@mappedin/mappedin-js 6.19.0 → 6.20.0

package/lib/esm/index.d.ts

@@ -1,8 +1,8 @@
-import * as _mappedin_mvf_v22 from "@mappedin/mvf-v2";
+import * as _mappedin_mvf_v25 from "@mappedin/mvf-v2";
 import { AnnotationCollection, AnnotationSymbol, AreaCollection, AreaId, BaseTextAreaProperties, Category, CategoryId, Connection as Connection$1, Details, EnterpriseCategory as EnterpriseCategory$1, EnterpriseCategoryId, EnterpriseLocation as EnterpriseLocation$1, EnterpriseLocationId, EnterpriseLocationInstance, EnterpriseTexture, EnterpriseVenue as EnterpriseVenue$1, EnterpriseVenueType, EntranceCollection, EntranceFeature, Facade as Facade$1, Feature as Feature$1, FeatureCollection as FeatureCollection$1, FloatingFloorTextProperties, FloorCollection, FloorId, FloorProperties, FloorStack as FloorStack$1, FloorTextCommonProperties, Geometry as Geometry$1, Hyperlink as Hyperlink$1, Image, Language, LineStringStyle, LineStringStyle as TMVFLineStringStyle, Location, LocationId, LocationLink, LocationSocial, LocationSocial as LocationSocial$1, LocationState, LocationState as LocationState$1, MVFv2_STANDARD_MVFv3, MultiPolygon as MultiPolygon$1, NavigationFlagDeclarations, NodeCollection, NodeId, ObstructionCollection, ObstructionCollection as ObstructionCollection$1, ObstructionFeature, ObstructionId, OpeningHoursSpecification, OperationHours, OperationHours as OperationHours$1, ParsedMVF, ParsedMVF as TMVF, ParsedMVFLocalePack, Point as Point$1, PointStyle, PointStyle as TMVFPointStyle, Polygon as Polygon$1, PolygonStyle, PolygonStyle as TMVFPolygonStyle, SiblingGroup, SiblingGroup as SiblingGroup$1, SpaceCollection, SpaceCollection as SpaceCollection$1, SpaceFeature, SpaceId, SpaceProperties, Style as TMVFStyle, StyleCollection, StyleCollection as TMVFStyleCollection, TilesetStyle } from "@mappedin/mvf-v2";
 import { MVFv2_STANDARD_MVFv3 as MVFv2_STANDARD_MVFv3$1, ParsedMVF as ParsedMVF$1, RawMVF } from "@mappedin/mvf-v2/no-validator-lite";
 import * as _mappedin_renderer_three0 from "@mappedin/renderer-three";
-import { AddLabelOptionsInternal, AddText3DOptions, AddText3DOptions as AddText3DOptions$1, AddText3DPointOptions, CameraSystemState, ColorString, DebugState, DebugState as DebugState$1, EntityId, EnvMapOptions, EnvMapOptions as EnvMapOptions$1, GLTFExportOptions as GLTFExportOptions$1, GroupContainerState, ISystemPlugin, ISystemPlugin as ISystemPlugin$1, ImagePlacementOptions, InitializeModelState, InitializeModelState as InitializeModelState$1, InitializeText3DState, InsetPadding, InsetPadding as InsetPadding$1, InsetPaddingOption, InsetPaddingOption as InsetPaddingOption$1, InterpolateOn, Interpolation, LabelAppearance as LabelAppearance$1, LabelRenderedState, LabelTextPlacement as LabelTextPlacement$1, LineStyle, LineStyle as LineStyle$1, MapViewState, MarkerState, OutlinesOptions, PaintStyle, PaintStyle as PaintStyle$1, PathState, PathWidth, PathWidth as PathWidth$1, PixelWidth, Position as Position$1, RendererCore, RendererCoreOptions, RendererCoreOptions as RendererCoreOptions$1, Shading, Text3DState, WatermarkUpdateOptions } from "@mappedin/renderer-three";
+import { AddLabelOptionsInternal, AddText3DOptions, AddText3DOptions as AddText3DOptions$1, AddText3DPointOptions, CameraSystemState, ColorString, DebugState, DebugState as DebugState$1, EntityId, EnvMapOptions, EnvMapOptions as EnvMapOptions$1, GLTFExportOptions as GLTFExportOptions$1, GroupContainerState, ISystemPlugin, ISystemPlugin as ISystemPlugin$1, ImagePlacementOptions, InitializeModelState, InitializeModelState as InitializeModelState$1, InitializeText3DState, InsetPadding, InsetPadding as InsetPadding$1, InsetPaddingOption, InsetPaddingOption as InsetPaddingOption$1, InterpolateOn, Interpolation, LabelRenderedState, LineStyle, LineStyle as LineStyle$1, MapViewState, MarkerState, OutlinesOptions, PaintStyle, PaintStyle as PaintStyle$1, PathState, PathWidth, PathWidth as PathWidth$1, PixelWidth, Position as Position$1, RendererCore, RendererCoreOptions, RendererCoreOptions as RendererCoreOptions$1, Shading, Text3DState, WatermarkUpdateOptions } from "@mappedin/renderer-three";
 import * as _tweenjs_tween_js0 from "@tweenjs/tween.js";
 import { Group, Tween } from "@tweenjs/tween.js";
 import { CustomLayerInterface, IControl, Map as Map$1, MapEventType } from "@mappedin/outdoor-context";
@@ -209,6 +209,11 @@ type TSearchOptions = {
    */
   enabled: boolean;
 };
