@carto/api-client 0.5.27-alpha.482101a.112 → 0.5.27

package/build/api-client.d.cts

@@ -775,16 +775,17 @@ declare function getLayerProps(type: LayerType, config: MapLayerConfig, dataset:
 };
 declare function domainFromValues(values: any, scaleType: ScaleType): any;
 declare function opacityToAlpha(opacity?: number): number;
-declare function getColorAccessor({ name, colorColumn }: VisualChannelField, scaleType: ScaleType, { aggregation, range }: {
+declare function getColorAccessor({ name, colorColumn, accessorKey }: VisualChannelField, scaleType: ScaleType, { aggregation, range, domainOverride, }: {
     aggregation?: string;
     range: ColorRange;
+    domainOverride?: [number, number];
 }, opacity: number | undefined, data: TilejsonResult): {
     accessor: any;
     domain: number[] | string[];
     scaleDomain: number[] | string[];
     range: string[];
 };
-declare function calculateLayerScale(name: string, scaleType: ScaleType, range: ColorRange, data: TilejsonResult): {
+declare function calculateLayerScale(name: string, scaleType: ScaleType, range: ColorRange, data: TilejsonResult, domainOverride?: [number, number]): {
     scale: D3Scale;
     domain: string[] | number[];
 };
@@ -797,7 +798,7 @@ declare function getIconUrlAccessor(field: VisualChannelField | null | undefined
 declare function getMaxMarkerSize(visConfig: VisConfig, visualChannels: VisualChannels): number;
 type Accessor = number | ((d: any, i: any) => number);
 declare function negateAccessor(accessor: Accessor): Accessor;
-declare function getSizeAccessor({ name }: VisualChannelField, scaleType: ScaleType | undefined, aggregation: string | null | undefined, range: number[] | undefined, data: TilejsonResult): {
+declare function getSizeAccessor({ name, accessorKey }: VisualChannelField, scaleType: ScaleType | undefined, aggregation: string | null | undefined, range: number[] | undefined, data: TilejsonResult, domainOverride?: [number, number]): {
     accessor: any;
     domain: number[];
     scaleDomain: number[];
@@ -814,6 +815,9 @@ declare function calculateClusterRadius(properties: {
 }>, radiusRange: [number, number], column: string): number;
 /** @privateRemarks Source: Builder */
 declare function getDefaultAggregationExpColumnAliasForLayerType(layerType: LayerType, provider: ProviderType, schema: SchemaField[]): string;
+declare function compileCustomAggregation(exp: string, opts: {
+    provider: ProviderType;
+}): string;
 /** @privateRemarks Source: Builder */
 declare function calculateClusterTextFontSize(radius: number): number;
 
@@ -821,6 +825,7 @@ type VisualChannelField = {
     name: string;
     type: string;
     colorColumn?: string;
+    accessorKey?: string;
 };
 type VisualChannels = {
     colorField?: VisualChannelField;
@@ -866,6 +871,8 @@ type VisConfig = {
     opacity?: number;
     enable3d?: boolean;
     colorAggregation?: string;
+    colorAggregationExp?: string;
+    colorAggregationDomain?: [number, number];
     colorRange: ColorRange;
     customMarkers?: boolean;
     customMarkersRange?: CustomMarkersRange | null;
@@ -873,14 +880,24 @@ type VisConfig = {
     radius: number;
     radiusRange?: number[];
     radiusAggregation?: string;
+    radiusAggregationExp?: string;
+    radiusAggregationDomain?: [number, number];
     sizeAggregation?: string;
+    sizeAggregationExp?: string;
+    sizeAggregationDomain?: [number, number];
     sizeRange?: number[];
     strokeColorAggregation?: string;
+    strokeColorAggregationExp?: string;
+    strokeColorAggregationDomain?: [number, number];
     strokeOpacity?: number;
     strokeColorRange?: ColorRange;
     heightRange?: number[];
     heightAggregation?: string;
+    heightAggregationExp?: string;
+    heightAggregationDomain?: [number, number];
     weightAggregation?: string;
+    weightAggregationExp?: string;
+    weightAggregationDomain?: [number, number];
     clusterLevel?: number;
     isTextVisible?: boolean;
     rasterStyleType?: 'Rgb' | 'ColorRange' | 'UniqueValues';
@@ -1060,7 +1077,7 @@ type Scale = {
     scaleDomain?: string[] | number[];
     range?: string[] | number[];
 };
-type ScaleKey = 'fillColor' | 'pointRadius' | 'lineColor' | 'elevation' | 'weight';
+type ScaleKey = 'fillColor' | 'pointRadius' | 'lineColor' | 'lineWidth' | 'elevation' | 'weight';
 type Scales = Partial<Record<ScaleKey, Scale>>;
 type LayerDescriptor = {
     type: LayerType;
@@ -2216,4 +2233,4 @@ declare function getColumnNameFromGeoColumn(geoColumn: string | null | undefined
  */
 declare function getSpatialIndexFromGeoColumn(geoColumn: string): SpatialIndex | null;
 
-export { type APIErrorContext, type APIRequestType, AUDIT_TAGS, type AddFilterOptions, type AggregationFunction, type AggregationType, AggregationTypes, type AggregationsRequestOptions, type AggregationsResponse, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CARTO_SOURCES, CartoAPIError, type CategoryOrderBy, type CategoryRequestOptions, type CategoryResponse, type CategoryResponseEntry, type CategoryResponseRaw, CellSet, type ColumnsOption, type D3Scale, DEFAULT_API_BASE_URL, type ExtentRequestOptions, type ExtentResponse, 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, OTHERS_CATEGORY_NAME, 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, SOURCE_DEFAULTS, type Scale, type ScaleKey, type ScaleType, type Scales, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SchemaField, SchemaFieldType, 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 TrajectoryQuerySourceOptions, type TrajectoryQuerySourceResponse, type TrajectoryTableSourceOptions, type TrajectoryTableSourceResponse, 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, ErrorCode as _ErrorCode, type VecExprResult as _VecExprResult, applyLayerGroupFilters as _applyLayerGroupFilters, _buildFeatureFilter, createVecExprEvaluator as _createVecExprEvaluator, domainFromValues as _domainFromValues, evaluateVecExpr as _evaluateVecExpr, fillInMapDatasets as _fillInMapDatasets, fillInTileStats as _fillInTileStats, _getHexagonResolution, getLog10ScaleSteps as _getLog10ScaleSteps, getRasterTileLayerStyleProps as _getRasterTileLayerStyleProps, validateVecExprSyntax as _validateVecExprSyntax, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, calculateClusterRadius, calculateClusterTextFontSize, calculateLayerScale, clearDefaultRequestCache, clearFilters, configureSource, createColorScale, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getDefaultAggregationExpColumnAliasForLayerType, getFilter, getIconUrlAccessor, getLayerDescriptor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSorter, 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, trajectoryQuerySource, trajectoryTableSource, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { type APIErrorContext, type APIRequestType, AUDIT_TAGS, type AddFilterOptions, type AggregationFunction, type AggregationType, AggregationTypes, type AggregationsRequestOptions, type AggregationsResponse, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CARTO_SOURCES, CartoAPIError, type CategoryOrderBy, type CategoryRequestOptions, type CategoryResponse, type CategoryResponseEntry, type CategoryResponseRaw, CellSet, type ColumnsOption, type D3Scale, DEFAULT_API_BASE_URL, type ExtentRequestOptions, type ExtentResponse, 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, OTHERS_CATEGORY_NAME, 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, SOURCE_DEFAULTS, type Scale, type ScaleKey, type ScaleType, type Scales, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SchemaField, SchemaFieldType, 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 TrajectoryQuerySourceOptions, type TrajectoryQuerySourceResponse, type TrajectoryTableSourceOptions, type TrajectoryTableSourceResponse, 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, ErrorCode as _ErrorCode, type VecExprResult as _VecExprResult, applyLayerGroupFilters as _applyLayerGroupFilters, _buildFeatureFilter, createVecExprEvaluator as _createVecExprEvaluator, domainFromValues as _domainFromValues, evaluateVecExpr as _evaluateVecExpr, fillInMapDatasets as _fillInMapDatasets, fillInTileStats as _fillInTileStats, _getHexagonResolution, getLog10ScaleSteps as _getLog10ScaleSteps, getRasterTileLayerStyleProps as _getRasterTileLayerStyleProps, validateVecExprSyntax as _validateVecExprSyntax, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, calculateClusterRadius, calculateClusterTextFontSize, calculateLayerScale, clearDefaultRequestCache, clearFilters, compileCustomAggregation, configureSource, createColorScale, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getDefaultAggregationExpColumnAliasForLayerType, getFilter, getIconUrlAccessor, getLayerDescriptor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSorter, 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, trajectoryQuerySource, trajectoryTableSource, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };

package/build/api-client.d.ts

@@ -775,16 +775,17 @@ declare function getLayerProps(type: LayerType, config: MapLayerConfig, dataset:
 };
 declare function domainFromValues(values: any, scaleType: ScaleType): any;
 declare function opacityToAlpha(opacity?: number): number;
-declare function getColorAccessor({ name, colorColumn }: VisualChannelField, scaleType: ScaleType, { aggregation, range }: {
+declare function getColorAccessor({ name, colorColumn, accessorKey }: VisualChannelField, scaleType: ScaleType, { aggregation, range, domainOverride, }: {
     aggregation?: string;
     range: ColorRange;
+    domainOverride?: [number, number];
 }, opacity: number | undefined, data: TilejsonResult): {
     accessor: any;
     domain: number[] | string[];
     scaleDomain: number[] | string[];
     range: string[];
 };
-declare function calculateLayerScale(name: string, scaleType: ScaleType, range: ColorRange, data: TilejsonResult): {
+declare function calculateLayerScale(name: string, scaleType: ScaleType, range: ColorRange, data: TilejsonResult, domainOverride?: [number, number]): {
     scale: D3Scale;
     domain: string[] | number[];
 };
@@ -797,7 +798,7 @@ declare function getIconUrlAccessor(field: VisualChannelField | null | undefined
 declare function getMaxMarkerSize(visConfig: VisConfig, visualChannels: VisualChannels): number;
 type Accessor = number | ((d: any, i: any) => number);
 declare function negateAccessor(accessor: Accessor): Accessor;
-declare function getSizeAccessor({ name }: VisualChannelField, scaleType: ScaleType | undefined, aggregation: string | null | undefined, range: number[] | undefined, data: TilejsonResult): {
+declare function getSizeAccessor({ name, accessorKey }: VisualChannelField, scaleType: ScaleType | undefined, aggregation: string | null | undefined, range: number[] | undefined, data: TilejsonResult, domainOverride?: [number, number]): {
     accessor: any;
     domain: number[];
     scaleDomain: number[];
@@ -814,6 +815,9 @@ declare function calculateClusterRadius(properties: {
 }>, radiusRange: [number, number], column: string): number;
 /** @privateRemarks Source: Builder */
 declare function getDefaultAggregationExpColumnAliasForLayerType(layerType: LayerType, provider: ProviderType, schema: SchemaField[]): string;
+declare function compileCustomAggregation(exp: string, opts: {
+    provider: ProviderType;
+}): string;
 /** @privateRemarks Source: Builder */
 declare function calculateClusterTextFontSize(radius: number): number;
 
@@ -821,6 +825,7 @@ type VisualChannelField = {
     name: string;
     type: string;
     colorColumn?: string;
+    accessorKey?: string;
 };
 type VisualChannels = {
     colorField?: VisualChannelField;
@@ -866,6 +871,8 @@ type VisConfig = {
     opacity?: number;
     enable3d?: boolean;
     colorAggregation?: string;
+    colorAggregationExp?: string;
+    colorAggregationDomain?: [number, number];
     colorRange: ColorRange;
     customMarkers?: boolean;
     customMarkersRange?: CustomMarkersRange | null;
@@ -873,14 +880,24 @@ type VisConfig = {
     radius: number;
     radiusRange?: number[];
     radiusAggregation?: string;
+    radiusAggregationExp?: string;
+    radiusAggregationDomain?: [number, number];
     sizeAggregation?: string;
+    sizeAggregationExp?: string;
+    sizeAggregationDomain?: [number, number];
     sizeRange?: number[];
     strokeColorAggregation?: string;
+    strokeColorAggregationExp?: string;
+    strokeColorAggregationDomain?: [number, number];
     strokeOpacity?: number;
     strokeColorRange?: ColorRange;
     heightRange?: number[];
     heightAggregation?: string;
+    heightAggregationExp?: string;
+    heightAggregationDomain?: [number, number];
     weightAggregation?: string;
+    weightAggregationExp?: string;
+    weightAggregationDomain?: [number, number];
     clusterLevel?: number;
     isTextVisible?: boolean;
     rasterStyleType?: 'Rgb' | 'ColorRange' | 'UniqueValues';
@@ -1060,7 +1077,7 @@ type Scale = {
     scaleDomain?: string[] | number[];
     range?: string[] | number[];
 };
-type ScaleKey = 'fillColor' | 'pointRadius' | 'lineColor' | 'elevation' | 'weight';
+type ScaleKey = 'fillColor' | 'pointRadius' | 'lineColor' | 'lineWidth' | 'elevation' | 'weight';
 type Scales = Partial<Record<ScaleKey, Scale>>;
 type LayerDescriptor = {
     type: LayerType;
@@ -2216,4 +2233,4 @@ declare function getColumnNameFromGeoColumn(geoColumn: string | null | undefined
  */
 declare function getSpatialIndexFromGeoColumn(geoColumn: string): SpatialIndex | null;
 
-export { type APIErrorContext, type APIRequestType, AUDIT_TAGS, type AddFilterOptions, type AggregationFunction, type AggregationType, AggregationTypes, type AggregationsRequestOptions, type AggregationsResponse, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CARTO_SOURCES, CartoAPIError, type CategoryOrderBy, type CategoryRequestOptions, type CategoryResponse, type CategoryResponseEntry, type CategoryResponseRaw, CellSet, type ColumnsOption, type D3Scale, DEFAULT_API_BASE_URL, type ExtentRequestOptions, type ExtentResponse, 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, OTHERS_CATEGORY_NAME, 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, SOURCE_DEFAULTS, type Scale, type ScaleKey, type ScaleType, type Scales, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SchemaField, SchemaFieldType, 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 TrajectoryQuerySourceOptions, type TrajectoryQuerySourceResponse, type TrajectoryTableSourceOptions, type TrajectoryTableSourceResponse, 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, ErrorCode as _ErrorCode, type VecExprResult as _VecExprResult, applyLayerGroupFilters as _applyLayerGroupFilters, _buildFeatureFilter, createVecExprEvaluator as _createVecExprEvaluator, domainFromValues as _domainFromValues, evaluateVecExpr as _evaluateVecExpr, fillInMapDatasets as _fillInMapDatasets, fillInTileStats as _fillInTileStats, _getHexagonResolution, getLog10ScaleSteps as _getLog10ScaleSteps, getRasterTileLayerStyleProps as _getRasterTileLayerStyleProps, validateVecExprSyntax as _validateVecExprSyntax, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, calculateClusterRadius, calculateClusterTextFontSize, calculateLayerScale, clearDefaultRequestCache, clearFilters, configureSource, createColorScale, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getDefaultAggregationExpColumnAliasForLayerType, getFilter, getIconUrlAccessor, getLayerDescriptor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSorter, 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, trajectoryQuerySource, trajectoryTableSource, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { type APIErrorContext, type APIRequestType, AUDIT_TAGS, type AddFilterOptions, type AggregationFunction, type AggregationType, AggregationTypes, type AggregationsRequestOptions, type AggregationsResponse, ApiVersion, type Attribute, _default as BASEMAP, type BaseRequestOptions, type Basemap, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CARTO_SOURCES, CartoAPIError, type CategoryOrderBy, type CategoryRequestOptions, type CategoryResponse, type CategoryResponseEntry, type CategoryResponseRaw, CellSet, type ColumnsOption, type D3Scale, DEFAULT_API_BASE_URL, type ExtentRequestOptions, type ExtentResponse, 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, OTHERS_CATEGORY_NAME, 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, SOURCE_DEFAULTS, type Scale, type ScaleKey, type ScaleType, type Scales, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SchemaField, SchemaFieldType, 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 TrajectoryQuerySourceOptions, type TrajectoryQuerySourceResponse, type TrajectoryTableSourceOptions, type TrajectoryTableSourceResponse, 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, ErrorCode as _ErrorCode, type VecExprResult as _VecExprResult, applyLayerGroupFilters as _applyLayerGroupFilters, _buildFeatureFilter, createVecExprEvaluator as _createVecExprEvaluator, domainFromValues as _domainFromValues, evaluateVecExpr as _evaluateVecExpr, fillInMapDatasets as _fillInMapDatasets, fillInTileStats as _fillInTileStats, _getHexagonResolution, getLog10ScaleSteps as _getLog10ScaleSteps, getRasterTileLayerStyleProps as _getRasterTileLayerStyleProps, validateVecExprSyntax as _validateVecExprSyntax, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, calculateClusterRadius, calculateClusterTextFontSize, calculateLayerScale, clearDefaultRequestCache, clearFilters, compileCustomAggregation, configureSource, createColorScale, createPolygonSpatialFilter, createViewportSpatialFilter, fetchBasemapProps, fetchMap, filterFunctions, geojsonFeatures, getApplicableFilters, getClient, getColorAccessor, getColumnNameFromGeoColumn, getDataFilterExtensionProps, getDefaultAggregationExpColumnAliasForLayerType, getFilter, getIconUrlAccessor, getLayerDescriptor, getLayerProps, getMaxMarkerSize, getSizeAccessor, getSorter, 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, trajectoryQuerySource, trajectoryTableSource, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };

package/build/api-client.js

@@ -9589,15 +9589,22 @@ function findAccessorKey(keys, properties) {
   }
   return keys;
 }
-function getColorAccessor({ name, colorColumn }, scaleType, { aggregation, range }, opacity, data) {
+function getColorAccessor({ name, colorColumn, accessorKey }, scaleType, {
+  aggregation,
+  range,
+  domainOverride
+}, opacity, data) {
+  const effectiveName = accessorKey ?? colorColumn ?? name;
+  const effectiveScaleType = colorColumn && !accessorKey ? "identity" : scaleType;
   const { scale: scale2, domain } = calculateLayerScale(
-    colorColumn || name,
-    colorColumn ? "identity" : scaleType,
+    effectiveName,
+    effectiveScaleType,
     range,
-    data
+    data,
+    domainOverride
   );
   const alpha = opacityToAlpha(opacity);
-  let accessorKeys = getAccessorKeys(colorColumn || name, aggregation);
+  let accessorKeys = accessorKey ? [accessorKey] : getAccessorKeys(colorColumn || name, aggregation);
   const accessor = (properties) => {
     if (!(accessorKeys[0] in properties)) {
       accessorKeys = findAccessorKey(accessorKeys, properties);
@@ -9614,11 +9621,11 @@ function getColorAccessor({ name, colorColumn }, scaleType, { aggregation, range
     range: (scale2.range() || []).map(rgbToHex)
   };
 }
-function calculateLayerScale(name, scaleType, range, data) {
+function calculateLayerScale(name, scaleType, range, data, domainOverride) {
   let scaleDomain;
   let scaleColors = [];
   const { colors } = range;
-  const domain = calculateDomain(data, name, scaleType, colors.length);
+  const domain = domainOverride && !range.colorMap ? domainOverride : calculateDomain(data, name, scaleType, colors.length);
   if (scaleType !== "identity") {
     if (range.colorMap) {
       const { colorMap } = range;
@@ -9703,19 +9710,20 @@ function negateAccessor(accessor) {
   }
   return -accessor;
 }
-function getSizeAccessor({ name }, scaleType, aggregation, range, data) {
+function getSizeAccessor({ name, accessorKey }, scaleType, aggregation, range, data, domainOverride) {
   const scale2 = scaleType ? SCALE_FUNCS[scaleType]() : identity2;
   let domain = [];
   if (scaleType && range) {
     if (aggregation !== AggregationTypes.Count) {
-      domain = calculateDomain(data, name, scaleType);
+      const source = accessorKey ?? name;
+      domain = domainOverride ?? calculateDomain(data, source, scaleType);
       scale2.domain(domain);
     } else {
       domain = scale2.domain();
     }
     scale2.range(range);
   }
-  let accessorKeys = getAccessorKeys(name, aggregation);
+  let accessorKeys = accessorKey ? [accessorKey] : getAccessorKeys(name, aggregation);
   const accessor = (properties) => {
     if (!(accessorKeys[0] in properties)) {
       accessorKeys = findAccessorKey(accessorKeys, properties);
@@ -9762,9 +9770,30 @@ function getDefaultAggregationExpColumnAliasForLayerType(layerType, provider, sc
     return DEFAULT_AGGREGATION_EXP_ALIAS;
   }
 }
+function hashString(input) {
+  let h = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    h ^= input.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return (h >>> 0).toString(16).padStart(8, "0");
+}
+function normalizeExpression(exp) {
+  return exp.trim().replace(/\s+/g, " ");
+}
+function applyProviderCase(alias, provider) {
+  return provider === "snowflake" ? alias.toUpperCase() : alias;
+}
 function getColumnAliasForAggregationExp(name, aggregation, provider) {
-  const columnAlias = `${name}_${aggregation}`;
-  return provider === "snowflake" ? columnAlias.toUpperCase() : columnAlias;
+  return applyProviderCase(`${name}_${aggregation}`, provider);
+}
+function compileCustomAggregation(exp, opts) {
+  const normalized = normalizeExpression(exp);
+  if (!normalized) {
+    throw new Error("Custom aggregation expression must not be empty");
+  }
+  const hash2 = hashString(normalized);
+  return applyProviderCase("custom_agg_" + hash2, opts.provider);
 }
 function getDefaultColumnFromSchemaForAggregationExp(schema) {
   return schema ? schema[0].name : "";
@@ -10288,6 +10317,26 @@ function createStyleProps(config2, mapping) {
   result.highlightColor = config2.visConfig.enable3d ? [255, 255, 255, 60] : [252, 242, 26, 255];
   return result;
 }
+function resolveCustomAggregation({
+  field,
+  aggregation,
+  expression,
+  domain,
+  providerId
+}) {
+  if (aggregation !== "custom") {
+    return { field, aggregation, domainOverride: void 0 };
+  }
+  if (!field || !expression?.trim()) {
+    return { field, aggregation: void 0, domainOverride: void 0 };
+  }
+  const alias = compileCustomAggregation(expression, { provider: providerId });
+  return {
+    field: { ...field, accessorKey: alias },
+    aggregation: void 0,
+    domainOverride: domain
+  };
+}
 function createChannelProps(id, layerType, config2, visualChannels, data, dataset) {
   if (layerType === "raster") {
     const rasterMetadata = data.raster_metadata;
@@ -10336,18 +10385,25 @@ function createChannelProps(id, layerType, config2, visualChannels, data, datase
   const scales = {};
   {
     const { colorField, colorScale } = visualChannels;
-    const { colorRange, colorAggregation } = visConfig;
-    if (colorField && colorScale && colorRange) {
+    const { colorRange } = visConfig;
+    const { field, aggregation, domainOverride } = resolveCustomAggregation({
+      field: colorField,
+      aggregation: visConfig.colorAggregation,
+      expression: visConfig.colorAggregationExp,
+      domain: visConfig.colorAggregationDomain,
+      providerId: dataset.providerId
+    });
+    if (field && colorScale && colorRange) {
       const { accessor, ...scaleProps } = getColorAccessor(
-        colorField,
+        field,
         colorScale,
-        { aggregation: colorAggregation, range: colorRange },
+        { aggregation, range: colorRange, domainOverride },
         visConfig.opacity,
         data
       );
       result.getFillColor = accessor;
       scales.fillColor = updateTriggers.getFillColor = {
-        field: colorField,
+        field,
         type: colorScale,
         ...scaleProps
       };
@@ -10407,40 +10463,54 @@ function createChannelProps(id, layerType, config2, visualChannels, data, datase
     };
   }
   {
-    const radiusRange = visConfig.radiusRange;
     const { radiusField, radiusScale } = visualChannels;
-    if (radiusField && radiusRange && radiusScale) {
+    const { radiusRange } = visConfig;
+    const { field, aggregation, domainOverride } = resolveCustomAggregation({
+      field: radiusField,
+      aggregation: visConfig.radiusAggregation,
+      expression: visConfig.radiusAggregationExp,
+      domain: visConfig.radiusAggregationDomain,
+      providerId: dataset.providerId
+    });
+    if (field && radiusRange && radiusScale) {
       const { accessor, ...scaleProps } = getSizeAccessor(
-        radiusField,
+        field,
         radiusScale,
-        visConfig.radiusAggregation,
+        aggregation,
         radiusRange,
-        data
+        data,
+        domainOverride
       );
       result.getPointRadius = accessor;
       scales.pointRadius = updateTriggers.getPointRadius = {
-        field: radiusField,
+        field,
         type: radiusScale,
         ...scaleProps
       };
     }
   }
   {
-    const strokeColorRange = visConfig.strokeColorRange;
     const { strokeColorScale, strokeColorField } = visualChannels;
-    if (strokeColorField && strokeColorRange && strokeColorScale) {
-      const { strokeColorAggregation: aggregation } = visConfig;
+    const { strokeColorRange } = visConfig;
+    const { field, aggregation, domainOverride } = resolveCustomAggregation({
+      field: strokeColorField,
+      aggregation: visConfig.strokeColorAggregation,
+      expression: visConfig.strokeColorAggregationExp,
+      domain: visConfig.strokeColorAggregationDomain,
+      providerId: dataset.providerId
+    });
+    if (field && strokeColorRange && strokeColorScale) {
       const opacity = visConfig.strokeOpacity !== void 0 ? visConfig.strokeOpacity : 1;
       const { accessor, ...scaleProps } = getColorAccessor(
-        strokeColorField,
+        field,
         strokeColorScale,
-        { aggregation, range: strokeColorRange },
+        { aggregation, range: strokeColorRange, domainOverride },
         opacity,
         data
       );
       result.getLineColor = accessor;
       scales.lineColor = updateTriggers.getLineColor = {
-        field: strokeColorField,
+        field,
         type: strokeColorScale,
         ...scaleProps
       };
@@ -10448,37 +10518,53 @@ function createChannelProps(id, layerType, config2, visualChannels, data, datase
   }
   {
     const { sizeField: strokeWidthField, sizeScale: strokeWidthScale } = visualChannels;
-    const { sizeRange, sizeAggregation } = visConfig;
-    if (strokeWidthField && sizeRange) {
+    const { sizeRange } = visConfig;
+    const { field, aggregation, domainOverride } = resolveCustomAggregation({
+      field: strokeWidthField,
+      aggregation: visConfig.sizeAggregation,
+      expression: visConfig.sizeAggregationExp,
+      domain: visConfig.sizeAggregationDomain,
+      providerId: dataset.providerId
+    });
+    if (field && sizeRange) {
       const { accessor, ...scaleProps } = getSizeAccessor(
-        strokeWidthField,
+        field,
         strokeWidthScale,
-        sizeAggregation,
+        aggregation,
         sizeRange,
-        data
+        data,
+        domainOverride
       );
       result.getLineWidth = accessor;
       scales.lineWidth = updateTriggers.getLineWidth = {
-        field: strokeWidthField,
+        field,
         type: strokeWidthScale || "identity",
         ...scaleProps
       };
     }
   }
   {
-    const { enable3d, heightRange } = visConfig;
     const { heightField, heightScale } = visualChannels;
-    if (heightField && heightRange && enable3d) {
+    const { enable3d, heightRange } = visConfig;
+    const { field, aggregation, domainOverride } = resolveCustomAggregation({
+      field: heightField,
+      aggregation: visConfig.heightAggregation,
+      expression: visConfig.heightAggregationExp,
+      domain: visConfig.heightAggregationDomain,
+      providerId: dataset.providerId
+    });
+    if (field && heightRange && enable3d) {
       const { accessor, ...scaleProps } = getSizeAccessor(
-        heightField,
+        field,
         heightScale,
-        visConfig.heightAggregation,
+        aggregation,
         heightRange,
-        data
+        data,
+        domainOverride
       );
       result.getElevation = accessor;
       scales.elevation = updateTriggers.getElevation = {
-        field: heightField,
+        field,
         type: heightScale || "identity",
         ...scaleProps
       };
@@ -10486,18 +10572,25 @@ function createChannelProps(id, layerType, config2, visualChannels, data, datase
   }
   {
     const { weightField } = visualChannels;
-    const { weightAggregation } = visConfig;
-    if (weightField && weightAggregation) {
+    const { field, aggregation, domainOverride } = resolveCustomAggregation({
+      field: weightField,
+      aggregation: visConfig.weightAggregation,
+      expression: visConfig.weightAggregationExp,
+      domain: visConfig.weightAggregationDomain,
+      providerId: dataset.providerId
+    });
+    if (field && (aggregation || visConfig.weightAggregation === "custom")) {
       const { accessor, ...scaleProps } = getSizeAccessor(
-        weightField,
+        field,
         void 0,
-        weightAggregation,
+        aggregation,
         void 0,
-        data
+        data,
+        domainOverride
       );
       result.getWeight = accessor;
       scales.weight = updateTriggers.getWeight = {
-        field: weightField,
+        field,
         type: "identity",
         ...scaleProps
       };
@@ -11293,6 +11386,7 @@ export {
   calculateLayerScale,
   clearDefaultRequestCache,
   clearFilters,
+  compileCustomAggregation,
   configureSource,
   createColorScale,
   createPolygonSpatialFilter,