@mappedin/mappedin-js 6.22.0 → 6.24.0

package/lib/esm/index.d.ts

@@ -1,15 +1,15 @@
-import * as _mappedin_mvf_v26 from "@mappedin/mvf-v2";
+import * as _mappedin_mvf_v22 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 three0 from "three";
+import { AmbientLight, BatchedMesh, BatchedMeshGeometryRange, Box3, BufferAttribute, BufferGeometry, Camera as Camera$1, Color, DirectionalLight, Group, Intersection, LineSegments, Matrix4, Mesh, MeshLambertMaterial, MeshLambertMaterialParameters, Object3D, Object3DEventMap, PerspectiveCamera, Plane, PlaneGeometry, Raycaster, Scene, ShaderMaterial, Texture, TubeGeometry, Vector2, Vector3, WebGLRenderer } from "three";
 import * as _mappedin_renderer_three0 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 { Group as Group$1, Tween } from "@tweenjs/tween.js";
 import { CustomLayerInterface, IControl, Map as Map$1, MapEventType } from "@mappedin/outdoor-context";
 import { ANIMATION_TWEENS, PathWidth as PathWidth$2, PathWidth as PathWidth$3, enableTestMode } from "@mappedin/renderer-shared";
 import { MatchInfo, SearchResult as SearchResult$1, Suggestion, Suggestion as Suggestion$1 } from "minisearch";
-import * as three0 from "three";
-import { AmbientLight, BatchedMesh, BatchedMeshGeometryRange, Box3, BufferAttribute, BufferGeometry, Camera as Camera$1, Color, DirectionalLight, Group as Group$1, Intersection, LineSegments, Matrix4, Mesh, MeshLambertMaterial, MeshLambertMaterialParameters, Object3D, Object3DEventMap, PerspectiveCamera, Plane, PlaneGeometry, Raycaster, Scene, ShaderMaterial, Texture, TubeGeometry, Vector2, Vector3, WebGLRenderer } from "three";
 import { BatchedText, BatchedText as BatchedText$1, Text, Text as Text$1 } from "troika-three-text";
 import "../../renderer-three/src/styles/interactions.scss";
 import "../../renderer-three/src/styles/html-controls.scss";
@@ -209,6 +209,11 @@ type TSearchOptions = {
    */
   enabled: boolean;
 };
+/**
+ * A pre-resolved (typically signed) MVF bundle URL, or a function that returns one.
+ * The function form supports re-resolution when a signed URL expires.
+ */
+type TBundleUri = string | (() => string | Promise<string>);
 /**
  * Options shared by every {@link getMapData} call regardless of authentication mode.
  * Carries the target `mapId` and optional overrides such as environment, base URL,
@@ -235,6 +240,23 @@ type TGetMapDataSharedOptions = {
    * @internal
    */
   customAuthUri?: string;
+  /**
+   * A pre-resolved (typically signed) MVF bundle URL, or a function that returns one.
+   *
+   * When set, credentials are optional: the SDK downloads from this URL instead of
+   * resolving one via the Mappedin API, and takes precedence over both the Maker and
+   * enterprise resolvers. Obtaining the URL remains the caller's responsibility — this
+   * is not an auth bypass.
+   *
+   * The function form supports re-resolution when a signed URL expires.
+   *
+   * Declared here as well as required on {@link TGetMapDataWithBundleUriOptions} so that
+   * combining it with credentials (`{ key, secret, mapId, bundleUri }`) survives excess
+   * property checking — without it that object matches no member of the union.
+   * @hidden
+   * @internal
+   */
+  bundleUri?: TBundleUri;
   /**
    * Callback for when the Mappedin map data has been fetched and parsed as Mappedin Venue Format (MVF) data.
    * @param mvf Parsed MVF data.
@@ -364,10 +386,25 @@ type TGetMapDataWithAccessTokenOptions = {
   accessToken: string;
 } & TGetMapDataSharedOptions;
 /**
- * Options accepted by {@link getMapData}. Either credentials (`key`/`secret`) or an
- * `accessToken` may be supplied alongside the shared options.
+ * {@link getMapData} options that supply a pre-resolved bundle URL.
+ * Credentials are optional — the URL itself is the download source.
+ * @interface
+ * @hidden
+ * @internal
+ */
+type TGetMapDataWithBundleUriOptions = {
+  /**
+   * A pre-resolved (typically signed) MVF bundle URL, or a function that returns one.
+   * @hidden
+   * @internal
+   */
+  bundleUri: TBundleUri;
+} & TGetMapDataSharedOptions;
+/**
+ * Options accepted by {@link getMapData}. Supply credentials (`key`/`secret`) or an
+ * `accessToken` alongside the shared options.
  */
-type TGetMapDataOptions = TGetMapDataWithCredentialsOptions | TGetMapDataWithAccessTokenOptions;
+type TGetMapDataOptions = TGetMapDataWithCredentialsOptions | TGetMapDataWithAccessTokenOptions | TGetMapDataWithBundleUriOptions;
 /**
  * @internal
  */
