@mappedin/mappedin-js 6.0.1-beta.11 → 6.0.1-beta.13

package/lib/esm/index.d.ts

@@ -8,15 +8,15 @@
 //   ../mappedin-js/@packages/internal/common
 //   ../mappedin-js/@mappedin/core-sdk
 //   ../mappedin-js/@mappedin/core-sdk/src/camera
+//   ../mappedin-js/@packages/internal/geojson-navigator
 //   ../mappedin-js/@tweenjs/tween.js
 //   ../mappedin-js/@mappedin/mvf/dist/locale
-//   ../mappedin-js/three
 //   ../mappedin-js/zod
+//   ../mappedin-js/three
 //   ../mappedin-js/@packages/internal/shave-text/shave-text
 //   ../mappedin-js/@turf/turf
 //   ../mappedin-js/@packages/internal/quad-tree
 //   ../mappedin-js/@packages/internal/outdoor-context-v4
-//   ../mappedin-js/@packages/internal/geojson-navigator
 //   ../mappedin-js/minisearch
 //   ../mappedin-js/three/addons/loaders/GLTFLoader.js
 //   ../mappedin-js/@mapbox/point-geometry
@@ -35,7 +35,7 @@ declare module '@mappedin/mappedin-js' {
     import type { TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions } from '@packages/internal/mvf-utils';
     import { parseMVF, unzipMVF } from '@packages/internal/mvf-utils';
     import type { Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import type { ParsedMVF as TMVF, StyleCollection as TMVFStyleCollection, Style as TMVFStyle, LineStringStyle as TMVFLineStringStyle, PolygonStyle as TMVFPolygonStyle, PointStyle as TMVFPointStyle } from '@mappedin/mvf';
+    import type { ParsedMVF as TMVF, StyleCollection as TMVFStyleCollection, Style as TMVFStyle, LineStringStyle as TMVFLineStringStyle, PolygonStyle as TMVFPolygonStyle, PointStyle as TMVFPointStyle, ParsedMVFLocalePack } from '@mappedin/mvf';
     import { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
     import type { Shading, PaintStyle, LineStyle, WatermarkOptions } from '@mappedin/mappedin-js/geojson/src';
     import { enableTestMode } from '@mappedin/mappedin-js/geojson/src';
@@ -288,6 +288,7 @@ declare module '@mappedin/mappedin-js' {
     };
     /**
         * @internal
+        * @deprecated Use {@link hydrateMapData} instead.
         *
         * Returns a {@link MapData} instance from a parsed MVF object.
         */
@@ -299,6 +300,37 @@ declare module '@mappedin/mappedin-js' {
         * @deprecated Use {@link getMapData} and enterprise will be inferred from key/secret.
         */
     export function setUseEnterpriseAPI(value: boolean): void;
+    export type THydrateMapDataBundle = {
+            type: 'binary';
+            options?: {
+                    enterprise?: boolean;
+            };
+            languagePacks?: {
+                    language: {
+                            code: string;
+                            name: string;
+                    };
+                    localePack: Uint8Array;
+            }[];
+            main: Uint8Array;
+    } | {
+            type: 'json';
+            options?: {
+                    enterprise?: boolean;
+            };
+            languagePacks?: {
+                    language: {
+                            code: string;
+                            name: string;
+                    };
+                    localePack: ParsedMVFLocalePack;
+            }[];
+            main: TMVF;
+    };
+    /**
+        * Load a MapData instance from a backup including language packs. Pass in userOptions to ensure outdoor view is available.
+        */
+    export const hydrateMapData: (backup: THydrateMapDataBundle | TMVF, userOptions?: TGetMapDataOptions) => Promise<MapData>;
     /**
         * Asynchronously retrieves map data ({@link MapData}) based on user-provided options.
         *
@@ -329,8 +361,8 @@ declare module '@mappedin/mappedin-js' {
     export type { Label, Marker, Path, Shape, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export type { Navigation, TNavigationOptions } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export { Coordinate, Annotation, Connection, Door, Floor, FloorStack, MapObject, PointOfInterest, Space, Image, Hyperlink, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, type Places, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, Images, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
+    export { Coordinate, Annotation, Connection, Door, Floor, FloorStack, MapObject, PointOfInterest, Space, Image, Hyperlink, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, Node, type Places, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    export type { Camera, Models, Labels, BlueDot, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, Images, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
     export type { SearchResult, SearchResultItem, SearchResultEnterpriseCategory, SearchResultEnterpriseLocations, SearchResultPlaces, SearchOptions, Search, Suggestion, MatchInfo, } from '@mappedin/mappedin-js/mappedin-js/src/search';
     export type { Analytics, TAnalyticsUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/analytics';
 }
@@ -339,11 +371,13 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
     import { Analytics } from '@mappedin/mappedin-js/mappedin-js/src/analytics';
     import { PubSub } from '@packages/internal/common';
     import type { TSearchOptions } from '@packages/internal/mvf-utils';
-    import type { Connection, Door, Floor, MapDataInternal, Space, MapObject, PointOfInterest, Annotation, Coordinate, FloorStack } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Connection, Door, Floor, MapDataInternal, Space, MapObject, PointOfInterest, Annotation, Coordinate, FloorStack, Node } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type EnterpriseCategory from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category';
     import type EnterpriseLocation from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location';
     import type EnterpriseVenue from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue';
     import { Search } from '@mappedin/mappedin-js/mappedin-js/src/search';
+    import type { TNavigationTarget, TGetDirectionsOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { Directions } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions';
     /**
         * A WeakMap to associate {@link MapData} instances with their internal representation.
         * We need a way to get the internal data object from the API
@@ -470,6 +504,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 * const annotations = mapData.getByType('annotation');
                 */
             getByType(type: 'annotation'): Annotation[];
+            /**
+                * @returns The nodes ({@link Node}) on the map.
+                * @example
+                * const nodes = mapData.getByType('node');
+                */
+            getByType(type: 'node'): Node[];
             /**
                 * @returns The enterprise locations ({@link EnterpriseLocation}) on the map.
                 * @example
@@ -487,7 +527,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 * @example
                 * const enterpriseVenue = mapData.getByType('enterprise-venue');
                 */
-            getByType(type: 'enterprise-venue'): EnterpriseVenue;
+            getByType(type: 'enterprise-venue'): EnterpriseVenue | undefined;
             /**
                 * Retrieves a specific map feature by its type and ID.
                 *
@@ -497,16 +537,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 * @example
                 * const space = mapData.getById('space', 'space-id');
                 */
-            getById(type: 'space', id: string): Space | undefined;
-            getById(type: 'door', id: string): Door | undefined;
-            getById(type: 'floor', id: string): Floor | undefined;
-            getById(type: 'floor-stack', id: string): FloorStack | undefined;
-            getById(type: 'connection', id: string): Connection | undefined;
-            getById(type: 'object', id: string): MapObject | undefined;
-            getById(type: 'point-of-interest', id: string): PointOfInterest | undefined;
-            getById(type: 'annotation', id: string): Annotation | undefined;
-            getById(type: 'enterprise-location', id: string): EnterpriseLocation | undefined;
-            getById(type: 'enterprise-category', id: string): EnterpriseCategory | undefined;
+            getById<T extends string>(type: T, id: string): T extends 'node' ? Node | undefined : T extends 'space' ? Space | undefined : T extends 'door' ? Door | undefined : T extends 'floor' ? Floor | undefined : T extends 'floor-stack' ? FloorStack | undefined : T extends 'connection' ? Connection | undefined : T extends 'object' ? MapObject | undefined : T extends 'point-of-interest' ? PointOfInterest | undefined : T extends 'annotation' ? Annotation | undefined : T extends 'enterprise-location' ? EnterpriseLocation | undefined : T extends 'enterprise-category' ? EnterpriseCategory | undefined : undefined;
             getById(type: string, id: string): object | undefined;
             /**
                 * Changes the language of the map data.
@@ -527,6 +558,35 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 * @internal
                 */
             get currentLanguage(): import("@mappedin/mvf").Language | undefined;
+            /**
+                * Retrieves directions ({@link Directions}) from one navigable point ({@link TNavigationTarget}) to another on the map.
+                *
+                * @param from The starting point for navigation.
+                * @param to The destination point.
+                * @param options Optional parameters for getting directions.
+                * @returns Directions from the start to the destination point.
+                * @example
+                * const directions = await map.getDirections(space1, space2);
+                */
+            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], options?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            /**
+                * Retrieves the distance between two navigable points ({@link TNavigationTarget}) on the map.
+                *
+                * @param from The starting point.
+                * @param to The destination point.
+                * @returns The distance between the start and destination points in meters.
+                */
+            getDistance(from: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation, to: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation): number;
+            /**
+                * Creates a backup of the map data including language packs.
+                * @internal
+                */
+            toBinaryBundle({ downloadLanguagePacks }?: {
+                    downloadLanguagePacks?: boolean;
+            }): Promise<void | import(".").THydrateMapDataBundle>;
+            toJSONBundle({ downloadLanguagePacks }?: {
+                    downloadLanguagePacks?: boolean;
+            }): Promise<import(".").THydrateMapDataBundle>;
     }
     export default MapData;
     /**
@@ -645,7 +705,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/events' {
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
-    import type Node from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node';
+    import Node from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node';
     import Door from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/door';
     import Space from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space';
     import Floor from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor';
@@ -664,9 +724,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
     import EnterpriseCategory from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category';
     import EnterpriseVenue from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue';
     import { PubSub } from '@packages/internal/common';
-    import type { LanguagePack, Places } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types';
+    import type { LanguagePack, Places, TMapDataInternalOptions } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types';
     import { type LocalePackUrls } from '@packages/internal/mvf-utils';
-    import type { LanguagePackHydrationItem } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { TGetDirectionsOptions, TNavigationTarget } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import { type Directions, DirectionsInternal } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions';
+    import { type THydrateMapDataBundle } from '@mappedin/mappedin-js/mappedin-js/src';
     /**
         * Internal class representing detailed map data.
         *
@@ -701,6 +763,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 */
             readonly obstructionIdByEntranceId: Record<string, string>;
             readonly venue?: EnterpriseVenue;
+            directions: DirectionsInternal;
             enterpriseMode: boolean;
             nodesById: MapDataRecords['nodesById'];
             spacesById: MapDataRecords['spacesById'];
@@ -715,6 +778,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
             categoriesById: MapDataRecords['categoriesById'];
             doorsByNodeId: MapDataRecords['doorsByNodeId'];
             locationsBySpaceId: MapDataRecords['mvfLocationsBySpaceId'];
+            locationIdsByNodeId: MapDataRecords['locationIdsByNodeId'];
             mvfAnnotationsById: MapDataRecords['mvfAnnotationsById'];
             mvfConnectionsById: MapDataRecords['mvfConnectionsById'];
             mvfConnectionsByNodeId: MapDataRecords['mvfConnectionsByNodeId'];
@@ -732,15 +796,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
             languagePacks: {
                     [languageCode: string]: LanguagePack;
             };
+            binaryBundle?: Uint8Array;
             /**
                 * @internal
                 */
-            constructor(mvf: ParsedMVF, { outdoorViewToken, localePacksUrls: localePacks, enterprise, languagePacks, }?: {
-                    enterprise?: boolean;
-                    outdoorViewToken?: string;
-                    localePacksUrls?: LocalePackUrls;
-                    languagePacks?: LanguagePackHydrationItem[];
-            });
+            constructor(mvf: ParsedMVF, options: TMapDataInternalOptions);
             /**
                 * Retrieves the map name.
                 *
@@ -842,6 +902,14 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 * change the langauge of the data objects in mapdata
                 */
             changeLanguage(languageCode: string): Promise<void>;
+            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], opt?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            getDistance(from: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation, to: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation): number;
+            toJSONBundle({ downloadLanguagePacks, }?: {
+                    downloadLanguagePacks?: boolean;
+            }): Promise<THydrateMapDataBundle>;
+            toBinaryBundle({ downloadLanguagePacks, }?: {
+                    downloadLanguagePacks?: boolean;
+            }): Promise<THydrateMapDataBundle | void>;
             /**
                 * Cleans up resources used by the instance.
                 *
@@ -849,7 +917,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 */
             destroy(): void;
     }
