@mappedin/mappedin-js 6.0.1-beta.15 → 6.0.1-beta.16

package/lib/esm/index.d.ts

@@ -3,6 +3,7 @@
 //   ../mappedin-js/@packages/internal/mvf-utils
 //   ../mappedin-js/@mappedin/mvf
 //   ../mappedin-js/@packages/internal/common/pubsub
+//   ../mappedin-js/@packages/internal/mvf-utils/mvf-utils
 //   ../mappedin-js/@packages/internal/common/Mappedin.Logger
 //   ../mappedin-js/geojson
 //   ../mappedin-js/@packages/internal/common
@@ -37,11 +38,13 @@ declare module '@mappedin/mappedin-js' {
     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, 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 type { InsetPadding, InsetPaddingOption, Shading, PaintStyle, LineStyle, WatermarkOptions } from '@mappedin/mappedin-js/geojson/src';
     import { enableTestMode } from '@mappedin/mappedin-js/geojson/src';
     export type { PubSub } from '@packages/internal/common/pubsub';
     import { MappedinMapLibreOverlay } from '@mappedin/mappedin-js/mappedin-js/src/maplibre-overlay';
     import type { LanguagePackHydrationItem } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import { type Environment } from '@packages/internal/mvf-utils/mvf-utils';
+    import type { TBlueDotEvents, TBlueDotAction, TBlueDotState } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     export { setLoggerLevel, E_SDK_LOG_LEVEL } from '@packages/internal/common/Mappedin.Logger';
     /**
         * Represents all the available antialiasing options.
@@ -167,6 +170,7 @@ declare module '@mappedin/mappedin-js' {
                     token?: string;
                     /**
                         * A url to a style specification conforming to the [Maplibre Style Spec](https://maplibre.org/maplibre-style-spec/).
+                        * Use the {@link Environment | `environment`} setting to switch environments.
                         */
                     style?: string;
                     /**
@@ -354,7 +358,7 @@ declare module '@mappedin/mappedin-js' {
     export const show3dMapGeojson: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
     export const show3dMap: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
     export { parseMVF, unzipMVF, enableTestMode };
-    export type { MapView, MapData, MappedinMapLibreOverlay, TEvents, TEventPayload, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, };
+    export type { MapView, MapData, MappedinMapLibreOverlay, TBlueDotEvents, TBlueDotAction, TBlueDotState, TEvents, TEventPayload, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, };
     export type * from 'geojson';
     export type { TUpdateState, TLabelState, TGeometryState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, TBlueDotPositionUpdate, } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export { WALLS, DOORS } from '@mappedin/mappedin-js/mappedin-js/src/types';
@@ -423,6 +427,19 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
             constructor(internal: MapDataInternal, { search }?: {
                     search?: TSearchOptions;
             });
+            /**
+                * Get the current environment.
+                *
+                * @example
+                * const env = mapData.getEnv();
+                * console.log(env.baseUri); // Get the API URL for the current environment
+                */
+            getEnv(): {
+                    readonly baseUri: string;
+                    readonly baseAuthUri: string;
+                    readonly analyticsBaseUri: string;
+                    readonly tileServerUri: string;
+            };
             /**
                 * The name of the map.
                 *
@@ -612,6 +629,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/events' {
     import type { Coordinate, Floor, MapObject, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { Label, Marker, Model, Path } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { CameraTransform } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/camera-transform';
+    import type { TBlueDotEvents } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot';
     export type TFloorChangeReason = '' | 'blue-dot-floor-change' | 'elevation-change';
     export type TClickPayload = {
             /**
@@ -703,6 +721,18 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/events' {
                 * Emitted when a user interaction with the map ends.
                 */
             'user-interaction-end': undefined;
+            /**
+                * Emitted when the Blue Dot's position is updated.
+                */
+            'blue-dot-position-update': TBlueDotEvents['position-update'];
+            /**
+                * Emitted when the Blue Dot's state changes.
+                */
+            'blue-dot-state-change': TBlueDotEvents['state-change'];
+            /**
+                * Emitted when the Blue Dot encounters an error.
+                */
+            'blue-dot-error': TBlueDotEvents['error'];
     } & TStackedMapsEvents;
     export type TEventPayload<EventName extends keyof TEvents> = TEvents[EventName] extends {
             data: null;
@@ -741,6 +771,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
     import { PubSub } from '@packages/internal/common';
     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 { EnvControl } from '@packages/internal/mvf-utils/mvf-utils';
     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';
@@ -812,10 +843,17 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                     [languageCode: string]: LanguagePack;
             };
             binaryBundle?: Uint8Array;
+            envControl: EnvControl;
             /**
                 * @internal
                 */
             constructor(mvf: ParsedMVF, options: TMapDataInternalOptions);
+            getEnv(): {
+                    readonly baseUri: string;
+                    readonly baseAuthUri: string;
+                    readonly analyticsBaseUri: string;
+                    readonly tileServerUri: string;
+            };
             /**
                 * Retrieves the map name.
                 *
@@ -950,10 +988,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
     import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
     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 { Label, Marker, Image, Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { TEventPayload } from '@mappedin/mappedin-js/mappedin-js/src/events';
     import type { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
     import type { TShowStackOptions } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
+    import type { InspectorOption } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/inspector/inspector';
     export class MapView extends PubSub<TEvents> {
             #private;
             /**
@@ -1027,7 +1066,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * // Update the color of a space to red.
                 * map.updateState(space, { color: 'red' });
                 */
-            updateState<T extends Space | MapObject | Label | Marker | Door | WALLS | DOORS>(target: T, state: TUpdateState<T>): any;
+            updateState<T extends Space | MapObject | Label | Marker | Shape | Door | WALLS | DOORS>(target: T, state: TUpdateState<T>): any;
             updateState<T extends string & NonNullable<unknown>>(target: T, state: TUpdateStates): any;
             update: () => void;
             getMapData(): {
@@ -1077,7 +1116,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * @hidden
                 */
             updateWatermark(options: WatermarkUpdateOptions): void;
-            getState<T extends Space | MapObject | Label | Marker | Image | string>(target: T): TGetState<T> | undefined;
+            getState<T extends Space | MapObject | Label | Marker | Image | Shape | string>(target: T): TGetState<T> | undefined;
             setHoverColor(c: string): void;
             getHoverColor(): string | undefined;
             /**
@@ -1195,7 +1234,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * @experimental
                 * Enable debug interface
                 */
-            enableDebug(): Promise<void>;
+            enableDebug(opitons?: InspectorOption): Promise<void>;
     }
 }
 
