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

package/dist/lib/utils/hex-encoder.js

@@ -0,0 +1,55 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Simple helper to decode and encode "hex encoded" binary buffers
+ * without first converting to string.
+ */
+export class HexEncoder {
+    /** Get length in bytes required to store encoded data */
+    getEncodedLength(array) {
+        return array.byteLength * 2;
+    }
+    /** Get length in bytes required to store decoded data */
+    getDecodedLength(array) {
+        return Math.ceil(array.byteLength / 2);
+    }
+    /** Decode hexadecimal */
+    decode(array, result) {
+        for (let i = 0; i < array.byteLength / 2; ++i) {
+            const halfByte1 = hexDecode(array[i]);
+            const halfByte2 = hexDecode(array[i + 1]);
+            result[i] = halfByte1 * 16 + halfByte2;
+        }
+        // Check if final half byte (is that legal?)
+        // if (array.byteLength % 2) {
+        //   const halfByte1 = hexDecode(array[i]);
+        // }
+        return result;
+    }
+    /** Encode hexadecimal */
+    encode(array, result) {
+        for (let i = 0; i < array.byteLength; ++i) {
+            const byte = array[i];
+            result[i * 2] = hexEncode(byte & 0x0f);
+            result[i * 2 + 1] = hexEncode(byte & 0xf0);
+        }
+        return result;
+    }
+}
+function hexEncode(value) {
+    if (value < 10) {
+        return value + 48; // ASCII of 0
+    }
+    return value - 10 + 65; // ASCII of capital A
+}
+function hexDecode(value) {
+    if (value >= 65) {
+        return value - 65 + 10; // ASCII of A
+    }
+    if (value >= 97) {
+        return value - 97 + 10; // ASCII of a
+    }
+    return value - 48; // ASCII of 0
+}
+//# sourceMappingURL=hex-encoder.js.map

package/dist/lib/utils/hex-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex-encoder.js","sourceRoot":"","sources":["../../../src/lib/utils/hex-encoder.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,yDAAyD;IACzD,gBAAgB,CAAC,KAAiB;QAChC,OAAO,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,yDAAyD;IACzD,gBAAgB,CAAC,KAAiB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,yBAAyB;IACzB,MAAM,CAAC,KAAiB,EAAE,MAAkB;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,CAAC;QACD,4CAA4C;QAC5C,8BAA8B;QAC9B,2CAA2C;QAC3C,IAAI;QACJ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,yBAAyB;IACzB,MAAM,CAAC,KAAiB,EAAE,MAAkB;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC,aAAa;IAClC,CAAC;IACD,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,qBAAqB;AAC/C,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa;IACvC,CAAC;IACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa;IACvC,CAAC;IACD,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC,aAAa;AAClC,CAAC"}

package/dist/lib/utils/hex-transcoder.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Encode a Uint8Array to a hex string
+ *
+ * @param  array Bytes to encode to string
+ * @return hex string
+ */
+export declare function encodeHex(array: Uint8Array): string;
+/**
+ * Decodes a hex string to a Uint8Array
+ *
+ * @param string hex string to decode to Uint8Array
+ * @return Uint8Array
+ */
+export declare function decodeHex(string: string): Uint8Array;
+//# sourceMappingURL=hex-transcoder.d.ts.map

package/dist/lib/utils/hex-transcoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex-transcoder.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/hex-transcoder.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAQnD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAUpD"}

package/dist/lib/utils/hex-transcoder.js