@@ -492,6 +529,50 @@ type THydrateMapDataBundle = {
  */
 declare const hydrateMapData: (backup: THydrateMapDataBundle | ParsedMVF, userOptions?: TGetMapDataOptions) => Promise<MapData>;
 //#endregion
+//#region ../packages/common/Mappedin.Logger.d.ts
+/**
+ * SDK logging verbosity. Ordered from most verbose to least (`debug < info < warn < error`) —
+ * selecting a level enables that level plus every level after it. `SILENT` suppresses all output.
+ */
+declare enum E_SDK_LOG_LEVEL {
+  /** @deprecated Renamed to {@link E_SDK_LOG_LEVEL.DEBUG}. Kept as an alias for back-compat. */
+  LOG = 0,
+  DEBUG = 0,
+  INFO = 1,
+  WARN = 2,
+  ERROR = 3,
+  SILENT = 4,
+}
+/**
+ * Case-insensitive string names for {@link E_SDK_LOG_LEVEL}, accepted anywhere a log level can be set.
+ * `'log'` is a deprecated alias for `'debug'`, and `'silent'` suppresses all output.
+ */
+type TLogLevelName = 'debug' | 'info' | 'log' | 'warn' | 'error' | 'silent';
+/** Resolve a case-insensitive level name to an {@link E_SDK_LOG_LEVEL}; `undefined` if unrecognized. */
+declare function parseLogLevel(level: string): E_SDK_LOG_LEVEL | undefined;
+/**
+ * Set the SDK's global log verbosity. Lower levels include all higher-numbered levels;
+ * `SILENT` suppresses all output. Defaults to `INFO` (`DEBUG` is opt-in).
+ * @param level - The desired verbosity: a case-insensitive level name (`'debug'`, `'info'`,
+ * `'warn'`, `'error'`, `'silent'`) or an {@link E_SDK_LOG_LEVEL} value. An unrecognized or
+ * out-of-range value warns rather than silently no-ops.
+ */
+declare function setLoggerLevel(level: E_SDK_LOG_LEVEL | TLogLevelName): void;
+//#endregion
+//#region ../packages/common/errors.d.ts
+/**
+ * @internal
+ */
+declare class MappedinError extends Error {
+  constructor(message: string, label?: string);
+}
+/**
+ * @internal
+ */
+declare class MappedinRenderError extends MappedinError {
+  constructor(message: string, label?: string);
+}
+//#endregion
 //#region ../packages/common/async.d.ts
 /**
  * A debounced function with a cancel method
@@ -504,6 +585,111 @@ interface DebouncedFunction<T$1 extends (...args: any[]) => void> {
   cancel: () => void;
 }
 //#endregion
+//#region ../packages/common/pubsub.d.ts
+/**
+ * Generic PubSub class implementing the Publish-Subscribe pattern for event handling.
+ *
+ * @template EVENT_PAYLOAD - The type of the event payload.
+ * @template EVENT - The type of the event.
+ */
+declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
+  /**
+   * @private
+   * @internal
+   */
+  private _subscribers;
+  /**
+   * @private
+   * @internal
+   * AbortController for managing lifecycle and cleanup
+   */
+  private _abortController;
+  /**
+   * Returns the AbortSignal for this PubSub instance.
+   * Use this signal with APIs that support cancellation (fetch, addEventListener, etc.)
+   * When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.
+   *
+   * @example
+   * ```typescript
+   * // Automatically cleaned up when PubSub is destroyed
+   * pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });
+   * ```
+   */
+  get signal(): AbortSignal;
+  /**
+   * @private
+   * @internal
+   */
+  publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
+  /**
+   * Subscribe a function to be called when the signal is aborted.
+   * @param fn The function to call when the signal is aborted.
+   */
+  onAbort<T$1 extends (...args: any[]) => void>(fn: T$1): void;
+  /**
+   * Subscribe a function to an event.
+   *
+   * @param eventName An event name which, when fired, will call the provided
+   * function.
+   * @param fn A callback that gets called when the corresponding event is fired. The
+   * callback will get passed an argument with a type that's one of event payloads.
+   * @param options Optional options object. If a signal is provided, the subscription will be
+   * automatically cleaned up when that signal is aborted.
+   * @returns A cleanup function that unsubscribes the event listener when called.
+   * @example
+   * // Subscribe to the 'click' event
+   * const handler = (event) => {
+   *  const { coordinate } = event;
+   *  const { latitude, longitude } = coordinate;
+   * 	console.log(`Map was clicked at ${latitude}, ${longitude}`);
+   * };
+   * map.on('click', handler);
+   */
+  on<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, fn: (payload: EVENT_PAYLOAD[EVENT_NAME] extends {
+    data: null;
+  } ? EVENT_PAYLOAD[EVENT_NAME]['data'] : EVENT_PAYLOAD[EVENT_NAME]) => void, options?: {
+    signal?: AbortSignal;
+  }): () => void;
+  /**
+   * Unsubscribe a function previously subscribed with {@link on}
+   *
+   * @param eventName An event name to which the provided function was previously
+   * subscribed.
+   * @param fn A function that was previously passed to {@link on}. The function must
+   * have the same reference as the function that was subscribed.
+   * @example
+   * // Unsubscribe from the 'click' event
+   * const handler = (event) => {
+   * 	console.log('Map was clicked', event);
+   * };
+   * map.off('click', handler);
+   */
+  off<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, fn: (payload: EVENT_PAYLOAD[EVENT_NAME] extends {
+    data: null;
+  } ? EVENT_PAYLOAD[EVENT_NAME]['data'] : EVENT_PAYLOAD[EVENT_NAME]) => void): void;
+  /**
+   * @private
+   * @internal
+   * Destroys the PubSub instance and automatically unsubscribes all listeners registered via on().
+   */
+  destroy(): void;
+}
+//#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/analytics/customer.d.ts
 /**
  * Valid track-analytics API contexts. These should match the expected values of that endpoint or the requests will fail.
@@ -3147,6 +3333,7 @@ declare const labelAppearanceSchemaBase: ZodObject<{
     easing: ZodDefault<ZodString>;
   }, $strip>]>>;
   iconPadding: ZodDefault<ZodNumber>;
+  iconBorderRadiusFactor: ZodDefault<ZodNumber>;
   iconFit: ZodDefault<ZodEnum<{
     fill: "fill";
     contain: "contain";
@@ -3191,8 +3378,9 @@ declare const labelAppearanceSchemaBase: ZodObject<{
  * | `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 |
+ * | `iconBorderRadiusFactor` | `number` | How round the icon pin's corners are, as a fraction of half the pin's size. `1` is a circle, `0` is a square. | 1 |
  * | `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` |
+ * | `iconOverflow` | `'visible'` \| `'hidden'` | Whether the icon should overflow the pin shape. | `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` |
  *
@@ -3254,6 +3442,7 @@ declare const labelAppearanceSchema: ZodPipe<ZodObject<{
     easing: ZodDefault<ZodString>;
   }, $strip>]>>;
   iconPadding: ZodDefault<ZodNumber>;
+  iconBorderRadiusFactor: ZodDefault<ZodNumber>;
   iconFit: ZodDefault<ZodEnum<{
     fill: "fill";
     contain: "contain";
@@ -3291,6 +3480,7 @@ declare const labelAppearanceSchema: ZodPipe<ZodObject<{
     easing: string;
   };
   iconPadding: number;
+  iconBorderRadiusFactor: number;
   iconFit: "fill" | "contain" | "cover";
   iconOverflow: "hidden" | "visible";
   iconVisible: number | boolean;
@@ -3656,96 +3846,6 @@ type Entity2DHTMLDivElement = HTMLDivElement & {
   };
 };
 //#endregion
-//#region ../packages/common/pubsub.d.ts
-/**
- * Generic PubSub class implementing the Publish-Subscribe pattern for event handling.
- *
- * @template EVENT_PAYLOAD - The type of the event payload.
- * @template EVENT - The type of the event.
- */
-declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
-  /**
-   * @private
-   * @internal
-   */
-  private _subscribers;
-  /**
-   * @private
-   * @internal
-   * AbortController for managing lifecycle and cleanup
-   */
-  private _abortController;
-  /**
-   * Returns the AbortSignal for this PubSub instance.
-   * Use this signal with APIs that support cancellation (fetch, addEventListener, etc.)
-   * When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.
-   *
-   * @example
-   * ```typescript
-   * // Automatically cleaned up when PubSub is destroyed
-   * pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });
-   * ```
-   */
-  get signal(): AbortSignal;
-  /**
-   * @private
-   * @internal
-   */
-  publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
-  /**
-   * Subscribe a function to be called when the signal is aborted.
-   * @param fn The function to call when the signal is aborted.
-   */
-  onAbort<T$1 extends (...args: any[]) => void>(fn: T$1): void;
-  /**
-   * Subscribe a function to an event.
-   *
-   * @param eventName An event name which, when fired, will call the provided
-   * function.
-   * @param fn A callback that gets called when the corresponding event is fired. The
-   * callback will get passed an argument with a type that's one of event payloads.
-   * @param options Optional options object. If a signal is provided, the subscription will be
-   * automatically cleaned up when that signal is aborted.
-   * @returns A cleanup function that unsubscribes the event listener when called.
-   * @example
-   * // Subscribe to the 'click' event
-   * const handler = (event) => {
-   *  const { coordinate } = event;
-   *  const { latitude, longitude } = coordinate;
-   * 	console.log(`Map was clicked at ${latitude}, ${longitude}`);
-   * };
-   * map.on('click', handler);
-   */
-  on<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, fn: (payload: EVENT_PAYLOAD[EVENT_NAME] extends {
-    data: null;
-  } ? EVENT_PAYLOAD[EVENT_NAME]['data'] : EVENT_PAYLOAD[EVENT_NAME]) => void, options?: {
-    signal?: AbortSignal;
-  }): () => void;
-  /**
-   * Unsubscribe a function previously subscribed with {@link on}
-   *
-   * @param eventName An event name to which the provided function was previously
-   * subscribed.
-   * @param fn A function that was previously passed to {@link on}. The function must
-   * have the same reference as the function that was subscribed.
-   * @example
-   * // Unsubscribe from the 'click' event
-   * const handler = (event) => {
-   * 	console.log('Map was clicked', event);
-   * };
-   * map.off('click', handler);
-   */
-  off<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, fn: (payload: EVENT_PAYLOAD[EVENT_NAME] extends {
-    data: null;
-  } ? EVENT_PAYLOAD[EVENT_NAME]['data'] : EVENT_PAYLOAD[EVENT_NAME]) => void): void;
-  /**
-   * @private
-   * @internal
-   * Destroys the PubSub instance and automatically unsubscribes all listeners registered via on().
-   */
-  destroy(): void;
-}
-//#endregion
 //#region ../2d-labels-markers/lib/esm/systems/collision/system.d.ts
 type TCollisionSystemEvent = {
   'visibility-changed': undefined;
@@ -4256,8 +4356,12 @@ declare class TokenManager {
   /**
    * Get an access token for the current set of API keys. If an access token was passed in, that
    * will be returned instead.
+   * @param forceRefresh - When `true`, bypass any cached token and fetch a fresh one. Useful for
+   * recovering from a rejected (e.g. expired) token even if the local expiry bookkeeping still
+   * considers it valid.
+   * @default forceRefresh false
    */
-  getAccessTokenAsync(): Promise<TokenWithExpiration>;
+  getAccessTokenAsync(forceRefresh?: boolean): Promise<TokenWithExpiration>;
   /**
    * Get SAS tokens for all maps. If any SAS token are expired, all SAS tokens will be refreshed.
    */
@@ -4504,21 +4608,6 @@ 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
 /**
  * Preset visual styles for the connector line drawn from the tracked
@@ -5235,7 +5324,14 @@ declare class FloorObject implements FloorProperties {
   buildGapFootprint(gapHeight: number, ceilingCuts: Feature$1<Polygon$1, any>[]): void;
   getFootprintStyle(): LineStringStyleWithTopColor;
   buildFootprint(): void;
-  setBatchedTextVisible(visible: boolean): void;
+  /**
+   * Toggle the consumer geometryText batch (`geometryText-${id}` — labelAll / Text3D.add).
+   * Delegates to Text3DSystem.setBatchVisible so a toggle issued before the lazily-built batch
+   * exists survives.
+   */
+  setGeometryTextBatchVisible(visible: boolean): void;
+  /** Toggle the baked floorText batch (`floortext-${id}`). Same durable-intent mechanism. */
+  setFloorTextBatchVisible(visible: boolean): void;
 }
 //#endregion
 //#region src/api-geojson/floor-stack-object.d.ts
@@ -5283,6 +5379,20 @@ declare class FloorStackObject implements Omit<FloorStack$1, 'maps' | 'floors' |
 }
 //#endregion
 //#region src/api-geojson/map-object.d.ts