@@ -1206,7 +1245,7 @@ declare module '@mappedin/mappedin-js/geojson/src' {
     import type { GroupContainerState } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
     import type { GeometryGroupState } from '@mappedin/mappedin-js/geojson/src/entities/geometry-group';
     import type { Position } from '@mappedin/mappedin-js/geojson/src/types/geometry';
-    import type { InsetPadding, RendererCoreOptions, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload } from '@mappedin/mappedin-js/geojson/src/types';
+    import type { InsetPadding, InsetPaddingOption, RendererCoreOptions, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload } from '@mappedin/mappedin-js/geojson/src/types';
     import type { GeometryState } from '@mappedin/mappedin-js/geojson/src/components/mesh';
     import type { ShapeState, CustomGeometryBuilder } from '@mappedin/mappedin-js/geojson/src/components/custom';
     import type { ModelState } from '@mappedin/mappedin-js/geojson/src/components/model';
@@ -1230,7 +1269,7 @@ declare module '@mappedin/mappedin-js/geojson/src' {
     export type { GLTFExportOptions } from '@mappedin/mappedin-js/geojson/src/systems/exporter';
     export type { AttributionControlOptions, AttributionPosition } from '@mappedin/mappedin-js/geojson/src/systems/html-controls/system';
     export { ATTRIBUTION_POSITIONS } from '@mappedin/mappedin-js/geojson/src/systems/html-controls/system';
-    export type { AddPathOptions, AddMarkerOptions, AddLabelOptions, AnimateToOptions, FocusOnOptions, MapViewState, MarkerState, PathState, GroupContainerState, GeometryGroupState, ShapeState, CustomGeometryBuilder, LabelState, GeometryState, ModelState, EasingCurve, Camera, InsetPadding, Position, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload, CollisionRankingTier, LabelAppearance, RendererCore, };
+    export type { AddPathOptions, AddMarkerOptions, AddLabelOptions, AnimateToOptions, FocusOnOptions, MapViewState, MarkerState, PathState, GroupContainerState, GeometryGroupState, ShapeState, CustomGeometryBuilder, LabelState, GeometryState, ModelState, EasingCurve, Camera, InsetPadding, InsetPaddingOption, Position, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload, CollisionRankingTier, LabelAppearance, RendererCore, };
     export function createRenderer(container: HTMLElement, options?: RendererCoreOptions & {
         [key: string]: any;
     }): Promise<RendererCore>;
@@ -1268,9 +1307,10 @@ 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, 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 { Label, Marker, Model, Image, Shape } 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';
+    import type { InsetPaddingOption } from '@mappedin/mappedin-js/geojson/src';
     export type DeepRequired<T> = Required<{
             [K in keyof T]: T[K] extends Required<T[K]> ? T[K] : DeepRequired<T[K]>;
     }>;
@@ -1466,6 +1506,36 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             coordinate: Coordinate;
     };
+    /**
+        * Represents the state of a shape.
+        */
+    export type TShapeState = {
+            /**
+                * The type of the shape.
+                */
+            type: 'Shape';
+            /**
+                * Whether Shpae is visible
+                */
+            visible: boolean;
+            /**
+                * The altitude of the shape.
+                */
+            altitude: number;
+            /**
+                * The color of the shape.
+                */
+            color: string;
+            /**
+                * The height of the shape.
+                * Height cannot be updated at this time
+                */
+            height: number;
+            /**
+                * The opacity of the shape.
+                */
+            opacity: number;
+    };
     /**
         * Defines the state for geometry elements like {@link Space} when updated.
         */
@@ -1523,9 +1593,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     /**
         * The type for updating the state of map elements (colors, texts, etc.).
         */
-    export type TUpdateState<T> = T extends WALLS ? Partial<TWallsState> : T extends DOORS ? Partial<TDoorsState> : T extends Marker ? Partial<TMarkerState> : T extends Label ? Partial<TLabelState> : T extends Space | MapObject ? Partial<TGeometryState> : T extends Door ? Partial<TGeometryState> : T extends string ? Record<string, any> : never;
+    export type TUpdateState<T> = T extends WALLS ? Partial<TWallsState> : T extends DOORS ? Partial<TDoorsState> : T extends Marker ? Partial<TMarkerState> : T extends Label ? Partial<TLabelState> : T extends Space | MapObject ? Partial<TGeometryState> : T extends Shape ? Partial<Omit<TShapeState, 'height' | 'type'>> : T extends Door ? Partial<TGeometryState> : T extends string ? Record<string, any> : never;
     export type TUpdateStates = Partial<Omit<TGeometryState, 'interactive' | 'hoverColor' | 'type'>> | Partial<TMarkerState> | Partial<TLabelState> | Partial<TGeometryState>;
-    export type TGetEntityState<T> = T extends WALLS ? TWallsState : T extends DOORS ? TDoorsState : T extends Marker ? TMarkerState : T extends Model ? TModelState : T extends Label ? TLabelState : T extends Image ? TImageState : T extends Space | MapObject ? TGeometryState : T extends string ? TLabelState | TGeometryState | TMarkerState | TModelState | undefined : never;
+    export type TGetEntityState<T> = T extends WALLS ? TWallsState : T extends DOORS ? TDoorsState : T extends Marker ? TMarkerState : T extends Shape ? TShapeState : T extends Model ? TModelState : T extends Label ? TLabelState : T extends Image ? TImageState : T extends Space | MapObject ? TGeometryState : T extends string ? TLabelState | TGeometryState | TMarkerState | TModelState | undefined : never;
     export type TGetState<T> = TGetEntityState<T> | undefined;
     /**
         * Options for {@link Camera} animations on the map.
@@ -1586,7 +1656,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             maxZoomLevel?: number;
             /**
-                * Camera bearing when focusing on a target, in degrees.
+                * Camera bearing when focusing on a target in degrees clockwise from North. 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
                 */
             bearing?: number;
             /**
@@ -1596,12 +1666,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
             /**
                 * Screen offsets for the camera focus.
                 */
-            screenOffsets?: {
-                    top: number;
-                    right: number;
-                    bottom: number;
-                    left: number;
-            };
+            screenOffsets?: InsetPaddingOption;
     };
     export type TCameraFocusOnTargets = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | Node;
     /**
@@ -1624,7 +1689,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             zoomLevel?: number;
             /**
-                * Bearing for the camera target in degrees.
+                * Bearing for the camera target in degrees clockwise from North. 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
                 */
             bearing?: number;
             /**
@@ -1894,7 +1959,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
         * | 'right'  | Anchors the marker on the right side, convenient for when space is limited on the left.|
         *
         */
