@tomtom-org/maps-sdk 0.36.0 → 0.36.2

package/core/dist/index.d.ts

@@ -2165,7 +2165,7 @@ export declare type GetPositionOptions = {
  * }
  * ```
  *
- * @group Shared
+ * @ignore
  */
 export declare const getPositionStrict: (hasLngLat: HasLngLat, options?: GetPositionOptions) => Position;
 
@@ -3432,6 +3432,15 @@ export declare type POI = {
     timeZone?: TimeZone;
 };
 
+/**
+ * POI categories were retrieved from https://docs.tomtom.com/search-api/documentation/poi-categories-service/poi-categories
+ * so it can be passed to search endpoints in a human-readable format in addition to being able to use POI category ID directly
+ * categories were put in this format trying to match them poi classification codes as much as possible.
+ *
+ * @ignore
+ */
+export declare const poiCategoriesToID: Record<POICategory, number>;
+
 /**
  * @group Place
  */
@@ -3470,6 +3479,13 @@ export declare type PoiDetailsDataSource = {
     sourceName?: string;
 };
 
+/**
+ * Inverted mapping of POI category IDs to their corresponding category names.
+ *
+ * @ignore
+ */
+export declare const poiIDsToCategories: Record<number, POICategory>;
+
 /**
  * GeoJSON Feature containing polygon or multi-polygon geometry.
  *
@@ -4447,9 +4463,8 @@ export declare type TomTomHeaders = {
 
 /**
  * @ignore
- * @param lngLat
  */
-export declare const toPointFeature: (lngLat: Position) => Feature<Point>;
+export declare const toPointFeature: (coordinates: Position) => Feature<Point>;
 
 /**
  * All possible traffic incident categories.

package/map/dist/THIRD_PARTY.txt

@@ -63,7 +63,7 @@ terms above.
 ---
 
 Name: @tomtom-org/maps-sdk
-Version: 0.36.0
+Version: 0.36.2
 License: See in LICENSE.txt
 Private: false
 Description: TomTom Maps for JavaScript

package/map/dist/index.d.ts

@@ -3504,9 +3504,10 @@ export declare type LightDark = 'light' | 'dark';
 export declare const MAJOR_DELAY_COLOR = "#AD0000";
 
 /**
+ * POI category mappings that have a direct equivalent in Map Display POI categories.
  * @ignore
  */
-declare const mapDisplayPoiCategoryMappings: Partial<Record<POICategory, string>>;
+export declare const mapDisplayPoiCategoryMappings: Partial<Record<POICategory, string>>;
 
 /**
  * Configuration options for map user event handling.
@@ -4171,15 +4172,39 @@ export declare type PlaceIconConfig = {
      */
     categoryIcons?: CustomImage<MapStylePOICategory>[];
     /**
-     * Custom mapping function to generate the icon ID for a given place.
+     * Custom mapping to determine the icon for a given place.
      *
      * @remarks
-     * If provided, this function sets the iconID property on the place.
-     * This allows for full control on how to determine which icon to use for each place based on its properties.
+     * Supports two mapping strategies:
      *
-     * @param place The place to generate the icon ID for.
+     * - **`imageID`**: Directly returns the icon image ID to use for the place.
+     *   This provides full control over icon selection.
+     *
+     * - **`poiCategory`**: Returns a POI category, which is then resolved to an icon
+     *   using the existing category-to-icon logic. This reuses the standard category mapping.
+     *
+     * @example
+     * ```typescript
+     * // Direct image ID mapping
+     * mapping: {
+     *   to: 'imageID',
+     *   fn: (place) => place.properties.poi?.name?.includes('urgent') ? 'urgent-icon' : 'default-icon'
+     * }
+     *
+     * // POI category mapping
+     * mapping: {
+     *   to: 'poiCategory',
+     *   fn: (place) => place.properties.customCategory || 'RESTAURANT'
+     * }
+     * ```
      */
-    mapping?: (place: Place) => string;
+    mapping?: {
+        to: 'imageID';
+        fn: (place: Place) => string;
+    } | {
+        to: 'poiCategory';
+        fn: (place: Place) => MapStylePOICategory;
+    };
 };
 
 /**
@@ -6855,6 +6880,11 @@ export declare const tertiaryRoadCategories: readonly ["connecting", "major_loca
  */
 export declare type TertiaryRoadCategory = (typeof tertiaryRoadCategories)[number];
 
+/**
+ * @ignore
+ */
+export declare const toBaseMapPOICategory: (category: POICategory) => string;
+
 /**
  * Layer to be added to the existing style, and may include extra config such as the ID of the layer to add it under.
  * * e.g. GeoJSON layers.
@@ -6887,11 +6917,6 @@ export declare type ToBeAddedLayerSpecTemplate<L extends LayerSpecification = La
  */
 export declare type ToBeAddedLayerSpecWithoutSource<L extends LayerSpecification = LayerSpecification> = Omit<ToBeAddedLayerSpec<L>, 'source'>;
 
-/**
- * @ignore
- */
-export declare const toMapDisplayPOICategory: (category: POICategory) => string;
-
 /**
  * Main TomTom Map class for displaying interactive maps in web applications.
  *