@mappedin/react-sdk 6.0.1-beta.31 → 6.0.1-beta.33

package/lib/esm/index.d.ts

@@ -70,7 +70,7 @@ declare module '@mappedin/react-sdk/mappedin-js/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 { LanguagePackHydrationItem, TImagePlacementOptions } from '@mappedin/react-sdk/mappedin-js/src/types';
     import { MAPPEDIN_COLORS } from '@mappedin/react-sdk/mappedin-js/src/constants';
     import { type Environment } from '@packages/internal/mvf-utils/mvf-utils';
     import type { TBlueDotEvents, TBlueDotAction, TBlueDotState, GeolocationPositionExtended, TFollowMode, TFollowCameraOptions } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/blue-dot/blue-dot';
@@ -253,6 +253,23 @@ declare module '@mappedin/react-sdk/mappedin-js/src' {
                 * @default false
                 */
             keepOutdoorGeometryVisible?: boolean;
+            /**
+                * @experimental
+                *
+                * Enable occlusion of labels, markers and floors.
+                */
+            occlusion?: {
+                    /**
+                        * Enable occlusion.
+                        * @default false
+                        */
+                    enabled?: boolean;
+            };
+            /**
+                * @experimental
+                * @internal
+                */
+            imagePlacementOptions?: TImagePlacementOptions;
     };
     /**
         * @internal
@@ -886,6 +903,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data' {
                 * @internal
                 */
             get currentLanguage(): import("@mappedin/mvf").Language | undefined;
+            /**
+                * Retrieves the natural bearing of the map, which is the angle, in degrees, the map is considered to be "naturally oriented" towards.
+                * Typically the angle perpendicular to the street the map is facing, or the main entrance. Other print maps inside the map may have this direction be up.
+                * 90 degrees means East is "up"
+                *
+                * @returns The natural bearing of the map.
+                */
+            get naturalBearing(): number;
             /**
                 * Retrieves directions ({@link Directions}) from one navigable point ({@link TNavigationTarget}) to another on the map.
                 *
@@ -1069,6 +1094,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/events' {
                     directions: Directions;
                     path: Path;
             };
+            /**
+                * Emitted before the scene is drawn to the screen.
+                */
+            'pre-render': undefined;
+            /**
+                * Emitted after the scene is drawn to the screen.
+                */
+            'post-render': undefined;
     } & TStackedMapsEvents;
     export type TEventPayload<EventName extends keyof TEvents> = TEvents[EventName] extends {
             data: null;
@@ -1101,7 +1134,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
     import FloorStack from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/floor-stack';
     import Facade from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/facade';
     import type { MapDataRecords, EnterpriseMapDataRecords } from '@mappedin/react-sdk/mappedin-js/src/utils/data-creation';
-    import type { AnnotationCollection, ParsedMVF, Connection as MVFConnection, EntranceCollection, NodeCollection, ObstructionCollection, SpaceCollection, FloorProperties as MVFFloor, FloorStack as MVFFloorStack, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseCategory as MVFEnterpriseCategory, Language, AreaCollection } 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, AreaCollection, TilesetStyle } 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';
@@ -1109,11 +1142,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
     import { PubSub } from '@packages/internal/common';
     import type { LanguagePack, Places, TMapDataInternalOptions } from '@mappedin/react-sdk/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 { EnvControl, TGetMapDataOptions } from '@packages/internal/mvf-utils/mvf-utils';
     import type { TMapDataObjectTypes, TGetDirectionsOptions, TNavigationTarget } from '@mappedin/react-sdk/mappedin-js/src/types';
     import { type Directions, DirectionsInternal } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/directions';
     import { type THydrateMapDataBundle } from '@mappedin/react-sdk/mappedin-js/src';
     import { Query } from '@mappedin/react-sdk/mappedin-js/src/query';
+    import LocationProfile from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location-profile';
+    import LocationCategory from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location-category';
     /**
         * Internal class representing detailed map data.
         *
@@ -1164,7 +1199,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             pointsOfInterestById: MapDataRecords['poisById'];
             annotationsById: MapDataRecords['annotationsById'];
             areasById: MapDataRecords['areasById'];
+            locationProfilesById: MapDataRecords['locationProfilesById'];
+            locationCategoriesById: MapDataRecords['locationCategoriesById'];
+            locationProfilesByExternalId: MapDataRecords['locationProfilesByExternalId'];
             locationsById: EnterpriseMapDataRecords['locationsById'];
+            locationProfilesByCategoryId: MapDataRecords['locationProfilesByCategoryId'];
+            locationCategoriesByParentId: MapDataRecords['locationCategoriesByParentId'];
             categoriesById: EnterpriseMapDataRecords['categoriesById'];
             doorsByNodeId: MapDataRecords['doorsByNodeId'];
             mvfLocationsBySpaceId: EnterpriseMapDataRecords['mvfLocationsBySpaceId'];
@@ -1203,8 +1243,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             languagePacks: {
                     [languageCode: string]: LanguagePack;
             };
+            tilesets: {
+                    [tilesetId: string]: TilesetStyle;
+            };
             binaryBundle?: Uint8Array;
             envControl: EnvControl;
+            getMapDataOptions?: TGetMapDataOptions;
             /**
                 * @internal
                 */
@@ -1223,6 +1267,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             get mapName(): string;
             get organizationId(): string;
             get mapCenter(): Coordinate;
+            get naturalBearing(): number;
             /**
                 * Retrieves all spaces in the map.
                 *
@@ -1278,9 +1323,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             get nodes(): Node[];
             get locations(): EnterpriseLocation[];
             get categories(): EnterpriseCategory[];
+            get locationProfiles(): LocationProfile[];
+            get locationCategories(): LocationCategory[];
             get mvfFloors(): MVFFloor[];
             get mvfFloorStacks(): MVFFloorStack[];
             getByType(type: string): object[];
+            getByType(type: 'location-profile'): LocationProfile[];
+            getByType(type: 'location-category'): LocationCategory[];
             getByType(type: 'space'): Space[];
             getByType(type: 'area'): Area[];
             getByType(type: 'door'): Door[];
@@ -1338,6 +1387,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
                     multiDestination?: true;
             }) => Directions | Directions[] | undefined;
             getDistance(from: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation | Area, to: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation | Area): number;
+            transformImageRequest: (url: string) => Promise<{
+                    url: string;
+            }>;
             toJSONBundle({ downloadLanguagePacks, }?: {
                     downloadLanguagePacks?: boolean;
             }): Promise<THydrateMapDataBundle>;
@@ -1351,7 +1403,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
                 */
             destroy(): void;
     }
-    export { Node, Area, MapDataInternal, Space, Floor, FloorStack, Facade, Connection, MapObject, Door, Coordinate, PointOfInterest, Annotation, Hyperlink, Image, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, };
+    export { Node, Area, MapDataInternal, Space, Floor, FloorStack, Facade, Connection, MapObject, Door, Coordinate, PointOfInterest, Annotation, Hyperlink, Image, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, LocationCategory, LocationProfile, };
     export type { TSpaceType } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/space';
     export type { Places };
 }
@@ -1664,6 +1716,16 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view' {
                 * @internal
                 */
             Debug: Debug;
+            /**
+                * Takes a screenshot of the current scene and returns it as a data URL.
+                *
+                * NOTE: This only captures the 3D scene, not the UI elements like labels, markers, etc.
+                * Also, this does not cause the screenshot to be saved to the user's device, it only returns
+                * the data.
+                * @returns A Promise that resolves with the screenshot as a base64-encoded data URL string
+                * @experimental
+                */
+            takeScreenshot(): Promise<string>;
     }
 }
 
