@mappedin/mappedin-js 6.6.0 → 6.8.0

package/lib/esm/index.d.ts

@@ -1,8 +1,8 @@
 import { Color as Color$1, CompositeExpression, DiffCommand, DiffOperations, Feature as Feature$2, FeatureFilter, FeatureState, FilterSpecification, Formatted, FormattedSection, GlobalProperties, ICanonicalTileID, IMercatorCoordinate, InterpolationType, LayerSpecification, LightSpecification, Padding, ProjectionSpecification, PromoteIdSpecification, PropertyValueSpecification, ResolvedImage, SkySpecification, SourceExpression, SourceSpecification, SpriteSpecification, StylePropertyExpression, StylePropertySpecification, StyleSpecification, TerrainSpecification, TransitionSpecification, VariableAnchorOffsetCollection } from '@maplibre/maplibre-gl-style-spec';
-import { AnnotationCollection, AnnotationSymbol, AreaCollection, AreaId, BaseTextAreaProperties, Category as MVFCategory, CategoryId, Connection as MVFConnection, Details, EnterpriseCategory as MVFEnterpriseCategory, EnterpriseCategory as MvfEnterpriseCategory, EnterpriseCategoryId as MVFEnterpriseCategoryId, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseLocation as MvfEnterpriseLocation, EnterpriseLocationId as MVFEnterpriseLocationId, EnterpriseLocationInstance, EnterpriseTexture, EnterpriseVenue as MVFEnterpriseVenue, EntranceCollection, EntranceFeature, Facade as MVFFacade, Feature, Feature as MVFFeature, FeatureCollection, FloatingFloorTextProperties, FloorCollection, FloorId, FloorProperties as MVFFloor, FloorProperties as MvfFloor, FloorStack as MVFFloorStack, FloorStack as MvfFloorStack, FloorTextCommonProperties, Geometry, Hyperlink as MVFHyperlink, Image as MVFImage, Language, LineStringStyle, LineStringStyle as TMVFLineStringStyle, Location as MVFLocation, LocationId, LocationLink, LocationSocial, LocationState, MultiPolygon, NavigationFlagDeclarations, NodeCollection, NodeCollection as MVFNodeCollection, NodeId, ObstructionCollection, ObstructionFeature, ObstructionId, ObstructionProperties, OpeningHoursSpecification, OperationHours, ParsedMVF, ParsedMVF as TMVF, ParsedMVFLocalePack, Point, PointStyle, PointStyle as TMVFPointStyle, Polygon, PolygonStyle, PolygonStyle as TMVFPolygonStyle, SiblingGroup, SpaceCollection, SpaceFeature, SpaceId, SpaceProperties, Style as TMVFStyle, StyleCollection, StyleCollection as TMVFStyleCollection, TilesetStyle } from '@mappedin/mvf-v2';
-import { ParsedMVF, RawMVF } from '@mappedin/mvf-v2/no-validator';
+import { AnnotationCollection, AnnotationSymbol, AreaCollection, AreaId, BaseTextAreaProperties, Category as MVFCategory, CategoryId, Connection as MVFConnection, Details, EnterpriseCategory as MVFEnterpriseCategory, EnterpriseCategory as MvfEnterpriseCategory, EnterpriseCategoryId as MVFEnterpriseCategoryId, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseLocation as MvfEnterpriseLocation, EnterpriseLocationId as MVFEnterpriseLocationId, EnterpriseLocationInstance, EnterpriseTexture, EnterpriseVenue as MVFEnterpriseVenue, EnterpriseVenueType, EntranceCollection, EntranceFeature, Facade as MVFFacade, Feature, Feature as MVFFeature, FeatureCollection, FloatingFloorTextProperties, FloorCollection, FloorId, FloorProperties as MVFFloor, FloorProperties as MvfFloor, FloorStack as MVFFloorStack, FloorStack as MvfFloorStack, FloorTextCommonProperties, Geometry, Hyperlink as MVFHyperlink, Image as MVFImage, Language, LineStringStyle, LineStringStyle as TMVFLineStringStyle, Location as MVF2Location, LocationId, LocationLink, LocationSocial, LocationState, MultiPolygon, NavigationFlagDeclarations, NodeCollection, NodeCollection as MVFNodeCollection, NodeId, ObstructionCollection, ObstructionFeature, ObstructionId, ObstructionProperties, OpeningHoursSpecification, OperationHours, ParsedMVF, ParsedMVF as TMVF, ParsedMVFLocalePack, ParsedMVFv3, Point, PointStyle, PointStyle as TMVFPointStyle, Polygon, PolygonStyle, PolygonStyle as TMVFPolygonStyle, SiblingGroup, SpaceCollection, SpaceFeature, SpaceId, SpaceProperties, Style as TMVFStyle, StyleCollection, StyleCollection as TMVFStyleCollection, TilesetStyle } from '@mappedin/mvf-v2';
+import { ParsedMVF, ParsedMVFv3, RawMVF } from '@mappedin/mvf-v2/no-validator';
 import { Group as TweenGroup, Tween } from '@tweenjs/tween.js';
