@carto/api-client 0.5.13 → 0.5.15-alpha.raster-0

package/package.json

@@ -8,7 +8,7 @@
   "homepage": "https://github.com/CartoDB/carto-api-client#readme",
   "author": "Don McCurdy <donmccurdy@carto.com>",
   "packageManager": "yarn@4.3.1",
-  "version": "0.5.13",
+  "version": "0.5.15-alpha.raster-0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -71,6 +71,7 @@
     "d3-format": "^3.1.0",
     "d3-scale": "^4.0.2",
     "h3-js": "^4.1.0",
+    "jsep": "^1.4.0",
     "quadbin": "^0.4.1-alpha.0"
   },
   "devDependencies": {
@@ -125,11 +126,12 @@
     "tsup": "^8.3.6",
     "typescript": "~5.8.2",
     "typescript-eslint": "^8.26.1",
-    "vite": "^6.2.2",
-    "vitest": "3.2.3"
+    "vite": "^7.0.0",
+    "vitest": "3.2.4"
   },
   "resolutions": {
     "@carto/api-client": "portal:./",
     "rollup": "^4.20.0"
-  }
+  },
+  "stableVersion": "0.5.14"
 }

package/src/fetch-map/index.ts

@@ -1,4 +1,5 @@
 export {default as BASEMAP} from './basemap-styles.js';