-    export { MapDataInternal, Space, Floor, FloorStack, Connection, MapObject, Door, Coordinate, PointOfInterest, Annotation, Hyperlink, Image, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, };
+    export { Node, MapDataInternal, Space, Floor, FloorStack, Connection, MapObject, Door, Coordinate, PointOfInterest, Annotation, Hyperlink, Image, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, };
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space';
     export type { Places };
 }
@@ -862,7 +930,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
     import type { Camera, Labels, Markers, Models, Paths, Exporter, Directions, Style, Outdoor, Images } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
     import type { BlueDot } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
-    import type { Door, Floor, MapObject, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Annotation, Coordinate, Door, Floor, MapObject, PointOfInterest, Space, Node, EnterpriseLocation } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { DOORS, WALLS, TGetDirectionsOptions, TGetState, TNavigationTarget, TUpdateState, TUpdateStates } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import type { Label, Marker, Image } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { TEventPayload } from '@mappedin/mappedin-js/mappedin-js/src/events';
@@ -994,6 +1062,14 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
             getState<T extends Space | MapObject | Label | Marker | Image | string>(target: T): TGetState<T> | undefined;
             setHoverColor(c: string): void;
             getHoverColor(): string | undefined;
+            /**
+                * @internal
+                */
+            convertAltitudeToMercatorZoomLevel(altitude: number): number;
+            /**
+                * @internal
+                */
+            convertMercatorZoomLevelToAltitude(zoomLevel: number): number;
             /**
                 * Determines if a given target is within the viewport.
                 *
@@ -1015,7 +1091,15 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * @example
                 * const directions = await map.getDirections(space1, space2);
                 */