@@ -1772,7 +1834,7 @@ declare module '@mappedin/react-sdk/geojson/src' {
       */
     export { enableTestMode } from '@mappedin/react-sdk/geojson/src/services/test-mode';
     export { mountSceneGraphVisualizer };
-    export type { EntityId, EntityState, LineStyle, PaintStyle, ModelProperties, Shading } from '@mappedin/react-sdk/geojson/src/types';
+    export type { EntityId, EntityState, LineStyle, PaintStyle, ModelProperties, Shading, ImagePlacementOptions, } from '@mappedin/react-sdk/geojson/src/types';
     export type * from 'geojson';
     export type { WatermarkUpdateOptions, WatermarkOptions, WatermarkPosition } from '@mappedin/react-sdk/geojson/src/systems/watermark/system';
     export { preloadFont } from '@mappedin/react-sdk/geojson/src/systems/text3d/system';
@@ -1860,10 +1922,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/maplibre-overlay' {
 
 declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     import type { Feature, MultiPolygon, Polygon } from 'geojson';
-    import type { Coordinate, Floor, Door, Space, MapObject, PointOfInterest, Connection, EnterpriseLocation, Node, Area, Facade, FloorStack, Annotation, EnterpriseCategory, EnterpriseVenue } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { Coordinate, Floor, Door, Space, MapObject, PointOfInterest, Connection, EnterpriseLocation, Node, Area, Facade, FloorStack, Annotation, EnterpriseCategory, EnterpriseVenue, LocationCategory, LocationProfile } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import type { Label, Marker, Model, Image, Shape, Text3D } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
     import type { Language, ParsedMVFLocalePack } from '@mappedin/mvf';
-    import type { InsetPaddingOption, UpdatableText3DState, Text3DState, AddText3DOptions, EnvMapOptions, InitializeModelState, ModelState, UpdateModelState } from '@mappedin/react-sdk/geojson/src';
+    import type { InsetPaddingOption, UpdatableText3DState, Text3DState, AddText3DOptions, EnvMapOptions, InitializeModelState, ModelState, UpdateModelState, ImagePlacementOptions } from '@mappedin/react-sdk/geojson/src';
     export type DeepRequired<T> = Required<{
             [K in keyof T]: T[K] extends Required<T[K]> ? T[K] : DeepRequired<T[K]>;
     }>;
@@ -2240,7 +2302,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     /**
         * Defines the target for navigation operations.
         */
-    export type TNavigationTarget = Space | MapObject | Coordinate | Door | PointOfInterest | Connection | EnterpriseLocation | Node | Area | Facade;
+    export type TNavigationTarget = LocationProfile | Annotation | Space | MapObject | Coordinate | Door | PointOfInterest | Connection | EnterpriseLocation | Node | Area | Facade;
     /**
         * Defines the special zone for navigation operations.
         */
@@ -2574,7 +2636,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
             /**
                 * The target for the model to be placed on.
                 */
-            target: Space | Door | Coordinate;
+            target: IAnchorable;
             /**
                 * Optional. Determines the opacity of the model.
                 * @default 1
@@ -2814,6 +2876,15 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
             localePack: ParsedMVFLocalePack;
     };
     export type GlobalState = {
+            /**
+                * The color of the background, in hex format(#000000).
+                */
+            backgroundColor: string;
+            /**
+                * The alpha value of the background, between 0 and 1.
+                * @default 1
+                */
+            backgroundAlpha: number;
             /**
                 * environment map for reflections.
                 * @default 'basic'
@@ -2843,6 +2914,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     export interface IFocusable {
             get focusTarget(): TFocusTarget | TFocusTarget[];
     }
+    export interface INavigatable {
+            get navigationTarget(): TNavigationTarget | TNavigationTarget[];
+    }
     /**
         * A class that implements IAnchorable can have 2D elements like {@link Label}s and {@link Marker}s anchored to it.
         */
@@ -2853,6 +2927,8 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
         * Associates MapData type strings with their corresponding classes.
         */
     export type TMapDataObjectTypes = {
+            'location-profile': LocationProfile;
+            'location-category': LocationCategory;
             node: Node;
             space: Space;
             door: Door;
@@ -2868,6 +2944,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
             area: Area;
             facade: Facade;
     };
+    /**
+        * @interface
+        * @internal
+        */
+    export type TImagePlacementOptions = ImagePlacementOptions;
 }
 
 declare module '@mappedin/react-sdk/mappedin-js/src/constants' {
@@ -2888,6 +2969,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/constants' {
         outdoorView: {
             layersHiddenByGeometry: string[];
         };
+        imagePlacementOptions: {
+            mode: "default";
+        };
     };
     export const EXTERIOR_WALLS_ID = "ExteriorWalls";
     export const WALLS_ID = "Walls";
@@ -2898,6 +2982,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/constants' {
     export const LABELS_LAYER = "LabelsLayer";
     export const MARKERS_LAYER = "MarkersLayer";
     export const FOOTPRINT_LAYER = "FootprintLayer";
+    export const OCCLUSION_LAYER = "OcclusionLayer";
     export const IMAGES_LAYER = "ImagesLayer";
     export const SELF_SERVE_API_AUDIENCE: string[];
     export const ENTERPRISE_API_AUDIENCE: string[];
@@ -3087,6 +3172,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/sta
     import { type Floor } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     import { type TCameraAnimationOptions } from '@mappedin/react-sdk/mappedin-js/src';
     export const GAP_BELOW_FLOORS = 50;
+    export const DEBUG = false;
     export const DURATION = 1000;
     export type TStackedMapsState = 
     /**
@@ -3109,8 +3195,21 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/sta
             includedFloors?: Floor[];
             /**
                 * The distance between floors in the stack in meters.
+                * - When set to 'auto', the system automatically calculates the optimal distance
+                *   needed to visually separate first two floors in the current view.
+                * - When set to a numeric value, that exact distance in meters is used between each floor.
+                * @default 50
+                *
+                * @example
+                * // Use automatic distance calculation
+                * await mapView.StackedMaps.expand({ distanceBetweenFloors: 'auto' });
+                * console.log(mapView.distanceBetweenFloors) // output: computed value
+                *
+                * // Use fixed distance of 75 meters between floors
+                * mapView.StackedMaps.expand({ distanceBetweenFloors: 75 });
+                * console.log(mapView.distanceBetweenFloors) // output: 75 as specified
                 */
-            distanceBetweenFloors?: number;
+            distanceBetweenFloors?: number | 'auto';
             /**
                 * The pan mode to use when animating the camera.
                 * @default 'elevation'
@@ -3147,9 +3246,42 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/stacked-maps/sta
                 */
             get expanded(): boolean;
             /**
-                * The distance between floors in the stack in meters.
+                * Gets the distance between floors in meters.
+                *
+                * This property returns different values based on how the `expand()` method was called:
+                *
+                * - When `expand()` was called with `distanceBetweenFloors: 'auto'`, this returns the computed
+                *   value needed to visually separate the first two floors in clip space.
+                * - When `expand()` was called with a numeric value (e.g., `distanceBetweenFloors: 50`),
+                *   this returns that specified value.
+    
+                     * This value is cached for performance until `clearCachedFloorSeparationDistance()` is called
+                     * to force a recalculation.
+                *
+                * @example
+                * // Using automatic floor separation distance
+                * await mapView.StackedMaps.expand({ distanceBetweenFloors: 'auto' });
+                * console.log(mapView.StackedMaps.distanceBetweenFloors); // Returns computed separation value
+                *
+                * // Using fixed floor separation distance
+                * await mapView.StackedMaps.expand({ distanceBetweenFloors: 50 });
+                * console.log(mapView.StackedMaps.distanceBetweenFloors); // Returns 50
                 */
