@loaders.gl/gis 4.3.1 → 4.4.0-alpha.1

package/dist/index.d.ts

@@ -1,13 +1,32 @@
-export { GEOPARQUET_METADATA_JSON_SCHEMA } from "./lib/geo/geoparquet-metadata-schema.js";
-export type { GeoMetadata } from "./lib/geo/geoparquet-metadata.js";
-export { getGeoMetadata, setGeoMetadata, unpackGeoMetadata } from "./lib/geo/geoparquet-metadata.js";
-export { unpackJSONStringMetadata } from "./lib/geo/geoparquet-metadata.js";
-export type { GeoArrowEncoding, GeoArrowMetadata } from "./lib/geo/geoarrow-metadata.js";
-export { getGeometryColumnsFromSchema } from "./lib/geo/geoarrow-metadata.js";
-export { convertWKBTableToGeoJSON } from "./lib/tables/convert-table-to-geojson.js";
-export { flatGeojsonToBinary } from "./lib/binary-features/flat-geojson-to-binary.js";
-export { geojsonToBinary } from "./lib/binary-features/geojson-to-binary.js";
-export { geojsonToFlatGeojson } from "./lib/binary-features/geojson-to-flat-geojson.js";
-export { binaryToGeojson, binaryToGeometry } from "./lib/binary-features/binary-to-geojson.js";
-export { transformBinaryCoords, transformGeoJsonCoords } from "./lib/binary-features/transform.js";
+export type { GeojsonGeometryInfo } from "./lib/geometry-api/geometry-info.js";
+export { getGeometryInfo } from "./lib/geometry-api/geometry-info.js";
+export type { BinaryGeometryInfo } from "./lib/binary-geometry-api/binary-geometry-info.js";
+export { getBinaryGeometryInfo } from "./lib/binary-geometry-api/binary-geometry-info.js";
+export { transformBinaryCoords, transformGeoJsonCoords } from "./lib/binary-geometry-api/transform-coordinates.js";
+export { convertGeoArrowToTable } from "./lib/table-converters/convert-geoarrow-table.js";
+export { convertWKBTableToGeoJSON } from "./lib/table-converters/convert-wkb-table-to-geojson.js";
+export { convertFlatGeojsonToBinaryFeatureCollection, convertFlatGeojsonToBinaryFeatureCollection as flatGeojsonToBinary } from "./lib/feature-collection-converters/convert-flat-geojson-to-binary-features.js";
+export { convertGeojsonToBinaryFeatureCollection, convertGeojsonToBinaryFeatureCollection as geojsonToBinary } from "./lib/feature-collection-converters/convert-geojson-to-binary-features.js";
+export { convertGeojsonToFlatGeojson, convertGeojsonToFlatGeojson as geojsonToFlatGeojson } from "./lib/feature-collection-converters/convert-geojson-to-flat-geojson.js";
+export { convertBinaryFeatureCollectionToGeojson, convertBinaryFeatureCollectionToGeojson as binaryToGeojson } from "./lib/feature-collection-converters/convert-binary-features-to-geojson.js";
+export { isWKB, isTWKB, isWKT } from "./lib/geometry-converters/wkb/helpers/parse-wkb-header.js";
+export type { WKBHeader } from "./lib/geometry-converters/wkb/helpers/wkb-types.js";
+export { WKT_MAGIC_STRINGS } from "./lib/geometry-converters/wkb/helpers/wkb-types.js";
+export { convertBinaryGeometryToGeometry } from "./lib/geometry-converters/convert-binary-geometry-to-geojson.js";
+export { convertWKTToGeometry } from "./lib/geometry-converters/wkb/convert-wkt-to-geometry.js";
+export { convertWKBToGeometry } from "./lib/geometry-converters/wkb/convert-wkb-to-geometry.js";
+export { convertWKBToBinaryGeometry } from "./lib/geometry-converters/wkb/convert-wkb-to-binary-geometry.js";
+export { convertTWKBToGeometry } from "./lib/geometry-converters/wkb/convert-twkb-to-geometry.js";
+export { convertGeometryToWKT } from "./lib/geometry-converters/wkb/convert-geometry-to-wkt.js";
+export { convertGeometryToWKB } from "./lib/geometry-converters/wkb/convert-geometry-to-wkb.js";
+export { convertGeometryToTWKB } from "./lib/geometry-converters/wkb/convert-geometry-to-twkb.js";
+export type { WKTCRS, ParseWKTCRSOptions } from "./lib//wkt-crs/parse-wkt-crs.js";
+export { parseWKTCRS } from "./lib//wkt-crs/parse-wkt-crs.js";
+export type { EncodeWKTCRSOptions } from "./lib//wkt-crs/encode-wkt-crs.js";
+export { encodeWKTCRS } from "./lib//wkt-crs/encode-wkt-crs.js";
+export type { BinaryDataFromGeoArrow, BinaryGeometriesFromArrowOptions } from "./lib/feature-collection-converters/convert-geoarrow-to-binary-features.js";
+export { convertGeoArrowToBinaryFeatureCollection, convertGeoArrowToBinaryFeatureCollection as getBinaryGeometriesFromArrow, getBinaryGeometryTemplate, getTriangleIndices, getMeanCentersFromBinaryGeometries } from "./lib/feature-collection-converters/convert-geoarrow-to-binary-features.js";
+export { convertGeoArrowGeometryToGeoJSON } from "./lib/geometry-converters/convert-geoarrow-to-geojson.js";
+export { encodeHex, decodeHex } from "./lib/utils/hex-transcoder.js";
+export { extractNumericPropTypes as _extractNumericPropTypes } from "./lib/feature-collection-converters/convert-flat-geojson-to-binary-features.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,+BAA+B,EAAC,gDAA6C;AAErF,YAAY,EAAC,WAAW,EAAC,yCAAsC;AAC/D,OAAO,EAAC,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAC,yCAAsC;AAChG,OAAO,EAAC,wBAAwB,EAAC,yCAAsC;AAEvE,YAAY,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,uCAAoC;AACpF,OAAO,EAAC,4BAA4B,EAAC,uCAAoC;AAGzE,OAAO,EAAC,wBAAwB,EAAC,iDAA8C;AAG/E,OAAO,EAAC,mBAAmB,EAAC,wDAAqD;AACjF,OAAO,EAAC,eAAe,EAAC,mDAAgD;AACxE,OAAO,EAAC,oBAAoB,EAAC,yDAAsD;AACnF,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAC,mDAAgD;AAC1F,OAAO,EAAC,qBAAqB,EAAE,sBAAsB,EAAC,2CAAwC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,YAAY,EAAC,mBAAmB,EAAC,4CAAyC;AAC1E,OAAO,EAAC,eAAe,EAAC,4CAAyC;AAGjE,YAAY,EAAC,kBAAkB,EAAC,0DAAuD;AACvF,OAAO,EAAC,qBAAqB,EAAC,0DAAuD;AACrF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACvB,2DAAwD;AAGzD,OAAO,EAAC,sBAAsB,EAAC,yDAAsD;AACrF,OAAO,EAAC,wBAAwB,EAAC,+DAA4D;AAG7F,OAAO,EACL,2CAA2C,EAE3C,2CAA2C,IAAI,mBAAmB,EACnE,uFAAoF;AACrF,OAAO,EACL,uCAAuC,EAEvC,uCAAuC,IAAI,eAAe,EAC3D,kFAA+E;AAChF,OAAO,EACL,2BAA2B,EAE3B,2BAA2B,IAAI,oBAAoB,EACpD,+EAA4E;AAC7E,OAAO,EACL,uCAAuC,EACvC,uCAAuC,IAAI,eAAe,EAC3D,kFAA+E;AAGhF,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAC,kEAA+D;AAE5F,YAAY,EAAC,SAAS,EAAC,2DAAwD;AAC/E,OAAO,EAAC,iBAAiB,EAAC,2DAAwD;AAGlF,OAAO,EAAC,+BAA+B,EAAC,wEAAqE;AAE7G,OAAO,EAAC,oBAAoB,EAAC,iEAA8D;AAC3F,OAAO,EAAC,oBAAoB,EAAC,iEAA8D;AAC3F,OAAO,EAAC,0BAA0B,EAAC,wEAAqE;AACxG,OAAO,EAAC,qBAAqB,EAAC,kEAA+D;AAE7F,OAAO,EAAC,oBAAoB,EAAC,iEAA8D;AAC3F,OAAO,EAAC,oBAAoB,EAAC,iEAA8D;AAC3F,OAAO,EAAC,qBAAqB,EAAC,kEAA+D;AAG7F,YAAY,EAAC,MAAM,EAAE,kBAAkB,EAAC,wCAAqC;AAC7E,OAAO,EAAC,WAAW,EAAC,wCAAqC;AACzD,YAAY,EAAC,mBAAmB,EAAC,yCAAsC;AACvE,OAAO,EAAC,YAAY,EAAC,yCAAsC;AAG3D,YAAY,EACV,sBAAsB,EACtB,gCAAgC,EACjC,mFAAgF;AACjF,OAAO,EACL,wCAAwC,EAExC,wCAAwC,IAAI,4BAA4B,EACxE,yBAAyB,EACzB,kBAAkB,EAClB,kCAAkC,EACnC,mFAAgF;AAEjF,OAAO,EAAC,gCAAgC,EAAC,iEAA8D;AAIvG,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,sCAAmC;AAChE,OAAO,EAAC,uBAAuB,IAAI,wBAAwB,EAAC,uFAAoF"}