-    export type TMarkerAnchor = 'center' | 'top' | 'left' | 'bottom' | 'right';
+    export type TMarkerAnchor = 'center' | 'top' | 'left' | 'bottom' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
     /**
         * Options for controlling the behavior of the {@link Directions}.
         */
@@ -2007,7 +2072,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             height: number;
             /**
-                * Rotation of the image in degrees.
+                * Rotation of the image in degrees clockwise from North. 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
                 *
                 * @default 0
                 */
@@ -2039,7 +2104,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 *  Optional. Specifies the anchor point of the marker, determining its position relative to its coordinates.
                 *  For the possible values and their descriptions, see {@link TMarkerAnchor}
                 */
-            anchor?: TMarkerAnchor;
+            anchor?: TMarkerAnchor | TMarkerAnchor[];
             /**
                 * Whether the {@link Marker} should be clickable
                 * @default false
@@ -2182,11 +2247,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             heading?: GeolocationPosition['coords']['heading'] | 'device' | undefined;
             /**
-                * Floor level to override.
+                * Floor or floorId to override.
                 * Set to `'device'` to reset to the device's floor level.
                 * Set to `undefined` to disable floor level and show the BlueDot on all floors.
                 */
-            floor?: Floor | 'device' | undefined;
+            floorOrFloorId?: Floor | string | 'device' | undefined;
     };
     export type LanguagePackHydrationItem = {
             language: Language;
@@ -2194,6 +2259,120 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     };
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot' {
+    import type { RendererCore } from '@mappedin/core-sdk';
+    import { PubSub } from '@packages/internal/common';
+    import { Coordinate, type Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { TBlueDotOptions, TBlueDotPositionUpdate } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
+    export type TBlueDotEvents = {
+            /**
+                * Emitted when the Blue Dot's position is updated.
+                */
+            'position-update': {
+                    floor: Floor | undefined;
+                    heading: GeolocationPosition['coords']['heading'] | undefined;
+                    accuracy: GeolocationPosition['coords']['accuracy'] | undefined;
+                    coordinate: Coordinate;
+            };
+            /**
+                * Emitted when the Blue Dot's state changes.
+                */
+            'state-change': {
+                    /**
+                        * The new state of the Blue Dot.
+                        */
+                    state: TBlueDotState;
+                    /**
+                        * The action that caused the state change.
+                        */
+                    action: TBlueDotAction;
+            };
+            /**
+                * Emitted when the Blue Dot encounters an error.
+                */
+            error: GeolocationPositionError;
+            /**
+                * Emitted when the Blue Dot's following state changes.
+                */
+            'follow-change': {
+                    following: boolean;
+            };
+    };
+    export type TBlueDotState = 'hidden' | 'active' | 'inactive' | 'disabled';
+    export type TBlueDotAction = 'timeout' | 'error' | 'position-update' | 'enable' | 'disable';
+    export type TBlueDotPositionUpdateWithFloor = Omit<TBlueDotPositionUpdate, 'floorOrFloorId'> & {
+            floor?: Floor | 'device' | undefined;
+    };
+    export class BlueDot extends PubSub<TBlueDotEvents> {
+            #private;
+            state: TBlueDotState;
+            /**
+                * The direction the user is facing in degrees from north.
+                */
+            get heading(): GeolocationPosition['coords']['heading'] | undefined;
+            /**
+                * The accuracy of the current position in metres.
+                */
+            get accuracy(): GeolocationPosition['coords']['accuracy'] | undefined;
+            /**
+                * The coordinate of the current position.
+                */
+            get coordinate(): Coordinate | undefined;
+            /**
+                * The floor the Blue Dot is currently on. If undefined, the Blue Dot will appear on every floor.
+                */
+            get floor(): Floor | undefined;
+            /**
+                * @internal
+                */
+            constructor(core: RendererCore, geoJSONApi: GeoJsonApi);
+            /**
+                * Enable the Blue Dot. It will be hidden until a position is received either from the browser or by calling {@link BlueDot.update}.
+                * @param options - The options to setup the Blue Dot.
+                */
+            enable(options?: TBlueDotOptions): void;
+            /**
+                * Disable the Blue Dot. It will be hidden and no longer update.
+                */
+            disable(): void;
+            /**
+                * Enable or disable the devices's geolocation listener to automatically position the Blue Dot.
+                * If enabled, the device will request permission to access the user's precise location.
+                * @param watch - Whether to enable or disable the listener.
+                */
+            watchDevicePosition(watch: boolean): void;
+            /**
+                * Manually override some position properties of the Blue Dot.
+                * Accepts a full GeolocationPosition object or a partial {@link TBlueDotPositionUpdate} object.
+                * @example Manually set the accuracy and heading
+                * ```ts
+                * api.BlueDot.update({ accuracy: 10, heading: 90 });
+                * ```
+                * @example Reset accuracy and heading to device values
+                * ```ts
+                * api.BlueDot.update({ accuracy: 'device', heading: 'device' });
+                * ```
+                */
+            update(position: GeolocationPositionExtended | TBlueDotPositionUpdate | undefined): void;
+    }
+    type TStateTransitions = {
+            [Action in TBlueDotAction]?: TBlueDotState;
+    };
+    type TStateMachine = {
+            [State in TBlueDotState]: {
+                    actions: TStateTransitions;
+            };
+    };
+    export const stateMachine: TStateMachine;
+    export type GeolocationPositionExtended = GeolocationPosition & {
+            coords: GeolocationPosition['coords'] & {
+                    readonly floorLevel?: number;
+            };
+    };
+    export {};
+}
+
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects' {
     export { Label } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/label';
     export { Marker } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/marker';