-            get gapBelowFloors(): number;
+            get distanceBetweenFloors(): number;
+            /**
+                * Clears the cached value for the computed distance between floors.
+                *
+                * Call this method to invalidate the calculation of the optimal distance between floors
+                * when using `distanceBetweenFloors: 'auto'` option with the expand() method. This is useful
+                * when the camera position or viewport has changed significantly, which may affect the optimal
+                * floor separation distance.
+                *
+                * @example
+                * // Force recalculation before expanding with auto distance
+                * mapView.StackedMaps.clearCachedFloorSeparationDistance();
+                * await mapView.StackedMaps.expand({ distanceBetweenFloors: 'auto' });
+                */
+            clearCachedFloorSeparationDistance(): void;
             /**
                 * The factor of the expanded floor stack. 0 is collapsed, 1 is fully expanded.
                 */
@@ -3520,11 +3652,19 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/directions' {
             /**
                 * @internal
                 */
-            constructor(directions: DirectionsCollection, mapData: MapDataInternal);
+            constructor(directions: DirectionsCollection, mapData: MapDataInternal, from: TNavigationTarget[], to: TNavigationTarget[]);
             /**
                 * @internal
                 */
             get path(): Node[];
+            /**
+                * The selected departure.
+                */
+            get departure(): TNavigationTarget;
+            /**
+                * The selected destination.
+                */
+            get destination(): TNavigationTarget;
             /**
                 * All the coordinates ({@link Coordinate}) of the directions.
                 */
@@ -3574,6 +3714,14 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/directions' {
                 */
             getExcludedNodeIds: (accessible: boolean, excludedConnections: Connection[]) => string[];
     }
+    /**
+        * Get the nodes from the navigation target.
+        *
+        * @hidden
+        * @param target
+        * @param mapData
+        */
+    export function getNodesFromTarget(target: TNavigationTarget, mapData: MapDataInternal): string[];
 }
 
 declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/types' {
@@ -3589,7 +3737,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/types' {
     import type { PartialExcept } from '@mappedin/mvf/dist/locale';
     import type { LocalePackUrls } from '@packages/internal/mvf-utils';
     import type { LanguagePackHydrationItem } from '@mappedin/react-sdk/mappedin-js/src/types';
-    import type { EnvControl } from '@packages/internal/mvf-utils/mvf-utils';
+    import type { EnvControl, TGetMapDataOptions } from '@packages/internal/mvf-utils/mvf-utils';
     /**
         * Places are the main objects that can be searched for.
         */
@@ -3618,6 +3766,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/types' {
             languagePacks?: LanguagePackHydrationItem[];
             binaryBundle?: Uint8Array;
             sasToken?: string;
+            getMapDataOptions?: TGetMapDataOptions;
     };
     /**
         * A class that implements IGeoJSONData has a underlying GeoJSON datathat can be accessed.
@@ -3762,6 +3911,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/node' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
                     neighbors: string[];
             };
@@ -3996,6 +4146,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/door' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4136,6 +4287,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/space' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4194,6 +4346,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/floor' {
                 * @returns {string} The name of the floor.
                 */
             get name(): string;
+            /**
+                * Gets the short name of the floor (i.e. "F1", "L, "2", etc.).
+                * Used in space constrained lists and Often aligns with what is displayed on an elevator.
+                *
+                * @returns {string} The short name of the floor.
+                */
+            get shortName(): string;
             /**
                 * Gets the external ID of the floor.
                 *
@@ -4368,6 +4527,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/connection'
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     }[];
                     floors: string[];
             };
@@ -4484,6 +4644,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/object' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4498,6 +4659,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/object' {
 
 declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/coordinate' {
     import type { IFocusable, IAnchorable } from '@mappedin/react-sdk/mappedin-js/src/types';
+    type TCoordinateParams = {
+            latitude: number;
+            longitude: number;
+            floorId?: string;
+            verticalOffset?: number;
+    };
     /**
         * Class representing a pseudo-mercator coordinate.
         *
@@ -4530,6 +4697,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/coordinate'
                 * The floor ID of the coordinate.
                 */
             readonly floorId?: string;
+            /**
+                * The vertical position of the coordinate, offset from the floor.
+                * @internal
+                */
+            readonly verticalOffset: number;
             /**
                 * Checks if the provided instance is of type Coordinate.
                 *
@@ -4540,7 +4712,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/coordinate'
             /**
                 * @internal
                 */
-            constructor(latitude: number, longitude: number, floorId?: string);
+            constructor(latitudeOrParams: TCoordinateParams);
+            /**
+                * @deprecated
+                * @internal
+                */
+            constructor(latitudeOrParams: number, longitude: number, floorId?: string);
             /**
                 * @internal
                 */
@@ -4565,6 +4742,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/coordinate'
                     latitude: number;
                     longitude: number;
                     floor: string | undefined;