@@ -0,0 +1,51 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Forked from https://github.com/jessetane/hex-transcoder under MIT license
+const alphabet = '0123456789abcdef';
+const encodeLookup = [];
+const decodeLookup = [];
+for (let i = 0; i < 256; i++) {
+    encodeLookup[i] = alphabet[(i >> 4) & 0xf] + alphabet[i & 0xf];
+    if (i < 16) {
+        if (i < 10) {
+            decodeLookup[0x30 + i] = i;
+        }
+        else {
+            decodeLookup[0x61 - 10 + i] = i;
+        }
+    }
+}
+/**
+ * Encode a Uint8Array to a hex string
+ *
+ * @param  array Bytes to encode to string
+ * @return hex string
+ */
+export function encodeHex(array) {
+    const length = array.length;
+    let string = '';
+    let i = 0;
+    while (i < length) {
+        string += encodeLookup[array[i++]];
+    }
+    return string;
+}
+/**
+ * Decodes a hex string to a Uint8Array
+ *
+ * @param string hex string to decode to Uint8Array
+ * @return Uint8Array
+ */
+export function decodeHex(string) {
+    const sizeof = string.length >> 1;
+    const length = sizeof << 1;
+    const array = new Uint8Array(sizeof);
+    let n = 0;
+    let i = 0;
+    while (i < length) {
+        array[n++] = (decodeLookup[string.charCodeAt(i++)] << 4) | decodeLookup[string.charCodeAt(i++)];
+    }
+    return array;
+}
+//# sourceMappingURL=hex-transcoder.js.map

package/dist/lib/utils/hex-transcoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex-transcoder.js","sourceRoot":"","sources":["../../../src/lib/utils/hex-transcoder.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,4EAA4E;AAE5E,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AACpC,MAAM,YAAY,GAAa,EAAE,CAAC;AAClC,MAAM,YAAY,GAAa,EAAE,CAAC;AAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC7B,YAAY,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/D,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACX,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAiB;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/wkt-crs/encode-wkt-crs.d.ts

@@ -0,0 +1,10 @@
+import type { WKTCRS } from "./parse-wkt-crs.js";
+export type EncodeWKTCRSOptions = {
+    debug?: boolean;
+};
+/**
+ * convert JSON representation of Well-Known Text
+ * back to standard Well-Known Text
+ */
+export declare function encodeWKTCRS(wkt: WKTCRS, options?: EncodeWKTCRSOptions): string;
+//# sourceMappingURL=encode-wkt-crs.d.ts.map

package/dist/lib/wkt-crs/encode-wkt-crs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-wkt-crs.d.ts","sourceRoot":"","sources":["../../../src/lib/wkt-crs/encode-wkt-crs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,MAAM,EAAC,2BAAwB;AAE5C,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAyB/E"}

package/dist/lib/wkt-crs/encode-wkt-crs.js

@@ -0,0 +1,36 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// parse-wkt-crs was forked from https://github.com/DanielJDufour/wkt-crs under Creative Commons CC0 1.0 license.
+/**
+ * convert JSON representation of Well-Known Text
+ * back to standard Well-Known Text
+ */
+export function encodeWKTCRS(wkt, options) {
+    if (Array.isArray(wkt) && wkt.length === 1 && Array.isArray(wkt[0])) {
+        wkt = wkt[0]; // ignore first extra wrapper array
+    }
+    const [kw, ...attrs] = wkt;
+    const str = `${kw}[${attrs
+        .map((attr) => {
+        if (Array.isArray(attr)) {
+            return encodeWKTCRS(attr, options);
+        }
+        else if (typeof attr === 'number') {
+            return attr.toString();
+        }
+        else if (typeof attr === 'string') {
+            // can't automatically convert all caps to varibale
+            // because EPSG is string in AUTHORITY["EPSG", ...]
+            if (attr.startsWith('raw:')) {
+                // convert "raw:NORTH" to NORTH
+                return attr.replace('raw:', '');
+            }
+            return `"${attr}"`;
+        }
+        throw new Error(`[wktcrs] unexpected attribute "${attr}"`);
+    })
+        .join(',')}]`;
+    return str;
+}
+//# sourceMappingURL=encode-wkt-crs.js.map

package/dist/lib/wkt-crs/encode-wkt-crs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-wkt-crs.js","sourceRoot":"","sources":["../../../src/lib/wkt-crs/encode-wkt-crs.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AACpC,iHAAiH;AAQjH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAA6B;IACrE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAmC;IACnD,CAAC;IAED,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC3B,MAAM,GAAG,GAAG,GAAG,EAAE,IAAI,KAAK;SACvB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,mDAAmD;YACnD,mDAAmD;YACnD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,+BAA+B;gBAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,IAAI,GAAG,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,GAAG,CAAC,CAAC;IAC7D,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/wkt-crs/parse-wkt-crs.d.ts

