@mappedin/mappedin-js 4.1.0-beta.2 → 4.1.2

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

@@ -1,16 +1,15 @@
 // Generated by dts-bundle v0.7.3
 // Dependencies for this module:
 //   ../three
-//   ../three/src/core/Object3D
-//   ../three/src/math/Vector3
+//   ../minisearch
 //   ../@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 Analytics from '@mappedin/mappedin-js/get-venue/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 +40,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
         */
@@ -57,8 +56,9 @@ declare module '@mappedin/mappedin-js' {
     export type { MapView } from '@mappedin/mappedin-js/renderer/MapView';
     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 type { TGetVenueOptions, TShowVenueOptions, TMappedinOfflineSearchOptions, TMappedinOfflineSearchResult, TMappedinOfflineSearchSuggestions, TMappedinOfflineAllSearchMatch, TMappedinOfflineSearchAllOptions } from '@mappedin/mappedin-js/get-venue';
+    export { Mappedin, MappedinDirections, MappedinLocation, MappedinPolygon, MappedinNode, MappedinCategory, MappedinMap, MappedinEvent, MappedinMapGroup, MappedinVenue, MappedinVortex, MappedinNavigatable, MappedinCoordinate, OfflineSearch, MAP_RENDER_MODE, setFetchFn } from '@mappedin/mappedin-js/get-venue';
+    export { BundleAssetManager } from '@mappedin/mappedin-js/renderer/bundle-asset-manager';
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Search' {
@@ -80,21 +80,89 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Search' {
     let Search: any;
 }
 
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Analytics' {
-    export default Analytics;
+declare module '@mappedin/mappedin-js/get-venue/Mappedin.Analytics' {
+    type AnalyticsOptions = {
+            clientId?: string;
+            clientSecret?: string;
+            accessToken?: string;
+            noAuth?: boolean;
+            venue: string;
+            testMode?: boolean | string;
+            context?: string;
+            platformString?: string;
+    };
     /**
-      * A class to access the Mappedin Analytics platform. Correct usage will improve Smart Search results, and lead to more accurate insights.
-      * This will be created for you as part of Mappedin.{{#crossLink "Mappedin/initialize:method"}}{{/crossLink}}, but you can also create one manually. You are mostly going to use `locationSelected`.
-      *
-      * @type {any}
-      *
-      * @class Analytics
-      * @param options {Object} A list of configuration options for the Analytics API.
-      *	@param [options.key] {String} The same key you are using for getVenue. Handled automatically in Mapview.initialize()
-      *	@param [options.secret] {String} The same secret you are using for getVenue. Handled automatically in Mapview.initialize()
-      *	@param [options.venue] {String} The same venue slug you are using for getVenue. Handled automatically in MapView.initialize()
-      */
-    var Analytics: any;
+        * A class to access the Mappedin Analytics platform. Correct usage will improve Smart Search results, and lead to more accurate insights.
+        * This will be created for you as part of Mappedin.{{#crossLink "Mappedin/initialize:method"}}{{/crossLink}}, but you can also create one manually. You are mostly going to use `locationSelected`.
+        *
+        * @type {any}
+        *
+        * @class Analytics
+        * @param options {Object} A list of configuration options for the Analytics API.
+        *	@param [options.clientId] {String} The same key you are using for getVenue. Handled automatically in Mapview.initialize()
+        *	@param [options.clientSecret] {String} The same secret you are using for getVenue. Handled automatically in Mapview.initialize()
+        *	@param [options.venue] {String} The same venue slug you are using for getVenue. Handled automatically in MapView.initialize()
+        *	@param [options.context] {String} The context to pass with the analytics request. Defaults to "websdk".
+        *	@param [options.noAuth] {Boolean} Whether authentication should not be sent with analytics requests.
+        *	@param [options.testMode] {Boolean} Whether analytics events should be dropped because this is running in a test environment.
+        */
+    class Analytics {
+            #private;
+            constructor(options: AnalyticsOptions);
+            track(target: any, query: any): void;
+            /**
+                * Whenever a location is selected, you should fire this event. What "selected" means can vary by venue,
+                * but a good rule of thumb is that you fire the event whenever you would show the location's details.
+                * Typically this is when the user taps it's polygon on the map, picks it from search results or a category list.
+                * or deep links directly into the map.
+                * @method locationSelected
+                * @param location {MappedinLocation} The location the user selected.
+                */
+            locationSelected(location: any): void;
+            /**
+                * Whenever a category is selected, you should fire this event.
+                * @method categorySelected
+                * @param category {MappedinCategory} The category the user selected.
+                */
+            categorySelected(category: any): void;
+            mapViewLoaded(type: any, forced: any, benchmark: any, reason: any): void;
+            /**
+                * Whenever a user requests directions, you should fire this event.
+                * @method getDirections
+                * @param start {MappedinLocation} The start location for wayfinding.
+                * @param end {MappedinLocation} The end location for wayfinding.
+                */
+            getDirections(start: any, end: any): void;
+            getSessionID(): string;
+            getDeviceID(): string;
+            /**
+                * @param mode {Boolean} Indicates whether the user's geolocation is enabled.
+                */
+            setGeolocationMode(mode: any): void;
+            /**
+                * Track an event.
+                * @method trackBlueDotEvent
+                * @param event {String}
+                * event param should be a property of the {{#crossLink "Analytics/BLUEDOT_EVENT:property"}}{{/crossLink}} property.
+                */
+            trackBlueDotEvent(blueDotEvent: any): void;
+            trackSearch(searchAnalyticsObject: any): void;
+            trackSearchSuggest(searchAnalyticsObject: any): void;
+            /**
+                * Enum of valid bluedot events.
+                * Pass a property of this into the {{#crossLink "Analytics/trackBlueDotEvent:method"}}{{/crossLink}} method.
+                * Valid properties are: ATTEMPT_BLUEDOT, FOUND_POSITION, FOUND_FLOOR.
+                * @property BLUEDOT_EVENT {Object}
+                * @example
+                *   Analytics.trackBlueDotEvent(Analytics.BLUEDOT_EVENT.ATTEMPT_BLUEDOT)
+                */
+            static BLUEDOT_EVENT: {
+                    ATTEMPT_BLUEDOT: string;
+                    FOUND_POSITION: string;
+                    FOUND_FLOOR: string;
+            };
+    }
+    export default Analytics;
 }
 
 declare module '@mappedin/mappedin-js/renderer/MapView' {
@@ -443,8 +511,21 @@ declare module '@mappedin/mappedin-js/renderer/MapView' {
 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';
+    /**
+        * This is how we can avoid bundling in node-fetch (via isomorphic fetch),
+        * which keeps popping up in security advisories
+        * This is a pattern that most isomorphic libraries appear to use,
+        * where when running in node, you can pass your own fetch function
+        * as one is not provided by Node.js.
+        *
+        */
+    export function isomorphicFetch(): Window['fetch'];
+    /**
+        * Overwrite the internal `fetch` function with your own. Typically for use in Node.js and Jest
+        */
+    export function setFetchFn(fetchFn: any): void;
     /** 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';
@@ -464,9 +545,12 @@ declare module '@mappedin/mappedin-js/get-venue' {
     export type { IDirectionsResult } from '@mappedin/mappedin-js/navigator';
     export type { TOperationHoursMap } from '@mappedin/mappedin-js/get-venue/MappedinLocation';
     export type { TDirectionToOptions } from '@mappedin/mappedin-js/get-venue/MappedinNavigatable';
+    export { OfflineSearch } from '@mappedin/mappedin-js/get-venue/Mappedin.OfflineSearch';
+    export type { TMappedinOfflineSearchOptions, TMappedinOfflineSearchResult, TMappedinOfflineSearchSuggestions, TMappedinOfflineAllSearchMatch, TMappedinOfflineSearchAllOptions } from '@mappedin/mappedin-js/get-venue/Mappedin.OfflineSearch';
     /** 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 +562,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: TGetVenueBundleOptions): Promise<Mappedin>;
     /**
         * Get Venue Data for a Mappedin Venue
         */
@@ -522,6 +616,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: TGetVenueBundleOptions, 
+    /**
+        * 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 +758,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 +780,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;
             /**
@@ -681,6 +792,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.BlueDot/Mappedi
                 */
             message?: GeolocationPositionError | string;
     };
+    export const FALLBACK_TO_GPS_TIMEOUT = 10000;
     type TBlueDotProps = {
             data: any;
             mapView: MapView;
@@ -702,7 +814,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 +1084,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 +1113,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 +1132,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 +1168,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 +1238,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 +1261,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 +1271,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 +1306,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 +1341,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 +1440,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 +1486,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 +1518,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 +1556,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 +1589,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 } from 'three';
     import type { MappedinMap } from '@mappedin/mappedin-js/renderer';
     export default class DefaultAssetManager {
-        textureLoader: TextureLoader;
+        textureLoader: any;
         loadMapPolygons(map: MappedinMap): Promise<any>;
-        loadImage(url: string): Promise<unknown>;
+        loadImage(url: string): Promise<Texture>;
     }
 }
 
@@ -1667,6 +1795,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.FloatingLabel'
             RIGHT = "right"
     }
     class FloatingLabel extends BaseCollider implements ISmarterLabel {
+            #private;
             lines: number;
             contextConfigured: boolean;
             fillText: TDrawFn | undefined;
@@ -1676,11 +1805,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;
@@ -1689,7 +1817,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;
@@ -1732,6 +1860,7 @@ declare module '@mappedin/mappedin-js/renderer/Camera' {
             zoom?: number;
             tilt?: number;
             rotation?: number;
+            position?: MappedinCoordinate | MappedinNode;
     };
     export const ANIMATION_TWEENS: {
             linear: any;
@@ -1746,6 +1875,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;
     };
@@ -1782,29 +1914,66 @@ 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 angle (in radians), relative to a top-down view.
+                *
+                * ex: 0 means the camera is facing top-down, π/2 means the camera is
+                * facing directly from the side.
                 */
             get tilt(): number;
             /**
-                * 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);
+            /**
+                * Get the current maximum tilt angle (in radians) the camera is allowed to use.
+                */
+            get maxTilt(): number;
+            /**
+                * Sets the maximum tilt angle (in radians) the camera is allowed to use.
+                *
+                * Tilt angle must be between 0 and π/2 radians. It will be clamped within
+                * this range if it exceeds it on either end.
+                *
+                * As tilt angle approaches π/2 radians, this will impact overall touch controls
+                * and should be used sparingly.
+                */
+            set maxTilt(radians: number);
+            /**
+                * Get the current camera position, which is at the center of the map.
+                * @returns the position as a coordinate
+                */
+            get position(): MappedinCoordinate;
+            /**
+                * User camera interactions
+                */
+            interactions: {
+                    /**
+                        * Enable all user interactions. This does not affect programmatic
+                        * Camera controls, such as `set` and `focusOn`
+                        */
+                    enable: () => void;
+                    /**
+                        * Disable all user interactions. This does not affect programmatic
+                        * Camera controls, such as `set` and `focusOn`
+                        */
+                    disable: () => void;
+            };
             setSafeAreaInsets(insets: {
                     top: number;
                     left: number;
@@ -1813,7 +1982,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>;
@@ -1823,7 +1992,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.
                 */
@@ -1839,6 +2007,18 @@ declare module '@mappedin/mappedin-js/renderer/Camera' {
     export default Camera;
 }
 
+declare module '@mappedin/mappedin-js/renderer/bundle-asset-manager' {
+    import type { Texture } from 'three';
+    import { Mappedin, MappedinMap } from '@mappedin/mappedin-js/renderer';
+    import AssetManager from '@mappedin/mappedin-js/renderer/internal/Mappedin.AssetManager';
+    export class BundleAssetManager extends AssetManager {
+        venueData: Mappedin;
+        constructor(venueData: Mappedin);
+        loadMapPolygons(map: MappedinMap): Promise<Record<string, any>>;
+        loadImage(url: string): Promise<Texture>;
+    }
+}
+
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartTooltip' {
     import './Mappedin.SmartTooltip.scss';
     import { COLLISION_RANKING_TIERS } from '@mappedin/mappedin-js/renderer/MapView.enums';
@@ -1947,6 +2127,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;
             /**
@@ -1958,7 +2141,7 @@ declare module '@mappedin/mappedin-js/renderer/layers/BlueDot' {
                 */
             enable(options?: TEnableBlueDotOptions): void;
             /**
-                * Disable BlueDot
+                * Disables Blue Dot and stops emitting events.
                 */
             disable(): void;
     }
@@ -1977,7 +2160,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;
             /**
@@ -1993,6 +2186,15 @@ declare module '@mappedin/mappedin-js/renderer/layers/Journey' {
 }
 
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
+    export namespace TASK_PRIORITY {
+            const VISIBLE_MAP_HIGH: number;
+            const VISIBLE_MAP_LOW: number;
+            const VISIBLE_MAP_MARKER: number;
+            const ASYNC_MAP_HIGH: number;
+            const ASYNC_MAP_LOW: number;
+            const ASYNC_MAP_MARKER: number;
+            const MAP_LOADED: number;
+    }
     export const SCENE_FROM_LIVE_JSON: false;
     /**
         * A handle to a 3D marker added to a map.
@@ -2022,10 +2224,11 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
             _started: boolean;
             _loaderPromise: null;
             _promiseResolve: null;
+            hoverableMeshChildren: any[];
             objectsDictionary: {};
             north: null;
             mapScale: null;
-            object: Object3D;
+            object: any;
             labels: Set<any>;
             tooltips: Set<any>;
             markers: Set<any>;
@@ -2042,6 +2245,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
             loadAsync: any;
             _taskScheduler: any;
             id: any;
+            mapRenderingStrategy: any;
             _highPriorityTasks: FrameTaskGroup;
             _lowPriorityTasks: FrameTaskGroup;
             _markerTasks: FrameTaskGroup;
@@ -2049,11 +2253,12 @@ 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: {
-                    min: Vector3;
-                    max: Vector3;
+                    min: any;
+                    max: any;
             } | undefined;
             loadPolygonNow(polygonId: any): void;
             _addElementToScene(element: any): void;
@@ -2130,10 +2335,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
                 * @return {ThreeJSMarkerHandle} a unique identifier for the marker
                 */
             addThreeJSMarker(options: {
-                    object?: Object3D | undefined;
-                    position?: Vector3 | undefined;
+                    object?: any;
+                    position?: any;
                     rotation?: any;
-                    scale?: Vector3 | undefined;
+                    scale?: any;
             }): ThreeJSMarkerHandle;
             /**
                 * Remove the given `ThreeJSMarker` from this map.
@@ -2165,16 +2370,14 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.MapObject' {
             _popinChildObjects(): void;
     }
     import { PubSub } from "@mappedin/mappedin-js/renderer/internal/pub-sub";
-    import { Object3D } from "three/src/core/Object3D";
-    import { FrameTaskGroup } from "@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler";
-    import { Vector3 } from "three/src/math/Vector3";
+    import { FrameTaskGroup } from "@mappedin/mappedin-js/get-venue/Mappedin.TaskScheduler";
 }
 
 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 Analytics from '@mappedin/mappedin-js/get-venue/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';
@@ -2205,9 +2408,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
         */
@@ -2221,44 +2424,58 @@ declare module '@mappedin/mappedin-js/renderer' {
     export type { MapView } from '@mappedin/mappedin-js/renderer/MapView';
     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 type { TGetVenueOptions, TShowVenueOptions, TMappedinOfflineSearchOptions, TMappedinOfflineSearchResult, TMappedinOfflineSearchSuggestions, TMappedinOfflineAllSearchMatch, TMappedinOfflineSearchAllOptions } from '@mappedin/mappedin-js/get-venue';
+    export { Mappedin, MappedinDirections, MappedinLocation, MappedinPolygon, MappedinNode, MappedinCategory, MappedinMap, MappedinEvent, MappedinMapGroup, MappedinVenue, MappedinVortex, MappedinNavigatable, MappedinCoordinate, OfflineSearch, MAP_RENDER_MODE, setFetchFn } from '@mappedin/mappedin-js/get-venue';
+    export { BundleAssetManager } from '@mappedin/mappedin-js/renderer/bundle-asset-manager';
 }
 
 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;
+            useDraftData?: boolean;
+            platformString?: string;
     };
     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';
@@ -2273,8 +2490,9 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
     import { MappedinTheme } from '@mappedin/mappedin-js/get-venue/MappedinTheme';
     import { MappedinVenue } from '@mappedin/mappedin-js/get-venue/MappedinVenue';
     import { MappedinVortex } from '@mappedin/mappedin-js/get-venue/MappedinVortex';
+    import Analytics from '@mappedin/mappedin-js/get-venue/Mappedin.Analytics';
     export const defaultOptions: TGetVenueOptionsInternal & TGetVenueOptions;
-    export enum CollectionType {
+    export enum MappedinCollectionType {
             CATEGORY = "categories",
             EVENT = "events",
             LOCATION = "locations",
@@ -2285,14 +2503,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;
@@ -2488,6 +2706,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
@@ -2496,9 +2719,11 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin' {
                 */
             hydrate(mappedinSerializableData: string | object, shouldPopulateBundledImagesAsBlobs?: boolean): Promise<undefined>;
             images: any;
+            imageBinaries?: Map<string, Uint8Array>;
             scenes: any;
             fetch(): Promise<void>;
             constructor(options: TGetVenueOptionsInternal & TGetVenueOptions);
+            analytics: Analytics;
             /**
                 * @hidden
                 */
@@ -2622,6 +2847,60 @@ 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;
+                    };
+                    _isAbsolutelyPositioned?: boolean;
+            };
+            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.
                 *
@@ -2808,6 +3087,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.
         *
@@ -2834,6 +3114,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;
@@ -2848,6 +3133,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.
                 *
@@ -2885,28 +3175,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;
     }
@@ -2979,9 +3297,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;
     }
 }