+                    verticalOffset: number;
             };
             /**
                 * Cleans up resources used by the instance.
@@ -4669,6 +4847,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/poi' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4775,6 +4954,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/annotation'
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -5038,8 +5218,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/facade' {
 
 declare module '@mappedin/react-sdk/mappedin-js/src/utils/data-creation' {
     import type { AnnotationCollection, EntranceCollection, FeatureCollection, Connection as MVFConnection, EnterpriseCategory as MVFEnterpriseCategory, EnterpriseCategoryId as MVFEnterpriseCategoryId, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseLocationId as MVFEnterpriseLocationId, EnterpriseVenue as MVFEnterpriseVenue, FloorProperties as MVFFloor, FloorStack as MVFFloorStack, NodeCollection, ObstructionCollection, ParsedMVF, Point, SpaceCollection, SpaceProperties, AreaCollection, AreaId, EnterpriseLocationInstance } from '@mappedin/mvf';
-    import type { MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
-    import { Annotation, Area, Connection, Door, EnterpriseCategory, EnterpriseLocation, Facade, Floor, FloorStack, MapObject, Node, PointOfInterest, Space } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import { Annotation, Area, Connection, Door, EnterpriseCategory, EnterpriseLocation, Facade, Floor, FloorStack, MapObject, Node, PointOfInterest, Space, LocationCategory, LocationProfile, type MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
     export type MapDataRecords = {
             spacesById: Record<string, Space>;
             nodesById: Record<string, Node>;
@@ -5054,6 +5233,10 @@ declare module '@mappedin/react-sdk/mappedin-js/src/utils/data-creation' {
             poisById: Record<string, PointOfInterest>;
             annotationsById: Record<string, Annotation>;
             areasById: Record<AreaId, Area>;
+            locationProfilesById: Record<string, LocationProfile>;
+            locationCategoriesById: Record<string, LocationCategory>;
+            locationProfilesByCategoryId: Record<string, LocationProfile[]>;
+            locationCategoriesByParentId: Record<string, LocationCategory[]>;
             spacesByExternalId: Record<string, Space[]>;
             nodesByExternalId: Record<string, Node[]>;
             poisByExternalId: Record<string, PointOfInterest[]>;
@@ -5062,6 +5245,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/utils/data-creation' {
             floorsByExternalId: Record<string, Floor[]>;
             objectsByExternalId: Record<string, MapObject[]>;
             areasByExternalId: Record<string, Area[]>;
+            locationProfilesByExternalId: Record<string, LocationProfile[]>;
             spaceIdsByDestinationNodeId: Record<string, string[]>;
             objectEntranceNodeIdsByObstructionId: Record<string, string[]>;
             obstructionIdByEntranceId: Record<string, string>;
@@ -5105,6 +5289,13 @@ declare module '@mappedin/react-sdk/mappedin-js/src/utils/data-creation' {
             mvfLocationsById: Record<string, MVFEnterpriseLocation>;
             mvfLocationsBySpaceId: Record<string, MVFEnterpriseLocation[]>;
     };
+    export const processMVFLocationProfilesAndCategories: (mvf: ParsedMVF, data: MapDataInternal) => {
+            locationCategoriesByParentId: Record<string, LocationCategory[]>;
+            locationProfilesById: Record<string, LocationProfile>;
+            locationCategoriesById: Record<string, LocationCategory>;
+            locationProfilesByExternalId: Record<string, LocationProfile[]>;
+            locationProfilesByCategoryId: Record<string, LocationProfile[]>;
+    };
     export const processMVFSpaces: (mvf: ParsedMVF, data: MapDataInternal) => Pick<MapDataRecords, "spacesById" | "spacesByExternalId" | "spaceIdsByDestinationNodeId" | "poisById" | "poisByExternalId" | "mvfSpacesById" | "objectEntranceNodeIdsByObstructionId" | "connectionsById" | "connectionIdsByLatLon" | "mvfSpacesByFloorId" | "mvfPoisByFloorId">;
     export const processMVFNodes: (mvf: ParsedMVF, data: MapDataInternal) => Pick<MapDataRecords, "nodesById" | "nodesByExternalId" | "mvfNodesById" | "mvfNodesByFloorId">;
     export const processMVFObstructions: (mvf: ParsedMVF, data: MapDataInternal) => Pick<MapDataRecords, "objectsById" | "objectsByExternalId" | "mvfObstructionById" | "obstructionIdByEntranceId">;
@@ -5531,6 +5722,165 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/venue' {
     export default EnterpriseVenue;
 }
 
+declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location-profile' {
+    import type { LocationId, LocationLink, LocationPicture, LocationSocial, Location as MVFLocation } from '@mappedin/mvf';
+    import BaseMetaData from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-metadata-object';
+    import type { Annotation, Connection, Door, LocationCategory, MapDataInternal, Space, MapObject } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { TFocusTarget, TNavigationTarget, IFocusable, INavigatable } from '@mappedin/react-sdk/mappedin-js/src/types';
+    import { OpeningHours } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/opening-hours';
+    class LocationProfile extends BaseMetaData implements Omit<MVFLocation, 'categories' | 'spaces' | 'obstructions' | 'entrances' | 'shapes' | 'connections' | 'annotations' | 'openingHoursSpecification'>, IFocusable, INavigatable {
+            #private;
+            /**
+                * Checks if the provided instance is of type EnterpriseLocation.
+                *
+                * @param instance The instance to check.
+                * @returns {boolean} True if the instance is a EnterpriseLocation, false otherwise.
+                */
+            static is(instance: object): instance is LocationProfile;
+            /**
+                * @internal
+                */
+            static readonly __type = "location-profile";
+            /**
+                * @internal
+                */
+            readonly __type = "location-profile";
+            id: LocationId;
+            name: string;
+            externalId?: string;
+            description?: string;
+            /**
+                * The location's logo
+                *
+                * @format uri
+                */
+            logo?: string;
+            phone?: string;
+            /**
+                * The location's social media links.
+                */
+            social: LocationSocial[];
+            /**
+                * The location's pictures
+                */
+            pictures: LocationPicture[];
+            /**
+                * Web links for the location
+                */
+            links: LocationLink[];
+            constructor(data: MapDataInternal, options: {
+                    mvfData: MVFLocation;
+            });
+            /**
+                * Gets the {@link Space}s associated with the location.
+                *
+                * @returns {Space[]} The spaces array.
+                */
+            get spaces(): Space[];
+            /**
+                * Gets the {@link Door}s associated with the location.
+                *
+                * @returns {Door[]} The doors array.
+                */
+            get doors(): Door[];
+            /**
+                * Gets the {@link Connection}s associated with the location.
+                *
+                * @returns {Connection[]} The connections array.
+                */
+            get connections(): Connection[];
+            /**
+                * Gets the {@link Annotation}s associated with the location.
+                *
+                * @returns {Annotation[]} The annotations array.
+                */
+            get annotations(): Annotation[];
+            /**
+                * Gets the {@link LocationCategory}s associated with the location.
+                *
+                * @returns {LocationCategory[]} The location categories array.
+                */
+            get categories(): LocationCategory[];
+            /**
+                * Gets the {@link MapObject}s associated with the location.
+                *
+                * @returns {MapObject[]} The map objects array.
+                */
+            get mapObjects(): MapObject[];
+            /** @internal */
+            get focusTarget(): TFocusTarget[];
+            /**
+                * Gets the {@link OpeningHours} associated with the location.
+                *
+                * @returns {OpeningHours} The opening hours.
+                */
+            get openingHours(): OpeningHours;
+            /**
+                * @internal
+                */
+            get navigationTarget(): TNavigationTarget[];
+            toJSON(): {
+                    id: string;
+                    name: string;
+            };
+    }
+    export default LocationProfile;
+}
+
+declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location-category' {
+    import type { CategoryId, Category as MVFCategory } from '@mappedin/mvf';
+    import BaseMetaData from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-metadata-object';
+    import type { LocationProfile, MapDataInternal } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    class LocationCategory extends BaseMetaData implements Omit<MVFCategory, 'parent'> {
+            #private;
+            /**
+                * Checks if the provided instance is of type EnterpriseLocation.
+                *
+                * @param instance The instance to check.
+                * @returns {boolean} True if the instance is a EnterpriseLocation, false otherwise.
+                */
+            static is(instance: object): instance is LocationCategory;
+            /**
+                * @internal
+                */
+            static readonly __type = "location-category";
+            /**
+                * @internal
+                */
+            readonly __type = "location-category";
+            id: CategoryId;
+            name: string;
+            /**
+                * The category's icon
+                *
+                * @format uri
+                */
+            icon: string;
+            constructor(data: MapDataInternal, options: {
+                    mvfData: MVFCategory;
+            });
+            /**
+                * Gets the parent {@link LocationCategory}.
+                *
+                * @returns {LocationCategory | undefined} The parent location category.
+                */
+            get parent(): LocationCategory | undefined;
+            /**
+                * Gets the children {@link LocationCategory}s.
+                */
+            get children(): LocationCategory[];
+            /**
+                * Gets the {@link LocationProfile}s that are associated with this category.
+                */
+            get locationProfiles(): LocationProfile[];
+            toJSON(): {
+                    id: string;
+                    name: string;
+            };
+    }
+    export default LocationCategory;
+}
+
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/shapes' {
     import type { GeojsonApiMapObject } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object';
     import { Shape } from '@mappedin/react-sdk/mappedin-js/src/map-view-objects';
@@ -5678,6 +6028,10 @@ declare module '@mappedin/react-sdk/geojson/src/components/marker' {
                         * The z-index of the marker. Can be used used in conjunction with rank: 'always-visible' to make certain markers appear over others
                         */
                     zIndex?: number;
+                    /**
+                        * The vertical position of the marker relative to the floor.
+                        */
+                    verticalOffset?: number;
             };
             /**
                 * 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.
@@ -5742,10 +6096,18 @@ declare module '@mappedin/react-sdk/geojson/src/components/marker' {
                 * Dynamic resize of the marker. If set to true, the marker will resize based on the content.
                 */
             dynamicResize?: boolean;