package/dist/index.js

@@ -1,16 +1,39 @@
 // Types from `@loaders.gl/schema`
-// 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.js";
-export { getGeoMetadata, setGeoMetadata, unpackGeoMetadata } from "./lib/geo/geoparquet-metadata.js";
-export { unpackJSONStringMetadata } from "./lib/geo/geoparquet-metadata.js";
-export { getGeometryColumnsFromSchema } from "./lib/geo/geoarrow-metadata.js";
-// Table conversion
-export { convertWKBTableToGeoJSON } from "./lib/tables/convert-table-to-geojson.js";
-// Binary Geometries
-export { flatGeojsonToBinary } from "./lib/binary-features/flat-geojson-to-binary.js";
-export { geojsonToBinary } from "./lib/binary-features/geojson-to-binary.js";
-export { geojsonToFlatGeojson } from "./lib/binary-features/geojson-to-flat-geojson.js";
-export { binaryToGeojson, binaryToGeometry } from "./lib/binary-features/binary-to-geojson.js";
-export { transformBinaryCoords, transformGeoJsonCoords } from "./lib/binary-features/transform.js";
+export { getGeometryInfo } from "./lib/geometry-api/geometry-info.js";
+export { getBinaryGeometryInfo } from "./lib/binary-geometry-api/binary-geometry-info.js";
+export { transformBinaryCoords, transformGeoJsonCoords } from "./lib/binary-geometry-api/transform-coordinates.js";
+// TABLE CONVERSION
+export { convertGeoArrowToTable } from "./lib/table-converters/convert-geoarrow-table.js";
+export { convertWKBTableToGeoJSON } from "./lib/table-converters/convert-wkb-table-to-geojson.js";
+// FEATURE COLLECTION CONVERSION
+export { convertFlatGeojsonToBinaryFeatureCollection, 
+// deprecated
+convertFlatGeojsonToBinaryFeatureCollection as flatGeojsonToBinary } from "./lib/feature-collection-converters/convert-flat-geojson-to-binary-features.js";
+export { convertGeojsonToBinaryFeatureCollection, 
+// deprecated
+convertGeojsonToBinaryFeatureCollection as geojsonToBinary } from "./lib/feature-collection-converters/convert-geojson-to-binary-features.js";
+export { convertGeojsonToFlatGeojson, 
+// deprecated
+convertGeojsonToFlatGeojson as geojsonToFlatGeojson } from "./lib/feature-collection-converters/convert-geojson-to-flat-geojson.js";
+export { convertBinaryFeatureCollectionToGeojson, convertBinaryFeatureCollectionToGeojson as binaryToGeojson } from "./lib/feature-collection-converters/convert-binary-features-to-geojson.js";
+// GEOMETRY ENCODING DETECTION
+export { isWKB, isTWKB, isWKT } from "./lib/geometry-converters/wkb/helpers/parse-wkb-header.js";
+export { WKT_MAGIC_STRINGS } from "./lib/geometry-converters/wkb/helpers/wkb-types.js";
+// GEOMETRY CONVERSION
+export { convertBinaryGeometryToGeometry } from "./lib/geometry-converters/convert-binary-geometry-to-geojson.js";
+export { convertWKTToGeometry } from "./lib/geometry-converters/wkb/convert-wkt-to-geometry.js";
+export { convertWKBToGeometry } from "./lib/geometry-converters/wkb/convert-wkb-to-geometry.js";
+export { convertWKBToBinaryGeometry } from "./lib/geometry-converters/wkb/convert-wkb-to-binary-geometry.js";
+export { convertTWKBToGeometry } from "./lib/geometry-converters/wkb/convert-twkb-to-geometry.js";
+export { convertGeometryToWKT } from "./lib/geometry-converters/wkb/convert-geometry-to-wkt.js";
+export { convertGeometryToWKB } from "./lib/geometry-converters/wkb/convert-geometry-to-wkb.js";
+export { convertGeometryToTWKB } from "./lib/geometry-converters/wkb/convert-geometry-to-twkb.js";
+export { parseWKTCRS } from "./lib//wkt-crs/parse-wkt-crs.js";
+export { encodeWKTCRS } from "./lib//wkt-crs/encode-wkt-crs.js";
+export { convertGeoArrowToBinaryFeatureCollection, 
+// deprecated
+convertGeoArrowToBinaryFeatureCollection as getBinaryGeometriesFromArrow, getBinaryGeometryTemplate, getTriangleIndices, getMeanCentersFromBinaryGeometries } from "./lib/feature-collection-converters/convert-geoarrow-to-binary-features.js";
+export { convertGeoArrowGeometryToGeoJSON } from "./lib/geometry-converters/convert-geoarrow-to-geojson.js";
+// EXPERIMENTAL APIs
+export { encodeHex, decodeHex } from "./lib/utils/hex-transcoder.js";
+export { extractNumericPropTypes as _extractNumericPropTypes } from "./lib/feature-collection-converters/convert-flat-geojson-to-binary-features.js";