-            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | TNavigationTarget[], options?: TGetDirectionsOptions) => Directions | undefined;
+            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], options?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            /**
+                * Retrieves the distance between two navigable points ({@link TNavigationTarget}) on the map.
+                *
+                * @param from The starting point.
+                * @param to The destination point.
+                * @returns The distance between the start and destination points in meters.
+                */
+            getDistance(from: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation, to: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation): number | undefined;
             /**
                 * Creates a {@link Coordinate} on the map.
                 *
@@ -1027,8 +1111,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * // Create a coordinate at the CN Tower.
                 * const coord = map.createCoordinate(43.642567, -79.387054);
                 */
-            createCoordinate(latitude: number, longitude: number, floor?: Floor): import(".").Coordinate;
-            createCoordinateFromScreenCoordinate(x: number, y: number, floor?: Floor): import(".").Coordinate | undefined;
+            createCoordinate(latitude: number, longitude: number, floor?: Floor): Coordinate;
+            createCoordinateFromScreenCoordinate(x: number, y: number, floor?: Floor): Coordinate | undefined;
             /**
                 * @hidden
                 * @experimental
@@ -1156,7 +1240,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/maplibre-overlay' {
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     import type { Feature, MultiPolygon, Polygon } from 'geojson';
-    import type { Coordinate, Floor, Door, Space, MapObject, PointOfInterest, Connection, Annotation, EnterpriseLocation } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Coordinate, Floor, Door, Space, MapObject, PointOfInterest, Connection, Annotation, EnterpriseLocation, Node } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { Label, Marker, Model, Image } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { EasingCurve } from '@mappedin/core-sdk/src/camera';
     import type { Language, ParsedMVFLocalePack } from '@mappedin/mvf';
@@ -1228,6 +1312,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 * The {@link Coordinate} at which this instruction applies.
                 */
             coordinate: Coordinate;
+            /**
+                * @internal
+                */
+            node: Node;
     };
     /**
         * Defines the state for a label when its appearance is updated.
@@ -1488,7 +1576,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     /**
         * Defines the target for the {@link Camera} focus operation.
         */
-    export type TCameraFocusOnTarget = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | (Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door)[];
+    export type TCameraFocusOnTarget = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | Node | (Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Node)[];
     /**
         * Defines the target for camera operations.
         */
@@ -1515,7 +1603,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     /**
         * Defines the target for navigation operations.
         */
-    export type TNavigationTarget = Space | MapObject | Coordinate | Door | PointOfInterest | Connection | EnterpriseLocation;
+    export type TNavigationTarget = Space | MapObject | Coordinate | Door | PointOfInterest | Connection | EnterpriseLocation | Node;
     /**
         * Defines the special zone for navigation operations.
         */
