@sqlrooms/deck 0.29.0-rc.5 → 0.29.0-rc.6

package/dist/prepare/wkbDecoder.js

@@ -1,6 +1,15 @@
 import { WKBLoader, WKTLoader } from '@loaders.gl/wkt';
-import { Field, FixedSizeList, Float64, Table, vectorFromArray, } from 'apache-arrow';
+import { Field, FixedSizeList, Float64, List, makeData, Table, Vector, } from 'apache-arrow';
 import { buildBinaryGeoJsonData } from './toGeoJsonBinary';
+import { parseWKBHeader, readWKBPointXY, visitWKBMultiPolygonCoordinates, visitWKBPolygonCoordinates, WKB_MULTIPOLYGON, WKB_POINT, WKB_POLYGON, } from './wkbParser';
+const COORD_FIELD = new Field('xy', new Float64(), false);
+const VERTEX_TYPE = new FixedSizeList(2, COORD_FIELD);
+const VERTEX_FIELD = new Field('', VERTEX_TYPE, true);
+const RING_TYPE = new List(VERTEX_FIELD);
+const RING_FIELD = new Field('', RING_TYPE, true);
+const POLYGON_TYPE = new List(RING_FIELD);
+const GEOMETRY_SAMPLE_LIMIT = 100;
+const BITS_PER_VALIDITY_BYTE = 8;
 function toArrayBuffer(value) {
     if (ArrayBuffer.isView(value)) {
         const copy = new Uint8Array(value.byteLength);
@@ -9,14 +18,51 @@ function toArrayBuffer(value) {
     }
     return value;
 }
-function parseGeometryValue(value, encoding) {
-    if (value == null) {
+function isWKTEncoding(encoding, value) {
+    return (encoding === 'wkt' ||
+        encoding === 'geoarrow.wkt' ||
+        (encoding === 'unknown' && typeof value === 'string'));
+}
+function buildNullBitmap(n, isNull, nullCount) {
+    if (nullCount === 0)
         return null;
+    const bitmap = new Uint8Array(Math.ceil(n / BITS_PER_VALIDITY_BYTE));
+    for (let i = 0; i < n; i++) {
+        if (isNull[i] !== 1)
+            setValidityBit(bitmap, i);
+    }
+    return bitmap;
+}
+function setValidityBit(bitmap, rowIndex) {
+    const byteIndex = Math.floor(rowIndex / BITS_PER_VALIDITY_BYTE);
+    const bitIndex = rowIndex % BITS_PER_VALIDITY_BYTE;
+    bitmap[byteIndex] |= 1 << bitIndex;
+}
+function buildPromotedResult(table, columnName, promotedGeometry, encoding) {
+    const columns = {};
+    for (const field of table.schema.fields) {
+        columns[field.name] =
+            field.name === columnName
+                ? promotedGeometry
+                : table.getChild(field.name);
     }
+    const promotedTable = new Table(columns);
+    return {
+        table: promotedTable,
+        geometryColumnName: columnName,
+        geometryColumn: promotedTable.getChild(columnName),
+        encoding,
+        source: 'promoted',
+    };
+}
+function parseGeometryValue(value, encoding) {
+    if (value == null)
+        return null;
     try {
-        if (encoding === 'wkt' ||
-            encoding === 'geoarrow.wkt' ||
-            (encoding === 'unknown' && typeof value === 'string')) {
+        if (isWKTEncoding(encoding, value)) {
+            // Keep WKT support for ST_AsText(...) and geoarrow.wkt inputs.
+            // The upstream WKB parser plan does not cover WKT.
+            // See: https://github.com/geoarrow/geoarrow-js/issues/54
             return (WKTLoader.parseTextSync?.(String(value), { wkt: { crs: false } }) ?? null);
         }
         return (WKBLoader.parseSync?.(toArrayBuffer(value), {
@@ -25,99 +71,252 @@ function parseGeometryValue(value, encoding) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        if (message.includes('WKB: Unsupported geometry type: 0')) {
+        if (message.includes('WKB: Unsupported geometry type: 0') ||
+            message.includes('WKB: Unsupported iso-wkb type')) {
             throw new Error('DuckDB GEOMETRY values are not WKB by default. Select ST_AsWKB(geom) AS geom or ST_AsText(geom) AS geom before passing the result to DeckJsonMap.');
         }
         throw error instanceof Error ? error : new Error(message);
     }
 }
-function getSampleGeometry(table, columnName, encoding) {
+function getSampleWKBGeomTypes(table, columnName, sampleLimit = GEOMETRY_SAMPLE_LIMIT) {
     const vector = table.getChild(columnName);
-    if (!vector) {
+    if (!vector)
         return null;
+    const geomTypes = [];
+    for (let i = 0; i < table.numRows; i++) {
+        const raw = vector.get(i);
+        if (raw == null)
+            continue;
+        const hdr = parseWKBHeader(toArrayBuffer(raw));
+        if (!hdr)
+            return null;
+        geomTypes.push(hdr.geomType);
+        if (geomTypes.length >= sampleLimit)
+            break;
+    }
+    return geomTypes;
+}
+function getSampleGeometryTypes(table, columnName, encoding, sampleLimit = GEOMETRY_SAMPLE_LIMIT) {
+    const vector = table.getChild(columnName);
+    if (!vector)
+        return null;
+    const geometryTypes = [];
+    for (let i = 0; i < table.numRows; i++) {
+        const geometry = parseGeometryValue(vector.get(i), encoding);
+        if (!geometry)
+            continue;
+        geometryTypes.push(geometry.type);
+        if (geometryTypes.length >= sampleLimit)
+            break;
+    }
+    return geometryTypes;
+}
+function appendPolygonCoordinates(rings, ringOffsetsList, xyList) {
+    for (const ring of rings) {
+        ringOffsetsList.push(xyList.length / 2);
+        for (const point of ring) {
+            xyList.push(point[0], point[1]);
+        }
+    }
+}
+function sampledGeometriesMatch(table, columnName, encoding, matchesParsedType, matchesWKBType) {
+    try {
+        const geometryTypes = getSampleGeometryTypes(table, columnName, encoding);
+        return geometryTypes != null && geometryTypes.every(matchesParsedType);
+    }
+    catch {
+        try {
+            const geomTypes = getSampleWKBGeomTypes(table, columnName);
+            return geomTypes != null && geomTypes.every(matchesWKBType);
+        }
+        catch {
+            return false;
+        }
     }
-    for (let rowIndex = 0; rowIndex < table.numRows; rowIndex++) {
-        const geometry = parseGeometryValue(vector.get(rowIndex), encoding);
-        if (geometry) {
-            return geometry;
+}
+function tryPromotePolygonTable(table, columnName, encoding) {
+    const vector = table.getChild(columnName);
+    if (!vector)
+        return null;
+    const n = table.numRows;
+    const polygonOffsets = new Int32Array(n + 1);
+    const ringOffsetsList = [];
+    const xyList = [];
+    const isNull = new Uint8Array(n);
+    let nullCount = 0;
+    const polygonVisitor = {
+        onRingStart: () => ringOffsetsList.push(xyList.length / 2),
+        onCoordinate: (x, y) => xyList.push(x, y),
+    };
+    for (let i = 0; i < n; i++) {
+        polygonOffsets[i] = ringOffsetsList.length;
+        const raw = vector.get(i);
+        if (raw == null) {
+            isNull[i] = 1;
+            nullCount++;
+            continue;
+        }
+        if (isWKTEncoding(encoding, raw)) {
+            const geom = parseGeometryValue(raw, encoding);
+            if (!geom) {
+                isNull[i] = 1;
+                nullCount++;
+                continue;
+            }
+            if (geom.type === 'Polygon') {
+                appendPolygonCoordinates(geom.coordinates, ringOffsetsList, xyList);
+            }
+            else if (geom.type === 'MultiPolygon') {
+                for (const polygon of geom.coordinates) {
+                    appendPolygonCoordinates(polygon, ringOffsetsList, xyList);
+                }
+            }
+            else
+                return null;
+            continue;
         }
+        const buf = toArrayBuffer(raw);
+        const hdr = parseWKBHeader(buf);
+        if (!hdr)
+            return null;
+        if (hdr.geomType === WKB_POLYGON) {
+            if (visitWKBPolygonCoordinates(buf, hdr, polygonVisitor) == null) {
+                return null;
+            }
+        }
+        else if (hdr.geomType === WKB_MULTIPOLYGON) {
+            if (!visitWKBMultiPolygonCoordinates(buf, hdr, polygonVisitor)) {
+                return null;
+            }
+        }
+        else
+            return null;
     }
-    return null;
+    polygonOffsets[n] = ringOffsetsList.length;
+    const totalRings = ringOffsetsList.length;
+    const totalPoints = xyList.length / 2;
+    const ringOffsets = new Int32Array(totalRings + 1);
+    for (let j = 0; j < totalRings; j++)
+        ringOffsets[j] = ringOffsetsList[j];
+    ringOffsets[totalRings] = totalPoints;
+    const flatCoords = new Float64Array(xyList);
+    const floatData = makeData({
+        type: new Float64(),
+        length: totalPoints * 2,
+        data: flatCoords,
+    });
+    const pointData = makeData({
+        type: VERTEX_TYPE,
+        length: totalPoints,
+        child: floatData,
+    });
+    const ringData = makeData({
+        type: RING_TYPE,
+        length: totalRings,
+        valueOffsets: ringOffsets,
+        child: pointData,
+    });
+    const polyData = makeData({
+        type: POLYGON_TYPE,
+        length: n,
+        nullCount,
+        nullBitmap: buildNullBitmap(n, isNull, nullCount),
+        valueOffsets: polygonOffsets,
+        child: ringData,
+    });
+    return buildPromotedResult(table, columnName, new Vector([polyData]), 'geoarrow.polygon');
 }
 /**
  * Attempt to promote WKB/WKT Point geometries into a native GeoArrow
- * FixedSizeList column.  Returns `null` if any non-null geometry is not
+ * FixedSizeList column. Returns `null` if any non-null geometry is not
  * a Point, so callers can fall back to the GeoJSON binary path.
  */
 function tryPromotePointTable(table, columnName, encoding) {
     const vector = table.getChild(columnName);
-    if (!vector) {
+    if (!vector)
         return null;
-    }
-    const points = [];
-    for (let rowIndex = 0; rowIndex < table.numRows; rowIndex++) {
-        const geometry = parseGeometryValue(vector.get(rowIndex), encoding);
-        if (!geometry) {
-            points.push(null);
-            continue;
-        }
-        if (geometry.type !== 'Point') {
-            return null;
-        }
-        if (!('coordinates' in geometry)) {
-            points.push(null);
+    const n = table.numRows;
+    const xyValues = new Float64Array(n * 2);
+    const isNull = new Uint8Array(n);
+    let nullCount = 0;
+    const markNullPoint = (rowIndex) => {
+        isNull[rowIndex] = 1;
+        xyValues[rowIndex * 2] = Number.NaN;
+        xyValues[rowIndex * 2 + 1] = Number.NaN;
+        nullCount++;
+    };
+    for (let i = 0; i < n; i++) {
+        const raw = vector.get(i);
+        if (raw == null) {
+            markNullPoint(i);
             continue;
         }
-        const coords = geometry.coordinates;
-        if (!Array.isArray(coords) ||
-            coords.length < 2 ||
-            !Number.isFinite(coords[0]) ||
-            !Number.isFinite(coords[1])) {
-            points.push(null);
+        if (isWKTEncoding(encoding, raw)) {
+            const geom = parseGeometryValue(raw, encoding);
+            if (!geom) {
+                markNullPoint(i);
+                continue;
+            }
+            if (geom.type !== 'Point')
+                return null;
+            const c = geom.coordinates;
+            xyValues[i * 2] = c[0];
+            xyValues[i * 2 + 1] = c[1];
             continue;
         }
-        points.push([coords[0], coords[1]]);
-    }
-    const coordinateField = new Field('xy', new Float64());
-    const geomType = new FixedSizeList(2, coordinateField);
-    const promotedGeometry = vectorFromArray(points, geomType);
-    const nextColumns = {};
-    for (const field of table.schema.fields) {
-        nextColumns[field.name] =
-            field.name === columnName
-                ? promotedGeometry
-                : table.getChild(field.name);
+        const hdr = parseWKBHeader(toArrayBuffer(raw));
+        if (!hdr)
+            return null;
+        const xy = readWKBPointXY(hdr);
+        if (!xy)
+            return null;
+        xyValues[i * 2] = xy[0];
+        xyValues[i * 2 + 1] = xy[1];
     }
-    const promotedTable = new Table(nextColumns);
-    return {
-        table: promotedTable,
-        geometryColumnName: columnName,
-        geometryColumn: promotedTable.getChild(columnName),
-        encoding: 'geoarrow.point',
-        source: 'promoted',
-    };
+    const floatData = makeData({
+        type: new Float64(),
+        length: n * 2,
+        data: xyValues,
+    });
+    const geomData = makeData({
+        type: VERTEX_TYPE,
+        length: n,
+        nullCount,
+        nullBitmap: buildNullBitmap(n, isNull, nullCount),
+        child: floatData,
+    });
+    return buildPromotedResult(table, columnName, new Vector([geomData]), 'geoarrow.point');
 }
+const POINT_LAYERS = new Set([
+    'GeoArrowScatterplotLayer',
+    'GeoArrowHeatmapLayer',
+    'GeoArrowColumnLayer',
+]);
+const POLYGON_LAYERS = new Set([
+    'GeoArrowPolygonLayer',
+    'GeoArrowSolidPolygonLayer',
+]);
 export const wkbGeometryDecoder = {
     supportsGeoArrowPromotion(layerType, encoding, table, columnName) {
         if (!['wkb', 'geoarrow.wkb', 'wkt', 'geoarrow.wkt', 'unknown'].includes(encoding)) {
             return false;
         }
-        if (![
-            'GeoArrowScatterplotLayer',
-            'GeoArrowHeatmapLayer',
-            'GeoArrowColumnLayer',
-        ].includes(layerType)) {
-            return false;
+        if (POINT_LAYERS.has(layerType)) {
+            return sampledGeometriesMatch(table, columnName, encoding, (geometryType) => geometryType === 'Point', (geometryType) => geometryType === WKB_POINT);
         }
-        const sampleGeometry = getSampleGeometry(table, columnName, encoding);
-        return sampleGeometry == null || sampleGeometry.type === 'Point';
+        if (POLYGON_LAYERS.has(layerType)) {
+            return sampledGeometriesMatch(table, columnName, encoding, (geometryType) => geometryType === 'Polygon' || geometryType === 'MultiPolygon', (geometryType) => geometryType === WKB_POLYGON || geometryType === WKB_MULTIPOLYGON);
+        }
+        return false;
     },
     toGeoArrowLike(table, columnName, encoding) {
-        const result = tryPromotePointTable(table, columnName, encoding);
-        if (!result) {
-            throw new Error('GeoArrow promotion failed: column contains non-Point geometries.');
-        }
-        return result;
+        const pointResult = tryPromotePointTable(table, columnName, encoding);
+        if (pointResult)
+            return pointResult;
+        const result = tryPromotePolygonTable(table, columnName, encoding);
+        if (result)
+            return result;
+        throw new Error('GeoArrow promotion failed: unsupported geometry type for column.');
     },
     toGeoJsonBinary(table, columnName, encoding) {
         return buildBinaryGeoJsonData({

package/dist/prepare/wkbDecoder.js.map

@@ -1 +1 @@
-{"version":3,"file":"wkbDecoder.js","sourceRoot":"","sources":["../../src/prepare/wkbDecoder.ts"],"names":[],"mappings":"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","sourcesContent":["import {WKBLoader, WKTLoader} from '@loaders.gl/wkt';\nimport type * as arrow from 'apache-arrow';\nimport {\n  Field,\n  FixedSizeList,\n  Float64,\n  Table,\n  vectorFromArray,\n} from 'apache-arrow';\nimport type {GeometryDecoder} from './geometryDecoder';\nimport {buildBinaryGeoJsonData} from './toGeoJsonBinary';\nimport type {\n  PreparedGeoArrowLayerData,\n  ResolvedGeometryEncoding,\n} from './types';\n\nfunction toArrayBuffer(value: unknown) {\n  if (ArrayBuffer.isView(value)) {\n    const copy = new Uint8Array(value.byteLength);\n    copy.set(\n      new Uint8Array(value.buffer, value.byteOffset, value.byteLength),\n      0,\n    );\n    return copy.buffer;\n  }\n  return value as ArrayBuffer;\n}\n\nfunction parseGeometryValue(\n  value: unknown,\n  encoding: ResolvedGeometryEncoding,\n) {\n  if (value == null) {\n    return null;\n  }\n\n  try {\n    if (\n      encoding === 'wkt' ||\n      encoding === 'geoarrow.wkt' ||\n      (encoding === 'unknown' && typeof value === 'string')\n    ) {\n      return (\n        WKTLoader.parseTextSync?.(String(value), {wkt: {crs: false}}) ?? null\n      );\n    }\n\n    return (\n      WKBLoader.parseSync?.(toArrayBuffer(value), {\n        wkb: {shape: 'geojson-geometry'},\n      }) ?? null\n    );\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    if (message.includes('WKB: Unsupported geometry type: 0')) {\n      throw new Error(\n        'DuckDB GEOMETRY values are not WKB by default. Select ST_AsWKB(geom) AS geom or ST_AsText(geom) AS geom before passing the result to DeckJsonMap.',\n      );\n    }\n\n    throw error instanceof Error ? error : new Error(message);\n  }\n}\n\nfunction getSampleGeometry(\n  table: arrow.Table,\n  columnName: string,\n  encoding: ResolvedGeometryEncoding,\n) {\n  const vector = table.getChild(columnName);\n  if (!vector) {\n    return null;\n  }\n\n  for (let rowIndex = 0; rowIndex < table.numRows; rowIndex++) {\n    const geometry = parseGeometryValue(vector.get(rowIndex), encoding);\n    if (geometry) {\n      return geometry;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Attempt to promote WKB/WKT Point geometries into a native GeoArrow\n * FixedSizeList column.  Returns `null` if any non-null geometry is not\n * a Point, so callers can fall back to the GeoJSON binary path.\n */\nfunction tryPromotePointTable(\n  table: arrow.Table,\n  columnName: string,\n  encoding: ResolvedGeometryEncoding,\n): PreparedGeoArrowLayerData | null {\n  const vector = table.getChild(columnName);\n  if (!vector) {\n    return null;\n  }\n\n  const points = [];\n  for (let rowIndex = 0; rowIndex < table.numRows; rowIndex++) {\n    const geometry = parseGeometryValue(vector.get(rowIndex), encoding);\n    if (!geometry) {\n      points.push(null);\n      continue;\n    }\n\n    if (geometry.type !== 'Point') {\n      return null;\n    }\n\n    if (!('coordinates' in geometry)) {\n      points.push(null);\n      continue;\n    }\n\n    const coords = geometry.coordinates;\n    if (\n      !Array.isArray(coords) ||\n      coords.length < 2 ||\n      !Number.isFinite(coords[0]) ||\n      !Number.isFinite(coords[1])\n    ) {\n      points.push(null);\n      continue;\n    }\n\n    points.push([coords[0], coords[1]]);\n  }\n\n  const coordinateField = new Field('xy', new Float64());\n  const geomType = new FixedSizeList(2, coordinateField);\n  const promotedGeometry = vectorFromArray(points, geomType);\n\n  const nextColumns: Record<string, arrow.Vector> = {};\n  for (const field of table.schema.fields) {\n    nextColumns[field.name] =\n      field.name === columnName\n        ? promotedGeometry\n        : (table.getChild(field.name) as arrow.Vector);\n  }\n\n  const promotedTable = new Table(nextColumns);\n\n  return {\n    table: promotedTable,\n    geometryColumnName: columnName,\n    geometryColumn: promotedTable.getChild(columnName)!,\n    encoding: 'geoarrow.point',\n    source: 'promoted',\n  };\n}\n\nexport const wkbGeometryDecoder: GeometryDecoder = {\n  supportsGeoArrowPromotion(\n    layerType: string,\n    encoding: ResolvedGeometryEncoding,\n    table: arrow.Table,\n    columnName: string,\n  ) {\n    if (\n      !['wkb', 'geoarrow.wkb', 'wkt', 'geoarrow.wkt', 'unknown'].includes(\n        encoding,\n      )\n    ) {\n      return false;\n    }\n\n    if (\n      ![\n        'GeoArrowScatterplotLayer',\n        'GeoArrowHeatmapLayer',\n        'GeoArrowColumnLayer',\n      ].includes(layerType)\n    ) {\n      return false;\n    }\n\n    const sampleGeometry = getSampleGeometry(table, columnName, encoding);\n    return sampleGeometry == null || sampleGeometry.type === 'Point';\n  },\n  toGeoArrowLike(\n    table: arrow.Table,\n    columnName: string,\n    encoding: ResolvedGeometryEncoding,\n  ) {\n    const result = tryPromotePointTable(table, columnName, encoding);\n    if (!result) {\n      throw new Error(\n        'GeoArrow promotion failed: column contains non-Point geometries.',\n      );\n    }\n    return result;\n  },\n  toGeoJsonBinary(\n    table: arrow.Table,\n    columnName: string,\n    encoding: ResolvedGeometryEncoding,\n  ) {\n    return buildBinaryGeoJsonData({\n      table,\n      geometryColumnName: columnName,\n      getGeometryAt: (rowIndex) => {\n        const value = table.getChild(columnName)?.get(rowIndex);\n        return parseGeometryValue(value, encoding);\n      },\n    });\n  },\n};\n"]}
+{"version":3,"file":"wkbDecoder.js","sourceRoot":"","sources":["../../src/prepare/wkbDecoder.ts"],"names":[],"mappings":"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","sourcesContent":["import {WKBLoader, WKTLoader} from '@loaders.gl/wkt';\nimport type * as arrow from 'apache-arrow';\nimport {\n  Field,\n  FixedSizeList,\n  Float64,\n  List,\n  makeData,\n  Table,\n  Vector,\n} from 'apache-arrow';\nimport type {GeometryDecoder} from './geometryDecoder';\nimport {buildBinaryGeoJsonData} from './toGeoJsonBinary';\nimport type {\n  PreparedGeoArrowLayerData,\n  ResolvedGeometryEncoding,\n} from './types';\nimport {\n  parseWKBHeader,\n  readWKBPointXY,\n  visitWKBMultiPolygonCoordinates,\n  visitWKBPolygonCoordinates,\n  WKB_MULTIPOLYGON,\n  WKB_POINT,\n  WKB_POLYGON,\n} from './wkbParser';\n\nconst COORD_FIELD = new Field('xy', new Float64(), false);\nconst VERTEX_TYPE = new FixedSizeList(2, COORD_FIELD);\nconst VERTEX_FIELD = new Field('', VERTEX_TYPE, true);\nconst RING_TYPE = new List(VERTEX_FIELD);\nconst RING_FIELD = new Field('', RING_TYPE, true);\nconst POLYGON_TYPE = new List(RING_FIELD);\n\nconst GEOMETRY_SAMPLE_LIMIT = 100;\nconst BITS_PER_VALIDITY_BYTE = 8;\n\nfunction toArrayBuffer(value: unknown): ArrayBuffer {\n  if (ArrayBuffer.isView(value)) {\n    const copy = new Uint8Array(value.byteLength);\n    copy.set(\n      new Uint8Array(value.buffer, value.byteOffset, value.byteLength),\n      0,\n    );\n    return copy.buffer;\n  }\n  return value as ArrayBuffer;\n}\n\nfunction isWKTEncoding(\n  encoding: ResolvedGeometryEncoding,\n  value: unknown,\n): boolean {\n  return (\n    encoding === 'wkt' ||\n    encoding === 'geoarrow.wkt' ||\n    (encoding === 'unknown' && typeof value === 'string')\n  );\n}\n\nfunction buildNullBitmap(\n  n: number,\n  isNull: Uint8Array,\n  nullCount: number,\n): Uint8Array | null {\n  if (nullCount === 0) return null;\n  const bitmap = new Uint8Array(Math.ceil(n / BITS_PER_VALIDITY_BYTE));\n  for (let i = 0; i < n; i++) {\n    if (isNull[i] !== 1) setValidityBit(bitmap, i);\n  }\n  return bitmap;\n}\n\nfunction setValidityBit(bitmap: Uint8Array, rowIndex: number) {\n  const byteIndex = Math.floor(rowIndex / BITS_PER_VALIDITY_BYTE);\n  const bitIndex = rowIndex % BITS_PER_VALIDITY_BYTE;\n  bitmap[byteIndex]! |= 1 << bitIndex;\n}\n\nfunction buildPromotedResult(\n  table: arrow.Table,\n  columnName: string,\n  promotedGeometry: arrow.Vector,\n  encoding: PreparedGeoArrowLayerData['encoding'],\n): PreparedGeoArrowLayerData {\n  const columns: Record<string, arrow.Vector> = {};\n  for (const field of table.schema.fields) {\n    columns[field.name] =\n      field.name === columnName\n        ? promotedGeometry\n        : (table.getChild(field.name) as arrow.Vector);\n  }\n  const promotedTable = new Table(columns);\n  return {\n    table: promotedTable,\n    geometryColumnName: columnName,\n    geometryColumn: promotedTable.getChild(columnName)!,\n    encoding,\n    source: 'promoted',\n  };\n}\n\nfunction parseGeometryValue(\n  value: unknown,\n  encoding: ResolvedGeometryEncoding,\n) {\n  if (value == null) return null;\n\n  try {\n    if (isWKTEncoding(encoding, value)) {\n      // Keep WKT support for ST_AsText(...) and geoarrow.wkt inputs.\n      // The upstream WKB parser plan does not cover WKT.\n      // See: https://github.com/geoarrow/geoarrow-js/issues/54\n      return (\n        WKTLoader.parseTextSync?.(String(value), {wkt: {crs: false}}) ?? null\n      );\n    }\n\n    return (\n      WKBLoader.parseSync?.(toArrayBuffer(value), {\n        wkb: {shape: 'geojson-geometry'},\n      }) ?? null\n    );\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    if (\n      message.includes('WKB: Unsupported geometry type: 0') ||\n      message.includes('WKB: Unsupported iso-wkb type')\n    ) {\n      throw new Error(\n        'DuckDB GEOMETRY values are not WKB by default. Select ST_AsWKB(geom) AS geom or ST_AsText(geom) AS geom before passing the result to DeckJsonMap.',\n      );\n    }\n    throw error instanceof Error ? error : new Error(message);\n  }\n}\n\nfunction getSampleWKBGeomTypes(\n  table: arrow.Table,\n  columnName: string,\n  sampleLimit = GEOMETRY_SAMPLE_LIMIT,\n): number[] | null {\n  const vector = table.getChild(columnName);\n  if (!vector) return null;\n  const geomTypes: number[] = [];\n  for (let i = 0; i < table.numRows; i++) {\n    const raw = vector.get(i);\n    if (raw == null) continue;\n    const hdr = parseWKBHeader(toArrayBuffer(raw));\n    if (!hdr) return null;\n    geomTypes.push(hdr.geomType);\n    if (geomTypes.length >= sampleLimit) break;\n  }\n  return geomTypes;\n}\n\nfunction getSampleGeometryTypes(\n  table: arrow.Table,\n  columnName: string,\n  encoding: ResolvedGeometryEncoding,\n  sampleLimit = GEOMETRY_SAMPLE_LIMIT,\n): string[] | null {\n  const vector = table.getChild(columnName);\n  if (!vector) return null;\n  const geometryTypes: string[] = [];\n\n  for (let i = 0; i < table.numRows; i++) {\n    const geometry = parseGeometryValue(vector.get(i), encoding);\n    if (!geometry) continue;\n    geometryTypes.push(geometry.type);\n    if (geometryTypes.length >= sampleLimit) break;\n  }\n  return geometryTypes;\n}\n\nfunction appendPolygonCoordinates(\n  rings: number[][][],\n  ringOffsetsList: number[],\n  xyList: number[],\n) {\n  for (const ring of rings) {\n    ringOffsetsList.push(xyList.length / 2);\n    for (const point of ring) {\n      xyList.push(point[0]!, point[1]!);\n    }\n  }\n}\n\nfunction sampledGeometriesMatch(\n  table: arrow.Table,\n  columnName: string,\n  encoding: ResolvedGeometryEncoding,\n  matchesParsedType: (geometryType: string) => boolean,\n  matchesWKBType: (geometryType: number) => boolean,\n) {\n  try {\n    const geometryTypes = getSampleGeometryTypes(table, columnName, encoding);\n    return geometryTypes != null && geometryTypes.every(matchesParsedType);\n  } catch {\n    try {\n      const geomTypes = getSampleWKBGeomTypes(table, columnName);\n      return geomTypes != null && geomTypes.every(matchesWKBType);\n    } catch {\n      return false;\n    }\n  }\n}\n\nfunction tryPromotePolygonTable(\n  table: arrow.Table,\n  columnName: string,\n  encoding: ResolvedGeometryEncoding,\n): PreparedGeoArrowLayerData | null {\n  const vector = table.getChild(columnName);\n  if (!vector) return null;\n\n  const n = table.numRows;\n  const polygonOffsets = new Int32Array(n + 1);\n  const ringOffsetsList: number[] = [];\n  const xyList: number[] = [];\n  const isNull = new Uint8Array(n);\n  let nullCount = 0;\n  const polygonVisitor = {\n    onRingStart: () => ringOffsetsList.push(xyList.length / 2),\n    onCoordinate: (x: number, y: number) => xyList.push(x, y),\n  };\n\n  for (let i = 0; i < n; i++) {\n    polygonOffsets[i] = ringOffsetsList.length;\n    const raw = vector.get(i);\n\n    if (raw == null) {\n      isNull[i] = 1;\n      nullCount++;\n      continue;\n    }\n\n    if (isWKTEncoding(encoding, raw)) {\n      const geom = parseGeometryValue(raw, encoding);\n      if (!geom) {\n        isNull[i] = 1;\n        nullCount++;\n        continue;\n      }\n      if (geom.type === 'Polygon') {\n        appendPolygonCoordinates(\n          geom.coordinates as number[][][],\n          ringOffsetsList,\n          xyList,\n        );\n      } else if (geom.type === 'MultiPolygon') {\n        for (const polygon of geom.coordinates as number[][][][]) {\n          appendPolygonCoordinates(polygon, ringOffsetsList, xyList);\n        }\n      } else return null;\n      continue;\n    }\n\n    const buf = toArrayBuffer(raw);\n    const hdr = parseWKBHeader(buf);\n    if (!hdr) return null;\n\n    if (hdr.geomType === WKB_POLYGON) {\n      if (visitWKBPolygonCoordinates(buf, hdr, polygonVisitor) == null) {\n        return null;\n      }\n    } else if (hdr.geomType === WKB_MULTIPOLYGON) {\n      if (!visitWKBMultiPolygonCoordinates(buf, hdr, polygonVisitor)) {\n        return null;\n      }\n    } else return null;\n  }\n  polygonOffsets[n] = ringOffsetsList.length;\n\n  const totalRings = ringOffsetsList.length;\n  const totalPoints = xyList.length / 2;\n\n  const ringOffsets = new Int32Array(totalRings + 1);\n  for (let j = 0; j < totalRings; j++) ringOffsets[j] = ringOffsetsList[j]!;\n  ringOffsets[totalRings] = totalPoints;\n\n  const flatCoords = new Float64Array(xyList);\n  const floatData = makeData({\n    type: new Float64(),\n    length: totalPoints * 2,\n    data: flatCoords,\n  });\n  const pointData = makeData({\n    type: VERTEX_TYPE,\n    length: totalPoints,\n    child: floatData,\n  });\n  const ringData = makeData({\n    type: RING_TYPE,\n    length: totalRings,\n    valueOffsets: ringOffsets,\n    child: pointData,\n  });\n  const polyData = makeData({\n    type: POLYGON_TYPE,\n    length: n,\n    nullCount,\n    nullBitmap: buildNullBitmap(n, isNull, nullCount),\n    valueOffsets: polygonOffsets,\n    child: ringData,\n  });\n  return buildPromotedResult(\n    table,\n    columnName,\n    new Vector([polyData]),\n    'geoarrow.polygon',\n  );\n}\n\n/**\n * Attempt to promote WKB/WKT Point geometries into a native GeoArrow\n * FixedSizeList column. Returns `null` if any non-null geometry is not\n * a Point, so callers can fall back to the GeoJSON binary path.\n */\nfunction tryPromotePointTable(\n  table: arrow.Table,\n  columnName: string,\n  encoding: ResolvedGeometryEncoding,\n): PreparedGeoArrowLayerData | null {\n  const vector = table.getChild(columnName);\n  if (!vector) return null;\n\n  const n = table.numRows;\n  const xyValues = new Float64Array(n * 2);\n  const isNull = new Uint8Array(n);\n  let nullCount = 0;\n\n  const markNullPoint = (rowIndex: number) => {\n    isNull[rowIndex] = 1;\n    xyValues[rowIndex * 2] = Number.NaN;\n    xyValues[rowIndex * 2 + 1] = Number.NaN;\n    nullCount++;\n  };\n\n  for (let i = 0; i < n; i++) {\n    const raw = vector.get(i);\n    if (raw == null) {\n      markNullPoint(i);\n      continue;\n    }\n\n    if (isWKTEncoding(encoding, raw)) {\n      const geom = parseGeometryValue(raw, encoding);\n      if (!geom) {\n        markNullPoint(i);\n        continue;\n      }\n      if (geom.type !== 'Point') return null;\n      const c = geom.coordinates as number[];\n      xyValues[i * 2] = c[0]!;\n      xyValues[i * 2 + 1] = c[1]!;\n      continue;\n    }\n\n    const hdr = parseWKBHeader(toArrayBuffer(raw));\n    if (!hdr) return null;\n    const xy = readWKBPointXY(hdr);\n    if (!xy) return null;\n    xyValues[i * 2] = xy[0];\n    xyValues[i * 2 + 1] = xy[1];\n  }\n\n  const floatData = makeData({\n    type: new Float64(),\n    length: n * 2,\n    data: xyValues,\n  });\n  const geomData = makeData({\n    type: VERTEX_TYPE,\n    length: n,\n    nullCount,\n    nullBitmap: buildNullBitmap(n, isNull, nullCount),\n    child: floatData,\n  });\n  return buildPromotedResult(\n    table,\n    columnName,\n    new Vector([geomData]),\n    'geoarrow.point',\n  );\n}\n\nconst POINT_LAYERS = new Set([\n  'GeoArrowScatterplotLayer',\n  'GeoArrowHeatmapLayer',\n  'GeoArrowColumnLayer',\n]);\n\nconst POLYGON_LAYERS = new Set([\n  'GeoArrowPolygonLayer',\n  'GeoArrowSolidPolygonLayer',\n]);\n\nexport const wkbGeometryDecoder: GeometryDecoder = {\n  supportsGeoArrowPromotion(\n    layerType: string,\n    encoding: ResolvedGeometryEncoding,\n    table: arrow.Table,\n    columnName: string,\n  ) {\n    if (\n      !['wkb', 'geoarrow.wkb', 'wkt', 'geoarrow.wkt', 'unknown'].includes(\n        encoding,\n      )\n    ) {\n      return false;\n    }\n\n    if (POINT_LAYERS.has(layerType)) {\n      return sampledGeometriesMatch(\n        table,\n        columnName,\n        encoding,\n        (geometryType) => geometryType === 'Point',\n        (geometryType) => geometryType === WKB_POINT,\n      );\n    }\n\n    if (POLYGON_LAYERS.has(layerType)) {\n      return sampledGeometriesMatch(\n        table,\n        columnName,\n        encoding,\n        (geometryType) =>\n          geometryType === 'Polygon' || geometryType === 'MultiPolygon',\n        (geometryType) =>\n          geometryType === WKB_POLYGON || geometryType === WKB_MULTIPOLYGON,\n      );\n    }\n\n    return false;\n  },\n\n  toGeoArrowLike(\n    table: arrow.Table,\n    columnName: string,\n    encoding: ResolvedGeometryEncoding,\n  ) {\n    const pointResult = tryPromotePointTable(table, columnName, encoding);\n    if (pointResult) return pointResult;\n\n    const result = tryPromotePolygonTable(table, columnName, encoding);\n    if (result) return result;\n\n    throw new Error(\n      'GeoArrow promotion failed: unsupported geometry type for column.',\n    );\n  },\n\n  toGeoJsonBinary(\n    table: arrow.Table,\n    columnName: string,\n    encoding: ResolvedGeometryEncoding,\n  ) {\n    return buildBinaryGeoJsonData({\n      table,\n      geometryColumnName: columnName,\n      getGeometryAt: (rowIndex) => {\n        const value = table.getChild(columnName)?.get(rowIndex);\n        return parseGeometryValue(value, encoding);\n      },\n    });\n  },\n};\n"]}

package/dist/prepare/wkbParser.d.ts

@@ -0,0 +1,19 @@
+export declare const WKB_POINT = 1;
+export declare const WKB_POLYGON = 3;
+export declare const WKB_MULTIPOLYGON = 6;
+export type WKBHeader = {
+    view: DataView;
+    isLE: boolean;
+    geomType: number;
+    offset: number;
+    coordBytes: number;
+};
+export type WKBPolygonCoordinateVisitor = {
+    onRingStart: () => void;
+    onCoordinate: (x: number, y: number) => void;
+};
+export declare function parseWKBHeader(buf: ArrayBuffer, startOffset?: number): WKBHeader | null;
+export declare function readWKBPointXY(header: WKBHeader): [number, number] | null;
+export declare function visitWKBPolygonCoordinates(buf: ArrayBuffer, header: WKBHeader, visitor: WKBPolygonCoordinateVisitor): number | null;
+export declare function visitWKBMultiPolygonCoordinates(buf: ArrayBuffer, header: WKBHeader, visitor: WKBPolygonCoordinateVisitor): boolean;
+//# sourceMappingURL=wkbParser.d.ts.map

package/dist/prepare/wkbParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkbParser.d.ts","sourceRoot":"","sources":["../../src/prepare/wkbParser.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAyBlC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAIF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,WAAW,SAAI,GACd,SAAS,GAAG,IAAI,CA2BlB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAYzE;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,2BAA2B,GACnC,MAAM,GAAG,IAAI,CAyBf;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAiBT"}

package/dist/prepare/wkbParser.js

@@ -0,0 +1,115 @@
+export const WKB_POINT = 1;
+export const WKB_POLYGON = 3;
+export const WKB_MULTIPOLYGON = 6;
+// Local WKB parser used until geoarrow-js ships WKB to GeoArrow parsing:
+// See: https://github.com/geoarrow/geoarrow-js/issues/54
+const WKB_BYTE_ORDER_BYTES = 1;
+const WKB_GEOMETRY_TYPE_BYTES = 4;
+const WKB_HEADER_BYTES = WKB_BYTE_ORDER_BYTES + WKB_GEOMETRY_TYPE_BYTES;
+const WKB_GEOMETRY_TYPE_OFFSET = WKB_BYTE_ORDER_BYTES;
+const WKB_SRID_BYTES = 4;
+const WKB_UINT32_BYTES = 4;
+const XY_COORDINATE_BYTES = 16;
+const OPTIONAL_COORDINATE_DIMENSION_BYTES = 8;
+const Y_COORDINATE_OFFSET_BYTES = 8;
+// PostGIS EWKB stores Z/M/SRID metadata in the high bits
+// of the WKB type word.
+const EWKB_Z_FLAG = 0x80000000;
+const EWKB_M_FLAG = 0x40000000;
+const EWKB_SRID_FLAG = 0x20000000;
+const ISO_WKB_TYPE_MASK = 0xffff;
+const ISO_WKB_Z_OFFSET = 1000;
+const ISO_WKB_M_OFFSET = 2000;
+const ISO_WKB_ZM_OFFSET = 3000;
+const ISO_WKB_MAX_BASE_TYPE = 7;
+// Reads the shared WKB/EWKB prefix like byte order, geometry type, optional SRID
+// and bytes per coordinate. Point/polygon readers use this to find their data.
+export function parseWKBHeader(buf, startOffset = 0) {
+    if (buf.byteLength < startOffset + WKB_HEADER_BYTES)
+        return null;
+    const view = new DataView(buf);
+    const isLE = view.getUint8(startOffset) === 1;
+    const rawType = view.getUint32(startOffset + WKB_GEOMETRY_TYPE_OFFSET, isLE);
+    const isoType = rawType & ISO_WKB_TYPE_MASK;
+    const isoZ = hasIsoWKBTypeOffset(isoType, ISO_WKB_Z_OFFSET);
+    const isoM = hasIsoWKBTypeOffset(isoType, ISO_WKB_M_OFFSET);
+    const isoZM = hasIsoWKBTypeOffset(isoType, ISO_WKB_ZM_OFFSET);
+    const hasZ = (rawType & EWKB_Z_FLAG) !== 0 || isoZ || isoZM;
+    const hasM = (rawType & EWKB_M_FLAG) !== 0 || isoM || isoZM;
+    const hasSRID = (rawType & EWKB_SRID_FLAG) !== 0;
+    let base = isoType;
+    if (isoZM)
+        base -= ISO_WKB_ZM_OFFSET;
+    else if (isoM)
+        base -= ISO_WKB_M_OFFSET;
+    else if (isoZ)
+        base -= ISO_WKB_Z_OFFSET;
+    let offset = startOffset + WKB_HEADER_BYTES;
+    if (hasSRID)
+        offset += WKB_SRID_BYTES;
+    const coordBytes = XY_COORDINATE_BYTES +
+        (hasZ ? OPTIONAL_COORDINATE_DIMENSION_BYTES : 0) +
+        (hasM ? OPTIONAL_COORDINATE_DIMENSION_BYTES : 0);
+    return { view, isLE, geomType: base, offset, coordBytes };
+}
+export function readWKBPointXY(header) {
+    if (header.geomType !== WKB_POINT)
+        return null;
+    if (!hasBytes(header.view.buffer, header.offset, header.coordBytes)) {
+        return null;
+    }
+    return [
+        header.view.getFloat64(header.offset, header.isLE),
+        header.view.getFloat64(header.offset + Y_COORDINATE_OFFSET_BYTES, header.isLE),
+    ];
+}
+export function visitWKBPolygonCoordinates(buf, header, visitor) {
+    if (header.geomType !== WKB_POLYGON)
+        return null;
+    const { view, isLE, offset: headerOffset, coordBytes } = header;
+    let offset = headerOffset;
+    if (!hasBytes(buf, offset, WKB_UINT32_BYTES))
+        return null;
+    const numRings = view.getUint32(offset, isLE);
+    offset += WKB_UINT32_BYTES;
+    for (let ringIndex = 0; ringIndex < numRings; ringIndex++) {
+        visitor.onRingStart();
+        if (!hasBytes(buf, offset, WKB_UINT32_BYTES))
+            return null;
+        const numPoints = view.getUint32(offset, isLE);
+        offset += WKB_UINT32_BYTES;
+        for (let pointIndex = 0; pointIndex < numPoints; pointIndex++) {
+            if (!hasBytes(buf, offset, coordBytes))
+                return null;
+            visitor.onCoordinate(view.getFloat64(offset, isLE), view.getFloat64(offset + Y_COORDINATE_OFFSET_BYTES, isLE));
+            offset += coordBytes;
+        }
+    }
+    return offset <= buf.byteLength ? offset : null;
+}
+export function visitWKBMultiPolygonCoordinates(buf, header, visitor) {
+    if (header.geomType !== WKB_MULTIPOLYGON)
+        return false;
+    let offset = header.offset;
+    if (!hasBytes(buf, offset, WKB_UINT32_BYTES))
+        return false;
+    const numPolygons = header.view.getUint32(offset, header.isLE);
+    offset += WKB_UINT32_BYTES;
+    for (let polygonIndex = 0; polygonIndex < numPolygons; polygonIndex++) {
+        const polygonHeader = parseWKBHeader(buf, offset);
+        if (!polygonHeader || polygonHeader.geomType !== WKB_POLYGON)
+            return false;
+        const nextOffset = visitWKBPolygonCoordinates(buf, polygonHeader, visitor);
+        if (nextOffset == null)
+            return false;
+        offset = nextOffset;
+    }
+    return offset <= buf.byteLength;
+}
+function hasIsoWKBTypeOffset(isoType, offset) {
+    return isoType >= offset && isoType <= offset + ISO_WKB_MAX_BASE_TYPE;
+}
+function hasBytes(buf, offset, byteLength) {
+    return offset >= 0 && offset + byteLength <= buf.byteLength;
+}
+//# sourceMappingURL=wkbParser.js.map

package/dist/prepare/wkbParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkbParser.js","sourceRoot":"","sources":["../../src/prepare/wkbParser.ts"],"names":[],"mappings":"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","sourcesContent":["export const WKB_POINT = 1;\nexport const WKB_POLYGON = 3;\nexport const WKB_MULTIPOLYGON = 6;\n\n// Local WKB parser used until geoarrow-js ships WKB to GeoArrow parsing:\n// See: https://github.com/geoarrow/geoarrow-js/issues/54\nconst WKB_BYTE_ORDER_BYTES = 1;\nconst WKB_GEOMETRY_TYPE_BYTES = 4;\nconst WKB_HEADER_BYTES = WKB_BYTE_ORDER_BYTES + WKB_GEOMETRY_TYPE_BYTES;\nconst WKB_GEOMETRY_TYPE_OFFSET = WKB_BYTE_ORDER_BYTES;\nconst WKB_SRID_BYTES = 4;\nconst WKB_UINT32_BYTES = 4;\nconst XY_COORDINATE_BYTES = 16;\nconst OPTIONAL_COORDINATE_DIMENSION_BYTES = 8;\nconst Y_COORDINATE_OFFSET_BYTES = 8;\n\n// PostGIS EWKB stores Z/M/SRID metadata in the high bits\n// of the WKB type word.\nconst EWKB_Z_FLAG = 0x80000000;\nconst EWKB_M_FLAG = 0x40000000;\nconst EWKB_SRID_FLAG = 0x20000000;\nconst ISO_WKB_TYPE_MASK = 0xffff;\nconst ISO_WKB_Z_OFFSET = 1000;\nconst ISO_WKB_M_OFFSET = 2000;\nconst ISO_WKB_ZM_OFFSET = 3000;\nconst ISO_WKB_MAX_BASE_TYPE = 7;\n\nexport type WKBHeader = {\n  view: DataView;\n  isLE: boolean;\n  geomType: number;\n  offset: number;\n  coordBytes: number;\n};\n\nexport type WKBPolygonCoordinateVisitor = {\n  onRingStart: () => void;\n  onCoordinate: (x: number, y: number) => void;\n};\n\n// Reads the shared WKB/EWKB prefix like byte order, geometry type, optional SRID\n// and bytes per coordinate. Point/polygon readers use this to find their data.\nexport function parseWKBHeader(\n  buf: ArrayBuffer,\n  startOffset = 0,\n): WKBHeader | null {\n  if (buf.byteLength < startOffset + WKB_HEADER_BYTES) return null;\n  const view = new DataView(buf);\n  const isLE = view.getUint8(startOffset) === 1;\n  const rawType = view.getUint32(startOffset + WKB_GEOMETRY_TYPE_OFFSET, isLE);\n  const isoType = rawType & ISO_WKB_TYPE_MASK;\n  const isoZ = hasIsoWKBTypeOffset(isoType, ISO_WKB_Z_OFFSET);\n  const isoM = hasIsoWKBTypeOffset(isoType, ISO_WKB_M_OFFSET);\n  const isoZM = hasIsoWKBTypeOffset(isoType, ISO_WKB_ZM_OFFSET);\n\n  const hasZ = (rawType & EWKB_Z_FLAG) !== 0 || isoZ || isoZM;\n  const hasM = (rawType & EWKB_M_FLAG) !== 0 || isoM || isoZM;\n  const hasSRID = (rawType & EWKB_SRID_FLAG) !== 0;\n\n  let base = isoType;\n  if (isoZM) base -= ISO_WKB_ZM_OFFSET;\n  else if (isoM) base -= ISO_WKB_M_OFFSET;\n  else if (isoZ) base -= ISO_WKB_Z_OFFSET;\n\n  let offset = startOffset + WKB_HEADER_BYTES;\n  if (hasSRID) offset += WKB_SRID_BYTES;\n\n  const coordBytes =\n    XY_COORDINATE_BYTES +\n    (hasZ ? OPTIONAL_COORDINATE_DIMENSION_BYTES : 0) +\n    (hasM ? OPTIONAL_COORDINATE_DIMENSION_BYTES : 0);\n  return {view, isLE, geomType: base, offset, coordBytes};\n}\n\nexport function readWKBPointXY(header: WKBHeader): [number, number] | null {\n  if (header.geomType !== WKB_POINT) return null;\n  if (!hasBytes(header.view.buffer, header.offset, header.coordBytes)) {\n    return null;\n  }\n  return [\n    header.view.getFloat64(header.offset, header.isLE),\n    header.view.getFloat64(\n      header.offset + Y_COORDINATE_OFFSET_BYTES,\n      header.isLE,\n    ),\n  ];\n}\n\nexport function visitWKBPolygonCoordinates(\n  buf: ArrayBuffer,\n  header: WKBHeader,\n  visitor: WKBPolygonCoordinateVisitor,\n): number | null {\n  if (header.geomType !== WKB_POLYGON) return null;\n\n  const {view, isLE, offset: headerOffset, coordBytes} = header;\n  let offset = headerOffset;\n  if (!hasBytes(buf, offset, WKB_UINT32_BYTES)) return null;\n  const numRings = view.getUint32(offset, isLE);\n  offset += WKB_UINT32_BYTES;\n\n  for (let ringIndex = 0; ringIndex < numRings; ringIndex++) {\n    visitor.onRingStart();\n    if (!hasBytes(buf, offset, WKB_UINT32_BYTES)) return null;\n    const numPoints = view.getUint32(offset, isLE);\n    offset += WKB_UINT32_BYTES;\n    for (let pointIndex = 0; pointIndex < numPoints; pointIndex++) {\n      if (!hasBytes(buf, offset, coordBytes)) return null;\n      visitor.onCoordinate(\n        view.getFloat64(offset, isLE),\n        view.getFloat64(offset + Y_COORDINATE_OFFSET_BYTES, isLE),\n      );\n      offset += coordBytes;\n    }\n  }\n\n  return offset <= buf.byteLength ? offset : null;\n}\n\nexport function visitWKBMultiPolygonCoordinates(\n  buf: ArrayBuffer,\n  header: WKBHeader,\n  visitor: WKBPolygonCoordinateVisitor,\n): boolean {\n  if (header.geomType !== WKB_MULTIPOLYGON) return false;\n\n  let offset = header.offset;\n  if (!hasBytes(buf, offset, WKB_UINT32_BYTES)) return false;\n  const numPolygons = header.view.getUint32(offset, header.isLE);\n  offset += WKB_UINT32_BYTES;\n\n  for (let polygonIndex = 0; polygonIndex < numPolygons; polygonIndex++) {\n    const polygonHeader = parseWKBHeader(buf, offset);\n    if (!polygonHeader || polygonHeader.geomType !== WKB_POLYGON) return false;\n    const nextOffset = visitWKBPolygonCoordinates(buf, polygonHeader, visitor);\n    if (nextOffset == null) return false;\n    offset = nextOffset;\n  }\n\n  return offset <= buf.byteLength;\n}\n\nfunction hasIsoWKBTypeOffset(isoType: number, offset: number): boolean {\n  return isoType >= offset && isoType <= offset + ISO_WKB_MAX_BASE_TYPE;\n}\n\nfunction hasBytes(\n  buf: {byteLength: number},\n  offset: number,\n  byteLength: number,\n) {\n  return offset >= 0 && offset + byteLength <= buf.byteLength;\n}\n"]}

package/dist/types.d.ts

@@ -43,11 +43,19 @@ export type DeckJsonMapProps = {
     spec: string | Record<string, unknown>;
     datasets: Record<string, DeckDatasetInput>;
     mapStyle?: string;
+    /**
+     * When true, deck.gl layers are inserted into MapLibre's layer stack sharing
+     * the same WebGL2 context. This allows rendering deck layers between basemap
+     * layers (e.g. under labels). Requires WebGL2 (MapLibre GL v3+).
+     * Defaults to false (deck renders in a separate overlay canvas on top).
+     */
+    interleaved?: boolean;
     deckProps?: Partial<DeckProps>;
     mapProps?: Partial<MapProps>;
     showLegends?: boolean;
     className?: string;
     children?: ReactNode;
+    onDatasetStatesChange?: (states: Record<string, PreparedDeckDatasetState>) => void;
 };
 export declare function isSqlDatasetInput(input: DeckDatasetInput): input is DeckSqlDatasetInput;
 export declare function isArrowTableDatasetInput(input: DeckDatasetInput): input is DeckArrowTableDatasetInput;