@carto/kepler.gl 0.0.81 → 0.0.82

package/src/reducers/map-style-updaters.js

@@ -1,541 +0,0 @@
-// Copyright (c) 2022 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
-// @ts-nocheck
-import Task, {withTask} from 'react-palm/tasks';
-import cloneDeep from 'lodash/cloneDeep';
-
-// Utils
-import {
-  getDefaultLayerGroupVisibility,
-  isValidStyleUrl,
-  getStyleDownloadUrl,
-  mergeLayerGroupVisibility,
-  editTopMapStyle,
-  editBottomMapStyle,
-  getStyleImageIcon
-} from 'utils/map-style-utils/mapbox-gl-style-editor';
-import {
-  DEFAULT_MAP_STYLES,
-  DEFAULT_LAYER_GROUPS,
-  DEFAULT_MAPBOX_API_URL
-} from 'constants/default-settings';
-import {generateHashId} from 'utils/utils';
-import {LOAD_MAP_STYLE_TASK} from 'tasks/tasks';
-import {loadMapStyles, loadMapStyleErr} from 'actions/map-style-actions';
-import {rgb} from 'd3-color';
-import {hexToRgb} from 'utils/color-utils';
-
-const DEFAULT_BLDG_COLOR = '#D1CEC7';
-
-/**
- * @return {import('./map-style-updaters').MapStyle}
- */
-const getDefaultState = () => {
-  const visibleLayerGroups = {};
-  const styleType = 'dark';
-  const topLayerGroups = {};
-
-  return {
-    styleType,
-    visibleLayerGroups,
-    topLayerGroups,
-    mapStyles: DEFAULT_MAP_STYLES.reduce(
-      (accu, curr) => ({
-        ...accu,
-        [curr.id]: curr
-      }),
-      {}
-    ),
-    // save mapbox access token
-    mapboxApiAccessToken: null,
-    mapboxApiUrl: DEFAULT_MAPBOX_API_URL,
-    mapStylesReplaceDefault: false,
-    inputStyle: getInitialInputStyle(),
-    threeDBuildingColor: hexToRgb(DEFAULT_BLDG_COLOR),
-    custom3DBuildingColor: false
-  };
-};
-
-/**
- * Updaters for `mapStyle`. Can be used in your root reducer to directly modify kepler.gl's state.
- * Read more about [Using updaters](../advanced-usage/using-updaters.md)
- * @public
- * @example
- *
- * import keplerGlReducer, {mapStyleUpdaters} from 'kepler.gl/reducers';
- * // Root Reducer
- * const reducers = combineReducers({
- *  keplerGl: keplerGlReducer,
- *  app: appReducer
- * });
- *
- * const composedReducer = (state, action) => {
- *  switch (action.type) {
- *    // click button to hide label from background map
- *    case 'CLICK_BUTTON':
- *      return {
- *        ...state,
- *        keplerGl: {
- *          ...state.keplerGl,
- *          foo: {
- *             ...state.keplerGl.foo,
- *             mapStyle: mapStyleUpdaters.mapConfigChangeUpdater(
- *               mapStyle,
- *               {payload: {visibleLayerGroups: {label: false, road: true, background: true}}}
- *             )
- *          }
- *        }
- *      };
- *  }
- *  return reducers(state, action);
- * };
- *
- * export default composedReducer;
- */
-/* eslint-disable no-unused-vars */
-const mapStyleUpdaters = null;
-/* eslint-enable no-unused-vars */
-/**
- * Default initial `mapStyle`
- * @memberof mapStyleUpdaters
- * @constant
- * @property styleType - Default: `'dark'`
- * @property visibleLayerGroups - Default: `{}`
- * @property topLayerGroups - Default: `{}`
- * @property mapStyles - mapping from style key to style object
- * @property mapboxApiAccessToken - Default: `null`
- * @Property mapboxApiUrl - Default null
- * @Property mapStylesReplaceDefault - Default: `false`
- * @property inputStyle - Default: `{}`
- * @property threeDBuildingColor - Default: `[r, g, b]`
- * @type {import('./map-style-updaters').MapStyle}
- * @public
- */
-export const INITIAL_MAP_STYLE = getDefaultState();
-
-/**
- * Create two map styles from preset map style, one for top map one for bottom
- *
- * @param {string} styleType - current map style
- * @param {Object} visibleLayerGroups - visible layers of bottom map
- * @param {Object} topLayerGroups - visible layers of top map
- * @param {Object} mapStyles - a dictionary of all map styles
- * @returns {Object} bottomMapStyle | topMapStyle | isRaster
- */
-export function getMapStyles({styleType, visibleLayerGroups, topLayerGroups, mapStyles}) {
-  const mapStyle = mapStyles[styleType];
-
-  // style might not be loaded yet
-  if (!mapStyle || !mapStyle.style) {
-    return {};
-  }
-
-  const editable = Object.keys(visibleLayerGroups).length;
-
-  const bottomMapStyle = !editable
-    ? mapStyle.style
-    : editBottomMapStyle({
-        id: styleType,
-        mapStyle,
-        visibleLayerGroups
-      });
-
-  const hasTopLayer = editable && Object.values(topLayerGroups).some(v => v);
-
-  // mute top layer if not visible in bottom layer
-  const topLayers =
-    hasTopLayer &&
-    Object.keys(topLayerGroups).reduce(
-      (accu, key) => ({
-        ...accu,
-        [key]: topLayerGroups[key] && visibleLayerGroups[key]
-      }),
-      {}
-    );
-
-  const topMapStyle = hasTopLayer
-    ? editTopMapStyle({
-        id: styleType,
-        mapStyle,
-        visibleLayerGroups: topLayers
-      })
-    : null;
-
-  return {bottomMapStyle, topMapStyle, editable};
-}
-
-function findLayerFillColor(layer) {
-  return layer && layer.paint && layer.paint['background-color'];
-}
-
-function get3DBuildingColor(style) {
-  // set building color to be the same as the background color.
-  if (!style.style) {
-    return hexToRgb(DEFAULT_BLDG_COLOR);
-  }
-
-  const backgroundLayer = (style.style.layers || []).find(({id}) => id === 'background');
-
-  const buildingLayer = (style.style.layers || []).find(({id}) => id.match(/building/));
-
-  const buildingColor =
-    findLayerFillColor(buildingLayer) || findLayerFillColor(backgroundLayer) || DEFAULT_BLDG_COLOR;
-
-  // brighten or darken building based on style
-  const operation = style.id.match(/(?=(dark|night))/) ? 'brighter' : 'darker';
-
-  const alpha = 0.2;
-  const rgbObj = rgb(buildingColor)[operation]([alpha]);
-  return [rgbObj.r, rgbObj.g, rgbObj.b];
-}
-
-function getLayerGroupsFromStyle(style) {
-  return Array.isArray(style.layers)
-    ? DEFAULT_LAYER_GROUPS.filter(lg => style.layers.filter(lg.filter).length)
-    : [];
-}
-
-// Updaters
-/**
- * Propagate `mapStyle` reducer with `mapboxApiAccessToken` and `mapStylesReplaceDefault`.
- * if mapStylesReplaceDefault is true mapStyles is emptied; loadMapStylesUpdater() will
- * populate mapStyles.
- *
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').initMapStyleUpdater}
- * @public
- */
-export const initMapStyleUpdater = (state, {payload = {}}) => ({
-  ...state,
-  // save mapbox access token to map style state
-  mapboxApiAccessToken: payload.mapboxApiAccessToken || state.mapboxApiAccessToken,
-  mapboxApiUrl: payload.mapboxApiUrl || state.mapboxApiUrl,
-  mapStyles: !payload.mapStylesReplaceDefault ? state.mapStyles : {},
-  mapStylesReplaceDefault: payload.mapStylesReplaceDefault || false
-});
-// });
-
-/**
- * Update `visibleLayerGroups`to change layer group visibility
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').mapConfigChangeUpdater}
- * @public
- */
-export const mapConfigChangeUpdater = (state, action) => ({
-  ...state,
-  ...action.payload,
-  ...getMapStyles({
-    ...state,
-    ...action.payload
-  })
-});
-
-/**
- * Change to another map style. The selected style should already been loaded into `mapStyle.mapStyles`
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').mapStyleChangeUpdater}
- * @public
- */
-export const mapStyleChangeUpdater = (state, {payload: styleType}) => {
-  if (!state.mapStyles[styleType]) {
-    // we might not have received the style yet
-    return state;
-  }
-  const defaultLGVisibility = getDefaultLayerGroupVisibility(state.mapStyles[styleType]);
-
-  const visibleLayerGroups = mergeLayerGroupVisibility(
-    defaultLGVisibility,
-    state.visibleLayerGroups
-  );
-
-  const threeDBuildingColor = state.custom3DBuildingColor
-    ? state.threeDBuildingColor
-    : get3DBuildingColor(state.mapStyles[styleType]);
-
-  return {
-    ...state,
-    styleType,
-    visibleLayerGroups,
-    threeDBuildingColor,
-    ...getMapStyles({
-      ...state,
-      visibleLayerGroups,
-      styleType
-    })
-  };
-};
-
-/**
- * Callback when load map style success
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').loadMapStylesUpdater}
- * @public
- */
-export const loadMapStylesUpdater = (state, action) => {
-  const newStyles = action.payload || {};
-  const addLayerGroups = Object.keys(newStyles).reduce(
-    (accu, id) => ({
-      ...accu,
-      [id]: {
-        ...newStyles[id],
-        layerGroups: newStyles[id].layerGroups || getLayerGroupsFromStyle(newStyles[id].style)
-      }
-    }),
-    {}
-  );
-
-  // add new styles to state
-  const newState = {
-    ...state,
-    mapStyles: {
-      ...state.mapStyles,
-      ...addLayerGroups
-    }
-  };
-
-  return newStyles[state.styleType]
-    ? mapStyleChangeUpdater(newState, {payload: state.styleType})
-    : newState;
-};
-
-/**
- * Callback when load map style error
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').loadMapStyleErrUpdater}
- * @public
- */
-// do nothing for now, if didn't load, skip it
-export const loadMapStyleErrUpdater = state => state;
-
-/**
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').requestMapStylesUpdater}
- * @public
- */
-export const requestMapStylesUpdater = (state, {payload: mapStyles}) => {
-  const loadMapStyleTasks = getLoadMapStyleTasks(
-    mapStyles,
-    state.mapboxApiAccessToken,
-    state.mapboxApiUrl
-  );
-  return withTask(state, loadMapStyleTasks);
-};
-
-/**
- * Load map style object when pass in saved map config
- * @memberof mapStyleUpdaters
- * @param state `mapStyle`
- * @param action
- * @param action.payload saved map config `{mapStyle, visState, mapState}`
- * @returns nextState or `react-pam` tasks to load map style object
- * @type {typeof import('./map-style-updaters').receiveMapConfigUpdater}
- */
-export const receiveMapConfigUpdater = (state, {payload: {config = {}}}) => {
-  const {mapStyle} = config || {};
-
-  if (!mapStyle) {
-    return state;
-  }
-
-  // if saved custom mapStyles load the style object
-  const loadMapStyleTasks = mapStyle.mapStyles
-    ? getLoadMapStyleTasks(mapStyle.mapStyles, state.mapboxApiAccessToken, state.mapboxApiUrl)
-    : null;
-
-  // merge default mapStyles
-  const merged = mapStyle.mapStyles
-    ? {
-        ...mapStyle,
-        mapStyles: {
-          ...mapStyle.mapStyles,
-          ...state.mapStyles
-        }
-      }
-    : mapStyle;
-
-  // set custom3DBuildingColor: true if mapStyle contains threeDBuildingColor
-  merged.custom3DBuildingColor =
-    Boolean(mapStyle.threeDBuildingColor) || merged.custom3DBuildingColor;
-  const newState = mapConfigChangeUpdater(state, {payload: merged});
-
-  return loadMapStyleTasks ? withTask(newState, loadMapStyleTasks) : newState;
-};
-
-function getLoadMapStyleTasks(mapStyles, mapboxApiAccessToken, mapboxApiUrl) {
-  return [
-    Task.all(
-      Object.values(mapStyles)
-        .map(({id, url, accessToken}) => ({
-          id,
-          url: isValidStyleUrl(url)
-            ? getStyleDownloadUrl(url, accessToken || mapboxApiAccessToken, mapboxApiUrl)
-            : url
-        }))
-        .map(LOAD_MAP_STYLE_TASK)
-    ).bimap(
-      // success
-      results =>
-        loadMapStyles(
-          results.reduce(
-            (accu, {id, style}) => ({
-              ...accu,
-              [id]: {
-                ...mapStyles[id],
-                style
-              }
-            }),
-            {}
-          )
-        ),
-      // error
-      loadMapStyleErr
-    )
-  ];
-}
-/**
- * Reset map style config to initial state
- * @memberof mapStyleUpdaters
- * @param state `mapStyle`
- * @returns nextState
- * @type {typeof import('./map-style-updaters').resetMapConfigMapStyleUpdater}
- * @public
- */
-export const resetMapConfigMapStyleUpdater = state => {
-  const emptyConfig = {
-    ...INITIAL_MAP_STYLE,
-    mapboxApiAccessToken: state.mapboxApiAccessToken,
-    mapboxApiUrl: state.mapboxApiUrl,
-    mapStylesReplaceDefault: state.mapStylesReplaceDefault,
-    ...state.initialState,
-    mapStyles: state.mapStyles,
-    initialState: state.initialState
-  };
-
-  return mapStyleChangeUpdater(emptyConfig, {payload: emptyConfig.styleType});
-};
-
-/**
- * Callback when a custom map style object is received
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').loadCustomMapStyleUpdater}
- * @public
- */
-export const loadCustomMapStyleUpdater = (state, {payload: {icon, style, error}}) => ({
-  ...state,
-  inputStyle: {
-    ...state.inputStyle,
-    // style json and icon will load asynchronously
-    ...(style
-      ? {
-          id: style.id || generateHashId(),
-          // make a copy of the style object
-          style: cloneDeep(style),
-          label: style.name,
-          // gathering layer group info from style json
-          layerGroups: getLayerGroupsFromStyle(style)
-        }
-      : {}),
-    ...(icon ? {icon} : {}),
-    ...(error !== undefined ? {error} : {})
-  }
-});
-
-/**
- * Input a custom map style object
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').inputMapStyleUpdater}
- * @public
- */
-export const inputMapStyleUpdater = (state, {payload: {inputStyle, mapState}}) => {
-  const updated = {
-    ...state.inputStyle,
-    ...inputStyle
-  };
-
-  const isValid = isValidStyleUrl(updated.url);
-  const icon = isValid
-    ? getStyleImageIcon({
-        mapState,
-        styleUrl: updated.url,
-        mapboxApiAccessToken: updated.accessToken || state.mapboxApiAccessToken,
-        mapboxApiUrl: state.mapboxApiUrl || DEFAULT_MAPBOX_API_URL
-      })
-    : state.inputStyle.icon;
-
-  return {
-    ...state,
-    inputStyle: {
-      ...updated,
-      isValid,
-      icon
-    }
-  };
-};
-
-/**
- * Add map style from user input to reducer and set it to current style
- * This action is called when user click confirm after putting in a valid style url in the custom map style dialog.
- * It should not be called from outside kepler.gl without a valid `inputStyle` in the `mapStyle` reducer.
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').addCustomMapStyleUpdater}
- */
-export const addCustomMapStyleUpdater = state => {
-  const styleId = state.inputStyle.id;
-  const newState = {
-    ...state,
-    mapStyles: {
-      ...state.mapStyles,
-      [styleId]: state.inputStyle
-    },
-    // set to default
-    inputStyle: getInitialInputStyle()
-  };
-  // set new style
-  return mapStyleChangeUpdater(newState, {payload: styleId});
-};
-
-/**
- * Updates 3d building color
- * @memberof mapStyleUpdaters
- * @type {typeof import('./map-style-updaters').set3dBuildingColorUpdater}
- */
-export const set3dBuildingColorUpdater = (state, {payload: color}) => ({
-  ...state,
-  threeDBuildingColor: color,
-  custom3DBuildingColor: true
-});
-
-/**
- * Return the initial input style
- * @return Object
- */
-export function getInitialInputStyle() {
-  return {
-    accessToken: null,
-    error: false,
-    isValid: false,
-    label: null,
-    style: null,
-    url: null,
-    icon: null,
-    custom: true
-  };
-}

