@tomtom-org/maps-sdk-plugin-agent-toolkit 0.2.5 → 0.2.7

package/dist/index.d.ts

@@ -1,34 +1,26 @@
 import { BaseMapModule } from '../../../../map/dist';
 import { BBox } from '../../../../core/dist';
 import { BBox as BBox_2 } from '../../../../../core/dist';
-import { CommonPlaceProps } from '../../../core/dist';
-import { CommonPlaceProps as CommonPlaceProps_2 } from '../../../../core/dist';
-import { GeometriesModule } from '../../../map/dist';
-import { GeometriesModule as GeometriesModule_2 } from '../../../../map/dist';
+import { CommonPlaceProps } from '../../../../core/dist';
+import { GeometriesModule } from '../../../../map/dist';
 import { GeometryTheme } from '../../../../map/dist';
 import { HillshadeModule } from '../../../../map/dist';
 import { LanguageModel } from 'ai';
 import { Map as Map_2 } from 'maplibre-gl';
 import { ModelMessage } from 'ai';
-import { Place } from '../../../core/dist';
-import { Place as Place_2 } from '../../../../core/dist';
-import { PlaceConnectionDisplay } from '../../../map/dist';
-import { PlaceConnectionDisplay as PlaceConnectionDisplay_2 } from '../../../../map/dist';
+import { Place } from '../../../../core/dist';
+import { PlaceConnectionDisplay } from '../../../../map/dist';
 import { Places } from '../../../../core/dist';
-import { PlacesModule } from '../../../map/dist';
-import { PlacesModule as PlacesModule_2 } from '../../../../map/dist';
+import { PlacesModule } from '../../../../map/dist';
 import { PlanningWaypoint } from '../../../../map/dist';
 import { POIsModule } from '../../../../map/dist';
-import { PolygonFeature } from '../../../core/dist';
-import { PolygonFeature as PolygonFeature_2 } from '../../../../core/dist';
-import { PolygonFeatures } from '../../../core/dist';
+import { PolygonFeature } from '../../../../core/dist';
+import { PolygonFeatures } from '../../../../core/dist';
 import { Position } from 'geojson';
 import { PrepareStepFunction } from 'ai';
-import { ReachableRangeBudget } from '../../../services/dist';
-import { Routes } from '../../../core/dist';
-import { Routes as Routes_2 } from '../../../../core/dist';
-import { RoutingModule } from '../../../map/dist';
-import { RoutingModule as RoutingModule_2 } from '../../../../map/dist';
+import { ReachableRangeBudget } from '../../../../services/dist';
+import { Routes } from '../../../../core/dist';
+import { RoutingModule } from '../../../../map/dist';
 import { TomTomMap } from '../../../../map/dist';
 import { TomTomMap as TomTomMap_2 } from '../../map/dist';
 import { ToolLoopAgent } from 'ai';
@@ -41,8 +33,7 @@ import { TrafficIncident as TrafficIncident_2 } from '../../../../../core/dist';
 import { TrafficIncidentDetailsByBBoxParams } from '../../../../services/dist';
 import { TrafficIncidentOverlayModule } from '../../../../map/dist';
 import { TrafficIncidentsModule } from '../../../../map/dist';
-import { WaypointLike } from '../../../core/dist';
-import { WaypointLike as WaypointLike_2 } from '../../../../core/dist';
+import { WaypointLike } from '../../../../core/dist';
 import { z } from 'zod';
 
 declare type AnalysisOutputFormat = 'json' | 'chart';
