@math.gl/geospatial 5.0.0-alpha.9 → 5.0.0-beta.1

package/dist/geoarrow/types.d.ts

@@ -0,0 +1,155 @@
+import type { SpatialReference } from "../crs/index.js";
+import type { TypedArray } from '@math.gl/core';
+/** 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;
+/** Combines semantic dimensions without confusing a measure ordinate with elevation. */
+export declare function mergeGeoArrowDimensions(left: GeoArrowDimension, right: GeoArrowDimension): GeoArrowDimension;
+/**
+ * Infers the dimensions present in coordinate arrays of a tagged geometry value.
+ * Three ordinates are interpreted as XYZ; callers with XYM data should supply that semantic
+ * dimension explicitly instead of inferring it from tuple length.
+ */
+export declare function inferGeoArrowGeometryDimension(geometry: GeoArrowGeometryValue): GeoArrowDimension;
+/** 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":"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"}

package/dist/geoarrow/types.js

@@ -0,0 +1,71 @@
+// 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;
+    }
+}
+/** Combines semantic dimensions without confusing a measure ordinate with elevation. */
+export function mergeGeoArrowDimensions(left, right) {
+    const hasZ = left === 'xyz' || left === 'xyzm' || right === 'xyz' || right === 'xyzm';
+    const hasM = left === 'xym' || left === 'xyzm' || right === 'xym' || right === 'xyzm';
+    return hasZ && hasM ? 'xyzm' : hasZ ? 'xyz' : hasM ? 'xym' : 'xy';
+}
+/**
+ * Infers the dimensions present in coordinate arrays of a tagged geometry value.
+ * Three ordinates are interpreted as XYZ; callers with XYM data should supply that semantic
+ * dimension explicitly instead of inferring it from tuple length.
+ */
+export function inferGeoArrowGeometryDimension(geometry) {
+    if (geometry.type === 'GeometryCollection') {
+        return geometry.geometries.reduce((dimension, child) => mergeGeoArrowDimensions(dimension, inferGeoArrowGeometryDimension(child)), 'xy');
+    }
+    return inferCoordinateDimensions(geometry.coordinates);
+}
+/** Infers the combined dimensions of nested coordinate tuples. */
+function inferCoordinateDimensions(coordinates) {
+    if (typeof coordinates[0] === 'number') {
+        return coordinates.length >= 4 ? 'xyzm' : coordinates.length === 3 ? 'xyz' : 'xy';
+    }
+    let dimension = 'xy';
+    for (const child of coordinates) {
+        if (Array.isArray(child)) {
+            dimension = mergeGeoArrowDimensions(dimension, inferCoordinateDimensions(child));
+        }
+    }
+    return dimension;
+}
+/** 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,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CACrC,IAAuB,EACvB,KAAwB;IAExB,MAAM,IAAI,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC;IACtF,MAAM,IAAI,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC;IACtF,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAA+B;IAC5E,IAAI,QAAQ,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,CAC/B,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACnB,uBAAuB,CAAC,SAAS,EAAE,8BAA8B,CAAC,KAAK,CAAC,CAAC,EAC3E,IAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,yBAAyB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,kEAAkE;AAClE,SAAS,yBAAyB,CAAC,WAA+B;IAChE,IAAI,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,CAAC;IACD,IAAI,SAAS,GAAsB,IAAI,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS,GAAG,uBAAuB,CAAC,SAAS,EAAE,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,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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"}

package/dist/geoarrow/wkb-entry.d.ts

@@ -0,0 +1,4 @@
+/** Optional serialized-format bridge. The parser implementation lives in @math.gl/geospatial/wkb. */
+export { decodeGeoArrowWKB, decodeGeoArrowWKT, encodeGeoArrowWKB, encodeGeoArrowWKT, getGeoArrowWKBVertexCount } from "./codecs.js";
+export type { DecodeGeoArrowWKBOptions } from "./codecs.js";
+//# sourceMappingURL=wkb-entry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-entry.d.ts","sourceRoot":"","sources":["../../src/geoarrow/wkb-entry.ts"],"names":[],"mappings":"AAIA,qGAAqG;AACrG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EAC1B,oBAAiB;AAClB,YAAY,EAAC,wBAAwB,EAAC,oBAAiB"}