@@ -2219,25 +2398,30 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
                 */
             createMarkers?: {
                     /**
-                        * Controls whether a marker is created for the departure point.
+                        * Controls whether a marker is created for the departure point and allows a custom marker to be created.
                         * @default true
                         */
-                    departure?: boolean;
+                    departure?: boolean | ((instruction: TDirectionInstruction) => Marker);
                     /**
-                        * Controls whether a marker is created for the destination point.
+                        * Controls whether a marker is created for the destination point and allows a custom marker to be created.
                         * @default true
                         */
-                    destination?: boolean;
+                    destination?: boolean | ((instruction: TDirectionInstruction) => Marker);
                     /**
-                        * Controls whether markers are created for connection points.
+                        * Controls whether markers are created for connection points and allows a custom marker to be created.
                         * @default true
                         */
-                    connection?: boolean;
+                    connection?: boolean | ((instruction: TDirectionInstruction) => Marker);
             };
             /**
                 * Options for the path.
                 */
             pathOptions?: {
+                    /**
+                        * duration in milliseconds for the path to be drawn
+                        * @default
+                        */
+                    drawDuration: number;
                     /**
                         * The color of the path.
                         * @default '#40A9FF'
@@ -2724,6 +2908,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/camera-tr
     }
 }
 
+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/map-data-objects/node' {
     import type { NodeCollection } from '@mappedin/mvf';
     import Coordinate from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/coordinate';
@@ -3892,8 +4081,9 @@ 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';
+    import type { LocalePackUrls } from '@packages/internal/mvf-utils';
+    import type { LanguagePackHydrationItem } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { EnvControl } from '@packages/internal/mvf-utils/mvf-utils';
     /**
       * Places are the main objects that can be searched for.
       */
@@ -3915,6 +4105,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types' {
         };
     };
     export type TMapDataInternalOptions = {
+        env?: EnvControl;
         enterprise?: boolean;
         outdoorViewToken?: string;
         localePacksUrls?: LocalePackUrls;
@@ -3931,11 +4122,13 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     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, 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 type { InsetPadding, InsetPaddingOption, Shading, PaintStyle, LineStyle, WatermarkOptions } from '@mappedin/mappedin-js/geojson/src';
     import { enableTestMode } from '@mappedin/mappedin-js/geojson/src';
     export type { PubSub } from '@packages/internal/common/pubsub';
     import { MappedinMapLibreOverlay } from '@mappedin/mappedin-js/mappedin-js/src/maplibre-overlay';
     import type { LanguagePackHydrationItem } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import { type Environment } from '@packages/internal/mvf-utils/mvf-utils';
+    import type { TBlueDotEvents, TBlueDotAction, TBlueDotState } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     export { setLoggerLevel, E_SDK_LOG_LEVEL } from '@packages/internal/common/Mappedin.Logger';
     /**
         * Represents all the available antialiasing options.
@@ -4061,6 +4254,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
                     token?: string;
                     /**
                         * A url to a style specification conforming to the [Maplibre Style Spec](https://maplibre.org/maplibre-style-spec/).
+                        * Use the {@link Environment | `environment`} setting to switch environments.
                         */
                     style?: string;
                     /**
@@ -4248,7 +4442,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     export const show3dMapGeojson: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
     export const show3dMap: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
     export { parseMVF, unzipMVF, enableTestMode };
-    export type { MapView, MapData, MappedinMapLibreOverlay, TEvents, TEventPayload, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, };
+    export type { MapView, MapData, MappedinMapLibreOverlay, TBlueDotEvents, TBlueDotAction, TBlueDotState, TEvents, TEventPayload, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, };
     export type * from 'geojson';
     export type { TUpdateState, TLabelState, TGeometryState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, TBlueDotPositionUpdate, } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export { WALLS, DOORS } from '@mappedin/mappedin-js/mappedin-js/src/types';
@@ -4261,89 +4455,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     export type { Analytics, TAnalyticsUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/analytics';
 }
 
-declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot' {
-    import type { RendererCore } from '@mappedin/core-sdk';
-    import { PubSub } from '@packages/internal/common';
-    import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
-    import type { TBlueDotOptions, TBlueDotPositionUpdate } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    import { Coordinate, type Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    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;
-            state: TBlueDotState;
-            /**
-                * The direction the user is facing in degrees from north.
-                */
-            get heading(): GeolocationPosition['coords']['heading'] | undefined;
-            /**
-                * The accuracy of the current position in metres.
-                */
-            get accuracy(): GeolocationPosition['coords']['accuracy'] | undefined;
-            /**
-                * The coordinate of the current position.
-                */
-            get coordinate(): Coordinate | undefined;
-            /**
-                * The floor the Blue Dot is currently on. If undefined, the Blue Dot will appear on every floor.
-                */
-            get floor(): Floor | undefined;
-            /**
-                * @internal
-                */
-            constructor(core: RendererCore, geoJSONApi: GeoJsonApi);
-            /**
-                * Enable the Blue Dot. It will be hidden until a position is received either from the browser or by calling {@link BlueDot.update}.
-                * @param options - The options to setup the Blue Dot.
-                */
-            enable(options?: TBlueDotOptions): void;
-            /**
-                * Disable the Blue Dot. It will be hidden and no longer update.
-                */
-            disable(): void;
-            /**
-                * Enable or disable the devices's geolocation listener to automatically position the Blue Dot.
-                * If enabled, the device will request permission to access the user's precise location.
-                * @param watch - Whether to enable or disable the listener.
-                */
-            watchDevicePosition(watch: boolean): void;
-            /**
-                * Manually override some position properties of the Blue Dot.
-                * Accepts a full GeolocationPosition object or a partial {@link TBlueDotPositionUpdate} object.
-                * @example Manually set the accuracy and heading
-                * ```ts
-                * api.BlueDot.update({ accuracy: 10, heading: 90 });
-                * ```
-                * @example Reset accuracy and heading to device values
-                * ```ts
-                * api.BlueDot.update({ accuracy: 'device', heading: 'device' });
-                * ```
-                */
-            update(position: GeolocationPositionExtended | TBlueDotPositionUpdate | undefined): void;
-    }
-    type TStateTransitions = {
-            [Action in TBlueDotAction]?: TBlueDotState;
-    };
-    type TStateMachine = {
-            [State in TBlueDotState]: {
-                    actions: TStateTransitions;
-            };
-    };
-    export const stateMachine: TStateMachine;
-    export type GeolocationPositionExtended = GeolocationPosition & {
-            coords: GeolocationPosition['coords'] & {
-                    readonly floorLevel?: number;
-            };
-    };
-    export {};
-}
-
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes' {
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
     import { Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
@@ -4397,6 +4508,26 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes' {
     export {};
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/inspector/inspector' {
+    import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
+    import type { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
+    import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
+    export class Inspector {
+        storeStateToLocalStorageEnabled: boolean;
+        constructor(mv: MapView, api: GeoJsonApi);
+        setMapData(data: MapData): void;
+        enable(options?: InspectorOption): Promise<void>;
+        get enabled(): boolean;
+    }
+    export type InspectorState = {
+        camera: {
+            focusOnClick: boolean;
+            padding: [number, number, number, number];
+        };
+    };
+    export type InspectorOption = Partial<InspectorState>;
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
     import './marker.scss';
     import { Vector2 } from 'three';
@@ -4454,22 +4585,23 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
             rank: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["low", "medium", "high", "always-visible"]>, z.ZodNumber]>>;
             interactive: z.ZodOptional<z.ZodBoolean>;
             id: z.ZodOptional<z.ZodString>;
-            anchor: z.ZodOptional<z.ZodEnum<["top", "bottom", "left", "right", "center"]>>;
+            anchor: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "bottom", "left", "right", "center", "top-left", "top-right", "bottom-left", "bottom-right"]>, z.ZodArray<z.ZodEnum<["top", "bottom", "left", "right", "center", "top-left", "top-right", "bottom-left", "bottom-right"]>, "many">]>>;
             dynamicResize: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
             interactive?: boolean | undefined;
             id?: string | undefined;
