@mappedin/mappedin-js 6.8.0 → 6.9.0

package/lib/esm/index.d.ts

@@ -1,10 +1,137 @@
 import { Color as Color$1, CompositeExpression, DiffCommand, DiffOperations, Feature as Feature$2, FeatureFilter, FeatureState, FilterSpecification, Formatted, FormattedSection, GlobalProperties, ICanonicalTileID, IMercatorCoordinate, InterpolationType, LayerSpecification, LightSpecification, Padding, ProjectionSpecification, PromoteIdSpecification, PropertyValueSpecification, ResolvedImage, SkySpecification, SourceExpression, SourceSpecification, SpriteSpecification, StylePropertyExpression, StylePropertySpecification, StyleSpecification, TerrainSpecification, TransitionSpecification, VariableAnchorOffsetCollection } from '@maplibre/maplibre-gl-style-spec';
-import { AnnotationCollection, AnnotationSymbol, AreaCollection, AreaId, BaseTextAreaProperties, Category as MVFCategory, CategoryId, Connection as MVFConnection, Details, EnterpriseCategory as MVFEnterpriseCategory, EnterpriseCategory as MvfEnterpriseCategory, EnterpriseCategoryId as MVFEnterpriseCategoryId, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseLocation as MvfEnterpriseLocation, EnterpriseLocationId as MVFEnterpriseLocationId, EnterpriseLocationInstance, EnterpriseTexture, EnterpriseVenue as MVFEnterpriseVenue, EnterpriseVenueType, EntranceCollection, EntranceFeature, Facade as MVFFacade, Feature, Feature as MVFFeature, FeatureCollection, FloatingFloorTextProperties, FloorCollection, FloorId, FloorProperties as MVFFloor, FloorProperties as MvfFloor, FloorStack as MVFFloorStack, FloorStack as MvfFloorStack, FloorTextCommonProperties, Geometry, Hyperlink as MVFHyperlink, Image as MVFImage, Language, LineStringStyle, LineStringStyle as TMVFLineStringStyle, Location as MVF2Location, LocationId, LocationLink, LocationSocial, LocationState, MultiPolygon, NavigationFlagDeclarations, NodeCollection, NodeCollection as MVFNodeCollection, NodeId, ObstructionCollection, ObstructionFeature, ObstructionId, ObstructionProperties, OpeningHoursSpecification, OperationHours, ParsedMVF, ParsedMVF as TMVF, ParsedMVFLocalePack, ParsedMVFv3, Point, PointStyle, PointStyle as TMVFPointStyle, Polygon, PolygonStyle, PolygonStyle as TMVFPolygonStyle, SiblingGroup, SpaceCollection, SpaceFeature, SpaceId, SpaceProperties, Style as TMVFStyle, StyleCollection, StyleCollection as TMVFStyleCollection, TilesetStyle } from '@mappedin/mvf-v2';
-import { ParsedMVF, ParsedMVFv3, RawMVF } from '@mappedin/mvf-v2/no-validator';
+import { AnnotationCollection, AnnotationSymbol, AreaCollection, AreaId, BaseTextAreaProperties, Category as MVFCategory, CategoryId, Connection as MVFConnection, Details, EnterpriseCategory as MVFEnterpriseCategory, EnterpriseCategory as MvfEnterpriseCategory, EnterpriseCategoryId as MVFEnterpriseCategoryId, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseLocation as MvfEnterpriseLocation, EnterpriseLocationId as MVFEnterpriseLocationId, EnterpriseLocationInstance, EnterpriseTexture, EnterpriseVenue as MVFEnterpriseVenue, EnterpriseVenueType, EntranceCollection, EntranceFeature, Facade as MVFFacade, Feature, Feature as MVFFeature, FeatureCollection, FloatingFloorTextProperties, FloorCollection, FloorId, FloorProperties as MVFFloor, FloorProperties as MvfFloor, FloorStack as MVFFloorStack, FloorStack as MvfFloorStack, FloorTextCommonProperties, Geometry, Hyperlink as MVFHyperlink, Image as MVFImage, Language, LineStringStyle, LineStringStyle as TMVFLineStringStyle, Location as MVF2Location, LocationId, LocationLink, LocationSocial, LocationState, MVFv2_STANDARD_MVFv3, MultiPolygon, NavigationFlagDeclarations, NodeCollection, NodeCollection as MVFNodeCollection, NodeId, ObstructionCollection, ObstructionFeature, ObstructionId, ObstructionProperties, OpeningHoursSpecification, OperationHours, ParsedMVF, ParsedMVF as TMVF, ParsedMVFLocalePack, Point, PointStyle, PointStyle as TMVFPointStyle, Polygon, PolygonStyle, PolygonStyle as TMVFPolygonStyle, SiblingGroup, SpaceCollection, SpaceFeature, SpaceId, SpaceProperties, Style as TMVFStyle, StyleCollection, StyleCollection as TMVFStyleCollection, TilesetStyle } from '@mappedin/mvf-v2';
+import { MVFv2_STANDARD_MVFv3, ParsedMVF, RawMVF } from '@mappedin/mvf-v2/no-validator';
 import { Group as TweenGroup, Tween } from '@tweenjs/tween.js';
