@carto/api-client 0.5.2-alpha.0 → 0.5.2-alpha.2

package/build/api-client.d.cts

@@ -219,6 +219,32 @@ type PositionalQueryParameter = QueryParameterValue[];
 /** @privateRemarks Source: @deck.gl/carto */
 type QueryParameters = NamedQueryParameter | PositionalQueryParameter;
 
+/******************************************************************************
+ * MAP INSTANTIATION
+ */
+/**
+ * @privateRemarks Source: @deck.gl/carto
+ * @internal
+ */
+declare enum SchemaFieldType {
+    Number = "number",
+    Bigint = "bigint",
+    String = "string",
+    Geometry = "geometry",
+    Timestamp = "timestamp",
+    Object = "object",
+    Boolean = "boolean",
+    Variant = "variant",
+    Unknown = "unknown"
+}
+/**
+ * @privateRemarks Source: @deck.gl/carto
+ * @internal
+ */
+interface SchemaField {
+    name: string;
+    type: SchemaFieldType;
+}
 /******************************************************************************
  * LOCAL CALCULATIONS
  */
@@ -630,6 +656,7 @@ type RasterMetadata = {
 };
 type TilejsonResult = Tilejson & {
     accessToken: string;
+    schema: SchemaField[];
 };
 type QueryResult = {
     meta: {
@@ -662,6 +689,11 @@ declare const SCALE_FUNCS: Record<string, () => any>;
 type SCALE_TYPE = keyof typeof SCALE_FUNCS;
 declare const AGGREGATION: Record<string, string>;
 declare const OPACITY_MAP: Record<string, string>;
+/** @privateRemarks Source: Builder */
+declare const TEXT_LABEL_INDEX = 0;
+/** @privateRemarks Source: Builder */
+declare const TEXT_OUTLINE_OPACITY = 64;
+declare const TEXT_NUMBER_FORMATTER: Intl.NumberFormat;
 declare function getLayerProps(type: LayerType, config: MapLayerConfig, dataset: Dataset): {
     propMap: any;
     defaultProps: any;
@@ -684,6 +716,18 @@ declare function negateAccessor(accessor: Accessor): Accessor;
 declare function getSizeAccessor({ name }: VisualChannelField, scaleType: SCALE_TYPE | undefined, aggregation: string | null | undefined, range: Iterable<Range> | null | undefined, data: any): any;
 declare function getTextAccessor({ name, type }: VisualChannelField, data: any): any;
 
+/** @privateRemarks Source: Builder */
+declare function calculateClusterRadius(properties: {
+    [column: string]: number;
+}, stats: Record<string, {
+    min: number;
+    max: number;
+}>, radiusRange: [number, number], column: string): number;
+/** @privateRemarks Source: Builder */
+declare function getDefaultAggregationExpColumnAliasForLayerType(layerType: LayerType, provider: ProviderType, schema: SchemaField[]): string;
+/** @privateRemarks Source: Builder */
+declare function calculateClusterTextFontSize(radius: number): number;
+
 type VisualChannelField = {
     name: string;
     type: string;
@@ -739,6 +783,8 @@ type VisConfig = {
     heightRange?: any;
     heightAggregation?: any;
     weightAggregation?: any;
+    clusterLevel?: number;
+    isTextVisible?: boolean;
 };
 type TextLabel = {
     field: VisualChannelField | null | undefined;
@@ -1768,4 +1814,4 @@ declare function getColumnNameFromGeoColumn(geoColumn: string | null | undefined
  */
 declare function getSpatialIndexFromGeoColumn(geoColumn: string): SpatialIndex | null;
 
-export { AGGREGATION, type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, type ColumnsOption, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type FetchMapOptions, type FetchMapResult, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, type FilterOptions, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GetFilterOptions, type GoogleBasemap, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type KeplerMapConfig, type Layer, type LayerDescriptor, type LayerType, type MapLibreBasemap, type MapType, type NamedQueryParameter, OPACITY_MAP, type ParseMapResult, type PositionalQueryParameter, Provider, type ProviderType, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterBandType, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RasterTile, type RemoveFilterOptions, type SCALE_TYPE, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptionalOptions, type SourceOptions, type SourceRequiredOptions, type SpatialDataType, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, SpatialIndexColumn, type SpatialIndexTile, type StringSearchOptions, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type Tilejson, type TilejsonResult, type TilesetSourceOptions, type Tilestats, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRasterSource, type WidgetRasterSourceProps, type WidgetRasterSourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, type _DataFilterExtensionProps, _buildFeatureFilter, domainFromValues as _domainFromValues, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, configureSource, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColorValueAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getFilter, getIconUrlAccessor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSpatialIndexFromGeoColumn, getTextAccessor, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, negateAccessor, opacityToAlpha, parseMap, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scaleAggregationResLevel, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { AGGREGATION, type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, type ColumnsOption, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type FetchMapOptions, type FetchMapResult, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, type FilterOptions, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GetFilterOptions, type GoogleBasemap, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type KeplerMapConfig, type Layer, type LayerDescriptor, type LayerType, type MapLibreBasemap, type MapType, type NamedQueryParameter, OPACITY_MAP, type ParseMapResult, type PositionalQueryParameter, Provider, type ProviderType, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterBandType, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RasterTile, type RemoveFilterOptions, type SCALE_TYPE, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptionalOptions, type SourceOptions, type SourceRequiredOptions, type SpatialDataType, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, SpatialIndexColumn, type SpatialIndexTile, type StringSearchOptions, TEXT_LABEL_INDEX, TEXT_NUMBER_FORMATTER, TEXT_OUTLINE_OPACITY, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type Tilejson, type TilejsonResult, type TilesetSourceOptions, type Tilestats, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRasterSource, type WidgetRasterSourceProps, type WidgetRasterSourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, type _DataFilterExtensionProps, _buildFeatureFilter, domainFromValues as _domainFromValues, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, calculateClusterRadius, calculateClusterTextFontSize, clearFilters, configureSource, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColorValueAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getDefaultAggregationExpColumnAliasForLayerType, getFilter, getIconUrlAccessor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSpatialIndexFromGeoColumn, getTextAccessor, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, negateAccessor, opacityToAlpha, parseMap, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scaleAggregationResLevel, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };

package/build/api-client.d.ts

@@ -219,6 +219,32 @@ type PositionalQueryParameter = QueryParameterValue[];
 /** @privateRemarks Source: @deck.gl/carto */
 type QueryParameters = NamedQueryParameter | PositionalQueryParameter;
 
+/******************************************************************************
+ * MAP INSTANTIATION
+ */
+/**
+ * @privateRemarks Source: @deck.gl/carto
+ * @internal
+ */
+declare enum SchemaFieldType {
+    Number = "number",
+    Bigint = "bigint",
+    String = "string",
+    Geometry = "geometry",
+    Timestamp = "timestamp",
+    Object = "object",
+    Boolean = "boolean",
+    Variant = "variant",
+    Unknown = "unknown"
+}
+/**
+ * @privateRemarks Source: @deck.gl/carto
+ * @internal
+ */
+interface SchemaField {
+    name: string;
+    type: SchemaFieldType;
+}
 /******************************************************************************
  * LOCAL CALCULATIONS
  */
@@ -630,6 +656,7 @@ type RasterMetadata = {
 };
 type TilejsonResult = Tilejson & {
     accessToken: string;
+    schema: SchemaField[];
 };
 type QueryResult = {
     meta: {
@@ -662,6 +689,11 @@ declare const SCALE_FUNCS: Record<string, () => any>;
 type SCALE_TYPE = keyof typeof SCALE_FUNCS;
 declare const AGGREGATION: Record<string, string>;
 declare const OPACITY_MAP: Record<string, string>;
+/** @privateRemarks Source: Builder */
+declare const TEXT_LABEL_INDEX = 0;
+/** @privateRemarks Source: Builder */
+declare const TEXT_OUTLINE_OPACITY = 64;
+declare const TEXT_NUMBER_FORMATTER: Intl.NumberFormat;
 declare function getLayerProps(type: LayerType, config: MapLayerConfig, dataset: Dataset): {
     propMap: any;
     defaultProps: any;
@@ -684,6 +716,18 @@ declare function negateAccessor(accessor: Accessor): Accessor;
 declare function getSizeAccessor({ name }: VisualChannelField, scaleType: SCALE_TYPE | undefined, aggregation: string | null | undefined, range: Iterable<Range> | null | undefined, data: any): any;
 declare function getTextAccessor({ name, type }: VisualChannelField, data: any): any;
 
+/** @privateRemarks Source: Builder */
+declare function calculateClusterRadius(properties: {
+    [column: string]: number;
+}, stats: Record<string, {
+    min: number;
+    max: number;
+}>, radiusRange: [number, number], column: string): number;
+/** @privateRemarks Source: Builder */
+declare function getDefaultAggregationExpColumnAliasForLayerType(layerType: LayerType, provider: ProviderType, schema: SchemaField[]): string;
+/** @privateRemarks Source: Builder */
+declare function calculateClusterTextFontSize(radius: number): number;
+
 type VisualChannelField = {
     name: string;
     type: string;
@@ -739,6 +783,8 @@ type VisConfig = {
     heightRange?: any;
     heightAggregation?: any;
     weightAggregation?: any;
+    clusterLevel?: number;
+    isTextVisible?: boolean;
 };
 type TextLabel = {
     field: VisualChannelField | null | undefined;
@@ -1768,4 +1814,4 @@ declare function getColumnNameFromGeoColumn(geoColumn: string | null | undefined
  */
 declare function getSpatialIndexFromGeoColumn(geoColumn: string): SpatialIndex | null;
 
-export { AGGREGATION, type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, type ColumnsOption, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type FetchMapOptions, type FetchMapResult, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, type FilterOptions, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GetFilterOptions, type GoogleBasemap, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type KeplerMapConfig, type Layer, type LayerDescriptor, type LayerType, type MapLibreBasemap, type MapType, type NamedQueryParameter, OPACITY_MAP, type ParseMapResult, type PositionalQueryParameter, Provider, type ProviderType, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterBandType, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RasterTile, type RemoveFilterOptions, type SCALE_TYPE, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptionalOptions, type SourceOptions, type SourceRequiredOptions, type SpatialDataType, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, SpatialIndexColumn, type SpatialIndexTile, type StringSearchOptions, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type Tilejson, type TilejsonResult, type TilesetSourceOptions, type Tilestats, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRasterSource, type WidgetRasterSourceProps, type WidgetRasterSourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, type _DataFilterExtensionProps, _buildFeatureFilter, domainFromValues as _domainFromValues, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, configureSource, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColorValueAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getFilter, getIconUrlAccessor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSpatialIndexFromGeoColumn, getTextAccessor, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, negateAccessor, opacityToAlpha, parseMap, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scaleAggregationResLevel, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { AGGREGATION, type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, type ColumnsOption, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type FetchMapOptions, type FetchMapResult, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, type FilterOptions, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GetFilterOptions, type GoogleBasemap, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type KeplerMapConfig, type Layer, type LayerDescriptor, type LayerType, type MapLibreBasemap, type MapType, type NamedQueryParameter, OPACITY_MAP, type ParseMapResult, type PositionalQueryParameter, Provider, type ProviderType, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterBandType, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RasterTile, type RemoveFilterOptions, type SCALE_TYPE, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptionalOptions, type SourceOptions, type SourceRequiredOptions, type SpatialDataType, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, SpatialIndexColumn, type SpatialIndexTile, type StringSearchOptions, TEXT_LABEL_INDEX, TEXT_NUMBER_FORMATTER, TEXT_OUTLINE_OPACITY, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type Tilejson, type TilejsonResult, type TilesetSourceOptions, type Tilestats, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRasterSource, type WidgetRasterSourceProps, type WidgetRasterSourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, type _DataFilterExtensionProps, _buildFeatureFilter, domainFromValues as _domainFromValues, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, calculateClusterRadius, calculateClusterTextFontSize, clearFilters, configureSource, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColorValueAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getDefaultAggregationExpColumnAliasForLayerType, getFilter, getIconUrlAccessor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSpatialIndexFromGeoColumn, getTextAccessor, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, negateAccessor, opacityToAlpha, parseMap, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scaleAggregationResLevel, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };

package/build/api-client.js

@@ -10894,6 +10894,7 @@ function isValidBandValue(value, nodata) {
 }
 
 // src/utils.ts
+var FILTER_TYPES = new Set(Object.values(FilterType));
 function normalizeObjectKeys(el) {
   if (Array.isArray(el)) {
     return el.map((value) => normalizeObjectKeys(value));
@@ -11294,7 +11295,7 @@ async function baseSource(endpoint, options, urlParameters) {
     type: endpoint,
     source: JSON.stringify(parameters, void 0, 2)
   };
-  const mapInstantiation = await requestWithParameters({
+  const { tilejson, schema } = await requestWithParameters({
     baseUrl,
     parameters,
     headers,
@@ -11302,7 +11303,7 @@ async function baseSource(endpoint, options, urlParameters) {
     maxLengthURL,
     localCache
   });
-  const dataUrl = mapInstantiation.tilejson.url[0];
+  const dataUrl = tilejson.url[0];
   if (cache) {
     cache.value = parseInt(
       new URL(dataUrl).searchParams.get("cache") || "",
@@ -11321,6 +11322,9 @@ async function baseSource(endpoint, options, urlParameters) {
   if (accessToken) {
     json.accessToken = accessToken;
   }
+  if (schema) {
+    json.schema = schema;
+  }
   return json;
 }
 
@@ -11541,8 +11545,8 @@ function objectToURLSearchParams(object) {
 }
 
 // src/filters.ts
-var FILTER_TYPES = new Set(Object.values(FilterType));
-var isFilterType = (type) => FILTER_TYPES.has(type);
+var FILTER_TYPES2 = new Set(Object.values(FilterType));
+var isFilterType = (type) => FILTER_TYPES2.has(type);
 function addFilter(filters, { column, type, values, owner }) {
   if (!filters[column]) {
     filters[column] = {};
@@ -11557,7 +11561,7 @@ function removeFilter(filters, { column, owner }) {
     return filters;
   }
   if (owner) {
-    for (const type of FILTER_TYPES) {
+    for (const type of FILTER_TYPES2) {
       if (owner === filter[type]?.owner) {
         delete filter[type];
       }
@@ -11582,7 +11586,7 @@ function hasFilter(filters, { column, owner }) {
   if (!owner) {
     return true;
   }
-  for (const type of FILTER_TYPES) {
+  for (const type of FILTER_TYPES2) {
     if (owner === filter[type]?.owner) {
       return true;
     }
@@ -11941,7 +11945,11 @@ function min(values, keys, joinOperation) {
       Infinity
     );
   }
-  return Math.min(...values);
+  let min3 = Number.POSITIVE_INFINITY;
+  for (const value of values) {
+    min3 = Math.min(min3, value);
+  }
+  return min3;
 }
 function max(values, keys, joinOperation) {
   const normalizedKeys = normalizeKeys(keys);
@@ -11951,7 +11959,11 @@ function max(values, keys, joinOperation) {
       -Infinity
     );
   }
-  return Math.max(...values);
+  let max3 = Number.NEGATIVE_INFINITY;
+  for (const value of values) {
+    max3 = Math.max(max3, value);
+  }
+  return max3;
 }
 function normalizeKeys(keys) {
   return Array.isArray(keys) ? keys : typeof keys === "string" ? [keys] : void 0;
@@ -14240,7 +14252,8 @@ var customMarkersPropsMap = {
 var heatmapTilePropsMap = {
   visConfig: {
     colorRange: (x) => ({ colorRange: x.colors.map(hexToRGBA) }),
-    radius: "radiusPixels"
+    radius: (radius) => ({ radiusPixels: 20 + radius }),
+    opacity: "opacity"
   }
 };
 var defaultProps = {
@@ -14261,6 +14274,12 @@ var deprecatedLayerTypes = [
   "hexagonId",
   "point"
 ];
+var TEXT_LABEL_INDEX = 0;
+var TEXT_OUTLINE_OPACITY = 64;
+var TEXT_NUMBER_FORMATTER = new Intl.NumberFormat("en-US", {
+  maximumFractionDigits: 2,
+  notation: "compact"
+});
 function getLayerProps(type, config2, dataset) {
   if (deprecatedLayerTypes.includes(type)) {
     throw new Error(
@@ -14352,9 +14371,7 @@ function findAccessorKey(keys, properties) {
       return [key];
     }
   }
-  throw new Error(
-    `Could not find property for any accessor key: ${keys.join(", ")}`
-  );
+  return keys;
 }
 function getColorValueAccessor({ name }, colorAggregation, data) {
   const aggregator = AGGREGATION_FUNC[colorAggregation];
@@ -14481,6 +14498,40 @@ function getTextAccessor({ name, type }, data) {
   };
   return normalizeAccessor(accessor, data);
 }
+function calculateClusterRadius(properties, stats, radiusRange, column) {
+  const { min: min3, max: max3 } = stats[column];
+  const value = properties[column];
+  if (min3 === max3) return radiusRange[1];
+  const normalizedValue = (value - min3) / (max3 - min3);
+  return radiusRange[0] + normalizedValue * (radiusRange[1] - radiusRange[0]);
+}
+function getDefaultAggregationExpColumnAliasForLayerType(layerType, provider, schema) {
+  if (schema && layerType === "clusterTile") {
+    return getColumnAliasForAggregationExp(
+      getDefaultColumnFromSchemaForAggregationExp(schema),
+      "count",
+      provider
+    );
+  } else {
+    return DEFAULT_AGGREGATION_EXP_ALIAS;
+  }
+}
+function getColumnAliasForAggregationExp(name, aggregation, provider) {
+  const columnAlias = `${name}_${aggregation}`;
+  return provider === "snowflake" ? columnAlias.toUpperCase() : columnAlias;
+}
+function getDefaultColumnFromSchemaForAggregationExp(schema) {
+  return schema ? schema[0].name : "";
+}
+function calculateClusterTextFontSize(radius) {
+  if (radius >= 80) return 24;
+  if (radius >= 72) return 24;
+  if (radius >= 56) return 20;
+  if (radius >= 40) return 16;
+  if (radius >= 24) return 13;
+  if (radius >= 8) return 11;
+  return 11;
+}
 
 // src/fetch-map/parse-map.ts
 function parseMap(json) {
@@ -14521,7 +14572,14 @@ function parseMap(json) {
             ...defaultProps2,
             ...createInteractionProps(interactionConfig),
             ...styleProps,
-            ...createChannelProps(id, type, config3, visualChannels, data),
+            ...createChannelProps(
+              id,
+              type,
+              config3,
+              visualChannels,
+              data,
+              dataset
+            ),
             // Must come after style
             ...createParametersProp(
               layerBlending,
@@ -14596,7 +14654,7 @@ function createStyleProps(config2, mapping) {
   result.highlightColor = config2.visConfig.enable3d ? [255, 255, 255, 60] : [252, 242, 26, 255];
   return result;
 }
-function createChannelProps(id, type, config2, visualChannels, data) {
+function createChannelProps(id, type, config2, visualChannels, data, dataset) {
   const {
     colorField,
     colorScale,
@@ -14656,6 +14714,47 @@ function createChannelProps(id, type, config2, visualChannels, data) {
       };
     }
   }
+  if (type === "clusterTile") {
+    const aggregationExpAlias = getDefaultAggregationExpColumnAliasForLayerType(
+      type,
+      dataset.providerId,
+      data.schema
+    );
+    result.pointType = visConfig.isTextVisible ? "circle+text" : "circle";
+    result.clusterLevel = visConfig.clusterLevel;
+    result.getWeight = (d) => {
+      return d.properties[aggregationExpAlias];
+    };
+    result.getPointRadius = (d, info) => {
+      return calculateClusterRadius(
+        d.properties,
+        info.data.attributes.stats,
+        visConfig.radiusRange,
+        aggregationExpAlias
+      );
+    };
+    result.textCharacterSet = "auto";
+    result.textFontFamily = "Inter, sans";
+    result.textFontSettings = { sdf: true };
+    result.textFontWeight = 600;
+    result.getText = (d) => TEXT_NUMBER_FORMATTER.format(d.properties[aggregationExpAlias]);
+    result.getTextColor = config2.textLabel[TEXT_LABEL_INDEX].color;
+    result.textOutlineColor = [
+      ...config2.textLabel[TEXT_LABEL_INDEX].outlineColor,
+      TEXT_OUTLINE_OPACITY
+    ];
+    result.textOutlineWidth = 5;
+    result.textSizeUnits = "pixels";
+    result.getTextSize = (d, info) => {
+      const radius = calculateClusterRadius(
+        d.properties,
+        info.data.attributes.stats,
+        visConfig.radiusRange,
+        aggregationExpAlias
+      );
+      return calculateClusterTextFontSize(radius);
+    };
+  }
   if (radiusField || sizeField) {
     result.getPointRadius = getSizeAccessor(
       // @ts-ignore
@@ -15366,6 +15465,9 @@ export {
   SOURCE_DEFAULTS,
   SpatialIndex,
   SpatialIndexColumn,
+  TEXT_LABEL_INDEX,
+  TEXT_NUMBER_FORMATTER,
+  TEXT_OUTLINE_OPACITY,
   TileFormat,
   WidgetQuerySource,
   WidgetRasterSource,
@@ -15386,6 +15488,8 @@ export {
   buildBinaryFeatureFilter,
   buildPublicMapUrl,
   buildStatsUrl,
+  calculateClusterRadius,
+  calculateClusterTextFontSize,
   clearFilters,
   configureSource,
   createPolygonSpatialFilter,
@@ -15400,6 +15504,7 @@ export {
   getColorValueAccessor,
   getColumnNameFromGeoColumn,
   getDataFilterExtensionProps,
+  getDefaultAggregationExpColumnAliasForLayerType,
   getFilter,
   getIconUrlAccessor,
   getLayerProps,