@mappedin/mappedin-js 6.21.0 → 6.22.0

package/lib/esm/index.d.ts

@@ -1,8 +1,8 @@
-import * as _mappedin_mvf_v22 from "@mappedin/mvf-v2";
+import * as _mappedin_mvf_v26 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, 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 { AddLabelOptionsInternal, AddText3DOptions, AddText3DOptions as AddText3DOptions$1, AddText3DPointOptions, AddText3DPointOptions as AddText3DPointOptions$1, 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";
@@ -4426,6 +4426,22 @@ declare class PathSegment$1 implements IFocusable {
   get distance(): number;
   /** @internal */
   get focusTarget(): Coordinate[];
+  /**
+   * Serializes the path segment to JSON.
+   *
+   * `isConnectionSegment` and `distance` are computed getters, so they are included explicitly
+   * here — otherwise they would be dropped by `JSON.stringify` (e.g. when a {@link Path} crosses
+   * the React Native / native WebView bridge, where consumers rely on `segment.isConnectionSegment`).
+   *
+   * @returns An object representing the path segment.
+   */
+  toJSON(): {
+    __type: string;
+    id: string;
+    coordinates: Coordinate[];
+    isConnectionSegment: boolean;
+    distance: number;
+  };
 }
 /**
  * Class representing a path on the {@link MapView}.
@@ -4490,6 +4506,17 @@ declare class Path implements IFocusable {
 //#endregion
 //#region ../packages/common/interpolate.d.ts
 declare const EASING_CURVES: readonly ["ease-in", "ease-out", "ease-in-out", "linear", "ease-out-cubic"];
+/**
+ * The set of easing curves that can be applied when interpolating a value.
+ *
+ * - `linear`: constant rate of change from start to end.
+ * - `ease-in`: starts slowly, then accelerates.
+ * - `ease-out`: starts quickly, then decelerates.
+ * - `ease-in-out`: starts slowly, accelerates through the middle, then decelerates.
+ * - `ease-out-cubic`: a stronger ease-out using a cubic curve.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/animation-timing-function
+ */
 type EasingCurve = (typeof EASING_CURVES)[number];
 //#endregion
 //#region src/navigation/tethered.d.ts
@@ -4609,6 +4636,27 @@ type TTrackCoordinateOptions = {
  * ```
  */
 type TCreateMarker = boolean | ((instruction: TDirectionInstruction) => Marker);
+/**
+ * The role a {@link Marker} plays within a drawn navigation route.
+ *
+ * - `departure` — the pin marking the start of the route.
+ * - `destination` — the flag marking the end of the route.
+ * - `connection` — a marker at a floor change (e.g. stairs, elevator).
+ */
+type TNavigationMarkerType = 'departure' | 'destination' | 'connection';
+/**
+ * A {@link Marker} drawn as part of a navigation route, paired with the role it
+ * plays in that route. Returned by {@link Navigation.markers}.
+ */
+type TNavigationMarker = {
+  /**
+   * The underlying {@link Marker}. Pass it to {@link MapView.updateState} to
+   * change its state (for example, `{ enabled: false }` to hide it).
+   */
+  marker: Marker;
+  /** Which part of the route this marker represents. */
+  type: TNavigationMarkerType;
+};
 /**
  * Path options extended with connection-specific overrides for Navigation.
  * Connection paths inherit all base path options unless overridden with `__EXPERIMENTAL__CONNECTION_*` properties.
@@ -4728,6 +4776,7 @@ type NavigationState = {
   activeDirections?: Directions;
   activePath?: Path;
   paths: Path[];
+  markers: TNavigationMarker[];
 };
 /**
  * Navigation-specific event types.
@@ -4784,11 +4833,32 @@ declare class Navigation {
   getMarkerById(id: string): {
     instruction: TDirectionInstruction;
     marker: Marker;
+    type: TNavigationMarkerType;
   } | undefined;
   /**
    * @internal
    */
   get paths(): Path[];
+  /**
+   * The markers drawn for the currently drawn navigation route: the departure
+   * and destination pins, plus a marker at each connection (floor change).
+   *
+   * Navigation markers are drawn with an `always-visible` collision rank so
+   * they are never dropped by label collision. As a side effect they also stay
+   * visible when the current floor changes. To control their visibility per
+   * floor, combine this with {@link MapView.updateState} and each marker's
+   * {@link Marker.coordinate}.
+   *
+   * @returns An array of {@link TNavigationMarker}, each pairing a {@link Marker} with its role in the route.
+   * @example Hide navigation markers that aren't on the current floor
+   * ```ts
+   * for (const { marker } of mapView.Navigation.markers) {
+   *   const onCurrentFloor = marker.coordinate.floorId === mapView.currentFloor?.id;
+   *   mapView.updateState(marker, { enabled: onCurrentFloor });
+   * }
+   * ```
+   */
+  get markers(): TNavigationMarker[];
   /**
    * The currently active directions.
    */
@@ -7443,20 +7513,82 @@ declare class MapView {
   getOptimalVisualDistanceBetweenFloors(floors: Floor[]): number | undefined;
   /**
    * @internal
-   * @deprecated For legacy use only
+   * @deprecated Use per-floor and per-segment state instead — see {@link MapView.updateState | updateState}.
    *
    * If true, the map will hide paths not on the current floor.
    *
+   * For FLOOR paths, prefer toggling the floor's paths layer directly:
+   * `mapView.updateState(floor, { paths: { visible: false } })`.
+   *
+   * CONNECTION paths span two floors and are not part of any floor's paths layer, so they are
+   * unaffected by the floor toggle above. Hide them per-segment via
+   * `mapView.updateState(segment, { visible: false })`, filtering
+   * `mapView.Navigation.paths[].segments` by `segment.isConnectionSegment`.
+   *
    * @default false
+   *
+   * @example
+   * ```ts
+   * // Hide paths on every floor except the current one
+   * for (const floor of mapData.getByType('floor')) {
+   * 	mapView.updateState(floor, { paths: { visible: floor.id === mapView.currentFloor?.id } });
+   * }
+   *
+   * // Connection segments aren't owned by a floor — hide the ones that don't
+   * // touch the current floor on either end
+   * for (const path of mapView.Navigation.paths) {
+   * 	for (const segment of path.segments) {
+   * 		if (!segment.isConnectionSegment) continue;
+   * 		const touchesCurrentFloor = segment.coordinates.some(
+   * 			(c) => c.floorId === mapView.currentFloor?.id
+   * 		);
+   * 		mapView.updateState(segment, { visible: touchesCurrentFloor });
+   * 	}
+   * }
+   * ```
+   *
+   * @see {@link MapView.updateState | updateState} to toggle floor and segment visibility.
+   * @see Navigation_-_Path_Visibility.ts for a complete example.
    */
   get __INTERNAL__hidePathsNotOnCurrentFloor(): boolean;
   /**
    * @internal
-   * @deprecated For legacy use only
+   * @deprecated Use per-floor and per-segment state instead — see {@link MapView.updateState | updateState}.
    *
    * If true, the map will hide paths not on the current floor.
    *
+   * For FLOOR paths, prefer toggling the floor's paths layer directly:
+   * `mapView.updateState(floor, { paths: { visible: false } })`.
+   *
+   * CONNECTION paths span two floors and are not part of any floor's paths layer, so they are
+   * unaffected by the floor toggle above. Hide them per-segment via
+   * `mapView.updateState(segment, { visible: false })`, filtering
+   * `mapView.Navigation.paths[].segments` by `segment.isConnectionSegment`.
+   *
    * @default false
+   *
+   * @example
+   * ```ts
+   * // Hide paths on every floor except the current one
+   * for (const floor of mapData.getByType('floor')) {
+   * 	mapView.updateState(floor, { paths: { visible: floor.id === mapView.currentFloor?.id } });
+   * }
+   *
+   * // Connection segments aren't owned by a floor — hide the ones that don't
+   * // touch the current floor on either end
+   * for (const path of mapView.Navigation.paths) {
+   * 	for (const segment of path.segments) {
+   * 		if (!segment.isConnectionSegment) continue;
+   * 		const touchesCurrentFloor = segment.coordinates.some(
+   * 			(c) => c.floorId === mapView.currentFloor?.id
+   * 		);
+   * 		mapView.updateState(segment, { visible: touchesCurrentFloor });
+   * 	}
+   * }
+   * ```
+   *
+   * @see {@link MapView.updateState | updateState} to toggle floor and segment visibility.
+   * @see Navigation_-_Path_Visibility.ts for a complete example.
    */
   set __INTERNAL__hidePathsNotOnCurrentFloor(value: boolean);
   /**
@@ -9149,7 +9281,7 @@ type TGeometryUpdateState = output<typeof geometryStateSchemaPartial>;
 declare const labelStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"label">>;
   text: ZodString;
-  rank: ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>;
+  rank: ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">;
   appearance: ZodCustom<LabelAppearance, LabelAppearance>;
   interactive: ZodDefault<ZodBoolean>;
   enabled: ZodDefault<ZodBoolean>;
@@ -9172,7 +9304,7 @@ declare const labelStateSchema: ZodObject<{
 declare const labelStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"label">>>;
   text: ZodOptional<ZodString>;
-  rank: ZodOptional<ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>>;
+  rank: ZodOptional<ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">>;
   appearance: ZodOptional<ZodCustom<LabelAppearance, LabelAppearance>>;
   interactive: ZodOptional<ZodDefault<ZodBoolean>>;
   enabled: ZodOptional<ZodDefault<ZodBoolean>>;
@@ -9205,7 +9337,7 @@ type TLabelUpdateState = output<typeof labelStateSchemaPartial>;
 /** @internal */
 declare const markerStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"marker">>;
-  rank: ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>;
+  rank: ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">;
   placement: ZodOptional<ZodUnion<readonly [ZodEnum<{
     hidden: "hidden";
     top: "top";
@@ -9247,9 +9379,7 @@ declare const markerStateSchema: ZodObject<{
 declare const markerStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"marker">>>;
   enabled: ZodOptional<ZodDefault<ZodBoolean>>;
-  interactive: ZodOptional<ZodDefault<ZodUnion<readonly [ZodBoolean, ZodLiteral<"pointer-events-auto">]>>>;
-  rank: ZodOptional<ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>>;
-  occlude: ZodOptional<ZodDefault<ZodBoolean>>;
+  rank: ZodOptional<ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">>;
   placement: ZodOptional<ZodOptional<ZodUnion<readonly [ZodEnum<{
     hidden: "hidden";
     top: "top";
@@ -9273,6 +9403,7 @@ declare const markerStateSchemaPartial: ZodObject<{
     "bottom-left": "bottom-left";
     "bottom-right": "bottom-right";
   }>>]>>>;
+  interactive: ZodOptional<ZodDefault<ZodUnion<readonly [ZodBoolean, ZodLiteral<"pointer-events-auto">]>>>;
   dynamicResize: ZodOptional<ZodDefault<ZodBoolean>>;
   zIndex: ZodOptional<ZodOptional<ZodNumber>>;
   lowPriorityPin: ZodOptional<ZodOptional<ZodObject<{
@@ -9281,6 +9412,7 @@ declare const markerStateSchemaPartial: ZodObject<{
     color: ZodOptional<ZodString>;
   }, $strip>>>;
   contentHTML: ZodOptional<ZodString>;
+  occlude: ZodOptional<ZodDefault<ZodBoolean>>;
   animated: ZodOptional<ZodDefault<ZodBoolean>>;
 }, $strip>;
 /**
@@ -9306,6 +9438,7 @@ declare const pathStateSchemaPartial: ZodObject<{
   width: ZodOptional<ZodType<PathWidth$2, unknown, $ZodTypeInternals<PathWidth$2, unknown>>>;
   completeFraction: ZodOptional<ZodDefault<ZodNumber>>;
   visible: ZodOptional<ZodDefault<ZodBoolean>>;
+  interactive: ZodOptional<ZodDefault<ZodBoolean>>;
   verticalOffset: ZodOptional<ZodDefault<ZodNumber>>;
   highlightStartFraction: ZodOptional<ZodDefault<ZodNumber>>;
   highlightEndFraction: ZodOptional<ZodDefault<ZodNumber>>;
@@ -9358,6 +9491,7 @@ declare const pathStateSchemaStrict: ZodObject<{
   width: ZodType<PathWidth$2>;
   completeFraction: ZodDefault<ZodNumber>;
   visible: ZodDefault<ZodBoolean>;
+  interactive: ZodDefault<ZodBoolean>;
   verticalOffset: ZodDefault<ZodNumber>;
   highlightStartFraction: ZodDefault<ZodNumber>;
   highlightEndFraction: ZodDefault<ZodNumber>;
@@ -11619,7 +11753,7 @@ type TAddText3DOptions = AddText3DOptions$1;
 /**
  * Options for adding 3D text at an anchorable target (e.g., Coordinate).
  */
-type TAddText3DAnchorableOptions = AddText3DPointOptions;
+type TAddText3DAnchorableOptions = AddText3DPointOptions$1;
 /**
  * Options for controlling the behavior of an {@link Image3DView}.
  */
@@ -12875,8 +13009,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_v26.FeatureType;
+    geometry: _mappedin_mvf_v26.Polygon;
   };
   /** @internal */
   get focusTarget(): this;
@@ -12978,8 +13112,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_v26.FeatureType;
+    geometry: _mappedin_mvf_v26.LineString;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -13115,8 +13249,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_v26.FeatureType;
+    geometry: _mappedin_mvf_v26.Point | _mappedin_mvf_v26.LineString | _mappedin_mvf_v26.Polygon;
   };
   /** @internal */
   get focusTarget(): this | Coordinate;
@@ -13202,7 +13336,7 @@ declare class PointOfInterest extends DetailedMapData<FeatureCollection$1<Point$
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v22.FeatureType;
+    type: _mappedin_mvf_v26.FeatureType;
     geometry: Point$1;
   };
   /**
@@ -13316,8 +13450,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_v26.FeatureType;
+    geometry: _mappedin_mvf_v26.Point;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -13533,8 +13667,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_v26.FeatureType;
+    geometry: _mappedin_mvf_v26.LineString | _mappedin_mvf_v26.Polygon;
   };
   /** @internal */
   get anchorTarget(): Coordinate;
@@ -13847,8 +13981,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_v26.FeatureType;
+    geometry: _mappedin_mvf_v26.Point;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -15904,7 +16038,7 @@ declare class MapData {
    * console.log(`Current language: ${language.name} (${language.code})`);
    * ```
    */
-  get currentLanguage(): _mappedin_mvf_v22.Language | undefined;
+  get currentLanguage(): _mappedin_mvf_v26.Language | undefined;
   /**
    * Gets the natural bearing of the map.
    *
@@ -15931,18 +16065,29 @@ declare class MapData {
    * @param from The starting location(s).
    * @param to The destination location(s).
    * @param options Optional configuration for the directions calculation.
-   * @returns A {@link Directions} object containing the route, or undefined if no route is found.
+   * @returns A {@link Directions} object containing the route, or `undefined` if no route is found.
    *
-   * @example Get directions between two spaces
+   * @remarks
+   * When the origin and destination resolve to the same location — for example a {@link Coordinate}
+   * inside a {@link Space} routed to that same space, the caller is already at the destination.
+   * In that case a **defined**  {@link Directions} is still returned, but it has a `distance` of `0`
+   * and an empty `coordinates` array (there is no path to draw or follow).
+   * This is distinct from `undefined`, which means no route could be found at all. To detect this case,
+   * check `directions.coordinates.length === 0` (or `directions.distance === 0`).
+   *
+   * @example Get directions between two spaces, handling the "already at destination" case
    * ```ts
    * const space1 = mapData.getById('space', 'space-123');
    * const space2 = mapData.getById('space', 'space-456');
    *
    * if (space1 && space2) {
    *   const directions = await mapData.getDirections(space1, space2);
-   *   if (directions) {
+   *   if (!directions) {
+   *     console.log('No route found');
+   *   } else if (directions.coordinates.length === 0) {
+   *     console.log('Already at destination — nothing to draw');
+   *   } else {
    *     console.log(`Distance: ${directions.distance}m`);
-   *     console.log(`Duration: ${directions.duration}s`);
    *     directions.instructions.forEach(instruction => {
    *       console.log(instruction.action.type);
    *     });
@@ -19702,6 +19847,7 @@ declare class GeometryInFocusSystem extends PubSub<{
   private viewfinder;
   private screenBoundsMap;
   private screenDiagonal;
+  private lastPublishedEntities?;
   constructor(state: RendererState, camera: Camera$1);
   resize(): void;
   /**
@@ -21392,6 +21538,13 @@ type RendererCoreOptions$2 = Partial<{
   transformImageRequest?: TransformImageRequest;
   useWorkers?: boolean;
   useCollisionWorker?: boolean;
+  /**
+   * When true, skips zod validation of label/marker inputs on add and update.
+   * Map-global perf escape hatch for bulk operations where inputs are already
+   * known-good. Mirrors the `disableUpdateStateValidation` map option.
+   * @default false
+   */
+  disableUpdateStateValidation?: boolean;
   /**
    * Shadow rendering configuration
    * @experimental
@@ -21871,6 +22024,8 @@ type RendererState = {
   readonly geometryScene: GroupContainerObject3D;
   hoverColor: string;
   text3dHoverColor: string;
+  /** When true, label/marker input validation is skipped (perf escape hatch). */
+  disableUpdateStateValidation: boolean;
   center?: Position$2;
   insetsPadding: InsetPadding$2;
   shouldMeasureCanvas: boolean;
@@ -22132,6 +22287,12 @@ type FootprintConfig = {
   outline: boolean;
   /** Whether spaces open to below (ceiling cutouts) are enabled. */
   spacesOpenToBelowEnabled: boolean;
+  /**
+   * Resolve the "floor above" by nearest-higher elevation instead of exact `elevation + 1`,
+   * so open-to-below voids cut across non-contiguous ordinals (physically adjacent floors
+   * numbered e.g. 0,1,3,5,6). See design/0001-noncontiguous-void-adjacency.md.
+   */
+  disableGapFilling?: boolean;
   spacesOpenToBelowVisualEffectEnabled?: boolean;
   spacesOpenToBelowVisualEffectDarkenAmount?: number;
   spacesOpenToBelowVisualEffectDarkenUseDepth?: boolean;
@@ -22261,8 +22422,6 @@ type TShow3DMapOptions = {
   watermark?: TWatermarkOptions;
   /**
    * Options for the attribution control.
-   *
-   * @hidden
    */
   attribution?: {
     /**
@@ -22606,4 +22765,4 @@ declare const getVersion: () => string | undefined;
  */
 declare const show3dMapGeojson: (el: HTMLElement, mapData: MapData, options?: TShow3DMapOptions) => Promise<MapView>;
 //#endregion
-export { ACTION_TYPE, ANIMATION_TWEENS, type AddText3DOptions, type Analytics, Annotation, Area, type AutoElements, BBox, BEARING_TYPE, CONNECTION_TYPE, type Camera, type CameraBounds, type CameraTransform, type CaptureEventsPayloadMap, type ColorString, Connection, Coordinate, DOORS, type Debug, type DebugState, DetailedMapData, Directions, Door, E_SDK_LOG_LEVEL, EnterpriseCategory, EnterpriseLocation, EnterpriseVenue, type EnvMapOptions, type Environment, type Exporter, Facade, Feature, FeatureCollection, Floor, FloorStack, type FootprintConfig, GeoJSON$1 as GeoJSON, GeoJsonGeometryTypes, GeoJsonObject, GeoJsonProperties, GeoJsonTypes, Geometry, GeometryCollection, GeometryObject, type GlobalState, Hyperlink, type IAnchorable, type IFocusable, type IGeoJSONData, type INavigatable, type ISystemPlugin, type Image3D, type Image3DView, ImageMetaData, type InitializeModelState, type InitializeText3DState, type InsetPadding, type InsetPaddingOption, type InterpolateOn, type Interpolation, type Label, type LabelAppearance, type LabelTextPlacement, type Labels, LineString, type LineStyle, LocationCategory, LocationProfile, type LocationSocial, type LocationState, MAPPEDIN_COLORS, type MapData, type MapDataElements, type MapElementToGetRenderedState, type MapElementToGetState, type MapElementToUpdateState, type MapElementsWithState, type MapFeatureOfType, MapObject, MapView, type MapViewElements, type MapViewState, type MappedinError, type MappedinRenderError, type Marker, type Markers, type MatchInfo, type Model, type Models, type MultiFloorViewEffectState, MultiLineString, MultiPoint, MultiPolygon, type Navigation, type NavigationState, Node, type OpeningHours, type OperationHours, type Outdoor, type OutlinesOptions, type PaintStyle, type Path, type PathSegment$1 as PathSegment, type PathWidth, type Paths, type PixelWidth, type Places, Point, PointOfInterest, Polygon, type Position, type PubSub, type Query, type RendererCoreOptions, type Search, type SearchOptions, type SearchResult, type SearchResultEnterpriseCategory, type SearchResultEnterpriseLocations, type SearchResultItem, type SearchResultPlaces, type Shading, type Shape, type Shapes, type SiblingGroup, Space, type Style, type Suggestion, type TActionType, type TAddImageOptions, type TAddLabelOptions, type TAddMarkerOptions, type TAddModel, type TAddModelOptions, type TAddPathOptions, type TAddText3DAnchorableOptions, type TAddText3DOptions, type TAnalyticsUpdateState, type TAnimateStateResult, type TAnimationOptions, type TAntialiasingOptions, type TBearingType, type TCameraAnimationOptions, type TCameraInteractionsSetOptions, type TCameraTarget, type TCancellablePromise, type TClickPayload, type TCollisionRankingTier, type TConnectionPathOptions, type TConnectionType, type TCoordinateParams, type TCreateMarker, type TDirectionInstruction, type TDirectionInstructionAction, type TDirectionZone, type TDoorsState, type TDoorsUpdateState, type TEasingFunction, type TEventPayload, type TEvents, type TExperimentalDashOptions, type TFacadeState, type TFacadeUpdateState, type TFindNearestOptions, type TFindNearestResult, type TFindPreferredLanguageInVenueOptions, type TFloorAltitudeData, type TFloorChangePayload, type TFloorChangeReason, type TFloorState, type TFloorUpdateState, type TFocusOnOptions, type TFocusTarget, type TGeometryState, type TGeometryUpdateState, type TGetDirectionsOptions, type TGetMapDataOptions, type TGetMapDataSharedOptions, type TGetMapDataWithAccessTokenOptions, type TGetMapDataWithCredentialsOptions, type TGetState, type THoverPayload, type THydrateMapDataBundle, type TImage3DState as TImageState, type TImage3DUpdateState as TImageUpdateState, type TLabelState, type TLabelUpdateState, type TMVF, type TMVFLineStringStyle, type TMVFPointStyle, type TMVFPolygonStyle, type TMVFStyle, type TMVFStyleCollection, type TMapDataEvents, type TMapDataObjectTypes, type TMapFeatureTypes, type TMapViewObjectTypes, type TMarkerPlacement, type TMarkerState, type TMarkerUpdateState, type TModelState, type TModelUpdateState, type TMultiFloorViewOptions, type TNavigationOptions, type TNavigationPathOptions, type TNavigationTarget, type TOutsideThresholdPathStyle, type TPathSectionHighlightOptions, type TPathState, type TPathUpdateState, type TQueriables, type TQueryAtResult, type RendererState as TRendererState, type TSearchOptions, type TSetFloorOptions, type TShapeState, type TShapeUpdateState, type TShow3DMapOptions, type TSpaceType, type TStateChangedInternalPayload, type TTakeScreenshotOptions, type TTetheredOptions as TTetherOptions, type TText3DState, type TText3DUpdateState, type TTrackCoordinateOptions, type TTravelledOptions, type TUpdateState, type TWallsState, type TWallsUpdateState, TWatermarkOptions, type Text3D, type Text3DView, type UpdateGlobalState, type VisibilityState, WALLS, type WithState, MAPPEDIN_LAYER_ID as __INTERNAL__MAPPEDIN_LAYER_ID, MapLibreOverlay as __INTERNAL__MapLibreOverlay, Core as __INTERNAL__RendererCore, convertToRendererCoreOptions as __INTERNAL__convertToRendererCoreOptions, __setWatermarkOnClickFn, checkWorkerUrls, disableText3DWorker, enableTestMode, findPreferredLanguageInVenue, forceEnterpriseLocations, getMapData, getMapDataEnterprise, getMultiFloorState, getVersion, hydrateMapData, hydrateMapDataFromMVF, parseMVFv2 as parseMVF, preloadFont, setLoggerLevel, setUseEnterpriseAPI, setWorkersUrl, shouldForceEnterpriseLocations, show3dMap, show3dMapGeojson, unzipAndParseMVFv2, unzipMVFv2 as unzipMVF };
+export { ACTION_TYPE, ANIMATION_TWEENS, type AddText3DOptions, type AddText3DPointOptions, type Analytics, Annotation, Area, type AutoElements, BBox, BEARING_TYPE, CONNECTION_TYPE, type Camera, type CameraBounds, type CameraTransform, type CaptureEventsPayloadMap, type ColorString, Connection, Coordinate, DOORS, type Debug, type DebugState, DetailedMapData, Directions, Door, E_SDK_LOG_LEVEL, type EasingCurve, EnterpriseCategory, EnterpriseLocation, EnterpriseVenue, type EnvMapOptions, type Environment, type Exporter, Facade, Feature, FeatureCollection, Floor, FloorStack, type FootprintConfig, GeoJSON$1 as GeoJSON, GeoJsonGeometryTypes, GeoJsonObject, GeoJsonProperties, GeoJsonTypes, Geometry, GeometryCollection, GeometryObject, type GlobalState, Hyperlink, type IAnchorable, type IFocusable, type IGeoJSONData, type INavigatable, type ISystemPlugin, type Image3D, type Image3DView, ImageMetaData, type InitializeModelState, type InitializeText3DState, type InsetPadding, type InsetPaddingOption, type InterpolateOn, type Interpolation, type Label, type LabelAppearance, type LabelTextPlacement, type Labels, LineString, type LineStyle, LocationCategory, LocationProfile, type LocationSocial, type LocationState, MAPPEDIN_COLORS, type MapData, type MapDataElements, type MapElementToGetRenderedState, type MapElementToGetState, type MapElementToUpdateState, type MapElementsWithState, type MapFeatureOfType, MapObject, MapView, type MapViewElements, type MapViewState, type MappedinError, type MappedinRenderError, type Marker, type Markers, type MatchInfo, type Model, type Models, type MultiFloorViewEffectState, MultiLineString, MultiPoint, MultiPolygon, type Navigation, type NavigationState, Node, type OpeningHours, type OperationHours, type Outdoor, type OutlinesOptions, type PaintStyle, type Path, type PathSegment$1 as PathSegment, type PathWidth, type Paths, type PixelWidth, type Places, Point, PointOfInterest, Polygon, type Position, type PubSub, type Query, type RendererCoreOptions, type Search, type SearchOptions, type SearchResult, type SearchResultEnterpriseCategory, type SearchResultEnterpriseLocations, type SearchResultItem, type SearchResultPlaces, type Shading, type Shape, type Shapes, type SiblingGroup, Space, type Style, type Suggestion, type TActionType, type TAddImageOptions, type TAddLabelOptions, type TAddMarkerOptions, type TAddModel, type TAddModelOptions, type TAddPathOptions, type TAddText3DAnchorableOptions, type TAddText3DOptions, type TAnalyticsUpdateState, type TAnimateStateResult, type TAnimationOptions, type TAntialiasingOptions, type TBearingType, type TCameraAnimationOptions, type TCameraInteractionsSetOptions, type TCameraTarget, type TCancellablePromise, type TClickPayload, type TCollisionRankingTier, type TConnectionPathOptions, type TConnectionType, type TCoordinateParams, type TCreateMarker, type TDirectionInstruction, type TDirectionInstructionAction, type TDirectionZone, type TDoorsState, type TDoorsUpdateState, type TEasingFunction, type TEventPayload, type TEvents, type TExperimentalDashOptions, type TFacadeState, type TFacadeUpdateState, type TFindNearestOptions, type TFindNearestResult, type TFindPreferredLanguageInVenueOptions, type TFloorAltitudeData, type TFloorChangePayload, type TFloorChangeReason, type TFloorState, type TFloorUpdateState, type TFocusOnOptions, type TFocusTarget, type TGeometryState, type TGeometryUpdateState, type TGetDirectionsOptions, type TGetMapDataOptions, type TGetMapDataSharedOptions, type TGetMapDataWithAccessTokenOptions, type TGetMapDataWithCredentialsOptions, type TGetState, type THoverPayload, type THydrateMapDataBundle, type TImage3DState as TImageState, type TImage3DUpdateState as TImageUpdateState, type TLabelState, type TLabelUpdateState, type TMVF, type TMVFLineStringStyle, type TMVFPointStyle, type TMVFPolygonStyle, type TMVFStyle, type TMVFStyleCollection, type TMapDataEvents, type TMapDataObjectTypes, type TMapFeatureTypes, type TMapViewObjectTypes, type TMarkerPlacement, type TMarkerState, type TMarkerUpdateState, type TModelState, type TModelUpdateState, type TMultiFloorViewOptions, type TNavigationMarker, type TNavigationMarkerType, type TNavigationOptions, type TNavigationPathOptions, type TNavigationTarget, type TOutsideThresholdPathStyle, type TPathSectionHighlightOptions, type TPathState, type TPathUpdateState, type TQueriables, type TQueryAtResult, type RendererState as TRendererState, type TSearchOptions, type TSetFloorOptions, type TShapeState, type TShapeUpdateState, type TShow3DMapOptions, type TSpaceType, type TStateChangedInternalPayload, type TTakeScreenshotOptions, type TTetheredOptions as TTetherOptions, type TText3DState, type TText3DUpdateState, type TTrackCoordinateOptions, type TTravelledOptions, type TUpdateState, type TWallsState, type TWallsUpdateState, TWatermarkOptions, type Text3D, type Text3DView, type UpdateGlobalState, type VisibilityState, WALLS, type WithState, MAPPEDIN_LAYER_ID as __INTERNAL__MAPPEDIN_LAYER_ID, MapLibreOverlay as __INTERNAL__MapLibreOverlay, Core as __INTERNAL__RendererCore, convertToRendererCoreOptions as __INTERNAL__convertToRendererCoreOptions, __setWatermarkOnClickFn, checkWorkerUrls, disableText3DWorker, enableTestMode, findPreferredLanguageInVenue, forceEnterpriseLocations, getMapData, getMapDataEnterprise, getMultiFloorState, getVersion, hydrateMapData, hydrateMapDataFromMVF, parseMVFv2 as parseMVF, preloadFont, setLoggerLevel, setUseEnterpriseAPI, setWorkersUrl, shouldForceEnterpriseLocations, show3dMap, show3dMapGeojson, unzipAndParseMVFv2, unzipMVFv2 as unzipMVF };

package/lib/esm/index.js

@@ -1 +1 @@
-import{A as C,B as D,C as E,D as F,E as M,F as N,I as O,J as P,K as Q,L as R,M as S,N as T,O as U,P as V,Q as W,R as X,S as Y,T as Z,U as _,V as $,W as aa,X as ba,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-VJT5KQYB.js";import{v as K,x as L}from"./chunk-LJC6K2N5.js";import{Da as I,P as G,Y as H,a,c as b,nb as J}from"./chunk-S3S2TZVB.js";import"./chunk-F4OI5ZPF.js";import"./chunk-3IQDSCDT.js";import"./chunk-PWEV3AFA.js";export{y as ACTION_TYPE,G as ANIMATION_TWEENS,p as Annotation,i as Area,z as BEARING_TYPE,A as CONNECTION_TYPE,m as Connection,c as Coordinate,C as DOORS,g as DetailedMapData,D as Directions,j as Door,a as E_SDK_LOG_LEVEL,t as EnterpriseCategory,s as EnterpriseLocation,u as EnterpriseVenue,r as Facade,l as Floor,q as FloorStack,e as Hyperlink,f as ImageMetaData,F as LocationCategory,E as LocationProfile,h as MAPPEDIN_COLORS,n as MapObject,P as MapView,d as Node,o as PointOfInterest,k as Space,B as WALLS,I as __INTERNAL__MAPPEDIN_LAYER_ID,L as __INTERNAL__MapLibreOverlay,K as __INTERNAL__RendererCore,R as __INTERNAL__convertToRendererCoreOptions,T as __setWatermarkOnClickFn,_ as checkWorkerUrls,N as disableText3DWorker,H as enableTestMode,S as findPreferredLanguageInVenue,W as forceEnterpriseLocations,Y as getMapData,Z as getMapDataEnterprise,M as getMultiFloorState,aa as getVersion,Q as hydrateMapData,U as hydrateMapDataFromMVF,v as parseMVF,J as preloadFont,b as setLoggerLevel,V as setUseEnterpriseAPI,O as setWorkersUrl,X as shouldForceEnterpriseLocations,$ as show3dMap,ba as show3dMapGeojson,x as unzipAndParseMVFv2,w as unzipMVF};
+import{A as C,B as D,C as E,D as F,E as M,F as N,I as O,J as P,K as Q,L as R,M as S,N as T,O as U,P as V,Q as W,R as X,S as Y,T as Z,U as _,V as $,W as aa,X as ba,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-Q25YCNKX.js";import{v as K,x as L}from"./chunk-HYINSTT6.js";import{Da as I,P as G,Y as H,a,c as b,nb as J}from"./chunk-WQRLPX6X.js";import"./chunk-NGRMTFSH.js";import"./chunk-JVDXHWBF.js";import"./chunk-PWEV3AFA.js";export{y as ACTION_TYPE,G as ANIMATION_TWEENS,p as Annotation,i as Area,z as BEARING_TYPE,A as CONNECTION_TYPE,m as Connection,c as Coordinate,C as DOORS,g as DetailedMapData,D as Directions,j as Door,a as E_SDK_LOG_LEVEL,t as EnterpriseCategory,s as EnterpriseLocation,u as EnterpriseVenue,r as Facade,l as Floor,q as FloorStack,e as Hyperlink,f as ImageMetaData,F as LocationCategory,E as LocationProfile,h as MAPPEDIN_COLORS,n as MapObject,P as MapView,d as Node,o as PointOfInterest,k as Space,B as WALLS,I as __INTERNAL__MAPPEDIN_LAYER_ID,L as __INTERNAL__MapLibreOverlay,K as __INTERNAL__RendererCore,R as __INTERNAL__convertToRendererCoreOptions,T as __setWatermarkOnClickFn,_ as checkWorkerUrls,N as disableText3DWorker,H as enableTestMode,S as findPreferredLanguageInVenue,W as forceEnterpriseLocations,Y as getMapData,Z as getMapDataEnterprise,M as getMultiFloorState,aa as getVersion,Q as hydrateMapData,U as hydrateMapDataFromMVF,v as parseMVF,J as preloadFont,b as setLoggerLevel,V as setUseEnterpriseAPI,O as setWorkersUrl,X as shouldForceEnterpriseLocations,$ as show3dMap,ba as show3dMapGeojson,x as unzipAndParseMVFv2,w as unzipMVF};