@mappedin/mappedin-js 6.3.1 → 6.4.0

package/lib/esm/index.d.ts

@@ -79,19 +79,55 @@ declare class AnalyticsInternal {
 	sendBlueDotEvents(event: BlueDotEvents): void | Promise<Response> | Promise<void>;
 }
 type UpdateStateParam = Partial<Pick<AnalyticState, "geolocationMode" | "context" | "logEvents" | "userPosition" | "mapId" | "sendEvents" | "logEvents" | "accessToken" | "sessionId" | "deviceId">>;
-type CaptureEventsPayloadMap = {
+/**
+ * Maps reserved analytics event names to their payload structures.
+ *
+ * This type is used by the {@link Analytics.capture} method to provide type safety for reserved analytics events.
+ * When using these event names, the payload must match the corresponding structure.
+ */
+export type CaptureEventsPayloadMap = {
+	/**
+	 * Event fired when a location is selected.
+	 */
 	"$select-location": {
+		/**
+		 * The ID of the selected location.
+		 */
 		id: string;
 	};
+	/**
+	 * Event fired when a category is selected.
+	 */
 	"$select-category": {
+		/**
+		 * The ID of the selected category.
+		 */
 		id: string;
 	};
+	/**
+	 * Event fired when query suggestions are generated.
+	 */
 	"$query-suggest": {
+		/**
+		 * The search query string.
+		 */
 		query: string;
+		/**
+		 * Optional array of suggestion strings.
+		 */
 		suggestions?: string[];
 	};
+	/**
+	 * Event fired when a search query is executed.
+	 */
 	"$query-search": {
+		/**
+		 * The search query string.
+		 */
 		query: string;
+		/**
+		 * Optional array of result IDs (hits).
+		 */
 		hits?: string[];
 	};
 };
@@ -194,7 +230,7 @@ type AnalyticState = {
 	/** Flag to enable sending of events. */
 	sendEvents: boolean;
 } & AnalyticsAuth;
-type AnalyticsOptions = Partial<Omit<AnalyticState, "version" | "analyticsBaseUrl" | "geolocationMode" | "userPosition">>;
+type AnalyticsOptions = Partial<Omit<AnalyticState, "analyticsBaseUrl" | "geolocationMode" | "userPosition">>;
 type AnalyticsUpdateOptions = Omit<AnalyticsOptions, keyof AnalyticsAuth> & ((Required<Pick<AnalyticsAuth, "key" | "secret">> & Partial<Pick<AnalyticsAuth, "accessToken">>) | (Required<Pick<AnalyticsAuth, "accessToken">> & Partial<Pick<AnalyticsAuth, "key" | "secret">>));
 /**
  * Options for updating the current state of analytics.
@@ -359,16 +395,7 @@ interface FeatureCollection$1<G extends Geometry$1 | null = Geometry$1, P = GeoJ
 	type: "FeatureCollection";
 	features: Array<Feature$1<G, P>>;
 }
-/**
- * Represents the environment state configuration.
- * @example
- * const mapData = getMapData({
- *  key: '',
- *  secret: '',
- *  environment: 'eu'
- * })
- */
-export type Environment = {
+type Environment = {
 	/**
 	 * The base URI for the API.
 	 */
@@ -388,16 +415,13 @@ export type Environment = {
 };
 type InternalServiceEnvironment = "us" | "us-enterprise" | "eu" | "us-staging-enterprise" | "us-staging-self-serve";
 type ServiceEnvironment = "us" | "eu";
-/**
- * Options for configuring search functionality.
- */
-export type TSearchOptions = {
+type TSearchOptions = {
 	/**
 	 * Indicates whether search functionality is enabled.
 	 */
 	enabled: boolean;
 };
-export type TGetMapDataSharedOptions = {
+type TGetMapDataSharedOptions = {
 	/**
 	 * Mappedin map ID.
 	 */
@@ -473,6 +497,11 @@ export type TGetMapDataSharedOptions = {
 		 * @internal
 		 */
 		context?: string;
+		/**
+		 * Version override for analytics events.
+		 * @internal
+		 */
+		version?: string;
 	};
 	search?: TSearchOptions;
 	/**
@@ -491,10 +520,7 @@ export type TGetMapDataSharedOptions = {
 	 */
 	mvfVersion?: "2.0.0" | "2.0.0-c" | "3.0.0";
 };
-/**
- * @interface
- */
-export type TGetMapDataWithCredentialsOptions = {
+type TGetMapDataWithCredentialsOptions = {
 	/**
 	 * Mappedin auth key.
 	 */
@@ -504,16 +530,13 @@ export type TGetMapDataWithCredentialsOptions = {
 	 */
 	secret: string;
 } & TGetMapDataSharedOptions;
-/**
- * @interface
- */
-export type TGetMapDataWithAccessTokenOptions = {
+type TGetMapDataWithAccessTokenOptions = {
 	/**
 	 * Mappedin access token.
 	 */
 	accessToken: string;
 } & TGetMapDataSharedOptions;
-export type TGetMapDataOptions = TGetMapDataWithCredentialsOptions | TGetMapDataWithAccessTokenOptions;
+type TGetMapDataOptions = TGetMapDataWithCredentialsOptions | TGetMapDataWithAccessTokenOptions;
 /**
  * @internal
  */
@@ -4775,6 +4798,11 @@ type PathState = {
 	highlightColor: string;
 	highlightWidthMultiplier: number;
 	highlightCompleteFraction: number;
+	/**
+	 * The opacity of the path when it's behind geometry (x-ray effect). Value from 0 to 1.
+	 * @default 0.25
+	 */
+	xrayOpacity: number;
 };
 type AddPathOptions = {
 	/**
@@ -4829,6 +4857,11 @@ type AddPathOptions = {
 	highlightColor?: string;
 	highlightWidthMultiplier?: number;
 	highlightCompleteFraction?: number;
+	/**
+	 * The opacity of the path when it's behind geometry (x-ray effect). Value from 0 to 1.
+	 * @default 0.25
+	 */
+	xrayOpacity?: number;
 };
 declare class PathComponent {
 	#private;
@@ -4853,6 +4886,7 @@ declare class PathComponent {
 	highlightCompleteFraction: number;
 	highlightWidthMultiplier: number;
 	highlightColor: string;
+	xrayOpacity: number;
 	dashed: boolean;
 	/**
 	 * If the path is vertical it will be rebuilt whenever altitudeDirty = true. This will be set during the first render of the path.
@@ -5133,6 +5167,7 @@ declare class Geometry3DObject3D extends Object3D {
 		isSingleModel?: boolean;
 		type: Geometry3DObjectTypes;
 	};
+	components: never[];
 	/**
 	 * Custom raycast implementation for model objects only.
 	 * This selectively enables recursive raycasting just for models, which have complex hierarchies,
@@ -5188,7 +5223,7 @@ declare class Geometry3D<M extends MeshComponentTypes = MeshComponent, S extends
 	parentId?: string | number;
 	get object3d(): M["mesh"];
 	get parentObject3D(): GroupContainerObject3D | GeometryGroupObject3D | null;
-	get type(): T;
+	type: T;
 	entities2D: Map<string | number, Geometry2D>;
 	constructor(meshComponent: M, styleComponent: S);
 	/** Attaching a 2D entity to the 3D entity so it will follow the style changes */
@@ -5305,13 +5340,7 @@ interface PathUniforms {
 		value: number;
 	};
 }
-/**
- * Generic PubSub class implementing the Publish-Subscribe pattern for event handling.
- *
- * @template EVENT_PAYLOAD - The type of the event payload.
- * @template EVENT - The type of the event.
- */
-export declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
+declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
 	/**
 	 * @private
 	 * @internal
@@ -5394,6 +5423,19 @@ declare class Renderer {
 	 */
 	destroy(): void;
 	enabledLayers: Set<number>;
+	private matricesUpdatedThisFrame;
+	/**
+	 * Indicate that a new frame is starting, so we can reset the matrices updated flag
+	 */
+	startFrame(): void;
+	/**
+	 * Per frame, we can call this function many times, but it should only fire once
+	 */
+	private updateMatricesIfNeeded;
+	/**
+	 * Render a custom scene
+	 */
+	renderScene(scene: Scene, sceneCamera: Camera): void;
 	/**
 	 * Re-render the scene, depending on which parts of the scene have been
 	 * invalidated.
@@ -5403,7 +5445,7 @@ declare class Renderer {
 	 * @param scene {Scene}
 	 * @param sceneCamera {Camera}
 	 */
-	render(scene: Scene, sceneCamera: Camera): void;
+	renderFullScene(scene: Scene, sceneCamera: Camera): void;
 	clear(): void;
 	/**
 	 * Set the size of the renderer, composer, and all its internal buffers.
@@ -5597,6 +5639,70 @@ export declare class MappedinError extends Error {
 export declare class MappedinRenderError extends MappedinError {
 	constructor(message: string, label?: string);
 }
+/**
+ * Generic PubSub class implementing the Publish-Subscribe pattern for event handling.
+ *
+ * @template EVENT_PAYLOAD - The type of the event payload.
+ * @template EVENT - The type of the event.
+ */
+declare class PubSub$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
+	/**
+	 * @private
+	 * @internal
+	 */
+	private _subscribers;
+	/**
+	 * @private
+	 * @internal
+	 */
+	private _destroyed;
+	/**
+	 * @private
+	 * @internal
+	 */
+	publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
+	/**
+	 * Subscribe a function to an event.
+	 *
+	 * @param eventName An event name which, when fired, will call the provided
+	 * function.
+	 * @param fn A callback that gets called when the corresponding event is fired. The
+	 * callback will get passed an argument with a type that's one of event payloads.
+	 * @example
+	 * // Subscribe to the 'click' event
+	 * const handler = (event) => {
+	 *  const { coordinate } = event;
+	 *  const { latitude, longitude } = coordinate;
+	 * 	console.log(`Map was clicked at ${latitude}, ${longitude}`);
+	 * };
+	 * map.on('click', handler);
+	 */
+	on<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, fn: (payload: EVENT_PAYLOAD[EVENT_NAME] extends {
+		data: null;
+	} ? EVENT_PAYLOAD[EVENT_NAME]["data"] : EVENT_PAYLOAD[EVENT_NAME]) => void): void;
+	/**
+	 * Unsubscribe a function previously subscribed with {@link on}
+	 *
+	 * @param eventName An event name to which the provided function was previously
+	 * subscribed.
+	 * @param fn A function that was previously passed to {@link on}. The function must
+	 * have the same reference as the function that was subscribed.
+	 * @example
+	 * // Unsubscribe from the 'click' event
+	 * const handler = (event) => {
+	 * 	console.log('Map was clicked', event);
+	 * };
+	 * map.off('click', handler);
+	 */
+	off<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, fn: (payload: EVENT_PAYLOAD[EVENT_NAME] extends {
+		data: null;
+	} ? EVENT_PAYLOAD[EVENT_NAME]["data"] : EVENT_PAYLOAD[EVENT_NAME]) => void): void;
+	/**
+	 * @private
+	 * @internal
+	 */
+	destroy(): void;
+}
 declare const EASING_CURVES: readonly [
 	"ease-in",
 	"ease-out",
@@ -15062,11 +15168,6 @@ type ReadonlyObjectDeep<ObjectType extends object> = {
 	readonly [KeyType in keyof ObjectType]: ReadonlyDeep<ObjectType[KeyType]>;
 };
 type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
-type PartialExcept<T, K extends string> = {
-	[P in keyof T as P extends K ? P : never]: T[P];
-} & {
-	[P in keyof T as P extends K ? never : P]?: T[P] extends Primitive$1 ? T[P] : T[P] extends (infer U)[] ? PartialExcept<U, K>[] : PartialExcept<T[P], K>;
-};
 type ExtractDeep<T, U, Depth extends readonly number[] = [
 ]> = Depth["length"] extends 3 ? any : {
 	[K in keyof T as T[K] extends U ? K : T[K] extends object | undefined ? ExtractDeep<NonNullable<T[K]>, U, [
@@ -15158,7 +15259,7 @@ type WatermarkUpdateOptions = Omit<WatermarkOptions, "onClick" | "visible"> & {
 	/** Set the interactivity of the watermark. */
 	interactive?: boolean;
 };
-declare class WatermarkSystem extends PubSub<{
+declare class WatermarkSystem extends PubSub$1<{
 	"texture-loaded": void;
 }> {
 	#private;
@@ -15333,8 +15434,8 @@ declare class InteractionSystem extends PubSub<InteractionEvents> {
 	private lastPointerEvent?;
 	private cursor;
 	private touchesCount;
-	private isUserInteracting;
-	constructor(container: HTMLCanvasElement, coreState: RendererState, camera: PerspectiveCamera, worldPlane: Mesh, isUserInteracting: () => boolean);
+	private isUserMovingCamera;
+	constructor(container: HTMLCanvasElement, coreState: RendererState, camera: PerspectiveCamera, worldPlane: Mesh, isUserMovingCamera: () => boolean);
 	updateQuadtree(takeIT: QuadTree<{
 		entityId: Geometry2D["id"];
 	}>): void;
@@ -15476,122 +15577,6 @@ declare const LABEL_TEXT_PLACEMENT: {
 declare const LABEL_LOW_PRIORITY = "low-priority";
 export type LabelTextPlacement = ValueOf<typeof LABEL_TEXT_PLACEMENT>;
 type LabelTextPlacementInternal = LabelTextPlacement | typeof LABEL_LOW_PRIORITY;
-declare const labelAppearanceSchema: z.ZodPipe<z.ZodObject<{
-	margin: z.ZodDefault<z.ZodNumber>;
-	maxLines: z.ZodDefault<z.ZodNumber>;
-	textSize: z.ZodDefault<z.ZodNumber>;
-	maxWidth: z.ZodDefault<z.ZodNumber>;
-	lineHeight: z.ZodDefault<z.ZodNumber>;
-	color: z.ZodDefault<z.ZodString>;
-	outlineColor: z.ZodDefault<z.ZodString>;
-	textColor: z.ZodOptional<z.ZodString>;
-	textOutlineColor: z.ZodOptional<z.ZodString>;
-	pinColor: z.ZodOptional<z.ZodString>;
-	pinOutlineColor: z.ZodOptional<z.ZodString>;
-	pinColorInactive: z.ZodOptional<z.ZodString>;
-	pinOutlineColorInactive: z.ZodOptional<z.ZodString>;
-	icon: z.ZodOptional<z.ZodString>;
-	iconSize: z.ZodDefault<z.ZodNumber>;
-	iconScale: z.ZodDefault<z.ZodUnion<readonly [
-		z.ZodNumber,
-		z.ZodObject<{
-			on: z.ZodLiteral<"zoom-level">;
-			input: z.ZodTuple<[
-				z.ZodNumber
-			], z.ZodNumber>;
-			output: z.ZodTuple<[
-				z.ZodNumber
-			], z.ZodNumber>;
-			easing: z.ZodDefault<z.ZodEnum<{
-				"ease-in": "ease-in";
-				"ease-out": "ease-out";
-				"ease-in-out": "ease-in-out";
-				linear: "linear";
-			}>>;
-		}, z.core.$strip>
-	]>>;
-	iconPadding: z.ZodDefault<z.ZodNumber>;
-	iconFit: z.ZodDefault<z.ZodEnum<{
-		fill: "fill";
-		contain: "contain";
-		cover: "cover";
-	}>>;
-	iconOverflow: z.ZodDefault<z.ZodEnum<{
-		visible: "visible";
-		hidden: "hidden";
-	}>>;
-	iconVisible: z.ZodDefault<z.ZodUnion<readonly [
-		z.ZodBoolean,
-		z.ZodNumber
-	]>>;
-	opacity: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>, z.ZodTransform<{
-	textColor: string;
-	textOutlineColor: string;
-	pinColor: string;
-	pinOutlineColor: string;
-	pinColorInactive: string;
-	pinOutlineColorInactive: string;
-	margin: number;
-	maxLines: number;
-	textSize: number;
-	maxWidth: number;
-	lineHeight: number;
-	color: string;
-	outlineColor: string;
-	iconSize: number;
-	iconScale: number | {
-		on: "zoom-level";
-		input: [
-			number,
-			...number[]
-		];
-		output: [
-			number,
-			...number[]
-		];
-		easing: "ease-in" | "ease-out" | "ease-in-out" | "linear";
-	};
-	iconPadding: number;
-	iconFit: "fill" | "contain" | "cover";
-	iconOverflow: "visible" | "hidden";
-	iconVisible: number | boolean;
-	opacity: number;
-	icon?: string | undefined;
-}, {
-	margin: number;
-	maxLines: number;
-	textSize: number;
-	maxWidth: number;
-	lineHeight: number;
-	color: string;
-	outlineColor: string;
-	iconSize: number;
-	iconScale: number | {
-		on: "zoom-level";
-		input: [
-			number,
-			...number[]
-		];
-		output: [
-			number,
-			...number[]
-		];
-		easing: "ease-in" | "ease-out" | "ease-in-out" | "linear";
-	};
-	iconPadding: number;
-	iconFit: "fill" | "contain" | "cover";
-	iconOverflow: "visible" | "hidden";
-	iconVisible: number | boolean;
-	opacity: number;
-	textColor?: string | undefined;
-	textOutlineColor?: string | undefined;
-	pinColor?: string | undefined;
-	pinOutlineColor?: string | undefined;
-	pinColorInactive?: string | undefined;
-	pinOutlineColorInactive?: string | undefined;
-	icon?: string | undefined;
-}>>;
 declare const labelAppearanceSchemaStrict: z.ZodObject<{
 	margin: z.ZodDefault<z.ZodNumber>;
 	maxLines: z.ZodDefault<z.ZodNumber>;
@@ -15706,24 +15691,107 @@ declare const labelAppearanceSchemaStrict: z.ZodObject<{
  */
 export type LabelAppearance = OptionalRemap<OptionalRemap<z.input<typeof labelAppearanceSchemaStrict>, "iconScale", number | Interpolation<"zoom-level", number[]>>, "color" | "outlineColor" | "pinColor" | "pinOutlineColor" | "pinColorInactive" | "pinOutlineColorInactive", ColorString>;
 type LabelAppearanceWithDefaults = z.infer<typeof labelAppearanceSchema>;
-declare const addLabelOptionsSchema: z.ZodObject<{
-	rank: z.ZodOptional<z.ZodUnion<readonly [
-		z.ZodEnum<{
-			low: "low";
-			medium: "medium";
-			high: "high";
-			"always-visible": "always-visible";
-		}>,
-		z.ZodNumber
-	]>>;
-	appearance: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-		margin: z.ZodDefault<z.ZodNumber>;
-		maxLines: z.ZodDefault<z.ZodNumber>;
-		textSize: z.ZodDefault<z.ZodNumber>;
-		maxWidth: z.ZodDefault<z.ZodNumber>;
-		lineHeight: z.ZodDefault<z.ZodNumber>;
-		color: z.ZodDefault<z.ZodString>;
-		outlineColor: z.ZodDefault<z.ZodString>;
+declare const labelAppearanceSchema: z.ZodPipe<z.ZodObject<{
+	margin: z.ZodDefault<z.ZodNumber>;
+	maxLines: z.ZodDefault<z.ZodNumber>;
+	textSize: z.ZodDefault<z.ZodNumber>;
+	maxWidth: z.ZodDefault<z.ZodNumber>;
+	lineHeight: z.ZodDefault<z.ZodNumber>;
+	color: z.ZodDefault<z.ZodString>;
+	outlineColor: z.ZodDefault<z.ZodString>;
+	textColor: z.ZodOptional<z.ZodString>;
+	textOutlineColor: z.ZodOptional<z.ZodString>;
+	pinColor: z.ZodOptional<z.ZodString>;
+	pinOutlineColor: z.ZodOptional<z.ZodString>;
+	pinColorInactive: z.ZodOptional<z.ZodString>;
+	pinOutlineColorInactive: z.ZodOptional<z.ZodString>;
+	icon: z.ZodOptional<z.ZodString>;
+	iconSize: z.ZodDefault<z.ZodNumber>;
+	iconScale: z.ZodDefault<z.ZodUnion<readonly [
+		z.ZodNumber,
+		z.ZodObject<{
+			on: z.ZodLiteral<"zoom-level">;
+			input: z.ZodTuple<[
+				z.ZodNumber
+			], z.ZodNumber>;
+			output: z.ZodTuple<[
+				z.ZodNumber
+			], z.ZodNumber>;
+			easing: z.ZodDefault<z.ZodEnum<{
+				"ease-in": "ease-in";
+				"ease-out": "ease-out";
+				"ease-in-out": "ease-in-out";
+				linear: "linear";
+			}>>;
+		}, z.core.$strip>
+	]>>;
+	iconPadding: z.ZodDefault<z.ZodNumber>;
+	iconFit: z.ZodDefault<z.ZodEnum<{
+		fill: "fill";
+		contain: "contain";
+		cover: "cover";
+	}>>;
+	iconOverflow: z.ZodDefault<z.ZodEnum<{
+		visible: "visible";
+		hidden: "hidden";
+	}>>;
+	iconVisible: z.ZodDefault<z.ZodUnion<readonly [
+		z.ZodBoolean,
+		z.ZodNumber
+	]>>;
+	opacity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodTransform<Required<LabelAppearance>, {
+	margin: number;
+	maxLines: number;
+	textSize: number;
+	maxWidth: number;
+	lineHeight: number;
+	color: string;
+	outlineColor: string;
+	iconSize: number;
+	iconScale: number | {
+		on: "zoom-level";
+		input: [
+			number,
+			...number[]
+		];
+		output: [
+			number,
+			...number[]
+		];
+		easing: "ease-in" | "ease-out" | "ease-in-out" | "linear";
+	};
+	iconPadding: number;
+	iconFit: "fill" | "contain" | "cover";
+	iconOverflow: "visible" | "hidden";
+	iconVisible: number | boolean;
+	opacity: number;
+	textColor?: string | undefined;
+	textOutlineColor?: string | undefined;
+	pinColor?: string | undefined;
+	pinOutlineColor?: string | undefined;
+	pinColorInactive?: string | undefined;
+	pinOutlineColorInactive?: string | undefined;
+	icon?: string | undefined;
+}>>;
+declare const addLabelOptionsSchema: z.ZodObject<{
+	rank: z.ZodOptional<z.ZodUnion<readonly [
+		z.ZodEnum<{
+			low: "low";
+			medium: "medium";
+			high: "high";
+			"always-visible": "always-visible";
+		}>,
+		z.ZodNumber
+	]>>;
+	appearance: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+		margin: z.ZodDefault<z.ZodNumber>;
+		maxLines: z.ZodDefault<z.ZodNumber>;
+		textSize: z.ZodDefault<z.ZodNumber>;
+		maxWidth: z.ZodDefault<z.ZodNumber>;
+		lineHeight: z.ZodDefault<z.ZodNumber>;
+		color: z.ZodDefault<z.ZodString>;
+		outlineColor: z.ZodDefault<z.ZodString>;
 		textColor: z.ZodOptional<z.ZodString>;
 		textOutlineColor: z.ZodOptional<z.ZodString>;
 		pinColor: z.ZodOptional<z.ZodString>;
@@ -15765,40 +15833,7 @@ declare const addLabelOptionsSchema: z.ZodObject<{
 			z.ZodNumber
 		]>>;
 		opacity: z.ZodDefault<z.ZodNumber>;
-	}, z.core.$strip>, z.ZodTransform<{
-		textColor: string;
-		textOutlineColor: string;
-		pinColor: string;
-		pinOutlineColor: string;
-		pinColorInactive: string;
-		pinOutlineColorInactive: string;
-		margin: number;
-		maxLines: number;
-		textSize: number;
-		maxWidth: number;
-		lineHeight: number;
-		color: string;
-		outlineColor: string;
-		iconSize: number;
-		iconScale: number | {
-			on: "zoom-level";
-			input: [
-				number,
-				...number[]
-			];
-			output: [
-				number,
-				...number[]
-			];
-			easing: "ease-in" | "ease-out" | "ease-in-out" | "linear";
-		};
-		iconPadding: number;
-		iconFit: "fill" | "contain" | "cover";
-		iconOverflow: "visible" | "hidden";
-		iconVisible: number | boolean;
-		opacity: number;
-		icon?: string | undefined;
-	}, {
+	}, z.core.$strip>, z.ZodTransform<Required<LabelAppearance>, {
 		margin: number;
 		maxLines: number;
 		textSize: number;
@@ -15849,6 +15884,7 @@ declare const addLabelOptionsSchema: z.ZodObject<{
 			hidden: "hidden";
 		}>>
 	]>>;
+	occlude: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type AddLabelOptionsInternal = z.input<typeof addLabelOptionsSchema> & {
 	appearance?: LabelAppearance;
@@ -15878,7 +15914,7 @@ type AddLabelOptionsInternal = z.input<typeof addLabelOptionsSchema> & {
 	 */
 	textPlacement?: LabelTextPlacement | LabelTextPlacement[];
 };
-declare class MeshCreationAndOptimizationSystem extends PubSub<{
+declare class MeshCreationAndOptimizationSystem extends PubSub$1<{
 	"model-loaded": void;
 	"geometry-2d-added": void;
 	"geometry-group-added": void;
@@ -15924,7 +15960,7 @@ declare enum TEXTALIGN {
 	CENTER = "center",
 	RIGHT = "right"
 }
-declare class TwoDDrawSystem extends PubSub<{
+declare class TwoDDrawSystem extends PubSub$1<{
 	"img:loaded": undefined;
 }> {
 	dirty: boolean;
@@ -16000,7 +16036,7 @@ declare class TwoDVisibilitySystem extends PubSub<{
 	playAnimations: () => void;
 	_playAnimations(): void;
 }
-declare class RenderSystem extends PubSub<{
+declare class RenderSystem extends PubSub$1<{
 	"measure-canvas": undefined;
 	"pre-render": undefined;
 	"post-render": undefined;
@@ -16691,7 +16727,7 @@ declare class DOMDrawSystem {
 	constructor(state: RendererState);
 	update(isUserInteracting: boolean): void;
 }
-declare class DOMResizeSystem extends PubSub<{
+declare class DOMResizeSystem extends PubSub$1<{
 	"dimensions-update": void;
 }> {
 	state: RendererState;
@@ -16891,7 +16927,7 @@ declare class Camera$2 {
 	 */
 	focusOn(target: (Position | Position$1 | string)[], options?: FocusOnOptions): Promise<void>;
 }
-declare class PanBoundsSystem extends PubSub<{
+declare class PanBoundsSystem extends PubSub$1<{
 	update: void;
 }> {
 	private currentTotalBoundingBox?;
@@ -16982,7 +17018,7 @@ declare class IdleQueue {
 	 */
 	clearAll(): void;
 }
-declare class OutlineInterpolationSystem extends PubSub<{
+declare class OutlineInterpolationSystem extends PubSub$1<{
 	"needs-render": void;
 }> {
 	#private;
@@ -17017,7 +17053,7 @@ declare class OutlineInterpolationSystem extends PubSub<{
 	update(zoomLevel: number, isCameraZoomDirty?: boolean): void;
 	destroy(): void;
 }
-declare class ImageSystem extends PubSub<{
+declare class ImageSystem extends PubSub$1<{
 	"image-loaded": void;
 }> {
 	private rendererState;
@@ -17045,7 +17081,7 @@ declare class ImageSystem extends PubSub<{
 	update(cameraRotationRadians: number): void;
 	updateImageScreenBBoxes(meshComponent: MeshComponent | ImageComponent): void;
 }
-declare class GeometryInFocusSystem extends PubSub<{
+declare class GeometryInFocusSystem extends PubSub$1<{
 	/**
 	 * Returns the list of entities that are likely in focus, sorted by the weight of the raycast.
 	 */
@@ -17080,7 +17116,7 @@ declare class GeometryInFocusSystem extends PubSub<{
 declare class OutdoorLayers {
 	#private;
 	idleQueue: IdleQueue;
-	hideLayersIntersectingPolygons(bbox: BBox, polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[], layers: string[]): void;
+	hideLayersIntersectingPolygons(polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[], layers: string[]): void;
 	constructor(map?: Map);
 	destroy(): void;
 }
@@ -17149,7 +17185,7 @@ declare class GeometryDisposalSystem {
 	constructor(state: RendererState);
 	update(): void;
 }
-declare class TextureSystem extends PubSub<{
+declare class TextureSystem extends PubSub$1<{
 	"texture-added": void;
 }> {
 	dirty: boolean;
@@ -17469,11 +17505,10 @@ declare class Core extends PubSub<MapEvent> {
 	getMetersPerPixel: () => number;
 	/**
 	 * Filters out layers at a certain point on the outdoor map. This can be used to hide the outdoor building footprint underneath the 3D geometry.
-	 * @param bbox The bounding box to filter layers under.
 	 * @param polygons The polygons to filter layers under.
 	 * @param layers The layers to filter out.
 	 */
-	hideOutdoorLayersIntersectingPolygons: (bbox: BBox, polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[], layers: string[]) => void;
+	hideOutdoorLayersIntersectingPolygons: (polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[], layers: string[]) => void;
 	/**
 	 * Get the center of a geometry or bounding box.
 	 * @param geometryOrBoundingBox Geometry, geometry id, or bounding box to get the center of.
@@ -17781,25 +17816,39 @@ declare class LabelComponent {
 	toPackedMessage(isPanning?: boolean): PackedJsonMessage;
 	destroy(): void;
 }
+type Occlusion2D = {
+	enabled: boolean;
+	id: number;
+};
+declare class Occlusion2DComponent implements Occlusion2D {
+	readonly type: "occlusion2d";
+	enabled: boolean;
+	/**
+	 * Id of the occluder
+	 */
+	id: number;
+	constructor(id: number);
+}
 declare class Geometry2DObject3D extends Object3D {
 }
 type ComponentTypeMap$1 = {
 	interaction: InteractionComponent;
 	marker: MarkerComponent;
 	label: LabelComponent;
+	occlusion2d: Occlusion2DComponent;
 };
 declare class Geometry2D {
 	id: string | number;
-	get type(): "label" | "marker";
+	type: "label" | "marker";
 	get parentObject3D(): GroupContainerObject3D | GeometryGroupObject3D | null;
 	/** The geometry3D that this 2D entity is attached to */
 	get attachedTo(): string | number | undefined;
 	verticalOffset: number;
-	occluderId?: number;
 	object3d: Geometry2DObject3D;
 	components: [
 		MarkerComponent | LabelComponent,
-		InteractionComponent?
+		InteractionComponent?,
+		Occlusion2DComponent?
 	];
 	getComponent<T extends keyof ComponentTypeMap$1>(type: T): ComponentTypeMap$1[T] | undefined;
 	disposed: boolean;
@@ -18029,15 +18078,7 @@ type ClickPayload = {
 	/**
 	 * Details about the pointer event which triggered the interaction.
 	 */
-	pointerEvent: {
-		/**
-		 * The button which was clicked. 0 is the left mouse button and 2 is the right mouse button.
-		 * On touch devices a tap will have a button of 0.
-		 *
-		 * @see https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/button
-		 */
-		button: number;
-	};
+	pointerEvent: Pick<PointerEvent, "button">;
 	/**
 	 * An array of group container IDs which the user interaction passed through. Will be empty if no group containers were interacted with.
 	 */
@@ -18133,12 +18174,22 @@ type RendererState = {
 	readonly geometry2DMap: Map<string | number, Geometry2D>;
 	/**
 	 * A set of all 2D geometry IDs in the scene. This is updated when objects' visiblity changes.
+	 * @deprecated Use geometry2DsInScene instead.
 	 */
 	readonly geometry2DIdsInScene: Set<Geometry2D["id"]>;
 	/**
 	 * A set of all 3D geometry IDs in the scene. This is updated when objects' visiblity changes.
+	 * @deprecated Use geometry3DsInScene instead.
 	 */
 	readonly geometry3DIdsInScene: Set<All3DTypes["id"]>;
+	/**
+	 * A set of all 3D geometries in the scene. This is updated when objects' visiblity changes.
+	 */
+	readonly geometry3DsInScene: Set<All3DTypes>;
+	/**
+	 * A set of all 2D geometries in the scene. This is updated when objects' visiblity changes.
+	 */
+	readonly geometry2DsInScene: Set<Geometry2D>;
 	/**
 	 * IDs of geometry groups that need to be loaded, including preloaded geometry groups that are not in the scene yet
 	 */
@@ -18305,6 +18356,11 @@ type AddMarkerOptions = {
 	 * Dynamic resize of the marker. If set to true, the marker will resize based on the content.
 	 */
 	dynamicResize?: boolean;
+	/**
+	 * Whether the marker can be occluded by 3D geometry
+	 * @default true
+	 */
+	occlude?: boolean;
 	/**
 	 * @internal
 	 */
@@ -18395,320 +18451,48 @@ declare class MarkerComponent {
 	get lowPriorityPinStrategyIndex(): number;
 	destroy(): void;
 }
-type NodeNeighbor = {
-	id: string;
-	weight: number;
-};
-type NodeProperties = {
+export declare function enableTestMode(): void;
+/**
+ * Class representing a label on the {@link MapView}.
+ *
+ * Labels contain text and an image that are anchored to a specific point on the map. They automatically rotate and show and hide based on priority and zoom level.
+ * Use them to inform users about location names, points of interest and more!
+ *
+ * Effective use of labels allows an app to convey additional information to the user.
+ * For example labels can be used to show room names, important points of interest, main entrances or any other piece of contextual information that is useful to the user.
+ *
+ * Refer to the [Labels Guide](https://developer.mappedin.com/web-sdk/labels) for more information and interactive examples.
+ */
+export declare class Label implements IFocusable {
 	/**
-	 * Unique identifier for the node.
+	 * The label's id
 	 */
-	id: string;
+	readonly id: string;
 	/**
-	 * An array of neighboring nodes with associated weights.
+	 * The label's text
 	 */
-	neighbors: NodeNeighbor[];
+	readonly text: string;
 	/**
-	 * Additional property specific to the navigator based on the 'groupBy' option.
-	 * */
-	[name: string]: any;
-};
-type NodeCollection$1 = FeatureCollection$1<Point$1, NodeProperties>;
-type NodeFeature = Feature$1<Point$1, NodeProperties>;
-declare class Edge {
-	/** The originating node of the edge */
-	origin: NodeFeature;
-	/** The destination node of the edge */
-	destination: NodeFeature;
-	/** The distance between the origin and the destination nodes */
-	distance: number;
-	/** The angle of the edge with respect to some reference, in degrees */
-	angle: number;
-	/** A composite weight of the edge, combining distance and a custom path weight */
-	weight: number;
+	 * The target object where the label is anchored.
+	 */
+	readonly target: IAnchorable;
 	/**
-	 * Constructs a new Edge instance.
-	 * @param {NodeFeature} origin - The originating node of the edge.
-	 * @param {NodeFeature} destination - The destination node of the edge.
-	 * @param {number} [distance=0] - The physical distance between the origin and destination.
-	 * @param {number} [angle=0] - The angle of the edge in degrees.
-	 * @param {number} [pathWeight=0] - An additional weight factor for the path.
+	 * @internal
 	 */
-	constructor({ origin, destination, distance, angle, pathWeight, multiplicativeDistanceWeightScaling, }: {
-		origin: NodeFeature;
-		destination: NodeFeature;
-		distance?: number;
-		angle?: number;
-		pathWeight?: number;
-		multiplicativeDistanceWeightScaling?: boolean;
-	});
-}
-declare class NavigationGraph {
-	#private;
-	readonly edges: {
-		[propName: string]: Edge[];
-	};
-	readonly nodesById: {
-		[propName: string]: NodeFeature;
-	};
-	readonly nodesByGroup: Map<string, NodeFeature[]>;
-	constructor({ nodes, groupBy, multiplicativeDistanceWeightScaling, }: {
-		nodes: NodeCollection$1;
-		groupBy: string;
-		multiplicativeDistanceWeightScaling?: boolean;
-	});
+	static readonly __type = "label";
 	/**
-	 * Calculates the shortest Euclidean distance from the origin node to any of the destination nodes.
-	 *
-	 * @param origin - The origin node.
-	 * @param destinations - An array of destination nodes.
-	 * @returns The shortest Euclidean distance.
+	 * @internal
 	 */
-	getShortestEuclideanDistance(origin: NodeFeature, destinations: NodeFeature[]): number;
-	hasLineOfSight: (origin: Position, destination: Position, edges?: Position[][], bufferRadius?: number) => boolean;
+	readonly __type = "label";
 	/**
-	 * Performs a Dijkstra search to find nodes within a given travel distance that satisfy a goal function, sorted by distance.
+	 * Checks if the provided instance is of type Label.
 	 *
-	 * @param originId - Origin node ID.
-	 * @param maxTravelDistance - The maximum travel distance.
-	 * @param includedNodeIds - Array of node IDs to include in the search.
-	 * @param obstructionEdges - Array of obstruction edges for line of sight calculations.
-	 * @param useLineOfSight - Whether to use line of sight checking.
-	 * @returns An Array of nodes within the travel distance that satisfy the goal function.
-	 * - feature: The node feature.
-	 * - distance: The distance to the node.
-	 * - edges: The edges to the node.
+	 * @param instance The instance to check.
+	 * @returns {boolean} True if the instance is a Label, false otherwise.
 	 */
-	dijkstraFindWithinTravelDistance(originId: string, maxTravelDistance: number, includedNodeIds: string[], obstructionEdges: Position[][], useLineOfSight: boolean, limitNumberOfResults: number): {
-		feature: NodeFeature;
-		distance: number;
-	}[];
-	/**
-	 * Performs A* pathfinding from specified origins to destinations, considering optional constraints like accessibility.
-	 *
-	 * @param {string[]} originIds - Array of origin node IDs.
-	 * @param {string[]} destinationNodeIds - Array of destination node IDs.
-	 * @param {Set<string>} [disabledConnectionNodeIds] - Optional set of connection node IDs that are disabled (ie. act as regular nodes).
-	 * @param {Set<string>} [disabledNodeIds] - Optional set of node IDs which are ignored during pathfinding.
-	 * @returns {Edge[]} An array of edges representing the shortest path, or an empty array if no path is found.
-	 */
-	aStar({ originIds, destinationNodeIds, disabledConnectionNodeIds, zones, overrideEdgeWeights, disabledNodeIds, }: {
-		originIds: string[];
-		destinationNodeIds: string[];
-		zones: DirectionsZone[];
-		disabledConnectionNodeIds?: Set<string>;
-		overrideEdgeWeights?: Map<Edge, number>;
-		disabledNodeIds?: Set<string>;
-	}): Edge[];
-}
-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;
-	destination?: string;
-	edges: Edge[];
-};
-type DirectionFeature = Feature$1<Point$1, DirectionProperties>;
-type DirectionsCollection = FeatureCollection$1<Point$1, DirectionProperties>;
-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;
-};
-type DirectionsZone = {
-	geometry: Feature$1<MultiPolygon$1 | Polygon$1>;
-	/**
-	 * The additional cost for navigation through the zone.
-	 */
-	cost: number;
-	/**
-	 *
-	 *  Additional property specific to the navigator based on the 'groupBy' option.
-	 */
-	[index: string]: any;
-};
-declare class Navigator$1 {
-	private groupBy;
-	graph: NavigationGraph;
-	private geometryEdgesByMapId;
-	private flagDeclarations;
-	private disabledNodeIds;
-	/**
-	 * 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 {SpaceCollection} [spaces] - Optional collection of spaces that could block paths.
-	 * @param {string} [groupBy] - Optional property name to group nodes and paths for differentiated processing.
-	 */
-	constructor({ nodes, geojsonCollection, groupBy, multiplicativeDistanceWeightScaling, flagDeclarations, }: {
-		nodes: NodeCollection$1;
-		geojsonCollection?: ObstructionCollection | SpaceCollection;
-		groupBy?: string;
-		multiplicativeDistanceWeightScaling?: boolean;
-		flagDeclarations?: NavigationFlagDeclarations;
-	});
-	private getDisabledNodeIds;
-	/**
-	 * Calculates and returns a set of directions from origin nodes to destination nodes, including detailed properties.
-	 *
-	 * @param {DirectionsZone[]} zones - special zones for navigation operations.
-	 * @param {string[]} originIds - IDs of origin nodes.
-	 * @param {string[]} destinationNodeIds - IDs of destination nodes.
-	 * @param {string[]} [disabledConnectionNodeIds] - IDs of connection nodes that are disabled (ie. act as regular nodes).
-	 * @param {SimplifyDirectionsOptions} [simplify] - Options to simplify the pathfinding result.
-	 * @returns {DirectionsCollection} A collection of directional features representing the path.
-	 */
-	getDirections({ zones: directionsZones, originIds, destinationNodeIds, disabledConnectionNodeIds, simplify, multiplicativeDistanceWeightScaling, overrideEdgeWeights, }: {
-		originIds: string[];
-		destinationNodeIds: string[];
-		zones?: DirectionsZone[];
-		disabledConnectionNodeIds?: string[];
-		simplify?: SimplifyDirectionsOptions;
-		multiplicativeDistanceWeightScaling?: boolean;
-		overrideEdgeWeights?: Map<Edge, number>;
-	}): DirectionsCollection;
-	/**
-	 * Generates a path from a series of edges, constructing a feature collection of directional steps.
-	 *
-	 * @param {Edge[]} steps - An array of edges representing the path.
-	 * @returns {DirectionsCollection} A collection of directional features.
-	 */
-	private generatePath;
-	/**
-	 * Simplifies a sequence of steps by reducing unnecessary nodes using a buffer radius to check for obstructions.
-	 *
-	 * @param {Edge[]} steps - The steps to simplify.
-	 * @param {number} bufferRadius - The buffer radius to use
-	 * for simplification.
-	 * @returns {Edge[]} An array of simplified edges representing a more direct path.
-	 */
-	private simplifyAllSteps;
-	/**
-	 * Finds the nearest nodes on the graph within a given travel distance.
-	 *
-	 * @param originId - The ID of the origin node.
-	 * @param maxDistance - The maximum distance to search.
-	 * @param floorId - The ID of the floor.
-	 * @param includedNodeIds - The IDs of the nodes to include.
-	 * @param useLineOfSight - Whether to use line of sight.
-	 * @returns An array of nodes within the travel distance that satisfy the goal function.
-	 */
-	findNearestNodesOnGraph: (originId: string, maxDistance: number, floorId: string, includedNodeIds: string[], useLineOfSight?: boolean, limitNumberOfResults?: number) => {
-		feature: NodeFeature;
-		distance: number;
-	}[];
-	/**
-	 * Checks if there is a line of sight between two points on the map.
-	 *
-	 * @param origin - The origin point.
-	 * @param destination - The destination point.
-	 * @param floorId - The ID of the floor.
-	 * @param bufferRadius - The buffer radius to use when checking for line of sight.
-	 * @returns True if there is a line of sight, false otherwise.
-	 */
-	hasLineOfSight: (origin: [
-		number,
-		number
-	], destination: [
-		number,
-		number
-	], floorId: string, bufferRadius?: number) => boolean;
-	/**
-	 * Simplifies a section of steps by checking direct lines of sight between steps and eliminating intermediate nodes if unobstructed.
-	 *
-	 * @param {Edge[]} steps - The steps to potentially simplify.
-	 * @param {[number, number][][]} geometryEdges - The geometrical edges of the map used to check for line of sight.
-	 * @param {number} bufferRadius - The buffer radius to use when simplifying.
-	 * @returns {Edge[]} An array of simplified edges.
-	 */
-	private simplifySteps;
-	/**
-	 * 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;
-}
-export declare function enableTestMode(): void;
-/**
- * Class representing a label on the {@link MapView}.
- *
- * Labels contain text and an image that are anchored to a specific point on the map. They automatically rotate and show and hide based on priority and zoom level.
- * Use them to inform users about location names, points of interest and more!
- *
- * Effective use of labels allows an app to convey additional information to the user.
- * For example labels can be used to show room names, important points of interest, main entrances or any other piece of contextual information that is useful to the user.
- *
- * Refer to the [Labels Guide](https://developer.mappedin.com/web-sdk/labels) for more information and interactive examples.
- */
-export declare class Label implements IFocusable {
-	/**
-	 * The label's id
-	 */
-	readonly id: string;
-	/**
-	 * The label's text
-	 */
-	readonly text: string;
-	/**
-	 * The target object where the label is anchored.
-	 */
-	readonly target: IAnchorable;
-	/**
-	 * @internal
-	 */
-	static readonly __type = "label";
-	/**
-	 * @internal
-	 */
-	readonly __type = "label";
-	/**
-	 * Checks if the provided instance is of type Label.
-	 *
-	 * @param instance The instance to check.
-	 * @returns {boolean} True if the instance is a Label, false otherwise.
-	 */
-	static is(instance: object): instance is Label;
-	/** @internal */
-	get focusTarget(): Coordinate;
+	static is(instance: object): instance is Label;
+	/** @internal */
+	get focusTarget(): Coordinate;
 	/**
 	 * @internal
 	 */
@@ -18782,10 +18566,10 @@ export declare class Image3DView {
 	 */
 	readonly __type = "image-3d";
 	/**
-	 * Checks if the provided instance is of type Image"
+	 * Checks if the provided instance is of type Image3DView.
 	 *
 	 * @param instance The instance to check.
-	 * @returns {boolean} True if the instance is a Image, false otherwise.
+	 * @returns {boolean} True if the instance is an Image3DView, false otherwise.
 	 */
 	static is(instance: object): instance is Image3DView;
 	/**
@@ -18951,7 +18735,30 @@ export declare class Path implements IFocusable {
 		segments: PathSegment[];
 	};
 }
-type TCreateMarker = boolean | ((instruction: TDirectionInstruction) => Marker);
+/**
+ * Controls marker creation for navigation points.
+ *
+ * - If `true`, a default marker is created.
+ * - If `false`, no marker is created.
+ * - If a function is provided, it will be called with the direction instruction and should return a custom {@link Marker} instance.
+ *
+ * @example
+ * ```ts
+ * // Use default markers
+ * createMarkers: { departure: true, destination: true }
+ *
+ * // Disable markers
+ * createMarkers: { departure: false }
+ *
+ * // Create custom markers
+ * createMarkers: {
+ *   departure: (instruction) => {
+ *     return mapView.Markers.add(instruction.coordinate, '<div>Custom</div>');
+ *   }
+ * }
+ * ```
+ */
+export type TCreateMarker = boolean | ((instruction: TDirectionInstruction) => Marker);
 /**
  * Options for navigation.
  */
@@ -19221,7 +19028,7 @@ declare class FloorStackObject implements Omit<MVFFloorStack, "maps" | "floors"
 	addFloor(floor: FloorObject): void;
 	loadAllFloors(): void;
 }
-declare class GeojsonApiMapObject extends PubSub<{
+declare class GeojsonApiMapObject extends PubSub$1<{
 	"floor-change": {
 		reason?: TFloorChangeReason;
 		floorId: string;
@@ -20145,7 +19952,7 @@ export declare class MapView {
 	 *
 	 * Provides turn-by-turn navigation instructions and route visualization. This method delegates to the MapData instance.
 	 *
-	 * @note In enterprise mode, path smoothing is disabled by default. Use the `smoothing` option to explicitly enable it if needed.
+	 * @remarks In enterprise mode, path smoothing is disabled by default. Use the `smoothing` option to explicitly enable it if needed.
 	 *
 	 * @param from The starting location(s).
 	 * @param to The destination location(s).
@@ -20204,7 +20011,7 @@ export declare class MapView {
 	 *
 	 * Provides routes from a single starting point to multiple destinations. This method delegates to the MapData instance.
 	 *
-	 * @note In enterprise mode, path smoothing is disabled by default. Use the `smoothing` option to explicitly enable it if needed.
+	 * @remarks In enterprise mode, path smoothing is disabled by default. Use the `smoothing` option to explicitly enable it if needed.
 	 *
 	 * @param from The starting location.
 	 * @param to An array of destination locations or arrays of destinations.
@@ -20502,6 +20309,7 @@ declare class Camera$3 {
 	 * Controls which camera interactions are enabled/disabled.
 	 *
 	 * @example
+	 * ```ts
 	 * // Disable zoom and rotation
 	 * mapView.Camera.interactions.set({ zoom: false, bearingAndPitch: false });
 	 *
@@ -20510,6 +20318,7 @@ declare class Camera$3 {
 	 *
 	 * // Disable all interactions
 	 * mapView.Camera.interactions.disable();
+	 * ```
 	 */
 	interactions: {
 		set: (options: TCameraInteractionsSetOptions) => void;
@@ -21025,10 +20834,10 @@ type CurrentMapGetter$3 = () => GeojsonApiMapObject | undefined;
  * });
  *
  * // Remove an image
- * mapView.Images.remove(image);
+ * mapView.Image3D.remove(image);
  *
  * // Remove all images
- * mapView.Images.removeAll();
+ * mapView.Image3D.removeAll();
  * ```
  *
  * ### Advanced
@@ -21071,7 +20880,7 @@ export declare class Image3D {
 	 * @param target The target object ({@link IAnchorable}) for the image (e.g., {@link Space}, {@link Door}, or {@link Coordinate}).
 	 * @param url The URL of the image (JPEG or PNG format).
 	 * @param options Configuration options for the image (see {@link TAddImageOptions}).
-	 * @returns {Image | undefined} The created {@link Image}, or undefined if creation failed.
+	 * @returns The created {@link Image3DView} instance.
 	 *
 	 * @example Add a simple image
 	 * ```ts
@@ -21103,17 +20912,21 @@ export declare class Image3D {
 	/**
 	 * Removes an image from the map.
 	 *
-	 * @param image {Image} The {@link Image} which should be removed.
+	 * @param image The {@link Image3DView} instance to remove.
 	 * @example
-	 * mapView.Images.remove(image);
+	 * ```ts
+	 * mapView.Image3D.remove(image);
+	 * ```
 	 */
 	remove(image: Image3DView): void;
 	/**
 	 * Remove all the images from the map.
 	 *
-	 * @returns An array of all removed {@link Image} instances.
+	 * @returns An array of all removed {@link Image3DView} instances.
 	 * @example
-	 * const removedImages = mapView.Images.removeAll();
+	 * ```ts
+	 * const removedImages = mapView.Image3D.removeAll();
+	 * ```
 	 */
 	removeAll(): Image3DView[];
 }
@@ -21395,7 +21208,6 @@ declare class Style$2 {
 }
 type CurrentMapGetter$7 = () => GeojsonApiMapObject | undefined;
 type HiddenOutdoorGeometry = [
-	BBox,
 	polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[],
 	layers: string[]
 ];
@@ -21840,6 +21652,7 @@ declare const labelStateSchema: z.ZodObject<{
 			center: "center";
 		}>>
 	]>>;
+	occlude: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const labelStateSchemaPartial: z.ZodObject<{
 	type: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"label">>>;
@@ -21864,6 +21677,7 @@ declare const labelStateSchemaPartial: z.ZodObject<{
 			center: "center";
 		}>>
 	]>>>;
+	occlude: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type TLabelState = z.infer<typeof labelStateSchema>;
 export type TLabelUpdateState = z.infer<typeof labelStateSchemaPartial>;
@@ -21910,6 +21724,7 @@ declare const markerStateSchema: z.ZodObject<{
 	}, z.core.$strip>>;
 	element: z.ZodCustom<HTMLElement, HTMLElement>;
 	contentHTML: z.ZodString;
+	occlude: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const markerStateSchemaPartial: z.ZodObject<{
 	type: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"marker">>>;
@@ -21919,6 +21734,7 @@ declare const markerStateSchemaPartial: z.ZodObject<{
 		z.ZodLiteral<"pointer-events-auto">
 	]>>>;
 	rank: z.ZodOptional<z.ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">>;
+	occlude: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 	placement: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [
 		z.ZodEnum<{
 			"top-left": "top-left";
@@ -21968,6 +21784,7 @@ declare const pathStateSchemaPartial: z.ZodObject<{
 	highlightColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
 	highlightWidthMultiplier: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
 	highlightCompleteFraction: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+	xrayOpacity: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const pathStateSchemaStrict: z.ZodObject<{
 	type: z.ZodDefault<z.ZodLiteral<"path">>;
@@ -21981,6 +21798,7 @@ declare const pathStateSchemaStrict: z.ZodObject<{
 	highlightColor: z.ZodDefault<z.ZodString>;
 	highlightWidthMultiplier: z.ZodDefault<z.ZodNumber>;
 	highlightCompleteFraction: z.ZodDefault<z.ZodNumber>;
+	xrayOpacity: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type TPathState = z.infer<typeof pathStateSchemaStrict>;
 export type TPathUpdateState = z.infer<typeof pathStateSchemaPartial>;
@@ -22268,7 +22086,7 @@ export type MapElementToUpdateState = {
 	[DOORS.Exterior]: TDoorsUpdateState;
 	[DOORS.Interior]: TDoorsUpdateState;
 };
-declare class GeoJsonApi extends PubSub<TNavigationEvents> {
+declare class GeoJsonApi extends PubSub$1<TNavigationEvents> {
 	#private;
 	core: Core;
 	mapObjects: GeojsonApiMapObject[];
@@ -22280,7 +22098,6 @@ declare class GeoJsonApi extends PubSub<TNavigationEvents> {
 	mapData?: MapData;
 	currentMap: GeojsonApiMapObject;
 	hiddenOutdoorGeometries: [
-		BBox,
 		polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[],
 		layers: string[]
 	][];
@@ -22292,7 +22109,7 @@ declare class GeoJsonApi extends PubSub<TNavigationEvents> {
 	 * Internal systems publish events here which are then exposed to developers via
 	 * MapView.on() and MapView.off().
 	 */
-	externalPubSub: PubSub<TEvents>;
+	externalPubSub: PubSub$1<TEvents>;
 	get manualFloorVisibility(): boolean;
 	set manualFloorVisibility(value: boolean);
 	get hidePathsNotOnCurrentFloor(): boolean;
@@ -22309,7 +22126,7 @@ declare class GeoJsonApi extends PubSub<TNavigationEvents> {
 	Shapes: Shapes;
 	Style: Style$2;
 	Image3D: Image3D;
-	constructor(rendererCore: Core, mapView: MapView, externalPubSub: PubSub<TEvents>);
+	constructor(rendererCore: Core, mapView: MapView, externalPubSub: PubSub$1<TEvents>);
 	preloadFloors(floors: Floor[]): void;
 	updateState<T extends MapElementsWithState>(target: T, state: TUpdateState<T>): void;
 	updateState<T extends string & NonNullable<unknown>>(target: T, state: ValueOf<MapElementToUpdateState>): void;
@@ -22371,49 +22188,321 @@ declare class GeoJsonApi extends PubSub<TNavigationEvents> {
 		manualFloorVisibility: boolean;
 	}>;
 	/**
-	 * Publish all current state information
-	 * @internal
+	 * Publish all current state information
+	 * @internal
+	 */
+	publishAllState(): void;
+	clear(): void;
+	destroy(): void;
+	getOptimalVisualDistanceBetweenFloors(floors: Floor[], debug?: boolean): number | undefined;
+}
+/**
+ * Sets the base URL directory where worker scripts are hosted for CSP compatibility.
+ *
+ * This function configures both the MapLibre and collision system workers to load from
+ * external URLs instead of using inline blob URLs. The SDK expects two specific worker
+ * files to be available in the provided directory:
+ * - `maplibre-worker.csp.js` - For MapLibre map rendering
+ * - `collision-worker.csp.js` - For the collision detection system
+ *
+ * Using this approach enables compatibility with strict Content Security Policies
+ * that block unsafe-eval and blob: URLs.
+ *
+ * @param baseUrl - Base URL directory where worker scripts are hosted (without trailing slash)
+ *                  Example: "https://cdn.example.com/workers"
+ *
+ * @example
+ * ```typescript
+ * import { setWorkersUrl } from '@mappedin/mappedin-js';
+ *
+ * // Call before initializing any maps
+ * setWorkersUrl('https://cdn.example.com/workers');
+ * // This will load:
+ * // - https://cdn.example.com/workers/maplibre-worker.csp.js
+ * // - https://cdn.example.com/workers/collision-worker.csp.js
+ * ```
+ *
+ * @remarks
+ * - The worker files can be found in the published package at:
+ *   `node_modules/@mappedin/mappedin-js/lib/esm/workers/`
+ * - For deployment, copy these files to your web server or CDN
+ * - A better approach is to add these files to your build process to ensure
+ *   they're always in sync with your application
+ * - Call this function before creating any map instances
+ */
+export declare function setWorkersUrl(baseUrl: string): void;
+type NodeNeighbor = {
+	id: string;
+	weight: number;
+};
+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;
+};
+type NodeCollection$1 = FeatureCollection$1<Point$1, NodeProperties>;
+type NodeFeature = Feature$1<Point$1, NodeProperties>;
+declare class Edge {
+	/** The originating node of the edge */
+	origin: NodeFeature;
+	/** The destination node of the edge */
+	destination: NodeFeature;
+	/** The distance between the origin and the destination nodes */
+	distance: number;
+	/** The angle of the edge with respect to some reference, in degrees */
+	angle: number;
+	/** A composite weight of the edge, combining distance and a custom path weight */
+	weight: number;
+	/**
+	 * Constructs a new Edge instance.
+	 * @param {NodeFeature} origin - The originating node of the edge.
+	 * @param {NodeFeature} destination - The destination node of the edge.
+	 * @param {number} [distance=0] - The physical distance between the origin and destination.
+	 * @param {number} [angle=0] - The angle of the edge in degrees.
+	 * @param {number} [pathWeight=0] - An additional weight factor for the path.
+	 */
+	constructor({ origin, destination, distance, angle, pathWeight, multiplicativeDistanceWeightScaling, }: {
+		origin: NodeFeature;
+		destination: NodeFeature;
+		distance?: number;
+		angle?: number;
+		pathWeight?: number;
+		multiplicativeDistanceWeightScaling?: boolean;
+	});
+}
+declare class NavigationGraph {
+	#private;
+	readonly edges: {
+		[propName: string]: Edge[];
+	};
+	readonly nodesById: {
+		[propName: string]: NodeFeature;
+	};
+	readonly nodesByGroup: Map<string, NodeFeature[]>;
+	constructor({ nodes, groupBy, multiplicativeDistanceWeightScaling, }: {
+		nodes: NodeCollection$1;
+		groupBy: string;
+		multiplicativeDistanceWeightScaling?: boolean;
+	});
+	/**
+	 * Calculates the shortest Euclidean distance from the origin node to any of the destination nodes.
+	 *
+	 * @param origin - The origin node.
+	 * @param destinations - An array of destination nodes.
+	 * @returns The shortest Euclidean distance.
+	 */
+	getShortestEuclideanDistance(origin: NodeFeature, destinations: NodeFeature[]): number;
+	hasLineOfSight: (origin: Position, destination: Position, edges?: Position[][], bufferRadius?: number) => boolean;
+	/**
+	 * Performs a Dijkstra search to find nodes within a given travel distance that satisfy a goal function, sorted by distance.
+	 *
+	 * @param originId - Origin node ID.
+	 * @param maxTravelDistance - The maximum travel distance.
+	 * @param includedNodeIds - Array of node IDs to include in the search.
+	 * @param obstructionEdges - Array of obstruction edges for line of sight calculations.
+	 * @param useLineOfSight - Whether to use line of sight checking.
+	 * @returns An Array of nodes within the travel distance that satisfy the goal function.
+	 * - feature: The node feature.
+	 * - distance: The distance to the node.
+	 * - edges: The edges to the node.
+	 */
+	dijkstraFindWithinTravelDistance(originId: string, maxTravelDistance: number, includedNodeIds: string[], obstructionEdges: Position[][], useLineOfSight: boolean, limitNumberOfResults: number): {
+		feature: NodeFeature;
+		distance: number;
+	}[];
+	/**
+	 * Performs A* pathfinding from specified origins to destinations, considering optional constraints like accessibility.
+	 *
+	 * @param {string[]} originIds - Array of origin node IDs.
+	 * @param {string[]} destinationNodeIds - Array of destination node IDs.
+	 * @param {Set<string>} [disabledConnectionNodeIds] - Optional set of connection node IDs that are disabled (ie. act as regular nodes).
+	 * @param {Set<string>} [disabledNodeIds] - Optional set of node IDs which are ignored during pathfinding.
+	 * @returns {Edge[]} An array of edges representing the shortest path, or an empty array if no path is found.
+	 */
+	aStar({ originIds, destinationNodeIds, disabledConnectionNodeIds, zones, overrideEdgeWeights, disabledNodeIds, }: {
+		originIds: string[];
+		destinationNodeIds: string[];
+		zones: DirectionsZone[];
+		disabledConnectionNodeIds?: Set<string>;
+		overrideEdgeWeights?: Map<Edge, number>;
+		disabledNodeIds?: Set<string>;
+	}): Edge[];
+}
+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;
+	destination?: string;
+	edges: Edge[];
+};
+type DirectionFeature = Feature$1<Point$1, DirectionProperties>;
+type DirectionsCollection = FeatureCollection$1<Point$1, DirectionProperties>;
+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;
+};
+type DirectionsZone = {
+	geometry: Feature$1<MultiPolygon$1 | Polygon$1>;
+	/**
+	 * The additional cost for navigation through the zone.
+	 */
+	cost: number;
+	/**
+	 *
+	 *  Additional property specific to the navigator based on the 'groupBy' option.
+	 */
+	[index: string]: any;
+};
+declare class Navigator$1 {
+	private groupBy;
+	graph: NavigationGraph;
+	private geometryEdgesByMapId;
+	private flagDeclarations;
+	private disabledNodeIds;
+	/**
+	 * 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 {SpaceCollection} [spaces] - Optional collection of spaces that could block paths.
+	 * @param {string} [groupBy] - Optional property name to group nodes and paths for differentiated processing.
+	 */
+	constructor({ nodes, geojsonCollection, groupBy, multiplicativeDistanceWeightScaling, flagDeclarations, }: {
+		nodes: NodeCollection$1;
+		geojsonCollection?: ObstructionCollection | SpaceCollection;
+		groupBy?: string;
+		multiplicativeDistanceWeightScaling?: boolean;
+		flagDeclarations?: NavigationFlagDeclarations;
+	});
+	private getDisabledNodeIds;
+	/**
+	 * Calculates and returns a set of directions from origin nodes to destination nodes, including detailed properties.
+	 *
+	 * @param {DirectionsZone[]} zones - special zones for navigation operations.
+	 * @param {string[]} originIds - IDs of origin nodes.
+	 * @param {string[]} destinationNodeIds - IDs of destination nodes.
+	 * @param {string[]} [disabledConnectionNodeIds] - IDs of connection nodes that are disabled (ie. act as regular nodes).
+	 * @param {SimplifyDirectionsOptions} [simplify] - Options to simplify the pathfinding result.
+	 * @returns {DirectionsCollection} A collection of directional features representing the path.
+	 */
+	getDirections({ zones: directionsZones, originIds, destinationNodeIds, disabledConnectionNodeIds, simplify, multiplicativeDistanceWeightScaling, overrideEdgeWeights, }: {
+		originIds: string[];
+		destinationNodeIds: string[];
+		zones?: DirectionsZone[];
+		disabledConnectionNodeIds?: string[];
+		simplify?: SimplifyDirectionsOptions;
+		multiplicativeDistanceWeightScaling?: boolean;
+		overrideEdgeWeights?: Map<Edge, number>;
+	}): DirectionsCollection;
+	/**
+	 * Generates a path from a series of edges, constructing a feature collection of directional steps.
+	 *
+	 * @param {Edge[]} steps - An array of edges representing the path.
+	 * @returns {DirectionsCollection} A collection of directional features.
+	 */
+	private generatePath;
+	/**
+	 * Simplifies a sequence of steps by reducing unnecessary nodes using a buffer radius to check for obstructions.
+	 *
+	 * @param {Edge[]} steps - The steps to simplify.
+	 * @param {number} bufferRadius - The buffer radius to use
+	 * for simplification.
+	 * @returns {Edge[]} An array of simplified edges representing a more direct path.
+	 */
+	private simplifyAllSteps;
+	/**
+	 * Finds the nearest nodes on the graph within a given travel distance.
+	 *
+	 * @param originId - The ID of the origin node.
+	 * @param maxDistance - The maximum distance to search.
+	 * @param floorId - The ID of the floor.
+	 * @param includedNodeIds - The IDs of the nodes to include.
+	 * @param useLineOfSight - Whether to use line of sight.
+	 * @returns An array of nodes within the travel distance that satisfy the goal function.
+	 */
+	findNearestNodesOnGraph: (originId: string, maxDistance: number, floorId: string, includedNodeIds: string[], useLineOfSight?: boolean, limitNumberOfResults?: number) => {
+		feature: NodeFeature;
+		distance: number;
+	}[];
+	/**
+	 * Checks if there is a line of sight between two points on the map.
+	 *
+	 * @param origin - The origin point.
+	 * @param destination - The destination point.
+	 * @param floorId - The ID of the floor.
+	 * @param bufferRadius - The buffer radius to use when checking for line of sight.
+	 * @returns True if there is a line of sight, false otherwise.
+	 */
+	hasLineOfSight: (origin: [
+		number,
+		number
+	], destination: [
+		number,
+		number
+	], floorId: string, bufferRadius?: number) => boolean;
+	/**
+	 * Simplifies a section of steps by checking direct lines of sight between steps and eliminating intermediate nodes if unobstructed.
+	 *
+	 * @param {Edge[]} steps - The steps to potentially simplify.
+	 * @param {[number, number][][]} geometryEdges - The geometrical edges of the map used to check for line of sight.
+	 * @param {number} bufferRadius - The buffer radius to use when simplifying.
+	 * @returns {Edge[]} An array of simplified edges.
+	 */
+	private simplifySteps;
+	/**
+	 * 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.
 	 */
-	publishAllState(): void;
-	clear(): void;
-	destroy(): void;
-	getOptimalVisualDistanceBetweenFloors(floors: Floor[], debug?: boolean): number | undefined;
+	getAngle: (point1: Position, point2: Position) => number;
 }
-/**
- * Sets the base URL directory where worker scripts are hosted for CSP compatibility.
- *
- * This function configures both the MapLibre and collision system workers to load from
- * external URLs instead of using inline blob URLs. The SDK expects two specific worker
- * files to be available in the provided directory:
- * - `maplibre-worker.csp.js` - For MapLibre map rendering
- * - `collision-worker.csp.js` - For the collision detection system
- *
- * Using this approach enables compatibility with strict Content Security Policies
- * that block unsafe-eval and blob: URLs.
- *
- * @param baseUrl - Base URL directory where worker scripts are hosted (without trailing slash)
- *                  Example: "https://cdn.example.com/workers"
- *
- * @example
- * ```typescript
- * import { setWorkersUrl } from '@mappedin/mappedin-js';
- *
- * // Call before initializing any maps
- * setWorkersUrl('https://cdn.example.com/workers');
- * // This will load:
- * // - https://cdn.example.com/workers/maplibre-worker.csp.js
- * // - https://cdn.example.com/workers/collision-worker.csp.js
- * ```
- *
- * @remarks
- * - The worker files can be found in the published package at:
- *   `node_modules/@mappedin/mappedin-js/lib/esm/workers/`
- * - For deployment, copy these files to your web server or CDN
- * - A better approach is to add these files to your build process to ensure
- *   they're always in sync with your application
- * - Call this function before creating any map instances
- */
-export declare function setWorkersUrl(baseUrl: string): void;
 /**
  * Represents a set of directions between two points.
  *
@@ -22465,6 +22554,9 @@ export declare class Directions {
 		__type: string;
 		from: TNavigationTarget;
 		to: TNavigationTarget;
+		coordinates: Coordinate[];
+		distance: number;
+		instructions: TDirectionInstruction[];
 	};
 }
 declare class DirectionsInternal {
@@ -22659,57 +22751,72 @@ export declare class Text3DView {
 	 */
 	static is(instance: object): instance is Text3DView;
 }
-export type TFloorChangeReason = "blue-dot-floor-change" | "navigation-connection-click" | string;
+export type TFloorChangeReason = string;
+/**
+ * The payload for a user click event on the map.
+ *
+ * Contains detailed information about all visible interactive map elements that were under the pointer
+ * at the time of the event.
+ *
+ * Properties are optional and included only when corresponding objects are present at the pointer location.
+ */
 export type TClickPayload = {
 	/**
-	 * The coordinate of the interaction.
+	 * The geographic {@link Coordinate} of the pointer event.
 	 */
 	coordinate: Coordinate;
 	/**
-	 * The interactive paths which the user interaction passed through.
+	 * Interactive {@link Path}s under the pointer.
 	 */
 	paths?: Path[];
 	/**
-	 * The interactive spaces which the user interaction passed through.
+	 * Interactive {@link Space}s under the pointer.
 	 */
 	spaces?: Space[];
 	/**
-	 * The interactive objects which the user interaction passed through.
+	 * Interactive {@link MapObject | Object}s under the pointer.
 	 */
 	objects?: MapObject[];
 	/**
-	 * The interactive areas which the user interaction passed through.
+	 * Interactive {@link Area}s under the pointer.
 	 */
 	areas?: Area[];
 	/**
-	 * The markers which the user interaction passed through.
+	 * Interactive {@link Marker}s under the pointer.
 	 */
 	markers?: Marker[];
 	/**
-	 * The models which the user interaction passed through.
+	 * Interactive {@link Model}s under the pointer.
 	 */
 	models?: Model[];
 	/**
-	 * The interactive labels which the user interaction passed through.
+	 * Interactive {@link Label}s under the pointer.
 	 */
 	labels?: Label[];
 	/**
-	 * The interactive floors which the user interaction passed through.
+	 * Interactive {@link Floor}s under the pointer.
 	 */
 	floors?: Floor[];
 	/**
-	 * Details about the pointer event which triggered the interaction.
+	 * Details about the pointer event triggering this click, containing only the pointer button.
 	 */
-	pointerEvent: ClickPayload["pointerEvent"];
+	pointerEvent: Pick<PointerEvent, "button">;
 	/**
-	 * The interactive facades which the user interaction passed through.
+	 * Interactive {@link Facade}s under the pointer.
 	 */
 	facades?: Facade[];
 	/**
-	 * The interactive shapes which the user interaction passed through.
+	 * Interactive {@link Shape}s under the pointer.
 	 */
 	shapes?: Shape[];
 };
+/**
+ * Represents the payload for a hover event on the map.
+ * This contains the interactive objects that the user's pointer is over,
+ * but omits the `pointerEvent` property from {@link TClickPayload}.
+ *
+ * @see {@link TClickPayload}
+ */
 export type THoverPayload = Omit<TClickPayload, "pointerEvent">;
 type TCameraStateChangePayload = CameraSystemState & {
 	autoMinZoomLevel: Core["camera"]["autoMinZoomLevel"];
@@ -22727,13 +22834,20 @@ export type TStateChangedInternalPayload = Partial<{
 	Navigation: NavigationState;
 	manualFloorVisibility: boolean;
 }>;
-type TFloorChangePayload = {
+/**
+ * Describes the payload delivered with floor change events.
+ *
+ * This type provides context when a floor change occurs within the map,
+ * such as user-initiated level switches, programmatic navigation, or automatic changes.
+ * It specifies both the current and previous floors for the transition, as well as an optional reason.
+ */
+export type TFloorChangePayload = {
 	/**
-	 * The floor that is being changed to.
+	 * The {@link Floor} which the map is changing to.
 	 */
 	floor: Floor;
 	/**
-	 * The floor that is being changed from.
+	 * The {@link Floor} that was active before the change.
 	 */
 	previousFloor: Floor;
 	/**
@@ -22765,7 +22879,7 @@ export type TEvents = {
 	/**
 	 * Emitted when the map is hovered over with a mouse.
 	 */
-	hover: Omit<THoverPayload, "pointerEvent">;
+	hover: THoverPayload;
 	/**
 	 * Emitted when the camera's view changes.
 	 */
@@ -23238,6 +23352,12 @@ export type TAddPathOptions = {
 	 * @defaultValue false
 	 */
 	visibleThroughGeometry?: boolean;
+	/**
+	 * The opacity of the path when it's behind geometry (x-ray effect). Value from 0 to 1.
+	 *
+	 * @defaultValue 0.25
+	 */
+	xrayOpacity?: number;
 };
 /**
  * Defines the priority levels for collider collision handling, allowing customization of collider visibility in congested areas.
@@ -23394,7 +23514,7 @@ export type TAddModelOptions = Omit<InitializeModelState, "scale" | "url"> & {
 };
 type TAddText3DOptions = AddText3DOptions;
 /**
- * Options for controlling the behavior of an {@link Image}.
+ * Options for controlling the behavior of an {@link Image3DView}.
  */
 export type TAddImageOptions = {
 	/**
@@ -23422,7 +23542,7 @@ export type TAddImageOptions = {
 	 */
 	verticalOffset?: number;
 	/**
-	 * Attempt to keep the image facing the camera as much as possible
+	 * If true, the image will automatically rotate to face the camera, creating a billboard effect.
 	 *
 	 * @default false
 	 */
@@ -23482,6 +23602,7 @@ export type TAddMarkerOptions = {
 		/**
 		 * Whether to enable low priority pin strategy when all anchor positions have collisions.
 		 * @default true
+		 * @deprecated add 'hidden' to the placement array instead
 		 */
 		enabled?: boolean;
 		/**
@@ -23495,6 +23616,11 @@ export type TAddMarkerOptions = {
 		 */
 		color?: string;
 	};
+	/**
+	 * Whether the marker should be occluded by 3D geometry.
+	 * @default true
+	 */
+	occlude?: boolean;
 };
 /**
  * Options for creating a new {@link Label} with {@link Labels.add}.
@@ -23526,6 +23652,11 @@ export type TAddLabelOptions = {
 	 * The placement of the text relative to the pin.
 	 */
 	textPlacement?: LabelTextPlacement[];
+	/**
+	 * Whether the label should be occluded by 3D geometry.
+	 * @default true
+	 */
+	occlude?: boolean;
 };
 type LanguagePackHydrationItem = {
 	language: Language;
@@ -23535,7 +23666,10 @@ type LanguagePackHydrationItem = {
  * All map elements which have state.
  */
 export type MapElementsWithState = WithState<MapDataElements | MapViewElements | DOORS | WALLS>;
-type WithState<T> = T extends {
+/**
+ * Filter type that extracts only elements which have state.
+ */
+export type WithState<T> = T extends {
 	__type: infer U;
 } ? U extends keyof MapElementToGetState ? T : never : T extends string ? T extends keyof MapElementToGetState ? T : never : never;
 /**
@@ -23606,7 +23740,10 @@ export type TMapDataObjectTypes = {
 	[Area.__type]: Area;
 	[Facade.__type]: Facade;
 };
-type TMapViewObjectTypes = {
+/**
+ * Associates MapView type strings with their corresponding classes.
+ */
+export type TMapViewObjectTypes = {
 	[Label.__type]: Label;
 	[Marker.__type]: Marker;
 	[Model.__type]: Model;
@@ -23616,20 +23753,34 @@ type TMapViewObjectTypes = {
 	[Image3DView.__type]: Image3DView;
 	[Text3DView.__type]: Text3DView;
 };
-type TMapFeatureTypes = TMapDataObjectTypes & TMapViewObjectTypes;
-type MapFeatureOfType<T extends string> = T extends keyof TMapFeatureTypes ? TMapFeatureTypes[T] : never;
+/**
+ * Associates MapData and MapView type strings with their corresponding classes.
+ *
+ * This is a union of {@link TMapDataObjectTypes} and {@link TMapViewObjectTypes}, providing
+ * a complete mapping of all map feature type strings to their class types.
+ */
+export type TMapFeatureTypes = TMapDataObjectTypes & TMapViewObjectTypes;
+/**
+ * Returns the class type for a given type string.
+ */
+export type MapFeatureOfType<T extends string> = T extends keyof TMapFeatureTypes ? TMapFeatureTypes[T] : never;
 type TImagePlacementOptions = ImagePlacementOptions;
-type TCameraInteractionsSetOptions = {
+/**
+ * Options to control which camera interactions are enabled in the MapView.
+ *
+ * All values are optional; if omitted, the corresponding interaction will not be changed.
+ */
+export type TCameraInteractionsSetOptions = {
 	/**
-	 * Whether to enable panning.
+	 * Whether to enable panning (dragging the map).
 	 */
 	pan?: boolean;
 	/**
-	 * Whether to enable zooming.
+	 * Whether to enable zooming (scroll or pinch).
 	 */
 	zoom?: boolean;
 	/**
-	 * Whether to enable bearing and pitch.
+	 * Whether to enable bearing (rotation) and pitch (tilting).
 	 */
 	bearingAndPitch?: boolean;
 };
@@ -23670,17 +23821,25 @@ type TGetInViewOptions = Partial<{
 	screenOffsets: Partial<InsetPadding>;
 	fullyContains: boolean;
 }>;
-type TPathSectionHighlightOptions = {
+/**
+ * Configuration options for highlighting a specific section of a path on the map.
+ * These options allow you to visually emphasize a segment of a path using custom color, width,
+ * and animation duration for user interaction or navigation purposes.
+ */
+export type TPathSectionHighlightOptions = {
 	/**
-	 * The color of the highlight.
+	 * The highlight color for the path section (CSS color string).
+	 * @default 'red'
 	 */
 	color?: string;
 	/**
-	 * The width multiplier of the highlight.
+	 * Multiplies the base path width by this factor for the duration of the highlight.
+	 * @default 1
 	 */
 	widthMultiplier?: number;
 	/**
-	 * The duration of the highlight animation.
+	 * Duration of the highlight animation in milliseconds.
+	 * @default 1500
 	 */
 	animationDuration?: number;
 };
@@ -23694,21 +23853,26 @@ export type TTakeScreenshotOptions = {
 	 */
 	withOutdoorContext?: boolean;
 };
-type TCoordinateParams = {
+/**
+ * Parameters for creating a {@link Coordinate}.
+ *
+ * Used with the {@link Coordinate} constructor or {@link MapView.createCoordinate} method to create a coordinate on the map.
+ */
+export type TCoordinateParams = {
 	/**
-	 * The latitude of the coordinate in decimal degrees.
+	 * The latitude of the {@link Coordinate}.
 	 */
 	latitude: number;
 	/**
-	 * The longitude of the coordinate in decimal degrees.
+	 * The longitude of the {@link Coordinate}.
 	 */
 	longitude: number;
 	/**
-	 * Optional ID of the floor this coordinate is on.
+	 * Optional ID of the {@link Floor} this {@link Coordinate} is on.
 	 */
 	floorId?: string;
 	/**
-	 * Optional vertical offset from the floor in meters.
+	 * Optional vertical offset from the {@link Floor} in meters.
 	 */
 	verticalOffset?: number;
 };
@@ -23997,6 +24161,7 @@ export declare class LocationProfile extends BaseMetaData implements LocationDat
 	 * @format uri
 	 */
 	icon?: ImageMetaData;
+	/** @internal */
 	constructor(data: MapDataInternal, options: {
 		mvfData: MVFLocation;
 	});
@@ -24081,13 +24246,15 @@ declare abstract class BaseMapData {
 	get geoJSONBoundingBox(): BBox | undefined;
 	get geoJSON(): Feature$1<Polygon$1 | MultiPolygon$1 | LineString | Point$1, null>;
 }
-type PropertiesWithDetails = {
+export declare abstract class DetailedMapData<MVFData extends MVFFeature<Geometry, {
 	id: string;
 	externalId?: string;
 	details?: Details;
-};
-declare abstract class DetailedMapData<MVFData extends MVFFeature<Geometry, PropertiesWithDetails>> extends BaseMapData {
+}>> extends BaseMapData {
 	#private;
+	/**
+	 * @internal
+	 */
 	constructor(data: MapDataInternal, mvfData: MVFData);
 	/**
 	 * Gets the external identifier of the map feature.
@@ -24131,6 +24298,20 @@ declare abstract class DetailedMapData<MVFData extends MVFFeature<Geometry, Prop
 	 * @returns {LocationProfile[]} An array of location profiles.
 	 */
 	get locationProfiles(): LocationProfile[];
+	/**
+	 * Serializes DetailedMapData fields to a plain object.
+	 * Internal method for use by bridge serialization.
+	 *
+	 * @internal
+	 */
+	_serializeDetailedMapData(): {
+		externalId: string;
+		name: string;
+		description: string;
+		images: ImageMetaData[];
+		links: Hyperlink[];
+		locationProfiles: LocationProfile[];
+	};
 }
 /**
  * An Area represents some grouping of multiple pieces of geometry, not
@@ -24793,6 +24974,11 @@ export declare class MapObject extends DetailedMapData<ObstructionFeature> imple
 	 */
 	destroy(): void;
 }
+type PartialExcept<T, K extends string> = {
+	[P in keyof T as P extends K ? P : never]: T[P];
+} & {
+	[P in keyof T as P extends K ? never : P]?: T[P] extends Primitive$1 ? T[P] : T[P] extends (infer U)[] ? PartialExcept<U, K>[] : PartialExcept<T[P], K>;
+};
 type TokenWithExpiration = {
 	token: string;
 	expires?: number;
@@ -24814,7 +25000,7 @@ type TokenManagerEvents = {
 		sasTokens: Record<string, TokenWithExpiration>;
 	};
 };
-type TokenManagerPubSub = PubSub<TokenManagerEvents>;
+type TokenManagerPubSub = PubSub$1<TokenManagerEvents>;
 declare class TokenManager {
 	#private;
 	constructor(mapIds: string[], options: TokenManagerOptions);
@@ -25778,7 +25964,7 @@ export declare class EnterpriseVenue extends BaseMetaData implements MVFEnterpri
 	 */
 	destroy(): void;
 }
-export type TQueriables = PointOfInterest | Door | Annotation | Node$1 | Space;
+export type TQueriables = PointOfInterest | Door | Annotation | Node$1 | Space | EnterpriseLocation;
 /**
  * Query allows users to query for nodes, locations, categories, and other points of interest within the venue.
  */
@@ -25862,6 +26048,7 @@ export declare class LocationCategory extends BaseMetaData implements Omit<MVFCa
 	 * @format uri
 	 */
 	icon: string;
+	/** @internal */
 	constructor(data: MapDataInternal, options: {
 		mvfData: MVFCategory;
 	});
@@ -25907,7 +26094,7 @@ export type TFindPreferredLanguageInVenueOptions = {
  * @returns An object containing the selected language code and name, or undefined if no language is found
  */
 export declare function findPreferredLanguageInVenue(venue: EnterpriseVenue, options?: TFindPreferredLanguageInVenueOptions): Language;
-declare class MapDataInternal extends PubSub<{
+declare class MapDataInternal extends PubSub$1<{
 	"language-change": {
 		code: string;
 		name: string;
@@ -26332,6 +26519,165 @@ export declare class Search {
 	 */
 	enable(): Promise<void>;
 }
+/**
+ * Represents the environment state configuration.
+ * @example
+ * const mapData = getMapData({
+ *  key: '',
+ *  secret: '',
+ *  environment: 'eu'
+ * })
+ */
+type Environment$1 = {
+	/**
+	 * The base URI for the API.
+	 */
+	baseUri: string;
+	/**
+	 * The base URI for authentication.
+	 */
+	baseAuthUri: string;
+	/**
+	 * The base URI for analytics.
+	 */
+	analyticsBaseUri: string;
+	/**
+	 * The URI for the tile server.
+	 */
+	tileServerUri: string;
+};
+type ServiceEnvironment$1 = "us" | "eu";
+/**
+ * Options for configuring search functionality.
+ */
+type TSearchOptions$1 = {
+	/**
+	 * Indicates whether search functionality is enabled.
+	 */
+	enabled: boolean;
+};
+type TGetMapDataSharedOptions$1 = {
+	/**
+	 * Mappedin map ID.
+	 */
+	mapId: string;
+	/**
+	 * Optionally provide a custom base URL for the Mappedin API request.
+	 * Use the {@link Environment | `environment`} setting to switch environments
+	 */
+	baseUri?: string;
+	/**
+	 * Optionally provide a custom base URL for authentication when obtaining an access token.
+	 * Use the {@link Environment | `environment`} setting to switch environments.
+	 */
+	baseAuthUri?: string;
+	/**
+	 * Optionally provide an entirely custom URL for authentication when obtaining an access token.
+	 * @hidden
+	 * @internal
+	 */
+	customAuthUri?: string;
+	/**
+	 * Callback for when the Mappedin map data has been fetched and parsed as Mappedin Venue Format (MVF) data.
+	 * @param mvf Parsed MVF data.
+	 */
+	onMVFParsed?: (mvf: ParsedMVF) => void;
+	/**
+	 * Load different view of mvf data based on configId
+	 */
+	viewId?: string;
+	/**
+	 * set the target SDK environment
+	 * @default 'us'
+	 * @example
+	 * const mapData = getMapData({
+	 *  key: '',
+	 *  secret: '',
+	 *  environment: 'eu'
+	 * })
+	 */
+	environment?: ServiceEnvironment$1;
+	/**
+	 * The language of the map data.
+	 * The ISO 639-1 language code to change to (e.g., 'en' for English, 'fr' for French). Check ({@link EnterpriseVenue.languages}) for available languages
+	 */
+	language?: string;
+	/**
+	 * Whether to use browser's language settings as fallback if the supplied language code is not available.
+	 * @default true
+	 * */
+	fallbackToNavigatorLanguage?: boolean;
+	/**
+	 * Analytics configuration.
+	 */
+	analytics?: {
+		/**
+		 * Whether to log analytics events.
+		 * @default false
+		 */
+		logEvents?: boolean;
+		/**
+		 * Whether to send analytics events to the server.
+		 * @default false
+		 */
+		sendEvents?: boolean;
+		/**
+		 * Custom base URI for analytics requests. If not provided, the default analytics endpoint will be used.
+		 * Use the {@link Environment | `environment`} setting to switch environments.
+		 */
+		baseUri?: string;
+		/**
+		 * Context for analytics events.
+		 * @default 'websdk'
+		 * @internal
+		 */
+		context?: string;
+		/**
+		 * Version override for analytics events.
+		 * @internal
+		 */
+		version?: string;
+	};
+	search?: TSearchOptions$1;
+	/**
+	 * Fetch bearer and SAS tokens for the map ahead of time and keep them up to date in the background.
+	 * @default true
+	 */
+	prefetchTokens?: boolean;
+	/**
+	 * @hidden
+	 * @internal
+	 */
+	layoutId?: "draft";
+	/**
+	 * @hidden
+	 * @internal
+	 */
+	mvfVersion?: "2.0.0" | "2.0.0-c" | "3.0.0";
+};
+/**
+ * @interface
+ */
+type TGetMapDataWithCredentialsOptions$1 = {
+	/**
+	 * Mappedin auth key.
+	 */
+	key: string;
+	/**
+	 * Mappedin auth secret.
+	 */
+	secret: string;
+} & TGetMapDataSharedOptions$1;
+/**
+ * @interface
+ */
+type TGetMapDataWithAccessTokenOptions$1 = {
+	/**
+	 * Mappedin access token.
+	 */
+	accessToken: string;
+} & TGetMapDataSharedOptions$1;
+type TGetMapDataOptions$1 = TGetMapDataWithCredentialsOptions$1 | TGetMapDataWithAccessTokenOptions$1;
 export type THydrateMapDataBundle = {
 	type: "binary";
 	options?: {
@@ -26364,7 +26710,7 @@ export type THydrateMapDataBundle = {
 /**
  * Load a MapData instance from a backup including language packs. Pass in userOptions to ensure outdoor view is available.
  */
-export declare const hydrateMapData: (backup: THydrateMapDataBundle | TMVF, userOptions?: TGetMapDataOptions) => Promise<MapData>;
+export declare const hydrateMapData: (backup: THydrateMapDataBundle | TMVF, userOptions?: TGetMapDataOptions$1) => Promise<MapData>;
 /**
  * ## MapData in Mappedin JS
  *
@@ -27086,13 +27432,13 @@ export declare const MAPPEDIN_COLORS: {
 	lightTeal: string;
 };
 export type VisibilityState = {
-	outdoorOpacity: number;
+	outdoorOpacity: number | "initial";
 	floorStates: {
 		floor?: Floor;
 		state: TFloorState;
 	}[];
 };
-export declare function getMultiFloorState(floors: Floor[], currentFloor: Floor, floorGap: (number | "auto") | undefined, floorIdsInNavigation: Floor["id"][], floorsVisualHeightMap?: Map<number, {
+export declare function getMultiFloorState(floors: Floor[], currentFloor: Floor, floorGap: number | "auto" | undefined, floorIdsInNavigation: Floor["id"][], floorsVisualHeightMap?: Map<number, {
 	altitude: number;
 	effectiveHeight: number;
 }>): VisibilityState;
@@ -27355,7 +27701,7 @@ export type TShow3DMapOptions = {
  *
  * Returns a {@link MapData} instance from a parsed MVF object.
  */
-export declare const hydrateMapDataFromMVF: (mvf: TMVF, options?: TGetMapDataWithCredentialsOptions & {
+export declare const hydrateMapDataFromMVF: (mvf: TMVF, options?: TGetMapDataWithCredentialsOptions$1 & {
 	languagePacks?: LanguagePackHydrationItem[];
 }) => Promise<MapData>;
 /**
@@ -27387,12 +27733,12 @@ export declare function shouldForceEnterpriseLocations(): boolean;
  * @example
  * const data = await getMapData({ key: 'api_key', secret: 'api_secret', mapId: 'id' });
  */
-export declare const getMapData: (userOptions: TGetMapDataOptions) => Promise<MapData>;
+export declare const getMapData: (userOptions: TGetMapDataOptions$1) => Promise<MapData>;
 /**
  * @internal
  * @deprecated Use {@link getMapData} and enterprise will be inferred from key/secret.
  */
-export declare const getMapDataEnterprise: (userOptions: TGetMapDataOptions) => Promise<MapData>;
+export declare const getMapDataEnterprise: (userOptions: TGetMapDataOptions$1) => Promise<MapData>;
 /**
  * @internal
  *
@@ -27450,19 +27796,26 @@ declare namespace z {
 
 export {
 	Camera$3 as Camera,
+	Environment$1 as Environment,
 	Feature$1 as Feature,
 	FeatureCollection$1 as FeatureCollection,
 	GeoJSON$1 as GeoJSON,
 	Geometry$1 as Geometry,
+	LocationSocial,
 	LocationState,
 	MultiPolygon$1 as MultiPolygon,
 	Node$1 as Node,
 	OperationHours,
 	Point$1 as Point,
 	Polygon$1 as Polygon,
+	PubSub$1 as PubSub,
 	RendererState as TRendererState,
 	SiblingGroup,
 	Style$2 as Style,
+	TGetMapDataOptions$1 as TGetMapDataOptions,
+	TGetMapDataSharedOptions$1 as TGetMapDataSharedOptions,
+	TGetMapDataWithAccessTokenOptions$1 as TGetMapDataWithAccessTokenOptions,
+	TGetMapDataWithCredentialsOptions$1 as TGetMapDataWithCredentialsOptions,
 	TImage3DState as TImageState,
 	TImage3DUpdateState as TImageUpdateState,
 	TMVF,
@@ -27471,6 +27824,7 @@ export {
 	TMVFPolygonStyle,
 	TMVFStyle,
 	TMVFStyleCollection,
+	TSearchOptions$1 as TSearchOptions,
 	parseMVFv2 as parseMVF,
 	unzipMVFv2 as unzipMVF,
 };