@mappedin/mappedin-js 6.0.1-beta.13 → 6.0.1-beta.14

package/lib/esm/index.d.ts

@@ -11,8 +11,8 @@
 //   ../mappedin-js/@packages/internal/geojson-navigator
 //   ../mappedin-js/@tweenjs/tween.js
 //   ../mappedin-js/@mappedin/mvf/dist/locale
-//   ../mappedin-js/zod
 //   ../mappedin-js/three
+//   ../mappedin-js/zod
 //   ../mappedin-js/@packages/internal/shave-text/shave-text
 //   ../mappedin-js/@turf/turf
 //   ../mappedin-js/@packages/internal/quad-tree
@@ -356,7 +356,7 @@ declare module '@mappedin/mappedin-js' {
     export { parseMVF, unzipMVF, enableTestMode };
     export type { MapView, MapData, MappedinMapLibreOverlay, TEvents, TEventPayload, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, };
     export type * from 'geojson';
-    export type { TUpdateState, TLabelState, TGeometryState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    export type { TUpdateState, TLabelState, TGeometryState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, TBlueDotPositionUpdate, } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export { WALLS, DOORS } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export type { Label, Marker, Path, Shape, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export type { Navigation, TNavigationOptions } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
@@ -568,7 +568,18 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 * @example
                 * const directions = await map.getDirections(space1, space2);
                 */
-            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], options?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | TNavigationTarget[], options?: TGetDirectionsOptions) => Directions | undefined;
+            /**
+                * Retrieves directions ({@link Directions}) from one navigable point ({@link TNavigationTarget}) to multiple destination points on the map.
+                *
+                * @param from The starting point for navigation.
+                * @param to The destination points.
+                * @param options Optional parameters for getting directions.
+                * @returns Directions from the start to the destination points.
+                * @example
+                * const directions = await map.getDirections(space1, [space2, space3]);
+                */
+            getDirectionsMultiDestination: (from: TNavigationTarget, to: (TNavigationTarget | TNavigationTarget[])[], options?: TGetDirectionsOptions) => Directions[] | undefined;
             /**
                 * Retrieves the distance between two navigable points ({@link TNavigationTarget}) on the map.
                 *
@@ -599,7 +610,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/events' {
     import type { ClickPayload } from '@mappedin/core-sdk';
     import type { TStackedMapsEvents } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
     import type { Coordinate, Floor, MapObject, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import type { Label, Marker, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    import type { Label, Marker, Model, Path } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { CameraTransform } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/camera-transform';
     export type TFloorChangeReason = '' | 'blue-dot-floor-change' | 'elevation-change';
     export type TClickPayload = {
@@ -607,6 +618,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/events' {
                 * The coordinate of the interaction.
                 */
             coordinate: Coordinate;
+            /**
+                * The interactive paths which the user interaction passed through.
+                */
+            paths: Path[];
             /**
                 * The interactive spaces which the user interaction passed through.
                 */
@@ -902,7 +917,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 * change the langauge of the data objects in mapdata
                 */
             changeLanguage(languageCode: string): Promise<void>;
-            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], opt?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            getDirectionsMultiDestination: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], opt?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], opt?: TGetDirectionsOptions & {
+                    multiSegment?: true;
+            }) => Directions | Directions[] | undefined;
             getDistance(from: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation, to: Space | Door | Coordinate | MapObject | PointOfInterest | Annotation | Node | EnterpriseLocation): number;
             toJSONBundle({ downloadLanguagePacks, }?: {
                     downloadLanguagePacks?: boolean;
@@ -1091,7 +1109,16 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * @example
                 * const directions = await map.getDirections(space1, space2);
                 */
-            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | (TNavigationTarget | TNavigationTarget[])[], options?: TGetDirectionsOptions) => Directions | Directions[] | undefined;
+            getDirections: (from: TNavigationTarget | TNavigationTarget[], to: TNavigationTarget | TNavigationTarget[], options?: TGetDirectionsOptions) => Directions | undefined;
+            /**
+                * Retrieves directions ({@link Directions}) from one navigable point ({@link TNavigationTarget}) to multiple destination points on the map.
+                *
+                * @param from The starting point for navigation.
+                * @param to The destination points.
+                * @param options Optional parameters for getting directions.
+                * @returns Directions from the start to the destination points.
+                */
+            getDirectionsMultiDestination: (from: TNavigationTarget, to: (TNavigationTarget | TNavigationTarget[])[], options?: TGetDirectionsOptions) => Directions[] | undefined;
             /**
                 * Retrieves the distance between two navigable points ({@link TNavigationTarget}) on the map.
                 *
@@ -1247,6 +1274,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     export type DeepRequired<T> = Required<{
             [K in keyof T]: T[K] extends Required<T[K]> ? T[K] : DeepRequired<T[K]>;
     }>;
+    export type DeepPartial<T> = Partial<{
+            [K in keyof T]: T[K] extends Partial<T[K]> ? DeepPartial<T[K]> : T[K];
+    }>;
     export type CancellablePromise<T> = {
             promise: Promise<T>;
             cancel: () => void;
@@ -1573,10 +1603,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                     left: number;
             };
     };
+    export type TCameraFocusOnTargets = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | Node;
     /**
         * Defines the target for the {@link Camera} focus operation.
+        * @interface
         */
-    export type TCameraFocusOnTarget = Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Annotation | Node | (Floor | Space | Coordinate | MapObject | Connection | PointOfInterest | Door | Node)[];
+    export type TCameraFocusOnTarget = TCameraFocusOnTargets | TCameraFocusOnTargets[];
     /**
         * Defines the target for camera operations.
         */
@@ -1867,12 +1899,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
         * Options for controlling the behavior of the {@link Directions}.
         */
     export type TGetDirectionsOptions = {
-            /**
-                * If true directions will be shown as a multisegment route
-                *
-                * @default false
-                */
-            multiSegment?: boolean;
             /**
                 * If true directions will only take accessible routes
                 *
@@ -2098,16 +2124,16 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                     opacity?: number;
             };
             /**
-                * Options for the bearing directional indicator.
+                * Options for the heading directional indicator.
                 */
-            bearing?: {
+            heading?: {
                     /**
-                        * The color of the bearing cone.
+                        * The color of the heading cone.
                         * @default #2266ff
                         */
                     color?: string;
                     /**
-                        * The opacity of the bearing cone.
+                        * The opacity of the heading cone.
                         * @default 0.7
                         */
                     opacity?: number;
@@ -2118,12 +2144,50 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 * @default 30000
                 */
             timeout?: number;
+            /**
+                * Whether to watch the browser's position.
+                * @default true
+                */
+            watchBrowserPosition?: boolean;
             /**
                 * Whether to log debug messages.
                 * @default false
                 */
             debug?: boolean;
     };
+    /**
+        * Position update options for the {@link BlueDot.update} method.
+        */
+    export type TBlueDotPositionUpdate = {
+            /**
+                * Latitude to override.
+                * Set to `'device'` to reset to the device's latitude.
+                */
+            latitude?: GeolocationPosition['coords']['latitude'] | 'device' | undefined;
+            /**
+                * Longitude to override.
+                * Set to `'device'` to reset to the device's longitude.
+                */
+            longitude?: GeolocationPosition['coords']['longitude'] | 'device' | undefined;
+            /**
+                * Accuracy to override.
+                * Set to `'device'` to reset to the device's accuracy.
+                * Set to `undefined` to disable the accuracy ring.
+                */
+            accuracy?: GeolocationPosition['coords']['accuracy'] | 'device' | undefined;
+            /**
+                * Heading to override.
+                * Set to `'device'` to reset to the device's heading.
+                * Set to `undefined` to disable the heading indicator.
+                */
+            heading?: GeolocationPosition['coords']['heading'] | 'device' | undefined;
+            /**
+                * Floor level to override.
+                * Set to `'device'` to reset to the device's floor level.
+                * Set to `undefined` to disable floor level and show the BlueDot on all floors.
+                */
+            floor?: Floor | 'device' | undefined;
+    };
     export type LanguagePackHydrationItem = {
             language: Language;
             localePack: ParsedMVFLocalePack;
@@ -2141,8 +2205,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects' {
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
+    import { type TDirectionInstruction } from '@mappedin/mappedin-js/mappedin-js/src';
     import type { Directions } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
+    import { Path, Marker } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { RendererCore } from '@mappedin/core-sdk';
     /**
         * Options for navigation.
@@ -2177,6 +2243,12 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
                         * @default '#40A9FF'
                         */
                     color?: string;
+                    /**
+                        * Whether the path should be clickable.
+                        *
+                        * @defaultValue false
+                        */
+                    interactive?: boolean;
                     /**
                         * The accent color of the path. This is applied to arrows if they are displayed
                         * @default 'blue'
@@ -2233,6 +2305,20 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
                 * @internal
                 */
             constructor(core: RendererCore, currentMapGetter: CurrentMapGetter);
+            /**
+                * @internal
+                */
+            getPathById(id: string): {
+                    path: Path;
+                    entityIds: string[];
+            } | undefined;
+            /**
+                * @internal
+                */
+            getMarkerById(id: string): {
+                    instruction: TDirectionInstruction;
+                    marker: Marker;
+            } | undefined;
             /**
                 * Draws the specified directions on the map.
                 * @param directions The directions to be drawn.
@@ -3067,7 +3153,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor' {
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/connection' {
-    import type { FeatureCollection, Image, Point, SpaceProperties } from '@mappedin/mvf';
+    import type { Feature, FeatureCollection, Image, Point, SpaceProperties, Connection as MVFConnection } from '@mappedin/mvf';
     import Coordinate from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/coordinate';
     import type { Floor, MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
@@ -3097,7 +3183,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/connectio
                 * @internal
                 */
             constructor(data: MapDataInternal, options: {
-                    mvfDataByFloorId: Record<string, FeatureCollection<Point, SpaceProperties>['features'][number]>;
+                    mvfDataByFloorId: Record<string, FeatureCollection<Point, SpaceProperties>['features'][number]> | Record<string, Feature<Point, MVFConnection>>;
+                    accessible?: boolean;
             });
             /**
                 * Gets the name of the connection.
@@ -3107,6 +3194,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/connectio
             get name(): string;
             get description(): string;
             get images(): Image[];
+            get accessible(): boolean;
             /**
                 * Gets the external ID of the connection.
                 *
@@ -4162,7 +4250,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     export { parseMVF, unzipMVF, enableTestMode };
     export type { MapView, MapData, MappedinMapLibreOverlay, TEvents, TEventPayload, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TGetMapDataSharedOptions, TAmbientOcclusionOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, };
     export type * from 'geojson';
-    export type { TUpdateState, TLabelState, TGeometryState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    export type { TUpdateState, TLabelState, TGeometryState, TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TCameraFocusOnTarget, TAddMarkerOptions, TAddPathOptions, TLabelAppearance, TAddLabelOptions, TAddModelOptions, TAddModel, TGetDirectionsOptions, TCollisionRankingTier, TMarkerAnchor, TDirectionInstruction, TDirectionInstructionAction, TGetState, TMarkerState, TBlueDotOptions, TBlueDotPositionUpdate, } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export { WALLS, DOORS } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export type { Label, Marker, Path, Shape, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export type { Navigation, TNavigationOptions } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
@@ -4177,66 +4265,81 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
     import type { RendererCore } from '@mappedin/core-sdk';
     import { PubSub } from '@packages/internal/common';
     import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
-    import type { TBlueDotOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    import { z } from 'zod';
+    import type { TBlueDotOptions, TBlueDotPositionUpdate } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import { Coordinate, type Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export type TBlueDotEvents = {
-        'floor-change': {
-            reason: 'blue-dot-floor-change';
-            floorId: string;
-        };
+            'floor-change': {
+                    reason: 'blue-dot-floor-change';
+                    floorId: string;
+            };
     };
     export type TBlueDotState = 'hidden' | 'active' | 'inactive' | 'disabled';
     export type TBlueDotAction = 'timeout' | 'error' | 'position-received' | 'enable' | 'disable';
     export class BlueDot extends PubSub<TBlueDotEvents> {
-        #private;
-        /**
-          * @internal
-          */
-        constructor(core: RendererCore, geoJSONApi: GeoJsonApi);
-        enable(options?: TBlueDotOptions): void;
-        disable(): void;
+            #private;
+            state: TBlueDotState;
+            /**
+                * The direction the user is facing in degrees from north.
+                */
+            get heading(): GeolocationPosition['coords']['heading'] | undefined;
+            /**
+                * The accuracy of the current position in metres.
+                */
+            get accuracy(): GeolocationPosition['coords']['accuracy'] | undefined;
+            /**
+                * The coordinate of the current position.
+                */
+            get coordinate(): Coordinate | undefined;
+            /**
+                * The floor the Blue Dot is currently on. If undefined, the Blue Dot will appear on every floor.
+                */
+            get floor(): Floor | undefined;
+            /**
+                * @internal
+                */
+            constructor(core: RendererCore, geoJSONApi: GeoJsonApi);
+            /**
+                * Enable the Blue Dot. It will be hidden until a position is received either from the browser or by calling {@link BlueDot.update}.
+                * @param options - The options to setup the Blue Dot.
+                */
+            enable(options?: TBlueDotOptions): void;
+            /**
+                * Disable the Blue Dot. It will be hidden and no longer update.
+                */
+            disable(): void;
+            /**
+                * Enable or disable the devices's geolocation listener to automatically position the Blue Dot.
+                * If enabled, the device will request permission to access the user's precise location.
+                * @param watch - Whether to enable or disable the listener.
+                */
+            watchDevicePosition(watch: boolean): void;
+            /**
+                * Manually override some position properties of the Blue Dot.
+                * Accepts a full GeolocationPosition object or a partial {@link TBlueDotPositionUpdate} object.
+                * @example Manually set the accuracy and heading
+                * ```ts
+                * api.BlueDot.update({ accuracy: 10, heading: 90 });
+                * ```
+                * @example Reset accuracy and heading to device values
+                * ```ts
+                * api.BlueDot.update({ accuracy: 'device', heading: 'device' });
+                * ```
+                */
+            update(position: (GeolocationPosition & {
+                    coords: GeolocationPosition['coords'] & {
+                            readonly floorLevel?: number;
+                    };
+            }) | TBlueDotPositionUpdate | undefined): void;
     }
     type TStateTransitions = {
-        [Action in TBlueDotAction]?: TBlueDotState;
+            [Action in TBlueDotAction]?: TBlueDotState;
     };
     type TStateMachine = {
-        [State in TBlueDotState]: {
-            actions: TStateTransitions;
-        };
+            [State in TBlueDotState]: {
+                    actions: TStateTransitions;
+            };
     };
     export const stateMachine: TStateMachine;
-    export const positionSchema: z.ZodObject<{
-        coords: z.ZodObject<{
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            floorLevel: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-            accuracy: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-        }, "strip", z.ZodTypeAny, {
-            latitude: number;
-            longitude: number;
-            floorLevel?: number | null | undefined;
-            accuracy?: number | null | undefined;
-        }, {
-            latitude: number;
-            longitude: number;
-            floorLevel?: number | null | undefined;
-            accuracy?: number | null | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        coords: {
-            latitude: number;
-            longitude: number;
-            floorLevel?: number | null | undefined;
-            accuracy?: number | null | undefined;
-        };
-    }, {
-        coords: {
-            latitude: number;
-            longitude: number;
-            floorLevel?: number | null | undefined;
-            accuracy?: number | null | undefined;
-        };
-    }>;
     export {};
 }
 
@@ -4450,9 +4553,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
 
 declare module '@mappedin/mappedin-js/geojson/src/components/path' {
     import { Vector3 } from 'three';
-    import type { Mesh, ShaderMaterial, BufferGeometry } from 'three';
+    import type { Mesh, BufferGeometry } from 'three';
     import type { EntityId, Position } from '@mappedin/mappedin-js/geojson/src/types';
-    import { Geometry3DObject3D } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
+    import type { PathMaterial, PatMeshContainer } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
     import type { FeatureCollection, Point } from 'geojson';
     import type { GroupContainerState } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
     export type PathProperties = {
@@ -4461,6 +4564,11 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
                 */
             parentId?: EntityId<GroupContainerState> | string | null;
     };
+    /**
+        * Updatable path state
+        * @interface
+        */
+    export type PathUpdateState = Omit<Partial<PathState>, 'id' | 'type'>;
     /**
         * State representing a Path
         */
@@ -4489,6 +4597,30 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
                 * Note: use values between 0 and 1.
                 */
             completeFraction: number;
+            /**
+                * The color of the path.
+                */
+            color: string;
+            /**
+                * The accent color of the path. When arrows are visible, it is applied to them
+                */
+            accentColor: string;
+            /**
+                * Display Arrows on Path to indicate direction
+                */
+            displayArrowsOnPath: boolean;
+            /**
+                * Arrows on path should animate to indicate direction
+                */
+            animateArrowsOnPath: boolean;
+            /**
+                * The radius of the path when zoomed in
+                */
+            nearRadius: number;
+            /**
+                * The radius of the path when zoomed out
+                */
+            farRadius: number;
     };
     export type AddPathOptions = {
             /**
@@ -4528,16 +4660,16 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
     export class PathComponent {
             #private;
             readonly type = "path";
-            mesh: Geometry3DObject3D;
-            material?: ShaderMaterial;
+            mesh: PatMeshContainer;
+            material?: PathMaterial;
             geometry?: BufferGeometry;
             outline?: Mesh;
             feature: FeatureCollection<Point, PathProperties>;
             options: AddPathOptions;
             nearRadius: number;
             farRadius: number;
-            color: string;
             accentColor: string;
+            completeFraction: number;
             altitudeAdjustment: number;
             displayArrowsOnPath: boolean;
             animateArrowsOnPath: boolean;
@@ -4546,11 +4678,10 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
                 */
             isVertical: boolean;
             dirty: boolean;
+            materialDirty: boolean;
             constructor(feature: FeatureCollection<Point, PathProperties>, options?: AddPathOptions);
             setColor(): void;
             setOpacity(): void;
-            set completeFraction(value: number);
-            get completeFraction(): number;
             set visible(visible: boolean);
             get visible(): boolean;
             position: Vector3;
@@ -5366,6 +5497,10 @@ declare module '@mappedin/mappedin-js/geojson/src/types' {
                 * The coordinate of the interaction.
                 */
             coordinate: Position;
+            /**
+                * An array of path IDs which the user interaction passed through. Will be empty if no paths were interacted with.
+                */
+            paths: (string | number)[] | [];
             /**
                 * An array of marker IDs which the user interaction passed through. Will be empty if no markers were interacted with.
                 */
@@ -5946,7 +6081,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
     import { TwoDVisibilitySystem } from '@mappedin/mappedin-js/geojson/src/systems/2d-visibility/system';
     import { RenderSystem } from '@mappedin/mappedin-js/geojson/src/systems/render/system';
     import type { Position as GeoJsonPosition, FeatureCollection, LineString, MultiPolygon, Polygon, Point, Feature } from 'geojson';
-    import type { AddPathOptions, PathProperties, PathState } from '@mappedin/mappedin-js/geojson/src/components/path';
+    import type { AddPathOptions, PathProperties, PathState, PathUpdateState } from '@mappedin/mappedin-js/geojson/src/components/path';
     import { StackSystem } from '@mappedin/mappedin-js/geojson/src/systems/stack/system';
     import { CameraSystem } from '@mappedin/mappedin-js/geojson/src/systems/camera';
     import { DOMDrawSystem } from '@mappedin/mappedin-js/geojson/src/systems/dom-draw/system';
@@ -6121,7 +6256,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
                 * Get the current state of the map view, or any entity that was added, regardless of whether it is visible in the scene
                 */
             getState(): MapViewState;
-            getState<T extends EntityId<EntityState>>(geometryOrGeometryId: T): T extends EntityId<LabelState> ? LabelState : T extends EntityId<GeometryState> ? GeometryState : T extends EntityId<MarkerState> ? MarkerState : T extends EntityId<GeometryGroupState> ? GeometryGroupState : T extends EntityId<GroupContainerState> ? GroupContainerState : T extends EntityId<ModelState> ? ModelState : T extends EntityId<PathState> ? ShapeState : T extends EntityId<ShapeState> ? ShapeState : T extends EntityId<ImageState> ? ImageState : EntityState;
+            getState<T extends EntityId<EntityState>>(geometryOrGeometryId: T): T extends EntityId<LabelState> ? LabelState : T extends EntityId<GeometryState> ? GeometryState : T extends EntityId<MarkerState> ? MarkerState : T extends EntityId<GeometryGroupState> ? GeometryGroupState : T extends EntityId<GroupContainerState> ? GroupContainerState : T extends EntityId<ModelState> ? ModelState : T extends EntityId<PathState> ? PathState : T extends EntityId<ShapeState> ? ShapeState : T extends EntityId<ImageState> ? ImageState : EntityState;
             getState(geometryOrGeometryId?: Record<string | number, any> | string | number): EntityState;
             getState<T extends EntityState>(geometryOrGeometryId: T['id']): T extends LabelState ? LabelState : T extends GeometryState ? GeometryState : T extends MarkerState ? MarkerState : T extends GeometryGroupState ? GeometryGroupState : T extends GroupContainerState ? GroupContainerState : T extends ModelState ? ModelState : T extends PathState ? PathState : T extends ShapeState ? ShapeState : T extends ImageState ? ImageState : EntityState;
             /**
@@ -6134,7 +6269,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             setState<T extends EntityId<GroupContainerState>>(object: T | T['id'], state: Partial<GroupContainerState>): void;
             setState<T extends EntityId<GeometryState>>(object: T | T['id'], state: Partial<GeometryState>): void;
             setState<T extends EntityId<ShapeState>>(object: T | T['id'], state: Partial<ShapeState>): void;
-            setState<T extends EntityId<PathState>>(object: T | T['id'], state: Partial<PathState>): void;
+            setState<T extends EntityId<PathState>>(object: T | T['id'], state: PathUpdateState): void;
             setState<T extends EntityId<ModelState>>(object: T | T['id'], state: Partial<ModelState>): void;
             setState<T extends EntityId<ImageState>>(object: T | T['id'], state: Partial<ImageState>): void;
             setState<T extends EntityState>(object: T | T['id'], state: Partial<T>): void;
@@ -6552,7 +6687,7 @@ declare module '@mappedin/mappedin-js/geojson/src/utils' {
     export { getPixelRatio } from '@mappedin/mappedin-js/geojson/src/utils/get-pixel-ratio';
     export { debounce } from '@mappedin/mappedin-js/geojson/src/utils/async';
     export { shouldDisableOffscreenCanvas } from '@mappedin/mappedin-js/geojson/src/utils/browser';
-    export { noop } from '@mappedin/mappedin-js/geojson/src/utils/fp';
+    export { noop, pick, isEmpty, type KeysOfUnion } from '@mappedin/mappedin-js/geojson/src/utils/fp';
     export { transformRequest } from '@mappedin/mappedin-js/geojson/src/utils/tranform-request';
 }
 
@@ -6979,7 +7114,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object' {
             floorId: string;
         };
     }> {
+        /** Floors sorted in order of elevation */
         floors: FloorObject[];
+        /** Map of floors by elevation. Floor elevation does not always match index or is not always contiguous. */
+        floorsByElevation: Map<number, FloorObject>;
         currentFloorId: string;
         id: string;
         renderer: RendererCore;
@@ -8099,7 +8237,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/analytics/customer' {
             latitude: number;
             longitude: number;
             floorLevel?: number;
-            accuracy: number;
+            accuracy?: number;
     };
     type AnalyticsAuth = {
             /** The API key for authentication. */
@@ -8176,6 +8314,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-meta
 
 declare module '@mappedin/mappedin-js/geojson/src/entities/geometry3d' {
     import { Object3D } from 'three';
+    import type { Mesh, Object3DEventMap, ShaderMaterial, Texture, TubeGeometry, Color, Vector2 } from 'three';
     import type { InteractionComponent } from '@mappedin/mappedin-js/geojson/src/components/interaction';
     import type { MeshComponent } from '@mappedin/mappedin-js/geojson/src/components/mesh';
     import type { ModelComponent } from '@mappedin/mappedin-js/geojson/src/components/model';
@@ -8196,15 +8335,104 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/geometry3d' {
             type: 'geometry' | 'path' | 'model' | 'custom-geometry' | 'image';
         };
     }
+    export type PathMaterial = ShaderMaterial & {
+        uniforms: PathUniforms;
+    };
+    export type PathMesh = Mesh<TubeGeometry, PathMaterial, Object3DEventMap>;
+    export class PatMeshContainer extends Geometry3DObject3D {
+        children: [PathMesh, PathMesh];
+    }
     export type MeshComponentTypes = MeshComponent | PathComponent | ModelComponent | CustomGeometryComponent | ImageComponent;
     export class Geometry3D {
         id: string | number;
         components: [MeshComponentTypes, StyleComponent, InteractionComponent?];
-        get object3d(): Geometry3DObject3D | import("../components/mesh").EntityBatchedMesh | undefined;
+        get object3d(): Geometry3DObject3D | PatMeshContainer | import("../components/mesh").EntityBatchedMesh | undefined;
         get parent(): GroupContainerObject3D | GeometryGroupObject3D | null;
         get type(): 'geometry' | 'path' | 'model' | 'custom-geometry' | 'image';
         constructor(meshComponent: MeshComponent | PathComponent | ModelComponent | CustomGeometryComponent | ImageComponent, styleComponent: StyleComponent);
     }
+    export interface PathUniforms {
+        vertexes: {
+            type: 'f';
+            value: number;
+        };
+        resolution: {
+            type: 'v2';
+            value: Vector2;
+        };
+        cameraParameters: {
+            type: 'v2';
+            value: Vector2;
+        };
+        complete: {
+            type: 'f';
+            value: number;
+        };
+        color: {
+            type: 'c';
+            value: Color;
+        };
+        pathLength: {
+            type: 'f';
+            value: number;
+        };
+        nearRadius: {
+            type: 'f';
+            value: number;
+        };
+        farRadius: {
+            type: 'f';
+            value: number;
+        };
+        nearZoom: {
+            type: 'f';
+            value: number;
+        };
+        farZoom: {
+            type: 'f';
+            value: number;
+        };
+        pulseColor: {
+            type: 'c';
+            value: Color;
+        };
+        pulse: {
+            type: 'f';
+            value: number;
+        };
+        pulseLength: {
+            type: 'f';
+            value: number;
+        };
+        pathIsVertical: {
+            type: 'b';
+            value: boolean;
+        };
+        arrowAnimationTimer: {
+            type: 'f';
+            value: number;
+        };
+        arrowTexture: {
+            type: 't';
+            value: Texture;
+        };
+        displayArrowsOnPath: {
+            type: 'b';
+            value: boolean;
+        };
+        flattenFactor: {
+            type: 'f';
+            value: number;
+        };
+        showPulse: {
+            type: 'b';
+            value: boolean;
+        };
+        opacityMultiplier: {
+            type: 'f';
+            value: number;
+        };
+    }
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/entities/geometry2d' {
@@ -8416,7 +8644,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/image' {
 declare module '@mappedin/mappedin-js/geojson/src/entities' {
     export { updateInteractivity } from '@mappedin/mappedin-js/geojson/src/entities/utils';
     export { Geometry2D, Geometry2DComponents } from '@mappedin/mappedin-js/geojson/src/entities/geometry2d';
-    export { Geometry3D, Geometry3DComponents } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
+    export { Geometry3D, Geometry3DComponents, type PathMesh, type PatMeshContainer, type PathMaterial, } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/types/options' {
@@ -9222,6 +9450,23 @@ declare module '@mappedin/mappedin-js/geojson/src/utils/browser' {
 
 declare module '@mappedin/mappedin-js/geojson/src/utils/fp' {
     export function noop(): void;
+    export type KeysOfUnion<T> = T extends T ? keyof T : never;
+    /**
+      * Given an object and a number of properties as strings, return version
+      * of that object with only those properties.
+      *
+      * @param src - the object
+      * @param properties - an array of property names chosen
+      * to appear on the resulting object.
+      * @returns object with limited properties.
+      * @example
+      * ```ts
+      * let foo = { name: 'Charlie', age: 10 };
+      * let justName = pick(foo, ['name']); // justName = { name: 'Charlie' }
+      * ```
+      */
+    export function pick<T extends object>(src: T, properties: KeysOfUnion<T>[]): Partial<T>;
+    export function isEmpty(obj: Record<string, any>): boolean;
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/utils/tranform-request' {
@@ -9367,8 +9612,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/style' {
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/entities/utils' {
-    import type { CollisionRankingTier, GeometryState, LabelState, PathState, RendererCore } from '@mappedin/mappedin-js/geojson/src';
+    import type { CollisionRankingTier, GeometryState, LabelState, RendererCore } from '@mappedin/mappedin-js/geojson/src';
     import { type MarkerState } from '@mappedin/mappedin-js/geojson/src/components/marker';
+    import type { PathUpdateState } from '@mappedin/mappedin-js/geojson/src/components/path';
     import type { Geometry3DTypes, Position, RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
     import { GeometryGroupObject3D, type GeometryGroupState } from '@mappedin/mappedin-js/geojson/src/entities/geometry-group';
     import { GroupContainerObject3D } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
@@ -9385,7 +9631,6 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/utils' {
     export function updatePosition(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: Position | undefined, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition']): void;
     export function updateParent(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: GroupContainerObject3D | undefined): boolean;
     export function updateEnabled(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: boolean | undefined): void;
-    export function updatePath(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: Partial<PathState> | undefined): void;
     export function updateMarker(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: Partial<MarkerState> | undefined, state: RendererState): boolean;
     export function updateRank(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: CollisionRankingTier | undefined): boolean;
     export function updateLabel(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update: Partial<LabelState> | undefined, state: RendererState): void;
@@ -9398,6 +9643,8 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/utils' {
     export function updateIndividualGeometryOpacity(entity: Geometry3D, update?: number): boolean;
     export function updateAltitude(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update?: number): boolean;
     export function updateOutline(entity: Geometry3DTypes, update?: boolean): boolean;
+    export function handlePathUpdate(geometry: Geometry3D, update: PathUpdateState): void;
+    export function pickPathOptions(update: PathUpdateState): Partial<PathUpdateState>;
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/systems/collisions/collider-processor' {