@tomtom-org/maps-sdk 0.53.0 → 0.55.1

package/services/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ZodError, ZodIssue, ZodObject } from "zod";
-import { AddressProperties, AreaAnalyticsMetricKey, Avoidable, BBox, ChargingPark, ChargingParkWithAvailability, ChargingStation, ChargingStationsAccessType, ChargingStationsAvailability, ChargingStopProps, CommonPlaceProps, Connector, ConnectorType, CurrentType, EVChargingStationWithAvailabilityPlaceProps, EntryPoint, Fuel, GeographyType, GetPositionEntryPointOption, GlobalConfig, HasBBox, HasLngLat, Instruction, MapcodeType, OpeningHours, OpeningHoursMode, POICategory, Place, PlaceType, Places, PlugType, PolygonFeature, PolygonFeatures, RevGeoAddressProps, RoadShieldReference, Route, RoutePlanningLocation, Routes, SearchPlaceProps, TimeZone, TomTomAPIHeaders, TomTomHeaders, TrafficAreaAnalytics, TrafficIncidentDetails, TrafficIncidentRequestCategory, TrafficIncidentTEC, TrafficIncidentTimeValidity, TravelMode, View, inputSectionTypes } from "@tomtom-org/maps-sdk/core";
+import { AddressProperties, AreaAnalyticsMetricKey, Avoidable, BBox, ChargingPark, ChargingParkWithAvailability, ChargingStation, ChargingStationsAccessType, ChargingStationsAvailability, ChargingStopProps, CommonPlaceProps, Connector, ConnectorType, CurrentType, EVChargingStationWithAvailabilityPlaceProps, EntryPoint, Fuel, GeographyType, GetPositionEntryPointOption, GlobalConfig, HasBBox, HasLngLat, MapcodeType, OpeningHours, OpeningHoursMode, POICategory, Place, PlaceType, Places, PlugType, PolygonFeature, PolygonFeatures, RevGeoAddressProps, RoadShieldReference, Route, RoutePlanningLocation, Routes, SearchPlaceProps, TimeZone, TomTomAPIHeaders, TomTomHeaders, TrafficAreaAnalytics, TrafficIncidentDetails, TrafficIncidentRequestCategory, TrafficIncidentTEC, TrafficIncidentTimeValidity, TravelMode, View, inputSectionTypes } from "@tomtom-org/maps-sdk/core";
 //#region src/shared/types/apiResponseErrorTypes.d.ts
 /**
  * @ignore
@@ -65,6 +65,13 @@ export type FetchInput<PostData = void> = ({
 } & GetObject) | ({
   method: 'POST';
 } & PostObject<PostData>);
+/**
+ * Per-call HTTP options threaded from service params down to `fetch`.
+ * @ignore
+ */
+export type RequestOptions = {
+  signal?: AbortSignal;
+};
 export type ParsedFetchResponse<T> = Promise<{
   data: Promise<T>;
   status: number;
@@ -155,6 +162,36 @@ export type CommonServiceParams<ApiRequest = any, ApiResponse = any> = Partial<G
    * @param apiResponse - The received raw (unparsed) API response
    */
   onAPIResponse?: (apiRequest: ApiRequest, apiResponse: ApiResponse) => void;
+  /**
+   * An `AbortSignal` used to cancel the request.
+   *
+   * @remarks
+   * Aborting rejects the call with an {@link SDKAbortError} (its `name` is `'AbortError'`)
+   * and cancels the underlying HTTP request, including while the SDK is waiting to retry
+   * a rate-limited (429) response. Aborting a call that already completed has no effect.
+   *
+   * Compose signals to add a deadline: `AbortSignal.any([mine, AbortSignal.timeout(5000)])`.
+   *
+   * @example
+   * Cancel the previous search whenever a new one starts:
+   * ```ts
+   * let controller: AbortController | undefined;
+   *
+   * const searchForQuery = async (query: string) => {
+   *     controller?.abort();
+   *     controller = new AbortController();
+   *     try {
+   *         return await search({ query, signal: controller.signal });
+   *     } catch (error) {
+   *         if (error instanceof SDKAbortError) return;
+   *         throw error;
+   *     }
+   * };
+   * ```
+   *
+   * @defaultValue `undefined` (the request cannot be cancelled)
+   */
+  signal?: AbortSignal;
 };
 /**
  * Function type for parsing API error responses into SDK service errors.
@@ -217,9 +254,10 @@ export type ServiceTemplate<Params extends CommonServiceParams<ApiRequest, ApiRe
    *
    * @param request - The request object to send
    * @param headers - Custom TomTom headers to include in the request
+   * @param options - Per-call HTTP options, such as the `AbortSignal` used to cancel the request
    * @returns A promise resolving to the parsed fetch response
    */