@@ -0,0 +1,15 @@
+export type ParseWKTCRSOptions = {
+    sort?: boolean;
+    keywords?: string[];
+    raw?: boolean;
+    debug?: boolean;
+};
+export type WKTCRS = any;
+/**
+ *
+ * @param wkt
+ * @param options
+ * @returns
+ */
+export declare function parseWKTCRS(wkt: string, options?: ParseWKTCRSOptions): WKTCRS;
+//# sourceMappingURL=parse-wkt-crs.d.ts.map

package/dist/lib/wkt-crs/parse-wkt-crs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-wkt-crs.d.ts","sourceRoot":"","sources":["../../../src/lib/wkt-crs/parse-wkt-crs.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,GAAG,CAAC;AAEzB;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA2E7E"}

package/dist/lib/wkt-crs/parse-wkt-crs.js

@@ -0,0 +1,121 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// parse-wkt-crs was forked from https://github.com/DanielJDufour/wkt-crs under Creative Commons CC0 1.0 license.
+/**
+ *
+ * @param wkt
+ * @param options
+ * @returns
+ */
+export function parseWKTCRS(wkt, options) {
+    if (options?.debug) {
+        console.log('[wktcrs] parse starting with\n', wkt);
+    }
+    // move all keywords into first array item slot
+    // from PARAM[12345, 67890] to ["PARAM", 12345, 67890]
+    wkt = wkt.replace(/[A-Z][A-Z\d_]+\[/gi, (match) => `["${match.substr(0, match.length - 1)}",`);
+    // wrap variables in strings
+    // from [...,NORTH] to [...,"NORTH"]
+    wkt = wkt.replace(/, ?([A-Z][A-Z\d_]+[,\]])/gi, (match, p1) => {
+        const varname = p1.substr(0, p1.length - 1);
+        return ',' + `"${options?.raw ? 'raw:' : ''}${varname}"${p1[p1.length - 1]}`;
+    });
+    if (options?.raw) {
+        // replace all numbers with strings
+        wkt = wkt.replace(/, {0,2}(-?[\.\d]+)(?=,|\])/g, function (match, p1) {
+            return ',' + `"${options?.raw ? 'raw:' : ''}${p1}"`;
+        });
+    }
+    // str should now be valid JSON
+    if (options?.debug) {
+        console.log(`[wktcrs] json'd wkt: '${wkt}'`);
+    }
+    let data;
+    try {
+        data = JSON.parse(wkt);
+    }
+    catch (error) {
+        console.error(`[wktcrs] failed to parse '${wkt}'`);
+        throw error;
+    }
+    if (options?.debug) {
+        console.log(`[wktcrs] json parsed: '${wkt}'`);
+    }
+    function process(data, parent) {
+        const kw = data[0];
+        // after removing the first element with .shift()
+        // data is now just an array of attributes
+        data.forEach(function (it) {
+            if (Array.isArray(it)) {
+                process(it, data);
+            }
+        });
+        const kwarr = `MULTIPLE_${kw}`;
+        if (kwarr in parent) {
+            parent[kwarr].push(data);
+        }
+        else if (kw in parent) {
+            parent[kwarr] = [parent[kw], data];
+            delete parent[kw];
+        }
+        else {
+            parent[kw] = data;
+        }
+        return parent;
+    }
+    const result = process(data, [data]);
+    if (options?.debug) {
+        console.log('[wktcrs] parse returning', result);
+    }
+    if (options?.sort) {
+        sort(result, options);
+    }
+    return result;
+}
+function sort(data, options) {
+    const keys = Object.keys(data).filter((k) => !/\d+/.test(k));
+    const keywords = options?.keywords || [];
+    if (!options?.keywords) {
+        // try to find multiples
+        const counts = {};
+        if (Array.isArray(data)) {
+            data.forEach((it) => {
+                if (Array.isArray(it) && it.length >= 2 && typeof it[1] === 'string') {
+                    const k = it[0];
+                    if (!counts[k])
+                        counts[k] = 0;
+                    counts[k]++;
+                }
+            });
+            for (const k in counts) {
+                if (counts[k] > 0)
+                    keywords.push(k);
+            }
+        }
+    }
+    keys.forEach((key) => {
+        data[key] = sort(data[key]);
+    });
+    keywords.forEach((key) => {
+        const indices = [];
+        const params = [];
+        data.forEach((item, i) => {
+            if (Array.isArray(item) && item[0] === key) {
+                indices.push(i);
+                params.push(item);
+            }
+        });
+        params.sort((a, b) => {
+            a = a[1].toString();
+            b = b[1].toString();
+            return a < b ? -1 : a > b ? 1 : 0;
+        });
+        // replace in order
+        params.forEach((param, i) => {
+            data[indices[i]] = param;
+        });
+    });
+    return data;
+}
+//# sourceMappingURL=parse-wkt-crs.js.map

