@deck.gl/carto 9.0.0-beta.8 → 9.0.0

package/package.json

@@ -3,7 +3,7 @@
   "description": "CARTO official integration with Deck.gl. Build geospatial applications using CARTO and Deck.gl.",
   "license": "MIT",
   "type": "module",
-  "version": "9.0.0-beta.8",
+  "version": "9.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,12 +42,12 @@
     "prepublishOnly": "npm run build-bundle && npm run build-bundle -- --env=dev"
   },
   "dependencies": {
-    "@loaders.gl/gis": "^4.2.0-alpha.5",
-    "@loaders.gl/loader-utils": "^4.2.0-alpha.5",
-    "@loaders.gl/mvt": "^4.2.0-alpha.5",
-    "@loaders.gl/schema": "^4.2.0-alpha.5",
-    "@loaders.gl/tiles": "^4.2.0-alpha.5",
-    "@luma.gl/constants": "9.0.0-beta.10",
+    "@loaders.gl/gis": "^4.1.4",
+    "@loaders.gl/loader-utils": "^4.1.4",
+    "@loaders.gl/mvt": "^4.1.4",
+    "@loaders.gl/schema": "^4.1.4",
+    "@loaders.gl/tiles": "^4.1.4",
+    "@luma.gl/constants": "^9.0.6",
     "@math.gl/web-mercator": "^4.0.0",
     "@types/d3-array": "^3.0.2",
     "@types/d3-color": "^1.4.2",
@@ -64,13 +64,13 @@
     "quadbin": "^0.2.0"
   },
   "peerDependencies": {
-    "@deck.gl/aggregation-layers": "^9.0.0-beta",
-    "@deck.gl/core": "^9.0.0-beta",
-    "@deck.gl/extensions": "^9.0.0-beta",
-    "@deck.gl/geo-layers": "^9.0.0-beta",
-    "@deck.gl/layers": "^9.0.0-beta",
-    "@loaders.gl/core": "^4.2.0-alpha.5",
-    "@luma.gl/core": "9.0.0-beta.10"
+    "@deck.gl/aggregation-layers": "^9.0.0",
+    "@deck.gl/core": "^9.0.0",
+    "@deck.gl/extensions": "^9.0.0",
+    "@deck.gl/geo-layers": "^9.0.0",
+    "@deck.gl/layers": "^9.0.0",
+    "@loaders.gl/core": "^4.1.0",
+    "@luma.gl/core": "^9.0.0"
   },
-  "gitHead": "8867a1047c2693d44e4af9507c296cf7ab61f9e8"
+  "gitHead": "fcb5ccf0a899e651949b24986488211e278e9321"
 }

package/src/api/common.ts

@@ -1,6 +1,6 @@
 export const DEFAULT_API_BASE_URL = 'https://gcp-us-east1.api.carto.com';
 export const DEFAULT_CLIENT = 'deck-gl-carto';
