@mappedin/react-sdk 6.0.1-beta.19 → 6.0.1-beta.20

package/lib/esm/index.d.ts

@@ -10,6 +10,7 @@
 //   ../react/@mappedin/mappedin-js
 //   ../react/@packages/internal/common
 //   ../react/@mappedin/core-sdk
+//   ../react/@packages/internal/outdoor-context-v4
 //   ../react/@packages/internal/geojson-navigator
 //   ../react/@mappedin/mvf/dist/locale
 //   ../react/three
@@ -18,7 +19,6 @@
 //   ../react/@tweenjs/tween.js
 //   ../react/@turf/turf
 //   ../react/@packages/internal/quad-tree
-//   ../react/@packages/internal/outdoor-context-v4
 //   ../react/minisearch
 //   ../react/three/addons/loaders/GLTFLoader.js
 //   ../react/@mapbox/point-geometry
@@ -65,6 +65,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src' {
     import type { InsetPadding, InsetPaddingOption, Shading, PaintStyle, LineStyle, WatermarkOptions } from '@mappedin/react-sdk/geojson/src';
     import { enableTestMode } from '@mappedin/react-sdk/geojson/src';
     export type { PubSub } from '@packages/internal/common/pubsub';
+    import type { TMappedinMapLibreOverlayEvents } from '@mappedin/react-sdk/mappedin-js/src/maplibre-overlay';
     import { MappedinMapLibreOverlay } from '@mappedin/react-sdk/mappedin-js/src/maplibre-overlay';
     import type { LanguagePackHydrationItem } from '@mappedin/react-sdk/mappedin-js/src/types';
     import { type Environment } from '@packages/internal/mvf-utils/mvf-utils';
@@ -376,14 +377,20 @@ declare module '@mappedin/react-sdk/mappedin-js/src' {
         */
     export const getMapDataEnterprise: (userOptions: TGetMapDataOptions) => Promise<MapData>;
     /**
-        * Create a MapLibre overlay with a Map to render it within existing MapLibre projects.
+        * Mappedin JS makes use of MapLibre to render the outdoor portion of the map. Mappedin JS exposes this layer through {@link MapView.OutoorMap} and can be used to add additional layers as described in the [Outdoor Map Guide](https://developer.mappedin.com/web-sdk/outdoor-map).
+        *
+        * It is also possible to utilize the opposite architecture, by adding a MapView to a MapLibre Map.
+        * This is accomplished by using {@link MappedinMapLibreOverlay} class. It allows a developer to easily add a Mappedin indoor map to an existing MapLibre based app.
+        *
+        * Refer to the [Mappedin MapLibre Overlay](https://developer.mappedin.com/web-sdk/mappedin-maplibre-overlay) for more information and interactive examples.
+    
         * @experimental
         */
     export const createMapLibreOverlay: (mapData: MapData, showMapOptions?: TShow3DMapOptions) => MappedinMapLibreOverlay;
     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, TBlueDotEvents, TBlueDotAction, TBlueDotState, GeolocationPositionExtended, TStackedMapsEvents, TExpandOptions, TStackedMapsState, TFollowMode, TFollowCameraOptions, TEvents, TEventPayload, TFloorChangeReason, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, OperationHours, SiblingGroup, LocationState, };
+    export type { MapView, MapData, MappedinMapLibreOverlay, TMappedinMapLibreOverlayEvents, TBlueDotEvents, TBlueDotAction, TBlueDotState, GeolocationPositionExtended, TStackedMapsEvents, TExpandOptions, TStackedMapsState, TFollowMode, TFollowCameraOptions, TEvents, TEventPayload, TFloorChangeReason, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, OperationHours, SiblingGroup, LocationState, };
     export type * from 'geojson';
     export type { TUpdateState, TUpdateStates, TLabelState, TGeometryState, TModelState, TShapeState, TDoorsState, TImageState, TWallsState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TFocusable, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TAddImageOptions, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, TBlueDotPositionUpdate, } from '@mappedin/react-sdk/mappedin-js/src/types';
     export { WALLS, DOORS } from '@mappedin/react-sdk/mappedin-js/src/types';
@@ -1118,7 +1125,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
     import Image from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/image';
     import FloorStack from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/floor-stack';
     import type { MapDataRecords } from '@mappedin/react-sdk/mappedin-js/src/utils/data-creation';
-    import type { AnnotationCollection, ParsedMVF, Connection as MVFConnection, EntranceCollection, NodeCollection, ObstructionCollection, SpaceCollection, FloorProperties as MVFFloor, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseCategory as MVFEnterpriseCategory, Language } from '@mappedin/mvf';
+    import type { AnnotationCollection, ParsedMVF, Connection as MVFConnection, EntranceCollection, NodeCollection, ObstructionCollection, SpaceCollection, FloorProperties as MVFFloor, FloorStack as MVFFloorStack, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseCategory as MVFEnterpriseCategory, Language } from '@mappedin/mvf';
     import { AnalyticsInternal } from '@mappedin/react-sdk/mappedin-js/src/analytics';
     import EnterpriseLocation from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location';
     import EnterpriseCategory from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/category';
@@ -1270,6 +1277,8 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             get nodes(): Node[];
             get locations(): EnterpriseLocation[];
             get categories(): EnterpriseCategory[];
+            get mvfFloors(): MVFFloor[];
+            get mvfFloorStacks(): MVFFloorStack[];
             /**
                 * Retrieves an object by its type and ID.
                 *
@@ -1299,12 +1308,18 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             getMVFFeatureById(type: 'space', id: string): SpaceCollection['features'][number] | undefined;
             getMVFFeatureById(type: 'node', id: string): NodeCollection['features'][number] | undefined;
             getMVFFeatureById(type: 'obstruction', id: string): ObstructionCollection['features'][number] | undefined;
-            getMVFFeatureById(type: 'map', id: string): MVFFloor | undefined;
+            getMVFFeatureById(type: 'floor', id: string): MVFFloor | undefined;
+            getMVFFeatureById(type: 'floor-stack', id: string): MVFFloorStack | undefined;
             getMVFFeatureById(type: 'connection', id: string): MVFConnection | undefined;
             getMVFFeatureById(type: 'entrance', id: string): EntranceCollection['features'][number] | undefined;
             getMVFFeatureById(type: 'annotation', id: string): AnnotationCollection['features'][number] | undefined;
             getMVFFeatureById(type: string, id: string): object | undefined;
             getMVFFeatureByNodeId(type: 'connection', id: string): MVFConnection | undefined;
+            /**
+                * Retrieves all MVF features of a given type. Safer than referencing the mvf's deprecated collections directly.
+                */
+            getMVFFeatureByType(type: 'floor-stack'): MVFFloorStack[];
+            getMVFFeatureByType(type: 'floor'): MVFFloor[];
             getPropTranslation(type: 'enterprise-location' | 'enterprise-category', prop: string, id: string, fallback: MVFEnterpriseLocation[keyof MVFEnterpriseLocation] | MVFEnterpriseCategory[keyof MVFEnterpriseCategory]): unknown;
             /**
                 * change the langauge of the data objects in mapdata
@@ -1341,13 +1356,20 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
     import type { Camera, Labels, Markers, Models, Paths, Exporter, Directions, Style, Outdoor, Images } from '@mappedin/react-sdk/mappedin-js/src/api-geojson';
     import type { BlueDot } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     import type MapData from '@mappedin/react-sdk/mappedin-js/src/map-data';
-    import type { Annotation, Coordinate, Door, Floor, MapObject, PointOfInterest, Space, Node, EnterpriseLocation } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { Annotation, Coordinate, Door, Floor, MapObject, PointOfInterest, Space, Node, EnterpriseLocation, FloorStack } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import type { DOORS, WALLS, TGetDirectionsOptions, TGetState, TNavigationTarget, TUpdateState, TUpdateStates } from '@mappedin/react-sdk/mappedin-js/src/types';
     import type { Label, Marker, Image, Shape } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { TEventPayload } from '@mappedin/react-sdk/mappedin-js/src/events';
     import type { Shapes } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/shapes';
     import type { StackedMaps, TCollapseOptions, TExpandOptions } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
     import type { InspectorOption } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/inspector/inspector';
+    /**
+        * The MapView class is the main class for rendering and interacting with the map.
+        *
+        * It provides a set of controls for manipulating the map's elements and state.
+        *
+        * For help getting started, refer to the [Getting Started Guide](https://developer.mappedin.com/web-sdk/getting-started).
+        */
     export class MapView extends PubSub<TEvents> {
             #private;
             /**
@@ -1415,9 +1437,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
                 *
                 * | target    | state          |
                 * |-----------|----------------|
+                * | {@link Door}      | {@link TDoorsState}    |
                 * | {@link Label}     | {@link TLabelState}    |
                 * | {@link MapObject} | {@link TGeometryState} |
+                * | {@link Marker}    | {@link TMarkerState}   |
                 * | {@link Space}     | {@link TGeometryState} |
+                * | {@link Shape}     | {@link TShapeState}    |
+                * | {@link DOORS}     | {@link TDoorsState}     |
+                * | {@link WALLS}     | {@link TWallsState}     |
                 *
                 * @param target The target to update.
                 * @param state The new state to apply to the target.
@@ -1428,6 +1455,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
             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;
+            /**
+                * Retrieves the map data for the current map.
+                * @returns The {@link MapData} for the current map.
+                */
             getMapData(): {
                     [x: string]: MapData;
             };
@@ -1443,12 +1474,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
             /**
                 * @experimental
                 */
-            expand(opts?: TExpandOptions): Promise<void> | undefined;
+            expand(opts?: TExpandOptions): Promise<void>;
             /**
                 * @experimental
                 * @hidden
                 */
-            collapse(opts?: TCollapseOptions): Promise<void> | undefined;
+            collapse(opts?: TCollapseOptions): Promise<void>;
             /**
                 * Adds a map to the MapView.
                 * @param mapData The map data to add.
@@ -1461,6 +1492,15 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
                 * @param floor The floor or floor ID to set.
                 */
             setFloor(floor: Floor | string): void;
+            /**
+                * Sets the current floor stack ({@link FloorStack}) of the map. The default floor of the stack will be set as the current floor.
+                * @param floorStack The floor stack or floor stack ID to set.
+                */
+            setFloorStack(floorStack: FloorStack | string): void;
+            /**
+                * The current floor stack ({@link FloorStack}) of the map.
+                */
+            get currentFloorStack(): FloorStack;
             /**
                 * The current floor ({@link Floor}) of the map.
                 */
@@ -1588,7 +1628,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
             destroy(): void;
             /**
                 * @experimental
-                * Enable debug interface
+                * Enable debug interface. Learn more about the debug interface in the [Debug Mode Guide](https://developer.mappedin.com/web-sdk/getting-started#debug-mode).
                 */
             enableDebug(opitons?: InspectorOption): Promise<void>;
     }