package/dist/lib/wkt-crs/parse-wkt-crs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-wkt-crs.js","sourceRoot":"","sources":["../../../src/lib/wkt-crs/parse-wkt-crs.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AACpC,iHAAiH;AAajH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAA4B;IACnE,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,+CAA+C;IAC/C,sDAAsD;IACtD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAE/F,4BAA4B;IAC5B,oCAAoC;IACpC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5C,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,mCAAmC;QACnC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,6BAA6B,EAAE,UAAU,KAAK,EAAE,EAAE;YAClE,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,GAAG,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,OAAO,CAAC,IAAI,EAAE,MAAM;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,iDAAiD;QACjD,0CAA0C;QAE1C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,YAAY,EAAE,EAAE,CAAC;QAE/B,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,IAAc,EAAE,OAA+B;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAa,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;QACvB,wBAAwB;QACxB,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBAClB,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACrE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;wBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACnB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACpB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loaders.gl/gis",
   "description": "Helpers for GIS category data",
-  "version": "4.3.4",
+  "version": "4.4.0-alpha.10",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -32,8 +32,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@loaders.gl/loader-utils": "4.3.4",
-    "@loaders.gl/schema": "4.3.4",
+    "@loaders.gl/geoarrow": "4.4.0-alpha.10",
+    "@loaders.gl/loader-utils": "4.4.0-alpha.10",
+    "@loaders.gl/schema": "4.4.0-alpha.10",
+    "@loaders.gl/schema-utils": "4.4.0-alpha.10",
     "@mapbox/vector-tile": "^1.3.1",
     "@math.gl/polygon": "^4.1.0",
     "pbf": "^3.2.1"
@@ -42,7 +44,7 @@
     "@math.gl/proj4": "^4.1.0"
   },
   "peerDependencies": {
-    "@loaders.gl/core": "^4.3.0"
+    "@loaders.gl/core": "4.4.0-alpha.1"
   },
-  "gitHead": "d18246f4ef6382f787a6ae2e9e21d8a7f40e5917"
+  "gitHead": "7b4dc3fdbaed20a2597c70c57efdcda5c404147f"
 }

package/src/index.ts

@@ -3,21 +3,94 @@
 // Geo Metadata
 // import {default as GEOPARQUET_METADATA_SCHEMA} from './lib/geo/geoparquet-metadata-schema.json';
 // export {GEOPARQUET_METADATA_SCHEMA};
-export {GEOPARQUET_METADATA_JSON_SCHEMA} from './lib/geo/geoparquet-metadata-schema';
+// export {GEOPARQUET_METADATA_JSON_SCHEMA} from './lib/geoarrow/geoparquet-metadata-schema';
 
