@tomtom-org/maps-sdk 0.41.0 → 0.41.5

package/core/package.json

@@ -31,9 +31,6 @@
     "@types/lodash-es": "catalog:",
     "@vitest/coverage-v8": "catalog:",
     "rimraf": "catalog:",
-    "rollup-plugin-analyzer": "catalog:",
-    "rollup-plugin-license": "catalog:",
-    "rollup-plugin-visualizer": "catalog:",
     "shared-configs": "workspace:*",
     "ts-node": "catalog:",
     "typescript": "catalog:",

package/map/dist/THIRD_PARTY.txt

@@ -1,5 +1,5 @@
 Name: lodash-es
-Version: 4.17.22
+Version: 4.17.23
 License: MIT
 Private: false
 Description: Lodash exported as ES modules.
@@ -63,7 +63,7 @@ terms above.
 ---
 
 Name: @turf/helpers
-Version: 7.3.2
+Version: 7.3.3
 License: MIT
 Private: false
 Description: Provides helper functions to create GeoJSON features, like points, lines, or areas on a map.
@@ -102,7 +102,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ---
 
 Name: @turf/invariant
-Version: 7.3.2
+Version: 7.3.3
 License: MIT
 Private: false
 Description: Lightweight utility for input validation and data extraction in Turf.js. Ensures GeoJSON inputs are in the correct format and extracts specific components like coordinates or geometries.
@@ -139,7 +139,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ---
 
 Name: @turf/bearing
-Version: 7.3.2
+Version: 7.3.3
 License: MIT
 Private: false
 Description: Takes two points and finds the geographic bearing between them.
@@ -173,7 +173,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ---
 
 Name: maplibre-gl
-Version: 5.16.0
+Version: 5.17.0
 License: BSD-3-Clause
 Private: false
 Description: BSD licensed community fork of mapbox-gl, a WebGL interactive maps library

package/map/dist/index.d.ts

@@ -351,6 +351,12 @@ export declare class AddedSourceWithLayers<SOURCE_SPEC extends SourceSpecificati
     ensureAddedToMapWithVisibility(visible: boolean, addLayersToMap: boolean): void;
 }
 
+/**
+ * Availability level for POI icons with availability indicators.
+ * @group Shared
+ */
+export declare type AvailabilityLevel = 'available' | 'occupied';
+
 /**
  * Source identifier for base map vector tiles.
  *
@@ -1364,7 +1370,7 @@ export declare type CustomImage<I extends string = string> = {
      * The specific values depend on the context:
      * - For POI categories: Use MapStylePOICategory values (e.g., 'RESTAURANT', 'HOTEL_MOTEL')
      * - For route waypoints: Use waypoint identifiers (e.g., 'waypoint-start', 'waypoint-end')
-     * - For charging stations: Use station type identifiers
+     * - For charging stations: Use station type identifiers (e.g., 'ELECTRIC_VEHICLE_STATION')
      * - For custom markers: Use any unique string identifier
      */
     id: I;
