@deck.gl/carto 9.0.23 → 9.0.24

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { default as ClusterTileLayer } from "./layers/cluster-tile-layer.js";
 import { default as H3TileLayer } from "./layers/h3-tile-layer.js";
 import { default as HeatmapTileLayer } from "./layers/heatmap-tile-layer.js";
 import { default as _PointLabelLayer } from "./layers/point-label-layer.js";
@@ -5,6 +6,7 @@ import { default as QuadbinTileLayer } from "./layers/quadbin-tile-layer.js";
 import { default as RasterTileLayer } from "./layers/raster-tile-layer.js";
 import { default as VectorTileLayer } from "./layers/vector-tile-layer.js";
 declare const CARTO_LAYERS: {
+    ClusterTileLayer: typeof ClusterTileLayer;
     H3TileLayer: typeof H3TileLayer;
     HeatmapTileLayer: typeof HeatmapTileLayer;
     _PointLabelLayer: typeof _PointLabelLayer;
@@ -12,7 +14,7 @@ declare const CARTO_LAYERS: {
     RasterTileLayer: typeof RasterTileLayer;
     VectorTileLayer: typeof VectorTileLayer;
 };
-export { CARTO_LAYERS, H3TileLayer, HeatmapTileLayer, _PointLabelLayer, QuadbinTileLayer, RasterTileLayer, VectorTileLayer };
+export { CARTO_LAYERS, ClusterTileLayer, H3TileLayer, HeatmapTileLayer, _PointLabelLayer, QuadbinTileLayer, RasterTileLayer, VectorTileLayer };
 export { default as BASEMAP, GOOGLE_BASEMAPS as _GOOGLE_BASEMAPS, getStyleUrl as _getStyleUrl, fetchStyle as _fetchStyle, applyLayerGroupFilters as _applyLayerGroupFilters, STYLE_LAYER_GROUPS as _STYLE_LAYER_GROUPS } from "./basemap.js";
 export { default as colorBins } from "./style/color-bins-style.js";
 export { default as colorCategories } from "./style/color-categories-style.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,kCAA+B;AAC9D,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,uCAAoC;AACxE,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,sCAAmC;AACvE,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,uCAAoC;AACxE,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,sCAAmC;AACtE,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,sCAAmC;AACtE,QAAA,MAAM,YAAY;;;;;;;CAOjB,CAAC;AACF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,CAAC;AAEF,OAAO,EACL,OAAO,IAAI,OAAO,EAClB,eAAe,IAAI,gBAAgB,EACnC,WAAW,IAAI,YAAY,EAC3B,UAAU,IAAI,WAAW,EACzB,sBAAsB,IAAI,uBAAuB,EACjD,kBAAkB,IAAI,mBAAmB,EAC1C,qBAAkB;AACnB,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,oCAAiC;AAC9D,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,0CAAuC;AAC1E,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,0CAAuC;AAC1E,OAAO,EAAC,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAC,uBAAoB;AAC3D,OAAO,EAAC,iBAAiB,EAAC,yBAAsB;AAChD,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,MAAM,EACN,OAAO,EACP,WAAW,EACX,eAAe,EACf,YAAY,EACZ,OAAO,IAAI,QAAQ,EACnB,eAAe,IAAI,gBAAgB,EACnC,aAAa,IAAI,cAAc,EAChC,uBAAoB;AAErB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAChB,2BAAwB;AAEzB,QAAA,MAAM,aAAa;;;;;;;;;;;;;CAalB,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,eAAe,EAChB,CAAC;AAEF,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC3B,2BAAwB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,uCAAoC;AACxE,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,kCAA+B;AAC9D,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,uCAAoC;AACxE,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,sCAAmC;AACvE,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,uCAAoC;AACxE,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,sCAAmC;AACtE,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,sCAAmC;AACtE,QAAA,MAAM,YAAY;;;;;;;;CAQjB,CAAC;AACF,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,CAAC;AAEF,OAAO,EACL,OAAO,IAAI,OAAO,EAClB,eAAe,IAAI,gBAAgB,EACnC,WAAW,IAAI,YAAY,EAC3B,UAAU,IAAI,WAAW,EACzB,sBAAsB,IAAI,uBAAuB,EACjD,kBAAkB,IAAI,mBAAmB,EAC1C,qBAAkB;AACnB,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,oCAAiC;AAC9D,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,0CAAuC;AAC1E,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,0CAAuC;AAC1E,OAAO,EAAC,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAC,uBAAoB;AAC3D,OAAO,EAAC,iBAAiB,EAAC,yBAAsB;AAChD,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,MAAM,EACN,OAAO,EACP,WAAW,EACX,eAAe,EACf,YAAY,EACZ,OAAO,IAAI,QAAQ,EACnB,eAAe,IAAI,gBAAgB,EACnC,aAAa,IAAI,cAAc,EAChC,uBAAoB;AAErB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAChB,2BAAwB;AAEzB,QAAA,MAAM,aAAa;;;;;;;;;;;;;CAalB,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,eAAe,EAChB,CAAC;AAEF,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC3B,2BAAwB"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { default as ClusterTileLayer } from "./layers/cluster-tile-layer.js";
 import { default as H3TileLayer } from "./layers/h3-tile-layer.js";
 import { default as HeatmapTileLayer } from "./layers/heatmap-tile-layer.js";
 import { default as _PointLabelLayer } from "./layers/point-label-layer.js";
@@ -5,6 +6,7 @@ import { default as QuadbinTileLayer } from "./layers/quadbin-tile-layer.js";
 import { default as RasterTileLayer } from "./layers/raster-tile-layer.js";
 import { default as VectorTileLayer } from "./layers/vector-tile-layer.js";
 const CARTO_LAYERS = {
+    ClusterTileLayer,
     H3TileLayer,
     HeatmapTileLayer,
     _PointLabelLayer,
@@ -12,7 +14,7 @@ const CARTO_LAYERS = {
     RasterTileLayer,
     VectorTileLayer
 };
-export { CARTO_LAYERS, H3TileLayer, HeatmapTileLayer, _PointLabelLayer, QuadbinTileLayer, RasterTileLayer, VectorTileLayer };
+export { CARTO_LAYERS, ClusterTileLayer, H3TileLayer, HeatmapTileLayer, _PointLabelLayer, QuadbinTileLayer, RasterTileLayer, VectorTileLayer };
 export { default as BASEMAP, GOOGLE_BASEMAPS as _GOOGLE_BASEMAPS, getStyleUrl as _getStyleUrl, fetchStyle as _fetchStyle, applyLayerGroupFilters as _applyLayerGroupFilters, STYLE_LAYER_GROUPS as _STYLE_LAYER_GROUPS } from "./basemap.js";
 export { default as colorBins } from "./style/color-bins-style.js";
 export { default as colorCategories } from "./style/color-categories-style.js";

package/dist/layers/cluster-tile-layer.d.ts

@@ -0,0 +1,41 @@
+import { GeoJsonLayerProps } from '@deck.gl/layers';
+import { TileLayerProps, TileLayerPickingInfo } from '@deck.gl/geo-layers';
+import type { Feature, Geometry } from 'geojson';
+import { Accessor, DefaultProps, CompositeLayer, Layer, LayersList, PickingInfo } from '@deck.gl/core';
+import { ClusteredFeaturePropertiesT, ParsedQuadbinCell, ParsedQuadbinTile } from "./cluster-utils.js";
+import type { TilejsonResult } from "../sources/types.js";
+export type ClusterTileLayerPickingInfo<FeaturePropertiesT = {}> = TileLayerPickingInfo<ParsedQuadbinTile<FeaturePropertiesT>, PickingInfo<Feature<Geometry, FeaturePropertiesT>>>;
+/** All properties supported by ClusterTileLayer. */
+export type ClusterTileLayerProps<FeaturePropertiesT = unknown> = _ClusterTileLayerProps<FeaturePropertiesT> & Omit<TileLayerProps<ParsedQuadbinTile<FeaturePropertiesT>>, 'data'>;
+/** Properties added by ClusterTileLayer. */
+type _ClusterTileLayerProps<FeaturePropertiesT> = Omit<GeoJsonLayerProps<ClusteredFeaturePropertiesT<FeaturePropertiesT>>, 'data'> & {
+    data: null | TilejsonResult | Promise<TilejsonResult>;
+    /**
+     * The number of aggregation levels to cluster cells by. Larger values increase
+     * the clustering radius, with an increment of `clusterLevel` doubling the radius.
+     *
+     * @default 5
+     */
+    clusterLevel?: number;
+    /**
+     * The (average) position of points in a cell used for clustering.
+     * If not supplied the center of the quadbin cell is used.
+     *
+     * @default cell center
+     */
+    getPosition?: Accessor<ParsedQuadbinCell<FeaturePropertiesT>, [number, number]>;
+    /**
+     * The weight of each cell used for clustering.
+     *
+     * @default 1
+     */
+    getWeight?: Accessor<ParsedQuadbinCell<FeaturePropertiesT>, number>;
+};
+export default class ClusterTileLayer<FeaturePropertiesT = any, ExtraProps extends {} = {}> extends CompositeLayer<ExtraProps & Required<_ClusterTileLayerProps<FeaturePropertiesT>>> {
+    static layerName: string;
+    static defaultProps: DefaultProps<ClusterTileLayerProps<unknown>>;
+    getLoadOptions(): any;
+    renderLayers(): Layer | null | LayersList;
+}
+export {};
+//# sourceMappingURL=cluster-tile-layer.d.ts.map

package/dist/layers/cluster-tile-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-tile-layer.d.ts","sourceRoot":"","sources":["../../src/layers/cluster-tile-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAGL,cAAc,EACd,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAC,OAAO,EAAE,QAAQ,EAAC,MAAM,SAAS,CAAC;AAE/C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EAGd,KAAK,EACL,UAAU,EACV,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,2BAA2B,EAI3B,iBAAiB,EACjB,iBAAiB,EAClB,2BAAwB;AAMzB,OAAO,KAAK,EAAC,cAAc,EAAC,4BAAyB;AAgBrD,MAAM,MAAM,2BAA2B,CAAC,kBAAkB,GAAG,EAAE,IAAI,oBAAoB,CACrF,iBAAiB,CAAC,kBAAkB,CAAC,EACrC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CACnD,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,CAAC,kBAAkB,GAAG,OAAO,IAC5D,sBAAsB,CAAC,kBAAkB,CAAC,GACxC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAExE,4CAA4C;AAC5C,KAAK,sBAAsB,CAAC,kBAAkB,IAAI,IAAI,CACpD,iBAAiB,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,CAAC,EAClE,MAAM,CACP,GAAG;IACF,IAAI,EAAE,IAAI,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhF;;;;OAIG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;CACrE,CAAC;AA6FF,MAAM,CAAC,OAAO,OAAO,gBAAgB,CACnC,kBAAkB,GAAG,GAAG,EACxB,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,cAAc,CAAC,UAAU,GAAG,QAAQ,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,SAAS,SAAsB;IACtC,MAAM,CAAC,YAAY,+CAAgB;IAEnC,cAAc,IAAI,GAAG;IAQrB,YAAY,IAAI,KAAK,GAAG,IAAI,GAAG,UAAU;CAiB1C"}

package/dist/layers/cluster-tile-layer.js

@@ -0,0 +1,116 @@
+import { GeoJsonLayer } from '@deck.gl/layers';
+import { TileLayer } from '@deck.gl/geo-layers';
+import { registerLoaders } from '@loaders.gl/core';
+import { binaryToGeojson } from '@loaders.gl/gis';
+import { CompositeLayer, _deepEqual as deepEqual } from '@deck.gl/core';
+import { aggregateTile, clustersToBinary, computeAggregationStats, extractAggregationProperties } from "./cluster-utils.js";
+import { DEFAULT_TILE_SIZE } from "../constants.js";
+import QuadbinTileset2D from "./quadbin-tileset-2d.js";
+import { getQuadbinPolygon } from "./quadbin-utils.js";
+import CartoSpatialTileLoader from "./schema/carto-spatial-tile-loader.js";
+import { injectAccessToken, TilejsonPropType } from "./utils.js";
+registerLoaders([CartoSpatialTileLoader]);
+const defaultProps = {
+    data: TilejsonPropType,
+    clusterLevel: { type: 'number', value: 5, min: 1 },
+    getPosition: {
+        type: 'accessor',
+        value: ({ id }) => getQuadbinPolygon(id, 0.5).slice(2, 4)
+    },
+    getWeight: { type: 'accessor', value: 1 },
+    refinementStrategy: 'no-overlap',
+    tileSize: DEFAULT_TILE_SIZE
+};
+class ClusterGeoJsonLayer extends TileLayer {
+    static { this.layerName = 'ClusterGeoJsonLayer'; }
+    static { this.defaultProps = defaultProps; }
+    renderLayers() {
+        const visibleTiles = this.state.tileset?.tiles.filter((tile) => {
+            return tile.isLoaded && tile.content && this.state.tileset.isTileVisible(tile);
+        });
+        if (!visibleTiles?.length) {
+            return null;
+        }
+        visibleTiles.sort((a, b) => b.zoom - a.zoom);
+        const { zoom } = this.context.viewport;
+        const { clusterLevel, getPosition, getWeight } = this.props;
+        const properties = extractAggregationProperties(visibleTiles[0]);
+        const data = [];
+        for (const tile of visibleTiles) {
+            // Calculate aggregation based on viewport zoom
+            const overZoom = Math.round(zoom - tile.zoom);
+            const aggregationLevels = Math.round(clusterLevel) - overZoom;
+            aggregateTile(tile, aggregationLevels, properties, getPosition, getWeight);
+            data.push(...tile.userData[aggregationLevels]);
+        }
+        data.sort((a, b) => Number(b.count - a.count));
+        const clusterIds = data?.map((tile) => tile.id);
+        const needsUpdate = !deepEqual(clusterIds, this.state.clusterIds, 1);
+        this.setState({ clusterIds });
+        if (needsUpdate) {
+            const stats = computeAggregationStats(data, properties);
+            for (const d of data) {
+                d.stats = stats;
+            }
+            this.setState({ data: clustersToBinary(data) });
+        }
+        const props = {
+            ...this.props,
+            id: 'clusters',
+            data: this.state.data,
+            dataComparator: (data, oldData) => {
+                const newIds = data?.points?.properties?.map((tile) => tile.id);
+                const oldIds = oldData?.points?.properties?.map((tile) => tile.id);
+                return deepEqual(newIds, oldIds, 1);
+            }
+        };
+        return new GeoJsonLayer(this.getSubLayerProps(props));
+    }
+    getPickingInfo(params) {
+        const info = params.info;
+        if (info.index !== -1) {
+            const { data } = params.sourceLayer.props;
+            info.object = binaryToGeojson(data, {
+                globalFeatureId: info.index
+            });
+        }
+        return info;
+    }
+    _updateAutoHighlight(info) {
+        for (const layer of this.getSubLayers()) {
+            layer.updateAutoHighlight(info);
+        }
+    }
+    filterSubLayer() {
+        return true;
+    }
+}
+// Adapter layer around ClusterLayer that converts tileJSON into TileLayer API
+export default class ClusterTileLayer extends CompositeLayer {
+    static { this.layerName = 'ClusterTileLayer'; }
+    static { this.defaultProps = defaultProps; }
+    getLoadOptions() {
+        const loadOptions = super.getLoadOptions() || {};
+        const tileJSON = this.props.data;
+        injectAccessToken(loadOptions, tileJSON.accessToken);
+        loadOptions.cartoSpatialTile = { ...loadOptions.cartoSpatialTile, scheme: 'quadbin' };
+        return loadOptions;
+    }
+    renderLayers() {
+        const tileJSON = this.props.data;
+        if (!tileJSON)
+            return null;
+        const { tiles: data, maxresolution: maxZoom } = tileJSON;
+        return [
+            // @ts-ignore
+            new ClusterGeoJsonLayer(this.props, {
+                id: `cluster-geojson-layer-${this.props.id}`,
+                data,
+                // TODO: Tileset2D should be generic over TileIndex type
+                TilesetClass: QuadbinTileset2D,
+                maxZoom,
+                loadOptions: this.getLoadOptions()
+            })
+        ];
+    }
+}

package/dist/layers/cluster-utils.d.ts

@@ -0,0 +1,30 @@
+import { _Tile2DHeader as Tile2DHeader } from '@deck.gl/geo-layers';
+import { Accessor } from '@deck.gl/core';
+import { BinaryFeatureCollection } from '@loaders.gl/schema';
+export type Aggregation = 'any' | 'average' | 'count' | 'min' | 'max' | 'sum';
+export type AggregationProperties<FeaturePropertiesT> = {
+    aggregation: Aggregation;
+    name: keyof FeaturePropertiesT;
+}[];
+export type ClusteredFeaturePropertiesT<FeaturePropertiesT> = FeaturePropertiesT & {
+    id: bigint;
+    count: number;
+    position: [number, number];
+    stats: Record<keyof FeaturePropertiesT, {
+        min: number;
+        max: number;
+    }>;
+};
+export type ParsedQuadbinCell<FeaturePropertiesT> = {
+    id: bigint;
+    properties: FeaturePropertiesT;
+};
+export type ParsedQuadbinTile<FeaturePropertiesT> = ParsedQuadbinCell<FeaturePropertiesT>[];
+export declare function aggregateTile<FeaturePropertiesT>(tile: Tile2DHeader<ParsedQuadbinTile<FeaturePropertiesT>>, aggregationLevels: number, properties: AggregationProperties<FeaturePropertiesT> | undefined, getPosition: Accessor<ParsedQuadbinCell<FeaturePropertiesT>, [number, number]>, getWeight: Accessor<ParsedQuadbinCell<FeaturePropertiesT>, number>): void;
+export declare function extractAggregationProperties<FeaturePropertiesT extends {}>(tile: Tile2DHeader<ParsedQuadbinTile<FeaturePropertiesT>>): AggregationProperties<FeaturePropertiesT>;
+export declare function computeAggregationStats<FeaturePropertiesT>(data: ClusteredFeaturePropertiesT<FeaturePropertiesT>[], properties: AggregationProperties<FeaturePropertiesT>): Record<keyof FeaturePropertiesT, {
+    min: number;
+    max: number;
+}>;
+export declare function clustersToBinary<FeaturePropertiesT>(data: ClusteredFeaturePropertiesT<FeaturePropertiesT>[]): BinaryFeatureCollection;
+//# sourceMappingURL=cluster-utils.d.ts.map

package/dist/layers/cluster-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-utils.d.ts","sourceRoot":"","sources":["../../src/layers/cluster-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC9E,MAAM,MAAM,qBAAqB,CAAC,kBAAkB,IAAI;IACtD,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,kBAAkB,CAAC;CAChC,EAAE,CAAC;AACJ,MAAM,MAAM,2BAA2B,CAAC,kBAAkB,IAAI,kBAAkB,GAAG;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,kBAAkB,EAAE;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CACrE,CAAC;AACF,MAAM,MAAM,iBAAiB,CAAC,kBAAkB,IAAI;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,kBAAkB,CAAA;CAAC,CAAC;AACjG,MAAM,MAAM,iBAAiB,CAAC,kBAAkB,IAAI,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC;AAE5F,wBAAgB,aAAa,CAAC,kBAAkB,EAC9C,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,EACzD,iBAAiB,EAAE,MAAM,EACzB,UAAU,uDAAgD,EAC1D,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC9E,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,GACjE,IAAI,CAyDN;AAED,wBAAgB,4BAA4B,CAAC,kBAAkB,SAAS,EAAE,EACxE,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,GACxD,qBAAqB,CAAC,kBAAkB,CAAC,CAY3C;AAED,wBAAgB,uBAAuB,CAAC,kBAAkB,EACxD,IAAI,EAAE,2BAA2B,CAAC,kBAAkB,CAAC,EAAE,EACvD,UAAU,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;SAEM,MAAM;SAAO,MAAM;GAY/E;AAWD,wBAAgB,gBAAgB,CAAC,kBAAkB,EACjD,IAAI,EAAE,2BAA2B,CAAC,kBAAkB,CAAC,EAAE,GACtD,uBAAuB,CA8BzB"}

package/dist/layers/cluster-utils.js

@@ -0,0 +1,122 @@
+import { cellToParent } from 'quadbin';
+export function aggregateTile(tile, aggregationLevels, properties = [], getPosition, getWeight) {
+    if (!tile.content)
+        return;
+    // Aggregate on demand and cache result
+    if (!tile.userData)
+        tile.userData = {};
+    if (tile.userData[aggregationLevels])
+        return;
+    const out = {};
+    for (const cell of tile.content) {
+        let id = cell.id;
+        const position = typeof getPosition === 'function' ? getPosition(cell, {}) : getPosition;
+        // Aggregate by parent id
+        for (let i = 0; i < aggregationLevels - 1; i++) {
+            id = cellToParent(id);
+        }
+        // Unfortunately TS doesn't support Record<bigint, any>
+        // https://github.com/microsoft/TypeScript/issues/46395
+        const parentId = Number(id);
+        if (!(parentId in out)) {
+            out[parentId] = { id, count: 0, position: [0, 0] };
+            for (const { name, aggregation } of properties) {
+                if (aggregation === 'any') {
+                    // Just pick first value for ANY
+                    out[parentId][name] = cell.properties[name];
+                }
+                else {
+                    out[parentId][name] = 0;
+                }
+            }
+        }
+        // Layout props
+        const prevTotalW = out[parentId].count;
+        out[parentId].count += typeof getWeight === 'function' ? getWeight(cell, {}) : getWeight;
+        const totalW = out[parentId].count;
+        const W = totalW - prevTotalW;
+        out[parentId].position[0] = (prevTotalW * out[parentId].position[0] + W * position[0]) / totalW;
+        out[parentId].position[1] = (prevTotalW * out[parentId].position[1] + W * position[1]) / totalW;
+        // Re-aggregate other properties so clusters can be styled
+        for (const { name, aggregation } of properties) {
+            const prevValue = out[parentId][name];
+            const value = cell.properties[name];
+            if (aggregation === 'average') {
+                out[parentId][name] = (prevTotalW * prevValue + W * value) / totalW;
+            }
+            else if (aggregation === 'count' || aggregation === 'sum') {
+                out[parentId][name] = prevValue + value;
+            }
+            else if (aggregation === 'max') {
+                out[parentId][name] = Math.max(prevValue, value);
+            }
+            else if (aggregation === 'min') {
+                out[parentId][name] = Math.min(prevValue, value);
+            }
+        }
+    }
+    tile.userData[aggregationLevels] = Object.values(out);
+}
+export function extractAggregationProperties(tile) {
+    const properties = [];
+    const validAggregations = ['any', 'average', 'count', 'min', 'max', 'sum'];
+    for (const name of Object.keys(tile.content[0].properties)) {
+        let aggregation = name.split('_').pop().toLowerCase();
+        if (!validAggregations.includes(aggregation)) {
+            aggregation = 'any';
+        }
+        properties.push({ name: name, aggregation });
+    }
+    return properties;
+}
+export function computeAggregationStats(data, properties) {
+    const stats = {};
+    for (const { name, aggregation } of properties) {
+        stats[name] = { min: Infinity, max: -Infinity };
+        if (aggregation !== 'any') {
+            for (const d of data) {
+                stats[name].min = Math.min(stats[name].min, d[name]);
+                stats[name].max = Math.max(stats[name].max, d[name]);
+            }
+        }
+    }
+    return stats;
+}
+const EMPTY_UINT16ARRAY = new Uint16Array();
+const EMPTY_BINARY_PROPS = {
+    positions: { value: new Float32Array(), size: 2 },
+    properties: [],
+    numericProps: {},
+    featureIds: { value: EMPTY_UINT16ARRAY, size: 1 },
+    globalFeatureIds: { value: EMPTY_UINT16ARRAY, size: 1 }
+};
+export function clustersToBinary(data) {
+    const positions = new Float32Array(data.length * 2);
+    const featureIds = new Uint16Array(data.length);
+    for (let i = 0; i < data.length; i++) {
+        positions.set(data[i].position, 2 * i);
+        featureIds[i] = i;
+    }
+    return {
+        shape: 'binary-feature-collection',
+        points: {
+            type: 'Point',
+            positions: { value: positions, size: 2 },
+            properties: data,
+            numericProps: {},
+            featureIds: { value: featureIds, size: 1 },
+            globalFeatureIds: { value: featureIds, size: 1 }
+        },
+        lines: {
+            type: 'LineString',
+            pathIndices: { value: EMPTY_UINT16ARRAY, size: 1 },
+            ...EMPTY_BINARY_PROPS
+        },
+        polygons: {
+            type: 'Polygon',
+            polygonIndices: { value: EMPTY_UINT16ARRAY, size: 1 },
+            primitivePolygonIndices: { value: EMPTY_UINT16ARRAY, size: 1 },
+            ...EMPTY_BINARY_PROPS
+        }
+    };
+}

package/dist/layers/schema/carto-raster-tile-loader.js

@@ -1,7 +1,7 @@
 import { TileReader } from "./carto-raster-tile.js";
 import { parsePbf } from "./tile-loader-utils.js";
 import { getWorkerUrl } from "../../utils.js";
-const VERSION = typeof "9.0.23" !== 'undefined' ? "9.0.23" : 'latest';
+const VERSION = typeof "9.0.24" !== 'undefined' ? "9.0.24" : 'latest';
 const id = 'cartoRasterTile';
 const DEFAULT_OPTIONS = {
     cartoRasterTile: {

package/dist/layers/schema/carto-spatial-tile-loader.js

@@ -2,7 +2,7 @@ import { TileReader } from "./carto-spatial-tile.js";
 import { parsePbf } from "./tile-loader-utils.js";
 import { getWorkerUrl } from "../../utils.js";
 import { binaryToSpatialjson } from "./spatialjson-utils.js";
-const VERSION = typeof "9.0.23" !== 'undefined' ? "9.0.23" : 'latest';
+const VERSION = typeof "9.0.24" !== 'undefined' ? "9.0.24" : 'latest';
 const id = 'cartoSpatialTile';
 const DEFAULT_OPTIONS = {
     cartoSpatialTile: {

package/dist/layers/schema/carto-vector-tile-loader.js

@@ -2,7 +2,7 @@ import earcut from 'earcut';
 import { TileReader } from "./carto-tile.js";
 import { parsePbf } from "./tile-loader-utils.js";
 import { getWorkerUrl } from "../../utils.js";
-const VERSION = typeof "9.0.23" !== 'undefined' ? "9.0.23" : 'latest';
+const VERSION = typeof "9.0.24" !== 'undefined' ? "9.0.24" : 'latest';
 const id = 'cartoVectorTile';
 const DEFAULT_OPTIONS = {
     cartoVectorTile: {

package/dist/style/color-bins-style.d.ts

@@ -1,6 +1,5 @@
-import { AccessorFunction } from '@deck.gl/core';
+import { AccessorFunction, Color } from '@deck.gl/core';
 import { Feature } from 'geojson';
-import { Color } from "./palette.js";
 import { AttributeSelector } from "./utils.js";
 /**
  * Helper function for quickly creating a color bins style based on `d3` `scaleThreshold`.

package/dist/style/color-bins-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-bins-style.d.ts","sourceRoot":"","sources":["../../src/style/color-bins-style.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAChC,OAAmB,EAAC,KAAK,EAA8B,qBAAkB;AAEzE,OAAO,EAAC,iBAAiB,EAAe,mBAAgB;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAK,GAAG,OAAO,EAAE,EACjD,IAAI,EACJ,MAAM,EACN,MAAwB,EACxB,SAAsB,EACvB,EAAE;IACD,2CAA2C;IAC3C,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvC,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAE1B,uDAAuD;IACvD,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAWjC"}
+{"version":3,"file":"color-bins-style.d.ts","sourceRoot":"","sources":["../../src/style/color-bins-style.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAE,KAAK,EAAC,MAAM,eAAe,CAAC;AACtD,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAC,iBAAiB,EAAe,mBAAgB;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAK,GAAG,OAAO,EAAE,EACjD,IAAI,EACJ,MAAM,EACN,MAAwB,EACxB,SAAsB,EACvB,EAAE;IACD,2CAA2C;IAC3C,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvC,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAE1B,uDAAuD;IACvD,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAWjC"}

package/dist/style/color-categories-style.d.ts

@@ -1,6 +1,5 @@
-import { AccessorFunction } from '@deck.gl/core';
+import { AccessorFunction, Color } from '@deck.gl/core';
 import { Feature } from 'geojson';
-import { Color } from "./palette.js";
 import { AttributeSelector } from "./utils.js";
 /**
  * Helper function for quickly creating a color category style.

package/dist/style/color-categories-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-categories-style.d.ts","sourceRoot":"","sources":["../../src/style/color-categories-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAChC,OAAmB,EAAC,KAAK,EAA4C,qBAAkB;AAEvF,OAAO,EAAC,iBAAiB,EAAe,mBAAgB;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,EACvD,IAAI,EACJ,MAAM,EACN,MAAwB,EACxB,SAAsB,EACtB,WAA0B,EAC3B,EAAE;IACD,0CAA0C;IAC1C,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAEzD,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAEzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB,sFAAsF;IACtF,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAgBjC"}
+{"version":3,"file":"color-categories-style.d.ts","sourceRoot":"","sources":["../../src/style/color-categories-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,KAAK,EAAC,MAAM,eAAe,CAAC;AACtD,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAC,iBAAiB,EAAe,mBAAgB;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,EACvD,IAAI,EACJ,MAAM,EACN,MAAwB,EACxB,SAAsB,EACtB,WAA0B,EAC3B,EAAE;IACD,0CAA0C;IAC1C,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAEzD,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAEzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB,sFAAsF;IACtF,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAgBjC"}

package/dist/style/color-continuous-style.d.ts

@@ -1,6 +1,5 @@
-import { AccessorFunction } from '@deck.gl/core';
+import { AccessorFunction, Color } from '@deck.gl/core';
 import { Feature } from 'geojson';
-import { Color } from "./palette.js";
 import { AttributeSelector } from "./utils.js";
 /**
  * Helper function for quickly creating a color continuous style.

package/dist/style/color-continuous-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-continuous-style.d.ts","sourceRoot":"","sources":["../../src/style/color-continuous-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAChC,OAAmB,EAAC,KAAK,EAA8B,qBAAkB;AAEzE,OAAO,EAAC,iBAAiB,EAAe,mBAAgB;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,EACvD,IAAI,EACJ,MAAM,EACN,MAAwB,EACxB,SAAsB,EACvB,EAAE;IACD,2CAA2C;IAC3C,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvC,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAE1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAUjC"}
+{"version":3,"file":"color-continuous-style.d.ts","sourceRoot":"","sources":["../../src/style/color-continuous-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,KAAK,EAAC,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAC,iBAAiB,EAAe,mBAAgB;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,EACvD,IAAI,EACJ,MAAM,EACN,MAAwB,EACxB,SAAsB,EACvB,EAAE;IACD,2CAA2C;IAC3C,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvC,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAE1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAUjC"}

package/dist/style/palette.d.ts

@@ -1,4 +1,4 @@
-export type Color = [r: number, b: number, g: number, a?: number];
+import { Color } from '@deck.gl/core';
 export declare const DEFAULT_PALETTE = "PurpOr";
 export declare const NULL_COLOR: Color;
 export declare const OTHERS_COLOR: Color;

package/dist/style/palette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/style/palette.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,UAAU,EAAE,KAAuB,CAAC;AACjD,eAAO,MAAM,YAAY,EAAE,KAAuB,CAAC;AAOnD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,KAAK,EAAE,CA0B/E;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CA2C3C"}
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/style/palette.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,EAAC,MAAM,eAAe,CAAC;AAEpC,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,UAAU,EAAE,KAAuB,CAAC;AACjD,eAAO,MAAM,YAAY,EAAE,KAAuB,CAAC;AAOnD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,KAAK,EAAE,CA0B/E;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CA2C3C"}