@math.gl/geospatial 5.0.0-alpha.17 → 5.0.0-alpha.19

package/dist/geoarrow/tessellation-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tessellation-entry.d.ts","sourceRoot":"","sources":["../../src/geoarrow/tessellation-entry.ts"],"names":[],"mappings":"AAIA,6CAA6C;AAC7C,YAAY,EAAC,oBAAoB,EAAE,iCAAiC,EAAC,wBAAqB;AAC1F,OAAO,EAAC,0BAA0B,EAAC,wBAAqB"}

package/dist/geoarrow/tessellation-entry.js

@@ -0,0 +1,5 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export { tessellateGeoArrowPolygons } from "./tessellate.js";
+//# sourceMappingURL=tessellation-entry.js.map

package/dist/geoarrow/tessellation-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tessellation-entry.js","sourceRoot":"","sources":["../../src/geoarrow/tessellation-entry.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAI5D,OAAO,EAAC,0BAA0B,EAAC,wBAAqB"}

package/dist/geoarrow/types.d.ts

@@ -0,0 +1,147 @@
+import type { SpatialReference } from "../crs/index.js";
+import type { TypedArray } from '@math.gl/core/types';
+/** Minimal tagged geometry shape used only by compatibility builders.
+ *
+ * The physical GeoArrow APIs never create these values. Keeping the structural type here avoids
+ * making the descriptor package depend on the WKB format package.
+ */
+export type GeoArrowGeometryValue = {
+    type: 'Point';
+    coordinates: readonly number[];
+} | {
+    type: 'LineString';
+    coordinates: readonly (readonly number[])[];
+} | {
+    type: 'Polygon';
+    coordinates: readonly (readonly (readonly number[])[])[];
+} | {
+    type: 'MultiPoint';
+    coordinates: readonly (readonly number[])[];
+} | {
+    type: 'MultiLineString';
+    coordinates: readonly (readonly (readonly number[])[])[];
+} | {
+    type: 'MultiPolygon';
+    coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+} | {
+    type: 'GeometryCollection';
+    geometries: readonly GeoArrowGeometryValue[];
+};
+/** GeoArrow concrete, mixed, bounding-box, and serialized encodings. */
+export type GeoArrowEncoding = 'geoarrow.point' | 'geoarrow.linestring' | 'geoarrow.polygon' | 'geoarrow.multipoint' | 'geoarrow.multilinestring' | 'geoarrow.multipolygon' | 'geoarrow.geometry' | 'geoarrow.geometrycollection' | 'geoarrow.box' | 'geoarrow.wkb' | 'geoarrow.wkt';
+/** Semantic coordinate dimensions. M is never interpreted as Z. */
+export type GeoArrowDimension = 'xy' | 'xyz' | 'xym' | 'xyzm';
+/** Physical coordinate organization for native geometries. */
+export type GeoArrowCoordinateLayout = 'interleaved' | 'separated';
+/** Supported list-offset buffers. */
+export type GeoArrowOffsets = Int32Array | BigInt64Array;
+/** Numeric physical storage accepted by GeoArrow descriptors. */
+export type GeoArrowNumericArray = TypedArray | BigInt64Array | BigUint64Array;
+/** Borrowed validity bitmap. Set bits are valid rows. */
+export type GeoArrowValidity = Readonly<{
+    values: Uint8Array;
+    /** Bit position corresponding to logical row zero. */
+    bitOffset?: number;
+}>;
+/** Properties shared by all physical arrays. */
+export type GeoArrowArrayBase = Readonly<{
+    /** Number of logical values represented by this array. */
+    length: number;
+    /** Optional borrowed validity bitmap for this nesting level. */
+    validity?: GeoArrowValidity;
+}>;
+/** Primitive scalar storage, optionally strided within a typed array. */
+export type GeoArrowPrimitive = GeoArrowArrayBase & Readonly<{
+    kind: 'primitive';
+    values: GeoArrowNumericArray;
+    /** Scalar offset of logical value zero. */
+    offset?: number;
+    /** Scalars between consecutive logical values. Defaults to one. */
+    stride?: number;
+}>;
+/** Fixed-size list storage, used for interleaved coordinate tuples. */
+export type GeoArrowFixedSizeList = GeoArrowArrayBase & Readonly<{
+    kind: 'fixed-size-list';
+    size: number;
+    child: GeoArrowArray;
+    /** Logical list offset into the child. */
+    offset?: number;
+}>;
+/** Variable-size list storage. */
+export type GeoArrowList = GeoArrowArrayBase & Readonly<{
+    kind: 'list';
+    offsets: GeoArrowOffsets;
+    /** Index of logical row zero in `offsets`. */
+    offset?: number;
+    /** Value subtracted from offsets before indexing the supplied child view. */
+    offsetBase?: number | bigint;
+    child: GeoArrowArray;
+}>;
+/** Named separated children, used for separated coordinates and boxes. */
+export type GeoArrowStruct = GeoArrowArrayBase & Readonly<{
+    kind: 'struct';
+    children: Readonly<Record<string, GeoArrowArray>>;
+    /** Logical struct offset applied to every child. */
+    offset?: number;
+}>;
+/** Struct storage used by `geoarrow.box` minimum/maximum ordinate columns. */
+export type GeoArrowBox = GeoArrowStruct;
+/** One dense-union child and its stable type ID. */
+export type GeoArrowDenseUnionChild = Readonly<{
+    name: string;
+    typeId: number;
+    /** Child-specific physical encoding (required for mixed-dimensional unions). */
+    encoding?: GeoArrowEncoding;
+    /** Child-specific semantic dimension. Falls back to the column dimension for legacy data. */
+    dimension?: GeoArrowDimension;
+    /** Child-specific coordinate layout. Falls back to the column layout for legacy data. */
+    coordinateLayout?: GeoArrowCoordinateLayout | null;
+    data: GeoArrowArray;
+}>;
+/** Dense-union storage for mixed geometry families. */
+export type GeoArrowDenseUnion = GeoArrowArrayBase & Readonly<{
+    kind: 'dense-union';
+    typeIds: Int8Array | Uint8Array;
+    valueOffsets: Int32Array;
+    children: readonly GeoArrowDenseUnionChild[];
+    /** Logical row offset into typeIds and valueOffsets. */
+    offset?: number;
+}>;
+/** Variable-width binary or UTF-8 storage for WKB and WKT. */
+export type GeoArrowSerialized = GeoArrowArrayBase & Readonly<{
+    kind: 'serialized';
+    encoding: 'binary' | 'utf8';
+    offsets: GeoArrowOffsets;
+    values: Uint8Array;
+    /** Optional Arrow BinaryView-style records (four uint32 words per row). */
+    views?: Uint32Array;
+    /** Borrowed out-of-line buffers referenced by BinaryView records. */
+    dataBuffers?: readonly Uint8Array[];
+    /** Index of logical row zero in `offsets`. */
+    offset?: number;
+    /** Value subtracted from offsets before indexing `values`. */
+    offsetBase?: number | bigint;
+}>;
+/** Arrow-compatible physical array tree without Arrow runtime classes. */
+export type GeoArrowArray = GeoArrowPrimitive | GeoArrowFixedSizeList | GeoArrowList | GeoArrowStruct | GeoArrowDenseUnion | GeoArrowSerialized;
+/** One logical GeoArrow geometry column backed by borrowed chunks. */
+export type GeoArrowColumn = Readonly<{
+    encoding: GeoArrowEncoding;
+    dimension: GeoArrowDimension;
+    coordinateLayout: GeoArrowCoordinateLayout | null;
+    chunks: readonly GeoArrowArray[];
+    spatialReference?: SpatialReference | null;
+    edges?: 'planar' | 'spherical';
+    metadata?: Readonly<Record<string, unknown>>;
+}>;
+/** Coordinate callback used by mapping kernels. */
+export type GeoArrowCoordinateMapper = (coordinate: readonly number[], rowIndex: number) => readonly number[];
+/** Four-value XY bounds. */
+export type GeoArrowBounds = readonly [number, number, number, number];
+/** Returns the number of coordinate components for a semantic dimension. */
+export declare function getGeoArrowDimensionSize(dimension: GeoArrowDimension): 2 | 3 | 4;
+/** Returns the concrete geometry family associated with an encoding. */
+export declare function getGeoArrowGeometryType(encoding: GeoArrowEncoding): Exclude<GeoArrowGeometryValue['type'], 'GeometryCollection'> | 'GeometryCollection' | null;
+/** Returns the canonical concrete encoding for a materialized geometry family. */
+export declare function getGeoArrowEncodingForGeometry(type: GeoArrowGeometryValue['type']): GeoArrowEncoding;
+//# sourceMappingURL=types.d.ts.map

