@mappedin/mappedin-js 6.0.1-beta.0 → 6.0.1-beta.1

package/lib/esm/index.d.ts

@@ -281,7 +281,7 @@ declare module '@mappedin/mappedin-js' {
         * Asynchronously retrieves map data ({@link MapData}) based on user-provided options.
         *
         * @experimental
-        * @param userOptions Options provided by the user to retrieve map data.
+        * @param userOptions {TGetMapDataOptions} Options provided by the user to retrieve map data.
         * @returns {Promise<MapData>} Promise resolving to the MapData.
         * @example
         * const data = await getMapData({ key: 'api_key', secret: 'api_secret', mapId: 'id' });
@@ -318,11 +318,11 @@ declare module '@mappedin/mappedin-js' {
     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, } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    export type { Label, Marker, Path, CustomGeometry, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    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';
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export { Coordinate, Annotation, Connection, Door, Floor, MapObject, PointOfInterest, Space, Image, Hyperlink, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Outdoor } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
+    export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
     export { analytics };
 }
 
@@ -700,7 +700,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
-    import type { RendererCore } from '@mappedin/core-sdk';
+    import type { RendererCore, WatermarkOptions } from '@mappedin/core-sdk';
     import { PubSub } from '@packages/internal/common';
     import { type TEvents, type TShow3DMapOptions } from '@mappedin/mappedin-js/mappedin-js/src';
     import type { Navigation } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
@@ -711,7 +711,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
     import type { TGetDirectionsOptions, TGetState, TNavigationTarget, TUpdateState, TUpdateStates } 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 { CustomGeometries } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/custom-geometries';
+    import type { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
     export class MapView extends PubSub<TEvents> {
             #private;
             /**
@@ -755,7 +755,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
             /**
                 * Controls custom GeoJSON geometry on the map
                 */
-            CustomGeometries: CustomGeometries;
+            Shapes: Shapes;
             /**
                 * Controls for the outdoor map.
                 */
@@ -823,6 +823,13 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
                 * The current floor ({@link Floor}) of the map.
                 */
             get currentFloor(): Floor;
+            /**
+                * Updates the watermark on the map.
+                *
+                * @param options {WatermarkOptions}
+                * @hidden
+                */
+            updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
             getState<T extends Space | MapObject | Label | Marker | string>(target: T): TGetState<T> | undefined;
             setHoverColor(c: string): void;
             getHoverColor(): string | undefined;
@@ -926,13 +933,14 @@ declare module '@mappedin/mappedin-js/geojson/src' {
     import type { Position } from '@mappedin/mappedin-js/geojson/src/types/geometry';
     import type { InsetPadding, RendererCoreOptions, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload } from '@mappedin/mappedin-js/geojson/src/types';
     import type { GeometryState } from '@mappedin/mappedin-js/geojson/src/components/mesh';
-    import type { CustomGeometryState, CustomGeometryBuilder } from '@mappedin/mappedin-js/geojson/src/components/custom';
+    import type { ShapeState, CustomGeometryBuilder } from '@mappedin/mappedin-js/geojson/src/components/custom';
     import type { ModelState } from '@mappedin/mappedin-js/geojson/src/components/model';
     import RendererCore, { type MapViewState } from '@mappedin/mappedin-js/geojson/src/renderer';
     import type { Camera, AnimateToOptions, FocusOnOptions, EasingCurve } from '@mappedin/mappedin-js/geojson/src/camera';
     import { mountSceneGraphVisualizer } from '@mappedin/mappedin-js/geojson/examples/src/utils/scene-graph-visualizer';
     import '../../packages/outdoor-context-v4/css/maplibre-gl.css';
     import type { CollisionRankingTier } from '@mappedin/mappedin-js/geojson/src/utils/collision-ranking-tier';
+    export { Navigator } from '@mappedin/mappedin-js/packages/geojson-navigator';
     export { interpolate, debounce } from '@mappedin/mappedin-js/geojson/src/utils';
     export { MAPPEDIN_LAYER_ID } from '@mappedin/mappedin-js/geojson/src/utils/constants';
     /**
@@ -947,7 +955,7 @@ declare module '@mappedin/mappedin-js/geojson/src' {
     export type { GLTFExportOptions } from '@mappedin/mappedin-js/geojson/src/systems/exporter';
     export type { AttributionControlOptions, AttributionPosition } from '@mappedin/mappedin-js/geojson/src/systems/html-controls/system';
     export { ATTRIBUTION_POSITIONS } from '@mappedin/mappedin-js/geojson/src/systems/html-controls/system';
-    export type { AddPathOptions, AddMarkerOptions, AddLabelOptions, AnimateToOptions, FocusOnOptions, MapViewState, MarkerState, PathState, GroupContainerState, GeometryGroupState, CustomGeometryState, CustomGeometryBuilder, LabelState, GeometryState, ModelState, EasingCurve, Camera, InsetPadding, Position, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload, CollisionRankingTier, LabelAppearance, RendererCore, };
+    export type { AddPathOptions, AddMarkerOptions, AddLabelOptions, AnimateToOptions, FocusOnOptions, MapViewState, MarkerState, PathState, GroupContainerState, GeometryGroupState, ShapeState, CustomGeometryBuilder, LabelState, GeometryState, ModelState, EasingCurve, Camera, InsetPadding, Position, ClickPayload, HoverPayload, CameraPayload, MapEvent, MapEventPayload, CollisionRankingTier, LabelAppearance, RendererCore, };
     export function createRenderer(container: HTMLElement, options?: RendererCoreOptions & {
         [key: string]: any;
     }): Promise<RendererCore>;
@@ -1297,18 +1305,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/types' {
                 * @defaultValue 0.4
                 */
             farRadius?: number;
-            /**
-                * Zoom level in meters where the path size is `nearRadius`.
-                *
-                * @defaultValue 5
-                */
-            nearZoom?: number;
-            /**
-                * Zoom level in meters where the path size is `farRadius`.
-                *
-                * @defaultValue 1000
-                */
-            farZoom?: number;
             /**
                 * Duration of path drawing in milliseconds.
                 *
@@ -1676,7 +1672,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects' {
     export { Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/model';
     export { Path } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/path';
     export { CameraTransform } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/camera-transform';
-    export { CustomGeometry } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/custom-geometry';
+    export { Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/shape';
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/navigation' {
@@ -1776,6 +1772,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson' {
     export { Camera } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera';
     export { Labels } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/labels';
     export { Markers } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/markers';
+    export { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
     export { Models } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/models';
     export { Paths } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/paths';
     export { Exporter } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/exporter';
@@ -3029,7 +3026,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
         * Asynchronously retrieves map data ({@link MapData}) based on user-provided options.
         *
         * @experimental
-        * @param userOptions Options provided by the user to retrieve map data.
+        * @param userOptions {TGetMapDataOptions} Options provided by the user to retrieve map data.
         * @returns {Promise<MapData>} Promise resolving to the MapData.
         * @example
         * const data = await getMapData({ key: 'api_key', secret: 'api_secret', mapId: 'id' });
@@ -3066,11 +3063,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     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, } from '@mappedin/mappedin-js/mappedin-js/src/types';
-    export type { Label, Marker, Path, CustomGeometry, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    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';
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export { Coordinate, Annotation, Connection, Door, Floor, MapObject, PointOfInterest, Space, Image, Hyperlink, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Outdoor } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
+    export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
     export { analytics };
 }
 
@@ -3101,13 +3098,13 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-
     }
 }
 
-declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/custom-geometries' {
+declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes' {
     import type { GeojsonApiMapObject } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object';
-    import { CustomGeometry } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    import { Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     import type { FeatureCollection, LineString, MultiPolygon, Polygon } from 'geojson';
     import type { LineStyle, PaintStyle } from '@mappedin/core-sdk';
     import type { Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export class CustomGeometries {
+    export class Shapes {
             #private;
             /**
                 * @internal
@@ -3122,31 +3119,31 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/custom-geometr
             /**
                 * @internal
                 */
-            getById(id: string): CustomGeometry | undefined;
+            getById(id: string): Shape | undefined;
             /**
-                * Adds a custom GeoJSON geometry ({@link CustomGeometry}) to the map.
+                * Adds a custom GeoJSON geometry ({@link Shape}) to the map.
                 *
                 * @param geometry a valid GeoJSON feature collection
                 * @param style
                 * @param floor Floor to add the geometry to
-                * @returns {CustomGeometry | undefined} The created CustomGeometry, or undefined if creation failed.
+                * @returns {Shape | undefined} The created shapes, or undefined if creation failed.
                 * @example
                 *
-                * map.CustomGeometries.add(polygons, { color: 'red' }, mapView.currentFloor);
+                * map.Shapes.add(polygons, { color: 'red' }, mapView.currentFloor);
                 */
-            add<T extends FeatureCollection<Polygon | MultiPolygon | LineString, any>>(geometry: T, style: T extends FeatureCollection<LineString, any> ? LineStyle : PaintStyle, floor?: Floor): CustomGeometry;
+            add<T extends FeatureCollection<Polygon | MultiPolygon | LineString, any>>(geometry: T, style: T extends FeatureCollection<LineString, any> ? LineStyle : PaintStyle, floor?: Floor): Shape;
             /**
-                * Removes a specific CustomGeometry ({@link CustomGeometry}) from the map.
-                * @param customGeometry The CustomGeometry to be removed.
+                * Removes a specific shapes ({@link Shape}) from the map.
+                * @param shapes The shapes to be removed.
                 * @example
-                * map.CustomGeometries.remove(geo);
+                * map.Shapes.remove(geo);
                 */
-            remove(customGeometry: CustomGeometry): void;
+            remove(shapes: Shape): void;
             /**
-                * Removes all Custom Geometries ({@link CustomGeometry}) from the map.
+                * Removes all Shapes ({@link Shape}) from the map.
                 *
                 * @example
-                * map.CustomGeometries.removeAll();
+                * map.Shapes.removeAll();
                 */
             removeAll(): string[];
     }
@@ -3874,11 +3871,11 @@ declare module '@mappedin/mappedin-js/geojson/src/types' {
     import type { ModelState } from '@mappedin/mappedin-js/geojson/src/components/model';
     import type { LabelState } from '@mappedin/mappedin-js/geojson/src/components/label';
     import type { MarkerState } from '@mappedin/mappedin-js/geojson/src/components/marker';
-    import type { CustomGeometryState } from '@mappedin/mappedin-js/geojson/src/components/custom';
+    import type { ShapeState } from '@mappedin/mappedin-js/geojson/src/components/custom';
     /**
         * The state of an entity, which can be a geometry, geometry group, group container, path, model, label, or marker.
         */
-    export type EntityState = GeometryState | GeometryGroupState | GroupContainerState | PathState | ModelState | LabelState | MarkerState | CustomGeometryState;
+    export type EntityState = GeometryState | GeometryGroupState | GroupContainerState | PathState | ModelState | LabelState | MarkerState | ShapeState;
     /**
         * A wrapper object that contains the ID and type of an entity. This is returned when adding entities to the scene, and can be used
         * to `getState` and `setState` of the entity.
@@ -4101,6 +4098,11 @@ declare module '@mappedin/mappedin-js/geojson/src/types' {
                 * Fired when the user stops interacting with the map.
                 */
             'user-interaction-end': undefined;
+            /**
+                * Fired when a geometry is in focus, meaning it occupies the area closest to the center of the screen. This will only be true for one geometry at a time.
+                * Geometries can be added to the focus listener via `mapView.setState(.., { focusable: true })`.
+                */
+            'geometry-in-focus': string | number | null;
     };
     /**
         * The payload of an event. See also {@link MapEvent}.
@@ -4111,7 +4113,7 @@ declare module '@mappedin/mappedin-js/geojson/src/types' {
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/components/mesh' {
-    import type { Texture, BufferGeometry, LineSegments } from 'three';
+    import type { Texture, BufferGeometry, LineSegments, Mesh } from 'three';
     import { BatchedMesh, Color, Vector3 } from 'three';
     import type { BatchedStandardMaterial } from '@mappedin/mappedin-js/geojson/src/systems/mesh-creation-and-optimization/batched-material';
     import type { Position } from '@mappedin/mappedin-js/geojson/src/types';
@@ -4167,10 +4169,15 @@ declare module '@mappedin/mappedin-js/geojson/src/components/mesh' {
                 * Whether the geometry is outlined with a 30% darkened color. This effect adds lines around the geometry to make it stand out.
                 */
             outline: boolean;
+            /**
+                * Whether the geometry should emit an event when focused on by the center of the camera
+                */
+            focusable: boolean;
     };
     export class MeshComponent {
             #private;
             mesh?: EntityBatchedMesh;
+            focusMesh?: Mesh;
             outline?: LineSegments;
             readonly type = "geometry";
             instanceIndex: number;
@@ -4181,6 +4188,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/mesh' {
             get visible(): boolean;
             set visible(visible: boolean);
             setOpacity(opacity: number): void;
+            focusable: boolean;
             color: Color;
             topColor: Color;
             setColor(color: string, topColor: string): void;
@@ -4209,7 +4217,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/custom' {
     /**
         * State representing a Custom Geometry
         */
-    export type CustomGeometryState = {
+    export type ShapeState = {
             readonly id: string;
             readonly type: 'custom-geometry';
             /**
@@ -4346,17 +4354,20 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
     import { GeometryGroupObject3D } from '@mappedin/mappedin-js/geojson/src/entities/entity-group';
     import { DOMResizeSystem } from '@mappedin/mappedin-js/geojson/src/systems/dom-resize/system';
     import { Camera } from '@mappedin/mappedin-js/geojson/src/camera';
-    import { WatermarkSystem } from '@mappedin/mappedin-js/geojson/src/systems/watermark/system';
+    import { type WatermarkOptions, WatermarkSystem } from '@mappedin/mappedin-js/geojson/src/systems/watermark/system';
     import { PanBoundsSystem } from '@mappedin/mappedin-js/geojson/src/systems/pan-bounds/system';
     import { HTMLControlsSystem } from '@mappedin/mappedin-js/geojson/src/systems/html-controls/system';
-    import { type CustomGeometryBuilder, type CustomGeometryState } from '@mappedin/mappedin-js/geojson/src/components/custom';
+    import { type CustomGeometryBuilder, type ShapeState } from '@mappedin/mappedin-js/geojson/src/components/custom';
     import { CustomGeometrySystem } from '@mappedin/mappedin-js/geojson/src/systems/custom-geometry/system';
     import { OutlineInterpolationSystem } from '@mappedin/mappedin-js/geojson/src/systems/outline-interpolation/system';
+    import { GeometryInFocusSystem } from '@mappedin/mappedin-js/geojson/src/systems/geometry-in-focus/system';
     import { OutdoorLayers } from '@mappedin/mappedin-js/geojson/src/systems/outdoor-layers/system';
     import { PathSystem } from '@mappedin/mappedin-js/geojson/src/systems/path';
     export type * from '@mappedin/mappedin-js/geojson/src/types';
     export const raycaster: Raycaster;
     export const DEFAULT_ZOOM_LEVEL = 18;
+    export const DEFAULT_MIN_ZOOM_LEVEL = 12;
+    export const DEFAULT_MAX_ZOOM_LEVEL = 22;
     export const DEFAULT_PITCH = 0;
     export const DEFAULT_BEARING = 0;
     /**
@@ -4382,6 +4393,8 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             insetsPadding: InsetPadding;
             shouldMeasureCanvas: boolean;
             pixelRatio: number;
+            canvasWidth: number;
+            canvasHeight: number;
     };
     export type Systems = {
             cameraSystem: CameraSystem;
@@ -4406,6 +4419,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             outlineInterpolationSystem: OutlineInterpolationSystem;
             outdoorLayersSystem: OutdoorLayers;
             pathSystem: PathSystem;
+            geometryInFocusSystem: GeometryInFocusSystem;
     };
     export type MapViewState = {
             readonly type: 'map-view';
@@ -4458,7 +4472,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             addCustomGeometry(id: string, feature: Feature<Point>, builder: CustomGeometryBuilder, style?: {
                     visible?: boolean;
                     altitude?: number;
-            }, parent?: EntityId<GroupContainerState> | string | number | null): EntityId<CustomGeometryState>;
+            }, parent?: EntityId<GroupContainerState> | string | number | null): EntityId<ShapeState>;
             /**
                 * Add a geometry group from GeoJSON data
                 */
@@ -4479,6 +4493,12 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
                 * Add a Path along a set of GeoJSON coordinates that can be animated.
                 */
             addPath(geometry: FeatureCollection<Point, any>, options?: AddPathOptions, parent?: EntityId<GroupContainerState> | string | null): EntityId<PathState>;
+            /**
+                * Updates the watermark on the map.
+                *
+                * @param options {WatermarkOptions}
+                */
+            updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
             /**
                 * @deprecated
                 * @TODO: remove this method and do this in setstate instead
@@ -4515,9 +4535,9 @@ 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> ? CustomGeometryState : T extends EntityId<CustomGeometryState> ? CustomGeometryState : 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> ? ShapeState : T extends EntityId<ShapeState> ? ShapeState : 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 ? CustomGeometryState : T extends CustomGeometryState ? PathState : 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 ? ShapeState : T extends ShapeState ? PathState : EntityState;
             /**
                 * Set the state of the map view or any entity that was added, regardless of whether it is visible in the scene.
                 */
@@ -4527,7 +4547,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             setState<T extends EntityId<GeometryGroupState>>(object: T | T['id'], state: Partial<GeometryGroupState>): void;
             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<CustomGeometryState>>(object: T | T['id'], state: Partial<CustomGeometryState>): 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<ModelState>>(object: T | T['id'], state: Partial<ModelState>): void;
             setState<T extends EntityState>(object: T | T['id'], state: Partial<T>): void;
@@ -4722,12 +4742,14 @@ declare module '@mappedin/mappedin-js/geojson/src/camera' {
                 * How far out the camera can zoom
                 *
                 * @param zoomLevel  The minimum zoom level in mercator zoom level units.
+                * @default 0
                 */
             setMinZoomLevel(zoomLevel: number): void;
             /**
                 * How far in the camera can zoom
                 *
                 * @param zoomLevel The maximum zoom level in mercator zoom level units.
+                * @default Infinity
                 */
             setMaxZoomLevel(zoomLevel: number): void;
             /**
@@ -4826,6 +4848,10 @@ declare module '@mappedin/mappedin-js/geojson/src/utils/collision-ranking-tier'
     export function convertNumberToCollisionRankingTier(rank: number): CollisionRankingTier;
 }
 
+declare module '@mappedin/mappedin-js/packages/geojson-navigator' {
+    export * from '@mappedin/mappedin-js/packages/geojson-navigator/src';
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/utils' {
     import type { Box3, Camera as THREECamera } from 'three';
     import { Box2 } from 'three';
@@ -4973,6 +4999,7 @@ declare module '@mappedin/mappedin-js/geojson/src/services/renderer' {
 
 declare module '@mappedin/mappedin-js/geojson/src/systems/watermark/system' {
     import type { PerspectiveCamera } from 'three';
+    import { PubSub } from '@packages/internal/common';
     import type { Geometry2D } from '@mappedin/mappedin-js/geojson/src/entities';
     import type { QuadTree } from '@packages/internal/quad-tree';
     export type WatermarkPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center' | 'top' | 'bottom' | 'left' | 'right';
@@ -5012,10 +5039,13 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/watermark/system' {
                 */
             onClick?: () => void;
     };
-    export class WatermarkSystem {
+    export class WatermarkSystem extends PubSub<{
+            'texture-loaded': void;
+    }> {
             #private;
-            options: Required<WatermarkOptions>;
             dirty: boolean;
+            get options(): WatermarkOptions;
+            set options(options: WatermarkOptions);
             get icon(): string;
             constructor(cameraObject: PerspectiveCamera, canvasWidth: number, canvasHeight: number, rendererState: any, options?: WatermarkOptions);
             get width(): number;
@@ -5327,31 +5357,31 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/path' {
     }
 }
 
-declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/custom-geometry' {
+declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/shape' {
     /**
-        * Class representing a GeoJSON geometry on the {@link MapView}.
+        * Class representing GeoJSON shape on the {@link MapView}.
         *
         */
-    export class CustomGeometry {
+    export class Shape {
             /**
-                * The label's id
+                * id of Shape
                 */
             readonly id: string;
             /**
                 * @internal
                 */
-            static readonly __type = "CustomGeometry";
+            static readonly __type = "Shape";
             /**
                 * @internal
                 */
-            readonly __type = "CustomGeometry";
+            readonly __type = "Shape";
             /**
-                * Checks if the provided instance is of type CustomGeometry.
+                * Checks if the provided instance is of type Shape.
                 *
                 * @param instance The instance to check.
-                * @returns {boolean} True if the instance is a CustomGeometry, false otherwise.
+                * @returns {boolean} True if the instance is a Shape, false otherwise.
                 */
-            static is(instance: object): instance is CustomGeometry;
+            static is(instance: object): instance is Shape;
             /**
                 * @internal
                 */
@@ -5360,7 +5390,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-view-objects/custom-ge
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
-    import type { Position, RendererCore } from '@mappedin/core-sdk';
+    import type { Position, RendererCore, WatermarkOptions } from '@mappedin/core-sdk';
     import { type TShow3DMapOptions } from '@mappedin/mappedin-js/mappedin-js/src';
     import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
     import { Floor } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
@@ -5379,7 +5409,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
     import { Paths } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/paths';
     import { BlueDot } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot';
     import type { TFloorChangeReason } from '@mappedin/mappedin-js/mappedin-js/src/events';
-    import { CustomGeometries } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/custom-geometries';
+    import { Shapes } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/shapes';
     import { Style } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/style';
     import Outdoor from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/outdoor';
     export class GeoJsonApi {
@@ -5402,7 +5432,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
         Navigation: Navigation;
         Outdoor: Outdoor;
         BlueDot: BlueDot;
-        CustomGeometries: CustomGeometries;
+        Shapes: Shapes;
         Style: Style;
         constructor(rendererCore: RendererCore, mapView: MapView);
         updateState<T extends Space | MapObject | Label | Marker | 'walls' | (string & NonNullable<unknown>)>(target: T, state: TUpdateState<T>): void;
@@ -5415,6 +5445,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/api' {
         collapse(): Promise<void> | undefined;
         addMap(mapData: MapData, options?: TShow3DMapOptions): Promise<MapData>;
         setFloor(floor: Floor | string, reason?: TFloorChangeReason): void;
+        updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
         get currentFloor(): Floor;
         getState<T extends Space | MapObject | Label | Marker | Model | string>(target: T): TGetState<T> | undefined;
         setHoverColor(c: string): void;
@@ -5514,6 +5545,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera' {
                 * Update the minimum zoom level of the camera in mercator zoom levels.
                 * @param zoomLevel The new minimum zoom level.
                 * @see https://wiki.openstreetmap.org/wiki/Zoom_levels
+                * @default 22
                 */
             setMinZoomLevel: (zoomLevel: number) => void;
             /**
@@ -5526,6 +5558,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/camera' {
                 * Update the maximum zoom level of the camera in mercator zoom levels.
                 * @param zoomLevel The new maximum zoom level.
                 * @see https://wiki.openstreetmap.org/wiki/Zoom_levels
+                * @default 12
                 */
             setMaxZoomLevel: (zoomLevel: number) => void;
     }
@@ -5938,7 +5971,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object' {
     import { StackedMaps } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps';
     import type { TFloorChangeReason } from '@mappedin/mappedin-js/mappedin-js/src/events';
     import type { FeatureCollection, LineString, MultiPolygon, Polygon } from 'geojson';
-    import type { CustomGeometry } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
+    import type { Shape } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export class GeojsonApiMapObject extends PubSub<{
         'floor-change': {
             reason?: TFloorChangeReason;
@@ -5976,11 +6009,11 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/map-object' {
         Exporter: {
             getCurrentSceneGLTF: (options: GLTFExportOptions) => Promise<Blob>;
         };
-        CustomGeometries: {
+        Shapes: {
             add: <T extends FeatureCollection<Polygon | MultiPolygon | LineString, any>>(geometry: T, style: T extends FeatureCollection<LineString, any> ? LineStyle : PaintStyle, opts: {
                 floorId?: string;
             }) => string;
-            remove: (customGeometry: CustomGeometry) => string;
+            remove: (customGeometry: Shape) => string;
         };
         Labels: {
             all: ({ onCreate }: {
@@ -6757,6 +6790,24 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/outline-interpolation/
     }
 }
 
+declare module '@mappedin/mappedin-js/geojson/src/systems/geometry-in-focus/system' {
+    import { PubSub } from '@packages/internal/common';
+    import type { RendererState } from '@mappedin/mappedin-js/geojson/src/renderer';
+    import { type PerspectiveCamera } from 'three';
+    export class GeometryInFocusSystem extends PubSub<{
+        'geometry-in-focus': string | number | null;
+    }> {
+        #private;
+        cameraDirty: boolean;
+        focusablesDirty: boolean;
+        constructor(state: RendererState, camera: PerspectiveCamera);
+        resize(): void;
+        update: () => void;
+        updateRaf(): void;
+        destroy(): void;
+    }
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/systems/outdoor-layers/system' {
     import type { Map } from '@packages/internal/outdoor-context-v4';
     import type { Position } from '@mappedin/mappedin-js/geojson/src/renderer';
@@ -6772,6 +6823,15 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/path' {
     export { PathSystem } from '@mappedin/mappedin-js/geojson/src/systems/path/system';
 }
 
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src' {
+    export { Navigator } from '@mappedin/mappedin-js/packages/geojson-navigator/src/navigator';
+    export type { SimplifyDirectionsOptions } from '@mappedin/mappedin-js/packages/geojson-navigator/src/navigator/navigator';
+    export type { NodeCollection, NodeProperties, NodeFeature, NodeNeighbor } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/node';
+    export type { ObstructionCollection, ObstructionProperties, ObstructionFeature } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/obstruction';
+    export type { DirectionsCollection, DirectionProperties, DirectionFeature } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/directions';
+    export type { CoordinateFeature, CoordinateProperties } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/coordinate';
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/utils/bounding-box' {
     import { type Box3, Vector3 } from 'three';
     export function getCornersOfBoundingBox(boundingBox: Box3): Vector3[];
@@ -7018,6 +7078,7 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/interactions/system' {
             hasTouched: boolean;
             onPointerMoveRaf: (event: PointerEvent) => void;
             tapsControl: TapsController;
+            handleHover(e?: PointerEvent): void;
             dirty3D: boolean;
             get _hitBoxes(): {
                     entities: (Object3D | EntityMesh<Geometry3D> | EntityBatchedMesh)[];
@@ -7157,26 +7218,28 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                 * This is actually the minium distance the camera can get from it's anchor on the ground. May be worth changing if your map has very tall buildings to avoid the camera clipping through them.
                 *
                 * @property minZoomAltitude {Number}
-                * @default 5
+                * @default 0
                 */
             minZoomAltitude: number;
+            /**
+                * Maximum distance the camera can get from it's anchor on the ground. Setting this too high will result in parts of the map falling out of the camera's clipping plane and disappearing.
+                *
+                * @property maxZoomAltitude {Number}
+                * @default Infinity
+                */
+            maxZoomAltitude: number;
             /**
                 * How far the camera can zoom in towards the ground.
                 *
                 * This is equivalent to the minZoomAltitude property in mercator zoom level units.
+                * @default 0
                 */
             get maxZoomLevel(): number;
             /**
                 * Sets distance the camera can zoom in towards the ground.
+                * @default Infinity
                 */
             setMaxZoomLevel(zoomLevel: number): void;
-            /**
-                * Maximum distance the camera can get from it's anchor on the ground. Setting this too high will result in parts of the map falling out of the camera's clipping plane and disappearing.
-                *
-                * @property maxZoomAltitude {Number}
-                * @default 10000
-                */
-            maxZoomAltitude: number;
             /**
                 * How far the camera can zoom out away from the ground.
                 *
@@ -7187,27 +7250,11 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                 * Sets distance the camera can zoom away from the ground.
                 */
             setMinZoomLevel(zoomLevel: number): void;
-            /**
-                * Initial min zoom; zoom cannot be restricted beyond this.
-                *
-                * @property initialMinZoom {Number}
-                * @default 5
-                */
-            initialMinZoom: number;
-            /**
-                * Initial max zoom; zoom cannot be restricted beyond this.
-                *
-                * @property initialMaxZoom {Number}
-                * @default 10000
-                */
-            initialMaxZoom: number;
             /**
                 * ignoreZoomLimits; use with caution for special effects
                 * @default false
                 */
             ignoreZoomLimits: boolean;
-            minExpandedZoom: number;
-            maxExpandedZoom: number;
             /**
                 * Multiplier for min and max zoom, for convenience.
                 *
@@ -7460,20 +7507,6 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/camera/system' {
                 * @param zoom {Number} The distance to increase or decrease the zoom.
                 */
             zoom: (zoomDelta: number) => void;
-            /**
-                * Expands the zoom limits to allow zooming to the specified distance.
-                *
-                * @param zoom {Number} The distance to allow zooming to.
-                * @param buffer {Number} The factor by which the user should be able to zoom beyond the specified distance.
-                */
-            expandZoomLimits: (zoom: number, buffer: number) => void;
-            /**
-                * Restricts the zoom limits, but will not restrict beyond the current zoom level.
-                *
-                * @param zoom {Number} The number to limit zooming to.
-                * @param buffer {Number} The factor by which the user should be able to zoom beyond the specified distance.
-                */
-            restrictZoomLimits: (zoom: number, buffer: number) => void;
             /**
                 * Returns the current projection scale factor.
                 * @param FOV {number} Field of view
@@ -15543,6 +15576,223 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/path/system' {
     }
 }
 
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src/navigator' {
+    export * from '@mappedin/mappedin-js/packages/geojson-navigator/src/navigator/navigator';
+}
+
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src/navigator/navigator' {
+    import type { Position, Feature, MultiPolygon, Polygon } from 'geojson';
+    import type { NodeCollection, NodeFeature } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/node';
+    import type { ObstructionCollection } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/obstruction';
+    import type { DirectionsCollection } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/directions';
+    import type { CoordinateFeature } from '@mappedin/mappedin-js/packages/geojson-navigator/src/types/coordinate';
+    /**
+        * Options for simplifying directions in the Navigator class.
+        */
+    export type SimplifyDirectionsOptions = {
+            /**
+                * Enable or disable simplifying.
+                */
+            enabled: boolean;
+            /**
+                * The radius of the buffer around the path to consider when simplifying, in meters.
+                * @default 0.7
+                */
+            bufferRadius?: number;
+    };
+    /**
+        * Defines the special zone for navigation operations.
+        */
+    export type DirectionsZone = {
+            geometry: Feature<MultiPolygon | Polygon>;
+            /**
+                * The additional cost for navigation through the zone.
+                */
+            cost: number;
+            /**
+                *
+                *  Additional property specific to the navigator based on the 'groupBy' option.
+                */
+            [index: string]: any;
+    };
+    export class Navigator {
+            /**
+                * Constructs a Navigator instance to manage pathfinding with optional obstructions and grouping features.
+                *
+                * @param {NodeCollection} nodes - Collection of nodes for the navigation graph.
+                * @param {ObstructionCollection} [obstructions] - Optional collection of obstructions that could block paths.
+                * @param {string} [groupBy] - Optional property name to group nodes and paths for differentiated processing.
+                */
+            constructor({ nodes, obstructions, groupBy, }: {
+                    nodes: NodeCollection;
+                    obstructions?: ObstructionCollection;
+                    groupBy?: string;
+            });
+            findNearestNode: (feature: CoordinateFeature) => NodeFeature | null;
+            /**
+                * Calculates and returns a set of directions from origin nodes to destination nodes, including detailed properties.
+                *
+                * @param {string[]} originIds - IDs of origin nodes.
+                * @param {string[]} destinationNodeIds - IDs of destination nodes.
+                * @param {string[]} [excludedNodeIds] - IDs of nodes to exclude from pathfinding.
+                * @param {SimplifyDirectionsOptions} [simplify] - Options to simplify the pathfinding result.
+                * @returns {DirectionsCollection} A collection of directional features representing the path.
+                */
+            getDirections({ zones: directionsZones, originIds, destinationNodeIds, excludedNodeIds, simplify, }: {
+                    originIds: string[];
+                    destinationNodeIds: string[];
+                    zones?: DirectionsZone[];
+                    excludedNodeIds?: string[];
+                    simplify?: SimplifyDirectionsOptions;
+            }): DirectionsCollection;
+            /**
+                * Calculates the approximate distance between two geographic coordinates on Earth's surface.
+                *
+                * This function uses the equirectangular approximation method to compute the distance, which simplifies
+                * the math and speeds up calculations, but is less accurate over long distances compared to other methods
+                * like the haversine formula.
+                *
+                * @param {Position} point1 - The first point's longitude and latitude as [longitude, latitude].
+                * @param {Position} point2 - The second point's longitude and latitude as [longitude, latitude].
+                * @return
+                * @return {number} The approximate distance between the two points in meters.
+                */
+            getDistance: (point1: Position, point2: Position) => number;
+            /**
+                * Calculates the angle between two geographic coordinates.
+                *
+                * @param {Position} point1 - The first point's longitude and latitude as [longitude, latitude].
+                * @param {Position} point2 - The second point's longitude and latitude as [longitude, latitude].
+                * @hidden
+                *
+                * @return {number} The angle in radians, calculated clockwise from the north between the two points specified.
+                */
+            getAngle: (point1: Position, point2: Position) => number;
+    }
+}
+
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src/types/node' {
+    import type { Feature, FeatureCollection, Point } from 'geojson';
+    /**
+        * The neighboring node with associated weight.
+        */
+    export type NodeNeighbor = {
+            id: string;
+            weight: number;
+    };
+    /**
+        * Properties specific to node features in a geospatial context.
+        * Each node includes a mandatory unique identifier and supports additional custom properties.
+        */
+    export type NodeProperties = {
+            /**
+                * Unique identifier for the node.
+                */
+            id: string;
+            /**
+                * An array of neighboring nodes with associated weights.
+                */
+            neighbors: NodeNeighbor[];
+            /**
+                * Additional property specific to the navigator based on the 'groupBy' option.
+                * */
+            [name: string]: any;
+    };
+    /**
+        * A GeoJSON feature collection that groups multiple nodes, each represented as a point.
+        * This structure is commonly used in mapping, routing, and network analysis applications.
+        */
+    export type NodeCollection = FeatureCollection<Point, NodeProperties>;
+    /**
+        * A GeoJSON feature representing a node as a point with associated properties.
+        * Nodes are critical for defining specific locations in network-based analyses, such as transportation networks,
+        * utility networks, or any kind of spatial network analysis.
+        */
+    export type NodeFeature = Feature<Point, NodeProperties>;
+}
+
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src/types/obstruction' {
+    import type { LineString, FeatureCollection, Polygon, Feature } from 'geojson';
+    /**
+        * Properties specific to obstruction features in a geospatial context.
+        * Includes a mandatory unique identifier and allows for any additional custom properties.
+        */
+    export type ObstructionProperties = {
+            /**
+                * Unique identifier for the obstruction.
+                */
+            id: string;
+            /**
+                * Additional property specific to the navigator based on the 'groupBy' option.
+                * */
+            [name: string]: any;
+    };
+    /**
+        * A GeoJSON feature collection that groups multiple obstruction features, which can be line strings or polygons.
+        * This is typically used to represent physical barriers or areas where access is restricted.
+        */
+    export type ObstructionCollection = FeatureCollection<LineString | Polygon, ObstructionProperties>;
+    /**
+        * A GeoJSON feature representing an obstruction, which can be either a line string or a polygon.
+        * This type is crucial for mapping and managing areas that impede or restrict movement, such as barriers or restricted zones.
+        *
+        */
+    export type ObstructionFeature = Feature<LineString | Polygon, ObstructionProperties>;
+}
+
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src/types/directions' {
+    import type { Feature, FeatureCollection, Point } from 'geojson';
+    /**
+        * Properties specific to directional features in a navigation context.
+        * Includes an identifier, optional angle and distance, and allows for any additional properties.
+        */
+    export type DirectionProperties = {
+            /**
+                * Unique identifier for the direction.
+                */
+            id: string;
+            /**
+                * An angle between this point and the destination, in radians.
+                */
+            angle?: number;
+            /**
+                * Distance to the next point, in meters.
+                */
+            distance?: number;
+            /**
+                * Group id which the direction belongs to (e.g. floor, building, etc).
+                * It's based on the groupBy property of the navigator.
+                */
+            groupBy?: string;
+    };
+    /**
+        * A GeoJSON feature representing a point with properties tailored for navigation directions.
+        */
+    export type DirectionFeature = Feature<Point, DirectionProperties>;
+    /**
+        * A GeoJSON feature collection that groups multiple directional features, often used to represent a route or path.
+        */
+    export type DirectionsCollection = FeatureCollection<Point, DirectionProperties>;
+}
+
+declare module '@mappedin/mappedin-js/packages/geojson-navigator/src/types/coordinate' {
+    import type { Feature, Point } from 'geojson';
+    /**
+        * Properties specific to node features in a geospatial context.
+        * Each node includes a mandatory unique identifier and supports additional custom properties.
+        */
+    export type CoordinateProperties = {
+            /**
+                * Additional property specific to the navigator based on the 'groupBy' option.
+                * */
+            [name: string]: any;
+    };
+    /**
+        * A GeoJSON feature representing a coordinate as a point with associated properties.
+        */
+    export type CoordinateFeature = Feature<Point, CoordinateProperties>;
+}
+
 declare module '@mappedin/mappedin-js/geojson/src/entities/utils' {
     import type { CollisionRankingTier, GeometryState, LabelState, PathState, RendererCore } from '@mappedin/mappedin-js/geojson/src';
     import type { MarkerState } from '@mappedin/mappedin-js/geojson/src/components/marker';