@tomtom-org/maps-sdk 0.52.0 → 0.53.0

package/map/dist/third-party.json

@@ -0,0 +1,38 @@
+[
+  {
+    "name": "@turf/turf",
+    "version": "7.4.0",
+    "license": "MIT",
+    "bundled": false,
+    "description": "a JavaScript library for performing geospatial operations with GeoJSON",
+    "repository": "git://github.com/Turfjs/turf.git",
+    "homepage": "https://github.com/Turfjs/turf",
+    "author": "Turf Authors",
+    "licenseText": "The MIT License (MIT)\n\nCopyright (c) 2017 TurfJS\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
+  },
+  {
+    "name": "lodash-es",
+    "version": "4.18.1",
+    "license": "MIT",
+    "bundled": false,
+    "description": "Lodash exported as ES modules.",
+    "repository": "lodash/lodash",
+    "homepage": "https://lodash.com/custom-builds",
+    "author": "John-David Dalton <john.david.dalton@gmail.com>",
+    "contributors": [
+      "John-David Dalton <john.david.dalton@gmail.com>",
+      "Mathias Bynens <mathias@qiwi.be>"
+    ],
+    "licenseText": "Copyright OpenJS Foundation and other contributors <https://openjsf.org/>\n\nBased on Underscore.js, copyright Jeremy Ashkenas,\nDocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>\n\nThis software consists of voluntary contributions made by many\nindividuals. For exact contribution history, see the revision history\navailable at https://github.com/lodash/lodash\n\nThe following license applies to all parts of this software except as\ndocumented below:\n\n====\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\nLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n====\n\nCopyright and related rights for sample code are waived via CC0. Sample\ncode is defined as all source code displayed within the prose of the\ndocumentation.\n\nCC0: http://creativecommons.org/publicdomain/zero/1.0/\n\n====\n\nFiles located in the node_modules and vendor directories are externally\nmaintained libraries used by this software which have their own\nlicenses; we recommend you read them, as their terms may differ from the\nterms above."
+  },
+  {
+    "name": "maplibre-gl",
+    "version": "6.9.0",
+    "license": "BSD-3-Clause",
+    "bundled": false,
+    "description": "BSD licensed community fork of mapbox-gl, a WebGL interactive maps library",
+    "repository": "https://github.com/maplibre/maplibre-gl-js",
+    "homepage": "https://maplibre.org/",
+    "licenseText": "Copyright (c) 2023, MapLibre contributors\n\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n    * Redistributions of source code must retain the above copyright notice,\n      this list of conditions and the following disclaimer.\n    * Redistributions in binary form must reproduce the above copyright notice,\n      this list of conditions and the following disclaimer in the documentation\n      and/or other materials provided with the distribution.\n    * Neither the name of MapLibre GL JS nor the names of its contributors\n      may be used to endorse or promote products derived from this software\n      without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR\nCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\nEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\nPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n\n-------------------------------------------------------------------------------\n\nContains code from mapbox-gl-js v1.13 and earlier\n\nVersion v1.13 of mapbox-gl-js and earlier are licensed under a BSD-3-Clause license\n\nCopyright (c) 2020, Mapbox\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n* Redistributions of source code must retain the above copyright notice,\n  this list of conditions and the following disclaimer.\n* Redistributions in binary form must reproduce the above copyright notice,\n  this list of conditions and the following disclaimer in the documentation\n  and/or other materials provided with the distribution.\n* Neither the name of Mapbox GL JS nor the names of its contributors\n  may be used to endorse or promote products derived from this software\n  without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR\nCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\nEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\nPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\nEVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n\n-------------------------------------------------------------------------------\n\nContains code from glfx.js\n\nCopyright (C) 2011 by Evan Wallace\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n--------------------------------------------------------------------------------\n\nContains a portion of d3-color https://github.com/d3/d3-color\n\nCopyright 2010-2016 Mike Bostock\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n* Redistributions of source code must retain the above copyright notice, this\n  list of conditions and the following disclaimer.\n\n* Redistributions in binary form must reproduce the above copyright notice,\n  this list of conditions and the following disclaimer in the documentation\n  and/or other materials provided with the distribution.\n\n* Neither the name of the author nor the names of contributors may be used to\n  endorse or promote products derived from this software without specific prior\n  written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\nANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+  }
+]

package/package.json

@@ -2,8 +2,16 @@
   "name": "@tomtom-org/maps-sdk",
   "author": "TomTom International B.V.",
   "license": "See in LICENSE.txt",
-  "version": "0.52.0",
-  "description": "TomTom Maps for JavaScript",
+  "version": "0.53.0",
+  "description": "TomTom maps, search, geocoding, routing, isochrones, EV and traffic for JavaScript — typed GeoJSON services and a MapLibre GL JS map.",
+  "homepage": "https://docs.tomtom.com/maps-sdk-js/introduction/overview",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tomtom-international/maps-sdk-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tomtom-international/maps-sdk-js/issues"
+  },
   "keywords": [
     "tomtom",
     "sdk",
@@ -15,7 +23,18 @@
     "routing",
     "traffic",
     "web",
-    "nodejs"
+    "nodejs",
+    "maplibre",
+    "maplibre-gl",
+    "geojson",
+    "typescript",
+    "directions",
+    "reverse-geocoding",
+    "autocomplete",
+    "poi",
+    "isochrone",
+    "ev-charging",
+    "navigation"
   ],
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
@@ -28,7 +47,7 @@
   "peerDependencies": {
     "@turf/turf": "^7.4.0",
     "lodash-es": "^4.18.1",
-    "maplibre-gl": "^6.6.0",
+    "maplibre-gl": "^6.9.0",
     "zod": "^4.4.3"
   },
   "size-limit": [
@@ -56,7 +75,8 @@
     "package.json",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE.txt"
+    "LICENSE.txt",
+    "THIRD_PARTY.txt"
   ],
   "exports": {
     "./core": {
@@ -77,11 +97,13 @@
     "build:api-reference": "typedoc",
     "build:examples": "pnpm -F @tomtom-org/maps-sdk-examples build",
     "build:examples:sandpack": "pnpm -F @tomtom-org/maps-sdk-examples build:sandpack",
-    "build:sdk": "pnpm -F core build  && pnpm -F services build && pnpm -F map build",
+    "build:sdk": "pnpm -F core build  && pnpm -F services build && pnpm -F map build && pnpm build:third-party",
+    "build:third-party": "node shared-configs/aggregateThirdParty.ts",
+    "build:third-party:plugins": "node shared-configs/aggregateThirdParty.ts --plugins",
     "eval:explorer": "pnpm -F @testing/ai-eval-explorer dev",
     "eval:explorer:build": "pnpm -F @testing/ai-eval-explorer build",
     "build:agent-eval": "pnpm -F agent-eval build",
-    "build:plugins": "pnpm -F './plugins/*' build",
+    "build:plugins": "pnpm -F './plugins/*' build && pnpm build:third-party:plugins",
     "clean": "pnpm -r --no-bail clean:dist && pnpm -r --no-bail clean:cache",
     "e2e-test:agent-toolkit:sandbox": "pnpm -F @tomtom-org/maps-sdk-plugin-agent-toolkit test:e2e",
     "e2e-test:examples": "pnpm -F @tomtom-org/maps-sdk-examples test:e2e",
@@ -101,8 +123,8 @@
     "sync-docs-package-version": "bash documentation/scripts/update-sdk-version-in-docs.sh",
     "sync-examples-package-version": "bash examples/scripts/sync-examples-package-version.sh",
     "test:agent-eval": "pnpm -F agent-eval test",
-    "test:sdk": "pnpm -F core test && pnpm -F services test && pnpm -F map test",
-    "test:sdk:coverage": "pnpm -F core test:coverage && pnpm -F services test:coverage && pnpm -F map test:coverage && pnpm -F plugins test:coverage",
+    "test:sdk": "pnpm -F shared-configs test && pnpm -F core test && pnpm -F services test && pnpm -F map test",
+    "test:sdk:coverage": "pnpm -F shared-configs test:coverage && pnpm -F core test:coverage && pnpm -F services test:coverage && pnpm -F map test:coverage && pnpm -F plugins test:coverage",
     "test:plugins": "pnpm --filter './plugins/*' run --if-present test",
     "test:examples": "pnpm -F @tomtom-org/maps-sdk-examples test",
     "type-check:examples": "pnpm -F @tomtom-org/maps-sdk-examples type-check",

package/services/dist/THIRD_PARTY.txt

@@ -1 +1,102 @@
-No third parties dependencies
+The following third-party components are declared as peer dependencies. Their code is
+NOT bundled into this package: your package manager installs them alongside it and
+your application bundles them. The licenses below apply to those copies, and each of
+these components may in turn install its own dependencies under their own licenses.
+
+Name: lodash-es
+Version: 4.18.1
+License: MIT
+Bundled: false (peer dependency)
+Description: Lodash exported as ES modules.
+Repository: lodash/lodash
+Homepage: https://lodash.com/custom-builds
+Author: John-David Dalton <john.david.dalton@gmail.com>
+Contributors:
+  John-David Dalton <john.david.dalton@gmail.com>
+  Mathias Bynens <mathias@qiwi.be>
+License Text:
+===
+
+Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
+
+Based on Underscore.js, copyright Jeremy Ashkenas,
+DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/lodash/lodash
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code displayed within the prose of the
+documentation.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+Files located in the node_modules and vendor directories are externally
+maintained libraries used by this software which have their own
+licenses; we recommend you read them, as their terms may differ from the
+terms above.
+
+
+---
+
+Name: zod
+Version: 4.4.3
+License: MIT
+Bundled: false (peer dependency)
+Description: TypeScript-first schema declaration and validation library with static type inference
+Repository: git+https://github.com/colinhacks/zod.git
+Homepage: https://zod.dev
+Author: Colin McDonnell <zod@colinhacks.com>
+License Text:
+===
+
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/services/dist/index.d.ts

@@ -1507,10 +1507,35 @@ export type ElectricVehiclePreferences = {
 export type VehiclePreferences<E extends VehicleEngineType = undefined> = E extends 'electric' ? ElectricVehiclePreferences : {};
 //#endregion
 //#region src/shared/types/vehicleRestrictionParams.d.ts
+/**
+ * Whether the vehicle carries an electronic toll collection transponder.
+ *
+ * Determines which toll roads the routing engine may use: some tolls can only be paid by
+ * transponder, others only without one.
+ *
+ * @group Vehicle
+ */
+export declare const tollTransponderOptions: readonly ["all", "unknown", "none"];
+/**
+ * Whether the vehicle carries an electronic toll collection transponder.
+ *
+ * @remarks
+ * - `all` — the vehicle has a transponder accepted by every toll operator on the route
+ * - `unknown` — transponder availability is unknown, so no assumption is made
+ * - `none` — the vehicle has no transponder
+ *
+ * @example
+ * ```typescript
+ * const transponder: TollTransponder = 'all';
+ * ```
+ *
+ * @group Vehicle
+ */
+export type TollTransponder = (typeof tollTransponderOptions)[number];
 /**
  * Parameters for a vehicle which are related to restrictions applied during route planning.
  */
-type VehicleRestrictions = {
+export type VehicleRestrictions = {
   /**
    * Vehicle restrictions applied during route planning.
    */
@@ -1523,6 +1548,24 @@ type VehicleRestrictions = {
      * @default 0
      */
     maxSpeedKMH?: number;
+    /**
+     * Whether the vehicle carries an electronic toll collection transponder.
+     *
+     * @remarks
+     * Affects which toll roads are considered usable: a toll that can only be paid by
+     * transponder is avoided when this is `none`, and a toll that cannot be paid by
+     * transponder is avoided when this is `all`.
+     *
+     * @default 'unknown'
+     *
+     * @example
+     * ```typescript
+     * restrictions: {
+     *   tollTransponder: 'all'
+     * }
+     * ```
+     */
+    tollTransponder?: TollTransponder;
   };
 };
 //#endregion
@@ -6283,11 +6326,25 @@ type AvoidAreasAPI = {
   rectangles: AvoidRectangleAPI[];
 };
 /**
- * V3 per-leg request (used in the `legs` array for route reconstruction).
+ * V3 per-stop request options, nested under the leg that arrives at the stop.
+ * @ignore
+ */
+type RouteStopRequestAPI = {
+  pauseDurationInSeconds?: number;
+  entryPoints?: MultiPoint;
+  preferredEntryPointIndex?: number;
+};
+/**
+ * V3 per-leg request (used in the `legs` array for route reconstruction and per-stop options).
  * @ignore
  */
 type LegRequestAPI = {
   path?: LineString;
+  routeType?: RouteType;
+  avoids?: {
+    name: string;
+  }[];
+  routeStop?: RouteStopRequestAPI;
 };
 /**
  * V3 POST body for /routing/routes/calculate and (partially) /routing/calculateLongDistanceEVRoute.
@@ -6298,7 +6355,7 @@ type CalculateRoutePOSTDataAPI = {
   routePlanningLocations: RoutePlanningLocationsAPI;
   path?: LineString;
   legs?: LegRequestAPI[];
-  routeType?: string;
+  routeType?: RouteType;
   traffic?: string;
   avoids?: string[];
   travelMode?: string;
@@ -6309,6 +6366,8 @@ type CalculateRoutePOSTDataAPI = {
   vehicleWeightInKilograms?: number;
   vehicleMaxSpeedInKilometersPerHour?: number;
   vehicleHeadingInDegrees?: number;
+  vehicleHasElectronicTollCollectionTransponder?: string;
+  arrivalSidePreference?: 'anySide' | 'curbSide';
   chargingParameters?: ChargingParametersAPI;
   guidance?: 'none' | 'instructions';
   instructionPhonetics?: 'ipa' | 'lhp';
@@ -6455,6 +6514,29 @@ type ExtendedRouteRepresentation = 'distance' | 'travelTime';
  * @group Routing
  */
 type ComputeTravelTimeFor = 'none' | 'all';
+/**
+ * Side of the road to arrive on.
+ *
+ * @group Routing
+ */
+declare const arrivalSides: readonly ["any", "curb"];
+/**
+ * Which side of the road the route should arrive on at each stop.
+ *
+ * @remarks
+ * - `any`: arrive from either side, whichever is faster
+ * - `curb`: arrive on the curb side for the country's driving direction
+ *
+ * @example
+ * ```typescript
+ * const arrivalSide: ArrivalSide = 'curb';
+ * ```
+ *
+ * @default 'any'
+ *
+ * @group Routing
+ */
+type ArrivalSide = (typeof arrivalSides)[number];
 /**
  * Maximum number of alternative routes to calculate.
  *
@@ -6597,7 +6679,26 @@ type CalculateRouteParams = CommonServiceParams<CalculateRouteRequestAPI, Calcul
    */
   useEntryPoints?: GetPositionEntryPointOption;
   /**
-   * Request additional travel time calculations for different traffic scenarios.
+   * Which side of the road the route should arrive on.
+   *
+   * @remarks
+   * - `any`: arrive from either side, whichever is faster
+   * - `curb`: arrive on the curb side for the country's driving direction, so passengers or
+   *   deliveries can leave the vehicle without crossing the road
+   *
+   * Applies to the destination and to every intermediate stop.
+   *
+   * @default 'any'
+   *
+   * @example
+   * ```typescript
+   * // Pull up on the passenger side at each stop
+   * arrivalSide: 'curb'
+   * ```
+   */
+  arrivalSide?: ArrivalSide;
+  /**
+   * Request travel time calculations for different traffic scenarios.
    *
    * When set to 'all', the returned route summary will contain extra fields:
    * - `noTrafficTravelTimeInSeconds` – Free-flow (no traffic)
@@ -6610,10 +6711,10 @@ type CalculateRouteParams = CommonServiceParams<CalculateRouteRequestAPI, Calcul
    *
    * @example
    * ```typescript
-   * computeAdditionalTravelTimeFor: 'all'
+   * computeTravelTimeFor: 'all'
    * ```
    */
-  computeAdditionalTravelTimeFor?: ComputeTravelTimeFor;
+  computeTravelTimeFor?: ComputeTravelTimeFor;
   /**
    * Request extended progress information at route polyline points.
    *
@@ -8436,6 +8537,101 @@ export declare const calculateReachableRanges: (paramsArray: ReachableRangeParam
  */
 export declare const calculateRoute: (params: CalculateRouteParams, customTemplate?: Partial<CalculateRouteTemplate>) => Promise<Routes>;
 //#endregion
+//#region src/routing/types/routeStopOptions.d.ts
+/**
+ * Cost model overrides that apply to a single leg of a route.
+ *
+ * @remarks
+ * A subset of {@link CostModel}: only the route type and the avoid list can vary per leg.
+ * Traffic, avoid areas and departure time are route-wide.
+ *
+ * @group Routing
+ */
+type LegCostModel = Pick<CostModel, 'routeType' | 'avoid'>;
+/**
+ * Per-stop routing options, carried on the `properties` of a route stop.
+ *
+ * Attach these to any waypoint in {@link CalculateRouteParams.locations} to control how the
+ * route reaches that stop, and how long it waits there.
+ *
+ * @remarks
+ * **Leg attribution.** Options describe the leg *arriving at* this stop. Reading them that way
+ * is what keeps them attached to the right stop when another stop is inserted earlier in the
+ * list. `legCostModel` on the origin has no leg to describe and is ignored.
+ *
+ * **The wait at a stop** is {@link WaypointProps.pauseDurationSeconds}, which every waypoint
+ * carries — the map reads it too, to label the stop's pin.
+ *
+ * **Entry points.** Explicit `candidateEntryPoints` hand the routing engine a set of approach
+ * points and let it choose; this takes precedence over the route-wide
+ * {@link CalculateRouteParams.useEntryPoints}, which only resolves a single position
+ * client-side.
+ *
+ * @example
+ * ```typescript
+ * import type { Waypoint } from '@tomtom-org/maps-sdk/core';
+ * import type { RouteStopOptions } from '@tomtom-org/maps-sdk/services';
+ *
+ * const stop: Waypoint<RouteStopOptions> = {
+ *     type: 'Feature',
+ *     geometry: { type: 'Point', coordinates: [4.7, 52.1] },
+ *     properties: {
+ *         // wait 20 minutes at this stop
+ *         pauseDurationSeconds: 1200,
+ *         // reach this stop without using motorways
+ *         legCostModel: { routeType: 'short', avoid: ['motorways'] },
+ *     },
+ * };
+ *
+ * const route = await calculateRoute({ locations: [origin, stop, destination] });
+ * ```
+ *
+ * @group Routing
+ */
+type RouteStopOptions = {
+  /**
+   * Candidate approach points for this stop, for the routing engine to choose between.
+   *
+   * @remarks
+   * Use this when a place has several usable entrances and you want the engine to pick the one
+   * that suits the route, rather than resolving a single entry point yourself. Takes precedence
+   * over {@link CalculateRouteParams.useEntryPoints} for this stop.
+   *
+   * Deliberately not called `entryPoints`: a {@link Place} already carries `entryPoints` of its
+   * own in `properties`, describing entrances found by search, and those are not sent to the
+   * routing API. These are positions you choose to offer the router.
+   *
+   * @example
+   * ```typescript
+   * // Let the router choose between the main and the delivery entrance
+   * candidateEntryPoints: [[4.701, 52.101], [4.703, 52.099]]
+   * ```
+   */
+  candidateEntryPoints?: HasLngLat[];
+  /**
+   * Index into {@link RouteStopOptions.candidateEntryPoints} of the preferred approach point.
+   *
+   * @remarks
+   * The routing engine uses this entry point unless another one produces a materially better
+   * route. Ignored when `candidateEntryPoints` is not set.
+   */
+  preferredEntryPointIndex?: number;
+  /**
+   * Cost model overrides for the leg *arriving at* this stop.
+   *
+   * @remarks
+   * Falls back to the route-wide {@link CostModel} for anything not set here. Ignored on the
+   * origin, which has no arriving leg.
+   *
+   * @example
+   * ```typescript
+   * // Take the scenic way to this one stop
+   * legCostModel: { routeType: 'thrilling', avoid: ['motorways'] }
+   * ```
+   */
+  legCostModel?: LegCostModel;
+};
+//#endregion
 //#region src/fuzzy-search/types/fuzzySearchResponse.d.ts
 /**
  * Response from the fuzzy search service.
@@ -9079,4 +9275,4 @@ export declare const trafficAreaAnalytics: (params: TrafficAreaAnalyticsParams,
  */
 export declare const trafficIncidentDetails: (params: TrafficIncidentDetailsParams, customTemplate?: Partial<TrafficIncidentDetailsTemplate>) => Promise<TrafficIncidentDetails>;
 //#endregion
-export type { AdditionalDataAPI, AlongRouteSearchParams, AlongRouteSearchPayloadAPI, AlongRouteSearchRequestAPI, AlongRouteSearchResponse, AlongRouteSearchResponseAPI, AlongRouteSearchResultAPI, AlongRouteSortBy, AreaAnalyticsDateInput, AreaTag, AutocompleteGenericSearchSegment, AutocompleteSearchBrandSegment, AutocompleteSearchCategorySegment, AutocompleteSearchCategorySegmentAPI, AutocompleteSearchContext, AutocompleteSearchContextAPI, AutocompleteSearchMatch, AutocompleteSearchMatches, AutocompleteSearchParams, AutocompleteSearchPlaintextSegment, AutocompleteSearchResponse, AutocompleteSearchResponseAPI, AutocompleteSearchResult, AutocompleteSearchResultAPI, AutocompleteSearchResultGeoBias, AutocompleteSearchResultGeoBiasAPI, AutocompleteSearchSegment, AutocompleteSearchSegmentAPI, AutocompleteSearchSegmentType, BookmarkIntent, BookmarkIntentDetails, CalculateRouteParams, CanonicalAreaTag, ChargingStationsAvailabilityParams, Circle, CircleAPI, CommonServiceParamsWithZoom, ComputeTravelTimeFor, CoordinateIntent, CoordinateIntentAPI, CoordinateIntentDetails, CoordinateIntentDetailsAPI, ExplorationBrandAPI, ExplorationChargingParkAPI, ExplorationClassificationAPI, ExplorationOpeningHoursAPI, ExplorationOpeningIntervalAPI, ExplorationPOIAPI, ExplorationPlaceProps, ExplorationRecordType, ExplorationSearchParams, ExplorationSearchPayloadAPI, ExplorationSearchRequestAPI, ExplorationSearchResponse, ExplorationSearchResponseAPI, ExplorationSearchResultAPI, ExplorationViewportAPI, ExtendedRouteRepresentation, FunctionalRoadClass, FuzzySearchParams, FuzzySearchResponse, FuzzySearchResponseAPI, FuzzySearchResultAPI, GeocodingParams, GeocodingProps, GeocodingResponse, GeometriesInput, GeometryAPI, GeometryDataParams, GeometryDataResponseAPI, GeometryParams, GeometryPlaceParams, GeometrySearchFeatureCollectionProps, GeometrySearchParams, GeometrySearchPayloadAPI, GeometrySearchRequestAPI, GeometrySearchResponse, GeometrySearchResponseAPI, GeometrySearchResultAPI, GuidanceParams, InputSectionType, InputSectionTypes, MaxNumberOfAlternatives, NearAPI, NearbyIntent, NearbyIntentAPI, NearbyIntentDetails, NearbyIntentDetailsAPI, POICategoriesParams, POICategoriesResponse, POICategoryResult, PlaceByIdMandatoryParams, PlaceByIdOptionalParams, PlaceByIdParams, PlaceByIdResponse, PlaceByIdResponseAPI, PlaceByIdResultAPI, PoiCategoriesResponseAPI, PoiCategoryAPI, PolygonAPI, PopulatedAreaTag, QueryIntent, QueryIntentAPI, ReverseGeocodingMandatoryParams, ReverseGeocodingOptionalParams, ReverseGeocodingParams, RoutePointAPI, SearchGeometryInput, TrafficAreaAnalyticsDateRange, TrafficAreaAnalyticsDays, TrafficAreaAnalyticsParams, TrafficIncidentDetailsByBBoxParams, TrafficIncidentDetailsByIdsParams, TrafficIncidentDetailsParams, W3WIntent, W3WIntentDetails, functionalRoadClasses, metricKeyToApiDataType };
+export type { AdditionalDataAPI, AlongRouteSearchParams, AlongRouteSearchPayloadAPI, AlongRouteSearchRequestAPI, AlongRouteSearchResponse, AlongRouteSearchResponseAPI, AlongRouteSearchResultAPI, AlongRouteSortBy, AreaAnalyticsDateInput, AreaTag, ArrivalSide, AutocompleteGenericSearchSegment, AutocompleteSearchBrandSegment, AutocompleteSearchCategorySegment, AutocompleteSearchCategorySegmentAPI, AutocompleteSearchContext, AutocompleteSearchContextAPI, AutocompleteSearchMatch, AutocompleteSearchMatches, AutocompleteSearchParams, AutocompleteSearchPlaintextSegment, AutocompleteSearchResponse, AutocompleteSearchResponseAPI, AutocompleteSearchResult, AutocompleteSearchResultAPI, AutocompleteSearchResultGeoBias, AutocompleteSearchResultGeoBiasAPI, AutocompleteSearchSegment, AutocompleteSearchSegmentAPI, AutocompleteSearchSegmentType, BookmarkIntent, BookmarkIntentDetails, CalculateRouteParams, CanonicalAreaTag, ChargingStationsAvailabilityParams, Circle, CircleAPI, CommonServiceParamsWithZoom, ComputeTravelTimeFor, CoordinateIntent, CoordinateIntentAPI, CoordinateIntentDetails, CoordinateIntentDetailsAPI, ExplorationBrandAPI, ExplorationChargingParkAPI, ExplorationClassificationAPI, ExplorationOpeningHoursAPI, ExplorationOpeningIntervalAPI, ExplorationPOIAPI, ExplorationPlaceProps, ExplorationRecordType, ExplorationSearchParams, ExplorationSearchPayloadAPI, ExplorationSearchRequestAPI, ExplorationSearchResponse, ExplorationSearchResponseAPI, ExplorationSearchResultAPI, ExplorationViewportAPI, ExtendedRouteRepresentation, FunctionalRoadClass, FuzzySearchParams, FuzzySearchResponse, FuzzySearchResponseAPI, FuzzySearchResultAPI, GeocodingParams, GeocodingProps, GeocodingResponse, GeometriesInput, GeometryAPI, GeometryDataParams, GeometryDataResponseAPI, GeometryParams, GeometryPlaceParams, GeometrySearchFeatureCollectionProps, GeometrySearchParams, GeometrySearchPayloadAPI, GeometrySearchRequestAPI, GeometrySearchResponse, GeometrySearchResponseAPI, GeometrySearchResultAPI, GuidanceParams, InputSectionType, InputSectionTypes, LegCostModel, MaxNumberOfAlternatives, NearAPI, NearbyIntent, NearbyIntentAPI, NearbyIntentDetails, NearbyIntentDetailsAPI, POICategoriesParams, POICategoriesResponse, POICategoryResult, PlaceByIdMandatoryParams, PlaceByIdOptionalParams, PlaceByIdParams, PlaceByIdResponse, PlaceByIdResponseAPI, PlaceByIdResultAPI, PoiCategoriesResponseAPI, PoiCategoryAPI, PolygonAPI, PopulatedAreaTag, QueryIntent, QueryIntentAPI, ReverseGeocodingMandatoryParams, ReverseGeocodingOptionalParams, ReverseGeocodingParams, RoutePointAPI, RouteStopOptions, SearchGeometryInput, TrafficAreaAnalyticsDateRange, TrafficAreaAnalyticsDays, TrafficAreaAnalyticsParams, TrafficIncidentDetailsByBBoxParams, TrafficIncidentDetailsByIdsParams, TrafficIncidentDetailsParams, W3WIntent, W3WIntentDetails, arrivalSides, functionalRoadClasses, metricKeyToApiDataType };