@tomtom-org/maps-sdk 0.30.2 → 0.31.0

package/map/dist/index.d.ts

@@ -3,6 +3,7 @@ import { BackgroundLayerSpecification } from 'maplibre-gl';
 import { BBox } from 'geojson';
 import { ChargingSpeed } from '../../../../core';
 import { ChargingStop } from '../../../../core';
+import { CircleLayerSpecification } from 'maplibre-gl';
 import { CommonPlaceProps } from '../../../../core';
 import { DataDrivenPropertyValueSpecification } from 'maplibre-gl';
 import { DelayMagnitude } from '../../../../core';
@@ -951,6 +952,31 @@ export declare const buildPlaceTitle: (place: Place_2) => string;
  */
 export declare const buildRoutingLayers: (config?: RoutingModuleConfig) => Required<RouteLayersConfig>;
 
+/**
+ * Parameters to identify a feature by its ID or index in a given features array.
+ * @group User Events
+ */
+export declare type ByIdOrIndex = {
+    /**
+     * The unique identifier of the feature.
+     *
+     * @remarks
+     * This ID corresponds to the `id` property of the feature being targeted.
+     * Cannot be used together with `index`.
+     */
+    id: string;
+} | {
+    /**
+     * The index of the feature in the feature array.
+     *
+     * @remarks
+     * Zero-based index referring to the position in the features array
+     * that was passed to the module's show method.
+     * Cannot be used together with `id`.
+     */
+    index: number;
+};
+
 /**
  * Mapping of charging stop speeds to sprite image IDs.
  * @group Routing
@@ -1058,7 +1084,7 @@ export declare type ChargingStopTextConfig = {
      *
      * @see https://maplibre.org/maplibre-style-spec/types/#formatted
      */
-    title?: ExpressionSpecification;
+    title?: DataDrivenPropertyValueSpecification<string>;
 };
 
 /**
@@ -1084,15 +1110,7 @@ export declare type ChargingStopTextConfig = {
  *
  * @group User Events
  */