-export type {GeoMetadata} from './lib/geo/geoparquet-metadata';
-export {getGeoMetadata, setGeoMetadata, unpackGeoMetadata} from './lib/geo/geoparquet-metadata';
-export {unpackJSONStringMetadata} from './lib/geo/geoparquet-metadata';
+// export type {GeoMetadata} from './lib/geoarrow/geoparquet-metadata';
+// export {
+//   getGeoMetadata,
+//   setGeoMetadata,
+//   unpackGeoMetadata
+// } from './lib/geoarrow/geoparquet-metadata';
+// export {unpackJSONStringMetadata} from './lib/geoarrow/geoparquet-metadata';
 
-export type {GeoArrowEncoding, GeoArrowMetadata} from './lib/geo/geoarrow-metadata';
-export {getGeometryColumnsFromSchema} from './lib/geo/geoarrow-metadata';
+//
+export type {GeojsonGeometryInfo} from './lib/geometry-api/geometry-info';
+export {getGeometryInfo} from './lib/geometry-api/geometry-info';
 
-// Table conversion
-export {convertWKBTableToGeoJSON} from './lib/tables/convert-table-to-geojson';
+// Binary Geometry Utilities
+export type {BinaryGeometryInfo} from './lib/binary-geometry-api/binary-geometry-info';
+export {getBinaryGeometryInfo} from './lib/binary-geometry-api/binary-geometry-info';
+export {
+  transformBinaryCoords,
+  transformGeoJsonCoords
+} from './lib/binary-geometry-api/transform-coordinates';
 
-// Binary Geometries
-export {flatGeojsonToBinary} from './lib/binary-features/flat-geojson-to-binary';
-export {geojsonToBinary} from './lib/binary-features/geojson-to-binary';
-export {geojsonToFlatGeojson} from './lib/binary-features/geojson-to-flat-geojson';
-export {binaryToGeojson, binaryToGeometry} from './lib/binary-features/binary-to-geojson';
-export {transformBinaryCoords, transformGeoJsonCoords} from './lib/binary-features/transform';
+// TABLE CONVERSION
+export {convertGeoArrowToTable} from './lib/table-converters/convert-geoarrow-table';
+export {convertWKBTableToGeoJSON} from './lib/table-converters/convert-wkb-table-to-geojson';
+
+// FEATURE COLLECTION CONVERSION
+export {
+  convertFlatGeojsonToBinaryFeatureCollection,
+  // deprecated
+  convertFlatGeojsonToBinaryFeatureCollection as flatGeojsonToBinary
+} from './lib/feature-collection-converters/convert-flat-geojson-to-binary-features';
+export {
+  convertGeojsonToBinaryFeatureCollection,
+  // deprecated
+  convertGeojsonToBinaryFeatureCollection as geojsonToBinary
+} from './lib/feature-collection-converters/convert-geojson-to-binary-features';
+export {
+  convertGeojsonToFlatGeojson,
+  // deprecated
+  convertGeojsonToFlatGeojson as geojsonToFlatGeojson
+} from './lib/feature-collection-converters/convert-geojson-to-flat-geojson';
+export {
+  convertBinaryFeatureCollectionToGeojson,
+  convertBinaryFeatureCollectionToGeojson as binaryToGeojson
+} from './lib/feature-collection-converters/convert-binary-features-to-geojson';
+
+// GEOMETRY ENCODING DETECTION
+export {isWKB, isTWKB, isWKT} from './lib/geometry-converters/wkb/helpers/parse-wkb-header';
+
+export type {WKBHeader} from './lib/geometry-converters/wkb/helpers/wkb-types';
+export {WKT_MAGIC_STRINGS} from './lib/geometry-converters/wkb/helpers/wkb-types';
+
+// GEOMETRY CONVERSION
+export {convertBinaryGeometryToGeometry} from './lib/geometry-converters/convert-binary-geometry-to-geojson';
+
+export {convertWKTToGeometry} from './lib/geometry-converters/wkb/convert-wkt-to-geometry';
+export {convertWKBToGeometry} from './lib/geometry-converters/wkb/convert-wkb-to-geometry';
+export {convertWKBToBinaryGeometry} from './lib/geometry-converters/wkb/convert-wkb-to-binary-geometry';
+export {convertTWKBToGeometry} from './lib/geometry-converters/wkb/convert-twkb-to-geometry';
+
+export {convertGeometryToWKT} from './lib/geometry-converters/wkb/convert-geometry-to-wkt';
+export {convertGeometryToWKB} from './lib/geometry-converters/wkb/convert-geometry-to-wkb';
+export {convertGeometryToTWKB} from './lib/geometry-converters/wkb/convert-geometry-to-twkb';
+
+// CRS
+export type {WKTCRS, ParseWKTCRSOptions} from './lib//wkt-crs/parse-wkt-crs';
+export {parseWKTCRS} from './lib//wkt-crs/parse-wkt-crs';
+export type {EncodeWKTCRSOptions} from './lib//wkt-crs/encode-wkt-crs';
+export {encodeWKTCRS} from './lib//wkt-crs/encode-wkt-crs';
+
+// GEOARROW
+export type {
+  BinaryDataFromGeoArrow,
+  BinaryGeometriesFromArrowOptions
+} from './lib/feature-collection-converters/convert-geoarrow-to-binary-features';
+export {
+  convertGeoArrowToBinaryFeatureCollection,
+  // deprecated
+  convertGeoArrowToBinaryFeatureCollection as getBinaryGeometriesFromArrow,
+  getBinaryGeometryTemplate,
+  getTriangleIndices,
+  getMeanCentersFromBinaryGeometries
+} from './lib/feature-collection-converters/convert-geoarrow-to-binary-features';
+
+export {convertGeoArrowGeometryToGeoJSON} from './lib/geometry-converters/convert-geoarrow-to-geojson';
+
+// EXPERIMENTAL APIs
+
+export {encodeHex, decodeHex} from './lib/utils/hex-transcoder';
+export {extractNumericPropTypes as _extractNumericPropTypes} from './lib/feature-collection-converters/convert-flat-geojson-to-binary-features';