package/dist/lib/binary-geometry-api/binary-geometry-info.d.ts

@@ -0,0 +1,21 @@
+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 declare function getBinaryGeometryInfo(geometry: BinaryGeometry): BinaryGeometryInfo;
+//# sourceMappingURL=binary-geometry-info.d.ts.map

package/dist/lib/binary-geometry-api/binary-geometry-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-geometry-info.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-geometry-api/binary-geometry-info.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uFAAuF;IACvF,iBAAiB,EACb,OAAO,GACP,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,cAAc,CAAC;IACnB,wDAAwD;IACxD,eAAe,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,CAQlF"}

package/dist/lib/binary-geometry-api/binary-geometry-info.js

@@ -0,0 +1,48 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * @returns information about a binary geometry
+ */
+export function getBinaryGeometryInfo(geometry) {
+    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) {
+    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) {
+    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/dist/lib/binary-geometry-api/concat-binary-geometry.d.ts

@@ -0,0 +1,5 @@
+import type { BinaryPointGeometry, BinaryLineGeometry, BinaryPolygonGeometry } from '@loaders.gl/schema';
+export declare function concatenateBinaryPointGeometries(binaryPointGeometries: BinaryPointGeometry[], dimension: number): BinaryPointGeometry;
+export declare function concatenateBinaryLineGeometries(binaryLineGeometries: BinaryLineGeometry[], dimension: number): BinaryLineGeometry;
+export declare function concatenateBinaryPolygonGeometries(binaryPolygonGeometries: BinaryPolygonGeometry[], dimension: number): BinaryPolygonGeometry;
+//# sourceMappingURL=concat-binary-geometry.d.ts.map

package/dist/lib/binary-geometry-api/concat-binary-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat-binary-geometry.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-geometry-api/concat-binary-geometry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAG5B,wBAAgB,gCAAgC,CAC9C,qBAAqB,EAAE,mBAAmB,EAAE,EAC5C,SAAS,EAAE,MAAM,GAChB,mBAAmB,CAQrB;AAED,wBAAgB,+BAA+B,CAC7C,oBAAoB,EAAE,kBAAkB,EAAE,EAC1C,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAWpB;AAED,wBAAgB,kCAAkC,CAChD,uBAAuB,EAAE,qBAAqB,EAAE,EAChD,SAAS,EAAE,MAAM,GAChB,qBAAqB,CA8BvB"}

package/dist/lib/binary-geometry-api/concat-binary-geometry.js

@@ -0,0 +1,50 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { concatTypedArrays } from "../utils/concat-typed-arrays.js";
+export function concatenateBinaryPointGeometries(binaryPointGeometries, dimension) {
+    const positions = 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, dimension) {
+    const lines = 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, dimension) {
+    const polygons = [];
+    const primitivePolygons = [];
+    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) => x > 0)
+            .map((x) => 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) => (value) => (sum += value);

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

