@tomtom-org/maps-sdk-plugin-viewport-places 0.5.1 → 0.5.3

package/LICENSE.txt

@@ -1,8 +1,8 @@
 TOMTOM MAPS SDK FOR JAVASCRIPT LICENSE AGREEMENT (“AGREEMENT”)
 
-Last update: September 2026
+Last update: October 2026
 
-By downloading or accessing the “TomTom Maps SDK for JavaScript” (the “SDK”), you are entering into a binding agreement with TomTom Global Content B.V. (“TomTom”). The SDK comprises all software, binaries and source code made available by TomTom for it, whether through the TomTom Developer Portal or public code repositories (e.g. GitHub). This Agreement with TomTom consists of the terms and conditions below together with the Data Processing Schedule. You should not use the SDK if you cannot agree to both.
+By downloading or accessing the “TomTom Maps SDK for JavaScript” (the “SDK”), you are entering into a binding agreement with TomTom Global Content B.V. (“TomTom”). The SDK comprises all software, binaries and source code made available by TomTom for it, whether through the TomTom Developer Portal, package registries (e.g. npm) or otherwise. The example applications that TomTom publishes in public code repositories (e.g. GitHub) are not part of the SDK: they are licensed separately, under the license distributed with them. This Agreement with TomTom consists of the terms and conditions below together with the Data Processing Schedule. You should not use the SDK if you cannot agree to both.
 
 You may not use the SDK or accept this Agreement if you are barred from receiving it under the laws of the European Union or of any other country, including the country in which you are resident or from which you use the SDK. If you accept this Agreement on behalf of your employer or another entity, you represent and warrant that you have full legal authority to bind that employer or entity. If you do not have that authority, you may not accept this Agreement or use the SDK on their behalf.
 
@@ -14,7 +14,7 @@ You may not use the SDK or accept this Agreement if you are barred from receivin
 
 3.1. You agree to use the SDK only for purposes permitted by (a) this Agreement and (b) any applicable law, regulation or generally accepted practice or guideline in the relevant jurisdictions (including any laws regarding the export of data or software to and from the United States or other relevant countries).
 
-3.2. Other than as permitted by applicable legislation, you are prohibited from copying (except for backup purposes), modifying, adapting, (re)distributing, renting, lending, publicly presenting, decompiling, reverse engineering, disassembling or creating derivative works of the SDK or any part of it. Notwithstanding the foregoing, where the SDK is hosted on a public repository (e.g. GitHub, which allows forking under its terms of service), you may: (i) fork the repository solely for the purpose of submitting a pull request to TomTom, provided that such fork remains hosted within the platform and is not used as a basis for a separate or competing product or service; and (ii) download a local copy of the source code solely for the purpose of debugging your Permitted Application, provided that such copy is not shared or redistributed. The availability of the source code in a public repository does not constitute “Open-Source” licensing and grants you no rights under any Open Source Initiative (OSI) approved license. Neither that availability, nor any rights granted by the platform’s terms of service with respect to viewing or forking within the platform, shall be construed as a grant of rights to modify, fork or redistribute the SDK beyond those expressly granted in Clause 1 and this Clause 3.2.
+3.2. Other than as permitted by applicable legislation, you are prohibited from copying (except for backup purposes), modifying, adapting, (re)distributing, renting, lending, publicly presenting, decompiling, reverse engineering, disassembling or creating derivative works of the SDK or any part of it. Notwithstanding the foregoing, you may inspect the SDK as distributed to you, including any source code embedded in its source maps, solely for the purpose of debugging your Permitted Application, provided that it is not shared or redistributed. The readability of the SDK’s source code in its distribution does not constitute “Open-Source” licensing and grants you no rights under any Open Source Initiative (OSI) approved license, nor shall it be construed as a grant of rights to modify, fork or redistribute the SDK beyond those expressly granted in Clause 1 and this Clause 3.2.
 
 3.3. You may not use the SDK in connection with any illegal, fraudulent, dishonest or unethical activity or behaviour, and in particular not to create or develop, or help others create or develop, a product, service or library that competes, directly or indirectly, with the SDK or the TomTom APIs.
 
