@mappedin/mappedin-js 5.47.0 → 5.49.0

package/lib/esm/renderer/index.d.ts

@@ -12,7 +12,6 @@ declare module '@mappedin/mappedin-js' {
     import { MapView } from '@mappedin/mappedin-js/renderer/public/MapView';
     import type { Mappedin, MappedinMap, TGetVenueBundleOptions, TGetVenueOptions } from '@mappedin/mappedin-js/get-venue';
     import { getVenue, getVenueMVF, getVenueBundle, getVenueMaker, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, MappedinDestinationSet, hydrateVenue, GET_VENUE_EVENT } from '@mappedin/mappedin-js/get-venue';
-    import { PositionUpdater } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core';
     import type { TMapViewOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     export { E_SDK_LOG_LEVEL, setLoggerLevel } from '@mappedin/mappedin-js/common/Mappedin.Logger';
     export type { Marker } from '@mappedin/mappedin-js/renderer/private/controllers/MarkersController';
@@ -59,7 +58,7 @@ declare module '@mappedin/mappedin-js' {
         */
     function showVenue<T extends Mappedin>(el: HTMLElement, venue: T, options?: TMapViewOptions): Promise<MapView>;
     export { COLLISION_RANKING_TIERS, STATE, E_SDK_EVENT, E_BLUEDOT_STATE_REASON, E_BLUEDOT_MARKER_STATE, E_BLUEDOT_EVENT, E_BLUEDOT_STATE, E_CAMERA_EVENT, E_CAMERA_DIRECTION, SAFE_AREA_INSET_TYPE, ANIMATION_TWEENS, CAMERA_EASING_MODE, STACKED_MAPS_STATE, MARKER_ANCHOR, GEOLOCATION_STATUS, E_MAP_CHANGED_REASON, } from '@mappedin/mappedin-js/renderer/MapView.enums';
-    export { getVenue, getVenueMVF, getVenueBundle, getVenueMaker, showVenue, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, hydrateVenue, PositionUpdater, MappedinDestinationSet, GET_VENUE_EVENT, };
+    export { getVenue, getVenueMVF, getVenueBundle, getVenueMaker, showVenue, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, hydrateVenue, MappedinDestinationSet, GET_VENUE_EVENT, };
     import DefaultAssetManager from '@mappedin/mappedin-js/renderer/internal/Mappedin.AssetManager';
     import type { TTileManagerOptions } from '@mappedin/mappedin-js/renderer/internal/outdoor-context/Mappedin.TileManager';
     import type { TShowWatermarkOptions } from '@mappedin/mappedin-js/renderer/private/controllers/WatermarkController';
@@ -972,197 +971,6 @@ declare module '@mappedin/mappedin-js/get-venue' {
     export function hydrateVenueMVF(mvfData: ParsedMVF): Promise<Mappedin>;
 }
 
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core' {
-    import FakeGeolocation from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/fake-geolocation';
-    import { IStateMachine } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.StateMachine';
-    import { E_BLUEDOT_MARKER_STATE, E_BLUEDOT_STATE, E_BLUEDOT_STATE_REASON } from '@mappedin/mappedin-js/renderer/MapView.enums';
-    import PositionSmoothing from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/position-smoothing';
-    import { PubSub, IPubSub } from '@mappedin/mappedin-js/renderer/internal/pub-sub';
-    import { MappedinMap, MappedinNode } from '@mappedin/mappedin-js/get-venue';
-    import { TGeolocationObject } from '@mappedin/mappedin-js/renderer/MapView.types';
-    import type { ICore } from '@mappedin/mappedin-js/renderer/internal';
-    import { BlueDotManager } from '@mappedin/mappedin-js/renderer/internal';
-    export const DEFAULT_BLUE_DOT_COLOR = "#2266ff";
-    /**
-        * Position Updater Events
-        * @internal
-        */
-    export enum E_POSITION_UPDATER_EVENT {
-            POSITION_UPDATE = 0,
-            ERROR = 1
-    }
-    export interface IPositionUpdater extends IPubSub {
-            /**
-                * Function that emits position updates
-                */
-            update: (position: TGeolocationObject) => void;
-            /**
-                * Optional function to start listening
-                */
-            start?: (options?: any) => void;
-            /**
-                * Optional function to stop listening
-                */
-            stop?: () => void;
-            /**
-                * Function that emits an error in retrieving position
-                */
-            throwError?: (err: string) => void;
-    }
-    export class PositionUpdater extends PubSub implements IPositionUpdater {
-            update: (position: TGeolocationObject) => void;
-            throwError: (err: any) => void;
-    }
-    export type TEnableBlueDotOptions = {
-            /**
-                * Show Bearing
-                * @defaultValue false
-                */
-            showBearing?: boolean;
-            /**
-                * For venues that do not provide level updates, assume the user is always on the default map
-                * If this is false, and no level information is found from position updates, blueDotUpdate events will
-                * not include the nearest node
-                * This should probably be set true for single floor venues that have no level information in position updates
-                *
-                * @defaultValue false
-                */
-            allowImplicitFloorLevel?: boolean;
-            /**
-                * Smooth incoming position updates. Set to false if smoothing happens outside the SDK
-                * @defaultValue true
-                */
-            smoothing?: boolean;
-            /**
-                * Custom positionUpdater
-                * @defaultValue undefined
-                */
-            positionUpdater?: IPositionUpdater;
-            /**
-                * Override the default color of the Blue Dot. We interpolate other colors, (such as aura and bearing) from this base color
-                * @defaultValue '#2266ff'
-                */
-            baseColor?: string;
-            /**
-                * Whether to use the rotated view while following the user's position.
-                * @defaultValue false
-                */
-            useRotationMode?: boolean;
-    };
-    export type TUserData = {
-            state: E_BLUEDOT_STATE;
-            position: TGeolocationObject | null;
-            map: MappedinMap | null;
-            bearing: any;
-            nearestNode: any;
-            hasEverReceivedFloorLevel: boolean;
-    };
-    export interface IBlueDotCore extends IPubSub {
-            positionUpdater: IPositionUpdater | null;
-            positionSmoothing: PositionSmoothing;
-            locationUncertainTimeoutPeriod: number;
-            fallbackToGPSTimeoutPeriod: number;
-            enableBlueDot: (options?: TEnableBlueDotOptions) => void;
-            disableBlueDot: () => void;
-            enableBlueDotOptions: TEnableBlueDotOptions;
-            enabled: boolean;
-            enableTargetMapOverride: (mapId: MappedinMap['id'], options?: {
-                    restoreWhenNewFloorLevelIsReceived: boolean;
-            }) => void;
-            disableTargetMapOverride: () => void;
-            targetMapOverride?: {
-                    mapId: MappedinMap['id'];
-                    lastStoredMapId?: MappedinMap['id'];
-                    options?: {
-                            restoreWhenNewFloorLevelIsReceived: boolean;
-                    };
-            };
-            state: TBlueDotStateChange;
-            /**
-            Whether blue dot should be allowed with missing floor level information.
-             */
-            forceBlueDot: boolean;
-            /** Whether we have received floorLevel data and are on a floorLevel supported device */
-            hasEverReceivedFloorLevel: boolean;
-            /**
-            The state machine for the current state of the blue dot.
-             */
-            stateMachine: IStateMachine;
-            /**
-            The map the user's device is currently on.
-             */
-            userMap: MappedinMap | null;
-            /**
-            The position of the user's device.
-             */
-            userPosition: TGeolocationObject | null;
-            /**
-            The nearest node to the user's position.
-             */
-            nearestNode: any;
-            /**
-            The direction the user is moving.
-             */
-            bearing: any;
-            /**
-                * When bearing is set by updateBearing. undefined if overrideBearing is turned off
-                */
-            overrideBearing?: number;
-            /**
-            Everything in one object, for convenience.
-             */
-            userData: TUserData | null;
-    }
-    export type TBlueDotPositionUpdate = {
-            /**
-                * The {@link MappedinMap} Blue Dot position is on
-                */
-            map?: MappedinMap;
-            /**
-                * The nearest {@link MappedinNode} to the Blue Dot position
-                */
-            nearestNode?: MappedinNode;
-            /**
-                * Actual position of Blue Dot (post smoothing, if smoothing is enabled)
-                */
-            position?: TGeolocationObject;
-            /**
-                * Current Blue Dot bearing
-                */
-            bearing?: number;
-    };
-    export type TBlueDotStateChange = {
-            /**
-                * What we currently know about the user's position, and how confident we are.
-                */
-            name: E_BLUEDOT_STATE;
-            /**
-                * Visiblity state of the Blue Dot marker
-                */
-            markerVisibility?: E_BLUEDOT_MARKER_STATE;
-            /**
-                * Reason why Blue Dot may be in the current state
-                */
-            reason?: E_BLUEDOT_STATE_REASON;
-            /**
-                * Additional message to complement the reason
-                */
-            message?: GeolocationPositionError | string;
-    };
-    export const FALLBACK_TO_GPS_TIMEOUT = 10000;
-    type TBlueDotProps = {
-            data: any;
-            core: ICore;
-            manager: BlueDotManager;
-    };
-    export type TLatLonProps = [number, number];
-    const BlueDot: {
-            ({ data, core, manager }: TBlueDotProps): IBlueDotCore;
-            FakeGeolocation: typeof FakeGeolocation;
-    };
-    export default BlueDot;
-}
-
 declare module '@mappedin/mappedin-js/renderer/MapView.types' {
     import type { MAP_RENDER_MODE, Mappedin, MappedinCoordinate, MappedinLocation, MappedinMap, MappedinNode, MappedinPolygon, ThingsOption } from '@mappedin/mappedin-js/get-venue';
     import type { TFloatingLabelAppearance } from '@mappedin/mappedin-js/renderer/internal/Mappedin.FloatingLabel';
@@ -1172,6 +980,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
     import { TOOLTIP_ANCHOR } from '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartTooltip';
     import { GEOLOCATION_STATUS, COLLISION_RANKING_TIERS, STATE, MARKER_ANCHOR, E_SDK_EVENT, E_BLUEDOT_EVENT, E_CAMERA_EVENT, CAMERA_EASING_MODE, E_MAP_CHANGED_REASON, STACKED_MAPS_STATE } from '@mappedin/mappedin-js/renderer/MapView.enums';
     import { TOutdoorViewOptions, TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL } from '@mappedin/mappedin-js/renderer/private/controllers/OutdoorViewController';
+    import { IPubSub, PubSub } from '@mappedin/mappedin-js/renderer/internal/pub-sub';
     export type { TEnableBlueDotOptions, TFloatingLabelAppearance, ThingsOption };
     /** @internal */
     export type Without<T, U> = {
@@ -1384,7 +1193,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
             overviewPathOptions?: TPathOptions;
             overviewPathOnConnectionsOptions?: TPathOptions;
             showOverviewPathOnMap?: MappedinMap;
-            overviewPathMode?: 'always' | 'current-elevation-and-mapgroup';
+            overviewPathMode?: 'always' | 'current-elevation-and-mapgroup' | 'current-elevation';
             overviewInactivePathSizeFactor?: number;
             overviewPathInactiveColor?: string;
     };
@@ -2404,10 +2213,11 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
     export type { default as Journey } from '@mappedin/mappedin-js/renderer/public/api/Journey';
     export type TStackedMapsOptions = {
             /**
-                * The vertical distance between maps in overview, in metres.
+                * The vertical distance between maps in overview, in metres. When set to 'auto', will automatically determine
+                * the ideal vertical spacing based on map content and dimensions.
                 * @default 50
                 */
-            verticalDistanceBetweenMaps?: number;
+            verticalDistanceBetweenMaps?: number | 'auto';
             /**
                 * Whether to show map level labels in overview.
                 * @default true
@@ -2419,6 +2229,28 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 */
             prioritizeJourneyMaps?: boolean;
     };
+    export interface IPositionUpdater extends IPubSub {
+            /**
+                * Function that emits position updates
+                */
+            update: (position: TGeolocationObject) => void;
+            /**
+                * Optional function to start listening
+                */
+            start?: (options?: any) => void;
+            /**
+                * Optional function to stop listening
+                */
+            stop?: () => void;
+            /**
+                * Function that emits an error in retrieving position
+                */
+            throwError?: (err: string) => void;
+    }
+    export class PositionUpdater extends PubSub implements IPositionUpdater {
+            update: (position: TGeolocationObject) => void;
+            throwError: (err: any) => void;
+    }
 }
 
 declare module '@mappedin/mappedin-js/common/Mappedin.Logger' {
@@ -3911,7 +3743,7 @@ declare module '@mappedin/mappedin-js/renderer/internal' {
     import { MappedinMap } from '@mappedin/mappedin-js/get-venue';
     import { Vector3 } from '@mappedin/mvf';
     export { MappedinMap, Mappedin, MappedinCoordinate, MappedinPolygon, MappedinNode, MappedinLocation, MappedinVenue, findPreferredLanguage, } from '@mappedin/mappedin-js/get-venue';
-    export type { TEnableBlueDotOptions, TFloatingLabelAppearance, TGeolocationObject, TPathOptions, TConnectionProps, TConnectionTemplateFn, TMarkerTemplateProps, TMarkerTemplateFn, TJourneyOptions, TPadding, TCreateMarkerOptions, TAnimationOptions, TCreateTooltipInternalOptions, TCreateTooltipCommonOptions, TCreateTooltipOptions, TCreateTextTooltipOptions, TCreateCustomInnerHTMLTooltipOptions, TCreateCustomTooltipOptions, TCreateThreeDMarkerOptions, TGetPolygonsAtCoordinateOptions, TMapViewOptions, TMapViewOptionsLegacy, TFlatLabelOptions, TFlatLabelAppearance, TFloatingLabelPolygonOptions, TAddFlatLabelOptions, TAddFloatingLabelOptions, TLabelAllLocationCommonOptions, TLabelAllLocationFloatingLabelOptions, TLabelAllLocationFlatLabelOptions, TFloatingLabelAllLocationsOptions, TFlatLabelAllLocationsOptions, changeListenerFn, TMapClickEvent, E_SDK_EVENT_PAYLOAD, E_BLUEDOT_EVENT_PAYLOAD, CAMERA_EVENT_PAYLOAD, } from '@mappedin/mappedin-js/renderer/MapView.types';
+    export type { TEnableBlueDotOptions, TFloatingLabelAppearance, TGeolocationObject, TPathOptions, TConnectionProps, TConnectionTemplateFn, TMarkerTemplateProps, TMarkerTemplateFn, TJourneyOptions, TPadding, TCreateMarkerOptions, TAnimationOptions, TCreateTooltipInternalOptions, TCreateTooltipCommonOptions, TCreateTooltipOptions, TCreateTextTooltipOptions, TCreateCustomInnerHTMLTooltipOptions, TCreateCustomTooltipOptions, TCreateThreeDMarkerOptions, TGetPolygonsAtCoordinateOptions, TMapViewOptions, TMapViewOptionsLegacy, TFlatLabelOptions, TFlatLabelAppearance, TFloatingLabelPolygonOptions, TAddFlatLabelOptions, TAddFloatingLabelOptions, TLabelAllLocationCommonOptions, TLabelAllLocationFloatingLabelOptions, TLabelAllLocationFlatLabelOptions, TFloatingLabelAllLocationsOptions, TFlatLabelAllLocationsOptions, changeListenerFn, TMapClickEvent, E_SDK_EVENT_PAYLOAD, E_BLUEDOT_EVENT_PAYLOAD, CAMERA_EVENT_PAYLOAD, TStackedMapsOptions, } from '@mappedin/mappedin-js/renderer/MapView.types';
     export { labelThemes } from '@mappedin/mappedin-js/renderer/MapView.types';
     export { GEOLOCATION_STATUS, COLLISION_RANKING_TIERS, E_BLUEDOT_STATE_REASON, E_BLUEDOT_STATE, E_BLUEDOT_MARKER_STATE, STATE, MARKER_ANCHOR, E_SDK_EVENT, E_BLUEDOT_EVENT, E_CAMERA_EVENT, E_CAMERA_DIRECTION, SAFE_AREA_INSET_TYPE, CAMERA_EASING_MODE, ANIMATION_TWEENS, STACKED_MAPS_STATE, } from '@mappedin/mappedin-js/renderer/MapView.enums';
     export { MAP_RENDER_MODE } from '@mappedin/mappedin-js/get-venue';
@@ -4069,7 +3901,8 @@ declare module '@mappedin/mappedin-js/renderer/internal' {
         * Types
         */
     export type { TSceneTransitionOptions } from '@mappedin/mappedin-js/renderer/private/scene-manager/MapView.SceneManager';
-    export type { IPositionUpdater, IBlueDotCore } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core';
+    export type { IBlueDotCore } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core';
+    export type { IPositionUpdater } from '@mappedin/mappedin-js/renderer/MapView.types';
     export type { TSafeAreaInsets, TCameraTargets, TFocusOnCameraOptions, TCameraTransform, TCameraAnimationOptions, } from '@mappedin/mappedin-js/renderer/private/controllers/CameraController';
     export type { TColliderPosition } from '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider';
     export type { ICollider, TColliderStrategy } from '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider';
@@ -4344,6 +4177,14 @@ declare module '@mappedin/mappedin-js/renderer/MapView.enums' {
                 */
             JOURNEY_CONNECTION_CLICK = "journey-connection-click"
     }
+    /**
+        * Position Updater Events
+        * @internal
+        */
+    export enum E_POSITION_UPDATER_EVENT {
+            POSITION_UPDATE = 0,
+            ERROR = 1
+    }
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.AssetManager' {
@@ -6218,119 +6059,6 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.API.types' {
     };
 }
 
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/fake-geolocation' {
-    export default FakeGeolocation;
-    class FakeGeolocation {
-        constructor(options: any);
-        active: boolean;
-        positions: any[];
-        positionIndex: number;
-        timerList: any[];
-        timeElapsed: number;
-        startTime: number | undefined;
-        startPos: number;
-        endPos: number;
-        smoothingType: any;
-        isActive(): boolean;
-        setCallbacks(success: any, error: any, options: any): void;
-        watchPosition(success: any, error: any, options: any): void;
-        sendPositionResponse(position: any): void;
-        start(): void;
-        pause(): void;
-        speed: any;
-        setPositions(positions: any): void;
-        successCallback: any;
-        errorCallback: any;
-        options: any;
-        clearWatch(): void;
-        reset(): void;
-    }
-}
-
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.StateMachine' {
-    import { IPubSub } from '@mappedin/mappedin-js/renderer/internal/pub-sub';
-    import { E_BLUEDOT_STATE, E_BLUEDOT_MARKER_STATE } from '@mappedin/mappedin-js/renderer/internal';
-    /**
-    What we just learned about the user's position.
-     */
-    export enum ACTION {
-        gotPosition = 0,
-        gotPositionWithFloor = 1,
-        gotError = 2,
-        timedOut = 3,
-        disabledBlueDot = 4,
-        enabledBlueDot = 5
-    }
-    export interface IStateMachine extends IPubSub {
-        state: E_BLUEDOT_STATE;
-        markerState: E_BLUEDOT_MARKER_STATE | undefined;
-        transition: (action: ACTION) => void;
-        reset: () => void;
-    }
-    export enum STATEMACHINE_EVENT {
-        stateChanged = 0,
-        markerStateChanged = 1
-    }
-    const StateMachine: () => IStateMachine & IPubSub;
-    export default StateMachine;
-}
-
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/position-smoothing' {
-    export namespace SMOOTHING_TYPE {
-        let NONE: string;
-        let KALMAN: string;
-    }
-    export default PositionSmoothing;
-    class PositionSmoothing {
-        constructor(levelFilter: any);
-        smooth(pos: any): any;
-        smoothingType: any;
-        lastLocation: any;
-        levelFilter: any;
-        formatLocation(pos: any): {
-            type: string;
-            timestamp: any;
-            coords: {
-                latitude: any;
-                longitude: any;
-                accuracy: any;
-                floorLevel: any;
-            };
-        };
-        kalman(location: any, lastLocation: any): any;
-        latitudeKF: any;
-        longitudeKF: any;
-        setSmoothingType(smoothingType: any): void;
-        reset(): void;
-    }
-}
-
-declare module '@mappedin/mappedin-js/renderer/internal/pub-sub' {
-    type TChangeEventData = {
-        oldValue: any;
-        newValue: any;
-    };
-    type TListenerFn = (data: TChangeEventData | any) => void;
-    export interface IPubSub {
-        publish: (eventName: any, data: TChangeEventData) => void;
-        on: (eventName: any, listenerFn: TListenerFn) => void;
-        off: (eventName: any, listenerFn: TListenerFn) => void;
-        destroy: () => void;
-        _subscribers: {
-            [eventName in any]?: TListenerFn[];
-        };
-    }
-    export class PubSub {
-        _subscribers: any;
-        publish(eventName: any, data: any): void;
-        on(eventName: any, fn: any): void;
-        off(eventName: any, fn: any): void;
-        destroy(): void;
-    }
-    export function tinyObservable<T>(store: T): T & IPubSub;
-    export {};
-}
-
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.FloatingLabel' {
     import './Mappedin.FloatingLabel.scss';
     import { BaseCollider } from '@mappedin/mappedin-js/renderer/internal';