@@ -9,11 +9,10 @@ type TransformCoordinate = (coord: number[]) => number[];
 export declare function transformBinaryCoords(binaryFeatures: BinaryFeatureCollection, transformCoordinate: TransformCoordinate): BinaryFeatureCollection;
 /**
  * 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
  */
 export declare function transformGeoJsonCoords(features: Feature[], fn: (coord: number[]) => number[]): Feature[];
 export {};
-//# sourceMappingURL=transform.d.ts.map
+//# sourceMappingURL=transform-coordinates.d.ts.map

package/dist/lib/binary-geometry-api/transform-coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-coordinates.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-geometry-api/transform-coordinates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAkB,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAEzF,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,uBAAuB,EACvC,mBAAmB,EAAE,mBAAmB,GACvC,uBAAuB,CAWzB;AAcD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,GAChC,OAAO,EAAE,CAMX"}

package/dist/lib/{binary-features/transform.js → binary-geometry-api/transform-coordinates.js}

@@ -29,7 +29,6 @@ function transformBinaryGeometryPositions(binaryGeometry, fn) {
 }
 /**
  * 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

package/dist/lib/feature-collection-converters/convert-binary-features-to-geojson.d.ts

@@ -0,0 +1,16 @@
+import type { BinaryGeometryType, BinaryFeatureCollection, Feature } from '@loaders.gl/schema';
+type BinaryToGeoJsonOptions = {
+    type?: BinaryGeometryType;
+    globalFeatureId?: number;
+};
+/**
+ * Convert binary geometry representation to GeoJSON
+ * @param data   geometry data in binary representation
+ * @param options
+ * @param options.type  Input data type: Point, LineString, or Polygon
+ * @param options.featureId  Global feature id. If specified, only a single feature is extracted
+ * @return GeoJSON objects
+ */
+export declare function convertBinaryFeatureCollectionToGeojson(data: BinaryFeatureCollection, options?: BinaryToGeoJsonOptions): Feature[] | Feature;
+export {};
+//# sourceMappingURL=convert-binary-features-to-geojson.d.ts.map

