@mappedin/mappedin-js 5.29.4-alpha.0 → 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> = {
@@ -1632,6 +1635,13 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                     outdoorGeometryLayers?: string[];
                     /**
                         * Use the current polygon objects directly rather than what is stored when rendering the map in CMS.
+                        *
+                        * Important Considerations:
+                        * - When this flag is set to true, the application will use live polygon data, which might not include certain enhancements such as 3D text annotations or automatically generated infill patterns. These features typically depend on the CMS's Render capabilities.
+                        * - Opting for live polygons means the system will not utilize the pre-processed optimized polygon data that is available through the CMS's rendering pipeline.
+                        * - This option is useful for applications requiring the most up-to-date representation of polygon data but may result in a less detailed visual representation due to the absence of certain rendered features.
+                        *
+                        * Use this option with caution, understanding the trade-offs between real-time update and visual detail.
                         */
                     useLivePolygons?: boolean;
             };
@@ -1640,7 +1650,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 * Requires `multiBufferRendering` to be enabled.
                 * @experimental
                 */
-            outdoorView?: TOutdoorViewControllerOptions & {
+            outdoorView?: TOutdoorViewOptions & {
                     enabled?: boolean;
             };
             /**
@@ -1777,6 +1787,10 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
             onWebGLRendererError?: () => void;
     };
     export type TShowVenueOptions = {
+            /**
+                * Enable shading of bottoms of geometry along with outlines to make geometry stand out.
+                */
+            shadingAndOutlines?: boolean;
             /**
                 * @experimental
                 *
@@ -1834,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;
             };
             /**
@@ -2339,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';
 }
@@ -4751,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;
@@ -4764,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: {
@@ -4802,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;
@@ -5041,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
@@ -5071,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' {
@@ -5342,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.
@@ -6221,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;
 }
@@ -6477,8 +6576,7 @@ declare module '@mappedin/mappedin-js/navigator/Directive' {
 }
 
 declare module '@mappedin/mappedin-js/renderer/private/controllers/FlatLabelsController' {
-    import { TAddFlatLabelOptions, TFlatLabelAllLocationsOptions, TFlatLabelAppearance, ICore } from '@mappedin/mappedin-js/renderer/internal';
-    import { FlatLabel } from '@mappedin/mappedin-js/renderer/internal';
+    import { TAddFlatLabelOptions, TFlatLabelAllLocationsOptions, TFlatLabelAppearance, ICore, FlatLabel } from '@mappedin/mappedin-js/renderer/internal';
     import { MappedinPolygon } from '@mappedin/mappedin-js/get-venue';
     export const LABEL_ALL_LOCATIONS_WARNING = "Adding or removing individual labels after calling labelAllLocations() may cause unexpected behaviour. We recommend adding all labels individually if more specific control is desired. https://developer.mappedin.com/web-sdk-api/v5/latest/classes/flatlabels#add";
     export type FlatLabelRenderObject = TAddFlatLabelOptions & {
@@ -8121,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;
@@ -8133,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[];
         };
@@ -8155,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(): {
@@ -9279,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' {
@@ -10650,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[]>;
@@ -10982,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
@@ -10996,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
@@ -11006,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;
@@ -11054,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' {
@@ -11112,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;
     }) => {
@@ -11394,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;