-            anchor?: "center" | "left" | "right" | "bottom" | "top" | undefined;
+            anchor?: "center" | "left" | "right" | "bottom" | "top" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | ("center" | "left" | "right" | "bottom" | "top" | "top-left" | "top-right" | "bottom-left" | "bottom-right")[] | undefined;
             rank?: number | "high" | "low" | "medium" | "always-visible" | undefined;
             dynamicResize?: boolean | undefined;
     }, {
             interactive?: boolean | undefined;
             id?: string | undefined;
-            anchor?: "center" | "left" | "right" | "bottom" | "top" | undefined;
+            anchor?: "center" | "left" | "right" | "bottom" | "top" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | ("center" | "left" | "right" | "bottom" | "top" | "top-left" | "top-right" | "bottom-left" | "bottom-right")[] | undefined;
             rank?: number | "high" | "low" | "medium" | "always-visible" | undefined;
             dynamicResize?: boolean | undefined;
     }>;
     export function validateMarker(coordinate: Position, contentHTML: string, options: AddMarkerOptions): void;
+    export type MarkerAnchor = 'top' | 'bottom' | 'left' | 'right' | 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
     /**
         * Options for creating a new Marker
         */
@@ -4491,9 +4623,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
                 */
             id?: string;
             /**
-                * Anchor point for the marker. This will determine the position of the marker relative to the position.
+                * Anchor point for the marker. This will determine the position of the marker relative to the position. A list will place the marker in the first empty placement.
                 */
-            anchor?: 'top' | 'bottom' | 'left' | 'right' | 'center';
+            anchor?: MarkerAnchor | MarkerAnchor[];
             /**
                 * Dynamic resize of the marker. If set to true, the marker will resize based on the content.
                 */
@@ -4505,7 +4637,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
             static testId: number;
             rank: number;
             initialRank: number;
-            options: AddMarkerOptions;
+            activeAnchor: MarkerAnchor;
+            options: Required<AddMarkerOptions>;
             projection: Vector2;
             enabled: boolean;
             activeStrategyIndex: number;
@@ -4531,9 +4664,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
             visible: boolean;
             animation: Animation | null;
             currentStrategyIndex: number;