@@ -306,11 +297,11 @@ declare class CustomGeometriesState implements ShownEntriesSlice, StateSlice {
      * Append a new entry. If `explicitId` collides, the slice auto-suffixes (`-2`, `-3`, ...).
      * Returns the assigned id. Under `single` mode the new entry replaces every older one.
      */
-    addEntry(features: PolygonFeature_2<CommonPlaceProps_2>[], provenance: CustomGeometriesEntry['provenance'], label: string, explicitId?: string): string;
+    addEntry(features: PolygonFeature<CommonPlaceProps>[], provenance: CustomGeometriesEntry['provenance'], label: string, explicitId?: string): string;
     /** Attach an analysis to an existing entry (replace if a result of the same name exists). */
     addAnalysisToEntry(entryId: string, analysis: CustomGeometriesAnalysis): boolean;
     /** Lazy-init the entry's GeometriesModule, applying / re-applying the requested theme. */
-    getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule_2>;
+    getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule>;
     /**
      * Render this entry's polygons. `mode` is scoped to this entry's own layer:
      * - `'replace'` (default) — show exactly `entry.features`, clearing whatever the
@@ -927,14 +918,13 @@ export declare type PlacesEntry = {
     /** Lazy place-id → boundary polygon index, built on first lookup through PlacesState.getGeometryForPlace. */
     _geometryByPlaceId?: Record<string, PolygonFeature<CommonPlaceProps>>;
     /**
-     * Per-entry display modules. Each entry owns its own PlacesModule per marker theme and a
-     * dedicated GeometriesModule, so display state lives on the entry rather than on a shared
-     * slice-level module. Lazy-initialised via PlacesState helpers — undefined until first show.
+     * Per-entry display modules. An entry is rendered under at most one marker theme at a time,
+     * so a single PlacesModule covers all themes — `_showEntryAs` rethemes it via `applyTheme`.
+     * A dedicated GeometriesModule renders the entry's boundary polygons.
+     * Lazy-initialised via PlacesState helpers — undefined until first show.
      */
     _modules?: {
-        pin?: PlacesModule;
-        baseMap?: PlacesModule;
-        pinClustered?: PlacesModule;
+        places?: PlacesModule;
         geometries?: GeometriesModule;
     };
     /** The marker theme currently rendering this entry, or undefined when hidden. */
@@ -948,10 +938,10 @@ declare type PlacesMarkerType = 'pin' | 'base-map' | 'pin-clustered';
  * State for the places layer: an append-only history of place results plus per-entry display
  * modules.
  *
- * Each entry owns its own PlacesModule (per marker theme: pin / base-map / pin-clustered) and
- * a dedicated GeometriesModule, lazy-initialised on first show. The slice no longer holds
- * shared modules — display state lives on the entry, so two entries can be rendered side by
- * side under different themes without sharing a single source.
+ * Each entry owns a single PlacesModule (rethemed in-place via `applyTheme` when the marker
+ * type changes — an entry only renders under one theme at a time) and a dedicated
+ * GeometriesModule, lazy-initialised on first show. Display state lives on the entry, so two
+ * entries can be rendered side by side under different themes without sharing a single source.
  *
  * @group Agent Toolkit
  */
@@ -975,24 +965,24 @@ declare class PlacesState implements StateSlice {
      */
     setEntryMode(mode: EntryMode): Promise<void>;
     /**
-     * Lazy-init and return the entry's PlacesModule for the given marker theme. Each entry
-     * keeps a separate module per theme so flipping themes for one entry doesn't disturb
-     * another. Throws when the entry id is unknown.
+     * Lazy-init and return the entry's PlacesModule, rethemed to `markerType`. An entry only
+     * ever renders under one theme at a time, so the same module is reused — flipping themes
+     * calls `applyTheme` in place. Throws when the entry id is unknown.
      */
-    getEntryPlacesModule(entryId: string, markerType: PlacesMarkerType): Promise<PlacesModule_2>;
+    getEntryPlacesModule(entryId: string, markerType: PlacesMarkerType): Promise<PlacesModule>;
     /**
      * Lazy-init and return the entry's place-geometries module (for POI footprints, municipality
      * outlines). Re-applies themed config when the theme changes. Throws on unknown entry id.
      */
-    getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule_2>;
+    getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule>;
     private _requireEntry;
     get entries(): readonly PlacesEntry[];
     /**
      * This is used purely to pass data between tools in a context-dependent way,
      * so we assume the most recent entry is the relevant one to show on the map.
      */
-    get latestPlace(): Place_2[] | undefined;
-    addPlaceResult(place: Place_2 | Places, label: string, explicitId?: string, connections?: PlaceConnectionDisplay_2[], geometries?: PolygonFeature_2<CommonPlaceProps_2>[]): string;
+    get latestPlace(): Place[] | undefined;
+    addPlaceResult(place: Place | Places, label: string, explicitId?: string, connections?: PlaceConnectionDisplay[], geometries?: PolygonFeature<CommonPlaceProps>[]): string;
     private _uniqueEntryId;
     /**
      * Attach an analysis result to an existing entry. Analysis names are unique
@@ -1001,27 +991,27 @@ declare class PlacesState implements StateSlice {
      */
     addAnalysisToEntry(entryId: string, analysis: PlacesAnalysis): boolean;
     findPlaceById(placeId: string): {
-        place: Place_2;
+        place: Place;
         entryId: string;
     } | undefined;
     /**
      * Returns the cached boundary polygon for a place id, or undefined if no geometry has been
      * fetched for it yet. Builds a lazy place-id → feature index per entry on first lookup.
      */
-    getGeometryForPlace(placeId: string): PolygonFeature_2<CommonPlaceProps_2> | undefined;
+    getGeometryForPlace(placeId: string): PolygonFeature<CommonPlaceProps> | undefined;
     /**
      * Fetches the boundary polygon for a place from the Geometry Data service and stores it on
      * the owning entry. Returns the cached feature if already fetched, or undefined if the place
      * is unknown or has no geometry data source.
      */
-    fetchPlaceGeometry(placeId: string): Promise<PolygonFeature_2<CommonPlaceProps_2> | undefined>;
+    fetchPlaceGeometry(placeId: string): Promise<PolygonFeature<CommonPlaceProps> | undefined>;
     /**
      * Batch-fetches boundary polygons for every place in an entry that has a geometry data source
      * but is not yet cached. Issues one Geometry Data request per chunk of {@link GEOMETRY_DATA_BATCH_SIZE}
      * place ids (the API caps each request) and stores the merged result on `entry.geometries`.
      * Returns the full geometries list for the entry, or an empty array if the entry is unknown.
      */
-    fetchGeometriesForEntry(entryId: string): Promise<PolygonFeature_2<CommonPlaceProps_2>[]>;
+    fetchGeometriesForEntry(entryId: string): Promise<PolygonFeature<CommonPlaceProps>[]>;
     /**
      * Render the given polygons via the entry's GeometriesModule. The `mode` flag is
      * scoped to **this entry's layer only** — it does not touch other entries (use
@@ -1036,7 +1026,7 @@ declare class PlacesState implements StateSlice {
      * `entryId` defaults to the latest entry that owns geometries — handy when callers only ever
      * render the most-recently produced footprints. Pass an explicit id to target an older one.
      */
-    showPlaceGeometries(features: PolygonFeature_2<CommonPlaceProps_2>[], theme?: GeometryTheme, mode?: 'add' | 'replace', entryId?: string): Promise<void>;
+    showPlaceGeometries(features: PolygonFeature<CommonPlaceProps>[], theme?: GeometryTheme, mode?: 'add' | 'replace', entryId?: string): Promise<void>;
     private _latestGeometriesEntryId;
     private _buildGeometryIndex;
     /** IDs of all entries currently shown on the map. */
@@ -1051,13 +1041,13 @@ declare class PlacesState implements StateSlice {
     /** Marker type for a specific entry, or undefined if it is not shown. */
     getShownMarkerType(id: string): PlacesMarkerType | undefined;
     /** Return the union of all features belonging to currently-shown entries. */
-    getShownFeatures(): Place_2[];
+    getShownFeatures(): Place[];
     /**
      * Replace the shown set for `markerType` with exactly these ids and re-render.
      * Entries currently shown as `markerType` but absent from `ids` are hidden;
      * entries in `ids` are switched to `markerType` (lazy-creating their module).
      */
-    setShownEntries(ids: readonly string[], markerType: PlacesMarkerType): Promise<Place_2[]>;
+    setShownEntries(ids: readonly string[], markerType: PlacesMarkerType): Promise<Place[]>;
     /**
      * Add ids to the shown set under `markerType`. Any id previously shown as
      * a different marker type is moved (its previous module is cleared, the
@@ -1066,9 +1056,9 @@ declare class PlacesState implements StateSlice {
      * Under `entryMode === 'single'` everything else is hidden first, so the
      * effective behaviour collapses to "show exactly the last id in the list".
      */
-    addShownEntries(ids: readonly string[], markerType: PlacesMarkerType): Promise<Place_2[]>;
+    addShownEntries(ids: readonly string[], markerType: PlacesMarkerType): Promise<Place[]>;
     /** Remove ids from the shown set and clear their modules. */
-    removeShownEntries(ids: readonly string[]): Promise<Place_2[]>;
+    removeShownEntries(ids: readonly string[]): Promise<Place[]>;
     /** Clear everything from the map (does not touch entries history). */
     clearShownEntries(): Promise<void>;
     clearShownGeometries(ids?: readonly string[]): Promise<void>;
@@ -1174,13 +1164,13 @@ declare class RangeState implements ShownEntriesSlice {
      * Lazy-init the entry's GeometriesModule (for the isochrone/isodistance polygons),
      * applying the requested theme. Throws on unknown id.
      */
-    getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule_2>;
+    getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule>;
     /**
      * Lazy-init the entry's origin-pin PlacesModule. Each entry maintains its own pin module
      * so multiple ranges entries can be on the map simultaneously without the pins of one
      * overwriting another.
      */
-    getEntryPlacesModule(entryId: string): Promise<PlacesModule_2>;
+    getEntryPlacesModule(entryId: string): Promise<PlacesModule>;
     /**
      * Mark this entry as shown — records `_shown = true` and emits `shown-change`. The
      * caller is expected to push features into the lazy modules itself; this method only
@@ -1362,7 +1352,7 @@ declare class RoutingState implements ShownEntriesSlice {
      * Lazy-init and return an entry's RoutingModule. Throws on unknown id. Callers that need
      * to show/hide should prefer the higher-level {@link showEntry} / {@link hideEntry}.
      */
-    getEntryRoutingModule(entryId: string): Promise<RoutingModule_2>;
+    getEntryRoutingModule(entryId: string): Promise<RoutingModule>;
     /**
      * Render the given entry's routes + waypoints on its own RoutingModule.
      *
@@ -1389,21 +1379,21 @@ declare class RoutingState implements ShownEntriesSlice {
      * "focused route" (e.g. setRouteTheme, getShownRoutes) read off it. Returns undefined
      * when no entry is currently shown.
      */
-    get currentEntryModule(): RoutingModule_2 | undefined;
+    get currentEntryModule(): RoutingModule | undefined;
     get entries(): readonly RoutesEntry[];
-    get currentRoutes(): Routes_2 | undefined;
-    get currentWaypoints(): WaypointLike_2[] | undefined;
+    get currentRoutes(): Routes | undefined;
+    get currentWaypoints(): WaypointLike[] | undefined;
     /** Sparse nullable slots being assembled before triggering a route calculation. */
     get planningSlots(): PlanningWaypoint[];
     get params(): RouteParams;
-    addRoutes(routes: Routes_2, waypoints: WaypointLike_2[], label: string): string;
+    addRoutes(routes: Routes, waypoints: WaypointLike[], label: string): string;
     /**
      * Attach an analysis result to an existing routes entry. Names are unique within a single
      * entry — adding one with an existing name replaces it. Returns true on success, false if
      * the entry doesn't exist.
      */
     addAnalysisToEntry(entryId: string, analysis: RoutesAnalysis): boolean;
-    setWaypointAt(index: number, waypoint: WaypointLike_2): void;
+    setWaypointAt(index: number, waypoint: WaypointLike): void;
     setParams(params: Partial<RouteParams>): void;
     reset(): void;
 }