@loaders.gl/parquet 4.5.3 → 5.0.0-alpha.10

package/dist/lib/encoders/encode-table-to-parquet-js.js

@@ -0,0 +1,394 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getGeoMetadata } from '@loaders.gl/schema';
+import { concatUint8Arrays } from "../../parquetjs/utils/binary-utils.js";
+import { ParquetEncoder } from "../../parquetjs/encoder/parquet-encoder.js";
+import { ParquetSchema } from "../../parquetjs/schema/schema.js";
+/** Encode a plain loaders.gl table with the parquetjs implementation. */
+export async function encodeTableToParquetJs(table, objectRowTable, options) {
+    const parquetSchema = new ParquetSchema(convertSchemaToParquetSchema(table.schema, objectRowTable, options));
+    const chunks = [];
+    const outputStream = {
+        write(chunk, callback) {
+            chunks.push(chunk.slice());
+            callback();
+        },
+        close(callback) {
+            callback();
+        }
+    };
+    const encoder = await ParquetEncoder.openStream(parquetSchema, outputStream, options.parquet);
+    for (const [key, value] of Object.entries(table.schema?.metadata || {})) {
+        encoder.setMetadata(key, value);
+    }
+    for (const row of objectRowTable.data) {
+        await encoder.appendRow(row);
+    }
+    await encoder.close();
+    return concatUint8Arrays(chunks).slice().buffer;
+}
+/**
+ * Converts a loaders.gl schema into a parquetjs schema definition.
+ * @param schema table schema
+ * @param objectRowTable table data in object-row form
+ * @returns parquetjs schema definition
+ */
+function convertSchemaToParquetSchema(schema, objectRowTable, options) {
+    const parquetFields = {};
+    const columnEncodings = options.parquet?.columnEncodings || {};
+    const columnDictionaries = options.parquet?.columnDictionaries || {};
+    const bloomFilterColumns = options.parquet?.bloomFilter && typeof options.parquet.bloomFilter === 'object'
+        ? options.parquet.bloomFilter
+        : {};
+    const pageIndexColumns = options.parquet?.pageIndex && typeof options.parquet.pageIndex === 'object'
+        ? options.parquet.pageIndex
+        : {};
+    const columnKeyMetadata = options.parquet?.encryption?.columnKeyMetadata || {};
+    const fieldNames = new Set(schema.fields.map(field => field.name));
+    const geoMetadata = getGeoMetadata(schema.metadata);
+    for (const columnName of Object.keys(columnEncodings)) {
+        if (!fieldNames.has(columnName)) {
+            throw new Error(`ParquetJSWriter: Unknown column encoding override "${columnName}"`);
+        }
+    }
+    for (const columnName of Object.keys(columnDictionaries)) {
+        if (!fieldNames.has(columnName)) {
+            throw new Error(`ParquetJSWriter: Unknown column dictionary override "${columnName}"`);
+        }
+    }
+    for (const columnName of Object.keys(bloomFilterColumns)) {
+        if (!fieldNames.has(columnName)) {
+            throw new Error(`ParquetJSWriter: Unknown Bloom-filter column "${columnName}"`);
+        }
+    }
+    for (const columnName of Object.keys(pageIndexColumns)) {
+        if (!fieldNames.has(columnName)) {
+            throw new Error(`ParquetJSWriter: Unknown page-index column "${columnName}"`);
+        }
+    }
+    for (const columnName of Object.keys(columnKeyMetadata)) {
+        if (!fieldNames.has(columnName)) {
+            throw new Error(`ParquetJSWriter: Unknown encryption column key "${columnName}"`);
+        }
+    }
+    for (const field of schema.fields) {
+        parquetFields[field.name] = {
+            ...convertFieldToParquetFieldDefinition(field, objectRowTable.data, geoMetadata?.version, geoMetadata?.columns?.[field.name], undefined, options.parquet?.int96AsTimestamp),
+            encoding: columnEncodings[field.name]
+        };
+    }
+    return parquetFields;
+}
+/**
+ * Converts one loaders.gl field to the closest parquetjs field definition.
+ * @param field table field metadata
+ * @param rows object rows used for nullability and fallback inference
+ * @returns parquetjs field definition
+ */
+function convertFieldToParquetFieldDefinition(field, rows, geoParquetVersion, geoColumnMetadata, fieldValues, int96AsTimestamp = false) {
+    const values = fieldValues || rows.map(row => row[field.name]);
+    const sampleValue = getFirstDefinedValue(values);
+    const nullable = field.nullable ?? sampleValue === undefined;
+    const dataType = field.type === 'null' ? getDataTypeFromValue(sampleValue) : field.type;
+    if (typeof dataType === 'object') {
+        switch (dataType.type) {
+            case 'struct':
+                return {
+                    optional: nullable,
+                    fields: Object.fromEntries(dataType.children.map(child => [
+                        child.name,
+                        convertFieldToParquetFieldDefinition(child, [], undefined, undefined, getStructChildValues(values, child.name), int96AsTimestamp)
+                    ]))
+                };
+            case 'list': {
+                const child = dataType.children[0];
+                if (!child) {
+                    throw new Error(`ParquetJSWriter: List field "${field.name}" has no value child`);
+                }
+                return {
+                    optional: nullable,
+                    logicalType: { type: 'LIST' },
+                    fields: {
+                        list: {
+                            repeated: true,
+                            fields: {
+                                element: convertFieldToParquetFieldDefinition(child, [], undefined, undefined, flattenListValues(values), int96AsTimestamp)
+                            }
+                        }
+                    }
+                };
+            }
+            case 'map': {
+                const mapEntryField = dataType.children.length === 1 ? dataType.children[0] : undefined;
+                const mapEntryChildren = mapEntryField &&
+                    typeof mapEntryField.type === 'object' &&
+                    mapEntryField.type.type === 'struct'
+                    ? mapEntryField.type.children
+                    : dataType.children;
+                const [keyField, valueField] = mapEntryChildren;
+                if (!keyField || !valueField) {
+                    throw new Error(`ParquetJSWriter: Map field "${field.name}" needs key and value children`);
+                }
+                if (keyField.nullable) {
+                    throw new Error(`ParquetJSWriter: Map keys must be non-nullable ("${field.name}")`);
+                }
+                return {
+                    optional: nullable,
+                    logicalType: { type: 'MAP' },
+                    fields: {
+                        key_value: {
+                            repeated: true,
+                            fields: {
+                                key: {
+                                    ...convertFieldToParquetFieldDefinition({ ...keyField, name: 'key', nullable: false }, [], undefined, undefined, getMapChildValues(values, 'key'), int96AsTimestamp),
+                                    optional: false
+                                },
+                                value: {
+                                    ...convertFieldToParquetFieldDefinition({ ...valueField, name: 'value' }, [], undefined, undefined, getMapChildValues(values, 'value'), int96AsTimestamp)
+                                }
+                            }
+                        }
+                    }
+                };
+            }
+            default:
+                break;
+        }
+    }
+    switch (dataType) {
+        case 'bool':
+            return { type: 'BOOLEAN', optional: nullable };
+        case 'int':
+        case 'int32':
+            return { type: 'INT_32', optional: nullable };
+        case 'int8':
+            return { type: 'INT_8', optional: nullable };
+        case 'int16':
+            return { type: 'INT_16', optional: nullable };
+        case 'uint8':
+            return { type: 'UINT_8', optional: nullable };
+        case 'uint16':
+            return { type: 'UINT_16', optional: nullable };
+        case 'uint32':
+            return { type: 'UINT_32', optional: nullable };
+        case 'int64':
+            return { type: 'INT_64', optional: nullable };
+        case 'uint64':
+            return { type: 'UINT_64', optional: nullable };
+        case 'float':
+        case 'float32':
+            return { type: 'FLOAT', optional: nullable };
+        case 'float16':
+            return { type: 'FLOAT16', optional: nullable };
+        case 'float64':
+            return { type: 'DOUBLE', optional: nullable };
+        case 'utf8':
+            return { type: 'UTF8', optional: nullable };
+        case 'binary':
+            if (geoParquetVersion?.startsWith('2.') &&
+                String(geoColumnMetadata?.encoding).toLowerCase() === 'wkb') {
+                return getNativeGeospatialFieldDefinition(nullable, getNativeGeospatialCRS(geoColumnMetadata?.crs), geoColumnMetadata?.edges);
+            }
+            if (!geoParquetVersion) {
+                const geoArrowMetadata = getWKBGeoArrowMetadata(field);
+                if (geoArrowMetadata) {
+                    return getNativeGeospatialFieldDefinition(nullable, getGeoArrowNativeCRS(geoArrowMetadata), geoArrowMetadata.edges);
+                }
+            }
+            return { type: 'BYTE_ARRAY', optional: nullable };
+        case 'date-day':
+            return { type: 'DATE', optional: nullable };
+        case 'date-millisecond':
+        case 'timestamp-second':
+        case 'timestamp-millisecond':
+            return { type: 'TIMESTAMP_MILLIS', optional: nullable };
+        case 'timestamp-microsecond':
+            return { type: 'TIMESTAMP_MICROS', optional: nullable };
+        case 'timestamp-nanosecond':
+            return {
+                type: int96AsTimestamp ? 'INT96' : 'TIMESTAMP_NANOS',
+                optional: nullable
+            };
+        case 'time-second':
+        case 'time-millisecond':
+            return { type: 'TIME_MILLIS', optional: nullable };
+        case 'time-microsecond':
+            return { type: 'TIME_MICROS', optional: nullable };
+        case 'time-nanosecond':
+            return { type: 'TIME_NANOS', optional: nullable };
+        default:
+            if (typeof dataType === 'object' && dataType.type === 'decimal') {
+                const physicalType = dataType.precision <= 9
+                    ? 'DECIMAL_INT32'
+                    : dataType.precision <= 18
+                        ? 'DECIMAL_INT64'
+                        : 'DECIMAL_FIXED_LEN_BYTE_ARRAY';
+                return {
+                    type: physicalType,
+                    typeLength: physicalType === 'DECIMAL_FIXED_LEN_BYTE_ARRAY'
+                        ? getDecimalByteWidth(dataType.precision)
+                        : undefined,
+                    precision: dataType.precision,
+                    scale: dataType.scale,
+                    optional: nullable
+                };
+            }
+            if (typeof dataType === 'object' && dataType.type === 'fixed-size-binary') {
+                return {
+                    type: 'FIXED_LEN_BYTE_ARRAY',
+                    typeLength: dataType.byteWidth,
+                    optional: nullable
+                };
+            }
+            throw new Error(`ParquetJSWriter: Unsupported field "${field.name}" with type ${formatDataType(dataType)}`);
+    }
+}
+/** Serializes GeoParquet CRS metadata into the native Parquet logical-type string. */
+function getNativeGeospatialCRS(crs) {
+    if (crs === null)
+        return 'srid:0';
+    return crs === undefined ? undefined : JSON.stringify(crs);
+}
+/** Creates a native GEOMETRY or GEOGRAPHY field from normalized spatial semantics. */
+function getNativeGeospatialFieldDefinition(nullable, crs, edges) {
+    return edges && edges !== 'planar'
+        ? {
+            type: 'GEOGRAPHY',
+            optional: nullable,
+            logicalType: { type: 'GEOGRAPHY', crs, algorithm: edges.toUpperCase() }
+        }
+        : {
+            type: 'GEOMETRY',
+            optional: nullable,
+            logicalType: { type: 'GEOMETRY', crs }
+        };
+}
+/** Reads validated GeoArrow WKB extension metadata from a field. */
+function getWKBGeoArrowMetadata(field) {
+    if (field.metadata?.['ARROW:extension:name']?.toLowerCase() !== 'geoarrow.wkb')
+        return undefined;
+    const serializedMetadata = field.metadata['ARROW:extension:metadata'];
+    if (!serializedMetadata)
+        return {};
+    let metadata;
+    try {
+        metadata = JSON.parse(serializedMetadata);
+    }
+    catch (error) {
+        throw new Error(`ParquetJSWriter: Invalid GeoArrow metadata on "${field.name}"`, {
+            cause: error
+        });
+    }
+    if (!metadata || typeof metadata !== 'object') {
+        throw new Error(`ParquetJSWriter: Invalid GeoArrow metadata on "${field.name}"`);
+    }
+    const candidate = metadata;
+    if (candidate.crs !== undefined &&
+        typeof candidate.crs !== 'string' &&
+        (typeof candidate.crs !== 'object' || candidate.crs === null)) {
+        throw new Error(`ParquetJSWriter: Invalid GeoArrow CRS on "${field.name}"`);
+    }
+    if (candidate.edges !== undefined &&
+        !['spherical', 'vincenty', 'thomas', 'andoyer', 'karney'].includes(candidate.edges)) {
+        throw new Error(`ParquetJSWriter: Invalid GeoArrow edges on "${field.name}"`);
+    }
+    return candidate;
+}
+/** Maps GeoArrow CRS semantics onto the native Parquet logical-type property. */
+function getGeoArrowNativeCRS(metadata) {
+    if (metadata.crs === undefined)
+        return 'srid:0';
+    return typeof metadata.crs === 'string' ? metadata.crs : JSON.stringify(metadata.crs);
+}
+/** Returns the minimum fixed byte width required by one decimal precision. */
+function getDecimalByteWidth(precision) {
+    for (let byteWidth = 1; byteWidth <= 32; byteWidth++) {
+        const maximumPrecision = Math.floor(Math.log10(2 ** (8 * byteWidth - 1) - 1));
+        if (precision <= maximumPrecision)
+            return byteWidth;
+    }
+    throw new Error(`ParquetJSWriter: Decimal precision ${precision} exceeds 32 bytes`);
+}
+/**
+ * Finds the first non-nullish value in a column.
+ * @param rows table rows
+ * @param columnName column name
+ * @returns first defined value, if any
+ */
+function getFirstDefinedValue(values) {
+    for (const value of values) {
+        if (value !== null && value !== undefined) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** Extracts one named child from struct-like values for recursive schema conversion. */
+function getStructChildValues(values, childName) {
+    return values.flatMap(value => {
+        if (!value || typeof value !== 'object' || ArrayBuffer.isView(value))
+            return [];
+        return [Reflect.get(value, childName)];
+    });
+}
+/** Flattens list values while retaining nested arrays as child values. */
+function flattenListValues(values) {
+    return values.flatMap(value => (Array.isArray(value) ? value : []));
+}
+/** Extracts key/value members from Map, object, tuple, or Arrow object-row map values. */
+function getMapChildValues(values, member) {
+    const output = [];
+    for (const value of values) {
+        if (value instanceof Map) {
+            for (const [key, mapValue] of value)
+                output.push(member === 'key' ? key : mapValue);
+        }
+        else if (Array.isArray(value)) {
+            for (const entry of value) {
+                if (Array.isArray(entry) && entry.length >= 2)
+                    output.push(entry[member === 'key' ? 0 : 1]);
+                else if (entry && typeof entry === 'object')
+                    output.push(Reflect.get(entry, member));
+            }
+        }
+        else if (value && typeof value === 'object') {
+            for (const [key, mapValue] of Object.entries(value)) {
+                output.push(member === 'key' ? key : mapValue);
+            }
+        }
+    }
+    return output;
+}
+/**
+ * Infers a loaders.gl data type from a JavaScript value.
+ * @param value sample value
+ * @returns inferred data type
+ */
+function getDataTypeFromValue(value) {
+    if (typeof value === 'boolean') {
+        return 'bool';
+    }
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? 'int32' : 'float64';
+    }
+    if (typeof value === 'string') {
+        return 'utf8';
+    }
+    if (value instanceof Date) {
+        return 'timestamp-millisecond';
+    }
+    if (value instanceof Uint8Array) {
+        return 'binary';
+    }
+    throw new Error('ParquetJSWriter: Unable to infer a Parquet type from the provided row data');
+}
+/**
+ * Formats a loaders.gl data type for error messages.
+ * @param dataType input data type
+ * @returns human-readable type string
+ */
+function formatDataType(dataType) {
+    return typeof dataType === 'string' ? dataType : dataType.type;
+}
+//# sourceMappingURL=encode-table-to-parquet-js.js.map

package/dist/lib/encoders/encode-table-to-parquet-js.js.map

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

package/dist/lib/geo/geoparquet-covering.d.ts

@@ -0,0 +1,19 @@
+import type { ParquetBoundingBox, ParquetPredicate, ParquetRowGroupMetadata, ParquetSourceMetadata } from "../../parquet-source-types.js";
+/**
+ * Conservatively tests a row group using native Parquet geospatial statistics.
+ *
+ * Missing or malformed statistics retain the row group. Longitude intervals support the
+ * Parquet GEOGRAPHY antimeridian representation where `xmin` is greater than `xmax`.
+ */
+export declare function canGeoParquetRowGroupMatch(metadata: ParquetSourceMetadata, rowGroup: ParquetRowGroupMetadata, bbox: ParquetBoundingBox, geometryColumn?: string): boolean;
+/**
+ * Creates an exact per-row bounding-box predicate from GeoParquet 1.1 covering metadata.
+ *
+ * Invalid, missing, unsupported, or antimeridian-crossing coverings return `undefined` so spatial
+ * filtering remains conservative. GeoParquet 1.1 explicitly excludes antimeridian-crossing
+ * geometries from its bounding-box covering technique.
+ */
+export declare function createGeoParquetBoundingBoxPredicate(metadata: ParquetSourceMetadata, bbox: ParquetBoundingBox, geometryColumn?: string): ParquetPredicate | undefined;
+/** Combines an application predicate with an optional GeoParquet covering predicate. */
+export declare function combineParquetPredicates(predicate: ParquetPredicate | undefined, spatialPredicate: ParquetPredicate | undefined): ParquetPredicate | undefined;
+//# sourceMappingURL=geoparquet-covering.d.ts.map

package/dist/lib/geo/geoparquet-covering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoparquet-covering.d.ts","sourceRoot":"","sources":["../../../src/lib/geo/geoparquet-covering.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACtB,sCAAmC;AAEpC;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,kBAAkB,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAoBT;AAaD;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,kBAAkB,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,gBAAgB,GAAG,SAAS,CAwB9B;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,GAC7C,gBAAgB,GAAG,SAAS,CAQ9B"}

package/dist/lib/geo/geoparquet-covering.js

@@ -0,0 +1,137 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getGeoMetadata } from '@loaders.gl/schema';
+/**
+ * Conservatively tests a row group using native Parquet geospatial statistics.
+ *
+ * Missing or malformed statistics retain the row group. Longitude intervals support the
+ * Parquet GEOGRAPHY antimeridian representation where `xmin` is greater than `xmax`.
+ */
+export function canGeoParquetRowGroupMatch(metadata, rowGroup, bbox, geometryColumn) {
+    const bounds = getBoundingBoxCoordinates(bbox, true);
+    if (!bounds)
+        return true;
+    const geoMetadata = getGeoMetadata(metadata.schema.metadata);
+    const selectedGeometryColumn = geometryColumn || geoMetadata?.primary_column;
+    if (!selectedGeometryColumn)
+        return true;
+    const statistics = rowGroup.columns.find(column => column.path.length === 1 && column.path[0] === selectedGeometryColumn)?.geospatialStatistics?.bbox;
+    if (!statistics)
+        return true;
+    if (![statistics.xmin, statistics.xmax, statistics.ymin, statistics.ymax].every(Number.isFinite)) {
+        return true;
+    }
+    return (statistics.ymin <= bounds.north &&
+        statistics.ymax >= bounds.south &&
+        doLongitudeIntervalsIntersect(statistics.xmin, statistics.xmax, bounds.west, bounds.east));
+}
+/**
+ * Creates an exact per-row bounding-box predicate from GeoParquet 1.1 covering metadata.
+ *
+ * Invalid, missing, unsupported, or antimeridian-crossing coverings return `undefined` so spatial
+ * filtering remains conservative. GeoParquet 1.1 explicitly excludes antimeridian-crossing
+ * geometries from its bounding-box covering technique.
+ */
+export function createGeoParquetBoundingBoxPredicate(metadata, bbox, geometryColumn) {
+    const bounds = getBoundingBoxCoordinates(bbox, false);
+    if (!bounds) {
+        return undefined;
+    }
+    const geoMetadata = getGeoMetadata(metadata.schema.metadata);
+    const selectedGeometryColumn = geometryColumn || geoMetadata?.primary_column;
+    const columnMetadata = selectedGeometryColumn
+        ? geoMetadata?.columns?.[selectedGeometryColumn]
+        : undefined;
+    const covering = getBoundingBoxCovering(columnMetadata?.covering);
+    if (!covering || !hasCoveringColumns(metadata, covering)) {
+        return undefined;
+    }
+    return {
+        op: 'and',
+        args: [
+            { op: '<=', args: [{ property: covering.xmin }, bounds.east] },
+            { op: '>=', args: [{ property: covering.xmax }, bounds.west] },
+            { op: '<=', args: [{ property: covering.ymin }, bounds.north] },
+            { op: '>=', args: [{ property: covering.ymax }, bounds.south] }
+        ]
+    };
+}
+/** Combines an application predicate with an optional GeoParquet covering predicate. */
+export function combineParquetPredicates(predicate, spatialPredicate) {
+    if (!predicate) {
+        return spatialPredicate;
+    }
+    if (!spatialPredicate) {
+        return predicate;
+    }
+    return { op: 'and', args: [predicate, spatialPredicate] };
+}
+/** Validates the normative GeoParquet 1.1 two-level bbox covering representation. */
+function getBoundingBoxCovering(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const bbox = value.bbox;
+    if (!bbox || typeof bbox !== 'object') {
+        return undefined;
+    }
+    const candidate = bbox;
+    const xmin = getCoveringPath(candidate.xmin, 'xmin');
+    const ymin = getCoveringPath(candidate.ymin, 'ymin');
+    const xmax = getCoveringPath(candidate.xmax, 'xmax');
+    const ymax = getCoveringPath(candidate.ymax, 'ymax');
+    if (!xmin || !ymin || !xmax || !ymax) {
+        return undefined;
+    }
+    const rootColumn = xmin[0];
+    if (ymin[0] !== rootColumn || xmax[0] !== rootColumn || ymax[0] !== rootColumn) {
+        return undefined;
+    }
+    return { xmin, ymin, xmax, ymax };
+}
+/** Validates one GeoParquet 1.1 bbox leaf path. */
+function getCoveringPath(value, expectedLeaf) {
+    return Array.isArray(value) &&
+        value.length === 2 &&
+        typeof value[0] === 'string' &&
+        value[0].length > 0 &&
+        value[1] === expectedLeaf
+        ? [value[0], expectedLeaf]
+        : undefined;
+}
+/** Ensures every covering path resolves to a physical column in the Parquet footer. */
+function hasCoveringColumns(metadata, covering) {
+    const availablePaths = new Set(metadata.rowGroups.flatMap(rowGroup => rowGroup.columns.map(column => column.path.join('\0'))));
+    return Object.values(covering).every(path => availablePaths.has(path.join('\0')));
+}
+/** Validates and normalizes the two horizontal dimensions of a query bounding box. */
+function getBoundingBoxCoordinates(bbox, allowAntimeridian) {
+    const west = bbox[0];
+    const south = bbox[1];
+    const east = bbox.length === 8 ? bbox[4] : bbox.length === 6 ? bbox[3] : bbox[2];
+    const north = bbox.length === 8 ? bbox[5] : bbox.length === 6 ? bbox[4] : bbox[3];
+    if (![west, south, east, north].every(Number.isFinite) ||
+        (!allowAntimeridian && west > east) ||
+        south > north) {
+        return undefined;
+    }
+    return { west, south, east, north };
+}
+/** Tests two longitude intervals, each of which may wrap across the antimeridian. */
+function doLongitudeIntervalsIntersect(firstWest, firstEast, secondWest, secondEast) {
+    const firstIntervals = firstWest <= firstEast
+        ? [[firstWest, firstEast]]
+        : [
+            [firstWest, 180],
+            [-180, firstEast]
+        ];
+    const secondIntervals = secondWest <= secondEast
+        ? [[secondWest, secondEast]]
+        : [
+            [secondWest, 180],
+            [-180, secondEast]
+        ];
+    return firstIntervals.some(first => secondIntervals.some(second => first[0] <= second[1] && first[1] >= second[0]));
+}
+//# sourceMappingURL=geoparquet-covering.js.map

