@tomtom-org/maps-sdk 0.40.1 → 0.41.1

package/core/dist/index.d.ts

@@ -513,12 +513,8 @@ export declare type ChargingConnectionInfo = {
  * ```typescript
  * const chargingPark: ChargingPark = {
  *   connectors: [
- *     { id: 'c1', type: 'IEC62196Type2CCS', ratedPowerKW: 150, ... },
- *     { id: 'c2', type: 'Chademo', ratedPowerKW: 50, ... }
- *   ],
- *   connectorCounts: [
- *     { connector: {...}, count: 4, statusCounts: {} },
- *     { connector: {...}, count: 2, statusCounts: {} }
+ *     { connector: {...}, count: 4 },
+ *     { connector: {...}, count: 2 }
  *   ]
  * };
  * ```
@@ -526,13 +522,6 @@ export declare type ChargingConnectionInfo = {
  * @group Place
  */
 export declare type ChargingPark = {
-    /**
-     * Array of all unique connector types offered at this charging park.
-     *
-     * Each connector represents a different charging standard available.
-     * Use this to determine compatibility with your vehicle.
-     */
-    connectors: Connector[];
     /**
      * Count of connectors grouped by type and power level.
      *
@@ -544,7 +533,7 @@ export declare type ChargingPark = {
      * For real-time availability, use the availability property instead.
      * This field shows total counts regardless of current operational status.
      */
-    connectorCounts: ConnectorCount[];
+    connectors: ConnectorCount[];
 };
 
 /**
@@ -557,7 +546,6 @@ export declare type ChargingPark = {
  * ```typescript
  * const parkWithAvailability: ChargingParkWithAvailability = {
  *   connectors: [...],
- *   connectorCounts: [...],
  *   availability: {
  *     id: 'park-123',
  *     chargingStations: [...],
@@ -583,7 +571,7 @@ export declare type ChargingParkWithAvailability = ChargingPark & {
      * 2. Call the EV Charging Stations Availability service
      * 3. Merge the result into this property
      */
-    availability?: ChargingStationsAvailability;
+    availability: ChargingStationsAvailability;
 };
 
 /**
@@ -631,6 +619,7 @@ export declare type ChargingPaymentOption = {
  * Individual charging point (EVSE - Electric Vehicle Supply Equipment).
  *
  * Represents a single charging unit with one or more connectors.
+ * A charging point can have several charging connectors, of which only one can be used at a time.
  *
  * @remarks
  * A charging station typically contains multiple charging points.
@@ -829,7 +818,7 @@ export declare type ChargingSpeed = 'slow' | 'regular' | 'fast' | 'ultra-fast';
  * Electric vehicle charging station.
  *
  * Represents a complete charging station facility with one or more charging points.
- * A station is typically at a single location but may have multiple charging units.
+ * A station is typically at a single location but may have multiple charging points.
  *
  * @example
  * ```typescript
@@ -1367,7 +1356,7 @@ export declare type Connector = {
     /**
      * Unique identifier for this connector.
      */
-    id: string;
+    id?: string;
     /**
      * Physical connector type/standard.
      *
@@ -1798,7 +1787,6 @@ export declare type EntryPointType = 'main' | 'minor';
  *   // EV-specific properties
  *   chargingPark: {
  *     connectors: [...],
- *     connectorCounts: [...],
  *     availability: {...}
  *   }
  * };
@@ -1806,14 +1794,14 @@ export declare type EntryPointType = 'main' | 'minor';
  *
  * @group Place
  */
-export declare type EVChargingStationPlaceProps = Omit<CommonPlaceProps, 'chargingPark'> & {
+export declare type EVChargingStationWithAvailabilityPlaceProps = Omit<CommonPlaceProps, 'chargingPark'> & {
     /**
      * Charging infrastructure and availability information.
      *
      * Contains details about available connectors, counts, and optionally
      * real-time availability status if fetched from the availability service.
      */
-    chargingPark?: ChargingParkWithAvailability;
+    chargingPark: ChargingParkWithAvailability;
 };
 
 /**
@@ -2961,7 +2949,7 @@ export declare type MapcodeType = 'Local' | 'International' | 'Alternative';
  * Merges the global configuration into the given one, with the latter having priority.
  * @ignore
  */
-export declare const mergeFromGlobal: <T extends Partial<GlobalConfig>>(givenConfig?: T) => T;
+export declare const mergeFromGlobal: <T extends Partial<GlobalConfig>>(givenConfig?: T) => GlobalConfig & T;
 
 /**
  * Date and time with convenient derived properties.

package/core/package.json

@@ -38,8 +38,8 @@
     "ts-node": "catalog:",
     "typescript": "catalog:",
     "vite": "catalog:",
-    "vitest": "catalog:",
-    "vite-plugin-dts": "catalog:"
+    "vite-plugin-dts": "catalog:",
+    "vitest": "catalog:"
   },
   "typedoc": {
     "entryPoint": "./index.ts"

package/map/dist/THIRD_PARTY.txt

@@ -63,7 +63,7 @@ terms above.
 ---
 
 Name: @turf/helpers
-Version: 7.3.1
+Version: 7.3.2
 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.1
+Version: 7.3.2
 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.1
+Version: 7.3.2
 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.15.0
+Version: 5.16.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

@@ -3607,6 +3607,14 @@ export declare type IncidentsConfig = MapModuleCommonConfig & IncidentsCommonCon
  */
 export declare const INDEX_TYPE = "indexType";
 
+/**
+ * Complete TomTom map parameters after merging with global configuration.
+ * This type represents the fully resolved configuration used internally by the SDK.
+ *
+ * @ignore
+ */
+export declare type InternalTomTomMapParams = GlobalConfig & TomTomMapParams;
+
 /**
  * Function signature to filter layers.
  * @ignore
@@ -3906,7 +3914,7 @@ declare const mapFonts: readonly ["Noto-Regular", "NotoSans-MediumItalic", "Noto
  * - Rendering options (antialiasing, terrain)
  * - Localization and accessibility
  *
- * @see [MapLibre MapOptions](https://maplibre.org/maplibre-gl-js-docs/api/map/)
+ * @see [MapLibre MapOptions](https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/MapOptions/)
  *
  * @group Map
  */
@@ -7062,38 +7070,38 @@ export declare type ToBeAddedLayerSpecWithoutSource<L extends LayerSpecification
  * ```typescript
  * import { TomTomMap } from '@tomtom-international/maps-sdk-js/map';
  *
- * const map = new TomTomMap(
- *   {
+ * const map = new TomTomMap({
+ *   key: 'YOUR_API_KEY',
+ *   style: 'standardLight',
+ *   mapLibre: {
  *     container: 'map',
  *     center: [4.9041, 52.3676],
  *     zoom: 10
- *   },
- *   {
- *     key: 'YOUR_API_KEY',
- *     style: 'standardLight'
  *   }
- * );
+ * });
  * ```
  *
  * @example
  * With modules and configuration:
  * ```typescript
- * const map = new TomTomMap(
- *   { container: 'map', center: [-74.006, 40.7128], zoom: 12 },
- *   {
- *     key: 'YOUR_API_KEY',
- *     style: {
- *       type: 'standard',
- *       id: 'standardDark',
- *       include: ['trafficFlow', 'trafficIncidents']
- *     },
- *     language: 'en-US',
- *     events: {
- *       precisionMode: 'point-then-box',
- *       cursorOnHover: 'pointer'
- *     }
+ * const map = new TomTomMap({
+ *   key: 'YOUR_API_KEY',
+ *   style: {
+ *     type: 'standard',
+ *     id: 'standardDark',
+ *     include: ['trafficFlow', 'trafficIncidents']
+ *   },
+ *   language: 'en-US',
+ *   events: {
+ *     precisionMode: 'point-then-box',
+ *     cursorOnHover: 'pointer'
+ *   },
+ *   mapLibre: {
+ *     container: 'map',
+ *     center: [-74.006, 40.7128],
+ *     zoom: 12
  *   }
- * );
+ * });
  *
  * // Access MapLibre functionality directly
  * map.mapLibreMap.on('load', () => {
@@ -7168,18 +7176,14 @@ export declare class TomTomMap {
     /**
      * @ignore
      */
-    _params: TomTomMapParams;
+    _params: InternalTomTomMapParams;
     styleLightDarkTheme: LightDark;
     private readonly styleChangeHandlers;
     /**
      * Constructs a new TomTom Map instance and attaches it to a DOM element.
      *
-     * @param mapLibreOptions - MapLibre map configuration for viewport, controls, and rendering.
-     * Includes properties like `container`, `center`, `zoom`, `bearing`, `pitch`, etc.
-     * See {@link MapLibreOptions} for all available options.
-     *
-     * @param mapParams - TomTom-specific parameters including API key, style, and events.
-     * Can be partially specified here if already set via global configuration.
+     * @param mapParams - Combined TomTom and MapLibre parameters for map initialization.
+     * Includes API key, style, events, and MapLibre options like container, center, zoom, etc.
      * See {@link TomTomMapParams} for all available parameters.
      *
      * @remarks
@@ -7196,17 +7200,32 @@ export declare class TomTomMap {
      * @example
      * Minimal initialization:
      * ```typescript
-     * const map = new TomTomMap(
-     *   { container: 'map', center: [0, 0], zoom: 2 },
-     *   { key: 'YOUR_API_KEY' }
-     * );
+     * const map = new TomTomMap({
+     *   key: 'YOUR_API_KEY',
+     *   mapLibre: {
+     *     container: 'map',
+     *     center: [0, 0],
+     *     zoom: 2
+     *   }
+     * });
      * ```
      *
      * @example
      * Full configuration:
      * ```typescript
-     * const map = new TomTomMap(
-     *   {
+     * const map = new TomTomMap({
+     *   key: 'YOUR_API_KEY',
+     *   style: {
+     *     type: 'standard',
+     *     id: 'standardLight',
+     *     include: ['trafficFlow', 'hillshade']
+     *   },
+     *   language: 'en-US',
+     *   events: {
+     *     precisionMode: 'point-then-box',
+     *     paddingBoxPx: 10
+     *   },
+     *   mapLibre: {
      *     container: 'map',
      *     center: [-122.4194, 37.7749],
      *     zoom: 13,
@@ -7215,21 +7234,8 @@ export declare class TomTomMap {
      *     antialias: true,
      *     maxZoom: 18,
      *     minZoom: 8
-     *   },
-     *   {
-     *     key: 'YOUR_API_KEY',
-     *     style: {
-     *       type: 'standard',
-     *       id: 'standardLight',
-     *       include: ['trafficFlow', 'hillshade']
-     *     },
-     *     language: 'en-US',
-     *     events: {
-     *       precisionMode: 'point-then-box',
-     *       paddingBoxPx: 10
-     *     }
      *   }
-     * );
+     * });
      * ```
      *
      * @throws Will log errors if RTL text plugin fails to load (non-blocking)
@@ -7241,7 +7247,7 @@ export declare class TomTomMap {
      * @see [Map Styles Guide](https://docs.tomtom.com/maps-sdk-js/guides/map/map-styles)
      * @see [User Interaction Events Guide](https://docs.tomtom.com/maps-sdk-js/guides/map/user-events)
      */
-    constructor(mapLibreOptions: MapLibreOptions, mapParams?: Partial<TomTomMapParams>);
+    constructor(mapParams: TomTomMapParams);
     private loadRTLTextPlugin;
     /**
      * Dynamically loads the MapLibre CSS stylesheet from CDN.
@@ -7579,25 +7585,29 @@ export declare class TomTomMap {
 /**
  * Parameters for initializing a TomTom map instance.
  *
- * Combines global SDK configuration with map-specific settings like style and events.
+ * Combines global SDK configuration with map-specific settings like style, events, and MapLibre options.
+ * All GlobalConfig properties (key, baseURL, etc.) are optional and will be merged from global configuration.
+ * Only mapLibre.container is strictly required.
  *
  * @example
  * ```typescript
  * const mapParams: TomTomMapParams = {
  *   key: 'your-api-key',
- *   container: 'map-container',
- *   center: [4.9041, 52.3676],
- *   zoom: 12,
  *   style: 'standardLight',
  *   events: {
  *     onClick: (event) => console.log('Map clicked', event)
+ *   },
+ *   mapLibre: {
+ *     container: 'map-container',
+ *     center: [4.9041, 52.3676],
+ *     zoom: 12
  *   }
  * };
  * ```
  *
  * @group Map
  */
-export declare type TomTomMapParams = GlobalConfig & {
+export declare type TomTomMapParams = Partial<GlobalConfig> & {
     /**
      * Map style to load.
      *
@@ -7637,6 +7647,26 @@ export declare type TomTomMapParams = GlobalConfig & {
      * ```
      */
     events?: MapEventsConfig;
+    /**
+     * MapLibre-specific options for map configuration.
+     *
+     * Includes options for viewport settings, interaction controls, rendering options, and more.
+     *
+     * @example
+     * ```typescript
+     * mapLibre: {
+     *   container: 'map',
+     *   center: [4.9041, 52.3676],
+     *   zoom: 12,
+     *   pitch: 45,
+     *   bearing: -17.6,
+     *   antialias: true,
+     *   maxZoom: 18,
+     *   minZoom: 8
+     * }
+     * ```
+     */
+    mapLibre: MapLibreOptions;
 };
 
 /**