-import { AmbientLight, BatchedMesh, BatchedMeshGeometryRange, BufferAttribute, BufferGeometry, Camera, Camera as ThreeCamera, Color, DirectionalLight, Group, Intersection, LineSegments, Mesh, MeshLambertMaterial, MeshLambertMaterialParameters, Object3D, Object3DEventMap, PerspectiveCamera, Plane, PlaneGeometry, Raycaster, Scene, ShaderMaterial, Texture, TubeGeometry, Vector2, Vector3, WebGLRenderer } from 'three';
+import { AmbientLight, BatchedMesh, BatchedMeshGeometryRange, Box3, BufferAttribute, BufferGeometry, Camera, Camera as ThreeCamera, Color, DirectionalLight, Group, Intersection, LineSegments, Mesh, MeshLambertMaterial, MeshLambertMaterialParameters, Object3D, Object3DEventMap, PerspectiveCamera, Plane, PlaneGeometry, Raycaster, Scene, ShaderMaterial, Texture, TubeGeometry, Vector2, Vector3, WebGLRenderer } from 'three';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 
 declare const VALID_CONTEXTS: readonly [
@@ -576,7 +576,11 @@ declare function createEnvControl(): {
 	__getState: () => Environment;
 };
 type EnvControl = ReturnType<typeof createEnvControl>;
-export declare function unzipAndParseMVFv2(data: Uint8Array, inputVersion?: string): Promise<ParsedMVF>;
+type ParsedMVFResult = {
+	mvf2: ParsedMVF;
+	mvf3?: ParsedMVFv3;
+};
+export declare function unzipAndParseMVFv2(data: Uint8Array, inputVersion?: string): Promise<ParsedMVFResult>;
 type TDrawFn = (ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, x: number, y: number) => void;
 type MaterialSide = "back" | "front" | "double";
 type Style = {
@@ -1009,6 +1013,7 @@ declare class BatchedStandardMaterial extends MeshLambertMaterial {
 	removeSideTexture(batchId: number): void;
 	removeTopTexture(batchId: number): void;
 	dispose(): void;
+	clone(params?: MeshLambertMaterialParameters): this;
 }
 interface StandardSchemaV1<Input = unknown, Output = Input> {
 	/** The Standard Schema properties. */
@@ -4837,6 +4842,44 @@ type PathState = {
 	 * Only applies when smoothingTension > 0.
 	 */
 	smoothingCornerRadius: number;
+	/**
+	 * Whether the path should be rendered as a dashed line.
+	 */
+	dashed: boolean;
+	/**
+	 * Length of each dash segment as fraction of path (0-1).
+	 */
+	dashLength: number;
+	/**
+	 * Length of each gap between dashes as fraction of path (0-1).
+	 */
+	dashGap: number;
+	/**
+	 * When true, dashSize and gapSize are interpreted as multiples of path width.
+	 * When false, dashLength and dashGap are used as fractions of path length.
+	 */
+	dashRelativeToWidth: boolean;
+	/**
+	 * Length of each dash as a multiple of path width. Only used when dashRelativeToWidth is true.
+	 */
+	dashSize: number;
+	/**
+	 * Length of each gap as a multiple of path width. Only used when dashRelativeToWidth is true.
+	 */
+	gapSize: number;
+	/**
+	 * When true, dashMeters and gapMeters are used as absolute sizes in meters.
+	 * Takes precedence over dashRelativeToWidth.
+	 */
+	dashAbsolute: boolean;
+	/**
+	 * Length of each dash in meters. Only used when dashAbsolute is true.
+	 */
+	dashMeters: number;
+	/**
+	 * Length of each gap in meters. Only used when dashAbsolute is true.
+	 */
+	gapMeters: number;
 };
 type AddPathOptions = {
 	/**
@@ -4908,6 +4951,48 @@ type AddPathOptions = {
 	 * @default 0.0
 	 */
 	smoothingCornerRadius?: number;
+	/**
+	 * Length of each dash segment as fraction of path (0-1).
+	 * @default 0.1
+	 */
+	dashLength?: number;
+	/**
+	 * Length of each gap between dashes as fraction of path (0-1).
+	 * @default 0.1
+	 */
+	dashGap?: number;
+	/**
+	 * When true, dashSize and gapSize are interpreted as multiples of path width (deck.gl style).
+	 * When false (default), dashLength and dashGap are used as fractions of path length.
+	 * @default false
+	 */
+	dashRelativeToWidth?: boolean;
+	/**
+	 * Length of each dash as a multiple of path width. Only used when dashRelativeToWidth is true.
+	 * @default 3.0
+	 */
+	dashSize?: number;
+	/**
+	 * Length of each gap as a multiple of path width. Only used when dashRelativeToWidth is true.
+	 * @default 2.0
+	 */
+	gapSize?: number;
+	/**
+	 * When true, dashMeters and gapMeters are used as absolute sizes in meters.
+	 * Takes precedence over dashRelativeToWidth.
+	 * @default false
+	 */
+	dashAbsolute?: boolean;
+	/**
+	 * Length of each dash in meters. Only used when dashAbsolute is true.
+	 * @default 1.0
+	 */
+	dashMeters?: number;
+	/**
+	 * Length of each gap in meters. Only used when dashAbsolute is true.
+	 * @default 0.5
+	 */
+	gapMeters?: number;
 };
 declare class PathComponent {
 	#private;
@@ -4936,6 +5021,14 @@ declare class PathComponent {
 	dashed: boolean;
 	smoothingTension: number;
 	smoothingCornerRadius: number;
+	dashLength: number;
+	dashGap: number;
+	dashRelativeToWidth: boolean;
+	dashSize: number;
+	gapSize: number;
+	dashAbsolute: boolean;
+	dashMeters: number;
+	gapMeters: number;
 	/**
 	 * If the path is vertical it will be rebuilt whenever altitudeDirty = true. This will be set during the first render of the path.
 	 */
@@ -5129,8 +5222,15 @@ declare class OutlineComponent implements Outline {
 }
 declare class FocusableComponent {
 	readonly type: "focusable";
-	focusMesh?: Mesh;
 	dirty: boolean;
+	/**
+	 * Vertices of the geometry in world space
+	 */
+	vertices?: Vector3[];
+	/**
+	 * Bounding box computed from object for frustum culling
+	 */
+	boundingBox: Box3;
 }
 type TextureStyle = {
 	texture?: SingleTexture;
@@ -5387,6 +5487,38 @@ interface PathUniforms {
 		type: "f";
 		value: number;
 	};
+	dashLength: {
+		type: "f";
+		value: number;
+	};
+	dashGap: {
+		type: "f";
+		value: number;
+	};
+	dashRelativeToWidth: {
+		type: "b";
+		value: boolean;
+	};
+	dashSize: {
+		type: "f";
+		value: number;
+	};
+	gapSize: {
+		type: "f";
+		value: number;
+	};
+	dashAbsolute: {
+		type: "b";
+		value: boolean;
+	};
+	dashMeters: {
+		type: "f";
+		value: number;
+	};
+	gapMeters: {
+		type: "f";
+		value: number;
+	};
 }
 declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
 	/**
@@ -5397,13 +5529,37 @@ declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EV
 	/**
 	 * @private
 	 * @internal
+	 * AbortController for managing lifecycle and cleanup
 	 */
-	private _destroyed;
+	private _abortController;
+	/**
+	 * @protected
+	 * @internal
+	 * Tracks all cleanup functions for subscriptions made via on()
+	 */
+	protected _cleanupFunctions: Array<() => void>;
+	/**
+	 * Returns the AbortSignal for this PubSub instance.
+	 * Use this signal with APIs that support cancellation (fetch, addEventListener, etc.)
+	 * When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Automatically cleaned up when PubSub is destroyed
+	 * pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });
+	 * ```
+	 */
+	get signal(): AbortSignal;
 	/**
 	 * @private
 	 * @internal
 	 */
 	publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
+	/**
+	 * Subscribe a function to be called when the signal is aborted.
+	 * @param fn The function to call when the signal is aborted.
+	 */
+	onAbort<T extends (...args: any[]) => void>(fn: T): void;
 	/**
 	 * Subscribe a function to an event.
 	 *
@@ -5411,6 +5567,9 @@ declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EV
 	 * 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.
+	 * @param options Optional options object. If a signal is provided, the subscription will be
+	 * automatically cleaned up when that signal is aborted.
+	 * @returns A cleanup function that unsubscribes the event listener when called.
 	 * @example
 	 * // Subscribe to the 'click' event
 	 * const handler = (event) => {
@@ -5422,7 +5581,9 @@ declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EV
 	 */
 	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;
+	} ? EVENT_PAYLOAD[EVENT_NAME]["data"] : EVENT_PAYLOAD[EVENT_NAME]) => void, options?: {
+		signal?: AbortSignal;
+	}): () => void;
 	/**
 	 * Unsubscribe a function previously subscribed with {@link on}
 	 *
@@ -5443,6 +5604,7 @@ declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EV
 	/**
 	 * @private
 	 * @internal
+	 * Destroys the PubSub instance and automatically unsubscribes all listeners registered via on().
 	 */
 	destroy(): void;
 }
@@ -5702,13 +5864,37 @@ declare class PubSub$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof
 	/**
 	 * @private
 	 * @internal
+	 * AbortController for managing lifecycle and cleanup
+	 */
+	private _abortController;
+	/**
+	 * @protected
+	 * @internal
+	 * Tracks all cleanup functions for subscriptions made via on()
 	 */
-	private _destroyed;
+	protected _cleanupFunctions: Array<() => void>;
+	/**
+	 * Returns the AbortSignal for this PubSub instance.
+	 * Use this signal with APIs that support cancellation (fetch, addEventListener, etc.)
+	 * When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Automatically cleaned up when PubSub is destroyed
+	 * pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });
+	 * ```
+	 */
+	get signal(): AbortSignal;
 	/**
 	 * @private
 	 * @internal
 	 */
 	publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
+	/**
+	 * Subscribe a function to be called when the signal is aborted.
+	 * @param fn The function to call when the signal is aborted.
+	 */
+	onAbort<T extends (...args: any[]) => void>(fn: T): void;
 	/**
 	 * Subscribe a function to an event.
 	 *
@@ -5716,6 +5902,9 @@ declare class PubSub$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof
 	 * 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.
+	 * @param options Optional options object. If a signal is provided, the subscription will be
+	 * automatically cleaned up when that signal is aborted.
+	 * @returns A cleanup function that unsubscribes the event listener when called.
 	 * @example
 	 * // Subscribe to the 'click' event
 	 * const handler = (event) => {
@@ -5727,7 +5916,9 @@ declare class PubSub$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof
 	 */
 	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;
+	} ? EVENT_PAYLOAD[EVENT_NAME]["data"] : EVENT_PAYLOAD[EVENT_NAME]) => void, options?: {
+		signal?: AbortSignal;
+	}): () => void;
 	/**
 	 * Unsubscribe a function previously subscribed with {@link on}
 	 *
@@ -5748,6 +5939,7 @@ declare class PubSub$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof
 	/**
 	 * @private
 	 * @internal
+	 * Destroys the PubSub instance and automatically unsubscribes all listeners registered via on().
 	 */
 	destroy(): void;
 }