+/**
+ * Handler that intercepts `setFloor` between `floor-change-start` and the internal
+ * commit (currentFloor assignment + `floor-change` emission). Replaces the default
+ * `processFloorChange` + `setVisible` path entirely while installed.
+ *
+ * A handler may run synchronously or return a promise. `setFloor` only
+ * defers the floor-change commit when the handler actually returns a thenable — a synchronous
+ * handler commits inline, with no microtask, so callers that do no async work don't pay an await.
+ */
+type SetFloorHandler = (floor: Floor, context: {
+  reason?: TFloorChangeReason;
+  previousFloor?: Floor;
+  signal: AbortSignal;
+}) => void | Promise<void>;
 declare class GeojsonApiMapObject extends PubSub<{
   'floor-change': {
     reason?: TFloorChangeReason;
@@ -5314,7 +5424,13 @@ declare class GeojsonApiMapObject extends PubSub<{
   get currentFloor(): FloorObject;
   /** @deprecated use `currentFloorStack.floorObjects` or `floorsById` instead */
   get floors(): FloorObject[];
-  processFloorChange(floorId: string): void;
+  /**
+   * @param fromStackId - the stack we're transitioning *from* (the previously-committed stack).
+   * Passed explicitly rather than read off `currentFloorStackId` because the latter now reflects
+   * intent — it already points at the target stack by the time this runs, so it can't tell us
+   * whether this is a cross-stack transition.
+   */
+  processFloorChange(floorId: string, fromStackId: string): void;
   /**
    * Merges the given effect fields into the stored multiFloorView options
    * and re-applies floor states so the change is visible immediately.
@@ -7495,15 +7611,31 @@ declare class MapView {
   /**
    * @internal
    * @hidden
-   * Whether the floor visibility is being self managed or automatically handled by the SDK.
+   * When `true`, floor changes skip the automatic hide-other-floors logic, leaving floor
+   * visibility under the caller's control. Derived from whether a setFloor handler is installed: a
+   * real {@link __EXPERIMENTAL__overrideSetFloorHandler} handler reports `true` here too.
    */
   get manualFloorVisibility(): boolean;
   /**
    * @internal
    * @hidden
-   * Disables the default behavior of the SDK to automatically hide floors on setFloor.
+   * When `true`, floor changes skip the automatic hide-other-floors logic, leaving floor
+   * visibility under the caller's control. Setting `true` installs a synchronous no-op handler when
+   * none exists (a real handler is left untouched); setting `false` clears the handler — "not
+   * manual" means no handler.
    */
   set manualFloorVisibility(value: boolean);
+  /**
+   * **Super experimental — this API may change or be removed in any release without notice.
+   * Do not depend on it in production.**
+   *
+   * Last-writer-wins: installing while one is already registered logs a warning and replaces it.
+   * Pass `undefined` to clear.
+   *
+   * @internal
+   * @hidden
+   */
+  __EXPERIMENTAL__overrideSetFloorHandler(handler: SetFloorHandler | undefined): void;
   /**
    * @internal
    * @hidden
@@ -8006,7 +8138,7 @@ type CurrentMapGetter$6 = () => GeojsonApiMapObject | undefined;
  * - Automatic rotation and positioning
  * - Batch operations for adding all labels at once
  *
- * > **Best Practice:** Use the `rank` option to control label visibility priority. Use `interactive: true` to enable click/hover events for important labels.
+ * > **Best Practice:** Use the `rank` option to control label visibility priority. Use `interactive: true` to enable click/hover events for important labels. Prefer `low` / `medium` / `high` when labels should yield to BlueDot's `enable2DCollisions` shield — `always-visible` labels never yield and can still cover the BlueDot.
  *
  * ### Example Usage
  * ```ts
@@ -9123,6 +9255,12 @@ declare const floorStateSchemaPartial: ZodObject<{
   }, $strip>>;
   text3d: ZodOptional<ZodObject<{
     visible: ZodOptional<ZodDefault<ZodBoolean>>;
+    geometryText: ZodOptional<ZodDefault<ZodObject<{
+      visible: ZodDefault<ZodBoolean>;
+    }, $strip>>>;
+    floorText: ZodOptional<ZodDefault<ZodObject<{
+      visible: ZodDefault<ZodBoolean>;
+    }, $strip>>>;
   }, $strip>>;
   models: ZodOptional<ZodObject<{
     type: ZodOptional<ZodDefault<ZodLiteral<"floor.models">>>;
@@ -9201,6 +9339,12 @@ declare const floorStateSchemaStrict: ZodObject<{
   }, $strict>;
   text3d: ZodObject<{
     visible: ZodDefault<ZodBoolean>;
+    geometryText: ZodDefault<ZodObject<{
+      visible: ZodDefault<ZodBoolean>;
+    }, $strip>>;
+    floorText: ZodDefault<ZodObject<{
+      visible: ZodDefault<ZodBoolean>;
+    }, $strip>>;
   }, $strict>;
   models: ZodObject<{
     type: ZodDefault<ZodLiteral<"floor.models">>;
@@ -9281,7 +9425,7 @@ type TGeometryUpdateState = output<typeof geometryStateSchemaPartial>;
 declare const labelStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"label">>;
   text: ZodString;
-  rank: ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">;
+  rank: ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>;
   appearance: ZodCustom<LabelAppearance, LabelAppearance>;
   interactive: ZodDefault<ZodBoolean>;
   enabled: ZodDefault<ZodBoolean>;
@@ -9304,7 +9448,7 @@ declare const labelStateSchema: ZodObject<{
 declare const labelStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"label">>>;
   text: ZodOptional<ZodString>;
-  rank: ZodOptional<ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">>;
+  rank: ZodOptional<ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>>;
   appearance: ZodOptional<ZodCustom<LabelAppearance, LabelAppearance>>;
   interactive: ZodOptional<ZodDefault<ZodBoolean>>;
   enabled: ZodOptional<ZodDefault<ZodBoolean>>;
@@ -9337,7 +9481,7 @@ type TLabelUpdateState = output<typeof labelStateSchemaPartial>;
 /** @internal */
 declare const markerStateSchema: ZodObject<{
   type: ZodDefault<ZodLiteral<"marker">>;
-  rank: ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">;
+  rank: ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>;
   placement: ZodOptional<ZodUnion<readonly [ZodEnum<{
     hidden: "hidden";
     top: "top";
@@ -9379,7 +9523,9 @@ declare const markerStateSchema: ZodObject<{
 declare const markerStateSchemaPartial: ZodObject<{
   type: ZodOptional<ZodDefault<ZodLiteral<"marker">>>;
   enabled: ZodOptional<ZodDefault<ZodBoolean>>;
-  rank: ZodOptional<ZodCustom<TCollisionRankingTier | "initial", TCollisionRankingTier | "initial">>;
+  interactive: ZodOptional<ZodDefault<ZodUnion<readonly [ZodBoolean, ZodLiteral<"pointer-events-auto">]>>>;
+  rank: ZodOptional<ZodCustom<"initial" | TCollisionRankingTier, "initial" | TCollisionRankingTier>>;
+  occlude: ZodOptional<ZodDefault<ZodBoolean>>;
   placement: ZodOptional<ZodOptional<ZodUnion<readonly [ZodEnum<{
     hidden: "hidden";
     top: "top";
@@ -9403,7 +9549,6 @@ 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<{
@@ -9412,7 +9557,6 @@ declare const markerStateSchemaPartial: ZodObject<{
     color: ZodOptional<ZodString>;
   }, $strip>>>;
   contentHTML: ZodOptional<ZodString>;
-  occlude: ZodOptional<ZodDefault<ZodBoolean>>;
   animated: ZodOptional<ZodDefault<ZodBoolean>>;
 }, $strip>;
 /**
@@ -9847,6 +9991,14 @@ declare class GeoJsonApi extends PubSub<TNavigationEvents> {
    * MapView.on() and MapView.off().
    */
   externalPubSub: PubSub<TEvents>;
+  get __EXPERIMENTAL__floorHandler(): SetFloorHandler | undefined;
+  __EXPERIMENTAL__overrideSetFloorHandler(handler: SetFloorHandler | undefined): void;
+  /**
+   * Whether floor changes skip the automatic hide-other-floors logic, leaving floor visibility
+   * under the caller's control. Derived state: a handler is installed ⇒ manual; no handler ⇒ not
+   * manual. A real override handler (e.g. dynamic-focus) implies manual visibility; the setter
+   * below installs a synchronous no-op for the flag-only case.
+   */
   get manualFloorVisibility(): boolean;
   set manualFloorVisibility(value: boolean);
   get hidePathsNotOnCurrentFloor(): boolean;
@@ -10665,20 +10817,6 @@ declare class Text3DView {
   static is(instance: object): instance is Text3DView;
 }
 //#endregion
-//#region ../packages/common/errors.d.ts
-/**
- * @internal
- */
-declare class MappedinError extends Error {
-  constructor(message: string, label?: string);
-}
-/**
- * @internal
- */
-declare class MappedinRenderError extends MappedinError {
-  constructor(message: string, label?: string);
-}
-//#endregion
 //#region src/events.d.ts
 /**
  * Free-form context string passed to `MapView.setFloor` (via {@link TSetFloorOptions})
@@ -10859,7 +10997,9 @@ type TEvents = {
    */
   'outdoor-view-loaded': undefined;
   /**
-   * Emitted when the outdoor style is loaded or changed.
+   * Emitted when the outdoor stylesheet finishes loading — on initial outdoor
+   * load and again after `Outdoor.setStyle`. Does not fire for runtime style
+   * mutations such as layer filters used by outdoor building covering.
    */
   'outdoor-style-loaded': undefined;
   /**
@@ -11504,7 +11644,7 @@ type TConnectionPathOptions = TAddPathOptions & {
  * | low    | Colliders with this ranking have a low visibility priority and will be hidden in favor of higher-ranked colliders in crowded areas.     |
  * | medium | Colliders with this ranking have a standard visibility priority and may be hidden in favor of higher-ranked colliders in crowded areas. |
  * | high   | These colliders are given higher visibility priority than 'medium' priority.                                                            |
- * | always-visible | Colliders with this ranking will not be hidden, ensuring their constant visibility regardless of crowding. |
+ * | always-visible | Colliders with this ranking will not be hidden, ensuring their constant visibility regardless of crowding. Labels with this rank also will not yield to BlueDot's `enable2DCollisions` shield and can still paint over the BlueDot. |
  *
  * Use this type to fine-tune the visibility of colliders, enhancing map readability and user experience by prioritizing important information.
  */
@@ -13009,8 +13149,8 @@ declare class Area extends DetailedMapData<AreaCollection['features'][number]> i
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
-    geometry: _mappedin_mvf_v26.Polygon;
+    type: _mappedin_mvf_v22.FeatureType;
+    geometry: _mappedin_mvf_v22.Polygon;
   };
   /** @internal */
   get focusTarget(): this;
@@ -13112,8 +13252,8 @@ declare class Door extends DetailedMapData<EntranceFeature> implements IGeoJSOND
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
-    geometry: _mappedin_mvf_v26.LineString;
+    type: _mappedin_mvf_v22.FeatureType;
+    geometry: _mappedin_mvf_v22.LineString;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -13249,8 +13389,8 @@ declare class Space extends DetailedMapData<SpaceFeature> implements IGeoJSONDat
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
-    geometry: _mappedin_mvf_v26.Point | _mappedin_mvf_v26.LineString | _mappedin_mvf_v26.Polygon;
+    type: _mappedin_mvf_v22.FeatureType;
+    geometry: _mappedin_mvf_v22.Point | _mappedin_mvf_v22.LineString | _mappedin_mvf_v22.Polygon;
   };
   /** @internal */
   get focusTarget(): this | Coordinate;
@@ -13336,7 +13476,7 @@ declare class PointOfInterest extends DetailedMapData<FeatureCollection$1<Point$
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
+    type: _mappedin_mvf_v22.FeatureType;
     geometry: Point$1;
   };
   /**
@@ -13450,8 +13590,8 @@ declare class Annotation extends DetailedMapData<AnnotationCollection['features'
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
-    geometry: _mappedin_mvf_v26.Point;
+    type: _mappedin_mvf_v22.FeatureType;
+    geometry: _mappedin_mvf_v22.Point;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -13667,8 +13807,8 @@ declare class MapObject extends DetailedMapData<ObstructionFeature> implements I
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
-    geometry: _mappedin_mvf_v26.LineString | _mappedin_mvf_v26.Polygon;
+    type: _mappedin_mvf_v22.FeatureType;
+    geometry: _mappedin_mvf_v22.LineString | _mappedin_mvf_v22.Polygon;
   };
   /** @internal */
   get anchorTarget(): Coordinate;
@@ -13981,8 +14121,8 @@ declare class Node extends BaseMetaData implements IGeoJSONData, IFocusable, IAn
    */
   get geoJSON(): {
     properties: null;
-    type: _mappedin_mvf_v26.FeatureType;
-    geometry: _mappedin_mvf_v26.Point;
+    type: _mappedin_mvf_v22.FeatureType;
+    geometry: _mappedin_mvf_v22.Point;
   };
   /** @internal */
   get focusTarget(): Coordinate;
@@ -14705,9 +14845,9 @@ declare class EnterpriseVenue extends BaseMetaData implements EnterpriseVenue$1
 //#endregion
 //#region src/query/types.d.ts
 /**
- * Types that can be queried for in the nearest search
+ * The map data object types that can be passed in the `include` array of a {@link Query.nearest} search.
  */
-type TQueriables = PointOfInterest | Door | Annotation | Node | Space | EnterpriseLocation;
+type TQueriables = PointOfInterest | Door | Annotation | Node | Space | EnterpriseLocation | MapObject | LocationProfile | Connection | Area | Facade;
 /**
  * Types that can be returned from Query.at() - geometry objects at a coordinate
  */
@@ -16038,7 +16178,7 @@ declare class MapData {
    * console.log(`Current language: ${language.name} (${language.code})`);
    * ```
    */
-  get currentLanguage(): _mappedin_mvf_v26.Language | undefined;
+  get currentLanguage(): _mappedin_mvf_v22.Language | undefined;
   /**
    * Gets the natural bearing of the map.
    *
@@ -17290,7 +17430,7 @@ type UpdateModelState = Omit<InitializeModelState$2, 'url'> & {
 };
 declare class ModelComponent {
   #private;
-  mesh?: Geometry3DObject3D | Group$1;
+  mesh?: Geometry3DObject3D | Group;
   readonly type = "model";
   positionDirty: boolean;
   outline?: LineSegments;
@@ -18044,7 +18184,7 @@ type ClippingPlane = {
    * 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;
+  holeFillGroup?: Group;
   topColor?: string;
   needsRebuild: boolean;
   topVisible?: boolean;
@@ -18065,7 +18205,7 @@ declare class ClippingPlaneComponent implements ClippingPlane {
   verticalOffset: number;
   plane?: Plane;
   holeFillMesh?: Mesh;
-  holeFillGroup?: Group$1;
+  holeFillGroup?: Group;
   topColor?: string;
   topVisible: boolean;
   bboxCenter?: {
@@ -19693,6 +19833,10 @@ declare class CustomGeometrySystem {
  */
 declare class IdleQueue {
   #private;
+  /**
+   * @param maxDelay - Forced idle-callback timeout in ms (default {@link FORCE_IDLE_CALLBACK_TIMEOUT}).
+   */
+  constructor(maxDelay?: number);
   /**
    * Returns the current number of pending jobs in the queue
    */
@@ -19736,8 +19880,11 @@ declare class OutlineInterpolationSystem extends PubSub<{
    */
   outlineOpacitiesDirty: boolean;
   /**
-   * Use IdleQueue to ensure the thread isn't blocked by building outlines
-   * @internal for unit tests only
+   * Use IdleQueue to ensure the thread isn't blocked by building outlines.
+   * When false, the build + bounding-sphere recompute run inline. Internal unit-test affordance,
+   * decoupled from the public `__TEST_synchronousIdleWork` option (which now only caps the idle
+   * timeout via `idleMaxDelay`); not driven by show3dMap.
+   * @internal for tests only
    */
   useIdleFramesOnly: boolean;
   get geometries3DDirty(): boolean;
@@ -19755,8 +19902,10 @@ declare class OutlineInterpolationSystem extends PubSub<{
    * Creates a new OutlineInterpolationSystem
    * @param rendererState - The renderer state
    * @param options - Optional configuration for outline rendering
+   * @param useIdleFramesOnly - When false, build outlines/bounding spheres inline instead of on idle frames (test-only)
+   * @param idleMaxDelay - Forced idle-callback timeout (ms) applied to the build/bounding-sphere queues
    */
-  constructor(rendererState: RendererState, options?: OutlinesOptions$1);
+  constructor(rendererState: RendererState, options?: OutlinesOptions$1, useIdleFramesOnly?: boolean, idleMaxDelay?: number);
   buildOutlines(geometryGroupEntity: FeatureCollectionObject3D): void;
   /**
    * Update the outline color of all entities with an outline component.
@@ -19883,11 +20032,48 @@ declare class GeometryInFocusSystem extends PubSub<{
 }
 //#endregion
 //#region ../renderer-three/src/systems/outdoor-layers/system.d.ts
+/**
+ * Hides OSM basemap features (buildings) sitting under indoor footprints by writing a single cumulative
+ * exclusion filter (`['!', ['in', ['id'], ['literal', ids]]]`) onto the target MapLibre layers.
+ *
+ * The design is dictated by how vector tiles and features relate:
+ * - Tiles are a fixed `z/x/y` world grid; a tile's bounds are pure arithmetic (`tileToLngLatBBox`).
+ *   Footprints are world-fixed too, so the tiles that can contain a covered building are static —
+ *   only a tile overlapping a footprint can add a match (`#isTileRelevant` gate on `sourcedata`).
+ * - Features live *inside* tiles, so new geometry only arrives via a tile load — hence recompute is
+ *   driven by `sourcedata` (with `e.tile`), not the camera. Do not gate on MapLibre `load`: that event
+ *   fires once on first settle and never again; `sourcedata` already covers pre- and post-load tiles,
+ *   and `queryRenderedFeatures` returns `[]` (safe no-op) before the style exists.
+ * - A feature larger than a tile is clipped into per-tile fragments that all share one `id`, and
+ *   `queryRenderedFeatures` returns them per-tile (duplicate ids). So a non-match by id can flip to a
+ *   match once a *different, later-rendered* fragment arrives — non-matches must stay retryable, and
+ *   they cannot be cached by id alone.
+ * - The layer filter is applied at bucket-populate, so a hidden feature drops out of
+ *   `queryRenderedFeatures`. `#matchedFeatureIds` is therefore the *only* record of what's hidden: it
+ *   accumulates, every `setFilter` writes the full cumulative set, and it resets only on genuine
+ *   invalidation (new polygons / style change) — otherwise prior matches un-hide and the
+ *   `setFilter → source reload → sourcedata` loop never converges.
+ * - `queryRenderedFeatures` reflects *rendered* tiles, but `sourcedata` fires on *load*; the gap is
+ *   render lag, covered by {@link OUTDOOR_COVERING_DEBOUNCE_MS} that coalesces the tile stream.
+ *   The window stays short because matches accumulate and `setFilter` is skipped when nothing new
+ *   matched — a short debounce only batches tile arrivals, it cannot un-hide or thrash.
+ * - The per-footprint sweep is chunked one-polygon-per-`idleQueue`-job so a many-footprint venue never
+ *   blocks the frame in a single synchronous pass. A live compute session is aborted (partial matches
+ *   rolled back, queue cleared) when a new compute takes over, so a novel tile is never lost to a
+ *   dropped in-flight request; the cumulative `setFilter` still runs once, in the queue's
+ *   `onComplete`, and only on successful completion (never after abort).
+ */
 declare class OutdoorLayers extends PubSub<{}> {
   #private;
   idleQueue: IdleQueue;
   hideLayersIntersectingPolygons(polygons: GeoJSON.Feature<GeoJSON.Polygon | GeoJSON.MultiPolygon, any>[], layers: string[]): void;
-  constructor(map?: Map$1);
+  /**
+   * @param map - The MapLibre map to cover OSM buildings on.
+   * @param idleMaxDelay - Forced idle-callback timeout (ms) for the covering-sweep queue. The e2e
+   *   harness caps it so the sweep settles inside a screenshot's settle wait instead of drifting out
+   *   to {@link FORCE_IDLE_CALLBACK_TIMEOUT} on a load-starved runner.
+   */
+  constructor(map?: Map$1, idleMaxDelay?: number);
   destroy(): void;
 }
 //#endregion
@@ -19949,9 +20135,28 @@ declare class Text3DSystem extends PubSub<{
   textSet: Set<string>;
   batchedTextMap: Map<GroupContainerObject3D, Promise<BatchedText>>;
   private resolvedBatchedTextMap;
+  /**
+   * Desired `BatchedText.visible` per parent group. Batches are created lazily over render
+   * frames, so a toggle issued before the batch exists must be remembered here (not on the
+   * generic GroupContainer) and applied at creation. Default when unset: `true`.
+   */
+  private batchVisibleByGroup;
   useWorker: boolean;
   remove(id: string): void;
   getBatchedText(group: GroupContainerObject3D): BatchedText | undefined;
+  /**
+   * Desired visibility for the `BatchedText` parented to `group`. Survives until the batch is
+   * created; also applies immediately if a batch (or its promise) already exists.
+   * @param group - Parent group container that owns the batch
+   * @param visible - Whether the batch should be visible
+   */
+  setBatchVisible(group: GroupContainerObject3D, visible: boolean): void;
+  /**
+   * Returns the durable desired visibility for `group`'s batch (`true` when never set).
+   * @param group - Parent group container that owns the batch
+   * @returns Desired batch visibility
+   */
+  getBatchVisible(group: GroupContainerObject3D): boolean;
   constructor(rendererState: RendererState, convertTo3DMapPosition: Core['convertTo3DMapPosition'], useWorker?: boolean);
   update(cameraRotationRadians: number): Promise<void[] | undefined>;
   /**
@@ -20124,16 +20329,6 @@ declare class Debug$1 {
 }
 //#endregion
 //#region ../renderer-three/src/systems/2d-occlusion/system.d.ts
-/**
- * Set to `true` by the visual regression harness (see `e2e/visual/fixtures.ts`)
- * before page load. When set we bypass the throttle so screenshots are
- * deterministic. Anything else leaves the throttle in effect.
- */
-declare global {
-  interface Window {
-    __MAPPEDIN_E2E__?: boolean;
-  }
-}
 declare class Occlusion2DSystem {
   private state;
   private renderer;
@@ -21288,8 +21483,8 @@ declare class Core extends PubSub<MapEvent> {
    */
   getInternalState(): RendererState;
   /** @internal */
-  getInternalTweenGroup(): Group;
-  getExternalTweenGroup(): Group;
+  getInternalTweenGroup(): Group$1;
+  getExternalTweenGroup(): Group$1;
   computeMinZOffsetBetweenContainers(lowerContainer: GroupContainerObject3D, upperContainer: GroupContainerObject3D, debug?: boolean): number;
   /**
    * Subscribe a function to an event.
@@ -21507,6 +21702,14 @@ type RendererCoreOptions$2 = Partial<{
     style?: string;
     enabled: boolean;
     lowDpi?: boolean;
+    /**
+     * Called when an outdoor tile request is rejected with an auth error (HTTP 401/403),
+     * typically because the tiles token has expired. Should resolve to a fresh tiles token
+     * (or `undefined` if one cannot be obtained). The renderer swaps the new token into the
+     * tile request headers and reloads the outdoor source so the basemap recovers without a
+     * page reload.
+     */
+    refreshToken?: () => Promise<string | undefined>;
   };
   gl?: WebGLRenderingContext;
   map?: Map$1;
@@ -21558,7 +21761,23 @@ type RendererCoreOptions$2 = Partial<{
    * - An object with `maxOpacity` and/or `darkenFactor` allows fine-grained control
    */
   outlines?: boolean | OutlinesOptions$1;
+  /**
+   * Caps the forced `requestIdleCallback` timeout for renderer-three's idle-deferred work (outline
+   * build + bounding-sphere recompute, OutdoorLayers covering sweep). Idle scheduling stays on, but a
+   * lower `maxDelay` forces the work to settle quickly so e2e screenshots don't race a half-built scene.
+   * @internal test-only; when unset the queues use the default 3000 ms timeout.
+   */
+  __TEST_synchronousIdleWork?: IdleWorkTestOptions;
 }>;
+/**
+ * Bounded-idle test knob. `enabled` opts in; `maxDelay` (ms) caps the idle-callback forced timeout.
+ * @internal test-only
+ */
+type IdleWorkTestOptions = {
+  enabled: boolean;
+  /** @default 3000 */
+  maxDelay?: number;
+};
 /**
  * Outline rendering configuration options
  */
@@ -21942,7 +22161,9 @@ type MapEvent = {
    */
   'outdoor-view-loaded': undefined;
   /**
-   * If outdoor view is enabled, this is fired when the style first loads or changes.
+   * If outdoor view is enabled, fired when the outdoor stylesheet finishes
+   * loading (initial load and after `setStyle`). Not fired for runtime style
+   * mutations such as `setFilter` from outdoor building covering.
    */
   'outdoor-style-loaded': undefined;
   /**
@@ -22036,9 +22257,9 @@ type RendererState = {
   canvasWidth: number;
   canvasHeight: number;
   /** Group for all tweens that are created internally by the SDK */
-  internalTweenGroup: Group;
+  internalTweenGroup: Group$1;
   /** Group for all tweens that are created externally, such as from animateState */
-  externalTweenGroup: Group;
+  externalTweenGroup: Group$1;
   cameraObject: Camera$1;
   naturalBearing: number;
   containerOffset: [number, number];
@@ -22230,24 +22451,6 @@ declare const MAPPEDIN_COLORS: {
   lightTeal: string;
 };
 //#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
 /**
  * Converts TShow3DMapOptions to RendererCoreOptions format.
@@ -22641,6 +22844,18 @@ type TShow3DMapOptions = {
    * @default false
    */
   disableUpdateStateValidation?: boolean;
+  /**
+   * @internal
+   *
+   * Caps the forced `requestIdleCallback` timeout for renderer-three's idle-scheduled render work
+   * (outline building, OutdoorLayers covering sweep). Idle scheduling stays on; a lower `maxDelay`
+   * forces the work to settle quickly so e2e visual screenshots don't race a half-built scene.
+   * Test-only: defaults on under the e2e harness (`window.__MAPPEDIN_E2E__`) with `maxDelay` 100.
+   */
+  __TEST_synchronousIdleWork?: {
+    enabled: boolean;
+    maxDelay?: number;
+  };
 };
 /**
  * @internal
@@ -22765,4 +22980,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 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 };
+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 SetFloorHandler, 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 TLogLevelName, 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, parseLogLevel, parseMVFv2 as parseMVF, preloadFont, setLoggerLevel, setUseEnterpriseAPI, setWorkersUrl, shouldForceEnterpriseLocations, show3dMap, show3dMapGeojson, unzipAndParseMVFv2, unzipMVFv2 as unzipMVF };