@carto/api-client 0.4.3 → 0.5.0-alpha.0

package/build/api-client.modern.js

@@ -3,6 +3,10 @@ import bboxPolygon from '@turf/bbox-polygon';
 import union from '@turf/union';
 import { getType } from '@turf/invariant';
 import { featureCollection, feature, polygon, multiPolygon } from '@turf/helpers';
+import intersects from '@turf/boolean-intersects';
+import booleanWithin from '@turf/boolean-within';
+import intersect from '@turf/intersect';
+import { getResolution as getResolution$2, polygonToCells } from 'h3-js';
 
 /**
  * @internal
@@ -61,6 +65,31 @@ var ApiVersion;
 })(ApiVersion || (ApiVersion = {}));
 /** @internalRemarks Source: @carto/constants, @deck.gl/carto */
 const DEFAULT_API_BASE_URL = 'https://gcp-us-east1.api.carto.com';
+/** @internalRemarks Source: @carto/react-core */
+var TileFormat;
+(function (TileFormat) {
+  TileFormat["MVT"] = "mvt";
+  TileFormat["JSON"] = "json";
+  TileFormat["GEOJSON"] = "geojson";
+  TileFormat["BINARY"] = "binary";
+})(TileFormat || (TileFormat = {}));
+/** @internalRemarks Source: @carto/react-core */
+var SpatialIndex;
+(function (SpatialIndex) {
+  SpatialIndex["H3"] = "h3";
+  SpatialIndex["S2"] = "s2";
+  SpatialIndex["QUADBIN"] = "quadbin";
+})(SpatialIndex || (SpatialIndex = {}));
+/** @internalRemarks Source: @carto/react-core */
+var Provider;
+(function (Provider) {
+  Provider["BIGQUERY"] = "bigquery";
+  Provider["REDSHIFT"] = "redshift";
+  Provider["POSTGRES"] = "postgres";
+  Provider["SNOWFLAKE"] = "snowflake";
+  Provider["DATABRICKS"] = "databricks";
+  Provider["DATABRICKS_REST"] = "databricksRest";
+})(Provider || (Provider = {}));
 
 const FILTER_TYPES = new Set(Object.values(FilterType));
 const isFilterType = type => FILTER_TYPES.has(type);
@@ -103,7 +132,7 @@ function normalizeObjectKeys(el) {
   }, {});
 }
 /** @internalRemarks Source: @carto/react-core */