-  sendRequest: (request: ApiRequest, headers: TomTomHeaders) => ParsedFetchResponse<ApiResponse>;
+  sendRequest: (request: ApiRequest, headers: TomTomHeaders, options?: RequestOptions) => ParsedFetchResponse<ApiResponse>;
   /**
    * Parses the successful API response into the expected return type.
    *
@@ -336,6 +374,35 @@ export declare class SDKServiceError extends SDKError {
    */
   constructor(message: string, service: string, status?: number);
 }
+/**
+ * Error class for cancelled service calls.
+ *
+ * Thrown when the `signal` passed to a service call is aborted, either before the
+ * request is sent or while it is in flight. Its `name` is `'AbortError'`, matching
+ * the convention used by `fetch`, and the original abort reason — including a custom
+ * value passed to `AbortController.abort(reason)` — is available on `cause`.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await search({ query: 'cafe', signal: controller.signal });
+ * } catch (error) {
+ *   if (error instanceof SDKAbortError) return; // superseded by a newer search
+ *   throw error;
+ * }
+ * ```
+ *
+ * @group Errors
+ */
+export declare class SDKAbortError extends SDKError {
+  /**
+   * Creates a new SDKAbortError instance.
+   *
+   * @param service - Name of the service whose call was cancelled
+   * @param cause - The abort reason carried by the signal
+   */
+  constructor(service: string, cause?: unknown);
+}
 /**
  * @ignore
  * @param error
@@ -348,8 +415,9 @@ export declare const parseDefaultResponseError: ParseResponseError<DefaultAPIRes
  * @param error The error captured by a catch function.
  * @param serviceName The name of the service.
  * @param parseResponseError
+ * @param signal The signal given to the call, used to recognise a cancellation.
  */
-export declare const buildResponseError: (error: unknown, serviceName: ServiceName, parseResponseError?: ParseResponseError<unknown>) => SDKError;
+export declare const buildResponseError: (error: unknown, serviceName: ServiceName, parseResponseError?: ParseResponseError<unknown>, signal?: AbortSignal) => SDKError;
 /**
  * @ignore
  * @param error
@@ -357,6 +425,66 @@ export declare const buildResponseError: (error: unknown, serviceName: ServiceNa
  */
 export declare const buildValidationError: (error: ValidationError, serviceName: ServiceName) => SDKError;
 //#endregion
