@mappedin/mappedin-js 5.29.4 → 5.30.0

package/lib/esm/renderer/index.d.ts

@@ -766,7 +766,7 @@ declare module '@mappedin/mappedin-js/renderer/public/MapView' {
 }
 
 declare module '@mappedin/mappedin-js/get-venue' {
-    import type { TGetVenueOptions, TGetVenueOptionsInternal, TVenueMetadata } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
+    import type { TAllGetVenueOptions, TGetVenueOptions, TGetVenueOptionsInternal, TVenueMetadata } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
     import { Mappedin } from '@mappedin/mappedin-js/get-venue/Mappedin';
     import { defaultThings } from '@mappedin/mappedin-js/get-venue/default-things';
     import { GET_VENUE_EVENT } from '@mappedin/mappedin-js/get-venue/internal';
@@ -813,7 +813,10 @@ declare module '@mappedin/mappedin-js/get-venue' {
     import { MAP_RENDER_MODE } from '@mappedin/mappedin-js/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
         */
@@ -915,7 +918,7 @@ declare module '@mappedin/mappedin-js/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>;
@@ -1139,7 +1142,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
     import type { Path } from '@mappedin/mappedin-js/renderer/private/controllers/PathsController';
     import { TOOLTIP_ANCHOR } from '@mappedin/mappedin-js/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/renderer/MapView.enums';
-    import { TOutdoorViewControllerOptions } from '@mappedin/mappedin-js/renderer/private/controllers/OutdoorViewController';
+    import { TOutdoorViewOptions, TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL } from '@mappedin/mappedin-js/renderer/private/controllers/OutdoorViewController';
     export type { TEnableBlueDotOptions, TFloatingLabelAppearance };
     /** @internal */
     export type Without<T, U> = {
@@ -1647,7 +1650,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 * Requires `multiBufferRendering` to be enabled.
                 * @experimental
                 */
-            outdoorView?: TOutdoorViewControllerOptions & {
+            outdoorView?: TOutdoorViewOptions & {
                     enabled?: boolean;
             };
             /**
@@ -1845,7 +1848,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 * @experimental
                 * Enable outdoor view. Requires multi-buffer rendering to be enabled
                 */
-            outdoorView?: TOutdoorViewControllerOptions & {
+            outdoorView?: TOutdoorViewOptions & {
                     enabled?: boolean;
             };
             /**
@@ -2350,6 +2353,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 */
             [E_CAMERA_EVENT.TILT_CHANGED]: number;
     };
+    export type { TOutdoorViewOptions, TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL };
     export type { default as BlueDotController } from '@mappedin/mappedin-js/renderer/private/controllers/BlueDotController';
     export type { default as Journey } from '@mappedin/mappedin-js/renderer/public/api/Journey';
 }
@@ -4762,6 +4766,14 @@ declare module '@mappedin/mappedin-js/renderer/public/api/Exporter' {
 }
 
 declare module '@mappedin/mappedin-js/get-venue/Mappedin.types' {
+    import type { TGetVenueMVFOptions, TGetVenueMakerOptions } from '@mappedin/mappedin-js/get-venue';
+    import type { DefaultThings } from '@mappedin/mappedin-js/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;
@@ -4775,22 +4787,44 @@ declare module '@mappedin/mappedin-js/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: {
@@ -4813,14 +4847,14 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.types' {
 
 declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
     import { Navigator } from '@mappedin/mappedin-js/navigator';
-    import type { TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
+    import type { TAllGetVenueOptions, TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/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/get-venue/internal';
     import { TAccessors, GET_VENUE_EVENT } from '@mappedin/mappedin-js/get-venue/internal';
     import { IAnalytics } from '@mappedin/mappedin-js/get-venue/Mappedin.CustomerAnalytics';
     import { ParsedMVF } from '@mappedin/mvf';
     import { ParsedMVFv1 } from '@mappedin/mappedin-js/get-venue/Mappedin.MVF.types';
     import { PubSub } from '@mappedin/mappedin-js/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;
@@ -5052,7 +5086,7 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
             /**
                 * @deprecated Use {@link hydrateVenue} instead
                 */
-            constructor(options: TGetVenueOptionsInternal & TGetVenueOptions);
+            constructor(options: TGetVenueOptionsInternal<TAllGetVenueOptions>);
             analytics: IAnalytics;
             /**
                 * @hidden
@@ -5082,6 +5116,7 @@ declare module '@mappedin/mappedin-js/get-venue/default-things' {
         themes: string[];
         rankings: string[];
     };
+    export type DefaultThings = typeof defaultThings;
 }
 
 declare module '@mappedin/mappedin-js/get-venue/internal' {
@@ -5353,6 +5388,7 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinLocation' {
             siblingGroups?: TSiblingGroup[] | undefined;
             gallery?: TGalleryImage[] | undefined;
             amenity?: string | undefined;
+            filterFlags?: string[];
             constructor(mappedin: Mappedin, data: any);
             /**
                 * Polygons this Location is attached to.
@@ -6232,45 +6268,97 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/OutdoorViewCo
     import './OutdoorViewController.scss';
     import type { ICore } from '@mappedin/mappedin-js/renderer/internal';
     import { XOR } from '@mappedin/mappedin-js/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;
 }
@@ -8131,6 +8219,17 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Element' {
         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;
@@ -8143,13 +8242,6 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Element' {
                 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[];
         };
@@ -8165,7 +8257,8 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Element' {
             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(): {
@@ -9289,158 +9382,9 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedi
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/utils' {
-    import { Box3, Vector3, Object3D, Material } from 'three';
-    import { Mappedin, MapObject, MappedinMap, TMapViewOptions } from '@mappedin/mappedin-js/renderer/internal';
-    import { Camera } from '@mappedin/mappedin-js/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/renderer/internal/utils/utils';
+    export { shouldDisableOffscreenCanvas } from '@mappedin/mappedin-js/renderer/internal/utils/browser';
+    export { throttle, debounce } from '@mappedin/mappedin-js/renderer/internal/utils/async';
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapManager' {
@@ -10660,6 +10604,7 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinVortex' {
             weight?: number;
             multiplier?: number;
             nodes?: string[];
+            filterFlags?: string[];
             constructor(data: any);
             static hydrate(vortexes: any): MappedinVortex[];
             static fetch(mappedin: Mappedin): Promise<MappedinVortex[]>;
@@ -10992,12 +10937,12 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinMapGroup' {
 }
 
 declare module '@mappedin/mappedin-js/get-venue/utils' {
-    import type { TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
+    import type { MergedThings, TGetVenueOptions, TGetVenueOptionsInternal, ThingsOption } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
     import type { MappedinMap } from '@mappedin/mappedin-js/get-venue/internal';
     import { Mappedin, MappedinNavigatable, MappedinNode, MappedinPolygon, MappedinLocation, MappedinCoordinate } from '@mappedin/mappedin-js/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
@@ -11006,7 +10951,7 @@ declare module '@mappedin/mappedin-js/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
@@ -11016,21 +10961,21 @@ declare module '@mappedin/mappedin-js/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;
@@ -11064,6 +11009,7 @@ declare module '@mappedin/mappedin-js/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/get-venue/Mappedin.cache' {
@@ -11122,7 +11068,7 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.cache' {
 }
 
 declare module '@mappedin/mappedin-js/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;
     }) => {
@@ -11404,6 +11350,203 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.EffectComposer'
     export {};
 }
 
+declare module '@mappedin/mappedin-js/renderer/internal/utils/utils' {
+    import { Box3, Vector3, Object3D, Material } from 'three';
+    import { Mappedin, MapObject, MappedinMap, TMapViewOptions } from '@mappedin/mappedin-js/renderer/internal';
+    import { Camera } from '@mappedin/mappedin-js/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 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 {};
+}
+
+declare module '@mappedin/mappedin-js/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/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/renderer/internal/Mappedin.MultiFloorView' {
     export namespace VIEW_STATE {
         let SINGLE_FLOOR: string;