-function assert(condition, message) {
+function assert$1(condition, message) {
   if (!condition) {
     throw new Error(message);
   }
@@ -606,7 +635,7 @@ function excludeURLParameters(baseUrlString, parameters) {
   return baseUrl.toString();
 }
 
-const _excluded$1 = ["accessToken", "connectionName", "cache"];
+const _excluded$2 = ["accessToken", "connectionName", "cache"];
 const SOURCE_DEFAULTS = {
   apiBaseUrl: DEFAULT_API_BASE_URL,
   clientId: getClient(),
@@ -620,7 +649,7 @@ async function baseSource(endpoint, options, urlParameters) {
       connectionName,
       cache
     } = options,
-    optionalOptions = _objectWithoutPropertiesLoose(options, _excluded$1);
+    optionalOptions = _objectWithoutPropertiesLoose(options, _excluded$2);
   const mergedOptions = _extends({}, SOURCE_DEFAULTS, {
     accessToken,
     connectionName,
@@ -686,6 +715,8 @@ async function baseSource(endpoint, options, urlParameters) {
 }
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const boundaryQuerySource = async function boundaryQuerySource(options) {
   const {
     columns,
@@ -711,6 +742,8 @@ const boundaryQuerySource = async function boundaryQuerySource(options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const boundaryTableSource = async function boundaryTableSource(options) {
   const {
     filters,
@@ -804,10 +837,10 @@ const REQUEST_GET_MAX_URL_LENGTH = 2048;
  * @internalRemarks Source: @carto/react-api
  */
 function executeModel(props) {
-  assert(props.source, 'executeModel: missing source');
-  assert(props.model, 'executeModel: missing model');
-  assert(props.params, 'executeModel: missing params');
-  assert(AVAILABLE_MODELS.includes(props.model), `executeModel: model provided isn't valid. Available models: ${AVAILABLE_MODELS.join(', ')}`);
+  assert$1(props.source, 'executeModel: missing source');
+  assert$1(props.model, 'executeModel: missing model');
+  assert$1(props.params, 'executeModel: missing params');
+  assert$1(AVAILABLE_MODELS.includes(props.model), `executeModel: model provided isn't valid. Available models: ${AVAILABLE_MODELS.join(', ')}`);
   const {
     model,
     source,
@@ -822,50 +855,52 @@ function executeModel(props) {
     connectionName,
     clientId
   } = source;
-  assert(apiBaseUrl, 'executeModel: missing apiBaseUrl');
-  assert(accessToken, 'executeModel: missing accessToken');
-  assert(apiVersion === V3, 'executeModel: SQL Model API requires CARTO 3+');
-  assert(type !== 'tileset', 'executeModel: Tilesets not supported');
+  assert$1(apiBaseUrl, 'executeModel: missing apiBaseUrl');
+  assert$1(accessToken, 'executeModel: missing accessToken');
+  assert$1(apiVersion === V3, 'executeModel: SQL Model API requires CARTO 3+');
+  assert$1(type !== 'tileset', 'executeModel: Tilesets not supported');
   let url = `${apiBaseUrl}/v3/sql/${connectionName}/model/${model}`;
   const {
     data,
     filters,
     filtersLogicalOperator = 'and',
-    geoColumn = DEFAULT_GEO_COLUMN
+    spatialDataType = 'geo',
+    spatialFiltersMode = 'intersects',
+    spatialFiltersResolution = 0
   } = source;
-  const queryParameters = source.queryParameters ? JSON.stringify(source.queryParameters) : '';
   const queryParams = {
     type,
     client: clientId,
     source: data,
-    params: JSON.stringify(params),
-    queryParameters,
-    filters: JSON.stringify(filters),
+    params,
+    queryParameters: source.queryParameters || '',
+    filters,
     filtersLogicalOperator
   };
+  const spatialDataColumn = source.spatialDataColumn || DEFAULT_GEO_COLUMN;
   // Picking Model API requires 'spatialDataColumn'.
   if (model === 'pick') {
-    queryParams.spatialDataColumn = geoColumn;
+    queryParams.spatialDataColumn = spatialDataColumn;
   }
-  // API supports multiple filters, we apply it only to geoColumn
+  // API supports multiple filters, we apply it only to spatialDataColumn
   const spatialFilters = source.spatialFilter ? {
-    [geoColumn]: source.spatialFilter
+    [spatialDataColumn]: source.spatialFilter
   } : undefined;
   if (spatialFilters) {
-    queryParams.spatialFilters = JSON.stringify(spatialFilters);
+    queryParams.spatialFilters = spatialFilters;
+    queryParams.spatialDataColumn = spatialDataColumn;
+    queryParams.spatialDataType = spatialDataType;
+  }
+  if (spatialDataType !== 'geo') {
+    if (spatialFiltersResolution > 0) {
+      queryParams.spatialFiltersResolution = spatialFiltersResolution;
+    }
+    queryParams.spatialFiltersMode = spatialFiltersMode;
   }
-  const urlWithSearchParams = url + '?' + new URLSearchParams(queryParams).toString();
+  const urlWithSearchParams = url + '?' + objectToURLSearchParams(queryParams).toString();
   const isGet = urlWithSearchParams.length <= REQUEST_GET_MAX_URL_LENGTH;
   if (isGet) {
     url = urlWithSearchParams;
-  } else {
-    // undo the JSON.stringify, @TODO find a better pattern
-    queryParams.params = params;
-    queryParams.filters = filters;
-    queryParams.queryParameters = source.queryParameters;
-    if (spatialFilters) {
-      queryParams.spatialFilters = spatialFilters;
-    }
   }
   return makeCall({
     url,
@@ -877,24 +912,72 @@ function executeModel(props) {
     })
   });
 }
+function objectToURLSearchParams(object) {
+  const params = new URLSearchParams();
+  for (const key in object) {
+    if (isPureObject(object[key])) {
+      params.append(key, JSON.stringify(object[key]));
+    } else if (Array.isArray(object[key])) {
+      params.append(key, JSON.stringify(object[key]));
+    } else if (object[key] === null) {
+      params.append(key, 'null');
+    } else if (object[key] !== undefined) {
+      params.append(key, String(object[key]));
+    }
+  }
+  return params;
+}
+
+const DEFAULT_TILE_SIZE = 512;
+const QUADBIN_ZOOM_MAX_OFFSET = 4;
+function getSpatialFiltersResolution(source, viewState) {
+  var _source$dataResolutio, _source$aggregationRe;
+  const dataResolution = (_source$dataResolutio = source.dataResolution) != null ? _source$dataResolutio : Number.MAX_VALUE;
+  const aggregationResLevel = (_source$aggregationRe = source.aggregationResLevel) != null ? _source$aggregationRe : source.spatialDataType === 'h3' ? DEFAULT_AGGREGATION_RES_LEVEL_H3 : DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN;
+  const aggregationResLevelOffset = Math.max(0, Math.floor(aggregationResLevel));
+  const currentZoomInt = Math.ceil(viewState.zoom);
+  if (source.spatialDataType === 'h3') {
+    var _maxH3SpatialFiltersR, _maxH3SpatialFiltersR2;
+    const tileSize = DEFAULT_TILE_SIZE;
+    const maxResolutionForZoom = (_maxH3SpatialFiltersR = (_maxH3SpatialFiltersR2 = maxH3SpatialFiltersResolutions.find(([zoom]) => zoom === currentZoomInt)) == null ? void 0 : _maxH3SpatialFiltersR2[1]) != null ? _maxH3SpatialFiltersR : Math.max(0, currentZoomInt - 3);
+    const maxSpatialFiltersResolution = maxResolutionForZoom ? Math.min(dataResolution, maxResolutionForZoom) : dataResolution;
+    const hexagonResolution = getHexagonResolution(viewState, tileSize) + aggregationResLevelOffset;
+    return Math.min(hexagonResolution, maxSpatialFiltersResolution);
+  }
+  if (source.spatialDataType === 'quadbin') {
+    const maxResolutionForZoom = currentZoomInt + QUADBIN_ZOOM_MAX_OFFSET;
+    const maxSpatialFiltersResolution = Math.min(dataResolution, maxResolutionForZoom);
+    const quadsResolution = Math.floor(viewState.zoom) + aggregationResLevelOffset;
+    return Math.min(quadsResolution, maxSpatialFiltersResolution);
+  }
+  return undefined;
+}
+const maxH3SpatialFiltersResolutions = [[20, 14], [19, 13], [18, 12], [17, 11], [16, 10], [15, 9], [14, 8], [13, 7], [12, 7], [11, 7], [10, 6], [9, 6], [8, 5], [7, 4], [6, 4], [5, 3], [4, 2], [3, 1], [2, 1], [1, 0]];
+// stolen from https://github.com/visgl/deck.gl/blob/master/modules/carto/src/layers/h3-tileset-2d.ts
+// Relative scale factor (0 = no biasing, 2 = a few hexagons cover view)
+const BIAS = 2;
+// Resolution conversion function. Takes a WebMercatorViewport and returns
+// a H3 resolution such that the screen space size of the hexagons is
+// similar
+function getHexagonResolution(viewport, tileSize) {
+  // Difference in given tile size compared to deck's internal 512px tile size,
+  // expressed as an offset to the viewport zoom.
+  const zoomOffset = Math.log2(tileSize / DEFAULT_TILE_SIZE);
+  const hexagonScaleFactor = 2 / 3 * (viewport.zoom - zoomOffset);
+  const latitudeScaleFactor = Math.log(1 / Math.cos(Math.PI * viewport.latitude / 180));
+  // Clip and bias
+  return Math.max(0, Math.floor(hexagonScaleFactor + latitudeScaleFactor - BIAS));
+}
 
-const _excluded = ["filterOwner", "spatialFilter", "abortController"],
-  _excluded2 = ["filterOwner", "spatialFilter", "abortController"],
-  _excluded3 = ["filterOwner", "spatialFilter", "abortController", "operationExp"],
-  _excluded4 = ["filterOwner", "spatialFilter", "abortController"],
-  _excluded5 = ["filterOwner", "spatialFilter", "abortController"],
-  _excluded6 = ["filterOwner", "spatialFilter", "abortController"],
-  _excluded7 = ["filterOwner", "spatialFilter", "abortController"],
-  _excluded8 = ["filterOwner", "abortController", "spatialFilter"];
 /**
  * Source for Widget API requests on a data source defined by a SQL query.
  *
  * Abstract class. Use {@link WidgetQuerySource} or {@link WidgetTableSource}.
  */
-class WidgetBaseSource {
+class WidgetSource {
   constructor(props) {
     this.props = void 0;
-    this.props = _extends({}, WidgetBaseSource.defaultProps, props);
+    this.props = _extends({}, WidgetSource.defaultProps, props);
   }
   _getModelSource(owner) {
     const props = this.props;
@@ -906,31 +989,65 @@ class WidgetBaseSource {
       connectionName: props.connectionName,
       filters: getApplicableFilters(owner, props.filters),
       filtersLogicalOperator: props.filtersLogicalOperator,
-      geoColumn: props.geoColumn
+      spatialDataType: props.spatialDataType,
+      spatialDataColumn: props.spatialDataColumn,
+      dataResolution: props.dataResolution
     };
   }
-  /****************************************************************************
-   * CATEGORIES
-   */
-  /**
-   * Returns a list of labeled datapoints for categorical data. Suitable for
-   * charts including grouped bar charts, pie charts, and tree charts.
-   */
+  _getSpatialFiltersResolution(source, spatialFilter, referenceViewState) {
+    // spatialFiltersResolution applies only to spatial index sources.
+    if (!spatialFilter || source.spatialDataType === 'geo') {
+      return;
+    }
+    if (!referenceViewState) {
+      throw new Error('Missing required option, "spatialIndexReferenceViewState".');
+    }
+    return getSpatialFiltersResolution(source, referenceViewState);
+  }
+}
+WidgetSource.defaultProps = {
+  apiVersion: ApiVersion.V3,
+  apiBaseUrl: DEFAULT_API_BASE_URL,
+  clientId: getClient(),
+  filters: {},
+  filtersLogicalOperator: 'and'
+};
+
+const _excluded$1 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController"],
+  _excluded2 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController"],
+  _excluded3 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController", "operationExp"],
+  _excluded4 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController"],
+  _excluded5 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController"],
+  _excluded6 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController"],
+  _excluded7 = ["filterOwner", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState", "abortController"],
+  _excluded8 = ["filterOwner", "abortController", "spatialFilter", "spatialFiltersMode", "spatialIndexReferenceViewState"];
+/**
+ * Source for Widget API requests.
+ *
+ * Abstract class. Use {@link WidgetQuerySource} or {@link WidgetTableSource}.
+ */
+class WidgetRemoteSource extends WidgetSource {
   async getCategories(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController
       } = options,
-      params = _objectWithoutPropertiesLoose(options, _excluded);
+      params = _objectWithoutPropertiesLoose(options, _excluded$1);
     const {
       column,
       operation,
       operationColumn
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     return executeModel({
       model: 'category',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -943,21 +1060,12 @@ class WidgetBaseSource {
       }
     }).then(res => normalizeObjectKeys(res.rows));
   }
-  /****************************************************************************
-   * FEATURES
-   */
-  /**
-   * Given a list of feature IDs (as found in `_carto_feature_id`) returns all
-   * matching features. In datasets containing features with duplicate geometries,
-   * feature IDs may be duplicated (IDs are a hash of geometry) and so more
-   * results may be returned than IDs in the request.
-   * @internal
-   * @experimental
-   */
   async getFeatures(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController
       } = options,
       params = _objectWithoutPropertiesLoose(options, _excluded2);
@@ -969,9 +1077,13 @@ class WidgetBaseSource {
       limit,
       tileResolution
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     return executeModel({
       model: 'pick',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -992,17 +1104,12 @@ class WidgetBaseSource {
       rows
     }));
   }
-  /****************************************************************************
-   * FORMULA
-   */
-  /**
-   * Returns a scalar numerical statistic over all matching data. Suitable
-   * for 'headline' or 'scorecard' figures such as counts and sums.
-   */
   async getFormula(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         operationExp
       } = options,
@@ -1011,14 +1118,18 @@ class WidgetBaseSource {
       column,
       operation
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     return executeModel({
       model: 'formula',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
         column: column != null ? column : '*',
-        operation,
+        operation: operation != null ? operation : 'count',
         operationExp
       },
       opts: {
@@ -1026,17 +1137,12 @@ class WidgetBaseSource {
       }
     }).then(res => normalizeObjectKeys(res.rows[0]));
   }
-  /****************************************************************************
-   * HISTOGRAM
-   */
-  /**
-   * Returns a list of labeled datapoints for 'bins' of data defined as ticks
-   * over a numerical range. Suitable for histogram charts.
-   */
   async getHistogram(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController
       } = options,
       params = _objectWithoutPropertiesLoose(options, _excluded4);
@@ -1045,9 +1151,13 @@ class WidgetBaseSource {
       operation,
       ticks
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     const data = await executeModel({
       model: 'histogram',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -1071,27 +1181,25 @@ class WidgetBaseSource {
     }
     return [];
   }
-  /****************************************************************************
-   * RANGE
-   */
-  /**
-   * Returns a range (min and max) for a numerical column of matching rows.
-   * Suitable for displaying certain 'headline' or 'scorecard' statistics,
-   * or rendering a range slider UI for filtering.
-   */
   async getRange(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController
       } = options,
       params = _objectWithoutPropertiesLoose(options, _excluded5);
     const {
       column
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     return executeModel({
       model: 'range',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -1102,17 +1210,12 @@ class WidgetBaseSource {
       }
     }).then(res => normalizeObjectKeys(res.rows[0]));
   }
-  /****************************************************************************
-   * SCATTER
-   */
-  /**
-   * Returns a list of bivariate datapoints defined as numerical 'x' and 'y'
-   * values. Suitable for rendering scatter plots.
-   */
   async getScatter(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController
       } = options,
       params = _objectWithoutPropertiesLoose(options, _excluded6);
@@ -1122,11 +1225,15 @@ class WidgetBaseSource {
       yAxisColumn,
       yAxisJoinOperation
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     // Make sure this is sync with the same constant in cloud-native/maps-api
     const HARD_LIMIT = 500;
     return executeModel({
       model: 'scatterplot',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -1144,17 +1251,12 @@ class WidgetBaseSource {
       y
     }) => [x, y]));
   }
-  /****************************************************************************
-   * TABLE
-   */
-  /**
-   * Returns a list of arbitrary data rows, with support for pagination and
-   * sorting. Suitable for displaying tables and lists.
-   */
   async getTable(options) {
     const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController
       } = options,
       params = _objectWithoutPropertiesLoose(options, _excluded7);
@@ -1165,9 +1267,13 @@ class WidgetBaseSource {
       offset = 0,
       limit = 10
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     return executeModel({
       model: 'table',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -1189,18 +1295,13 @@ class WidgetBaseSource {
       };
     });
   }
-  /****************************************************************************
-   * TIME SERIES
-   */
-  /**
-   * Returns a series of labeled numerical values, grouped into equally-sized
-   * time intervals. Suitable for rendering time series charts.
-   */
   async getTimeSeries(options) {
     const {
         filterOwner,
         abortController,
-        spatialFilter
+        spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState
       } = options,
       params = _objectWithoutPropertiesLoose(options, _excluded8);
     const {
@@ -1214,9 +1315,13 @@ class WidgetBaseSource {
       splitByCategoryLimit,
       splitByCategoryValues
     } = params;
+    const source = this.getModelSource(filterOwner);
+    const spatialFiltersResolution = this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
     return executeModel({
       model: 'timeseries',
-      source: _extends({}, this.getModelSource(filterOwner), {
+      source: _extends({}, source, {
+        spatialFiltersResolution,
+        spatialFiltersMode,
         spatialFilter
       }),
       params: {
@@ -1242,14 +1347,6 @@ class WidgetBaseSource {
     });
   }
 }
-WidgetBaseSource.defaultProps = {
-  apiVersion: ApiVersion.V3,
-  apiBaseUrl: DEFAULT_API_BASE_URL,
-  clientId: getClient(),
-  filters: {},
-  filtersLogicalOperator: 'and',
-  geoColumn: DEFAULT_GEO_COLUMN
-};
 
 /**
  * Source for Widget API requests on a data source defined by a SQL query.
@@ -1273,7 +1370,7 @@ WidgetBaseSource.defaultProps = {
  * const { widgetSource } = await data;
  * ```
  */
-class WidgetQuerySource extends WidgetBaseSource {
+class WidgetQuerySource extends WidgetRemoteSource {
   getModelSource(owner) {
     return _extends({}, super._getModelSource(owner), {
       type: 'query',
@@ -1305,7 +1402,7 @@ class WidgetQuerySource extends WidgetBaseSource {
  * const { widgetSource } = await data;
  * ```
  */
-class WidgetTableSource extends WidgetBaseSource {
+class WidgetTableSource extends WidgetRemoteSource {
   getModelSource(owner) {
     return _extends({}, super._getModelSource(owner), {
       type: 'table',
@@ -1314,156 +1411,2022 @@ class WidgetTableSource extends WidgetBaseSource {
   }
 }
 
-const h3QuerySource = async function h3QuerySource(options) {
-  const {
-    aggregationExp,
-    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
-    sqlQuery,
-    spatialDataColumn = 'h3',
-    queryParameters,
-    filters
-  } = options;
-  const urlParameters = {
-    aggregationExp,
-    spatialDataColumn,
-    spatialDataType: 'h3',
-    q: sqlQuery
-  };
-  if (aggregationResLevel) {
-    urlParameters.aggregationResLevel = String(aggregationResLevel);
-  }
-  if (queryParameters) {
-    urlParameters.queryParameters = queryParameters;
-  }
-  if (filters) {
-    urlParameters.filters = filters;
-  }
-  return baseSource('query', options, urlParameters).then(result => _extends({}, result, {
-    widgetSource: new WidgetQuerySource(options)
-  }));
-};
+function makeIntervalComplete(intervals) {
+  return intervals.map(val => {
+    if (val[0] === undefined || val[0] === null) {
+      return [Number.MIN_SAFE_INTEGER, val[1]];
+    }
+    if (val[1] === undefined || val[1] === null) {
+      return [val[0], Number.MAX_SAFE_INTEGER];
+    }
+    return val;
+  });
+}
 
-const h3TableSource = async function h3TableSource(options) {
-  const {
-    aggregationExp,
-    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
-    spatialDataColumn = 'h3',
-    tableName,
-    filters
-  } = options;
-  const urlParameters = {
-    aggregationExp,
-    name: tableName,
-    spatialDataColumn,
-    spatialDataType: 'h3'
+const filterFunctions = {
+  [FilterType.IN]: filterIn,
+  [FilterType.BETWEEN]: filterBetween,
+  [FilterType.TIME]: filterTime,
+  [FilterType.CLOSED_OPEN]: filterClosedOpen,
+  [FilterType.STRING_SEARCH]: filterStringSearch
+};
+function filterIn(filterValues, featureValue) {
+  return filterValues.includes(featureValue);
+}
+// FilterTypes.BETWEEN
+function filterBetween(filterValues, featureValue) {
+  const checkRange = range => {
+    const [lowerBound, upperBound] = range;
+    return featureValue >= lowerBound && featureValue <= upperBound;
   };
-  if (aggregationResLevel) {
-    urlParameters.aggregationResLevel = String(aggregationResLevel);
-  }
-  if (filters) {
-    urlParameters.filters = filters;
+  return makeIntervalComplete(filterValues).some(checkRange);
+}
+function filterTime(filterValues, featureValue) {
+  const featureValueAsTimestamp = new Date(featureValue).getTime();
+  if (isFinite(featureValueAsTimestamp)) {
+    return filterBetween(filterValues, featureValueAsTimestamp);
+  } else {
+    throw new Error(`Column used to filter by time isn't well formatted.`);
   }
-  return baseSource('table', options, urlParameters).then(result => _extends({}, result, {
-    widgetSource: new WidgetTableSource(options)
-  }));
-};
-
-// deck.gl
-const h3TilesetSource = async function h3TilesetSource(options) {
-  const {
-    tableName
-  } = options;
-  const urlParameters = {
-    name: tableName
+}
+// FilterTypes.CLOSED_OPEN
+function filterClosedOpen(filterValues, featureValue) {
+  const checkRange = range => {
+    const [lowerBound, upperBound] = range;
+    return featureValue >= lowerBound && featureValue < upperBound;
   };
-  return baseSource('tileset', options, urlParameters);
-};
+  return makeIntervalComplete(filterValues).some(checkRange);
+}
+// FilterTypes.STRING_SEARCH
+function filterStringSearch(filterValues, featureValue, params = {}) {
+  const normalizedFeatureValue = normalize(featureValue, params);
+  const stringRegExp = params.useRegExp ? filterValues : filterValues.map(filterValue => {
+    let stringRegExp = escapeRegExp(normalize(filterValue, params));
+    if (params.mustStart) stringRegExp = `^${stringRegExp}`;
+    if (params.mustEnd) stringRegExp = `${stringRegExp}$`;
+    return stringRegExp;
+  });
+  const regex = new RegExp(stringRegExp.join('|'), params.caseSensitive ? 'g' : 'gi');
+  return !!normalizedFeatureValue.match(regex);
+}
+// Aux
+const specialCharRegExp = /[.*+?^${}()|[\]\\]/g;
+const normalizeRegExp = /(?:[\^`\xA8\xAF\xB4\xB7\xB8\u02B0-\u034E\u0350-\u0357\u035D-\u0362\u0374\u0375\u037A\u0384\u0385\u0483-\u0487\u0559\u0591-\u05A1\u05A3-\u05BD\u05BF\u05C1\u05C2\u05C4\u064B-\u0652\u0657\u0658\u06DF\u06E0\u06E5\u06E6\u06EA-\u06EC\u0730-\u074A\u07A6-\u07B0\u07EB-\u07F5\u0818\u0819\u0898-\u089F\u08C9-\u08D2\u08E3-\u08FE\u093C\u094D\u0951-\u0954\u0971\u09BC\u09CD\u0A3C\u0A4D\u0ABC\u0ACD\u0AFD-\u0AFF\u0B3C\u0B4D\u0B55\u0BCD\u0C3C\u0C4D\u0CBC\u0CCD\u0D3B\u0D3C\u0D4D\u0DCA\u0E3A\u0E47-\u0E4C\u0E4E\u0EBA\u0EC8-\u0ECC\u0F18\u0F19\u0F35\u0F37\u0F39\u0F3E\u0F3F\u0F82-\u0F84\u0F86\u0F87\u0FC6\u1037\u1039\u103A\u1063\u1064\u1069-\u106D\u1087-\u108D\u108F\u109A\u109B\u135D-\u135F\u1714\u1715\u1734\u17C9-\u17D3\u17DD\u1939-\u193B\u1A60\u1A75-\u1A7C\u1A7F\u1AB0-\u1ABE\u1AC1-\u1ACB\u1B34\u1B44\u1B6B-\u1B73\u1BAA\u1BAB\u1BE6\u1BF2\u1BF3\u1C36\u1C37\u1C78-\u1C7D\u1CD0-\u1CE8\u1CED\u1CF4\u1CF7-\u1CF9\u1D2C-\u1D6A\u1DC4-\u1DCF\u1DF5-\u1DFF\u1FBD\u1FBF-\u1FC1\u1FCD-\u1FCF\u1FDD-\u1FDF\u1FED-\u1FEF\u1FFD\u1FFE\u2CEF-\u2CF1\u2E2F\u302A-\u302F\u3099-\u309C\u30FC\uA66F\uA67C\uA67D\uA67F\uA69C\uA69D\uA6F0\uA6F1\uA700-\uA721\uA788-\uA78A\uA7F8\uA7F9\uA806\uA82C\uA8C4\uA8E0-\uA8F1\uA92B-\uA92E\uA953\uA9B3\uA9C0\uA9E5\uAA7B-\uAA7D\uAABF-\uAAC2\uAAF6\uAB5B-\uAB5F\uAB69-\uAB6B\uABEC\uABED\uFB1E\uFE20-\uFE2F\uFF3E\uFF40\uFF70\uFF9E\uFF9F\uFFE3]|\uD800\uDEE0|\uD801[\uDF80-\uDF85\uDF87-\uDFB0\uDFB2-\uDFBA]|\uD802[\uDE38-\uDE3A\uDE3F\uDEE5\uDEE6]|\uD803[\uDD22-\uDD27\uDD4E\uDD69-\uDD6D\uDEFD-\uDEFF\uDF46-\uDF50\uDF82-\uDF85]|\uD804[\uDC46\uDC70\uDCB9\uDCBA\uDD33\uDD34\uDD73\uDDC0\uDDCA-\uDDCC\uDE35\uDE36\uDEE9\uDEEA\uDF3B\uDF3C\uDF4D\uDF66-\uDF6C\uDF70-\uDF74\uDFCE-\uDFD0\uDFD2\uDFD3\uDFE1\uDFE2]|\uD805[\uDC42\uDC46\uDCC2\uDCC3\uDDBF\uDDC0\uDE3F\uDEB6\uDEB7\uDF2B]|\uD806[\uDC39\uDC3A\uDD3D\uDD3E\uDD43\uDDE0\uDE34\uDE47\uDE99]|\uD807[\uDC3F\uDD42\uDD44\uDD45\uDD97\uDF41\uDF42\uDF5A]|\uD80D[\uDC47-\uDC55]|\uD818\uDD2F|\uD81A[\uDEF0-\uDEF4\uDF30-\uDF36]|\uD81B[\uDD6B\uDD6C\uDF8F-\uDF9F\uDFF0\uDFF1]|\uD82B[\uDFF0-\uDFF3\uDFF5-\uDFFB\uDFFD\uDFFE]|\uD833[\uDF00-\uDF2D\uDF30-\uDF46]|\uD834[\uDD67-\uDD69\uDD6D-\uDD72\uDD7B-\uDD82\uDD85-\uDD8B\uDDAA-\uDDAD]|\uD838[\uDC30-\uDC6D\uDD30-\uDD36\uDEAE\uDEEC-\uDEEF]|\uD839[\uDDEE\uDDEF]|\uD83A[\uDCD0-\uDCD6\uDD44-\uDD46\uDD48-\uDD4A])/g;
+function escapeRegExp(value) {
+  return value.replace(specialCharRegExp, '\\$&');
+}
+function normalize(data, params) {
+  let normalizedData = String(data);
+  if (!params.keepSpecialCharacters) normalizedData = normalizedData.normalize('NFD').replace(normalizeRegExp, '');
+  return normalizedData;
+}
 
-// deck.gl
-const rasterSource = async function rasterSource(options) {
-  const {
-    tableName,
-    filters
-  } = options;
-  const urlParameters = {
-    name: tableName
+const LOGICAL_OPERATOR_METHODS = {
+  and: 'every',
+  or: 'some'
+};
+function passesFilter(columns, filters, feature, filtersLogicalOperator) {
+  const method = LOGICAL_OPERATOR_METHODS[filtersLogicalOperator];
+  return columns[method](column => {
+    const columnFilters = filters[column];
+    const columnFilterTypes = Object.keys(columnFilters);
+    if (!feature || feature[column] === null || feature[column] === undefined) {
+      return false;
+    }
+    return columnFilterTypes.every(filter => {
+      const filterFunction = filterFunctions[filter];
+      if (!filterFunction) {
+        throw new Error(`"${filter}" filter is not implemented.`);
+      }
+      return filterFunction(columnFilters[filter].values, feature[column], columnFilters[filter].params);
+    });
+  });
+}
+function buildFeatureFilter({
+  filters = {},
+  type = 'boolean',
+  filtersLogicalOperator = 'and'
+}) {
+  const columns = Object.keys(filters);
+  if (!columns.length) {
+    return () => type === 'number' ? 1 : true;
+  }
+  return feature => {
+    const f = feature.properties || feature;
+    const featurePassesFilter = passesFilter(columns, filters, f, filtersLogicalOperator);
+    return type === 'number' ? Number(featurePassesFilter) : featurePassesFilter;
   };
-  if (filters) {
-    urlParameters.filters = filters;
+}
+// Apply certain filters to a collection of features
+function applyFilters(features, filters, filtersLogicalOperator) {
+  return Object.keys(filters).length ? features.filter(buildFeatureFilter({
+    filters,
+    filtersLogicalOperator
+  })) : features;
+}
+// Binary
+function buildBinaryFeatureFilter({
+  filters = {}
+}) {
+  const columns = Object.keys(filters);
+  if (!columns.length) {
+    return () => 1;
   }
-  return baseSource('raster', options, urlParameters);
+  return (featureIdIdx, binaryData) => passesFilterUsingBinary(columns, filters, featureIdIdx, binaryData);
+}
+function getValueFromNumericProps(featureIdIdx, binaryData, {
+  column
+}) {
+  var _binaryData$numericPr;
+  return (_binaryData$numericPr = binaryData.numericProps) == null || (_binaryData$numericPr = _binaryData$numericPr[column]) == null ? void 0 : _binaryData$numericPr.value[featureIdIdx];
+}
+function getValueFromProperties(featureIdIdx, binaryData, {
+  column
+}) {
+  var _binaryData$propertie;
+  const propertyIdx = binaryData.featureIds.value[featureIdIdx];
+  return (_binaryData$propertie = binaryData.properties[propertyIdx]) == null ? void 0 : _binaryData$propertie[column];
+}
+const GET_VALUE_BY_BINARY_PROP = {
+  properties: getValueFromProperties,
+  numericProps: getValueFromNumericProps
 };
-
-const quadbinQuerySource = async function quadbinQuerySource(options) {
+function getBinaryPropertyByFilterValues(filterValues) {
+  return typeof filterValues.flat()[0] === 'string' ? 'properties' : 'numericProps';
+}
+function getFeatureValue(featureIdIdx, binaryData, filter) {
   const {
-    aggregationExp,
-    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
-    sqlQuery,
-    spatialDataColumn = 'quadbin',
-    queryParameters,
-    filters
-  } = options;
-  const urlParameters = {
-    aggregationExp,
-    q: sqlQuery,
-    spatialDataColumn,
-    spatialDataType: 'quadbin'
-  };
-  if (aggregationResLevel) {
-    urlParameters.aggregationResLevel = String(aggregationResLevel);
+    column,
+    values
+  } = filter;
+  const binaryProp = getBinaryPropertyByFilterValues(values);
+  const getFeatureValueFn = GET_VALUE_BY_BINARY_PROP[binaryProp];
+  return getFeatureValueFn(featureIdIdx, binaryData, {
+    column
+  });
+}
+function passesFilterUsingBinary(columns, filters, featureIdIdx, binaryData) {
+  return columns.every(column => {
+    const columnFilters = filters[column];
+    return Object.entries(columnFilters).every(([type, {
+      values
+    }]) => {
+      const filterFn = filterFunctions[type];
+      if (!filterFn) {
+        throw new Error(`"${type}" filter is not implemented.`);
+      }
+      if (!values) return 0;
+      const featureValue = getFeatureValue(featureIdIdx, binaryData, {
+        type: type,
+        column,
+        values
+      });
+      if (featureValue === undefined || featureValue === null) return 0;
+      return filterFn(values, featureValue);
+    });
+  });
+}
+
+function geojsonFeatures({
+  geojson,
+  spatialFilter,
+  uniqueIdProperty
+}) {
+  let uniqueIdx = 0;
+  const map = new Map();
+  if (!spatialFilter) {
+    return [];
   }
-  if (queryParameters) {
-    urlParameters.queryParameters = queryParameters;
+  for (const feature of geojson.features) {
+    const uniqueId = uniqueIdProperty ? feature.properties[uniqueIdProperty] : ++uniqueIdx;
+    if (!map.has(uniqueId) && intersects(spatialFilter, feature)) {
+      map.set(uniqueId, feature.properties);
+    }
   }
-  if (filters) {
-    urlParameters.filters = filters;
+  return Array.from(map.values());
+}
+
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const DEFAULT_CONFIG = {
+  EPSILON: 1e-12,
+  debug: false,
+  precision: 4,
+  printTypes: false,
+  printDegrees: false,
+  printRowMajor: true,
+  _cartographicRadians: false
+};
+// Configuration is truly global as of v3.6 to ensure single config even if multiple copies of math.gl
+// Multiple copies of config can be quite tricky to debug...
+globalThis.mathgl = globalThis.mathgl || {
+  config: {
+    ...DEFAULT_CONFIG
   }
-  return baseSource('query', options, urlParameters).then(result => _extends({}, result, {
-    widgetSource: new WidgetQuerySource(options)
-  }));
 };
-
-const quadbinTableSource = async function quadbinTableSource(options) {
-  const {
-    aggregationExp,
-    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
-    spatialDataColumn = 'quadbin',
-    tableName,
-    filters
-  } = options;
-  const urlParameters = {
-    aggregationExp,
-    name: tableName,
-    spatialDataColumn,
-    spatialDataType: 'quadbin'
-  };
-  if (aggregationResLevel) {
-    urlParameters.aggregationResLevel = String(aggregationResLevel);
+/**
+ * Check if value is an "array"
+ * Returns `true` if value is either an array or a typed array
+ * Note: returns `false` for `ArrayBuffer` and `DataView` instances
+ * @note isTypedArray and isNumericArray are often more useful in TypeScript
+ */
+function isArray(value) {
+  return Array.isArray(value) || ArrayBuffer.isView(value) && !(value instanceof DataView);
+}
+function lerp(a, b, t) {
+  if (isArray(a)) {
+    return a.map((ai, i) => lerp(ai, b[i], t));
   }
-  if (filters) {
-    urlParameters.filters = filters;
+  return t * b + (1 - t) * a;
+}
+
+// Replacement for the external assert method to reduce bundle size
+// Note: We don't use the second "message" argument in calling code,
+// so no need to support it here
+function assert(condition, message) {
+  if (!condition) {
+    throw new Error(message || '@math.gl/web-mercator: assertion failed.');
   }
-  return baseSource('table', options, urlParameters).then(result => _extends({}, result, {
-    widgetSource: new WidgetTableSource(options)
-  }));
-};
+}
 
-// deck.gl
-const quadbinTilesetSource = async function quadbinTilesetSource(options) {
-  const {
-    tableName
-  } = options;
-  const urlParameters = {
-    name: tableName
-  };
-  return baseSource('tileset', options, urlParameters);
-};
+// TODO - THE UTILITIES IN THIS FILE SHOULD BE IMPORTED FROM WEB-MERCATOR-VIEWPORT MODULE
+// CONSTANTS
+const PI = Math.PI;
+const PI_4 = PI / 4;
+const DEGREES_TO_RADIANS = PI / 180;
+const RADIANS_TO_DEGREES = 180 / PI;
+const TILE_SIZE = 512;
+/**
+ * Project [lng,lat] on sphere onto [x,y] on 512*512 Mercator Zoom 0 tile.
+ * Performs the nonlinear part of the web mercator projection.
+ * Remaining projection is done with 4x4 matrices which also handles
+ * perspective.
+ *
+ * @param lngLat - [lng, lat] coordinates
+ *   Specifies a point on the sphere to project onto the map.
+ * @return [x,y] coordinates.
+ */
+function lngLatToWorld(lngLat) {
+  const [lng, lat] = lngLat;
+  assert(Number.isFinite(lng));
+  assert(Number.isFinite(lat) && lat >= -90 && lat <= 90, 'invalid latitude');
+  const lambda2 = lng * DEGREES_TO_RADIANS;
+  const phi2 = lat * DEGREES_TO_RADIANS;
+  const x = TILE_SIZE * (lambda2 + PI) / (2 * PI);
+  const y = TILE_SIZE * (PI + Math.log(Math.tan(PI_4 + phi2 * 0.5))) / (2 * PI);
+  return [x, y];
+}
+/**
+ * Unproject world point [x,y] on map onto {lat, lon} on sphere
+ *
+ * @param xy - array with [x,y] members
+ *  representing point on projected map plane
+ * @return - array with [x,y] of point on sphere.
+ *   Has toArray method if you need a GeoJSON Array.
+ *   Per cartographic tradition, lat and lon are specified as degrees.
+ */
+function worldToLngLat(xy) {
+  const [x, y] = xy;
+  const lambda2 = x / TILE_SIZE * (2 * PI) - PI;
+  const phi2 = 2 * (Math.atan(Math.exp(y / TILE_SIZE * (2 * PI) - PI)) - PI_4);
+  return [lambda2 * RADIANS_TO_DEGREES, phi2 * RADIANS_TO_DEGREES];
+}
 
-const vectorQuerySource = async function vectorQuerySource(options) {
-  const {
-    columns,
-    filters,
-    spatialDataColumn = 'geom',
+const TRANSFORM_FN$1 = {
+  Point: transformPoint$1,
+  MultiPoint: transformMultiPoint$1,
+  LineString: transformLineString$1,
+  MultiLineString: transformMultiLineString$1,
+  Polygon: transformPolygon$1,
+  MultiPolygon: transformMultiPolygon$1
+};
+/**
+ * Transform WGS84 coordinates to tile coords.
+ * It's the inverse of deck.gl coordinate-transform (https://github.com/visgl/deck.gl/blob/master/modules/geo-layers/src/mvt-layer/coordinate-transform.js)
+ *
+ * @param geometry - any valid geojson geometry
+ * @param bbox - geojson bbox
+ */
+function transformToTileCoords(geometry, bbox) {
+  const [west, south, east, north] = bbox;
+  const nw = projectFlat([west, north]);
+  const se = projectFlat([east, south]);
+  const projectedBbox = [nw, se];
+  if (geometry.type === 'GeometryCollection') {
+    throw new Error('Unsupported geometry type GeometryCollection');
+  }
+  const transformFn = TRANSFORM_FN$1[geometry.type];
+  const coordinates = transformFn(geometry.coordinates, projectedBbox);
+  return _extends({}, geometry, {
+    coordinates
+  });
+}
+function transformPoint$1([pointX, pointY], [nw, se]) {
+  const x = inverseLerp(nw[0], se[0], pointX);
+  const y = inverseLerp(nw[1], se[1], pointY);
+  return [x, y];
+}
+function getPoints$1(geometry, bbox) {
+  return geometry.map(g => transformPoint$1(projectFlat(g), bbox));
+}
+function transformMultiPoint$1(multiPoint, bbox) {
+  return getPoints$1(multiPoint, bbox);
+}
+function transformLineString$1(line, bbox) {
+  return getPoints$1(line, bbox);
+}
+function transformMultiLineString$1(multiLineString, bbox) {
+  return multiLineString.map(lineString => transformLineString$1(lineString, bbox));
+}
+function transformPolygon$1(polygon, bbox) {
+  return polygon.map(polygonRing => getPoints$1(polygonRing, bbox));
+}
+function transformMultiPolygon$1(multiPolygon, bbox) {
+  return multiPolygon.map(polygon => transformPolygon$1(polygon, bbox));
+}
+function projectFlat(xyz) {
+  return lngLatToWorld(xyz);
+}
+function inverseLerp(a, b, x) {
+  return (x - a) / (b - a);
+}
+
+const TRANSFORM_FN = {
+  Point: transformPoint,
+  MultiPoint: transformMultiPoint,
+  LineString: transformLineString,
+  MultiLineString: transformMultiLineString,
+  Polygon: transformPolygon,
+  MultiPolygon: transformMultiPolygon
+};
+/**
+ * Transform tile coords to WGS84 coordinates.
+ *
+ * @param geometry - any valid geojson geometry
+ * @param bbox - geojson bbox
+ */
+function transformTileCoordsToWGS84(geometry, bbox) {
+  const [west, south, east, north] = bbox;
+  const nw = lngLatToWorld([west, north]);
+  const se = lngLatToWorld([east, south]);
+  const projectedBbox = [nw, se];
+  if (geometry.type === 'GeometryCollection') {
+    throw new Error('Unsupported geometry type GeometryCollection');
+  }
+  const transformFn = TRANSFORM_FN[geometry.type];
+  const coordinates = transformFn(geometry.coordinates, projectedBbox);
+  return _extends({}, geometry, {
+    coordinates
+  });
+}
+function transformPoint([pointX, pointY], [nw, se]) {
+  const x = lerp(nw[0], se[0], pointX);
+  const y = lerp(nw[1], se[1], pointY);
+  return worldToLngLat([x, y]);
+}
+function getPoints(geometry, bbox) {
+  return geometry.map(g => transformPoint(g, bbox));
+}
+function transformMultiPoint(multiPoint, bbox) {
+  return getPoints(multiPoint, bbox);
+}
+function transformLineString(line, bbox) {
+  return getPoints(line, bbox);
+}
+function transformMultiLineString(multiLineString, bbox) {
+  return multiLineString.map(lineString => transformLineString(lineString, bbox));
+}
+function transformPolygon(polygon, bbox) {
+  return polygon.map(polygonRing => getPoints(polygonRing, bbox));
+}
+function transformMultiPolygon(multiPolygon, bbox) {
+  return multiPolygon.map(polygon => transformPolygon(polygon, bbox));
+}
+
+const FEATURE_GEOM_PROPERTY = '__geomValue';
+function tileFeaturesGeometries({
+  tiles,
+  tileFormat,
+  spatialFilter,
+  uniqueIdProperty,
+  options
+}) {
+  const map = new Map();
+  for (const tile of tiles) {
+    // Discard if it's not a visible tile (only check false value, not undefined)
+    // or tile has not data
+    if (tile.isVisible === false || !tile.data) {
+      continue;
+    }
+    const bbox = [tile.bbox.west, tile.bbox.south, tile.bbox.east, tile.bbox.north];
+    const bboxToGeom = bboxPolygon(bbox);
+    const tileIsFullyVisible = booleanWithin(bboxToGeom, spatialFilter);
+    // Clip the geometry to intersect with the tile
+    const spatialFilterFeature = {
+      type: 'Feature',
+      geometry: spatialFilter,
+      properties: {}
+    };
+    const clippedGeometryToIntersect = intersect(featureCollection([bboxToGeom, spatialFilterFeature]));
+    if (!clippedGeometryToIntersect) {
+      continue;
+    }
+    // We assume that MVT tileFormat uses local coordinates so we transform the geometry to intersect to tile coordinates [0..1],
+    // while in the case of 'geojson' or binary, the geometries are already in WGS84
+    const transformedGeometryToIntersect = tileFormat === TileFormat.MVT ? transformToTileCoords(clippedGeometryToIntersect.geometry, bbox) : clippedGeometryToIntersect.geometry;
+    createIndicesForPoints(tile.data.points);
+    calculateFeatures({
+      map,
+      tileIsFullyVisible,
+      geometryIntersection: transformedGeometryToIntersect,
+      data: tile.data.points,
+      type: 'Point',
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      options
+    });
+    calculateFeatures({
+      map,
+      tileIsFullyVisible,
+      geometryIntersection: transformedGeometryToIntersect,
+      data: tile.data.lines,
+      type: 'LineString',
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      options
+    });
+    calculateFeatures({
+      map,
+      tileIsFullyVisible,
+      geometryIntersection: transformedGeometryToIntersect,
+      data: tile.data.polygons,
+      type: 'Polygon',
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      options
+    });
+  }
+  return Array.from(map.values());
+}
+function processTileFeatureProperties({
+  map,
+  data,
+  startIndex,
+  endIndex,
+  type,
+  bbox,
+  tileFormat,
+  uniqueIdProperty,
+  storeGeometry,
+  geometryIntersection
+}) {
+  const tileProps = getPropertiesFromTile(data, startIndex);
+  const uniquePropertyValue = getUniquePropertyValue(tileProps, uniqueIdProperty, map);
+  if (!uniquePropertyValue || map.has(uniquePropertyValue)) {
+    return;
+  }
+  let geometry = null;
+  // Only calculate geometry if necessary
+  if (storeGeometry || geometryIntersection) {
+    const {
+      positions
+    } = data;
+    const ringCoordinates = getRingCoordinatesFor(startIndex, endIndex, positions);
+    geometry = getFeatureByType(ringCoordinates, type);
+  }
+  // If intersection is required, check before proceeding
+  if (geometry && geometryIntersection && !intersects(geometry, geometryIntersection)) {
+    return;
+  }
+  const properties = parseProperties(tileProps);
+  // Only save geometry if necessary
+  if (storeGeometry && geometry) {
+    properties[FEATURE_GEOM_PROPERTY] = tileFormat === TileFormat.MVT ? transformTileCoordsToWGS84(geometry, bbox) : geometry;
+  }
+  map.set(uniquePropertyValue, properties);
+}
+function addIntersectedFeaturesInTile({
+  map,
+  data,
+  geometryIntersection,
+  type,
+  bbox,
+  tileFormat,
+  uniqueIdProperty,
+  options
+}) {
+  const indices = getIndices(data);
+  const storeGeometry = (options == null ? void 0 : options.storeGeometry) || false;
+  for (let i = 0; i < indices.length - 1; i++) {
+    const startIndex = indices[i];
+    const endIndex = indices[i + 1];
+    processTileFeatureProperties({
+      map,
+      data,
+      startIndex,
+      endIndex,
+      type,
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      storeGeometry,
+      geometryIntersection
+    });
+  }
+}
+function getIndices(data) {
+  let indices;
+  switch (data.type) {
+    case 'Point':
+      // @ts-expect-error Missing or changed types?
+      indices = data.pointIndices;
+      break;
+    case 'LineString':
+      indices = data.pathIndices;
+      break;
+    case 'Polygon':
+      indices = data.primitivePolygonIndices;
+      break;
+    default:
+      throw new Error(`Unexpected type, "${data.type}"`);
+  }
+  return indices.value;
+}
+function getFeatureId(data, startIndex) {
+  return data.featureIds.value[startIndex];
+}
+function getPropertiesFromTile(data, startIndex) {
+  var _fields$featureId;
+  const featureId = getFeatureId(data, startIndex);
+  const {
+    properties,
+    numericProps,
+    fields
+  } = data;
+  const result = {
+    uniqueId: fields == null || (_fields$featureId = fields[featureId]) == null ? void 0 : _fields$featureId.id,
+    properties: properties[featureId],
+    numericProps: {}
+  };
+  for (const key in numericProps) {
+    result.numericProps[key] = numericProps[key].value[startIndex];
+  }
+  return result;
+}
+function parseProperties(tileProps) {
+  const {
+    properties,
+    numericProps
+  } = tileProps;
+  return Object.assign({}, properties, numericProps);
+}
+function getUniquePropertyValue(tileProps, uniqueIdProperty, map) {
+  if (uniqueIdProperty) {
+    return getValueFromTileProps(tileProps, uniqueIdProperty);
+  }
+  if (tileProps.uniqueId) {
+    return tileProps.uniqueId;
+  }
+  const artificialId = map.size + 1; // a counter, assumed as a valid new id
+  return getValueFromTileProps(tileProps, 'cartodb_id') || getValueFromTileProps(tileProps, 'geoid') || artificialId;
+}
+function getValueFromTileProps(tileProps, propertyName) {
+  const {
+    properties,
+    numericProps
+  } = tileProps;
+  return numericProps[propertyName] || properties[propertyName];
+}
+function getFeatureByType(coordinates, type) {
+  switch (type) {
+    case 'Polygon':
+      return {
+        type: 'Polygon',
+        coordinates: [coordinates]
+      };
+    case 'LineString':
+      return {
+        type: 'LineString',
+        coordinates
+      };
+    case 'Point':
+      return {
+        type: 'Point',
+        coordinates: coordinates[0]
+      };
+    default:
+      throw new Error('Invalid geometry type');
+  }
+}
+function getRingCoordinatesFor(startIndex, endIndex, positions) {
+  const ringCoordinates = [];
+  for (let j = startIndex; j < endIndex; j++) {
+    ringCoordinates.push(Array.from(positions.value.subarray(j * positions.size, (j + 1) * positions.size)));
+  }
+  return ringCoordinates;
+}
+function calculateFeatures({
+  map,
+  tileIsFullyVisible,
+  geometryIntersection,
+  data,
+  type,
+  bbox,
+  tileFormat,
+  uniqueIdProperty,
+  options
+}) {
+  if (!(data != null && data.properties.length)) {
+    return;
+  }
+  if (tileIsFullyVisible) {
+    addAllFeaturesInTile({
+      map,
+      data,
+      type,
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      options
+    });
+  } else {
+    addIntersectedFeaturesInTile({
+      map,
+      data,
+      geometryIntersection,
+      type,
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      options
+    });
+  }
+}
+function addAllFeaturesInTile({
+  map,
+  data,
+  type,
+  bbox,
+  tileFormat,
+  uniqueIdProperty,
+  options
+}) {
+  const indices = getIndices(data);
+  const storeGeometry = (options == null ? void 0 : options.storeGeometry) || false;
+  for (let i = 0; i < indices.length - 1; i++) {
+    const startIndex = indices[i];
+    const endIndex = indices[i + 1];
+    processTileFeatureProperties({
+      map,
+      data,
+      startIndex,
+      endIndex,
+      type,
+      bbox,
+      tileFormat,
+      uniqueIdProperty,
+      storeGeometry
+    });
+  }
+}
+function createIndicesForPoints(data) {
+  const featureIds = data.featureIds.value;
+  const lastFeatureId = featureIds[featureIds.length - 1];
+  const PointIndicesArray = featureIds.constructor;
+  const pointIndices = {
+    value: new PointIndicesArray(featureIds.length + 1),
+    size: 1
+  };
+  pointIndices.value.set(featureIds);
+  pointIndices.value.set([lastFeatureId + 1], featureIds.length);
+  // @ts-expect-error Missing or changed types?
+  data.pointIndices = pointIndices;
+}
+
+// a tile is an array [x,y,z]
+var d2r = Math.PI / 180,
+  r2d = 180 / Math.PI;
+function tileToBBOX(tile) {
+  var e = tile2lon(tile[0] + 1, tile[2]);
+  var w = tile2lon(tile[0], tile[2]);
+  var s = tile2lat(tile[1] + 1, tile[2]);
+  var n = tile2lat(tile[1], tile[2]);
+  return [w, s, e, n];
+}
+function tileToGeoJSON(tile) {
+  var bbox = tileToBBOX(tile);
+  var poly = {
+    type: 'Polygon',
+    coordinates: [[[bbox[0], bbox[1]], [bbox[0], bbox[3]], [bbox[2], bbox[3]], [bbox[2], bbox[1]], [bbox[0], bbox[1]]]]
+  };
+  return poly;
+}
+function tile2lon(x, z) {
+  return x / Math.pow(2, z) * 360 - 180;
+}
+function tile2lat(y, z) {
+  var n = Math.PI - 2 * Math.PI * y / Math.pow(2, z);
+  return r2d * Math.atan(0.5 * (Math.exp(n) - Math.exp(-n)));
+}
+function pointToTile(lon, lat, z) {
+  var tile = pointToTileFraction(lon, lat, z);
+  tile[0] = Math.floor(tile[0]);
+  tile[1] = Math.floor(tile[1]);
+  return tile;
+}
+function getChildren(tile) {
+  return [[tile[0] * 2, tile[1] * 2, tile[2] + 1], [tile[0] * 2 + 1, tile[1] * 2, tile[2] + 1], [tile[0] * 2 + 1, tile[1] * 2 + 1, tile[2] + 1], [tile[0] * 2, tile[1] * 2 + 1, tile[2] + 1]];
+}
+function getParent(tile) {
+  // top left
+  if (tile[0] % 2 === 0 && tile[1] % 2 === 0) {
+    return [tile[0] / 2, tile[1] / 2, tile[2] - 1];
+  }
+  // bottom left
+  else if (tile[0] % 2 === 0 && !tile[1] % 2 === 0) {
+    return [tile[0] / 2, (tile[1] - 1) / 2, tile[2] - 1];
+  }
+  // top right
+  else if (!tile[0] % 2 === 0 && tile[1] % 2 === 0) {
+    return [(tile[0] - 1) / 2, tile[1] / 2, tile[2] - 1];
+  }
+  // bottom right
+  else {
+    return [(tile[0] - 1) / 2, (tile[1] - 1) / 2, tile[2] - 1];
+  }
+}
+function getSiblings(tile) {
+  return getChildren(getParent(tile));
+}
+function hasSiblings(tile, tiles) {
+  var siblings = getSiblings(tile);
+  for (var i = 0; i < siblings.length; i++) {
+    if (!hasTile(tiles, siblings[i])) return false;
+  }
+  return true;
+}
+function hasTile(tiles, tile) {
+  for (var i = 0; i < tiles.length; i++) {
+    if (tilesEqual(tiles[i], tile)) return true;
+  }
+  return false;
+}
+function tilesEqual(tile1, tile2) {
+  return tile1[0] === tile2[0] && tile1[1] === tile2[1] && tile1[2] === tile2[2];
+}
+function tileToQuadkey(tile) {
+  var index = '';
+  for (var z = tile[2]; z > 0; z--) {
+    var b = 0;
+    var mask = 1 << z - 1;
+    if ((tile[0] & mask) !== 0) b++;
+    if ((tile[1] & mask) !== 0) b += 2;
+    index += b.toString();
+  }
+  return index;
+}
+function quadkeyToTile(quadkey) {
+  var x = 0;
+  var y = 0;
+  var z = quadkey.length;
+  for (var i = z; i > 0; i--) {
+    var mask = 1 << i - 1;
+    switch (quadkey[z - i]) {
+      case '0':
+        break;
+      case '1':
+        x |= mask;
+        break;
+      case '2':
+        y |= mask;
+        break;
+      case '3':
+        x |= mask;
+        y |= mask;
+        break;
+    }
+  }
+  return [x, y, z];
+}
+function bboxToTile(bboxCoords) {
+  var min = pointToTile(bboxCoords[0], bboxCoords[1], 32);
+  var max = pointToTile(bboxCoords[2], bboxCoords[3], 32);
+  var bbox = [min[0], min[1], max[0], max[1]];
+  var z = getBboxZoom(bbox);
+  if (z === 0) return [0, 0, 0];
+  var x = bbox[0] >>> 32 - z;
+  var y = bbox[1] >>> 32 - z;
+  return [x, y, z];
+}
+function getBboxZoom(bbox) {
+  var MAX_ZOOM = 28;
+  for (var z = 0; z < MAX_ZOOM; z++) {
+    var mask = 1 << 32 - (z + 1);
+    if ((bbox[0] & mask) != (bbox[2] & mask) || (bbox[1] & mask) != (bbox[3] & mask)) {
+      return z;
+    }
+  }
+  return MAX_ZOOM;
+}
+function pointToTileFraction(lon, lat, z) {
+  var sin = Math.sin(lat * d2r),
+    z2 = Math.pow(2, z),
+    x = z2 * (lon / 360 + 0.5),
+    y = z2 * (0.5 - 0.25 * Math.log((1 + sin) / (1 - sin)) / Math.PI);
+  return [x, y, z];
+}
+var tilebelt = {
+  tileToGeoJSON: tileToGeoJSON,
+  tileToBBOX: tileToBBOX,
+  getChildren: getChildren,
+  getParent: getParent,
+  getSiblings: getSiblings,
+  hasTile: hasTile,
+  hasSiblings: hasSiblings,
+  tilesEqual: tilesEqual,
+  tileToQuadkey: tileToQuadkey,
+  quadkeyToTile: quadkeyToTile,
+  pointToTile: pointToTile,
+  bboxToTile: bboxToTile,
+  pointToTileFraction: pointToTileFraction
+};
+
+/**
+ * Given a geometry, create cells and return them in their raw form,
+ * as an array of cell identifiers.
+ *
+ * @alias tiles
+ * @param {Object} geom GeoJSON geometry
+ * @param {Object} limits an object with min_zoom and max_zoom properties
+ * specifying the minimum and maximum level to be tiled.
+ * @returns {Array<Array<number>>} An array of tiles given as [x, y, z] arrays
+ */
+var tiles = getTiles;
+function getTiles(geom, limits) {
+  var i,
+    tile,
+    coords = geom.coordinates,
+    maxZoom = limits.max_zoom,
+    tileHash = {},
+    tiles = [];
+  if (geom.type === 'Point') {
+    return [tilebelt.pointToTile(coords[0], coords[1], maxZoom)];
+  } else if (geom.type === 'MultiPoint') {
+    for (i = 0; i < coords.length; i++) {
+      tile = tilebelt.pointToTile(coords[i][0], coords[i][1], maxZoom);
+      tileHash[toID(tile[0], tile[1], tile[2])] = true;
+    }
+  } else if (geom.type === 'LineString') {
+    lineCover(tileHash, coords, maxZoom);
+  } else if (geom.type === 'MultiLineString') {
+    for (i = 0; i < coords.length; i++) {
+      lineCover(tileHash, coords[i], maxZoom);
+    }
+  } else if (geom.type === 'Polygon') {
+    polygonCover(tileHash, tiles, coords, maxZoom);
+  } else if (geom.type === 'MultiPolygon') {
+    for (i = 0; i < coords.length; i++) {
+      polygonCover(tileHash, tiles, coords[i], maxZoom);
+    }
+  } else {
+    throw new Error('Geometry type not implemented');
+  }
+  if (limits.min_zoom !== maxZoom) {
+    // sync tile hash and tile array so that both contain the same tiles
+    var len = tiles.length;
+    appendHashTiles(tileHash, tiles);
+    for (i = 0; i < len; i++) {
+      var t = tiles[i];
+      tileHash[toID(t[0], t[1], t[2])] = true;
+    }
+    return mergeTiles(tileHash, tiles, limits);
+  }
+  appendHashTiles(tileHash, tiles);
+  return tiles;
+}
+function mergeTiles(tileHash, tiles, limits) {
+  var mergedTiles = [];
+  for (var z = limits.max_zoom; z > limits.min_zoom; z--) {
+    var parentTileHash = {};
+    var parentTiles = [];
+    for (var i = 0; i < tiles.length; i++) {
+      var t = tiles[i];
+      if (t[0] % 2 === 0 && t[1] % 2 === 0) {
+        var id2 = toID(t[0] + 1, t[1], z),
+          id3 = toID(t[0], t[1] + 1, z),
+          id4 = toID(t[0] + 1, t[1] + 1, z);
+        if (tileHash[id2] && tileHash[id3] && tileHash[id4]) {
+          tileHash[toID(t[0], t[1], t[2])] = false;
+          tileHash[id2] = false;
+          tileHash[id3] = false;
+          tileHash[id4] = false;
+          var parentTile = [t[0] / 2, t[1] / 2, z - 1];
+          if (z - 1 === limits.min_zoom) mergedTiles.push(parentTile);else {
+            parentTileHash[toID(t[0] / 2, t[1] / 2, z - 1)] = true;
+            parentTiles.push(parentTile);
+          }
+        }
+      }
+    }
+    for (i = 0; i < tiles.length; i++) {
+      t = tiles[i];
+      if (tileHash[toID(t[0], t[1], t[2])]) mergedTiles.push(t);
+    }
+    tileHash = parentTileHash;
+    tiles = parentTiles;
+  }
+  return mergedTiles;
+}
+function polygonCover(tileHash, tileArray, geom, zoom) {
+  var intersections = [];
+  for (var i = 0; i < geom.length; i++) {
+    var ring = [];
+    lineCover(tileHash, geom[i], zoom, ring);
+    for (var j = 0, len = ring.length, k = len - 1; j < len; k = j++) {
+      var m = (j + 1) % len;
+      var y = ring[j][1];
+
+      // add interesction if it's not local extremum or duplicate
+      if ((y > ring[k][1] || y > ring[m][1]) && (
+      // not local minimum
+      y < ring[k][1] || y < ring[m][1]) &&
+      // not local maximum
+      y !== ring[m][1]) intersections.push(ring[j]);
+    }
+  }
+  intersections.sort(compareTiles); // sort by y, then x
+
+  for (i = 0; i < intersections.length; i += 2) {
+    // fill tiles between pairs of intersections
+    y = intersections[i][1];
+    for (var x = intersections[i][0] + 1; x < intersections[i + 1][0]; x++) {
+      var id = toID(x, y, zoom);
+      if (!tileHash[id]) {
+        tileArray.push([x, y, zoom]);
+      }
+    }
+  }
+}
+function compareTiles(a, b) {
+  return a[1] - b[1] || a[0] - b[0];
+}
+function lineCover(tileHash, coords, maxZoom, ring) {
+  var prevX, prevY;
+  for (var i = 0; i < coords.length - 1; i++) {
+    var start = tilebelt.pointToTileFraction(coords[i][0], coords[i][1], maxZoom),
+      stop = tilebelt.pointToTileFraction(coords[i + 1][0], coords[i + 1][1], maxZoom),
+      x0 = start[0],
+      y0 = start[1],
+      x1 = stop[0],
+      y1 = stop[1],
+      dx = x1 - x0,
+      dy = y1 - y0;
+    if (dy === 0 && dx === 0) continue;
+    var sx = dx > 0 ? 1 : -1,
+      sy = dy > 0 ? 1 : -1,
+      x = Math.floor(x0),
+      y = Math.floor(y0),
+      tMaxX = dx === 0 ? Infinity : Math.abs(((dx > 0 ? 1 : 0) + x - x0) / dx),
+      tMaxY = dy === 0 ? Infinity : Math.abs(((dy > 0 ? 1 : 0) + y - y0) / dy),
+      tdx = Math.abs(sx / dx),
+      tdy = Math.abs(sy / dy);
+    if (x !== prevX || y !== prevY) {
+      tileHash[toID(x, y, maxZoom)] = true;
+      if (ring && y !== prevY) ring.push([x, y]);
+      prevX = x;
+      prevY = y;
+    }
+    while (tMaxX < 1 || tMaxY < 1) {
+      if (tMaxX < tMaxY) {
+        tMaxX += tdx;
+        x += sx;
+      } else {
+        tMaxY += tdy;
+        y += sy;
+      }
+      tileHash[toID(x, y, maxZoom)] = true;
+      if (ring && y !== prevY) ring.push([x, y]);
+      prevX = x;
+      prevY = y;
+    }
+  }
+  if (ring && y === ring[0][1]) ring.pop();
+}
+function appendHashTiles(hash, tiles) {
+  var keys = Object.keys(hash);
+  for (var i = 0; i < keys.length; i++) {
+    tiles.push(fromID(+keys[i]));
+  }
+}
+function toID(x, y, z) {
+  var dim = 2 * (1 << z);
+  return (dim * y + x) * 32 + z;
+}
+function fromID(id) {
+  var z = id % 32,
+    dim = 2 * (1 << z),
+    xy = (id - z) / 32,
+    x = xy % dim,
+    y = (xy - x) / dim % dim;
+  return [x, y, z];
+}
+
+const B = [0x5555555555555555n, 0x3333333333333333n, 0x0f0f0f0f0f0f0f0fn, 0x00ff00ff00ff00ffn, 0x0000ffff0000ffffn, 0x00000000ffffffffn];
+const S = [0n, 1n, 2n, 4n, 8n, 16n];
+function tileToCell(tile) {
+  if (tile.z < 0 || tile.z > 26) {
+    throw new Error('Wrong zoom');
+  }
+  const z = BigInt(tile.z);
+  let x = BigInt(tile.x) << 32n - z;
+  let y = BigInt(tile.y) << 32n - z;
+  for (let i = 0; i < 5; i++) {
+    const s = S[5 - i];
+    const b = B[4 - i];
+    x = (x | x << s) & b;
+    y = (y | y << s) & b;
+  }
+  const quadbin = 0x4000000000000000n | 1n << 59n |
+  // | (mode << 59) | (mode_dep << 57)
+  z << 52n | (x | y << 1n) >> 12n | 0xfffffffffffffn >> z * 2n;
+  return quadbin;
+}
+function getResolution$1(quadbin) {
+  return quadbin >> 52n & 0x1fn;
+}
+function geometryToCells(geometry, resolution) {
+  const zoom = Number(resolution);
+  return tiles(geometry, {
+    min_zoom: zoom,
+    max_zoom: zoom
+  }).map(([x, y, z]) => tileToCell({
+    x,
+    y,
+    z
+  }));
+}
+
+function tileFeaturesSpatialIndex({
+  tiles,
+  spatialFilter,
+  spatialDataColumn,
+  spatialDataType
+}) {
+  const map = new Map();
+  const spatialIndex = getSpatialIndex(spatialDataType);
+  const resolution = getResolution(tiles, spatialIndex);
+  const spatialIndexIDName = spatialDataColumn ? spatialDataColumn : spatialIndex;
+  if (!resolution) {
+    return [];
+  }
+  const cells = getCellsCoverGeometry(spatialFilter, spatialIndex, resolution);
+  if (!(cells != null && cells.length)) {
+    return [];
+  }
+  // We transform cells to Set to improve the performace
+  const cellsSet = new Set(cells);
+  for (const tile of tiles) {
+    if (tile.isVisible === false || !tile.data) {
+      continue;
+    }
+    tile.data.forEach(d => {
+      if (cellsSet.has(d.id)) {
+        map.set(d.id, _extends({}, d.properties, {
+          [spatialIndexIDName]: d.id
+        }));
+      }
+    });
+  }
+  return Array.from(map.values());
+}
+function getResolution(tiles, spatialIndex) {
+  var _tiles$find;
+  const data = (_tiles$find = tiles.find(tile => {
+    var _tile$data;
+    return (_tile$data = tile.data) == null ? void 0 : _tile$data.length;
+  })) == null ? void 0 : _tiles$find.data;
+  if (!data) {
+    return;
+  }
+  if (spatialIndex === SpatialIndex.QUADBIN) {
+    return Number(getResolution$1(data[0].id));
+  }
+  if (spatialIndex === SpatialIndex.H3) {
+    return getResolution$2(data[0].id);
+  }
+}
+const bboxWest = [-180, -90, 0, 90];
+const bboxEast = [0, -90, 180, 90];
+function getCellsCoverGeometry(geometry, spatialIndex, resolution) {
+  if (spatialIndex === SpatialIndex.QUADBIN) {
+    // @ts-expect-error TODO: Probably ought to be stricter about number vs. bigint types in this file.
+    return geometryToCells(geometry, resolution);
+  }
+  if (spatialIndex === SpatialIndex.H3) {
+    // The current H3 polyfill algorithm can't deal with polygon segments of greater than 180 degrees longitude
+    // so we clip the geometry to be sure that none of them is greater than 180 degrees
+    // https://github.com/uber/h3-js/issues/24#issuecomment-431893796
+    return polygonToCells(bboxClip(geometry, bboxWest).geometry.coordinates, resolution, true).concat(polygonToCells(bboxClip(geometry, bboxEast).geometry.coordinates, resolution, true));
+  }
+}
+function getSpatialIndex(spatialDataType) {
+  switch (spatialDataType) {
+    case 'h3':
+      return SpatialIndex.H3;
+    case 'quadbin':
+      return SpatialIndex.QUADBIN;
+    default:
+      throw new Error('Unexpected spatial data type');
+  }
+}
+
+/** @internalRemarks Source: @carto/react-core */
+function tileFeatures({
+  tiles,
+  spatialFilter,
+  uniqueIdProperty,
+  tileFormat,
+  spatialDataColumn = DEFAULT_GEO_COLUMN,
+  spatialDataType,
+  options = {}
+}) {
+  // TODO(cleanup): Is an empty response the expected result when spatialFilter
+  // is omitted? Why not make the parameter required, or return the full input?
+  if (!spatialFilter) {
+    return [];
+  }
+  if (spatialDataType !== 'geo') {
+    return tileFeaturesSpatialIndex({
+      tiles: tiles,
+      spatialFilter,
+      spatialDataColumn,
+      spatialDataType
+    });
+  }
+  return tileFeaturesGeometries({
+    tiles,
+    tileFormat,
+    spatialFilter,
+    uniqueIdProperty,
+    options
+  });
+}
+
+/** @internalRemarks Source: @carto/react-core */
+const aggregationFunctions = {
+  count: values => values.length,
+  min: (...args) => applyAggregationFunction(min, ...args),
+  max: (...args) => applyAggregationFunction(max, ...args),
+  sum: (...args) => applyAggregationFunction(sum, ...args),
+  avg: (...args) => applyAggregationFunction(avg, ...args)
+};
+/** @internalRemarks Source: @carto/react-core */
+function aggregate(feature, keys, operation) {
+  if (!(keys != null && keys.length)) {
+    throw new Error('Cannot aggregate a feature without having keys');
+  } else if (keys.length === 1) {
+    const value = feature[keys[0]];
+    return isPotentiallyValidNumber(value) ? Number(value) : value;
+  }
+  const aggregationFn = aggregationFunctions[operation];
+  if (!aggregationFn) {
+    throw new Error(`${operation} isn't a valid aggregation function`);
+  }
+  return aggregationFn(keys.map(column => {
+    const value = feature[column];
+    return isPotentiallyValidNumber(value) ? Number(value) : value;
+  }));
+}
+/*
+ * Forced casting to Number (just of non empty strings) allows to work-around
+ * some specific situations, where a big numeric field is transformed into a string when generating the tileset(eg.PG)
+ */
+function isPotentiallyValidNumber(value) {
+  return typeof value === 'string' && value.trim().length > 0;
+}
+const applyAggregationFunction = (aggFn, values, keys, operation) => {
+  const normalizedKeys = normalizeKeys(keys);
+  const elements = ((normalizedKeys == null ? void 0 : normalizedKeys.length) || 0) <= 1 ? filterFalsyElements(values, normalizedKeys || []) : values;
+  return aggFn(elements, keys, operation);
+};
+function filterFalsyElements(values, keys) {
+  const filterFn = value => value !== null && value !== undefined;
+  if (!(keys != null && keys.length)) {
+    return values.filter(filterFn);
+  }
+  return values.filter(v => filterFn(v[keys[0]]));
+}
+// Aggregation functions
+function avg(values, keys, joinOperation) {
+  return sum(values, keys, joinOperation) / (values.length || 1);
+}
+function sum(values, keys, joinOperation) {
+  const normalizedKeys = normalizeKeys(keys);
+  if (normalizedKeys) {
+    return values.reduce((a, b) => a + aggregate(b, normalizedKeys, joinOperation), 0);
+  }
+  return values.reduce((a, b) => a + b, 0);
+}
+function min(values, keys, joinOperation) {
+  const normalizedKeys = normalizeKeys(keys);
+  if (normalizedKeys) {
+    return values.reduce((a, b) => Math.min(a, aggregate(b, normalizedKeys, joinOperation)), Infinity);
+  }
+  return Math.min(...values);
+}
+function max(values, keys, joinOperation) {
+  const normalizedKeys = normalizeKeys(keys);
+  if (normalizedKeys) {
+    return values.reduce((a, b) => Math.max(a, aggregate(b, normalizedKeys, joinOperation)), -Infinity);
+  }
+  return Math.max(...values);
+}
+// Aux
+// Keys can come as a string (one column) or a strings array (multiple column)
+// Use always an array to make the code easier
+function normalizeKeys(keys) {
+  return Array.isArray(keys) ? keys : typeof keys === 'string' ? [keys] : undefined;
+}
+
+/***
+   Copyright 2013 Teun Duynstee
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+*/
+var thenBy_module = function () {
+  function identity(v) {
+    return v;
+  }
+  function ignoreCase(v) {
+    return typeof v === "string" ? v.toLowerCase() : v;
+  }
+  function makeCompareFunction(f, opt) {
+    opt = typeof opt === "object" ? opt : {
+      direction: opt
+    };
+    if (typeof f != "function") {
+      var prop = f;
+      // make unary function
+      f = function (v1) {
+        return !!v1[prop] ? v1[prop] : "";
+      };
+    }
+    if (f.length === 1) {
+      // f is a unary function mapping a single item to its sort score
+      var uf = f;
+      var preprocess = opt.ignoreCase ? ignoreCase : identity;
+      var cmp = opt.cmp || function (v1, v2) {
+        return v1 < v2 ? -1 : v1 > v2 ? 1 : 0;
+      };
+      f = function (v1, v2) {
+        return cmp(preprocess(uf(v1)), preprocess(uf(v2)));
+      };
+    }
+    const descTokens = {
+      "-1": '',
+      desc: ''
+    };
+    if (opt.direction in descTokens) return function (v1, v2) {
+      return -f(v1, v2);
+    };
+    return f;
+  }
+
+  /* adds a secondary compare function to the target function (`this` context)
+     which is applied in case the first one returns 0 (equal)
+     returns a new compare function, which has a `thenBy` method as well */
+  function tb(func, opt) {
+    /* should get value false for the first call. This can be done by calling the 
+    exported function, or the firstBy property on it (for es6 module compatibility)
+    */
+    var x = typeof this == "function" && !this.firstBy ? this : false;
+    var y = makeCompareFunction(func, opt);
+    var f = x ? function (a, b) {
+      return x(a, b) || y(a, b);
+    } : y;
+    f.thenBy = tb;
+    return f;
+  }
+  tb.firstBy = tb;
+  return tb;
+}();
+
+/**
+ * Apply sort structure to a collection of features
+ * @param features
+ * @param [sortOptions]
+ * @param [sortOptions.sortBy] - One or more columns to sort by
+ * @param [sortOptions.sortByDirection] - Direction by the columns will be sorted
+ * @param [sortOptions.sortByColumnType] - Column type
+ * @internal
+ * @internalRemarks Source: @carto/react-core
+ */
+function applySorting(features, {
+  sortBy,
+  sortByDirection = 'asc',
+  sortByColumnType = 'string'
+} = {}) {
+  // If sortBy is undefined, pass all features
+  if (sortBy === undefined) {
+    return features;
+  }
+  // sortOptions exists, but are bad formatted
+  const isValidSortBy = Array.isArray(sortBy) && sortBy.length ||
+  // sortBy can be an array of columns
+  typeof sortBy === 'string'; // or just one column
+  if (!isValidSortBy) {
+    throw new Error('Sorting options are bad formatted');
+  }
+  const sortFn = createSortFn({
+    sortBy,
+    sortByDirection,
+    sortByColumnType: sortByColumnType || 'string'
+  });
+  return features.sort(sortFn);
+}
+// Aux
+function createSortFn({
+  sortBy,
+  sortByDirection,
+  sortByColumnType
+}) {
+  const [firstSortOption, ...othersSortOptions] = normalizeSortByOptions({
+    sortBy,
+    sortByDirection,
+    sortByColumnType
+  });
+  let sortFn = thenBy_module.firstBy(...firstSortOption);
+  for (let sortOptions of othersSortOptions) {
+    sortFn = sortFn.thenBy(...sortOptions);
+  }
+  return sortFn;
+}
+function normalizeSortByOptions({
+  sortBy,
+  sortByDirection,
+  sortByColumnType
+}) {
+  const numberFormat = sortByColumnType === 'number' && {
+    cmp: (a, b) => a - b
+  };
+  if (!Array.isArray(sortBy)) {
+    sortBy = [sortBy];
+  }
+  return sortBy.map(sortByEl => {
+    // sortByEl is 'column'
+    if (typeof sortByEl === 'string') {
+      return [sortByEl, _extends({
+        direction: sortByDirection
+      }, numberFormat)];
+    }
+    if (Array.isArray(sortByEl)) {
+      // sortBy is ['column']
+      if (sortByEl[1] === undefined) {
+        return [sortByEl, _extends({
+          direction: sortByDirection
+        }, numberFormat)];
+      }
+      // sortBy is ['column', { ... }]
+      if (typeof sortByEl[1] === 'object') {
+        const othersSortOptions = numberFormat ? _extends({}, numberFormat, sortByEl[1]) : sortByEl[1];
+        return [sortByEl[0], _extends({
+          direction: sortByDirection
+        }, othersSortOptions)];
+      }
+    }
+    return sortByEl;
+  });
+}
+
+/** @internalRemarks Source: @carto/react-core */
+function groupValuesByColumn({
+  data,
+  valuesColumns,
+  joinOperation,
+  keysColumn,
+  operation
+}) {
+  if (Array.isArray(data) && data.length === 0) {
+    return null;
+  }
+  const groups = data.reduce((accumulator, item) => {
+    const group = item[keysColumn];
+    const values = accumulator.get(group) || [];
+    accumulator.set(group, values);
+    const aggregatedValue = aggregate(item, valuesColumns, joinOperation);
+    const isValid = (operation === 'count' ? true : aggregatedValue !== null) && aggregatedValue !== undefined;
+    if (isValid) {
+      values.push(aggregatedValue);
+      accumulator.set(group, values);
+    }
+    return accumulator;
+  }, new Map()); // We use a map to be able to maintain the type in the key value
+  const targetOperation = aggregationFunctions[operation];
+  if (targetOperation) {
+    return Array.from(groups).map(([name, value]) => ({
+      name,
+      value: targetOperation(value)
+    }));
+  }
+  return [];
+}
+
+/**
+ * Returns midnight (local time) on the Monday preceeding a given date, in
+ * milliseconds since the UNIX epoch.
+ */
+/**
+ * Returns midnight (UTC) on the Monday preceeding a given date, in
+ * milliseconds since the UNIX epoch.
+ */
+function getUTCMonday(date) {
+  const dateCp = new Date(date);
+  const day = dateCp.getUTCDay();
+  const diff = dateCp.getUTCDate() - day + (day ? 1 : -6); // adjust when day is sunday
+  dateCp.setUTCDate(diff);
+  return Date.UTC(dateCp.getUTCFullYear(), dateCp.getUTCMonth(), dateCp.getUTCDate());
+}
+
+const GROUP_KEY_FN_MAPPING = {
+  year: date => Date.UTC(date.getUTCFullYear()),
+  month: date => Date.UTC(date.getUTCFullYear(), date.getUTCMonth()),
+  week: date => getUTCMonday(date),
+  day: date => Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()),
+  hour: date => Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours()),
+  minute: date => Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours(), date.getUTCMinutes()),
+  second: date => Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours(), date.getUTCMinutes(), date.getUTCSeconds())
+};
+/** @internalRemarks Source: @carto/react-core */
+function groupValuesByDateColumn({
+  data,
+  valuesColumns,
+  joinOperation,
+  keysColumn,
+  groupType,
+  operation
+}) {
+  if (Array.isArray(data) && data.length === 0) {
+    return null;
+  }
+  const groupKeyFn = GROUP_KEY_FN_MAPPING[groupType];
+  if (!groupKeyFn) {
+    return null;
+  }
+  const groups = data.reduce((acc, item) => {
+    const value = item[keysColumn];
+    const formattedValue = new Date(value);
+    const groupKey = groupKeyFn(formattedValue);
+    if (!isNaN(groupKey)) {
+      let groupedValues = acc.get(groupKey);
+      if (!groupedValues) {
+        groupedValues = [];
+        acc.set(groupKey, groupedValues);
+      }
+      const aggregatedValue = aggregate(item, valuesColumns, joinOperation);
+      const isValid = aggregatedValue !== null && aggregatedValue !== undefined;
+      if (isValid) {
+        groupedValues.push(aggregatedValue);
+        acc.set(groupKey, groupedValues);
+      }
+    }
+    return acc;
+  }, new Map());
+  const targetOperation = aggregationFunctions[operation];
+  return [...groups.entries()].map(([name, value]) => ({
+    name,
+    value: targetOperation(value)
+  })).sort((a, b) => a.name - b.name);
+}
+
+/**
+ * Histogram computation.
+ * @internalRemarks Source: @carto/react-core
+ */
+function histogram({
+  data,
+  valuesColumns,
+  joinOperation,
+  ticks,
+  operation
+}) {
+  if (Array.isArray(data) && data.length === 0) {
+    return [];
+  }
+  const binsContainer = [Number.MIN_SAFE_INTEGER, ...ticks].map((tick, index, arr) => ({
+    bin: index,
+    start: tick,
+    end: index === arr.length - 1 ? Number.MAX_SAFE_INTEGER : arr[index + 1],
+    values: []
+  }));
+  data.forEach(feature => {
+    const featureValue = aggregate(feature, valuesColumns, joinOperation);
+    const isValid = featureValue !== null && featureValue !== undefined;
+    if (!isValid) {
+      return;
+    }
+    const binContainer = binsContainer.find(bin => bin.start <= featureValue && bin.end > featureValue);
+    if (!binContainer) {
+      return;
+    }
+    binContainer.values.push(featureValue);
+  });
+  const targetOperation = aggregationFunctions[operation];
+  const transformedBins = binsContainer.map(binContainer => binContainer.values);
+  return transformedBins.map(values => values.length ? targetOperation(values) : 0);
+}
+
+/**
+ * Filters invalid features and formats  data.
+ * @internalRemarks Source: @carto/react-core
+ */
+function scatterPlot({
+  data,
+  xAxisColumns,
+  xAxisJoinOperation,
+  yAxisColumns,
+  yAxisJoinOperation
+}) {
+  return data.reduce((acc, feature) => {
+    const xValue = aggregate(feature, xAxisColumns, xAxisJoinOperation);
+    const xIsValid = xValue !== null && xValue !== undefined;
+    const yValue = aggregate(feature, yAxisColumns, yAxisJoinOperation);
+    const yIsValid = yValue !== null && yValue !== undefined;
+    if (xIsValid && yIsValid) {
+      acc.push([xValue, yValue]);
+    }
+    return acc;
+  }, []);
+}
+
+const _excluded = ["filterOwner", "spatialFilter", "abortController"];
+/**
+ * Source for Widget API requests on a data source defined by a tileset.
+ *
+ * Generally not intended to be constructed directly. Instead, call
+ * {@link vectorTilesetSource}, {@link h3TilesetSource}, or {@link quadbinTilesetSource},
+ * which can be shared with map layers. Sources contain a `widgetSource`
+ * property, for use by widget implementations.
+ *
+ * Example:
+ *
+ * ```javascript
+ * import { vectorTilesetSource } from '@carto/api-client';
+ *
+ * const data = vectorTilesetSource({
+ *   accessToken: '••••',
+ *   connectionName: 'carto_dw',
+ *   tableName: 'carto-demo-data.demo_rasters.my_tileset_source'
+ * });
+ *
+ * const { widgetSource } = await data;
+ * ```
+ */
+class WidgetTilesetSource extends WidgetSource {
+  constructor(...args) {
+    super(...args);
+    this._features = [];
+  }
+  getModelSource(owner) {
+    return _extends({}, super._getModelSource(owner), {
+      type: 'tileset',
+      data: this.props.tableName
+    });
+  }
+  /** Loads features as a list of tiles (typically provided by deck.gl). */
+  loadTiles({
+    tiles,
+    spatialFilter,
+    uniqueIdProperty,
+    options
+  }) {
+    this._features = tileFeatures({
+      tiles,
+      options,
+      spatialFilter,
+      uniqueIdProperty,
+      tileFormat: this.props.tileFormat,
+      spatialDataColumn: this.props.spatialDataColumn,
+      spatialDataType: this.props.spatialDataType
+    });
+  }
+  /** Loads features as GeoJSON (used for testing). */
+  loadGeoJSON({
+    geojson,
+    spatialFilter,
+    uniqueIdProperty
+  }) {
+    this._features = geojsonFeatures({
+      geojson,
+      spatialFilter,
+      uniqueIdProperty
+    });
+  }
+  async getFeatures(options) {
+    throw new Error('getFeatures not supported for tilesets');
+  }
+  async getFormula({
+    column = '*',
+    operation = 'count',
+    joinOperation,
+    filterOwner
+  }) {
+    if (operation === 'custom') {
+      throw new Error('Custom aggregation not supported for tilesets');
+    }
+    if (!this._features.length) {
+      return {
+        value: null
+      };
+    }
+    // Column is required except when operation is 'count'.
+    if (column && column !== '*' || operation !== 'count') {
+      assertColumn(this._features, column);
+    }
+    const filteredFeatures = this._getFilteredFeatures(filterOwner);
+    if (filteredFeatures.length === 0 && operation !== 'count') {
+      return {
+        value: null
+      };
+    }
+    const targetOperation = aggregationFunctions[operation];
+    return {
+      value: targetOperation(filteredFeatures, column, joinOperation)
+    };
+  }
+  async getHistogram({
+    operation = 'count',
+    ticks,
+    column,
+    joinOperation,
+    filterOwner
+  }) {
+    if (!this._features.length) {
+      return [];
+    }
+    const filteredFeatures = this._getFilteredFeatures(filterOwner);
+    assertColumn(this._features, column);
+    return histogram({
+      data: filteredFeatures,
+      valuesColumns: normalizeColumns(column),
+      joinOperation,
+      ticks,
+      operation
+    });
+  }
+  async getCategories({
+    column,
+    operation = 'count',
+    operationColumn,
+    joinOperation,
+    filterOwner
+  }) {
+    if (!this._features.length) {
+      return [];
+    }
+    const filteredFeatures = this._getFilteredFeatures(filterOwner);
+    assertColumn(this._features, column, operationColumn);
+    const groups = groupValuesByColumn({
+      data: filteredFeatures,
+      valuesColumns: normalizeColumns(operationColumn || column),
+      joinOperation,
+      keysColumn: column,
+      operation
+    });
+    return groups || [];
+  }
+  async getScatter({
+    xAxisColumn,
+    yAxisColumn,
+    xAxisJoinOperation,
+    yAxisJoinOperation,
+    filterOwner
+  }) {
+    if (!this._features.length) {
+      return [];
+    }
+    const filteredFeatures = this._getFilteredFeatures(filterOwner);
+    assertColumn(this._features, xAxisColumn, yAxisColumn);
+    return scatterPlot({
+      data: filteredFeatures,
+      xAxisColumns: normalizeColumns(xAxisColumn),
+      xAxisJoinOperation,
+      yAxisColumns: normalizeColumns(yAxisColumn),
+      yAxisJoinOperation
+    });
+  }
+  async getTable(options) {
+    const {
+        filterOwner
+      } = options,
+      params = _objectWithoutPropertiesLoose(options, _excluded);
+    const {
+      columns,
+      searchFilterColumn,
+      searchFilterText,
+      sortBy,
+      sortDirection,
+      sortByColumnType,
+      offset = 0,
+      limit = 10
+    } = params;
+    if (!this._features.length) {
+      return {
+        rows: [],
+        totalCount: 0
+      };
+    }
+    // Filter.
+    let filteredFeatures = this._getFilteredFeatures(filterOwner);
+    // Search.
+    // TODO: Could we get the same behavior by applying filters in loadTiles()?
+    if (searchFilterColumn && searchFilterText) {
+      filteredFeatures = filteredFeatures.filter(row => row[searchFilterColumn] && String(row[searchFilterColumn]).toLowerCase().includes(String(searchFilterText).toLowerCase()));
+    }
+    // Sort.
+    let rows = applySorting(filteredFeatures, {
+      sortBy,
+      sortByDirection: sortDirection,
+      sortByColumnType
+    });
+    const totalCount = rows.length;
+    // Offset and limit.
+    rows = rows.slice(Math.min(offset, totalCount), Math.min(offset + limit, totalCount));
+    // Select columns.
+    rows = rows.map(srcRow => {
+      const dstRow = {};
+      for (const column of columns) {
+        dstRow[column] = srcRow[column];
+      }
+      return dstRow;
+    });
+    return {
+      rows,
+      totalCount
+    };
+  }
+  async getTimeSeries({
+    column,
+    stepSize,
+    operation,
+    operationColumn,
+    joinOperation,
+    filterOwner
+  }) {
+    if (!this._features.length) {
+      return {
+        rows: []
+      };
+    }
+    const filteredFeatures = this._getFilteredFeatures(filterOwner);
+    assertColumn(this._features, column, operationColumn);
+    const rows = groupValuesByDateColumn({
+      data: filteredFeatures,
+      valuesColumns: normalizeColumns(operationColumn || column),
+      keysColumn: column,
+      groupType: stepSize,
+      operation,
+      joinOperation
+    }) || [];
+    return {
+      rows
+    };
+  }
+  async getRange({
+    column,
+    filterOwner
+  }) {
+    if (!this._features.length) {
+      // TODO: Is this the only nullable response in the Widgets API? If so,
+      // can we do something more consistent?
+      return null;
+    }
+    assertColumn(this._features, column);
+    const filteredFeatures = this._getFilteredFeatures(filterOwner);
+    return {
+      min: aggregationFunctions.min(filteredFeatures, column),
+      max: aggregationFunctions.max(filteredFeatures, column)
+    };
+  }
+  /****************************************************************************
+   * INTERNAL
+   */
+  _getFilteredFeatures(filterOwner) {
+    return applyFilters(this._features, getApplicableFilters(filterOwner, this.props.filters), this.props.filtersLogicalOperator || 'and');
+  }
+}
+function assertColumn(features, ...columnArgs) {
+  // TODO(cleanup): Can drop support for multiple column shapes here?
+  // Due to the multiple column shape, we normalise it as an array with normalizeColumns
+  const columns = Array.from(new Set(columnArgs.map(normalizeColumns).flat()));
+  const featureKeys = Object.keys(features[0]);
+  const invalidColumns = columns.filter(column => !featureKeys.includes(column));
+  if (invalidColumns.length) {
+    throw new InvalidColumnError(`Missing column(s): ${invalidColumns.join(', ')}`);
+  }
+}
+function normalizeColumns(columns) {
+  return Array.isArray(columns) ? columns : typeof columns === 'string' ? [columns] : [];
+}
+
+const h3QuerySource = async function h3QuerySource(options) {
+  const {
+    aggregationExp,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
+    sqlQuery,
+    spatialDataColumn = 'h3',
+    queryParameters,
+    filters
+  } = options;
+  const urlParameters = {
+    aggregationExp,
+    spatialDataColumn,
+    spatialDataType: 'h3',
+    q: sqlQuery
+  };
+  if (aggregationResLevel) {
+    urlParameters.aggregationResLevel = String(aggregationResLevel);
+  }
+  if (queryParameters) {
+    urlParameters.queryParameters = queryParameters;
+  }
+  if (filters) {
+    urlParameters.filters = filters;
+  }
+  return baseSource('query', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetQuerySource(_extends({}, options, {
+      // NOTE: passing redundant spatialDataColumn here to apply the default value 'h3'
+      spatialDataColumn,
+      spatialDataType: 'h3'
+    }))
+  }));
+};
+
+const h3TableSource = async function h3TableSource(options) {
+  const {
+    aggregationExp,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
+    spatialDataColumn = 'h3',
+    tableName,
+    filters
+  } = options;
+  const urlParameters = {
+    aggregationExp,
+    name: tableName,
+    spatialDataColumn,
+    spatialDataType: 'h3'
+  };
+  if (aggregationResLevel) {
+    urlParameters.aggregationResLevel = String(aggregationResLevel);
+  }
+  if (filters) {
+    urlParameters.filters = filters;
+  }
+  return baseSource('table', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetTableSource(_extends({}, options, {
+      // NOTE: passing redundant spatialDataColumn here to apply the default value 'h3'
+      spatialDataColumn,
+      spatialDataType: 'h3'
+    }))
+  }));
+};
+
+function getTileFormat(tilejson) {
+  const tileParams = new URL(tilejson.tiles[0]).searchParams;
+  return tileParams.get('formatTiles') === 'mvt' ? TileFormat.MVT : TileFormat.BINARY;
+}
+
+const h3TilesetSource = async function h3TilesetSource(options) {
+  const {
+    tableName,
+    spatialDataColumn = 'h3'
+  } = options;
+  const urlParameters = {
+    name: tableName
+  };
+  return baseSource('tileset', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetTilesetSource(_extends({}, options, {
+      tileFormat: getTileFormat(result),
+      spatialDataColumn,
+      spatialDataType: 'h3'
+    }))
+  }));
+};
+
+// deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const rasterSource = async function rasterSource(options) {
+  const {
+    tableName,
+    filters
+  } = options;
+  const urlParameters = {
+    name: tableName
+  };
+  if (filters) {
+    urlParameters.filters = filters;
+  }
+  return baseSource('raster', options, urlParameters);
+};
+
+const quadbinQuerySource = async function quadbinQuerySource(options) {
+  const {
+    aggregationExp,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
+    sqlQuery,
+    spatialDataColumn = 'quadbin',
+    queryParameters,
+    filters
+  } = options;
+  const urlParameters = {
+    aggregationExp,
+    q: sqlQuery,
+    spatialDataColumn,
+    spatialDataType: 'quadbin'
+  };
+  if (aggregationResLevel) {
+    urlParameters.aggregationResLevel = String(aggregationResLevel);
+  }
+  if (queryParameters) {
+    urlParameters.queryParameters = queryParameters;
+  }
+  if (filters) {
+    urlParameters.filters = filters;
+  }
+  return baseSource('query', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetQuerySource(_extends({}, options, {
+      // NOTE: passing redundant spatialDataColumn here to apply the default value 'quadbin'
+      spatialDataColumn,
+      spatialDataType: 'quadbin'
+    }))
+  }));
+};
+
+const quadbinTableSource = async function quadbinTableSource(options) {
+  const {
+    aggregationExp,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
+    spatialDataColumn = 'quadbin',
+    tableName,
+    filters
+  } = options;
+  const urlParameters = {
+    aggregationExp,
+    name: tableName,
+    spatialDataColumn,
+    spatialDataType: 'quadbin'
+  };
+  if (aggregationResLevel) {
+    urlParameters.aggregationResLevel = String(aggregationResLevel);
+  }
+  if (filters) {
+    urlParameters.filters = filters;
+  }
+  return baseSource('table', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetTableSource(_extends({}, options, {
+      // NOTE: passing redundant spatialDataColumn here to apply the default value 'quadbin'
+      spatialDataColumn,
+      spatialDataType: 'quadbin'
+    }))
+  }));
+};
+
+const quadbinTilesetSource = async function quadbinTilesetSource(options) {
+  const {
+    tableName,
+    spatialDataColumn = 'quadbin'
+  } = options;
+  const urlParameters = {
+    name: tableName
+  };
+  return baseSource('tileset', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetTilesetSource(_extends({}, options, {
+      tileFormat: getTileFormat(result),
+      spatialDataColumn,
+      spatialDataType: 'quadbin'
+    }))
+  }));
+};
+
+const vectorQuerySource = async function vectorQuerySource(options) {
+  const {
+    columns,
+    filters,
+    spatialDataColumn = DEFAULT_GEO_COLUMN,
     sqlQuery,
     tileResolution = DEFAULT_TILE_RESOLUTION,
     queryParameters,
@@ -1488,7 +3451,10 @@ const vectorQuerySource = async function vectorQuerySource(options) {
     urlParameters.aggregationExp = aggregationExp;
   }
   return baseSource('query', options, urlParameters).then(result => _extends({}, result, {
-    widgetSource: new WidgetQuerySource(options)
+    widgetSource: new WidgetQuerySource(_extends({}, options, {
+      spatialDataColumn,
+      spatialDataType: 'geo'
+    }))
   }));
 };
 
@@ -1496,7 +3462,7 @@ const vectorTableSource = async function vectorTableSource(options) {
   const {
     columns,
     filters,
-    spatialDataColumn = 'geom',
+    spatialDataColumn = DEFAULT_GEO_COLUMN,
     tableName,
     tileResolution = DEFAULT_TILE_RESOLUTION,
     aggregationExp
@@ -1517,19 +3483,28 @@ const vectorTableSource = async function vectorTableSource(options) {
     urlParameters.aggregationExp = aggregationExp;
   }
   return baseSource('table', options, urlParameters).then(result => _extends({}, result, {
-    widgetSource: new WidgetTableSource(options)
+    widgetSource: new WidgetTableSource(_extends({}, options, {
+      spatialDataColumn,
+      spatialDataType: 'geo'
+    }))
   }));
 };
 
-// deck.gl
 const vectorTilesetSource = async function vectorTilesetSource(options) {
   const {
-    tableName
+    tableName,
+    spatialDataColumn = DEFAULT_GEO_COLUMN
   } = options;
   const urlParameters = {
     name: tableName
   };
-  return baseSource('tileset', options, urlParameters);
+  return baseSource('tileset', options, urlParameters).then(result => _extends({}, result, {
+    widgetSource: new WidgetTilesetSource(_extends({}, options, {
+      tileFormat: getTileFormat(result),
+      spatialDataColumn,
+      spatialDataType: 'geo'
+    }))
+  }));
 };
 
 const query = async function query(options) {
@@ -1574,5 +3549,5 @@ const query = async function query(options) {
   });
 };
 
-export { ApiVersion, CartoAPIError, DEFAULT_API_BASE_URL, FilterType, SOURCE_DEFAULTS, WidgetBaseSource, WidgetQuerySource, WidgetTableSource, addFilter, boundaryQuerySource, boundaryTableSource, buildPublicMapUrl, buildStatsUrl, clearFilters, createPolygonSpatialFilter, createViewportSpatialFilter, getClient, getFilter, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, setClient, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { ApiVersion, CartoAPIError, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, FilterType, Provider, SOURCE_DEFAULTS, SpatialIndex, TileFormat, WidgetQuerySource, WidgetRemoteSource, WidgetTableSource, WidgetTilesetSource, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, createPolygonSpatialFilter, createViewportSpatialFilter, filterFunctions, geojsonFeatures, getClient, getFilter, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
 //# sourceMappingURL=api-client.modern.js.map