package/dist/geoarrow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/geoarrow/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,gBAAgB,EAAC,wBAAqB;AACnD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,qBAAqB,CAAC;AACpD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CAAC,GAC/C;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAA;CAAC,GACjE;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;CAAC,GAC3E;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAA;CAAC,GACjE;IAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;CAAC,GACnF;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;CAAC,GAC7F;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAAC,CAAC;AAE/E,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,qBAAqB,GACrB,kBAAkB,GAClB,qBAAqB,GACrB,0BAA0B,GAC1B,uBAAuB,GACvB,mBAAmB,GACnB,6BAA6B,GAC7B,cAAc,GACd,cAAc,GACd,cAAc,CAAC;AAEnB,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9D,8DAA8D;AAC9D,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG,WAAW,CAAC;AAEnE,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,aAAa,CAAC;AAEzD,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AAE/E,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAC/C,QAAQ,CAAC;IACP,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEL,uEAAuE;AACvE,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GACnD,QAAQ,CAAC;IACP,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEL,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAC1C,QAAQ,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;IACzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC,CAAC;AAEL,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAC5C,QAAQ,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEL,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC;AAEzC,oDAAoD;AACpD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACnD,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC,CAAC;AAEH,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAChD,QAAQ,CAAC;IACP,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,SAAS,GAAG,UAAU,CAAC;IAChC,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC7C,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEL,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAChD,QAAQ,CAAC;IACP,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B,CAAC,CAAC;AAEL,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,qBAAqB,GACrB,YAAY,GACZ,cAAc,GACd,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gBAAgB,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAClD,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,MAAM,wBAAwB,GAAG,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,QAAQ,EAAE,MAAM,KACb,SAAS,MAAM,EAAE,CAAC;AAEvB,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvE,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,iBAAiB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAUhF;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,GAAG,oBAAoB,GAAG,IAAI,CAmB5F;AAED,kFAAkF;AAClF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAClC,gBAAgB,CAElB"}