@@ -6583,6 +6311,167 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.FloatingLabel'
     export default InternalFloatingLabel;
 }
 
+declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core' {
+    import FakeGeolocation from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/fake-geolocation';
+    import { IStateMachine } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.StateMachine';
+    import { E_BLUEDOT_MARKER_STATE, E_BLUEDOT_STATE, E_BLUEDOT_STATE_REASON } from '@mappedin/mappedin-js/renderer/MapView.enums';
+    import PositionSmoothing from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/position-smoothing';
+    import { IPubSub } from '@mappedin/mappedin-js/renderer/internal/pub-sub';
+    import { MappedinMap, MappedinNode } from '@mappedin/mappedin-js/get-venue';
+    import { IPositionUpdater, TGeolocationObject } from '@mappedin/mappedin-js/renderer/MapView.types';
+    import type { ICore } from '@mappedin/mappedin-js/renderer/internal';
+    import { BlueDotManager } from '@mappedin/mappedin-js/renderer/internal';
+    export const DEFAULT_BLUE_DOT_COLOR = "#2266ff";
+    export type TEnableBlueDotOptions = {
+            /**
+                * Show Bearing
+                * @defaultValue false
+                */
+            showBearing?: boolean;
+            /**
+                * For venues that do not provide level updates, assume the user is always on the default map
+                * If this is false, and no level information is found from position updates, blueDotUpdate events will
+                * not include the nearest node
+                * This should probably be set true for single floor venues that have no level information in position updates
+                *
+                * @defaultValue false
+                */
+            allowImplicitFloorLevel?: boolean;
+            /**
+                * Smooth incoming position updates. Set to false if smoothing happens outside the SDK
+                * @defaultValue true
+                */
+            smoothing?: boolean;
+            /**
+                * Custom positionUpdater
+                * @defaultValue undefined
+                */
+            positionUpdater?: IPositionUpdater;
+            /**
+                * Override the default color of the Blue Dot. We interpolate other colors, (such as aura and bearing) from this base color
+                * @defaultValue '#2266ff'
+                */
+            baseColor?: string;
+            /**
+                * Whether to use the rotated view while following the user's position.
+                * @defaultValue false
+                */
+            useRotationMode?: boolean;
+    };
+    export type TUserData = {
+            state: E_BLUEDOT_STATE;
+            position: TGeolocationObject | null;
+            map: MappedinMap | null;
+            bearing: any;
+            nearestNode: any;
+            hasEverReceivedFloorLevel: boolean;
+    };
+    export interface IBlueDotCore extends IPubSub {
+            positionUpdater: IPositionUpdater | null;
+            positionSmoothing: PositionSmoothing;
+            locationUncertainTimeoutPeriod: number;
+            fallbackToGPSTimeoutPeriod: number;
+            enableBlueDot: (options?: TEnableBlueDotOptions) => void;
+            disableBlueDot: () => void;
+            enableBlueDotOptions: TEnableBlueDotOptions;
+            enabled: boolean;
+            enableTargetMapOverride: (mapId: MappedinMap['id'], options?: {
+                    restoreWhenNewFloorLevelIsReceived: boolean;
+            }) => void;
+            disableTargetMapOverride: () => void;
+            targetMapOverride?: {
+                    mapId: MappedinMap['id'];
+                    lastStoredMapId?: MappedinMap['id'];
+                    options?: {
+                            restoreWhenNewFloorLevelIsReceived: boolean;
+                    };
+            };
+            state: TBlueDotStateChange;
+            /**
+            Whether blue dot should be allowed with missing floor level information.
+             */
+            forceBlueDot: boolean;
+            /** Whether we have received floorLevel data and are on a floorLevel supported device */
+            hasEverReceivedFloorLevel: boolean;
+            /**
+            The state machine for the current state of the blue dot.
+             */
+            stateMachine: IStateMachine;
+            /**
+            The map the user's device is currently on.
+             */
+            userMap: MappedinMap | null;
+            /**
+            The position of the user's device.
+             */
+            userPosition: TGeolocationObject | null;
+            /**
+            The nearest node to the user's position.
+             */
+            nearestNode: any;
+            /**
+            The direction the user is moving.
+             */
+            bearing: any;
+            /**
+                * When bearing is set by updateBearing. undefined if overrideBearing is turned off
+                */
+            overrideBearing?: number;
+            /**
+            Everything in one object, for convenience.
+             */
+            userData: TUserData | null;
+    }
+    export type TBlueDotPositionUpdate = {
+            /**
+                * The {@link MappedinMap} Blue Dot position is on
+                */
+            map?: MappedinMap;
+            /**
+                * The nearest {@link MappedinNode} to the Blue Dot position
+                */
+            nearestNode?: MappedinNode;
+            /**
+                * Actual position of Blue Dot (post smoothing, if smoothing is enabled)
+                */
+            position?: TGeolocationObject;
+            /**
+                * Current Blue Dot bearing
+                */
+            bearing?: number;
+    };
+    export type TBlueDotStateChange = {
+            /**
+                * What we currently know about the user's position, and how confident we are.
+                */
+            name: E_BLUEDOT_STATE;
+            /**
+                * Visiblity state of the Blue Dot marker
+                */
+            markerVisibility?: E_BLUEDOT_MARKER_STATE;
+            /**
+                * Reason why Blue Dot may be in the current state
+                */
+            reason?: E_BLUEDOT_STATE_REASON;
+            /**
+                * Additional message to complement the reason
+                */
+            message?: GeolocationPositionError | string;
+    };
+    export const FALLBACK_TO_GPS_TIMEOUT = 10000;
+    type TBlueDotProps = {
+            data: any;
+            core: ICore;
+            manager: BlueDotManager;
+    };
+    export type TLatLonProps = [number, number];
+    const BlueDot: {
+            ({ data, core, manager }: TBlueDotProps): IBlueDotCore;
+            FakeGeolocation: typeof FakeGeolocation;
+    };
+    export default BlueDot;
+}
+
 declare module '@mappedin/mappedin-js/renderer/private/controllers/OutdoorViewController' {
     import './OutdoorViewController.scss';
     import type { ICore } from '@mappedin/mappedin-js/renderer/internal';
@@ -6702,6 +6591,32 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/OutdoorViewCo
     export default OutdoorViewController;
 }
 