@@ -1635,10 +1675,11 @@ declare module '@mappedin/react-sdk/geojson/src' {
 declare module '@mappedin/react-sdk/mappedin-js/src/maplibre-overlay' {
     import { MapView } from '@mappedin/react-sdk/mappedin-js/src/map-view';
     import type MapData from '@mappedin/react-sdk/mappedin-js/src/map-data';
-    import type { TShow3DMapOptions } from '@mappedin/react-sdk/mappedin-js/src';
-    import { MapLibreOverlay } from '@mappedin/react-sdk/geojson/src/maplibre-overlay';
+    import { type TShow3DMapOptions } from '@mappedin/react-sdk/mappedin-js/src';
     import type { Position } from '@mappedin/core-sdk';
-    export class MappedinMapLibreOverlay extends MapLibreOverlay<{
+    import type { IControl } from '@packages/internal/outdoor-context-v4';
+    import { PubSub } from '@packages/internal/common';
+    export type TMappedinMapLibreOverlayEvents = {
             /**
                 * Event emitted when the MappedinMap is loaded
                 */
@@ -1652,12 +1693,52 @@ declare module '@mappedin/react-sdk/mappedin-js/src/maplibre-overlay' {
                         */
                     mapData: MapData;
             };
-    }> {
+    };
+    /**
+        * Mappedin JS makes use of MapLibre to render the outdoor portion of the map. Mappedin JSexposes this layer through {@link MapView.OutoorMap} and can be used to add additional layers as described in the [Outdoor Map Guide](https://developer.mappedin.com/web-sdk/outdoor-map).
+        *
+        * It is also possible to utilize the opposite architecture, by adding a MapView to a MapLibre Map.
+        * This is accomplished by using this MappedinMapLibreOverlay class. It allows a developer to easily add a Mappedin indoor map to an existing MapLibre based app.
+        *
+        * Use {@link createMapLibreOverlay} to instantiate this class.
+        *
+        * Refer to the [Mappedin MapLibre Overlay](https://developer.mappedin.com/web-sdk/mappedin-maplibre-overlay) for more information and interactive examples.
+        */
+    export class MappedinMapLibreOverlay extends PubSub<TMappedinMapLibreOverlayEvents> implements IControl {
             #private;
             static instance: MappedinMapLibreOverlay;
+            /** @internal */
             constructor(origin: Position | undefined, mapData: MapData, options?: TShow3DMapOptions);
+            /** @internal */
             onAdd(map: any): HTMLDivElement;
+            /** @internal */
             onRemove(): void;
+            /**
+                * Subscribe to an event.
+                * @example
+                * ```ts
+                * const handler = ({ mapView, mapData }) => {
+                *  console.log('MapView loaded');
+                * };
+                * overlay.on('loaded', handler);
+                * ```
+                */
+            on: <EventName extends keyof TMappedinMapLibreOverlayEvents>(eventName: EventName, fn: (payload: TMappedinMapLibreOverlayEvents[EventName] extends {
+                    data: null;
+            } ? TMappedinMapLibreOverlayEvents[EventName]["data"] : TMappedinMapLibreOverlayEvents[EventName]) => void) => void;
+            /**
+                * Unsubscribe from an event.
+                * @example
+                * ```ts
+                * const handler = ({ mapView, mapData }) => {
+                *  console.log('MapView loaded');
+                * };
+                * overlay.off('loaded', handler);
+                * ```
+                */
+            off: <EventName extends keyof TMappedinMapLibreOverlayEvents>(eventName: EventName, fn: (payload: TMappedinMapLibreOverlayEvents[EventName] extends {
+                    data: null;
+            } ? TMappedinMapLibreOverlayEvents[EventName]["data"] : TMappedinMapLibreOverlayEvents[EventName]) => void) => void;
     }
 }
 
@@ -1666,7 +1747,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     import type { Coordinate, Floor, Door, Space, MapObject, PointOfInterest, Connection, Annotation, EnterpriseLocation, Node } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import type { Label, Marker, Model, Image, Shape } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { Language, ParsedMVFLocalePack } from '@mappedin/mvf';
-    import { type InsetPaddingOption, Position } from '@mappedin/core-sdk';
+    import type { InsetPaddingOption, Position } from '@mappedin/core-sdk';
     export type DeepRequired<T> = Required<{
             [K in keyof T]: T[K] extends Required<T[K]> ? T[K] : DeepRequired<T[K]>;
     }>;
@@ -1808,11 +1889,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     export type TDoorsState = {
             type: 'doors';
             /**
-                * Color of the walls.
+                * Color of the doors.
                 */
             color: string | 'initial';
             /**
-                * Color of the top of walls, if not set, defaults to the color.
+                * Color of the top of doors, if not set, defaults to the color.
                 */
             topColor?: string | 'initial';
             /**
@@ -1828,7 +1909,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
                     url?: string;
             };
             /**
-                * Visibility of the walls.
+                * Visibility of the doors.
                 */
             visible: boolean;
             /**
@@ -1948,7 +2029,7 @@ declare module '@mappedin/react-sdk/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 Shape ? Partial<Omit<TShapeState, 'height' | 'type'>> : 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 Door ? 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 TGetState<T> = T extends WALLS ? TWallsState | undefined : T extends DOORS ? TDoorsState | undefined : T extends Marker ? TMarkerState | undefined : T extends Shape ? TShapeState | undefined : T extends Model ? TModelState | undefined : T extends Label ? TLabelState | undefined : T extends Image ? TImageState | undefined : T extends Space | MapObject ? TGeometryState | undefined : T extends string ? TLabelState | TGeometryState | TMarkerState | TModelState | undefined : never;
     /**
@@ -2031,7 +2112,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     /**
         * A map element that can be focused on by the camera.
         */
-    export type TFocusable = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | Node
+    export type TFocusable = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | Node | EnterpriseLocation
     /**
         * @experimental
         */
@@ -2588,10 +2669,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
                 */
             timeout?: number;
             /**
-                * Whether to watch the browser's position.
+                * Whether to watch the device's position.
                 * @default true
                 */
-            watchBrowserPosition?: boolean;
+            watchDevicePosition?: boolean;
             /**
                 * Whether to log debug messages.
                 * @default false
@@ -2691,6 +2772,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/blue-dot/blue-do
     };
     /**
         * @experimental
+        *
+        * Mappedin JS can use the location provided from an indoor positioning system to display a BlueDot on the map, indicating the user's position.
+        *
+        * This class is accessed using {@link MapView.BlueDot}.
+        *
+        * Further details and interactive examples can be found in the [BlueDot Guide](https://developer.mappedin.com/web-sdk/blue-dot).
         */
     export class BlueDot extends PubSub<TBlueDotEvents> {
             #private;
@@ -2751,11 +2838,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/blue-dot/blue-do
             follow: (mode: TFollowMode, cameraOptions?: TFollowCameraOptions) => void;
     }
     export type TFollowMode = 
-    /** Camera follows only the position of the Blue Dot. Bearing is not updated. */
+    /** Camera position follows the Blue Dot's position. */
     'position-only'
-    /** Camera follows both position and heading of the Blue Dot. */
+    /** Camera position follows the Blue Dot's position. Camera bearing matches the Blue Dot's heading. */
      | 'position-and-heading'
-    /** Camera follows position and automatically rotates to match the direction of the navigation path */
+    /** Camera position follows the Blue Dot's position. Camera bearing is calculated based on the Navigation path. */
      | 'position-and-path-direction'
     /** Disables follow mode */
      | false;
@@ -2848,6 +2935,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/sta
     export type TCollapseOptions = TCameraAnimationOptions;
     type CurrentMapGetter = () => GeojsonApiMapObject | undefined;
     /**
+        * Stacked Maps enables multi floor visualization. It allows for multiple floors of a building to be shown together as a stack of floors in an accordion style view.
+        *
+        * This class is accessed using {@link MapView.StackedMaps}.
+        *
+        * Refer to the [Stacked Maps Guide](https://developer.mappedin.com/web-sdk/stacked-maps) for more information and interactive examples.
+        *
         * @experimental
         */
     export class StackedMaps extends PubSub<TStackedMapsEvents> {
@@ -2886,7 +2979,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/sta
                 */
             setFloorVisiblityMode(mode: 'all-floors' | 'only-current-floor'): void;
             /**
-                * Set whether to listen to camera elevation changes to automatically change the floor.
+                * Set whether to listen to camera elevation changes to automatically change the floor. When enabled, the `mapView.on('floor-change')` event is fired
                 */
             changeFloorOnElevationChanges(value: boolean): void;
             /**
@@ -3058,6 +3151,17 @@ declare module '@mappedin/react-sdk/mappedin-js/src/navigation' {
                     destinationColor?: string;
             };
     };
+    /**
+        * When a user needs to get from point A to point B, drawing a path on the map helps them to navigate to their destination. It can help them to visualize the route they'll need to take, like a good treasure map.
+    
+        * Navigation is a helper class to display wayfinding easily on the map. Functionality of Navigation could be replicated by drawing the paths using {@link Paths} and adding well designed tooltips at connection points.
+        *
+        * This class is accessed using {@link MapView.Navigation}.
+        *
+        * {@link Navigation.draw} allows for easily drawing multiple components that make up a wayfinding illustration. It shows a human figure to mark the start point, a path with animated directional arrows, pulses in the direction of travel and a pin to mark the destination. Each of these components can be customized to match an app's style.
+        *
+        * Refer to the [Drawing Navigation](https://developer.mappedin.com/web-sdk/wayfinding#drawing-navigation) in the Wayfinding Guide for more information and interactive examples.
+        */
     export class Navigation {
             #private;
             /**
@@ -3195,8 +3299,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/category' {
     import type { MapDataInternal, EnterpriseLocation } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-object';
     /**
-        * An EnterpriseCategory is a collection of similar EnterpriseLocations.
+        * An EnterpriseCategory groups one or more EnterpriseLocation. These allow similar locations to be sorted in a logical fashion.
+        * For example a mall may group locations into Food Court, Footwear and Women's Fashion. They can be accessed using the {@link MapData.getByType()} method as shown below.
+        *
+        * ```typescript
+        * const categories = mapData.getByType('enterprise-category');
+        * ```
         *
+        * Refer to the [EnterpriseCategory Guide](https://developer.mappedin.com/web-sdk/enterprise-data#enterprise-categories) for more information and interactive examples.
         */
     class EnterpriseCategory extends BaseMapData implements Omit<MVFEnterpriseCategory, 'children' | 'locations'> {
             #private;
@@ -3208,12 +3318,33 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/category' {
                 * @internal
                 */
             readonly __type = "enterprise-category";
+            /**
+                * The name of the category.
+                */
             name: string;
+            /**
+                * The color of the category.
+                */
             color?: string | undefined;
+            /**
+                * The external ID of the category.
+                */
             externalId: string;
+            /**
+                * Extra properties of the category.
+                */
             extra?: Record<string, unknown> | undefined;
+            /**
+                * A URL to the icon of the category.
+                */
             icon?: string | undefined;
+            /**
+                * The icon from the default list of icons.
+                */
             iconFromDefaultList?: string | null | undefined;
+            /**
+                * The sort order of the category.
+                */
             sortOrder: number;
             /**
                 * Checks if the provided instance is of type EnterpriseCategory.
@@ -3228,7 +3359,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/category' {
             constructor(data: MapDataInternal, options: {
                     mvfData: MVFEnterpriseCategory;
             });
+            /**
+                * The child categories of the category.
+                */
             get children(): EnterpriseCategory[];
+            /**
+                * The {@link EnterpriseLocation}s within this category.
+                */
             get locations(): EnterpriseLocation[];
             /**
                 * Serializes the EnterpriseCategory data to JSON.
@@ -3255,9 +3392,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location' {
     import BaseMapData from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-object';
     import type Node from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/node';
     /**
-        * A class representing enterprise location data within the map.
+        * An EnterpriseLocation contains metadata about a location, such as its name, description, logo, phone number, social medial links, hours of operation and more.
+        * They can be accessed using the {@link MapData.getByType()} method as shown below.
         *
-        * An EnterpriseLocation is something like a store, or a washroom on a map.
+        * ```typescript
+        * const allLocations = mapData.getByType('enterprise-location');
+        * ```
+        *
+        * Refer to the [EnterpriseLocation Guide](https://developer.mappedin.com/web-sdk/enterprise-data#enterprise-locations) for more information and interactive examples.
         */
     class EnterpriseLocation extends BaseMapData implements Omit<MVFEnterpriseLocation, 'polygons' | 'nodes' | 'links'> {
             #private;
@@ -3269,36 +3411,139 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location' {
                 * @internal
                 */
             readonly __type = "enterprise-location";
+            /**
+                * The description of the location.
+                */
             description?: string | undefined;
+            /**
+                * The name of the location.
+                */
             name: string;
+            /**
+                * The amenity of the location.
+                */
             amenity?: string | undefined;
+            /**
+                * The external ID of the location.
+                */
             externalId: string;
+            /**
+                * Extra properties of the location.
+                */
             extra?: Record<string, unknown> | undefined;
+            /**
+                * The gallery of the location.
+                */
             gallery?: {
                     caption?: string | null;
                     image: string;
                     embeddedUrl?: string | null;
             }[] | undefined;
+            /**
+                * Specific instances of this location with different properties.
+                * Typically, there will be at least one node or polygon defined,
+                * plus one or more other properties that are different from the parent.
+                * The remaining properties will be the same as the parent.
+    
+                * For example, suppose there is a location like this:
+                *
+                * ```json
+                * {
+                *   "id": "location-id-1",
+                *   "name": "Location 1",
+                *   "nodes": ["node-1", "node-2"],
+                *   "polygons": ["polygon-1", "polygon-2"],
+                *   "externalId": "externalId-1",
+                *   "description": "Description 1",
+                * }
+                * ```
+                *
+                * (Note that for clarity, we have put strings in for nodes and polygons, but in practice they would be objects.)
+                *
+                * Then suppose it had an `instances` array that contained an object that looked like this:
+                *
+                * ```json
+                * {
+                *   "id": "instance-id-1",
+                *   "name": "Location 1 - A",
+                *   "nodes": ["node-1"],
+                *   "polygons": ["polygon-1"],
+                *   "externalId": "externalId-1-A",
+                *   "description": "Description 1",
+                * }
+                * ```
+                * This says "Location 1" is the parent location, and "Location 1 - A" is an instance of it. The instance has a different name, and a different external ID, and it only applies to node `node-1` and polygon `polygon-1`.
+                * The ID will always be different, but other properties (like the description) are the same as the parent.
+                *
+                * Example use cases:
+                * - A Mall may have a location with two nodes and one polygon. It may then have an instance with one of the nodes, and operating hours
+                * that are different from the parent. This indicates that this instance is an entrance for the location that is accessible at different times, perhaps for an interior mall entrance, when the main location (and other, exterior entrance) is open later than the rest of the mall.
+                * - An aiport may have a location with several polygons and nodes, and an instance for each node (and corrisponding polygon, if any) with a different siblingGroup. The location in the sibling group may be the airport terminal, or airside vs landside.
+                * This would allow an application to show the location once in a search result, but offer UX to select the instance that is in the right terminal.
+                *
+                * Note: Instances are actual EnterpriseLocations. This means they have all the properties of a normal EnterpriseLocation, including an `instances` property, that will always be undefined. They also do NOT have a parent proprty, or any other explicit reference to the parent location. These instances are
+                * only referenced from their parent location, and will not show up in other places in the map data. However, they should otherwise behave like normal EnterpriseLocations, being targetable for things like navigation and focus.
+                */
+            instances?: EnterpriseLocation[] | undefined;
+            /**
+                * A URL to the logo of the location.
+                */
             logo?: string | undefined;
+            /**
+                * The operation hours of the location.
+                */
             operationHours?: OperationHours[] | undefined;
+            /**
+                * The phone number of the location.
+                */
             phone?: {
                     number: string;
                     extension?: string;
             } | undefined;
+            /**
+                * A URL to the picture of the location.
+                */
             picture?: string | undefined;
+            /**
+                * The short name of the location.
+                */
             shortName?: string | undefined;
+            /**
+                * Whether to show the floating label when an image is present.
+                */
             showFloatingLabelWhenImagePresent?: boolean | undefined;
+            /**
+                * Whether to show the logo.
+                */
             showLogo?: boolean | undefined;
+            /**
+                * The sibling groups of the location.
+                */
             siblingGroups?: SiblingGroup[] | undefined;
+            /**
+                * The social media links of the location.
+                */
             social?: {
                     facebook?: string;
                     instagram?: string;
                     twitter?: string;
                     website?: string;
             } | undefined;
+            /**
+                * The sort order of the location.
+                */
             sortOrder: number;
+            /**
+                * The {@link LocationState}s of the location.
+                */
             states?: LocationState[] | undefined;
+            /**
+                * The tags of the location.
+                */
             tags?: string[] | undefined;
+            /**
+                * The type of the location.
+                */
             type: string;
             /**
                 * Checks if the provided instance is of type EnterpriseLocation.
@@ -3313,6 +3558,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location' {
             constructor(data: MapDataInternal, options: {
                     mvfData: MVFEnterpriseLocation;
                     categoryIds: string[];
+                    locationInstances?: EnterpriseLocation[];
             });
             get categories(): EnterpriseCategory[];
             get coordinates(): Coordinate[];
@@ -3342,7 +3588,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/venue' {
     import type { Hyperlink, MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-object';
     /**
-        * An EnterpriseVenue is a specific place (like a mall, office building, or stadium) with one or more Floors
+        * The EnterpriseVenue class holds metadata bout the map, which includes the map name, supported languages, default language, top locations and more.
+        * It can be accessed using the {@link 	MapData.getByType()} method as shown below.
+        *
+        * ```typescript
+        * const venue = mapData.getByType('venue');
+        * ```
+        *
+        * Refer to the [EnterpriseVenue Guide](https://developer.mappedin.com/web-sdk/enterprise-data#enterprise-venue) for more information.
         */
     class EnterpriseVenue extends BaseMapData implements MVFEnterpriseVenue {
             #private;
@@ -3354,18 +3607,57 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/venue' {
                 * @internal
                 */
             readonly __type = "enterprise-venue";
+            /**
+                * The country code of the venue.
+                */
             countrycode?: string | undefined;
+            /**
+                * The external ID of the venue.
+                */
             externalId: string;
+            /**
+                * The default language of the venue.
+                */
             defaultLanguage: Language;
+            /**
+                * The default map of the venue.
+                */
             defaultMap?: string | undefined;
+            /**
+                * Extra properties of the venue.
+                */
             extra?: Record<string, unknown> | undefined;
+            /**
+                * A URL to the icon of the venue.
+                */
             icon?: string | undefined;
+            /**
+                * The languages supported by the venue.
+                */
             languages: Language[];
+            /**
+                * The links of the venue.
+                */
             links: Hyperlink[];
+            /**
+                * A URL to the logo of the venue.
+                */
             logo?: string | undefined;
+            /**
+                * A URL to a web page with [Mappedin Web](https://developer.mappedin.com/docs/enterprise-apps/mappedin-web-v2) for this venue.
+                */
             mappedinWebUrl?: string | undefined;
+            /**
+                * The slug of the venue.
+                */
             slug: string;
+            /**
+                * The top locations of the venue.
+                */
             topLocations?: string[] | undefined;
+            /**
+                * The timezone ID of the venue.
+                */
             tzid?: string | undefined;
             /**
                 * Checks if the provided instance is of type EnterpriseVenue.
@@ -3617,7 +3909,30 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/door' {
     /**
         * A class representing door data within the map.
         *
-        * This class provides details and operations related to a door.
+        * Doors are hidden by default. Doors can be made visible by setting their `visible` property to `true`.
+        *
+        * ```typescript
+        * //Make interior doors visible and brown.
+        * mapView.updateState(DOORS.Interior, {
+        * 	visible: true,
+        * 	color: '#5C4033',
+        * 	opacity: 0.6,
+        * });
+    
+        * //Make exterior doors visible and black.
+        * mapView.updateState(DOORS.Exterior, {
+        * 	visible: true,
+        * 	color: 'black',
+        * 	opacity: 0.6,
+        * });
+        * ```
+        * Doors can also be made visible on an individual basis by passing in a {@link Door} object to {@link MapView.updateState}.
+        *
+        * Refer to the [Door Guide](https://developer.mappedin.com/web-sdk/spaces#doors) for more information and interactive examples.
+        *
+        * Door appearance can be customized by changing the color or adding a texture to the top or sides of a door.
+        * Refer to the [Textures & Colors Guide](https://developer.mappedin.com/web-sdk/images-textures#textures--colors) for more information and interactive examples.
+        *
         */
     class Door extends BaseMapData {
             #private;
@@ -3655,7 +3970,17 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/door' {
                 * @returns {string} The external ID of the door.
                 */
             get externalId(): string;
+            /**
+                * Gets the description of the door.
+                *
+                * @returns {string} The description of the door.
+                */
             get description(): string;
+            /**
+                * Gets the images of the door.
+                *
+                * @returns {Image[]} The images of the door.
+                */
             get images(): Image[];
             /**
                 * Gets the {@link Floor} object associated with the door.
@@ -3718,9 +4043,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/space' {
         */
     export type TSpaceType = 'room' | 'hallway' | 'exterior' | 'void' | 'connection.stairs' | 'connection.elevator' | 'poi';
     /**
-        * A class representing space data within the map.
+        * A Space represents an area enclosed by walls, such as a hall or room. Spaces can be Interactive and have Labels and Markers added to them.
+        * Spaces can also be customized with a color, texture and hover color.
         *
-        * Spaces are used to represent different areas within a map, such as rooms, hallways, etc.
+        * Refer to the [Spaces Guide](https://developer.mappedin.com/web-sdk/spaces) for more information and interactive examples.
         */
     class Space extends BaseMapData {
             #private;
@@ -3991,6 +4317,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/connection'
             get name(): string;
             get description(): string;
             get images(): Image[];
+            /**
+                * Whether the connection is accessible. For example elevators are accessible while stairs are not.
+                *
+                * @returns {boolean} Whether the connection is accessible.
+                */
             get accessible(): boolean;
             /**
                 * Gets the external ID of the connection.
@@ -4057,7 +4388,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/object' {
     /**
         * A class representing generic map object data within the map.
         *
-        * It could represent various objects on the map, such as desks, walls, etc.
+        * It could represent various objects on the map, such as desks, chairs, etc.
+        *
+        * MapObject appearance can be customized by changing the color or adding a texture to its top or sides.
+        * Refer to the [Textures & Colors Guide](https://developer.mappedin.com/web-sdk/images-textures#textures--colors) for more information and interactive examples.
         */
     export class MapObject extends BaseMapData {
             #private;
@@ -4326,6 +4660,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/annotation'
         *
         * Annotations are used to mark specific points or areas on the map with additional information.
         * It includes some details on a map that may be relevant to safety or accessibility (e.g. Fire Extinguishers).
+        * Refer to the [Annotation Guide](https://developer.mappedin.com/web-sdk/annotations) for more information.
         */
     class Annotation extends BaseMapData {
             #private;
@@ -4732,6 +5067,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/shapes' {
     import type { FeatureCollection, LineString, MultiPolygon, Polygon } from 'geojson';
     import type { LineStyle, PaintStyle } from '@mappedin/core-sdk';
     import type { Floor } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * The Shapes class draws 3 dimensional shapes on top of a map. The shapes are created using GeoJSON geometry, which could be a {@link Polygon}, {@link MultiPolygon} (array of polygons) or a {@link LineString}.
+        *
+        * This class is accessed using {@link MapView.Shapes}.
+        *
+        * Refer to the [Shapes Guide](https://developer.mappedin.com/web-sdk/shapes) for more information and interactive examples.
+        */
     export class Shapes {
             #private;
             /**
@@ -7421,29 +7763,13 @@ declare module '@mappedin/react-sdk/geojson/src/systems/html-controls/system' {
     }
 }
 
-declare module '@mappedin/react-sdk/geojson/src/maplibre-overlay' {
-    import type { IControl, Map as MapLibreMap, CustomLayerInterface } from '@packages/internal/outdoor-context-v4';
-    import type { Position } from '@mappedin/react-sdk/geojson/src/types';
-    import RendererCore from '@mappedin/react-sdk/geojson/src/renderer';
-    import { PubSub } from '@packages/internal/common';
-    export class MapLibreOverlay<T> extends PubSub<T> implements IControl {
-        el: HTMLDivElement;
-        core: RendererCore;
-        origin?: Position;
-        map?: MapLibreMap;
-        layer?: CustomLayerInterface;
-        constructor(origin: Position | undefined);
-        onAdd(map: MapLibreMap): HTMLDivElement;
-        onRemove(): void;
-    }
-}
-
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/api' {
     import type { Position, RendererCore, WatermarkOptions } from '@mappedin/core-sdk';
     import { type TShow3DMapOptions } from '@mappedin/react-sdk/mappedin-js/src';
     import { WALLS, DOORS } from '@mappedin/react-sdk/mappedin-js/src/types';
     import type MapData from '@mappedin/react-sdk/mappedin-js/src/map-data';
-    import { Coordinate, MapObject, Space, Floor, type MapDataInternal, Door } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { FloorStack, MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import { Coordinate, MapObject, Space, Floor, Door } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import type { MapView } from '@mappedin/react-sdk/mappedin-js/src/map-view';
     import { Label, Marker, type Model, type Image, Shape } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import { Navigation } from '@mappedin/react-sdk/mappedin-js/src/navigation';
@@ -7463,14 +7789,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/api' {
     import Outdoor from '@mappedin/react-sdk/mappedin-js/src/api-geojson/outdoor';
     export class GeoJsonApi {
         core: RendererCore;
-        outdoors: GeojsonApiMapObject;
         mapObjects: GeojsonApiMapObject[];
         id: string;
         mapDataExternal: {
             [key in string]: MapData;
         };
         mapData?: MapData;
-        currentMap?: GeojsonApiMapObject;
+        currentMap: GeojsonApiMapObject;
         hiddenOutdoorGeometries: [Position, layer: string[]][];
         mapView: MapView;
         Camera: Camera;
@@ -7493,7 +7818,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/api' {
         getMapData(): MapData | undefined;
         addMap(mapData: MapData, options?: TShow3DMapOptions): Promise<MapData>;
         setFloor(floor: Floor | string, reason?: TFloorChangeReason): void;
+        setFloorStack(floorStack: FloorStack | string): void;
         updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
+        get currentFloorStack(): FloorStack;
         get currentFloor(): Floor;
         getState<T extends Space | MapObject | Label | Marker | Shape | Model | Image | string>(target: T): TGetState<T> | undefined;
         setHoverColor(c: string): void;
@@ -7523,8 +7850,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object' {
     import { StackedMaps } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
     import type { TFloorChangeReason } from '@mappedin/react-sdk/mappedin-js/src/events';
     import type { Path, Shape } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
-    import type { Space, Door, PointOfInterest, MapObject, Node } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { Space, Door, PointOfInterest, MapObject, Node, MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import { type GeoJsonApi } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/api';
+    import { FloorStackObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-stack-object';
     export class GeojsonApiMapObject extends PubSub<{
         'floor-change': {
             reason?: TFloorChangeReason;
@@ -7543,18 +7871,21 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object' {
             path: Path;
         };
     }> {
-        /** Floors sorted in order of elevation */
-        floors: FloorObject[];
-        /** Map of floors by elevation. Floor elevation does not always match index or is not always contiguous. */
-        floorsByElevation: Map<number, FloorObject>;
+        floorStacksById: Map<string, FloorStackObject>;
+        floorsById: Map<string, FloorObject>;
         currentFloorId: string;
+        currentFloorStackId: string;
         id: string;
         renderer: RendererCore;
         api: GeoJsonApi;
         mvf: ParsedMVF;
         styleMap: AggregatedStyleMap;
         StackedMaps: StackedMaps;
+        get currentFloorStack(): FloorStackObject;
+        setFloorStack(floorStackId: string): void;
         get currentFloor(): FloorObject;
+        /** @deprecated use `currentFloorStack.floorObjects` or `floorsById` instead */
+        get floors(): FloorObject[];
         setFloor(floorId: string, reason?: TFloorChangeReason): void;
         Models: {
             add: (id: string, targets: TAddModel[], opts: TAddModelOptions & {
@@ -7605,7 +7936,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object' {
             };
             remove: (entityIds: string[]) => void;
         };
-        constructor(id: string, mvf: any, styleMap: AggregatedStyleMap, options: TShow3DMapOptions | undefined, api: GeoJsonApi);
+        constructor(id: string, mapDataInternal: MapDataInternal | undefined, options: TShow3DMapOptions | undefined, api: GeoJsonApi);
     }
 }
 
@@ -7614,14 +7945,26 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/label' {
     /**
         * Class representing a label on the {@link MapView}.
         *
-        * Labels are used to provide additional information on the map.
+        * Labels contain text and an image that are anchored to a specific point on the map. They automatically rotate and show and hide based on priority and zoom level.
+        * Use them to inform users about location names, points of interest and more!
+        *
+        * Effective use of labels allows an app to convey additional information to the user.
+        * For example labels can be used to show room names, important points of interest, main entrances or any other piece of contextual information that is useful to the user.
+        *
+        * Refer to the [Labels Guide](https://developer.mappedin.com/web-sdk/labels) for more information and interactive examples.
         */
     export class Label {
             /**
                 * The label's id
                 */
             readonly id: string;
+            /**
+                * The label's text
+                */
             readonly text: string;
+            /**
+                * The target object where the label is anchored.
+                */
             readonly target: Space | Door | Coordinate | PointOfInterest | MapObject | Node;
             /**
                 * @internal
@@ -7648,9 +7991,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/label' {
 declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/marker' {
     import type { Coordinate, Door, Node, Space } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     /**
-        * Class representing a marker on the {@link MapView}.
+        * Mappedin JS allows adding and removing Markers on a map using the {@link Markers} class. Markers are elements containing HTML that Mappedin JS anchors to a {@link Door}, {@link Space}, {@link Coordinate} or {@link Node}.
+        * They are automatically rotated and repositioned when the camera moves.
         *
-        * Markers are used to indicate a specific location on the map.
+        * Refer to the [Markers Guide](https://developer.mappedin.com/web-sdk/markers) for more information and interactive examples.
         */
     export class Marker {
             /**
@@ -7728,6 +8072,18 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/image' {
 declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/model' {
     /**
         * Class representing a 3D model on the {@link MapView}.
+        *
+        * Adding 3D models to a map can be a great way to represent landmarks to help users find key locations. They could also be used to show the location of assets or represent furniture to provide a rich indoor layout.
+    
+        * Mappedin JS supports models in Graphics Library Transmission Format (GLTF) and GL Transmission Format Binary (GLB) format. Models with nested meshes are not supported and should not be used.
+        *
+        * 3D Models can be added to a {@link Coordinate}, {@link Door} or {@link Space}.
+        * When adding the same model to multiple locations at the same time always use an array instead of calling the add method multiple times.
+        * This allows the SDK to re-use the same instance of the model to reduce RAM usage and rendering time, resulting in better performance.
+        *
+        * Models are added using {@link Models.add}.
+        *
+        * Refer to the [3D Models Guide](https://developer.mappedin.com/web-sdk/3d-models) for more information and interactive examples.
         */
     export class Model {
             /**
@@ -7765,7 +8121,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/path' {
     /**
         * Class representing a path on the {@link MapView}.
         *
-        * Paths are used to indicate a route on the map.
+        * Paths are used to indicate a route on the map and can be added and removed using {@link Paths.add} and {@link Paths.remove}.
         */
     export class Path {
             /**
@@ -7795,6 +8151,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/shape' {
     /**
         * Class representing GeoJSON shape on the {@link MapView}.
         *
+        * Refer to the [Shapes Guide](https://developer.mappedin.com/web-sdk/shapes) for more information and interactive examples.
         */
     export class Shape {
             /**
@@ -7827,12 +8184,25 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
     import type { TCameraAnimationOptions, TCameraFocusOnTarget, TCameraTarget, TFocusOnOptions } from '@mappedin/react-sdk/mappedin-js/src/types';
     import type { InsetPadding, RendererCore } from '@mappedin/core-sdk';
     import { Coordinate } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * The Camera class is used to control the camera's position, pitch, bearing, and zoom level. It can also be used to focus
+        * on one or more locations on the map. The camera can be repositioned instantly or animated to a new position.
+        *
+        * This class is accessed using {@link MapView.Camera}
+        *
+        * Refer to the [Camera Guide](https://developer.mappedin.com/web-sdk/camera) for more information and interactive examples.
+        */
     export class Camera {
             #private;
             /**
                 * @internal
                 */
             constructor(rendererCore: RendererCore);
+            /**
+                * Define an area of the screen that is safe for the camera. Anything outside the safe area is assumed to be covered in some way. The camera will not place any map elements there when calling {@link Camera.focusOn}.
+                *
+                * @param padding The padding in pixels.
+                */
             setScreenOffsets(padding: InsetPadding): void;
             get screenOffsets(): InsetPadding;
             /**
@@ -7840,7 +8210,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
                 */
             get panMode(): "default" | "elevation";
             /**
-                * Set the camera's pan mode. 'elevation' moves the camera up and down, while 'default' allows the camera to pan along the ground.
+                * Set the camera's pan mode. 'elevation' moves the camera up and down, while 'default' allows the camera to pan in all directions.
                 * @experimental
                 * @param panMode The new pan mode.
                 */
@@ -7852,7 +8222,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
                 * @param options Optional settings for focusing the camera.
                 * @example
                 * // Focus on a single space
-                * map.Camera.focusOn(space, { minZoomLevel: 5, duration: 1000 });
+                * mapView.Camera.focusOn(space, { minZoomLevel: 5, duration: 1000 });
                 */
             focusOn(target: TCameraFocusOnTarget, options?: TFocusOnOptions): Promise<void>;
             /**
@@ -7860,14 +8230,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
                 * @param target The target configuration for the camera.
                 * @param options Optional settings for the camera animation.
                 * @example
-                * map.Camera.animateTo({ center: coordinate, zoomLevel: 10 }, { duration: 500 });
+                * mapView.Camera.animateTo({ center: coordinate, zoomLevel: 10 }, { duration: 500 });
                 */
             animateTo(target: TCameraTarget, options?: TCameraAnimationOptions): Promise<void>;
             /**
                 * Sets the camera to a specified target without animation.
                 * @param target The target configuration for the camera.
                 * @example
-                * map.Camera.set({ center: coordinate, zoomLevel: 10 });
+                * mapView.Camera.set({ center: coordinate, zoomLevel: 10 });
                 */
             set(target: TCameraTarget): void;
             /**
@@ -7926,7 +8296,6 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
                 * Update the minimum zoom level of the camera in mercator zoom levels.
                 * @param zoomLevel The new minimum zoom level.
                 * @see https://wiki.openstreetmap.org/wiki/Zoom_levels
-                * @default 22
                 */
             setMinZoomLevel: (zoomLevel: number) => void;
             /**
@@ -7939,7 +8308,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
                 * Update the maximum zoom level of the camera in mercator zoom levels.
                 * @param zoomLevel The new maximum zoom level.
                 * @see https://wiki.openstreetmap.org/wiki/Zoom_levels
-                * @default 12
+                * @default 22
+                * @max 24
+                * @min 0
                 */
             setMaxZoomLevel: (zoomLevel: number) => void;
             /**
@@ -7968,6 +8339,19 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/labels' {
     import type { GeojsonApiMapObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object';
     import type { PointOfInterest, MapObject } from '@mappedin/react-sdk/mappedin-js/src';
     import type { Space, Door, Coordinate, Node } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * Class used to add and remove a {@link Label} on the {@link MapView}.
+        *
+        * Labels contain text and an image that are anchored to a specific point on the map. They automatically rotate and show and hide based on priority and zoom level.
+        * Use them to inform users about location names, points of interest and more!
+        *
+        * Effective use of labels allows an app to convey additional information to the user.
+        * For example labels can be used to show room names, important points of interest, main entrances or any other piece of contextual information that is useful to the user.
+        *
+        * This class is accessed using {@link MapView.Labels}.
+        *
+        * Refer to the [Labels Guide](https://developer.mappedin.com/web-sdk/labels) for more information and interactive examples.
+        */
     export class Labels {
             #private;
             /**
@@ -7996,7 +8380,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/labels' {
                 * @returns {Label | undefined} The created label, or undefined if creation failed.
                 * @example
                 *
-                * map.Labels.add(space, 'Welcome', { appearance: { color: 'blue' } });
+                * mapView.Labels.add(space, 'Welcome', { appearance: { color: 'blue' } });
                 */
             add(target: Space | Door | Coordinate | PointOfInterest | MapObject | Node, text: string, options?: TAddLabelOptions | undefined): Label;
             /**
@@ -8006,7 +8390,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/labels' {
                 *
                 * @example
                 * // Add all the labels to the map
-                * map.Labels.all();
+                * mapView.Labels.all();
                 */
             all(): Label[];
             /**
@@ -8021,7 +8405,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/labels' {
                 * Removes all the labels ({@link Label}) from the map.
                 *
                 * @example
-                * map.Labels.removeAll();
+                * mapView.Labels.removeAll();
                 */
             removeAll(): Label[];
     }
@@ -8034,6 +8418,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/markers' {
     import { Marker } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { GeojsonApiMapObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object';
     import type { Space, Door, Coordinate, Node } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * Mappedin JS allows adding and removing Markers on a map. Markers are elements containing HTML that Mappedin JS anchors to a {@link Door}, {@link Space}, {@link Coordinate} or {@link Node}.
+        * They are automatically rotated and repositioned when the camera moves.
+        *
+        * This class is accessed using {@link MapView.Markers}.
+        *
+        * Refer to the [Markers Guide](https://developer.mappedin.com/web-sdk/markers) for more information and interactive examples.
+        */
     export class Markers {
             #private;
             /**
@@ -8061,8 +8453,8 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/markers' {
                 * @param options Optional additional options for the {@link Marker}.
                 * @returns {Marker | undefined} The created {@link Marker}, or undefined if creation failed.
                 * @example
-                * // Add an interactive {@link Marker} to the map with custom HTML content.
-                * map.Markers.add(coordinate, '<div>Marker Content</div>', { interactive: true });
+                * // Add an interactive Marker to the map with custom HTML content.
+                * mapView.Markers.add(coordinate, '<div>Marker Content</div>', { interactive: true });
                 */
             add(target: Space | Door | Coordinate | Node, html: string, options?: TAddMarkerOptions): Marker;
             /**
@@ -8077,7 +8469,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/markers' {
                 * Remove all the markers from the map.
                 *
                 * @example
-                * map.Markers.removeAll();
+                * mapView.Markers.removeAll();
                 */
             removeAll(): Marker[];
             /**
@@ -8085,7 +8477,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/markers' {
                 * @param marker The {@link Marker} which should be removed.
                 * @param target The new target object ({@link Space}, {@link Door}, or {@link Coordinate}) for the marker.
                 * @example
-                * const marker = map.Markers.add(coordinate, '<div>Marker Content</div>');
+                * const marker = mapView.Markers.add(coordinate, '<div>Marker Content</div>');
                 * mapView.Markers.setPosition(marker, newCoordinate);
                 */
             setPosition(marker: Marker, target: Space | Door | Coordinate | Node): void;
@@ -8096,7 +8488,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/markers' {
                 * @param options Optional additional options for the animation.
                 * @returns {Promise<void>} A promise that resolves when the animation is complete.
                 * @example
-                * const marker = map.Markers.add(coordinate, '<div>Marker Content</div>');
+                * const marker = mapView.Markers.add(coordinate, '<div>Marker Content</div>');
                 * mapView.Markers.animateTo(marker, newCoordinate, { duration: 1000 });
                 */
             animateTo(marker: Marker, target: Space | Door | Coordinate | Node, options?: TAnimationOptions): Promise<void>;
@@ -8109,6 +8501,19 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/models' {
     import type { TAddModelOptions, TAddModel } from '@mappedin/react-sdk/mappedin-js/src/types';
     import { Model } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { GeojsonApiMapObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object';
+    /**
+        * Adding 3D models to a map can be a great way to represent landmarks to help users find key locations. They could also be used to show the location of assets or represent furniture to provide a rich indoor layout.
+    
+        * Mappedin JS supports models in Graphics Library Transmission Format (GLTF) and GL Transmission Format Binary (GLB) format. Models with nested meshes are not supported and should not be used.
+        *
+        * 3D Models can be added to a {@link Coordinate}, {@link Door} or {@link Space}.
+        * When adding the same model to multiple locations at the same time always use an array instead of calling the add method multiple times.
+        * This allows the SDK to re-use the same instance of the model to reduce RAM usage and rendering time, resulting in better performance.
+        *
+        * This class is accessed using {@link MapView.Models}.
+        *
+        * Refer to the [3D Models Guide](https://developer.mappedin.com/web-sdk/3d-models) for more information and interactive examples.
+        */
     export class Models {
             #private;
             /**
@@ -8137,7 +8542,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/models' {
                 * @returns {Model | undefined} The created {@link Model}, or undefined if creation failed.
                 * @example
                 * // Add a {@link Model} to the map.
-                * map.Models.add(coordinate);
+                * mapView.Models.add(coordinate);
                 */
             add(models: TAddModel | TAddModel[], options: TAddModelOptions): Model[];
             /**
@@ -8152,7 +8557,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/models' {
                 * Remove all the models from the map.
                 *
                 * @example
-                * map.MOdels.removeAll();
+                * mapView.Models.removeAll();
                 */
             removeAll(): Model[];
     }
@@ -8165,6 +8570,19 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/paths' {
     import type { TAddPathOptions } from '@mappedin/react-sdk/mappedin-js/src';
     import { Path } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { Coordinate } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * While {@link Navigation} provides a complete start and end navigation illustration, it may be desired to draw just the path. This can be done using Paths.
+        *
+        * Paths is accessed using {@link MapView.Paths}.
+        *
+        * Paths can be drawn from one coordinate to another using {@link Paths.add}. If using just two coordinates, the path will be drawn straight between the two points.
+        * This may work for some scenarios, but in most cases an app will need to show the user their walking path, going through doors and avoiding walls and other objects.
+        * Such a path of coordinates can be created by calling the {@link MapData.getDirections()} method, passing in a start and end {@link TNavigationTarget}. Note that a Space requires an entrance to be used as a target.
+        *
+        * The width of the path is set using the {@link TAddPathOptions.nearRadius} and {@link TAddPathOptions.farRadius} parameters. These values are in meters. `nearRadius` is the path width used at the lowest zoom level closest to the ground and `farRadius` is used at the highest zoom level. Additional path styles are outlined later in this guide in the Path Styles section.
+        *
+        * Refer to the [Drawing a Path](https://developer.mappedin.com/web-sdk/wayfinding#drawing-a-path) in the Wayfinding Guide for more information and interactive examples.
+        */
     export class Paths {
             #private;
             /**
@@ -8190,21 +8608,21 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/paths' {
                 * @param options Optional additional option
                 * @example
                 * // Add a red path to the map
-                * map.Paths.add(coordinate,  { color: '#ff0000' });
+                * mapView.Paths.add(coordinate,  { color: '#ff0000' });
                 */
             add(coordinate: Coordinate[], options?: TAddPathOptions): Path;
             /**
                 * Removes a specific path ({@link Path}) from the map.
                 * @param path The path to be removed.
                 * @example
-                * map.Paths.remove(path);
+                * mapView.Paths.remove(path);
                 */
             remove(path: Path): void;
             /**
                 * Removes all paths ({@link Path}) from the map.
                 *
                 * @example
-                * map.Paths.removeAll();
+                * mapView.Paths.removeAll();
                 */
             removeAll(): Path[];
     }
@@ -8356,6 +8774,17 @@ declare module '@mappedin/react-sdk/mappedin-js/src/navigation/index' {
                     destinationColor?: string;
             };
     };
+    /**
+        * When a user needs to get from point A to point B, drawing a path on the map helps them to navigate to their destination. It can help them to visualize the route they'll need to take, like a good treasure map.
+    
+        * Navigation is a helper class to display wayfinding easily on the map. Functionality of Navigation could be replicated by drawing the paths using {@link Paths} and adding well designed tooltips at connection points.
+        *
+        * This class is accessed using {@link MapView.Navigation}.
+        *
+        * {@link Navigation.draw} allows for easily drawing multiple components that make up a wayfinding illustration. It shows a human figure to mark the start point, a path with animated directional arrows, pulses in the direction of travel and a pin to mark the destination. Each of these components can be customized to match an app's style.
+        *
+        * Refer to the [Drawing Navigation](https://developer.mappedin.com/web-sdk/wayfinding#drawing-navigation) in the Wayfinding Guide for more information and interactive examples.
+        */
     export class Navigation {
             #private;
             /**
@@ -8481,12 +8910,29 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/style' {
 
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/outdoor' {
     import { type RendererCore, type Position } from '@mappedin/core-sdk';
+    /**
+        * The outdoor map shown around the Mappedin indoor map can be manipulated to show or hide additional information. It can be used to add GeoJSON based geometry, images, deck.gl layers and more.
+        *
+        * The outdoor map is accessed using {@link MapView.Outdoor.map}, which returns a maplibregl.Map object.
+        * [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/) is a TypeScript library that uses WebGL to render interactive maps from vector tiles in a browser. The Mappedin SDK makes use of it to display the outdoor map.
+        *
+        * By providing access to the MapLibre map used to draw the outdoor map, the Mappedin SDK enables developers to draw on and manipulate the outdoor map.
+        * Developers can use most capabilities of MapLibre GL JS with key exceptions being Interactivity and Camera, which are not available.
+        *
+        * User touch and click events are handled by Mappedin JS and are not propagated to the outdoor map layer. Camera movement is also handled by Mappedin JS and cannot be manipulated using MapLibre controls.
+        *
+        * Refer to the [Outdoor Map Guide](https://developer.mappedin.com/web-sdk/outdoor-map) for more information and interactive examples.
+        */
     export default class Outdoor {
             #private;
             /**
                 * @internal
                 */
             constructor(core: RendererCore, hiddenOutdoorGeometry?: [Position, string[]][]);
+            /**
+                * Set the style of the outdoor map. Use one of [Mappedin's predefined styles](https://developer.mappedin.com/web-sdk/outdoor-map#styles) or link to a custom style.
+                * @param style {any}
+                */
             setStyle(style: any): void;
             /**
                 * Returns a Maplibre map for advanced usage.
@@ -8494,8 +8940,8 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/outdoor' {
                 * @returns {object} Maplibre map instance
                 *
                 * Limitations:
-                * - Maplibre interaction events are not supported; use SDK interaction events.
-                * - Maplibre markers and labels may overlap as they are not integrated with the SDK collision engine.
+                * - Maplibre interaction events are not supported, use Mappedin JS interaction events.
+                * - Maplibre markers and labels may overlap as they are not integrated with the Mappedin JS collision engine.
                 */
             get map(): import("@packages/internal/outdoor-context-v4").Map | undefined;
             /**
@@ -8507,16 +8953,16 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/outdoor' {
                 */
             get visible(): boolean;
             /**
-                * Show the outdoor view.
+                * Show the outdoor map.
                 */
             show(): void;
             /**
-                * Hide the outdoor view.
+                * Hide the outdoor map.
                 * @param excludedStyleLayerIds {string[]}
                 */
             hide(excludedStyleLayerIds?: string[]): void;
             /**
-                * Set outdoor view opacity
+                * Set outdoor view opacity.
                 * @param targetOpacity {number | 'initial'}
                 * @param excludedStyleLayerIds {string[]}
                 */
@@ -8529,6 +8975,25 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/images' {
     import { Image } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { GeojsonApiMapObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object';
     import type { Space, Door, Coordinate } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * Images can enhance the fidelity of an indoor map. They can be used to add custom branding, highlight important features, or provide additional information to users.
+        * Images can be placed on any {@link Door}, {@link Space}, or {@link Coordinate} on the map and given a verticalOffset to control the height at which the image is displayed.
+        *
+        * This class is accessed using {@link MapView.Images}.
+        *
+        * JPEG and PNG images are supported. It's important to consider the size of all unique image files displayed on a map at one time.
+        * Using many unique images may cause instability on mobile devices with limited GPU memory. The Mappedin SDK will cache and reuse images that have the same URL, resulting in reduced memory usage.
+        *
+        * The following calculations illustrates how much memory is used for a given image:
+        *
+        * Formula: `width * height * 4 bytes/pixel = memory used`
+        *
+        * 512 x 512 Pixel Image: `512px * 512px * 4 bytes/pixel = 1MB`
+        *
+        * 4096 x 4096 Pixel Image: `4096px * 4096px * 4 bytes/pixel = 64MB`
+        *
+        *  Refer to the [Images Guide](https://developer.mappedin.com/web-sdk/images-textures) for more information and interactive examples.
+        */
     export class Images {
             #private;
             /**
@@ -8557,7 +9022,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/images' {
                 * @returns {Image | undefined} The created {@link Image}, or undefined if creation failed.
                 * @example
                 * // Add an interactive {@link Image} to the map with custom HTML content.
-                * map.Images.add(coordinate, '<div>Image Content</div>', { interactive: true });
+                * mapView.Images.add(coordinate, '<div>Image Content</div>', { interactive: true });
                 */
             add(target: Space | Door | Coordinate, url: string, options: TAddImageOptions): Image;
             /**
@@ -8572,7 +9037,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/images' {
                 * Remove all the images from the map.
                 *
                 * @example
-                * map.Images.removeAll();
+                * mapView.Images.removeAll();
                 */
             removeAll(): Image[];
     }
@@ -8873,6 +9338,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/search/external' {
     import type MapData from '@mappedin/react-sdk/mappedin-js/src/map-data';
     import type { InternalSearch, SearchOptions, SuggestOptions } from '@mappedin/react-sdk/mappedin-js/src/search/internal';
     import type { MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    /**
+        * Search allows users to search for locations, categories, and other points of interest within the venue.
+        *
+        * Refer to the [Search Guide](https://developer.mappedin.com/web-sdk/enterprise-data#enterprise-search) for more information and interactive examples.
+        */
     export class Search {
             #private;
             /**
@@ -8887,7 +9357,16 @@ declare module '@mappedin/react-sdk/mappedin-js/src/search/external' {
                     enabled?: boolean;
             });
             /**
-                * Searches for places, locations, and categories.
+                * Use query to search for locations based on a string input:
+                *
+                * - {@link EnterpriseLocation}: Specific places such as stores, restaurants, or washrooms.
+                * - {@link EnterpriseCategory}: Groups of locations, such as "Food Court" or "Electronics."
+                * - {@link Places}: Any main objects that can be searched for such as Space, Door, Point of Interest
+                *
+                * Search query returns a list of matching {@	link SearchResults} based on the input string.
+                *
+                * {@link SearchResults} include information about the type of match, the score (relevance), and detailed metadata about the matching items.
+                *
                 * @param term - The search term.
                 * @param options - The search options.
                 * @returns The search results.
@@ -8899,7 +9378,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/search/external' {
                 */
             query(term: string, options?: SearchOptions): ReturnType<typeof InternalSearch.prototype.search>;
             /**
-                * Suggests the names of places, locations, and categories.
+                * Suggests the names of places, locations, and categories based on partial input. This is useful for creating an autocomplete feature for a search bar.
                 * @param term - The search term.
                 * @param options - The suggest options.
                 * @returns The search suggestions.
@@ -9003,7 +9482,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/analytics/customer' {
             /**
                 * Captures an analytic event with a custom target and query payload.
                 *
-                * @param target - The event name or target can be .
+                * @param target - The event name or target can be one of: `$select-location`, `$select-category`, `$query-suggest`, `$query-search`
                 * @param query - The payload associated with the event.
                 * @returns A promise that resolves to the server response or void.
                 */
@@ -10334,17 +10813,22 @@ declare module '@mappedin/react-sdk/geojson/src/systems/exporter/exporter' {
 }
 
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-object' {
-    import type { ParsedMVF } from '@mappedin/mvf';
+    import type { FloorProperties as MVFFloor, ParsedMVF } from '@mappedin/mvf';
     import type { RendererCore } from '@mappedin/core-sdk';
     import type { AggregatedStyleMap } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/utils';
     import type { TShow3DMapOptions } from '@mappedin/react-sdk/mappedin-js/src';
-    export class FloorObject {
+    export class FloorObject implements MVFFloor {
         id: string;
-        name: string;
+        name?: string;
         elevation: number;
         containerId: string;
+        externalId: string;
+        metadata?: Partial<Record<string, unknown>> | undefined;
+        shortName?: string | undefined;
+        subtitle?: string | undefined;
         layers: Map<string, string>;
-        constructor(parentId: string, floor: ParsedMVF['map.geojson'][0], renderer: RendererCore, options: TShow3DMapOptions, mvf: ParsedMVF, styleMap?: AggregatedStyleMap);
+        floorStackId: string;
+        constructor(parentId: string, floor: MVFFloor, renderer: RendererCore, options: TShow3DMapOptions, mvf?: ParsedMVF, styleMap?: AggregatedStyleMap);
         load: () => this;
     }
 }
@@ -10390,6 +10874,28 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/utils' {
     export function tweenToPromise(tween: Tween): Promise<void>;
 }
 
+declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-stack-object' {
+    import type { RendererCore } from '@mappedin/core-sdk';
+    import type { FloorId, FloorStack as MVFFloorStack } from '@mappedin/mvf';
+    import type { FloorObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-object';
+    export class FloorStackObject implements Omit<MVFFloorStack, 'maps' | 'floors'> {
+        id: MVFFloorStack['id'];
+        externalId: MVFFloorStack['externalId'];
+        name: MVFFloorStack['name'];
+        type: MVFFloorStack['type'];
+        floorIds: FloorId[];
+        /** Sorted floor objects by elevation */
+        floorObjects: FloorObject[];
+        floorObjectsByElevation: Map<number, FloorObject>;
+        metadata?: MVFFloorStack['metadata'];
+        footprint?: MVFFloorStack['footprint'];
+        containerId: string;
+        constructor(floorStack: MVFFloorStack, parentId: string, renderer: RendererCore);
+        get defaultFloor(): FloorObject;
+        addFloor(floor: FloorObject): void;
+    }
+}
+
 declare module '@mappedin/react-sdk/geojson/src/components/style' {
     import type { LineStyle } from '@mappedin/react-sdk/geojson/src/renderer';
     export const DEFAULT_COLOR = "#ffffff";
@@ -11197,7 +11703,7 @@ declare module '@mappedin/react-sdk/geojson/src/systems/camera/constants' {
     export const ZRANGE = 100;
     export const WHEEL_ZOOM_MULTIPLIER = 10000;
     export const MIN_MERCATOR_ZOOM_LEVEL = 0;
-    export const MAX_MERCATOR_ZOOM_LEVEL = 22;
+    export const MAX_MERCATOR_ZOOM_LEVEL = 24;
     export const BLOCK_MERCATOR_ZOOM_LEVEL = 17;
     export const ROOM_MERCATOR_ZOOM_LEVEL = 20;
     export const EVENTS: readonly ["change", "pan-start", "pan-end", "rotate-start", "rotate-end", "zoom-start", "zoom-end", "multi-start", "multi-end", "multi-cancel", "pedestal-start", "pedestal-change", "pedestal-end", "user-pan-start", "user-pedestal-start", "user-rotate-start", "user-dolly-start", "user-zoom-start", "user-tilt-start", "user-pan-end", "user-pedestal-end", "user-rotate-end", "user-dolly-end", "user-zoom-end", "user-tilt-end", "position-updated", "zoom-updated", "tilt-updated", "rotation-updated"];