-import { AmbientLight, BatchedMesh, BatchedMeshGeometryRange, Box3, BufferAttribute, BufferGeometry, Camera, Camera as ThreeCamera, Color, DirectionalLight, Group, Intersection, LineSegments, Mesh, MeshLambertMaterial, MeshLambertMaterialParameters, Object3D, Object3DEventMap, PerspectiveCamera, Plane, PlaneGeometry, Raycaster, Scene, ShaderMaterial, Texture, TubeGeometry, Vector2, Vector3, WebGLRenderer } from 'three';
+import { AmbientLight, BatchedMesh, BatchedMeshGeometryRange, Box3, BufferAttribute, BufferGeometry, Camera, Camera as ThreeCamera, 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 { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 
+export declare enum E_SDK_LOG_LEVEL {
+	LOG = 0,
+	WARN = 1,
+	ERROR = 2,
+	SILENT = 3
+}
+export declare function setLoggerLevel(level: E_SDK_LOG_LEVEL): void;
+/**
+ * @internal
+ */
+export declare class MappedinError extends Error {
+	constructor(message: string, label?: string);
+}
+/**
+ * @internal
+ */
+export declare class MappedinRenderError extends MappedinError {
+	constructor(message: string, label?: string);
+}
+interface DebouncedFunction<T extends (...args: any[]) => void> {
+	(...args: Parameters<T>): void;
+	/**
+	 * Cancels any pending debounced execution
+	 */
+	cancel: () => void;
+}
+/**
+ * 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.
+ */
+export 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;
+	/**
+	 * @protected
+	 * @internal
+	 * Tracks all cleanup functions for subscriptions made via on()
+	 */
+	protected _cleanupFunctions: Array<() => void>;
+	/**
+	 * Returns the AbortSignal for this PubSub instance.
+	 * Use this signal with APIs that support cancellation (fetch, addEventListener, etc.)
+	 * When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Automatically cleaned up when PubSub is destroyed
+	 * pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });
+	 * ```
+	 */
+	get signal(): AbortSignal;
+	/**
+	 * @private
+	 * @internal
+	 */
+	publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
+	/**
+	 * Subscribe a function to be called when the signal is aborted.
+	 * @param fn The function to call when the signal is aborted.
+	 */
+	onAbort<T extends (...args: any[]) => void>(fn: T): void;
+	/**
+	 * Subscribe a function to an event.
+	 *
+	 * @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;
+}
+declare const EASING_CURVES: readonly [
+	"ease-in",
+	"ease-out",
+	"ease-in-out",
+	"linear"
+];
+type EasingCurve = (typeof EASING_CURVES)[number];
 declare const VALID_CONTEXTS: readonly [
 	"websdk",
 	"web",
@@ -75,7 +202,7 @@ declare class AnalyticsInternal {
 	/**
 	 * @internal
 	 */
-	sendGetDirectionsEvent: (start: string, end: string, accessible?: boolean | undefined) => void;
+	sendGetDirectionsEvent: DebouncedFunction<(start: string, end: string, accessible?: boolean) => void | Promise<Response> | Promise<void>>;
 	sendBlueDotEvents(event: BlueDotEvents): void | Promise<Response> | Promise<void>;
 }
 type UpdateStateParam = Partial<Pick<AnalyticState, "geolocationMode" | "context" | "logEvents" | "userPosition" | "mapId" | "sendEvents" | "logEvents" | "accessToken" | "sessionId" | "deviceId">>;
@@ -578,7 +705,7 @@ declare function createEnvControl(): {
 type EnvControl = ReturnType<typeof createEnvControl>;
 type ParsedMVFResult = {
 	mvf2: ParsedMVF;
-	mvf3?: ParsedMVFv3;
+	mvf3?: MVFv2_STANDARD_MVFv3;
 };
 export declare function unzipAndParseMVFv2(data: Uint8Array, inputVersion?: string): Promise<ParsedMVFResult>;
 type TDrawFn = (ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, x: number, y: number) => void;
@@ -1013,6 +1140,7 @@ declare class BatchedStandardMaterial extends MeshLambertMaterial {
 	removeSideTexture(batchId: number): void;
 	removeTopTexture(batchId: number): void;
 	dispose(): void;
+	setShadowUniforms(shadowMap: Texture, lightMatrix: Matrix4, cameraNear: number, cameraFar: number, shadowBias: number, shadowOpacity: number, baseColor: Color, shadowMapSize: number, pcfSpread: number, pcfSamples: number, sunDir: Vector3, normalBias: number, depthRangeMax: number, shadowEnabled: boolean): void;
 	clone(params?: MeshLambertMaterialParameters): this;
 }
 interface StandardSchemaV1<Input = unknown, Output = Input> {
@@ -5520,7 +5648,7 @@ interface PathUniforms {
 		value: number;
 	};
 }
-declare class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
+declare class PubSub$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
 	/**
 	 * @private
 	 * @internal
@@ -5830,126 +5958,6 @@ declare class QuadTree<T = unknown> {
 	 */
 	draw(context: CanvasRenderingContext2D): void;
 }
-export declare enum E_SDK_LOG_LEVEL {
-	LOG = 0,
-	WARN = 1,
-	ERROR = 2,
-	SILENT = 3
-}
-export declare function setLoggerLevel(level: E_SDK_LOG_LEVEL): void;
-/**
- * @internal
- */
-export declare class MappedinError extends Error {
-	constructor(message: string, label?: string);
-}
-/**
- * @internal
- */
-export declare class MappedinRenderError extends MappedinError {
-	constructor(message: string, label?: string);
-}
-/**
- * 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$1<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {
-	/**
-	 * @private
-	 * @internal
-	 */
-	private _subscribers;
-	/**
-	 * @private
-	 * @internal
-	 * AbortController for managing lifecycle and cleanup
-	 */
-	private _abortController;
-	/**
-	 * @protected
-	 * @internal
-	 * Tracks all cleanup functions for subscriptions made via on()
-	 */
-	protected _cleanupFunctions: Array<() => void>;
-	/**
-	 * Returns the AbortSignal for this PubSub instance.
-	 * Use this signal with APIs that support cancellation (fetch, addEventListener, etc.)
-	 * When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.
-	 *
-	 * @example
-	 * ```typescript
-	 * // Automatically cleaned up when PubSub is destroyed
-	 * pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });
-	 * ```
-	 */
-	get signal(): AbortSignal;
-	/**
-	 * @private
-	 * @internal
-	 */
-	publish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]): void;
-	/**
-	 * Subscribe a function to be called when the signal is aborted.
-	 * @param fn The function to call when the signal is aborted.
-	 */
-	onAbort<T extends (...args: any[]) => void>(fn: T): void;
-	/**
-	 * Subscribe a function to an event.
-	 *
-	 * @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;
-}
-declare const EASING_CURVES: readonly [
-	"ease-in",
-	"ease-out",
-	"ease-in-out",
-	"linear"
-];
-type EasingCurve = (typeof EASING_CURVES)[number];
 type ExpiryData = {
 	cacheControl?: string | null;
 	expires?: Date | string | null;
@@ -6887,6 +6895,35 @@ type StyleImageMetadata = {
 	textFitHeight?: TextFit;
 };
 type StyleImage = StyleImageData & StyleImageMetadata;
+interface StyleImageInterface {
+	width: number;
+	height: number;
+	data: Uint8Array | Uint8ClampedArray;
+	/**
+	 * This method is called once before every frame where the icon will be used.
+	 * The method can optionally update the image's `data` member with a new image.
+	 *
+	 * If the method updates the image it must return `true` to commit the change.
+	 * If the method returns `false` or nothing the image is assumed to not have changed.
+	 *
+	 * If updates are infrequent it maybe easier to use {@link Map#updateImage} to update
+	 * the image instead of implementing this method.
+	 *
+	 * @returns `true` if this method updated the image. `false` if the image was not changed.
+	 */
+	render?: () => boolean;
+	/**
+	 * Optional method called when the layer has been added to the Map with {@link Map#addImage}.
+	 *
+	 * @param map - The Map this custom layer was just added to.
+	 */
+	onAdd?: (map: Map$1, id: string) => void;
+	/**
+	 * Optional method called when the icon is removed from the map with {@link Map#removeImage}.
+	 * This gives the image a chance to clean up resources and event listeners.
+	 */
+	onRemove?: () => void;
+}
 declare class IndexBuffer {
 	context: Context;
 	buffer: WebGLBuffer;
@@ -11700,6 +11737,9 @@ interface Subscription {
 	 */
 	unsubscribe(): void;
 }
+type Complete<T> = {
+	[P in keyof Required<T>]: Pick<T, P> extends Required<Pick<T, P>> ? T[P] : (T[P] | undefined);
+};
 type RequireAtLeastOne<T> = {
 	[K in keyof T]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<keyof T, K>>>;
 }[keyof T];
@@ -12625,6 +12665,84 @@ declare abstract class Camera$1 extends Evented {
 	 */
 	queryTerrainElevation(lngLatLike: LngLatLike): number | null;
 }
+type EventInProgress = {
+	handlerName: string;
+	originalEvent: Event$1;
+};
+type EventsInProgress = {
+	zoom?: EventInProgress;
+	roll?: EventInProgress;
+	pitch?: EventInProgress;
+	rotate?: EventInProgress;
+	drag?: EventInProgress;
+};
+declare class HandlerManager {
+	_map: Map$1;
+	_el: HTMLElement;
+	_handlers: Array<{
+		handlerName: string;
+		handler: Handler;
+		allowed: Array<string>;
+	}>;
+	_eventsInProgress: EventsInProgress;
+	_frameId: number;
+	_inertia: HandlerInertia;
+	_bearingSnap: number;
+	_handlersById: {
+		[x: string]: Handler;
+	};
+	_updatingCamera: boolean;
+	_changes: Array<[
+		HandlerResult,
+		EventsInProgress,
+		{
+			[handlerName: string]: Event$1;
+		}
+	]>;
+	_terrainMovement: boolean;
+	_zoom: {
+		handlerName: string;
+	};
+	_previousActiveHandlers: {
+		[x: string]: Handler;
+	};
+	_listeners: Array<[
+		Window | Document | HTMLElement,
+		string,
+		{
+			passive?: boolean;
+			capture?: boolean;
+		} | undefined
+	]>;
+	constructor(map: Map$1, options: CompleteMapOptions);
+	destroy(): void;
+	_addDefaultHandlers(options: CompleteMapOptions): void;
+	_add(handlerName: string, handler: Handler, allowed?: Array<string>): void;
+	stop(allowEndAnimation: boolean): void;
+	isActive(): boolean;
+	isZooming(): boolean;
+	isRotating(): boolean;
+	isMoving(): boolean;
+	_blockedByActive(activeHandlers: {
+		[x: string]: Handler;
+	}, allowed: Array<string>, myName: string): boolean;
+	handleWindowEvent: (e: {
+		type: "mousemove" | "mouseup" | "touchmove";
+	}) => void;
+	_getMapTouches(touches: TouchList): TouchList;
+	handleEvent: (e: Event$1, eventName?: keyof Handler) => void;
+	mergeHandlerResult(mergedHandlerResult: HandlerResult, eventsInProgress: EventsInProgress, handlerResult: HandlerResult, name: string, e?: UIEvent): void;
+	_applyChanges(): void;
+	_updateMapTransform(combinedResult: HandlerResult, combinedEventsInProgress: EventsInProgress, deactivatedHandlers: {
+		[handlerName: string]: Event$1;
+	}): void;
+	_fireEvents(newEventsInProgress: EventsInProgress, deactivatedHandlers: {
+		[handlerName: string]: Event$1;
+	}, allowEndAnimation: boolean): void;
+	_fireEvent(type: string, e?: Event$1): void;
+	_requestFrame(): number;
+	_triggerRenderFrame(): void;
+}
 type ControlPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
 type MapLayerMouseEvent = MapMouseEvent & {
 	features?: MapGeoJSONFeature[];
@@ -13520,6 +13638,7 @@ type MapOptions = {
 	 */
 	centerClampedToGround?: boolean;
 };
+type CompleteMapOptions = Complete<MapOptions>;
 declare class Map$1 extends Camera$1 {
 	style: Style$1;
 	painter: Painter;
@@ -15499,7 +15618,7 @@ type WatermarkUpdateOptions = Omit<WatermarkOptions, "onClick" | "visible"> & {
 	/** Set the interactivity of the watermark. */
 	interactive?: boolean;
 };
-declare class WatermarkSystem extends PubSub$1<{
+declare class WatermarkSystem extends PubSub<{
 	"texture-loaded": void;
 }> {
 	#private;
@@ -15579,7 +15698,7 @@ type PackedJsonMessage = {
 	shouldCollideWithScreenEdges: boolean;
 	lockedToStrategyIndex: number;
 };
-declare class CollisionSystem extends PubSub<TCollisionSystemEvent, keyof TCollisionSystemEvent> {
+declare class CollisionSystem extends PubSub$1<TCollisionSystemEvent, keyof TCollisionSystemEvent> {
 	private worker;
 	private debugContext;
 	private debugCanvas;
@@ -15661,7 +15780,7 @@ type InteractionState = {
 		offsetY: number;
 	} | undefined;
 };
-declare class InteractionSystem extends PubSub<InteractionEvents> {
+declare class InteractionSystem extends PubSub$1<InteractionEvents> {
 	raycaster: Raycaster;
 	private state;
 	private coreState;
@@ -16154,7 +16273,7 @@ type AddLabelOptionsInternal = z.input<typeof addLabelOptionsSchema> & {
 	 */
 	textPlacement?: LabelTextPlacement | LabelTextPlacement[];
 };
-declare class MeshCreationAndOptimizationSystem extends PubSub$1<{
+declare class MeshCreationAndOptimizationSystem extends PubSub<{
 	"model-loaded": void;
 	"geometry-2d-added": void;
 	"geometry-group-added": void;
@@ -16194,7 +16313,7 @@ declare enum TEXTALIGN {
 	CENTER = "center",
 	RIGHT = "right"
 }
-declare class TwoDDrawSystem extends PubSub$1<{
+declare class TwoDDrawSystem extends PubSub<{
 	"img:loaded": undefined;
 }> {
 	dirty: boolean;
@@ -16252,7 +16371,7 @@ declare class DrawSystem {
 	determineTextureVisiblity(meshComponent: MeshComponent, textureComponent: TextureComponent, interactionComponent?: InteractionComponent): void;
 	update(): void;
 }
-declare class TwoDVisibilitySystem extends PubSub<{
+declare class TwoDVisibilitySystem extends PubSub$1<{
 	"draw:2d": undefined;
 	"animate:2d": undefined;
 }> {
@@ -16270,7 +16389,7 @@ declare class TwoDVisibilitySystem extends PubSub<{
 	playAnimations: () => void;
 	_playAnimations(): void;
 }
-declare class RenderSystem extends PubSub$1<{
+declare class RenderSystem extends PubSub<{
 	"measure-canvas": undefined;
 	"pre-render": undefined;
 	"post-render": undefined;
@@ -16450,7 +16569,7 @@ type CameraSystemState = {
 type CameraEvents = {
 	[Event in CameraEventName]: Event extends keyof SpecificCameraEvents ? SpecificCameraEvents[Event] : undefined;
 };
-declare class CameraSystem extends PubSub<CameraEvents> {
+declare class CameraSystem extends PubSub$1<CameraEvents> {
 	#private;
 	dirty: boolean;
 	zoomDirty: boolean;
@@ -16960,7 +17079,7 @@ declare class DOMDrawSystem {
 	constructor(state: RendererState);
 	update(isUserInteracting: boolean): void;
 }
-declare class DOMResizeSystem extends PubSub$1<{
+declare class DOMResizeSystem extends PubSub<{
 	"dimensions-update": void;
 }> {
 	state: RendererState;
@@ -17003,7 +17122,7 @@ export declare const ANIMATION_TWEENS: {
 	"ease-out": (amount: number) => number;
 	"ease-in-out": (amount: number) => number;
 };
-declare class Camera$2 extends PubSub$1<{
+declare class Camera$2 extends PubSub<{
 	"padding-change": {
 		padding: InsetPadding;
 	};
@@ -17164,7 +17283,7 @@ declare class Camera$2 extends PubSub$1<{
 	 */
 	focusOn(target: (Position | Position$1 | string)[], options?: FocusOnOptions): Promise<void>;
 }
-declare class PanBoundsSystem extends PubSub$1<{
+declare class PanBoundsSystem extends PubSub<{
 	update: void;
 }> {
 	private currentTotalBoundingBox?;
@@ -17255,7 +17374,7 @@ declare class IdleQueue {
 	 */
 	clearAll(): void;
 }
-declare class OutlineInterpolationSystem extends PubSub$1<{
+declare class OutlineInterpolationSystem extends PubSub<{
 	"needs-render": void;
 }> {
 	#private;
@@ -17290,7 +17409,7 @@ declare class OutlineInterpolationSystem extends PubSub$1<{
 	update(zoomLevel: number, isCameraZoomDirty?: boolean): void;
 	destroy(): void;
 }
-declare class ImageSystem extends PubSub$1<{
+declare class ImageSystem extends PubSub<{
 	"image-loaded": void;
 }> {
 	private rendererState;
@@ -17318,7 +17437,7 @@ declare class ImageSystem extends PubSub$1<{
 	update(cameraRotationRadians: number): void;
 	updateImageScreenBBoxes(meshComponent: MeshComponent | ImageComponent): void;
 }
-declare class GeometryInFocusSystem extends PubSub$1<{
+declare class GeometryInFocusSystem extends PubSub<{
 	/**
 	 * Returns the list of entities that are likely in focus, sorted by the weight of the raycast.
 	 */
@@ -17373,7 +17492,7 @@ declare class GeometryInFocusSystem extends PubSub$1<{
 	hideDebug(): void;
 	destroy(): void;
 }
-declare class OutdoorLayers extends PubSub<{}> {
+declare class OutdoorLayers extends PubSub$1<{}> {
 	#private;
 	idleQueue: IdleQueue;
 	hideLayersIntersectingPolygons(polygons: Feature$1<Polygon$1 | MultiPolygon$1, any>[], layers: string[]): void;
@@ -17445,7 +17564,7 @@ declare class GeometryDisposalSystem {
 	constructor(state: RendererState);
 	update(): void;
 }
-declare class TextureSystem extends PubSub$1<{
+declare class TextureSystem extends PubSub<{
 	"texture-added": void;
 }> {
 	dirty: boolean;
@@ -17516,6 +17635,158 @@ declare class PluginSystem {
 	unregisterPlugin(plugin: ISystemPlugin): void;
 	update(state: RendererState): void;
 }
+declare class ShadowsSystem {
+	private state;
+	private rendererService;
+	private depthMaterial;
+	private cameraOrbit;
+	private lightCamera;
+	private shadowRenderTarget;
+	private lightMatrix;
+	private currentSnapX;
+	private currentSnapY;
+	private shadowCenter;
+	private shadowPlane;
+	private shadowPlaneMaterial;
+	private shadowPlaneEnabled;
+	private lightCameraHelper;
+	private debugEnabled;
+	private debugGrid;
+	private debugCurrentCell;
+	private debugCurrentCellMaterial;
+	private debugCanvas;
+	private debugCanvasCtx;
+	private debugRenderTarget;
+	/** Immutable user-provided configuration (external API) */
+	private readonly options;
+	/** Mutable internal state that changes during runtime */
+	private readonly internal;
+	private readonly shadowResolutionSizes;
+	private readonly shadowResolutionZoomThresholds;
+	constructor(state: RendererState, rendererService: Renderer, cameraOrbit: Object3D, options?: ShadowsOptions);
+	/**
+	 * Creates a WebGLRenderTarget for shadow mapping with the specified size
+	 * @param size - The width and height of the render target in pixels
+	 * @returns A configured WebGLRenderTarget with depth texture
+	 */
+	private createShadowRenderTarget;
+	/**
+	 * Resizes the shadow render target to the specified size
+	 * Reuses the existing render target to avoid memory allocation overhead
+	 * @param size - The new width and height of the render target in pixels
+	 */
+	private resizeShadowRenderTarget;
+	/**
+	 * Creates a shadow-receiving plane at ground level (z=0)
+	 * The plane only renders shadow pixels and is transparent elsewhere
+	 */
+	private createShadowPlane;
+	/**
+	 * Enable or disable the shadow plane
+	 */
+	setShadowPlaneEnabled(enabled: boolean): void;
+	/**
+	 * Get shadow plane enabled state
+	 */
+	isShadowPlaneEnabled(): boolean;
+	/**
+	 * Update shadow plane position to follow camera (for large scenes)
+	 */
+	private updateShadowPlanePosition;
+	/**
+	 * Enable or disable debug visualization for the shadow system
+	 * @param enabled - Whether to show debug helpers
+	 */
+	setDebugEnabled(enabled: boolean): void;
+	/**
+	 * Get debug visualization enabled state
+	 * @returns Whether debug visualization is enabled
+	 */
+	isDebugEnabled(): boolean;
+	/**
+	 * Creates debug visualization helpers for the shadow system
+	 */
+	private createDebugHelpers;
+	/**
+	 * Creates a grid visualization showing the shadow snap grid
+	 */
+	private createDebugGrid;
+	/**
+	 * Creates a colored mesh highlighting the current grid cell
+	 */
+	private createDebugCurrentCell;
+	/**
+	 * Creates a debug canvas to display the shadow map (what the light camera sees)
+	 */
+	private createDebugCanvas;
+	private debugPixelBuffer;
+	/**
+	 * Updates the debug canvas with a color render from the light camera's perspective
+	 */
+	private updateDebugCanvas;
+	/**
+	 * Disposes debug visualization helpers
+	 */
+	private disposeDebugHelpers;
+	/**
+	 * Updates the debug helpers to reflect current light camera state
+	 */
+	private updateDebugHelpers;
+	/**
+	 * Calculate sun direction vector from azimuth and elevation angles
+	 */
+	private updateSunDirection;
+	private updateLightCamera;
+	private bias;
+	private matrix;
+	private updateLightMatrix;
+	/**
+	 * Update sun distance based on camera zoom level
+	 */
+	private updateAutoSunDistance;
+	/**
+	 * Update shadow resolution based on camera zoom level
+	 * Only applies when shadowMapSize is set to 'auto'
+	 * Switches between high (4K) and low (2K) resolution with hysteresis
+	 */
+	private updateAutoShadowResolution;
+	private updateAutoLightSize;
+	/**
+	 * Update snap grid size based on camera zoom level
+	 * Larger grid when zoomed out = fewer shadow map re-renders
+	 */
+	private updateAutoSnapGridSize;
+	/**
+	 * Recreates the debug grid visualization when grid size changes
+	 */
+	private recreateDebugGrid;
+	private transparentGeometryVisibilityStateMap;
+	private renderShadowMap;
+	private updateShadowUniforms;
+	private lastZoomLevel;
+	private lastCameraElevation;
+	/**
+	 * Checks if zoom level or camera elevation has changed significantly since the last update
+	 * @param zoomLevel - Current zoom level
+	 * @param cameraElevation - Current camera elevation
+	 * @returns True if zoom or elevation changed significantly, false otherwise
+	 */
+	private zoomOrElevationChanged;
+	private updateSnap;
+	needsRender: boolean;
+	needsCompute: boolean;
+	update(zoomLevel: number, cameraElevation: number): void;
+	/**
+	 * For some reason, geometries with opacity 0 are still casting a shadow.
+	 * This method excludes them from the shadow map.
+	 */
+	private excludeNonShadowGeometry;
+	private revertExcludedNonShadowGeometry;
+	/**
+	 * Dispose shadow plane resources
+	 */
+	destroy(): void;
+}
 type Systems = {
 	cameraSystem: CameraSystem;
 	panBoundsSystem: PanBoundsSystem;
@@ -17550,13 +17821,14 @@ type Systems = {
 	maskingSystem: MaskingSystem;
 	clippingPlaneSystem: ClippingPlaneSystem;
 	pluginSystem: PluginSystem;
+	shadowsSystem?: ShadowsSystem;
 };
 export type MapViewState = {
 	readonly type: "map-view";
 	hoverColor: string;
 	text3dHoverColor: string;
 };
-declare class Core extends PubSub<MapEvent> {
+declare class Core extends PubSub$1<MapEvent> {
 	#private;
 	options: Omit<RendererCoreOptions, "outdoorView">;
 	container: HTMLElement;
@@ -17871,7 +18143,7 @@ declare class Core extends PubSub<MapEvent> {
 	 * };
 	 * map.on('click', handler);
 	 */
-	on: PubSub<MapEvent>["on"];
+	on: PubSub$1<MapEvent>["on"];
 	/**
 	 * Unsubscribe a function previously subscribed with {@link on}
 	 *
@@ -17886,7 +18158,7 @@ declare class Core extends PubSub<MapEvent> {
 	 * };
 	 * map.off('click', handler);
 	 */
-	off: PubSub<MapEvent>["off"];
+	off: PubSub$1<MapEvent>["off"];
 	/**
 	 * @hidden
 	 * Returns the current cursor decided by Mappedin. This is useful when integrating with other overlays to show the correct user interaction.
@@ -18184,7 +18456,82 @@ type RendererCoreOptions = Partial<{
 	transformImageRequest?: TransformImageRequest;
 	useWorkers?: boolean;
 	useCollisionWorker?: boolean;
+	/**
+	 * Shadow rendering configuration
+	 * @experimental
+	 * @default { enabled: false }
+	 */
+	__EXPERIMENTAL_shadows?: ShadowsOptions;
 }>;
+type ShadowsOptions = {
+	/**
+	 * Master toggle for the entire shadow system
+	 * @default false
+	 */
+	enabled: boolean;
+	/**
+	 * Enable debug visualization (light camera frustum, snap grid, current cell highlight, shadow map preview)
+	 * @default false
+	 */
+	debug?: boolean;
+	/**
+	 * Base color tint applied to shadows. Lighter colors make shadows softer and less harsh.
+	 * @default '#a0a0a0'
+	 */
+	baseColor?: string;
+	/**
+	 * Opacity/darkness of shadows (0.0 = invisible, 1.0 = completely black).
+	 * Lower values create softer, more subtle shadows that blend with ambient lighting.
+	 * @default 0.35
+	 */
+	shadowOpacity?: number;
+	/**
+	 * Number of Poisson disk samples for Percentage Closer Filtering (PCF).
+	 * Higher values create softer shadow edges but impact performance.
+	 * Valid range: 1-16 samples (uses rotated Poisson disk pattern).
+	 * @default 4
+	 */
+	pcfSamples?: number;
+	/**
+	 * Sampling spread/radius for PCF soft shadows in shadow map texels.
+	 * Larger values create softer, more blurred shadow edges and reduce banding.
+	 * Smaller values create sharper, more defined shadows.
+	 * @default 2.5
+	 */
+	pcfSpread?: number;
+	/**
+	 * Depth bias to prevent shadow acne and self-shadowing artifacts.
+	 * Increase if you see moiré patterns, noise, or overall darkening.
+	 * Too high causes "peter panning" (detached shadows).
+	 * @default 0.001
+	 */
+	shadowBias?: number;
+	/**
+	 * Offset shadows along surface normals to prevent self-shadowing artifacts (shadow acne).
+	 * Increase if you see noise/banding on surfaces. Too high causes shadows to detach from objects.
+	 * @default 0.12
+	 */
+	normalBias?: number;
+	/**
+	 * Resolution of the shadow map texture in pixels (width/height).
+	 * - `'auto'` (default): Automatically switches between high (4096) and low (2048) resolution based on zoom level
+	 * - A number value (e.g., 1024, 2048, 4096): Uses a fixed resolution
+	 * Higher values create sharper shadows but use more memory and bandwidth.
+	 * Lower values are faster but may show pixelation.
+	 * @default 'auto'
+	 */
+	shadowMapSize?: "auto" | number;
+	/**
+	 * Sun azimuth angle in degrees: 0=North, 90=East, 180=South, 270=West
+	 * @default 225
+	 */
+	sunAzimuth?: number;
+	/**
+	 * Sun elevation angle in degrees: 0=horizon, 90=directly overhead
+	 * @default 45
+	 */
+	sunElevation?: number;
+};
 /**
  * A color string. Color can be one of:
  * - CSS color name, e.g. `DarkGoldenRod`
@@ -18523,6 +18870,14 @@ type RendererState = {
 	ambientLight: AmbientLight;
 	renderer: WebGLRenderer;
 	threeJSScene: Scene;
+	/**
+	 * The depth range for 3D rendering. This is used to ensure that depth comparisons are accurate, since Maplibre changes the depth range during rendering.
+	 * @defaultValue [0, 1]
+	 */
+	depthRangeFor3D: [
+		number,
+		number
+	];
 };
 type EntityTypes = Geometry3DTypes | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D;
 type TransformImageRequest = (url: string) => Promise<{
@@ -19339,7 +19694,7 @@ declare class FloorStackObject implements Omit<MVFFloorStack, "maps" | "floors"
 	addFloor(floor: FloorObject): void;
 	loadAllFloors(): void;
 }
-declare class GeojsonApiMapObject extends PubSub$1<{
+declare class GeojsonApiMapObject extends PubSub<{
 	"floor-change": {
 		reason?: TFloorChangeReason;
 		floorId: string;
@@ -22459,7 +22814,7 @@ export type MapElementToUpdateState = {
 	[DOORS.Exterior]: TDoorsUpdateState;
 	[DOORS.Interior]: TDoorsUpdateState;
 };
-declare class GeoJsonApi extends PubSub$1<TNavigationEvents> {
+declare class GeoJsonApi extends PubSub<TNavigationEvents> {
 	#private;
 	core: Core;
 	mapObjects: GeojsonApiMapObject[];
@@ -22482,7 +22837,7 @@ declare class GeoJsonApi extends PubSub$1<TNavigationEvents> {
 	 * Internal systems publish events here which are then exposed to developers via
 	 * MapView.on() and MapView.off().
 	 */
-	externalPubSub: PubSub$1<TEvents>;
+	externalPubSub: PubSub<TEvents>;
 	get manualFloorVisibility(): boolean;
 	set manualFloorVisibility(value: boolean);
 	get hidePathsNotOnCurrentFloor(): boolean;
@@ -22499,7 +22854,7 @@ declare class GeoJsonApi extends PubSub$1<TNavigationEvents> {
 	Shapes: Shapes;
 	Style: Style$2;
 	Image3D: Image3D;
-	constructor(rendererCore: Core, mapView: MapView, externalPubSub: PubSub$1<TEvents>);
+	constructor(rendererCore: Core, mapView: MapView, externalPubSub: PubSub<TEvents>);
 	preloadFloors(floors: Floor[]): void;
 	updateState<T extends MapElementsWithState>(target: T, state: TUpdateState<T>): void;
 	updateState<T extends string & NonNullable<unknown>>(target: T, state: ValueOf<MapElementToUpdateState>): void;
@@ -24701,7 +25056,7 @@ export declare class ImageMetaData extends BaseMetaData {
 	 */
 	destroy(): void;
 }
-type MVF3Location = Required<ParsedMVFv3>["locations"][number];
+type MVF3Location = Required<MVFv2_STANDARD_MVFv3>["locations"][number];
 type LocationData = Omit<MVF2Location, "categories" | "spaces" | "obstructions" | "entrances" | "shapes" | "connections" | "annotations" | "areas" | "openingHoursSpecification" | "links" | "pictures" | "website" | "icon"> & {
 	links: Hyperlink[];
 	images: ImageMetaData[];
@@ -24732,8 +25087,13 @@ export declare class LocationProfile extends BaseMetaData implements LocationDat
 	 * The location's logo
 	 *
 	 * @format uri
+	 * @deprecated Use the {@link logoImage} property instead
 	 */
 	logo?: string;
+	/**
+	 * An image representing the location's logo
+	 */
+	logoImage?: ImageMetaData;
 	phone?: string;
 	/**
 	 * The location's social media links.
@@ -25153,7 +25513,16 @@ export declare class Space extends DetailedMapData<SpaceFeature> implements IGeo
 	 */
 	get type(): TSpaceType;
 	/**
-	 * @internal
+	 * Gets the {@link EnterpriseLocation}s attached to this space.
+	 *
+	 * @returns {EnterpriseLocation[]} An array of enterprise locations.
+	 */
+	get enterpriseLocations(): EnterpriseLocation[];
+	/**
+	 * Gets the {@link EnterpriseLocation}s attached to this space.
+	 *
+	 * @deprecated Use {@link enterpriseLocations} instead. This property will be removed in a future release.
+	 * @returns {EnterpriseLocation[]} An array of enterprise locations.
 	 */
 	get locations(): EnterpriseLocation[];
 	/**
@@ -25530,7 +25899,16 @@ export declare class MapObject extends DetailedMapData<ObstructionFeature> imple
 	 */
 	get type(): string;
 	/**
-	 * @internal
+	 * Gets the {@link EnterpriseLocation}s attached to this object.
+	 *
+	 * @returns {EnterpriseLocation[]} An array of enterprise locations.
+	 */
+	get enterpriseLocations(): EnterpriseLocation[];
+	/**
+	 * Gets the {@link EnterpriseLocation}s attached to this object.
+	 *
+	 * @deprecated Use {@link enterpriseLocations} instead. This property will be removed in a future release.
+	 * @returns {EnterpriseLocation[]} An array of enterprise locations.
 	 */
 	get locations(): EnterpriseLocation[];
 	/**
@@ -25610,7 +25988,7 @@ type TokenManagerEvents = {
 		sasTokens: Record<string, TokenWithExpiration>;
 	};
 };
-type TokenManagerPubSub = PubSub$1<TokenManagerEvents>;
+type TokenManagerPubSub = PubSub<TokenManagerEvents>;
 declare class TokenManager {
 	#private;
 	constructor(mapIds: string[], options: TokenManagerOptions);
@@ -25700,7 +26078,7 @@ type TMapDataInternalOptions = {
 	binaryBundle?: Uint8Array;
 	tokenManager?: TokenManager;
 	getMapDataOptions?: TGetMapDataOptions;
-	mvf3?: ParsedMVFv3;
+	mvf3?: MVFv2_STANDARD_MVFv3;
 };
 type MVFNodeFeature = MVFNodeCollection["features"][number];
 type MVFFloorFeature = FloorCollection["features"][number];
@@ -26147,16 +26525,20 @@ type MapDataRecords = {
 		[floorId: string]: AnnotationCollection["features"][number][];
 	};
 	mvfAreasById: Record<AreaId, AreaCollection["features"][number]>;
-	mvf3LocationsById: Record<string, Required<ParsedMVFv3>["locations"][number]>;
+	mvf3LocationsById: Record<string, Required<MVFv2_STANDARD_MVFv3>["locations"][number]>;
 };
 type EnterpriseMapDataRecords = {
 	connectionsByExternalId: Record<string, Connection[]>;
 	locationsByExternalId: Record<string, EnterpriseLocation[]>;
 	categoriesByExternalId: Record<string, EnterpriseCategory[]>;
 	locationsById: Record<MVFEnterpriseLocationId, EnterpriseLocation>;
+	/** Instance locations by ID - separate from locationsById so they don't appear in getByType */
+	locationInstancesById: Record<string, EnterpriseLocation>;
+	/** Instance locations by polygon ID - for space.enterpriseLocations to check instances first */
+	instanceLocationsByPolygonId: Record<string, EnterpriseLocation>;
 	categoriesById: Record<MVFEnterpriseCategoryId, EnterpriseCategory>;
 	locationIdsByNodeId: Record<string, MVFEnterpriseLocationId[]>;
-	locationInstancesById: Record<string, EnterpriseLocationInstance>;
+	mvfLocationInstancesById: Record<string, EnterpriseLocationInstance>;
 	venue: MVFEnterpriseVenue;
 	mvfCategoriesById: Record<string, MVFEnterpriseCategory>;
 	mvfLocationsById: Record<string, MVFEnterpriseLocation>;
@@ -26708,7 +27090,7 @@ export type TFindPreferredLanguageInVenueOptions = {
  * @returns An object containing the selected language code and name, or undefined if no language is found
  */
 export declare function findPreferredLanguageInVenue(venue: EnterpriseVenue, options?: TFindPreferredLanguageInVenueOptions): Language;
-declare class MapDataInternal extends PubSub$1<{
+declare class MapDataInternal extends PubSub<{
 	"language-change": {
 		code: string;
 		name: string;
@@ -26776,6 +27158,8 @@ declare class MapDataInternal extends PubSub$1<{
 	locationProfilesByAttachedFeatureId: MapDataRecords["locationProfilesByAttachedFeatureId"];
 	entranceNodeIdsBySpaceId?: MapDataRecords["entranceNodeIdsBySpaceId"];
 	locationsById: EnterpriseMapDataRecords["locationsById"];
+	locationInstancesById: EnterpriseMapDataRecords["locationInstancesById"];
+	instanceLocationsByPolygonId: EnterpriseMapDataRecords["instanceLocationsByPolygonId"];
 	categoriesById: EnterpriseMapDataRecords["categoriesById"];
 	mvfLocationsByGeometryId: EnterpriseMapDataRecords["mvfLocationsByGeometryId"];
 	locationIdsByNodeId: EnterpriseMapDataRecords["locationIdsByNodeId"];
@@ -28304,6 +28688,80 @@ export type TShow3DMapOptions = {
 	 * @default false
 	 */
 	disableWorkers?: boolean;
+	/**
+	 * Shadow rendering configuration.
+	 * @experimental
+	 * @default { enabled: false }
+	 */
+	__EXPERIMENTAL_shadows?: {
+		/**
+		 * Master toggle for the entire shadow system
+		 * @default false
+		 */
+		enabled: boolean;
+		/**
+		 * Enable debug visualization (light camera frustum, snap grid, current cell highlight, shadow map preview)
+		 * @default false
+		 */
+		debug?: boolean;
+		/**
+		 * Base color tint applied to shadows. Lighter colors make shadows softer and less harsh.
+		 * @default '#a0a0a0'
+		 */
+		baseColor?: string;
+		/**
+		 * Opacity/darkness of shadows (0.0 = invisible, 1.0 = completely black).
+		 * Lower values create softer, more subtle shadows that blend with ambient lighting.
+		 * @default 0.35
+		 */
+		shadowOpacity?: number;
+		/**
+		 * Number of Poisson disk samples for Percentage Closer Filtering (PCF).
+		 * Higher values create softer shadow edges but impact performance.
+		 * Valid range: 1-16 samples (uses rotated Poisson disk pattern).
+		 * @default 4
+		 */
+		pcfSamples?: number;
+		/**
+		 * Sampling spread/radius for PCF soft shadows in shadow map texels.
+		 * Larger values create softer, more blurred shadow edges and reduce banding.
+		 * Smaller values create sharper, more defined shadows.
+		 * @default 2.5
+		 */
+		pcfSpread?: number;
+		/**
+		 * Depth bias to prevent shadow acne and self-shadowing artifacts.
+		 * Increase if you see moiré patterns, noise, or overall darkening.
+		 * Too high causes "peter panning" (detached shadows).
+		 * @default 0.001
+		 */
+		shadowBias?: number;
+		/**
+		 * Offset shadows along surface normals to prevent self-shadowing artifacts (shadow acne).
+		 * Increase if you see noise/banding on surfaces. Too high causes shadows to detach from objects.
+		 * @default 0.12
+		 */
+		normalBias?: number;
+		/**
+		 * Resolution of the shadow map texture in pixels (width/height).
+		 * - `'auto'` (default): Automatically switches between high (4096) and low (2048) resolution based on zoom level
+		 * - A number value (e.g., 1024, 2048, 4096): Uses a fixed resolution
+		 * Higher values create sharper shadows but use more memory and bandwidth.
+		 * Lower values are faster but may show pixelation.
+		 * @default 'auto'
+		 */
+		shadowMapSize?: "auto" | number;
+		/**
+		 * Sun azimuth angle in degrees: 0=North, 90=East, 180=South, 270=West
+		 * @default 225
+		 */
+		sunAzimuth?: number;
+		/**
+		 * Sun elevation angle in degrees: 0=horizon, 90=directly overhead
+		 * @default 45
+		 */
+		sunElevation?: number;
+	};
 	/**
 	 * @experimental
 	 * @internal
@@ -28427,7 +28885,6 @@ export {
 	OperationHours,
 	Point$1 as Point,
 	Polygon$1 as Polygon,
-	PubSub$1 as PubSub,
 	RendererState as TRendererState,
 	SiblingGroup,
 	Style$2 as Style,