package/dist/geoarrow/wkb-entry.js

@@ -0,0 +1,6 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+/** Optional serialized-format bridge. The parser implementation lives in @math.gl/geospatial/wkb. */
+export { decodeGeoArrowWKB, decodeGeoArrowWKT, encodeGeoArrowWKB, encodeGeoArrowWKT, getGeoArrowWKBVertexCount } from "./codecs.js";
+//# sourceMappingURL=wkb-entry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-entry.js","sourceRoot":"","sources":["../../src/geoarrow/wkb-entry.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,qGAAqG;AACrG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EAC1B,oBAAiB"}

package/dist/geoarrow/worker.d.ts

@@ -0,0 +1,11 @@
+import type { GeoArrowColumn } from "./types.js";
+export { getGeoArrowTransferList } from "./layout.js";
+export type { GeoArrowColumn } from "./types.js";
+/** A column and the unique borrowed buffers that may be transferred with it. */
+export type GeoArrowTransfer = Readonly<{
+    column: GeoArrowColumn;
+    transferList: ArrayBuffer[];
+}>;
+/** Prepares an explicit structured-clone transfer payload without detaching any buffers. */
+export declare function prepareGeoArrowTransfer(column: GeoArrowColumn): GeoArrowTransfer;
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/geoarrow/worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,cAAc,EAAC,mBAAgB;AAG5C,OAAO,EAAC,uBAAuB,EAAC,oBAAiB;AACjD,YAAY,EAAC,cAAc,EAAC,mBAAgB;AAE5C,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC,CAAC;AAEH,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAEhF"}

package/dist/geoarrow/worker.js

@@ -0,0 +1,10 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { getGeoArrowTransferList } from "./layout.js";
+export { getGeoArrowTransferList } from "./layout.js";
+/** Prepares an explicit structured-clone transfer payload without detaching any buffers. */
+export function prepareGeoArrowTransfer(column) {
+    return { column, transferList: getGeoArrowTransferList(column) };
+}
+//# sourceMappingURL=worker.js.map

package/dist/geoarrow/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/geoarrow/worker.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAG5D,OAAO,EAAC,uBAAuB,EAAC,oBAAiB;AAEjD,OAAO,EAAC,uBAAuB,EAAC,oBAAiB;AASjD,4FAA4F;AAC5F,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,OAAO,EAAC,MAAM,EAAE,YAAY,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAAC,CAAC;AACjE,CAAC"}

package/dist/geodesic-buffer.d.ts

@@ -0,0 +1,34 @@
+import type { NumericArray } from '@math.gl/core';
+import type { GeodesicLine } from "./ellipsoid-geodesic.js";
+import type { RhumbLine } from "./ellipsoid-rhumb.js";
+export declare const GEODESIC_BUFFER_FIELDS: readonly ["lat2", "lon2", "azi2", "s12", "a12", "m12", "M12", "M21"];
+export declare const RHUMB_BUFFER_FIELDS: readonly ["lat2", "lon2", "azi12", "s12"];
+type Result = {
+    [key: string]: number | undefined;
+};
+declare class LineBuffer {
+    private readonly evaluate;
+    readonly capacity: number;
+    readonly fields: readonly string[];
+    readonly stride: number;
+    private readonly stage;
+    private readonly scratch;
+    private readonly control;
+    constructor(evaluate: (distance: number, output: Result) => Result, capacity: number, fields: readonly string[]);
+    /** Atomically write interleaved rows; input/output aliasing is supported. */
+    positions(distances: Readonly<NumericArray>, output: Float64Array): Float64Array;
+    private write;
+}
+/** Fixed-capacity sampler; prepares staging once and reuses scalar result sinks when available. */
+export declare class GeodesicLineBuffer extends LineBuffer {
+    constructor(line: Pick<GeodesicLine, 'position'>, capacity: number, options?: {
+        area?: boolean;
+    });
+}
+export declare class RhumbLineBuffer extends LineBuffer {
+    constructor(line: RhumbLine, capacity: number, options?: {
+        area?: boolean;
+    });
+}
+export {};
+//# sourceMappingURL=geodesic-buffer.d.ts.map