@@ -78,7 +78,7 @@ You may not use the SDK or accept this Agreement if you are barred from receivin
 
 11.4. The TomTom APIs and the SDK are provided as “Commercial Computer Software” or “restricted computer software”. Use, duplication or disclosure by the U.S. Government or a U.S. Government subcontractor is subject to the restrictions set forth in 48 C.F.R. Section 12.212 or 48 C.F.R. 227.2702, as applicable, or successor provisions. In respect of the Map API and Search API, the manufacturer is TomTom Global Content B.V.
 
-11.5. By submitting any suggestion, bug fix or code contribution (“Contribution”) to TomTom (e.g. via a GitHub Pull Request), you grant TomTom a perpetual, irrevocable, worldwide, royalty-free and non-exclusive license to use, reproduce, modify and distribute the Contribution as part of the SDK. You represent that you have the legal right to grant this license and that the Contribution does not infringe any third-party intellectual property rights.
+11.5. By submitting any suggestion, bug fix or code contribution (“Contribution”) to TomTom (e.g. via a GitHub issue or discussion), you grant TomTom a perpetual, irrevocable, worldwide, royalty-free and non-exclusive license to use, reproduce, modify and distribute the Contribution as part of the SDK. You represent that you have the legal right to grant this license and that the Contribution does not infringe any third-party intellectual property rights.
 
 THIRD PARTY SOFTWARE NOTICES
 

package/README.md

@@ -1,6 +1,6 @@
 # Viewport Places Plugin
 