-            onStrategySelected: (strategyIndex: any, force?: boolean) => void;
+            onStrategySelected: (strategyIndex: number, force?: boolean) => void;
             get strategies(): {
-                    name: string;
+                    name: MarkerAnchor;
                     getBoundingBox: () => number[];
             }[];
             toJSON(): {
@@ -4559,6 +4692,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
     import type { PathMaterial, PatMeshContainer } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
     import type { FeatureCollection, Point } from 'geojson';
     import type { GroupContainerState } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
+    import { z } from 'zod';
     export type PathProperties = {
             /**
                 * The parentId of the point. The point will be anchored to the altitude of this parent group container.
@@ -4658,6 +4792,70 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
                 */
             animateArrowsOnPath?: boolean;
     };
+    export const addPathOptionsSchema: z.ZodObject<{
+            interactive: z.ZodOptional<z.ZodBoolean>;
+            id: z.ZodOptional<z.ZodString>;
+            nearRadius: z.ZodOptional<z.ZodNumber>;
+            farRadius: z.ZodOptional<z.ZodNumber>;
+            accentColor: z.ZodOptional<z.ZodString>;
+            displayArrowsOnPath: z.ZodOptional<z.ZodBoolean>;
+            animateArrowsOnPath: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+            interactive?: boolean | undefined;
+            id?: string | undefined;
+            accentColor?: string | undefined;
+            displayArrowsOnPath?: boolean | undefined;
+            animateArrowsOnPath?: boolean | undefined;
+            nearRadius?: number | undefined;
+            farRadius?: number | undefined;
+    }, {
+            interactive?: boolean | undefined;
+            id?: string | undefined;
+            accentColor?: string | undefined;
+            displayArrowsOnPath?: boolean | undefined;
+            animateArrowsOnPath?: boolean | undefined;
+            nearRadius?: number | undefined;
+            farRadius?: number | undefined;
+    }>;
+    export const featureSchema: z.ZodObject<{
+            type: z.ZodEnum<["Feature"]>;
+            geometry: z.ZodObject<{
+                    type: z.ZodEnum<["Point"]>;
+                    coordinates: z.ZodArray<z.ZodNumber, "many">;
+            }, "strip", z.ZodTypeAny, {
+                    type: "Point";
+                    coordinates: number[];
+            }, {
+                    type: "Point";
+                    coordinates: number[];
+            }>;
+            properties: z.ZodObject<{
+                    parentId: z.ZodOptional<z.ZodAny>;
+            }, "strip", z.ZodTypeAny, {
+                    parentId?: any;
+            }, {
+                    parentId?: any;
+            }>;
+    }, "strip", z.ZodTypeAny, {
+            type: "Feature";
+            geometry: {
+                    type: "Point";
+                    coordinates: number[];
+            };
+            properties: {
+                    parentId?: any;
+            };
+    }, {
+            type: "Feature";
+            geometry: {
+                    type: "Point";
+                    coordinates: number[];
+            };
+            properties: {
+                    parentId?: any;
+            };
+    }>;
+    export function validatePath(geometry: FeatureCollection<Point, PathProperties>, options: AddPathOptions): void;
     export class PathComponent {
             #private;
             readonly type = "path";
@@ -5314,6 +5512,10 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/geometry-group' {
                 * The top texture URL of the geometry
                 */
             topTexture?: string;
+            /**
+                * altitude of the geometry group
+                */
+            altitude?: number;
     };
     export type ChildUpdatable<T> = T extends LineStyle ? Partial<Pick<LineStyle, 'color' | 'opacity' | 'visible'>> : Partial<Pick<PaintStyle, 'color' | 'opacity' | 'visible'>>;
     export class GeometryGroupObject3D extends Object3D {
@@ -5339,6 +5541,8 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/geometry-group' {
                 * We use this logic a lot for getting the material of the group. since group does not have material and batched mesh does
                 */
             getfirstChildEntityId(): string | number | undefined;
+            setAltitude(altitude: number): void;
+            get altitude(): number;
     }
 }
 
@@ -5488,6 +5692,22 @@ declare module '@mappedin/mappedin-js/geojson/src/types' {
             left: number;
             bottom: number;
             right: number;
+            /**
+                * The type of padding to use. If 'portion', the padding will be a portion of the canvas size. If 'pixel', the padding will be in pixels.
+                * @defaultValue 'pixel'
+                */
+            type: 'pixel' | 'portion';
+    };
+    /**
+        * An option for setting the inset padding of the camera.
+        * @interface
+        */
+    export type InsetPaddingOption = Omit<InsetPadding, 'type'> & {
+            /**
+                * The type of padding to use. If 'portion', the padding will be a portion of the canvas size. If 'pixel', the padding will be in pixels.
+                * @defaultValue 'pixel'
+                */
+            type?: InsetPadding['type'];
     };
     export * from '@mappedin/mappedin-js/geojson/src/types/constants';
     /**
@@ -5772,19 +5992,39 @@ declare module '@mappedin/mappedin-js/geojson/src/components/custom' {
     import { Geometry3DObject3D } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
     import type { GroupContainerState } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
     /**
-        * State representing a Custom Geometry
+        * Represents the state of a custom shape.
         */
     export type ShapeState = {
+            /**
+                * The unique identifier of the shape.
+                */
             readonly id: string;
+            /**
+                * The type of the shape, which is always 'custom-geometry'.
+                */
             readonly type: 'custom-geometry';
             /**
-                * The position of the geometry in [lon, lat]
+                * The position of the geometry in [longitude, latitude].
                 */
             readonly position: Position;
+            /**
+                * Whether the geometry is visible.
+                */
             visible?: boolean;
+            /**
+                * The altitude of the geometry, in meters.
+                */
             altitude?: number;
             /**
-                * The parent container of the geometry
+                * The color of the shape.
+                */
+            color: string;
+            /**
+                * The opacity of the shape.
+                */
+            opacity: number;
+            /**
+                * The parent container of the geometry.
                 */
             readonly parent: EntityId<GroupContainerState> | string | number;
     };
@@ -6222,7 +6462,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             /**
                 * Add a Path along a set of GeoJSON coordinates that can be animated.
                 */
-            addPath(geometry: FeatureCollection<Point, PathProperties>, options?: AddPathOptions, parent?: EntityId<GroupContainerState> | string | null): EntityId<PathState>;
+            addPath(geometry: FeatureCollection<Point, PathProperties>, options?: AddPathOptions, parent?: EntityId<GroupContainerState> | string | null): EntityId<PathState> | undefined;
             /**
                 * Updates the watermark on the map.
                 *
@@ -6413,13 +6653,13 @@ declare module '@mappedin/mappedin-js/geojson/src/camera' {
     import type { RendererCore } from '@mappedin/mappedin-js/geojson/src';
     import type { Position as GeoJSONPosition } from 'geojson';
     import { type InsetPadding, type Position } from '@mappedin/mappedin-js/geojson/src/types';
-    import type { RendererState, Systems } from '@mappedin/mappedin-js/geojson/src/renderer';
+    import type { InsetPaddingOption, RendererState, Systems } from '@mappedin/mappedin-js/geojson/src/renderer';
     export type EasingCurve = 'ease-in' | 'ease-out' | 'ease-in-out' | 'linear';
     export type FocusOnOptions = {
             bearing?: number;
             pitch?: number;
             duration?: number;
-            padding?: InsetPadding;
+            padding?: InsetPaddingOption;
             minZoomLevel?: number;
             maxZoomLevel?: number;
             easing?: EasingCurve;
@@ -6510,7 +6750,7 @@ declare module '@mappedin/mappedin-js/geojson/src/camera' {
                 */
             setMaxPitch(pitch: number): void;
             /**
-                * The camera's current bearing in degrees from north.
+                * The camera's current clockwise rotation in degrees from north.
                 */
             get bearing(): number;
             /**
@@ -6539,10 +6779,9 @@ declare module '@mappedin/mappedin-js/geojson/src/camera' {
                 */
             get insetsPadding(): InsetPadding;
             /**
-                *
                 * @param padding The padding around the edges of the map when focusing on a set of coordinates (in screen pixels).
                 */