+export {getRasterTileLayerStyleProps as _getRasterTileLayerStyleProps} from './raster-layer.js';
 export {fetchMap} from './fetch-map.js';
 export type {FetchMapOptions, FetchMapResult} from './fetch-map.js';
 export type {

package/src/fetch-map/layer-map.ts

@@ -28,6 +28,7 @@ import {
   scaleIdentity,
 } from './utils.js';
 import type {
+  ColorRange,
   CustomMarkersRange,
   Dataset,
   MapLayerConfig,
@@ -38,6 +39,7 @@ import type {
 import type {ProviderType, SchemaField} from '../types.js';
 import {DEFAULT_AGGREGATION_EXP_ALIAS} from '../constants-internal.js';
 import {AggregationTypes} from '../constants.js';
+import type {TilejsonResult} from '../sources/types.js';
 
 export type D3Scale = {
   domain: (d?: any) => any[];
@@ -113,6 +115,13 @@ const sharedPropMap = {
   },
 };
 
+const rasterPropsMap = {
+  isVisible: 'visible',
+  visConfig: {
+    opacity: 'opacity',
+  },
+};
+
 const customMarkersPropsMap = {
   color: 'getIconColor',
   visConfig: {
@@ -174,6 +183,13 @@ export function getLayerProps(
     );
   }
 
+  if (type === 'raster') {
+    return {
+      propMap: rasterPropsMap,
+      defaultProps: {},
+    };
+  }
+
   let basePropMap: any = sharedPropMap;
   if (config.visConfig?.customMarkers) {
     basePropMap = mergePropMaps(basePropMap, customMarkersPropsMap);
@@ -200,6 +216,9 @@ function domainFromAttribute(
   scaleLength: number
 ) {
   if (scaleType === 'ordinal' || scaleType === 'point') {
+    if (!attribute.categories) {
+      return [0, 1];
+    }
     return attribute.categories
       .map((c: any) => c.category)
       .filter((c: any) => c !== undefined && c !== null);
@@ -235,8 +254,8 @@ function domainFromValues(values: any, scaleType: ScaleType) {
 }
 
 function calculateDomain(
-  data: any,
-  name: any,
+  data: TilejsonResult,
+  name: string,
   scaleType: ScaleType,
   scaleLength?: number
 ) {
@@ -251,7 +270,7 @@ function calculateDomain(
 }
 
 function normalizeAccessor(accessor: any, data: any) {
-  if (data.features || data.tilestats) {
+  if (data.features || data.tilestats || data.raster_metadata) {
     return (object: any, info: any) => {
       if (object) {
         return accessor(object.properties || object.__source.object.properties);
@@ -321,14 +340,13 @@ export function getColorAccessor(
   return {accessor: normalizeAccessor(accessor, data), scale};
 }
 
-function calculateLayerScale(
-  name: any,
+export function calculateLayerScale(
+  name: string,
   scaleType: ScaleType,
-  range: any,
-  data: any
+  range: ColorRange,
+  data: TilejsonResult
 ) {
-  const scale = SCALE_FUNCS[scaleType]();
-  let domain: (string | number)[] = [];
+  let domain: string[] | number[] = [];
   let scaleColor: string[] = [];
 
   if (scaleType !== 'identity') {
@@ -336,7 +354,7 @@ function calculateLayerScale(
 
     if (Array.isArray(colorMap)) {
       colorMap.forEach(([value, color]) => {
-        domain.push(value);
+        (domain as string[]).push(value);
         scaleColor.push(color);
       });
     } else {
@@ -349,9 +367,19 @@ function calculateLayerScale(
     }
   }
 
+  return createColorScale(scaleType, domain, scaleColor, UNKNOWN_COLOR);
+}
+
+export function createColorScale<T>(
+  scaleType: ScaleType,
+  domain: string[] | number[],
+  range: T[],
+  unknown: T
+) {
+  const scale = SCALE_FUNCS[scaleType]();
   scale.domain(domain);
-  scale.range(scaleColor);
-  scale.unknown!(UNKNOWN_COLOR);
+  scale.range(range);
+  scale.unknown!(unknown as any);
 
   return scale;
 }

package/src/fetch-map/parse-map.ts

@@ -32,6 +32,10 @@ import type {
   VisualChannelField,
 } from './types.js';
 import {isRemoteCalculationSupported} from './utils.js';
+import {
+  getRasterTileLayerStylePropsRgb,
+  getRasterTileLayerStylePropsScaledBand,
+} from './raster-layer.js';
 
 export type Scale = {
   field: VisualChannelField;
@@ -40,11 +44,18 @@ export type Scale = {
   type: ScaleType;
 };
 
+export type ScaleKey =
+  | 'fillColor'
+  | 'pointRadius'
+  | 'lineColor'
+  | 'elevation'
+  | 'weight';
+
 export type LayerDescriptor = {
   type: LayerType;
   props: Record<string, any>;
   filters?: Filters;
-  scales: Record<ScaleKey, Scale>;
+  scales: Partial<Record<ScaleKey, Scale>>;
 };
 
 export type ParseMapResult = {
@@ -68,13 +79,62 @@ export type ParseMapResult = {
   layers: LayerDescriptor[];
 };
 
+export function getLayerDescriptor({
+  mapConfig,
+  layer,
+  dataset,
+}: {
+  mapConfig: KeplerMapConfig;
+  layer: MapConfigLayer;
+  dataset: Dataset;
+}) {
+  const {filters, visState} = mapConfig;
+  const {layerBlending, interactionConfig} = visState;
+  const {id, type, config, visualChannels} = layer;
+  const {data, id: datasetId} = dataset;
+
+  const {propMap, defaultProps} = getLayerProps(type, config, dataset);
+
+  const styleProps = createStyleProps(config, propMap);
+
+  const {channelProps, scales} = createChannelProps(
+    id,
+    type,
+    config,
+    visualChannels,
+    data,
+    dataset
+  );
+  const layerDescriptor: LayerDescriptor = {
+    type,
+    filters:
+      isEmptyObject(filters) || isRemoteCalculationSupported(dataset)
+        ? undefined
+        : filters[datasetId],
+    props: {
+      id,
+      data,
+      ...defaultProps,
+      ...createInteractionProps(interactionConfig),
+      ...styleProps,
+      ...channelProps,
+      ...createParametersProp(layerBlending, styleProps.parameters || {}), // Must come after style
+      ...createLoadOptions(data.accessToken),
+    },
+    scales,
+  };
+  return layerDescriptor;
+}
+
 export function parseMap(json: any) {
   const {keplerMapConfig, datasets, token} = json;
   assert(keplerMapConfig.version === 'v1', 'Only support Kepler v1');
-  const config = keplerMapConfig.config as KeplerMapConfig;
-  const {filters, mapState, mapStyle, popupSettings, legendSettings} = config;
-  const {layers, layerBlending, interactionConfig} = config.visState;
+  const mapConfig = keplerMapConfig.config as KeplerMapConfig;
+  const {mapState, mapStyle, popupSettings, legendSettings, visState} =
+    mapConfig;
+  const {layers} = visState;
 
+  const layersReverse = [...layers].reverse();
   return {
     id: json.id,
     title: json.title,
@@ -87,57 +147,24 @@ export function parseMap(json: any) {
     popupSettings,
     legendSettings,
     token,
-    layers: layers
-      .reverse()
-      .map(({id, type, config, visualChannels}: MapConfigLayer) => {
-        try {
-          const {dataId} = config;
-          const dataset: Dataset | null = datasets.find(
-            (d: any) => d.id === dataId
-          );
-          assert(dataset, `No dataset matching dataId: ${dataId}`);
-          const {data} = dataset;
-          assert(data, `No data loaded for dataId: ${dataId}`);
-
-          const {propMap, defaultProps} = getLayerProps(type, config, dataset);
-
-          const styleProps = createStyleProps(config, propMap);
-
-          const {channelProps, scales} = createChannelProps(
-            id,
-            type,
-            config,
-            visualChannels,
-            data,
-            dataset
-          );
-          const layer: LayerDescriptor = {
-            type,
-            filters:
-              isEmptyObject(filters) || isRemoteCalculationSupported(dataset)
-                ? undefined
-                : filters[dataId],
-            props: {
-              id,
-              data,
-              ...defaultProps,
-              ...createInteractionProps(interactionConfig),
-              ...styleProps,
-              ...channelProps,
-              ...createParametersProp(
-                layerBlending,
-                styleProps.parameters || {}
-              ), // Must come after style
-              ...createLoadOptions(token),
-            },
-            scales,
-          };
-          return layer;
-        } catch (e: any) {
-          console.error(e.message);
-          return undefined;
-        }
-      }),
+    layers: layersReverse.map((layer: MapConfigLayer) => {
+      try {
+        const {dataId} = layer.config;
+        const dataset: Dataset | null = datasets.find(
+          (d: any) => d.id === dataId
+        );
+        assert(dataset, `No dataset matching dataId: ${dataId}`);
+        const layerDescriptor = getLayerDescriptor({
+          mapConfig,
+          layer,
+          dataset,
+        });
+        return layerDescriptor;
+      } catch (e: any) {
+        console.error(e.message);
+        return undefined;
+      }
+    }),
   };
 }
 
@@ -225,13 +252,6 @@ function domainAndRangeFromScale(
   };
 }
 
-export type ScaleKey =
-  | 'fillColor'
-  | 'pointRadius'
-  | 'lineColor'
-  | 'elevation'
-  | 'weight';
-
 function createChannelProps(
   id: string,
   layerType: LayerType,
@@ -239,7 +259,10 @@ function createChannelProps(
   visualChannels: VisualChannels,
   data: any,
   dataset: Dataset
-): {channelProps: Record<string, any>; scales: Record<ScaleKey, Scale>} {
+): {
+  channelProps: Record<string, any>;
+  scales: Partial<Record<ScaleKey, Scale>>;
+} {
   const {
     colorField,
     colorScale,
@@ -249,9 +272,41 @@ function createChannelProps(
     strokeColorScale,
     weightField,
   } = visualChannels;
+  if (layerType === 'raster') {
+    const rasterStyleType = config.visConfig.rasterStyleType;
+    if (rasterStyleType === 'Rgb') {
+      return {
+        channelProps: getRasterTileLayerStylePropsRgb({
+          layerConfig: config,
+          rasterMetadata: data.raster_metadata,
+          visualChannels,
+        }),
+        scales: {},
+      };
+    } else {
+      return {
+        channelProps: getRasterTileLayerStylePropsScaledBand({
+          layerConfig: config,
+          visualChannels,
+          rasterMetadata: data.raster_metadata,
+        }),
+        scales: {
+          ...(colorField && {
+            fillColor: {
+              field: colorField,
+              type: 'ordinal',
+              domain: [],
+              range: [],
+            },
+          }),
+        },
+      };
+    }
+  }
   const {heightField, heightScale} = visualChannels;
   const {textLabel, visConfig} = config;
   const result: Record<string, any> = {};
+  const updateTriggers: Record<string, any> = {};
 
   const scales: Record<string, Scale> = {};
 
@@ -265,7 +320,7 @@ function createChannelProps(
       data
     );
     result.getFillColor = accessor;
-    scales.fillColor = {
+    scales.fillColor = updateTriggers.getFillColor = {
       field: colorField,
       type: colorScale!,
       ...domainAndRangeFromScale(scale),
@@ -288,6 +343,8 @@ function createChannelProps(
       return d.properties[aggregationExpAlias];
     };
 
+    updateTriggers.getWeight = aggregationExpAlias;
+
     result.getPointRadius = (d: any, info: any) => {
       return calculateClusterRadius(
         d.properties,
@@ -296,6 +353,10 @@ function createChannelProps(
         aggregationExpAlias
       );
     };
+    updateTriggers.getPointRadius = {
+      aggregationExpAlias,
+      radiusRange: visConfig.radiusRange,
+    };
 
     result.textCharacterSet = 'auto';
     result.textFontFamily = 'Inter, sans';
@@ -305,6 +366,8 @@ function createChannelProps(
     result.getText = (d: any) =>
       TEXT_NUMBER_FORMATTER.format(d.properties[aggregationExpAlias]);
 
+    updateTriggers.getText = aggregationExpAlias;
+
     result.getTextColor = config.textLabel[TEXT_LABEL_INDEX].color;
     result.textOutlineColor = [
       ...(config.textLabel[TEXT_LABEL_INDEX].outlineColor as number[]),
@@ -322,6 +385,11 @@ function createChannelProps(
       );
       return calculateClusterTextFontSize(radius);
     };
+
+    updateTriggers.getTextSize = {
+      aggregationExpAlias,
+      radiusRange: visConfig.radiusRange,
+    };
   }
 
   if (radiusField) {
@@ -333,7 +401,7 @@ function createChannelProps(
       data
     );
     result.getPointRadius = accessor;
-    scales.pointRadius = {
+    scales.pointRadius = updateTriggers.getPointRadius = {
       field: radiusField,
       type: radiusScale || 'identity',
       ...domainAndRangeFromScale(scale),
@@ -353,7 +421,7 @@ function createChannelProps(
       data
     );
     result.getLineColor = accessor;
-    scales.lineColor = {
+    scales.lineColor = updateTriggers.getLineColor = {
       field: strokeColorField,
       type: strokeColorScale!,
       ...domainAndRangeFromScale(scale),
@@ -368,7 +436,7 @@ function createChannelProps(
       data
     );
     result.getElevation = accessor;
-    scales.elevation = {
+    scales.elevation = updateTriggers.getElevation = {
       field: heightField,
       type: heightScale || 'identity',
       ...domainAndRangeFromScale(scale),
@@ -384,9 +452,9 @@ function createChannelProps(
       data
     );
     result.getWeight = accessor;
-    scales.weight = {
+    scales.weight = updateTriggers.getWeight = {
       field: weightField,
-      type: 'identity',
+      type: 'identity' as ScaleType,
       ...domainAndRangeFromScale(scale),
     };
   }
@@ -407,6 +475,12 @@ function createChannelProps(
       {fallbackUrl: customMarkersUrl, maxIconSize, useMaskedIcons},
       data
     );
+    updateTriggers.getIcon = {
+      customMarkersUrl,
+      customMarkersRange,
+      maxIconSize,
+      useMaskedIcons,
+    };
     result._subLayerProps = {
       'points-icon': {
         loadOptions: {
@@ -424,10 +498,12 @@ function createChannelProps(
 
     if (getFillColor && useMaskedIcons) {
       result.getIconColor = getFillColor;
+      updateTriggers.getIconColor = updateTriggers.getFillColor;
     }
 
     if (getPointRadius) {
       result.getIconSize = getPointRadius;
+      updateTriggers.getIconSize = updateTriggers.getPointRadius;
     }
 
     if (visualChannels.rotationField) {
@@ -439,6 +515,7 @@ function createChannelProps(
         data
       );
       result.getIconAngle = negateAccessor(accessor);
+      updateTriggers.getIconAngle = updateTriggers.getRotationField;
     }
   } else if (layerType === 'tileset') {
     result.pointType = 'circle';
@@ -494,7 +571,13 @@ function createChannelProps(
     };
   }
 
-  return {channelProps: result, scales};
+  return {
+    channelProps: {
+      ...result,
+      updateTriggers,
+    },
+    scales,
+  };
 }
 
 function createLoadOptions(accessToken: string) {