+declare module '@mappedin/mappedin-js/renderer/internal/pub-sub' {
+    type TChangeEventData = {
+        oldValue: any;
+        newValue: any;
+    };
+    type TListenerFn = (data: TChangeEventData | any) => void;
+    export interface IPubSub {
+        publish: (eventName: any, data: TChangeEventData) => void;
+        on: (eventName: any, listenerFn: TListenerFn) => void;
+        off: (eventName: any, listenerFn: TListenerFn) => void;
+        destroy: () => void;
+        _subscribers: {
+            [eventName in any]?: TListenerFn[];
+        };
+    }
+    export class PubSub {
+        _subscribers: any;
+        publish(eventName: any, data: any): void;
+        on(eventName: any, fn: any): void;
+        off(eventName: any, fn: any): void;
+        destroy(): void;
+    }
+    export function tinyObservable<T>(store: T): T & IPubSub;
+    export {};
+}
+
 declare module '@mappedin/mappedin-js/renderer/private/controllers/BlueDotController' {
     import type { IBlueDotCore, ICore, TEnableBlueDotOptions } from '@mappedin/mappedin-js/renderer/internal';
     import { E_BLUEDOT_EVENT_PAYLOAD, E_BLUEDOT_EVENT, MappedinMap, PubSub } from '@mappedin/mappedin-js/renderer/internal';
@@ -7563,14 +7478,14 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.TaskScheduler' {
 declare module '@mappedin/mappedin-js/renderer/private/scene-manager/MapView.SceneManager' {
     import { MappedinMap } from '@mappedin/mappedin-js/get-venue';
     import type { ICore, TCameraAnimationOptions, TFocusOnCameraOptions, TCameraTargets, MapViewStackScene } from '@mappedin/mappedin-js/renderer/internal';
-    import { MapObject, MapViewScene } from '@mappedin/mappedin-js/renderer/internal';
+    import { MapObject, MapViewScene, type TStackedMapsOptions } from '@mappedin/mappedin-js/renderer/internal';
     export type TSceneTransitionOptions = {
             /**
                 * Map to set as active during the transition. This will decide where the camera will be positioned, as well as which
                 * colliders are enabled.
                 */
             activeMap?: MappedinMap;
-            verticalDistanceBetweenMaps?: number;
+            verticalDistanceBetweenMaps?: TStackedMapsOptions['verticalDistanceBetweenMaps'];
             /**
                 * Whether to auto focus on the active map or leave the camera where it is.
                 * For single building venues, this should look the same way it did with MapManager
@@ -8224,14 +8139,17 @@ declare module '@mappedin/mappedin-js/renderer/private/scene-manager/MapView.Sce
 }
 
 declare module '@mappedin/mappedin-js/renderer/private/scene-manager/MapView.StackScene' {
+    import type { Object3D } from 'three';
     import { Box3, Mesh } from 'three';
-    import { MappedinMap } from '@mappedin/mappedin-js/get-venue';
-    import type { ICore, SceneManager, TSceneTransitionOptions } from '@mappedin/mappedin-js/renderer/internal';
-    import { MapObject, MapViewScene } from '@mappedin/mappedin-js/renderer/internal';
+    import type { MappedinMap } from '@mappedin/mappedin-js/get-venue';
+    import type { ICore, SceneManager, TSceneTransitionOptions, MapObject } from '@mappedin/mappedin-js/renderer/internal';
+    import { MapViewScene } from '@mappedin/mappedin-js/renderer/internal';
     export const DEFAULT_VERTICAL_DISTANCE_BETWEEN_MAPS = 50;
     class MapViewStackScene extends MapViewScene {
         #private;
         containerBoxHelper: Box3;
+        get cachedIdealVerticalDistance(): number | undefined;
+        set cachedIdealVerticalDistance(value: number | undefined);
         viewportBox: any;
         currentMapWrapperMesh: any;
         currentMapWrapperBoxHelper: any;
@@ -8244,7 +8162,7 @@ declare module '@mappedin/mappedin-js/renderer/private/scene-manager/MapView.Sta
         createStackBoundingBox(): void;
         focusOnStackBox(transitionOptions?: TSceneTransitionOptions): Promise<unknown>;
         unmount(): void;
-        computeMapZ(mo: MapObject, index: number, transitionOptions?: TSceneTransitionOptions): number;
+        computeMapZ(mo: MapObject, index: number, verticalDistanceBetweenMaps?: number | 'auto'): number;
         prepare(sceneManager: SceneManager, transitionOptions?: TSceneTransitionOptions): Promise<void>;
         postRender(): void;
         expandMaps: (mapObjects: MapObject[], transitionOptions: TSceneTransitionOptions) => {
@@ -8260,8 +8178,22 @@ declare module '@mappedin/mappedin-js/renderer/private/scene-manager/MapView.Sta
         createMapLabels: () => void;
         updateLabels: () => void;
         destroyLabels: () => void;
+        helpers: Object3D[];
+        debug2DBox: HTMLElement[];
+        /**
+          * Get the first two floor distance as the ideal vertical distance
+          * cached the result to avoid recomputation.
+          * this is a temporary solution to provide an ideal stackedmap vertical distance between floors.
+          * the problem with this approach:
+          * 1. it only considers the first two floors
+          * 2. if the camera panned higher then this computation will be wrong
+          * 3. since cache is at module level, any cercumstances changes will not be reflected: camera rotation
+          */
+        getIdealVerticalDistance(): number | undefined;
+        focusOnCurrentMap(transitionOptions?: TSceneTransitionOptions): Promise<unknown>;
     }
     export default MapViewStackScene;
+    export function isValidBoxNumber(v: number): boolean;
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Element' {
@@ -8874,10 +8806,10 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/BillboardMana
 }
 
 declare module '@mappedin/mappedin-js/renderer/private/controllers/StackedMapsController' {
-    import { MappedinDirections, MappedinMap, MappedinNode } from '@mappedin/mappedin-js/get-venue';
+    import type { MappedinDirections, MappedinMap, MappedinNode } from '@mappedin/mappedin-js/get-venue';
     import { STACKED_MAPS_STATE, MapViewScene, MapViewStackScene, CAMERA_EASING_MODE } from '@mappedin/mappedin-js/renderer/internal';
     import type { ICore, TCameraTransform, TCameraAnimationOptions } from '@mappedin/mappedin-js/renderer/internal';
-    import { TStackedMapsOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
+    import type { TStackedMapsOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     enum ACTION {
         enable = "enable",
         disable = "disable",
@@ -8963,7 +8895,7 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/StackedMapsCo
                     tilt: number;
                 };
             };
-            verticalDistanceBetweenMaps: number | undefined;
+            verticalDistanceBetweenMaps: number | "auto" | undefined;
         })[] | undefined;
         getScrollToMapOptions: (params: TParams) => (MapViewStackScene | {
             focusOn: {
@@ -8986,7 +8918,7 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/StackedMapsCo
                     duration: number;
                 };
             };
-            verticalDistanceBetweenMaps: number | undefined;
+            verticalDistanceBetweenMaps: number | "auto" | undefined;
         })[] | undefined;
         getEnableOptions: () => void;
         getShowOverviewTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