package/src/lib/binary-geometry-api/binary-geometry-info.ts

@@ -0,0 +1,75 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {BinaryGeometry} from '@loaders.gl/schema';
+
+/**
+ * Information about a binary geometry
+ */
+export type BinaryGeometryInfo = {
+  /** The GeoJSON style geometry type corresponding to this particular binary geometry */
+  multiGeometryType:
+    | 'Point'
+    | 'LineString'
+    | 'Polygon'
+    | 'MultiPoint'
+    | 'MultiLineString'
+    | 'MultiPolygon';
+  /** Is this a "Multi" version of the binary geometry? */
+  isMultiGeometry: boolean;
+  /** How many dimensions are the coordinates? */
+  dimension: number;
+  /** How many points does this geometry have? */
+  pointCount: number;
+  /** How many coordinates does this geometry have? */
+  coordinateCount: number;
+};
+
+/**
+ * @returns information about a binary geometry
+ */
+export function getBinaryGeometryInfo(geometry: BinaryGeometry): BinaryGeometryInfo {
+  return {
+    isMultiGeometry: isMultiGeometryType(geometry),
+    multiGeometryType: getMultiGeometryType(geometry),
+    dimension: geometry.positions.size,
+    pointCount: geometry.positions.value.length / geometry.positions.size,
+    coordinateCount: geometry.positions.value.length
+  };
+}
+
+/** @returns true if a binary geometry corresponds to a MultiPoint, MultiLineString or MultiPolygon */
+function isMultiGeometryType(geometry: BinaryGeometry) {
+  switch (geometry.type) {
+    case 'Point':
+      const {positions} = geometry;
+      return positions.value.length / positions.size > 1;
+    case 'LineString':
+      const {pathIndices} = geometry;
+      return pathIndices.value.length > 1;
+    case 'Polygon':
+      const {polygonIndices} = geometry;
+      return polygonIndices.value.length > 1;
+    default:
+      return false;
+  }
+}
+
+/**
+ * @returns geometry type of binary geometry, including MultiPoint, MultiLineString or MultiPolygon
+ */
+function getMultiGeometryType(geometry: BinaryGeometry) {
+  const isMulti = isMultiGeometryType(geometry);
+  switch (geometry.type) {
+    case 'Point':
+      return isMulti ? 'MultiPoint' : 'Point';
+    case 'LineString':
+      return isMulti ? 'MultiLineString' : 'LineString';
+    case 'Polygon':
+      return isMulti ? 'MultiPolygon' : 'Polygon';
+    default:
+      // @ts-expect-error
+      throw new Error(`Illegal geometry type: ${type}`);
+  }
+}