-            setInsetPadding(padding?: InsetPadding): void;
+            setInsetPadding(padding: InsetPadding): void;
             animateTo(options: AnimateToOptions): Promise<void>;
             /**
                 *  Focuses the camera on a set of coordinates, with optional animation
@@ -6894,6 +7133,83 @@ declare module '@mappedin/mappedin-js/geojson/src/maplibre-overlay' {
     }
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
+    import type { Position, RendererCore, WatermarkOptions } from '@mappedin/core-sdk';
+    import { type TShow3DMapOptions } from '@mappedin/mappedin-js/mappedin-js/src';
+    import { WALLS, DOORS } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
+    import { Coordinate, MapObject, Space, Floor, type MapDataInternal, Door } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
+    import { Label, Marker, type Model, type Image, Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    import { Navigation } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
+    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 { 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';
+    import { Markers } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers';
+    import { Images } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/images';
+    import { Models } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/models';
+    import { Paths } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/paths';
+    import { BlueDot } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
+    import type { TFloorChangeReason } from '@mappedin/mappedin-js/mappedin-js/src/events';
+    import { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
+    import { Style } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/style';
+    import Outdoor from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/outdoor';
+    import type { TShowStackOptions } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
+    export class GeoJsonApi {
+        core: RendererCore;
+        outdoors: GeojsonApiMapObject;
+        mapObjects: GeojsonApiMapObject[];
+        id: string;
+        mapDataExternal: {
+            [key in string]: MapData;
+        };
+        currentMap?: GeojsonApiMapObject;
+        hiddenOutdoorGeometries: [Position, layer: string[]][];
+        mapView: MapView;
+        Camera: Camera;
+        Labels: Labels;
+        Markers: Markers;
+        Models: Models;
+        Paths: Paths;
+        Exporter: Exporter;
+        Navigation: Navigation;
+        Outdoor: Outdoor;
+        BlueDot: BlueDot;
+        Shapes: Shapes;
+        Style: Style;
+        Images: Images;
+        constructor(rendererCore: RendererCore, mapView: MapView);
+        updateState<T extends Space | MapObject | Label | Shape | Marker | Door | WALLS | DOORS | (string & NonNullable<unknown>)>(target: T, state: TUpdateState<T>): void;
+        update: () => void;
+        getMapDataInternal(): MapDataInternal | undefined;
+        getMapData(): MapData | undefined;
+        expand(opts?: {
+            excludeFloors: Floor[];
+        }): Promise<void> | undefined;
+        collapse(): Promise<void> | undefined;
+        showStack(opts?: TShowStackOptions): Promise<void> | undefined;
+        addMap(mapData: MapData, options?: TShow3DMapOptions): Promise<MapData>;
+        setFloor(floor: Floor | string, reason?: TFloorChangeReason): Promise<void> | undefined;
+        updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
+        get currentFloor(): Floor;
+        getState<T extends Space | MapObject | Label | Marker | Shape | Model | Image | string>(target: T): TGetState<T> | undefined;
+        setHoverColor(c: string): void;
+        getHoverColor(): string | 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;
+        auto(): void;
+        /**
+          * @internal
+          */
+        get __core(): RendererCore;
+        clear(): void;
+        destroy(): void;
+    }
+}
+
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/label' {
     /**
         * Class representing a label on the {@link MapView}.
@@ -7180,88 +7496,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object' {
     }
 }
 
-declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
-    import type { Position, RendererCore, WatermarkOptions } from '@mappedin/core-sdk';
-    import { type TShow3DMapOptions } from '@mappedin/mappedin-js/mappedin-js/src';
-    import { WALLS, DOORS } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
-    import { Coordinate, MapObject, Space, Floor, type MapDataInternal, Door } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    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 { TGetState, TUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    import { Camera } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera';
-    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';
-    import { Markers } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers';
-    import { Images } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/images';
-    import { Models } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/models';
-    import { Paths } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/paths';
-    import { BlueDot } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
-    import type { TFloorChangeReason } from '@mappedin/mappedin-js/mappedin-js/src/events';
-    import { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
-    import { Style } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/style';
-    import Outdoor from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/outdoor';
-    import type { TShowStackOptions } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
-    export class GeoJsonApi {
-        core: RendererCore;
-        outdoors: GeojsonApiMapObject;
-        mapObjects: GeojsonApiMapObject[];
-        id: string;
-        mapDataExternal: {
-            [key in string]: MapData;
-        };
-        currentMap?: GeojsonApiMapObject;
-        hiddenOutdoorGeometries: [Position, layer: string[]][];
-        mapView: MapView;
-        Camera: Camera;
-        Labels: Labels;
-        Markers: Markers;
-        Models: Models;
-        Paths: Paths;
-        Exporter: Exporter;
-        Navigation: Navigation;
-        Outdoor: Outdoor;
-        BlueDot: BlueDot;
-        Shapes: Shapes;
-        Style: Style;
-        Images: Images;
-        constructor(rendererCore: RendererCore, mapView: MapView);
-        updateState<T extends Space | MapObject | Label | Marker | Door | WALLS | DOORS | (string & NonNullable<unknown>)>(target: T, state: TUpdateState<T>): void;
-        update: () => void;
-        getMapDataInternal(): MapDataInternal | undefined;
-        getMapData(): MapData | undefined;
-        expand(opts?: {
-            excludeFloors: Floor[];
-        }): Promise<void> | undefined;
-        collapse(): Promise<void> | undefined;
-        showStack(opts?: TShowStackOptions): Promise<void> | undefined;
-        addMap(mapData: MapData, options?: TShow3DMapOptions): Promise<MapData>;
-        setFloor(floor: Floor | string, reason?: TFloorChangeReason): Promise<void> | undefined;
-        updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
-        get currentFloor(): Floor;
-        getState<T extends Space | MapObject | Label | Marker | Model | Image | string>(target: T): TGetState<T> | undefined;
-        setHoverColor(c: string): void;
-        getHoverColor(): string | 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;
-        auto(): void;
-        /**
-          * @internal
-          */
-        get __core(): RendererCore;
-        clear(): void;
-        destroy(): void;
-    }
-}
-
-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';
@@ -7342,7 +7576,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera' {
                 */
             setMaxPitch: (maxPitch: number) => void;
             /**
-                * The current bearing of the camera in degrees.
+                * The current bearing of the camera in degrees clockwise from North. 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.
                 */
             get bearing(): number;
             /**
@@ -7783,6 +8017,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/search/internal' {
     import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
     import { z } from 'zod';
     export class InternalSearch {
+            #private;
             constructor(mapData: MapData);
             /**
                 * Populates the search indexes with the map data.
@@ -8275,7 +8510,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/analytics/customer' {
             /** Flag to enable sending of events. */
             sendEvents: boolean;
     } & AnalyticsAuth;