package/src/reducers/map-style.js

@@ -1,53 +0,0 @@
-// Copyright (c) 2022 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
-import {handleActions} from 'redux-actions';
-import ActionTypes from 'constants/action-types';
-import * as mapStyleUpdaters from './map-style-updaters';
-
-/**
- * Important: Do not rename `actionHandler` or the assignment pattern of property value.
- * It is used to generate documentation
- */
-const actionHandler = {
-  [ActionTypes.INIT]: mapStyleUpdaters.initMapStyleUpdater,
-  [ActionTypes.INPUT_MAP_STYLE]: mapStyleUpdaters.inputMapStyleUpdater,
-  [ActionTypes.MAP_CONFIG_CHANGE]: mapStyleUpdaters.mapConfigChangeUpdater,
-  [ActionTypes.MAP_STYLE_CHANGE]: mapStyleUpdaters.mapStyleChangeUpdater,
-  [ActionTypes.REQUEST_MAP_STYLES]: mapStyleUpdaters.requestMapStylesUpdater,
-  [ActionTypes.LOAD_MAP_STYLES]: mapStyleUpdaters.loadMapStylesUpdater,
-  [ActionTypes.LOAD_MAP_STYLE_ERR]: mapStyleUpdaters.loadMapStyleErrUpdater,
-  [ActionTypes.RECEIVE_MAP_CONFIG]: mapStyleUpdaters.receiveMapConfigUpdater,
-  [ActionTypes.LOAD_CUSTOM_MAP_STYLE]: mapStyleUpdaters.loadCustomMapStyleUpdater,
-  [ActionTypes.ADD_CUSTOM_MAP_STYLE]: mapStyleUpdaters.addCustomMapStyleUpdater,
-  [ActionTypes.RESET_MAP_CONFIG]: mapStyleUpdaters.resetMapConfigMapStyleUpdater,
-  [ActionTypes.SET_3D_BUILDING_COLOR]: mapStyleUpdaters.set3dBuildingColorUpdater,
-  [ActionTypes.RESET_MAP_CONFIG]: mapStyleUpdaters.resetMapConfigMapStyleUpdater
-};
-
-export const mapStyleReducerFactory = (initialState = {}) =>
-  // @ts-ignore
-  handleActions(actionHandler, {
-    ...mapStyleUpdaters.INITIAL_MAP_STYLE,
-    ...initialState,
-    initialState
-  });
-
-export default mapStyleReducerFactory();