package/dist/geoarrow/types.js

@@ -0,0 +1,41 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+/** Returns the number of coordinate components for a semantic dimension. */
+export function getGeoArrowDimensionSize(dimension) {
+    switch (dimension) {
+        case 'xy':
+            return 2;
+        case 'xyz':
+        case 'xym':
+            return 3;
+        case 'xyzm':
+            return 4;
+    }
+}
+/** Returns the concrete geometry family associated with an encoding. */
+export function getGeoArrowGeometryType(encoding) {
+    switch (encoding) {
+        case 'geoarrow.point':
+            return 'Point';
+        case 'geoarrow.linestring':
+            return 'LineString';
+        case 'geoarrow.polygon':
+            return 'Polygon';
+        case 'geoarrow.multipoint':
+            return 'MultiPoint';
+        case 'geoarrow.multilinestring':
+            return 'MultiLineString';
+        case 'geoarrow.multipolygon':
+            return 'MultiPolygon';
+        case 'geoarrow.geometrycollection':
+            return 'GeometryCollection';
+        default:
+            return null;
+    }
+}
+/** Returns the canonical concrete encoding for a materialized geometry family. */
+export function getGeoArrowEncodingForGeometry(type) {
+    return `geoarrow.${type.toLowerCase()}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/geoarrow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/geoarrow/types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AA8K5D,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB,CAAC,SAA4B;IACnE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,CAAC,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,uBAAuB,CACrC,QAA0B;IAE1B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,gBAAgB;YACnB,OAAO,OAAO,CAAC;QACjB,KAAK,qBAAqB;YACxB,OAAO,YAAY,CAAC;QACtB,KAAK,kBAAkB;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,qBAAqB;YACxB,OAAO,YAAY,CAAC;QACtB,KAAK,0BAA0B;YAC7B,OAAO,iBAAiB,CAAC;QAC3B,KAAK,uBAAuB;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,6BAA6B;YAChC,OAAO,oBAAoB,CAAC;QAC9B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,8BAA8B,CAC5C,IAAmC;IAEnC,OAAO,YAAY,IAAI,CAAC,WAAW,EAAE,EAAsB,CAAC;AAC9D,CAAC"}

package/dist/geoarrow/views.d.ts

@@ -0,0 +1,45 @@
+import type { GeoArrowColumn } from "./types.js";
+/** One physical batch borrowed from a native geometry column. */
+export type GeoArrowBatchView = Readonly<{
+    /** Single-chunk column retaining the source semantics and typed arrays. */
+    column: GeoArrowColumn;
+    /** Index of the physical chunk in the source column, including empty chunks. */
+    chunkIndex: number;
+    /** First logical row in the source column; not a feature ID or byte cursor. */
+    rowOffset: number;
+}>;
+/** One logical row, with top-level union dispatch resolved without decoding coordinates. */
+export type GeoArrowRowView = Readonly<{
+    /** One-row column, preserving nulls, collections, and exact single/multi identity. */
+    column: GeoArrowColumn;
+    /** Logical row index relative to the input column, including null rows. */
+    rowIndex: number;
+    /** Physical chunk index in the input column. */
+    chunkIndex: number;
+    /** Logical row index within that chunk, before union dispatch. */
+    chunkRowIndex: number;
+}>;
+/**
+ * Iterates native physical chunks lazily, including empty chunks, without new typed arrays.
+ * This is not a loader record-batch protocol: one loader batch may contain several chunks.
+ * Views borrow storage; callers must not mutate, recycle, or detach it while views are in use.
+ * Assumes valid physical descriptors; use validateGeoArrowColumn for untrusted input.
+ */
+export declare function iterateGeoArrowBatches(column: GeoArrowColumn): IterableIterator<GeoArrowBatchView>;
+/**
+ * Borrows one native geometry row, allocating descriptors but no typed arrays or coordinates.
+ * Resolves the top-level union by type ID and retains collection grouping inside the row.
+ * Indices are relative to the supplied column (including when it is already sliced).
+ * Throws for an invalid row index, serialized/box encoding, or invalid union dispatch.
+ * Assumes valid physical descriptors beyond the selected union dispatch.
+ */
+export declare function getGeoArrowRowView(column: GeoArrowColumn, rowIndex: number): GeoArrowRowView;
+/**
+ * Assembles a nonempty iterable of compatible native columns without merging physical chunks.
+ * Encodings, dimensions, and layouts must match. CRS and opaque metadata must be the same
+ * references (or both absent); no semantic equivalence, metadata merging, or reprojection is
+ * attempted. Missing edges mean planar. Empty columns/chunks are permitted and retained.
+ * Returns a new envelope and chunk-reference list, never new typed arrays.
+ */
+export declare function concatenateGeoArrowColumns(columns: Iterable<GeoArrowColumn>): GeoArrowColumn;
+//# sourceMappingURL=views.d.ts.map

package/dist/geoarrow/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/geoarrow/views.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,cAAc,EAAC,mBAAgB;AAG3D,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,2EAA2E;IAC3E,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,4FAA4F;AAC5F,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,sFAAsF;IACtF,MAAM,EAAE,cAAc,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,wBAAiB,sBAAsB,CACrC,MAAM,EAAE,cAAc,GACrB,gBAAgB,CAAC,iBAAiB,CAAC,CAQrC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAsD5F;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,cAAc,CAqB5F"}

package/dist/geoarrow/views.js

@@ -0,0 +1,114 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { getEncodingFromChildName, isGeoArrowValueValid, sliceGeoArrowArray } from "./layout.js";
+/**
+ * Iterates native physical chunks lazily, including empty chunks, without new typed arrays.
+ * This is not a loader record-batch protocol: one loader batch may contain several chunks.
+ * Views borrow storage; callers must not mutate, recycle, or detach it while views are in use.
+ * Assumes valid physical descriptors; use validateGeoArrowColumn for untrusted input.
+ */
+export function* iterateGeoArrowBatches(column) {
+    assertNativeGeometryColumn(column);
+    let rowOffset = 0;
+    for (let chunkIndex = 0; chunkIndex < column.chunks.length; chunkIndex++) {
+        const chunk = column.chunks[chunkIndex];
+        yield { column: { ...column, chunks: [chunk] }, chunkIndex, rowOffset };
+        rowOffset += chunk.length;
+    }
+}
+/**
+ * Borrows one native geometry row, allocating descriptors but no typed arrays or coordinates.
+ * Resolves the top-level union by type ID and retains collection grouping inside the row.
+ * Indices are relative to the supplied column (including when it is already sliced).
+ * Throws for an invalid row index, serialized/box encoding, or invalid union dispatch.
+ * Assumes valid physical descriptors beyond the selected union dispatch.
+ */
+export function getGeoArrowRowView(column, rowIndex) {
+    assertNativeGeometryColumn(column);
+    if (!Number.isSafeInteger(rowIndex) || rowIndex < 0) {
+        throw new RangeError('GeoArrow row index must be a nonnegative safe integer');
+    }
+    let chunkRowIndex = rowIndex;
+    for (let chunkIndex = 0; chunkIndex < column.chunks.length; chunkIndex++) {
+        const chunk = column.chunks[chunkIndex];
+        if (chunkRowIndex >= chunk.length) {
+            chunkRowIndex -= chunk.length;
+            continue;
+        }
+        let rowColumn = {
+            ...column,
+            chunks: [sliceGeoArrowArray(chunk, chunkRowIndex, chunkRowIndex + 1)]
+        };
+        // A parent-masked union row has no child value to resolve; dispatch may be unused.
+        if (column.encoding === 'geoarrow.geometry' &&
+            isGeoArrowValueValid(chunk.validity, chunkRowIndex)) {
+            if (chunk.kind !== 'dense-union') {
+                throw new Error('Mixed GeoArrow geometry requires dense-union storage');
+            }
+            const physicalIndex = (chunk.offset || 0) + chunkRowIndex;
+            const child = chunk.children.find(candidate => candidate.typeId === chunk.typeIds[physicalIndex]);
+            const valueOffset = chunk.valueOffsets[physicalIndex];
+            if (!child ||
+                !Number.isInteger(valueOffset) ||
+                valueOffset < 0 ||
+                valueOffset >= child.data.length) {
+                throw new Error('Invalid GeoArrow union row dispatch');
+            }
+            const encoding = child.encoding || getEncodingFromChildName(child.name);
+            if (encoding === 'geoarrow.geometry') {
+                throw new Error('GeoArrow geometry union children must be concrete geometries');
+            }
+            const data = sliceGeoArrowArray(child.data, valueOffset, valueOffset + 1);
+            rowColumn = {
+                ...column,
+                encoding,
+                dimension: child.dimension ?? column.dimension,
+                coordinateLayout: child.coordinateLayout ?? column.coordinateLayout,
+                chunks: [data]
+            };
+            assertNativeGeometryColumn(rowColumn);
+        }
+        return { column: rowColumn, rowIndex, chunkIndex, chunkRowIndex };
+    }
+    throw new RangeError('GeoArrow row index exceeds column length');
+}
+/**
+ * Assembles a nonempty iterable of compatible native columns without merging physical chunks.
+ * Encodings, dimensions, and layouts must match. CRS and opaque metadata must be the same
+ * references (or both absent); no semantic equivalence, metadata merging, or reprojection is
+ * attempted. Missing edges mean planar. Empty columns/chunks are permitted and retained.
+ * Returns a new envelope and chunk-reference list, never new typed arrays.
+ */
+export function concatenateGeoArrowColumns(columns) {
+    let firstColumn;
+    const chunks = [];
+    for (const column of columns) {
+        assertNativeGeometryColumn(column);
+        if (!firstColumn) {
+            firstColumn = column;
+        }
+        else if (column.encoding !== firstColumn.encoding ||
+            column.dimension !== firstColumn.dimension ||
+            column.coordinateLayout !== firstColumn.coordinateLayout ||
+            (column.edges ?? 'planar') !== (firstColumn.edges ?? 'planar') ||
+            column.spatialReference !== firstColumn.spatialReference ||
+            column.metadata !== firstColumn.metadata) {
+            throw new Error('Cannot concatenate GeoArrow columns with different semantic envelopes');
+        }
+        for (const chunk of column.chunks)
+            chunks.push(chunk);
+    }
+    if (!firstColumn)
+        throw new Error('At least one GeoArrow column is required');
+    return { ...firstColumn, chunks };
+}
+/** Keeps borrowed geometry access distinct from decoding serialized data or interpreting boxes. */
+function assertNativeGeometryColumn(column) {
+    if (column.encoding === 'geoarrow.wkb' ||
+        column.encoding === 'geoarrow.wkt' ||
+        column.encoding === 'geoarrow.box') {
+        throw new Error('GeoArrow geometry views require native geometry; decode WKB/WKT first');
+    }
+}
+//# sourceMappingURL=views.js.map

package/dist/geoarrow/views.js.map

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