@@ -3140,6 +3459,229 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinNavigatable' {
     }
 }
 
+declare module '@mappedin/mappedin-js/get-venue/Mappedin.OfflineSearch' {
+    import { Mappedin } from '@mappedin/mappedin-js/get-venue/Mappedin';
+    import type { SearchOptions } from 'minisearch';
+    import { MappedinLocation } from '@mappedin/mappedin-js/get-venue/MappedinLocation';
+    import { MappedinCategory } from '@mappedin/mappedin-js/get-venue/MappedinCategory';
+    export const removeAccents: (it: string) => string;
+    export type { SearchOptions };
+    /**
+        * A {@link Mappedin.OfflineSearch} is an offline search module
+        *
+        *
+        * @class Mappedin.OfflineSearch
+        */
+    export type TMappedinOfflineSearchAllOptions = {
+            /**
+                * Array of stopwords to ignore when searching, default: english stopwords
+                */
+            stopWords?: string[];
+            /**
+                * Index location tags - typically better to use either tags or descriptions, depending on what's available
+                * @default true
+                */
+            searchTags?: boolean;
+            /**
+                * Index location descriptions - typically better to use either tags or descriptions, depending on what's available
+                * @default true
+                */
+            searchDescriptions?: boolean;
+            /**
+                * Also index all tags for every location in every category (caution: this may slow down indexing and search)
+                * @default false
+                */
+            searchTagsInCategories?: boolean;
+            /**
+                * Also index all tags for every location in every category (caution: this may slow down indexing and search)
+                * @default false
+                */
+            searchDescriptionsInCategories?: boolean;
+            /**
+                * Initialize Search with a previously indexed JSON string (outputted by OfflineSearch.toJSON())
+                */
+            jsonIndex?: string;
+            /**
+                * Use the location polygons' rank in weighing results
+                */
+            useLocationRank?: boolean;
+            /**
+                * Emit Analytics events when doing search
+                * @default true when running in production
+                */
+            emitAnalyticsEvents?: boolean;
+            /**
+                * Fine tune search constants
+                */
+            constants: {
+                    /**
+                        * Fuzziness index for location names and tags
+                        * @default 0.09
+                        */
+                    PRIMARY_INDEX_FUZZYNESS: number;
+                    /**
+                        * Multiplier for location names (1 by default)
+                        * @default 1
+                        */
+                    PRIMARY_INDEX_WEIGHT: number;
+                    /**
+                        * Multiplier for descriptions
+                        * @default 0.025
+                        */
+                    SECONDARY_INDEX_WEIGHT: number;
+                    /**
+                        * Multiplier for location names
+                        * @default 1
+                        */
+                    LOCATION_NAME_WEIGHT: number;
+                    /**
+                        * Multiplier for category names
+                        * @default 0.5
+                        */
+                    CATEGORY_NAME_WEIGHT: number;
+                    /**
+                        * Multiplier for category locations' descriptions
+                        * @default 0.0005
+                        */
+                    CATEGORY_LOCATION_DESCRIPTION_WEIGHT: number;
+                    /**
+                        * Multiplier for category locations' tags
+                        * @default 0.0005
+                        */
+                    CATEGORY_LOCATION_TAGS_WEIGHT: number;
+                    /**
+                        * Multiplier for category locations' names
+                        * @default 0.01
+                        */
+                    CATEGORY_LOCATION_NAME_WEIGHT: number;
+                    /**
+                        * Multiplier for location tags
+                        * @default 0.05
+                        */
+                    PRIMARY_INDEX_TAGS_NAME_WEIGHT: number;
+                    /**
+                        * Default rank when one isn't available in the data, default = 1
+                        * @default 1
+                        */
+                    LOCATION_DEFAULT_RANK: number;
+                    /**
+                        * Ratio of Fuzzy Searches of Location names and tags relative to exact
+                        * @default 0.01
+                        */
+                    RATIO_OF_FUZZY_TO_EXACT: number;
+                    /**
+                        * Ratio of Prefix Searches of Location names and tags relative to exact
+                        * @default 0.2
+                        */
+                    RATIO_OF_PREFIX_TO_EXACT: number;
+            };
+    };
+    export type TMappedinOfflineAllSearchMatch = {
+            /**
+                * The term that was found
+                */
+            term: string;
+            /**
+                * Term's weight
+                */
+            weight: number;
+            /**
+                * What field the search matched on
+                */
+            matchesOn: string;
+            /**
+                * The value of that field
+                */
+            value?: string;
+    };
+    export type TMappedinOfflineSearchOptions = Partial<TMappedinOfflineSearchAllOptions>;
+    export type TMappedinOfflineSearchResult = {
+            /**
+                * Type describing the object
+                */
+            type: 'MappedinLocation' | 'MappedinCategory' | 'Custom';
+            /**
+                * Details on why the result was returned
+                */
+            matches: TMappedinOfflineAllSearchMatch[];
+            /**
+                * Found object
+                */
+            object: MappedinLocation | MappedinCategory | Record<string, unknown>;
+            /**
+                * Total score of the result
+                */
+            score: number;
+    };
+    export type TMappedinOfflineSearchSuggestions = {
+            /**
+                * Total number of suggestions generated
+                */
+            total: number;
+            /**
+                * List of suggestions
+                */
+            hits: {
+                    /**
+                        * Suggestion text
+                        */
+                    text: string;
+            }[];
+    };
+    /**
+        * A {@link OfflineSearch} is an offline search module. It can be initialized at any time by passing the {@link Mappedin} object and a set of {@link TMappedinOfflineSearchOptions} options.
+        *
+        *
+        * @class Mappedin.OfflineSearch
+        */
+    export class OfflineSearch {
+            #private;
+            constructor(
+            /**
+                * Mappedin Venue Object, typically returned by `getVenue`/`showVenue`
+                */
+            mappedin: Mappedin, options?: TMappedinOfflineSearchOptions);
+            /**
+                * Get Suggestions for term
+                */
+            suggest(
+            /**
+                * Search term
+                */
+            term: string): Promise<TMappedinOfflineSearchSuggestions>;
+            /**
+                * Search for a term
+                */
+            search(
+            /**
+                * Search term
+                */
+            term: string): Promise<TMappedinOfflineSearchResult[]>;
+            /**
+                * Export search index to JSON for storage/caching - this would avoid having to re-index
+                * on page reload
+                */
+            toJSON(): Promise<string>;
+            /**
+                * Add a custom query to the search index
+                */
+            addQuery(params: {
+                    /**
+                        * Query string to match for this object
+                        */
+                    query: string;
+                    /**
+                        * Object that is returned when query matches
+                        */
+                    object: MappedinLocation | MappedinCategory | Record<string, unknown>;
+                    /**
+                        * Optional weight to multiply by the score
+                        */
+                    weight?: number;
+            }): Promise<void>;
+    }
+}
+
 declare module '@mappedin/mappedin-js/get-venue/Mappedin.API.types' {
     /**
       * This file contains the API types for MappedinSDK - before they get turned into Classes
@@ -3255,9 +3797,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;
@@ -3310,27 +3849,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[];
@@ -3342,6 +3886,8 @@ declare module '@mappedin/mappedin-js/get-venue/Mappedin.API.types' {
         themes: any;
         venue: TVenue;
         vortexes: TVortex[];
+        locationStates?: TLocationState[];
+        imageBinaries?: Map<string, Uint8Array>;
     };
 }
 
@@ -3431,7 +3977,6 @@ declare module '@mappedin/mappedin-js/renderer/internal/pub-sub' {
 
 declare module '@mappedin/mappedin-js/renderer/Core.interface' {
     import { MappedinMap, Mappedin, MappedinCoordinate, MappedinPolygon, MappedinNode } from '@mappedin/mappedin-js/get-venue';
-    import CameraControls from '@mappedin/mappedin-js/renderer/internal/Mappedin.CameraControls';
     import { Vector2, Vector3 } from 'three';
     import { changeListenerFn, TMapViewOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     import RENDER from '@mappedin/mappedin-js/renderer/internal/Mappedin.RenderTasks';
@@ -3448,7 +3993,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;
@@ -3487,6 +4032,7 @@ declare module '@mappedin/mappedin-js/renderer/Core.interface' {
                 * @internal
                 */
             currentScale: number;
+            loadOptions?: TMapViewOptions['loadOptions'];
             imageFlippingEnabled: boolean;
             imageFlippingCache: any;
             cachedPadding: any;
@@ -3506,7 +4052,7 @@ declare module '@mappedin/mappedin-js/renderer/Core.interface' {
                 * Some of the functions don't do anything in 2D.
                 *
                 */
-            controls?: typeof CameraControls;
+            controls: any;
             /**
                 * The Venue data this MapView is using.
                 *
@@ -3599,7 +4145,20 @@ declare module '@mappedin/mappedin-js/renderer/Core.interface' {
             onMapChanged(map: string): void;
             getPositionLatLon(lat: number, lon: number, map?: MappedinMap | string): Vector3;
             getPositionPolygon(polygon: MappedinPolygon | string): Vector3;
+            /**
+                * Takes an x/y pair in Mappedin coordinate space and gives you a Vector3 in scene space
+                * @param nodeOrCoordinate a node or coordinate
+                */
             convertTo3DMapPosition(nodeOrCoordinate: MappedinCoordinate | MappedinNode): Vector3;
+            /**
+                * Converts a Vector-like object into a MappedinCoordinate for a map.
+                * @param position an object with x and y, like a Vector3
+                * @param mapClass An optional map; otherwise, the current map will be used.
+                */
+            convert3DMapPositionToCoordinate(position: {
+                    x: number;
+                    y: number;
+            }, mapClass?: MappedinMap): MappedinCoordinate;
             setPadding(padding: {
                     top: number;
                     left: number;
@@ -3760,8 +4319,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;
@@ -3775,8 +4336,8 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.LabelAtlas' {
         polygonMeshesById: any;
         polyId: any;
         map: any;
-        color: Color;
-        baseColor: Color;
+        color: any;
+        baseColor: any;
         hideOnCreate: boolean;
         hoverLabelText: any;
         fontSize: number;
@@ -3807,7 +4368,6 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.LabelAtlas' {
         index: any;
         layout(map: any, origin: any, size: any, rotation: any, uv: any, color: any): void;
     }
-    import { Color } from "three/src/math/Color";
     export {};
 }
 
@@ -3846,6 +4406,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 = {
@@ -3859,6 +4420,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.SmartCollider'
         getBoundingBox: (TColliderStrategyProps: any) => TRange;
         onStrategySelected: (collider: TCustomCollider<any>) => void;
     };
+    export type TGetBoundingBox = ({ x, y }: {
+        x: any;
+        y: any;
+    }) => [number, number, number, number];
     export type TDimensions = {
         width: number;
         height: number;
@@ -3871,13 +4436,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;
@@ -3901,15 +4472,16 @@ 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;
-        position: Vector3;
+        offscreen: boolean;
+        position: any;
         dimensions: {
             width: number;
             height: number;
@@ -4101,11 +4673,11 @@ declare module '@mappedin/mappedin-js/renderer/internal/shave-text' {
 }
 
 declare module '@mappedin/mappedin-js/renderer/layers/EventSystem' {
-    import { Object3D, Raycaster } from 'three';
+    import { Object3D } from 'three';
     import { MapView } from '@mappedin/mappedin-js/renderer';
     import { ICore } from '@mappedin/mappedin-js/renderer/Core.interface';
     import BlueDotManager from '@mappedin/mappedin-js/renderer/internal/blue-dot-manager';
-    export const raycaster: Raycaster;
+    export const raycaster: any;
     class EventSystemLayer {
         mapView: MapView;
         core: ICore;
@@ -4148,7 +4720,7 @@ declare module '@mappedin/mappedin-js/renderer/layers/EventSystem' {
         };
         hasTouched: boolean;
         calculateMouseCoordinates: (event: any) => void;
-        getMouseRayIntersects: (objects: Object3D | Object3D[]) => import("three").Intersection[];
+        getMouseRayIntersects: (objects: Object3D | Object3D[]) => any;
         detectPolygonsUnderMouse: () => any[];
         getMouseMapPosition: () => {
             x: number;
@@ -4196,24 +4768,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Journey' {
     }
 }
 
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler' {
-    export namespace UPDATE_ORDERING {
-            const BEFORE_CAMERA: number;
-            const CAMERA: number;
-            const AFTER_CAMERA: number;
-            const RENDER: number;
-            const AFTER_RENDER: number;
-            const AFTER_ALL_UPDATES: number;
-    }
-    export namespace TASK_PRIORITY {
-            const VISIBLE_MAP_HIGH: number;
-            const VISIBLE_MAP_LOW: number;
-            const VISIBLE_MAP_MARKER: number;
-            const ASYNC_MAP_HIGH: number;
-            const ASYNC_MAP_LOW: number;
-            const ASYNC_MAP_MARKER: number;
-            const MAP_LOADED: number;
-    }
+declare module '@mappedin/mappedin-js/get-venue/Mappedin.TaskScheduler' {
     /**
         * A function that can be submitted to the Task Scheduler to run each frame for
         * some provided number of frames. A single update can be repeatedly submitted;
@@ -4247,22 +4802,22 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 *	@param [options.userdata] {Any}
                 *		Arbitrary data that you can store along with this update.
                 */
-            constructor(options?: {
-                    callback?: Function | undefined;
-                    frameCount?: number | undefined;
-                    ordering?: number | undefined;
-                    supersededBy?: [FrameUpdate] | undefined;
-                    name?: string | undefined;
-                    userdata?: any;
-            } | undefined);
-            _callback: Function | undefined;
+            constructor(options: {
+                    callback: Function;
+                    frameCount?: number;
+                    ordering?: number;
+                    supersededBy?: Set<never>;
+                    name: string;
+                    userdata?: Record<string, any>;
+            });
+            _callback: Function;
             _frameCount: number;
             _ordering: number;
-            _supersededBy: Set<any>;
-            name: string | undefined;
-            userdata: any;
+            _supersededBy: Set<never>;
+            name: string;
             _remainingFrameCount: number;
             _lastFrameTime: number;
+            userdata?: Record<string, any>;
             /**
                 * Return the amount of time that this frame update took to execute during
                 * its most recent execution, in milliseconds. If called during this frame
@@ -4302,24 +4857,25 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 *	@param [options.userdata] {Any}
                 *		Arbitrary data that you can store along with this task.
                 */
-            constructor(options?: {
-                    callback?: Function | undefined;
-                    group?: FrameTaskGroup | undefined;
-                    priority?: number | undefined;
-                    postponeOnAdd?: number | undefined;
-                    name?: string | undefined;
-                    userdata?: any;
-            } | undefined);
-            _callback: Function | undefined;
-            _group: FrameTaskGroup | null;
-            _priority: number;
+            constructor(options: {
+                    userdata: Record<string, any>;
+                    priority: number;
+                    group?: FrameTaskGroup;
+                    postponeOnAdd: number | boolean;
+                    name: string;
+                    lastFrameTime: number;
+                    callback: Function;
+            });
             _postponed: number | boolean;
-            name: string | undefined;
-            userdata: any;
+            userdata: Record<string, any>;
+            _priority: number;
+            _group: FrameTaskGroup | null;
+            name: string;
+            _lastFrameTime: number;
+            _callback: Function;
             _complete: boolean;
             _scheduled: boolean;
             _cancelled: boolean;
-            _lastFrameTime: number;
             /**
                 * Return true if this task has been run at least once.
                 *
@@ -4366,18 +4922,18 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 *	@param [options.userdata] {Any}
                 *		Arbitrary data that you can store along with this task group.
                 */
-            constructor(options?: {
-                    onComplete?: Function | undefined;
-                    priority?: number | undefined;
-                    postponeOnAdd?: number | undefined;
-                    name?: string | undefined;
-                    userdata?: any;
-            } | undefined);
+            constructor(options: {
+                    onComplete?: Function;
+                    priority?: number;
+                    userdata: Record<string, any>;
+                    postponeOnAdd: number | boolean;
+                    name: string;
+            });
+            _postponed: number | boolean;
             _onComplete: Function;
             _priority: number;
-            _postponed: number | boolean;
-            name: string | undefined;
-            userdata: any;
+            userdata: Record<string, any>;
+            name: string;
             _tasks: Set<any>;
             _scheduledTasks: Set<any>;
             _scheduled: boolean;
@@ -4396,13 +4952,22 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method tasks
                 * @return {[FrameTask]} list of tasks in this group
                 */
-            getTasks(): [FrameTask];
+            getTasks(): any[];
             /**
                 * Empty this task group. This will trivially satisfy `isComplete`.
                 *
                 * @method clear
                 */
             clear(): void;
+            /**
+                * Return one arbitrary incomplete task from this group, or undefined if
+                * there are none.
+                *
+                * @method _popTask
+                * @return {FrameTask} arbitrary scheduled task
+                * @private
+                */
+            _popTask(): any;
     }
     /**
         * A timer for the task scheduler that uses real wall-time to determine if there's
@@ -4412,6 +4977,8 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
         * @private
         */
     export class RealTimeTimer {
+            _maxMillisecondsPerFrame: number;
+            _time: number;
             /**
                 * @constructor
                 * @param [options] {Object} Options for the timer
@@ -4420,10 +4987,8 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 *     or equal to this value, then another task may be executed
                 */
             constructor(options?: {
-                    maxMillisecondsPerFrame?: any;
-            } | undefined);
-            _maxMillisecondsPerFrame: any;
-            _time: any;
+                    maxMillisecondsPerFrame?: number;
+            });
             /**
                 * Begin timing a frame.
                 *
@@ -4445,6 +5010,8 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
         * @private
         */
     export class FixedTimer {
+            _ticks: number;
+            maxTasksPerFrame: number;
             /**
                 * @constructor
                 * @param [options] {Object} Options for the timer
@@ -4453,10 +5020,8 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 *     Can be modified as the `maxTasksPerFrame` property on this boject.
                 */
             constructor(options?: {
-                    maxTasksPerFrame?: any;
-            } | undefined);
-            maxTasksPerFrame: any;
-            _ticks: number;
+                    maxTasksPerFrame?: number;
+            });
             /**
                 * Begin timing a frame.
                 *
@@ -4500,11 +5065,11 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 *     performance information.
                 */
             constructor(options?: {
-                    timer?: any;
-                    performance?: any;
-            } | undefined);
-            _timer: any;
-            _performance: any;
+                    timer?: RealTimeTimer;
+                    performance?: boolean;
+            });
+            _timer: RealTimeTimer;
+            _performance: boolean;
             _scheduledUpdatesByOrdering: Multimap;
             _scheduledTasksByPriority: Multimap;
             _postponedTasks: Set<any>;
@@ -4512,18 +5077,6 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
             _updatesToRunThisFrame: any[];
             _lastFrameTime: number;
             _updatesRunLastFrame: Set<any>;
-            /**
-                * Run all scheduled updates, and re-schedule another animation frame if any
-                * scheduled updates still exist. If any scheduled update specifies
-                * `shouldRunTasksAfterCompletion`, this will also run queued tasks until the
-                * frame time runs out.
-                *
-                * @method update
-                * @param timestamp {number} the current animation time, as returned from
-                * `performance.now()`; will be automatically filled in by
-                * `requestAnimationFrame` when it triggers this as a callback
-                */
-            update(timestamp: number): void;
             /**
                 * Empty the task scheduler's queue. All tasks in it will be cancelled.
                 *
@@ -4543,6 +5096,18 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method requestAnimationFrame
                 */
             requestAnimationFrame(): void;
+            /**
+                * Run all scheduled updates, and re-schedule another animation frame if any
+                * scheduled updates still exist. If any scheduled update specifies
+                * `shouldRunTasksAfterCompletion`, this will also run queued tasks until the
+                * frame time runs out.
+                *
+                * @method update
+                * @param timestamp {number} the current animation time, as returned from
+                * `performance.now()`; will be automatically filled in by
+                * `requestAnimationFrame` when it triggers this as a callback
+                */
+            update(timestamp: number): void;
             /**
                 * Execute all tasks that are currently pending, without regard for the
                 * available frame time.
@@ -4567,7 +5132,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * has not yet been run or if the scheduler has been cleared.
                 */
             getUpdatesRunLastFrame(): Set<any>;
-            _executeOneTask(timestamp: any): void;
+            _executeOneTask(timestamp: number): void;
             /**
                 * Schedule an update to be run for the next `update.frameCount` frames. If
                 * the update already exists in the scheduler, the update's frame count will
@@ -4577,7 +5142,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method scheduleUpdate
                 * @param task {FrameUpdate} the update to schedule
                 */
-            scheduleUpdate(update: any): void;
+            scheduleUpdate(update: FrameUpdate): void;
             /**
                 * Schedule a task to be run during a frame update. This will also schedule
                 * an animation frame to begin processing the task queue.
@@ -4592,7 +5157,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method cancelUpdate
                 * @param task {FrameUpdate} the update to cancel
                 */
-            cancelUpdate(update: any): void;
+            cancelUpdate(update: FrameUpdate): void;
             /**
                 * If the given task or group is in the queue, remove it. Cancelling a
                 * completed task is a no-op.
@@ -4603,7 +5168,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method cancelTask
                 * @param task {FrameTask or FrameTaskGroup} the task to cancel
                 */
-            cancelTask(task: FrameTask): void;
+            cancelTask(task: FrameTask | FrameTaskGroup): void;
             /**
                 * Set the provided task or group not to run, until it's resumed using `resumeTask`.
                 *
@@ -4613,7 +5178,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method postponeTask
                 * @param task {FrameTask or FrameTaskGroup} the task to postpone
                 */
-            postponeTask(task: FrameTask): void;
+            postponeTask(task: FrameTask | FrameTaskGroup): void;
             /**
                 * Allow a postponed task or task group to resume processing. This will also
                 * request an animation frame to allow the resumed task to be processed.
@@ -4624,7 +5189,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method resumeTask
                 * @param task {FrameTask or FrameTaskGroup} the task to resume
                 */
-            resumeTask(task: FrameTask): void;
+            resumeTask(task: FrameTask | FrameTaskGroup): void;
             /**
                 * Change the priority of the given scheduled task or task group.
                 *
@@ -4632,7 +5197,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @param task {FrameTask or FrameTaskGroup} the task whose priority will be changed
                 * @param priority {number} the priority to assign the task
                 */
-            setTaskPriority(task: FrameTask, priority: number): void;
+            setTaskPriority(task: FrameTask | FrameTaskGroup, priority: number): void;
     }
     /**
         * A map that maps a numeric key to a set of values.
@@ -4643,6 +5208,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
         * @private
         */
     class Multimap {
+            /**
+                * @method constructor
+                */
+            constructor();
             _map: Map<any, any>;
             _size: number;
             _sortedKeys: any[];
@@ -4702,7 +5271,10 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method values
                 * @return {Iterator} iterator over the values in the map
                 */
-            values(): Iterator<any, any, undefined>;
+            values(): {
+                    [Symbol.iterator]: () => any;
+                    next: () => any;
+            };
             /**
                 * A list of keys in this set, sorted by numeric value. Not cloned,
                 * for efficiency's sake, so please don't mutate it.
@@ -4710,7 +5282,7 @@ declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.TaskScheduler'
                 * @method keys
                 * @return {[number]} sorted list of numeric keys in the map
                 */
-            keys(): [number];
+            keys(): any[];
             /**
                 * The number of elements in this multimap, equal to the sum of the sizes
                 * of each key's set of values.
@@ -4722,6 +5294,231 @@ 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, Position } 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 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 MIStyle = {
+            id: string;
+            /** The altitude of the bottom of the geometry, in metres. */
+            altitude: number;
+            color: string;
+            height: number;
+            image?: PolygonImage;
+            opacity: number;
+    };
+    export type MIImageInstance = {
+            /** The local path or URL of the image. */
+            path: string;
+            /** The position of the centre of the image, in [long, lat] form. */
+            position: Position;
+            /** The altitude of the image, in metres. */
+            altitude: number;
+            /** Euler angles representing the rotation of the image, in degrees. Angles are in XYZ order. */
+            rotation: {
+                    x: number;
+                    y: number;
+                    z: number;
+            };
+            /** The size of the image, in metres. */
+            size: {
+                    x: number;
+                    y: number;
+            };
+            /** The portion of the image to display. */
+            viewBox: {
+                    top: number;
+                    left: number;
+                    width: number;
+                    height: number;
+            };
+            /**
+                * A space or obstruction to associate this image with. If provided,
+                * changes to the polygon's visibility will affect this image.
+                * */
+            polygonId?: string;
+    };
+    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 WithIDs<T> = Map<string, T>;
+    export type MIStyleCollection = MIStyle[];
+    /**
+        * A mapping of polygon IDs to style IDs;
+        */
+    export type MIPolygonStyle = {
+            [key in string]: string;
+    };
+    export type MIImageInstanceCollection = MIImageInstance[];
+    /**
+        * The entire data collection for an MVF, in a single JSON collection.
+        *
+        */
+    export type MVFDataJSON = {
+            connection: WithIDs<MIGeoJSONConnectionCollection>;
+            level: WithIDs<MIGeoJSONLevelCollection>;
+            node: WithIDs<MIGeoJSONNodeCollection>;
+            obstruction: WithIDs<MIGeoJSONObstructionCollection>;
+            space: WithIDs<MIGeoJSONSpaceCollection>;
+            building: MIGeoJSONBuildingCollection;
+            category: MIGeoJSONCategoryCollection;
+            style: MIStyleCollection;
+            polygonStyle: WithIDs<MIPolygonStyle>;
+            imageInstance: WithIDs<MIImageInstanceCollection>;
+            location: MIGeoJSONLocationCollection;
+            manifest: MIGeoJSONManifestCollection;
+    };
+    export type MVFData = MVFDataJSON & {
+            imageBinaries: WithIDs<Uint8Array>;
+    };
+    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';
@@ -4771,23 +5568,6 @@ declare module '@mappedin/mappedin-js/get-venue/MappedinTheme' {
     }
 }
 
-declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.CameraControls' {
-    export default CameraControls;
-    /**
-      * The advanced, manual camera controls for {{#crossLink "MapView"}}{{/crossLink}}. You probably don't need to use this at all, instead relying on the MapView's {{#crossLink "MapView/focusOn:method"}}{{/crossLink}}, {{#crossLink "MapView/resetCamera:method"}}{{/crossLink}} and built in touch/mouse controls.
-      * This class will let you do things like change the min/max zoom, tilt, and pan, attach to camera events, and move/animate the camera to specifc points.
-      *
-      * The camera works by setting an anchor point on the scene at ground level and pointing the camera at it. {{#crossLink "CameraControls/zoom:method"}}{{/crossLink}} controls how far the camera is from the anchor, and {{#crossLink "CameraControls/tilt:method"}}{{/crossLink}}/{{#crossLink "CameraControls/rotate:method"}}{{/crossLink}} controls the angle the camera is rotated about it.
-      * The camera will always be pointed directly at the anchor point. {{#crossLink "CameraControls/pan:method"}}{{/crossLink}} or {{#crossLink "CameraControls/setPosition:method"}}{{/crossLink}} will move that anchor around on the 2D ground plane.
-      *
-      * Created for you automatically with a MapView, don't re-create yourself.
-      * @type {any}
-      *
-      * @class CameraControls
-      */
-    let CameraControls: any;
-}
-
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.RenderTasks' {
     export default RENDER;
     namespace RENDER {
@@ -4803,56 +5583,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: any;
+            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';