@sqlrooms/deck 0.29.0-rc.10 → 0.29.0-rc.12

package/dist/json/layers/DeckHeatmapLayer.js

@@ -0,0 +1,69 @@
+import { GeoArrowHeatmapLayer } from '@geoarrow/deck.gl-geoarrow';
+import { DEFAULT_HEATMAP_WEIGHTS_TEXTURE_SIZE } from '../heatmapDefaults';
+/**
+ * GeoArrow heatmap that reuses the inner binary `data` wrapper when only style
+ * props change. JSONConverter builds a new layer each time; a new wrapper looks
+ * like a data change and rebuilds aggregation.
+ */
+export class DeckHeatmapLayer extends GeoArrowHeatmapLayer {
+    static layerName = 'GeoArrowHeatmapLayer';
+    static defaultProps = {
+        weightsTextureSize: {
+            type: 'number',
+            min: 128,
+            max: 2048,
+            value: DEFAULT_HEATMAP_WEIGHTS_TEXTURE_SIZE,
+        },
+    };
+    renderLayers() {
+        const rendered = super.renderLayers();
+        const heatmap = unwrapSingleLayer(rendered);
+        if (!heatmap)
+            return rendered;
+        const cache = reuseCachedHeatmapData(this.state?.heatmapDataCache, this.props, heatmap.props.data);
+        if (this.state) {
+            this.state.heatmapDataCache = cache;
+        }
+        if (cache.data === heatmap.props.data) {
+            return heatmap;
+        }
+        const HeatmapClass = heatmap.constructor;
+        return new HeatmapClass({
+            ...heatmap.props,
+            data: cache.data,
+        });
+    }
+}
+/** Return the previous inner heatmap `data` object when Arrow inputs match. */
+export function reuseCachedHeatmapData(cache, props, nextData) {
+    const sourceData = props.data;
+    const sourcePosition = props.getPosition;
+    const weightKey = getHeatmapWeightKey(props);
+    if (cache &&
+        cache.sourceData === sourceData &&
+        cache.sourcePosition === sourcePosition &&
+        cache.weightKey === weightKey) {
+        return cache;
+    }
+    return { sourceData, sourcePosition, weightKey, data: nextData };
+}
+function getHeatmapWeightKey(props) {
+    const getWeight = props.getWeight;
+    const triggers = props.updateTriggers;
+    if (triggers && typeof triggers === 'object' && 'getWeight' in triggers) {
+        return triggers.getWeight;
+    }
+    if (typeof getWeight === 'number' || getWeight == null) {
+        return getWeight ?? 1;
+    }
+    return getWeight;
+}
+function unwrapSingleLayer(rendered) {
+    const layers = Array.isArray(rendered) ? rendered : [rendered];
+    const layer = layers[0];
+    if (layer && typeof layer === 'object' && 'props' in layer) {
+        return layer;
+    }
+    return null;
+}
+//# sourceMappingURL=DeckHeatmapLayer.js.map

package/dist/json/layers/DeckHeatmapLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckHeatmapLayer.js","sourceRoot":"","sources":["../../../src/json/layers/DeckHeatmapLayer.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Layer, LayersList} from '@deck.gl/core';\nimport {GeoArrowHeatmapLayer} from '@geoarrow/deck.gl-geoarrow';\nimport {DEFAULT_HEATMAP_WEIGHTS_TEXTURE_SIZE} from '../heatmapDefaults';\n\ntype HeatmapDataCache = {\n  sourceData: unknown;\n  sourcePosition: unknown;\n  weightKey: unknown;\n  data: unknown;\n};\n\ntype LayerWithData = Layer & {props: {data?: unknown}};\n\n/**\n * GeoArrow heatmap that reuses the inner binary `data` wrapper when only style\n * props change. JSONConverter builds a new layer each time; a new wrapper looks\n * like a data change and rebuilds aggregation.\n */\nexport class DeckHeatmapLayer extends GeoArrowHeatmapLayer {\n  static layerName = 'GeoArrowHeatmapLayer';\n  static defaultProps = {\n    weightsTextureSize: {\n      type: 'number' as const,\n      min: 128,\n      max: 2048,\n      value: DEFAULT_HEATMAP_WEIGHTS_TEXTURE_SIZE,\n    },\n  };\n\n  declare state: {heatmapDataCache?: HeatmapDataCache};\n\n  renderLayers(): Layer | LayersList | null {\n    const rendered = super.renderLayers();\n    const heatmap = unwrapSingleLayer(rendered);\n    if (!heatmap) return rendered;\n\n    const cache = reuseCachedHeatmapData(\n      this.state?.heatmapDataCache,\n      this.props as Record<string, unknown>,\n      heatmap.props.data,\n    );\n    if (this.state) {\n      this.state.heatmapDataCache = cache;\n    }\n    if (cache.data === heatmap.props.data) {\n      return heatmap;\n    }\n\n    const HeatmapClass = heatmap.constructor as new (\n      props: Record<string, unknown>,\n    ) => Layer;\n    return new HeatmapClass({\n      ...heatmap.props,\n      data: cache.data,\n    });\n  }\n}\n\n/** Return the previous inner heatmap `data` object when Arrow inputs match. */\nexport function reuseCachedHeatmapData(\n  cache: HeatmapDataCache | undefined,\n  props: Record<string, unknown>,\n  nextData: unknown,\n): HeatmapDataCache {\n  const sourceData = props.data;\n  const sourcePosition = props.getPosition;\n  const weightKey = getHeatmapWeightKey(props);\n  if (\n    cache &&\n    cache.sourceData === sourceData &&\n    cache.sourcePosition === sourcePosition &&\n    cache.weightKey === weightKey\n  ) {\n    return cache;\n  }\n  return {sourceData, sourcePosition, weightKey, data: nextData};\n}\n\nfunction getHeatmapWeightKey(props: Record<string, unknown>): unknown {\n  const getWeight = props.getWeight;\n  const triggers = props.updateTriggers;\n  if (triggers && typeof triggers === 'object' && 'getWeight' in triggers) {\n    return (triggers as Record<string, unknown>).getWeight;\n  }\n  if (typeof getWeight === 'number' || getWeight == null) {\n    return getWeight ?? 1;\n  }\n  return getWeight;\n}\n\nfunction unwrapSingleLayer(rendered: unknown): LayerWithData | null {\n  const layers = Array.isArray(rendered) ? rendered : [rendered];\n  const layer = layers[0];\n  if (layer && typeof layer === 'object' && 'props' in layer) {\n    return layer as LayerWithData;\n  }\n  return null;\n}\n"]}

package/dist/json/layers/h3IndexFormat.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Convert Arrow/DuckDB H3 cell ids to hex strings for H3HexagonLayer.
+ * Bigint must use base-16 — `String(bigint)` is decimal and invalid for deck.gl.
+ */
+export declare function formatH3IndexForDeck(value: unknown): string;
+//# sourceMappingURL=h3IndexFormat.d.ts.map