+            /**
+                * @internal
+                */
+            occluderId?: number;
             /**
                 * The z-index of the marker. Can be used used in conjunction with rank: 'always-visible' to make certain markers appear over others
                 */
             zIndex?: number;
+            /**
+                * The vertical position of the marker relative to the floor.
+                */
+            verticalOffset?: number;
     };
     export class MarkerComponent {
             id: string | number;
@@ -5765,6 +6127,7 @@ declare module '@mappedin/react-sdk/geojson/src/components/marker' {
                 */
             canShow: boolean;
             visible: boolean;
+            isOccluded: boolean;
             offscreen: boolean;
             strategyIndex: number;
             activeBoundingBox: {
@@ -5781,6 +6144,8 @@ declare module '@mappedin/react-sdk/geojson/src/components/marker' {
                     left: string;
             };
             dirty: boolean;
+            /** Flag used in 2d-projection system to determine if the parent has changed */
+            parentDirty: boolean;
             collisionDirty: boolean;
             visibilityNeedsUpdate: 'show' | 'hide' | false;
             constructor(contentHtml: string, options?: AddMarkerOptions);
@@ -6371,6 +6736,14 @@ declare module '@mappedin/react-sdk/geojson/src/components/label' {
                 * @internal
                 */
             id?: string;
+            /**
+                * @internal
+                */
+            occluderId?: number;
+            /**
+                * The vertical position of the label relative to the floor.
+                */
+            verticalOffset?: number;
     };
     type TStyle = {
             top?: number;
@@ -6440,7 +6813,7 @@ declare module '@mappedin/react-sdk/geojson/src/components/label' {
             /**
                 * The parent container of the label
                 */
-            readonly parent: EntityId<GroupContainerState> | string | number;
+            readonly parent: EntityId<GroupContainerState>;
             /**
                 * Whether the label is enabled
                 */
@@ -6463,6 +6836,10 @@ declare module '@mappedin/react-sdk/geojson/src/components/label' {
                 * Options for the label
                 */
             options: Omit<AddLabelOptions, 'id'>;
+            /**
+                * vertical offset of the model in meters off the floor
+                */
+            verticalOffset: number;
     };
     export class LabelComponent {
             lines: number;
@@ -6484,6 +6861,7 @@ declare module '@mappedin/react-sdk/geojson/src/components/label' {
             options: LabelOptions;
             visible: boolean;
             enabled: boolean;
+            isOccluded: boolean;
             offscreen: boolean;
             /**
                 * Whether the label can be shown, which is decided by the collision engine
@@ -6502,6 +6880,8 @@ declare module '@mappedin/react-sdk/geojson/src/components/label' {
             currentStrategyIndex: number;
             totalMarkerSize: number;
             dirty: boolean;
+            /** Flag used in 2d-projection system to determine if the parent has changed */
+            parentDirty: boolean;
             collisionDirty: boolean;
             lastTextAlign: any;
             imageHash?: number;
@@ -6546,6 +6926,7 @@ declare module '@mappedin/react-sdk/geojson/src/entities/group-container' {
     import type { InteractionComponent } from '@mappedin/react-sdk/geojson/src/components/interaction';
     import type { BatchedText } from '@mappedin/react-sdk/geojson/src/services/text3d/text3d';
     import type { EntityTypes } from '@mappedin/react-sdk/geojson/src/renderer';
+    import type { Feature, MultiPolygon, Polygon } from 'geojson';
     export enum GroupContainerComponents {
             Stack = 0,
             Interaction = 1
@@ -6578,9 +6959,13 @@ declare module '@mappedin/react-sdk/geojson/src/entities/group-container' {
                     entityId: string | number;
                     entities2D: Set<string | number>;
                     dirty: boolean;
+                    occluderDirty: boolean;
+                    occluderId?: number;
+                    occluderFeature?: Feature<Polygon | MultiPolygon, any>;
             };
             components: [StackComponent?, InteractionComponent?];
             constructor(id: string);
+            addOccluderFeature(feature: Feature<Polygon | MultiPolygon, any>, occluderId: number): void;
             addEntity(entityGroupOrContainer: GroupContainerObject3D | GeometryGroupObject3D | Geometry2D | Geometry3DTypes): void;
             removeEntity(entityGroupOrContainer: EntityTypes): void;
             setVisible(visible: boolean): void;
@@ -6873,7 +7258,6 @@ declare module '@mappedin/react-sdk/geojson/src/types' {
                 */
             type?: InsetPadding['type'];
     };
-    export * from '@mappedin/react-sdk/geojson/src/types/constants';
     /**
         * Result of a user click event.
         */
@@ -6989,6 +7373,10 @@ declare module '@mappedin/react-sdk/geojson/src/types' {
                 * Fired before the scene is rendered. Use this to modify the scene before it is rendered.
                 */
             'pre-render': undefined;
+            /**
+                * Fired when the synchronous tasks of the scene render are complete.
+                */
+            'post-render': undefined;
     };
     /**
         * The payload of an event. See also {@link MapEvent}.
@@ -7025,18 +7413,70 @@ declare module '@mappedin/react-sdk/geojson/src/types' {
         * All of the entities in the scene
         */
     export type EntityTypes = Geometry3DTypes | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D;
+    /** @internal */
+    export type TransformImageRequest = (url: string) => Promise<{
+            url: string;
+    }>;
+    /**
+        * The mode to use for auto image placement.
+        * - `default` will currently not rotate the image, but in the future it may be settable per-image, in which case this mode will use that setting.
+        * - `none` will not rotate the image.
+        * - `nearest 90` may rotate the image 90 degrees to fit the polygon better.
+        * - `initial bearing` will rotate the images to face the initial bearing of the map view, then try to fit them to their polygon.
+        *
+        * @internal
+        */
+    export type ImagePlacementMode = 'default' | 'none' | 'fit-nearest-90' | 'fit-initial-bearing';
+    /**
+        * Options for configuring how images are automatically placed on polygons.
+        *
+        * @internal
+        */
+    export type ImagePlacementOptions = {
+            /**
+                * The mode to use for auto image placement. See {@link ImagePlacementMode} for more information.
+                * @defaultValue 'default'
+                */
+            mode?: ImagePlacementMode;
+            /**
+                * Scale factor applied to the resulting rectangle dimensions.
+                * Values less than 1 create a safety margin inside the polygon.
+                * @defaultValue 0.9
+                */
+            scaleFactor?: number;
+            /**
+                * Controls the balance between optimizing for rectangle area vs. proximity to center.
+                * Higher values prioritize center alignment over size.
+                * @defaultValue 0.5
+                */
+            centerPriority?: number;
+            /**
+                * Resolution of the grid used for finding the rectangle.
+                * Higher values provide more precise results but require more computation.
+                * @defaultValue 100
+                */
+            resolution?: number;
+            /**
+                * Threshold ratio for determining when to fall back to the original rectangle.
+                * If the calculated rectangle is smaller than this ratio of the original,
+                * the original rectangle will be returned instead.
+                * @defaultValue 0.5
+                */
+            minimumSizeRatio?: number;
+    };
 }
 
 declare module '@mappedin/react-sdk/geojson/src/components/mesh' {
     import type { Texture, BufferGeometry, LineSegments, Mesh } from 'three';
     import { BatchedMesh, Color, Vector3 } from 'three';
     import type { BatchedStandardMaterial } from '@mappedin/react-sdk/geojson/src/systems/mesh-creation-and-optimization/batched-material';
-    import type { Position } from '@mappedin/react-sdk/geojson/src/types';
+    import type { EntityId, Position } from '@mappedin/react-sdk/geojson/src/types';
     import type { Feature, LineString, MultiLineString, MultiPolygon, Polygon, Position as GeoJsonPosition } from 'geojson';
     import type { BBox } from '@turf/turf';
     import { type ImageProperties } from '@mappedin/react-sdk/geojson/src/components/image';
     import { type BaseTextAreaProperties } from '@mappedin/mvf';
     import type { Text } from 'troika-three-text';
+    import type { GeometryGroupState } from '@mappedin/react-sdk/geojson/src/entities/geometry-group';
     export class EntityBatchedMesh extends BatchedMesh {
             type: "entityBatchedMesh";
             userData: {
@@ -7066,6 +7506,10 @@ declare module '@mappedin/react-sdk/geojson/src/components/mesh' {
                 * The position of the geometry in [lon, lat]
                 */
             readonly position: Position;
+            /**
+                * The parent group of the geometry
+                */
+            readonly parent: EntityId<GeometryGroupState>;
             /**
                 * Whether the geometry is visible. This is independent of the visibility of the children, but will affect the visibility of the children if set to false.
                 */
@@ -7551,7 +7995,7 @@ declare module '@mappedin/react-sdk/geojson/src/components/model' {
 
 declare module '@mappedin/react-sdk/geojson/src/renderer' {
     import './utils/object-this-polyfill';
-    import { Scene, Vector3, Raycaster, Camera as ThreeCamera } from 'three';
+    import { PerspectiveCamera, Scene, Vector3, Raycaster, Camera as ThreeCamera } from 'three';
     import type { GroupContainerState } from '@mappedin/react-sdk/geojson/src/entities/group-container';
     import { GroupContainerObject3D } from '@mappedin/react-sdk/geojson/src/entities/group-container';
     import { PubSub } from '@mappedin/react-sdk/packages/common/pubsub';
@@ -7595,10 +8039,10 @@ declare module '@mappedin/react-sdk/geojson/src/renderer' {
     import type { AddText3DOptions, Text3DState, UpdatableText3DState } from '@mappedin/react-sdk/geojson/src/components/text3d';
     import { MeshDetachmentSystem } from '@mappedin/react-sdk/geojson/src/systems/mesh-detachment/system';
     import { MeshModificationSystem } from '@mappedin/react-sdk/geojson/src/systems/mesh-modification/system';
-    import { PreRenderSystem } from '@mappedin/react-sdk/geojson/src/systems/pre-render/system';
     import { Text3DSystem } from '@mappedin/react-sdk/geojson/src/systems/text3d/system';
     import { Group as TweenGroup } from '@tweenjs/tween.js';
     import { Debug } from '@mappedin/react-sdk/geojson/src/utils/debug';
+    import { Occlusion2DSystem } from '@mappedin/react-sdk/geojson/src/systems/2d-occlusion/system';
     export type * from '@mappedin/react-sdk/geojson/src/types';
     export const raycaster: Raycaster;
     /**
@@ -7639,8 +8083,8 @@ declare module '@mappedin/react-sdk/geojson/src/renderer' {
             geometryInFocusSystem: GeometryInFocusSystem;
             meshDetachmentSystem: MeshDetachmentSystem;
             meshModificationSystem: MeshModificationSystem;
-            preRenderSystem: PreRenderSystem;
             text3DSystem: Text3DSystem;
+            occlusion2DSystem: Occlusion2DSystem;
     };
     export type MapViewState = {
             readonly type: 'map-view';
@@ -7701,6 +8145,7 @@ declare module '@mappedin/react-sdk/geojson/src/renderer' {
                 * Add a geometry group from GeoJSON data
                 */
             addGeometryGroup<T extends FeatureCollection<Polygon | MultiPolygon | LineString, any>>(id: string, geometry: T, style?: T extends FeatureCollection<LineString, any> ? LineStyle : PaintStyle, parent?: EntityId<GroupContainerState> | string | number | null): EntityId<GeometryGroupState>;
+            addOccluder<T extends Feature<Polygon | MultiPolygon, any>>(feature: T, parent?: EntityId<GroupContainerState> | string | number | null): number;
             addImage(id: string, geometry: Feature<Point, ImageProperties>, style: ImageStyle, parent?: EntityId<GroupContainerState> | string | null): EntityId<ImageState> | undefined;
             /**
                 * Add a group of models from GeoJSON data. These will be instanced automatically for better performance.
@@ -7770,6 +8215,7 @@ declare module '@mappedin/react-sdk/geojson/src/renderer' {
                 */
             getScene(): GroupContainerState;
             getThreeScene(): Scene | undefined;
+            getThreeCamera(): PerspectiveCamera;
             setEnvironment(update: EnvMapOptions): Promise<void>;
             getEnvironment(): EnvMapOptions;
             /**
@@ -7838,11 +8284,15 @@ declare module '@mappedin/react-sdk/geojson/src/renderer' {
             /**
                 * Sets the background color of the renderer. Only applies to "standalone mode"
                 */
-            setBackgroundColor: (color: any, alpha: any) => void;
+            setBackgroundColor: (color: string, alpha: number) => void;
             /**
                 * Returns  the background color of the renderer. Only applies to "standalone mode"
                 */
-            get backgroundColor(): import("three").Color;
+            get backgroundColor(): string;
+            /**
+                * Returns  the background alpha of the renderer. Only applies to "standalone mode"
+                */
+            get backgroundAlpha(): number;
             /**
                 * internal
                 */
@@ -8614,8 +9064,7 @@ declare module '@mappedin/react-sdk/packages/geojson-navigator' {
 }
 
 declare module '@mappedin/react-sdk/geojson/src/utils' {
-    import type { Box3, Object3D, Camera as THREECamera } from 'three';
-    import { Box2 } from 'three';
+    import type { Object3D, Camera as THREECamera } from 'three';
     import { MercatorCoordinate } from '@mappedin/react-sdk/packages/outdoor-context-v4';
     import type { CustomLayerInterface } from '@mappedin/react-sdk/packages/outdoor-context-v4';
     import type { GeometryGroupObject3D } from '@mappedin/react-sdk/geojson/src/entities/geometry-group';
@@ -8624,6 +9073,7 @@ declare module '@mappedin/react-sdk/geojson/src/utils' {
     import type { Geometry3DTypes } from '@mappedin/react-sdk/geojson/src/entities/geometry3d';
     import type { Position, RendererState } from '@mappedin/react-sdk/geojson/src/renderer';
     import type { Camera } from '@mappedin/react-sdk/geojson/src/camera';
+    export { isFiniteBox } from '@packages/internal/common';
     export function cartesianToGeographic(centerLat: number, centerLon: number, x: number, y: number): {
         lat: number;
         lon: number;
@@ -8691,7 +9141,6 @@ declare module '@mappedin/react-sdk/geojson/src/utils' {
     export function getGeometryByGeometryId(state: RendererState, geometryOrGeometryId?: string | number | Record<string, any>): Geometry3DTypes | GeometryGroupObject3D | GroupContainerObject3D | Geometry2D | undefined;
     export function getBoundingBoxCenter(bbox: Position[]): [number, number];
     export { getCornersOfBoundingBox } from '@mappedin/react-sdk/geojson/src/utils/bounding-box';
-    export function isFiniteBox(box: Box2 | Box3): boolean;
     export { getPixelRatio } from '@mappedin/react-sdk/geojson/src/utils/get-pixel-ratio';
     export { debounce } from '@mappedin/react-sdk/geojson/src/utils/async';
     export { shouldDisableOffscreenCanvas } from '@mappedin/react-sdk/geojson/src/utils/browser';
@@ -8701,6 +9150,8 @@ declare module '@mappedin/react-sdk/geojson/src/utils' {
 }
 
 declare module '@mappedin/react-sdk/geojson/src/utils/constants' {
+    import type { InsetPadding } from '@mappedin/react-sdk/geojson/src/types';
+    export const DEFAULT_INSET_PADDING: InsetPadding;
     export const MAPPEDIN_LAYER_ID = "mappedin";
     export enum ENTITY_3D_LAYERS {
         DEFAULT = 0,
@@ -9077,7 +9528,8 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/map-object' {
             }) => void;
             add: (coordinate: Position, text: string, opts?: AddLabelOptions & {
                 floorId?: string;
-                spaceId?: string;
+                parentId?: string;
+                verticalOffset?: number;
             }) => {
                 id: string | number;
             };
@@ -9200,7 +9652,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/marker' {
 }
 
 declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/image' {
-    import type { Coordinate, Door, Space } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { IAnchorable } from '@mappedin/react-sdk/mappedin-js/src/types';
     /**
         * Class representing an Image on the {@link MapView}.
         */
@@ -9209,7 +9661,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/image' {
             /**
                 * The image's target
                 */
-            readonly target: Space | Door | Coordinate;
+            readonly target: IAnchorable;
             /**
                 * @internal
                 */
@@ -9228,7 +9680,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/image' {
             /**
                 * @internal
                 */
-            constructor(id: string, url: string, target: Space | Door | Coordinate);
+            constructor(id: string, url: string, target: IAnchorable);
             /**
                 * The image's id
                 */
@@ -9392,8 +9844,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-view-objects/text3d' {
 
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
     import type { IFocusable, TCameraAnimationOptions, TCameraTarget, TFocusOnOptions } from '@mappedin/react-sdk/mappedin-js/src/types';
-    import type { InsetPadding, RendererCore } from '@mappedin/core-sdk';
+    import type { InsetPadding } from '@mappedin/core-sdk';
     import { Coordinate } from '@mappedin/react-sdk/mappedin-js/src/map-data-objects';
+    import type { GeoJsonApi } from '@mappedin/react-sdk/mappedin-js/src/api-geojson/api';
     /**
         * 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.
@@ -9407,7 +9860,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/camera' {
             /**
                 * @internal
                 */
-            constructor(rendererCore: RendererCore);
+            constructor(api: GeoJsonApi);
             /**
                 * 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}.
                 *
@@ -10198,10 +10651,9 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/outdoor' {
 }
 
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/images' {
-    import type { TAddImageOptions } from '@mappedin/react-sdk/mappedin-js/src/types';
+    import type { IAnchorable, TAddImageOptions } from '@mappedin/react-sdk/mappedin-js/src/types';
     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.
@@ -10251,7 +10703,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/images' {
                 * // Add an interactive {@link Image} to the map with custom HTML content.
                 * mapView.Images.add(coordinate, '<div>Image Content</div>', { interactive: true });
                 */
-            add(target: Space | Door | Coordinate, url: string, options: TAddImageOptions): Image;
+            add(target: IAnchorable, url: string, options: TAddImageOptions): Image;
             /**
                 * Removes a image from the map.
                 *
@@ -10871,6 +11323,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-object
     import Image from '@mappedin/react-sdk/mappedin-js/src/map-data-objects/image';
     import type { Details } from '@mappedin/mvf';
     export default abstract class BaseMapData {
+            #private;
             /**
                 * The identity of the map data.
                 */
@@ -10888,6 +11341,32 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/base-object
                 * @returns {Image[]} An array of Image objects, or an empty array if no images exist.
                 */
             images: Image[];
+            /**
+                * Gets the bounding box of the geoJSON geometry.
+                *
+                * @returns {BBox} The bounding box of the geoJSON geometry
+                */
+            get geoJSONBoundingBox(): {};
+            get geoJSON(): {
+                    properties: null;
+                    type: string;
+                    geometry: {};
+            };
+    }
+}
+
+declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/opening-hours' {
+    import type { OpeningHoursSpecification } from '@mappedin/mvf';
+    /**
+        * Represents the opening hours of a location.
+        */
+    export class OpeningHours {
+            #private;
+            constructor(mvfData: OpeningHoursSpecification[]);
+            /**
+                * Gets the raw opening hours data.
+                */
+            get raw(): OpeningHoursSpecification[];
     }
 }
 
@@ -11137,14 +11616,16 @@ declare module '@mappedin/react-sdk/geojson/src/entities/geometry2d' {
         id: string | number;
         get type(): 'label' | 'marker';
         get parentObject3D(): GroupContainerObject3D | GeometryGroupObject3D | null;
+        verticalOffset: number;
         /**
           * When the position of the entity changes, this should be set to true, so that systems like pan bounds can update
           */
         positionDirty: boolean;
+        occluderId?: number;
         object3d: Geometry2DObject3D;
         components: [MarkerComponent | LabelComponent, InteractionComponent?];
         disposed: boolean;
-        constructor(ui: MarkerComponent | LabelComponent, position: Vector3);
+        constructor(ui: MarkerComponent | LabelComponent, position: Vector3, verticalOffset?: number);
         get position(): Vector3;
         setAltitude(z: number): void;
     }
@@ -11362,13 +11843,15 @@ declare module '@mappedin/react-sdk/geojson/src/types/options' {
     import type { Position } from '@mappedin/react-sdk/geojson/src/types/geometry';
     import type { Map as MapLibreMap } from '@mappedin/react-sdk/packages/outdoor-context-v4';
     import type { AttributionControlOptions } from '@mappedin/react-sdk/geojson/src/systems/html-controls/system';
-    import type { WatermarkOptions } from '@mappedin/react-sdk/geojson/src';
+    import type { ImagePlacementOptions, WatermarkOptions } from '@mappedin/react-sdk/geojson/src';
+    import type { TransformImageRequest } from '@mappedin/react-sdk/geojson/src/types';
     export type EnvMapOptions = 'basic' | false;
     export type RendererCoreOptions = Partial<{
         center?: Position;
         zoomLevel?: number;
         pitch?: number;
         bearing?: number;
+        naturalBearing?: number;
         outdoorView: {
             headers: {
                 'x-mappedin-tiles-key': string;
@@ -11388,19 +11871,18 @@ declare module '@mappedin/react-sdk/geojson/src/types/options' {
         onWebGLRendererError?: (error: Error) => void;
         watermark?: WatermarkOptions;
         attribution?: AttributionControlOptions;
+        imagePlacementOptions?: ImagePlacementOptions;
         /**
           * environment map for reflections.
           * @default 'basic'
           */
         environment?: EnvMapOptions;
+        occlusionEnabled?: boolean;
+        /** Callback to intercept and modify requests for images. */
+        transformImageRequest?: TransformImageRequest;
     }>;
 }
 
-declare module '@mappedin/react-sdk/geojson/src/types/constants' {
-    import type { InsetPadding } from '@mappedin/react-sdk/geojson/src/types';
-    export const DEFAULT_INSET_PADDING: InsetPadding;
-}
-
 declare module '@mappedin/react-sdk/geojson/src/systems/mesh-creation-and-optimization/batched-material' {
     import { MeshLambertMaterial, type Color, type Texture, type MeshLambertMaterialParameters } from 'three';
     export class BatchedStandardMaterial extends MeshLambertMaterial {
@@ -11603,26 +12085,38 @@ declare module '@mappedin/react-sdk/geojson/src/systems/2d-projection/system' {
 }
 
 declare module '@mappedin/react-sdk/geojson/src/systems/2d-draw/system' {
-    import type { RendererState } from '@mappedin/react-sdk/geojson/src/renderer';
+    import type { RendererState, TransformImageRequest } from '@mappedin/react-sdk/geojson/src/renderer';
     import LabelComponent from '@mappedin/react-sdk/geojson/src/components/label';
+    import { PubSub } from '@packages/internal/common';
     export const INACTIVE_MARKER_SIZE_NO_ICON = 3.5;
     enum TEXTALIGN {
         LEFT = "left",
         CENTER = "center",
         RIGHT = "right"
     }
-    export class TwoDDrawSystem {
+    export class TwoDDrawSystem extends PubSub<{
+        'img:loaded': undefined;
+    }> {
         dirty: boolean;
         state: RendererState;
         colliderContext: CanvasRenderingContext2D;
         colliderCanvas: HTMLCanvasElement;
-        constructor(state: RendererState, colliderCanvas: HTMLCanvasElement);
+        transformRequestFunc?: TransformImageRequest;
+        constructor(state: RendererState, colliderCanvas: HTMLCanvasElement, transformImageRequest?: TransformImageRequest);
+        transformRequest: (url: string) => Promise<{
+            url: string;
+        }>;
         pinCache: {
             [key in number]: [HTMLCanvasElement | OffscreenCanvas, HTMLCanvasElement | OffscreenCanvas];
         };
-        imagePromiseCache: {
+        /** Stores the loaded images ready to be drawn. */
+        imageCache: {
             [key in number]: HTMLImageElement | ImageBitmap;
         };
+        /** Stores the promises for each image fetch. */
+        imagePromiseCache: {
+            [key in number]: Promise<HTMLImageElement | ImageBitmap>;
+        };
         imageDimensionsCache: {
             [key in number]: {
                 width: number;
@@ -11699,6 +12193,8 @@ declare module '@mappedin/react-sdk/geojson/src/systems/render/system' {
     import { PubSub } from '@packages/internal/common';
     export class RenderSystem extends PubSub<{
             'measure-canvas': undefined;
+            'pre-render': undefined;
+            'post-render': undefined;
     }> {
             constructor(renderer: Renderer, state: RendererState, mode: RendererCore['mode'], scene: Scene, cameraObject: PerspectiveCamera, viewCamera: Camera, systems: Systems);
             twoDdirty: boolean;
@@ -11968,7 +12464,7 @@ declare module '@mappedin/react-sdk/geojson/src/systems/outline-interpolation/sy
 }
 
 declare module '@mappedin/react-sdk/geojson/src/systems/image/system' {
-    import type { RendererState } from '@mappedin/react-sdk/geojson/src/renderer';
+    import type { ImagePlacementOptions, RendererState } from '@mappedin/react-sdk/geojson/src/renderer';
     import { type Texture } from 'three';
     import type { RendererCore } from '@mappedin/react-sdk/geojson/src';
     import { PubSub } from '@packages/internal/common';
@@ -11976,7 +12472,7 @@ declare module '@mappedin/react-sdk/geojson/src/systems/image/system' {
     export class ImageSystem extends PubSub<{
         'image-loaded': void;
     }> {
-        constructor(rendererState: RendererState, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition']);
+        constructor(rendererState: RendererState, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition'], initialBearing?: number, naturalBearing?: number, imagePlacementOptions?: ImagePlacementOptions);
         imageLoadingCache: Map<string, Promise<Texture>>;
         update(cameraRotationRadians: number): void;
     }
@@ -12058,16 +12554,21 @@ declare module '@mappedin/react-sdk/geojson/src/systems/mesh-modification/system
     }
 }
 
-declare module '@mappedin/react-sdk/geojson/src/systems/pre-render/system' {
-    import type { RendererCore } from '@mappedin/react-sdk/geojson/src';
-    /**
-      * This system runs any tasks at the very start of the render loop.
-      * This is useful for ensuring that animations are synced with the render loop.
-      */
-    export class PreRenderSystem {
-        #private;
-        constructor(core: RendererCore);
-        update(): void;
+declare module '@mappedin/react-sdk/geojson/src/systems/2d-occlusion/system' {
+    import type { RendererState } from '@mappedin/react-sdk/geojson/src/renderer';
+    import { type Vector3 } from 'three';
+    import type { Renderer } from '@mappedin/react-sdk/geojson/src/services/renderer';
+    import type { Position as GeoJsonPosition } from 'geojson';
+    export function fillArrayWithColor(array: Float32Array | Uint8Array, count: number, color: number): void;
+    export class Occlusion2DSystem {
+        constructor(state: RendererState, convertTo3DMapPosition: (position: GeoJsonPosition) => Vector3, renderer?: Renderer);
+        reserveOccluderId(): number;
+        enable(): void;
+        disable(): void;
+        resize: () => void;
+        activeOccluders: Set<unknown>;
+        update: () => void;
+        destroy(): void;
     }
 }
 
@@ -12449,12 +12950,21 @@ declare module '@mappedin/react-sdk/geojson/src/components/styles/model-style' {
                 * vertical offset of the model in meters off the floor
                 */
             verticalOffset: number;
+            /**
+                * Color property designed for use with @mappedin/3d-assets.
+                * Updates the accent color of 3d assets by applying the color to materials named
+                * ['Default', 'Fabric', 'Mpdn_Logo', 'Fabric_Logo'].
+                * For custom colors on non-Mappedin models, use the {@link ModelStyle.material | material} property.
+                * If both the `material` and `color` properties are provided, `material` property updates will take higher precedence than `color` property updates.
+                */
+            color: string;
     };
     export class ModelStyleComponnet implements Partial<ModelStyle> {
             dirty: boolean;
             visible: boolean;
             opacity: number;
             verticalOffset: number;
+            color?: string;
             material?: ModelStyle['material'];
             constructor(init?: Partial<ModelStyle>);
     }
@@ -12463,7 +12973,7 @@ declare module '@mappedin/react-sdk/geojson/src/components/styles/model-style' {
 
 declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-object' {
     import type { Polygon, MultiPolygon, FloorProperties as MVFFloor, ParsedMVF, Feature } from '@mappedin/mvf';
-    import type { RendererCore } from '@mappedin/core-sdk';
+    import type { RendererCore, BBox } 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';
     class Layer {
@@ -12476,6 +12986,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-object' {
         hide(): void;
     }
     export class FloorObject implements MVFFloor {
+        #private;
         id: string;
         name?: string;
         elevation: number;
@@ -12484,9 +12995,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-object' {
         metadata?: Partial<Record<string, unknown>> | undefined;
         shortName?: string | undefined;
         subtitle?: string | undefined;
+        occluderId?: number;
         layers: Map<string, Layer>;
         footprint?: Feature<Polygon | MultiPolygon | null, MVFFloor>;
         floorStackId: string;
+        get geoJSONBoundingBox(): BBox | undefined;
         constructor(parentId: string, floor: MVFFloor, renderer: RendererCore, multiFloorView: Required<TShow3DMapOptions['multiFloorView']>, options: TShow3DMapOptions, mvf?: ParsedMVF, styleMap?: AggregatedStyleMap);
         load: () => this;
         get visible(): boolean;