package/src/lib/binary-geometry-api/concat-binary-geometry.ts

@@ -0,0 +1,78 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {
+  TypedArray,
+  BinaryPointGeometry,
+  BinaryLineGeometry,
+  BinaryPolygonGeometry
+} from '@loaders.gl/schema';
+import {concatTypedArrays} from '../utils/concat-typed-arrays';
+
+export function concatenateBinaryPointGeometries(
+  binaryPointGeometries: BinaryPointGeometry[],
+  dimension: number
+): BinaryPointGeometry {
+  const positions: TypedArray[] = binaryPointGeometries.map((geometry) => geometry.positions.value);
+  const concatenatedPositions = new Float64Array(concatTypedArrays(positions).buffer);
+
+  return {
+    type: 'Point',
+    positions: {value: concatenatedPositions, size: dimension}
+  };
+}
+
+export function concatenateBinaryLineGeometries(
+  binaryLineGeometries: BinaryLineGeometry[],
+  dimension: number
+): BinaryLineGeometry {
+  const lines: TypedArray[] = binaryLineGeometries.map((geometry) => geometry.positions.value);
+  const concatenatedPositions = new Float64Array(concatTypedArrays(lines).buffer);
+  const pathIndices = lines.map((line) => line.length / dimension).map(cumulativeSum(0));
+  pathIndices.unshift(0);
+
+  return {
+    type: 'LineString',
+    positions: {value: concatenatedPositions, size: dimension},
+    pathIndices: {value: new Uint32Array(pathIndices), size: 1}
+  };
+}
+
+export function concatenateBinaryPolygonGeometries(
+  binaryPolygonGeometries: BinaryPolygonGeometry[],
+  dimension: number
+): BinaryPolygonGeometry {
+  const polygons: TypedArray[] = [];
+  const primitivePolygons: TypedArray[] = [];
+
+  for (const binaryPolygon of binaryPolygonGeometries) {
+    const {positions, primitivePolygonIndices} = binaryPolygon;
+    polygons.push(positions.value);
+    primitivePolygons.push(primitivePolygonIndices.value);
+  }
+
+  const concatenatedPositions = new Float64Array(concatTypedArrays(polygons).buffer);
+  const polygonIndices = polygons.map((p) => p.length / dimension).map(cumulativeSum(0));
+  polygonIndices.unshift(0);
+
+  // Combine primitivePolygonIndices from each individual polygon
+  const primitivePolygonIndices = [0];
+  for (const primitivePolygon of primitivePolygons) {
+    primitivePolygonIndices.push(
+      ...primitivePolygon
+        .filter((x: number) => x > 0)
+        .map((x: number) => x + primitivePolygonIndices[primitivePolygonIndices.length - 1])
+    );
+  }
+
+  return {
+    type: 'Polygon',
+    positions: {value: concatenatedPositions, size: dimension},
+    polygonIndices: {value: new Uint32Array(polygonIndices), size: 1},
+    primitivePolygonIndices: {value: new Uint32Array(primitivePolygonIndices), size: 1}
+  };
+}
+
+// https://stackoverflow.com/a/55261098
+const cumulativeSum = (sum: number) => (value: number) => (sum += value);

package/src/lib/{binary-features/transform.ts → binary-geometry-api/transform-coordinates.ts}

@@ -38,7 +38,6 @@ function transformBinaryGeometryPositions(binaryGeometry: BinaryGeometry, fn: Tr
 
 /**
  * Apply transformation to every coordinate of GeoJSON features
- *
  * @param  features Array of GeoJSON features
  * @param  fn       Function to call on each coordinate
  * @return          Transformed GeoJSON features