@tomtom-org/maps-sdk 0.48.2 → 0.49.0

package/core/dist/index.d.ts

@@ -4633,6 +4633,7 @@ export declare type SectionsProps = {
     country?: CountrySectionProps[];
     ferry?: SectionProps[];
     importantRoadStretch?: ImportantRoadStretchProps[];
+    /** Lane configuration sections. Guidance-only: present solely when `guidance` was requested. */
     lanes?: LaneSectionProps[];
     leg: LegSectionProps[];
     lowEmissionZone?: SectionProps[];
@@ -4943,6 +4944,19 @@ export declare type TollPaymentType = 'CASH_COINS_AND_BILLS' | 'CASH_BILLS_ONLY'
  */
 export declare const TOMTOM_USER_AGENT_SDK_NAME = "MapsSDKJS";
 
+/**
+ * Service-specific TomTom API headers, declared per-request by a service's
+ * request builder (not added globally). Widen this type when a new service
+ * needs a header outside the existing set.
+ * @ignore
+ */
+export declare type TomTomAPIHeaders = {
+    'TomTom-Api-Key'?: string;
+    'TomTom-Api-Version'?: string;
+    'Accept-Language'?: string;
+    Attributes?: string;
+};
+
 /**
  * Global configuration singleton for the TomTom Maps SDK.
  *

package/map/dist/index.d.ts

@@ -8538,7 +8538,8 @@ export declare type StreetRoadSubCategory = (typeof streetRoadSubCategories)[num
  *   }
  * };
  *
- * map.addStyleChangeHandler(styleHandler);
+ * const unsubscribe = map.addStyleChangeHandler(styleHandler);
+ * // Call unsubscribe() when the handler's owner is torn down.
  * ```
  *
  * @see {@link TomTomMap.addStyleChangeHandler}
@@ -9203,6 +9204,11 @@ export declare class TomTomMap {
      *
      * @param handler - A {@link StyleChangeHandler} object with callbacks for style change events.
      *
+     * @returns An unsubscribe function that removes this handler. Call it when the
+     * handler's owner (e.g. a custom overlay) is torn down — otherwise the handler,
+     * and everything it closes over, lives for the lifetime of the map. Mirrors the
+     * disposer returned by module event handlers (`module.events.on(...)`).
+     *
      * @remarks
      * **When to Use:**
      * - You have custom layers or sources that need to be recreated after style changes
@@ -9242,6 +9248,17 @@ export declare class TomTomMap {
      * ```
      *
      * @example
+     * Unsubscribe when the owner is torn down:
+     * ```typescript
+     * const unsubscribe = map.addStyleChangeHandler({
+     *   onStyleChanged: () => reattachCustomLayers(),
+     * });
+     *
+     * // Later, when the overlay is removed:
+     * unsubscribe();
+     * ```
+     *
+     * @example
      * Preserve custom layers across style changes:
      * ```typescript
      * let customLayerData = null;
@@ -9308,7 +9325,7 @@ export declare class TomTomMap {
      * @see {@link StyleChangeHandler} - Handler interface definition
      * @see {@link setStyle} - Method that triggers the handlers
      */
-    addStyleChangeHandler(handler: StyleChangeHandler): void;
+    addStyleChangeHandler(handler: StyleChangeHandler): () => void;
 }
 
 /**
@@ -11427,3 +11444,15 @@ export declare type WaypointsConfig = {
 };
 
 export { }
+
+
+declare global {
+    /**
+     * Installed by the demo-BFF sandpack bootstrap. Resolves once the proxy
+     * session cookie is valid and not about to expire, re-minting it first
+     * when needed. See ensureFreshSession in proxyBootstrap.ts. Declared as a
+     * global var (not a Window member) so it can be read off `globalThis`,
+     * which also works on the main thread where window === globalThis.
+     */
+    var __DEMO_BFF_ENSURE_SESSION__: (() => Promise<void>) | undefined;
+}