@@ -15989,12 +16181,6 @@ declare class DOMVisibilitySystem {
 	constructor(state: RendererState, domTree: Entity2DHTMLDivElementContainer);
 	update(): void;
 }
-declare class TwoDProjectionSystem {
-	state: RendererState;
-	project: (projection: Vector2, position: Vector3) => void;
-	constructor(state: RendererState, project: (projection: Vector2, position: Vector3) => void);
-	update(): void;
-}
 declare enum PINVISIBILITY {
 	/** The pin is visible. */
 	ACTIVE = 1,
@@ -16697,7 +16883,6 @@ declare class CameraSystem extends PubSub<CameraEvents> {
 	private addMouseEventListeners;
 	private addMouseMoveEventListeners;
 	private removeMouseMoveEventListeners;
-	private removeEventListeners;
 	private removeMouseUpEventListeners;
 	private onContextMenu;
 	private onMouseUp;
@@ -16818,7 +17003,11 @@ export declare const ANIMATION_TWEENS: {
 	"ease-out": (amount: number) => number;
 	"ease-in-out": (amount: number) => number;
 };
-declare class Camera$2 {
+declare class Camera$2 extends PubSub$1<{
+	"padding-change": {
+		padding: InsetPadding;
+	};
+}> {
 	#private;
 	/**
 	 * @internal
@@ -17111,7 +17300,7 @@ declare class ImageSystem extends PubSub$1<{
 	private naturalBearing;
 	private imagePlacementOptions;
 	private cameraFrustum;
-	constructor(rendererState: RendererState, convertTo3DMapPosition: Core["convertTo3DMapPosition"], projectToScreen: (projectVector: Vector2, position: Vector3) => void, initialBearing?: number, naturalBearing?: number, imagePlacementOptions?: ImagePlacementOptions);
+	constructor(rendererState: RendererState, convertTo3DMapPosition: Core["convertTo3DMapPosition"], projectToScreen: Core["project"], initialBearing?: number, naturalBearing?: number, imagePlacementOptions?: ImagePlacementOptions);
 	private createImageMesh;
 	private getOrDownloadImage;
 	/**
@@ -17140,28 +17329,51 @@ declare class GeometryInFocusSystem extends PubSub$1<{
 	focusablesDirty: boolean;
 	private state;
 	private camera;
+	private cameraFrustum;
+	private viewProjectionMatrix;
+	private tempScreenPos;
 	private debugEl;
-	private raycasters;
 	private collisions;
 	private focusableEntities;
-	private debugRaycasters;
-	constructor(state: RendererState, camera: PerspectiveCamera);
+	private debug;
+	private debugBBoxElements;
+	private viewfinder;
+	private screenBoundsMap;
+	private screenDiagonal;
+	constructor(state: RendererState, camera: Camera);
 	resize(): void;
 	/**
-	 * Build 5 raycasters, one for the center of the screen, and one for each corner of the screen.
-	 * the center one has the highest weight, and the corners have the lowest weight.
-	 * this allows us to detect focus closer to the center of the screen more easily.
+	 * Everything within this square is considered "in focus" and ranked based on proximity to center.
+	 */
+	private createViewfinder;
+	/**
+	 * Filters vertices to keep only those on the perimeter (convex hull)
+	 * @param vertices - Array of all vertices in world space
+	 * @returns Array of perimeter vertices in world space
+	 */
+	private simplifyVertices;
+	/**
+	 * Computes screen-space bounding box and depth info from world-space vertices
+	 * Projects all vertices to clip space and finds the bounding box
+	 * Culls if the bounding box doesn't intersect the camera frustum
+	 *
+	 * @param focusableComponent - Component containing vertices and/or bounding box
+	 * @returns Screen-space bounding box and closest depth, or undefined if not visible
 	 */
-	private buildRaycasters;
+	private computeScreenSpaceBounds;
 	private updateFocusableEntities;
 	update: (cameraIsMoving?: boolean, cameraStoppedMovingTime?: number) => void;
 	updateRaf(): void;
-	raycast(): void;
-	showRaycasters(): void;
-	hideRaycasters(): void;
+	/**
+	 * Updates debug visualization for screen-space bounding boxes
+	 */
+	private updateDebugBBoxes;
+	compute(): void;
+	showDebug(): void;
+	hideDebug(): void;
 	destroy(): void;
 }
-declare class OutdoorLayers {
+declare class OutdoorLayers extends PubSub<{}> {
 	#private;
 	idleQueue: IdleQueue;
 	hideLayersIntersectingPolygons(polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[], layers: string[]): void;
@@ -17371,6 +17583,12 @@ declare class Core extends PubSub<MapEvent> {
 	 * @internal
 	 */
 	constructor(container: HTMLElement, options?: RendererCoreOptions);
+	/**
+	 * Projects a position into screen space. If a Vector3 is provided, the z-coordinate will include the depth from the camera.
+	 * @param projectVector - The vector to project the position into
+	 * @param position - The position to project
+	 */
+	private project;
 	/**
 	 * Add a container that can hold other containers, geometry groups, markers, labels and paths. Use this to group entities together.
 	 */
@@ -17624,16 +17842,7 @@ declare class Core extends PubSub<MapEvent> {
 	/**
 	 * Remove a MapLibre event listener
 	 */
-	offMapLibreEvent(event: keyof MapEventType, handler: (...args: any[]) => void): void;
-	/**
-	 * Returns true if the renderer has been aborted.
-	 */
-	get aborted(): boolean;
-	/**
-	 * Register a handler once to be called when the renderer is aborted.
-	 * The handler will be removed after it is called.
-	 */
-	onAbort(handler: () => void): void;
+	offMapLibreEvent(event: LiteralUnion<keyof MapEventType, string>, handler: (...args: any[]) => void): void;
 	/**
 	 * @internal for testing
 	 */
@@ -17662,7 +17871,7 @@ declare class Core extends PubSub<MapEvent> {
 	 * };
 	 * map.on('click', handler);
 	 */
-	on: <EventName extends keyof MapEvent>(eventName: EventName, fn: (payload: MapEventPayload<EventName>) => void) => void;
+	on: PubSub<MapEvent>["on"];
 	/**
 	 * Unsubscribe a function previously subscribed with {@link on}
 	 *
@@ -17677,7 +17886,7 @@ declare class Core extends PubSub<MapEvent> {
 	 * };
 	 * map.off('click', handler);
 	 */
-	off: <EventName extends keyof MapEvent>(eventName: EventName, fn: (payload: MapEventPayload<EventName>) => void) => void;
+	off: PubSub<MapEvent>["off"];
 	/**
 	 * @hidden
 	 * Returns the current cursor decided by Mappedin. This is useful when integrating with other overlays to show the correct user interaction.
@@ -18219,6 +18428,12 @@ type MapEvent = {
 	 * If outdoor view is enabled, this is fired when the style first loads or changes.
 	 */
 	"outdoor-style-loaded": undefined;
+	/**
+	 * Fired when outdoor style loading fails. The map will fall back to indoor-only rendering.
+	 */
+	"outdoor-style-error": {
+		error: unknown;
+	};
 	/**
 	 * Fired when the user starts interacting with the map.
 	 */
@@ -18249,9 +18464,6 @@ type MapEvent = {
 	resize: undefined;
 	"pan-bounds-change": PanBounds;
 };
-type MapEventPayload<EventName extends keyof MapEvent> = MapEvent[EventName] extends {
-	data: null;
-} ? MapEvent[EventName]["data"] : MapEvent[EventName];
 type All3DTypes = Geometry3DTypes | GeometryGroupObject3D | GroupContainerObject3D;
 type RendererState = {
 	/**
@@ -19082,7 +19294,10 @@ declare class FloorObject implements MVFFloor {
 	facadesByStyleId: Map<string, string[]>;
 	get geoJSONBoundingBox(): BBox | undefined;
 	constructor(parentId: string, floor: MVFFloor, mapObject: GeojsonApiMapObject, multiFloorView: Required<TShow3DMapOptions["multiFloorView"]>, options: TShow3DMapOptions, mvf?: ParsedMVF, styleMap?: AggregatedStyleMap, mapDataInternal?: MapDataInternal);
-	load: () => this;
+	/**
+	 * @param focusable - Whether the floor is part of a building and should be focusable. This will be set on the geometry layer.
+	 */
+	load: (focusable?: boolean) => this;
 	/**
 	 * Add an occluder to the floor if it has a footprint.
 	 */
@@ -19093,6 +19308,7 @@ declare class FloorObject implements MVFFloor {
 	get hasFacadeGeometry(): boolean;
 	get visible(): boolean;
 	setVisible(visible: boolean): void;
+	setBatchedTextVisible(visible: boolean): void;
 }
 declare class FloorStackObject implements Omit<MVFFloorStack, "maps" | "floors" | "defaultFloor" | "footprint"> {
 	#private;
@@ -19108,7 +19324,6 @@ declare class FloorStackObject implements Omit<MVFFloorStack, "maps" | "floors"
 	metadata?: MVFFloorStack["metadata"];
 	containerId: string;
 	facade?: MVFFacade;
-	private renderer;
 	constructor(floorStack: MVFFloorStack, parentId: string, renderer: Core, facade?: MVFFacade);
 	get defaultFloor(): FloorObject;
 	/**
@@ -21621,6 +21836,9 @@ declare const floorStateSchemaPartial: z.ZodObject<{
 		type: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"floor.areas">>>;
 		visible: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 	}, z.core.$strip>>;
+	text3d: z.ZodOptional<z.ZodObject<{
+		visible: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+	}, z.core.$strip>>;
 	type: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"floor">>>;
 	visible: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 	altitude: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
@@ -21668,6 +21886,9 @@ declare const floorStateSchemaStrict: z.ZodObject<{
 		type: z.ZodDefault<z.ZodLiteral<"floor.areas">>;
 		visible: z.ZodDefault<z.ZodBoolean>;
 	}, z.core.$strict>;
+	text3d: z.ZodObject<{
+		visible: z.ZodDefault<z.ZodBoolean>;
+	}, z.core.$strict>;
 	type: z.ZodDefault<z.ZodLiteral<"floor">>;
 	visible: z.ZodDefault<z.ZodBoolean>;
 	altitude: z.ZodDefault<z.ZodNumber>;
@@ -21899,6 +22120,24 @@ declare const pathStateSchemaPartial: z.ZodObject<{
 	xrayOpacity: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
 	__EXPERIMENTAL_SMOOTHING_TENSION: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
 	__EXPERIMENTAL_SMOOTHING_CORNER_RADIUS: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+	dashed: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+	__EXPERIMENTAL_DASH_OPTIONS: z.ZodOptional<z.ZodOptional<z.ZodDiscriminatedUnion<[
+		z.ZodObject<{
+			__EXPERIMENTAL_DASH_MODE: z.ZodLiteral<"length-scaling">;
+			__EXPERIMENTAL_DASH_LENGTH: z.ZodDefault<z.ZodNumber>;
+			__EXPERIMENTAL_DASH_GAP: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			__EXPERIMENTAL_DASH_MODE: z.ZodLiteral<"width-scaling">;
+			__EXPERIMENTAL_DASH_SIZE: z.ZodDefault<z.ZodNumber>;
+			__EXPERIMENTAL_GAP_SIZE: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			__EXPERIMENTAL_DASH_MODE: z.ZodLiteral<"absolute">;
+			__EXPERIMENTAL_DASH_METERS: z.ZodDefault<z.ZodNumber>;
+			__EXPERIMENTAL_GAP_METERS: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>
+	], "__EXPERIMENTAL_DASH_MODE">>>;
 }, z.core.$strip>;
 declare const pathStateSchemaStrict: z.ZodObject<{
 	type: z.ZodDefault<z.ZodLiteral<"path">>;
@@ -21915,9 +22154,27 @@ declare const pathStateSchemaStrict: z.ZodObject<{
 	xrayOpacity: z.ZodDefault<z.ZodNumber>;
 	__EXPERIMENTAL_SMOOTHING_TENSION: z.ZodDefault<z.ZodNumber>;
 	__EXPERIMENTAL_SMOOTHING_CORNER_RADIUS: z.ZodDefault<z.ZodNumber>;
+	dashed: z.ZodDefault<z.ZodBoolean>;
+	__EXPERIMENTAL_DASH_OPTIONS: z.ZodOptional<z.ZodDiscriminatedUnion<[
+		z.ZodObject<{
+			__EXPERIMENTAL_DASH_MODE: z.ZodLiteral<"length-scaling">;
+			__EXPERIMENTAL_DASH_LENGTH: z.ZodDefault<z.ZodNumber>;
+			__EXPERIMENTAL_DASH_GAP: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			__EXPERIMENTAL_DASH_MODE: z.ZodLiteral<"width-scaling">;
+			__EXPERIMENTAL_DASH_SIZE: z.ZodDefault<z.ZodNumber>;
+			__EXPERIMENTAL_GAP_SIZE: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			__EXPERIMENTAL_DASH_MODE: z.ZodLiteral<"absolute">;
+			__EXPERIMENTAL_DASH_METERS: z.ZodDefault<z.ZodNumber>;
+			__EXPERIMENTAL_GAP_METERS: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>
+	], "__EXPERIMENTAL_DASH_MODE">>;
 }, z.core.$strict>;
 export type TPathState = z.infer<typeof pathStateSchemaStrict>;
-export type TPathUpdateState = z.infer<typeof pathStateSchemaPartial>;
+export type TPathUpdateState = z.input<typeof pathStateSchemaPartial>;
 declare const shapeStateSchemaPartial: z.ZodObject<{
 	type: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"shape">>>;
 	visible: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
@@ -22509,6 +22766,12 @@ type GreedyLosOptions = BaseSimplifyOptions & {
 };
 type RdpOptions = BaseSimplifyOptions & {
 	__EXPERIMENTAL_METHOD: "rdp";
+	/**
+	 * Whether to include door-adjacent nodes (predecessor/successor of doors) in the must-include set.
+	 * When true, nodes immediately before and after doors are preserved during simplification.
+	 * @default true
+	 */
+	mustIncludeDoorBufferNodes?: boolean;
 };
 type DpOptimalOptions = BaseSimplifyOptions & {
 	__EXPERIMENTAL_METHOD: "dp-optimal";
@@ -23411,6 +23674,52 @@ export type TDirectionZone = {
 	 */
 	floor?: Floor;
 };
+type TExperimentalDashOptions = {
+	/**
+	 * Length-scaling mode: dash/gap as fractions of path length (0-1)
+	 */
+	__EXPERIMENTAL_DASH_MODE: "length-scaling";
+	/**
+	 * Dash length as fraction of path (0-1).
+	 * @default 0.1
+	 */
+	__EXPERIMENTAL_DASH_LENGTH?: number;
+	/**
+	 * Gap length as fraction of path (0-1).
+	 * @default 0.1
+	 */
+	__EXPERIMENTAL_DASH_GAP?: number;
+} | {
+	/**
+	 * Width-scaling mode: dash/gap as multiples of path width (deck.gl style)
+	 */
+	__EXPERIMENTAL_DASH_MODE: "width-scaling";
+	/**
+	 * Dash size as multiple of path width.
+	 * @default 3.0
+	 */
+	__EXPERIMENTAL_DASH_SIZE?: number;
+	/**
+	 * Gap size as multiple of path width.
+	 * @default 2.0
+	 */
+	__EXPERIMENTAL_GAP_SIZE?: number;
+} | {
+	/**
+	 * Absolute mode: dash/gap in meters (deterministic regardless of path length)
+	 */
+	__EXPERIMENTAL_DASH_MODE: "absolute";
+	/**
+	 * Dash length in meters.
+	 * @default 1.0
+	 */
+	__EXPERIMENTAL_DASH_METERS?: number;
+	/**
+	 * Gap length in meters.
+	 * @default 0.5
+	 */
+	__EXPERIMENTAL_GAP_METERS?: number;
+};
 /**
  * Options for controlling the behavior of a {@link Path}.
  */
@@ -23533,6 +23842,13 @@ export type TAddPathOptions = {
 	 * @defaultValue 0.5
 	 */
 	__EXPERIMENTAL_SMOOTHING_CORNER_RADIUS?: number;
+	/**
+	 * @experimental
+	 * Dash configuration. When dashed=true, controls dash/gap sizing.
+	 * Uses discriminated union - mode determines which properties are valid.
+	 * @see TExperimentalDashOptions
+	 */
+	__EXPERIMENTAL_DASH_OPTIONS?: TExperimentalDashOptions;
 };
 /**
  * Defines the priority levels for collider collision handling, allowing customization of collider visibility in congested areas.
@@ -23665,6 +23981,13 @@ export type TGetDirectionsOptions = {
 		 * Always uses line-of-sight validation (cannot be disabled).
 		 */
 		__EXPERIMENTAL_METHOD: "rdp";
+		/**
+		 * @experimental
+		 * Whether to include door-adjacent nodes (predecessor/successor of doors) in the must-include set.
+		 * When true (default), nodes immediately before and after doors are preserved during simplification.
+		 * @default true
+		 */
+		__EXPERIMENTAL_MUST_INCLUDE_DOOR_BUFFER_NODES?: boolean;
 	} | {
 		/**
 		 * Enable or disable path smoothing.
@@ -24378,7 +24701,8 @@ export declare class ImageMetaData extends BaseMetaData {
 	 */
 	destroy(): void;
 }
-type LocationData = Omit<MVFLocation, "categories" | "spaces" | "obstructions" | "entrances" | "shapes" | "connections" | "annotations" | "areas" | "openingHoursSpecification" | "links" | "pictures" | "website" | "icon"> & {
+type MVF3Location = Required<ParsedMVFv3>["locations"][number];
+type LocationData = Omit<MVF2Location, "categories" | "spaces" | "obstructions" | "entrances" | "shapes" | "connections" | "annotations" | "areas" | "openingHoursSpecification" | "links" | "pictures" | "website" | "icon"> & {
 	links: Hyperlink[];
 	images: ImageMetaData[];
 	icon?: ImageMetaData;
@@ -24433,9 +24757,28 @@ export declare class LocationProfile extends BaseMetaData implements LocationDat
 	 * @format uri
 	 */
 	icon?: ImageMetaData;
+	/**
+	 * Additional user defined data. The type is unknown, so it is recommended to validate the data before use.
+	 *
+	 * _Only available when loading MVFv3 data._
+	 *
+	 * ```ts
+	 * const mapData = await getMapData({
+	 *   ...
+	 *   mvfVersion: '3.0.0',
+	 * });
+	 *
+	 * const locationProfile = mapData.getById('location-profile', id);
+	 * if (typeof locationProfile?.extra?.myProperty === 'string') {
+	 * 	// Do something
+	 * }
+	 * ```
+	 */
+	extra?: Record<string, unknown>;
 	/** @internal */
 	constructor(data: MapDataInternal, options: {
-		mvfData: MVFLocation;
+		mvf2Data: MVF2Location;
+		mvf3Data?: MVF3Location;
 	});
 	/**
 	 * Gets the {@link Space}s associated with the location.
@@ -25357,6 +25700,7 @@ type TMapDataInternalOptions = {
 	binaryBundle?: Uint8Array;
 	tokenManager?: TokenManager;
 	getMapDataOptions?: TGetMapDataOptions;
+	mvf3?: ParsedMVFv3;
 };
 type MVFNodeFeature = MVFNodeCollection["features"][number];
 type MVFFloorFeature = FloorCollection["features"][number];
@@ -25803,6 +26147,7 @@ type MapDataRecords = {
 		[floorId: string]: AnnotationCollection["features"][number][];
 	};
 	mvfAreasById: Record<AreaId, AreaCollection["features"][number]>;
+	mvf3LocationsById: Record<string, Required<ParsedMVFv3>["locations"][number]>;
 };
 type EnterpriseMapDataRecords = {
 	connectionsByExternalId: Record<string, Connection[]>;
@@ -26212,6 +26557,10 @@ export declare class EnterpriseVenue extends BaseMetaData implements MVFEnterpri
 	 * The default map of the venue.
 	 */
 	get defaultMap(): string;
+	/**
+	 * The enterprise venue type.
+	 */
+	get enterpriseType(): EnterpriseVenueType | undefined;
 	/**
 	 * Serializes the EnterpriseVenue data to JSON.
 	 *