@@ -9378,8 +9310,8 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/JourneyContro
         constructor(directions: MappedinDirections | MappedinDirections[], options: TJourneyOptions | undefined, core: Core);
         setStep: (step: any) => void;
         setStepByPath: (path: Path) => void;
-        overviewPathMode: 'never' | 'always' | 'current-elevation-and-mapgroup';
-        setOverviewPathMode(mode: 'never' | 'always' | 'current-elevation-and-mapgroup'): void;
+        overviewPathMode: 'never' | 'always' | 'current-elevation-and-mapgroup' | 'current-elevation';
+        setOverviewPathMode(mode: 'never' | 'always' | 'current-elevation-and-mapgroup' | 'current-elevation'): void;
         static instance: JourneyController | null;
         static create(directions: MappedinDirections | MappedinDirections[], options: any, core: Core): JourneyController;
         destroy(): void;
@@ -11479,27 +11411,51 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.cache' {
         categories: {
             [id: string]: MappedinCategory;
         };
+        categoriesByExternalId: {
+            [externalId: string]: MappedinCategory;
+        };
         locations: {
             [id: string]: MappedinLocation;
         };
+        locationsByExternalId: {
+            [externalId: string]: MappedinLocation;
+        };
         vortexes: {
             [id: string]: MappedinVortex;
         };