@@ -1415,6 +1421,36 @@ export declare type CustomImage<I extends string = string> = {
      * ```
      */
     pixelRatio?: number;
+    /**
+     * Availability level for POI icons with availability indicators.
+     *
+     * @remarks
+     * Used when displaying custom icons for POIs with real-time availability data.
+     * The SDK will select the appropriate icon based on the availability ratio and
+     * configured threshold.
+     *
+     * - `'available'`: Used when ratio >= threshold (sufficient capacity available)
+     * - `'occupied'`: Used when ratio < threshold (low or no availability)
+     *
+     *
+     * @example
+     * ```typescript
+     * // Define custom icons for both availability states
+     * categoryIcons: [
+     *   {
+     *     id: 'ELECTRIC_VEHICLE_STATION',
+     *     image: greenChargingSVG,
+     *     availabilityLevel: 'available'
+     *   },
+     *   {
+     *     id: 'ELECTRIC_VEHICLE_STATION',
+     *     image: redChargingSVG,
+     *     availabilityLevel: 'occupied'
+     *   }
+     * ]
+     * ```
+     */
+    availabilityLevel?: AvailabilityLevel;
 };
 
 /**
@@ -2013,6 +2049,81 @@ declare type DisplayTrafficSectionProps = DisplaySectionProps & TrafficSectionPr
     title?: string;
 };
 
+/**
+ * Configuration for EV charging station availability display.
+ *
+ * @remarks
+ * **Opt-In Feature:**
+ * - Disabled by default - set `enabled: true` to activate
+ * - Requires fetching availability via {@link getPlacesWithEVAvailability}
+ * - Each PlacesModule can enable/disable independently
+ *
+ * When enabled, displays formatted availability text (e.g., "3/10") below the station name
+ * with color-coding based on availability ratio: green (high), orange (limited), red (none/low).
+ *
+ * @example
+ * ```typescript
+ * // Enable with defaults
+ * const places = await PlacesModule.get(map, {
+ *   evAvailability: { enabled: true }
+ * });
+ * const stations = await search({ poiCategories: ['ELECTRIC_VEHICLE_STATION'] });
+ * places.show(await getPlacesWithEVAvailability(stations));
+ *
+ * // Custom threshold and format
+ * const places = await PlacesModule.get(map, {
+ *   evAvailability: {
+ *     enabled: true,
+ *     threshold: 0.5,
+ *     formatText: (available, total) => `${available} of ${total}`
+ *   }
+ * });
+ *
+ * // Combine with custom icon
+ * const places = await PlacesModule.get(map, {
+ *   icon: {
+ *     categoryIcons: [{
+ *       id: 'ELECTRIC_VEHICLE_STATION',
+ *       image: customEvIconSvg,
+ *       pixelRatio: 2
+ *     }]
+ *   },
+ *   evAvailability: { enabled: true }
+ * });
+ * ```
+ *
+ * @group Places
+ */
+export declare type EVAvailabilityConfig = {
+    /**
+     * Enable or disable EV availability display.
+     *
+     * @remarks
+     * Must be explicitly set to `true` to display availability.
+     */
+    enabled?: boolean;
+    /**
+     * Availability ratio threshold for determining available vs occupied.
+     *
+     * @remarks
+     * - `ratio >= threshold`: Available (green)
+     * - `ratio < threshold`: Occupied (red)
+     *
+     * @default 0
+     */
+    threshold?: number;
+    /**
+     * Custom function to format the availability text.
+     *
+     * @param available - Number of available charging points
+     * @param total - Total number of charging points
+     * @returns Formatted availability text
+     *
+     * @default (available, total) => `${available}/${total}`
+     */
+    formatText?: (available: number, total: number) => string;
+};
+
 /**
  * Optional events configuration for a map module.
  *
@@ -4418,16 +4529,28 @@ export declare type PlaceLayersConfig = {
  * - Data-driven styling via MapLibre expressions
  * - Interactive events (click, hover, etc.)
  * - Support for custom feature properties
+ * - EV charging station availability display (opt-in)
  *
  * **Marker Styles:**
  * - `pin`: Traditional teardrop-shaped map pins
  * - `circle`: Simple circular markers
  * - `base-map`: Mimics built-in POI layer styling
  *
+ * **EV Charging Station Availability:**
+ * When displaying EV charging stations with availability data from
+ * {@link getPlacesWithEVAvailability}, the module can:
+ * - Show available/total charging points (e.g., "3/10")
+ * - Color-code availability (green = good, orange = limited, red = none/low)
+ * - Display as formatted text within the station's label
+ *
+ * This feature is disabled by default. To enable it, set `evAvailability.enabled` to `true`
+ * in the configuration.
+ *
  * **Common Use Cases:**
  * - Search result visualization
  * - Custom location markers
  * - Store locators
+ * - EV charging station maps with real-time availability
  * - Delivery/pickup points
  * - Saved locations display
  *
@@ -4447,6 +4570,19 @@ export declare type PlaceLayersConfig = {
  * // Display places from search
  * await placesModule.show(searchResults);
  *
+ * // EV Charging Stations - Opt-in to availability display
+ * const evStations = await PlacesModule.get(map, {
+ *   evAvailability: { enabled: true }
+ * });
+ * const results = await search({ poiCategories: ['ELECTRIC_VEHICLE_STATION'] });
+ * evStations.show(await getPlacesWithEVAvailability(results)); // Shows availability
+ *
+ * // Granular control: Enable for searched stations only, background stations without
+ * const bgStations = await PlacesModule.get(map); // EV availability disabled
+ * const searched = await PlacesModule.get(map, {
+ *   evAvailability: { enabled: true }
+ * });
+ *
  * // Handle clicks
  * placesModule.events.on('click', (feature) => {
  *   console.log('Clicked:', feature.properties);
@@ -4777,6 +4913,16 @@ export declare type PlacesModuleConfig = MapModuleCommonConfig & {
      * * Use this only if you need fine MapLibre control on how places are displayed.
      */
     layers?: PlaceLayersConfig;
+    /**
+     * Configuration for EV charging station availability display.
+     *
+     * @remarks
+     * Disabled by default - set `enabled: true` to show availability on EV stations.
+     * Requires calling {@link getPlacesWithEVAvailability} to fetch availability data.
+     *
+     * @default undefined (disabled)
+     */
+    evAvailability?: EVAvailabilityConfig;
     /**
      * Additional properties to compute for each place feature.
      *
@@ -4944,20 +5090,19 @@ export declare type PlaceTextConfig = {
      */
     haloWidth?: DataDrivenPropertyValueSpecification<number>;
     /**
-     * Text offset from the icon in ems [x, y].
+     * Text offset from the icon in ems.
      *
-     * Positive x moves right, positive y moves down.
+     * Applies uniformly to all anchor positions (top, left, right).
+     * Positive values increase distance from icon.
      *
-     * @default [0, 0]
+     * @default undefined (uses automatic offset calculation based on icon size)
      *
      * @example
      * ```typescript
-     * offset: [0, 1.5]  // Position text below icon
-     *
-     * offset: [1, 0]  // Position text to the right
+     * offset: 1.5  // Position text 1.5em away from icon in whichever direction the renderer chooses
      * ```
      */
-    offset?: DataDrivenPropertyValueSpecification<[number, number]>;
+    offset?: number;
 };
 
 /**
@@ -5701,6 +5846,7 @@ export declare const ROUTE_LINE_FOREGROUND_WIDTH: ExpressionSpecification;
 
 /**
  * Main route outline color.
+ * @ignore
  */
 export declare const ROUTE_LINE_OUTLINE_COLOR = "#105287";
 
@@ -6824,7 +6970,7 @@ export declare type StyleChangeHandler = {
      *
      * @returns void or a Promise that resolves when preparation is complete
      */
-    onStyleAboutToChange: () => void | Promise<void>;
+    onStyleAboutToChange?: () => void | Promise<void>;
     /**
      * Callback invoked after a new style has been fully loaded.
      *
@@ -6834,7 +6980,7 @@ export declare type StyleChangeHandler = {
      *
      * @returns void or a Promise that resolves when reinitialization is complete
      */
-    onStyleChanged: () => void | Promise<void>;
+    onStyleChanged?: () => void | Promise<void>;
 };
 
 /**