@mappedin/mappedin-js 5.34.2 → 5.34.3

package/lib/esm/renderer/chunk-SAYKHSRQ.js

@@ -0,0 +1 @@
+import{b as a}from"./chunk-ZRT45YCM.js";var e,c=a((()=>{e={env:{NODE_ENV:"production",npm_package_version:"5.34.3"}}}));export{c as a,e as b};

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

@@ -2357,6 +2357,23 @@ declare module '@mappedin/mappedin-js/renderer/MapView.types' {
     export type { TOutdoorViewOptions, TOutdoorViewOptionsWithHeaders, TOutdoorViewOptionsWithAuthURL };
     export type { default as BlueDotController } from '@mappedin/mappedin-js/renderer/private/controllers/BlueDotController';
     export type { default as Journey } from '@mappedin/mappedin-js/renderer/public/api/Journey';
+    export type TStackedMapsOptions = {
+            /**
+                * The vertical distance between maps in overview, in metres.
+                * @default 50
+                */
+            verticalDistanceBetweenMaps?: number;
+            /**
+                * Whether to show map level labels in overview.
+                * @default true
+                */
+            mapLabels?: boolean;
+            /**
+                * Whether to show only Journey maps in the stack if a Journey is active and the current map is part of the Journey.
+                * @default true
+                */
+            prioritizeJourneyMaps?: boolean;
+    };
 }
 
 declare module '@mappedin/mappedin-js/common/Mappedin.Logger' {
@@ -3420,8 +3437,8 @@ declare module '@mappedin/mappedin-js/renderer/public/api/Paths' {
 
 declare module '@mappedin/mappedin-js/renderer/public/api/StackedMaps' {
     import { MappedinMap } from '@mappedin/mappedin-js/get-venue';
+    import { TStackedMapsOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
     import { STACKED_MAPS_STATE, StackedMapsController, TCameraTransform } from '@mappedin/mappedin-js/renderer/internal';
-    import { TStackedMapsOptions } from '@mappedin/mappedin-js/renderer/private/controllers/StackedMapsController';
     /**
         * @experimental
         * API for showing multiple maps involved in a {@link Journey} as a vertical stack.
@@ -3434,7 +3451,8 @@ declare module '@mappedin/mappedin-js/renderer/public/api/StackedMaps' {
             constructor(markersController: StackedMapsController);
             /**
                 * @experimental
-                * Enable Stacked Maps. A {@link Journey} must be drawn beforehand or this method will fail.
+                * Enable Stacked Maps. If a {@link Journey} is drawn beforehand the default behaviour is to only display the floors that are part of the journey.
+                * {@link TStackedMapsOptions} can be used to enabling display of all maps including those that are not part of the journey.
                 * Use {@link showOverview} to expand the maps vertically after enabling.
                 *
                 * Upon enabling, map state will become {@link STATE.STACKED | STACKED} and Stacked Maps state will become {@link STACKED_MAPS_STATE.ACTIVE | ACTIVE}.
@@ -3472,7 +3490,7 @@ declare module '@mappedin/mappedin-js/renderer/public/api/StackedMaps' {
             /**
                 * @experimental
                 *
-                * Expand the maps in the current {@link Journey} vertically and add vertical paths between connections.
+                * Expand and display all maps in the current {@link MapGroup}. If a {@link Journey} has been drawn, vertical paths between connections are displayed.
                 * Stacked Maps must be enabled beforehand and state will become {@link STACKED_MAPS_STATE.OVERVIEW | OVERVIEW}.
                 *
                 * @example
@@ -3527,7 +3545,8 @@ declare module '@mappedin/mappedin-js/renderer/public/api/StackedMaps' {
                 * @experimental
                 *
                 * Used when in {@link STACKED_MAPS_STATE.OVERVIEW | OVERVIEW} state to replace the maps in the
-                * current stack if there is a new Journey or Journey is cleared.
+                * current stack after clearing or creating a {@link Journey}.
+                * Use this to hide maps that are not part of the journey or to display all maps in the {@link MapGroup}.
                 *
                 * @param options - Options to adjust the overview. Each option defaults to the setting passed in {@link enable}, unless provided.
                 *
@@ -6642,150 +6661,6 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/FlatLabelsCon
     export default FlatLabelsController;
 }
 
-declare module '@mappedin/mappedin-js/renderer/private/controllers/StackedMapsController' {
-    import { MappedinDirections, MappedinMap, MappedinNode } from '@mappedin/mappedin-js/get-venue';
-    import { STACKED_MAPS_STATE, MapViewScene, MapViewStackScene, CAMERA_EASING_MODE } from '@mappedin/mappedin-js/renderer/internal';
-    import type { ICore, TCameraTransform } from '@mappedin/mappedin-js/renderer/internal';
-    enum ACTION {
-            enable = "enable",
-            disable = "disable",
-            showOverview = "showOverview",
-            zoomInToMap = "zoomInToMap",
-            scrollToMap = "scrollToMap",
-            restack = "restack"
-    }
-    type TTargetTransitionFunction = ((options: TParams) => () => Promise<void>) | ((options: TParams) => void);
-    type TParams = {
-            map: MappedinMap;
-    } | {
-            directions: MappedinDirections | MappedinDirections[];
-    } | {
-            stackScene: MapViewStackScene;
-            directions: MappedinDirections | MappedinDirections[];
-            verticalDistanceBetweenMaps?: number;
-    } | {
-            stackScene: MapViewStackScene;
-            verticalDistanceBetweenMaps?: number;
-            map: MappedinMap;
-            nodes: MappedinNode[];
-    } | {
-            stackScene: MapViewStackScene;
-            map: MappedinMap;
-            nodes: MappedinNode[];
-            rotation: number;
-            cameraTransform?: TCameraTransform;
-            verticalDistanceBetweenMaps?: number;
-    };
-    type TActionFn = [STACKED_MAPS_STATE, TTargetTransitionFunction[]];
-    type TState = {
-            [stateName in STACKED_MAPS_STATE]?: {
-                    actions: {
-                            [actionName in ACTION]?: TActionFn;
-                    };
-            };
-    };
-    export type TInternalTransitionOptions = {
-            animate?: boolean;
-    };
-    export type TStackedMapsOptions = {
-            /**
-                * The vertical distance between maps in overview, in metres.
-                * @default 50
-                */
-            verticalDistanceBetweenMaps?: number;
-            /**
-                * Whether to show map level labels in overview.
-                * @default true
-                */
-            mapLabels?: boolean;
-            /**
-                * Whether to show only Journey maps in the stack if a Journey is active and the current map is part of the Journey.
-                * @default true
-                */
-            prioritizeJourneyMaps?: boolean;
-    };
-    class StackedMapsController {
-            #private;
-            options: TStackedMapsOptions;
-            enabled: boolean;
-            stackScene: MapViewStackScene;
-            constructor(core: ICore);
-            needsUpdate: boolean;
-            currentState: STACKED_MAPS_STATE;
-            mapsInStack: MappedinMap[];
-            getZoomIntoMapOptions: (params: TParams) => (MapViewScene | {
-                    activeMap: MappedinMap;
-                    focusOn: {
-                            targets: {
-                                    nodes: MappedinNode[];
-                            };
-                            options: {
-                                    zoom?: number | undefined;
-                                    tilt: number;
-                                    rotation: number;
-                                    position?: MappedinNode | import("../../internal").MappedinCoordinate | undefined;
-                                    easing: CAMERA_EASING_MODE;
-                            };
-                    };
-            })[] | undefined;
-            getDisableOptions: (params: TParams) => (MapViewScene | {
-                    activeMap: MappedinMap;
-            })[] | undefined;
-            getShowOverviewOptions: (params: TParams) => (MapViewStackScene | {
-                    activeMap: MappedinMap;
-                    focusOn: {
-                            options: {
-                                    tilt: number;
-                                    duration: number;
-                            };
-                    };
-                    verticalDistanceBetweenMaps: number | undefined;
-            })[] | undefined;
-            getScrollToMapOptions: (params: TParams) => (MapViewStackScene | {
-                    focusOn: {
-                            targets: {
-                                    nodes: MappedinNode[];
-                            };
-                            options: {
-                                    tilt: number;
-                                    easing: CAMERA_EASING_MODE;
-                            };
-                    };
-                    activeMap: MappedinMap;
-            })[] | undefined;
-            getRestackOptions: (params: TParams) => (MapViewStackScene | {
-                    activeMap: MappedinMap;
-                    focusOn: {
-                            options: {
-                                    tilt: number;
-                                    duration: number;
-                            };
-                    };
-                    verticalDistanceBetweenMaps: number | undefined;
-            })[] | undefined;
-            getEnableOptions: () => void;
-            getShowOverviewTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
-            getZoomInToMapTransition: (options: any) => () => Promise<void>;
-            getScrollToMapTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
-            getRestackTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
-            getDisableTransition: (options: any) => () => Promise<void>;
-            getEnableTransition: () => () => void;
-            states: TState;
-            get determineMapStack(): MappedinMap[];
-            transition(currentState: STACKED_MAPS_STATE, actionName: ACTION): TTargetTransitionFunction[] | void;
-            exec(transitions: TTargetTransitionFunction[] | void, params: TParams): Promise<void>;
-            disable: () => Promise<void>;
-            enable: (opts?: TStackedMapsOptions) => Promise<void>;
-            get nodesInJourneyOrMap(): any[];
-            showOverview: () => Promise<void>;
-            scrollToMap: (map: MappedinMap) => Promise<void>;
-            restack: (options?: TStackedMapsOptions) => Promise<void>;
-            zoomInToMap: (map: MappedinMap, cameraTransform?: TCameraTransform) => Promise<void>;
-            get currentMap(): MappedinMap;
-    }
-    export default StackedMapsController;
-}
-
 declare module '@mappedin/mappedin-js/renderer/internal/outdoor-context/Mappedin.Tile' {
     import { Texture, Mesh, MeshBasicMaterial } from 'three';
     import type { ICore } from '@mappedin/mappedin-js/renderer/internal';
@@ -8992,6 +8867,134 @@ declare module '@mappedin/mappedin-js/renderer/private/controllers/BillboardMana
     export default BillboardManager;
 }
 
+declare module '@mappedin/mappedin-js/renderer/private/controllers/StackedMapsController' {
+    import { MappedinDirections, MappedinMap, MappedinNode } from '@mappedin/mappedin-js/get-venue';
+    import { STACKED_MAPS_STATE, MapViewScene, MapViewStackScene, CAMERA_EASING_MODE } from '@mappedin/mappedin-js/renderer/internal';
+    import type { ICore, TCameraTransform } from '@mappedin/mappedin-js/renderer/internal';
+    import { TStackedMapsOptions } from '@mappedin/mappedin-js/renderer/MapView.types';
+    enum ACTION {
+        enable = "enable",
+        disable = "disable",
+        showOverview = "showOverview",
+        zoomInToMap = "zoomInToMap",
+        scrollToMap = "scrollToMap",
+        restack = "restack"
+    }
+    type TTargetTransitionFunction = ((options: TParams) => () => Promise<void>) | ((options: TParams) => void);
+    type TParams = {
+        map: MappedinMap;
+    } | {
+        directions: MappedinDirections | MappedinDirections[];
+    } | {
+        stackScene: MapViewStackScene;
+        directions: MappedinDirections | MappedinDirections[];
+        verticalDistanceBetweenMaps?: number;
+    } | {
+        stackScene: MapViewStackScene;
+        verticalDistanceBetweenMaps?: number;
+        map: MappedinMap;
+        nodes: MappedinNode[];
+    } | {
+        stackScene: MapViewStackScene;
+        map: MappedinMap;
+        nodes: MappedinNode[];
+        rotation: number;
+        cameraTransform?: TCameraTransform;
+        verticalDistanceBetweenMaps?: number;
+    };
+    type TActionFn = [STACKED_MAPS_STATE, TTargetTransitionFunction[]];
+    type TState = {
+        [stateName in STACKED_MAPS_STATE]?: {
+            actions: {
+                [actionName in ACTION]?: TActionFn;
+            };
+        };
+    };
+    export type TInternalTransitionOptions = {
+        animate?: boolean;
+    };
+    class StackedMapsController {
+        #private;
+        options: TStackedMapsOptions;
+        enabled: boolean;
+        stackScene: MapViewStackScene;
+        constructor(core: ICore);
+        needsUpdate: boolean;
+        currentState: STACKED_MAPS_STATE;
+        mapsInStack: MappedinMap[];
+        getZoomIntoMapOptions: (params: TParams) => (MapViewScene | {
+            activeMap: MappedinMap;
+            focusOn: {
+                targets: {
+                    nodes: MappedinNode[];
+                };
+                options: {
+                    zoom?: number | undefined;
+                    tilt: number;
+                    rotation: number;
+                    position?: MappedinNode | import("../../internal").MappedinCoordinate | undefined;
+                    easing: CAMERA_EASING_MODE;
+                };
+            };
+        })[] | undefined;
+        getDisableOptions: (params: TParams) => (MapViewScene | {
+            activeMap: MappedinMap;
+        })[] | undefined;
+        getShowOverviewOptions: (params: TParams) => (MapViewStackScene | {
+            activeMap: MappedinMap;
+            focusOn: {
+                options: {
+                    tilt: number;
+                    duration: number;
+                };
+            };
+            verticalDistanceBetweenMaps: number | undefined;
+        })[] | undefined;
+        getScrollToMapOptions: (params: TParams) => (MapViewStackScene | {
+            focusOn: {
+                targets: {
+                    nodes: MappedinNode[];
+                };
+                options: {
+                    tilt: number;
+                    easing: CAMERA_EASING_MODE;
+                };
+            };
+            activeMap: MappedinMap;
+        })[] | undefined;
+        getRestackOptions: (params: TParams) => (MapViewStackScene | {
+            activeMap: MappedinMap;
+            focusOn: {
+                options: {
+                    tilt: number;
+                    duration: number;
+                };
+            };
+            verticalDistanceBetweenMaps: number | undefined;
+        })[] | undefined;
+        getEnableOptions: () => void;
+        getShowOverviewTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
+        getZoomInToMapTransition: (options: any) => () => Promise<void>;
+        getScrollToMapTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
+        getRestackTransition: (options: any, inTransit?: boolean) => () => Promise<void>;
+        getDisableTransition: (options: any) => () => Promise<void>;
+        getEnableTransition: () => () => void;
+        states: TState;
+        get determineMapStack(): MappedinMap[];
+        transition(currentState: STACKED_MAPS_STATE, actionName: ACTION): TTargetTransitionFunction[] | void;
+        exec(transitions: TTargetTransitionFunction[] | void, params: TParams): Promise<void>;
+        disable: () => Promise<void>;
+        enable: (opts?: TStackedMapsOptions) => Promise<void>;
+        get nodesInJourneyOrMap(): any[];
+        showOverview: () => Promise<void>;
+        scrollToMap: (map: MappedinMap) => Promise<void>;
+        restack: (options?: TStackedMapsOptions) => Promise<void>;
+        zoomInToMap: (map: MappedinMap, cameraTransform?: TCameraTransform) => Promise<void>;
+        get currentMap(): MappedinMap;
+    }
+    export default StackedMapsController;
+}
+
 declare module '@mappedin/mappedin-js/renderer/internal/Mappedin.Renderer' {
     /**
         * A class that controls the rendering resources for a canvas output.