+//#region src/shared/types/geoBias.d.ts
+/**
+ * A point to search around, optionally bounded by a radius.
+ *
+ * @remarks
+ * Without `radiusMeters` the point biases the ranking without restricting results; with it, results
+ * are confined to that circle.
+ *
+ * @group Search
+ */
+export type PointGeoBias = {
+  /**
+   * The point to search around, as `[longitude, latitude]` or any GeoJSON form carrying one.
+   */
+  position: HasLngLat;
+  /**
+   * Radius around `position`, in metres. Values of zero or less are ignored by the API.
+   */
+  radiusMeters?: number;
+};
+/**
+ * A rectangle to confine results to.
+ *
+ * @group Search
+ */
+export type BoundingBoxGeoBias = {
+  /**
+   * The rectangle, as `[minLongitude, minLatitude, maxLongitude, maxLatitude]` or any GeoJSON
+   * value a bounding box can be derived from — a `bbox` property, a Feature, or a geometry.
+   */
+  boundingBox: HasBBox;
+};
+/**
+ * Where to look: a point with an optional radius, or a bounding box — one or the other.
+ *
+ * @remarks
+ * The two cannot be combined, which is why they are a union rather than separate options: an
+ * endpoint applies exactly one geographic bias per request.
+ *
+ * @example
+ * ```typescript
+ * // Around a point, ranking bias only
+ * const nearAmsterdam: GeoBias = { position: [4.9, 52.3] };
+ *
+ * // Around a point, confined to 2 km
+ * const within2km: GeoBias = { position: [4.9, 52.3], radiusMeters: 2000 };
+ *
+ * // Inside the visible map area
+ * const inViewport: GeoBias = { boundingBox: map.getBounds().toArray().flat() as BBox };
+ * ```
+ *
+ * @group Search
+ */
+export type GeoBias = (PointGeoBias & {
+  boundingBox?: never;
+}) | (BoundingBoxGeoBias & {
+  position?: never;
+  radiusMeters?: never;
+});
+//#endregion
 //#region src/shared/types/commonGeocodeAndFuzzySearchParams.d.ts
 /**
  * Common parameters shared between fuzzy search and geocoding services.
@@ -433,86 +561,19 @@ export type CommonGeocodeAndFuzzySearchParams = {
    */
   offset?: number;
   /**
-   * Search radius in meters around the specified position.
-   *
-   * When used with `position`, constrains results to locations within
-   * this distance from the position. Creates a circular search area.
-   *
-   * @remarks
-   * **Behavior:**
-   * - Must be used with `position` parameter
-   * - Values ≤ 0 are ignored (parameter has no effect)
-   * - Mutually exclusive with `boundingBox` (radius takes precedence)
-   *
-   * **Typical Values:**
-   * - 500m: Immediate vicinity (walking distance)
-   * - 2000m: Neighborhood area
-   * - 5000m: City district
-   * - 10000m: Greater city area
-   *
-   * @example
-   * ```typescript
-   * // Search within 1km radius
-   * radiusMeters: 1000
-   *
-   * // Search within 5km radius
-   * radiusMeters: 5000
-   *
-   * // Combined with position
-   * position: [4.9, 52.3],
-   * radiusMeters: 2000  // Within 2km of Amsterdam center
-   * ```
-   */
-  radiusMeters?: number;
-  /**
-   * Bounding box to constrain search results to a rectangular area.
-   *
-   * Filters results to only include locations within the specified bounding box.
-   * Accepts various GeoJSON formats that contain or can derive a bounding box.
+   * Where to look: a point with an optional radius, or a bounding box.
    *
    * @remarks
-   * **Accepted Formats:**
-   * - Direct BBox array: `[minLng, minLat, maxLng, maxLat]`
-   * - GeoJSON Feature/FeatureCollection with bbox property
-   * - Any GeoJSON geometry (bbox calculated automatically)
-   *
-   * **Important:**
-   * - Mutually exclusive with Point-Radius parameters
-   * - Point-Radius (`position` + `radiusMeters`) takes precedence if both provided
-   * - Useful for map viewport filtering
-   *
-   * **Use Cases:**
-   * - "Search in visible map area"
-   * - City/region boundary filtering
-   * - Custom geographic restrictions
+   * A point without `radiusMeters` biases the ranking; with one, or with a `boundingBox`, results
+   * are confined to that area. Leave it out to search without a geographic bias.
    *
    * @example
    * ```typescript
-   * // Direct bounding box (Amsterdam area)
-   * boundingBox: [4.8, 52.3, 5.0, 52.4]
-   *
-   * // From GeoJSON Feature
-   * boundingBox: {
-   *   type: 'Feature',
-   *   bbox: [4.8, 52.3, 5.0, 52.4],
-   *   geometry: { ... },
-   *   properties: {}
-   * }
-   *
-   * // From Polygon (bbox calculated)
-   * boundingBox: {
-   *   type: 'Polygon',
-   *   coordinates: [[
-   *     [4.8, 52.3],
-   *     [5.0, 52.3],
-   *     [5.0, 52.4],
-   *     [4.8, 52.4],
-   *     [4.8, 52.3]
-   *   ]]
-   * }
+   * geoBias: { position: [4.9, 52.3], radiusMeters: 2000 }
+   * geoBias: { boundingBox: [4.8, 52.3, 5.0, 52.4] }
    * ```
    */