package/dist/geodesic-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geodesic-buffer.d.ts","sourceRoot":"","sources":["../src/geodesic-buffer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAC,YAAY,EAAC,gCAA6B;AACvD,OAAO,KAAK,EAAC,SAAS,EAAC,6BAA0B;AACjD,eAAO,MAAM,sBAAsB,sEASxB,CAAC;AACZ,eAAO,MAAM,mBAAmB,2CAA2D,CAAC;AAC5F,KAAK,MAAM,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAC,CAAC;AAQlD,cAAM,UAAU;IAQZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,EACvE,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,MAAM,EAAE;IAU3B,6EAA6E;IAC7E,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY;IAShF,OAAO,CAAC,KAAK;CA0Bd;AACD,mGAAmG;AACnG,qBAAa,kBAAmB,SAAQ,UAAU;gBAE9C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAM;CAgBjC;AACD,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAM;CAc9E"}

package/dist/geodesic-buffer.js

@@ -0,0 +1,86 @@
+export const GEODESIC_BUFFER_FIELDS = Object.freeze([
+    'lat2',
+    'lon2',
+    'azi2',
+    's12',
+    'a12',
+    'm12',
+    'M12',
+    'M21'
+]);
+export const RHUMB_BUFFER_FIELDS = Object.freeze(['lat2', 'lon2', 'azi12', 's12']);
+function shared(value) {
+    return (ArrayBuffer.isView(value) &&
+        typeof SharedArrayBuffer !== 'undefined' &&
+        value.buffer instanceof SharedArrayBuffer);
+}
+class LineBuffer {
+    constructor(evaluate, capacity, fields) {
+        this.evaluate = evaluate;
+        this.scratch = {};
+        this.control = { busy: false };
+        if (!Number.isSafeInteger(capacity) || capacity < 0 || capacity > 1e6)
+            throw new RangeError('Buffer capacity must be in [0,1000000]');
+        this.capacity = capacity;
+        this.fields = Object.freeze([...fields]);
+        this.stride = fields.length;
+        this.stage = new Float64Array(capacity * this.stride);
+        Object.freeze(this);
+    }
+    /** Atomically write interleaved rows; input/output aliasing is supported. */
+    positions(distances, output) {
+        if (this.control.busy)
+            throw new RangeError('Packed line samplers are not reentrant');
+        this.control.busy = true;
+        try {
+            return this.write(distances, output);
+        }
+        finally {
+            this.control.busy = false;
+        }
+    }
+    write(distances, output) {
+        const count = distances.length;
+        if (!Number.isSafeInteger(count) ||
+            count < 0 ||
+            count > this.capacity ||
+            !(output instanceof Float64Array) ||
+            output.length < count * this.stride ||
+            shared(distances) ||
+            shared(output))
+            throw new RangeError('Invalid packed line storage');
+        for (let i = 0; i < count; i++)
+            if (!Number.isFinite(distances[i]))
+                throw new RangeError('Expected finite distances');
+        for (let i = 0; i < count; i++) {
+            const result = this.evaluate(distances[i], this.scratch);
+            for (let field = 0; field < this.stride; field++) {
+                const value = result[this.fields[field]];
+                if (!Number.isFinite(value))
+                    throw new RangeError('Line result or requested field is not representable');
+                this.stage[i * this.stride + field] = value;
+            }
+        }
+        for (let i = 0; i < count * this.stride; i++)
+            output[i] = this.stage[i];
+        return output;
+    }
+}
+/** Fixed-capacity sampler; prepares staging once and reuses scalar result sinks when available. */
+export class GeodesicLineBuffer extends LineBuffer {
+    constructor(line, capacity, options = {}) {
+        if (!line || typeof line.position !== 'function')
+            throw new RangeError('Expected a geodesic line');
+        const position = line.position.bind(line);
+        super((distance, result) => position(distance, undefined, undefined, result), capacity, options.area ? [...GEODESIC_BUFFER_FIELDS, 'S12'] : GEODESIC_BUFFER_FIELDS);
+    }
+}
+export class RhumbLineBuffer extends LineBuffer {
+    constructor(line, capacity, options = {}) {
+        if (!line || typeof line.position !== 'function')
+            throw new RangeError('Expected a rhumb line');
+        const position = line.position.bind(line);
+        super((distance, result) => position(distance, undefined, undefined, result), capacity, options.area ? [...RHUMB_BUFFER_FIELDS, 'S12'] : RHUMB_BUFFER_FIELDS);
+    }
+}
+//# sourceMappingURL=geodesic-buffer.js.map