package/dist/json/layers/h3IndexFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h3IndexFormat.d.ts","sourceRoot":"","sources":["../../../src/json/layers/h3IndexFormat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU3D"}

package/dist/json/layers/h3IndexFormat.js

@@ -0,0 +1,17 @@
+/**
+ * Convert Arrow/DuckDB H3 cell ids to hex strings for H3HexagonLayer.
+ * Bigint must use base-16 — `String(bigint)` is decimal and invalid for deck.gl.
+ */
+export function formatH3IndexForDeck(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'bigint') {
+        return BigInt.asUintN(64, value).toString(16);
+    }
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        // Narrow ints only; unsafe for full H3 range.
+        return BigInt.asUintN(64, BigInt(Math.trunc(value))).toString(16);
+    }
+    return String(value);
+}
+//# sourceMappingURL=h3IndexFormat.js.map

package/dist/json/layers/h3IndexFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h3IndexFormat.js","sourceRoot":"","sources":["../../../src/json/layers/h3IndexFormat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,8CAA8C;QAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC","sourcesContent":["/**\n * Convert Arrow/DuckDB H3 cell ids to hex strings for H3HexagonLayer.\n * Bigint must use base-16 — `String(bigint)` is decimal and invalid for deck.gl.\n */\nexport function formatH3IndexForDeck(value: unknown): string {\n  if (value == null) return '';\n  if (typeof value === 'bigint') {\n    return BigInt.asUintN(64, value).toString(16);\n  }\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    // Narrow ints only; unsafe for full H3 range.\n    return BigInt.asUintN(64, BigInt(Math.trunc(value))).toString(16);\n  }\n  return String(value);\n}\n"]}

package/dist/json/layers/index.d.ts

@@ -1,5 +1,7 @@
 export { createTableToRecordBatchAdapter } from './createTableToRecordBatchAdapter';
 export { DeckColumnLayer } from './DeckColumnLayer';
 export { DeckH3HexagonLayer } from './DeckH3HexagonLayer';
+export { DeckHeatmapLayer } from './DeckHeatmapLayer';
+export { formatH3IndexForDeck } from './h3IndexFormat';
 export { DeckTripsLayer } from './DeckTripsLayer';
 //# sourceMappingURL=index.d.ts.map

package/dist/json/layers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/json/layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,+BAA+B,EAAC,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/json/layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,+BAA+B,EAAC,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/json/layers/index.js

@@ -1,5 +1,7 @@
 export { createTableToRecordBatchAdapter } from './createTableToRecordBatchAdapter';
 export { DeckColumnLayer } from './DeckColumnLayer';
 export { DeckH3HexagonLayer } from './DeckH3HexagonLayer';
+export { DeckHeatmapLayer } from './DeckHeatmapLayer';
+export { formatH3IndexForDeck } from './h3IndexFormat';
 export { DeckTripsLayer } from './DeckTripsLayer';
 //# sourceMappingURL=index.js.map

package/dist/json/layers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json/layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,+BAA+B,EAAC,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC","sourcesContent":["export {createTableToRecordBatchAdapter} from './createTableToRecordBatchAdapter';\nexport {DeckColumnLayer} from './DeckColumnLayer';\nexport {DeckH3HexagonLayer} from './DeckH3HexagonLayer';\nexport {DeckTripsLayer} from './DeckTripsLayer';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json/layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,+BAA+B,EAAC,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC","sourcesContent":["export {createTableToRecordBatchAdapter} from './createTableToRecordBatchAdapter';\nexport {DeckColumnLayer} from './DeckColumnLayer';\nexport {DeckH3HexagonLayer} from './DeckH3HexagonLayer';\nexport {DeckHeatmapLayer} from './DeckHeatmapLayer';\nexport {formatH3IndexForDeck} from './h3IndexFormat';\nexport {DeckTripsLayer} from './DeckTripsLayer';\n"]}

package/dist/json/rewriteGeoArrowAccessors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rewriteGeoArrowAccessors.d.ts","sourceRoot":"","sources":["../../src/json/rewriteGeoArrowAccessors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAyBtC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,2BA4CA"}
+{"version":3,"file":"rewriteGeoArrowAccessors.d.ts","sourceRoot":"","sources":["../../src/json/rewriteGeoArrowAccessors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AA8CtC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,2BA4CA"}

package/dist/json/rewriteGeoArrowAccessors.js

@@ -5,6 +5,27 @@ function isSimpleColumnReference(expression) {
     return /^[A-Za-z_$][\w$]*$/.test(expression.trim());
 }
 function canUseDirectVectorAccessor(propName, vector) {
+    // H3 index columns are safe as Vectors — DeckH3HexagonLayer reads them
+    // directly and converts BigInt → hex string when needed.
+    if (propName === 'getHexagon') {
+        const type = vector.type;
+        return (arrow.DataType.isUtf8(type) ||
+            arrow.DataType.isLargeUtf8(type) ||
+            // DuckDB UBIGINT often arrives as Int(true, 64), not instanceof Int64.
+            (arrow.DataType.isInt(type) && type.bitWidth === 64));
+    }
+    const firstChunk = vector.data[0];
+    if (!firstChunk) {
+        return false;
+    }
+    // Heatmap weights are a scalar column. Passing a float Vector through lets
+    // GeoArrow put them in binary attributes instead of a new function on every
+    // JSON convert (which would look like a data change). Integer columns stay
+    // on the function accessor: GeoArrow only uploads float weights, and Int64
+    // values are bigint / BigInt64Array which deck.gl cannot use as GPU data.
+    if (propName === 'getWeight') {
+        return arrow.DataType.isFloat(firstChunk.type);
+    }
     // Direct numeric vectors (for example `getRadius`) currently end up in deck's
     // binary attribute path and trigger `Float64Array` initialization failures in the
     // GeoArrow scatterplot wrapper. Re-test which direct vector accessors are safe
@@ -12,11 +33,7 @@ function canUseDirectVectorAccessor(propName, vector) {
     if (!propName.endsWith('Color')) {
         return false;
     }
-    const firstChunk = vector.data[0];
-    if (!firstChunk || !arrow.DataType.isFixedSizeList(firstChunk.type)) {
-        return false;
-    }
-    return true;
+    return arrow.DataType.isFixedSizeList(firstChunk.type);
 }
 export function rewriteGeoArrowAccessors(options) {
     const { props, table, layerName } = options;

package/dist/json/rewriteGeoArrowAccessors.js.map

@@ -1 +1 @@
-{"version":3,"file":"rewriteGeoArrowAccessors.js","sourceRoot":"","sources":["../../src/json/rewriteGeoArrowAccessors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAE3D,SAAS,uBAAuB,CAAC,UAAkB;IACjD,OAAO,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB,EAAE,MAAoB;IACxE,8EAA8E;IAC9E,kFAAkF;IAClF,+EAA+E;IAC/E,qEAAqE;IACrE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAIxC;IACC,MAAM,EAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAC,GAAG,OAAO,CAAC;IAC1C,MAAM,aAAa,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,EAAC,GAAG,KAAK,EAAC,CAAC;IAE7B,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,IACE,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;YAC5B,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAC3B,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtC,IACE,aAAa,CAAC,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACpD,uBAAuB,CAAC,UAAU,CAAC,EACnC,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,IAAI,MAAM,IAAI,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC3D,SAAS,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;gBAC7B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,mEAAmE;gBACnE,mEAAmE;gBACnE,OAAO,CAAC,IAAI,CACV,WAAW,UAAU,CAAC,IAAI,EAAE,wCAAwC,QAAQ,IAAI,CACjF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,4EAA4E;QAC5E,gCAAgC;QAChC,SAAS,CAAC,QAAQ,CAAC,GAAG,uBAAuB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import * as arrow from 'apache-arrow';\nimport {compileGeoArrowAccessor} from './compileGeoArrowAccessor';\nimport {getLayerCompatibility} from './layerCompatibility';\n\nfunction isSimpleColumnReference(expression: string) {\n  return /^[A-Za-z_$][\\w$]*$/.test(expression.trim());\n}\n\nfunction canUseDirectVectorAccessor(propName: string, vector: arrow.Vector) {\n  // Direct numeric vectors (for example `getRadius`) currently end up in deck's\n  // binary attribute path and trigger `Float64Array` initialization failures in the\n  // GeoArrow scatterplot wrapper. Re-test which direct vector accessors are safe\n  // after verifying the 0.4.x runtime contract handles them correctly.\n  if (!propName.endsWith('Color')) {\n    return false;\n  }\n\n  const firstChunk = vector.data[0];\n  if (!firstChunk || !arrow.DataType.isFixedSizeList(firstChunk.type)) {\n    return false;\n  }\n\n  return true;\n}\n\nexport function rewriteGeoArrowAccessors(options: {\n  props: Record<string, unknown>;\n  table: arrow.Table;\n  layerName: string;\n}) {\n  const {props, table, layerName} = options;\n  const compatibility = getLayerCompatibility(layerName);\n  if (!compatibility || compatibility.representation !== 'geoarrow') {\n    return props;\n  }\n\n  const nextProps = {...props};\n\n  for (const [propName, propValue] of Object.entries(nextProps)) {\n    if (\n      typeof propValue !== 'string' ||\n      !propValue.startsWith('@@=') ||\n      !propName.startsWith('get')\n    ) {\n      continue;\n    }\n\n    const expression = propValue.slice(3);\n    if (\n      compatibility.vectorAccessorProps.includes(propName) &&\n      isSimpleColumnReference(expression)\n    ) {\n      const vector = table.getChild(expression.trim());\n      if (vector && canUseDirectVectorAccessor(propName, vector)) {\n        nextProps[propName] = vector;\n        continue;\n      }\n      if (!vector) {\n        // Column not found — fall through to compileGeoArrowAccessor which\n        // handles missing bindings gracefully (returns undefined per row).\n        console.warn(\n          `Column \"${expression.trim()}\" not found in dataset for accessor \"${propName}\".`,\n        );\n      }\n    }\n\n    // This custom compiler handles GeoArrow batch-oriented callbacks. The 0.4.x\n    // layers call function accessors with {index, data: {data: batch}, target},\n    // which this compiler produces.\n    nextProps[propName] = compileGeoArrowAccessor(expression, table);\n  }\n\n  return nextProps;\n}\n"]}
+{"version":3,"file":"rewriteGeoArrowAccessors.js","sourceRoot":"","sources":["../../src/json/rewriteGeoArrowAccessors.ts"],"names":[],"mappings":"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","sourcesContent":["import * as arrow from 'apache-arrow';\nimport {compileGeoArrowAccessor} from './compileGeoArrowAccessor';\nimport {getLayerCompatibility} from './layerCompatibility';\n\nfunction isSimpleColumnReference(expression: string) {\n  return /^[A-Za-z_$][\\w$]*$/.test(expression.trim());\n}\n\nfunction canUseDirectVectorAccessor(propName: string, vector: arrow.Vector) {\n  // H3 index columns are safe as Vectors — DeckH3HexagonLayer reads them\n  // directly and converts BigInt → hex string when needed.\n  if (propName === 'getHexagon') {\n    const type = vector.type;\n    return (\n      arrow.DataType.isUtf8(type) ||\n      arrow.DataType.isLargeUtf8(type) ||\n      // DuckDB UBIGINT often arrives as Int(true, 64), not instanceof Int64.\n      (arrow.DataType.isInt(type) && type.bitWidth === 64)\n    );\n  }\n\n  const firstChunk = vector.data[0];\n  if (!firstChunk) {\n    return false;\n  }\n\n  // Heatmap weights are a scalar column. Passing a float Vector through lets\n  // GeoArrow put them in binary attributes instead of a new function on every\n  // JSON convert (which would look like a data change). Integer columns stay\n  // on the function accessor: GeoArrow only uploads float weights, and Int64\n  // values are bigint / BigInt64Array which deck.gl cannot use as GPU data.\n  if (propName === 'getWeight') {\n    return arrow.DataType.isFloat(firstChunk.type);\n  }\n\n  // Direct numeric vectors (for example `getRadius`) currently end up in deck's\n  // binary attribute path and trigger `Float64Array` initialization failures in the\n  // GeoArrow scatterplot wrapper. Re-test which direct vector accessors are safe\n  // after verifying the 0.4.x runtime contract handles them correctly.\n  if (!propName.endsWith('Color')) {\n    return false;\n  }\n\n  return arrow.DataType.isFixedSizeList(firstChunk.type);\n}\n\nexport function rewriteGeoArrowAccessors(options: {\n  props: Record<string, unknown>;\n  table: arrow.Table;\n  layerName: string;\n}) {\n  const {props, table, layerName} = options;\n  const compatibility = getLayerCompatibility(layerName);\n  if (!compatibility || compatibility.representation !== 'geoarrow') {\n    return props;\n  }\n\n  const nextProps = {...props};\n\n  for (const [propName, propValue] of Object.entries(nextProps)) {\n    if (\n      typeof propValue !== 'string' ||\n      !propValue.startsWith('@@=') ||\n      !propName.startsWith('get')\n    ) {\n      continue;\n    }\n\n    const expression = propValue.slice(3);\n    if (\n      compatibility.vectorAccessorProps.includes(propName) &&\n      isSimpleColumnReference(expression)\n    ) {\n      const vector = table.getChild(expression.trim());\n      if (vector && canUseDirectVectorAccessor(propName, vector)) {\n        nextProps[propName] = vector;\n        continue;\n      }\n      if (!vector) {\n        // Column not found — fall through to compileGeoArrowAccessor which\n        // handles missing bindings gracefully (returns undefined per row).\n        console.warn(\n          `Column \"${expression.trim()}\" not found in dataset for accessor \"${propName}\".`,\n        );\n      }\n    }\n\n    // This custom compiler handles GeoArrow batch-oriented callbacks. The 0.4.x\n    // layers call function accessors with {index, data: {data: batch}, target},\n    // which this compiler produces.\n    nextProps[propName] = compileGeoArrowAccessor(expression, table);\n  }\n\n  return nextProps;\n}\n"]}

package/dist/json/scaleFunction.d.ts

@@ -0,0 +1,27 @@
+import type * as arrow from 'apache-arrow';
+declare const SQLROOMS_SCALE_MARKER: unique symbol;
+export type LinearScaleConfig = {
+    field: string;
+    type?: 'linear';
+    domain?: 'auto' | [number, number];
+    /** When set, map domain → range. When omitted, use raw field minus domain min. */
+    range?: [number, number];
+};
+export type ScaleMarker = LinearScaleConfig & {
+    [SQLROOMS_SCALE_MARKER]: true;
+};
+/** Marker returned by the Deck JSON `scale` function before table-aware compile. */
+export declare function createScaleMarker(props: Record<string, unknown>): ScaleMarker | undefined;
+export declare function isScaleMarker(value: unknown): value is ScaleMarker;
+/**
+ * Linear scale `@@=` expression. Non-identifier fields need
+ * {@link compileLinearScaleAccessor}.
+ */
+export declare function compileLinearScaleExpression(table: arrow.Table, scale: LinearScaleConfig): string | undefined;
+/**
+ * Elevation accessor for any Arrow column name (incl. non-identifiers).
+ * Reads GeoArrow `{index, data}` callbacks or GeoJSON `{properties}` features.
+ */
+export declare function compileLinearScaleAccessor(table: arrow.Table, scale: LinearScaleConfig): ((value: unknown) => number) | undefined;
+export {};
+//# sourceMappingURL=scaleFunction.d.ts.map

package/dist/json/scaleFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleFunction.d.ts","sourceRoot":"","sources":["../../src/json/scaleFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAG3C,QAAA,MAAM,qBAAqB,eAA8C,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kFAAkF;IAClF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG;IAC5C,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;CAC/B,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,WAAW,GAAG,SAAS,CA6BzB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAMlE;AAqBD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,KAAK,EAAE,iBAAiB,GACvB,MAAM,GAAG,SAAS,CA8BpB;AAsCD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,KAAK,EAAE,iBAAiB,GACvB,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,GAAG,SAAS,CAiC1C"}

package/dist/json/scaleFunction.js

@@ -0,0 +1,151 @@
+import { isBindableGeoArrowFieldIdentifier } from './compileGeoArrowAccessor';
+const SQLROOMS_SCALE_MARKER = Symbol.for('@sqlrooms/deck/sqlrooms-scale');
+/** Marker returned by the Deck JSON `scale` function before table-aware compile. */
+export function createScaleMarker(props) {
+    const field = typeof props.field === 'string' ? props.field.trim() : '';
+    if (!field)
+        return undefined;
+    const domain = props.domain === 'auto'
+        ? 'auto'
+        : Array.isArray(props.domain) &&
+            props.domain.length === 2 &&
+            typeof props.domain[0] === 'number' &&
+            typeof props.domain[1] === 'number'
+            ? [props.domain[0], props.domain[1]]
+            : 'auto';
+    const range = Array.isArray(props.range) &&
+        props.range.length === 2 &&
+        typeof props.range[0] === 'number' &&
+        typeof props.range[1] === 'number'
+        ? [props.range[0], props.range[1]]
+        : undefined;
+    return {
+        [SQLROOMS_SCALE_MARKER]: true,
+        field,
+        type: 'linear',
+        domain,
+        ...(range ? { range } : {}),
+    };
+}
+export function isScaleMarker(value) {
+    return Boolean(value &&
+        typeof value === 'object' &&
+        value[SQLROOMS_SCALE_MARKER]);
+}
+function readNumericDomain(vector) {
+    let min = Infinity;
+    let max = -Infinity;
+    for (let i = 0; i < vector.length; i++) {
+        // Arrow/SQL NULL must not become 0 via Number(null).
+        if (typeof vector.isValid === 'function' && !vector.isValid(i)) {
+            continue;
+        }
+        const raw = vector.get(i);
+        if (raw == null)
+            continue;
+        const v = Number(raw);
+        if (!Number.isFinite(v))
+            continue;
+        if (v < min)
+            min = v;
+        if (v > max)
+            max = v;
+    }
+    if (!Number.isFinite(min) || !Number.isFinite(max))
+        return null;
+    return [min, max];
+}
+/**
+ * Linear scale `@@=` expression. Non-identifier fields need
+ * {@link compileLinearScaleAccessor}.
+ */
+export function compileLinearScaleExpression(table, scale) {
+    const field = scale.field.trim();
+    if (!field || !isBindableGeoArrowFieldIdentifier(field))
+        return undefined;
+    const vector = table.getChild(field);
+    if (!vector)
+        return undefined;
+    const domain = scale.domain === 'auto' || scale.domain === undefined
+        ? readNumericDomain(vector)
+        : scale.domain;
+    if (!domain)
+        return undefined;
+    const [d0, d1] = domain;
+    if (!scale.range) {
+        if (d0 === 0)
+            return `@@=${field}`;
+        return `@@=Math.max(0, ${field} - ${d0})`;
+    }
+    const [r0, r1] = scale.range;
+    const span = d1 - d0;
+    if (span === 0) {
+        return `@@=${r0}`;
+    }
+    const lo = Math.min(r0, r1);
+    const hi = Math.max(r0, r1);
+    // Clamp after linear map (bigint coercion lives in compileGeoArrowAccessor).
+    return `@@=Math.max(${lo}, Math.min(${hi}, ${r0} + (${field} - ${d0}) / ${span} * ${r1 - r0}))`;
+}
+function readLinearScaleRawValue(value, field, vector) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const object = value;
+    if (typeof object.index === 'number') {
+        const batch = object.data?.data;
+        if (batch?.getChild) {
+            return batch.getChild(field)?.get(object.index);
+        }
+        if (batch) {
+            // Batch-local index (GeoArrow) without this field — do not fall back to
+            // the table-level vector.
+            return undefined;
+        }
+        return vector.get(object.index);
+    }
+    const sources = [object.properties, object];
+    for (const source of sources) {
+        if (source && typeof source === 'object' && field in source) {
+            return source[field];
+        }
+    }
+    return undefined;
+}
+/**
+ * Elevation accessor for any Arrow column name (incl. non-identifiers).
+ * Reads GeoArrow `{index, data}` callbacks or GeoJSON `{properties}` features.
+ */
+export function compileLinearScaleAccessor(table, scale) {
+    const field = scale.field.trim();
+    if (!field)
+        return undefined;
+    const vector = table.getChild(field);
+    if (!vector)
+        return undefined;
+    const domain = scale.domain === 'auto' || scale.domain === undefined
+        ? readNumericDomain(vector)
+        : scale.domain;
+    if (!domain)
+        return undefined;
+    const [d0, d1] = domain;
+    const range = scale.range;
+    return (value) => {
+        const raw = readLinearScaleRawValue(value, field, vector);
+        if (raw == null)
+            return 0;
+        const v = Number(raw);
+        if (!Number.isFinite(v))
+            return 0;
+        if (!range) {
+            return Math.max(0, v - d0);
+        }
+        const [r0, r1] = range;
+        const span = d1 - d0;
+        if (span === 0)
+            return r0;
+        const lo = Math.min(r0, r1);
+        const hi = Math.max(r0, r1);
+        return Math.max(lo, Math.min(hi, r0 + ((v - d0) / span) * (r1 - r0)));
+    };
+}
+//# sourceMappingURL=scaleFunction.js.map

package/dist/json/scaleFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleFunction.js","sourceRoot":"","sources":["../../src/json/scaleFunction.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport {isBindableGeoArrowFieldIdentifier} from './compileGeoArrowAccessor';\n\nconst SQLROOMS_SCALE_MARKER = Symbol.for('@sqlrooms/deck/sqlrooms-scale');\n\nexport type LinearScaleConfig = {\n  field: string;\n  type?: 'linear';\n  domain?: 'auto' | [number, number];\n  /** When set, map domain → range. When omitted, use raw field minus domain min. */\n  range?: [number, number];\n};\n\nexport type ScaleMarker = LinearScaleConfig & {\n  [SQLROOMS_SCALE_MARKER]: true;\n};\n\n/** Marker returned by the Deck JSON `scale` function before table-aware compile. */\nexport function createScaleMarker(\n  props: Record<string, unknown>,\n): ScaleMarker | undefined {\n  const field = typeof props.field === 'string' ? props.field.trim() : '';\n  if (!field) return undefined;\n\n  const domain =\n    props.domain === 'auto'\n      ? 'auto'\n      : Array.isArray(props.domain) &&\n          props.domain.length === 2 &&\n          typeof props.domain[0] === 'number' &&\n          typeof props.domain[1] === 'number'\n        ? ([props.domain[0], props.domain[1]] as [number, number])\n        : 'auto';\n\n  const range =\n    Array.isArray(props.range) &&\n    props.range.length === 2 &&\n    typeof props.range[0] === 'number' &&\n    typeof props.range[1] === 'number'\n      ? ([props.range[0], props.range[1]] as [number, number])\n      : undefined;\n\n  return {\n    [SQLROOMS_SCALE_MARKER]: true,\n    field,\n    type: 'linear',\n    domain,\n    ...(range ? {range} : {}),\n  };\n}\n\nexport function isScaleMarker(value: unknown): value is ScaleMarker {\n  return Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as {[SQLROOMS_SCALE_MARKER]?: boolean})[SQLROOMS_SCALE_MARKER],\n  );\n}\n\nfunction readNumericDomain(vector: arrow.Vector): [number, number] | null {\n  let min = Infinity;\n  let max = -Infinity;\n  for (let i = 0; i < vector.length; i++) {\n    // Arrow/SQL NULL must not become 0 via Number(null).\n    if (typeof vector.isValid === 'function' && !vector.isValid(i)) {\n      continue;\n    }\n    const raw = vector.get(i);\n    if (raw == null) continue;\n    const v = Number(raw);\n    if (!Number.isFinite(v)) continue;\n    if (v < min) min = v;\n    if (v > max) max = v;\n  }\n  if (!Number.isFinite(min) || !Number.isFinite(max)) return null;\n  return [min, max];\n}\n\n/**\n * Linear scale `@@=` expression. Non-identifier fields need\n * {@link compileLinearScaleAccessor}.\n */\nexport function compileLinearScaleExpression(\n  table: arrow.Table,\n  scale: LinearScaleConfig,\n): string | undefined {\n  const field = scale.field.trim();\n  if (!field || !isBindableGeoArrowFieldIdentifier(field)) return undefined;\n\n  const vector = table.getChild(field);\n  if (!vector) return undefined;\n\n  const domain =\n    scale.domain === 'auto' || scale.domain === undefined\n      ? readNumericDomain(vector)\n      : scale.domain;\n  if (!domain) return undefined;\n\n  const [d0, d1] = domain;\n\n  if (!scale.range) {\n    if (d0 === 0) return `@@=${field}`;\n    return `@@=Math.max(0, ${field} - ${d0})`;\n  }\n\n  const [r0, r1] = scale.range;\n  const span = d1 - d0;\n  if (span === 0) {\n    return `@@=${r0}`;\n  }\n\n  const lo = Math.min(r0, r1);\n  const hi = Math.max(r0, r1);\n  // Clamp after linear map (bigint coercion lives in compileGeoArrowAccessor).\n  return `@@=Math.max(${lo}, Math.min(${hi}, ${r0} + (${field} - ${d0}) / ${span} * ${r1 - r0}))`;\n}\n\nfunction readLinearScaleRawValue(\n  value: unknown,\n  field: string,\n  vector: arrow.Vector,\n): unknown {\n  if (!value || typeof value !== 'object') return undefined;\n\n  const object = value as {\n    index?: unknown;\n    data?: {data?: {getChild?: (name: string) => arrow.Vector | null}};\n    properties?: Record<string, unknown>;\n  };\n\n  if (typeof object.index === 'number') {\n    const batch = object.data?.data;\n    if (batch?.getChild) {\n      return batch.getChild(field)?.get(object.index);\n    }\n    if (batch) {\n      // Batch-local index (GeoArrow) without this field — do not fall back to\n      // the table-level vector.\n      return undefined;\n    }\n    return vector.get(object.index);\n  }\n\n  const sources = [object.properties, object as Record<string, unknown>];\n  for (const source of sources) {\n    if (source && typeof source === 'object' && field in source) {\n      return source[field];\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Elevation accessor for any Arrow column name (incl. non-identifiers).\n * Reads GeoArrow `{index, data}` callbacks or GeoJSON `{properties}` features.\n */\nexport function compileLinearScaleAccessor(\n  table: arrow.Table,\n  scale: LinearScaleConfig,\n): ((value: unknown) => number) | undefined {\n  const field = scale.field.trim();\n  if (!field) return undefined;\n\n  const vector = table.getChild(field);\n  if (!vector) return undefined;\n\n  const domain =\n    scale.domain === 'auto' || scale.domain === undefined\n      ? readNumericDomain(vector)\n      : scale.domain;\n  if (!domain) return undefined;\n\n  const [d0, d1] = domain;\n  const range = scale.range;\n\n  return (value) => {\n    const raw = readLinearScaleRawValue(value, field, vector);\n    if (raw == null) return 0;\n    const v = Number(raw);\n    if (!Number.isFinite(v)) return 0;\n\n    if (!range) {\n      return Math.max(0, v - d0);\n    }\n\n    const [r0, r1] = range;\n    const span = d1 - d0;\n    if (span === 0) return r0;\n    const lo = Math.min(r0, r1);\n    const hi = Math.max(r0, r1);\n    return Math.max(lo, Math.min(hi, r0 + ((v - d0) / span) * (r1 - r0)));\n  };\n}\n"]}

package/dist/mapAiConfig.d.ts

@@ -39,6 +39,7 @@ export declare const DeckMapResourceConfigParameter: z.ZodObject<{
         longitudeColumn: z.ZodOptional<z.ZodString>;
         latitudeColumn: z.ZodOptional<z.ZodString>;
         geometryColumn: z.ZodOptional<z.ZodString>;
+        geometryColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         h3Column: z.ZodOptional<z.ZodString>;
         padding: z.ZodOptional<z.ZodNumber>;
         maxZoom: z.ZodOptional<z.ZodNumber>;
@@ -92,6 +93,7 @@ export declare const DeckMapResourceToolParameters: z.ZodObject<{
             longitudeColumn: z.ZodOptional<z.ZodString>;
             latitudeColumn: z.ZodOptional<z.ZodString>;
             geometryColumn: z.ZodOptional<z.ZodString>;
+            geometryColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
             h3Column: z.ZodOptional<z.ZodString>;
             padding: z.ZodOptional<z.ZodNumber>;
             maxZoom: z.ZodOptional<z.ZodNumber>;
@@ -103,6 +105,12 @@ export declare const DeckMapResourceToolParameters: z.ZodObject<{
         }, z.core.$loose>>;
         settingsOpen: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>;
+    pointBinding: z.ZodOptional<z.ZodObject<{
+        dataset: z.ZodString;
+        longitudeColumn: z.ZodString;
+        latitudeColumn: z.ZodString;
+        geometryColumn: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     tableName: z.ZodOptional<z.ZodString>;
     replaceLayers: z.ZodOptional<z.ZodBoolean>;
     replaceDatasets: z.ZodOptional<z.ZodBoolean>;

package/dist/mapAiConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapAiConfig.d.ts","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAuCtB,kFAAkF;AAClF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBN,CAAC;AAEtC,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBxC,CAAC"}
+{"version":3,"file":"mapAiConfig.d.ts","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAgDtB,kFAAkF;AAClF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBN,CAAC;AAEtC,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBxC,CAAC"}

package/dist/mapAiConfig.js

@@ -26,16 +26,23 @@ const DeckMapFitToDataConfig = z.looseObject({
     longitudeColumn: z.string().optional(),
     latitudeColumn: z.string().optional(),
     geometryColumn: z.string().optional(),
+    geometryColumns: z.array(z.string()).optional(),
     h3Column: z.string().optional(),
     padding: z.number().optional(),
     maxZoom: z.number().optional(),
 });
+const DeckMapPointBindingParameter = z.object({
+    dataset: z.string().trim().min(1),
+    longitudeColumn: z.string().trim().min(1),
+    latitudeColumn: z.string().trim().min(1),
+    geometryColumn: z.string().trim().min(1).optional(),
+});
 /** Validates the portable Deck map config accepted from commands and AI tools. */
 export const DeckMapResourceConfigParameter = z.looseObject({
     spec: z.union([z.string(), z.record(z.string(), z.unknown())]),
     datasets: z
         .record(z.string(), DeckMapDatasetConfig)
-        .describe('Resource datasets keyed by id. Every dataset in a new map must define source.tableName or source.sqlQuery.'),
+        .describe('Resource datasets keyed by id. Every dataset in a new map must define source.tableName or source.sqlQuery. For visual-only updates send an empty object {} so merge keeps the existing registry — do not omit this field.'),
     configMode: z.enum(['basic', 'custom']).optional(),
     mapStyle: z.string().optional(),
     mapProps: z.record(z.string(), z.unknown()).optional(),
@@ -55,6 +62,7 @@ export const DeckMapResourceConfigParameter = z.looseObject({
 export const DeckMapResourceToolParameters = z.object({
     title: z.string().optional().default('Map'),
     config: DeckMapResourceConfigParameter,
+    pointBinding: DeckMapPointBindingParameter.optional().describe('Structured point provenance for a table-backed dataset. Prefer this over authoring transformSql when longitude and latitude columns should become WKB point geometry.'),
     tableName: z.string().optional(),
     replaceLayers: z
         .boolean()

package/dist/mapAiConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapAiConfig.js","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import {z} from 'zod';\nimport type {DeckMapConfig} from './mapConfig';\n\nconst DeckMapDatasetSource = z.union([\n  z.looseObject({\n    sqlQuery: z.string(),\n  }),\n  z.looseObject({\n    tableName: z.string(),\n    transformSql: z.string().optional(),\n  }),\n]);\nconst DeckMapDatasetConfig = z.looseObject({\n  source: DeckMapDatasetSource.optional().describe(\n    'Dataset source. Required for new maps; may be omitted only by a sparse update patch that retains an existing source.',\n  ),\n  geometryColumn: z.string().optional(),\n  geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),\n});\n\nconst DeckMapInteractionConfig = z.looseObject({\n  type: z.literal('point-radius-brush'),\n  dataset: z.string(),\n  longitudeColumn: z.string(),\n  latitudeColumn: z.string(),\n  radiusMeters: z.number().optional(),\n  event: z.enum(['hover', 'click']).optional(),\n});\n\nconst DeckMapFitToDataConfig = z.looseObject({\n  dataset: z.string(),\n  longitudeColumn: z.string().optional(),\n  latitudeColumn: z.string().optional(),\n  geometryColumn: z.string().optional(),\n  h3Column: z.string().optional(),\n  padding: z.number().optional(),\n  maxZoom: z.number().optional(),\n});\n\n/** Validates the portable Deck map config accepted from commands and AI tools. */\nexport const DeckMapResourceConfigParameter = z.looseObject({\n  spec: z.union([z.string(), z.record(z.string(), z.unknown())]),\n  datasets: z\n    .record(z.string(), DeckMapDatasetConfig)\n    .describe(\n      'Resource datasets keyed by id. Every dataset in a new map must define source.tableName or source.sqlQuery.',\n    ),\n  configMode: z.enum(['basic', 'custom']).optional(),\n  mapStyle: z.string().optional(),\n  mapProps: z.record(z.string(), z.unknown()).optional(),\n  showLegends: z.boolean().optional(),\n  interaction: DeckMapInteractionConfig.optional(),\n  fitToData: DeckMapFitToDataConfig.optional(),\n  dataPolicy: z\n    .looseObject({\n      disabled: z.boolean().optional(),\n      maxRows: z.number().int().min(1).optional(),\n      reason: z.string().optional(),\n    })\n    .optional(),\n  settingsOpen: z.boolean().optional(),\n}) satisfies z.ZodType<DeckMapConfig>;\n\n/** Validates inputs for an AI or command invocation that writes a map resource. */\nexport const DeckMapResourceToolParameters = z.object({\n  title: z.string().optional().default('Map'),\n  config: DeckMapResourceConfigParameter,\n  tableName: z.string().optional(),\n  replaceLayers: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.spec.layers is the complete desired list and omitted existing layers should be removed.',\n    ),\n  replaceDatasets: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.datasets is the complete desired registry and omitted existing datasets should be removed.',\n    ),\n  reasoning: z.string(),\n});\n"]}
+{"version":3,"file":"mapAiConfig.js","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import {z} from 'zod';\nimport type {DeckMapConfig} from './mapConfig';\nimport type {DeckMapPointBinding} from './mapConfigUtils';\n\nconst DeckMapDatasetSource = z.union([\n  z.looseObject({\n    sqlQuery: z.string(),\n  }),\n  z.looseObject({\n    tableName: z.string(),\n    transformSql: z.string().optional(),\n  }),\n]);\nconst DeckMapDatasetConfig = z.looseObject({\n  source: DeckMapDatasetSource.optional().describe(\n    'Dataset source. Required for new maps; may be omitted only by a sparse update patch that retains an existing source.',\n  ),\n  geometryColumn: z.string().optional(),\n  geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),\n});\n\nconst DeckMapInteractionConfig = z.looseObject({\n  type: z.literal('point-radius-brush'),\n  dataset: z.string(),\n  longitudeColumn: z.string(),\n  latitudeColumn: z.string(),\n  radiusMeters: z.number().optional(),\n  event: z.enum(['hover', 'click']).optional(),\n});\n\nconst DeckMapFitToDataConfig = z.looseObject({\n  dataset: z.string(),\n  longitudeColumn: z.string().optional(),\n  latitudeColumn: z.string().optional(),\n  geometryColumn: z.string().optional(),\n  geometryColumns: z.array(z.string()).optional(),\n  h3Column: z.string().optional(),\n  padding: z.number().optional(),\n  maxZoom: z.number().optional(),\n});\n\nconst DeckMapPointBindingParameter = z.object({\n  dataset: z.string().trim().min(1),\n  longitudeColumn: z.string().trim().min(1),\n  latitudeColumn: z.string().trim().min(1),\n  geometryColumn: z.string().trim().min(1).optional(),\n}) satisfies z.ZodType<DeckMapPointBinding>;\n\n/** Validates the portable Deck map config accepted from commands and AI tools. */\nexport const DeckMapResourceConfigParameter = z.looseObject({\n  spec: z.union([z.string(), z.record(z.string(), z.unknown())]),\n  datasets: z\n    .record(z.string(), DeckMapDatasetConfig)\n    .describe(\n      'Resource datasets keyed by id. Every dataset in a new map must define source.tableName or source.sqlQuery. For visual-only updates send an empty object {} so merge keeps the existing registry — do not omit this field.',\n    ),\n  configMode: z.enum(['basic', 'custom']).optional(),\n  mapStyle: z.string().optional(),\n  mapProps: z.record(z.string(), z.unknown()).optional(),\n  showLegends: z.boolean().optional(),\n  interaction: DeckMapInteractionConfig.optional(),\n  fitToData: DeckMapFitToDataConfig.optional(),\n  dataPolicy: z\n    .looseObject({\n      disabled: z.boolean().optional(),\n      maxRows: z.number().int().min(1).optional(),\n      reason: z.string().optional(),\n    })\n    .optional(),\n  settingsOpen: z.boolean().optional(),\n}) satisfies z.ZodType<DeckMapConfig>;\n\n/** Validates inputs for an AI or command invocation that writes a map resource. */\nexport const DeckMapResourceToolParameters = z.object({\n  title: z.string().optional().default('Map'),\n  config: DeckMapResourceConfigParameter,\n  pointBinding: DeckMapPointBindingParameter.optional().describe(\n    'Structured point provenance for a table-backed dataset. Prefer this over authoring transformSql when longitude and latitude columns should become WKB point geometry.',\n  ),\n  tableName: z.string().optional(),\n  replaceLayers: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.spec.layers is the complete desired list and omitted existing layers should be removed.',\n    ),\n  replaceDatasets: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.datasets is the complete desired registry and omitted existing datasets should be removed.',\n    ),\n  reasoning: z.string(),\n});\n"]}

package/dist/mapAiSharedInstructions.d.ts

@@ -0,0 +1,3 @@
+/** Shared Deck map AI rules for dashboard and document prompts. */
+export declare function getDeckMapSharedAiContractRules(): string;
+//# sourceMappingURL=mapAiSharedInstructions.d.ts.map

package/dist/mapAiSharedInstructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapAiSharedInstructions.d.ts","sourceRoot":"","sources":["../src/mapAiSharedInstructions.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,wBAAgB,+BAA+B,IAAI,MAAM,CAYxD"}

package/dist/mapAiSharedInstructions.js

@@ -0,0 +1,16 @@
+import { DECK_TABLE_DATASET_SOURCE_RELATION } from './datasets/tableDatasetSql';
+/** Shared Deck map AI rules for dashboard and document prompts. */
+export function getDeckMapSharedAiContractRules() {
+    const src = DECK_TABLE_DATASET_SOURCE_RELATION;
+    return `Shared Deck map authoring rules (dashboard and document):
+- Scatterplot/Heatmap/Column require Point positions — do not bind them to Polygon/MultiPolygon geom. Prefer GeoArrowPolygonLayer for Polygon, GeoJsonLayer for WKB/WKT MultiPolygon, or transformSql with ST_AsWKB(ST_Centroid(geom)) / ST_PointOnSurface(geom) when the user wants points (e.g. SELECT * EXCLUDE (geom), ST_AsWKB(ST_Centroid(geom)) AS geom FROM ${src}). The runtime will not invent centroids.
+- Mixed Point/LineString/Polygon columns: use GeoJsonLayer. Typed GeoArrowPolygon/Path/Scatterplot layers need a uniform geometry type. To keep one class, filter with WHERE ST_GeometryType(geom) IN (...) then use the matching typed layer.
+- Never write SELECT *, ST_AsWKB(col) AS col — DuckDB keeps the original column and the WKB alias collides. Use SELECT * EXCLUDE (col), ST_AsWKB(...) AS col, or omit transformSql when geom already exists. Bare ST_Point(...) / table GEOMETRY columns are projected to WKB by the dataset pipeline; prefer explicit ST_AsWKB when practical.
+- GeoArrowHeatmapLayer: omit colorRange (UI scheme selector owns it) and omit getWeight (default uniform density). Do not bind getWeight to a column — basic mode has no weight-column control.
+- Never set mapStyle to a mapbox:// URL — MapLibre cannot load that scheme. Omit mapStyle for the host basemap, or use a token-free MapLibre https:// style URL.
+- GeoArrowH3HexagonLayer: set getHexagon to "@@=h3_column" (or _sqlroomsBinding.hexagonColumn). When aggregating lon/lat, prefer h3_h3_to_string(h3_latlng_to_cell(lat, lon, res)) AS h3_cell (lat before lon).
+- GeoArrowArcLayer: bind WKB via _sqlroomsBinding.sourceGeometryColumn / targetGeometryColumn only (do not set getSourcePosition/getTargetPosition). Use ST_AsWKB(ST_Point(...)); set geometryEncodingHint to "wkb".
+- GeoArrowTripsLayer = animated path over time; GeoArrowArcLayer = static OD curve. Prefer TripsLayer for animated/trips/moving routes.
+- COLOR SCALE FIELD VARIANCE: Before choosing a numeric colorScale field, confirm it has real range (min < max / not all zeros or a single constant). Prefer SUMMARIZE table_name or SELECT min(col), max(col), count(DISTINCT col) FROM ... when unsure. Do NOT color by a flat column unless the user explicitly asks for that column by name. If no varying column exists, use a flat fill color instead of colorScale. Categorical fields need more than one distinct non-null value to be useful. Geometry, lon/lat, H3 index, and opaque ID columns are not useful color fields unless the user asks for them.`;
+}
+//# sourceMappingURL=mapAiSharedInstructions.js.map

package/dist/mapAiSharedInstructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapAiSharedInstructions.js","sourceRoot":"","sources":["../src/mapAiSharedInstructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,4BAA4B,CAAC;AAE9E,mEAAmE;AACnE,MAAM,UAAU,+BAA+B;IAC7C,MAAM,GAAG,GAAG,kCAAkC,CAAC;IAC/C,OAAO;sWAC6V,GAAG;;;;;;;;qlBAQ4O,CAAC;AACtlB,CAAC","sourcesContent":["import {DECK_TABLE_DATASET_SOURCE_RELATION} from './datasets/tableDatasetSql';\n\n/** Shared Deck map AI rules for dashboard and document prompts. */\nexport function getDeckMapSharedAiContractRules(): string {\n  const src = DECK_TABLE_DATASET_SOURCE_RELATION;\n  return `Shared Deck map authoring rules (dashboard and document):\n- Scatterplot/Heatmap/Column require Point positions — do not bind them to Polygon/MultiPolygon geom. Prefer GeoArrowPolygonLayer for Polygon, GeoJsonLayer for WKB/WKT MultiPolygon, or transformSql with ST_AsWKB(ST_Centroid(geom)) / ST_PointOnSurface(geom) when the user wants points (e.g. SELECT * EXCLUDE (geom), ST_AsWKB(ST_Centroid(geom)) AS geom FROM ${src}). The runtime will not invent centroids.\n- Mixed Point/LineString/Polygon columns: use GeoJsonLayer. Typed GeoArrowPolygon/Path/Scatterplot layers need a uniform geometry type. To keep one class, filter with WHERE ST_GeometryType(geom) IN (...) then use the matching typed layer.\n- Never write SELECT *, ST_AsWKB(col) AS col — DuckDB keeps the original column and the WKB alias collides. Use SELECT * EXCLUDE (col), ST_AsWKB(...) AS col, or omit transformSql when geom already exists. Bare ST_Point(...) / table GEOMETRY columns are projected to WKB by the dataset pipeline; prefer explicit ST_AsWKB when practical.\n- GeoArrowHeatmapLayer: omit colorRange (UI scheme selector owns it) and omit getWeight (default uniform density). Do not bind getWeight to a column — basic mode has no weight-column control.\n- Never set mapStyle to a mapbox:// URL — MapLibre cannot load that scheme. Omit mapStyle for the host basemap, or use a token-free MapLibre https:// style URL.\n- GeoArrowH3HexagonLayer: set getHexagon to \"@@=h3_column\" (or _sqlroomsBinding.hexagonColumn). When aggregating lon/lat, prefer h3_h3_to_string(h3_latlng_to_cell(lat, lon, res)) AS h3_cell (lat before lon).\n- GeoArrowArcLayer: bind WKB via _sqlroomsBinding.sourceGeometryColumn / targetGeometryColumn only (do not set getSourcePosition/getTargetPosition). Use ST_AsWKB(ST_Point(...)); set geometryEncodingHint to \"wkb\".\n- GeoArrowTripsLayer = animated path over time; GeoArrowArcLayer = static OD curve. Prefer TripsLayer for animated/trips/moving routes.\n- COLOR SCALE FIELD VARIANCE: Before choosing a numeric colorScale field, confirm it has real range (min < max / not all zeros or a single constant). Prefer SUMMARIZE table_name or SELECT min(col), max(col), count(DISTINCT col) FROM ... when unsure. Do NOT color by a flat column unless the user explicitly asks for that column by name. If no varying column exists, use a flat fill color instead of colorScale. Categorical fields need more than one distinct non-null value to be useful. Geometry, lon/lat, H3 index, and opaque ID columns are not useful color fields unless the user asks for them.`;\n}\n"]}

package/dist/mapConfig.d.ts

@@ -27,6 +27,12 @@ export type DeckMapFitToDataConfig = {
     longitudeColumn?: string;
     latitudeColumn?: string;
     geometryColumn?: string;
+    /**
+     * Multiple geometry columns whose extents should be combined when fitting
+     * the view. Used for arc layers that have separate source and target
+     * geometries — a single `geometryColumn` would only cover one endpoint.
+     */
+    geometryColumns?: string[];
     h3Column?: string;
     padding?: number;
     maxZoom?: number;
@@ -47,7 +53,7 @@ export type DeckMapConfig = {
 };
 /** Creates the portable empty configuration used for a new Deck map. */
 export declare function createEmptyDeckMapConfig(): DeckMapConfig;
-/** Adapter-facing dashboard panel shape; worksheet resources never store it. */
+/** Adapter-facing dashboard panel shape; document resources never store it. */
 export type DeckMapDashboardPanelConfig = DeckMapConfig;
 export type DeckMapDashboardDatasetConfig = DeckMapDatasetConfig;
 export type DeckMapDashboardDatasetSource = DeckMapDatasetSource;

package/dist/mapConfig.d.ts.map

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