-  boundingBox?: HasBBox;
+  geoBias?: GeoBias;
   /**
    * Restrict search to specific countries.
    *
@@ -3960,28 +4021,19 @@ type AutocompleteSearchParams = CommonServiceParams<URL, AutocompleteSearchRespo
    */
   query: string;
   /**
-   * Position to bias results towards.
-   *
-   * Results closer to this location will be ranked higher in suggestions.
+   * The point to bias suggestions towards, and how far around it to look.
    *
    * @remarks
-   * Can be provided as:
-   * - Object with `lon` and `lat` properties
-   * - Array `[longitude, latitude]`
-   *
-   * When used without `radiusMeters`, biases results but doesn't restrict them.
-   * When used with `radiusMeters`, constrains results to that area.
+   * This endpoint biases by point only — it takes no bounding box. Without `radiusMeters` the
+   * point ranks nearer suggestions higher without restricting them.
    *
    * @example
    * ```typescript
-   * // Object format
-   * position: { lon: 4.9041, lat: 52.3676 }
-   *
-   * // Array format
-   * position: [4.9041, 52.3676]
+   * geoBias: { position: [4.9041, 52.3676] }
+   * geoBias: { position: [4.9041, 52.3676], radiusMeters: 5000 }
    * ```
    */
-  position?: HasLngLat;
+  geoBias?: PointGeoBias;
   /**
    * Maximum number of suggestions to return.
    *
@@ -3995,24 +4047,6 @@ type AutocompleteSearchParams = CommonServiceParams<URL, AutocompleteSearchRespo
    * ```
    */
   limit?: number;
-  /**
-   * Search radius in meters from the position.
-   *
-   * When combined with `position`, restricts results to within this radius.
-   * Without `position`, this parameter is ignored.
-   *
-   * @remarks
-   * Only results within this distance from `position` will be returned.
-   * Values ≤ 0 are ignored.
-   *
-   * @example
-   * ```typescript
-   * // Search within 5km of position
-   * position: [4.9, 52.3],
-   * radiusMeters: 5000
-   * ```
-   */
-  radiusMeters?: number;
   /**
    * Restrict results to specific countries.
    *
@@ -4422,31 +4456,6 @@ type GeocodingParams = Omit<CommonPlacesParams<URL, GeocodingResponseAPI> & Comm
    * ```
    */
   query: string;
-  /**
-   * Geographic position to bias geocoding results toward.
-   *
-   * When provided, results closer to this position are ranked higher.
-   * Useful for resolving ambiguous queries (e.g. "Main Street") to
-   * the right city or region.
-   *
-   * Accepts any {@link HasLngLat}-compatible value:
-   * - `[longitude, latitude]` coordinate pair
-   * - GeoJSON `Point` geometry
-   * - GeoJSON `Feature<Point>` — pass a {@link Place} directly
-   *
-   * @example
-   * ```typescript
-   * // Coordinate pair
-   * position: [4.9041, 52.3676]
-   *
-   * // Place result from a previous search (e.g. user's selected location)
-   * position: selectedPlace
-   *
-   * // GeoJSON Point
-   * position: { type: 'Point', coordinates: [4.9041, 52.3676] }
-   * ```
-   */
-  position?: HasLngLat;
   /**
    * Indexes for which extended postal codes should be included in the results.
    *
@@ -5345,12 +5354,12 @@ type ReachableRangeRequestAPI = FetchInput;
 //#endregion
 //#region src/routing/types/apiResponseTypes.d.ts
 /**
- * V3 traffic section icon categories.
+ * Traffic section icon categories.
  * @ignore
  */
 type IconCategoryAPI = 'jam' | 'accident' | 'brokenDownVehicle' | 'dangerousConditions' | 'flooding' | 'fog' | 'ice' | 'laneClosed' | 'rain' | 'roadClosed' | 'roadWorks' | 'wind';
 /**
- * V3 delay magnitude values. `'undefined'` is the raw API value mapped to SDK `'indefinite'`.
+ * Delay magnitude values. `'undefined'` is the raw API value mapped to SDK `'indefinite'`.
  * @ignore
  */
 type DelayMagnitudeAPI = 'unknown' | 'minor' | 'moderate' | 'major' | 'undefined';