@@ -1779,6 +1867,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
         * Options for controlling the behavior of the {@link Directions}.
         */
     export type TGetDirectionsOptions = {
+            /**
+                * If true directions will be shown as a multisegment route
+                *
+                * @default false
+                */
+            multiSegment?: boolean;
             /**
                 * If true directions will only take accessible routes
                 *
@@ -1973,26 +2067,62 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
             id?: string;
     };
     export type TBlueDotOptions = {
-            /** The radius of the BlueDot in pixels. The BlueDot will maintain this size clamped to a minimum of 0.35 metres. */
+            /**
+                * The radius of the BlueDot in pixels. The BlueDot will maintain this size clamped to a minimum of 0.35 metres.
+                * @default 10
+                */
             radius?: number;
-            /** The color of the BlueDot core element. */
+            /**
+                * The color of the BlueDot core element.
+                * @default #2266ff
+                */
             color?: string;
-            /** Options for the accuracy ring around the BlueDot. */
+            /**
+                * The color of the BlueDot when it has timed out and gone inactive.
+                * @default #808080
+                */
+            inactiveColor?: string;
+            /**
+                * Options for the accuracy ring around the BlueDot.
+                */
             accuracyRing?: {
-                    /** The color of the accuracy ring. */
+                    /**
+                        * The color of the accuracy ring.
+                        * @default #2266ff
+                        */
                     color?: string;
-                    /** The opacity of the accuracy ring. */
+                    /**
+                        * The opacity of the accuracy ring.
+                        * @default 0.3
+                        */
                     opacity?: number;
             };
             /**
                 * Options for the bearing directional indicator.
                 */
             bearing?: {
-                    /** The color of the bearing cone. */
+                    /**
+                        * The color of the bearing cone.
+                        * @default #2266ff
+                        */
                     color?: string;
-                    /** The opacity of the bearing cone. */
+                    /**
+                        * The opacity of the bearing cone.
+                        * @default 0.7
+                        */
                     opacity?: number;
             };
+            /**
+                * The duration of the timeout in milliseconds.
+                * If the BlueDot does not receive a position update within this time, it will grey out until a position is received.
+                * @default 30000
+                */
+            timeout?: number;
+            /**
+                * Whether to log debug messages.
+                * @default false
+                */
+            debug?: boolean;
     };
     export type LanguagePackHydrationItem = {
             language: Language;
@@ -2095,6 +2225,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
                 * @internal
                 */
             get currentMap(): GeojsonApiMapObject;
+            /**
+                * Returns true if the navigation is for a multi-floor path.
+                */
+            get isMultiFloor(): boolean;
             /**
                 * @internal
                 */
@@ -2104,7 +2238,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
                 * @param directions The directions to be drawn.
                 * @param options Optional additional options for the navigation.
                 */
-            draw: (directions: Directions, options?: TNavigationOptions) => Promise<unknown>;
+            draw: (directions: Directions | Directions[], options?: TNavigationOptions) => Promise<unknown>;
             /**
                 * Clears any drawn navigation paths or directions from the map.
                 */
@@ -2116,6 +2250,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson' {
     export { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
+    export { BlueDot } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot';
     export { Camera } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera';
     export { Labels } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/labels';
     export { Markers } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers';
@@ -2201,7 +2336,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category'
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location' {
     import type { EnterpriseLocation as MVFEnterpriseLocation, LocationState, OperationHours, SiblingGroup } from '@mappedin/mvf';
-    import type { Coordinate, MapDataInternal, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Coordinate, EnterpriseCategory, MapDataInternal, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
     import type Node from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node';
     /**
@@ -2262,7 +2397,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location'
                 */
             constructor(data: MapDataInternal, options: {
                     mvfData: MVFEnterpriseLocation;
+                    categoryIds: string[];
             });
+            get categories(): EnterpriseCategory[];
             get coordinates(): Coordinate[];
             get nodes(): Node[];
             get spaces(): Space[];
@@ -2353,6 +2490,77 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue' {
     export default EnterpriseVenue;
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions' {
+    import type { ParsedMVF } from '@mappedin/mvf';
+    import type { DirectionsCollection } from '@packages/internal/geojson-navigator';
+    import { Coordinate, Node, type MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { TDirectionInstruction, TDirectionZone, TNavigationTarget } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    /**
+        * Represents a set of directions between two points.
+        *
+        * Directions are used to represent the path between two points on the map,
+        * as well as the instructions to follow the path.
+        */
+    export class Directions {
+            #private;
+            /**
+                * @internal
+                */
+            constructor(directions: DirectionsCollection, mapData: MapDataInternal);
+            /**
+                * @internal
+                */
+            get path(): Node[];
+            /**
+                * All the coordinates ({@link Coordinate}) of the directions.
+                */
+            get coordinates(): Coordinate[];
+            /**
+                * The total distance of the path in meters.
+                */
+            get distance(): number;
+            /**
+                * The array of instructions ({@link TDirectionInstruction}).
+                */
+            get instructions(): TDirectionInstruction[];
+    }
+    export class DirectionsInternal {
+            /**
+                * @hidden
+                */
+            constructor({ nodes, geojsonCollection, connections, groupBy, }: {
+                    nodes: ParsedMVF['node.geojson'];
+                    geojsonCollection: ParsedMVF['obstruction'] | ParsedMVF['space'];
+                    connections: ParsedMVF['connection.json'];
+                    groupBy?: string;
+            });
+            /**
+                * Get directions between two navigation targets.
+                *
+                * @hidden
+                * @param from
+                * @param to
+                * @param options
+                * @param mapData
+                */
+            getDirections: (from: TNavigationTarget[], to: TNavigationTarget[], options: {
+                    accessible: boolean;
+                    smoothing: {
+                            enabled: boolean;
+                            radius: number;
+                    };
+                    zones: TDirectionZone[];
+            }, mapData: MapDataInternal) => Directions | undefined;
+            /**
+                * Get the node IDs that should be excluded from the navigation graph.
+                *
+                * @hidden
+                * @param accessible {boolean}
+                */
+            getExcludedNodeIds: (accessible: boolean) => string[];
+    }
+}
+
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps' {
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
     import type { RendererCore } from '@mappedin/core-sdk';
@@ -2433,7 +2641,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/camera-tr
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node' {
     import type { NodeCollection } from '@mappedin/mvf';
     import Coordinate from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/coordinate';
-    import type { MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { EnterpriseLocation, MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type Floor from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
     /**
@@ -2467,6 +2675,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node' {
                     floorId: string;
                     mvfData: NodeCollection['features'][number];
             });
+            get locations(): EnterpriseLocation[];
             /**
                 * Gets the {@link Floor} associated with the node.
                 *
@@ -2480,6 +2689,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node' {
                 * @returns {Coordinate} The node's coordinate.
                 */
             get coordinate(): Coordinate;
+            /**
+                * Gets the external ID of the node.
+                *
+                * @returns {string} The external ID of the node.
+                */
+            get externalId(): string;
             /**
                 * Gets the neighboring nodes of this node.
                 *
@@ -2552,6 +2767,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/door' {
                 * @returns {string} The name of the door.
                 */
             get name(): string;
+            /**
+                * Gets the external ID of the door.
+                *
+                * @returns {string} The external ID of the door.
+                */
+            get externalId(): string;
             get description(): string;
             get images(): Image[];
             /**
@@ -2655,8 +2876,24 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space' {
                 * @returns {TSpaceType} The type of the space.
                 */
             get type(): TSpaceType;
+            /**
+                * Gets the description of the space.
+                *
+                * @returns {string} The description of the space, or an empty string if no description exists.
+                */
             get description(): string;
+            /**
+                * Gets the array of images associated with the space.
+                *
+                * @returns {Image[]} An array of Image objects, or an empty array if no images exist.
+                */
             get images(): Image[];
+            /**
+                * Gets the external identifier of the space.
+                *
+                * @returns {string} The external ID of the space, or an empty string if no external ID exists.
+                */
+            get externalId(): string;
             /**
                 * @internal
                 */
@@ -2749,6 +2986,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor' {
                 * @returns {string} The name of the floor.
                 */
             get name(): string;
+            /**
+                * Gets the external ID of the floor.
+                *
+                * @returns {string} The external ID of the floor.
+                */
+            get externalId(): string;
             /**
                 * Gets the elevation of the floor.
                 *
@@ -2864,6 +3107,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/connectio
             get name(): string;
             get description(): string;
             get images(): Image[];
+            /**
+                * Gets the external ID of the connection.
+                *
+                * @returns {string} The external ID of the connection.
+                */
             get externalId(): string;
             /**
             /**
@@ -2952,6 +3200,17 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/object' {
                 * @returns {string} The name of the object.
                 */
             get name(): string;
+            /**
+                * Gets the external ID of the MapObject.
+                *
+                * @returns {string} The external ID of the object.
+                */
+            get externalId(): string;
+            /**
+                * Gets the description of the MapObject.
+                *
+                * @returns {string} The description of the object.
+                */
             get description(): string;
             get images(): Image[];
             /**
@@ -3137,6 +3396,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/poi' {
                 * @returns {Coordinate} The POI's coordinate.
                 */
             get coordinate(): Coordinate;
+            /**
+                * Gets the external ID of the POI.
+                *
+                * @returns {string} The external ID of the POI.
+                */
+            get externalId(): string;
             /**
                 * Serializes the POI data to JSON.
                 *
@@ -3209,6 +3474,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/annotatio
                 * @returns {string} The annotation type.
                 */
             get type(): string;
+            /**
+                * Gets the external ID of the annotation.
+                *
+                * @returns {string} The external ID of the annotation.
+                */
+            get externalId(): string;
             /**
                 * Gets the center {@link Coordinate} of the annotation.
                 *
@@ -3341,6 +3612,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/image' {
                 * @returns {string | undefined } The name of the image.
                 */
             get name(): string | undefined;
+            /**
             /**
                 * Serializes the image data to JSON.
                 *
@@ -3403,6 +3675,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor-sta
                 * @returns {string} The name of the FloorStack.
                 */
             get name(): string;
+            /**
+                * Gets the externalId of FloorStack
+                */
+            get externalId(): string;
             /**
                 * Gets the floors ({@link Floor}) included in this FloorStack.
                 *
@@ -3451,6 +3727,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/utils/data-creation' {
             annotationsById: Record<string, Annotation>;
             locationsById: Record<MVFEnterpriseLocationId, EnterpriseLocation>;
             categoriesById: Record<MVFEnterpriseCategoryId, EnterpriseCategory>;
+            locationIdsByNodeId: Record<string, MVFEnterpriseLocationId[]>;
             venue: MVFEnterpriseVenue;
             spaceIdsByDestinationNodeId: Record<string, string[]>;
             objectEntranceNodeIdsByObstructionId: Record<string, string[]>;
@@ -3475,6 +3752,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/utils/data-creation' {
         * @internal
         */
     export const createEnterpriseDataFromMVF: (mvf: ParsedMVF, data: MapDataInternal) => {
+            locationIdsByNodeId: Record<string, string[]>;
             locationsBySpaceId: Record<string, MVFEnterpriseLocation[]>;
             mvfLocationsById: Record<string, MVFEnterpriseLocation>;
             mvfCategoriesById: Record<string, MVFEnterpriseCategory>;
@@ -3526,6 +3804,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types' {
     import type MapObject from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/object';
     import type { EnterpriseLocation as MvfEnterpriseLocation, EnterpriseCategory as MvfEnterpriseCategory, ParsedMVFLocalePack } from '@mappedin/mvf';
     import type { PartialExcept } from '@mappedin/mvf/dist/locale';
+    import { LocalePackUrls } from '@packages/internal/mvf-utils';
+    import { LanguagePackHydrationItem } from '@mappedin/mappedin-js/mappedin-js/src/types';
     /**
       * Places are the main objects that can be searched for.
       */
@@ -3546,6 +3826,13 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types' {
             categories: Record<string, MvfEnterpriseCategory>;
         };
     };
+    export type TMapDataInternalOptions = {
+        enterprise?: boolean;
+        outdoorViewToken?: string;
+        localePacksUrls?: LocalePackUrls;
+        languagePacks?: LanguagePackHydrationItem[];
+        binaryBundle?: Uint8Array;
+    };
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src' {
@@ -3554,7 +3841,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     import type { TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions } from '@packages/internal/mvf-utils';
     import { parseMVF, unzipMVF } from '@packages/internal/mvf-utils';
     import type { Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import type { ParsedMVF as TMVF, StyleCollection as TMVFStyleCollection, Style as TMVFStyle, LineStringStyle as TMVFLineStringStyle, PolygonStyle as TMVFPolygonStyle, PointStyle as TMVFPointStyle } from '@mappedin/mvf';
+    import type { ParsedMVF as TMVF, StyleCollection as TMVFStyleCollection, Style as TMVFStyle, LineStringStyle as TMVFLineStringStyle, PolygonStyle as TMVFPolygonStyle, PointStyle as TMVFPointStyle, ParsedMVFLocalePack } from '@mappedin/mvf';
     import { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
     import type { Shading, PaintStyle, LineStyle, WatermarkOptions } from '@mappedin/mappedin-js/geojson/src';
     import { enableTestMode } from '@mappedin/mappedin-js/geojson/src';
@@ -3807,6 +4094,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     };
     /**
         * @internal
+        * @deprecated Use {@link hydrateMapData} instead.
         *
         * Returns a {@link MapData} instance from a parsed MVF object.
         */
@@ -3818,6 +4106,37 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
         * @deprecated Use {@link getMapData} and enterprise will be inferred from key/secret.
         */
     export function setUseEnterpriseAPI(value: boolean): void;
+    export type THydrateMapDataBundle = {
+            type: 'binary';
+            options?: {
+                    enterprise?: boolean;
+            };
+            languagePacks?: {
+                    language: {
+                            code: string;
+                            name: string;
+                    };
+                    localePack: Uint8Array;
+            }[];
+            main: Uint8Array;
+    } | {
+            type: 'json';
+            options?: {
+                    enterprise?: boolean;
+            };
+            languagePacks?: {
+                    language: {
+                            code: string;
+                            name: string;
+                    };
+                    localePack: ParsedMVFLocalePack;
+            }[];
+            main: TMVF;
+    };
+    /**
+        * Load a MapData instance from a backup including language packs. Pass in userOptions to ensure outdoor view is available.
+        */
+    export const hydrateMapData: (backup: THydrateMapDataBundle | TMVF, userOptions?: TGetMapDataOptions) => Promise<MapData>;
     /**
         * Asynchronously retrieves map data ({@link MapData}) based on user-provided options.
         *
@@ -3848,8 +4167,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     export type { Label, Marker, Path, Shape, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export type { Navigation, TNavigationOptions } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export { Coordinate, Annotation, Connection, Door, Floor, FloorStack, MapObject, PointOfInterest, Space, Image, Hyperlink, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, type Places, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, Images, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
+    export { Coordinate, Annotation, Connection, Door, Floor, FloorStack, MapObject, PointOfInterest, Space, Image, Hyperlink, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, Node, type Places, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    export type { Camera, Models, Labels, BlueDot, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, Images, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
     export type { SearchResult, SearchResultItem, SearchResultEnterpriseCategory, SearchResultEnterpriseLocations, SearchResultPlaces, SearchOptions, Search, Suggestion, MatchInfo, } from '@mappedin/mappedin-js/mappedin-js/src/search';
     export type { Analytics, TAnalyticsUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/analytics';
 }
@@ -3859,18 +4178,66 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
     import { PubSub } from '@packages/internal/common';
     import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
     import type { TBlueDotOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import { z } from 'zod';
     export type TBlueDotEvents = {
         'floor-change': {
             reason: 'blue-dot-floor-change';
             floorId: string;
         };
     };
+    export type TBlueDotState = 'hidden' | 'active' | 'inactive' | 'disabled';
+    export type TBlueDotAction = 'timeout' | 'error' | 'position-received' | 'enable' | 'disable';
     export class BlueDot extends PubSub<TBlueDotEvents> {
         #private;
+        /**
+          * @internal
+          */
         constructor(core: RendererCore, geoJSONApi: GeoJsonApi);
         enable(options?: TBlueDotOptions): void;
         disable(): void;
     }
+    type TStateTransitions = {
+        [Action in TBlueDotAction]?: TBlueDotState;
+    };
+    type TStateMachine = {
+        [State in TBlueDotState]: {
+            actions: TStateTransitions;
+        };
+    };
+    export const stateMachine: TStateMachine;
+    export const positionSchema: z.ZodObject<{
+        coords: z.ZodObject<{
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+            floorLevel: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            accuracy: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            latitude: number;
+            longitude: number;
+            floorLevel?: number | null | undefined;
+            accuracy?: number | null | undefined;
+        }, {
+            latitude: number;
+            longitude: number;
+            floorLevel?: number | null | undefined;
+            accuracy?: number | null | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        coords: {
+            latitude: number;
+            longitude: number;
+            floorLevel?: number | null | undefined;
+            accuracy?: number | null | undefined;
+        };
+    }, {
+        coords: {
+            latitude: number;
+            longitude: number;
+            floorLevel?: number | null | undefined;
+            accuracy?: number | null | undefined;
+        };
+    }>;
+    export {};
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes' {
@@ -5120,6 +5487,9 @@ declare module '@mappedin/mappedin-js/geojson/src/types' {
             center?: Position;
             insetsPadding: InsetPadding;
             shouldMeasureCanvas: boolean;
+            /**
+                * Current clamped pixel ratio of the renderer, based on maplibre's clamping logic (when in interleaved mode)
+                */
             pixelRatio: number;
             canvasWidth: number;
             canvasHeight: number;
@@ -5753,7 +6123,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             getState(): MapViewState;
             getState<T extends EntityId<EntityState>>(geometryOrGeometryId: T): T extends EntityId<LabelState> ? LabelState : T extends EntityId<GeometryState> ? GeometryState : T extends EntityId<MarkerState> ? MarkerState : T extends EntityId<GeometryGroupState> ? GeometryGroupState : T extends EntityId<GroupContainerState> ? GroupContainerState : T extends EntityId<ModelState> ? ModelState : T extends EntityId<PathState> ? ShapeState : T extends EntityId<ShapeState> ? ShapeState : T extends EntityId<ImageState> ? ImageState : EntityState;
             getState(geometryOrGeometryId?: Record<string | number, any> | string | number): EntityState;
-            getState<T extends EntityState>(geometryOrGeometryId: T['id']): T extends LabelState ? LabelState : T extends GeometryState ? GeometryState : T extends MarkerState ? MarkerState : T extends GeometryGroupState ? GeometryGroupState : T extends GroupContainerState ? GroupContainerState : T extends ModelState ? ModelState : T extends PathState ? ShapeState : T extends ShapeState ? PathState : T extends ImageState ? ImageState : EntityState;
+            getState<T extends EntityState>(geometryOrGeometryId: T['id']): T extends LabelState ? LabelState : T extends GeometryState ? GeometryState : T extends MarkerState ? MarkerState : T extends GeometryGroupState ? GeometryGroupState : T extends GroupContainerState ? GroupContainerState : T extends ModelState ? ModelState : T extends PathState ? PathState : T extends ShapeState ? ShapeState : T extends ImageState ? ImageState : EntityState;
             /**
                 * Set the state of the map view or any entity that was added, regardless of whether it is visible in the scene.
                 */
@@ -6680,9 +7050,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
     import type { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
     import { Label, Marker, type Model, type Image } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import { Navigation } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
-    import type { TGetDirectionsOptions, TGetState, TNavigationTarget, TUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { TGetState, TUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import { Camera } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera';
-    import type { Directions } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions';
     import { Exporter } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/exporter';
     import { Labels } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/labels';
     import { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
@@ -6736,7 +7105,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
         getState<T extends Space | MapObject | Label | Marker | Model | Image | string>(target: T): TGetState<T> | undefined;
         setHoverColor(c: string): void;
         getHoverColor(): string | undefined;
-        getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | TNavigationTarget[], opt?: TGetDirectionsOptions) => Directions | undefined;
         createCoordinate(latitude: number, longitude: number, floor?: Floor): Coordinate;
         createCoordinateFromScreenCoordinate(x: number, y: number, floor?: Floor): Coordinate | undefined;
         isInView(target: Space | MapObject | Label | Marker | string): boolean;
@@ -6750,6 +7118,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
     }
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot' {
+    export { BlueDot } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
+    export type { TBlueDotEvents } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
+}
+
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera' {
     import type { TCameraAnimationOptions, TCameraFocusOnTarget, TCameraTarget, TFocusOnOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import type { InsetPadding, RendererCore } from '@mappedin/core-sdk';
@@ -6761,6 +7134,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera' {
                 */
             constructor(rendererCore: RendererCore);
             setScreenOffsets(padding: InsetPadding): void;
+            get screenOffsets(): InsetPadding;
             /**
                 * Focuses the camera on a specific target or array of targets.
                 *
@@ -6866,7 +7240,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/labels' {
     import { Label } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
     import type { PointOfInterest, MapObject } from '@mappedin/mappedin-js/mappedin-js/src';
-    import type { Space, Door, Coordinate } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Space, Door, Coordinate, Node } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export class Labels {
             #private;
             /**
@@ -6897,7 +7271,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/labels' {
                 *
                 * map.Labels.add(space, 'Welcome', { appearance: { color: 'blue' } });
                 */
-            add(target: Space | Door | Coordinate | PointOfInterest | MapObject, text: string, options?: TAddLabelOptions | undefined): Label;
+            add(target: Space | Door | Coordinate | PointOfInterest | MapObject | Node, text: string, options?: TAddLabelOptions | undefined): Label;
             /**
                 * Automatically adds all the labels ({@link Label}) to the map.
                 *
@@ -6932,7 +7306,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers' {
     import type { TAddMarkerOptions, TAnimationOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import { Marker } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
-    import type { Space, Door, Coordinate } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Space, Door, Coordinate, Node } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export class Markers {
             #private;
             /**
@@ -6963,7 +7337,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers' {
                 * // Add an interactive {@link Marker} to the map with custom HTML content.
                 * map.Markers.add(coordinate, '<div>Marker Content</div>', { interactive: true });
                 */
-            add(target: Space | Door | Coordinate, html: string, options?: TAddMarkerOptions): Marker;
+            add(target: Space | Door | Coordinate | Node, html: string, options?: TAddMarkerOptions): Marker;
             /**
                 * Removes a marker from the map.
                 *
@@ -6987,7 +7361,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers' {
                 * const marker = map.Markers.add(coordinate, '<div>Marker Content</div>');
                 * mapView.Markers.setPosition(marker, newCoordinate);
                 */
-            setPosition(marker: Marker, target: Space | Door | Coordinate): void;
+            setPosition(marker: Marker, target: Space | Door | Coordinate | Node): void;
             /**
                 * Update the position of a marker with an animation.
                 * @param marker The {@link Marker} which should be updated.
@@ -6998,7 +7372,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers' {
                 * const marker = map.Markers.add(coordinate, '<div>Marker Content</div>');
                 * mapView.Markers.animateTo(marker, newCoordinate, { duration: 1000 });
                 */
-            animateTo(marker: Marker, target: Space | Door | Coordinate, options?: TAnimationOptions): Promise<void>;
+            animateTo(marker: Marker, target: Space | Door | Coordinate | Node, options?: TAnimationOptions): Promise<void>;
     }
     type CurrentMapGetter = () => GeojsonApiMapObject | undefined;
     export {};
@@ -7142,76 +7516,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/exporter' {
     export {};
 }
 
-declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions' {
-    import type { ParsedMVF } from '@mappedin/mvf';
-    import type { DirectionsCollection } from '@packages/internal/geojson-navigator';
-    import type { MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import { Connection, Coordinate } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import type { TDirectionInstruction, TDirectionZone, TNavigationTarget } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    /**
-        * Represents a set of directions between two points.
-        *
-        * Directions are used to represent the path between two points on the map,
-        * as well as the instructions to follow the path.
-        */
-    export class Directions {
-            #private;
-            /**
-                * @internal
-                */
-            constructor(directions: DirectionsCollection, mapData: MapDataInternal);
-            /**
-                * All the coordinates ({@link Coordinate}) of the directions.
-                */
-            get coordinates(): Coordinate[];
-            /**
-                * The total distance of the path in meters.
-                */
-            get distance(): number;
-            /**
-                * The array of instructions ({@link TDirectionInstruction}).
-                */
-            get instructions(): TDirectionInstruction[];
-            lastConnectionAction?: 'take' | 'exit';
-            lastConnection?: Connection;
-    }
-    export class DirectionsInternal {
-            /**
-                * @hidden
-                */
-            constructor({ nodes, geojsonCollection, connections, groupBy, }: {
-                    nodes: ParsedMVF['node.geojson'];
-                    geojsonCollection: ParsedMVF['obstruction'] | ParsedMVF['space'];
-                    connections: ParsedMVF['connection.json'];
-                    groupBy?: string;
-            });
-            /**
-                * Get directions between two navigation targets.
-                *
-                * @hidden
-                * @param from
-                * @param to
-                * @param options
-                * @param mapData
-                */
-            getDirections: (from: TNavigationTarget[], to: TNavigationTarget[], options: {
-                    accessible: boolean;
-                    smoothing: {
-                            enabled: boolean;
-                            radius: number;
-                    };
-                    zones: TDirectionZone[];
-            }, mapData: MapDataInternal) => Directions | undefined;
-            /**
-                * Get the node IDs that should be excluded from the navigation graph.
-                *
-                * @hidden
-                * @param accessible {boolean}
-                */
-            getExcludedNodeIds: (accessible: boolean) => string[];
-    }
-}
-
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/style' {
     import type { StyleCollection } from '@mappedin/mvf';
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
@@ -7266,9 +7570,15 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/outdoor' {
             show(): void;
             /**
                 * Hide the outdoor view.
-                * @param excludedStyleLayerIds {string[]} E
+                * @param excludedStyleLayerIds {string[]}
                 */
             hide(excludedStyleLayerIds?: string[]): void;
+            /**
+                * Set outdoor view opacity
+                * @param targetOpacity {number | 'initial'}
+                * @param excludedStyleLayerIds {string[]}
+                */
+            setOpacity(targetOpacity: number | 'initial', excludedStyleLayerIds?: string[]): void;
     }
 }
 
@@ -7330,7 +7640,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/images' {
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/search/internal' {
     import type { SearchResult as MiniSearchResult, Suggestion, MatchInfo } from 'minisearch';
-    import type { EnterpriseLocation, EnterpriseCategory, Places } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import { EnterpriseLocation, EnterpriseCategory, Places } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
     import { z } from 'zod';
     export class InternalSearch {
@@ -8716,13 +9026,14 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/pan-bounds/system' {
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/systems/custom-geometry/system' {
+    import type { RendererCore } from '@mappedin/mappedin-js/geojson/src';
     import type { RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
     /**
       * System that renders and updates custom geometry entities. For every custom geometry entity, this calls the builder's
       * setup method once (when it is visible) and then the update method every frame.
       */
     export class CustomGeometrySystem {
-        constructor(state: RendererState);
+        constructor(state: RendererState, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition']);
         update(): void;
     }
 }
@@ -9204,7 +9515,7 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/interactions/system' {
 
 declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
     import type { PerspectiveCamera, Scene, WebGLRenderer } from 'three';
-    import { Vector2, Vector3 } from 'three';
+    import { Object3D, Vector2, Vector3 } from 'three';
     import { PubSub } from '@mappedin/mappedin-js/packages/common/pubsub';
     import * as CAMERA_CONSTANTS from '@mappedin/mappedin-js/geojson/src/systems/camera/constants';
     import type { AnimateCameraTarget, CameraControlsOptions, CameraFocusOnOptions } from '@mappedin/mappedin-js/geojson/src/systems/camera/types';
@@ -9650,6 +9961,7 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                     position: Vector3;
                     zoom: number;
             };
+            debugContainer: Object3D<import("three").Object3DEventMap>;
             focusOn(pointCloud: Vector3[], { insetsPadding }: any, options?: CameraFocusOnOptions): void;
             resize(canvasWidth: number, canvasHeight: number): void;
     }