+        vortexesByExternalId: {
+            [externalId: string]: MappedinVortex;
+        };
         maps: {
             [id: string]: MappedinMap;
         };
+        mapsByExternalId: {
+            [externalId: string]: MappedinMap;
+        };
         nodes: {
             [id: string]: MappedinNode;
         };
+        nodesByExternalId: {
+            [externalId: string]: MappedinNode;
+        };
         polygons: {
             [id: string]: MappedinPolygon;
         };
+        polygonsByExternalId: {
+            [externalId: string]: MappedinPolygon;
+        };
         events: {
             [id: string]: MappedinEvent;
         };
+        eventsByExternalId: {
+            [externalId: string]: MappedinEvent;
+        };
         mapGroups: {
             [id: string]: MappedinMapGroup;
         };
+        mapGroupsByExternalId: {
+            [externalId: string]: MappedinMapGroup;
+        };
         locationStates: {
             [id: string]: MappedinLocationState;
         };
@@ -11539,6 +11495,93 @@ declare module '@mappedin/mappedin-js/renderer/internal/shave-text' {
     export {};
 }
 
+declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/fake-geolocation' {
+    export default FakeGeolocation;
+    class FakeGeolocation {
+        constructor(options: any);
+        active: boolean;
+        positions: any[];
+        positionIndex: number;
+        timerList: any[];
+        timeElapsed: number;
+        startTime: number | undefined;
+        startPos: number;
+        endPos: number;
+        smoothingType: any;
+        isActive(): boolean;
+        setCallbacks(success: any, error: any, options: any): void;
+        watchPosition(success: any, error: any, options: any): void;
+        sendPositionResponse(position: any): void;
+        start(): void;
+        pause(): void;
+        speed: any;
+        setPositions(positions: any): void;
+        successCallback: any;
+        errorCallback: any;
+        options: any;
+        clearWatch(): void;
+        reset(): void;
+    }
+}
+
+declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.StateMachine' {
+    import { IPubSub } from '@mappedin/mappedin-js/renderer/internal/pub-sub';
+    import { E_BLUEDOT_STATE, E_BLUEDOT_MARKER_STATE } from '@mappedin/mappedin-js/renderer/internal';
+    /**
+    What we just learned about the user's position.
+     */
+    export enum ACTION {
+        gotPosition = 0,
+        gotPositionWithFloor = 1,
+        gotError = 2,
+        timedOut = 3,
+        disabledBlueDot = 4,
+        enabledBlueDot = 5
+    }
+    export interface IStateMachine extends IPubSub {
+        state: E_BLUEDOT_STATE;
+        markerState: E_BLUEDOT_MARKER_STATE | undefined;
+        transition: (action: ACTION) => void;
+        reset: () => void;
+    }
+    export enum STATEMACHINE_EVENT {
+        stateChanged = 0,
+        markerStateChanged = 1
+    }
+    const StateMachine: () => IStateMachine & IPubSub;
+    export default StateMachine;
+}
+
+declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/position-smoothing' {
+    export namespace SMOOTHING_TYPE {
+        let NONE: string;
+        let KALMAN: string;
+    }
+    export default PositionSmoothing;
+    class PositionSmoothing {
+        constructor(levelFilter: any);
+        smooth(pos: any): any;
+        smoothingType: any;
+        lastLocation: any;
+        levelFilter: any;
+        formatLocation(pos: any): {
+            type: string;
+            timestamp: any;
+            coords: {
+                latitude: any;
+                longitude: any;
+                accuracy: any;
+                floorLevel: any;
+            };
+        };
+        kalman(location: any, lastLocation: any): any;
+        latitudeKF: any;
+        longitudeKF: any;
+        setSmoothingType(smoothingType: any): void;
+        reset(): void;
+    }
+}
+
 declare module '@mappedin/mappedin-js/navigator/Edge' {
     import INode from '@mappedin/mappedin-js/navigator/interfaces/INode';
     import IVortex from '@mappedin/mappedin-js/navigator/interfaces/IVortex';