@mappedin/mappedin-js 4.0.15 → 4.0.18

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

@@ -5,12 +5,13 @@
 //   ../three/src/math/Vector3
 //   ../@tweenjs/tween.js
 //   ../three/src/math/Color
+//   ../geojson
 
 declare module '@mappedin/mappedin-js' {
     import Search from '@mappedin/mappedin-js/renderer/internal/Mappedin.Search';
     import Analytics from '@mappedin/mappedin-js/renderer/internal/Mappedin.Analytics';
     import { MapView } from '@mappedin/mappedin-js/renderer/MapView';
-    import { getVenue, getVenueBundle, Mappedin, downloadBundle, getVenueBundleURL, MappedinDestinationSet, MappedinMap, TGetVenueBundleOptions, TGetVenueOptions } from '@mappedin/mappedin-js/get-venue';
+    import { getVenue, getVenueBundle, Mappedin, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, MappedinDestinationSet, MappedinMap, TGetVenueBundleOptions, TGetVenueOptions } from '@mappedin/mappedin-js/get-venue';
     import { PositionUpdater } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core';
     import type { TMapViewOptions, TJourneyOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     import { labelThemes } from '@mappedin/mappedin-js/renderer/MapView.types';
@@ -41,9 +42,9 @@ declare module '@mappedin/mappedin-js' {
         */
     function showVenue<T extends Mappedin>(el: HTMLElement, venue: T, options?: TMapViewOptions): Promise<MapView>;
     export { COLLISION_RANKING_TIERS, STATE, E_SDK_EVENT, E_BLUEDOT_STATE_REASON, E_BLUEDOT_MARKER_STATE, E_BLUEDOT_EVENT, E_BLUEDOT_STATE, E_CAMERA_EVENT } from '@mappedin/mappedin-js/renderer/MapView.enums';
-    export { Search, getVenue, getVenueBundle, showVenue, downloadBundle, getVenueBundleURL, PositionUpdater, Analytics, MappedinDestinationSet, MARKER_ANCHOR, labelThemes };
+    export { Search, getVenue, getVenueBundle, showVenue, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, PositionUpdater, Analytics, MappedinDestinationSet, MARKER_ANCHOR, labelThemes };
     import DefaultAssetManager from '@mappedin/mappedin-js/renderer/internal/Mappedin.AssetManager';
-    const setAssetManager: (am: any) => void;
+    const setAssetManager: <T extends DefaultAssetManager>(am: T) => void;
     /**
         * @internal
         */
@@ -58,7 +59,7 @@ declare module '@mappedin/mappedin-js' {
     export type { TSafeAreaInsets, TFocusOnTargets, TFocusOnCameraOptions, TAnimatePositionOptions, TCameraAnimationOptions, TFocusOnOptions, default as Camera } from '@mappedin/mappedin-js/renderer/Camera';
     export { SAFE_AREA_INSET_TYPE, ANIMATION_TWEENS, CAMERA_EASING_MODE } from '@mappedin/mappedin-js/renderer/Camera';
     export type { TGetVenueOptions, MappedinLocation, MappedinPolygon, MappedinNode, MappedinCategory, MappedinMap, MappedinEvent, MappedinMapGroup, MappedinVenue, MappedinVortex, MappedinNavigatable, MappedinCoordinate, TShowVenueOptions } from '@mappedin/mappedin-js/get-venue';
-    export { Mappedin, MappedinDirections } from '@mappedin/mappedin-js/get-venue';
+    export { Mappedin, MappedinDirections, MAP_RENDER_MODE } from '@mappedin/mappedin-js/get-venue';
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Search' {
@@ -444,7 +445,7 @@ declare module '@mappedin/mappedin-js/get-venue' {
     import type { TGetVenueOptions } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
     import { Mappedin } from '@mappedin/mappedin-js/get-venue/Mappedin';
     /** Classes */
-    export { Mappedin } from '@mappedin/mappedin-js/get-venue/Mappedin';
+    export { Mappedin, MappedinCollectionType } from '@mappedin/mappedin-js/get-venue/Mappedin';
     export { MappedinLocation } from '@mappedin/mappedin-js/get-venue/MappedinLocation';
     export { MappedinPolygon } from '@mappedin/mappedin-js/get-venue/MappedinPolygon';
     export { MappedinNode } from '@mappedin/mappedin-js/get-venue/MappedinNode';
@@ -467,6 +468,7 @@ declare module '@mappedin/mappedin-js/get-venue' {
     /** API data types */
     export type { TLocationType, TNode, TImage, TLogo, TGalleryImage, TPhone, TSocial, TColor, TVortex, TPicture, TOpeningHours, TSiblingGroup, TState, TCategory, TEvent, TGeoReference, TMap, TMapGroup, TBuilding, TLocation, TPolygon, TPolygonRanking, TVenue, TMappedinAPI } from '@mappedin/mappedin-js/get-venue/Mappedin.API.types';
     export type { TGetVenueOptions } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
+    import { MAP_RENDER_MODE } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
     export type TShowVenueOptions = {
             /**
                 * Sets the initial background color of the map, including while loading.
@@ -478,14 +480,24 @@ declare module '@mappedin/mappedin-js/get-venue' {
                 */
             backgroundAlpha?: number;
             /**
-                * Whether or not to display labels initially
+                * Whether or not to display default styled Floating Labels initially
                 */
             labelAllLocationsOnInit?: boolean;
             /**
                 * The id of the first map to show on map load
                 */
             firstMapId?: string;
+            loadOptions?: {
+                    /**
+                        * Set the map render strategy in order to optimize FPS
+                        *
+                        * @beta
+                        */
+                    mapRenderStrategy?: MAP_RENDER_MODE;
+            };
     };
+    export { MAP_RENDER_MODE };
+    export function getVenueMVF(userOptions: TGetVenueOptions): Promise<Mappedin>;
     /**
         * Get Venue Data for a Mappedin Venue
         */
@@ -522,6 +534,23 @@ declare module '@mappedin/mappedin-js/get-venue' {
             url: any;
             updated_at: any;
     }): Promise<Mappedin>;
+    /**
+        * Get the bundle URL and updated_at time.
+        * @internal
+        */
+    export function getVenueMVFURL(userOptions: TGetVenueBundleOptions): Promise<{
+            url: string;
+            updated_at: string;
+    }>;
+    /**
+        * @internal
+        */
+    export function downloadVenueBundleMVF(options: TGetVenueOptions, 
+    /**
+        * use Web Workers to speed up MVF parsing. This is likely only benefitial for larger venues,
+        * and may be determental to smaller ones, hence it is off by default
+        */
+    useWorker?: boolean): Promise<unknown>;
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core' {
@@ -647,19 +676,19 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedi
     }
     export type TBlueDotPositionUpdate = {
             /**
-                * What Map is Blue Dot on
+                * The {@link MappedinMap} Blue Dot position is on
                 */
             map?: MappedinMap;
             /**
-                * The nearest Node to the BlueDot
+                * The nearest {@link MappedinNode} to the Blue Dot position
                 */
             nearestNode?: MappedinNode;
             /**
-                * Actual position of BlueDot (post smoothing, if smoothing is on)
+                * Actual position of Blue Dot (post smoothing, if smoothing is enabled)
                 */
             position?: TGeolocationObject;
             /**
-                * Current BlueDot bearing
+                * Current Blue Dot bearing
                 */
             bearing?: number;
     };
@@ -669,11 +698,11 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedi
                 */
             name: E_BLUEDOT_STATE;
             /**
-                * Visiblity State of the BlueDot marker
+                * Visiblity state of the Blue Dot marker
                 */
             markerVisibility?: E_BLUEDOT_MARKER_STATE;
             /**
-                * Reason why BlueDot may be in the current state
+                * Reason why Blue Dot may be in the current state
                 */
             reason?: E_BLUEDOT_STATE_REASON;
             /**
@@ -702,7 +731,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
     import { TBlueDotPositionUpdate, TBlueDotStateChange } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core';
     import { TOOLTIP_ANCHOR } from '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartTooltip';
     import type { Euler, Object3D, Vector3 } from 'three';
-    import { GEOLOCATION_STATUS, COLLISION_RANKING_TIERS, STATE, MARKER_ANCHOR, E_SDK_EVENT, E_BLUEDOT_EVENT, E_CAMERA_EVENT } from '@mappedin/mappedin-js/renderer/MapView.enums';
+    import { GEOLOCATION_STATUS, COLLISION_RANKING_TIERS, STATE, MARKER_ANCHOR, E_SDK_EVENT, E_BLUEDOT_EVENT, E_CAMERA_EVENT, MAP_RENDER_MODE } from '@mappedin/mappedin-js/renderer/MapView.enums';
     export type { TEnableBlueDotOptions, TFloatingLabelAppearance };
     /**
     An extension of the GeolocationPosition type.
@@ -972,19 +1001,27 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
             scale?: Vector3;
     };
     export type TMapViewOptions = {
+            /**
+                * Background color of the map in hex number or string e.g. `0x2e2e2e` or `#2e2e2e`.
+                */
             backgroundColor?: number | string;
             /**
                 * The opacity of the initial background color.
                 */
             backgroundAlpha?: number;
             /**
-                * Controls whether antialiasing is on. Defaults to true, as long as devicePixelRatio is 1. This is very expensive on high resolution screens.
+                * Controls whether antialiasing is on. Defaults to `true`, as long as devicePixelRatio is 1. This is very expensive on high resolution screens.
                 * @default true
                 */
             antialias?: boolean;
             disableHover?: boolean;
             disableZoomOnMapSizeChange?: boolean;
             loadOptions?: {
+                    /**
+                        * By default, the SDK will merge all geometries by material to reduce the number of draw calls to the GPU
+                        * To rever back to using a single geometry for every polygon, pass `MAP_RENDER_MODE.MULTI_GEOMETRY`
+                        */
+                    mapRenderStrategy?: MAP_RENDER_MODE;
                     async?: boolean;
                     zoomOverrides?: {
                             zoomMultiplier?: number;
@@ -993,7 +1030,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                     };
             };
             /**
-                * What map should the SDK initialize to?
+                * First map to be rendered
                 */
             firstMap?: MappedinMap | string;
             /**
@@ -1012,6 +1049,9 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
             onWebGLRendererError?: () => void;
     };
     export type TMapViewOptionsLegacy = {
+            /**
+                * Background color of the map in hex number or string e.g. `0x2e2e2e` or `#2e2e2e`.
+                */
             backgroundColor?: number | string;
             /**
                 * The opacity of the initial background color.
@@ -1045,7 +1085,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                     };
             };
             /**
-                * What map should the SDK initialize to?
+                * First map to be rendered
                 */
             firstMap?: MappedinMap | string;
             /**
@@ -1115,21 +1155,21 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 */
             height?: number;
             /**
-                * The amount of space to leave before starting the text
+                * The amount of space to leave before starting the text in pixels
                 * @default 5
                 */
             margin?: number;
             /**
-                * A optional color
+                * Optional color in hexadecimal string e.g. `#2e2e2e`.
                 */
             color?: string;
             /**
-                * How big to make the font. Defaults to 12
+                * Size of the font in pixels.
                 * @default 12
                 */
             fontSize?: number;
             /**
-                * A CSS style string font. ie "sans-serif". You can specify your own font via @font-face rule with a font family, and then include that here.
+                * A CSS style string font, e.g. "sans-serif". You can specify your own font via @font-face rule with a font family, and then include that here.
                 */
             font?: string;
             /**
@@ -1138,7 +1178,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                 */
             scaleMin?: number;
             /**
-                * How much to decrement the scale each time it doesn't fit, so we don't end up with too many different font sizes on screen at once. If * you are only labeling a few Polygons rather than everything,
+                * How much to decrement the scale each time it doesn't fit, so we don't end up with too many different font sizes on screen at once. If you are only labeling a few {@link MappedinPolygon}s rather than everything,
                 * you can set this and and scaleMin to 0.1 to fit everything except really long names perfectly.
                 * @default 0.25
                 */
@@ -1148,7 +1188,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
             scale?: number;
             flatLabels?: false | undefined;
             /**
-                * Custom Rank - this determines how likely a Floating Label will appear
+                * Ranking tier to determine how likely a {@link FloatingLabel} will appear
                 */
             rank?: COLLISION_RANKING_TIERS | number;
             /**
@@ -1183,7 +1223,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                     [key in string]: string;
             };
             /**
-                * Display label despite the polygon having an image on it
+                * Display label despite the {@link MappedinPolygon} having an image on it. Often these images represent store logos.
                 * @default false
                 */
             createDespiteImage?: boolean;
@@ -1218,7 +1258,7 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
                     longitude: number;
             };
             /**
-                * A list of MappedinPolygons corresponding to every polygon that a user's
+                * A list of {@link MappedinPolygon}s corresponding to every polygon that a user's
                 * click passed through. These are in order of first to last intersected.
                 * Will be empty if no interactive polygons were clicked.
                 */
@@ -1317,6 +1357,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Marker' {
         get strategies(): TColliderStrategy[];
         colliderDidMount(): void;
         setAction(action: any): void;
+        colliderDidNotFindAHome(): void;
         colliderDidGoOffscreen(): void;
         colliderDidUpdateVisiblity(): void;
     }
@@ -1362,30 +1403,30 @@ declare module '@mappedin/mappedin-js/renderer/MapView.enums' {
             CUSTOM_GEOLOCATION_PROVIDER_ERROR = 3
     }
     /**
-    What we currently know about the user's position, and how confident we are.
+    What we currently know about the user's position and how confident we are.
      */
     export enum E_BLUEDOT_STATE {
             /**
-                * We haven't started listening to position updates
+                * Not listening to Blue Dot position updates
                 */
             NOT_LISTENING = 0,
             /**
-                * We have started listening to position updates
+                * Listenign for listening to position updates but have not yet received a position
                 */
             LISTENING = 1,
             /**
-                * We've received relevant positions, and user is inside the venue
+                * Received relevant positions and user is in the venue
                 */
             HAS_POSITION = 2,
             /**
                 * We've received a relevant position, and we have enough information to determine
                 * which floor the user is on - either because we received a floor level, the venue
-                * only has one floor, or we're allowing implicit floor level.
+                * only has one floor or we're allowing implicit floor level detection.
                 */
             HAS_INDOOR_POSITION = 3,
             /**
                 * We are uncertain about the user's position, likely because we haven't received
-                * a relevant position in a while
+                * a relevant position in a while. Blue Dot will be rendered grey to indicate uncertainty of the actual position.
                 */
             LOCATION_UNCERTAIN = 4
     }
@@ -1394,26 +1435,29 @@ declare module '@mappedin/mappedin-js/renderer/MapView.enums' {
         */
     export enum E_BLUEDOT_MARKER_STATE {
             /**
-                * BlueDot is hidden
+                * Blue Dot is hidden
                 */
             HIDDEN = 0,
             /**
-                * BlueDot is transparent
+                * Blue Dot is transparent indicating the position is on a different floor
                 */
             GHOST = 1,
             /**
-                * BlueDot is visible and opaque
+                * Blue Dot is visible and opaque indicating accurate positioning on the current floor
                 */
             NORMAL = 2,
             /**
-                * BlueDot is grayed out
+                * Blue Dot is grayed out due to uncertainty about user's location, most likely due to not receiving recent position updates.
                 */
             UNCERTAIN = 3
     }
     export enum STATE {
+            /**
+                * The map is in exploration mode where the user controls the camera position.
+                */
             EXPLORE = "explore",
             /**
-                * FOLLOW state follows user's current location (BlueDot)
+                * Follows user's current location by keeping the camera centered on the Blue Dot.
                 */
             FOLLOW = "follow"
             /**
@@ -1429,19 +1473,19 @@ declare module '@mappedin/mappedin-js/renderer/MapView.enums' {
     }
     export enum E_SDK_EVENT {
             /**
-                * Emitted when the map is clicked
+                * Emitted when the map is clicked or tapped on a touch screen.
                 */
             CLICK = "CLICK",
             /**
-                * Emitted when the {@link STATE | SDK state} changes
+                * Emitted when the {@link STATE | SDK state} changes.
                 */
             STATE_CHANGE = "STATE_CHANGE",
             /**
-                * Emitted when a polygon is clicked
+                * Emitted when an interactive {@link MappedinPolygon | polygon} is clicked
                 */
             POLYGON_CLICKED = "POLYGON_CLICKED",
             /**
-                * Emitted when nothing is clicked
+                * Emitted when nothing (outside of interactive polygons) is clicked
                 */
             NOTHING_CLICKED = "NOTHING_CLICKED",
             /**
@@ -1462,15 +1506,16 @@ declare module '@mappedin/mappedin-js/renderer/MapView.enums' {
             ROTATION_CHANGED = "ROTATION_CHANGED",
             TILT_CHANGED = "TILT_CHANGED"
     }
+    export { MAP_RENDER_MODE } from '@mappedin/mappedin-js/get-venue';
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.AssetManager' {
-    import { TextureLoader } from 'three';
+    import { Texture, TextureLoader } from 'three';
     import type { MappedinMap } from '@mappedin/mappedin-js/renderer';
     export default class DefaultAssetManager {
         textureLoader: TextureLoader;
         loadMapPolygons(map: MappedinMap): Promise<any>;
-        loadImage(url: string): Promise<unknown>;
+        loadImage(url: string): Promise<Texture>;
     }
 }
 
@@ -1677,11 +1722,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.FloatingLabel'
             clearColor: () => void;
             zoomProportion: number;
             _cache: {};
-            _dirty: boolean;
             appearance: TAppearanceFilledIn;
             mapView: ICore;
             constructor(options: TFloatingLabelOptionsInternal, mapView: ICore);
-            enable(): void;
+            enable(updateEngine?: boolean): void;
             get strategies(): TColliderStrategy[];
             getCachedSymbol(orientation: any, textAlign: any, xCoordinate: any): any;
             colliderDidMount(): void;
@@ -1690,7 +1734,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.FloatingLabel'
             colliderDidUpdateVisiblity(): void;
             colliderDidGoOutsideGrid(): void;
             colliderDidNotFindAHome(): void;
-            disable(): void;
+            disable(updateEngine?: boolean): void;
             draw(context: CanvasRenderingContext2D): void;
             static original: FloatingLabel;
             static clone(options: TFloatingLabelOptionsInternal, mapView: ICore): any;
@@ -1747,6 +1791,9 @@ declare module '@mappedin/mappedin-js/renderer/Camera' {
             EASE_IN_OUT = "ease-in-out"
     }
     export type TCameraAnimationOptions = {
+            /**
+                * Animation duration in milliseconds
+                */
             duration?: number;
             easing?: CAMERA_EASING_MODE;
     };
@@ -1783,27 +1830,27 @@ declare module '@mappedin/mappedin-js/renderer/Camera' {
                 */
             get zoom(): number;
             /**
-                * Current Camera rotation (in radians)
+                * Current Camera rotation (in radians) from north
                 */
             get rotation(): number;
             /**
-                * Current Camera tilt
+                * Current Camera tilt between 0 (top-down) to 1 (from the side)
                 */
             get tilt(): number;
             /**
-                * Minimum distance (in meters) the camera is allowed to get to the ground.
+                * Get the minimum distance (in meters) the camera is allowed to get to the ground.
                 */
             get minZoom(): number;
             /**
-                * Minimum distance (in meters) the camera is allowed to get to the ground.
+                * Set the minimum distance (in meters) the camera is allowed to get to the ground.
                 */
             set minZoom(meters: number);
             /**
-                * Maximum distance (in meters) the camera is allowed to get to the ground.
+                * Get the maximum distance (in meters) the camera is allowed to get from the ground.
                 */
             get maxZoom(): number;
             /**
-                * Maximum distance (in meters) the camera is allowed to get to the ground.
+                * Set the maximum distance (in meters) the camera is allowed to get from the ground.
                 */
             set maxZoom(meters: number);
             setSafeAreaInsets(insets: {
@@ -1814,7 +1861,7 @@ declare module '@mappedin/mappedin-js/renderer/Camera' {
             }): void;
             getSafeAreaInsets(): any;
             /**
-                * Determine a new Camera view state based on a collection of targets, and start animating to that state.
+                * Focus the Camera view on a collection of targets and animate to that state.
                 * @returns a Promise that resolves when the animation finishes, or rejects when it is cancelled.
                 */
             focusOn(options: TFocusOnOptions): Promise<any>;
@@ -1824,7 +1871,6 @@ declare module '@mappedin/mappedin-js/renderer/Camera' {
             set(positionOptions?: TAnimatePositionOptions): void;
             /**
                 * Animate the Camera's view to smoothly transition to a new state over time.
-                * Returns a promise that resolves when the animation completes and gets rejected if the animation is cancelled.
                 *
                 * @returns a Promise that resolves when the animation finishes, or rejects when it is cancelled.
                 */
@@ -1948,6 +1994,9 @@ declare module '@mappedin/mappedin-js/renderer/layers/BlueDot' {
     import { TEnableBlueDotOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     import { PubSub } from '@mappedin/mappedin-js/renderer/internal/pub-sub.typed';
     import EventSystemLayer from '@mappedin/mappedin-js/renderer/layers/EventSystem';
+    /**
+        * Blue Dot Layer used for controlling the Blue Dot and listening to Blue Dot state change and position update events. Use the {@link on}-method to set listeners for {@link TBlueDotStateChange} and {@link TBlueDotPositionUpdate} events.
+        */
     class BlueDotLayer extends PubSub<E_BLUEDOT_EVENT_PAYLOAD, E_BLUEDOT_EVENT> {
             #private;
             /**
@@ -1959,7 +2008,7 @@ declare module '@mappedin/mappedin-js/renderer/layers/BlueDot' {
                 */
             enable(options?: TEnableBlueDotOptions): void;
             /**
-                * Disable BlueDot
+                * Disables Blue Dot and stops emitting events.
                 */
             disable(): void;
     }
@@ -1978,7 +2027,17 @@ declare module '@mappedin/mappedin-js/renderer/layers/Journey' {
                 */
             constructor(mapView: MapView, core: ICore);
             /**
-                * Draw a Journey
+                * Draw a Journey based on directions. Example usage:
+                *
+                * ```typescript
+                * const startLocation = venue.locations.find(location => location.name === "Cleo");
+                * const endLocation = venue.locations.find(location => location.name === "American Eagle");
+                *
+                * const directions = startLocation.directionsTo(endLocation);
+                * mapView.Journey.draw(directions);
+                * ```
+                *
+                * Use options to set connection (such as elevators and escalators) HTML tooltip template, departure and destination marker templates, path style and polygon higlight color. If no options are set, sane defaults are used to draw markers, tooltips and polygon highlights.
                 */
             draw(directions: MappedinDirections | MappedinDirections[], options?: TJourneyOptions): Journey;
             /**
@@ -2023,6 +2082,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
             _started: boolean;
             _loaderPromise: null;
             _promiseResolve: null;
+            hoverableMeshChildren: any[];
             objectsDictionary: {};
             north: null;
             mapScale: null;
@@ -2043,6 +2103,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
             loadAsync: any;
             _taskScheduler: any;
             id: any;
+            mapRenderingStrategy: any;
             _highPriorityTasks: FrameTaskGroup;
             _lowPriorityTasks: FrameTaskGroup;
             _markerTasks: FrameTaskGroup;
@@ -2050,6 +2111,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
             _visibilityLatch: boolean | null;
             _objLoadedComplete: boolean;
             _objLoaded(object: any): any;
+            _objLoadedMerged(object: any): void;
             enableImageFlipping(polygonId: any, rotation: any): void;
             elements: any;
             boundingBox: {
@@ -2175,7 +2237,7 @@ declare module '@mappedin/mappedin-js/renderer' {
     import Search from '@mappedin/mappedin-js/renderer/internal/Mappedin.Search';
     import Analytics from '@mappedin/mappedin-js/renderer/internal/Mappedin.Analytics';
     import { MapView } from '@mappedin/mappedin-js/renderer/MapView';
-    import { getVenue, getVenueBundle, Mappedin, downloadBundle, getVenueBundleURL, MappedinDestinationSet, MappedinMap, TGetVenueBundleOptions, TGetVenueOptions } from '@mappedin/mappedin-js/get-venue';
+    import { getVenue, getVenueBundle, Mappedin, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, MappedinDestinationSet, MappedinMap, TGetVenueBundleOptions, TGetVenueOptions } from '@mappedin/mappedin-js/get-venue';
     import { PositionUpdater } from '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedin.BlueDot.core';
     import type { TMapViewOptions, TJourneyOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     import { labelThemes } from '@mappedin/mappedin-js/renderer/MapView.types';
@@ -2206,9 +2268,9 @@ declare module '@mappedin/mappedin-js/renderer' {
         */
     function showVenue<T extends Mappedin>(el: HTMLElement, venue: T, options?: TMapViewOptions): Promise<MapView>;
     export { COLLISION_RANKING_TIERS, STATE, E_SDK_EVENT, E_BLUEDOT_STATE_REASON, E_BLUEDOT_MARKER_STATE, E_BLUEDOT_EVENT, E_BLUEDOT_STATE, E_CAMERA_EVENT } from '@mappedin/mappedin-js/renderer/MapView.enums';
-    export { Search, getVenue, getVenueBundle, showVenue, downloadBundle, getVenueBundleURL, PositionUpdater, Analytics, MappedinDestinationSet, MARKER_ANCHOR, labelThemes };
+    export { Search, getVenue, getVenueBundle, showVenue, downloadBundle, getVenueBundleURL, downloadVenueBundleMVF, PositionUpdater, Analytics, MappedinDestinationSet, MARKER_ANCHOR, labelThemes };
     import DefaultAssetManager from '@mappedin/mappedin-js/renderer/internal/Mappedin.AssetManager';
-    const setAssetManager: (am: any) => void;
+    const setAssetManager: <T extends DefaultAssetManager>(am: T) => void;
     /**
         * @internal
         */
@@ -2223,43 +2285,54 @@ declare module '@mappedin/mappedin-js/renderer' {
     export type { TSafeAreaInsets, TFocusOnTargets, TFocusOnCameraOptions, TAnimatePositionOptions, TCameraAnimationOptions, TFocusOnOptions, default as Camera } from '@mappedin/mappedin-js/renderer/Camera';
     export { SAFE_AREA_INSET_TYPE, ANIMATION_TWEENS, CAMERA_EASING_MODE } from '@mappedin/mappedin-js/renderer/Camera';
     export type { TGetVenueOptions, MappedinLocation, MappedinPolygon, MappedinNode, MappedinCategory, MappedinMap, MappedinEvent, MappedinMapGroup, MappedinVenue, MappedinVortex, MappedinNavigatable, MappedinCoordinate, TShowVenueOptions } from '@mappedin/mappedin-js/get-venue';
-    export { Mappedin, MappedinDirections } from '@mappedin/mappedin-js/get-venue';
+    export { Mappedin, MappedinDirections, MAP_RENDER_MODE } from '@mappedin/mappedin-js/get-venue';
 }
 
 declare module '@mappedin/mappedin-js/get-venue/Mappedin.types' {
     export type TGetVenueOptions = {
-        accessToken?: string;
-        clientId?: string;
-        clientSecret?: string;
-        baseUrl?: string;
-        includeHidden?: boolean;
-        noAuth?: boolean;
-        perspective?: string;
-        language?: string;
-        headers?: {
-            [key in string]: string;
-        };
-        venue: string;
-        things?: any;
+            accessToken?: string;
+            clientId?: string;
+            clientSecret?: string;
+            baseUrl?: string;
+            includeHidden?: boolean;
+            noAuth?: boolean;
+            perspective?: string;
+            language?: string;
+            headers?: {
+                    [key in string]: string;
+            };
+            venue: string;
+            things?: any;
     };
     export type TGetVenueOptionsInternal = {
-        baseUrl?: string;
-        supplementaryUrl?: string;
-        noAuth?: boolean;
-        includeHidden?: boolean;
-        apiGateway?: string;
-        authorization?: string;
-        /**
-          * @deprecated 2D support will be removed in the future
-          */
-        do2D?: boolean;
-        things?: any;
-        headers?: any;
+            baseUrl?: string;
+            supplementaryUrl?: string;
+            noAuth?: boolean;
+            includeHidden?: boolean;
+            apiGateway?: string;
+            authorization?: string;
+            /**
+                * @deprecated 2D support will be removed in the future
+                */
+            do2D?: boolean;
+            things?: any;
+            headers?: any;
     };
+    export enum MAP_RENDER_MODE {
+            /** Each polygon, its geometry and mesh are sent to the GPU every render frame.
+                * This was the default rendering mode before 4.0.17
+                */
+            MULTI_GEOMETRY = "MULTI_GEOMETRY",
+            /** Polygons' geometries are grouped by material and merged together, resulting in far fewer
+                * draw calls to the GPU. Default rendering mode since 4.0.17
+                */
+            SINGLE_GEOMETRY = "SINGLE_GEOMETRY"
+    }
 }
 
 declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
     import { Navigator } from '@mappedin/mappedin-js/navigator';
+    import { MVFData } from '@mappedin/mappedin-js/get-venue/Mappedin.MVF.types';
     import type { TGetVenueOptions, TGetVenueOptionsInternal } from '@mappedin/mappedin-js/get-venue/Mappedin.types';
     import { MappedinCategory } from '@mappedin/mappedin-js/get-venue/MappedinCategory';
     import { MappedinEvent } from '@mappedin/mappedin-js/get-venue/MappedinEvent';
@@ -2275,7 +2348,7 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
     import { MappedinVenue } from '@mappedin/mappedin-js/get-venue/MappedinVenue';
     import { MappedinVortex } from '@mappedin/mappedin-js/get-venue/MappedinVortex';
     export const defaultOptions: TGetVenueOptionsInternal & TGetVenueOptions;
-    export enum CollectionType {
+    export enum MappedinCollectionType {
             CATEGORY = "categories",
             EVENT = "events",
             LOCATION = "locations",
@@ -2286,14 +2359,14 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
             VORTEX = "vortexes"
     }
     type TAccessors = {
-            [CollectionType.CATEGORY]: MappedinCategory;
-            [CollectionType.EVENT]: MappedinEvent;
-            [CollectionType.LOCATION]: MappedinLocation;
-            [CollectionType.MAPGROUP]: MappedinMapGroup;
-            [CollectionType.MAP]: MappedinMap;
-            [CollectionType.NODE]: MappedinNode;
-            [CollectionType.POLYGON]: MappedinPolygon;
-            [CollectionType.VORTEX]: MappedinVortex;
+            [MappedinCollectionType.CATEGORY]: MappedinCategory;
+            [MappedinCollectionType.EVENT]: MappedinEvent;
+            [MappedinCollectionType.LOCATION]: MappedinLocation;
+            [MappedinCollectionType.MAPGROUP]: MappedinMapGroup;
+            [MappedinCollectionType.MAP]: MappedinMap;
+            [MappedinCollectionType.NODE]: MappedinNode;
+            [MappedinCollectionType.POLYGON]: MappedinPolygon;
+            [MappedinCollectionType.VORTEX]: MappedinVortex;
     };
     const THINGS: {
             categories: typeof MappedinCategory;
@@ -2489,6 +2562,11 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
                     [id: string]: MappedinRankings;
             };
             getCollectionItemById<T extends keyof TAccessors, I extends string>(name: T, id: I): TAccessors[T] | null;
+            /**
+                * @hidden
+                * @internal
+                */
+            hydrateFromMVF(mvfData: MVFData): Promise<undefined>;
             /**
                 *
                 * [experimental] Hydrate the Mappedin instance using a response from either {@link IMappedin.toString()}, {@link getVenueBundle} or by downloading the bundle manually
@@ -2623,6 +2701,59 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinPolygon' {
     export class MappedinPolygon extends MappedinNavigatable {
             #private;
             geometry: any;
+            image?: {
+                    visible: boolean;
+                    url: string | Blob;
+                    original: string | Blob;
+                    useLocalScaling: boolean;
+                    viewBox: {
+                            width: number;
+                            height: number;
+                    };
+                    scale: {
+                            x: number;
+                            y: number;
+                    };
+                    fitToBounds: boolean;
+                    position: {
+                            x: number;
+                            y: number;
+                            z: number;
+                    };
+                    rotation: {
+                            x: number;
+                            y: number;
+                            z: number;
+                    };
+            };
+            holes?: unknown[];
+            textures?: {
+                    image: any;
+                    name: 'front' | 'side';
+                    useFrontFaceImage?: boolean;
+            }[];
+            material: {
+                    color: string;
+                    opacity?: number;
+            };
+            label?: {
+                    visible: boolean;
+                    text: string;
+                    align: string;
+                    position: {
+                            x: number;
+                            y: number;
+                            z: number;
+                    };
+                    rotation: {
+                            x: number;
+                            y: number;
+                            z: number;
+                    };
+                    fontFamily: string;
+                    fontSize: number;
+                    color: string;
+            };
             /**
                 * Node ID.
                 *
@@ -2809,6 +2940,7 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinMap' {
     import type { TGeoReference } from '@mappedin/mappedin-js/get-venue/Mappedin.API.types';
     import type { MappedinMapGroup } from '@mappedin/mappedin-js/get-venue/MappedinMapGroup';
     import { MappedinCoordinate } from '@mappedin/mappedin-js/get-venue/MappedinCoordinate';
+    import { MappedinLocation } from '@mappedin/mappedin-js/get-venue';
     /**
         * A {@link MappedinMap} belonging to a specific {@link MappedinVenue}. Typically represents a certain floor. Give this to a {@link MapView} to display to the user.
         *
@@ -2835,6 +2967,11 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinMap' {
             shortName: string;
             elevation: number;
             scale?: number;
+            layers: {
+                    visible: boolean;
+                    name: string;
+                    id: string;
+            }[];
             x_scale?: number;
             perspectiveId?: string;
             scene: any;
@@ -2849,6 +2986,11 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinMap' {
                 * @property polygons {[MappedinPolygon]}
                 */
             get polygons(): MappedinPolygon[] | undefined;
+            /**
+                * Locations on this map
+                */
+            get locations(): MappedinLocation[];
+            get nodes(): import("./MappedinNode").MappedinNode[];
             /**
                 * Map Group this map belongs to.
                 *
@@ -2886,28 +3028,56 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinEvent' {
     import type { Mappedin } from '@mappedin/mappedin-js/get-venue/Mappedin';
     import type { MappedinLocation } from '@mappedin/mappedin-js/get-venue/MappedinLocation';
     /**
-        * An event.
+        * An event such as a promotion attached to a location in a venue for a period of time. Events can be created in the Mappedin CMS.
         *
         * @class MappedinEvent
         */
     export class MappedinEvent {
             #private;
+            /**
+                * Unique id string of the event.
+                */
             id: string;
             type: string;
+            /**
+                * Event name
+                */
             name: string;
+            /**
+                * Optional, longer description of the event.
+                */
             description?: string | undefined;
+            /**
+                * Optional image to be used for displaying the event.
+                */
             image?: TImage | undefined;
+            /**
+                * Start timestamp of the event. Javascript date in milliseconds since 1 January 1970 UTC.
+                */
             startDate?: number | undefined;
+            /**
+                * Start timestamp of the event. Javascript date in milliseconds since 1 January 1970 UTC.
+                */
             endDate?: number | undefined;
+            /**
+                * Timestamp when the event should be displayed. Javascript date in milliseconds since 1 January 1970 UTC.
+                */
             showDate?: number | undefined;
+            /**
+                * @internal
+                */
             constructor(mappedin: Mappedin, data: any);
             /**
-                * Location this Event is occuring at.
-                *
-                * @property location {MappedinLocation}
+                * Location this event is occuring at.
                 */
             location(): MappedinLocation | undefined;
+            /**
+                * @internal
+                */
             static hydrate(events: any, mappedin: Mappedin): MappedinEvent[];
+            /**
+                * @internal
+                */
             static fetch(mappedin: Mappedin): Promise<MappedinEvent[]>;
             toJSON(): any;
     }
@@ -2980,9 +3150,10 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinVenue' {
         tzidOverride: string;
         utcOffset: string;
         website: string;
-        constructor(data: any);
-        static hydrate(data: any): MappedinVenue;
+        constructor(mappedin: Mappedin, data: any);
+        static hydrate(data: any, mappedin: Mappedin): MappedinVenue;
         static fetch(mappedin: Mappedin): Promise<MappedinVenue>;
+        get isMultiBuilding(): any;
         toJSON(): any;
     }
 }
@@ -3256,9 +3427,6 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.API.types' {
     export type TMapGroup = {
         name: string;
         id: string;
-        maps: {
-            id: TMap['id'];
-        }[];
     };
     export type TBuilding = TLocation & {
         groupId: string;
@@ -3311,27 +3479,32 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.API.types' {
         entranceNodeId: string;
         score: number;
     };
-    export type TVenue = {
-        address: string;
-        city: string;
-        countrycode: string;
-        defaultMap: string;
-        externalId: string;
+    export type TLocationState = {
         id: string;
-        latitude: number;
-        logo: TLogo;
-        longitude: number;
-        metadata?: any;
         name: string;
-        operationHours: TOpeningHours[];
-        postal: string;
-        slug: string;
-        state: string;
-        telephone: string;
-        tzid: string;
-        tzidOverride: string;
-        utcOffset: string;
-        website: string;
+        value: string;
+    };
+    export type TVenue = {
+        address?: string;
+        city?: string;
+        countrycode?: string;
+        defaultMap?: string;
+        externalId?: string;
+        id?: string;
+        latitude?: number;
+        logo?: TLogo;
+        longitude?: number;
+        metadata?: any;
+        name?: string;
+        operationHours?: TOpeningHours[];
+        postal?: string;
+        slug?: string;
+        state?: string;
+        telephone?: string;
+        tzid?: string;
+        tzidOverride?: string;
+        utcOffset?: string;
+        website?: string;
     };
     export type TMappedinAPI = {
         nodes: TNode[];
@@ -3343,6 +3516,7 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.API.types' {
         themes: any;
         venue: TVenue;
         vortexes: TVortex[];
+        locationStates?: TLocationState[];
     };
 }
 
@@ -3449,7 +3623,7 @@ declare module '@mappedin/mappedin-js/renderer/Core.interface' {
                 */
             polygons?: (MappedinPolygon | MappedinPolygon['id'])[];
             /**
-                * The duration the focus animation should last for.
+                * The duration (in ms) the focus animation should last for.
                 * @defaultValue `100`
                 */
             duration?: number;
@@ -3488,6 +3662,7 @@ declare module '@mappedin/mappedin-js/renderer/Core.interface' {
                 * @internal
                 */
             currentScale: number;
+            loadOptions?: TMapViewOptions['loadOptions'];
             imageFlippingEnabled: boolean;
             imageFlippingCache: any;
             cachedPadding: any;
@@ -3761,8 +3936,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.LabelAtlas' {
     }
     export class FlatLabel {
         constructor(options: any, venue: any, mapObject: any, DEFAULT_FONT: any, polygonMeshesById: any, textLabelsByPolygonId: any, mapView: any, scope: any, atlas: any);
+        id: any;
         text: any;
         stateText: string;
+        fullText: any;
         font: any;
         atlas: any;
         canvasBounds: any;
@@ -3847,6 +4024,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.HTMLCollider' {
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider' {
     import SmartCollisionEngine from '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollisionEngine';
     import { Vector3 } from 'three';
+    import { Rectangle } from '@mappedin/mappedin-js/renderer/internal/quad-tree';
     export type TRange = [number, number, number, number];
     type TCustomCollider<T> = ICollider & T;
     export type TColliderStrategyProps = {
@@ -3860,6 +4038,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider'
         getBoundingBox: (TColliderStrategyProps: any) => TRange;
         onStrategySelected: (collider: TCustomCollider<any>) => void;
     };
+    type TGetBoundingBox = ({ x, y }: {
+        x: any;
+        y: any;
+    }) => [number, number, number, number];
     export type TDimensions = {
         width: number;
         height: number;
@@ -3872,13 +4054,19 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider'
     export interface ICollider {
         dimensions: TDimensions;
         screenPosition: [number, number];
-        currentStrategyName: string | null;
+        getBoundingBoxForCurrentStrategy?: TGetBoundingBox;
         options?: Record<string, unknown>;
         mapId: string;
         visible: boolean;
         rank: number;
-        _dirty?: boolean;
         id: string;
+        _bboxes?: [
+            string,
+            Rectangle,
+            (collider: TCustomCollider<any>) => void,
+            TGetBoundingBox
+        ][];
+        offscreen?: boolean;
         setAction: (action: EColliderAction) => void;
         action?: EColliderAction;
         position: Vector3;
@@ -3902,14 +4090,15 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider'
         __engine: any;
         _initialRank: number;
         screenPosition: [number, number];
-        currentStrategyName: null;
         enabled: boolean;
         options: any;
         mapId: string;
         id: string;
         action: EColliderAction;
+        getBoundingBoxForCurrentStrategy: undefined;
         rank: number;
         visible: boolean;
+        offscreen: boolean;
         position: Vector3;
         dimensions: {
             width: number;
@@ -4723,6 +4912,209 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
     export {};
 }
 
+declare module '@mappedin/mappedin-js/get-venue/Mappedin.MVF.types' {
+    import { FeatureCollection, Polygon, Point, MultiPolygon } from 'geojson';
+    type ManifestFile = {
+        type: 'file';
+        name: string;
+    };
+    type ManifestFolder = {
+        type: 'folder';
+        name: string;
+        children: ManifestFile[];
+    };
+    type OpeningHours = {
+        opens: string;
+        closes: string;
+        dayOfWeek: string;
+        validFrom?: string;
+        validThrough?: string;
+    };
+    type Image = {
+        original?: string;
+        xlarge?: string;
+        xxlarge?: string;
+        medium?: string;
+        '140x140'?: string;
+        xsmall?: string;
+        xxsmall?: string;
+        '66x66'?: string;
+        small?: string;
+        large?: string;
+    };
+    type PolygonImage = string;
+    type Phone = {
+        number: string;
+        extension?: string;
+    };
+    type Link = {
+        label: string;
+        url: string;
+    };
+    type Social = {
+        facebook?: string;
+        twitter?: string;
+        instagram?: string;
+        website?: string;
+    };
+    type LocationState = {
+        type: string;
+        start?: string;
+        end?: string;
+    };
+    type ImageTransform = {
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotation: number;
+        scale: {
+            x: number;
+            y: number;
+        };
+    };
+    type SiblingGroup = {
+        label: string;
+        siblings: string[];
+    };
+    export type MILocationProperties = {
+        id: string;
+        address?: string | null;
+        categories: string[];
+        description?: string | null;
+        email?: string | null;
+        externalId?: string | null;
+        hours?: OpeningHours[] | null;
+        links?: Link[] | null;
+        logo?: Image | null;
+        name: string;
+        phone?: Phone | null;
+        picture?: Image | null;
+        services?: string | null;
+        siblingGroups?: SiblingGroup[] | null;
+        social?: Social | null;
+        spaces?: TLocationSpaceReference[] | null;
+        states?: LocationState[] | null;
+        type: string;
+    };
+    export type MICategoryProperties = {
+        id: string;
+        name: string;
+        picture?: Image;
+    };
+    export type MIBuildingProperties = {
+        id: string;
+        name: string;
+        venue: string;
+    };
+    export type MILevelProperties = {
+        id: string;
+        abbreviation?: string;
+        building?: string;
+        elevation?: number;
+        name: string;
+    };
+    export type MIPolygonlikeProperties = {
+        id: string;
+        altitude?: string;
+        color?: string;
+        externalId?: string | null;
+        height?: string;
+        layer?: string;
+        level: string;
+        parent?: string | null;
+    };
+    type TPseudoNodeSpaceReference = {
+        node: string;
+        map: string;
+    };
+    export type TRealSpaceReference = {
+        id: string;
+        map: string;
+    };
+    type TLocationSpaceReference = TPseudoNodeSpaceReference | TRealSpaceReference;
+    export type TEntrances = {
+        id: string;
+        level: string;
+    };
+    export type MISpaceProperties = MIPolygonlikeProperties & {
+        entrances: TEntrances[];
+    };
+    export type MIObstructionProperties = MIPolygonlikeProperties;
+    export type MIConnectionProperties = {
+        id: string;
+        accessible: boolean;
+        destinations: string[];
+        level: string;
+        multiplier: number;
+        name: string;
+        type: string;
+        weight: number;
+    };
+    export type MINodeProperties = {
+        id: string;
+        accessible: boolean;
+        externalId: string | null;
+        level: string;
+        multiplier: number;
+        neighbors: string[];
+        weight: number;
+    };
+    export type MIManifestProperties = {
+        name: string;
+        folder_struct: (ManifestFolder | ManifestFile)[];
+        version: string;
+        time: string;
+    };
+    export type MILayerStyleProperties = {
+        layer: string;
+        altitude: number;
+        color: string;
+        height: number;
+        opacity: number;
+    };
+    export type MIPolygonStyleProperties = {
+        id: string;
+        altitude: number;
+        color: string;
+        height: number;
+        image: PolygonImage;
+        imageTransform: ImageTransform;
+        opacity: number;
+    };
+    export type MIGeoJSONManifestCollection = FeatureCollection<Point, MIManifestProperties>;
+    export type MIGeoJSONBuildingCollection = FeatureCollection<Polygon, MIBuildingProperties>;
+    export type MIGeoJSONConnectionCollection = FeatureCollection<Point, MIConnectionProperties>;
+    export type MIGeoJSONLevelCollection = FeatureCollection<Polygon | MultiPolygon, MILevelProperties>;
+    export type MIGeoJSONSpaceCollection = FeatureCollection<Polygon, MISpaceProperties>;
+    export type MIGeoJSONObstructionCollection = FeatureCollection<Polygon, MIObstructionProperties>;
+    export type MIGeoJSONNodeCollection = FeatureCollection<Point, MINodeProperties>;
+    export type MIGeoJSONLocationCollection = FeatureCollection<null, MILocationProperties>;
+    export type MIGeoJSONCategoryCollection = FeatureCollection<null, MICategoryProperties>;
+    export type MIGeoJSONLayerStyleCollection = FeatureCollection<null, MILayerStyleProperties>;
+    export type MIGeoJSONPolygonStyleCollection = FeatureCollection<null, MIPolygonStyleProperties>;
+    export type WithIDs<T> = Map<string, T>;
+    /**
+      * The entire data collection for an MVF, in a single JSON collection.
+      *
+      */
+    export type MVFData = {
+        connection: WithIDs<MIGeoJSONConnectionCollection>;
+        level: WithIDs<MIGeoJSONLevelCollection>;
+        node: WithIDs<MIGeoJSONNodeCollection>;
+        obstruction: WithIDs<MIGeoJSONObstructionCollection>;
+        polygonStyle: WithIDs<MIGeoJSONPolygonStyleCollection>;
+        space: WithIDs<MIGeoJSONSpaceCollection>;
+        building: MIGeoJSONBuildingCollection;
+        category: MIGeoJSONCategoryCollection;
+        layerStyle: MIGeoJSONLayerStyleCollection;
+        location: MIGeoJSONLocationCollection;
+        manifest: MIGeoJSONManifestCollection;
+    };
+    export {};
+}
+
 declare module '@mappedin/mappedin-js/get-venue/MappedinLocationRankings' {
     import type { Mappedin } from '@mappedin/mappedin-js/get-venue/Mappedin';
     import type { TLocation } from '@mappedin/mappedin-js/get-venue/Mappedin.API.types';
@@ -4804,56 +5196,85 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollisionE
     import './Mappedin.SmartCollisionEngine.scss';
     import { ICollider, TRange } from '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider';
     import { MappedinMap, MapView } from '@mappedin/mappedin-js/renderer';
+    import { ICore } from '@mappedin/mappedin-js/renderer/Core.interface';
+    import { Rectangle, QuadTree } from '@mappedin/mappedin-js/renderer/internal/quad-tree';
     export const COLLIDER_STRATEGY_LOW_PRIORITY = "LOW_PRIORITY";
     class SmartCollisionEngine {
-            #private;
-            _makeCollidersDirtyThrottled: any;
-            colliderCanvas: HTMLCanvasElement;
-            debugCanvas: HTMLCanvasElement;
-            colliderCanvasContext: CanvasRenderingContext2D;
-            debugCanvasContext: CanvasRenderingContext2D;
-            collisionEngineContainerEl: HTMLDivElement;
-            stepsX: any;
-            stepsY: any;
-            totalWidth: any;
-            totalHeight: any;
-            project: any;
-            grid: Uint8Array;
-            colliders: Map<string, ICollider>;
-            offscreenRanges: TRange[];
-            get sortedColliders(): ICollider[];
-            initialized: boolean;
-            mapView: MapView;
-            constructor(mapView: any);
-            init: (container: HTMLDivElement, projectFn: ({ position, mapId }: {
-                    position: Vector3;
-                    mapId: MappedinMap['id'];
-            }) => {
-                    x: number;
-                    y: number;
-            }) => void;
-            updatePosition: () => void;
-            updateVisibility: () => void;
-            add: (colliderId: string, collider: ICollider) => void;
-            remove: (colliderId: string) => void;
-            /**
-                * When adding/removing new colliders, or when updating their priorty, we need to make all colliders around them as "dirty",
-                * so they can be reconcilded correctly
-                */
-            makeCollidersDirty: () => void;
-            /**
-                * Allow to throttle making collders dirty. This is useful for things like BlueDot follow mode,
-                * As we follow the BlueDot, colliders will overlap, but constantly updating their visiblity makes
-                * for a bad experience
-                */
-            makeCollidersDirtyThrottled: (time: any) => void;
-            resize: (container: any) => void;
-            update: () => void;
-            destroy: () => void;
+        #private;
+        colliderCanvas: HTMLCanvasElement;
+        debugCanvas: HTMLCanvasElement;
+        colliderCanvasContext: CanvasRenderingContext2D;
+        debugCanvasContext: CanvasRenderingContext2D;
+        collisionEngineContainerEl: HTMLDivElement;
+        stepsX: any;
+        stepsY: any;
+        totalWidth: any;
+        totalHeight: any;
+        project: any;
+        colliders: Map<string, ICollider>;
+        offscreenRanges: TRange[];
+        get sortedColliders(): ICollider[];
+        initialized: boolean;
+        mapView: MapView;
+        core: ICore;
+        screen: Rectangle;
+        constructor(mapView: any, core: ICore);
+        init: (container: HTMLDivElement, projectFn: ({ position, mapId }: {
+            position: Vector3;
+            mapId: MappedinMap['id'];
+        }) => {
+            x: number;
+            y: number;
+        }) => void;
+        qtree: QuadTree;
+        recompute: () => void;
+        draw: () => void;
+        reposition: () => void;
+        add: (colliderId: string, collider: ICollider) => void;
+        remove: (colliderId: string) => void;
+        update: () => void;
+        resize: (container: any) => void;
+        destroy: () => void;
     }
     export default SmartCollisionEngine;
 }
 
+declare module '@mappedin/mappedin-js/renderer/internal/quad-tree' {
+    export function contains(rect1: Rectangle, rect2: Rectangle): boolean;
+    export function intersects(rect1: Rectangle, rect2: Rectangle): boolean;
+    class Rectangle {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        userData?: any;
+        constructor(x: number, y: number, w: number, h: number, userData?: any);
+        contains(rectangle: Rectangle): boolean;
+        intersects(rectangle: Rectangle): boolean;
+        draw(context: CanvasRenderingContext2D): void;
+    }
+    class QuadTree {
+        #private;
+        boundary: Rectangle;
+        capacity: number;
+        objects: Rectangle[];
+        topLeft: QuadTree;
+        topRight: QuadTree;
+        bottomLeft: QuadTree;
+        bottomRight: QuadTree;
+        divided: boolean;
+        parent?: QuadTree;
+        getSize(): any;
+        constructor(boundary: Rectangle, parent?: QuadTree);
+        subdivide(): void;
+        query(rectangle: Rectangle): Rectangle[];
+        insert(rectangle: Rectangle): boolean;
+        drawObjects(context: CanvasRenderingContext2D): void;
+        draw(context: CanvasRenderingContext2D): void;
+    }
+    export { QuadTree, Rectangle };
+}
+
 declare module '@mappedin/mappedin-js/navigator/Edge' {
     import INode from '@mappedin/mappedin-js/navigator/interfaces/INode';
     import IVortex from '@mappedin/mappedin-js/navigator/interfaces/IVortex';