-    type AnalyticsOptions = Partial<Omit<AnalyticState, 'version' | 'analyticsBaseUrl' | 'geolocationMode' | 'deviceId' | 'userPosition'>>;
+    type AnalyticsOptions = Partial<Omit<AnalyticState, 'version' | 'analyticsBaseUrl' | 'geolocationMode' | 'userPosition'>>;
     export type AnalyticsUpdateOptions = Omit<AnalyticsOptions, keyof AnalyticsAuth> & ((Required<Pick<AnalyticsAuth, 'key' | 'secret'>> & Partial<Pick<AnalyticsAuth, 'accessToken'>>) | (Required<Pick<AnalyticsAuth, 'accessToken'>> & Partial<Pick<AnalyticsAuth, 'key' | 'secret'>>));
     /**
         * Options for updating the current state of analytics.
@@ -9533,7 +9768,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/utils' {
     import type { LabelState, MarkerState, GeometryState, CollisionRankingTier, LineStyle, PaintStyle } from '@mappedin/core-sdk';
     import { type TGeometryState, type TLabelState, type TDirectionInstructionAction, type TShow3DMapOptions, type Label, type Marker, type Model } from '@mappedin/mappedin-js/mappedin-js/src';
     import type { TDoorsState, TMarkerState, TWallsState } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    import type { Image } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    import type { Image, Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
     import type TWEEN from '@tweenjs/tween.js';
     export function convertCoordinateToPosition(coord: Coordinate): Position;
@@ -9562,7 +9797,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/utils' {
     };
     export function groupGeometryByStyle(features: Feature<LineString | Polygon | Point, SpaceProperties | ObstructionProperties>[], styleMap: AggregatedStyleMap): Map<WithId<PolygonStyle> | WithId<LineStringStyle> | WithId<PointStyle>, Feature<Point | LineString | Polygon, WithPolygonImage<SpaceProperties> | WithPolygonImage<ObstructionProperties>>[]>;
     export function translateToCoreStyle(style: PolygonStyle | LineStringStyle, userOptions?: TShow3DMapOptions): PaintStyle | LineStyle;
-    export const getTargetID: <T extends Space | MapObject | Label | Marker | Model | Image | string>(target: T, api: GeoJsonApi) => string | undefined;
+    export const getTargetID: <T extends Space | Shape | MapObject | Label | Marker | Model | Image | string>(target: T, api: GeoJsonApi) => string | undefined;
     export function tweenToPromise(tween: TWEEN.Tween): Promise<void>;
 }
 
@@ -9767,7 +10002,7 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
     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';
-    import type { RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
+    import type { InsetPadding, RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
     type CameraEventName = (typeof CAMERA_CONSTANTS.EVENTS)[number];
     type SpecificCameraEvents = {
             'multi-start': {
@@ -10115,7 +10350,7 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                 */
             getZoomScaledMax: () => number;
             /**
-                * Sets the rotation to a specific orientation, in radians. Mostly useful to orient the map a certain way for a physical directory.
+                * Sets the rotation to a specific orientation, clockwise in radians. Mostly useful to orient the map a certain way for a physical directory.
                 *
                 * @param radians {Number} Absolute rotation to set the camera to, in radians. 0 in the starting point.
                 * @param silent {Boolean} Whether to avoid emitting events
@@ -10142,12 +10377,6 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                 * Current camera zoom in mercator zoom level units.
                 */
             getZoomLevel: () => number;
-            /**
-                * Rotates the camera a set number of radians relative to the current rotation. Useful for an idle rotation animation.
-                *
-                * @param radians {Number} Number of radians to rotate the camera.
-                */
-            rotate: (radians: number) => void;
             /**
                 * Sets the tilt to a specific level, in radians. 0 is top down. Bounded by minTilt and maxTilt.
                 *
@@ -10202,18 +10431,27 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                 * @param zoomLevel{number} The mercator zoom level
                 */
             convertZoomLevelToAltitude: (zoomLevel: number) => number;
-            getCameraFrameForPoints: (pointCloud: any, horizontalFovFactor: any, verticalFovFactor: any, padding: any, { canvasWidth, canvasHeight }: {
-                    canvasWidth: any;
-                    canvasHeight: any;
-            }, minZoom?: number, maxZoom?: number) => {
-                    position: Vector3;
-                    zoom: number;
-            };
+            static CAMERA_FRAME_PADDING_SIDES: readonly ["top", "bottom", "left", "right"];
             debugContainer: Object3D<import("three").Object3DEventMap>;
-            focusOn(pointCloud: Vector3[], { insetsPadding }: any, options?: CameraFocusOnOptions): void;
+            focusOn(pointCloud: Vector3[], options: CameraFocusOnOptions & {
+                    padding: InsetPadding;
+            }): void;
             resize(canvasWidth: number, canvasHeight: number): void;
     }
     export { CameraSystem };
+    export function getCameraFrameForPoints(pointCloud: Vector3[], { canvasWidth, orbit, paddingOption, canvasHeight, minZoom, maxZoom, camera, position, }: {
+            paddingOption: InsetPadding;
+            canvasWidth: number;
+            canvasHeight: number;
+            minZoom: number;
+            maxZoom: number;
+            orbit: Object3D;
+            camera: PerspectiveCamera;
+            position: Vector3;
+    }): {
+            position: Vector3;
+            zoom: number;
+    };
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/systems/camera/types' {