-export declare type CleanEventStateOptions = {
-    /**
-     * The index of the feature in the feature array.
-     *
-     * @remarks
-     * Zero-based index referring to the position in the features array
-     * that was passed to the module's show method.
-     */
-    index: number;
+export declare type CleanEventStateOptions = ByIdOrIndex & {
     /**
      * Whether to show the feature after cleaning the event state.
      *
@@ -1822,30 +1840,22 @@ declare type DisplaySectionProps = SectionProps & DisplayRouteRelatedProps;
  * };
  * ```
  *
- * @group Routing
  * @ignore
  */
 declare type DisplayTrafficSectionProps = DisplaySectionProps & TrafficSectionProps & {
     /**
-     * Icon ID for the section leading icon.
-     *
-     * @remarks
-     * References an icon in the map style sprite, used to visually
-     * represent the type of traffic incident or delay.
-     *
-     * @example
-     * ```typescript
-     * iconID: 'traffic-jam'
-     * iconID: 'accident'
-     * iconID: 'road-closure'
-     * ```
+     * Icon ID for jam category, if any.
+     */
+    jamIconID?: string;
+    /**
+     * Icon ID for the main cause of the incident, if any (roadworks, weather-related, accident...).
      */
-    iconID?: string;
+    causeIconID?: string;
     /**
      * Title for the traffic section.
      *
      * @remarks
-     * By default consists of the incident delay if any, but can be
+     * By default, consists of the incident delay if any, but can be
      * customized to provide more detailed information.
      *
      * @example
@@ -2334,6 +2344,7 @@ export declare class GeoJSONSourceWithLayers<T extends FeatureCollection = Featu
     constructor(map: Map_2, sourceId: string, layerSpecs: ToBeAddedLayerSpecWithoutSource[], addLayersToMap?: boolean);
     show(featureCollection: T): void;
     clear(): void;
+    private findFeature;
     putEventState(options: PutEventStateOptions): void;
     cleanEventState(options: CleanEventStateOptions): void;
     cleanEventStates(options?: CleanEventStatesOptions): void;
@@ -3039,10 +3050,9 @@ export declare type GeometryTextConfig = {
 /**
  * Gets the map style sprite image ID to display on the map for the give place.
  * @param place The place to display.
- * @param map
  * @param config
  */
-export declare const getIconIDForPlace: (place: Place_2, config?: PlacesModuleConfig, map?: Map_2) => string;
+export declare const getIconIDForPlace: (place: Place_2, config?: PlacesModuleConfig) => string;
 
 /**
  * Maps a Place category to the poi layer one, so the latter's style can apply it.
@@ -3057,6 +3067,11 @@ export declare const getPOILayerCategoryForPlace: (place: Place_2) => string | u
  */
 export declare const getStyleCategories: (categories: FilterablePOICategory[]) => string[];
 
+/**
+ * Configuration for adding custom layers to a map module based on its controlled source data.
+ *
+ * @group Shared
+ */
 export declare type HasAdditionalLayersConfig = {
     /**
      * Additional custom layers to be added alongside the predefined ones.
@@ -3065,11 +3080,11 @@ export declare type HasAdditionalLayersConfig = {
      * Allows for further customization by specifying extra layers that
      * complement the standard route visualization layers.
      *
-     * Use these if you want to add extra visuals to a specific route part, be it lines, or symbols.
+     * Use these if you want to add extra visuals to a specific module part, be it lines, symbols, or any MapLibre supported layer.
      *
      * You can define 'beforeID' in the additional layers to place them under predefined ones (or other of your additional layers).
      */
-    additional?: Record<string, ToBeAddedLayerSpecTemplate<LineLayerSpecification | SymbolLayerSpecification>>;
+    additional?: Record<string, ToBeAddedLayerSpecTemplate<SymbolLayerSpecification | LineLayerSpecification | CircleLayerSpecification>>;
 };
 
 /**
@@ -3306,31 +3321,6 @@ declare type HillshadeSourcesWithLayers = {
  */
 export declare type HoverEventType = 'hover' | 'long-hover';
 
-/**
- * Icon style options for displaying places on the map.
- *
- * @remarks
- * **Available Styles:**
- * - `pin`: Traditional map pin markers (teardrop shape)
- * - `circle`: Simple circular markers
- * - `poi-like`: Mimics the map's built-in POI layer style with category icons
- *
- * @example
- * ```typescript
- * // Use pin markers
- * const iconStyle: IconStyle = 'pin';
- *
- * // Use circles for minimal design
- * const iconStyle: IconStyle = 'circle';
- *
- * // Match map POI style
- * const iconStyle: IconStyle = 'poi-like';
- * ```
- *
- * @group Places
- */
-export declare type IconStyle = 'pin' | 'circle' | 'poi-like';
-
 /**
  * Available traffic incident category identifiers.
  *
@@ -4052,7 +4042,7 @@ export declare type PlaceDisplayProps = {
      */
     iconID: string;
     /**
-     * Map-style-compatible display category, mostly applicable for poi-like places.
+     * Map-style-compatible display category, mostly applicable for base-map places.
      *
      * @remarks
      * Used to match the place with a POI category in the map style, enabling
@@ -4065,7 +4055,7 @@ export declare type PlaceDisplayProps = {
      * - PARKING_GARAGE
      * - SHOPPING
      *
-     * Optional - only needed when using poi-like styling or category-based filtering.
+     * Optional - only needed when using base-map styling or category-based filtering.
      *
      * @example
      * ```typescript
@@ -4081,18 +4071,12 @@ export declare type PlaceDisplayProps = {
 /**
  * Configuration for place marker icons.
  *
- * Controls the visual appearance of place markers including style and custom icons.
+ * Controls the visual appearance of place markers including custom icons.
  *
  * @example
  * ```typescript
- * // Use pin style
- * const iconConfig: PlaceIconConfig = {
- *   iconStyle: 'pin'
- * };
- *
  * // Custom icons for specific categories
  * const iconConfig: PlaceIconConfig = {
- *   iconStyle: 'poi-like',
  *   customIcons: [
  *     { category: 'RESTAURANT', image: '/icons/food.png', pixelRatio: 2 },
  *     { category: 'HOTEL_MOTEL', image: '/icons/hotel.png', pixelRatio: 2 }
@@ -4103,12 +4087,6 @@ export declare type PlaceDisplayProps = {
  * @group Places
  */
 export declare type PlaceIconConfig = {
-    /**
-     * Base icon style for all places.
-     *
-     * @default 'pin'
-     */
-    iconStyle?: IconStyle;
     /**
      * Array of custom icons for specific place categories.
      *
@@ -4118,6 +4096,72 @@ export declare type PlaceIconConfig = {
     customIcons?: CustomImage<MapStylePOICategory>[];
 };
 
+/**
+ * @group Places
+ */
+export declare type PlaceLayerName = keyof PlaceLayersConfig;
+
+/**
+ * Configuration for custom place layer styling with MapLibre specifications.
+ *
+ * @remarks
+ * Provides fine-grained control over place marker layers, allowing customization
+ * of both the main place markers and highlighted/selected place markers.
+ *
+ * The layer IDs are derived from the PlacesModule instance prefix plus the key suffix:
+ * - `main`: The primary layer for displaying all places
+ * - `selected`: The layer for displaying highlighted/clicked places (rendered on top)
+ *
+ * All fields are optional. When a field is not provided, the default styling will be used.
+ *
+ * @example
+ * ```typescript
+ * const config: PlacesModuleConfig = {
+ *   layers: {
+ *     main: {
+ *       layout: {
+ *         'icon-size': 1.2,
+ *         'text-size': 14
+ *       },
+ *       paint: {
+ *         'text-color': '#333'
+ *       }
+ *     },
+ *     selected: {
+ *       layout: {
+ *         'icon-size': 1.5,
+ *         'text-allow-overlap': true
+ *       },
+ *       paint: {
+ *         'text-color': '#3f9cd9'
+ *       }
+ *     }
+ *   }
+ * };
+ * ```
+ *
+ * @group Places
+ */
+export declare type PlaceLayersConfig = {
+    /**
+     * Main place marker layer specification.
+     *
+     * @remarks
+     * Controls the visual appearance of all place markers on the map.
+     * This layer renders places that are not in a highlighted/selected state.
+     */
+    main?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
+    /**
+     * Selected/highlighted place marker layer specification.
+     *
+     * @remarks
+     * Controls the visual appearance of places when they are highlighted or selected
+     * (e.g., on hover or click events). This layer is rendered on top of the main layer
+     * to ensure selected places are always visible.
+     */
+    selected?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
+} & HasAdditionalLayersConfig;
+
 /**
  * Source identifier prefix for places (geocoding results) features.
  *
@@ -4148,7 +4192,7 @@ export declare const PLACES_SOURCE_PREFIX_ID = "places";
  * **Marker Styles:**
  * - `pin`: Traditional teardrop-shaped map pins
  * - `circle`: Simple circular markers
- * - `poi-like`: Mimics built-in POI layer styling
+ * - `base-map`: Mimics built-in POI layer styling
  *
  * **Common Use Cases:**
  * - Search result visualization
@@ -4161,16 +4205,17 @@ export declare const PLACES_SOURCE_PREFIX_ID = "places";
  * ```typescript
  * // Create places module with pin markers
  * const places = await PlacesModule.get(map, {
- *   iconConfig: {
- *     iconStyle: 'pin'
+ *   icon: {
+ *     customIcons: []
  *   },
- *   textConfig: {
- *     textField: (place) => place.properties.poi?.name || 'Unknown'
- *   }
+ *   text: {
+ *     field: (place) => place.properties.poi?.name || 'Unknown'
+ *   },
+ *   theme: 'pin'
  * });
  *
  * // Display places from search
- * await places.add(searchResults);
+ * await places.show(searchResults);
  *
  * // Handle clicks
  * places.events.on('click', (feature) => {
@@ -4209,6 +4254,7 @@ export declare class PlacesModule extends AbstractMapModule<PlacesSourcesAndLaye
      * @ignore
      */
     protected _initSourcesWithLayers(config?: PlacesModuleConfig, restore?: boolean): PlacesSourcesAndLayers;
+    private buildLayerSpecs;
     /**
      * @ignore
      */
@@ -4217,6 +4263,33 @@ export declare class PlacesModule extends AbstractMapModule<PlacesSourcesAndLaye
      * @ignore
      */
     protected restoreDataAndConfigImpl(): void;
+    /**
+     * Updates the visual theme for displayed places.
+     *
+     * @param theme - The theme style to apply to place markers.
+     *
+     * @remarks
+     * **Available Themes:**
+     * - `pin`: Traditional teardrop-shaped map pins
+     * - `circle`: Simple circular markers
+     * - `base-map`: Mimics the map's built-in POI layer style with category icons
+     *
+     * Changes apply immediately to all currently shown places. Other configuration
+     * properties (icon config, text config) remain unchanged.
+     *
+     * @example
+     * ```typescript
+     * // Switch to pin markers
+     * places.applyTheme('pin');
+     *
+     * // Use simple circles
+     * places.applyTheme('circle');
+     *
+     * // Match map's POI style (ideal to blend in)
+     * places.applyTheme('base-map');
+     * ```
+     */
+    applyTheme(theme: PlacesTheme): void;
     /**
      * Updates the icon configuration for displayed places.
      *
@@ -4230,13 +4303,8 @@ export declare class PlacesModule extends AbstractMapModule<PlacesSourcesAndLaye
      * @example
      * ```typescript
      * places.applyIconConfig({
-     *   iconStyle: 'circle'
-     * });
-     *
-     * // Add custom icons
-     * places.applyIconConfig({
      *   customIcons: [
-     *     { category: 'RESTAURANT', image: '/icons/food.png' }
+     *     { category: 'RESTAURANT', id: 'restaurant-icon', image: '/icons/food.png' }
      *   ]
      * });
      * ```
@@ -4254,18 +4322,19 @@ export declare class PlacesModule extends AbstractMapModule<PlacesSourcesAndLaye
      * ```typescript
      * // Use function
      * places.applyTextConfig({
-     *   textField: (place) => place.properties.poi?.name || 'Unknown'
+     *   field: (place) => place.properties.poi?.name || 'Unknown'
      * });
      *
      * // Use MapLibre expression
      * places.applyTextConfig({
-     *   textField: ['get', 'title'],
-     *   textSize: 14,
-     *   textColor: '#333'
+     *   field: ['get', 'title'],
+     *   size: 14,
+     *   color: '#333'
      * });
      * ```
      */
     applyTextConfig(textConfig: PlaceTextConfig): void;
+    private applyConfigPart;
     /**
      * Applies additional feature properties to displayed places.
      *
@@ -4410,29 +4479,29 @@ export declare class PlacesModule extends AbstractMapModule<PlacesSourcesAndLaye
  * ```typescript
  * // Basic configuration
  * const config: PlacesModuleConfig = {
- *   iconConfig: {
- *     iconStyle: 'pin'
+ *   icon: {
+ *     style: 'pin'
  *   },
- *   textConfig: {
- *     textField: (place) => place.properties.poi?.name || 'Unknown',
- *     textSize: 12
+ *   text: {
+ *     field: (place) => place.properties.poi?.name || 'Unknown',
+ *     size: 12
  *   }
  * };
  *
  * // Advanced configuration with custom properties
  * const config: PlacesModuleConfig = {
- *   iconConfig: {
- *     iconStyle: 'poi-like',
+ *   icon: {
+ *     style: 'base-map',
  *     customIcons: [
  *       { category: 'RESTAURANT', image: '/icons/restaurant.png' }
  *     ]
  *   },
- *   textConfig: {
- *     textField: ['get', 'title'],
- *     textSize: 14,
- *     textColor: '#333',
- *     textHaloColor: '#fff',
- *     textHaloWidth: 2
+ *   text: {
+ *     field: ['get', 'title'],
+ *     size: 14,
+ *     color: '#333',
+ *     haloColor: '#fff',
+ *     haloWidth: 2
  *   },
  *   extraFeatureProps: {
  *     category: (place) => place.properties.poi?.categories?.[0],
@@ -4444,18 +4513,38 @@ export declare class PlacesModule extends AbstractMapModule<PlacesSourcesAndLaye
  * @group Places
  */
 export declare type PlacesModuleConfig = {
+    /**
+     * Base style for all places.
+     *
+     * @remarks
+     * Can be overwritten by more advanced icon configurations.
+     *
+     * @default 'pin'
+     */
+    theme?: PlacesTheme;
     /**
      * Icon appearance configuration.
      *
      * Controls marker style and custom icons for different place categories.
      */
-    iconConfig?: PlaceIconConfig;
+    icon?: PlaceIconConfig;
     /**
      * Text label configuration.
      *
      * Controls label content, styling, and positioning.
      */
-    textConfig?: PlaceTextConfig;
+    text?: PlaceTextConfig;
+    /**
+     * Custom layer styling configuration.
+     *
+     * @remarks
+     * * Overrides the default layer styling with custom specifications.
+     * * You must provide complete layer specifications for any layers you wish to customize.
+     * * You can still reuse the default configurations if you want incremental changes. See: buildPlacesLayerSpecs.
+     * * Any layer not specified will continue to use its default styling.
+     * * Use this only if you need fine MapLibre control on how places are displayed.
+     */
+    layers?: PlaceLayersConfig;
     /**
      * Additional properties to compute for each place feature.
      *
@@ -4499,6 +4588,19 @@ declare type PlacesSourcesAndLayers = {
     places: GeoJSONSourceWithLayers<Places<DisplayPlaceProps>>;
 };
 
+/**
+ * Icon style options for displaying places on the map.
+ *
+ * @remarks
+ * **Available Styles:**
+ * - `pin`: Traditional map pin markers (teardrop shape)
+ * - `circle`: Simple circular markers
+ * - `base-map`: Mimics the map's built-in POI layer style with category icons
+ *
+ * @group Places
+ */
+export declare type PlacesTheme = 'pin' | 'circle' | 'base-map';
+
 /**
  * Configuration for place text labels.
  *
@@ -4513,16 +4615,16 @@ declare type PlacesSourcesAndLayers = {
  * ```typescript
  * // Simple text from place name
  * const textConfig: PlaceTextConfig = {
- *   textField: (place) => place.properties.poi?.name || place.properties.address.freeformAddress
+ *   field: (place) => place.properties.poi?.name || place.properties.address.freeformAddress
  * };
  *
  * // Using MapLibre expression with styling
  * const textConfig: PlaceTextConfig = {
- *   textField: ['get', 'title'],
- *   textSize: 14,
- *   textColor: '#333',
- *   textHaloColor: '#fff',
- *   textHaloWidth: 2
+ *   field: ['get', 'title'],
+ *   size: 14,
+ *   color: '#333',
+ *   haloColor: '#fff',
+ *   haloWidth: 2
  * };
  * ```
  *
@@ -4532,24 +4634,24 @@ export declare type PlaceTextConfig = {
     /**
      * Text content for the label.
      *
-     * Can be a function that extracts text from the place properties,
-     * or a MapLibre expression for data-driven content.
+     * Can be a function that extracts text from the place properties (data-based),
+     * or a MapLibre expression for data-driven content (data-driven layer-based).
      *
      * @example
      * ```typescript
      * // Function
-     * textField: (place) => place.properties.poi?.name || 'Unknown'
+     * title: (place) => place.properties.poi?.name || 'Unknown'
      *
      * // MapLibre expression
-     * textField: ['get', 'title']
+     * title: ['get', 'title']
      *
      * // Conditional expression
-     * textField: ['case', ['has', 'name'], ['get', 'name'], ['get', 'address']]
+     * title: ['case', ['has', 'name'], ['get', 'name'], ['get', 'address']]
      * ```
      *
      * @see https://maplibre.org/maplibre-style-spec/types/#formatted
      */
-    textField?: ((place: Place) => string) | DataDrivenPropertyValueSpecification<string>;
+    title?: ((place: Place) => string) | DataDrivenPropertyValueSpecification<string>;
     /**
      * Font size in pixels.
      *
@@ -4557,13 +4659,13 @@ export declare type PlaceTextConfig = {
      *
      * @example
      * ```typescript
-     * textSize: 14
+     * size: 14
      *
      * // Data-driven size based on importance
-     * textSize: ['interpolate', ['linear'], ['get', 'priority'], 1, 16, 10, 10]
+     * size: ['interpolate', ['linear'], ['get', 'priority'], 1, 16, 10, 10]
      * ```
      */
-    textSize?: DataDrivenPropertyValueSpecification<number>;
+    size?: DataDrivenPropertyValueSpecification<number>;
     /**
      * Text color.
      *
@@ -4571,22 +4673,22 @@ export declare type PlaceTextConfig = {
      *
      * @example
      * ```typescript
-     * textColor: '#333333'
+     * color: '#333333'
      *
      * // Category-based colors
-     * textColor: ['match', ['get', 'category'], 'RESTAURANT', '#D32F2F', '#1976D2']
+     * color: ['match', ['get', 'category'], 'RESTAURANT', '#D32F2F', '#1976D2']
      * ```
      */
-    textColor?: DataDrivenPropertyValueSpecification<string>;
+    color?: DataDrivenPropertyValueSpecification<string>;
     /**
      * Font face(s) to use for the text.
      *
      * @example
      * ```typescript
-     * textFont: ['Open Sans Bold', 'Arial Unicode MS Bold']
+     * font: ['Open Sans Bold', 'Arial Unicode MS Bold']
      * ```
      */
-    textFont?: DataDrivenPropertyValueSpecification<Array<MapFont>>;
+    font?: DataDrivenPropertyValueSpecification<Array<MapFont>>;
     /**
      * Text halo (outline) color for better readability.
      *
@@ -4594,10 +4696,10 @@ export declare type PlaceTextConfig = {
      *
      * @example
      * ```typescript
-     * textHaloColor: '#fff'
+     * haloColor: '#fff'
      * ```
      */
-    textHaloColor?: DataDrivenPropertyValueSpecification<string>;
+    haloColor?: DataDrivenPropertyValueSpecification<string>;
     /**
      * Text halo (outline) width in pixels.
      *
@@ -4605,10 +4707,10 @@ export declare type PlaceTextConfig = {
      *
      * @example
      * ```typescript
-     * textHaloWidth: 2  // Thicker outline for better contrast
+     * haloWidth: 2  // Thicker outline for better contrast
      * ```
      */
-    textHaloWidth?: DataDrivenPropertyValueSpecification<number>;
+    haloWidth?: DataDrivenPropertyValueSpecification<number>;
     /**
      * Text offset from the icon in ems [x, y].
      *
@@ -4618,12 +4720,12 @@ export declare type PlaceTextConfig = {
      *
      * @example
      * ```typescript
-     * textOffset: [0, 1.5]  // Position text below icon
+     * offset: [0, 1.5]  // Position text below icon
      *
-     * textOffset: [1, 0]  // Position text to the right
+     * offset: [1, 0]  // Position text to the right
      * ```
      */
-    textOffset?: DataDrivenPropertyValueSpecification<[number, number]>;
+    offset?: DataDrivenPropertyValueSpecification<[number, number]>;
 };
 
 /**
@@ -5269,15 +5371,7 @@ export declare const preparePlacesForDisplay: (placesInput: Place_2 | Place_2[]
  *
  * @group User Events
  */
-export declare type PutEventStateOptions = {
-    /**
-     * The index of the feature in the feature array.
-     *
-     * @remarks
-     * Zero-based index referring to the position in the features array
-     * that was passed to the module's show method.
-     */
-    index: number;
+export declare type PutEventStateOptions = ByIdOrIndex & {
     /**
      * The event state to set.
      *
@@ -5509,12 +5603,19 @@ export declare type RouteLayersConfig = {
          */
         incident?: {
             /**
-             * Symbol layer used to mark the location of an incident on the route.
+             * Symbol layer used to mark the start of a jam on the route.
              *
              * @remarks
-             * Can display icons for accidents, roadworks, or other incidents.
+             * Focuses on displaying jams with delays.
              */
-            routeIncidentSymbol?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
+            routeIncidentJamSymbol?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
+            /**
+             * Symbol layer used to mark the cause of the start of an incident on the route.
+             *
+             * @remarks
+             * Can display icons for accidents, roadworks, weather, or other incidents.
+             */
+            routeIncidentCauseSymbol?: Partial<ToBeAddedLayerSpecTemplate<SymbolLayerSpecification>>;
             /**
              * Line layer used to draw the incident's background/highlight.
              *
@@ -5529,13 +5630,6 @@ export declare type RouteLayersConfig = {
              * Useful for indicating partial closures or advisory segments.
              */
             routeIncidentDashedLine?: Partial<ToBeAddedLayerSpecTemplate<LineLayerSpecification>>;
-            /**
-             * Line layer used to apply pattern-based styling for incident segments.
-             *
-             * @remarks
-             * Allows use of image patterns or custom line patterns for emphasis.
-             */
-            routeIncidentPatternLine?: Partial<ToBeAddedLayerSpecTemplate<LineLayerSpecification>>;
         } & HasAdditionalLayersConfig;
         /**
          * Toll road section layers.
@@ -6986,6 +7080,11 @@ export declare class TomTomMap {
      * @see [User Events Guide](https://docs.tomtom.com/maps-sdk-js/guides/map/user-events)
      */
     constructor(mapLibreOptions: MapLibreOptions, mapParams?: Partial<TomTomMapParams>);
+    private loadRTLTextPlugin;
+    /**
+     * Dynamically loads the MapLibre CSS stylesheet from CDN.
+     */
+    private ensureMapLibreCSSLoaded;
     /**
      * Changes the map style dynamically without reloading the entire map.
      *