+/**
+ * Options shared by every {@link getMapData} call regardless of authentication mode.
+ * Carries the target `mapId` and optional overrides such as environment, base URL,
+ * and language preferences.
+ */
 type TGetMapDataSharedOptions = {
   /**
    * Mappedin map ID.
@@ -304,8 +309,12 @@ type TGetMapDataSharedOptions = {
    */
   prefetchTokens?: boolean;
   /**
-   * @hidden
-   * @internal
+   * Load draft (unpublished) enterprise map instead of the live version.
+   * Set to `"draft"` to fetch the latest unpublished changes.
+   * Leave unspecified to load the published live data.
+   *
+   * Requires an Enterprise API key. Only applicable to maps made in Mappedin CMS.
+   * @default undefined
    */
   layoutId?: 'draft';
   /**
@@ -344,6 +353,8 @@ type TGetMapDataWithCredentialsOptions = {
   secret: string;
 } & TGetMapDataSharedOptions;
 /**
+ * {@link getMapData} options that authenticate with a pre-issued access token,
+ * as opposed to a `key`/`secret` pair.
  * @interface
  */
 type TGetMapDataWithAccessTokenOptions = {
@@ -352,6 +363,10 @@ type TGetMapDataWithAccessTokenOptions = {
    */
   accessToken: string;
 } & TGetMapDataSharedOptions;
+/**
+ * Options accepted by {@link getMapData}. Either credentials (`key`/`secret`) or an
+ * `accessToken` may be supplied alongside the shared options.
+ */
 type TGetMapDataOptions = TGetMapDataWithCredentialsOptions | TGetMapDataWithAccessTokenOptions;
 /**
  * @internal
@@ -399,9 +414,21 @@ type ParsedMVFResult = {
   mvf2: ParsedMVF$1;
   mvf3?: MVFv2_STANDARD_MVFv3$1;
 };
+/**
+ * Decompress and parse a binary MVF (Mappedin Venue Format) payload into the
+ * structured `ParsedMVFResult` consumed by {@link hydrateMapData}.
+ *
+ * @param data - The gzipped MVF binary payload.
+ * @param inputVersion - The MVF schema version to parse against.
+ */
 declare function unzipAndParseMVFv2(data: Uint8Array, inputVersion?: string): Promise<ParsedMVFResult>;
 //#endregion
 //#region src/hydrate-map-data.d.ts
+/**
+ * Pre-fetched MVF data passed to {@link hydrateMapData} so a map can be constructed
+ * without going to the network. Supports both binary (`Uint8Array`) and JSON forms,
+ * optional language packs, and matches the shape produced by Mappedin's CDN.
+ */
 type THydrateMapDataBundle = {
   type: 'binary';
   options?: {
@@ -599,8 +626,19 @@ type CaptureEventsPayloadMap = {
      * Optional array of result IDs (hits).
      */
     hits?: string[];
+    /**
+     * Total number of results returned for the query across all result categories
+     * (places + enterprise locations + enterprise categories). Useful for identifying
+     * queries that return no results (`resultCount === 0`).
+     */
+    resultCount?: number;
   };
 };
+/**
+ * Sends user interaction analytics events to Mappedin's analytics backend.
+ * Captures map loads, search queries, directions, and custom user events so
+ * usage of an indoor map can be measured and tuned.
+ */
 declare class Analytics {
   #private;
   /**
@@ -635,6 +673,12 @@ declare class Analytics {
     analyticsBaseUrl: string;
     /** Flag to disable authentication. */
     noAuth: boolean;
+    /**
+     * Marks the tenant as an enterprise venue. Only enterprise venues are allowed to send
+     * `x-mappedin-key` / `x-mappedin-secret` headers to the analytics gateway — non-enterprise
+     * tenants must use `accessToken` (Bearer) auth, otherwise the gateway returns 401.
+     */
+    enterprise: boolean;
     /** Flag to enable geolocation mode. */
     geolocationMode: boolean;
     /** The context in which the analytics are being used. */
@@ -689,6 +733,12 @@ type AnalyticState = {
   analyticsBaseUrl: string;
   /** Flag to disable authentication. */
   noAuth: boolean;
+  /**
+   * Marks the tenant as an enterprise venue. Only enterprise venues are allowed to send
+   * `x-mappedin-key` / `x-mappedin-secret` headers to the analytics gateway — non-enterprise
+   * tenants must use `accessToken` (Bearer) auth, otherwise the gateway returns 401.
+   */
+  enterprise: boolean;
   /** Flag to enable geolocation mode. */
   geolocationMode: boolean;
   /** @internal The device ID to be used for analytics. */
@@ -3056,6 +3106,15 @@ declare const LABEL_TEXT_PLACEMENT: {
   readonly CENTER: "center";
 };
 declare const LABEL_LOW_PRIORITY = "low-priority";
+/**
+ * The placement of a label's text relative to its pin.
+ *
+ * - `'right'` — text appears to the right of the pin.
+ * - `'left'` — text appears to the left of the pin.
+ * - `'top'` — text appears above the pin.
+ * - `'hidden'` — text is hidden, only the pin is visible.
+ * - `'center'` — text is centered at the pin location and the pin is hidden.
+ */
 type LabelTextPlacement = (typeof LABEL_TEXT_PLACEMENT)[keyof typeof LABEL_TEXT_PLACEMENT];
 type LabelTextPlacementInternal = LabelTextPlacement | typeof LABEL_LOW_PRIORITY;
 type EasingCurve$1 = string;
@@ -3108,7 +3167,66 @@ declare const labelAppearanceSchemaBase: ZodObject<{
   __EXPERIMENTAL_wrapperShadowOffsetX: ZodDefault<ZodNumber>;
   __EXPERIMENTAL_wrapperShadowOffsetY: ZodDefault<ZodNumber>;
   __EXPERIMENTAL_wrapperShadowBlur: ZodDefault<ZodNumber>;
+  __EXPERIMENTAL_wrapperOpacity: ZodDefault<ZodNumber>;
 }, $strip>;
+/**
+ * Options to control how a label is rendered.
+ *
+ * | Option | Type | Description | Default |
+ * |--------|------|-------------|---------|
+ * | `margin` | `number` | Margin around the label text and pin in pixels. This will affect label density. Minimum is 6px. | 6 |
+ * | `maxLines` | `number` | Number of lines to display when text spans multiple lines. | 2 |
+ * | `textSize` | `number` | Text size in pixels | 11.5 |
+ * | `maxWidth` | `number` | Maximum width of text in pixels. | 150 |
+ * | `lineHeight` | `number` | Line height sets the height of a line box. It's commonly used to set the distance between lines of text. | 1.2 |
+ * | `color` | `string` | A color string for the label text and pin. | `#333` |
+ * | `outlineColor` | `string` | A color string for the outline around the label text and pin. | `white` |
+ * | `textColor` | `string` | A color string representing just the text color. Defaults to the same as `color`. | - |
+ * | `textOutlineColor` | `string` | A color string representing just the text outline. Defaults to the same as `outlineColor`. | - |
+ * | `pinColor` | `string` | A color string representing just the pin color. Defaults to the same as `color`. | - |
+ * | `pinOutlineColor` | `string` | A color string representing just the pin outline. Defaults to the same as `outlineColor`. | - |
+ * | `pinColorInactive` | `string` | A color string representing just the pin color when the label is inactive. Defaults to the same as `pinColor`. | - |
+ * | `pinOutlineColorInactive` | `string` | A color string representing just the pin outline when the label is inactive. Defaults to the same as `pinOutlineColor`. | - |
+ * | `icon` | `string` | An icon to be placed inside the label pin. Can be an SVG string or a path to a PNG or JPEG. | - |
+ * | `iconSize` | `number` | Size of the icon in pixels. Requires `icon` to be set. | 20 |
+ * | `iconScale` | `number` \| {@link Interpolation} | Scale the icon uniformly. Specify a number or an {@link Interpolation} object. | 1 |
+ * | `iconPadding` | `number` | Padding between the icon and the pin's border in pixels. | 2 |
+ * | `iconFit` | `'fill'` \| `'contain'` \| `'cover'` | How the icon should fit inside the pin. Options: `fill` (stretch to fill), `cover` (maintain aspect ratio and fill), `contain` (maintain aspect ratio and fit inside). | `cover` |
+ * | `iconOverflow` | `'visible'` \| `'hidden'` | Whether the icon should overflow the circle of the pin. | `hidden` |
+ * | `iconVisible` | `boolean` \| `number` | Controls icon visibility. If boolean, directly shows/hides the icon. If number, defines the zoom level at which the icon becomes visible. | `true` |
+ * | `opacity` | `number` | The opacity of the Label when it is enabled and visible. | `1` |
+ *
+ * @example Render a label with an SVG icon
+ * ```ts
+ * mapView.Labels.add(space, "Label", {
+ * 	appearance: {
+ * 		icon: `<svg>...</svg>`,
+ * 	},
+ * });
+ * ```
+ *
+ * @example Render a label with an image icon
+ * ```ts
+ * mapView.Labels.add(space, "Label", {
+ * 	appearance: {
+ * 		icon: 'https://example.com/icon.png',
+ * 	},
+ * });
+ * ```
+ *
+ * @example Scale a label's icon with zoom level
+ * ```ts
+ * mapView.Labels.add(space, "Label", {
+ * 	appearance: {
+ * 		iconScale: {
+ * 			on: 'zoom-level',
+ * 			input: [19, 22],
+ * 			output: [1, 3],
+ * 		},
+ * 	},
+ * });
+ * ```
+ */
 type LabelAppearance = Partial<input<typeof labelAppearanceSchemaBase>> & {
   iconScale?: number | Interpolation$2<'zoom-level', number[]>;
 };
@@ -3156,6 +3274,7 @@ declare const labelAppearanceSchema: ZodPipe<ZodObject<{
   __EXPERIMENTAL_wrapperShadowOffsetX: ZodDefault<ZodNumber>;
   __EXPERIMENTAL_wrapperShadowOffsetY: ZodDefault<ZodNumber>;
   __EXPERIMENTAL_wrapperShadowBlur: ZodDefault<ZodNumber>;
+  __EXPERIMENTAL_wrapperOpacity: ZodDefault<ZodNumber>;
 }, $strip>, ZodTransform<Required<LabelAppearance>, {
   margin: number;
   maxLines: number;
@@ -3183,6 +3302,7 @@ declare const labelAppearanceSchema: ZodPipe<ZodObject<{
   __EXPERIMENTAL_wrapperShadowOffsetX: number;
   __EXPERIMENTAL_wrapperShadowOffsetY: number;
   __EXPERIMENTAL_wrapperShadowBlur: number;
+  __EXPERIMENTAL_wrapperOpacity: number;
   textColor?: string | undefined;
   textOutlineColor?: string | undefined;
   pinColor?: string | undefined;
@@ -3252,6 +3372,7 @@ declare class LabelComponent {
   interactive: boolean;
   isOccluded: boolean;
   offscreen: boolean;
+  disposed: boolean;
   /**
    * Whether the label can be shown, which is decided by the collision engine
    */
@@ -4595,6 +4716,11 @@ type TNavigationOptions = {
     animated?: boolean;
   };
 };
+/**
+ * Snapshot of the navigation system's state at a point in time, including the
+ * active floors, paths, and directions. Returned by `Navigation.getState()` and
+ * suitable for serialization or use in undo/redo flows.
+ */
 type NavigationState = {
   isMultiFloor: boolean;
   floorStacks: FloorStack[];
@@ -4916,7 +5042,7 @@ declare class Footprint {
   /**
    * Builds the basement mask for elevation 0 floors
    */
-  buildBasementMask(): void;
+  buildBasementMask(spacesOpenToBelow?: Feature$1<Polygon$1, SpaceProperties>[]): void;
   /**
    * Updates the state of the footprint geometry (walls and ceiling)
    * @param state Partial state to update
@@ -5332,6 +5458,7 @@ declare class Shapes {
    * ```ts
    * const shape = mapView.Shapes.add(geometry, {
    *   color: 'green',
+   *   hoverColor: 'blue',
    *   opacity: 0.7,
    *   height: 2,
    *   interactive: true
@@ -5369,6 +5496,11 @@ type InspectorState = {
 type InspectorOption = Partial<InspectorState>;
 //#endregion
 //#region src/debug.d.ts
+/**
+ * Diagnostic utilities exposed at `MapView.Debug`. Provides toggles for
+ * debug visualizations, snapshots of the current camera state, and other
+ * inspection helpers useful while developing against Mappedin JS.
+ */
 declare class Debug {
   #private;
   state: DebugState$1;
@@ -6290,6 +6422,10 @@ type PartialExcept<T$1, K$1 extends string> = { [P in keyof T$1 as P extends K$1
 type ExtractDeep<T$1, U$1, Depth extends readonly number[] = []> = Depth['length'] extends 3 ? any : { [K in keyof T$1 as T$1[K] extends U$1 ? K : T$1[K] extends object | undefined ? ExtractDeep<NonNullable<T$1[K]>, U$1, [...Depth, 0]> extends never ? never : K : never]: T$1[K] extends object | undefined ? undefined extends T$1[K] ? ExtractDeep<NonNullable<T$1[K]>, U$1, [...Depth, 0]> | undefined : ExtractDeep<NonNullable<T$1[K]>, U$1, [...Depth, 0]> : T$1[K] extends U$1 ? T$1[K] : never };
 //#endregion
 //#region src/api-geojson/auto/index.d.ts
+/**
+ * Map view objects automatically created by `MapView.auto()` — typically labels
+ * and markers generated from venue data for common element types.
+ */
 type AutoElements = {
   labels: Label[];
   markers: Marker[];
@@ -7126,6 +7262,11 @@ declare class MapView {
   /**
    * Get the X and Y of a {@link Coordinate} measured from the top left corner of the map canvas.
    *
+   * The projected altitude is derived from the floor's live state (via `coordinate.floorId`)
+   * plus `coordinate.verticalOffset`. For coordinates without a `floorId`, `verticalOffset`
+   * is used directly as an absolute scene altitude — useful for "what if" projections at
+   * arbitrary altitudes without mutating the scene.
+   *
    * @experimental
    */
   getScreenCoordinateFromCoordinate(coordinate: Coordinate): {
@@ -7492,7 +7633,7 @@ declare class Camera {
   /**
    * The camera's current pan mode.
    */
-  get panMode(): "elevation" | "default";
+  get panMode(): "default" | "elevation";
   /**
    * Set the camera's pan mode. 'elevation' moves the camera up and down, while 'default' allows the camera to pan in all directions.
    * @experimental
@@ -7634,6 +7775,24 @@ declare class Camera {
    * The current elevation of the camera in meters.
    */
   get elevation(): number;
+  /**
+   * The maximum elevation (in meters) the camera is allowed to reach.
+   * @default Infinity
+   */
+  get maxElevation(): number;
+  /**
+   * Cap the camera's elevation in meters. Useful when `panMode` is
+   * `'elevation'` (vertical drag) to prevent the camera from rising above a
+   * building or floor stack. Pass `Infinity` to remove the cap.
+   *
+   * Applies to user pedestal drag, `setElevation`, and `animateElevation`.
+   * If the current elevation is above the new cap it is snapped down to it.
+   *
+   * @experimental
+   * @param maxElevation The new maximum elevation in meters.
+   * @default Infinity
+   */
+  setMaxElevation(maxElevation: number): void;
   /**
    * Animate the camera's elevation to a specified elevation.
    * @experimental
@@ -8389,6 +8548,11 @@ declare class Paths {
 type CurrentMapGetter$2 = () => GeojsonApiMapObject | undefined;
 //#endregion
 //#region src/api-geojson/style.d.ts
+/**
+ * Applies named visual style presets to the current map. Accessible from
+ * {@link MapView.Style}, it supports loading a {@link StyleCollection} or
+ * setting an individual style by id.
+ */
 declare class Style {
   #private;
   /**
@@ -8416,9 +8580,11 @@ type HiddenOutdoorGeometry = [polygons: GeoJSON.Feature<GeoJSON.Polygon | GeoJSO
  * [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/) is a TypeScript library that uses WebGL to render interactive maps from vector tiles in a browser. The Mappedin SDK makes use of it to display the outdoor map.
  *
  * By providing access to the MapLibre map used to draw the outdoor map, the Mappedin SDK enables developers to draw on and manipulate the outdoor map.
- * Developers can use most capabilities of MapLibre GL JS with key exceptions being Interactivity and Camera, which are not available.
+ * Developers can use most capabilities of MapLibre GL JS. The key exception is Interactivity, which is not available; direct Camera control is discouraged because Mappedin JS owns the outdoor camera (see below).
+ *
+ * User touch and click events are handled by Mappedin JS and are not propagated to the outdoor map layer. Camera movement is also driven by Mappedin JS; moving the MapLibre camera directly is not supported and may be overridden.
  *
- * User touch and click events are handled by Mappedin JS and are not propagated to the outdoor map layer. Camera movement is also handled by Mappedin JS and cannot be manipulated using MapLibre controls.
+ * IMPORTANT: Moving the camera via `Outdoor.map` (for example `Outdoor.map.flyTo` / `easeTo` / `jumpTo` / `setZoom`) is not supported — Mappedin JS controls the outdoor camera and may override these calls. Use {@link MapView.Camera} (for example {@link Camera.animateTo}, {@link Camera.set}, or {@link Camera.focusOn}) instead.
  *
  * Refer to the [Outdoor Map Guide](https://developer.mappedin.com/web-sdk/outdoor-map) for more information and interactive examples.
  */
@@ -8434,11 +8600,30 @@ declare class Outdoor {
    */
   setStyle(style: any): void;
   /**
-   * Returns a Maplibre map for advanced usage.
+   * Returns the underlying MapLibre GL map for **advanced, non-camera** usage,
+   * such as adding custom layers, sources, GeoJSON, or deck.gl overlays.
+   *
+   * IMPORTANT: Moving the camera through this object is not supported. Camera
+   * control (center, zoom, bearing, pitch, elevation) is owned by Mappedin JS,
+   * so MapLibre camera methods such as `flyTo`, `easeTo`, `jumpTo`, `panTo`,
+   * `zoomTo`, `setZoom`, `setCenter`, `setBearing`, or `setPitch` may be
+   * overridden. Use the {@link Camera} API instead — it is the supported,
+   * fully-featured path (animation promises, collision-aware framing).
+   *
+   * To move the camera, use the {@link Camera} API instead:
+   * - {@link Camera.animateTo} — smoothly move to a center / zoom / bearing / pitch
+   * - {@link Camera.set} — instantly set the camera
+   * - {@link Camera.focusOn} — frame one or more map elements
+   *
+   * @example Move the camera to a coordinate (correct — do NOT use `Outdoor.map.flyTo`)
+   * ```ts
+   * mapView.Camera.animateTo({ center: coordinate, zoomLevel: 19 }, { duration: 600 });
+   * ```
    *
-   * @returns {object} Maplibre map instance
+   * @returns The MapLibre GL `Map` instance, or `undefined` if the outdoor view is disabled.
    *
    * Limitations:
+   * - Camera methods are not supported (see above) — use {@link MapView.Camera} to move the camera.
    * - Maplibre interaction events are not supported, use Mappedin JS interaction events.
    * - Maplibre markers and labels may overlap as they are not integrated with the Mappedin JS collision engine.
    */
@@ -8659,6 +8844,7 @@ declare class Text3D {
 }
 //#endregion
 //#region src/states/doors-state.d.ts
+/** @internal */
 declare const doorsStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"doors">>>;
   color: ZodOptional<ZodDefault<ZodString>>;
@@ -8672,6 +8858,7 @@ declare const doorsStateSchemaPartial: ZodObject<{
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
   opacity: ZodOptional<ZodDefault<ZodNumber>>;
 }, $strip>;
+/** @internal */
 declare const doorsStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"doors">>;
   color: ZodDefault<ZodString>;
@@ -8685,24 +8872,39 @@ declare const doorsStateSchemaStrict: ZodObject<{
   visible: ZodDefault<ZodBoolean>;
   opacity: ZodDefault<ZodNumber>;
 }, $strict>;
+/**
+ * The serialized state of all doors in the map, including their colors and visibility.
+ */
 type TDoorsState = output<typeof doorsStateSchemaStrict>;
+/**
+ * A partial doors state used to apply incremental updates, where every field is optional.
+ */
 type TDoorsUpdateState = output<typeof doorsStateSchemaPartial>;
 //#endregion
 //#region src/states/facade-state.d.ts
+/** @internal */
 declare const facadeStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"facade">>>;
   opacity: ZodOptional<ZodDefault<ZodNumber>>;
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
 }, $strip>;
+/** @internal */
 declare const facadeStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"facade">>;
   opacity: ZodDefault<ZodNumber>;
   visible: ZodDefault<ZodBoolean>;
 }, $strict>;
+/**
+ * The serialized state of all building facades, including their materials and visibility.
+ */
 type TFacadeState = output<typeof facadeStateSchemaStrict>;
+/**
+ * A partial facades state used to apply incremental updates, where every field is optional.
+ */
 type TFacadeUpdateState = output<typeof facadeStateSchemaPartial>;
 //#endregion
 //#region src/states/floor-state.d.ts
+/** @internal */
 declare const floorStateSchemaPartial: ZodObject<{
   geometry: ZodOptional<ZodObject<{
     type: ZodOptional<ZodDefault<ZodLiteral<"floor.geometry">>>;
@@ -8780,6 +8982,7 @@ declare const floorStateSchemaPartial: ZodObject<{
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
   altitude: ZodOptional<ZodDefault<ZodNumber>>;
 }, $strip>;
+/** @internal */
 declare const floorStateSchemaStrict: ZodObject<{
   geometry: ZodObject<{
     type: ZodDefault<ZodLiteral<"floor.geometry">>;
@@ -8857,10 +9060,17 @@ declare const floorStateSchemaStrict: ZodObject<{
   visible: ZodDefault<ZodBoolean>;
   altitude: ZodDefault<ZodNumber>;
 }, $strict>;
+/**
+ * The serialized state of a floor, including its geometry, labels, markers, paths, and visibility.
+ */
 type TFloorState = output<typeof floorStateSchemaStrict>;
+/**
+ * A partial floor state used to apply incremental updates, where every field is optional.
+ */
 type TFloorUpdateState = output<typeof floorStateSchemaPartial>;
 //#endregion
 //#region src/states/geometry-state.d.ts
+/** @internal */
 declare const geometryStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"geometry">>>;
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
@@ -8883,6 +9093,7 @@ declare const geometryStateSchemaPartial: ZodObject<{
   borderColor: ZodOptional<ZodOptional<ZodString>>;
   borderWidth: ZodOptional<ZodOptional<ZodNumber>>;
 }, $strip>;
+/** @internal */
 declare const geometryStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"geometry">>;
   visible: ZodDefault<ZodBoolean>;
@@ -8906,12 +9117,17 @@ declare const geometryStateSchemaStrict: ZodObject<{
   borderWidth: ZodOptional<ZodNumber>;
 }, $strict>;
 /**
- * Defines the state for geometry elements like {@link Space} when updated.
+ * The serialized state of a geometry element such as a {@link Space}, including
+ * its style, color, and visibility.
  */
 type TGeometryState = output<typeof geometryStateSchemaStrict>;
+/**
+ * A partial geometry state used to apply incremental updates, where every field is optional.
+ */
 type TGeometryUpdateState = output<typeof geometryStateSchemaPartial>;
 //#endregion
 //#region src/states/label-state.d.ts
+/** @internal */
 declare const labelStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"label">>;
   text: ZodString;
@@ -8934,6 +9150,7 @@ declare const labelStateSchema: ZodObject<{
   }>>]>>;
   occlude: ZodDefault<ZodBoolean>;
 }, $strip>;
+/** @internal */
 declare const labelStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"label">>>;
   text: ZodOptional<ZodString>;
@@ -8956,10 +9173,18 @@ declare const labelStateSchemaPartial: ZodObject<{
   }>>]>>>;
   occlude: ZodOptional<ZodDefault<ZodBoolean>>;
 }, $strip>;
+/**
+ * The serialized state of a label, including its position, appearance, and rank.
+ * Returned by state APIs and used by extensions that need to inspect or persist label state.
+ */
 type TLabelState = output<typeof labelStateSchema>;
+/**
+ * A partial label state used to apply incremental updates, where every field is optional.
+ */
 type TLabelUpdateState = output<typeof labelStateSchemaPartial>;
 //#endregion
 //#region src/states/marker-state.d.ts
+/** @internal */
 declare const markerStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"marker">>;
   rank: ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>;
@@ -9000,9 +9225,10 @@ declare const markerStateSchema: ZodObject<{
   occlude: ZodDefault<ZodBoolean>;
   animated: ZodDefault<ZodBoolean>;
 }, $strip>;
+/** @internal */
 declare const markerStateSchemaPartial: ZodObject<{
-  type: ZodOptional<ZodDefault<ZodLiteral<"marker">>>;
   enabled: ZodOptional<ZodDefault<ZodBoolean>>;
+  type: ZodOptional<ZodDefault<ZodLiteral<"marker">>>;
   interactive: ZodOptional<ZodDefault<ZodUnion<readonly [ZodBoolean, ZodLiteral<"pointer-events-auto">]>>>;
   rank: ZodOptional<ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>>;
   occlude: ZodOptional<ZodDefault<ZodBoolean>>;
@@ -9039,12 +9265,23 @@ declare const markerStateSchemaPartial: ZodObject<{
   contentHTML: ZodOptional<ZodString>;
   animated: ZodOptional<ZodDefault<ZodBoolean>>;
 }, $strip>;
+/**
+ * The serialized state of a marker, including its anchor, HTML content, and rank.
+ * Returned by state APIs and used by extensions that need to inspect or persist marker state.
+ */
 type TMarkerState = output<typeof markerStateSchema>;
+/**
+ * A partial marker state used to apply incremental updates, where every field is optional.
+ */
 type TMarkerUpdateState = output<typeof markerStateSchemaPartial>;
 //#endregion
 //#region src/states/path-state.d.ts
-/** Border color - 'darken' auto-darkens main color, or explicit hex color string */
+/**
+ * Border color - 'darken' auto-darkens main color, or explicit hex color string.
+ * @internal
+ */
 type BorderColor = LiteralUnion<'darken', string>;
+/** @internal */
 declare const pathStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"path">>>;
   color: ZodOptional<ZodDefault<ZodString>>;
@@ -9095,6 +9332,7 @@ declare const pathStateSchemaPartial: ZodObject<{
     dithering: ZodOptional<ZodNumber>;
   }, $strip>>>;
 }, $strip>;
+/** @internal */
 declare const pathStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"path">>;
   color: ZodDefault<ZodString>;
@@ -9145,15 +9383,24 @@ declare const pathStateSchemaStrict: ZodObject<{
     dithering: ZodOptional<ZodNumber>;
   }, $strip>>;
 }, $strict>;
+/**
+ * The serialized state of a path, including its waypoints, style, and animation.
+ * Returned by state APIs and used by extensions that need to inspect or persist path state.
+ */
 type TPathState = output<typeof pathStateSchemaStrict>;
+/**
+ * A partial path state used to apply incremental updates, where every field is optional.
+ */
 type TPathUpdateState = input<typeof pathStateSchemaPartial>;
 //#endregion
 //#region src/states/shape-state.d.ts
+/** @internal */
 declare const shapeStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"shape">>>;
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
   altitude: ZodOptional<ZodDefault<ZodNumber>>;
   color: ZodOptional<ZodDefault<ZodString>>;
+  hoverColor: ZodOptional<ZodOptional<ZodString>>;
   height: ZodOptional<ZodDefault<ZodNumber>>;
   opacity: ZodOptional<ZodDefault<ZodNumber>>;
   interactive: ZodOptional<ZodDefault<ZodBoolean>>;
@@ -9166,11 +9413,13 @@ declare const shapeStateSchemaPartial: ZodObject<{
   }, $strip>>>;
   position: ZodOptional<ZodCustom<Coordinate, Coordinate>>;
 }, $strip>;
+/** @internal */
 declare const shapeStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"shape">>;
   visible: ZodDefault<ZodBoolean>;
   altitude: ZodDefault<ZodNumber>;
   color: ZodDefault<ZodString>;
+  hoverColor: ZodOptional<ZodString>;
   height: ZodDefault<ZodNumber>;
   opacity: ZodDefault<ZodNumber>;
   interactive: ZodDefault<ZodBoolean>;
@@ -9184,12 +9433,16 @@ declare const shapeStateSchemaStrict: ZodObject<{
   position: ZodCustom<Coordinate, Coordinate>;
 }, $strict>;
 /**
- * Represents the state of a shape.
+ * The serialized state of a shape feature collection, including its geometry and styling.
  */
 type TShapeState = output<typeof shapeStateSchemaStrict>;
+/**
+ * A partial shape state used to apply incremental updates, where every field is optional.
+ */
 type TShapeUpdateState = output<typeof shapeStateSchemaPartial>;
 //#endregion
 //#region src/states/image-state.d.ts
+/** @internal */
 declare const imageStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"image3d">>;
   visible: ZodDefault<ZodBoolean>;
@@ -9202,6 +9455,7 @@ declare const imageStateSchema: ZodObject<{
   flipImagesToFaceCamera: ZodDefault<ZodBoolean>;
   interactive: ZodDefault<ZodBoolean>;
 }, $strip>;
+/** @internal */
 declare const imageStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"image3d">>>;
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
@@ -9214,10 +9468,17 @@ declare const imageStateSchemaPartial: ZodObject<{
   flipImagesToFaceCamera: ZodOptional<ZodDefault<ZodBoolean>>;
   interactive: ZodOptional<ZodDefault<ZodBoolean>>;
 }, $strip>;
+/**
+ * The serialized state of a 3D image overlay, including its coordinate, size, and opacity.
+ */
 type TImage3DState = output<typeof imageStateSchema>;
+/**
+ * A partial 3D image state used to apply incremental updates, where every field is optional.
+ */
 type TImage3DUpdateState = output<typeof imageStateSchemaPartial>;
 //#endregion
 //#region src/states/model-state.d.ts
+/** @internal */
 declare const modelStateUpdateSchema: ZodObject<{
   altitude: ZodOptional<ZodOptional<ZodNumber>>;
   id: ZodOptional<ZodOptional<ZodUnion<readonly [ZodNumber, ZodString]>>>;
@@ -9237,6 +9498,7 @@ declare const modelStateUpdateSchema: ZodObject<{
   scale: ZodOptional<ZodUnion<readonly [ZodNumber, ZodTuple<[ZodNumber, ZodNumber, ZodNumber], null>]>>;
   rotation: ZodOptional<ZodUnion<readonly [ZodNumber, ZodTuple<[ZodNumber, ZodNumber, ZodNumber], null>]>>;
 }, $strip>;
+/** @internal */
 declare const modelStateSchemaStrict: ZodObject<{
   altitude: ZodOptional<ZodNumber>;
   id: ZodOptional<ZodUnion<readonly [ZodNumber, ZodString]>>;
@@ -9257,12 +9519,16 @@ declare const modelStateSchemaStrict: ZodObject<{
   clippingPlaneTopVisible: ZodDefault<ZodBoolean>;
 }, $strict>;
 /**
- * Represents the state of a model.
+ * The serialized state of a 3D model, including its coordinate, rotation, and scale.
  */
 type TModelState = output<typeof modelStateSchemaStrict>;
+/**
+ * A partial 3D model state used to apply incremental updates, where every field is optional.
+ */
 type TModelUpdateState = output<typeof modelStateUpdateSchema>;
 //#endregion
 //#region src/states/text3d-state.d.ts
+/** @internal */
 declare const text3DUpdateStateSchema: ZodObject<{
   visible: ZodOptional<ZodOptional<ZodBoolean>>;
   color: ZodOptional<ZodOptional<ZodString>>;
@@ -9283,6 +9549,7 @@ declare const text3DUpdateStateSchema: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"text3d">>>;
   position: ZodOptional<ZodCustom<Coordinate, Coordinate>>;
 }, $strict>;
+/** @internal */
 declare const text3DStateSchemaStrict: ZodObject<{
   visible: ZodBoolean;
   color: ZodString;
@@ -9309,10 +9576,17 @@ declare const text3DStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"text3d">>;
   position: ZodCustom<Coordinate, Coordinate>;
 }, $strict>;
+/**
+ * The serialized state of a 3D text element, including its coordinate, content, and appearance.
+ */
 type TText3DState = output<typeof text3DStateSchemaStrict>;
+/**
+ * A partial 3D text state used to apply incremental updates, where every field is optional.
+ */
 type TText3DUpdateState = output<typeof text3DUpdateStateSchema>;
 //#endregion
 //#region src/states/walls-state.d.ts
+/** @internal */
 declare const wallsStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"walls">>>;
   color: ZodOptional<ZodDefault<ZodString>>;
@@ -9327,6 +9601,7 @@ declare const wallsStateSchemaPartial: ZodObject<{
   height: ZodOptional<ZodDefault<ZodNumber>>;
   opacity: ZodOptional<ZodDefault<ZodNumber>>;
 }, $strip>;
+/** @internal */
 declare const wallsStateSchemaStrict: ZodObject<{
   type: ZodDefault<ZodLiteral<"walls">>;
   color: ZodDefault<ZodString>;
@@ -9341,7 +9616,13 @@ declare const wallsStateSchemaStrict: ZodObject<{
   height: ZodDefault<ZodNumber>;
   opacity: ZodDefault<ZodNumber>;
 }, $strict>;
+/**
+ * The serialized state of all walls in the map, including their colors and visibility.
+ */
 type TWallsState = output<typeof wallsStateSchemaStrict>;
+/**
+ * A partial walls state used to apply incremental updates, where every field is optional.
+ */
 type TWallsUpdateState = output<typeof wallsStateSchemaPartial>;
 //#endregion
 //#region src/states/state-utils.d.ts
@@ -10245,6 +10526,11 @@ declare class MappedinRenderError extends MappedinError {
 }
 //#endregion
 //#region src/events.d.ts
+/**
+ * Free-form context string passed to `MapView.setFloor` (via {@link TSetFloorOptions})
+ * that is forwarded to `floor-change` event listeners as `event.reason`. Useful for
+ * distinguishing user-initiated floor changes from programmatic ones.
+ */
 type TFloorChangeReason = string;
 /**
  * The payload for a user click event on the map.
@@ -10481,9 +10767,17 @@ type TEvents = {
     error: MappedinRenderError;
   };
 };
+/**
+ * Resolves to the payload type for a given {@link TEvents} event name. Use this
+ * to type the parameter of an event handler without depending on the internal
+ * shape of `TEvents`.
+ */
 type TEventPayload<EventName extends keyof TEvents> = TEvents[EventName] extends {
   data: null;
 } ? TEvents[EventName]['data'] : TEvents[EventName];
+/**
+ * Events emitted by {@link MapData}, such as when the active language pack changes.
+ */
 type TMapDataEvents = {
   'language-change': {
     code: string;
@@ -10525,12 +10819,22 @@ interface IGeoJSONData {
 }
 //#endregion
 //#region src/types/index.d.ts
+/**
+ * Result of an animation that may have run to completion or been cancelled before finishing.
+ */
 type TAnimateStateResult = {
   result: 'completed' | 'cancelled';
 };
+/**
+ * A promise extended with a `cancel()` method. Calling `cancel()` aborts the in-flight
+ * operation; the promise still settles, typically with a `'cancelled'` result.
+ */
 type TCancellablePromise<T$1> = Promise<T$1> & {
   cancel: () => void;
 };
+/**
+ * The action a user should take at a step of a {@link Directions} instruction.
+ */
 declare enum ACTION_TYPE {
   Departure = "Departure",
   TakeConnection = "TakeConnection",
@@ -11288,6 +11592,7 @@ type TAddModelOptions = Omit<InitializeModelState$1, 'scale' | 'url'> & {
   scale?: number | [number, number, number];
 };
 /**
+ * Options for adding a 3D text element to the map.
  * @interface
  */
 type TAddText3DOptions = AddText3DOptions$1;
@@ -11444,7 +11749,7 @@ type TAddLabelOptions = {
   /**
    * Customize the appearance of the {@link Label} and its pin
    */
-  appearance?: LabelAppearance$1;
+  appearance?: LabelAppearance;
   /**
    * Whether the Label should be clickable.
    * @default false
@@ -11461,7 +11766,7 @@ type TAddLabelOptions = {
   /**
    * The placement of the text relative to the pin.
    */
-  textPlacement?: LabelTextPlacement$1[];
+  textPlacement?: LabelTextPlacement[];
   /**
    * Whether the label should be occluded by 3D geometry.
    * @default true
@@ -11489,6 +11794,11 @@ type WithState<T$1> = T$1 extends {
 type TUpdateState<T$1 extends MapElementsWithState | string> = T$1 extends {
   __type: infer U;
 } ? U extends keyof MapElementToUpdateState ? MapElementToUpdateState[U] : never : T$1 extends string ? T$1 extends keyof MapElementToUpdateState ? MapElementToUpdateState[T$1] : Record<string, any> : never;
+/**
+ * Maps each map element discriminator (`__type`) to the read-only rendered state
+ * type the element exposes. Used internally by `getRenderedState` to derive a
+ * precise return type from the element passed in.
+ */
 type MapElementToGetRenderedState = {
   [Label.__type]: ReadonlyDeep<LabelRenderedState>;
 };
@@ -11503,6 +11813,11 @@ type MapElementWithRenderedState = WithState<Label>;
 type TGetRenderedState<T$1 extends MapElementWithRenderedState | string> = T$1 extends {
   __type: infer U;
 } ? U extends keyof MapElementToGetRenderedState ? MapElementToGetRenderedState[U] : never : T$1 extends string ? T$1 extends keyof MapElementToGetRenderedState ? MapElementToGetRenderedState[T$1] : Record<string, any> : never;
+/**
+ * Map-wide state applied to all elements, such as the background color, hover
+ * highlight color, and shared visibility flags. Returned by `MapView.getState`
+ * and consumed by extensions that need a snapshot of the global render state.
+ */
 type GlobalState = {
   /**
    * The color of the background, in hex format(#000000).
@@ -11664,6 +11979,10 @@ type TCameraInteractionsSetOptions = {
    */
   bearingAndPitch?: boolean;
 };
+/**
+ * Options passed to `MapView.setFloor` to control how the floor change is performed
+ * and to provide an optional reason that is propagated to `floor-change` event listeners.
+ */
 type TSetFloorOptions = {
   /**
    * Optionally provide the context for the floor change which will be published as the `reason` for the `floor-change` event.
@@ -12391,6 +12710,12 @@ declare abstract class BaseMapData {
 }
 //#endregion
 //#region src/map-data-objects/detailed-map-data.d.ts
+/**
+ * Abstract base class for map data objects that carry rich metadata (images,
+ * hyperlinks, location profiles, and an external ID). Specific classes such as
+ * {@link Space}, {@link PointOfInterest}, and {@link Connection} extend this
+ * to expose typed accessors for their `details` payload.
+ */
 declare abstract class DetailedMapData<MVFData extends Feature$1<Geometry$1, {
   id: string;
   externalId?: string;
@@ -12520,8 +12845,8 @@ declare class Area extends DetailedMapData<AreaCollection['features'][number]> i
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
-    geometry: _mappedin_mvf_v22.Polygon;
+    type: _mappedin_mvf_v25.FeatureType;
+    geometry: _mappedin_mvf_v25.Polygon;
   };
   /** @internal */
   get focusTarget(): this;
@@ -12623,8 +12948,8 @@ declare class Door extends DetailedMapData<EntranceFeature> implements IGeoJSOND
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
-    geometry: _mappedin_mvf_v22.LineString;
+    type: _mappedin_mvf_v25.FeatureType;
+    geometry: _mappedin_mvf_v25.LineString;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -12760,8 +13085,8 @@ declare class Space extends DetailedMapData<SpaceFeature> implements IGeoJSONDat
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
-    geometry: _mappedin_mvf_v22.Point | _mappedin_mvf_v22.LineString | _mappedin_mvf_v22.Polygon;
+    type: _mappedin_mvf_v25.FeatureType;
+    geometry: _mappedin_mvf_v25.Point | _mappedin_mvf_v25.Polygon | _mappedin_mvf_v25.LineString;
   };
   /** @internal */
   get focusTarget(): this | Coordinate;
@@ -12847,7 +13172,7 @@ declare class PointOfInterest extends DetailedMapData<FeatureCollection$1<Point$
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
+    type: _mappedin_mvf_v25.FeatureType;
     geometry: Point$1;
   };
   /**
@@ -12961,8 +13286,8 @@ declare class Annotation extends DetailedMapData<AnnotationCollection['features'
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
-    geometry: _mappedin_mvf_v22.Point;
+    type: _mappedin_mvf_v25.FeatureType;
+    geometry: _mappedin_mvf_v25.Point;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -13178,8 +13503,8 @@ declare class MapObject extends DetailedMapData<ObstructionFeature> implements I
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
-    geometry: _mappedin_mvf_v22.LineString | _mappedin_mvf_v22.Polygon;
+    type: _mappedin_mvf_v25.FeatureType;
+    geometry: _mappedin_mvf_v25.Polygon | _mappedin_mvf_v25.LineString;
   };
   /** @internal */
   get anchorTarget(): Coordinate;
@@ -13492,8 +13817,8 @@ declare class Node extends BaseMetaData implements IGeoJSONData, IFocusable, IAn
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
-    geometry: _mappedin_mvf_v22.Point;
+    type: _mappedin_mvf_v25.FeatureType;
+    geometry: _mappedin_mvf_v25.Point;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -14381,6 +14706,11 @@ declare class LocationCategory extends BaseMetaData implements Omit<Category, 'p
 }
 //#endregion
 //#region src/api-geojson/language.d.ts
+/**
+ * Options passed to {@link findPreferredLanguageInVenue} controlling which language is
+ * selected when more than one is available, and whether to fall back to the
+ * browser's preferred language.
+ */
 type TFindPreferredLanguageInVenueOptions = {
   /**
    * Preferred language code to use.
@@ -14736,6 +15066,10 @@ declare class InternalSearch {
   search(term: string, options?: SearchOptions): Promise<SearchResult>;
   suggest(term: string, options?: SuggestOptions): Promise<Suggestion[]>;
 }
+/**
+ * A single search result returned by `MapData.search`. Wraps the matched
+ * map data object along with its match metadata and relevance score.
+ */
 type SearchResultItem<T$1 extends Places | EnterpriseLocation | EnterpriseCategory> = {
   type: T$1['__type'];
   match: SearchResult$1['match'];
@@ -14743,14 +15077,17 @@ type SearchResultItem<T$1 extends Places | EnterpriseLocation | EnterpriseCatego
   item: T$1;
 };
 /**
+ * A search result wrapping a matched {@link EnterpriseCategory}.
  * @interface
  */
 type SearchResultEnterpriseCategory = SearchResultItem<EnterpriseCategory>;
 /**
+ * A search result wrapping a matched {@link EnterpriseLocation}.
  * @interface
  */
 type SearchResultEnterpriseLocations = SearchResultItem<EnterpriseLocation>;
 /**
+ * A search result wrapping a matched place (Space, PointOfInterest, etc.).
  * @interface
  */
 type SearchResultPlaces = SearchResultItem<Places>;
@@ -14805,6 +15142,8 @@ declare const suggestOptionsSchema: ZodObject<{
   }, $strip>>;
 }, $strip>;
 /**
+ * Options passed to `MapData.search` to filter the searchable data sources
+ * (places, enterprise locations, enterprise categories) and tune behavior.
  * @interface
  */
 type SearchOptions = output<typeof searchOptionsSchema>;
@@ -15529,7 +15868,7 @@ declare class MapData {
    * console.log(`Current language: ${language.name} (${language.code})`);
    * ```
    */
-  get currentLanguage(): _mappedin_mvf_v22.Language | undefined;
+  get currentLanguage(): _mappedin_mvf_v25.Language | undefined;
   /**
    * Gets the natural bearing of the map.
    *
@@ -15771,6 +16110,7 @@ type Style$1 = {
   join: LineStyle$2['join'];
   cap: LineStyle$2['cap'];
   topColor?: string;
+  hoverColor?: string;
   showImage: boolean;
   flipImageToFaceCamera: boolean;
   enableImageCollisions: boolean;
@@ -16185,6 +16525,11 @@ type FeatureCollectionState = {
    * preserved for now.
    */
   topColor?: string;
+  /**
+   * Per-feature hover color. Setting this cascades to all children, and reads
+   * back through to the first child.
+   */
+  hoverColor?: string;
   /**
    * @deprecated Per-feature property; read-through to the first child is
    * preserved for now.
@@ -17302,6 +17647,9 @@ type Text3DState$1 = {
   readonly rotation: number;
 } & Text3DStyle;
 /**
+ * Initial state for a 3D text element when it is first added to the map.
+ * Mirrors the shape of {@link TText3DState} with all fields optional and
+ * with the auto-managed `id` and `type` fields omitted.
  * @interface
  */
 type InitializeText3DState$1 = Partial<Omit<Text3DState$1, 'id' | 'type'>>;
@@ -17316,7 +17664,7 @@ type Text3DProperties = {
   textArea?: MeshComponentProperties['textArea'];
 };
 /**
- * Options for labeling a geometry with 3D text.
+ * Options accepted when adding a 3D text element (for example to label a space).
  */
 type AddText3DOptions$2 = {
   appearance?: Partial<InitializeText3DState$1>;
@@ -17458,9 +17806,26 @@ type ClippingPlane = {
   verticalOffset: number;
   plane?: Plane;
   holeFillMesh?: Mesh;
+  /**
+   * Group containing the two stencil counting passes (mesh0/mesh1) that toggle
+   * the clipping bit on cross-section pixels. Must be kept in sync with the
+   * cap's visibility: when the cap isn't rendered, it can't clear the clipping
+   * bit, so the counting passes must also be skipped to avoid leaving the bit
+   * set and corrupting other stencil-based features (e.g. underground mask).
+   */
+  holeFillGroup?: Group$1;
   topColor?: string;
   needsRebuild: boolean;
   topVisible?: boolean;
+  /**
+   * World-space XY center of the model's bounding box. Used to size and position
+   * the stencil bias / hole-fill plane to the model's footprint instead of a
+   * giant screen-covering quad (which would corrupt other stencil features).
+   */
+  bboxCenter?: {
+    x: number;
+    y: number;
+  };
 };
 declare class ClippingPlaneComponent implements ClippingPlane {
   readonly type: "clippingPlane";
@@ -17469,8 +17834,13 @@ declare class ClippingPlaneComponent implements ClippingPlane {
   verticalOffset: number;
   plane?: Plane;
   holeFillMesh?: Mesh;
+  holeFillGroup?: Group$1;
   topColor?: string;
   topVisible: boolean;
+  bboxCenter?: {
+    x: number;
+    y: number;
+  };
 }
 //#endregion
 //#region ../renderer-three/src/entities/geometry3d.d.ts
@@ -18797,6 +19167,21 @@ declare class Camera$2 extends PubSub<{
    * The camera's current elevation in meters from the ground.
    */
   get elevation(): number;
+  /**
+   * The maximum elevation (in meters) the camera is allowed to reach.
+   * @default Infinity
+   */
+  get maxElevation(): number;
+  /**
+   * Cap the camera's elevation in meters. Applies to user pedestal drag (when
+   * `panMode` is `'elevation'`), `setElevation`, and `animateElevation`. The
+   * current elevation is snapped down to the cap if it exceeds the new
+   * maximum.
+   *
+   * @param maxElevation The new maximum elevation in meters.
+   * @default Infinity
+   */
+  setMaxElevation(maxElevation: number): void;
   /**
    * @param elevation The elevation in meters.
    */
@@ -19671,11 +20056,23 @@ declare class ClippingPlaneSystem {
   update(): void;
   private process;
   /**
-   * Creates the stencil geometry for hole fill detection
-   * @param modelGeometry - The merged model geometry for counting passes
-   * @param planeGeometry - The plane geometry for bias pass (covers entire hole fill area)
-   * @param plane - The clipping plane
-   * @param renderOrder - Base render order for the meshes
+   * Creates the stencil counting passes that mark cross-section pixels.
+   *
+   * Two passes operate on a single reserved stencil bit (CLIPPING_BIT = 0x80),
+   * which is guaranteed to be 0 in every mask ID, so the clipping system and the
+   * masking system never overwrite each other's stencil state:
+   *
+   *  - mesh0 (back faces below clip): toggles bit 7 via InvertStencilOp.
+   *  - mesh1 (front faces below clip): toggles bit 7 via InvertStencilOp.
+   *
+   * For closed manifold meshes from a camera outside the model, each balanced
+   * back/front pair toggles bit 7 twice (returning it to 0), while each unpaired
+   * back face above the clip leaves bit 7 = 1. The cap then renders where
+   * bit 7 == 1 and immediately clears bit 7 again with ZeroStencilOp.
+   *
+   * @param modelGeometry - The merged model geometry used for both passes
+   * @param plane - The user-defined clipping plane
+   * @param renderOrder - Base render order for the passes
    */
   private createHoleFillGeometry;
 }
@@ -20309,6 +20706,10 @@ type Systems = {
   pluginSystem: PluginSystem;
   shadowsSystem?: ShadowsSystem;
 };
+/**
+ * Top-level state for the MapView, exposing global hover colors that apply
+ * to all interactive elements. Returned by state APIs and consumed by extensions.
+ */
 type MapViewState$1 = {
   readonly type: 'map-view';
   hoverColor: string;
@@ -20744,6 +21145,7 @@ declare class GroupContainerObject3D extends Object3D {
   setVisible(visible: boolean): void;
   setAltitude(altitude: number): void;
   set2DGeometryChildrenPositionDirty(): void;
+  liftFocusableCaches(dz: number): void;
   get altitude(): number;
   setOpacity(opacity: number): void;
   get opacity(): number;
@@ -20820,7 +21222,16 @@ declare class Geometry2D {
 type Position$2 = [lon: number, lat: number] | [lon: number, lat: number, alt: number];
 //#endregion
 //#region ../renderer-three/src/types/options.d.ts
+/**
+ * Selects which environment map is used for image-based lighting.
+ * `'basic'` enables a default environment map, `false` disables environment lighting.
+ */
 type EnvMapOptions$2 = 'basic' | false;
+/**
+ * Low-level options consumed by `RendererCore` to configure rendering, camera
+ * defaults, outdoor view integration, and visual effects. Most consumers
+ * should use `TShow3DMapOptions` instead, which is converted into this shape internally.
+ */
 type RendererCoreOptions$2 = Partial<{
   center?: Position$2;
   zoomLevel?: number;
@@ -21024,9 +21435,14 @@ type BevelState = {
    */
   segments?: number;
 };
+/**
+ * Visual styling for filled (polygon-based) geometry such as spaces and shapes.
+ * Controls color, opacity, height, textures, bevel, shading and outlines.
+ */
 type PaintStyle$2 = {
   color: string;
   topColor?: string;
+  hoverColor?: string;
   height?: number;
   altitude?: number;
   opacity?: number;
@@ -21065,14 +21481,23 @@ type PaintStyle$2 = {
    */
   __EXPERIMENTAL_maskEnabled?: boolean;
 };
+/**
+ * Configures the vertical shading gradient applied to extruded geometry to give
+ * walls and shapes a sense of depth. `start` and `end` are normalized heights.
+ */
 type Shading$1 = {
   start?: number;
   end?: number;
   intensity?: number;
 };
+/**
+ * Visual styling for line-based geometry such as paths and connection lines.
+ * Controls color, width, caps/joins, shading and outlines.
+ */
 type LineStyle$2 = {
   color: string;
   topColor?: string;
+  hoverColor?: string;
   width: number;
   opacity?: number;
   height?: number;
@@ -21111,6 +21536,10 @@ type ModelProperties = {
    */
   visibleThroughGeometry?: boolean;
 };
+/**
+ * Padding applied to the camera's visible area so map content stays clear of
+ * UI overlays such as headers, sidebars and bottom sheets.
+ */
 type InsetPadding$2 = {
   top: number;
   left: number;
@@ -21268,6 +21697,11 @@ type MapEvent = {
  * All entities in 3D
  */
 type All3DTypes = Geometry3DTypes | FeatureCollectionObject3D | GroupContainerObject3D;
+/**
+ * Snapshot of the renderer's internal state passed to {@link ISystemPlugin}
+ * instances on every frame. Exposes the Three.js scene, camera and geometry
+ * registries so plugins can inspect or augment the render pipeline.
+ */
 type RendererState = {
   /**
    * A map of all 3D geometries in the world.
@@ -21483,7 +21917,16 @@ declare class MapLibreOverlay<T$1> extends PubSub<T$1> implements IControl {
   private handleMove;
   private handleMoveEnd;
   private handleError;
+  /**
+   * Called by MapLibre when this overlay is added to a map as an IControl.
+   * @param map - The MapLibre map this overlay is being attached to.
+   * @returns The DOM element rendered by this overlay.
+   */
   onAdd(map: Map$1): HTMLDivElement;
+  /**
+   * Called by MapLibre when this overlay is removed from a map. Detaches all
+   * map listeners, removes the custom layer, and destroys the underlying renderer.
+   */
   onRemove(): void;
 }
 //#endregion
@@ -21498,12 +21941,21 @@ declare const MAPPEDIN_COLORS: {
 };
 //#endregion
 //#region ../packages/common/Mappedin.Logger.d.ts
+/**
+ * SDK logging verbosity. Ordered from most verbose to least — selecting a level
+ * enables that level plus every level after it.
+ */
 declare enum E_SDK_LOG_LEVEL {
   LOG = 0,
   WARN = 1,
   ERROR = 2,
   SILENT = 3,
 }
+/**
+ * Set the SDK's global log verbosity. Lower levels include all higher-numbered levels;
+ * `SILENT` suppresses all output.
+ * @param level - The desired verbosity from {@link E_SDK_LOG_LEVEL}.
+ */
 declare function setLoggerLevel(level: E_SDK_LOG_LEVEL): void;
 //#endregion
 //#region src/utils/convert-renderer-core-options.d.ts
@@ -21515,6 +21967,11 @@ declare function setLoggerLevel(level: E_SDK_LOG_LEVEL): void;
 declare function convertToRendererCoreOptions(options: TShow3DMapOptions | undefined): Partial<RendererCoreOptions$1> | undefined;
 //#endregion
 //#region src/api-geojson/multi-floor.d.ts
+/**
+ * Multi-floor visibility state returned by {@link getMultiFloorState}, describing
+ * the outdoor opacity and per-floor state used when rendering a stacked view of
+ * multiple floors at once.
+ */
 type VisibilityState = {
   outdoorOpacity: number | 'initial';
   floorStates: {
@@ -21522,6 +21979,11 @@ type VisibilityState = {
     state: TFloorState;
   }[];
 };
+/**
+ * Configuration for the footprint rendered beneath stacked floors in multi-floor
+ * view, controlling its color, opacity, outlines, and the visual treatment of
+ * spaces open to the floor below.
+ */
 type FootprintConfig = {
   /**
    * The color of the footprint.
@@ -21981,6 +22443,23 @@ declare const checkWorkerUrls: () => Promise<false | {
   collision: boolean;
   maplibre: boolean;
 }>;
+/**
+ * Render a Mappedin map into the given DOM container and return its {@link MapView}.
+ *
+ * This is the main entry point for Mappedin JS. Combine with {@link getMapData}
+ * to load venue data and render an interactive 3D map.
+ *
+ * @param el - The container element to render the map into. Must be attached to the DOM and have non-zero size.
+ * @param mapData - Venue data, typically obtained from {@link getMapData}.
+ * @param options - Optional {@link TShow3DMapOptions} to customize the initial state, UI, and behavior of the map.
+ * @returns A promise that resolves to a {@link MapView} once the map has been initialized.
+ *
+ * @example
+ * ```ts
+ * const mapData = await getMapData({ key: '...', secret: '...', mapId: '...' });
+ * const mapView = await show3dMap(document.getElementById('mappedin-map')!, mapData);
+ * ```
+ */
 declare const show3dMap: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
 /**
  * Returns the package version of the SDK.