package/dist/lib/geo/geoparquet-covering.js.map

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

package/dist/lib/geo/geospatial-metadata.d.ts

@@ -0,0 +1,67 @@
+import * as arrow from 'apache-arrow';
+import { type Schema } from '@loaders.gl/schema';
+/**
+ * Applies GeoParquet schema metadata to matching geometry fields as GeoArrow field metadata.
+ *
+ * @param schema - Schema to annotate.
+ * @returns The same schema reference.
+ */
+export declare function applyGeoParquetToFieldMetadata(schema: Schema): Schema;
+/**
+ * Creates an Arrow JS table whose schema metadata matches a loaders.gl schema.
+ *
+ * @param table - Arrow JS table to rewrap.
+ * @param schema - loaders.gl schema containing desired field/schema metadata.
+ * @returns Table using the updated Arrow JS schema.
+ */
+export declare function applyLoadersSchemaToArrowTable(table: arrow.Table, schema: Schema): arrow.Table;
+/**
+ * Normalizes an Arrow wrapper so GeoParquet metadata is preserved and GeoArrow field metadata is attached.
+ *
+ * @param arrowTable - loaders.gl Arrow table wrapper.
+ * @param schemaMetadata - Optional schema metadata override from the Parquet footer.
+ * @returns Arrow table wrapper with synchronized schema metadata.
+ */
+export declare function normalizeArrowTableGeoMetadata(arrowTable: {
+    shape: 'arrow-table';
+    data: arrow.Table;
+    schema?: Schema;
+}, schemaMetadata?: Map<string, string> | Record<string, string>): {
+    shape: 'arrow-table';
+    data: arrow.Table;
+    schema: Schema;
+};
+/**
+ * Synthesizes GeoParquet schema metadata from GeoArrow field metadata when needed.
+ *
+ * @param schema - Schema to inspect and update.
+ * @returns The same schema reference.
+ */
+export declare function ensureGeoParquetMetadata(schema: Schema): Schema;
+/**
+ * Ensures an Arrow table wrapper carries valid GeoParquet schema metadata when GeoArrow fields are present.
+ *
+ * @param arrowTable - Arrow table wrapper to inspect and update.
+ * @returns Updated Arrow table wrapper.
+ */
+export declare function ensureGeoParquetMetadataOnArrowTable(arrowTable: {
+    shape: 'arrow-table';
+    data: arrow.Table;
+    schema?: Schema;
+}): {
+    shape: 'arrow-table';
+    data: arrow.Table;
+    schema: Schema;
+};
+/**
+ * Returns Parquet file key/value metadata as a plain map.
+ *
+ * @param parquetMetadata - parquet-wasm metadata object.
+ * @returns Metadata map.
+ */
+export declare function getParquetFileMetadataMap(parquetMetadata: {
+    fileMetadata(): {
+        keyValueMetadata(): Map<string, string>;
+    };
+}): Map<string, string>;
+//# sourceMappingURL=geospatial-metadata.d.ts.map