package/src/reducers/provider-state-updaters.d.ts

@@ -1,88 +0,0 @@
-import * as ProviderActions from 'actions/provider-actions';
-import {MapListItem} from 'cloud-providers';
-
-type ActionPayload<P> = {
-  type?: string;
-  payload: P;
-};
-
-export type ProviderState = {
-  isProviderLoading: boolean;
-  isCloudMapLoading: boolean;
-  providerError: any;
-  currentProvider: string | null;
-  successInfo: any;
-  mapSaved: null | string;
-  initialState: any;
-  visualizations: MapListItem[]
-};
-
-export const INITIAL_PROVIDER_STATE: ProviderState;
-
-export function withTask<T>(s: T, any): T;
-
-export function exportFileToCloudUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.ExportFileToCloudPayload>
-): ProviderState;
-
-export function exportFileSuccessUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.ExportFileSuccessPayload>
-): ProviderState;
-
-export function postSaveLoadSuccessUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.PostSaveLoadSuccessPayload>
-): ProviderState;
-
-export function exportFileErrorUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.ExportFileErrorPayload>
-): ProviderState;
-
-export function loadCloudMapUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.LoadCloudMapPayload>
-): ProviderState;
-
-export function loadCloudMapSuccessUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.LoadCloudMapSuccessPayload>
-): ProviderState;
-
-export function loadCloudMapErrorUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.LoadCloudMapErrorPayload>
-): ProviderState;
-
-export function resetProviderStatusUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.ResetProviderStatusPayload>
-): ProviderState;
-
-export function setCloudProviderUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.SetCloudProviderPayload>
-): ProviderState;
-
-export function getSavedMapsUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.GetSavedMapsPayload>
-): ProviderState;
-
-export function getSavedMapsSuccessUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.GetSavedMapsSuccessPayload>
-): ProviderState;
-
-export function getSavedMapsErrorUpdater(
-  state: ProviderState,
-  action: ActionPayload<ProviderActions.GetSavedMapsErrorPayload>
-): ProviderState;
-
-export function createGlobalNotificationTasks(p: {
-  type?: string;
-  message: string;
-  delayClose?: boolean;
-}): any[];