@@ -5395,7 +5404,7 @@ type ChargingStopAPI = Omit<ChargingStopProps, 'targetChargeInPCT' | 'chargingCo
   };
 };
 /**
- * V3 summary — field names changed from V2.
+ * Route summary as the API returns it.
  * @ignore
  */
 type SummaryAPI = {
@@ -5408,6 +5417,7 @@ type SummaryAPI = {
   deviationDistanceInMeters?: number;
   deviationDurationInSeconds?: number;
   deviationPoint?: Point;
+  originalWaypointIndexAtEndOfLeg?: number;
   historicTrafficTravelTimeInSeconds?: number;
   liveTrafficIncidentsTravelTimeInSeconds?: number;
   noTrafficTravelTimeInSeconds?: number;
@@ -5419,7 +5429,7 @@ type SummaryAPI = {
   chargingInformationAtEndOfLeg?: ChargingStopAPI;
 };
 /**
- * V3 leg — path is now a GeoJSON LineString instead of a points array.
+ * Route leg. Its path is a GeoJSON LineString, not a points array.
  * @ignore
  */
 type LegAPI = {
@@ -5427,7 +5437,7 @@ type LegAPI = {
   summary: SummaryAPI;
 };
 /**
- * V3 basic section — uses pathIndex instead of pointIndex.
+ * Basic section. Spans are expressed with pathIndex, not pointIndex.
  * @ignore
  */
 type BasicSectionAPI = {
@@ -5458,7 +5468,7 @@ type TrafficSectionAPI = BasicSectionAPI & {
   eventId?: string;
 };
 /**
- * V3 speed limit section — speed values live under `speedRestrictions` (typed maximum/minimum)
+ * Speed limit section — speed values live under `speedRestrictions` (typed maximum/minimum)
  * instead of the V2 flat `maxSpeedLimitInKmh`.
  * @ignore
  */
@@ -5469,7 +5479,7 @@ type SpeedLimitSectionAPI = BasicSectionAPI & {
   }[];
 };
 /**
- * V3 lanes section — directions/separators are camelCase strings (mapped to the SDK's
+ * Lanes section — directions/separators are camelCase strings (mapped to the SDK's
  * UPPER_SNAKE enums during parsing), and lanes are objects rather than flat direction lists.
  * @ignore
  */
@@ -5496,7 +5506,7 @@ type ImportantRoadStretchSectionAPI = BasicSectionAPI & {
   }[];
 };
 /**
- * V3 sections object — already grouped by type (no flat array + discriminator).
+ * Sections object, grouped by type rather than a flat array with a discriminator.
  * @ignore
  */
 type SectionsAPI = {
@@ -5518,11 +5528,12 @@ type SectionsAPI = {
   roadShields?: (BasicSectionAPI & {
     roadShieldReferences?: RoadShieldReference[];
   })[];
+  tollRoad?: BasicSectionAPI[];
   tollVignette?: CountrySectionAPI[];
   importantRoadStretch?: ImportantRoadStretchSectionAPI[];
 };
 /**
- * V3 lat/lon point used in guidance instructions (different from GeoJSON used elsewhere).
+ * Lat/lon point used in guidance instructions (different from the GeoJSON used elsewhere).
  * @ignore
  */
 type LatLonPointAPI = {
@@ -5530,7 +5541,7 @@ type LatLonPointAPI = {
   longitude: number;
 };
 /**
- * V3 routePath point — field names changed from V2.
+ * A point on the route path.
  * @ignore
  */
 type RoutePathPointAPI = {
@@ -5539,24 +5550,17 @@ type RoutePathPointAPI = {
   travelTimeFromRouteStartInSeconds: number;
 };
 /**
- * V3 phonetic transcription — an object keyed by phonetic alphabet, not a flat string as in V2.
- * @ignore
- */
-type PhoneticAPI = {
-  lhp?: string;
-  ipa?: string;
-};
-/**
- * V3 text-with-phonetics — `phonetic` is now an object (mapped to a flat string during parsing).
+ * Text with phonetics. `phonetic` is a flat string, already transcribed in the alphabet the
+ * request asked for via `instructionPhonetics` — there is no per-alphabet object to choose from.
  * @ignore
  */
 type TextWithPhoneticsAPI = {
   text: string;
-  phonetic?: PhoneticAPI;
+  phonetic?: string;
   phoneticLanguageCode?: string;
 };
 /**
- * V3 icon reference — same shape as the SDK's RoadShieldReference.
+ * Icon reference — same shape as the SDK's RoadShieldReference.
  * @ignore
  */
 type IconReferenceAPI = {
@@ -5565,7 +5569,7 @@ type IconReferenceAPI = {
   affixes?: string[];
 };
 /**
- * V3 road shield inside an instruction's road information. `iconReference` is EXPLICIT.
+ * Road shield inside an instruction's road information. `iconReference` is EXPLICIT.
  * @ignore
  */
 type InstructionRoadShieldAPI = {
@@ -5575,7 +5579,25 @@ type InstructionRoadShieldAPI = {
   iconReference?: IconReferenceAPI;
 };
 /**
- * V3 road information inside an instruction — field names changed from V2.
+ * Side road. `side` is lowercase on the wire, mapped to the SDK's UPPER_SNAKE `SideRoadSide`.
+ * @ignore
+ */
+type SideRoadAPI = {
+  side: string;
+  offsetFromManeuverInMeters: number;
+  isDrivable?: boolean;
+};
+/**
+ * Maneuver view. Both angle fields are relative-direction strings (`slightLeft`, `back`, …),
+ * not degrees, and are mapped to the SDK's UPPER_SNAKE `ManeuverAngle`.
+ * @ignore
+ */
+type ManeuverViewAPI = {
+  onRouteAngle?: string;
+  offRouteAngles?: string[];
+};
+/**
+ * Road information inside an instruction.
  * @ignore
  */
 type InstructionRoadInformationAPI = {
@@ -5583,13 +5605,16 @@ type InstructionRoadInformationAPI = {
   roadShields?: InstructionRoadShieldAPI[];
   roadNames?: Array<{
     identifier: TextWithPhoneticsAPI;
+    source?: string;
   }>;
   roadNumbers?: Array<{
     identifier: TextWithPhoneticsAPI;
+    source?: string;
   }>;
+  countryCodeIso2?: string;
 };
 /**
- * V3 signpost — adds an EXPLICIT `exitIconReference` (mapped to signpostRoadShieldReferences).
+ * Signpost. Carries an EXPLICIT `exitIconReference`, mapped to signpostRoadShieldReferences.
  * @ignore
  */
 type SignpostAPI = {
@@ -5599,7 +5624,7 @@ type SignpostAPI = {
   exitIconReference?: IconReferenceAPI;
 };
 /**
- * V3 instruction — raw response shape. Coordinates are lat/lon (not GeoJSON), and several field
+ * Instruction — raw response shape. Coordinates are lat/lon (not GeoJSON), and several field
  * names / value casings differ from the SDK's {@link Instruction}; the parser converts them.
  * @ignore
  */
@@ -5625,10 +5650,14 @@ type InstructionAPI = {
   countryCrossingFromCodeIso2?: string;
   countryCrossingToName?: TextWithPhoneticsAPI;
   countryCrossingToCodeIso2?: string;
-  sideRoads?: Instruction['sideRoads'];
+  sideRoads?: SideRoadAPI[];
+  /** Generated, localised instruction text. Present on every instruction. */
+  message?: string;
+  maneuverView?: ManeuverViewAPI;
+  roundaboutType?: string;
 };
 /**
- * V3 progress point — field names differ from the SDK's RouteProgressPoint.
+ * Progress point. Its field names differ from the SDK's RouteProgressPoint.
  * @ignore
  */
 type ProgressPointAPI = {
@@ -6294,7 +6323,7 @@ declare const customize$3: {
 //#endregion
 //#region src/routing/types/apiRequestTypes.d.ts
 /**
- * V3 charging model sent in the POST body of the LDEVR endpoint.
+ * Charging model sent in the POST body of the LDEVR endpoint.
  * @ignore
  */
 type ChargingParametersAPI = {
@@ -6311,7 +6340,7 @@ type RoutePlanningLocationsAPI = {
   waypoints?: MultiPoint;
 };
 /**
- * V3 avoid area rectangle expressed as a GeoJSON Feature with a bbox.
+ * Avoid area rectangle expressed as a GeoJSON Feature with a bbox.
  * @ignore
  */
 type AvoidRectangleAPI = {
@@ -6326,7 +6355,7 @@ type AvoidAreasAPI = {
   rectangles: AvoidRectangleAPI[];
 };
 /**
- * V3 per-stop request options, nested under the leg that arrives at the stop.
+ * Per-stop request options, nested under the leg that arrives at the stop.
  * @ignore
  */
 type RouteStopRequestAPI = {
@@ -6335,7 +6364,7 @@ type RouteStopRequestAPI = {
   preferredEntryPointIndex?: number;
 };
 /**
- * V3 per-leg request (used in the `legs` array for route reconstruction and per-stop options).
+ * Per-leg request, used in the `legs` array for route reconstruction and per-stop options.
  * @ignore
  */
 type LegRequestAPI = {
@@ -6347,7 +6376,7 @@ type LegRequestAPI = {
   routeStop?: RouteStopRequestAPI;
 };
 /**
- * V3 POST body for /routing/routes/calculate and (partially) /routing/calculateLongDistanceEVRoute.
+ * POST body for /routing/routes/calculate and (partially) /routing/calculateLongDistanceEVRoute.
  * Consumption model parameters are sent as URL query params, not in the POST body.
  * @ignore
  */
@@ -6437,6 +6466,36 @@ type InputSectionType = (typeof inputSectionTypes)[number];
  * @group Routing
  */
 type InputSectionTypes = InputSectionType[];
+/**
+ * The phonetic alphabet street names are transcribed in.
+ *
+ * @remarks
+ * - `LHP`: Language-specific phonetic representation
+ * - `IPA`: International Phonetic Alphabet
+ *
+ * @group Routing
+ */
+type Phonetics = 'LHP' | 'IPA';
+/**
+ * The accepted values of {@link ChargingStopsStrategy}.
+ * @group Routing
+ */
+declare const chargingStopsStrategies: readonly ["automaticFastest", "manualFastest", "automaticFastestWithFallbackToManual"];
+/**
+ * How the routing service should plan charging stops on an electric route.
+ *
+ * @remarks
+ * - `automaticFastest`: the service picks charging stops for the fastest journey. The default.
+ * - `manualFastest`: the service plans no charging stops of its own; only stops you pass as
+ *   waypoints are charged at.
+ * - `automaticFastestWithFallbackToManual`: automatic, falling back to manual when no chargeable
+ *   route exists.
+ *
+ * Requires `vehicle.preferences.chargingPreferences` to be set as well: the endpoint also needs a
+ * minimum charge at the destination, which only the preferences supply.
+ * @group Routing
+ */
+type ChargingStopsStrategy = (typeof chargingStopsStrategies)[number];
 /**
  * Configuration for turn-by-turn guidance instructions.
  *
@@ -6469,7 +6528,7 @@ type GuidanceParams = {
    *
    * @default 'IPA'
    */
-  phonetics?: 'LHP' | 'IPA';
+  phonetics?: Phonetics;
 };
 /**
  * Extended route representation options.
@@ -6715,6 +6774,21 @@ type CalculateRouteParams = CommonServiceParams<CalculateRouteRequestAPI, Calcul
    * ```
    */
   computeTravelTimeFor?: ComputeTravelTimeFor;
+  /**
+   * How the service should plan charging stops on an electric route.
+   *
+   * Only applies to electric routes, so `vehicle.preferences.chargingPreferences` must be set
+   * too — validation says so before the request is sent.
+   *
+   * @default 'automaticFastest' (the service's own default when unset)
+   *
+   * @example
+   * ```typescript
+   * // Plan the fastest journey, choosing charging stops along the way
+   * chargingStopsStrategy: 'automaticFastest'
+   * ```
+   */
+  chargingStopsStrategy?: ChargingStopsStrategy;
   /**
    * Request extended progress information at route polyline points.
    *
@@ -6809,7 +6883,7 @@ type CalculateRouteTemplate = ServiceTemplate<CalculateRouteParams, FetchInput<C
 //#region src/routing/requestBuilder.d.ts
 /**
  * Default function for building calculate route request from {@link CalculateRouteParams}
- * targeting the OrbisV3 routing API.
+ * targeting the Orbis routing API.
  * @param params The calculate route parameters, with global configuration already merged into them.
  */
 declare const buildCalculateRouteRequest: (params: CalculateRouteParams) => FetchInput<CalculateRoutePOSTDataAPI>;
@@ -7843,8 +7917,8 @@ type ExplorationRecordType = 'POI' | 'PointAddress' | 'Street';
  * - `countries[0]` → `country`
  * - `poiBrands[0]` → `brand`
  * - `poiCategories` → `categories` (mapped to TomTom numeric category ids)
- * - `position` + `radiusMeters` → `near.coordinates` + `near.radius_km`
- * - `boundingBox` / `boundingBoxes` → `bboxes`
+ * - `geoBias` → `near.coordinates` + `near.radius_km`
+ * - `boundingBoxes` → `bboxes`
  * - `geometries` → `geometries` (Polygon/MultiPolygon passed through; Circle
  *   buffered to a Polygon; FeatureCollection flattened to its features)
  * - `municipalities` → `municipalities`
@@ -7856,23 +7930,18 @@ type ExplorationRecordType = 'POI' | 'PointAddress' | 'Street';
  * @ignore
  * @experimental
  */
-type ExplorationSearchParams = CommonSearchParams<ExplorationSearchRequestAPI, ExplorationSearchResponseAPI> & CommonGeocodeAndFuzzySearchParams & {
+type ExplorationSearchParams = CommonSearchParams<ExplorationSearchRequestAPI, ExplorationSearchResponseAPI> & Omit<CommonGeocodeAndFuzzySearchParams, 'geoBias'> & {
   /**
-   * Geographic position to restrict results around.
-   *
-   * Combined with {@link radiusMeters} this maps to the API's `near` filter.
-   * Accepts any {@link HasLngLat}-compatible value — a `[lon, lat]` tuple,
-   * a GeoJSON `Point`, or a `Feature<Point>`.
+   * The point to search around, and how far. Unlike the other search services, this endpoint
+   * takes a point and {@link boundingBoxes} as separate filters, so both may be given.
    */
-  position?: HasLngLat;
+  geoBias?: PointGeoBias;
   /**
    * Exact, case-sensitive municipality/city filters (e.g. `['Amsterdam', 'Utrecht']`).
    */
   municipalities?: string[];
   /**
-   * Additional bounding boxes to restrict results to.
-   *
-   * Merged with {@link boundingBox} and sent as the API's `bboxes` array.
+   * Bounding boxes to restrict results to, sent as the API's `bboxes` array.
    */
   boundingBoxes?: HasBBox[];
   /**
@@ -8476,7 +8545,8 @@ export declare const calculateReachableRange: (params: ReachableRangeParams, cus
  * consider implementing your own parallel processing with appropriate throttling.
  *
  * @param paramsArray Array of reachable range parameters, one for each area to calculate
- * @param options.signal An `AbortSignal` to cancel in-flight requests between iterations.
+ * @param options.signal An `AbortSignal` to cancel the in-flight request and skip the remaining ones.
+ *   Composed with any per-entry `signal`, so either one cancels.
  * @param customTemplate Advanced customization for request/response handling
  *
  * @returns Promise resolving to a FeatureCollection of reachable area polygons
@@ -8974,30 +9044,6 @@ type FuzzySearchParams = CommonSearchParams<URL, FuzzySearchResponseAPI> & Commo
    * minFuzzyLevel: 2  // Require at least moderate similarity
    * ```
    */
-  /**
-   * Geographic position to bias search results toward.
-   *
-   * When provided, results closer to this position are ranked higher.
-   * Does not filter results, only creates a soft bias.
-   *
-   * Accepts any {@link HasLngLat}-compatible value:
-   * - `[longitude, latitude]` coordinate pair
-   * - GeoJSON `Point` geometry
-   * - GeoJSON `Feature<Point>` — pass a {@link Place} directly
-   *
-   * @example
-   * ```typescript
-   * // Coordinate pair
-   * position: [4.9041, 52.3676]
-   *
-   * // Place result from a previous search
-   * position: searchResults.features[0]
-   *
-   * // GeoJSON Point
-   * position: { type: 'Point', coordinates: [4.9041, 52.3676] }
-   * ```
-   */
-  position?: HasLngLat;
   minFuzzyLevel?: number;
   /**
    * Maximum fuzziness level to be used.
@@ -9275,4 +9321,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, 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 };
+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, ChargingStopsStrategy, 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, Phonetics, 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, chargingStopsStrategies, functionalRoadClasses, metricKeyToApiDataType };