-Lightweight plugin for the [TomTom Maps SDK for Javascript](https://docs.tomtom.com/maps-sdk-js/introduction/overview) that keeps places in sync with the current map viewport by creating and managing "place modules" that refresh as the map moves.
+Plugin for the [TomTom Maps SDK for JavaScript](https://docs.tomtom.com/maps-sdk-js/introduction/overview) that keeps places in sync with the current map viewport: each search you add gets its own place module, which searches again whenever the map moves.
 
 ## Docs & examples
 
@@ -9,13 +9,13 @@ Lightweight plugin for the [TomTom Maps SDK for Javascript](https://docs.tomtom.
 
 ## Quickstart
 
-Note: SDK plugins `@tomtom-org/maps-sdk` as a peer dependency — ensure the SDK is installed in your project.
+Note: this plugin declares `@tomtom-org/maps-sdk` as a peer dependency — ensure the SDK is installed in your project.
 
 ```bash
 npm install @tomtom-org/maps-sdk maplibre-gl @tomtom-org/maps-sdk-plugin-viewport-places
 ```
 
-1. Follow the SDK [Project setup](https://docs.tomtom.com/maps-sdk-js/guides/introduction/project-setup) or the Map [quickstart](https://docs.tomtom.com/maps-sdk-js/guides/map/quickstart) to create and initialize a `TomTomMap`.
+1. Follow the SDK [Project setup](https://docs.tomtom.com/maps-sdk-js/introduction/project-setup) or the Map [quickstart](https://docs.tomtom.com/maps-sdk-js/guides/map/quickstart) to create and initialize a `TomTomMap`.
 
 2. Import and use the plugin (plugin-specific steps only):
 
@@ -25,11 +25,22 @@ import { ViewportPlaces } from '@tomtom-org/maps-sdk-plugin-viewport-places';
 // assume `map` is your initialized TomTomMap instance
 const viewportPlaces = new ViewportPlaces(map);
 
+// a text search
 await viewportPlaces.add({
   id: 'restaurants',
   searchOptions: { query: 'restaurant', limit: 40 },
   minZoom: 12,
 });
+
+// a POI category search
+await viewportPlaces.addPOICategories({
+  id: 'parking',
+  categories: ['PARKING_GARAGE', 'CHARGING_LOCATION'],
+});
+
+// change or drop a place module by its id
+await viewportPlaces.update({ id: 'restaurants', searchOptions: { query: 'pizza' } });
+viewportPlaces.remove('parking');
 ```
 
 Place modules are rendered bottom-up in the order they are added: the first added module appears at the bottom and later modules are stacked on top.

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { PlacesModule, PlacesModuleConfig, TomTomMap } from "@tomtom-org/maps-sd
 import { FuzzySearchParams } from "@tomtom-org/maps-sdk/services";
 //#region src/viewportPlaces.d.ts
 /**
- * Common Options when adding a viewport places module.
+ * The common options for adding a viewport places module.
  *
  * @group Viewport Places
  */
@@ -12,8 +12,8 @@ export type ViewportPlacesAddCommonOptions = {
    * Optional unique identifier for the viewport places module.
    *
    * @remarks
-   * * If not provided, a random ID will be generated.
-   * * If you need to keep updating or removing this place module later, provide a fixed ID.
+   * * If you don't provide it, a random ID is generated.
+   * * To update or remove this place module later, provide a fixed ID.
    */
   id?: string;
   /**
@@ -26,7 +26,7 @@ export type ViewportPlacesAddCommonOptions = {
   maxZoom?: number;
 };
 /**
- * Full Options when adding a viewport places module.
+ * The full options for adding a viewport places module.
  *
  * @group Viewport Places
  */
@@ -35,8 +35,8 @@ export type ViewportPlacesAddOptions = ViewportPlacesAddCommonOptions & {
    * The search parameters to query places for this place module.
    *
    * @remarks
-   * `geoBias`, `cursor` and `signal` are not accepted here: each module always searches the first
-   * page of the current viewport and owns an `AbortSignal` so that a new search cancels the one it
+   * `geoBias`, `cursor` and `signal` are not accepted here. Each module always searches the first
+   * page of the current viewport and owns an `AbortSignal`, so a new search cancels the one it
    * supersedes.
    */
   searchOptions: Omit<FuzzySearchParams, 'geoBias' | 'cursor' | 'signal'>;
@@ -46,7 +46,7 @@ export type ViewportPlacesAddOptions = ViewportPlacesAddCommonOptions & {
   placesModuleConfig?: PlacesModuleConfig;
 };
 /**
- * Options when updating a viewport places module.
+ * The options for updating a viewport places module.
  *
  * @group Viewport Places
  */
@@ -54,15 +54,15 @@ export type ViewportPlacesOptions = Omit<ViewportPlacesAddOptions, 'id'> & {
   /**
    * The unique identifier of the place module to update.
    * @remarks
-   * * This ID must correspond to an existing place module added via an "add" method.
+   * * It must match an existing place module added with an "add" method.
    */
   id: string;
 };
 /**
  * A class for managing dynamic searched place modules on a TomTom map.
  *
- * It leverages the SDK search service to maintain place modules that automatically
- * update and stay current as the map viewport changes.
+ * It uses the SDK search service to keep its place modules current automatically as the
+ * map viewport changes.
  *
  * @group Viewport Places
  */
@@ -87,14 +87,13 @@ export declare class ViewportPlaces {
    */
   private searchAndDisplay;
   /**
-   * Adds a PlacesModule that displays places based on fuzzy search parameters and automatically updates as the map moves.
+   * Adds a PlacesModule that shows places from fuzzy search parameters and updates automatically as the map moves.
    *
    * @remarks
    * * Each call to "add" creates a new place module and places it above previously added modules.
-   * * Place modules are rendered bottom-up in the order they are added: the first added module is displayed at the bottom, and later modules are stacked on top of earlier ones.
+   * * Place modules are rendered bottom-up in the order they are added. The first added module is displayed at the bottom, and later modules are stacked on top of earlier ones.
    * * The default places module marker type is 'base-map' unless overridden in the options.
    *
-   * @param options - The options for the place module.
    * @returns A promise that resolves to the PlacesModule instance managing the module.
    */
   add(options: ViewportPlacesAddOptions): Promise<PlacesModule>;
@@ -104,7 +103,7 @@ export declare class ViewportPlaces {
    *
    * @remarks
    * * This is a convenience wrapper over `add` that configures a category-based search for a PlacesModule.
-   * * Each call creates a new place module that will be stacked on top of previously added modules.
+   * * Each call creates a new place module that is stacked on top of previously added modules.
    *
    * @param options - The options for the category-based place module.
    * @returns A promise that resolves to the PlacesModule instance managing the module.
@@ -125,8 +124,7 @@ export declare class ViewportPlaces {
   removeAll(): void;
   /**
    * Updates the search and display options for an existing place module identified by its ID.
-   * This will immediately apply the new options and refresh the place module accordingly.
-   * @param newOptions - The new options to apply.
+   * It applies the new options immediately and refreshes the place module.
    * @throws Error if the place module with the given ID does not exist.
    */
   update(newOptions: ViewportPlacesOptions): Promise<void>;

package/dist/index.es.js

@@ -1,2 +1 @@
-import{generateId as e}from"@tomtom-org/maps-sdk/core";import{PlacesModule as s}from"@tomtom-org/maps-sdk/map";import{createLatestRequest as o,discoverPlaces as t}from"@tomtom-org/maps-sdk/services";var i=class{map;registeredModules={};mapLibreMap;constructor(e){this.map=e,this.mapLibreMap=e.mapLibreMap}getRegisteredModule(e){const s=this.registeredModules[e];if(!s)throw new Error(`Place module with id ${e} not found`);return s}async searchAndDisplay(e){const s=this.registeredModules[e];if(!s)return;const{placesModule:o,options:i,latestSearch:a}=s,r=this.mapLibreMap.getZoom();if(i.minZoom&&r<i.minZoom||i.maxZoom&&r>i.maxZoom)return a.cancel(),void(await o.clear());const n=await a.run(e=>t({geoBias:{boundingBox:this.map.getBBox()},limit:100,...i.searchOptions,signal:e}));n.current&&await o.show(n.value)}async add(t){const i=t.id??e(),a={...t,placesModuleConfig:{markerType:"base-map",...t.placesModuleConfig}},r=await s.create(this.map,a.placesModuleConfig),n=()=>this.searchAndDisplay(i),p=this.mapLibreMap.on("moveend",n);return this.registeredModules[i]={placesModule:r,subscription:p,options:a,latestSearch:o()},await n(),r}async addPOICategories(e){return this.add({...e,searchOptions:{filters:{poiCategories:e.categories}}})}remove(e){const s=this.getRegisteredModule(e);s.latestSearch.cancel(),s.placesModule.clear(),s.subscription.unsubscribe(),delete this.registeredModules[e]}removeAll(){Object.keys(this.registeredModules).forEach(e=>this.remove(e))}async update(e){const s=this.getRegisteredModule(e.id),o=s.options;s.options={...o,...e,searchOptions:{...o.searchOptions,...e.searchOptions,filters:{...o.searchOptions.filters,...e.searchOptions.filters}},placesModuleConfig:{...o.placesModuleConfig,...e.placesModuleConfig}},s.placesModule.applyConfig(s.options.placesModuleConfig),await this.searchAndDisplay(e.id)}};export{i as ViewportPlaces};
-//# sourceMappingURL=index.es.js.map
+import{generateId as e}from"@tomtom-org/maps-sdk/core";import{PlacesModule as s}from"@tomtom-org/maps-sdk/map";import{createLatestRequest as o,discoverPlaces as t}from"@tomtom-org/maps-sdk/services";var i=class{map;registeredModules={};mapLibreMap;constructor(e){this.map=e,this.mapLibreMap=e.mapLibreMap}getRegisteredModule(e){const s=this.registeredModules[e];if(!s)throw new Error(`Place module with id ${e} not found`);return s}async searchAndDisplay(e){const s=this.registeredModules[e];if(!s)return;const{placesModule:o,options:i,latestSearch:a}=s,r=this.mapLibreMap.getZoom();if(i.minZoom&&r<i.minZoom||i.maxZoom&&r>i.maxZoom)return a.cancel(),void(await o.clear());const n=await a.run(e=>t({geoBias:{boundingBox:this.map.getBBox()},limit:100,...i.searchOptions,signal:e}));n.current&&await o.show(n.value)}async add(t){const i=t.id??e(),a={...t,placesModuleConfig:{markerType:"base-map",...t.placesModuleConfig}},r=await s.create(this.map,a.placesModuleConfig),n=()=>this.searchAndDisplay(i),p=this.mapLibreMap.on("moveend",n);return this.registeredModules[i]={placesModule:r,subscription:p,options:a,latestSearch:o()},await n(),r}async addPOICategories(e){return this.add({...e,searchOptions:{filters:{poiCategories:e.categories}}})}remove(e){const s=this.getRegisteredModule(e);s.latestSearch.cancel(),s.placesModule.clear(),s.subscription.unsubscribe(),delete this.registeredModules[e]}removeAll(){Object.keys(this.registeredModules).forEach(e=>this.remove(e))}async update(e){const s=this.getRegisteredModule(e.id),o=s.options;s.options={...o,...e,searchOptions:{...o.searchOptions,...e.searchOptions,filters:{...o.searchOptions.filters,...e.searchOptions.filters}},placesModuleConfig:{...o.placesModuleConfig,...e.placesModuleConfig}},s.placesModule.applyConfig(s.options.placesModuleConfig),await this.searchAndDisplay(e.id)}};export{i as ViewportPlaces};

package/package.json

@@ -2,30 +2,30 @@
   "name": "@tomtom-org/maps-sdk-plugin-viewport-places",
   "author": "TomTom International B.V.",
   "license": "See in LICENSE.txt",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "type": "module",
   "description": "Plugin to leverage search to show places on the current viewport that refresh as the map moves",
   "types": "dist/index.d.ts",
   "peerDependencies": {
-    "@tomtom-org/maps-sdk": ">=0.61.0 <1.0.0"
+    "@tomtom-org/maps-sdk": ">=0.64.0 <1.0.0 || >=1.0.0-rc.0 <1.0.0"
   },
   "devDependencies": {
     "@tsconfig/recommended": "^1.0.13",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.4",
     "@vitest/coverage-v8": "^4.1.11",
-    "rolldown": "^1.2.11",
-    "ts-node": "^10.9.2",
+    "rolldown": "^1.2.12",
     "typescript": "^6.0.3",
-    "vite": "^8.3.1",
+    "vite": "^8.3.2",
     "vitest": "^4.1.11",
-    "@tomtom-org/maps-sdk": "0.61.0"
+    "@tomtom-org/maps-sdk": "1.0.0-rc.1"
   },
   "files": [
     "dist",
     "package.json",
     "README.md",
     "LICENSE.txt",
-    "THIRD_PARTY.txt"
+    "THIRD_PARTY.txt",
+    "!**/*.map"
   ],
   "exports": {
     ".": {

package/dist/index.es.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.es.js","names":["generateId","PlacesModule","createLatestRequest","discoverPlaces","ViewportPlaces","map","registeredModules","mapLibreMap","constructor","this","getRegisteredModule","id","entry","Error","searchAndDisplay","placesModule","options","latestSearch","zoom","getZoom","minZoom","maxZoom","cancel","clear","search","run","signal","geoBias","boundingBox","getBBox","limit","searchOptions","current","show","value","add","effectiveOptions","placesModuleConfig","markerType","create","subscription","on","addPOICategories","filters","poiCategories","categories","remove","unsubscribe","removeAll","Object","keys","forEach","key","update","newOptions","currentOptions","applyConfig"],"sources":["../src/viewportPlaces.ts"],"sourcesContent":["import { generateId, POICategory } from '@tomtom-org/maps-sdk/core';\nimport { PlacesModule, type PlacesModuleConfig, TomTomMap } from '@tomtom-org/maps-sdk/map';\nimport {\n    createLatestRequest,\n    discoverPlaces,\n    type FuzzySearchParams,\n    type LatestRequest,\n} from '@tomtom-org/maps-sdk/services';\nimport type { Subscription } from 'maplibre-gl';\n\n/**\n * Common Options when adding a viewport places module.\n *\n * @group Viewport Places\n */\nexport type ViewportPlacesAddCommonOptions = {\n    /**\n     * Optional unique identifier for the viewport places module.\n     *\n     * @remarks\n     * * If not provided, a random ID will be generated.\n     * * If you need to keep updating or removing this place module later, provide a fixed ID.\n     */\n    id?: string;\n    /**\n     * Minimum zoom level at which the place module is visible.\n     */\n    minZoom?: number;\n    /**\n     * Maximum zoom level at which the place module is visible.\n     */\n    maxZoom?: number;\n};\n\n/**\n * Full Options when adding a viewport places module.\n *\n * @group Viewport Places\n */\nexport type ViewportPlacesAddOptions = ViewportPlacesAddCommonOptions & {\n    /**\n     * The search parameters to query places for this place module.\n     *\n     * @remarks\n     * `geoBias`, `cursor` and `signal` are not accepted here: each module always searches the first\n     * page of the current viewport and owns an `AbortSignal` so that a new search cancels the one it\n     * supersedes.\n     */\n    searchOptions: Omit<FuzzySearchParams, 'geoBias' | 'cursor' | 'signal'>;\n    /**\n     * Optional configuration for the places module, such as styling.\n     */\n    placesModuleConfig?: PlacesModuleConfig;\n};\n\n/**\n * Options when updating a viewport places module.\n *\n * @group Viewport Places\n */\nexport type ViewportPlacesOptions = Omit<ViewportPlacesAddOptions, 'id'> & {\n    /**\n     * The unique identifier of the place module to update.\n     * @remarks\n     * * This ID must correspond to an existing place module added via an \"add\" method.\n     */\n    id: string;\n};\n\n/**\n * A class for managing dynamic searched place modules on a TomTom map.\n *\n * It leverages the SDK search service to maintain place modules that automatically\n * update and stay current as the map viewport changes.\n *\n * @group Viewport Places\n */\nexport class ViewportPlaces {\n    /**\n     * Internal map of registered place modules, keyed by their `id`.\n     * @private\n     */\n    private registeredModules: Record<\n        string,\n        {\n            options: ViewportPlacesAddOptions;\n            placesModule: PlacesModule;\n            subscription: Subscription;\n            /** Retires this module's in-flight search when a newer viewport supersedes it. */\n            latestSearch: LatestRequest;\n        }\n    > = {};\n    private readonly mapLibreMap;\n\n    /**\n     * Creates an instance of ViewportPlaces bound to a TomTom map.\n     * @param map - The TomTom map instance to attach place modules to.\n     */\n    constructor(private readonly map: TomTomMap) {\n        this.mapLibreMap = map.mapLibreMap;\n    }\n\n    private getRegisteredModule(id: string) {\n        const entry = this.registeredModules[id];\n        if (!entry) {\n            throw new Error(`Place module with id ${id} not found`);\n        }\n\n        return entry;\n    }\n\n    /**\n     * Performs the update logic for a registered PlacesModule, cancelling whatever search that\n     * module still has in flight.\n     * @param id - The unique identifier of the registered place module to refresh.\n     */\n    private async searchAndDisplay(id: string): Promise<void> {\n        const entry = this.registeredModules[id];\n        if (!entry) return;\n\n        const { placesModule, options, latestSearch } = entry;\n\n        const zoom = this.mapLibreMap.getZoom();\n        if ((options.minZoom && zoom < options.minZoom) || (options.maxZoom && zoom > options.maxZoom)) {\n            // A search left running would repopulate what this clears\n            latestSearch.cancel();\n            await placesModule.clear();\n            return;\n        }\n\n        const search = await latestSearch.run((signal) =>\n            discoverPlaces({\n                geoBias: { boundingBox: this.map.getBBox() },\n                limit: 100,\n                ...options.searchOptions,\n                signal,\n            }),\n        );\n        if (search.current) await placesModule.show(search.value);\n    }\n\n    /**\n     * Adds a PlacesModule that displays places based on fuzzy search parameters and automatically updates as the map moves.\n     *\n     * @remarks\n     * * Each call to \"add\" creates a new place module and places it above previously added modules.\n     * * Place modules are rendered bottom-up in the order they are added: the first added module is displayed at the bottom, and later modules are stacked on top of earlier ones.\n     * * The default places module marker type is 'base-map' unless overridden in the options.\n     *\n     * @param options - The options for the place module.\n     * @returns A promise that resolves to the PlacesModule instance managing the module.\n     */\n    async add(options: ViewportPlacesAddOptions): Promise<PlacesModule> {\n        const id = options.id ?? generateId();\n        const effectiveOptions = {\n            ...options,\n            placesModuleConfig: { markerType: 'base-map', ...options.placesModuleConfig } satisfies PlacesModuleConfig,\n        };\n\n        const placesModule = await PlacesModule.create(this.map, effectiveOptions.placesModuleConfig);\n        const searchAndDisplay = () => this.searchAndDisplay(id);\n\n        const subscription = this.mapLibreMap.on('moveend', searchAndDisplay);\n        this.registeredModules[id] = {\n            placesModule,\n            subscription,\n            options: effectiveOptions,\n            latestSearch: createLatestRequest(),\n        };\n        await searchAndDisplay();\n        return placesModule;\n    }\n\n    /**\n     * Adds a PlacesModule for specific POI categories that updates automatically as the map moves.\n     * The POIs are shown in the same style as the base map.\n     *\n     * @remarks\n     * * This is a convenience wrapper over `add` that configures a category-based search for a PlacesModule.\n     * * Each call creates a new place module that will be stacked on top of previously added modules.\n     *\n     * @param options - The options for the category-based place module.\n     * @returns A promise that resolves to the PlacesModule instance managing the module.\n     */\n    async addPOICategories(\n        options: ViewportPlacesAddCommonOptions & { categories: POICategory[] },\n    ): Promise<PlacesModule> {\n        return this.add({\n            ...options,\n            searchOptions: { filters: { poiCategories: options.categories } },\n        });\n    }\n\n    /**\n     * Removes a specific place module by its ID, stopping its updates and clearing the displayed places.\n     *\n     * @param id - The unique identifier of the PlacesModule to remove.\n     * @throws Error if the place module with the given ID does not exist.\n     */\n    remove(id: string): void {\n        const entry = this.getRegisteredModule(id);\n        entry.latestSearch.cancel();\n        entry.placesModule.clear();\n        entry.subscription.unsubscribe();\n        delete this.registeredModules[id];\n    }\n\n    /**\n     * Removes all registered place modules, stopping their updates and clearing all displayed places.\n     */\n    removeAll(): void {\n        Object.keys(this.registeredModules).forEach((key) => this.remove(key));\n    }\n\n    /**\n     * Updates the search and display options for an existing place module identified by its ID.\n     * This will immediately apply the new options and refresh the place module accordingly.\n     * @param newOptions - The new options to apply.\n     * @throws Error if the place module with the given ID does not exist.\n     */\n    async update(newOptions: ViewportPlacesOptions): Promise<void> {\n        const entry = this.getRegisteredModule(newOptions.id);\n        const currentOptions = entry.options;\n\n        // Update the options by merging current and new options:\n        entry.options = {\n            ...currentOptions,\n            ...newOptions,\n            // search and places display options are merged incrementally, search filters included:\n            searchOptions: {\n                ...currentOptions.searchOptions,\n                ...newOptions.searchOptions,\n                filters: { ...currentOptions.searchOptions.filters, ...newOptions.searchOptions.filters },\n            },\n            placesModuleConfig: { ...currentOptions.placesModuleConfig, ...newOptions.placesModuleConfig },\n        };\n        // Update the places module configuration and refresh the display:\n        entry.placesModule.applyConfig(entry.options.placesModuleConfig);\n        await this.searchAndDisplay(newOptions.id);\n    }\n}\n"],"mappings":"uMA6EA,IAAaI,EAAb,MAqBiCC,IAhB7BC,kBASI,CAAC,EACLC,YAMA,WAAAC,CAAYH,GAAiBI,KAAAJ,IAAAA,EACzBI,KAAKF,YAAcF,EAAIE,WAC3B,CAEA,mBAAAG,CAA4BC,GACxB,MAAMC,EAAQH,KAAKH,kBAAkBK,GACrC,IAAKC,EACD,MAAM,IAAIC,MAAM,wBAAwBF,eAG5C,OAAOC,CACX,CAOA,sBAAcE,CAAiBH,GAC3B,MAAMC,EAAQH,KAAKH,kBAAkBK,GACrC,IAAKC,EAAO,OAEZ,MAAMG,aAAEA,EAAAC,QAAcA,EAAAC,aAASA,GAAiBL,EAE1CM,EAAOT,KAAKF,YAAYY,UAC9B,GAAKH,EAAQI,SAAWF,EAAOF,EAAQI,SAAaJ,EAAQK,SAAWH,EAAOF,EAAQK,QAIlF,OAFAJ,EAAaK,oBACPP,EAAaQ,SAIvB,MAAMC,QAAeP,EAAaQ,IAAKC,GACnCvB,EAAe,CACXwB,QAAS,CAAEC,YAAanB,KAAKJ,IAAIwB,WACjCC,MAAO,OACJd,EAAQe,cACXL,YAGJF,EAAOQ,eAAejB,EAAakB,KAAKT,EAAOU,MACvD,CAaA,SAAMC,CAAInB,GACN,MAAML,EAAKK,EAAQL,IAAMX,IACnBoC,EAAmB,IAClBpB,EACHqB,mBAAoB,CAAEC,WAAY,cAAetB,EAAQqB,qBAGvDtB,QAAqBd,EAAasC,OAAO9B,KAAKJ,IAAK+B,EAAiBC,oBACpEvB,EAAA,IAAyBL,KAAKK,iBAAiBH,GAE/C6B,EAAe/B,KAAKF,YAAYkC,GAAG,UAAW3B,GAQpD,OAPAL,KAAKH,kBAAkBK,GAAM,CACzBI,eACAyB,eACAxB,QAASoB,EACTnB,aAAcf,WAEZY,IACCC,CACX,CAaA,sBAAM2B,CACF1B,GAEA,OAAOP,KAAK0B,IAAI,IACTnB,EACHe,cAAe,CAAEY,QAAS,CAAEC,cAAe5B,EAAQ6B,cAE3D,CAQA,MAAAC,CAAOnC,GACH,MAAMC,EAAQH,KAAKC,oBAAoBC,GACvCC,EAAMK,aAAaK,SACnBV,EAAMG,aAAaQ,QACnBX,EAAM4B,aAAaO,qBACZtC,KAAKH,kBAAkBK,EAClC,CAKA,SAAAqC,GACIC,OAAOC,KAAKzC,KAAKH,mBAAmB6C,QAASC,GAAQ3C,KAAKqC,OAAOM,GACrE,CAQA,YAAMC,CAAOC,GACT,MAAM1C,EAAQH,KAAKC,oBAAoB4C,EAAW3C,IAC5C4C,EAAiB3C,EAAMI,QAG7BJ,EAAMI,QAAU,IACTuC,KACAD,EAEHvB,cAAe,IACRwB,EAAexB,iBACfuB,EAAWvB,cACdY,QAAS,IAAKY,EAAexB,cAAcY,WAAYW,EAAWvB,cAAcY,UAEpFN,mBAAoB,IAAKkB,EAAelB,sBAAuBiB,EAAWjB,qBAG9EzB,EAAMG,aAAayC,YAAY5C,EAAMI,QAAQqB,0BACvC5B,KAAKK,iBAAiBwC,EAAW3C,GAC3C"}