@mappedin/mappedin-js 6.0.0-rc.2 → 6.0.0-rc.3

package/lib/esm/index.d.ts

@@ -50,7 +50,7 @@ declare module '@mappedin/mappedin-js' {
     import type { LanguagePackHydrationItem, TImagePlacementOptions, TMultiFloorViewOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import { MAPPEDIN_COLORS } from '@mappedin/mappedin-js/mappedin-js/src/constants';
     import { unzipAndParseMVFv2 } from '@packages/internal/mvf-utils/mvf-utils';
-    import type { GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
+    import type { GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor, TBlueDotState } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     import { hydrateMapData, type THydrateMapDataBundle } from '@mappedin/mappedin-js/mappedin-js/src/hydrate-map-data';
     export { disableText3DWorker } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/text3d';
     export { hydrateMapData, type THydrateMapDataBundle };
@@ -367,10 +367,10 @@ declare module '@mappedin/mappedin-js' {
         */
     export const show3dMapGeojson: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
     export { parseMVF, unzipMVF, enableTestMode, preloadFont, MAPPEDIN_COLORS, ANIMATION_TWEENS };
-    export type { MapData, MapViewState, GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor, TEvents, TMapDataEvents, TStateChangedInternalPayload, TEventPayload, TFloorChangeReason, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TSearchOptions, TGetMapDataSharedOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, EnvMapOptions, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, OperationHours, SiblingGroup, LocationState, AddText3DOptions, InitializeText3DState, InitializeModelState, Interpolation, LabelAppearance, ColorString, InterpolateOn, };
+    export type { MapData, MapViewState, GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor, TBlueDotState, TEvents, TMapDataEvents, TStateChangedInternalPayload, TEventPayload, TFloorChangeReason, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TSearchOptions, TGetMapDataSharedOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, EnvMapOptions, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, OperationHours, SiblingGroup, LocationState, AddText3DOptions, InitializeText3DState, InitializeModelState, Interpolation, LabelAppearance, ColorString, InterpolateOn, };
     export { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
     export type * from 'geojson';
-    export type { TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TAddMarkerOptions, TAddPathOptions, TAddLabelOptions, TAddModelOptions, TAddModel, TAddImageOptions, TGetDirectionsOptions, TCollisionRankingTier, TMarkerPlacement, TDirectionInstruction, TDirectionInstructionAction, TFocusTarget, IFocusable, IAnchorable, TMapDataObjectTypes, TSetFloorOptions, TCancellablePromise, TAnimateStateResult, GlobalState, TActionType, TBearingType, TConnectionType, TMultiFloorViewOptions, MapViewElements, MapDataElements, MapElementsWithState, TGetState, TUpdateState, } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    export type { TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TAddMarkerOptions, TAddPathOptions, TAddLabelOptions, TAddModelOptions, TAddModel, TAddImageOptions, TGetDirectionsOptions, TCollisionRankingTier, TMarkerPlacement, TDirectionInstruction, TDirectionInstructionAction, TFocusTarget, IFocusable, IAnchorable, TMapDataObjectTypes, TSetFloorOptions, TCancellablePromise, TAnimateStateResult, GlobalState, TActionType, TBearingType, TConnectionType, TMultiFloorViewOptions, TBlueDotOptions, TBlueDotPositionUpdate, TBlueDotUpdateOptions, MapViewElements, MapDataElements, MapElementsWithState, TGetState, TUpdateState, } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export type { TModelState, TModelUpdateState, TLabelState, TLabelUpdateState, TMarkerState, TMarkerUpdateState, TPathState, TPathUpdateState, TShapeState, TShapeUpdateState, TText3DState, TText3DUpdateState, TWallsState, TWallsUpdateState, TDoorsState, TDoorsUpdateState, TFacadeState, TFacadeUpdateState, TFloorState, TFloorUpdateState, TGeometryState, TGeometryUpdateState, TImage3DState as TImageState, TImage3DUpdateState as TImageUpdateState, MapElementToGetState, MapElementToUpdateState, } from '@mappedin/mappedin-js/mappedin-js/src/states';
     export { WALLS, DOORS, ACTION_TYPE, BEARING_TYPE, CONNECTION_TYPE } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export type { Label, Marker, Path, PathSegment, Shape, CameraTransform, Model, Image3DView, Text3DView, } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
@@ -1614,7 +1614,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 */
             getMVFFeatureByType(type: 'floor-stack'): MVFFloorStack[];
             getMVFFeatureByType(type: 'floor'): MVFFloor[];
-            getPropTranslation<T extends keyof LanguagePackRecords, P extends keyof NonNullable<NonNullable<LanguagePackRecords[T]>[string]>>(type: T, prop: P, id: string, fallback: NonNullable<NonNullable<LanguagePackRecords[T]>[string]>[P]): string | NonNullable<NonNullable<LanguagePackRecords[T]>[string]>[P] | undefined;
+            propTranslationCache: Map<number, Record<string, unknown>>;
+            getPropTranslation<T extends keyof LanguagePackRecords, P extends keyof NonNullable<NonNullable<LanguagePackRecords[T]>[string]>>(type: T, prop: P, id: string, fallback: NonNullable<NonNullable<LanguagePackRecords[T]>[string]>[P]): unknown;
             findPreferredLanguage(options?: TFindPreferredLanguageInVenueOptions): Language | undefined;
             /**
                 * Changes the language of the map data.
@@ -1678,7 +1679,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
     import { Coordinate } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { Annotation, Door, Floor, MapObject, PointOfInterest, Space, Node, EnterpriseLocation, FloorStack } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { TCoordinateParams } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/coordinate';
-    import type { TGetDirectionsOptions, TNavigationTarget, GlobalState, UpdateGlobalState, TSetFloorOptions, TCancellablePromise, TAnimateStateResult, TGetState, MapElementsWithState, TUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { TGetDirectionsOptions, TNavigationTarget, GlobalState, UpdateGlobalState, TSetFloorOptions, TCancellablePromise, TAnimateStateResult, TGetState, MapElementsWithState, TUpdateState, TGetInViewOptions, MapFeatureOfType } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import type { Label, Marker } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { TEventPayload } from '@mappedin/mappedin-js/mappedin-js/src/events';
     import type { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
@@ -2313,6 +2314,14 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * @returns A boolean indicating whether the target is within the viewport.
                 */
             isInView(target: Space | MapObject | Label | Marker | string): boolean;
+            /**
+                * Gets the map elements that are currently in view.
+                *
+                * @param type The type of map element to get.
+                * @param options Optional configuration for the in view check.
+                * @returns An array of map elements that are currently in view.
+                */
+            getInView<T extends string>(type: T, options?: TGetInViewOptions): MapFeatureOfType<T>[];
             /**
                 * @deprecated Use the async version instead. This method will be made truly async in the upcoming future.
                 * @internal
@@ -2703,7 +2712,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
     import type { MarkerPlacement } from '@mappedin/core-sdk/src/components/marker';
     import type { Language, ParsedMVFLocalePack } from '@mappedin/mvf-v2';
     import type { Feature, MultiPolygon, Polygon } from 'geojson';
-    import type { AddText3DOptions, EnvMapOptions, ImagePlacementOptions, InitializeModelState, InsetPaddingOption, Interpolation, LabelAppearance } from '@mappedin/mappedin-js/geojson/src';
+    import type { AddText3DOptions, EnvMapOptions, ImagePlacementOptions, InitializeModelState, InsetPadding, InsetPaddingOption, Interpolation, LabelAppearance } from '@mappedin/mappedin-js/geojson/src';
     import type { TFloorChangeReason } from '@mappedin/mappedin-js/mappedin-js/src/events';
     import type { Annotation, Area, Connection, Coordinate, Door, EnterpriseCategory, EnterpriseLocation, EnterpriseVenue, Facade, Floor, FloorStack, LocationCategory, LocationProfile, MapObject, Node, PointOfInterest, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { Image3DView, Label, Marker, Model, Path, Shape, Text3DView, PathSegment } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
@@ -3388,6 +3397,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                         * @default 0.7
                         */
                     opacity?: number;
+                    /**
+                        * Whether to display the heading cone when the BlueDot is inactive (timed out).
+                        * @default false
+                        */
+                    displayWhenInactive?: boolean;
             };
             /**
                 * The duration of the timeout in milliseconds.
@@ -3410,6 +3424,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 * @default 50
                 */
             accuracyThreshold?: number;
+            /**
+                * The initial state of the BlueDot when enabled.
+                * @default 'hidden'
+                */
+            initialState?: 'hidden' | 'inactive';
     };
     /**
         * Position update options for the {@link BlueDot.update} method.
@@ -3448,6 +3467,21 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             timestamp?: number;
     };
+    /**
+        * Options for the BlueDot update method.
+        */
+    export type TBlueDotUpdateOptions = {
+            /**
+                * If true, maintains the current state and skips timers and analytics for this update.
+                * @default false
+                */
+            silent?: boolean;
+            /**
+                * If true, animates the position change. If false, updates immediately.
+                * @default true
+                */
+            animate?: boolean;
+    };
     export type LanguagePackHydrationItem = {
             language: Language;
             localePack: ParsedMVFLocalePack;
@@ -3528,23 +3562,44 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
         * Associates MapData type strings with their corresponding classes.
         */
     export type TMapDataObjectTypes = {
-            'location-profile': LocationProfile;
-            'location-category': LocationCategory;
-            node: Node;
-            space: Space;
-            door: Door;
-            floor: Floor;
-            'floor-stack': FloorStack;
-            connection: Connection;
-            object: MapObject;
-            'point-of-interest': PointOfInterest;
-            annotation: Annotation;
-            'enterprise-location': EnterpriseLocation;
-            'enterprise-category': EnterpriseCategory;
-            'enterprise-venue': EnterpriseVenue;
-            area: Area;
-            facade: Facade;
+            [LocationProfile.__type]: LocationProfile;
+            [LocationCategory.__type]: LocationCategory;
+            [Node.__type]: Node;
+            [Space.__type]: Space;
+            [Door.__type]: Door;
+            [Floor.__type]: Floor;
+            [FloorStack.__type]: FloorStack;
+            [Connection.__type]: Connection;
+            [MapObject.__type]: MapObject;
+            [PointOfInterest.__type]: PointOfInterest;
+            [Annotation.__type]: Annotation;
+            [EnterpriseLocation.__type]: EnterpriseLocation;
+            [EnterpriseCategory.__type]: EnterpriseCategory;
+            [EnterpriseVenue.__type]: EnterpriseVenue;
+            [Area.__type]: Area;
+            [Facade.__type]: Facade;
     };
+    /**
+        * Associates MapView type strings with their corresponding classes.
+        */
+    export type TMapViewObjectTypes = {
+            [Label.__type]: Label;
+            [Marker.__type]: Marker;
+            [Model.__type]: Model;
+            [Shape.__type]: Shape;
+            [Path.__type]: Path;
+            [PathSegment.__type]: PathSegment;
+            [Image3DView.__type]: Image3DView;
+            [Text3DView.__type]: Text3DView;
+    };
+    /**
+        * Associates MapData and MapView type strings with their corresponding classes.
+        */
+    export type TMapFeatureTypes = TMapDataObjectTypes & TMapViewObjectTypes;
+    /**
+        * Returns the class for a given type string.
+        */
+    export type MapFeatureOfType<T extends string> = T extends keyof TMapFeatureTypes ? TMapFeatureTypes[T] : never;
     /**
         * @interface
         * @internal
@@ -3594,6 +3649,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 */
             updateCameraElevationOnFloorChange?: boolean;
     };
+    export type TGetInViewOptions = Partial<{
+            screenOffsets: Partial<InsetPadding>;
+            fullyContains: boolean;
+    }>;
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/constants' {
@@ -3633,6 +3692,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/constants' {
     export const MARKERS_LAYER = "MarkersLayer";
     export const FOOTPRINT_LAYER = "FootprintLayer";
     export const OCCLUSION_LAYER = "OcclusionLayer";
+    export const AREAS_LAYER = "AreasLayer";
     export const IMAGES_LAYER = "ImagesLayer";
     export const FACADES_LAYER = "FacadesLayer";
     export const PATHS_LAYER = "PathsLayer";
@@ -3650,7 +3710,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
     import type { EasingCurve } from '@packages/internal/common';
     import { PubSub } from '@packages/internal/common';
     import { Coordinate, type Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import type { TBlueDotOptions, TBlueDotPositionUpdate } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { TBlueDotOptions, TBlueDotPositionUpdate, TBlueDotUpdateOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import type { GeoJsonApi } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api';
     export type TBlueDotEvents = {
             /**
@@ -3704,7 +3764,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
             hover: undefined;
     };
     export type TBlueDotState = 'hidden' | 'active' | 'inactive' | 'disabled';
-    export type TBlueDotAction = 'timeout' | 'error' | 'position-update' | 'enable' | 'disable';
+    export type TBlueDotAction = 'timeout' | 'error' | 'position-update' | 'enable' | 'disable' | 'initialize';
     export type TBlueDotPositionUpdateWithFloor = Omit<TBlueDotPositionUpdate, 'floorOrFloorId'> & {
             floor?: Floor | 'device' | undefined;
     };
@@ -3804,6 +3864,18 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
                 * @see [BlueDot Guide](https://developer.mappedin.com/web-sdk/blue-dot)
                 */
             enable(options?: TBlueDotOptions): void;
+            /**
+                * Update the BlueDot state after it has been enabled.
+                * This allows overriding previously set values like colors, and other options.
+                * @param options - The options to update
+                *
+                * @example Update color and accuracy ring
+                * mapView.BlueDot.updateState({
+                *   color: '#ff0000',
+                *   accuracyRing: { color: '#ff0000', opacity: 0.5 }
+                * });
+                */
+            updateState(options: Partial<TBlueDotOptions>): void;
             /**
                 * Disable the Blue Dot. It will be hidden and no longer update.
                 */
@@ -3826,7 +3898,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
                 * api.BlueDot.update({ accuracy: 'device', heading: 'device' });
                 * ```
                 */
-            update(position: GeolocationPositionExtended | TBlueDotPositionUpdate | undefined): void;
+            update(position: GeolocationPositionExtended | TBlueDotPositionUpdate | undefined, options?: TBlueDotUpdateOptions): void;
             /**
                 * Set the camera to follow the BlueDot in various modes. User interaction will cancel following automatically.
                 * @param mode The follow mode ('position-only', 'position-and-heading', 'position-and-path-direction', or false to disable).
@@ -4365,7 +4437,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
     import type { RendererCore, WatermarkUpdateOptions } from '@mappedin/core-sdk';
     import { PubSub } from '@packages/internal/common';
     import { type TShow3DMapOptions } from '@mappedin/mappedin-js/mappedin-js/src';
-    import type { MapElementsWithState, TUpdateState, TGetState } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    import type { MapElementsWithState, TUpdateState, TGetState, TGetInViewOptions, MapFeatureOfType } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
     import type { FloorStack, MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import { Coordinate, MapObject, Space, Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
@@ -4461,6 +4533,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
                     y: number;
             };
             isInView(target: Space | MapObject | Label | Marker | string): boolean;
+            getInView<T extends string>(type: T, options?: TGetInViewOptions): MapFeatureOfType<T>[];
             __EXPERIMENTAL__auto(): {
                     labels: Label[];
             };
@@ -4809,7 +4882,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     import type { LanguagePackHydrationItem, TImagePlacementOptions, TMultiFloorViewOptions } from '@mappedin/mappedin-js/mappedin-js/src/types';
     import { MAPPEDIN_COLORS } from '@mappedin/mappedin-js/mappedin-js/src/constants';
     import { unzipAndParseMVFv2 } from '@packages/internal/mvf-utils/mvf-utils';
-    import type { GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
+    import type { GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor, TBlueDotState } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     import { hydrateMapData, type THydrateMapDataBundle } from '@mappedin/mappedin-js/mappedin-js/src/hydrate-map-data';
     export { disableText3DWorker } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/text3d';
     export { hydrateMapData, type THydrateMapDataBundle };
@@ -5126,10 +5199,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
         */
     export const show3dMapGeojson: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
     export { parseMVF, unzipMVF, enableTestMode, preloadFont, MAPPEDIN_COLORS, ANIMATION_TWEENS };
-    export type { MapData, MapViewState, GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor, TEvents, TMapDataEvents, TStateChangedInternalPayload, TEventPayload, TFloorChangeReason, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TSearchOptions, TGetMapDataSharedOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, EnvMapOptions, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, OperationHours, SiblingGroup, LocationState, AddText3DOptions, InitializeText3DState, InitializeModelState, Interpolation, LabelAppearance, ColorString, InterpolateOn, };
+    export type { MapData, MapViewState, GeolocationPositionExtended, TBlueDotPositionUpdateWithFloor, TBlueDotPositionProcessor, TBlueDotState, TEvents, TMapDataEvents, TStateChangedInternalPayload, TEventPayload, TFloorChangeReason, TClickPayload, THoverPayload, TShow3DMapOptions, TGetMapDataOptions, TGetMapDataWithAccessTokenOptions, TGetMapDataWithCredentialsOptions, TSearchOptions, TGetMapDataSharedOptions, TAntialiasingOptions, TMVF, PaintStyle, LineStyle, EnvMapOptions, Shading, TMVFStyleCollection, TMVFStyle, TMVFLineStringStyle, TMVFPolygonStyle, TMVFPointStyle, Environment, InsetPadding, InsetPaddingOption, OperationHours, SiblingGroup, LocationState, AddText3DOptions, InitializeText3DState, InitializeModelState, Interpolation, LabelAppearance, ColorString, InterpolateOn, };
     export { MapView } from '@mappedin/mappedin-js/mappedin-js/src/map-view';
     export type * from 'geojson';
-    export type { TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TAddMarkerOptions, TAddPathOptions, TAddLabelOptions, TAddModelOptions, TAddModel, TAddImageOptions, TGetDirectionsOptions, TCollisionRankingTier, TMarkerPlacement, TDirectionInstruction, TDirectionInstructionAction, TFocusTarget, IFocusable, IAnchorable, TMapDataObjectTypes, TSetFloorOptions, TCancellablePromise, TAnimateStateResult, GlobalState, TActionType, TBearingType, TConnectionType, TMultiFloorViewOptions, MapViewElements, MapDataElements, MapElementsWithState, TGetState, TUpdateState, } from '@mappedin/mappedin-js/mappedin-js/src/types';
+    export type { TCameraAnimationOptions, TAnimationOptions, TFocusOnOptions, TEasingFunction, TCameraTarget, TNavigationTarget, TDirectionZone, TAddMarkerOptions, TAddPathOptions, TAddLabelOptions, TAddModelOptions, TAddModel, TAddImageOptions, TGetDirectionsOptions, TCollisionRankingTier, TMarkerPlacement, TDirectionInstruction, TDirectionInstructionAction, TFocusTarget, IFocusable, IAnchorable, TMapDataObjectTypes, TSetFloorOptions, TCancellablePromise, TAnimateStateResult, GlobalState, TActionType, TBearingType, TConnectionType, TMultiFloorViewOptions, TBlueDotOptions, TBlueDotPositionUpdate, TBlueDotUpdateOptions, MapViewElements, MapDataElements, MapElementsWithState, TGetState, TUpdateState, } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export type { TModelState, TModelUpdateState, TLabelState, TLabelUpdateState, TMarkerState, TMarkerUpdateState, TPathState, TPathUpdateState, TShapeState, TShapeUpdateState, TText3DState, TText3DUpdateState, TWallsState, TWallsUpdateState, TDoorsState, TDoorsUpdateState, TFacadeState, TFacadeUpdateState, TFloorState, TFloorUpdateState, TGeometryState, TGeometryUpdateState, TImage3DState as TImageState, TImage3DUpdateState as TImageUpdateState, MapElementToGetState, MapElementToUpdateState, } from '@mappedin/mappedin-js/mappedin-js/src/states';
     export { WALLS, DOORS, ACTION_TYPE, BEARING_TYPE, CONNECTION_TYPE } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export type { Label, Marker, Path, PathSegment, Shape, CameraTransform, Model, Image3DView, Text3DView, } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
@@ -7449,7 +7522,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/utils/data-creation' {
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location' {
     import type { EnterpriseLocation as MVFEnterpriseLocation, LocationState, OperationHours, SiblingGroup } from '@mappedin/mvf-v2';
-    import type { Coordinate, EnterpriseCategory, MapDataInternal, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Coordinate, EnterpriseCategory, MapDataInternal, PointOfInterest, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type Node from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node';
     import BaseMetaData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-metadata-object';
     import type { IFocusable } from '@mappedin/mappedin-js/mappedin-js/src/types';
@@ -7611,6 +7684,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location'
                 * Whether the location has been marked as hidden.
                 */
             hidden: boolean;
+            primaryCategory?: string | undefined;
             /**
                 * Checks if the provided instance is of type EnterpriseLocation.
                 *
@@ -7632,6 +7706,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location'
             get categories(): EnterpriseCategory[];
             get coordinates(): Coordinate[];
             get nodes(): Node[];
+            get points(): PointOfInterest[];
             get spaces(): Space[];
             /**
                 * Serializes the EnterpriseLocation data to JSON.
@@ -8370,9 +8445,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
             id?: string | undefined;
             interactive?: boolean | "pointer-events-auto" | undefined;
             rank?: number | "low" | "medium" | "high" | "always-visible" | undefined;
-            placement?: "top" | "bottom" | "left" | "right" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | ("top" | "bottom" | "left" | "right" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right")[] | undefined;
-            dynamicResize?: boolean | undefined;
             zIndex?: number | undefined;
+            placement?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center" | "top" | "bottom" | "left" | "right" | ("top-left" | "top-right" | "bottom-left" | "bottom-right" | "center" | "top" | "bottom" | "left" | "right")[] | undefined;
+            dynamicResize?: boolean | undefined;
             lowPriorityPin?: {
                     size?: number | undefined;
                     color?: string | undefined;
@@ -8382,9 +8457,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
             id?: string | undefined;
             interactive?: boolean | "pointer-events-auto" | undefined;
             rank?: number | "low" | "medium" | "high" | "always-visible" | undefined;
-            placement?: "top" | "bottom" | "left" | "right" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | ("top" | "bottom" | "left" | "right" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right")[] | undefined;
-            dynamicResize?: boolean | undefined;
             zIndex?: number | undefined;
+            placement?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center" | "top" | "bottom" | "left" | "right" | ("top-left" | "top-right" | "bottom-left" | "bottom-right" | "center" | "top" | "bottom" | "left" | "right")[] | undefined;
+            dynamicResize?: boolean | undefined;
             lowPriorityPin?: {
                     size?: number | undefined;
                     color?: string | undefined;
@@ -9046,13 +9121,13 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             iconFit: "fill" | "contain" | "cover";
             iconOverflow: "visible" | "hidden";
             iconVisibleAtZoomLevel: number;
+            icon?: string | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
             pinColor?: string | undefined;
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
     }, {
             maxWidth?: number | undefined;
             maxLines?: number | undefined;
@@ -9060,6 +9135,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             color?: string | undefined;
             margin?: number | undefined;
             outlineColor?: string | undefined;
+            icon?: string | undefined;
             textSize?: number | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
@@ -9067,7 +9143,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
             iconSize?: number | undefined;
             iconScale?: number | {
                     input: [number, ...number[]];
@@ -9205,13 +9280,13 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             iconFit: "fill" | "contain" | "cover";
             iconOverflow: "visible" | "hidden";
             iconVisibleAtZoomLevel: number;
+            icon?: string | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
             pinColor?: string | undefined;
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
     }, {
             maxWidth?: number | undefined;
             maxLines?: number | undefined;
@@ -9219,6 +9294,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             color?: string | undefined;
             margin?: number | undefined;
             outlineColor?: string | undefined;
+            icon?: string | undefined;
             textSize?: number | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
@@ -9226,7 +9302,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
             iconSize?: number | undefined;
             iconScale?: number | {
                     input: [number, ...number[]];
@@ -9271,6 +9346,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             color?: string | undefined;
             margin?: number | undefined;
             outlineColor?: string | undefined;
+            icon?: string | undefined;
             textSize?: number | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
@@ -9278,7 +9354,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
             iconSize?: number | undefined;
             iconScale?: number | {
                     input: [number, ...number[]];
@@ -9416,13 +9491,13 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             iconFit: "fill" | "contain" | "cover";
             iconOverflow: "visible" | "hidden";
             iconVisibleAtZoomLevel: number;
+            icon?: string | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
             pinColor?: string | undefined;
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
     }, {
             maxWidth?: number | undefined;
             maxLines?: number | undefined;
@@ -9430,6 +9505,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             color?: string | undefined;
             margin?: number | undefined;
             outlineColor?: string | undefined;
+            icon?: string | undefined;
             textSize?: number | undefined;
             textColor?: string | undefined;
             textOutlineColor?: string | undefined;
@@ -9437,7 +9513,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
             pinOutlineColor?: string | undefined;
             pinColorInactive?: string | undefined;
             pinOutlineColorInactive?: string | undefined;
-            icon?: string | undefined;
             iconSize?: number | undefined;
             iconScale?: number | {
                     input: [number, ...number[]];
@@ -9675,13 +9750,13 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     iconFit: "fill" | "contain" | "cover";
                     iconOverflow: "visible" | "hidden";
                     iconVisibleAtZoomLevel: number;
+                    icon?: string | undefined;
                     textColor?: string | undefined;
                     textOutlineColor?: string | undefined;
                     pinColor?: string | undefined;
                     pinOutlineColor?: string | undefined;
                     pinColorInactive?: string | undefined;
                     pinOutlineColorInactive?: string | undefined;
-                    icon?: string | undefined;
             }, {
                     maxWidth?: number | undefined;
                     maxLines?: number | undefined;
@@ -9689,6 +9764,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     color?: string | undefined;
                     margin?: number | undefined;
                     outlineColor?: string | undefined;
+                    icon?: string | undefined;
                     textSize?: number | undefined;
                     textColor?: string | undefined;
                     textOutlineColor?: string | undefined;
@@ -9696,7 +9772,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     pinOutlineColor?: string | undefined;
                     pinColorInactive?: string | undefined;
                     pinOutlineColorInactive?: string | undefined;
-                    icon?: string | undefined;
                     iconSize?: number | undefined;
                     iconScale?: number | {
                             input: [number, ...number[]];
@@ -9741,6 +9816,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     color?: string | undefined;
                     margin?: number | undefined;
                     outlineColor?: string | undefined;
+                    icon?: string | undefined;
                     textSize?: number | undefined;
                     textColor?: string | undefined;
                     textOutlineColor?: string | undefined;
@@ -9748,7 +9824,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     pinOutlineColor?: string | undefined;
                     pinColorInactive?: string | undefined;
                     pinOutlineColorInactive?: string | undefined;
-                    icon?: string | undefined;
                     iconSize?: number | undefined;
                     iconScale?: number | {
                             input: [number, ...number[]];
@@ -9806,6 +9881,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     color?: string | undefined;
                     margin?: number | undefined;
                     outlineColor?: string | undefined;
+                    icon?: string | undefined;
                     textSize?: number | undefined;
                     textColor?: string | undefined;
                     textOutlineColor?: string | undefined;
@@ -9813,7 +9889,6 @@ declare module '@mappedin/mappedin-js/geojson/src/components/label-utils' {
                     pinOutlineColor?: string | undefined;
                     pinColorInactive?: string | undefined;
                     pinOutlineColorInactive?: string | undefined;
-                    icon?: string | undefined;
                     iconSize?: number | undefined;
                     iconScale?: number | {
                             input: [number, ...number[]];
@@ -10583,6 +10658,18 @@ declare module '@mappedin/mappedin-js/geojson/src/components/mesh' {
                 * Bevel configuration for extruded shapes.
                 */
             bevel?: BevelState;
+            /**
+                * Whether the geometry has a border
+                */
+            borderVisible: boolean;
+            /**
+                * The color of the border
+                */
+            borderColor?: string;
+            /**
+                * The width of the border
+                */
+            borderWidth?: number;
     };
     export class MeshComponent {
             #private;
@@ -11027,7 +11114,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
     import { ExporterSystem } from '@mappedin/mappedin-js/geojson/src/systems/exporter';
     import type { LabelState } from '@mappedin/mappedin-js/geojson/src/components/label';
     import type { AddLabelOptionsInternal } from '@mappedin/mappedin-js/geojson/src/components/label-utils';
-    import type { LineStyle, PaintStyle, RendererCoreOptions, Position, ModelProperties, EntityState, EntityId, MapEvent, MapEventPayload, RendererState, EntityTypes, EnvMapOptions } from '@mappedin/mappedin-js/geojson/src/types';
+    import type { LineStyle, PaintStyle, RendererCoreOptions, Position, ModelProperties, EntityState, EntityId, MapEvent, MapEventPayload, RendererState, EntityTypes, EnvMapOptions, InsetPadding } from '@mappedin/mappedin-js/geojson/src/types';
     import { MeshCreationAndOptimizationSystem } from '@mappedin/mappedin-js/geojson/src/systems/mesh-creation-and-optimization/system';
     import { DOMVisibilitySystem } from '@mappedin/mappedin-js/geojson/src/systems/dom-visiblity/system';
     import { TwoDProjectionSystem } from '@mappedin/mappedin-js/geojson/src/systems/2d-projection/system';
@@ -11066,6 +11153,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
     import type { FloatingFloorTextProperties } from '@mappedin/mvf-v2';
     import { GeometryDisposalSystem } from '@mappedin/mappedin-js/geojson/src/systems/geometry-disposal/system';
     import type { LiteralUnion } from 'type-fest';
+    import { BorderSystem } from '@mappedin/mappedin-js/geojson/src/systems/border/system';
     export type * from '@mappedin/mappedin-js/geojson/src/types';
     export const raycaster: Raycaster;
     /**
@@ -11108,6 +11196,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             text3DSystem: Text3DSystem;
             occlusion2DSystem: Occlusion2DSystem;
             geometryDisposalSystem: GeometryDisposalSystem;
+            borderSystem: BorderSystem;
     };
     export type MapViewState = {
             readonly type: 'map-view';
@@ -11360,6 +11449,18 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
                     id: EntityState['id'];
                     type: EntityState['type'];
             } | string | EntityState): boolean;
+            /**
+                * Return a list of Geometry2D IDs currently rendered on screen.
+                *
+                * @param options - The options to query.
+                * @param options.screenOffsets - Optional offsets to account for on the edges of the screen.
+                * @param options.fullyContains - Whether to exclude entities that intersect with the screen edges after accounting for offsets.
+                * @returns A list of IDs.
+                */
+            queryGeometry2DInView(options?: {
+                    screenOffsets?: Partial<InsetPadding>;
+                    fullyContains?: boolean;
+            }): string[];
             /**
                 * Perform a render of the scene. This is called internally when something changes, but can be called when adding external models
                 * The render happens in an animation frame, not matter how frequently it is called
@@ -11739,9 +11840,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
             content: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-            color: string;
             visible: boolean;
-            type: "text3d";
+            color: string;
             flipToFaceCamera: boolean;
             fontSize: number;
             margin: number | [number, number, number, number];
@@ -11755,6 +11855,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             strokeOpacity: number;
             strokeColor: string;
             fillOpacity: number;
+            type: "text3d";
             id: string | number;
             position: [number, number, number];
             content: string;
@@ -11763,9 +11864,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             maxHeight?: number | undefined;
             hoverColor?: string | undefined;
     }, {
-            color: string;
             visible: boolean;
-            type: "text3d";
+            color: string;
             flipToFaceCamera: boolean;
             fontSize: number;
             margin: number | [number, number, number, number];
@@ -11779,6 +11879,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             strokeOpacity: number;
             strokeColor: string;
             fillOpacity: number;
+            type: "text3d";
             id: string | number;
             position: [number, number, number];
             content: string;
@@ -11817,8 +11918,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             content: z.ZodOptional<z.ZodString>;
     }, "type" | "id">, "strict", z.ZodTypeAny, {
             maxWidth?: number | undefined;
-            color?: string | undefined;
             visible?: boolean | undefined;
+            color?: string | undefined;
             flipToFaceCamera?: boolean | undefined;
             font?: string | undefined;
             fontSize?: number | undefined;
@@ -11839,8 +11940,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             content?: string | undefined;
     }, {
             maxWidth?: number | undefined;
-            color?: string | undefined;
             visible?: boolean | undefined;
+            color?: string | undefined;
             flipToFaceCamera?: boolean | undefined;
             font?: string | undefined;
             fontSize?: number | undefined;
@@ -11891,8 +11992,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
             content: z.ZodOptional<z.ZodString>;
     }, "type" | "id">, "maxWidth" | "margin" | "maxHeight" | "position" | "content">, "strict", z.ZodTypeAny, {
-            color?: string | undefined;
             visible?: boolean | undefined;
+            color?: string | undefined;
             flipToFaceCamera?: boolean | undefined;
             font?: string | undefined;
             fontSize?: number | undefined;
@@ -11908,8 +12009,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             fillOpacity?: number | undefined;
             hoverColor?: string | undefined;
     }, {
-            color?: string | undefined;
             visible?: boolean | undefined;
+            color?: string | undefined;
             flipToFaceCamera?: boolean | undefined;
             font?: string | undefined;
             fontSize?: number | undefined;
@@ -11960,8 +12061,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
                     content: z.ZodOptional<z.ZodString>;
             }, "type" | "id">, "strict", z.ZodTypeAny, {
                     maxWidth?: number | undefined;
-                    color?: string | undefined;
                     visible?: boolean | undefined;
+                    color?: string | undefined;
                     flipToFaceCamera?: boolean | undefined;
                     font?: string | undefined;
                     fontSize?: number | undefined;
@@ -11982,8 +12083,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
                     content?: string | undefined;
             }, {
                     maxWidth?: number | undefined;
-                    color?: string | undefined;
                     visible?: boolean | undefined;
+                    color?: string | undefined;
                     flipToFaceCamera?: boolean | undefined;
                     font?: string | undefined;
                     fontSize?: number | undefined;
@@ -12008,8 +12109,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             parentId?: string | undefined;
             appearance?: {
                     maxWidth?: number | undefined;
-                    color?: string | undefined;
                     visible?: boolean | undefined;
+                    color?: string | undefined;
                     flipToFaceCamera?: boolean | undefined;
                     font?: string | undefined;
                     fontSize?: number | undefined;
@@ -12033,8 +12134,8 @@ declare module '@mappedin/mappedin-js/geojson/src/components/text3d' {
             parentId?: string | undefined;
             appearance?: {
                     maxWidth?: number | undefined;
-                    color?: string | undefined;
                     visible?: boolean | undefined;
+                    color?: string | undefined;
                     flipToFaceCamera?: boolean | undefined;
                     font?: string | undefined;
                     fontSize?: number | undefined;
@@ -12118,6 +12219,7 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/utils' {
     export function updateFocusable(entity: Geometry3D | GroupContainerObject3D, update?: boolean): boolean;
     export function updateIndividualGeometryRenderOrder(entity: Geometry3D, update?: number): boolean;
     export function updateSide(geometry: Geometry3DTypes | GeometryGroupObject3D, state: RendererState, update?: StyleComponent['side']): void;
+    export function updateBorder(entity: Geometry3D, update?: Partial<GeometryState>): void;
     export function handlePathUpdate(geometry: Geometry3DTypes, state: RendererState, update: PathUpdateState): void;
     export function pickPathOptions(update: PathUpdateState): Partial<PathUpdateState>;
     export function getEntityId(entityOrEntityId: Geometry2D | Geometry3DTypes | Geometry2DObject3D | Geometry3DObject3D | GeometryGroupObject3D | GroupContainerObject3D | string | number): any;
@@ -14212,6 +14314,18 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
                 * @default false
                 */
             flipImageToFaceCamera: z.ZodDefault<z.ZodBoolean>;
+            /**
+                * Whether the geometry has a border
+                */
+            borderVisible: z.ZodDefault<z.ZodBoolean>;
+            /**
+                * The color of the border. borderVisible must be true for this to take effect.
+                */
+            borderColor: z.ZodOptional<z.ZodString>;
+            /**
+                * The width of the border. borderVisible must be true for this to take effect.
+                */
+            borderWidth: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
             type: "geometry";
             height: number;
@@ -14221,6 +14335,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             flipImageToFaceCamera: boolean;
             visible: boolean;
             interactive: boolean;
+            borderVisible: boolean;
             topTexture?: {
                     url: string;
             } | undefined;
@@ -14229,6 +14344,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             } | undefined;
             topColor?: string | undefined;
             hoverColor?: string | undefined;
+            borderColor?: string | undefined;
+            borderWidth?: number | undefined;
     }, {
             type?: "geometry" | undefined;
             height?: number | undefined;
@@ -14246,6 +14363,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             interactive?: boolean | undefined;
             topColor?: string | undefined;
             hoverColor?: string | undefined;
+            borderVisible?: boolean | undefined;
+            borderColor?: string | undefined;
+            borderWidth?: number | undefined;
     }>;
     const geometryStateSchemaPartial: z.ZodObject<{
             type: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"geometry">>>;
@@ -14272,6 +14392,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
                     url: string;
             }>>>;
             flipImageToFaceCamera: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            borderVisible: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            borderColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            borderWidth: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     }, "strip", z.ZodTypeAny, {
             type?: "geometry" | undefined;
             height?: number | undefined;
@@ -14289,6 +14412,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             interactive?: boolean | undefined;
             topColor?: string | undefined;
             hoverColor?: string | undefined;
+            borderVisible?: boolean | undefined;
+            borderColor?: string | undefined;
+            borderWidth?: number | undefined;
     }, {
             type?: "geometry" | undefined;
             height?: number | undefined;
@@ -14306,6 +14432,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             interactive?: boolean | undefined;
             topColor?: string | undefined;
             hoverColor?: string | undefined;
+            borderVisible?: boolean | undefined;
+            borderColor?: string | undefined;
+            borderWidth?: number | undefined;
     }>;
     const geometryStateSchemaStrict: z.ZodObject<{
             type: z.ZodDefault<z.ZodLiteral<"geometry">>;
@@ -14372,6 +14501,18 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
                 * @default false
                 */
             flipImageToFaceCamera: z.ZodDefault<z.ZodBoolean>;
+            /**
+                * Whether the geometry has a border
+                */
+            borderVisible: z.ZodDefault<z.ZodBoolean>;
+            /**
+                * The color of the border. borderVisible must be true for this to take effect.
+                */
+            borderColor: z.ZodOptional<z.ZodString>;
+            /**
+                * The width of the border. borderVisible must be true for this to take effect.
+                */
+            borderWidth: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
             type: "geometry";
             height: number;
@@ -14381,6 +14522,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             flipImageToFaceCamera: boolean;
             visible: boolean;
             interactive: boolean;
+            borderVisible: boolean;
             topTexture?: {
                     url: string;
             } | undefined;
@@ -14389,6 +14531,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             } | undefined;
             topColor?: string | undefined;
             hoverColor?: string | undefined;
+            borderColor?: string | undefined;
+            borderWidth?: number | undefined;
     }, {
             type?: "geometry" | undefined;
             height?: number | undefined;
@@ -14406,6 +14550,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/geometry-state' {
             interactive?: boolean | undefined;
             topColor?: string | undefined;
             hoverColor?: string | undefined;
+            borderVisible?: boolean | undefined;
+            borderColor?: string | undefined;
+            borderWidth?: number | undefined;
     }>;
     /**
         * Defines the state for geometry elements like {@link Space} when updated.
@@ -15024,7 +15171,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/state-utils' {
     import type { TWallsState, TWallsUpdateState } from '@mappedin/mappedin-js/mappedin-js/src/states/walls-state';
     import type { Label, Marker, Model, Path, PathSegment, Shape, Text3DView, Image3DView } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { DOORS, WALLS } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    import type { Door, Facade, Floor, MapObject, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { Area, Door, Facade, Floor, MapObject, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { ReadonlyDeep } from 'type-fest';
     type ParseStateOptions = {
             warn?: boolean;
@@ -15066,6 +15213,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/state-utils' {
             [Floor.__type]: ReadonlyDeep<TFloorState>;
             [Facade.__type]: ReadonlyDeep<TFacadeState>;
             [Door.__type]: ReadonlyDeep<TDoorsState>;
+            [Area.__type]: ReadonlyDeep<TGeometryState>;
             [WALLS.Exterior]: ReadonlyDeep<TWallsState>;
             [WALLS.Interior]: ReadonlyDeep<TWallsState>;
             [DOORS.Exterior]: ReadonlyDeep<TDoorsState>;
@@ -15088,6 +15236,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/states/state-utils' {
             [Floor.__type]: TFloorUpdateState;
             [Facade.__type]: TFacadeUpdateState;
             [Door.__type]: TDoorsUpdateState;
+            [Area.__type]: TGeometryUpdateState;
             [WALLS.Exterior]: TWallsUpdateState;
             [WALLS.Interior]: TWallsUpdateState;
             [DOORS.Exterior]: TDoorsUpdateState;
@@ -15825,11 +15974,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/label' {
             /**
                 * @internal
                 */
-            static readonly __type = "Label";
+            static readonly __type = "label";
             /**
                 * @internal
                 */
-            readonly __type = "Label";
+            readonly __type = "label";
             /**
                 * Checks if the provided instance is of type Label.
                 *
@@ -15863,7 +16012,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/marker' {
             /**
                 * @internal
                 */
-            static readonly __type = "Marker";
+            static readonly __type = "marker";
             get target(): IAnchorable;
             get coordinate(): import("..").Coordinate;
             toJSON(): {
@@ -15875,7 +16024,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/marker' {
             /**
                 * @internal
                 */
-            readonly __type = "Marker";
+            readonly __type = "marker";
             /**
                 * The HTML element that represents the marker.
                 */
@@ -15914,11 +16063,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/image3d'
             /**
                 * @internal
                 */
-            static readonly __type = "Image3D";
+            static readonly __type = "image-3d";
             /**
                 * @internal
                 */
-            readonly __type = "Image3D";
+            readonly __type = "image-3d";
             /**
                 * Checks if the provided instance is of type Image"
                 *
@@ -15971,11 +16120,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/model' {
             /**
                 * @internal
                 */
-            static readonly __type = "Model";
+            static readonly __type = "model";
             /**
                 * @internal
                 */
-            readonly __type = "Model";
+            readonly __type = "model";
             get target(): IAnchorable;
             /**
                 * Checks if the provided instance is of type Model
@@ -16016,11 +16165,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/path' {
             /**
                 * @internal
                 */
-            static readonly __type = "PathSegment";
+            static readonly __type = "path-segment";
             /**
                 * @internal
                 */
-            readonly __type = "PathSegment";
+            readonly __type = "path-segment";
             /**
                 * Checks if the provided instance is a PathSegment.
                 */
@@ -16056,11 +16205,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/path' {
             /**
                 * @internal
                 */
-            static readonly __type = "Path";
+            static readonly __type = "path";
             /**
                 * @internal
                 */
-            readonly __type = "Path";
+            readonly __type = "path";
             /**
                 * Checks if the provided instance is a Path.
                 *
@@ -16101,11 +16250,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/shape' {
             /**
                 * @internal
                 */
-            static readonly __type = "Shape";
+            static readonly __type = "shape";
             /**
                 * @internal
                 */
-            readonly __type = "Shape";
+            readonly __type = "shape";
             /**
                 * Checks if the provided instance is of type Shape.
                 *
@@ -16143,8 +16292,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/text3d' {
             /**
                 * @internal
                 */
-            static readonly __type = "Text3D";
-            readonly __type = "Text3D";
+            static readonly __type = "text-3d";
+            readonly __type = "text-3d";
             /**
                 * Checks if the provided instance is of type Text3D
                 *
@@ -16617,6 +16766,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/labels' {
             constructor({ currentMapGetter }: {
                     currentMapGetter: CurrentMapGetter;
             });
+            getAll(): Label[];
             /**
                 * @internal
                 */
@@ -16762,6 +16912,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers' {
             constructor({ currentMapGetter }: {
                     currentMapGetter: CurrentMapGetter;
             });
+            getAll(): Marker[];
             /**
                 * @internal
                 */
@@ -18376,12 +18527,14 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/geometry3d' {
     import type { ModelStyleComponnet, Text3DStyleComponent } from '@mappedin/mappedin-js/geojson/src/components/styles';
     import type { OutlineComponent } from '@mappedin/mappedin-js/geojson/src/components/outline';
     import type { FocusableComponent } from '@mappedin/mappedin-js/geojson/src/components/focusable';
+    import type { BorderComponent } from '@mappedin/mappedin-js/geojson/src/components/border';
     export enum Geometry3DComponents {
             Mesh = 0,
             Style = 1,
             Interaction = 2,
             Outline = 3,
-            Focusable = 4
+            Focusable = 4,
+            Border = 5
     }
     type Geometry3DObjectTypes = 'geometry' | 'path' | 'model' | 'custom-geometry' | 'image' | 'text3d';
     export class Geometry3DObject3D extends Object3D {
@@ -18410,9 +18563,9 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/geometry3d' {
     }
     export type MeshComponentTypes = MeshComponent | PathComponent | ModelComponent | CustomGeometryComponent | Text3DComponent | ImageComponent;
     type MappedComponentType<M> = M extends MeshComponent ? 'geometry' : M extends PathComponent ? 'path' : M extends ModelComponent ? 'model' : M extends CustomGeometryComponent ? 'custom-geometry' : M extends ImageComponent ? 'image' : M extends Text3DComponent ? 'text3d' : never;
-    export class Geometry3D<M extends MeshComponentTypes = MeshComponent, S extends StyleComponent | Text3DStyleComponent | ModelStyleComponnet = StyleComponent, I extends InteractionComponent = InteractionComponent, T extends MappedComponentType<M> = MappedComponentType<M>, O extends OutlineComponent | undefined = OutlineComponent | undefined, F extends FocusableComponent | undefined = FocusableComponent | undefined> {
+    export class Geometry3D<M extends MeshComponentTypes = MeshComponent, S extends StyleComponent | Text3DStyleComponent | ModelStyleComponnet = StyleComponent, I extends InteractionComponent = InteractionComponent, T extends MappedComponentType<M> = MappedComponentType<M>, O extends OutlineComponent | undefined = OutlineComponent | undefined, F extends FocusableComponent | undefined = FocusableComponent | undefined, B extends BorderComponent | undefined = BorderComponent | undefined> {
             id: string | number;
-            components: [M, S, I?, O?, F?];
+            components: [M, S, I?, O?, F?, B?];
             /**
                 * Parent geometry group ID
                 */
@@ -18958,6 +19111,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/styles/style' {
         renderOrder?: number;
         shading?: Shading;
         bevel?: BevelState;
+        borderVisible: boolean;
+        borderColor?: string;
+        borderWidth?: number;
     };
     export class StyleComponent implements Style {
         #private;
@@ -18987,6 +19143,9 @@ declare module '@mappedin/mappedin-js/geojson/src/components/styles/style' {
         renderOrder: number;
         shading?: Shading;
         bevel?: BevelState;
+        borderVisible: boolean;
+        borderColor: string;
+        borderWidth: number;
         constructor(style?: Partial<Style>);
     }
     export {};
@@ -19142,7 +19301,7 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/mesh-creation-and-opti
         getGLTFLoader(): Promise<GLTFLoader>;
         createEntityFromFeature(id: string | number, feature: Feature<Polygon | LineString | MultiPolygon, MeshComponentProperties>, style?: (LineStyle | PaintStyle) & {
             focusable?: boolean;
-        }): Geometry3D<MeshComponent, StyleComponent, import("../../components/interaction").InteractionComponent, "geometry", OutlineComponent | undefined, FocusableComponent | undefined>;
+        }): Geometry3D<MeshComponent, StyleComponent, import("../../components/interaction").InteractionComponent, "geometry", OutlineComponent | undefined, FocusableComponent | undefined, import("../../components/border").BorderComponent | undefined>;
         createModelFromFeature(id: string | number, feature: Feature<Point, ModelProperties>, style?: Partial<ModelStyle>): ModelGeometry3D;
         populateEntityMesh(entity: Geometry3D, geometry: BufferGeometry): void;
         populateModelGroup(entities: Set<string | number>, url: string, tree: GeometryGroupObject3D): Promise<Geometry3DObject3D>;
@@ -19678,6 +19837,22 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/geometry-disposal/syst
     }
 }
 
+declare module '@mappedin/mappedin-js/geojson/src/systems/border/system' {
+    import type { RendererCore } from '@mappedin/mappedin-js/geojson/src';
+    import type { RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
+    export const DEFAULT_BORDER_COLOR = "gray";
+    export const DEFAULT_BORDER_WIDTH = 0.1;
+    export const XRAY_OPACITY = 0.25;
+    export class BorderSystem {
+        rendererState: RendererState;
+        dirty: boolean;
+        convertTo3DMapPosition: RendererCore['convertTo3DMapPosition'];
+        constructor(rendererState: RendererState, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition']);
+        update(): void;
+        destroy(): void;
+    }
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/utils' {
     import { type MercatorCoordinate, type CustomLayerInterface } from '@mappedin/mappedin-js/packages/outdoor-context-v5';
     import type { Object3D, PerspectiveCamera, Camera as THREECamera } from 'three';
@@ -19685,7 +19860,7 @@ declare module '@mappedin/mappedin-js/geojson/src/utils' {
     import { GroupContainerObject3D } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
     import type { Geometry2D } from '@mappedin/mappedin-js/geojson/src/entities/geometry2d';
     import type { Geometry3DTypes } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
-    import type { Position, RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
+    import type { InsetPadding, Position, RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
     import { GeometryGroupObject3D } from '@mappedin/mappedin-js/geojson/src/entities/geometry-group';
     export { isFiniteBox } from '@packages/internal/common';
     import type { Position as GeoJSONPosition } from 'geojson';
@@ -19785,6 +19960,10 @@ declare module '@mappedin/mappedin-js/geojson/src/utils' {
             Geometry = 0,
             ImageMesh = 1
     }
+    /**
+        * Given a screen element and a set of screen offsets, return the x, y, w, h of the rectangle that represents the area contained within the screen offsets.
+        */
+    export function rectFromScreenOffsets(el: HTMLElement, screenOffsets?: Partial<InsetPadding>): [number, number, number, number];
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/components/geometry-group-style' {
@@ -20339,7 +20518,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions/dir
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/directions/utils' {
-    import { DirectionsCollection } from '@packages/internal/geojson-navigator';
+    import type { DirectionsCollection } from '@packages/internal/geojson-navigator';
     import type { MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type { TNavigationTarget } from '@mappedin/mappedin-js/mappedin-js/src/types';
     export function getNodesFromTargetSync(target: TNavigationTarget, mapData: MapDataInternal): string[];
@@ -20533,6 +20712,7 @@ declare module '@mappedin/mappedin-js/packages/common/random-id' {
       */
     export const randomId: () => string;
     export function cyrb53(str: string, seed?: number): number;
+    export function shortId(): string;
 }
 
 declare module '@mappedin/mappedin-js/packages/common/storage' {
@@ -20741,6 +20921,24 @@ declare module '@mappedin/mappedin-js/geojson/src/components/outline' {
     export {};
 }
 
+declare module '@mappedin/mappedin-js/geojson/src/components/border' {
+    import type { Object3D } from 'three';
+    type Border = {
+        dirty: boolean;
+        visible: boolean;
+        mesh?: Object3D;
+        needsRebuild: boolean;
+    };
+    export class BorderComponent implements Border {
+        dirty: boolean;
+        needsRebuild: boolean;
+        set visible(visible: boolean);
+        get visible(): boolean;
+        mesh?: Object3D;
+    }
+    export {};
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/services/text3d/utils' {
     import type { Text } from 'troika-three-text';
     /**
@@ -29373,7 +29571,7 @@ declare module '@mappedin/mappedin-js/geojson/src/utils/ecs' {
     import type { EntityId, EntityState, RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
     import { Box3, Vector3 } from 'three';
     import type RendererCore from '@mappedin/mappedin-js/geojson/src/renderer';
-    export function getGeometryByGeometryId(state: RendererState, geometryOrGeometryId?: string | number | Record<string, any>): Geometry3DTypes | GeometryGroupObject3D | GroupContainerObject3D | Geometry2D | undefined;
+    export function getGeometryByGeometryId(state: RendererState, geometryOrGeometryId?: string | number | Record<string, any>): Geometry2D | GroupContainerObject3D | GeometryGroupObject3D | Geometry3DTypes | undefined;
     export function getVerticesOfEntity(core: RendererCore, geometryOrGeometryId?: string | number | EntityId<EntityState>, vertices?: Vector3[], bounds?: Box3, zOffset?: number): Vector3[];
 }