@carto/ps-react-maps 4.6.2 → 4.7.0

package/dist/types/editable/lasso-tools/types.d.ts

@@ -12,6 +12,7 @@ export interface LassoToolsData {
     };
     geometry: Geometry;
     type: DataType;
+    groupId?: number;
     layerProps?: GeoJsonLayerProps;
 }
 export interface LassoToolsState<M extends string = LassoToolsMode> {

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export type { BasemapsControlsProps, BasemapKey, BasemapType, DeckGLComponentPro
 export { CartoBasemaps, CartoBasemapURL, GmapsBasemap, MAPS_BASEMAP, MapsTypes, } from './const';
 export { DeckGLComponent } from './maps/deckgl';
 export { BasemapsControls } from './basemap-controls';
-export type { DefaultLassoToolsProps, LassoToolsChildrenProps, LassoToolsControlProps, LassoToolsLayerEditProps, LassoToolsLayerProps, LassoToolsLayersProps, LassoToolsProps, LassoToolsState, } from './editable/lasso-tools/types';
+export type { DefaultLassoToolsProps, LassoToolsChildrenProps, LassoToolsControlProps, LassoToolsData, LassoToolsLayerEditProps, LassoToolsLayerProps, LassoToolsLayersProps, LassoToolsProps, LassoToolsState, } from './editable/lasso-tools/types';
 export { DEFAULT_LASSO_TOOLS_COLORS, DEFAULT_LASSO_TOOLS_LAYER_PROPS, DEFAULT_LASSO_TOOLS_MODES, DEFAULT_LASSO_TOOLS_PROPS, DEFAULT_MASK_LAYER_PROPS, MAP_LASSO_TOOLS_LAYER_ID, MAP_MASK_LAYER_ID, } from './editable/lasso-tools/const';
 export { CustomCompositeEditMode } from './editable/lasso-tools/modes/custom-edit-mode.class';
 export { LassoTools } from './editable/lasso-tools/lasso-tools';
@@ -51,7 +51,8 @@ export { useEventManager } from './use-event-manager';
 export { useLayers } from './use-layers';
 export { useLegend } from './use-legend';
 export { useMapScreenshot } from './use-map-screenshot';
-export { useSpatialFilter, useLassoToolsSpatialFilter, useViewportSpatialFilter, } from './use-spatial-filter';
+export type { GroupedSpatialFilterResult } from './use-spatial-filter';
+export { useSpatialFilter, useLassoToolsSpatialFilter, useViewportSpatialFilter, useGroupedSpatialFilter, useGroupedLassoToolsSpatialFilters, useGroupedStaticSpatialFilters, } from './use-spatial-filter';
 export type { FieldFormatter, Formatter, Formatters, ObjectToHtmlOptions, Value, } from './utils/object-to-html/types';
 export { formatterTypes } from './utils/object-to-html/const';
 export { objectToHtml } from './utils/object-to-html/object-to-html';

package/dist/types/models/utils/resolve-property-for-source.d.ts

@@ -7,7 +7,7 @@
  * @returns The resolved string value for the source
  * @internal
  */
-export declare function resolvePropertyForSource(value: string | string[] | undefined, sourceIndex: number, totalSources: number, propertyName: string): string | undefined;
+export declare function resolvePropertyForSource(value: unknown, sourceIndex: number, totalSources: number, propertyName: string): unknown;
 /**
  * Resolves the column value for a specific source index
  * @param column - Single column string or array of columns
@@ -16,4 +16,4 @@ export declare function resolvePropertyForSource(value: string | string[] | unde
  * @returns The resolved column string for the source
  * @internal
  */
-export declare function resolveColumnForSource(column: string | string[] | undefined, sourceIndex: number, totalSources: number): string | undefined;
+export declare function resolveColumnForSource(column: string | string[] | undefined, sourceIndex: number, totalSources: number): unknown;

package/dist/types/providers/map/types.d.ts

@@ -2,6 +2,9 @@ import { MapViewState, WebMercatorViewport } from '@deck.gl/core';
 import { DeckGLComponentProps, InstanceRef, MapComponentProps, OverlayRef } from '../../types';
 import { SpatialFilter } from '@carto/api-client';
 import { Position } from 'geojson';
+export type SpatialFilterWithGroup = SpatialFilter & {
+    groupId?: number;
+};
 interface ValueProps {
     id: MapComponentProps['id'];
     /**
@@ -13,7 +16,7 @@ interface ValueProps {
     isLoaded: boolean;
     basemap: NonNullable<MapComponentProps['basemap']>;
     layers?: string[];
-    spatialFilter?: Record<string, SpatialFilter | null>;
+    spatialFilter?: Record<string, SpatialFilterWithGroup | null>;
     controller?: DeckGLComponentProps['controller'];
 }
 export interface MapProviderProps {
@@ -73,8 +76,8 @@ export interface CommonSlice {
     }) => void;
 }
 export interface SpatialFilterSlice {
-    spatialFilter: Record<ValueProps['id'], Record<string, SpatialFilter | null>>;
-    setSpatialFilter: (mapId: ValueProps['id'], id: string, value: SpatialFilter) => void;
+    spatialFilter: Record<ValueProps['id'], Record<string, SpatialFilterWithGroup | null>>;
+    setSpatialFilter: (mapId: ValueProps['id'], id: string, value: SpatialFilterWithGroup) => void;
     removeSpatialFilter: (mapId: ValueProps['id'], id: string) => void;
 }
 export interface LayerActionsSlice {

package/dist/types/use-spatial-filter.d.ts

@@ -17,3 +17,43 @@ export declare function useLassoToolsSpatialFilter({ mapId, }: {
 export declare function useStaticSpatialFilter({ mapId, }: {
     mapId: MapComponentProps['id'];
 }): SpatialFilter | undefined;
+/**
+ * Type for grouped spatial filter result
+ */
+export type GroupedSpatialFilterResult = SpatialFilter[];
+export declare function useGroupedSpatialFilter({ mapId, }: {
+    mapId: MapComponentProps['id'];
+}): {
+    spatialFilter: GroupedSpatialFilterResult;
+    staticSpatialFilter: GroupedSpatialFilterResult;
+    lassoToolsSpatialFilter: GroupedSpatialFilterResult;
+    viewportSpatialFilter: GroupedSpatialFilterResult;
+};
+/**
+ * Hook to create multipolygon geometries for each group of lasso tool values.
+ * Groups are identified by the groupId property in LassoToolsData.
+ * Uses per-group memoization to only recompute multipolygons when a specific group changes.
+ * This optimizes performance by avoiding expensive multiPolygon() calls for unchanged groups.
+ *
+ * @param mapId - The map component ID
+ * @param groupIds - Optional array of group IDs to filter results. If empty or undefined, returns all groups
+ * @returns Array of objects with groupId and spatialFilter, ordered by groupId
+ */
+export declare function useGroupedLassoToolsSpatialFilters({ mapId, groupIds, }: {
+    mapId: MapComponentProps['id'];
+    groupIds?: number[];
+}): GroupedSpatialFilterResult;
+/**
+ * Hook to create multipolygon geometries for each group of static spatial filters.
+ * Groups are identified by the groupId property in SpatialFilterWithGroup.
+ * Uses per-group memoization to only recompute multipolygons when a specific group changes.
+ * This optimizes performance by avoiding expensive multiPolygon() calls for unchanged groups.
+ *
+ * @param mapId - The map component ID
+ * @param groupIds - Optional array of group IDs to filter results. If empty or undefined, returns all groups
+ * @returns Array of objects with groupId and spatialFilter, ordered by groupId
+ */
+export declare function useGroupedStaticSpatialFilters({ mapId, groupIds, }: {
+    mapId: MapComponentProps['id'];
+    groupIds?: number[];
+}): GroupedSpatialFilterResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carto/ps-react-maps",
-  "version": "4.6.2",
+  "version": "4.7.0",
   "description": "CARTO's Professional Service React DeckGL library",
   "type": "module",
   "dependencies": {},
@@ -27,7 +27,7 @@
     "react-map-gl": "8.1.0",
     "zustand": "5.0.8",
     "@carto/ps-utils": "2.0.1",
-    "@carto/ps-services": "2.6.2"
+    "@carto/ps-services": "2.7.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",