@mappedin/mappedin-js 6.0.1-alpha.7 → 6.0.1-alpha.8

package/lib/esm/index.d.ts

@@ -491,7 +491,7 @@ declare module '@mappedin/mappedin-js/maker/src/events' {
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue' {
-    import type { TGetVenueOptions, TGetVenueOptionsInternal, TVenueMetadata } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
+    import type { TAllGetVenueOptions, TGetVenueOptions, TGetVenueOptionsInternal, TVenueMetadata } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
     import { Mappedin } from '@mappedin/mappedin-js/packages/get-venue/Mappedin';
     import { defaultThings } from '@mappedin/mappedin-js/packages/get-venue/default-things';
     import { GET_VENUE_EVENT } from '@mappedin/mappedin-js/packages/get-venue/internal';
@@ -538,7 +538,10 @@ declare module '@mappedin/mappedin-js/packages/get-venue' {
     import { MAP_RENDER_MODE } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
     import { ParsedMVF } from '@mappedin/mvf';
     export { MAP_RENDER_MODE, GET_VENUE_EVENT };
-    export function parseOptions(options: TGetVenueOptions): TGetVenueOptionsInternal & TGetVenueOptions;
+    /**
+        * @internal
+        */
+    export function parseOptions<T extends TAllGetVenueOptions>(options: T): TGetVenueOptionsInternal<T>;
     /**
         * @internal
         */
@@ -640,7 +643,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue' {
         * Download a bundle and return a Mappedin instance
         * @internal
         */
-    export function downloadBundle(userOptions: any, { url, updated_at }: {
+    export function downloadBundle(userOptions: TGetVenueBundleOptions, { url, updated_at }: {
             url: any;
             updated_at: any;
     }): Promise<Mappedin>;
@@ -691,7 +694,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue' {
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF' {
-    import { Connections, Map as MVFMap, NodeCollection, ObstructionCollection, ParsedMVF, RawMVF, SpaceCollection } from '@mappedin/mvf';
+    import { Connections, Map as MVFMap, NodeCollection, ObstructionCollection, ParsedMVF, RawMVF, SpaceCollection, StyleCollection } from '@mappedin/mvf';
     import { Position } from 'geojson';
     import { TCategory, TLocation, TMap, TMappedinAPI, TNode, TPolygon, TVortex } from '@mappedin/mappedin-js/packages/get-venue';
     import { MVFv1ConnectionCollection, MVFv1LevelCollection, MVFv1NodeCollection, ParsedMVFv1, RawMVFv1, WithIDs, MVFStyle } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF.types';
@@ -766,7 +769,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF' {
             maxLat: number;
             maxLong: number;
     };
-    export function convertPolygons(map: string, mvfObstructions: ObstructionCollection, mvfSpaces: SpaceCollection, deskEntrances: Map<string, TPolygon['entrances']>, styles: WithIDs<MVFStyle>, converter: CoordinateConverter): TPolygon[];
+    export function convertPolygons(map: string, mvfObstructions: ObstructionCollection, mvfSpaces: SpaceCollection, deskEntrances: Map<string, TPolygon['entrances']>, styles: WithIDs<MVFStyle>, layerStyles: StyleCollection, converter: CoordinateConverter): TPolygon[];
     export function convertVortexes(mvfConnections: Connections): TVortex[];
     export function convertVortexes_MVFv1(mvfConnections: MVFv1ConnectionCollection): TVortex[];
     export function overrideMVF(mvf: ParsedMVF, override?: Partial<Pick<ParsedMVF, 'styles.json'>>): ParsedMVF;
@@ -2289,6 +2292,14 @@ declare module '@mappedin/mappedin-js/maker/src/map-view-objects/camera-transfor
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.types' {
+    import type { TGetVenueMVFOptions, TGetVenueMakerOptions } from '@mappedin/mappedin-js/packages/get-venue';
+    import type { DefaultThings } from '@mappedin/mappedin-js/packages/get-venue/default-things';
+    export type MergedThings = {
+            [key in keyof DefaultThings]: string[];
+    } & {
+            [k: string]: string[];
+    };
+    export type ThingsOption = Partial<MergedThings>;
     export type TGetVenueOptions = {
             accessToken?: string;
             clientId?: string;
@@ -2302,22 +2313,44 @@ declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.types' {
                     [key in string]: string;
             };
             venue: string;
-            things?: any;
+            /**
+                * An object specifying additional properties to fetch for each data item.
+                * Each key represents a data item (e.g., 'locations', 'nodes'), and the value is an array of strings indicating extra properties to be included.
+                * @example
+                * For example:
+                * ```
+                * getVenue({
+                *   venue: 'some-venue',
+                *   things: { vortexes: [ 'material' ]
+                * }})
+                * ```
+                */
+            things?: ThingsOption;
             useDraftData?: boolean;
             platformString?: string;
             emitAnalyticsEvents?: boolean;
             secure?: boolean;
             preloadMapGeometry?: boolean;
     };
-    export type TGetVenueOptionsInternal = {
+    export type TProcessedMVFOptions = TGetVenueMakerOptions & {
+            emitAnalyticsEvents: boolean;
+            clientId: string;
+            clientSecret: string;
+            venue: string;
+    };
+    export type TAllGetVenueOptions = TGetVenueOptions | TGetVenueMVFOptions | (TProcessedMVFOptions & {
+            perspective?: string;
+    });
+    export type TGetVenueOptionsInternal<T extends TAllGetVenueOptions> = Omit<T & {
             baseUrl?: string;
             supplementaryUrl?: string;
             noAuth?: boolean;
             includeHidden?: boolean;
             apiGateway?: string;
             authorization?: string;
-            things?: any;
             headers?: any;
+    }, 'things'> & {
+            things?: MergedThings;
     };
     export type TVenueMetadata = {
             languages: {
@@ -2340,14 +2373,14 @@ declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.types' {
 
 declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin' {
     import { Navigator } from '@mappedin/mappedin-js/packages/navigator';
-    import type { TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
+    import type { TAllGetVenueOptions, TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
     import type { MappedinNode, MappedinPolygon, MappedinLocation, MappedinCategory, MappedinVortex, MappedinVenue, MappedinTheme, MappedinRankings, MappedinLocationRankings, MappedinEvent, MappedinLocationState, MappedinMap, MappedinMapGroup, GET_VENUE_PAYLOAD } from '@mappedin/mappedin-js/packages/get-venue/internal';
     import { TAccessors, GET_VENUE_EVENT } from '@mappedin/mappedin-js/packages/get-venue/internal';
     import { IAnalytics } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.CustomerAnalytics';
     import { ParsedMVF } from '@mappedin/mvf';
     import { ParsedMVFv1 } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF.types';
     import { PubSub } from '@mappedin/mappedin-js/packages/get-venue/pub-sub.typed';
-    export const defaultOptions: TGetVenueOptionsInternal & TGetVenueOptions;
+    export const defaultOptions: TGetVenueOptionsInternal<TGetVenueOptions>;
     export class Mappedin extends PubSub<GET_VENUE_PAYLOAD, GET_VENUE_EVENT> {
             #private;
             perspective: any;
@@ -2579,7 +2612,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin' {
             /**
                 * @deprecated Use {@link hydrateVenue} instead
                 */
-            constructor(options: TGetVenueOptionsInternal & TGetVenueOptions);
+            constructor(options: TGetVenueOptionsInternal<TAllGetVenueOptions>);
             analytics: IAnalytics;
             /**
                 * @hidden
@@ -2609,6 +2642,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/default-things' {
         themes: string[];
         rankings: string[];
     };
+    export type DefaultThings = typeof defaultThings;
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue/internal' {
@@ -3737,7 +3771,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF.types' {
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF.utils' {
-    import { Feature, LineString, Polygon } from '@turf/turf';
+    import type { Feature, LineString, Polygon } from '@turf/turf';
     import { EntranceCollection, ObstructionCollection, EntranceProperties, ObstructionProperties, StyleCollection, PolygonStyle, LineStringStyle } from '@mappedin/mvf';
     import { MVFStyle, WithIDs } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF.types';
     export const Z_FIGHTING_ADJUSTMENT_HORIZONTAL_FACTOR = 0.2;
@@ -3751,7 +3785,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.MVF.utils' {
       */
     export const STATIC_MVF_FILES: readonly ["connection.json", "manifest.geojson", "map.geojson", "node.geojson", "styles.json", "mapstack.geojson"];
     export type TStaticMVFFiles = (typeof STATIC_MVF_FILES)[number];
-    export function processObstructions(obstructionCollection: ObstructionCollection, entrances: EntranceCollection, styles?: WithIDs<MVFStyle>): ObstructionCollection;
+    export function processObstructions(obstructionCollection: ObstructionCollection, entrances: EntranceCollection): ObstructionCollection;
     export function isPolygonStyle(style: PolygonStyle | LineStringStyle | undefined): style is PolygonStyle & LineStringStyle;
     export function getStylesMap(styles: StyleCollection): WithIDs<MVFStyle>;
 }
@@ -5372,7 +5406,7 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/MapView.types' {
     import type { Path } from '@mappedin/mappedin-js/packages/legacy-renderer/private/controllers/PathsController';
     import { TOOLTIP_ANCHOR } from '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin.SmartTooltip';
     import { GEOLOCATION_STATUS, COLLISION_RANKING_TIERS, STATE, MARKER_ANCHOR, E_SDK_EVENT, E_BLUEDOT_EVENT, E_CAMERA_EVENT, MAP_RENDER_MODE, CAMERA_EASING_MODE, E_MAP_CHANGED_REASON } from '@mappedin/mappedin-js/packages/legacy-renderer/MapView.enums';
-    import { TOutdoorViewControllerOptions } from '@mappedin/mappedin-js/packages/legacy-renderer/private/controllers/OutdoorViewController';
+    import { TOutdoorViewOptions, TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL } from '@mappedin/mappedin-js/packages/legacy-renderer/private/controllers/OutdoorViewController';
     export type { TEnableBlueDotOptions, TFloatingLabelAppearance };
     /** @internal */
     export type Without<T, U> = {
@@ -5880,7 +5914,7 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/MapView.types' {
                 * Requires `multiBufferRendering` to be enabled.
                 * @experimental
                 */
-            outdoorView?: TOutdoorViewControllerOptions & {
+            outdoorView?: TOutdoorViewOptions & {
                     enabled?: boolean;
             };
             /**
@@ -6078,7 +6112,7 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/MapView.types' {
                 * @experimental
                 * Enable outdoor view. Requires multi-buffer rendering to be enabled
                 */
-            outdoorView?: TOutdoorViewControllerOptions & {
+            outdoorView?: TOutdoorViewOptions & {
                     enabled?: boolean;
             };
             /**
@@ -6583,6 +6617,7 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/MapView.types' {
                 */
             [E_CAMERA_EVENT.TILT_CHANGED]: number;
     };
+    export type { TOutdoorViewOptions, TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL };
     export type { default as BlueDotController } from '@mappedin/mappedin-js/packages/legacy-renderer/private/controllers/BlueDotController';
     export type { default as Journey } from '@mappedin/mappedin-js/packages/legacy-renderer/public/api/Journey';
 }
@@ -8305,6 +8340,17 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin
         assetManager: AssetManager;
         imageVisible: boolean;
         labelVisible: boolean;
+        polygonHeight: number;
+        geometry: ExtrudeGeometry;
+        mesh: Mesh;
+        material: MeshLambertMaterial | MeshLambertMaterial[];
+        labelMesh?: Mesh;
+        imageMesh?: Mesh;
+        /**
+          * For the time being we indicate inflated walls so they don't add to ray casting. Since these are walls it's a good optimization
+          */
+        isInflated: boolean;
+        sortScore: number | null;
         boundingBox: {
             min: {
                 x: number;
@@ -8317,13 +8363,6 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin
                 z: number;
             };
         };
-        polygonHeight: number;
-        geometry: ExtrudeGeometry;
-        mesh: Mesh;
-        material: MeshLambertMaterial | MeshLambertMaterial[];
-        labelMesh?: Mesh;
-        imageMesh?: Mesh;
-        sortScore: number | null;
         static materials: {
             [key in string]: MeshLambertMaterial | MeshLambertMaterial[];
         };
@@ -8339,7 +8378,8 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin
             x: number;
             y: number;
         };
-        static _makeFromCoords(className: any, coords: any, mapClass: any): any;
+        static _makeFromCoords(className: any, coords: any, mapClass: any, element: any): any;
+        static _inflate(coords: any, width: any): any;
         static _setPolygonDefaults(poly: any): any;
         constructor(poly: MappedinPolygon, mapClass: MappedinMap, container: Group, assetManager: any, mapLoadingStrategy?: MAP_RENDER_MODE);
         getBoundingBox(): {
@@ -9797,45 +9837,97 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/private/controlle
     import './OutdoorViewController.scss';
     import type { ICore } from '@mappedin/mappedin-js/packages/legacy-renderer/internal';
     import { XOR } from '@mappedin/mappedin-js/packages/legacy-renderer/MapView.types';
+    /**
+        * Represents the possible positions for map attribution.
+        */
     export type TAttributionPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-    export type TOutdoorViewControllerOptionsWithHeaders = {
-        url?: string;
-        attributionPosition?: TAttributionPosition;
-        customAttribution?: string | string[];
-        headers: {
-            [key: string]: string | null;
-        };
+    /**
+        * Defines the options for an Outdoor View when initialized with headers for authentication.
+        */
+    export type TOutdoorViewOptionsWithHeaders = {
+            /**
+                * The URL to the map style file.
+                * @see https://github.com/maplibre/maplibre-style-spec/
+                */
+            url?: string;
+            /**
+                * The position on the map where the attribution should be displayed.
+                * @default 'bottom-right'
+                */
+            attributionPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+            /**
+                * Custom text or an array of texts to be used for the map attribution.
+                */
+            customAttribution?: string | string[];
+            /**
+                * An object containing HTTP headers for authentication purposes.
+                * */
+            headers: {
+                    [key: string]: string | null;
+            };
     };
-    export type TOutdoorViewControllerOptionsWithAuthURL = {
-        url?: string;
-        authURL?: string;
-        customAttribution?: string | string[];
-        attributionPosition?: TAttributionPosition;
+    /**
+        * Defines the options for an Outdoor View when initialized with a URL for authentication.
+        */
+    export type TOutdoorViewOptionsWithAuthURL = {
+            /**
+                * The URL to the map style file.
+                * @see https://github.com/maplibre/maplibre-style-spec/
+                */
+            url?: string;
+            /**
+                * The URL to obtain an authentication token.
+                */
+            authURL?: string;
+            /**
+                * Custom text or an array of texts to be used for the map attribution.
+                */
+            customAttribution?: string | string[];
+            /**
+                * The position on the map where the attribution should be displayed.
+                * @default 'bottom-right'
+                */
+            attributionPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
     };
-    export type TOutdoorViewControllerOptions = XOR<TOutdoorViewControllerOptionsWithHeaders, TOutdoorViewControllerOptionsWithAuthURL>;
+    /**
+        * Defines the options for initializing an Outdoor View.
+        * This is a union type that requires exclusive or logic,
+        * ensuring that an instance can either have headers or
+        * an authentication URL, but not both.
+        *
+        * Note: It isn't permitted to use `.headers` and `.authURL` options simultaneously.
+        *
+        * @property {string} [url] - The URL to the map style file.
+        * @property {TAttributionPosition} [attributionPosition='bottom-right'] - The position on the map where the attribution should be displayed.
+        * @property {string | string[]} [customAttribution] - Custom text or an array of texts to be used for the map attribution.
+        * @property {Object.<string, string | null>} [headers] - An object containing HTTP headers for authentication purposes. It isn't permitted to use `.headers` and `.authURL` options simultaneously.
+        * @property {string} [authURL] - The URL to obtain an authentication token. It isn't permitted to use `.headers` and `.authURL` options simultaneously.
+        * @interface
+        */
+    export type TOutdoorViewOptions = XOR<TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL>;
     class OutdoorViewController {
-        _attribution: any;
-        core: ICore;
-        map: any;
-        enabled: boolean;
-        hidden: boolean;
-        url: string;
-        authURL: string;
-        headers?: TOutdoorViewControllerOptions['headers'];
-        customAttribution?: string | string[];
-        attributionPosition?: TAttributionPosition;
-        loaded: boolean;
-        constructor(core: ICore, options?: TOutdoorViewControllerOptions);
-        module: any;
-        load(): Promise<void>;
-        get attributions(): any;
-        hide(): void;
-        show(): void;
-        resize(): void;
-        getRequestHeaders: () => Promise<TOutdoorViewControllerOptions['headers']>;
-        render(): void;
-        setStyle(style: any): void;
-        setAttributionPosition(position: TAttributionPosition): void;
+            _attribution: any;
+            core: ICore;
+            map: any;
+            enabled: boolean;
+            hidden: boolean;
+            url: string;
+            authURL: string;
+            headers?: TOutdoorViewOptions['headers'];
+            customAttribution?: string | string[];
+            attributionPosition?: TAttributionPosition;
+            loaded: boolean;
+            constructor(core: ICore, options?: TOutdoorViewOptions);
+            module: any;
+            load(): Promise<void>;
+            get attributions(): any;
+            hide(): void;
+            show(): void;
+            resize(): void;
+            getRequestHeaders: () => Promise<TOutdoorViewOptions['headers']>;
+            render(): void;
+            setStyle(style: any): void;
+            setAttributionPosition(position: TAttributionPosition): void;
     }
     export default OutdoorViewController;
 }
@@ -10092,158 +10184,9 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin
 }
 
 declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils' {
-    import { Box3, Vector3, Object3D, Material } from 'three';
-    import { Mappedin, MapObject, MappedinMap, TMapViewOptions } from '@mappedin/mappedin-js/packages/legacy-renderer/internal';
-    import { Camera } from '@mappedin/mappedin-js/packages/legacy-renderer/public/api/Camera';
-    /**
-        *	Utils function listing
-        *
-        * - scrubMaterial
-        * - getObjectID
-        * - getObject
-        * - getBoundingBox
-        * - getBiggestBoundingBox
-        * - upackBoundingBox
-        * - getMapScale
-        * - throttle -> taken from lodash.js
-        * - getProjectionScaleFactor
-        * - getZoom
-        */
-    export function isGatewayKey(key: string): boolean;
-    export function getCombinedBoundingBox(objects: Object3D[]): Box3;
-    export function getMapsBoundingBox(maps: MapObject[], mapPadding: number): Box3;
-    export function scrubMaterial(material: Material): void;
-    /**
-        * Takes a Mappedin Object or id and returns the ID, so our functions can take bottomRight
-        * @template T extends string | {id: string}
-        * @param {T} object - input can be object containing id or the id itself
-        * @return {string}
-        */
-    export function getObjectId(object: any): string;
-    /**
-        * Takes a Mappedin object or ID and the array to look in and retuns the Object, so our functions can take both
-        */
-    export function getObject<K extends {
-            id: string;
-    }, T extends K | string>(obj: T, array: K[] | undefined): K | undefined;
-    export function getBoundingBox(object: Object3D): Box3;
-    /**
-        * Function pushes the items of the second array onto the first array (inplace).
-        * @template T
-        * @param {Array.<T>} arr1 - base array
-        * @param {Array.<T>} arr2 - array which items will be pushed to arr1
-        */
-    export function appendItems<T>(arr1: T[], arr2: T[]): void;
-    export function getBiggestBoundingBox(objects: Object3D[]): {
-            min: any;
-            max: any;
-    };
-    export function unpackBoundingBox(boundingBox: Box3): Vector3[];
-    export function getMapScale(map: MappedinMap): number;
-    export function getNorth(map: MappedinMap): number;
-    export function throttle<T>(func: () => void, wait: number, options?: any): () => void;
-    export function debounce<T>(func: () => void, wait: number, immediate?: boolean): () => void;
-    export function flatten(list: any[]): any[];
-    export function uniq(arr: any[]): any[];
-    export function toStyleString(styles: Record<string, string>): string;
-    /**
-    /*  getProjectionScaleFactor()
-    /*  finds the scale ratio between screen coordinates and 3D coordinates (in X-Z plane)
-    /*
-                *                                    R
-                *                                  /|
-                *    C : Camera                  /  |
-                *    PQ : Projection Plane     /    |
-                *    OR : Origin             /      |
-                *    F : FOV               /        |
-                *                      Q /          |
-                *                      /|           |
-                *                    /  |           |
-                *                  /    |           |
-                *                /      |           |
-                *              /        |           |
-                *            / F/2      |           |
-                *         C ------------P------------ O
-                *
-                *
-                *   ProjectionScaleFactor = ( OR / PQ )
-                *   PQ = canvasHeight / 2
-                *   CQ = zoom
-                *
-                *   OR / C0 = tan(F/2)
-                *   so OR = CO * tan(F/2)
-                */
-    export function getProjectionScaleFactor(FOV: number, canvasHeight: number, zoom: number): number;
-    /** getZoom
-        *
-        *  C - Camera, OP -- picture plane (canvas), S - origin,
-        *  QR - front side of maps Bounding Box, F: FOV
-        *
-        *                           Z-axis
-        *                     R_____|______
-        *                    /|     |     |
-        *                  /  |     |     |
-        *               P/    |     |     | maps BB
-        *              /|     |     |     |
-        *            /  |     |     |     |
-        *          /    |     |     |     |
-        *        / F    |E    |T    |S    |
-        *    C /--------|-----|-----|-----|------ orthogonal to Y axis, midpoint of focus maps
-        *      \        |     |     |     |
-        *        \      |     |     |     |
-        *          \    |     |     |     |
-        *            \  |     |     |     |
-        *              \|     |     |     |
-        *               O\    |     |     |
-        *                  \  |     |     |
-        *                    \|_____|_____|
-        *                     Q
-        *
-        *
-        * We want to get CS, which is the camera zoom
-        *
-        */
-    export function getZoom(focusBox: Box3, focusBoxHeight: number, FOV: number): number;
-    interface CalculateTwoDProjectionsParams {
-            maps: MapObject[];
-            width: number;
-            height: number;
-            camera: Camera;
-    }
-    export function calculateTwoDProjections({ maps, width, height, camera }: CalculateTwoDProjectionsParams): {
-            min: {
-                    x: number;
-                    y: number;
-            };
-            max: {
-                    x: number;
-                    y: number;
-            };
-    }[];
-    export function splitLine(startNode: Vector3, endNode: Vector3, segments: number): Vector3[];
-    export function isObject(item: any): boolean;
-    export const determineStartingMap: (venue: Mappedin, options: TMapViewOptions) => MappedinMap;
-    export function cyrb53(str: string, seed?: number): number;
-    export function addMarginMultiplierToBoundingBox(bbox: Box3, multiplier: number): Box3;
-    export function tweenPromise({ from, to, duration, easing, delay, onUpdate, onStart, onComplete, }: {
-            from: any;
-            to: any;
-            duration?: number | undefined;
-            easing?: any;
-            delay?: number | undefined;
-            onUpdate?: ((_: any) => void) | undefined;
-            onStart?: (() => void) | undefined;
-            onComplete?: (() => void) | undefined;
-    }): {
-            start(core: any): Promise<void>;
-    };
-    export const linearEase: (t: number) => number;
-    export const quadEaseIn: (t: number) => number;
-    export const quadEaseOut: (t: number) => number;
-    export function interpolate(value: number, inputMin: number, inputMax: number, outputMin: number, outputMax: number, easeFunc?: (t: number) => number): number;
-    export function interpolateMulti(value: number, inputRange: number[], outputRange: number[], easeFunc?: (t: number) => number): number;
-    export function checkWritableBeforeWrite(obj: any, key: string, value: any): void;
-    export {};
+    export * from '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils/utils';
+    export { shouldDisableOffscreenCanvas } from '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils/browser';
+    export { throttle, debounce } from '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils/async';
 }
 
 declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin.MapManager' {
@@ -12317,12 +12260,12 @@ declare module '@mappedin/mappedin-js/packages/get-venue/MappedinMapGroup' {
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue/utils' {
-    import type { TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
+    import type { MergedThings, TGetVenueOptions, TGetVenueOptionsInternal, ThingsOption } from '@mappedin/mappedin-js/packages/get-venue/Mappedin.types';
     import type { MappedinMap } from '@mappedin/mappedin-js/packages/get-venue/internal';
     import { Mappedin, MappedinNavigatable, MappedinNode, MappedinPolygon, MappedinLocation, MappedinCoordinate } from '@mappedin/mappedin-js/packages/get-venue/internal';
     export function isGatewayKey(key: string): boolean;
     export function stringifyQuery(query: any, gateway?: boolean): string;
-    export function buildUrl(options: TGetVenueOptionsInternal & TGetVenueOptions, pathname: string, query: any, supplementary?: boolean): string;
+    export function buildUrl(options: TGetVenueOptionsInternal<TGetVenueOptions>, pathname: string, query: any, supplementary?: boolean): string;
     /**
         * Make a network request to the Mappedin API to fetch an array of objects.
         * @param options options from getVenue- baseUrl and supplementaryUrl are used
@@ -12331,7 +12274,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/utils' {
         * @param supplementary whether to use the supplementaryUrl when sending the request
         * @returns the result json
         */
-    export function getArray(options: TGetVenueOptionsInternal & TGetVenueOptions, pathname: string, query: any, supplementary?: boolean): Promise<any>;
+    export function getArray(options: TGetVenueOptionsInternal<TGetVenueOptions>, pathname: string, query: any, supplementary?: boolean): Promise<any>;
     /**
         * Make a network request to the Mappedin API to fetch an object.
         * @param options options from getVenue- baseUrl and supplementaryUrl are used
@@ -12341,21 +12284,21 @@ declare module '@mappedin/mappedin-js/packages/get-venue/utils' {
         * @param isExpectingArray whether the endpoint returns an array
         * @returns the result json
         */
-    export function getObject(options: TGetVenueOptionsInternal & TGetVenueOptions, pathname: string, query: any, supplementary?: boolean, isExpectingArray?: boolean): Promise<any>;
+    export function getObject(options: TGetVenueOptionsInternal<TGetVenueOptions>, pathname: string, query: any, supplementary?: boolean, isExpectingArray?: boolean): Promise<any>;
     /**
         * Prepares the request and URL fields to pass into generateAPIRequest
         * @param options options from getVenue- baseUrl and supplementaryUrl are used
         * @param url string describing the url corresponding to the client's request
         * @param supplementary whether to use the supplementaryUrl when sending the request
         */
-    export function constructParamsForRequest(options: TGetVenueOptionsInternal & TGetVenueOptions, url: string, supplementary?: boolean): {
+    export function constructParamsForRequest(options: TGetVenueOptionsInternal<TGetVenueOptions>, url: string, supplementary?: boolean): {
             req: {
                     method: string;
                     headers: any;
             };
             url: string;
     };
-    export function generateAPIRequest(options: TGetVenueOptionsInternal & TGetVenueOptions, url: string, supplementary?: boolean): Promise<any>;
+    export function generateAPIRequest(options: TGetVenueOptionsInternal<TGetVenueOptions>, url: string, supplementary?: boolean): Promise<any>;
     export function addToSet(array: any, value: any): void;
     export function getDistanceBetweenLatLon([lat1, lon1]: [number, number], [lat2, lon2]: [number, number]): any;
     export function getMapScale(map: MappedinMap): any;
@@ -12389,6 +12332,7 @@ declare module '@mappedin/mappedin-js/packages/get-venue/utils' {
         * @return {MappedinLocation}
         */
     export const getPrimaryLocationForPolygon: (polygon: MappedinPolygon | string | undefined, venue: Mappedin) => MappedinLocation | null;
+    export function mergeThings(thingsOption: ThingsOption | undefined): MergedThings;
 }
 
 declare module '@mappedin/mappedin-js/packages/get-venue/Mappedin.cache' {
@@ -12874,7 +12818,7 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/quad-tre
 }
 
 declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/shave-text' {
-    export type TDrawFn = (ctx: CanvasRenderingContext2D, x: number, y: number) => void;
+    export type TDrawFn = (ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, x: number, y: number) => void;
     type TShave = (str: string, size: number, maxWidth: number, maxLines?: number, lineHeight?: number, options?: {
         strokeText: boolean;
     }) => {
@@ -13093,242 +13037,201 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin
     }
 }
 
-declare module '@mappedin/mappedin-js/packages/legacy-renderer/public/api/Camera' {
-    import { E_CAMERA_DIRECTION } from '@mappedin/mappedin-js/packages/legacy-renderer/MapView.enums';
-    import CameraController, { TCameraAnimationOptions, TCameraInteractionsSetOptions, TCameraTargets, TCameraTransform, TFocusOnCameraOptions } from '@mappedin/mappedin-js/packages/legacy-renderer/private/controllers/CameraController';
+declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils/utils' {
+    import { Box3, Vector3, Object3D, Material } from 'three';
+    import { Mappedin, MapObject, MappedinMap, TMapViewOptions } from '@mappedin/mappedin-js/packages/legacy-renderer/internal';
+    import { Camera } from '@mappedin/mappedin-js/packages/legacy-renderer/public/api/Camera';
     /**
-        * API to control and respond to the state of the camera within the scene.
+        *	Utils function listing
+        *
+        * - scrubMaterial
+        * - getObjectID
+        * - getObject
+        * - getBoundingBox
+        * - getBiggestBoundingBox
+        * - upackBoundingBox
+        * - getMapScale
+        * - throttle -> taken from lodash.js
+        * - getProjectionScaleFactor
+        * - getZoom
         */
-    export class Camera {
-            #private;
-            /**
-                * @hidden
-                */
-            constructor(controller: CameraController);
-            /**
-                * Subscribe a function to be called when an {@link E_CAMERA_EVENT} is fired.
-                *
-                * ```ts
-                * const cameraChangedHandler = ({ tilt, position, zoom, rotation }) => {
-                * 	// Do something with the new values
-                * };
-                * mapView.Camera.on(E_CAMERA_EVENT.CHANGED, cameraChangedHandler);
-                * ```
-                *
-                * @param eventName An {@link E_CAMERA_EVENT} that is fired when the camera changes.
-                * @param fn A callback that gets called when the corresponding event is fired. The
-                * callback will get passed an argument with a type that's one of {@link CAMERA_EVENT_PAYLOAD}.
-                */
-            on: CameraController['on'];
-            /**
-                * Unsubscribe a function that was previously subscribed with {@link on}.
-                *
-                * ```ts
-                * mapView.Camera.on(E_CAMERA_EVENT.CHANGED, cameraChangedHandler);
-                *
-                * ...
-                *
-                * // Something changed and I no longer want this event to fire
-                * mapView.Camera.off(E_CAMERA_EVENT.CHANGED, cameraChangedHandler);
-                * ```
-                *
-                * @param eventName An {@link E_CAMERA_EVENT} that is fired when the camera changes.
-                * @param fn A function that was previously passed to {@link on}. The function must
-                * have the same reference as the function that was subscribed.
-                */
-            off: CameraController['off'];
-            /**
-                * The current camera animation, if any. Resolves when the animation finishes.
-                */
-            get currentAnimation(): Promise<undefined> | undefined;
-            /**
-                * Current Camera zoom (in meters)
-                */
-            get zoom(): number;
-            /**
-                * Current Camera rotation (in radians) from north
-                */
-            get rotation(): number;
-            /**
-                * Current camera tilt angle (in radians), relative to a top-down view.
-                *
-                * ex: 0 means the camera is facing top-down, π/2 means the camera is
-                * facing directly from the side.
-                */
-            get tilt(): number;
-            /**
-                * Get the minimum distance (in meters) the camera is allowed to get to the ground.
-                */
-            get minZoom(): number;
-            /**
-                * Set the minimum distance (in meters) the camera is allowed to get to the ground.
-                */
-            set minZoom(meters: number);
-            /**
-                * Get the maximum distance (in meters) the camera is allowed to get from the ground.
-                */
-            get maxZoom(): number;
-            /**
-                * Set the maximum distance (in meters) the camera is allowed to get from the ground.
-                */
-            set maxZoom(meters: number);
-            /**
-                * Get the current maximum tilt angle (in radians) the camera is allowed to use.
-                */
-            get maxTilt(): number;
-            /**
-                * Sets the maximum tilt angle (in radians) the camera is allowed to use.
-                *
-                * Tilt angle must be between 0 and π/2 radians. It will be clamped within
-                * this range if it exceeds it on either end.
-                *
-                * As tilt angle approaches π/2 radians, this will impact overall touch controls
-                * and should be used sparingly.
-                */
-            set maxTilt(radians: number);
-            /**
-                * Get the current camera position, which is at the center of the map.
-                * @returns the position as a coordinate
-                */
-            get position(): import("../../index.rn").MappedinCoordinate;
-            /**
-                * Enable or disable the ability for the user to interact with the camera (e.g. pan, zoom, tilt, etc).
-                * This does not affect programmatic camera controls, such as {@link set} and {@link focusOn}.
-                *
-                * ```ts
-                * // The user can no longer interact to move the camera
-                * mapView.Camera.interactions.disable();
-                *
-                * // The user can now interact to move the camera again
-                * mapView.Camera.interactions.enable();
-                * ```
-                */
-            interactions: {
-                    /**
-                        * Enable or disable specific user interactions.
-                        *
-                        * ```ts
-                        * mapView.Camera.interactions.set({ zoom: false });
-                        * ```
-                        *
-                        * @param options An object defining the interactions to switch on or off.
-                        *
-                        */
-                    set: (options: TCameraInteractionsSetOptions) => void;
-                    /**
-                        * Enable all user interactions.
-                        */
-                    enable: () => void;
-                    /**
-                        * Disable all user interactions.
-                        */
-                    disable: () => void;
-            };
-            /**
-                * 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 (e.g. by UI) meaning the camera will not place
-                * any map elements there when calling {@link focusOn}.
-                *
-                * ```ts
-                * // The top 100px of the canvas are covered by a UI element
-                * mapView.Camera.setSafeAreaInsets({ top: 100, left: 0, bottom: 0, right: 0});
-                * mapView.Camera.focusOn({ nodes });
-                * ```
-                *
-                * @param insets An object defining a number of pixels from the top, left, bottom, and right of
-                * the screen. Only the area within the padding defined by these pixels is considered safe.
-                */
-            setSafeAreaInsets(insets: {
-                    top: number;
-                    left: number;
-                    bottom: number;
-                    right: number;
-            }): void;
-            /**
-                * Retrieve the values previously set by {@link setSafeAreaInsets}.
-                *
-                * @returns An object defining a number of pixels from the top, left, bottom, and right of
-                * the screen.
-                */
-            getSafeAreaInsets(): import("../../MapView.types").TPadding;
-            /**
-                * Animate the camera to focus on a collection of targets. To control where the targets should
-                * be placed on screen, either specify `safeAreaInsets` on the {@link TFocusOnCameraOptions}
-                * or call {@link setSafeAreaInsets}.
-                *
-                * ```ts
-                * const location = mapView.venue.locations.find((l) => l.name === "My Location")!;
-                *
-                * mapView.Camera.focusOn({
-                * 	polygons: location.polygons,
-                * 	nodes: location.nodes,
-                * });
-                * ```
-                *
-                * @param targets A collection of things that the camera will place into view at the end of the
-                * animation.
-                * @param options
-                * @returns a Promise that resolves when the animation finishes, or rejects when it is cancelled.
-                */
-            focusOn(targets: TCameraTargets, options?: TFocusOnCameraOptions & TCameraAnimationOptions): Promise<any>;
-            /**
-                * Instantaneously set the camera's transform to be in a new configuration. See also {@link animate}.
-                *
-                * ```ts
-                * const coord = mapView.venue.maps[0].createCoordinate(33.66107, 31.83911);
-                *
-                * // Place the camera top-down at a specified coordinate
-                * mapView.Camera.set({
-                * 	tilt: 0,
-                * 	position: coord,
-                * });
-                * ```
-                *
-                * @param transform The new transform of the camera.
-                */
-            set(transform: TCameraTransform): void;
-            /**
-                * Convert a Mercator Zoom Level to altitude, which can be used in the Camera APIs
-                */
-            convertZoomLevelToAltitude(zoomLevel: number): any;
-            /**
-                * Convert the altitude returned by getZoom into Mercator Zoom level
-                */
-            convertAltitudeToZoomLevel(altitude: number): any;
-            /**
-                * Smoothly transition the camera's transform to be in a new configuration. See also {@link set}.
-                *
-                * ```ts
-                * const coord = mapView.venue.maps[0].createCoordinate(33.66107, 31.83911);
-                *
-                * // Animate the camera to be top-down at a specified coordinate
-                * mapView.Camera.animate({
-                * 	tilt: 0,
-                * 	position: coord,
-                * });
-                * ```
+    export function isGatewayKey(key: string): boolean;
+    export function getCombinedBoundingBox(objects: Object3D[]): Box3;
+    export function getMapsBoundingBox(maps: MapObject[], mapPadding: number): Box3;
+    export function scrubMaterial(material: Material): void;
+    /**
+        * Takes a Mappedin Object or id and returns the ID, so our functions can take bottomRight
+        * @template T extends string | {id: string}
+        * @param {T} object - input can be object containing id or the id itself
+        * @return {string}
+        */
+    export function getObjectId(object: any): string;
+    /**
+        * Takes a Mappedin object or ID and the array to look in and retuns the Object, so our functions can take both
+        */
+    export function getObject<K extends {
+            id: string;
+    }, T extends K | string>(obj: T, array: K[] | undefined): K | undefined;
+    export function getBoundingBox(object: Object3D): Box3;
+    /**
+        * Function pushes the items of the second array onto the first array (inplace).
+        * @template T
+        * @param {Array.<T>} arr1 - base array
+        * @param {Array.<T>} arr2 - array which items will be pushed to arr1
+        */
+    export function appendItems<T>(arr1: T[], arr2: T[]): void;
+    export function getBiggestBoundingBox(objects: Object3D[]): {
+            min: any;
+            max: any;
+    };
+    export function unpackBoundingBox(boundingBox: Box3): Vector3[];
+    export function getMapScale(map: MappedinMap): number;
+    export function getNorth(map: MappedinMap): number;
+    export function flatten(list: any[]): any[];
+    export function uniq(arr: any[]): any[];
+    export function toStyleString(styles: Record<string, string>): string;
+    /**
+    /*  getProjectionScaleFactor()
+    /*  finds the scale ratio between screen coordinates and 3D coordinates (in X-Z plane)
+    /*
+                *                                    R
+                *                                  /|
+                *    C : Camera                  /  |
+                *    PQ : Projection Plane     /    |
+                *    OR : Origin             /      |
+                *    F : FOV               /        |
+                *                      Q /          |
+                *                      /|           |
+                *                    /  |           |
+                *                  /    |           |
+                *                /      |           |
+                *              /        |           |
+                *            / F/2      |           |
+                *         C ------------P------------ O
                 *
-                * @param transform The new transform of the camera.
-                * @param options
-                * @returns a Promise that resolves when the animation finishes, or rejects when it is cancelled.
-                */
-            animate(transform: TCameraTransform, options?: TCameraAnimationOptions): Promise<undefined>;
-            /**
-                * Moves the Camera view in a relative direction by a given distance in meters.
                 *
-                * ```ts
-                * // Move the camera 50 meters up relative to the camera frame
-                * mapView.Camera.translate(E_CAMERA_DIRECTION.UP, 50);
-                * ```
+                *   ProjectionScaleFactor = ( OR / PQ )
+                *   PQ = canvasHeight / 2
+                *   CQ = zoom
                 *
-                * @returns a Promise that resolves when the translation animation finishes, or rejects when it is cancelled.
-                */
-            translate(direction: E_CAMERA_DIRECTION, distance: number, options?: TCameraAnimationOptions): Promise<unknown>;
-            /**
-                * Cancel the currently active Camera animation.
+                *   OR / C0 = tan(F/2)
+                *   so OR = CO * tan(F/2)
                 */
-            cancelAnimation(): void;
+    export function getProjectionScaleFactor(FOV: number, canvasHeight: number, zoom: number): number;
+    /** getZoom
+        *
+        *  C - Camera, OP -- picture plane (canvas), S - origin,
+        *  QR - front side of maps Bounding Box, F: FOV
+        *
+        *                           Z-axis
+        *                     R_____|______
+        *                    /|     |     |
+        *                  /  |     |     |
+        *               P/    |     |     | maps BB
+        *              /|     |     |     |
+        *            /  |     |     |     |
+        *          /    |     |     |     |
+        *        / F    |E    |T    |S    |
+        *    C /--------|-----|-----|-----|------ orthogonal to Y axis, midpoint of focus maps
+        *      \        |     |     |     |
+        *        \      |     |     |     |
+        *          \    |     |     |     |
+        *            \  |     |     |     |
+        *              \|     |     |     |
+        *               O\    |     |     |
+        *                  \  |     |     |
+        *                    \|_____|_____|
+        *                     Q
+        *
+        *
+        * We want to get CS, which is the camera zoom
+        *
+        */
+    export function getZoom(focusBox: Box3, focusBoxHeight: number, FOV: number): number;
+    interface CalculateTwoDProjectionsParams {
+            maps: MapObject[];
+            width: number;
+            height: number;
+            camera: Camera;
     }
+    export function calculateTwoDProjections({ maps, width, height, camera }: CalculateTwoDProjectionsParams): {
+            min: {
+                    x: number;
+                    y: number;
+            };
+            max: {
+                    x: number;
+                    y: number;
+            };
+    }[];
+    export function splitLine(startNode: Vector3, endNode: Vector3, segments: number): Vector3[];
+    export function isObject(item: any): boolean;
+    export const determineStartingMap: (venue: Mappedin, options: TMapViewOptions) => MappedinMap;
+    export function cyrb53(str: string, seed?: number): number;
+    export function addMarginMultiplierToBoundingBox(bbox: Box3, multiplier: number): Box3;
+    export function tweenPromise({ from, to, duration, easing, delay, onUpdate, onStart, onComplete, }: {
+            from: any;
+            to: any;
+            duration?: number | undefined;
+            easing?: any;
+            delay?: number | undefined;
+            onUpdate?: ((_: any) => void) | undefined;
+            onStart?: (() => void) | undefined;
+            onComplete?: (() => void) | undefined;
+    }): {
+            start(core: any): Promise<void>;
+    };
+    export const linearEase: (t: number) => number;
+    export const quadEaseIn: (t: number) => number;
+    export const quadEaseOut: (t: number) => number;
+    export function interpolate(value: number, inputMin: number, inputMax: number, outputMin: number, outputMax: number, easeFunc?: (t: number) => number): number;
+    export function interpolateMulti(value: number, inputRange: number[], outputRange: number[], easeFunc?: (t: number) => number): number;
+    export function checkWritableBeforeWrite(obj: any, key: string, value: any): void;
+    export {};
+}
+
+declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils/browser' {
+    type DeviceType = {
+            isIpad: boolean;
+            isMobile: boolean;
+            isSafari12: boolean;
+            isFirefox: boolean;
+            isWindows: boolean;
+    };
+    /**
+        * Get device OS info
+        * export for testing purpose
+        * @returns DeviceType
+        */
+    export const _deviceTypeControl: {
+            getDeviceType(): DeviceType;
+            _reset(): void;
+    };
+    export const getDeviceType: () => DeviceType;
+    /**
+        * Creates a closure encapsulating the logic of getting device GPU info.
+        * inspired by https://github.com/pmndrs/detect-gpu
+        * export for testing
+        */
+    export const _gpuInfoControl: {
+            getInfo: () => string | undefined;
+            shouldDisableOffscreenCanvas: () => boolean;
+            _setCanvas(c: HTMLCanvasElement): void;
+    };
+    export const getGPUInfo: () => string | undefined;
+    /**
+        * Check if device is certain intel integrated GPU.
+        * This is for implementing workaround - https://issues.chromium.org/issues/40251953
+        * The reason we want to disable OffscreenCanvas at all is due to `willReadFrequently` flag only works in FF.
+        * In order to ensure the integrated intel GPU render text correctly
+        */
+    export const shouldDisableOffscreenCanvas: () => boolean;
+    export {};
+}
+
+declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/utils/async' {
+    export function throttle<T>(func: () => void, wait: number, options?: any): () => void;
+    export function debounce<T>(func: () => void, wait: number, immediate?: boolean): () => void;
 }
 
 declare module '@mappedin/mappedin-js/packages/legacy-renderer/internal/Mappedin.MultiFloorView' {
@@ -13924,6 +13827,244 @@ declare module '@mappedin/mappedin-js/packages/legacy-renderer/public/api/BlueDo
     }
 }
 
+declare module '@mappedin/mappedin-js/packages/legacy-renderer/public/api/Camera' {
+    import { E_CAMERA_DIRECTION } from '@mappedin/mappedin-js/packages/legacy-renderer/MapView.enums';
+    import CameraController, { TCameraAnimationOptions, TCameraInteractionsSetOptions, TCameraTargets, TCameraTransform, TFocusOnCameraOptions } from '@mappedin/mappedin-js/packages/legacy-renderer/private/controllers/CameraController';
+    /**
+        * API to control and respond to the state of the camera within the scene.
+        */
+    export class Camera {
+            #private;
+            /**
+                * @hidden
+                */
+            constructor(controller: CameraController);
+            /**
+                * Subscribe a function to be called when an {@link E_CAMERA_EVENT} is fired.
+                *
+                * ```ts
+                * const cameraChangedHandler = ({ tilt, position, zoom, rotation }) => {
+                * 	// Do something with the new values
+                * };
+                * mapView.Camera.on(E_CAMERA_EVENT.CHANGED, cameraChangedHandler);
+                * ```
+                *
+                * @param eventName An {@link E_CAMERA_EVENT} that is fired when the camera changes.
+                * @param fn A callback that gets called when the corresponding event is fired. The
+                * callback will get passed an argument with a type that's one of {@link CAMERA_EVENT_PAYLOAD}.
+                */
+            on: CameraController['on'];
+            /**
+                * Unsubscribe a function that was previously subscribed with {@link on}.
+                *
+                * ```ts
+                * mapView.Camera.on(E_CAMERA_EVENT.CHANGED, cameraChangedHandler);
+                *
+                * ...
+                *
+                * // Something changed and I no longer want this event to fire
+                * mapView.Camera.off(E_CAMERA_EVENT.CHANGED, cameraChangedHandler);
+                * ```
+                *
+                * @param eventName An {@link E_CAMERA_EVENT} that is fired when the camera changes.
+                * @param fn A function that was previously passed to {@link on}. The function must
+                * have the same reference as the function that was subscribed.
+                */
+            off: CameraController['off'];
+            /**
+                * The current camera animation, if any. Resolves when the animation finishes.
+                */
+            get currentAnimation(): Promise<undefined> | undefined;
+            /**
+                * Current Camera zoom (in meters)
+                */
+            get zoom(): number;
+            /**
+                * Current Camera rotation (in radians) from north
+                */
+            get rotation(): number;
+            /**
+                * Current camera tilt angle (in radians), relative to a top-down view.
+                *
+                * ex: 0 means the camera is facing top-down, π/2 means the camera is
+                * facing directly from the side.
+                */
+            get tilt(): number;
+            /**
+                * Get the minimum distance (in meters) the camera is allowed to get to the ground.
+                */
+            get minZoom(): number;
+            /**
+                * Set the minimum distance (in meters) the camera is allowed to get to the ground.
+                */
+            set minZoom(meters: number);
+            /**
+                * Get the maximum distance (in meters) the camera is allowed to get from the ground.
+                */
+            get maxZoom(): number;
+            /**
+                * Set the maximum distance (in meters) the camera is allowed to get from the ground.
+                */
+            set maxZoom(meters: number);
+            /**
+                * Get the current maximum tilt angle (in radians) the camera is allowed to use.
+                */
+            get maxTilt(): number;
+            /**
+                * Sets the maximum tilt angle (in radians) the camera is allowed to use.
+                *
+                * Tilt angle must be between 0 and π/2 radians. It will be clamped within
+                * this range if it exceeds it on either end.
+                *
+                * As tilt angle approaches π/2 radians, this will impact overall touch controls
+                * and should be used sparingly.
+                */
+            set maxTilt(radians: number);
+            /**
+                * Get the current camera position, which is at the center of the map.
+                * @returns the position as a coordinate
+                */
+            get position(): import("../../index.rn").MappedinCoordinate;
+            /**
+                * Enable or disable the ability for the user to interact with the camera (e.g. pan, zoom, tilt, etc).
+                * This does not affect programmatic camera controls, such as {@link set} and {@link focusOn}.
+                *
+                * ```ts
+                * // The user can no longer interact to move the camera
+                * mapView.Camera.interactions.disable();
+                *
+                * // The user can now interact to move the camera again
+                * mapView.Camera.interactions.enable();
+                * ```
+                */
+            interactions: {
+                    /**
+                        * Enable or disable specific user interactions.
+                        *
+                        * ```ts
+                        * mapView.Camera.interactions.set({ zoom: false });
+                        * ```
+                        *
+                        * @param options An object defining the interactions to switch on or off.
+                        *
+                        */
+                    set: (options: TCameraInteractionsSetOptions) => void;
+                    /**
+                        * Enable all user interactions.
+                        */
+                    enable: () => void;
+                    /**
+                        * Disable all user interactions.
+                        */
+                    disable: () => void;
+            };
+            /**
+                * 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 (e.g. by UI) meaning the camera will not place
+                * any map elements there when calling {@link focusOn}.
+                *
+                * ```ts
+                * // The top 100px of the canvas are covered by a UI element
+                * mapView.Camera.setSafeAreaInsets({ top: 100, left: 0, bottom: 0, right: 0});
+                * mapView.Camera.focusOn({ nodes });
+                * ```
+                *
+                * @param insets An object defining a number of pixels from the top, left, bottom, and right of
+                * the screen. Only the area within the padding defined by these pixels is considered safe.
+                */
+            setSafeAreaInsets(insets: {
+                    top: number;
+                    left: number;
+                    bottom: number;
+                    right: number;
+            }): void;
+            /**
+                * Retrieve the values previously set by {@link setSafeAreaInsets}.
+                *
+                * @returns An object defining a number of pixels from the top, left, bottom, and right of
+                * the screen.
+                */
+            getSafeAreaInsets(): import("../../MapView.types").TPadding;
+            /**
+                * Animate the camera to focus on a collection of targets. To control where the targets should
+                * be placed on screen, either specify `safeAreaInsets` on the {@link TFocusOnCameraOptions}
+                * or call {@link setSafeAreaInsets}.
+                *
+                * ```ts
+                * const location = mapView.venue.locations.find((l) => l.name === "My Location")!;
+                *
+                * mapView.Camera.focusOn({
+                * 	polygons: location.polygons,
+                * 	nodes: location.nodes,
+                * });
+                * ```
+                *
+                * @param targets A collection of things that the camera will place into view at the end of the
+                * animation.
+                * @param options
+                * @returns a Promise that resolves when the animation finishes, or rejects when it is cancelled.
+                */
+            focusOn(targets: TCameraTargets, options?: TFocusOnCameraOptions & TCameraAnimationOptions): Promise<any>;
+            /**
+                * Instantaneously set the camera's transform to be in a new configuration. See also {@link animate}.
+                *
+                * ```ts
+                * const coord = mapView.venue.maps[0].createCoordinate(33.66107, 31.83911);
+                *
+                * // Place the camera top-down at a specified coordinate
+                * mapView.Camera.set({
+                * 	tilt: 0,
+                * 	position: coord,
+                * });
+                * ```
+                *
+                * @param transform The new transform of the camera.
+                */
+            set(transform: TCameraTransform): void;
+            /**
+                * Convert a Mercator Zoom Level to altitude, which can be used in the Camera APIs
+                */
+            convertZoomLevelToAltitude(zoomLevel: number): any;
+            /**
+                * Convert the altitude returned by getZoom into Mercator Zoom level
+                */
+            convertAltitudeToZoomLevel(altitude: number): any;
+            /**
+                * Smoothly transition the camera's transform to be in a new configuration. See also {@link set}.
+                *
+                * ```ts
+                * const coord = mapView.venue.maps[0].createCoordinate(33.66107, 31.83911);
+                *
+                * // Animate the camera to be top-down at a specified coordinate
+                * mapView.Camera.animate({
+                * 	tilt: 0,
+                * 	position: coord,
+                * });
+                * ```
+                *
+                * @param transform The new transform of the camera.
+                * @param options
+                * @returns a Promise that resolves when the animation finishes, or rejects when it is cancelled.
+                */
+            animate(transform: TCameraTransform, options?: TCameraAnimationOptions): Promise<undefined>;
+            /**
+                * Moves the Camera view in a relative direction by a given distance in meters.
+                *
+                * ```ts
+                * // Move the camera 50 meters up relative to the camera frame
+                * mapView.Camera.translate(E_CAMERA_DIRECTION.UP, 50);
+                * ```
+                *
+                * @returns a Promise that resolves when the translation animation finishes, or rejects when it is cancelled.
+                */
+            translate(direction: E_CAMERA_DIRECTION, distance: number, options?: TCameraAnimationOptions): Promise<unknown>;
+            /**
+                * Cancel the currently active Camera animation.
+                */
+            cancelAnimation(): void;
+    }
+}
+
 declare module '@mappedin/mappedin-js/packages/legacy-renderer/public/api/Exporter' {
     import { ExportController } from '@mappedin/mappedin-js/packages/legacy-renderer/internal';
     /**