@mappedin/react-sdk 6.0.1-beta.32 → 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';
@@ -265,6 +265,11 @@ declare module '@mappedin/react-sdk/mappedin-js/src' {
                         */
                     enabled?: boolean;
             };
+            /**
+                * @experimental
+                * @internal
+                */
+            imagePlacementOptions?: TImagePlacementOptions;
     };
     /**
         * @internal
@@ -898,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.
                 *
@@ -1129,7 +1142,7 @@ 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';
@@ -1235,6 +1248,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects' {
             };
             binaryBundle?: Uint8Array;
             envControl: EnvControl;
+            getMapDataOptions?: TGetMapDataOptions;
             /**
                 * @internal
                 */
@@ -1253,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.
                 *
@@ -1372,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>;
@@ -1698,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>;
     }
 }
 
@@ -1806,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';
@@ -1897,7 +1925,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/types' {
     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]>;
     }>;
@@ -2608,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
@@ -2916,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' {
@@ -2936,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";
@@ -3136,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 = 
     /**
@@ -3158,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'
@@ -3196,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.
                 */
@@ -3654,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.
         */
@@ -3683,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.
@@ -3827,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[];
             };
@@ -4061,6 +4146,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/door' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4201,6 +4287,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/space' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4440,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[];
             };
@@ -4556,6 +4644,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/object' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4570,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.
         *
@@ -4602,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.
                 *
@@ -4612,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
                 */
@@ -4637,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.
@@ -4741,6 +4847,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/poi' {
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -4847,6 +4954,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/annotation'
                             latitude: number;
                             longitude: number;
                             floor: string | undefined;
+                            verticalOffset: number;
                     };
             };
             /**
@@ -5619,7 +5727,8 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location-pr
     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';
-    class LocationProfile extends BaseMetaData implements Omit<MVFLocation, 'categories' | 'spaces' | 'obstructions' | 'entrances' | 'shapes' | 'connections' | 'annotations'>, IFocusable, INavigatable {
+    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.
@@ -5700,6 +5809,12 @@ declare module '@mappedin/react-sdk/mappedin-js/src/map-data-objects/location-pr
             get mapObjects(): MapObject[];
             /** @internal */
             get focusTarget(): TFocusTarget[];
+            /**
+                * Gets the {@link OpeningHours} associated with the location.
+                *
+                * @returns {OpeningHours} The opening hours.
+                */
+            get openingHours(): OpeningHours;
             /**
                 * @internal
                 */
@@ -5913,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.
@@ -5985,6 +6104,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;
     };
     export class MarkerComponent {
             id: string | number;
@@ -6021,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);
@@ -6615,6 +6740,10 @@ declare module '@mappedin/react-sdk/geojson/src/components/label' {
                 * @internal
                 */
             occluderId?: number;
+            /**
+                * The vertical position of the label relative to the floor.
+                */
+            verticalOffset?: number;
     };
     type TStyle = {
             top?: number;
@@ -6684,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
                 */
@@ -6707,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;
@@ -6747,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;
@@ -7123,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.
         */
@@ -7279,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: {
@@ -7320,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.
                 */
@@ -7805,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';
@@ -8025,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;
             /**
@@ -8873,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';
@@ -8883,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;
@@ -8950,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';
@@ -8960,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,
@@ -9336,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;
             };
@@ -9459,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}.
         */
@@ -9468,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
                 */
@@ -9487,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
                 */
@@ -9651,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.
@@ -9666,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}.
                 *
@@ -10457,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.
@@ -10510,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.
                 *
@@ -11130,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.
                 */
@@ -11147,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[];
     }
 }
 
@@ -11396,6 +11616,7 @@ 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
           */
@@ -11404,7 +11625,7 @@ declare module '@mappedin/react-sdk/geojson/src/entities/geometry2d' {
         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;
     }
@@ -11622,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;
@@ -11648,20 +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 {
@@ -11864,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;
@@ -12231,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';
@@ -12239,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;
     }
@@ -12717,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>);
     }
@@ -12731,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 {
@@ -12744,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;
@@ -12756,6 +12999,7 @@ declare module '@mappedin/react-sdk/mappedin-js/src/api-geojson/floor-object' {
         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;