@mappedin/mappedin-js 6.1.2 → 6.3.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, 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 { 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 { Group as TweenGroup, Tween } from '@tweenjs/tween.js';
-import { BatchedMesh, BatchedMeshGeometryRange, BufferAttribute, BufferGeometry, Camera, Camera as ThreeCamera, Color, 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, 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 [
@@ -517,11 +517,11 @@ export type TGetMapDataOptions = TGetMapDataWithCredentialsOptions | TGetMapData
 /**
  * @internal
  */
-export declare function parseMVF(raw: RawMVF): ParsedMVF;
+declare function parseMVFv2(raw: RawMVF): ParsedMVF;
 /**
  * @internal
  */
-export declare function unzipMVF(data: Uint8Array): Promise<RawMVF>;
+declare function unzipMVFv2(data: Uint8Array): Promise<RawMVF>;
 type LocalePackUrls = {
 	[key: string]: string;
 };
@@ -580,6 +580,7 @@ type Style = {
 };
 declare class StyleComponent implements Style {
 	#private;
+	readonly type: "style";
 	initialColor: string;
 	set color(color: string);
 	get color(): string;
@@ -611,6 +612,7 @@ declare class StyleComponent implements Style {
 	constructor(style?: Partial<Style>);
 }
 declare class Text3DStyleComponent implements Partial<Text3DStyle> {
+	readonly type: "text3dStyle";
 	visible?: boolean;
 	altitude?: number;
 	color?: string;
@@ -839,6 +841,7 @@ type ModelStyle = {
 	clippingPlaneTopVisible: boolean;
 };
 declare class ModelStyleComponnet implements Partial<ModelStyle> {
+	readonly type: "modelStyle";
 	dirty: boolean;
 	visible: boolean;
 	opacity: number;
@@ -902,6 +905,7 @@ declare class GeometryGroupObject3D extends Object3D {
 	visible: boolean;
 	readonly type: "geometry-group";
 	components: never[];
+	getComponent(): void;
 	userData: {
 		entityId: string | number;
 		entities3D: Set<string | number>;
@@ -919,6 +923,7 @@ declare class GeometryGroupObject3D extends Object3D {
 	getfirstChildEntityId(): string | number | undefined;
 }
 declare class InteractionComponent {
+	type: "interaction";
 	hover: boolean | "user-interaction";
 	dirty: boolean;
 }
@@ -2003,10 +2008,10 @@ interface $ZodLiteral<T extends util.Literal = util.Literal> extends $ZodType {
 	_zod: $ZodLiteralInternals<T>;
 }
 declare const $ZodLiteral: $constructor<$ZodLiteral>;
-type _File = typeof globalThis extends {
+type _File$1 = typeof globalThis extends {
 	File: infer F extends new (...args: any[]) => any;
 } ? InstanceType<F> : {};
-interface File$1 extends _File {
+interface File$1 extends _File$1 {
 	readonly type: string;
 	readonly size: number;
 }
@@ -4679,6 +4684,10 @@ declare class ModelComponent {
 	color: Color;
 	setColor(): void;
 	clippingPlane?: Plane;
+	/**
+	 * The model scene that was loaded from GLB, minus the hole-fill-mesh business.
+	 */
+	get modelScene(): Object3D<import("three").Object3DEventMap> | Geometry3DObject3D | undefined;
 	position: Vector3;
 	get altitude(): number;
 	set altitude(value: number);
@@ -5007,6 +5016,7 @@ type Outline = {
 };
 declare class OutlineComponent implements Outline {
 	#private;
+	readonly type: "outline";
 	color: string;
 	dirty: boolean;
 	/** Controls whether the outline should be updated in the renderer */
@@ -5036,6 +5046,7 @@ declare class OutlineComponent implements Outline {
 	constructor(color: string);
 }
 declare class FocusableComponent {
+	readonly type: "focusable";
 	focusMesh?: Mesh;
 	dirty: boolean;
 }
@@ -5068,6 +5079,7 @@ type SingleTexture = {
 	];
 };
 declare class TextureComponent implements TextureStyle {
+	readonly type: "texture";
 	texture?: SingleTexture;
 	topTexture?: SingleTexture;
 	showTexture: boolean;
@@ -5084,6 +5096,7 @@ type Border = {
 	needsRebuild: boolean;
 };
 declare class BorderComponent implements Border {
+	readonly type: "border";
 	dirty: boolean;
 	needsRebuild: boolean;
 	set visible(visible: boolean);
@@ -5100,6 +5113,7 @@ type ClippingPlane = {
 	topVisible?: boolean;
 };
 declare class ClippingPlaneComponent implements ClippingPlane {
+	readonly type: "clippingPlane";
 	dirty: boolean;
 	needsRebuild: boolean;
 	verticalOffset: number;
@@ -5138,6 +5152,23 @@ declare class PatMeshContainer extends Geometry3DObject3D {
 }
 type MeshComponentTypes = MeshComponent | PathComponent | ModelComponent | CustomGeometryComponent | Text3DComponent | ImageComponent;
 type MappedComponentType<M> = M extends MeshComponent ? "geometry" : M extends PathComponent ? "path" : M extends ModelComponent ? "model" : M extends CustomGeometryComponent ? "custom-geometry" : M extends ImageComponent ? "image" : M extends Text3DComponent ? "text3d" : never;
+type ComponentTypeMap = {
+	interaction: InteractionComponent;
+	geometry: MeshComponent;
+	path: PathComponent;
+	model: ModelComponent;
+	"custom-geometry": CustomGeometryComponent;
+	image: ImageComponent;
+	text3d: Text3DComponent;
+	style: StyleComponent;
+	text3dStyle: Text3DStyleComponent;
+	modelStyle: ModelStyleComponnet;
+	outline: OutlineComponent;
+	focusable: FocusableComponent;
+	texture: TextureComponent;
+	border: BorderComponent;
+	clippingPlane: ClippingPlaneComponent;
+};
 declare class Geometry3D<M extends MeshComponentTypes = MeshComponent, S extends StyleComponent | Text3DStyleComponent | ModelStyleComponnet = StyleComponent, I extends InteractionComponent = InteractionComponent, T extends MappedComponentType<M> = MappedComponentType<M>, O extends OutlineComponent | undefined = OutlineComponent | undefined, F extends FocusableComponent | undefined = FocusableComponent | undefined, TX extends TextureComponent | undefined = TextureComponent | undefined, B extends BorderComponent | undefined = BorderComponent | undefined, C extends ClippingPlaneComponent | undefined = ClippingPlaneComponent | undefined> {
 	id: string | number;
 	components: [
@@ -5150,6 +5181,7 @@ declare class Geometry3D<M extends MeshComponentTypes = MeshComponent, S extends
 		TX?,
 		C?
 	];
+	getComponent<K extends keyof ComponentTypeMap>(type: K): ComponentTypeMap[K] | undefined;
 	/**
 	 * Parent geometry group ID
 	 */
@@ -15227,7 +15259,7 @@ declare class CollisionSystem extends PubSub<TCollisionSystemEvent, keyof TColli
 	working: boolean;
 	private _postMessage;
 	componentArray: (MarkerComponent | LabelComponent)[];
-	update: (watermarkWidth: number, watermarkHeight: number, watermarkPosition?: WatermarkPosition, isPanning?: boolean, staticColliders?: Rectangle[]) => void;
+	update: (watermarkWidth: number, watermarkHeight: number, watermarkPosition?: WatermarkPosition, lockStrategies?: boolean, staticColliders?: Rectangle[]) => void;
 	resize(watermarkWidth: number, watermarkHeight: number, watermarkPosition: WatermarkPosition): void;
 	/**
 	 * Resolve collisions
@@ -15265,7 +15297,7 @@ declare class TapsController {
 	destroy(): void;
 }
 type InteractionPayload = {
-	entity2D?: Geometry2D;
+	entity2D: Geometry2D[];
 	entity3D?: Geometry3D;
 	position?: Vector3;
 	groupContainers?: GroupContainerObject3D[];
@@ -15284,12 +15316,11 @@ type InteractionState = {
 	mouseDownStart: {
 		time: number;
 		timestamp: number;
-		offsetX: number;
-		offsetY: number;
+		clientX: number;
+		clientY: number;
 	} | undefined;
 };
 declare class InteractionSystem extends PubSub<InteractionEvents> {
-	#private;
 	raycaster: Raycaster;
 	private state;
 	private coreState;
@@ -15309,7 +15340,6 @@ declare class InteractionSystem extends PubSub<InteractionEvents> {
 	}>): void;
 	setHovered3DEntityInteractionComponentDirty(): void;
 	hasTouched: boolean;
-	onPointerMoveRaf: (event: PointerEvent) => void;
 	private onPointerMove;
 	tapsControl: TapsController;
 	getThreeDIntersectsFromXY(point: Vector2): Intersection<Object3D<Object3DEventMap>>[];
@@ -15338,7 +15368,7 @@ declare class InteractionSystem extends PubSub<InteractionEvents> {
 	enableDebug(): void;
 	get _state(): {
 		hovered3DEntity: Geometry3D | undefined;
-		hovered2DEntity: Geometry2D | undefined;
+		hovered2DEntities: Set<string | number>;
 		hovered3DContainers: GroupContainerObject3D[] | undefined;
 		lastHover: Geometry3D | undefined;
 		interaction: InteractionState;
@@ -15991,6 +16021,7 @@ declare class RenderSystem extends PubSub<{
 	private twoDFrameId;
 	private animationFrameId;
 	private nextFrame;
+	private updateEntitiesFrameId;
 	update: (sync?: boolean) => Promise<any>;
 	/**
 	 * Paint to screen
@@ -17167,6 +17198,19 @@ declare class ClippingPlaneSystem {
 	private process;
 	private createHoleFillGeometry;
 }
+export interface ISystemPlugin {
+	/**
+	 *
+	 * @param state - The current state of the renderer.
+	 */
+	update(state: RendererState): void;
+}
+declare class PluginSystem {
+	private plugins;
+	registerPlugin(plugin: ISystemPlugin): void;
+	unregisterPlugin(plugin: ISystemPlugin): void;
+	update(state: RendererState): void;
+}
 type Systems = {
 	cameraSystem: CameraSystem;
 	panBoundsSystem: PanBoundsSystem;
@@ -17199,6 +17243,7 @@ type Systems = {
 	borderSystem: BorderSystem;
 	renderOrderSystem: RenderOrderSystem;
 	clippingPlaneSystem: ClippingPlaneSystem;
+	pluginSystem: PluginSystem;
 };
 export type MapViewState = {
 	readonly type: "map-view";
@@ -17252,10 +17297,12 @@ declare class Core extends PubSub<MapEvent> {
 		altitude?: number;
 		interactive?: boolean;
 	}, parent?: EntityId<GroupContainerState> | string | number | null): EntityId<ShapeState>;
+	registerPlugin(plugin: ISystemPlugin): void;
+	unregisterPlugin(plugin: ISystemPlugin): void;
 	/**
 	 * Add a geometry group from GeoJSON data
 	 */
-	addGeometryGroup<T extends FeatureCollection$1<Polygon$1 | MultiPolygon$1 | LineString, any>>(id: string, geometry: T, style?: T extends FeatureCollection$1<LineString, any> ? LineStyle : PaintStyle, parent?: EntityId<GroupContainerState> | string | number | null): EntityId<GeometryGroupState>;
+	addGeometryGroup<T extends FeatureCollection$1<Polygon$1 | MultiPolygon$1 | LineString, any>>(id: string, geometry: T, style?: (T extends FeatureCollection$1<LineString, any> ? LineStyle : PaintStyle) | ((feature: Feature$1<Polygon$1 | MultiPolygon$1 | LineString, any>) => T extends FeatureCollection$1<LineString, any> ? LineStyle : PaintStyle), parent?: EntityId<GroupContainerState> | string | number | null): EntityId<GeometryGroupState>;
 	addOccluder<T extends Feature$1<Polygon$1 | MultiPolygon$1, any>>(feature: T, parent?: EntityId<GroupContainerState> | string | number | null): number;
 	addImage(id: string, geometry: Feature$1<Point$1, ImageProperties>, style: ImageStyle, parent?: EntityId<GroupContainerState> | string | null): EntityId<ImageState> | undefined;
 	/**
@@ -17571,6 +17618,7 @@ type GroupContainerState = {
 declare class GroupContainerObject3D extends Object3D {
 	childrenIds: Set<string | number>;
 	children: (GroupContainerObject3D | GeometryGroupObject3D | BatchedText | Geometry2D["object3d"] | NonNullable<Geometry3D["object3d"]>)[];
+	getComponent(): void;
 	readonly type: "group-container";
 	userData: {
 		entityId: string | number;
@@ -17735,6 +17783,11 @@ declare class LabelComponent {
 }
 declare class Geometry2DObject3D extends Object3D {
 }
+type ComponentTypeMap$1 = {
+	interaction: InteractionComponent;
+	marker: MarkerComponent;
+	label: LabelComponent;
+};
 declare class Geometry2D {
 	id: string | number;
 	get type(): "label" | "marker";
@@ -17748,6 +17801,7 @@ declare class Geometry2D {
 		MarkerComponent | LabelComponent,
 		InteractionComponent?
 	];
+	getComponent<T extends keyof ComponentTypeMap$1>(type: T): ComponentTypeMap$1[T] | undefined;
 	disposed: boolean;
 	constructor(ui: MarkerComponent | LabelComponent, position: Vector3, verticalOffset?: number);
 	private worldPosition;
@@ -18069,15 +18123,27 @@ type MapEventPayload<EventName extends keyof MapEvent> = MapEvent[EventName] ext
 } ? MapEvent[EventName]["data"] : MapEvent[EventName];
 type All3DTypes = Geometry3DTypes | GeometryGroupObject3D | GroupContainerObject3D;
 type RendererState = {
-	geometry3DMap: Map<string | number, All3DTypes>;
-	geometry2DMap: Map<string | number, Geometry2D>;
-	geometry2DIdsInScene: Set<Geometry2D["id"]>;
-	geometry3DIdsInScene: Set<All3DTypes["id"]>;
+	/**
+	 * A map of all 3D geometries in the world.
+	 */
+	readonly geometry3DMap: Map<string | number, All3DTypes>;
+	/**
+	 * A map of all 2D geometries in the world.
+	 */
+	readonly geometry2DMap: Map<string | number, Geometry2D>;
+	/**
+	 * A set of all 2D geometry IDs in the scene. This is updated when objects' visiblity changes.
+	 */
+	readonly geometry2DIdsInScene: Set<Geometry2D["id"]>;
+	/**
+	 * A set of all 3D geometry IDs in the scene. This is updated when objects' visiblity changes.
+	 */
+	readonly geometry3DIdsInScene: Set<All3DTypes["id"]>;
 	/**
 	 * IDs of geometry groups that need to be loaded, including preloaded geometry groups that are not in the scene yet
 	 */
-	geometryGroupIdsToLoad: Set<GeometryGroupObject3D["userData"]["entityId"]>;
-	entityScene: GroupContainerObject3D;
+	readonly geometryGroupIdsToLoad: Set<GeometryGroupObject3D["userData"]["entityId"]>;
+	readonly geometryScene: GroupContainerObject3D;
 	hoverColor: string;
 	text3dHoverColor: string;
 	center?: Position$1;
@@ -18100,6 +18166,10 @@ type RendererState = {
 		number
 	];
 	useStandaloneCamera: boolean;
+	directionalLight: DirectionalLight;
+	ambientLight: AmbientLight;
+	renderer: WebGLRenderer;
+	threeJSScene: Scene;
 };
 type EntityTypes = Geometry3DTypes | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D;
 type TransformImageRequest = (url: string) => Promise<{
@@ -18311,6 +18381,7 @@ declare class MarkerComponent {
 	collisionDirty: boolean;
 	visibilityNeedsUpdate: "show" | "hide" | false;
 	constructor(contentHtml: string, options?: AddMarkerOptions);
+	updateDimensionsIfZeroWidthHeight(width?: number, height?: number): void;
 	updateDimensions(width?: number, height?: number): void;
 	animation: Animation | null;
 	currentStrategyIndex: number;
@@ -19436,6 +19507,10 @@ export declare class Debug {
 	constructor(core: Core);
 	update: Core["Debug"]["update"];
 }
+export type AutoElements = {
+	labels: Label[];
+	markers: Marker[];
+};
 /**
  * ## MapView in Mappedin JS
  *
@@ -20241,20 +20316,18 @@ export declare class MapView {
 	};
 	/**
 	 * @experimental
-	 * @warning **EXPERIMENTAL FEATURE UNDER CONSTRUCTION**
 	 *
 	 * This is an experimental feature that may undergo significant changes,
 	 * including breaking changes, renaming, or complete removal in future versions.
 	 * Do not rely on this API in production environments.
 	 *
-	 * Currently provides basic auto-labeling functionality for map elements.
-	 * Future versions may include comprehensive theming and auto-setup features.
+	 * Automatically creates labels, markers, and updates state of map elements provided with default settings.
+	 * @param mapElements - A custom array of map elements to automatically create labels, markers, and update state of.
+	 * If not provided, all map elements will be used.
 	 *
-	 * @returns An object containing auto-created labels
+	 * @returns An object containing auto-created labels and markers.
 	 */
-	__EXPERIMENTAL__auto(): Promise<{
-		labels: Label[];
-	}>;
+	__EXPERIMENTAL__auto(mapElements?: MapDataElements[]): Promise<AutoElements>;
 	/**
 	 * Subscribe a function to an event.
 	 *
@@ -20371,6 +20444,16 @@ export declare class MapView {
 	 * @default false
 	 */
 	set __INTERNAL__hidePathsNotOnCurrentFloor(value: boolean);
+	/**
+	 * @internal
+	 * @experimental
+	 */
+	registerPlugin(plugin: ISystemPlugin): void;
+	/**
+	 * @internal
+	 * @experimental
+	 */
+	unregisterPlugin(plugin: ISystemPlugin): void;
 }
 /**
  * ## Camera in Mappedin JS
@@ -22258,9 +22341,7 @@ declare class GeoJsonApi extends PubSub<TNavigationEvents> {
 	};
 	isInView(target: Space | MapObject | Label | Marker | string): boolean;
 	getInView<T extends string>(type: T, options?: TGetInViewOptions): MapFeatureOfType<T>[];
-	__EXPERIMENTAL__auto(): Promise<{
-		labels: Label[];
-	}>;
+	__EXPERIMENTAL__auto(mapElements?: MapDataElements[]): Promise<AutoElements>;
 	tween<T extends Record<string, unknown>>(object: T): Tween<T>;
 	removeTween(tween: Tween<any>): void;
 	tweenGroup(): import("@tweenjs/tween.js").Group;
@@ -22405,10 +22486,6 @@ declare class DirectionsInternal {
 		originIds: string[];
 		destinationNodeIds: string[];
 		featureToNodeIdsMap: Map<TNavigationTarget, string[]>;
-		/**
-		 * Node ID for early return when origin and destination share same space.
-		 */
-		earlyReturnNodeId?: string;
 	};
 	getDirections: (from: TNavigationTarget[], to: TNavigationTarget[], options: {
 		accessible: boolean;
@@ -22785,6 +22862,31 @@ export type TMapDataEvents = {
 		name: string;
 	};
 };
+/**
+ * A class that implements IAnchorable can have 2D elements like {@link Label}s and {@link Marker}s anchored to it.
+ */
+export interface IAnchorable {
+	get anchorTarget(): Coordinate;
+}
+/**
+ * A class that implements IFocusable can be focused on by the camera.
+ */
+export interface IFocusable {
+	get focusTarget(): TFocusTarget | TFocusTarget[];
+}
+/**
+ * A class that implements INavigatable can be navigated to via directions.
+ */
+export interface INavigatable {
+	get navigationTarget(): TNavigationTarget | TNavigationTarget[];
+}
+/**
+ * A class that implements IGeoJSONData has a underlying GeoJSON datathat can be accessed.
+ */
+export interface IGeoJSONData {
+	/** Gets the underlying GeoJSON Feature representation of this object. */
+	geoJSON: Feature$1<any, null>;
+}
 export type TAnimateStateResult = {
 	result: "completed" | "cancelled";
 };
@@ -23483,21 +23585,6 @@ type UpdateGlobalState = PartialDeep<GlobalState>;
  * A map element that can be focused on by the camera.
  */
 export type TFocusTarget = Coordinate | Space | Area | MapObject | Floor | Shape;
-/**
- * A class that implements IFocusable can be focused on by the camera.
- */
-export interface IFocusable {
-	get focusTarget(): TFocusTarget | TFocusTarget[];
-}
-interface INavigatable {
-	get navigationTarget(): TNavigationTarget | TNavigationTarget[];
-}
-/**
- * A class that implements IAnchorable can have 2D elements like {@link Label}s and {@link Marker}s anchored to it.
- */
-export interface IAnchorable {
-	get anchorTarget(): Coordinate;
-}
 /**
  * Associates MapData type strings with their corresponding classes.
  */
@@ -24014,6 +24101,12 @@ declare abstract class DetailedMapData<MVFData extends MVFFeature<Geometry, Prop
 	 * @returns {string} The name of the map feature.
 	 */
 	get name(): string;
+	/**
+	 * Gets the URL of the icon for the map feature.
+	 *
+	 * @returns {ImageMetaData | undefined} The icon of the map feature.
+	 */
+	get icon(): ImageMetaData | undefined;
 	/**
 	 * Gets the description of the map feature.
 	 *
@@ -24434,6 +24527,7 @@ export declare class Annotation extends DetailedMapData<AnnotationCollection["fe
 	constructor(data: MapDataInternal, options: {
 		floorId: string;
 		mvfData: AnnotationCollection["features"][number];
+		symbol?: AnnotationSymbol;
 	});
 	/**
 	 * Gets the group of the annotation.
@@ -24460,6 +24554,18 @@ export declare class Annotation extends DetailedMapData<AnnotationCollection["fe
 	 * @throws Will throw an error if the floor is not found.
 	 */
 	get floor(): Floor;
+	/**
+	 * Gets the name of the annotation.
+	 *
+	 * @returns {string} The annotation's name.
+	 */
+	get name(): string;
+	/**
+	 * Gets the icon for the annotation.
+	 *
+	 * @returns {ImageMetaData | undefined} The icon of the annotation.
+	 */
+	get icon(): ImageMetaData | undefined;
 	/**
 	 * Gets the underlying GeoJSON Feature representation of this Annotation.
 	 */
@@ -24575,7 +24681,7 @@ export declare class Connection extends DetailedMapData<Feature<Point, SpaceProp
 		__type: string;
 		id: string;
 		name: string;
-		type: "stairs" | "door" | "elevator" | "escalator" | "ramp" | "slide" | "portal" | "security" | "shuttle" | "ladder";
+		type: "door" | "stairs" | "elevator" | "escalator" | "ramp" | "slide" | "portal" | "security" | "shuttle" | "ladder";
 		externalId: string;
 		coordinates: {
 			__type: string;
@@ -24799,10 +24905,6 @@ type TMapDataInternalOptions = {
 	tokenManager?: TokenManager;
 	getMapDataOptions?: TGetMapDataOptions;
 };
-interface IGeoJSONData {
-	/** Gets the underlying GeoJSON Feature representation of this object. */
-	geoJSON: Feature<any, null>;
-}
 type MVFNodeFeature = MVFNodeCollection["features"][number];
 type MVFFloorFeature = FloorCollection["features"][number];
 /**
@@ -25999,6 +26101,18 @@ declare class MapDataInternal extends PubSub<{
 	getByType(type: "enterprise-category"): EnterpriseCategory[];
 	getByType(type: "enterprise-venue"): EnterpriseVenue | undefined;
 	getByType(type: "facade"): Facade[];
+	/**
+	 * Retrieves all map data objects that match any of the specified types.
+	 * If a list of elements is provided, it filters only those elements by type.
+	 * Otherwise, it retrieves all objects for the specified types from this dataset.
+	 *
+	 * @param types - A set of type names to filter/retrieve
+	 * @param elements - Optional. A list of elements to filter by the provided types
+	 * @returns An array of map data objects matching any of the specified types
+	 */
+	getAllOfTypes<T extends MapDataElements["__type"]>(types: ReadonlySet<T> | readonly T[], elements?: readonly MapDataElements[]): Extract<MapDataElements, {
+		__type: T;
+	}>[];
 	/**
 	 * Retrieves an object by its type and ID.
 	 *
@@ -27225,6 +27339,15 @@ export type TShow3DMapOptions = {
 	 * @default false
 	 */
 	disableWorkers?: boolean;
+	/**
+	 * @experimental
+	 * @internal
+	 *
+	 * If true, updateState calls will not be validated. This allows for faster updates and should likely only be used for production environment where the input
+	 * is predictable and has been validated by the developer.
+	 * @default false
+	 */
+	disableUpdateStateValidation?: boolean;
 };
 /**
  * @internal
@@ -27337,6 +27460,7 @@ export {
 	OperationHours,
 	Point$1 as Point,
 	Polygon$1 as Polygon,
+	RendererState as TRendererState,
 	SiblingGroup,
 	Style$2 as Style,
 	TImage3DState as TImageState,
@@ -27347,6 +27471,8 @@ export {
 	TMVFPolygonStyle,
 	TMVFStyle,
 	TMVFStyleCollection,
+	parseMVFv2 as parseMVF,
+	unzipMVFv2 as unzipMVF,
 };
 
 export {};

package/lib/esm/index.js

@@ -1,2 +1 @@
-import{A as C,B as D,C as E,D as G,E as H,G as I,H as J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,a as c,b as d,c as e,d as f,e as g,f as h,g as i,h as j,i as k,j as l,k as m,l as n,m as o,n as p,o as q,p as r,q as s,r as t,s as u,t as v,u as w,v as x,w as y,x as z,y as A,z as B}from"./chunk-3PM6GKGK.js";import{_a as F,a,b}from"./chunk-UOCWYBVK.js";import"./chunk-MLCPE7I2.js";import"./chunk-3U5JJXJA.js";import"./chunk-ROCNZJLL.js";export{x as ACTION_TYPE,H as ANIMATION_TWEENS,o as Annotation,g as Area,y as BEARING_TYPE,z as CONNECTION_TYPE,l as Connection,c as Coordinate,B as DOORS,C as Directions,h as Door,a as E_SDK_LOG_LEVEL,s as EnterpriseCategory,r as EnterpriseLocation,t as EnterpriseVenue,q as Facade,j as Floor,p as FloorStack,e as Hyperlink,f as ImageMetaData,E as LocationCategory,D as LocationProfile,k as MAPPEDIN_COLORS,m as MapObject,L as MapView,d as Node,n as PointOfInterest,i as Space,A as WALLS,O as __setWatermarkOnClickFn,V as checkWorkerUrls,J as disableText3DWorker,G as enableTestMode,N as findPreferredLanguageInVenue,R as forceEnterpriseLocations,T as getMapData,U as getMapDataEnterprise,I as getMultiFloorState,X as getVersion,M as hydrateMapData,P as hydrateMapDataFromMVF,u as parseMVF,F as preloadFont,b as setLoggerLevel,Q as setUseEnterpriseAPI,K as setWorkersUrl,S as shouldForceEnterpriseLocations,W as show3dMap,Y as show3dMapGeojson,w as unzipAndParseMVFv2,v as unzipMVF};
-//# sourceMappingURL=index.js.map
+import{A as C,B as D,C as E,D as G,E as H,G as I,H as J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,a as c,b as d,c as e,d as f,e as g,f as h,g as i,h as j,i as k,j as l,k as m,l as n,m as o,n as p,o as q,p as r,q as s,r as t,s as u,t as v,u as w,v as x,w as y,x as z,y as A,z as B}from"./chunk-2DEFE4C2.js";import{a,ab as F,b}from"./chunk-Q56Y72HB.js";import"./chunk-YB4VFXKF.js";import"./chunk-66DYOCZO.js";import"./chunk-5W2UDR4H.js";export{x as ACTION_TYPE,H as ANIMATION_TWEENS,o as Annotation,g as Area,y as BEARING_TYPE,z as CONNECTION_TYPE,l as Connection,c as Coordinate,B as DOORS,C as Directions,h as Door,a as E_SDK_LOG_LEVEL,s as EnterpriseCategory,r as EnterpriseLocation,t as EnterpriseVenue,q as Facade,j as Floor,p as FloorStack,e as Hyperlink,f as ImageMetaData,E as LocationCategory,D as LocationProfile,k as MAPPEDIN_COLORS,m as MapObject,L as MapView,d as Node,n as PointOfInterest,i as Space,A as WALLS,O as __setWatermarkOnClickFn,V as checkWorkerUrls,J as disableText3DWorker,G as enableTestMode,N as findPreferredLanguageInVenue,R as forceEnterpriseLocations,T as getMapData,U as getMapDataEnterprise,I as getMultiFloorState,X as getVersion,M as hydrateMapData,P as hydrateMapDataFromMVF,u as parseMVF,F as preloadFont,b as setLoggerLevel,Q as setUseEnterpriseAPI,K as setWorkersUrl,S as shouldForceEnterpriseLocations,W as show3dMap,Y as show3dMapGeojson,w as unzipAndParseMVFv2,v as unzipMVF};