-export const V3_MINOR_VERSION = '3.3';
+export const V3_MINOR_VERSION = '3.4';
 export const MAX_GET_LENGTH = 8192;
 
 export const DEFAULT_PARAMETERS = {

package/src/api/fetch-map.ts

@@ -80,19 +80,24 @@ async function _fetchMapDataset(
       if (type === 'table') {
         dataset.data = await vectorTableSource({...options, columns, tableName: source});
       } else if (type === 'query') {
-        dataset.data = await vectorQuerySource({...options, sqlQuery: source, queryParameters});
+        dataset.data = await vectorQuerySource({
+          ...options,
+          columns,
+          sqlQuery: source,
+          queryParameters
+        });
       }
     } else if (spatialDataType === 'h3') {
       const options = {...globalOptions, aggregationExp, aggregationResLevel, spatialDataColumn};
       if (type === 'table') {
-        dataset.data = await h3TableSource({...options, columns, tableName: source});
+        dataset.data = await h3TableSource({...options, tableName: source});
       } else if (type === 'query') {
         dataset.data = await h3QuerySource({...options, sqlQuery: source, queryParameters});
       }
     } else if (spatialDataType === 'quadbin') {
       const options = {...globalOptions, aggregationExp, aggregationResLevel, spatialDataColumn};
       if (type === 'table') {
-        dataset.data = await quadbinTableSource({...options, columns, tableName: source});
+        dataset.data = await quadbinTableSource({...options, tableName: source});
       } else if (type === 'query') {
         dataset.data = await quadbinQuerySource({...options, sqlQuery: source, queryParameters});
       }

package/src/api/request-with-parameters.ts

@@ -9,7 +9,7 @@ function encodeParameter(name: string, value: string | boolean | number): string
   return `${name}=${encodeURIComponent(value)}`;
 }
 
-const REQUEST_CACHE = new Map();
+const REQUEST_CACHE = new Map<string, Promise<unknown>>();
 export async function requestWithParameters<T = any>({
   accessToken,
   baseUrl,
@@ -23,46 +23,59 @@ export async function requestWithParameters<T = any>({
   headers: Record<string, string>;
   errorContext: APIErrorContext;
 }): Promise<T> {
-  const key = JSON.stringify({baseUrl, parameters, customHeaders});
+  const key = createCacheKey(baseUrl, parameters || {}, customHeaders || {});
   if (REQUEST_CACHE.has(key)) {
-    return REQUEST_CACHE.get(key);
-  }
-
-  let url = baseUrl;
-  if (parameters) {
-    const allParameters = {...DEFAULT_PARAMETERS, ...parameters};
-    const encodedParameters = Object.entries(allParameters).map(([key, value]) => {
-      return encodeParameter(key, value);
-    });
-    url += `?${encodedParameters.join('&')}`;
+    return REQUEST_CACHE.get(key) as Promise<T>;
   }
 
+  const url = parameters ? createURLWithParameters(baseUrl, parameters) : baseUrl;
   const headers = {...DEFAULT_HEADERS, ...customHeaders};
-  try {
-    /* global fetch */
-    let response: Response;
-    if (url.length > MAX_GET_LENGTH) {
-      response = await fetch(baseUrl, {method: 'POST', body: JSON.stringify(parameters), headers});
-    } else {
-      response = await fetch(url, {headers});
-    }
-    let json: any;
-    try {
-      json = await response.json();
+
+  /* global fetch */
+  const fetchPromise =
+    url.length > MAX_GET_LENGTH
+      ? fetch(baseUrl, {method: 'POST', body: JSON.stringify(parameters), headers})
+      : fetch(url, {headers});
+
+  let response: Response | undefined;
+  const jsonPromise: Promise<T> = fetchPromise
+    .then((_response: Response) => {
+      response = _response;
+      return response.json();
+    })
+    .then((json: any) => {
+      if (!response || !response.ok) {
+        throw new Error(json.error);
+      }
       if (accessToken) {
         json.accessToken = accessToken;
       }
-    } catch {
-      json = {error: ''};
-    }
-    if (!response.ok) {
+      return json;
+    })
+    .catch((error: Error) => {
       REQUEST_CACHE.delete(key);
-      throw new CartoAPIError(json.error, errorContext, response);
-    }
+      throw new CartoAPIError(error, errorContext, response);
+    });
 
-    REQUEST_CACHE.set(key, json);
-    return json;
-  } catch (error) {
-    throw new CartoAPIError(error as Error, errorContext);
-  }
+  REQUEST_CACHE.set(key, jsonPromise);
+  return jsonPromise;
+}
+
+function createCacheKey(
+  baseUrl: string,
+  parameters: Record<string, string>,
+  headers: Record<string, string>
+): string {
+  const parameterEntries = Object.entries(parameters).sort(([a], [b]) => (a > b ? 1 : -1));
+  const headerEntries = Object.entries(headers).sort(([a], [b]) => (a > b ? 1 : -1));
+  return JSON.stringify({baseUrl, parameters: parameterEntries, headers: headerEntries});
+}
+
+function createURLWithParameters(baseUrl: string, parameters: Record<string, string>): string {
+  const encodedParameters = Object.entries({...DEFAULT_PARAMETERS, ...parameters}).map(
+    ([key, value]) => {
+      return encodeParameter(key, value);
+    }
+  );
+  return `${baseUrl}?${encodedParameters.join('&')}`;
 }

package/src/constants.ts

@@ -0,0 +1,5 @@
+export const DEFAULT_TILE_SIZE = 512;
+export const DEFAULT_TILE_RESOLUTION = 0.5;
+
+export const DEFAULT_AGGREGATION_RES_LEVEL_H3 = 4;
+export const DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN = 6;

package/src/index.ts

@@ -83,7 +83,13 @@ export {
 };
 
 export type {
+  GeojsonResult,
+  JsonResult,
   TilejsonResult,
+  SourceOptions,
+  QuerySourceOptions,
+  TableSourceOptions,
+  TilesetSourceOptions,
   BoundaryQuerySourceOptions,
   BoundaryTableSourceOptions,
   H3QuerySourceOptions,
@@ -95,7 +101,5 @@ export type {
   QuadbinTilesetSourceOptions,
   VectorQuerySourceOptions,
   VectorTableSourceOptions,
-  VectorTilesetSourceOptions,
-  GeojsonResult,
-  JsonResult
+  VectorTilesetSourceOptions
 } from './sources/index';

package/src/layers/h3-tile-layer.ts

@@ -4,6 +4,7 @@ import H3Tileset2D, {getHexagonResolution} from './h3-tileset-2d';
 import SpatialIndexTileLayer, {SpatialIndexTileLayerProps} from './spatial-index-tile-layer';
 import type {TilejsonResult} from '../sources/types';
 import {injectAccessToken, TilejsonPropType} from './utils';
+import {DEFAULT_TILE_SIZE} from '../constants';
 
 export const renderSubLayers = props => {
   const {data} = props;
@@ -18,7 +19,8 @@ export const renderSubLayers = props => {
 };
 
 const defaultProps: DefaultProps<H3TileLayerProps> = {
-  data: TilejsonPropType
+  data: TilejsonPropType,
+  tileSize: DEFAULT_TILE_SIZE
 };
 
 /** All properties supported by H3TileLayer. */

package/src/layers/quadbin-tile-layer.ts

@@ -5,6 +5,7 @@ import SpatialIndexTileLayer, {SpatialIndexTileLayerProps} from './spatial-index
 import {hexToBigInt} from 'quadbin';
 import type {TilejsonResult} from '../sources/types';
 import {injectAccessToken, TilejsonPropType} from './utils';
+import {DEFAULT_TILE_SIZE} from '../constants';
 
 export const renderSubLayers = props => {
   const {data} = props;
@@ -16,7 +17,8 @@ export const renderSubLayers = props => {
 };
 
 const defaultProps: DefaultProps<QuadbinTileLayerProps> = {
-  data: TilejsonPropType
+  data: TilejsonPropType,
+  tileSize: DEFAULT_TILE_SIZE
 };
 
 /** All properties supported by QuadbinTileLayer. */

package/src/layers/raster-layer.ts

@@ -10,7 +10,7 @@ import {ColumnLayer, ColumnLayerProps} from '@deck.gl/layers';
 import {quadbinToOffset} from './quadbin-utils';
 import {Raster} from './schema/carto-raster-tile-loader';
 import vs from './raster-layer-vertex.glsl';
-import {assert, createBinaryProxy} from '../utils';
+import {createBinaryProxy} from '../utils';
 
 const defaultProps: DefaultProps<RasterLayerProps> = {
   ...ColumnLayer.defaultProps,
@@ -30,8 +30,8 @@ class RasterColumnLayer extends ColumnLayer {
 
   getShaders() {
     const shaders = super.getShaders();
-    const data = this.props.data as unknown as Raster & {length: number};
-    const BLOCK_WIDTH = data.blockWidth || Math.sqrt(data.length);
+    const data = this.props.data as unknown as {data: Raster; length: number};
+    const BLOCK_WIDTH = data.data.blockSize ?? Math.sqrt(data.length);
     return {...shaders, defines: {...shaders.defines, BLOCK_WIDTH}, vs};
   }
 
@@ -93,17 +93,12 @@ export default class RasterLayer<DataT = any, ExtraProps = {}> extends Composite
       getLineWidth,
       tileIndex,
       updateTriggers
-    } = this.props;
+    } = this.props as typeof this.props & {data: Raster};
     if (!data || !tileIndex) return null;
 
-    const {blockWidth, blockHeight} = data as unknown as Raster;
-    assert(
-      blockWidth === blockHeight,
-      `blockWidth (${blockWidth}) must equal blockHeight (${blockHeight})`
-    );
-
+    const blockSize = data.blockSize ?? 0;
     const [xOffset, yOffset, scale] = quadbinToOffset(tileIndex);
-    const offset = [xOffset, yOffset, scale / blockWidth];
+    const offset = [xOffset, yOffset, scale / blockSize];
 
     // Filled Column Layer
     const CellLayer = this.getSubLayerClass('column', RasterColumnLayer);
@@ -121,7 +116,7 @@ export default class RasterLayer<DataT = any, ExtraProps = {}> extends Composite
       {
         data: {
           data, // Pass through data for getSubLayerAccessor()
-          length: blockWidth * blockHeight
+          length: blockSize * blockSize
         },
         offset
       }

package/src/layers/raster-tile-layer.ts

@@ -4,6 +4,7 @@ import QuadbinTileset2D from './quadbin-tileset-2d';
 import SpatialIndexTileLayer, {SpatialIndexTileLayerProps} from './spatial-index-tile-layer';
 import type {TilejsonResult} from '../sources/types';
 import {injectAccessToken, TilejsonPropType} from './utils';
+import {DEFAULT_TILE_SIZE} from '../constants';
 
 export const renderSubLayers = props => {
   const tileIndex = props.tile?.index?.q;
@@ -12,7 +13,8 @@ export const renderSubLayers = props => {
 };
 
 const defaultProps: DefaultProps<RasterTileLayerProps> = {
-  data: TilejsonPropType
+  data: TilejsonPropType,
+  tileSize: DEFAULT_TILE_SIZE
 };
 
 /** All properties supported by RasterTileLayer. */

package/src/layers/schema/carto-raster-tile-loader.ts

@@ -36,8 +36,8 @@ const CartoRasterTileLoader: LoaderWithParser = {
 };
 
 export type Raster = {
-  blockWidth: number;
-  blockHeight: number;
+  /** Raster tiles are square, with 'blockSize' width and height in pixels. */
+  blockSize: number;
   cells: {
     numericProps: NumericProps;
     properties: Properties[];
@@ -49,14 +49,14 @@ function parseCartoRasterTile(
   options?: CartoRasterTileLoaderOptions
 ): Raster | null {
   if (!arrayBuffer) return null;
-  const tile = parsePbf(arrayBuffer, TileReader);
-  const {bands, blockHeight, blockWidth} = tile;
+  const {bands, blockSize} = parsePbf(arrayBuffer, TileReader);
+
   const numericProps = {};
   for (let i = 0; i < bands.length; i++) {
     const {name, data} = bands[i];
     numericProps[name] = data;
   }
-  return {blockWidth, blockHeight, cells: {numericProps, properties: []}};
+  return {blockSize, cells: {numericProps, properties: []}};
 }
 
 export default CartoRasterTileLoader;

package/src/layers/schema/carto-raster-tile.ts

@@ -36,11 +36,10 @@ export class BandReader {
 
 export class TileReader {
   static read(pbf, end) {
-    return pbf.readFields(TileReader._readField, {blockWidth: 0, blockHeight: 0, bands: []}, end);
+    return pbf.readFields(TileReader._readField, {blockSize: 0, bands: []}, end);
   }
   static _readField(this: void, tag, obj, pbf) {
-    if (tag === 1) obj.blockWidth = pbf.readVarint();
-    else if (tag === 2) obj.blockHeight = pbf.readVarint();
-    else if (tag === 3) obj.bands.push(BandReader.read(pbf, pbf.readVarint() + pbf.pos));
+    if (tag === 1) obj.blockSize = pbf.readVarint();
+    else if (tag === 2) obj.bands.push(BandReader.read(pbf, pbf.readVarint() + pbf.pos));
   }
 }

package/src/layers/spatial-index-tile-layer.ts

@@ -6,12 +6,15 @@ registerLoaders([CartoRasterTileLoader, CartoSpatialTileLoader]);
 
 import {PickingInfo} from '@deck.gl/core';
 import {TileLayer, _Tile2DHeader as Tile2DHeader, TileLayerProps} from '@deck.gl/geo-layers';
+import {DEFAULT_TILE_SIZE} from '../constants';
 
 function isFeatureIdDefined(value: unknown): boolean {
   return value !== undefined && value !== null && value !== '';
 }
 
-const defaultProps: DefaultProps<SpatialIndexTileLayerProps> = {};
+const defaultProps: DefaultProps<SpatialIndexTileLayerProps> = {
+  tileSize: DEFAULT_TILE_SIZE
+};
 
 /** All properties supported by SpatialIndexTileLayer. */
 export type SpatialIndexTileLayerProps<DataT = unknown> = _SpatialIndexTileLayerProps &

package/src/layers/vector-tile-layer.ts

@@ -16,19 +16,22 @@ import {
 import {GeoJsonLayer} from '@deck.gl/layers';
 import {binaryToGeojson} from '@loaders.gl/gis';
 import type {BinaryFeatureCollection} from '@loaders.gl/schema';
-import type {Feature} from 'geojson';
+import type {Feature, Geometry} from 'geojson';
 
 import type {TilejsonResult} from '../sources/types';
 import {TilejsonPropType, injectAccessToken, mergeBoundaryData} from './utils';
+import {DEFAULT_TILE_SIZE} from '../constants';
 
 const defaultProps: DefaultProps<VectorTileLayerProps> = {
   ...MVTLayer.defaultProps,
   data: TilejsonPropType,
-  dataComparator: TilejsonPropType.equal
+  dataComparator: TilejsonPropType.equal,
+  tileSize: DEFAULT_TILE_SIZE
 };
 
 /** All properties supported by VectorTileLayer. */
-export type VectorTileLayerProps = _VectorTileLayerProps & Omit<MVTLayerProps, 'data'>;
+export type VectorTileLayerProps<FeaturePropertiesT = unknown> = _VectorTileLayerProps &
+  Omit<MVTLayerProps<FeaturePropertiesT>, 'data'>;
 
 /** Properties added by VectorTileLayer. */
 type _VectorTileLayerProps = {
@@ -36,9 +39,10 @@ type _VectorTileLayerProps = {
 };
 
 // @ts-ignore
-export default class VectorTileLayer<ExtraProps extends {} = {}> extends MVTLayer<
-  Required<_VectorTileLayerProps> & ExtraProps
-> {
+export default class VectorTileLayer<
+  FeaturePropertiesT = any,
+  ExtraProps extends {} = {}
+> extends MVTLayer<FeaturePropertiesT, Required<_VectorTileLayerProps> & ExtraProps> {
   static layerName = 'VectorTileLayer';
   static defaultProps = defaultProps;
 
@@ -46,7 +50,7 @@ export default class VectorTileLayer<ExtraProps extends {} = {}> extends MVTLaye
     mvt: boolean;
   };
 
-  constructor(...propObjects: VectorTileLayerProps[]) {
+  constructor(...propObjects: VectorTileLayerProps<FeaturePropertiesT>[]) {
     // Force externally visible props type, as it is not possible modify via extension
     // @ts-ignore
     super(...propObjects);
@@ -149,7 +153,7 @@ export default class VectorTileLayer<ExtraProps extends {} = {}> extends MVTLaye
       const {data} = params.sourceLayer!.props;
       info.object = binaryToGeojson(data as BinaryFeatureCollection, {
         globalFeatureId: info.index
-      }) as Feature;
+      }) as Feature<Geometry, FeaturePropertiesT>;
     }
 
     return info;

package/src/sources/h3-query-source.ts

@@ -1,4 +1,5 @@
 /* eslint-disable camelcase */
+import {DEFAULT_AGGREGATION_RES_LEVEL_H3} from '../constants';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -23,7 +24,7 @@ export const h3QuerySource = async function (
 ): Promise<TilejsonResult> {
   const {
     aggregationExp,
-    aggregationResLevel = 4,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
     sqlQuery,
     spatialDataColumn = 'h3',
     queryParameters

package/src/sources/h3-table-source.ts

@@ -1,4 +1,5 @@
 /* eslint-disable camelcase */
+import {DEFAULT_AGGREGATION_RES_LEVEL_H3} from '../constants';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -13,7 +14,6 @@ export type H3TableSourceOptions = SourceOptions & TableSourceOptions & Aggregat
 type UrlParameters = {
   aggregationExp: string;
   aggregationResLevel?: string;
-  columns?: string;
   spatialDataType: SpatialDataType;
   spatialDataColumn?: string;
   name: string;
@@ -24,8 +24,7 @@ export const h3TableSource = async function (
 ): Promise<TilejsonResult> {
   const {
     aggregationExp,
-    aggregationResLevel = 4,
-    columns,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
     spatialDataColumn = 'h3',
     tableName
   } = options;
@@ -39,8 +38,5 @@ export const h3TableSource = async function (
   if (aggregationResLevel) {
     urlParameters.aggregationResLevel = String(aggregationResLevel);
   }
-  if (columns) {
-    urlParameters.columns = columns.join(',');
-  }
   return baseSource<UrlParameters>('table', options, urlParameters) as Promise<TilejsonResult>;
 };

package/src/sources/index.ts

@@ -36,3 +36,10 @@ export type {VectorTableSourceOptions} from './vector-table-source';
 
 export {vectorTilesetSource} from './vector-tileset-source';
 export type {VectorTilesetSourceOptions} from './vector-tileset-source';
+
+export type {
+  SourceOptions,
+  QuerySourceOptions,
+  TableSourceOptions,
+  TilesetSourceOptions
+} from './types';

package/src/sources/quadbin-query-source.ts

@@ -1,4 +1,5 @@
 /* eslint-disable camelcase */
+import {DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN} from '../constants';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -24,7 +25,7 @@ export const quadbinQuerySource = async function (
 ): Promise<TilejsonResult> {
   const {
     aggregationExp,
-    aggregationResLevel = 6,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
     sqlQuery,
     spatialDataColumn = 'quadbin',
     queryParameters

package/src/sources/quadbin-table-source.ts

@@ -1,4 +1,5 @@
 /* eslint-disable camelcase */
+import {DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN} from '../constants';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -13,7 +14,6 @@ export type QuadbinTableSourceOptions = SourceOptions & TableSourceOptions & Agg
 type UrlParameters = {
   aggregationExp: string;
   aggregationResLevel?: string;
-  columns?: string;
   spatialDataType: SpatialDataType;
   spatialDataColumn?: string;
   name: string;
@@ -24,8 +24,7 @@ export const quadbinTableSource = async function (
 ): Promise<TilejsonResult> {
   const {
     aggregationExp,
-    aggregationResLevel = 6,
-    columns,
+    aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
     spatialDataColumn = 'quadbin',
     tableName
   } = options;
@@ -40,8 +39,5 @@ export const quadbinTableSource = async function (
   if (aggregationResLevel) {
     urlParameters.aggregationResLevel = String(aggregationResLevel);
   }
-  if (columns) {
-    urlParameters.columns = columns.join(',');
-  }
   return baseSource<UrlParameters>('table', options, urlParameters) as Promise<TilejsonResult>;
 };

package/src/sources/types.ts

@@ -75,6 +75,21 @@ export type QuerySourceOptions = {
   /** SQL query. */
   sqlQuery: string;
 
+  /**
+   * Relative resolution of a tile. Higher values increase density and data size. At `tileResolution = 1`, tile geometry is
+   * quantized to a 1024x1024 grid. Increasing or decreasing the resolution will increase or decrease the dimensions of
+   * the quantization grid proportionately.
+   *
+   * Supported `tileResolution` values, with corresponding grid sizes:
+   *
+   * - 0.25: 256x256
+   * - 0.5: 512x512
+   * - 1: 1024x1024
+   * - 2: 2048x2048
+   * - 4: 4096x4096
+   */
+  tileResolution?: TileResolution;
+
   /**
    * Values for named or positional paramteres in the query.
    *
@@ -109,18 +124,26 @@ export type TableSourceOptions = {
   tableName: string;
 
   /**
-   * Columns to retrieve from the table.
+   * The column name and the type of geospatial support.
    *
-   * If not present, all columns are returned.
+   * If not present, defaults to `'geom'` for generic tables, `'quadbin'` for Quadbin sources and `'h3'` for H3 sources.
    */
-  columns?: string[];
+  spatialDataColumn?: string;
 
   /**
-   * The column name and the type of geospatial support.
+   * Relative resolution of a tile. Higher values increase density and data size. At `tileResolution = 1`, tile geometry is
+   * quantized to a 1024x1024 grid. Increasing or decreasing the resolution will increase or decrease the dimensions of
+   * the quantization grid proportionately.
    *
-   * If not present, defaults to `'geom'` for generic tables, `'quadbin'` for Quadbin sources and `'h3'` for H3 sources.
+   * Supported `tileResolution` values, with corresponding grid sizes:
+   *
+   * - 0.25: 256x256
+   * - 0.5: 512x512
+   * - 1: 1024x1024
+   * - 2: 2048x2048
+   * - 4: 4096x4096
    */
-  spatialDataColumn?: string;
+  tileResolution?: TileResolution;
 };
 
 export type TilesetSourceOptions = {
@@ -130,12 +153,23 @@ export type TilesetSourceOptions = {
   tableName: string;
 };
 
+export type ColumnsOption = {
+  /**
+   * Columns to retrieve from the table.
+   *
+   * If not present, all columns are returned.
+   */
+  columns?: string[];
+};
+
 export type SpatialDataType = 'geo' | 'h3' | 'quadbin';
 
 export type TilejsonMapInstantiation = MapInstantiation & {
   tilejson: {url: string[]};
 };
 
+export type TileResolution = 0.25 | 0.5 | 1 | 2 | 4;
+
 export interface Tilejson {
   tilejson: string;
   name: string;
@@ -153,6 +187,7 @@ export interface Tilejson {
   center: [number, number, number];
   vector_layers: VectorLayer[];
   tilestats: Tilestats;
+  tileResolution?: TileResolution;
 }
 
 export interface Tilestats {