package/dist/geodesic-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geodesic-buffer.js","sourceRoot":"","sources":["../src/geodesic-buffer.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACG,CAAC,CAAC;AACZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC,CAAC;AAE5F,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,CACL,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QACzB,OAAO,iBAAiB,KAAK,WAAW;QACxC,KAAK,CAAC,MAAM,YAAY,iBAAiB,CAC1C,CAAC;AACJ,CAAC;AACD,MAAM,UAAU;IAOd,YACmB,QAAsD,EACvE,QAAgB,EAChB,MAAyB;QAFR,aAAQ,GAAR,QAAQ,CAA8C;QAHxD,YAAO,GAAW,EAAE,CAAC;QACrB,YAAO,GAAG,EAAC,IAAI,EAAE,KAAK,EAAC,CAAC;QAMvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,GAAG;YACnE,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,6EAA6E;IAC7E,SAAS,CAAC,SAAiC,EAAE,MAAoB;QAC/D,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;QACtF,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IACO,KAAK,CAAC,SAAiC,EAAE,MAAoB;QACnE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC;QAC/B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAC5B,KAAK,GAAG,CAAC;YACT,KAAK,GAAG,IAAI,CAAC,QAAQ;YACrB,CAAC,CAAC,MAAM,YAAY,YAAY,CAAC;YACjC,MAAM,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM;YACnC,MAAM,CAAC,SAAS,CAAC;YACjB,MAAM,CAAC,MAAM,CAAC;YAEd,MAAM,IAAI,UAAU,CAAC,6BAA6B,CAAC,CAAC;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,CAAC,CAAC;QACxF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACzB,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;gBAC9E,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,KAAM,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AACD,mGAAmG;AACnG,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YACE,IAAoC,EACpC,QAAgB,EAChB,UAA4B,EAAE;QAE9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU;YAC9C,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAK7B,CAAC;QACZ,KAAK,CACH,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EACtE,QAAQ,EACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAC3E,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,IAAe,EAAE,QAAgB,EAAE,UAA4B,EAAE;QAC3E,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU;YAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAK7B,CAAC;QACZ,KAAK,CACH,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EACtE,QAAQ,EACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,mBAAmB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACrE,CAAC;IACJ,CAAC;CACF"}

package/dist/geodesic-exact/area.d.ts

@@ -0,0 +1,5 @@
+/** Integrate the smooth correction, evaluating t's divided difference as an
+ * integral of its derivative rather than subtracting nearly equal t values.
+ */
+export declare function areaCorrection(ep2: number, k2: number, s1: number, c1: number, delta: number): number;
+//# sourceMappingURL=area.d.ts.map

package/dist/geodesic-exact/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../../src/geodesic-exact/area.ts"],"names":[],"mappings":"AAyCA;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,MAAM,CAmBR"}