package/dist/lib/feature-collection-converters/convert-binary-features-to-geojson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-binary-features-to-geojson.d.ts","sourceRoot":"","sources":["../../../src/lib/feature-collection-converters/convert-binary-features-to-geojson.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EAKvB,OAAO,EAER,MAAM,oBAAoB,CAAC;AAM5B,KAAK,sBAAsB,GAAG;IAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,EAAE,GAAG,OAAO,CAMrB"}

package/dist/lib/{binary-features/binary-to-geojson.js → feature-collection-converters/convert-binary-features-to-geojson.js}

@@ -1,6 +1,7 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
+import { convertBinaryGeometryToGeometry } from "../geometry-converters/convert-binary-geometry-to-geojson.js";
 /**
  * Convert binary geometry representation to GeoJSON
  * @param data   geometry data in binary representation
@@ -9,7 +10,7 @@
  * @param options.featureId  Global feature id. If specified, only a single feature is extracted
  * @return GeoJSON objects
  */
-export function binaryToGeojson(data, options) {
+export function convertBinaryFeatureCollectionToGeojson(data, options) {
     const globalFeatureId = options?.globalFeatureId;
     if (globalFeatureId !== undefined) {
         return getSingleFeature(data, globalFeatureId);
@@ -49,20 +50,6 @@ function parseFeatures(data, type) {
     const dataArray = normalizeInput(data, type);
     return parseFeatureCollection(dataArray);
 }
-/** Parse input binary data and return a valid GeoJSON geometry object */
-export function binaryToGeometry(data, startIndex, endIndex) {
-    switch (data.type) {
-        case 'Point':
-            return pointToGeoJson(data, startIndex, endIndex);
-        case 'LineString':
-            return lineStringToGeoJson(data, startIndex, endIndex);
-        case 'Polygon':
-            return polygonToGeoJson(data, startIndex, endIndex);
-        default:
-            const unexpectedInput = data;
-            throw new Error(`Unsupported geometry type: ${unexpectedInput?.type}`);
-    }
-}
 // Normalize features
 // Return an array of data objects, each of which have a type key
 function normalizeInput(data, type) {
@@ -109,7 +96,7 @@ function parseFeatureCollection(dataArray) {
 }
 /** Parse input binary data and return a single GeoJSON Feature */
 function parseFeature(data, startIndex, endIndex) {
-    const geometry = binaryToGeometry(data, startIndex, endIndex);
+    const geometry = convertBinaryGeometryToGeometry(data, startIndex, endIndex);
     const properties = parseProperties(data, startIndex, endIndex);
     const fields = parseFields(data, startIndex, endIndex);
     return { type: 'Feature', geometry, properties, ...fields };
@@ -126,77 +113,3 @@ function parseProperties(data, startIndex = 0, endIndex) {
     }
     return properties;
 }
-/** Parse binary data of type Polygon */
-function polygonToGeoJson(data, startIndex = -Infinity, endIndex = Infinity) {
-    const { positions } = data;
-    const polygonIndices = data.polygonIndices.value.filter((x) => x >= startIndex && x <= endIndex);
-    const primitivePolygonIndices = data.primitivePolygonIndices.value.filter((x) => x >= startIndex && x <= endIndex);
-    const multi = polygonIndices.length > 2;
-    // Polygon
-    if (!multi) {
-        const coordinates = [];
-        for (let i = 0; i < primitivePolygonIndices.length - 1; i++) {
-            const startRingIndex = primitivePolygonIndices[i];
-            const endRingIndex = primitivePolygonIndices[i + 1];
-            const ringCoordinates = ringToGeoJson(positions, startRingIndex, endRingIndex);
-            coordinates.push(ringCoordinates);
-        }
-        return { type: 'Polygon', coordinates };
-    }
-    // MultiPolygon
-    const coordinates = [];
-    for (let i = 0; i < polygonIndices.length - 1; i++) {
-        const startPolygonIndex = polygonIndices[i];
-        const endPolygonIndex = polygonIndices[i + 1];
-        const polygonCoordinates = polygonToGeoJson(data, startPolygonIndex, endPolygonIndex).coordinates;
-        coordinates.push(polygonCoordinates);
-    }
-    return { type: 'MultiPolygon', coordinates };
-}
-/** Parse binary data of type LineString */
-function lineStringToGeoJson(data, startIndex = -Infinity, endIndex = Infinity) {
-    const { positions } = data;
-    const pathIndices = data.pathIndices.value.filter((x) => x >= startIndex && x <= endIndex);
-    const multi = pathIndices.length > 2;
-    if (!multi) {
-        const coordinates = ringToGeoJson(positions, pathIndices[0], pathIndices[1]);
-        return { type: 'LineString', coordinates };
-    }
-    const coordinates = [];
-    for (let i = 0; i < pathIndices.length - 1; i++) {
-        const ringCoordinates = ringToGeoJson(positions, pathIndices[i], pathIndices[i + 1]);
-        coordinates.push(ringCoordinates);
-    }
-    return { type: 'MultiLineString', coordinates };
-}
-/** Parse binary data of type Point */
-function pointToGeoJson(data, startIndex, endIndex) {
-    const { positions } = data;
-    const coordinates = ringToGeoJson(positions, startIndex, endIndex);
-    const multi = coordinates.length > 1;
-    if (multi) {
-        return { type: 'MultiPoint', coordinates };
-    }
-    return { type: 'Point', coordinates: coordinates[0] };
-}
-/**
- * Parse a linear ring of positions to a GeoJSON linear ring
- *
- * @param positions Positions TypedArray
- * @param startIndex Start index to include in ring
- * @param endIndex End index to include in ring
- * @returns GeoJSON ring
- */
-function ringToGeoJson(positions, startIndex, endIndex) {
-    startIndex = startIndex || 0;
-    endIndex = endIndex || positions.value.length / positions.size;
-    const ringCoordinates = [];
-    for (let j = startIndex; j < endIndex; j++) {
-        const coord = Array();
-        for (let k = j * positions.size; k < (j + 1) * positions.size; k++) {
-            coord.push(Number(positions.value[k]));
-        }
-        ringCoordinates.push(coord);
-    }
-    return ringCoordinates;
-}

package/dist/lib/{binary-features/flat-geojson-to-binary.d.ts → feature-collection-converters/convert-flat-geojson-to-binary-features.d.ts}

@@ -1,5 +1,6 @@
-import type { BinaryFeatureCollection, FlatFeature, GeojsonGeometryInfo } from '@loaders.gl/schema';
-import { PropArrayConstructor } from "./flat-geojson-to-binary-types.js";
+import type { BinaryFeatureCollection, FlatFeature } from '@loaders.gl/schema';
+import { GeojsonGeometryInfo } from "../geometry-api/geometry-info.js";
+import { PropArrayConstructor } from "./helpers/flat-geojson-to-binary-types.js";
 /**
  * Convert binary features to flat binary arrays. Similar to
  * `geojsonToBinary` helper function, except that it expects
@@ -13,7 +14,7 @@ import { PropArrayConstructor } from "./flat-geojson-to-binary-types.js";
  * @param options
  * @returns filled arrays
  */
-export declare function flatGeojsonToBinary(features: FlatFeature[], geometryInfo: GeojsonGeometryInfo, options?: FlatGeojsonToBinaryOptions): BinaryFeatureCollection;
+export declare function convertFlatGeojsonToBinaryFeatureCollection(features: FlatFeature[], geometryInfo: GeojsonGeometryInfo, options?: FlatGeojsonToBinaryOptions): BinaryFeatureCollection;
 /**
  * Options for `flatGeojsonToBinary`
  */
@@ -22,17 +23,13 @@ export type FlatGeojsonToBinaryOptions = {
     PositionDataType?: Float32ArrayConstructor | Float64ArrayConstructor;
     triangulate?: boolean;
 };
-export declare const TEST_EXPORTS: {
-    extractNumericPropTypes: typeof extractNumericPropTypes;
-};
 /**
  * Extracts properties that are always numeric
  *
  * @param features
  * @returns object with numeric types
  */
-declare function extractNumericPropTypes(features: FlatFeature[]): {
+export declare function extractNumericPropTypes(features: FlatFeature[]): {
     [key: string]: PropArrayConstructor;
 };
-export {};
-//# sourceMappingURL=flat-geojson-to-binary.d.ts.map
+//# sourceMappingURL=convert-flat-geojson-to-binary-features.d.ts.map

package/dist/lib/feature-collection-converters/convert-flat-geojson-to-binary-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-flat-geojson-to-binary-features.d.ts","sourceRoot":"","sources":["../../../src/lib/feature-collection-converters/convert-flat-geojson-to-binary-features.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,uBAAuB,EAEvB,WAAW,EAKZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,mBAAmB,EAAC,yCAAsC;AAClE,OAAO,EACL,oBAAoB,EAIrB,kDAA+C;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,mBAAmB,EACjC,OAAO,CAAC,EAAE,0BAA0B,GACnC,uBAAuB,CAezB;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,uBAAuB,GAAG,uBAAuB,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACrC,CAgBA"}

package/dist/lib/{binary-features/flat-geojson-to-binary.js → feature-collection-converters/convert-flat-geojson-to-binary-features.js}

@@ -1,3 +1,6 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 /* eslint-disable indent */
 import { earcut } from '@math.gl/polygon';
 /**
@@ -13,7 +16,7 @@ import { earcut } from '@math.gl/polygon';
  * @param options
  * @returns filled arrays
  */
-export function flatGeojsonToBinary(features, geometryInfo, options) {
+export function convertFlatGeojsonToBinaryFeatureCollection(features, geometryInfo, options) {
     const propArrayTypes = extractNumericPropTypes(features);
     const numericPropKeys = Object.keys(propArrayTypes).filter((k) => propArrayTypes[k] !== Array);
     return fillArrays(features, {
@@ -25,16 +28,13 @@ export function flatGeojsonToBinary(features, geometryInfo, options) {
         triangulate: options ? options.triangulate : true
     });
 }
-export const TEST_EXPORTS = {
-    extractNumericPropTypes
-};
 /**
  * Extracts properties that are always numeric
  *
  * @param features
  * @returns object with numeric types
  */
-function extractNumericPropTypes(features) {
+export function extractNumericPropTypes(features) {
     const propArrayTypes = {};
     for (const feature of features) {
         if (feature.properties) {

package/dist/lib/feature-collection-converters/convert-geoarrow-to-binary-features.d.ts

@@ -0,0 +1,74 @@
+import * as arrow from 'apache-arrow';
+import type { BinaryFeatureCollection } from '@loaders.gl/schema';
+import type { GeoArrowEncoding } from '@loaders.gl/geoarrow';
+/**
+ * Binary data from geoarrow column and can be used by e.g. deck.gl GeojsonLayer
+ */
+export type BinaryDataFromGeoArrow = {
+    /** Binary format geometries, an array of BinaryFeatureCollection */
+    binaryGeometries: BinaryFeatureCollection[];
+    /** Boundary of the binary geometries */
+    bounds: [number, number, number, number];
+    /** Feature types of the binary geometries */
+    featureTypes: {
+        polygon: boolean;
+        point: boolean;
+        line: boolean;
+    };
+    /** (Optional) mean centers of the binary geometries for e.g. polygon filtering */
+    meanCenters?: number[][];
+};
+export type BinaryGeometriesFromArrowOptions = {
+    /** option to specify which chunk to get binary geometries from, for progressive rendering */
+    chunkIndex?: number;
+    /** The offset (beginning index of rows) of input chunk. Used for reconstructing globalFeatureIds in web workers */
+    chunkOffset?: number;
+    /** option to get mean centers from geometries, for polygon filtering */
+    calculateMeanCenters?: boolean;
+    /** option to compute the triangle indices by tesselating polygons */
+    triangulate?: boolean;
+};
+/**
+ * get binary geometries from geoarrow column
+ *
+ * @param geoColumn the geoarrow column, e.g. arrowTable.getChildAt(geoColumnIndex)
+ * @param geoEncoding the geo encoding of the geoarrow column, e.g. getGeoArrowEncoding(arrowTable.schema, geoColumnName)
+ * @param options options for getting binary geometries {meanCenter: boolean}
+ * @returns BinaryDataFromGeoArrow
+ */
+export declare function convertGeoArrowToBinaryFeatureCollection(geoColumn: arrow.Vector, geoEncoding: GeoArrowEncoding, options?: BinaryGeometriesFromArrowOptions): BinaryDataFromGeoArrow;
+/**
+ * binary geometry template, see deck.gl BinaryGeometry
+ */
+export declare function getBinaryGeometryTemplate(): {
+    globalFeatureIds: {
+        value: Uint32Array;
+        size: number;
+    };
+    positions: {
+        value: Float32Array;
+        size: number;
+    };
+    properties: never[];
+    numericProps: {};
+    featureIds: {
+        value: Uint32Array;
+        size: number;
+    };
+};
+/**
+ * Get mean centers from binary geometries
+ * @param binaryGeometries binary geometries from geoarrow column, an array of BinaryFeatureCollection
+ * @returns mean centers of the binary geometries
+ */
+export declare function getMeanCentersFromBinaryGeometries(binaryGeometries: BinaryFeatureCollection[]): number[][];
+/**
+ * get triangle indices. Allows deck.gl to skip performing costly triangulation on main thread.
+ * @param polygonIndices Indices within positions of the start of each simple Polygon
+ * @param primitivePolygonIndices Indices within positions of the start of each primitive Polygon/ring
+ * @param flatCoordinateArray Array of x, y or x, y, z positions
+ * @param nDim - number of dimensions per position
+ * @returns triangle indices or null if invalid polygon and earcut fails
+ */
+export declare function getTriangleIndices(polygonIndices: Uint16Array, primitivePolygonIndices: Int32Array, flatCoordinateArray: Float64Array, nDim: number): Uint32Array | null;
+//# sourceMappingURL=convert-geoarrow-to-binary-features.d.ts.map

package/dist/lib/feature-collection-converters/convert-geoarrow-to-binary-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-geoarrow-to-binary-features.d.ts","sourceRoot":"","sources":["../../../src/lib/feature-collection-converters/convert-geoarrow-to-binary-features.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAa3D;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,oEAAoE;IACpE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;IAC5C,wCAAwC;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,6CAA6C;IAC7C,YAAY,EAAE;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAC,CAAC;IAChE,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC1B,CAAC;AAsBF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,KAAK,CAAC,MAAM,EACvB,WAAW,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,gCAAgC,GACzC,sBAAsB,CAiFxB;AAED;;GAEG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;EAQxC;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,gBAAgB,EAAE,uBAAuB,EAAE,GAC1C,MAAM,EAAE,EAAE,CAiCZ;AA2ED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,WAAW,EAC3B,uBAAuB,EAAE,UAAU,EACnC,mBAAmB,EAAE,YAAY,EACjC,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,IAAI,CAyCpB"}