maplibre-gl 2.0.5 → 2.1.3

package/dist/maplibre-gl.d.ts

@@ -1,4 +1,4 @@
-// Generated by dts-bundle-generator v6.4.0
+// Generated by dts-bundle-generator v6.5.0
 
 import Point from '@mapbox/point-geometry';
 import TinySDF from '@mapbox/tiny-sdf';
@@ -53,6 +53,25 @@ export declare type RequestParameters = {
 	collectResourceTiming?: boolean;
 };
 export declare type ResponseCallback<T> = (error?: Error | null, data?: T | null, cacheControl?: string | null, expires?: string | null) => void;
+export declare class AJAXError extends Error {
+	/**
+	 * The response's HTTP status code.
+	 */
+	status: number;
+	/**
+	 * The response's HTTP status text.
+	 */
+	statusText: string;
+	/**
+	 * The request's URL.
+	 */
+	url: string;
+	/**
+	 * The response's body.
+	 */
+	body: Blob;
+	constructor(status: number, statusText: string, url: string, body: Blob);
+}
 export declare type ResourceTypeEnum = keyof IResourceType;
 export declare type RequestTransformFunction = (url: string, resourceType?: ResourceTypeEnum) => RequestParameters;
 export declare class RequestManager {
@@ -560,6 +579,7 @@ export declare type SymbolLayerSpecification = {
 		"symbol-sort-key"?: DataDrivenPropertyValueSpecification<number>;
 		"symbol-z-order"?: PropertyValueSpecification<"auto" | "viewport-y" | "source">;
 		"icon-allow-overlap"?: PropertyValueSpecification<boolean>;
+		"icon-overlap"?: PropertyValueSpecification<"never" | "always" | "cooperative">;
 		"icon-ignore-placement"?: PropertyValueSpecification<boolean>;
 		"icon-optional"?: PropertyValueSpecification<boolean>;
 		"icon-rotation-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">;
@@ -604,6 +624,7 @@ export declare type SymbolLayerSpecification = {
 			number
 		]>;
 		"text-allow-overlap"?: PropertyValueSpecification<boolean>;
+		"text-overlap"?: PropertyValueSpecification<"never" | "always" | "cooperative">;
 		"text-ignore-placement"?: PropertyValueSpecification<boolean>;
 		"text-optional"?: PropertyValueSpecification<boolean>;
 		"visibility"?: "visible" | "none";
@@ -824,45 +845,45 @@ export declare class LngLatBounds {
 	 */
 	getSouthWest(): LngLat;
 	/**
-	* Returns the northeast corner of the bounding box.
-	*
-	* @returns {LngLat} The northeast corner of the bounding box.
+	 * Returns the northeast corner of the bounding box.
+	 *
+	 * @returns {LngLat} The northeast corner of the bounding box.
 	 */
 	getNorthEast(): LngLat;
 	/**
-	* Returns the northwest corner of the bounding box.
-	*
-	* @returns {LngLat} The northwest corner of the bounding box.
+	 * Returns the northwest corner of the bounding box.
+	 *
+	 * @returns {LngLat} The northwest corner of the bounding box.
 	 */
 	getNorthWest(): LngLat;
 	/**
-	* Returns the southeast corner of the bounding box.
-	*
-	* @returns {LngLat} The southeast corner of the bounding box.
+	 * Returns the southeast corner of the bounding box.
+	 *
+	 * @returns {LngLat} The southeast corner of the bounding box.
 	 */
 	getSouthEast(): LngLat;
 	/**
-	* Returns the west edge of the bounding box.
-	*
-	* @returns {number} The west edge of the bounding box.
+	 * Returns the west edge of the bounding box.
+	 *
+	 * @returns {number} The west edge of the bounding box.
 	 */
 	getWest(): number;
 	/**
-	* Returns the south edge of the bounding box.
-	*
-	* @returns {number} The south edge of the bounding box.
+	 * Returns the south edge of the bounding box.
+	 *
+	 * @returns {number} The south edge of the bounding box.
 	 */
 	getSouth(): number;
 	/**
-	* Returns the east edge of the bounding box.
-	*
-	* @returns {number} The east edge of the bounding box.
+	 * Returns the east edge of the bounding box.
+	 *
+	 * @returns {number} The east edge of the bounding box.
 	 */
 	getEast(): number;
 	/**
-	* Returns the north edge of the bounding box.
-	*
-	* @returns {number} The north edge of the bounding box.
+	 * Returns the north edge of the bounding box.
+	 *
+	 * @returns {number} The north edge of the bounding box.
 	 */
 	getNorth(): number;
 	/**
@@ -892,20 +913,20 @@ export declare class LngLatBounds {
 	 */
 	isEmpty(): boolean;
 	/**
-	* Check if the point is within the bounding box.
-	*
-	* @param {LngLatLike} lnglat geographic point to check against.
-	* @returns {boolean} True if the point is within the bounding box.
-	* @example
-	* var llb = new maplibregl.LngLatBounds(
-	*   new maplibregl.LngLat(-73.9876, 40.7661),
-	*   new maplibregl.LngLat(-73.9397, 40.8002)
-	* );
-	*
-	* var ll = new maplibregl.LngLat(-73.9567, 40.7789);
-	*
-	* console.log(llb.contains(ll)); // = true
-	*/
+	 * Check if the point is within the bounding box.
+	 *
+	 * @param {LngLatLike} lnglat geographic point to check against.
+	 * @returns {boolean} True if the point is within the bounding box.
+	 * @example
+	 * var llb = new maplibregl.LngLatBounds(
+	 *   new maplibregl.LngLat(-73.9876, 40.7661),
+	 *   new maplibregl.LngLat(-73.9397, 40.8002)
+	 * );
+	 *
+	 * var ll = new maplibregl.LngLat(-73.9567, 40.7789);
+	 *
+	 * console.log(llb.contains(ll)); // = true
+	 */
 	contains(lnglat: LngLatLike): boolean;
 	/**
 	 * Converts an array to a `LngLatBounds` object.
@@ -1085,7 +1106,7 @@ export declare class CanonicalTileID {
 	key: string;
 	constructor(z: number, x: number, y: number);
 	equals(id: CanonicalTileID): boolean;
-	url(urls: Array<string>, scheme?: string | null): string;
+	url(urls: Array<string>, pixelRatio: number, scheme?: string | null): string;
 	getTilePoint(coord: MercatorCoordinate): Point;
 	toString(): string;
 }
@@ -1579,6 +1600,13 @@ export declare class StructArrayLayout2i4 extends StructArray {
 	emplaceBack(v0: number, v1: number): number;
 	emplace(i: number, v0: number, v1: number): number;
 }
+export declare class StructArrayLayout4i8 extends StructArray {
+	uint8: Uint8Array;
+	int16: Int16Array;
+	_refreshViews(): void;
+	emplaceBack(v0: number, v1: number, v2: number, v3: number): number;
+	emplace(i: number, v0: number, v1: number, v2: number, v3: number): number;
+}
 export declare class StructArrayLayout2i4i12 extends StructArray {
 	uint8: Uint8Array;
 	int16: Int16Array;
@@ -1816,6 +1844,8 @@ export declare class FeatureIndexArray extends StructArrayLayout1ul2ui8 {
 	 */
 	get(index: number): FeatureIndexStruct;
 }
+export declare class RasterBoundsArray extends StructArrayLayout4i8 {
+}
 export declare class CircleLayoutArray extends StructArrayLayout2i4 {
 }
 export declare class FillLayoutArray extends StructArrayLayout2i4 {
@@ -2351,12 +2381,12 @@ export interface StyleImageInterface {
 	 */
 	width: number;
 	/**
-	* @property {number} height
-	*/
+	 * @property {number} height
+	 */
 	height: number;
 	/**
 	 * @property {Uint8Array | Uint8ClampedArray} data
-	*/
+	 */
 	data: Uint8Array | Uint8ClampedArray;
 	/**
 	 * This method is called once before every frame where the icon will be used.
@@ -2683,8 +2713,8 @@ export declare class EdgeInsets {
  */
 export declare type PaddingOptions = {
 	/**
-	* @property {number} top Padding in pixels from the top of the map canvas.
-	*/
+	 * @property {number} top Padding in pixels from the top of the map canvas.
+	 */
 	top: number;
 	/**
 	 * @property {number} bottom Padding in pixels from the bottom of the map canvas.
@@ -3966,6 +3996,7 @@ export declare type SymbolLayoutProps = {
 	"symbol-sort-key": DataDrivenProperty<number>;
 	"symbol-z-order": DataConstantProperty<"auto" | "viewport-y" | "source">;
 	"icon-allow-overlap": DataConstantProperty<boolean>;
+	"icon-overlap": DataConstantProperty<"never" | "always" | "cooperative">;
 	"icon-ignore-placement": DataConstantProperty<boolean>;
 	"icon-optional": DataConstantProperty<boolean>;
 	"icon-rotation-alignment": DataConstantProperty<"map" | "viewport" | "auto">;
@@ -4010,6 +4041,7 @@ export declare type SymbolLayoutProps = {
 		number
 	]>;
 	"text-allow-overlap": DataConstantProperty<boolean>;
+	"text-overlap": DataConstantProperty<"never" | "always" | "cooperative">;
 	"text-ignore-placement": DataConstantProperty<boolean>;
 	"text-optional": DataConstantProperty<boolean>;
 };
@@ -4020,6 +4052,7 @@ export declare type SymbolLayoutPropsPossiblyEvaluated = {
 	"symbol-sort-key": PossiblyEvaluatedPropertyValue<number>;
 	"symbol-z-order": "auto" | "viewport-y" | "source";
 	"icon-allow-overlap": boolean;
+	"icon-overlap": "never" | "always" | "cooperative";
 	"icon-ignore-placement": boolean;
 	"icon-optional": boolean;
 	"icon-rotation-alignment": "map" | "viewport" | "auto";
@@ -4064,6 +4097,7 @@ export declare type SymbolLayoutPropsPossiblyEvaluated = {
 		number
 	]>;
 	"text-allow-overlap": boolean;
+	"text-overlap": "never" | "always" | "cooperative";
 	"text-ignore-placement": boolean;
 	"text-optional": boolean;
 };
@@ -4127,6 +4161,7 @@ export declare class SymbolStyleLayer extends StyleLayer {
 	_handleOverridablePaintPropertyUpdate<T, R>(name: string, oldValue: PropertyValue<T, R>, newValue: PropertyValue<T, R>): boolean;
 	static hasPaintOverride(layout: PossiblyEvaluated<SymbolLayoutProps, SymbolLayoutPropsPossiblyEvaluated>, propertyName: string): boolean;
 }
+export declare type OverlapMode = "never" | "always" | "cooperative";
 export declare type TypedStyleLayer = CircleStyleLayer | FillStyleLayer | FillExtrusionStyleLayer | HeatmapStyleLayer | HillshadeStyleLayer | LineStyleLayer | SymbolStyleLayer;
 export declare type BucketParameters<Layer extends TypedStyleLayer> = {
 	index: number;
@@ -4204,12 +4239,12 @@ export interface Bucket {
 	upload(context: Context): void;
 	uploadPending(): boolean;
 	/**
-	   * Release the WebGL resources associated with the buffers. Note that because
-	   * buckets are shared between layers having the same layout properties, they
-	   * must be destroyed in groups (all buckets for a tile, or all symbol buckets).
-	   *
-	   * @private
-	   */
+	 * Release the WebGL resources associated with the buffers. Note that because
+	 * buckets are shared between layers having the same layout properties, they
+	 * must be destroyed in groups (all buckets for a tile, or all symbol buckets).
+	 *
+	 * @private
+	 */
 	destroy(): void;
 }
 export declare type CustomRenderMethod = (gl: WebGLRenderingContext, matrix: mat4) => void;
@@ -4351,16 +4386,16 @@ export interface CustomLayerInterface {
 	 */
 	onAdd(map: Map, gl: WebGLRenderingContext): void;
 	/**
-	* Optional method called when the layer has been removed from the Map with {@link Map#removeLayer}. This
-	* gives the layer a chance to clean up gl resources and event listeners.
-	*
-	* @function
-	* @memberof CustomLayerInterface
-	* @instance
-	* @name onRemove
-	* @param {Map} map The Map this custom layer was just added to.
-	* @param {WebGLRenderingContext} gl The gl context for the map.
-	*/
+	 * Optional method called when the layer has been removed from the Map with {@link Map#removeLayer}. This
+	 * gives the layer a chance to clean up gl resources and event listeners.
+	 *
+	 * @function
+	 * @memberof CustomLayerInterface
+	 * @instance
+	 * @name onRemove
+	 * @param {Map} map The Map this custom layer was just added to.
+	 * @param {WebGLRenderingContext} gl The gl context for the map.
+	 */
 	onRemove(map: Map, gl: WebGLRenderingContext): void;
 }
 declare abstract class StyleLayer extends Evented {
@@ -4521,19 +4556,6 @@ export declare class LineAtlas {
 	};
 	bind(context: Context): void;
 }
-declare const status: {
-	unavailable: string;
-	deferred: string;
-	loading: string;
-	loaded: string;
-	error: string;
-};
-export declare type PluginState = {
-	pluginStatus: typeof status[keyof typeof status];
-	pluginURL: string;
-};
-export declare type PluginStateSyncCallback = (state: PluginState) => void;
-declare const registerForPluginStateChange: (callback: PluginStateSyncCallback) => PluginStateSyncCallback;
 export declare type MessageListener = (a: {
 	data: any;
 	target: any;
@@ -4577,6 +4599,112 @@ export declare class Dispatcher {
 	getActor(): Actor;
 	remove(): void;
 }
+export declare class TileBounds {
+	bounds: LngLatBounds;
+	minzoom: number;
+	maxzoom: number;
+	constructor(bounds: [
+		number,
+		number,
+		number,
+		number
+	], minzoom?: number | null, maxzoom?: number | null);
+	validateBounds(bounds: [
+		number,
+		number,
+		number,
+		number
+	]): LngLatBoundsLike;
+	contains(tileID: CanonicalTileID): boolean;
+}
+export declare class VectorTileSource extends Evented implements Source {
+	type: "vector";
+	id: string;
+	minzoom: number;
+	maxzoom: number;
+	url: string;
+	scheme: string;
+	tileSize: number;
+	promoteId: PromoteIdSpecification;
+	_options: VectorSourceSpecification;
+	_collectResourceTiming: boolean;
+	dispatcher: Dispatcher;
+	map: Map;
+	bounds: [
+		number,
+		number,
+		number,
+		number
+	];
+	tiles: Array<string>;
+	tileBounds: TileBounds;
+	reparseOverscaled: boolean;
+	isTileClipped: boolean;
+	_tileJSONRequest: Cancelable;
+	_loaded: boolean;
+	constructor(id: string, options: VectorSourceSpecification & {
+		collectResourceTiming: boolean;
+	}, dispatcher: Dispatcher, eventedParent: Evented);
+	load(): void;
+	loaded(): boolean;
+	hasTile(tileID: OverscaledTileID): boolean;
+	onAdd(map: Map): void;
+	setSourceProperty(callback: Function): void;
+	/**
+	 * Sets the source `tiles` property and re-renders the map.
+	 *
+	 * @param {string[]} tiles An array of one or more tile source URLs, as in the TileJSON spec.
+	 * @returns {VectorTileSource} this
+	 */
+	setTiles(tiles: Array<string>): this;
+	/**
+	 * Sets the source `url` property and re-renders the map.
+	 *
+	 * @param {string} url A URL to a TileJSON resource. Supported protocols are `http:` and `https:`.
+	 * @returns {VectorTileSource} this
+	 */
+	setUrl(url: string): this;
+	onRemove(): void;
+	serialize(): any;
+	loadTile(tile: Tile, callback: Callback<void>): void;
+	abortTile(tile: Tile): void;
+	unloadTile(tile: Tile): void;
+	hasTransition(): boolean;
+}
+export declare class RasterTileSource extends Evented implements Source {
+	type: "raster" | "raster-dem";
+	id: string;
+	minzoom: number;
+	maxzoom: number;
+	url: string;
+	scheme: string;
+	tileSize: number;
+	bounds: [
+		number,
+		number,
+		number,
+		number
+	];
+	tileBounds: TileBounds;
+	roundZoom: boolean;
+	dispatcher: Dispatcher;
+	map: Map;
+	tiles: Array<string>;
+	_loaded: boolean;
+	_options: RasterSourceSpecification | RasterDEMSourceSpecification;
+	_tileJSONRequest: Cancelable;
+	constructor(id: string, options: RasterSourceSpecification | RasterDEMSourceSpecification, dispatcher: Dispatcher, eventedParent: Evented);
+	load(): void;
+	loaded(): boolean;
+	onAdd(map: Map): void;
+	onRemove(): void;
+	serialize(): any;
+	hasTile(tileID: OverscaledTileID): boolean;
+	loadTile(tile: Tile, callback: Callback<void>): void;
+	abortTile(tile: Tile, callback: Callback<void>): void;
+	unloadTile(tile: Tile, callback: Callback<void>): void;
+	hasTransition(): boolean;
+}
 export declare type MapLayerMouseEvent = MapMouseEvent & {
 	features?: GeoJSON.Feature[];
 };
@@ -4806,8 +4934,8 @@ export interface MapStyleImageMissingEvent extends MapLibreEvent {
 	id: string;
 }
 /**
-* MapEventType - a mapping between the event name and the event value
-*/
+ * MapEventType - a mapping between the event name and the event value
+ */
 export declare type MapEventType = {
 	error: ErrorEvent;
 	load: MapLibreEvent;
@@ -4825,6 +4953,8 @@ export declare type MapEventType = {
 	sourcedata: MapSourceDataEvent;
 	styledata: MapStyleDataEvent;
 	styleimagemissing: MapStyleImageMissingEvent;
+	dataabort: MapDataEvent;
+	sourcedataabort: MapSourceDataEvent;
 	boxzoomcancel: MapLibreZoomEvent;
 	boxzoomstart: MapLibreZoomEvent;
 	boxzoomend: MapLibreZoomEvent;
@@ -4857,913 +4987,1225 @@ export declare type MapEventType = {
 	pitchend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
 	wheel: MapWheelEvent;
 };
-export declare type MapEvent = /**
-	 * Fired when a pointing device (usually a mouse) is pressed within the map.
-	 *
-	 * **Note:** This event is compatible with the optional `layerId` parameter.
-	 * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
-	 * the cursor is pressed while inside a visible portion of the specifed layer.
-	 *
-	 * @event mousedown
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('mousedown', function() {
-	 *   console.log('A mousedown event has occurred.');
-	 * });
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener for a specific layer
-	 * map.on('mousedown', 'poi-label', function() {
-	 *   console.log('A mousedown event has occurred on a visible portion of the poi-label layer.');
-	 * });
-	 * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-	 */ "mousedown"
+export declare type MapEvent = 
 /**
-	 * Fired when a pointing device (usually a mouse) is released within the map.
-	 *
-	 * **Note:** This event is compatible with the optional `layerId` parameter.
-	 * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
-	 * the cursor is released while inside a visible portion of the specifed layer.
-	 *
-	 * @event mouseup
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('mouseup', function() {
-	 *   console.log('A mouseup event has occurred.');
-	 * });
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener for a specific layer
-	 * map.on('mouseup', 'poi-label', function() {
-	 *   console.log('A mouseup event has occurred on a visible portion of the poi-label layer.');
-	 * });
-	 * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-	 */  | "mouseup"
+ * Fired when a pointing device (usually a mouse) is pressed within the map.
+ *
+ * **Note:** This event is compatible with the optional `layerId` parameter.
+ * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
+ * the cursor is pressed while inside a visible portion of the specifed layer.
+ *
+ * @event mousedown
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('mousedown', function() {
+ *   console.log('A mousedown event has occurred.');
+ * });
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener for a specific layer
+ * map.on('mousedown', 'poi-label', function() {
+ *   console.log('A mousedown event has occurred on a visible portion of the poi-label layer.');
+ * });
+ * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
+ */
+"mousedown"
 /**
-	 * Fired when a pointing device (usually a mouse) is moved within the map.
-	 * As you move the cursor across a web page containing a map,
-	 * the event will fire each time it enters the map or any child elements.
-	 *
-	 * **Note:** This event is compatible with the optional `layerId` parameter.
-	 * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
-	 * the cursor is moved inside a visible portion of the specifed layer.
-	 *
-	 * @event mouseover
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('mouseover', function() {
-	 *   console.log('A mouseover event has occurred.');
-	 * });
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener for a specific layer
-	 * map.on('mouseover', 'poi-label', function() {
-	 *   console.log('A mouseover event has occurred on a visible portion of the poi-label layer.');
-	 * });
-	 * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/mouse-position/)
-	 * @see [Highlight features under the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/hover-styles/)
-	 * @see [Display a popup on hover](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-hover/)
-	 */  | "mouseover"
+ * Fired when a pointing device (usually a mouse) is released within the map.
+ *
+ * **Note:** This event is compatible with the optional `layerId` parameter.
+ * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
+ * the cursor is released while inside a visible portion of the specifed layer.
+ *
+ * @event mouseup
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('mouseup', function() {
+ *   console.log('A mouseup event has occurred.');
+ * });
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener for a specific layer
+ * map.on('mouseup', 'poi-label', function() {
+ *   console.log('A mouseup event has occurred on a visible portion of the poi-label layer.');
+ * });
+ * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
+ */
+ | "mouseup"
 /**
-	 * Fired when a pointing device (usually a mouse) is moved while the cursor is inside the map.
-	 * As you move the cursor across the map, the event will fire every time the cursor changes position within the map.
-	 *
-	 * **Note:** This event is compatible with the optional `layerId` parameter.
-	 * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
-	 * the cursor is inside a visible portion of the specified layer.
-	 *
-	 * @event mousemove
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('mousemove', function() {
-	 *   console.log('A mousemove event has occurred.');
-	 * });
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener for a specific layer
-	 * map.on('mousemove', 'poi-label', function() {
-	 *   console.log('A mousemove event has occurred on a visible portion of the poi-label layer.');
-	 * });
-	 * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/mouse-position/)
-	 * @see [Highlight features under the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/hover-styles/)
-	 * @see [Display a popup on over](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-hover/)
-	 */  | "mousemove"
+ * Fired when a pointing device (usually a mouse) is moved within the map.
+ * As you move the cursor across a web page containing a map,
+ * the event will fire each time it enters the map or any child elements.
+ *
+ * **Note:** This event is compatible with the optional `layerId` parameter.
+ * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
+ * the cursor is moved inside a visible portion of the specifed layer.
+ *
+ * @event mouseover
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('mouseover', function() {
+ *   console.log('A mouseover event has occurred.');
+ * });
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener for a specific layer
+ * map.on('mouseover', 'poi-label', function() {
+ *   console.log('A mouseover event has occurred on a visible portion of the poi-label layer.');
+ * });
+ * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/mouse-position/)
+ * @see [Highlight features under the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/hover-styles/)
+ * @see [Display a popup on hover](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-hover/)
+ */
+ | "mouseover"
 /**
-	 * Fired when a pointing device (usually a mouse) is pressed and released at the same point on the map.
-	 *
-	 * **Note:** This event is compatible with the optional `layerId` parameter.
-	 * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
-	 * point that is pressed and released contains a visible portion of the specifed layer.
-	 *
-	 * @event click
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('click', function(e) {
-	 *   console.log('A click event has occurred at ' + e.lngLat);
-	 * });
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener for a specific layer
-	 * map.on('click', 'poi-label', function(e) {
-	 *   console.log('A click event has occurred on a visible portion of the poi-label layer at ' + e.lngLat);
-	 * });
-	 * @see [Measure distances](https://maplibre.org/maplibre-gl-js-docs/example/measure/)
-	 * @see [Center the map on a clicked symbol](https://maplibre.org/maplibre-gl-js-docs/example/center-on-symbol/)
-	 */  | "click"
+ * Fired when a pointing device (usually a mouse) is moved while the cursor is inside the map.
+ * As you move the cursor across the map, the event will fire every time the cursor changes position within the map.
+ *
+ * **Note:** This event is compatible with the optional `layerId` parameter.
+ * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
+ * the cursor is inside a visible portion of the specified layer.
+ *
+ * @event mousemove
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('mousemove', function() {
+ *   console.log('A mousemove event has occurred.');
+ * });
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener for a specific layer
+ * map.on('mousemove', 'poi-label', function() {
+ *   console.log('A mousemove event has occurred on a visible portion of the poi-label layer.');
+ * });
+ * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/mouse-position/)
+ * @see [Highlight features under the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/hover-styles/)
+ * @see [Display a popup on over](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-hover/)
+ */
+ | "mousemove"
 /**
-	 * Fired when a pointing device (usually a mouse) is pressed and released twice at the same point on
-	 * the map in rapid succession.
-	 *
-	 * **Note:** This event is compatible with the optional `layerId` parameter.
-	 * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only
-	 * when the point that is clicked twice contains a visible portion of the specifed layer.
-	 *
-	 * @event dblclick
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('dblclick', function(e) {
-	 *   console.log('A dblclick event has occurred at ' + e.lngLat);
-	 * });
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener for a specific layer
-	 * map.on('dblclick', 'poi-label', function(e) {
-	 *   console.log('A dblclick event has occurred on a visible portion of the poi-label layer at ' + e.lngLat);
-	 * });
-	 */  | "dblclick"
+ * Fired when a pointing device (usually a mouse) is pressed and released at the same point on the map.
+ *
+ * **Note:** This event is compatible with the optional `layerId` parameter.
+ * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only when the
+ * point that is pressed and released contains a visible portion of the specifed layer.
+ *
+ * @event click
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('click', function(e) {
+ *   console.log('A click event has occurred at ' + e.lngLat);
+ * });
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener for a specific layer
+ * map.on('click', 'poi-label', function(e) {
+ *   console.log('A click event has occurred on a visible portion of the poi-label layer at ' + e.lngLat);
+ * });
+ * @see [Measure distances](https://maplibre.org/maplibre-gl-js-docs/example/measure/)
+ * @see [Center the map on a clicked symbol](https://maplibre.org/maplibre-gl-js-docs/example/center-on-symbol/)
+ */
+ | "click"
 /**
-	 * Fired when a pointing device (usually a mouse) enters a visible portion of a specified layer from
-	 * outside that layer or outside the map canvas.
-	 *
-	 * **Important:** This event can only be listened for when {@link Map#on} includes three arguments,
-	 * where the second argument specifies the desired layer.
-	 *
-	 * @event mouseenter
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener
-	 * map.on('mouseenter', 'water', function() {
-	 *   console.log('A mouseenter event occurred on a visible portion of the water layer.');
-	 * });
-	 * @see [Center the map on a clicked symbol](https://maplibre.org/maplibre-gl-js-docs/example/center-on-symbol/)
-	 * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-click/)
-	 */  | "mouseenter"
+ * Fired when a pointing device (usually a mouse) is pressed and released twice at the same point on
+ * the map in rapid succession.
+ *
+ * **Note:** This event is compatible with the optional `layerId` parameter.
+ * If `layerId` is included as the second argument in {@link Map#on}, the event listener will fire only
+ * when the point that is clicked twice contains a visible portion of the specifed layer.
+ *
+ * @event dblclick
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('dblclick', function(e) {
+ *   console.log('A dblclick event has occurred at ' + e.lngLat);
+ * });
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener for a specific layer
+ * map.on('dblclick', 'poi-label', function(e) {
+ *   console.log('A dblclick event has occurred on a visible portion of the poi-label layer at ' + e.lngLat);
+ * });
+ */
+ | "dblclick"
 /**
-	 * Fired when a pointing device (usually a mouse) leaves a visible portion of a specified layer, or leaves
-	 * the map canvas.
-	 *
-	 * **Important:** This event can only be listened for when {@link Map#on} includes three arguements,
-	 * where the second argument specifies the desired layer.
-	 *
-	 * @event mouseleave
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the pointing device leaves
-	 * // a visible portion of the specified layer.
-	 * map.on('mouseleave', 'water', function() {
-	 *   console.log('A mouseleave event occurred.');
-	 * });
-	 * @see [Highlight features under the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/hover-styles/)
-	 * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-click/)
-	 */  | "mouseleave"
+ * Fired when a pointing device (usually a mouse) enters a visible portion of a specified layer from
+ * outside that layer or outside the map canvas.
+ *
+ * **Important:** This event can only be listened for when {@link Map#on} includes three arguments,
+ * where the second argument specifies the desired layer.
+ *
+ * @event mouseenter
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener
+ * map.on('mouseenter', 'water', function() {
+ *   console.log('A mouseenter event occurred on a visible portion of the water layer.');
+ * });
+ * @see [Center the map on a clicked symbol](https://maplibre.org/maplibre-gl-js-docs/example/center-on-symbol/)
+ * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-click/)
+ */
+ | "mouseenter"
 /**
-	 * Fired when a point device (usually a mouse) leaves the map's canvas.
-	 *
-	 * @event mouseout
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the pointing device leave's
-	 * // the map's canvas.
-	 * map.on('mouseout', function() {
-	 *   console.log('A mouseout event occurred.');
-	 * });
-	 */  | "mouseout"
+ * Fired when a pointing device (usually a mouse) leaves a visible portion of a specified layer, or leaves
+ * the map canvas.
+ *
+ * **Important:** This event can only be listened for when {@link Map#on} includes three arguements,
+ * where the second argument specifies the desired layer.
+ *
+ * @event mouseleave
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the pointing device leaves
+ * // a visible portion of the specified layer.
+ * map.on('mouseleave', 'water', function() {
+ *   console.log('A mouseleave event occurred.');
+ * });
+ * @see [Highlight features under the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/hover-styles/)
+ * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js-docs/example/popup-on-click/)
+ */
+ | "mouseleave"
 /**
-	 * Fired when the right button of the mouse is clicked or the context menu key is pressed within the map.
-	 *
-	 * @event contextmenu
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the right mouse button is
-	 * // pressed within the map.
-	 * map.on('contextmenu', function() {
-	 *   console.log('A contextmenu event occurred.');
-	 * });
-	 */  | "contextmenu"
+ * Fired when a point device (usually a mouse) leaves the map's canvas.
+ *
+ * @event mouseout
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the pointing device leave's
+ * // the map's canvas.
+ * map.on('mouseout', function() {
+ *   console.log('A mouseout event occurred.');
+ * });
+ */
+ | "mouseout"
 /**
-	 * Fired when a [`wheel`](https://developer.mozilla.org/en-US/docs/Web/Events/wheel) event occurs within the map.
-	 *
-	 * @event wheel
-	 * @memberof Map
-	 * @instance
-	 * @property {MapWheelEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a wheel event occurs within the map.
-	 * map.on('wheel', function() {
-	 *   console.log('A wheel event occurred.');
-	 * });
-	 */  | "wheel"
+ * Fired when the right button of the mouse is clicked or the context menu key is pressed within the map.
+ *
+ * @event contextmenu
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the right mouse button is
+ * // pressed within the map.
+ * map.on('contextmenu', function() {
+ *   console.log('A contextmenu event occurred.');
+ * });
+ */
+ | "contextmenu"
 /**
-	 * Fired when a [`touchstart`](https://developer.mozilla.org/en-US/docs/Web/Events/touchstart) event occurs within the map.
-	 *
-	 * @event touchstart
-	 * @memberof Map
-	 * @instance
-	 * @property {MapTouchEvent} data
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a touchstart event occurs within the map.
-	 * map.on('touchstart', function() {
-	 *   console.log('A touchstart event occurred.');
-	 * });
-	 * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-	 */  | "touchstart"
+ * Fired when a [`wheel`](https://developer.mozilla.org/en-US/docs/Web/Events/wheel) event occurs within the map.
+ *
+ * @event wheel
+ * @memberof Map
+ * @instance
+ * @property {MapWheelEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a wheel event occurs within the map.
+ * map.on('wheel', function() {
+ *   console.log('A wheel event occurred.');
+ * });
+ */
+ | "wheel"
 /**
-	 * Fired when a [`touchend`](https://developer.mozilla.org/en-US/docs/Web/Events/touchend) event occurs within the map.
-	 *
-	 * @event touchend
-	 * @memberof Map
-	 * @instance
-	 * @property {MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a touchstart event occurs within the map.
-	 * map.on('touchstart', function() {
-	 *   console.log('A touchstart event occurred.');
-	 * });
-	 * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-	 */  | "touchend"
+ * Fired when a [`touchstart`](https://developer.mozilla.org/en-US/docs/Web/Events/touchstart) event occurs within the map.
+ *
+ * @event touchstart
+ * @memberof Map
+ * @instance
+ * @property {MapTouchEvent} data
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a touchstart event occurs within the map.
+ * map.on('touchstart', function() {
+ *   console.log('A touchstart event occurred.');
+ * });
+ * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
+ */
+ | "touchstart"
 /**
-	 * Fired when a [`touchmove`](https://developer.mozilla.org/en-US/docs/Web/Events/touchmove) event occurs within the map.
-	 *
-	 * @event touchmove
-	 * @memberof Map
-	 * @instance
-	 * @property {MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a touchmove event occurs within the map.
-	 * map.on('touchmove', function() {
-	 *   console.log('A touchmove event occurred.');
-	 * });
-	 * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-	 */  | "touchmove"
+ * Fired when a [`touchend`](https://developer.mozilla.org/en-US/docs/Web/Events/touchend) event occurs within the map.
+ *
+ * @event touchend
+ * @memberof Map
+ * @instance
+ * @property {MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a touchstart event occurs within the map.
+ * map.on('touchstart', function() {
+ *   console.log('A touchstart event occurred.');
+ * });
+ * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
+ */
+ | "touchend"
 /**
-	 * Fired when a [`touchcancel`](https://developer.mozilla.org/en-US/docs/Web/Events/touchcancel) event occurs within the map.
-	 *
-	 * @event touchcancel
-	 * @memberof Map
-	 * @instance
-	 * @property {MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a touchcancel event occurs within the map.
-	 * map.on('touchcancel', function() {
-	 *   console.log('A touchcancel event occurred.');
-	 * });
-	 */  | "touchcancel"
+ * Fired when a [`touchmove`](https://developer.mozilla.org/en-US/docs/Web/Events/touchmove) event occurs within the map.
+ *
+ * @event touchmove
+ * @memberof Map
+ * @instance
+ * @property {MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a touchmove event occurs within the map.
+ * map.on('touchmove', function() {
+ *   console.log('A touchmove event occurred.');
+ * });
+ * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
+ */
+ | "touchmove"
 /**
-	 * Fired just before the map begins a transition from one
-	 * view to another, as the result of either user interaction or methods such as {@link Map#jumpTo}.
-	 *
-	 * @event movestart
-	 * @memberof Map
-	 * @instance
-	 * @property {{originalEvent: DragEvent}} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just before the map begins a transition
-	 * // from one view to another.
-	 * map.on('movestart', function() {
-	 *   console.log('A movestart` event occurred.');
-	 * });
-	 */  | "movestart"
+ * Fired when a [`touchcancel`](https://developer.mozilla.org/en-US/docs/Web/Events/touchcancel) event occurs within the map.
+ *
+ * @event touchcancel
+ * @memberof Map
+ * @instance
+ * @property {MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a touchcancel event occurs within the map.
+ * map.on('touchcancel', function() {
+ *   console.log('A touchcancel event occurred.');
+ * });
+ */
+ | "touchcancel"
 /**
-	 * Fired repeatedly during an animated transition from one view to
-	 * another, as the result of either user interaction or methods such as {@link Map#flyTo}.
-	 *
-	 * @event move
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // repeatedly during an animated transition.
-	 * map.on('move', function() {
-	 *   console.log('A move event occurred.');
-	 * });
-	 * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
-	 */  | "move"
+ * Fired just before the map begins a transition from one
+ * view to another, as the result of either user interaction or methods such as {@link Map#jumpTo}.
+ *
+ * @event movestart
+ * @memberof Map
+ * @instance
+ * @property {{originalEvent: DragEvent}} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just before the map begins a transition
+ * // from one view to another.
+ * map.on('movestart', function() {
+ *   console.log('A movestart` event occurred.');
+ * });
+ */
+ | "movestart"
 /**
-	 * Fired just after the map completes a transition from one
-	 * view to another, as the result of either user interaction or methods such as {@link Map#jumpTo}.
-	 *
-	 * @event moveend
-	 * @memberof Map
-	 * @instance
-	 * @property {{originalEvent: DragEvent}} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just after the map completes a transition.
-	 * map.on('moveend', function() {
-	 *   console.log('A moveend event occurred.');
-	 * });
-	 * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
-	 */  | "moveend"
+ * Fired repeatedly during an animated transition from one view to
+ * another, as the result of either user interaction or methods such as {@link Map#flyTo}.
+ *
+ * @event move
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // repeatedly during an animated transition.
+ * map.on('move', function() {
+ *   console.log('A move event occurred.');
+ * });
+ * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
+ */
+ | "move"
 /**
-	 * Fired when a "drag to pan" interaction starts. See {@link DragPanHandler}.
-	 *
-	 * @event dragstart
-	 * @memberof Map
-	 * @instance
-	 * @property {{originalEvent: DragEvent}} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a "drag to pan" interaction starts.
-	 * map.on('dragstart', function() {
-	 *   console.log('A dragstart event occurred.');
-	 * });
-	 */  | "dragstart"
+ * Fired just after the map completes a transition from one
+ * view to another, as the result of either user interaction or methods such as {@link Map#jumpTo}.
+ *
+ * @event moveend
+ * @memberof Map
+ * @instance
+ * @property {{originalEvent: DragEvent}} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just after the map completes a transition.
+ * map.on('moveend', function() {
+ *   console.log('A moveend event occurred.');
+ * });
+ * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
+ */
+ | "moveend"
 /**
-	 * Fired repeatedly during a "drag to pan" interaction. See {@link DragPanHandler}.
-	 *
-	 * @event drag
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // repeatedly  during a "drag to pan" interaction.
-	 * map.on('drag', function() {
-	 *   console.log('A drag event occurred.');
-	 * });
-	 */  | "drag"
+ * Fired when a "drag to pan" interaction starts. See {@link DragPanHandler}.
+ *
+ * @event dragstart
+ * @memberof Map
+ * @instance
+ * @property {{originalEvent: DragEvent}} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a "drag to pan" interaction starts.
+ * map.on('dragstart', function() {
+ *   console.log('A dragstart event occurred.');
+ * });
+ */
+ | "dragstart"
 /**
-	 * Fired when a "drag to pan" interaction ends. See {@link DragPanHandler}.
-	 *
-	 * @event dragend
-	 * @memberof Map
-	 * @instance
-	 * @property {{originalEvent: DragEvent}} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when a "drag to pan" interaction ends.
-	 * map.on('dragend', function() {
-	 *   console.log('A dragend event occurred.');
-	 * });
-	 * @see [Create a draggable marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
-	 */  | "dragend"
+ * Fired repeatedly during a "drag to pan" interaction. See {@link DragPanHandler}.
+ *
+ * @event drag
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // repeatedly  during a "drag to pan" interaction.
+ * map.on('drag', function() {
+ *   console.log('A drag event occurred.');
+ * });
+ */
+ | "drag"
 /**
-	 * Fired just before the map begins a transition from one zoom level to another,
-	 * as the result of either user interaction or methods such as {@link Map#flyTo}.
-	 *
-	 * @event zoomstart
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just before a zoom transition starts.
-	 * map.on('zoomstart', function() {
-	 *   console.log('A zoomstart event occurred.');
-	 * });
-	 */  | "zoomstart"
+ * Fired when a "drag to pan" interaction ends. See {@link DragPanHandler}.
+ *
+ * @event dragend
+ * @memberof Map
+ * @instance
+ * @property {{originalEvent: DragEvent}} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a "drag to pan" interaction ends.
+ * map.on('dragend', function() {
+ *   console.log('A dragend event occurred.');
+ * });
+ * @see [Create a draggable marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
+ */
+ | "dragend"
 /**
-	 * Fired repeatedly during an animated transition from one zoom level to another,
-	 * as the result of either user interaction or methods such as {@link Map#flyTo}.
-	 *
-	 * @event zoom
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // repeatedly during a zoom transition.
-	 * map.on('zoom', function() {
-	 *   console.log('A zoom event occurred.');
-	 * });
-	 */  | "zoom"
+ * Fired just before the map begins a transition from one zoom level to another,
+ * as the result of either user interaction or methods such as {@link Map#flyTo}.
+ *
+ * @event zoomstart
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just before a zoom transition starts.
+ * map.on('zoomstart', function() {
+ *   console.log('A zoomstart event occurred.');
+ * });
+ */
+ | "zoomstart"
 /**
-	 * Fired just after the map completes a transition from one zoom level to another,
-	 * as the result of either user interaction or methods such as {@link Map#flyTo}.
-	 *
-	 * @event zoomend
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just after a zoom transition finishes.
-	 * map.on('zoomend', function() {
-	 *   console.log('A zoomend event occurred.');
-	 * });
-	 */  | "zoomend"
+ * Fired repeatedly during an animated transition from one zoom level to another,
+ * as the result of either user interaction or methods such as {@link Map#flyTo}.
+ *
+ * @event zoom
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // repeatedly during a zoom transition.
+ * map.on('zoom', function() {
+ *   console.log('A zoom event occurred.');
+ * });
+ */
+ | "zoom"
 /**
-	 * Fired when a "drag to rotate" interaction starts. See {@link DragRotateHandler}.
-	 *
-	 * @event rotatestart
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just before a "drag to rotate" interaction starts.
-	 * map.on('rotatestart', function() {
-	 *   console.log('A rotatestart event occurred.');
-	 * });
-	 */  | "rotatestart"
+ * Fired just after the map completes a transition from one zoom level to another,
+ * as the result of either user interaction or methods such as {@link Map#flyTo}.
+ *
+ * @event zoomend
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just after a zoom transition finishes.
+ * map.on('zoomend', function() {
+ *   console.log('A zoomend event occurred.');
+ * });
+ */
+ | "zoomend"
 /**
-	 * Fired repeatedly during a "drag to rotate" interaction. See {@link DragRotateHandler}.
-	 *
-	 * @event rotate
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // repeatedly during "drag to rotate" interaction.
-	 * map.on('rotate', function() {
-	 *   console.log('A rotate event occurred.');
-	 * });
-	 */  | "rotate"
+ * Fired when a "drag to rotate" interaction starts. See {@link DragRotateHandler}.
+ *
+ * @event rotatestart
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just before a "drag to rotate" interaction starts.
+ * map.on('rotatestart', function() {
+ *   console.log('A rotatestart event occurred.');
+ * });
+ */
+ | "rotatestart"
 /**
-	 * Fired when a "drag to rotate" interaction ends. See {@link DragRotateHandler}.
-	 *
-	 * @event rotateend
-	 * @memberof Map
-	 * @instance
-	 * @property {MapMouseEvent | MapTouchEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just after a "drag to rotate" interaction ends.
-	 * map.on('rotateend', function() {
-	 *   console.log('A rotateend event occurred.');
-	 * });
-	 */  | "rotateend"
+ * Fired repeatedly during a "drag to rotate" interaction. See {@link DragRotateHandler}.
+ *
+ * @event rotate
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // repeatedly during "drag to rotate" interaction.
+ * map.on('rotate', function() {
+ *   console.log('A rotate event occurred.');
+ * });
+ */
+ | "rotate"
 /**
-	 * Fired whenever the map's pitch (tilt) begins a change as
-	 * the result of either user interaction or methods such as {@link Map#flyTo} .
-	 *
-	 * @event pitchstart
-	 * @memberof Map
-	 * @instance
-	 * @property {MapEventData} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just before a pitch (tilt) transition starts.
-	 * map.on('pitchstart', function() {
-	 *   console.log('A pitchstart event occurred.');
-	 * });
-	 */  | "pitchstart"
+ * Fired when a "drag to rotate" interaction ends. See {@link DragRotateHandler}.
+ *
+ * @event rotateend
+ * @memberof Map
+ * @instance
+ * @property {MapMouseEvent | MapTouchEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just after a "drag to rotate" interaction ends.
+ * map.on('rotateend', function() {
+ *   console.log('A rotateend event occurred.');
+ * });
+ */
+ | "rotateend"
 /**
-	 * Fired repeatedly during the map's pitch (tilt) animation between
-	 * one state and another as the result of either user interaction
-	 * or methods such as {@link Map#flyTo}.
-	 *
-	 * @event pitch
-	 * @memberof Map
-	 * @instance
-	 * @property {MapEventData} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // repeatedly during a pitch (tilt) transition.
-	 * map.on('pitch', function() {
-	 *   console.log('A pitch event occurred.');
-	 * });
-	 */  | "pitch"
+ * Fired whenever the map's pitch (tilt) begins a change as
+ * the result of either user interaction or methods such as {@link Map#flyTo} .
+ *
+ * @event pitchstart
+ * @memberof Map
+ * @instance
+ * @property {MapEventData} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just before a pitch (tilt) transition starts.
+ * map.on('pitchstart', function() {
+ *   console.log('A pitchstart event occurred.');
+ * });
+ */
+ | "pitchstart"
 /**
-	 * Fired immediately after the map's pitch (tilt) finishes changing as
-	 * the result of either user interaction or methods such as {@link Map#flyTo}.
-	 *
-	 * @event pitchend
-	 * @memberof Map
-	 * @instance
-	 * @property {MapEventData} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just after a pitch (tilt) transition ends.
-	 * map.on('pitchend', function() {
-	 *   console.log('A pitchend event occurred.');
-	 * });
-	 */  | "pitchend"
+ * Fired repeatedly during the map's pitch (tilt) animation between
+ * one state and another as the result of either user interaction
+ * or methods such as {@link Map#flyTo}.
+ *
+ * @event pitch
+ * @memberof Map
+ * @instance
+ * @property {MapEventData} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // repeatedly during a pitch (tilt) transition.
+ * map.on('pitch', function() {
+ *   console.log('A pitch event occurred.');
+ * });
+ */
+ | "pitch"
 /**
-	 * Fired when a "box zoom" interaction starts. See {@link BoxZoomHandler}.
-	 *
-	 * @event boxzoomstart
-	 * @memberof Map
-	 * @instance
-	 * @property {MapLibreZoomEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just before a "box zoom" interaction starts.
-	 * map.on('boxzoomstart', function() {
-	 *   console.log('A boxzoomstart event occurred.');
-	 * });
-	 */  | "boxzoomstart"
+ * Fired immediately after the map's pitch (tilt) finishes changing as
+ * the result of either user interaction or methods such as {@link Map#flyTo}.
+ *
+ * @event pitchend
+ * @memberof Map
+ * @instance
+ * @property {MapEventData} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just after a pitch (tilt) transition ends.
+ * map.on('pitchend', function() {
+ *   console.log('A pitchend event occurred.');
+ * });
+ */
+ | "pitchend"
 /**
-	 * Fired when a "box zoom" interaction ends.  See {@link BoxZoomHandler}.
-	 *
-	 * @event boxzoomend
-	 * @memberof Map
-	 * @instance
-	 * @type {Object}
-	 * @property {MapLibreZoomEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just after a "box zoom" interaction ends.
-	 * map.on('boxzoomend', function() {
-	 *   console.log('A boxzoomend event occurred.');
-	 * });
-	 */  | "boxzoomend"
+ * Fired when a "box zoom" interaction starts. See {@link BoxZoomHandler}.
+ *
+ * @event boxzoomstart
+ * @memberof Map
+ * @instance
+ * @property {MapLibreZoomEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just before a "box zoom" interaction starts.
+ * map.on('boxzoomstart', function() {
+ *   console.log('A boxzoomstart event occurred.');
+ * });
+ */
+ | "boxzoomstart"
 /**
-	 * Fired when the user cancels a "box zoom" interaction, or when the bounding box does not meet the minimum size threshold.
-	 * See {@link BoxZoomHandler}.
-	 *
-	 * @event boxzoomcancel
-	 * @memberof Map
-	 * @instance
-	 * @property {MapLibreZoomEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // the user cancels a "box zoom" interaction.
-	 * map.on('boxzoomcancel', function() {
-	 *   console.log('A boxzoomcancel event occurred.');
-	 * });
-	 */  | "boxzoomcancel"
+ * Fired when a "box zoom" interaction ends.  See {@link BoxZoomHandler}.
+ *
+ * @event boxzoomend
+ * @memberof Map
+ * @instance
+ * @type {Object}
+ * @property {MapLibreZoomEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just after a "box zoom" interaction ends.
+ * map.on('boxzoomend', function() {
+ *   console.log('A boxzoomend event occurred.');
+ * });
+ */
+ | "boxzoomend"
 /**
-	 * Fired immediately after the map has been resized.
-	 *
-	 * @event resize
-	 * @memberof Map
-	 * @instance
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // immediately after the map has been resized.
-	 * map.on('resize', function() {
-	 *   console.log('A resize event occurred.');
-	 * });
-	 */  | "resize"
+ * Fired when the user cancels a "box zoom" interaction, or when the bounding box does not meet the minimum size threshold.
+ * See {@link BoxZoomHandler}.
+ *
+ * @event boxzoomcancel
+ * @memberof Map
+ * @instance
+ * @property {MapLibreZoomEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // the user cancels a "box zoom" interaction.
+ * map.on('boxzoomcancel', function() {
+ *   console.log('A boxzoomcancel event occurred.');
+ * });
+ */
+ | "boxzoomcancel"
 /**
-	 * Fired when the WebGL context is lost.
-	 *
-	 * @event webglcontextlost
-	 * @memberof Map
-	 * @instance
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the WebGL context is lost.
-	 * map.on('webglcontextlost', function() {
-	 *   console.log('A webglcontextlost event occurred.');
-	 * });
-	 */  | "webglcontextlost"
+ * Fired immediately after the map has been resized.
+ *
+ * @event resize
+ * @memberof Map
+ * @instance
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // immediately after the map has been resized.
+ * map.on('resize', function() {
+ *   console.log('A resize event occurred.');
+ * });
+ */
+ | "resize"
 /**
-	 * Fired when the WebGL context is restored.
-	 *
-	 * @event webglcontextrestored
-	 * @memberof Map
-	 * @instance
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the WebGL context is restored.
-	 * map.on('webglcontextrestored', function() {
-	 *   console.log('A webglcontextrestored event occurred.');
-	 * });
-	 */  | "webglcontextrestored"
+ * Fired when the WebGL context is lost.
+ *
+ * @event webglcontextlost
+ * @memberof Map
+ * @instance
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the WebGL context is lost.
+ * map.on('webglcontextlost', function() {
+ *   console.log('A webglcontextlost event occurred.');
+ * });
+ */
+ | "webglcontextlost"
+/**
+ * Fired when the WebGL context is restored.
+ *
+ * @event webglcontextrestored
+ * @memberof Map
+ * @instance
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the WebGL context is restored.
+ * map.on('webglcontextrestored', function() {
+ *   console.log('A webglcontextrestored event occurred.');
+ * });
+ */
+ | "webglcontextrestored"
+/**
+ * Fired immediately after all necessary resources have been downloaded
+ * and the first visually complete rendering of the map has occurred.
+ *
+ * @event load
+ * @memberof Map
+ * @instance
+ * @type {Object}
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the map has finished loading.
+ * map.on('load', function() {
+ *   console.log('A load event occurred.');
+ * });
+ * @see [Draw GeoJSON points](https://maplibre.org/maplibre-gl-js-docs/example/geojson-markers/)
+ * @see [Add live realtime data](https://maplibre.org/maplibre-gl-js-docs/example/live-geojson/)
+ * @see [Animate a point](https://maplibre.org/maplibre-gl-js-docs/example/animate-point-along-line/)
+ */
+ | "load"
+/**
+ * Fired whenever the map is drawn to the screen, as the result of
+ *
+ * - a change to the map's position, zoom, pitch, or bearing
+ * - a change to the map's style
+ * - a change to a GeoJSON source
+ * - the loading of a vector tile, GeoJSON file, glyph, or sprite
+ *
+ * @event render
+ * @memberof Map
+ * @instance
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // whenever the map is drawn to the screen.
+ * map.on('render', function() {
+ *   console.log('A render event occurred.');
+ * });
+ */
+ | "render"
+/**
+ * Fired after the last frame rendered before the map enters an
+ * "idle" state:
+ *
+ * - No camera transitions are in progress
+ * - All currently requested tiles have loaded
+ * - All fade/transition animations have completed
+ *
+ * @event idle
+ * @memberof Map
+ * @instance
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just before the map enters an "idle" state.
+ * map.on('idle', function() {
+ *   console.log('A idle event occurred.');
+ * });
+ */
+ | "idle"
+/**
+ * Fired immediately after the map has been removed with {@link Map.event:remove}.
+ *
+ * @event remove
+ * @memberof Map
+ * @instance
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // just after the map is removed.
+ * map.on('remove', function() {
+ *   console.log('A remove event occurred.');
+ * });
+ */
+ | "remove"
+/**
+ * Fired when an error occurs. This is GL JS's primary error reporting
+ * mechanism. We use an event instead of `throw` to better accommodate
+ * asyncronous operations. If no listeners are bound to the `error` event, the
+ * error will be printed to the console.
+ *
+ * @event error
+ * @memberof Map
+ * @instance
+ * @property {{error: {message: string}}} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when an error occurs.
+ * map.on('error', function() {
+ *   console.log('A error event occurred.');
+ * });
+ */
+ | "error"
+/**
+ * Fired when any map data loads or changes. See {@link MapDataEvent}
+ * for more information.
+ *
+ * @event data
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when map data loads or changes.
+ * map.on('data', function() {
+ *   console.log('A data event occurred.');
+ * });
+ * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
+ */
+ | "data"
+/**
+ * Fired when the map's style loads or changes. See
+ * {@link MapDataEvent} for more information.
+ *
+ * @event styledata
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when the map's style loads or changes.
+ * map.on('styledata', function() {
+ *   console.log('A styledata event occurred.');
+ * });
+ */
+ | "styledata"
+/**
+ * Fired when one of the map's sources loads or changes, including if a tile belonging
+ * to a source loads or changes. See {@link MapDataEvent} for more information.
+ *
+ * @event sourcedata
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when one of the map's sources loads or changes.
+ * map.on('sourcedata', function() {
+ *   console.log('A sourcedata event occurred.');
+ * });
+ */
+ | "sourcedata"
+/**
+ * Fired when any map data (style, source, tile, etc) begins loading or
+ * changing asyncronously. All `dataloading` events are followed by a `data`,
+ * `dataabort` or `error` event. See {@link MapDataEvent} for more information.
+ *
+ * @event dataloading
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when any map data begins loading
+ * // or changing asynchronously.
+ * map.on('dataloading', function() {
+ *   console.log('A dataloading event occurred.');
+ * });
+ */
+ | "dataloading"
+/**
+ * Fired when the map's style begins loading or changing asyncronously.
+ * All `styledataloading` events are followed by a `styledata`
+ * or `error` event. See {@link MapDataEvent} for more information.
+ *
+ * @event styledataloading
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // map's style begins loading or
+ * // changing asyncronously.
+ * map.on('styledataloading', function() {
+ *   console.log('A styledataloading event occurred.');
+ * });
+ */
+ | "styledataloading"
+/**
+ * Fired when one of the map's sources begins loading or changing asyncronously.
+ * All `sourcedataloading` events are followed by a `sourcedata`, `sourcedataabort` or `error` event.
+ * See {@link MapDataEvent} for more information.
+ *
+ * @event sourcedataloading
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // map's sources begin loading or
+ * // changing asyncronously.
+ * map.on('sourcedataloading', function() {
+ *   console.log('A sourcedataloading event occurred.');
+ * });
+ */
+ | "sourcedataloading"
+/**
+ * Fired when an icon or pattern needed by the style is missing. The missing image can
+ * be added with {@link Map#addImage} within this event listener callback to prevent the image from
+ * being skipped. This event can be used to dynamically generate icons and patterns.
+ *
+ * @event styleimagemissing
+ * @memberof Map
+ * @instance
+ * @property {string} id The id of the missing image.
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // an icon or pattern is missing.
+ * map.on('styleimagemissing', function() {
+ *   console.log('A styleimagemissing event occurred.');
+ * });
+ * @see [Generate and add a missing icon to the map](https://maplibre.org/maplibre-gl-js-docs/example/add-image-missing-generated/)
+ */
+ | "styleimagemissing"
+/**
+ * @event style.load
+ * @memberof Map
+ * @instance
+ * @private
+ */
+ | "style.load"
 /**
-	 * Fired immediately after all necessary resources have been downloaded
-	 * and the first visually complete rendering of the map has occurred.
-	 *
-	 * @event load
-	 * @memberof Map
-	 * @instance
-	 * @type {Object}
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the map has finished loading.
-	 * map.on('load', function() {
-	 *   console.log('A load event occurred.');
-	 * });
-	 * @see [Draw GeoJSON points](https://maplibre.org/maplibre-gl-js-docs/example/geojson-markers/)
-	 * @see [Add live realtime data](https://maplibre.org/maplibre-gl-js-docs/example/live-geojson/)
-	 * @see [Animate a point](https://maplibre.org/maplibre-gl-js-docs/example/animate-point-along-line/)
-	 */  | "load"
+ * Fired when a request for one of the map's sources' tiles is aborted.
+ * See {@link MapDataEvent} for more information.
+ *
+ * @event dataabort
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a request for one of the map's sources' tiles is aborted.
+ * map.on('dataabort', function() {
+ *   console.log('A dataabort event occurred.');
+ * });
+ */
+ | "dataabort"
 /**
-	 * Fired whenever the map is drawn to the screen, as the result of
-	 *
-	 * - a change to the map's position, zoom, pitch, or bearing
-	 * - a change to the map's style
-	 * - a change to a GeoJSON source
-	 * - the loading of a vector tile, GeoJSON file, glyph, or sprite
+ * Fired when a request for one of the map's sources' tiles is aborted.
+ * See {@link MapDataEvent} for more information.
+ *
+ * @event sourcedataabort
+ * @memberof Map
+ * @instance
+ * @property {MapDataEvent} data
+ * @example
+ * // Initialize the map
+ * var map = new maplibregl.Map({ // map options });
+ * // Set an event listener that fires
+ * // when a request for one of the map's sources' tiles is aborted.
+ * map.on('sourcedataabort', function() {
+ *   console.log('A sourcedataabort event occurred.');
+ * });
+ */
+ | "sourcedataabort";
+export declare type GeoJSONSourceOptions = GeoJSONSourceSpecification & {
+	workerOptions?: any;
+	collectResourceTiming: boolean;
+};
+export declare class GeoJSONSource extends Evented implements Source {
+	type: "geojson";
+	id: string;
+	minzoom: number;
+	maxzoom: number;
+	tileSize: number;
+	attribution: string;
+	promoteId: PromoteIdSpecification;
+	isTileClipped: boolean;
+	reparseOverscaled: boolean;
+	_data: GeoJSON.GeoJSON | string;
+	_options: any;
+	workerOptions: any;
+	map: Map;
+	actor: Actor;
+	_pendingLoads: number;
+	_collectResourceTiming: boolean;
+	_removed: boolean;
+	/**
+	 * @private
+	 */
+	constructor(id: string, options: GeoJSONSourceOptions, dispatcher: Dispatcher, eventedParent: Evented);
+	load(): void;
+	onAdd(map: Map): void;
+	/**
+	 * Sets the GeoJSON data and re-renders the map.
 	 *
-	 * @event render
-	 * @memberof Map
-	 * @instance
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // whenever the map is drawn to the screen.
-	 * map.on('render', function() {
-	 *   console.log('A render event occurred.');
-	 * });
-	 */  | "render"
-/**
-	 * Fired after the last frame rendered before the map enters an
-	 * "idle" state:
+	 * @param {Object|string} data A GeoJSON data object or a URL to one. The latter is preferable in the case of large GeoJSON files.
+	 * @returns {GeoJSONSource} this
+	 */
+	setData(data: GeoJSON.GeoJSON | string): this;
+	/**
+	 * For clustered sources, fetches the zoom at which the given cluster expands.
 	 *
-	 * - No camera transitions are in progress
-	 * - All currently requested tiles have loaded
-	 * - All fade/transition animations have completed
+	 * @param clusterId The value of the cluster's `cluster_id` property.
+	 * @param callback A callback to be called when the zoom value is retrieved (`(error, zoom) => { ... }`).
+	 * @returns {GeoJSONSource} this
+	 */
+	getClusterExpansionZoom(clusterId: number, callback: Callback<number>): this;
+	/**
+	 * For clustered sources, fetches the children of the given cluster on the next zoom level (as an array of GeoJSON features).
 	 *
-	 * @event idle
-	 * @memberof Map
-	 * @instance
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just before the map enters an "idle" state.
-	 * map.on('idle', function() {
-	 *   console.log('A idle event occurred.');
-	 * });
-	 */  | "idle"
-/**
-	 * Fired immediately after the map has been removed with {@link Map.event:remove}.
+	 * @param clusterId The value of the cluster's `cluster_id` property.
+	 * @param callback A callback to be called when the features are retrieved (`(error, features) => { ... }`).
+	 * @returns {GeoJSONSource} this
+	 */
+	getClusterChildren(clusterId: number, callback: Callback<Array<GeoJSON.Feature>>): this;
+	/**
+	 * For clustered sources, fetches the original points that belong to the cluster (as an array of GeoJSON features).
 	 *
-	 * @event remove
-	 * @memberof Map
-	 * @instance
+	 * @param clusterId The value of the cluster's `cluster_id` property.
+	 * @param limit The maximum number of features to return.
+	 * @param offset The number of features to skip (e.g. for pagination).
+	 * @param callback A callback to be called when the features are retrieved (`(error, features) => { ... }`).
+	 * @returns {GeoJSONSource} this
 	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // just after the map is removed.
-	 * map.on('remove', function() {
-	 *   console.log('A remove event occurred.');
-	 * });
-	 */  | "remove"
-/**
-	 * Fired when an error occurs. This is GL JS's primary error reporting
-	 * mechanism. We use an event instead of `throw` to better accommodate
-	 * asyncronous operations. If no listeners are bound to the `error` event, the
-	 * error will be printed to the console.
-	 *
-	 * @event error
-	 * @memberof Map
-	 * @instance
-	 * @property {{error: {message: string}}} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when an error occurs.
-	 * map.on('error', function() {
-	 *   console.log('A error event occurred.');
-	 * });
-	 */  | "error"
-/**
-	 * Fired when any map data loads or changes. See {@link MapDataEvent}
-	 * for more information.
+	 * // Retrieve cluster leaves on click
+	 * map.on('click', 'clusters', function(e) {
+	 *   var features = map.queryRenderedFeatures(e.point, {
+	 *     layers: ['clusters']
+	 *   });
 	 *
-	 * @event data
-	 * @memberof Map
-	 * @instance
-	 * @property {MapDataEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when map data loads or changes.
-	 * map.on('data', function() {
-	 *   console.log('A data event occurred.');
-	 * });
-	 * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
-	 */  | "data"
-/**
-	 * Fired when the map's style loads or changes. See
-	 * {@link MapDataEvent} for more information.
+	 *   var clusterId = features[0].properties.cluster_id;
+	 *   var pointCount = features[0].properties.point_count;
+	 *   var clusterSource = map.getSource('clusters');
 	 *
-	 * @event styledata
-	 * @memberof Map
-	 * @instance
-	 * @property {MapDataEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when the map's style loads or changes.
-	 * map.on('styledata', function() {
-	 *   console.log('A styledata event occurred.');
+	 *   clusterSource.getClusterLeaves(clusterId, pointCount, 0, function(error, features) {
+	 *     // Print cluster leaves in the console
+	 *     console.log('Cluster leaves:', error, features);
+	 *   })
 	 * });
-	 */  | "styledata"
-/**
-	 * Fired when one of the map's sources loads or changes, including if a tile belonging
-	 * to a source loads or changes. See {@link MapDataEvent} for more information.
-	 *
-	 * @event sourcedata
-	 * @memberof Map
+	 */
+	getClusterLeaves(clusterId: number, limit: number, offset: number, callback: Callback<Array<GeoJSON.Feature>>): this;
+	_updateWorkerData(sourceDataType: MapSourceDataType): void;
+	loaded(): boolean;
+	loadTile(tile: Tile, callback: Callback<void>): void;
+	abortTile(tile: Tile): void;
+	unloadTile(tile: Tile): void;
+	onRemove(): void;
+	serialize(): any;
+	hasTransition(): boolean;
+}
+export declare type CanvasSourceSpecification = {
+	"type": "canvas";
+	"coordinates": [
+		[
+			number,
+			number
+		],
+		[
+			number,
+			number
+		],
+		[
+			number,
+			number
+		],
+		[
+			number,
+			number
+		]
+	];
+	"animate"?: boolean;
+	"canvas": string | HTMLCanvasElement;
+};
+export declare class CanvasSource extends ImageSource {
+	options: CanvasSourceSpecification;
+	animate: boolean;
+	canvas: HTMLCanvasElement;
+	width: number;
+	height: number;
+	play: () => void;
+	pause: () => void;
+	_playing: boolean;
+	/**
+	 * @private
+	 */
+	constructor(id: string, options: CanvasSourceSpecification, dispatcher: Dispatcher, eventedParent: Evented);
+	/**
+	 * Enables animation. The image will be copied from the canvas to the map on each frame.
+	 * @method play
 	 * @instance
-	 * @property {MapDataEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when one of the map's sources loads or changes.
-	 * map.on('sourcedata', function() {
-	 *   console.log('A sourcedata event occurred.');
-	 * });
-	 */  | "sourcedata"
-/**
-	 * Fired when any map data (style, source, tile, etc) begins loading or
-	 * changing asyncronously. All `dataloading` events are followed by a `data`
-	 * or `error` event. See {@link MapDataEvent} for more information.
-	 *
-	 * @event dataloading
-	 * @memberof Map
+	 * @memberof CanvasSource
+	 */
+	/**
+	 * Disables animation. The map will display a static copy of the canvas image.
+	 * @method pause
 	 * @instance
-	 * @property {MapDataEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // when any map data begins loading
-	 * // or changing asynchronously.
-	 * map.on('dataloading', function() {
-	 *   console.log('A dataloading event occurred.');
-	 * });
-	 */  | "dataloading"
-/**
-	 * Fired when the map's style begins loading or changing asyncronously.
-	 * All `styledataloading` events are followed by a `styledata`
-	 * or `error` event. See {@link MapDataEvent} for more information.
+	 * @memberof CanvasSource
+	 */
+	load(): void;
+	/**
+	 * Returns the HTML `canvas` element.
 	 *
-	 * @event styledataloading
-	 * @memberof Map
-	 * @instance
-	 * @property {MapDataEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // map's style begins loading or
-	 * // changing asyncronously.
-	 * map.on('styledataloading', function() {
-	 *   console.log('A styledataloading event occurred.');
-	 * });
-	 */  | "styledataloading"
-/**
-	 * Fired when one of the map's sources begins loading or changing asyncronously.
-	 * All `sourcedataloading` events are followed by a `sourcedata` or `error` event.
-	 * See {@link MapDataEvent} for more information.
+	 * @returns {HTMLCanvasElement} The HTML `canvas` element.
+	 */
+	getCanvas(): HTMLCanvasElement;
+	onAdd(map: Map): void;
+	onRemove(): void;
+	prepare(): void;
+	serialize(): any;
+	hasTransition(): boolean;
+	_hasInvalidDimensions(): boolean;
+}
+export declare type Coordinates = [
+	[
+		number,
+		number
+	],
+	[
+		number,
+		number
+	],
+	[
+		number,
+		number
+	],
+	[
+		number,
+		number
+	]
+];
+export declare class ImageSource extends Evented implements Source {
+	type: string;
+	id: string;
+	minzoom: number;
+	maxzoom: number;
+	tileSize: number;
+	url: string;
+	coordinates: Coordinates;
+	tiles: {
+		[_: string]: Tile;
+	};
+	options: any;
+	dispatcher: Dispatcher;
+	map: Map;
+	texture: Texture | null;
+	image: HTMLImageElement | ImageBitmap;
+	tileID: CanonicalTileID;
+	_boundsArray: RasterBoundsArray;
+	boundsBuffer: VertexBuffer;
+	boundsSegments: SegmentVector;
+	_loaded: boolean;
+	/**
+	 * @private
+	 */
+	constructor(id: string, options: ImageSourceSpecification | VideoSourceSpecification | CanvasSourceSpecification, dispatcher: Dispatcher, eventedParent: Evented);
+	load(newCoordinates?: Coordinates, successCallback?: () => void): void;
+	loaded(): boolean;
+	/**
+	 * Updates the image URL and, optionally, the coordinates. To avoid having the image flash after changing,
+	 * set the `raster-fade-duration` paint property on the raster layer to 0.
 	 *
-	 * @event sourcedataloading
-	 * @memberof Map
-	 * @instance
-	 * @property {MapDataEvent} data
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // map's sources begin loading or
-	 * // changing asyncronously.
-	 * map.on('sourcedataloading', function() {
-	 *   console.log('A sourcedataloading event occurred.');
-	 * });
-	 */  | "sourcedataloading"
-/**
-	 * Fired when an icon or pattern needed by the style is missing. The missing image can
-	 * be added with {@link Map#addImage} within this event listener callback to prevent the image from
-	 * being skipped. This event can be used to dynamically generate icons and patterns.
+	 * @param {Object} options Options object.
+	 * @param {string} [options.url] Required image URL.
+	 * @param {Array<Array<number>>} [options.coordinates] Four geographical coordinates,
+	 *   represented as arrays of longitude and latitude numbers, which define the corners of the image.
+	 *   The coordinates start at the top left corner of the image and proceed in clockwise order.
+	 *   They do not have to represent a rectangle.
+	 * @returns {ImageSource} this
+	 */
+	updateImage(options: {
+		url: string;
+		coordinates?: Coordinates;
+	}): this;
+	_finishLoading(): void;
+	onAdd(map: Map): void;
+	/**
+	 * Sets the image's coordinates and re-renders the map.
 	 *
-	 * @event styleimagemissing
-	 * @memberof Map
-	 * @instance
-	 * @property {string} id The id of the missing image.
-	 * @example
-	 * // Initialize the map
-	 * var map = new maplibregl.Map({ // map options });
-	 * // Set an event listener that fires
-	 * // an icon or pattern is missing.
-	 * map.on('styleimagemissing', function() {
-	 *   console.log('A styleimagemissing event occurred.');
-	 * });
-	 * @see [Generate and add a missing icon to the map](https://maplibre.org/maplibre-gl-js-docs/example/add-image-missing-generated/)
-	 */  | "styleimagemissing"
-/**
-	 * @event style.load
-	 * @memberof Map
-	 * @instance
-	 * @private
-	 */  | "style.load";
+	 * @param {Array<Array<number>>} coordinates Four geographical coordinates,
+	 *   represented as arrays of longitude and latitude numbers, which define the corners of the image.
+	 *   The coordinates start at the top left corner of the image and proceed in clockwise order.
+	 *   They do not have to represent a rectangle.
+	 * @returns {ImageSource} this
+	 */
+	setCoordinates(coordinates: Coordinates): this;
+	prepare(): void;
+	loadTile(tile: Tile, callback: Callback<void>): void;
+	serialize(): any;
+	hasTransition(): boolean;
+}
 /**
  * The `Source` interface must be implemented by each source type, including "core" types (`vector`, `raster`,
  * `video`, etc.) and all custom, third-party types.
@@ -5811,11 +6253,11 @@ export interface Source {
 	readonly abortTile?: (tile: Tile, callback: Callback<void>) => void;
 	readonly unloadTile?: (tile: Tile, callback: Callback<void>) => void;
 	/**
-	   * @returns A plain (stringifiable) JS object representing the current state of the source.
-	   * Creating a source using the returned object as the `options` should result in a Source that is
-	   * equivalent to this one.
-	   * @private
-	   */
+	 * @returns A plain (stringifiable) JS object representing the current state of the source.
+	 * Creating a source using the returned object as the `options` should result in a Source that is
+	 * equivalent to this one.
+	 * @private
+	 */
 	serialize(): any;
 	readonly prepare?: () => void;
 }
@@ -6082,6 +6524,19 @@ export declare class SourceCache extends Evented {
 	 */
 	reloadTilesForDependencies(namespaces: Array<string>, keys: Array<string>): void;
 }
+declare const status: {
+	unavailable: string;
+	deferred: string;
+	loading: string;
+	loaded: string;
+	error: string;
+};
+export declare type PluginState = {
+	pluginStatus: typeof status[keyof typeof status];
+	pluginURL: string;
+};
+export declare type PluginStateSyncCallback = (state: PluginState) => void;
+declare const registerForPluginStateChange: (callback: PluginStateSyncCallback) => PluginStateSyncCallback;
 export declare type QueryResult<T> = {
 	key: T;
 	x1: number;
@@ -6089,7 +6544,10 @@ export declare type QueryResult<T> = {
 	x2: number;
 	y2: number;
 };
-export declare class GridIndex<T> {
+export declare type GridKey = {
+	overlapMode?: OverlapMode;
+};
+export declare class GridIndex<T extends GridKey> {
 	circleKeys: Array<T>;
 	boxKeys: Array<T>;
 	boxCells: Array<Array<number>>;
@@ -6112,8 +6570,8 @@ export declare class GridIndex<T> {
 	private _insertCircleCell;
 	private _query;
 	query(x1: number, y1: number, x2: number, y2: number): Array<QueryResult<T>>;
-	hitTest(x1: number, y1: number, x2: number, y2: number, predicate?: (key: T) => boolean): boolean;
-	hitTestCircle(x: number, y: number, radius: number, predicate?: (key: T) => boolean): boolean;
+	hitTest(x1: number, y1: number, x2: number, y2: number, overlapMode: OverlapMode, predicate?: (key: T) => boolean): boolean;
+	hitTestCircle(x: number, y: number, radius: number, overlapMode: OverlapMode, predicate?: (key: T) => boolean): boolean;
 	private _queryCell;
 	private _queryCellCircle;
 	private _forEachCell;
@@ -6126,6 +6584,7 @@ export declare type FeatureKey = {
 	bucketInstanceId: number;
 	featureIndex: number;
 	collisionGroupID: number;
+	overlapMode: OverlapMode;
 };
 export declare class CollisionIndex {
 	grid: GridIndex<FeatureKey>;
@@ -6137,11 +6596,11 @@ export declare class CollisionIndex {
 	gridRightBoundary: number;
 	gridBottomBoundary: number;
 	constructor(transform: Transform, grid?: GridIndex<FeatureKey>, ignoredGrid?: GridIndex<FeatureKey>);
-	placeCollisionBox(collisionBox: SingleCollisionBox, allowOverlap: boolean, textPixelRatio: number, posMatrix: mat4, collisionGroupPredicate?: (key: FeatureKey) => boolean): {
+	placeCollisionBox(collisionBox: SingleCollisionBox, overlapMode: OverlapMode, textPixelRatio: number, posMatrix: mat4, collisionGroupPredicate?: (key: FeatureKey) => boolean): {
 		box: Array<number>;
 		offscreen: boolean;
 	};
-	placeCollisionCircles(allowOverlap: boolean, symbol: any, lineVertexArray: SymbolLineVertexArray, glyphOffsetArray: GlyphOffsetArray, fontSize: number, posMatrix: mat4, labelPlaneMatrix: mat4, labelToScreenMatrix: mat4, showCollisionCircles: boolean, pitchWithMap: boolean, collisionGroupPredicate: (key: FeatureKey) => boolean, circlePixelDiameter: number, textPixelPadding: number): {
+	placeCollisionCircles(overlapMode: OverlapMode, symbol: any, lineVertexArray: SymbolLineVertexArray, glyphOffsetArray: GlyphOffsetArray, fontSize: number, posMatrix: mat4, labelPlaneMatrix: mat4, labelToScreenMatrix: mat4, showCollisionCircles: boolean, pitchWithMap: boolean, collisionGroupPredicate: (key: FeatureKey) => boolean, circlePixelDiameter: number, textPixelPadding: number): {
 		circles: Array<number>;
 		offscreen: boolean;
 		collisionDetected: boolean;
@@ -6154,8 +6613,8 @@ export declare class CollisionIndex {
 	 * @private
 	 */
 	queryRenderedSymbols(viewportQueryGeometry: Array<Point>): {};
-	insertCollisionBox(collisionBox: Array<number>, ignorePlacement: boolean, bucketInstanceId: number, featureIndex: number, collisionGroupID: number): void;
-	insertCollisionCircles(collisionCircles: Array<number>, ignorePlacement: boolean, bucketInstanceId: number, featureIndex: number, collisionGroupID: number): void;
+	insertCollisionBox(collisionBox: Array<number>, overlapMode: OverlapMode, ignorePlacement: boolean, bucketInstanceId: number, featureIndex: number, collisionGroupID: number): void;
+	insertCollisionCircles(collisionCircles: Array<number>, overlapMode: OverlapMode, ignorePlacement: boolean, bucketInstanceId: number, featureIndex: number, collisionGroupID: number): void;
 	projectAndGetPerspectiveRatio(posMatrix: mat4, x: number, y: number): {
 		point: Point;
 		perspectiveRatio: number;
@@ -6200,7 +6659,7 @@ export declare class RetainedQueryData {
 }
 export declare type CollisionGroup = {
 	ID: number;
-	predicate?: any;
+	predicate?: (key: FeatureKey) => boolean;
 };
 export declare class CollisionGroups {
 	collisionGroups: {
@@ -6276,7 +6735,7 @@ export declare class Placement {
 	};
 	constructor(transform: Transform, fadeDuration: number, crossSourceCollisions: boolean, prevPlacement?: Placement);
 	getBucketParts(results: Array<BucketPart>, styleLayer: StyleLayer, tile: Tile, sortAcrossTiles: boolean): void;
-	attemptAnchorPlacement(anchor: TextAnchor, textBox: SingleCollisionBox, width: number, height: number, textBoxScale: number, rotateWithMap: boolean, pitchWithMap: boolean, textPixelRatio: number, posMatrix: mat4, collisionGroup: CollisionGroup, textAllowOverlap: boolean, symbolInstance: SymbolInstance, bucket: SymbolBucket, orientation: number, iconBox?: SingleCollisionBox | null): {
+	attemptAnchorPlacement(anchor: TextAnchor, textBox: SingleCollisionBox, width: number, height: number, textBoxScale: number, rotateWithMap: boolean, pitchWithMap: boolean, textPixelRatio: number, posMatrix: mat4, collisionGroup: CollisionGroup, textOverlapMode: OverlapMode, symbolInstance: SymbolInstance, bucket: SymbolBucket, orientation: number, iconBox?: SingleCollisionBox | null): {
 		shift: Point;
 		placedGlyphBoxes: {
 			box: Array<number>;
@@ -6493,10 +6952,10 @@ export declare class Style extends Evented {
 	 */
 	removeSource(id: string): this;
 	/**
-	* Set the data of a GeoJSON source, given its id.
-	* @param {string} id id of the source
-	* @param {GeoJSON|string} data GeoJSON source
-	*/
+	 * Set the data of a GeoJSON source, given its id.
+	 * @param {string} id id of the source
+	 * @param {GeoJSON|string} data GeoJSON source
+	 */
 	setGeoJSONSourceData(id: string, data: GeoJSON.GeoJSON | string): void;
 	/**
 	 * Get a source by id.
@@ -6516,7 +6975,7 @@ export declare class Style extends Evented {
 	/**
 	 * Moves a layer to a different z-position. The layer will be inserted before the layer with
 	 * ID `before`, or appended if `before` is omitted.
-	 * @param {string} id  ID of the layer to move
+	 * @param {string} id ID of the layer to move
 	 * @param {string} [before] ID of an existing layer to insert before
 	 */
 	moveLayer(id: string, before?: string): void;
@@ -6640,6 +7099,7 @@ export declare class Painter {
 	emptyProgramConfiguration: ProgramConfiguration;
 	width: number;
 	height: number;
+	pixelRatio: number;
 	tileExtentBuffer: VertexBuffer;
 	tileExtentSegments: SegmentVector;
 	debugBuffer: VertexBuffer;
@@ -6679,7 +7139,7 @@ export declare class Painter {
 	debugOverlayTexture: Texture;
 	debugOverlayCanvas: HTMLCanvasElement;
 	constructor(gl: WebGLRenderingContext, transform: Transform);
-	resize(width: number, height: number): void;
+	resize(width: number, height: number, pixelRatio: number): void;
 	setup(): void;
 	clearStencil(): void;
 	_renderTileClippingMasks(layer: StyleLayer, tileIDs: Array<OverscaledTileID>): void;
@@ -7662,12 +8122,12 @@ export declare class ScrollZoomHandler {
 	 */
 	setZoomRate(zoomRate: number): void;
 	/**
-	* Set the zoom rate of a mouse wheel
-	* @param {number} [wheelZoomRate=1/450] The rate used to scale mouse wheel movement to a zoom value.
-	* @example
-	* // Slow down zoom of mouse wheel
-	* map.scrollZoom.setWheelZoomRate(1/600);
-	*/
+	 * Set the zoom rate of a mouse wheel
+	 * @param {number} [wheelZoomRate=1/450] The rate used to scale mouse wheel movement to a zoom value.
+	 * @example
+	 * // Slow down zoom of mouse wheel
+	 * map.scrollZoom.setWheelZoomRate(1/600);
+	 */
 	setWheelZoomRate(wheelZoomRate: number): void;
 	/**
 	 * Returns a Boolean indicating whether the "scroll to zoom" interaction is enabled.
@@ -8255,6 +8715,7 @@ export declare type MapOptions = {
 	localIdeographFontFamily?: string;
 	style: StyleSpecification | string;
 	pitchWithRotate?: boolean;
+	pixelRatio?: number;
 };
 export declare type Complete<T> = {
 	[P in keyof Required<T>]: Pick<T, P> extends Required<Pick<T, P>> ? T[P] : (T[P] | undefined);
@@ -8304,6 +8765,7 @@ export declare class Map extends Camera {
 	_locale: any;
 	_removed: boolean;
 	_clickTolerance: number;
+	_pixelRatio: number;
 	/**
 	 * The map's {@link ScrollZoomHandler}, which implements zooming in and out with a scroll wheel or trackpad.
 	 * Find more details and examples using `scrollZoom` in the {@link ScrollZoomHandler} section.
@@ -8407,6 +8869,18 @@ export declare class Map extends Camera {
 	 * if (mapDiv.style.visibility === true) map.resize();
 	 */
 	resize(eventData?: any): this;
+	/**
+	 * Returns the map's pixel ratio.
+	 * @returns {number} The pixel ratio.
+	 */
+	getPixelRatio(): number;
+	/**
+	 * Sets the map's pixel ratio. This allows to override `devicePixelRatio`.
+	 * After this call, the canvas' `width` attribute will be `container.clientWidth * pixelRatio`
+	 * and its height attribute will be `container.clientHeight * pixelRatio`.
+	 * @param {number} pixelRatio The pixel ratio.
+	 */
+	setPixelRatio(pixelRatio: number): void;
 	/**
 	 * Returns the map's geographical bounds. When the bearing or pitch is non-zero, the visible region is not
 	 * an axis-aligned rectangle, and the result is the smallest bounds that encompasses the visible region.
@@ -8666,6 +9140,8 @@ export declare class Map extends Camera {
 	 * | [`styledataloading`](#map.event:styledataloading)         |                           |
 	 * | [`sourcedataloading`](#map.event:sourcedataloading)       |                           |
 	 * | [`styleimagemissing`](#map.event:styleimagemissing)       |                           |
+	 * | [`dataabort`](#map.event:dataabort)                       |                           |
+	 * | [`sourcedataabort`](#map.event:sourcedataabort)           |                           |
 	 *
 	 * @param {string | Listener} layerIdOrListener The ID of a style layer or a listener if no ID is provided. Event will only be triggered if its location
 	 * is within a visible feature in this layer. The event will have a `features` property containing
@@ -8919,10 +9395,10 @@ export declare class Map extends Camera {
 	/**
 	 *  Updates the requestManager's transform request with a new function
 	 *
-	 *  @param transformRequest A callback run before the Map makes a request for an external URL. The callback can be used to modify the url, set headers, or set the credentials property for cross-origin requests.
+	 * @param transformRequest A callback run before the Map makes a request for an external URL. The callback can be used to modify the url, set headers, or set the credentials property for cross-origin requests.
 	 *    Expected to return an object with a `url` property and optionally `headers` and `credentials` properties
 	 *
-	 *  @returns {Map} `this`
+	 * @returns {Map} `this`
 	 *
 	 *  @example
 	 *  map.setTransformRequest((url: string, resourceType: string) => {});
@@ -9063,9 +9539,9 @@ export declare class Map extends Camera {
 	 * @param options Options object.
 	 * @param options.pixelRatio The ratio of pixels in the image to physical pixels on the screen
 	 * @param options.sdf Whether the image should be interpreted as an SDF image
-	 * @param options.content  `[x1, y1, x2, y2]`  If `icon-text-fit` is used in a layer with this image, this option defines the part of the image that can be covered by the content in `text-field`.
-	 * @param options.stretchX  `[[x1, x2], ...]` If `icon-text-fit` is used in a layer with this image, this option defines the part(s) of the image that can be stretched horizontally.
-	 * @param options.stretchY  `[[y1, y2], ...]` If `icon-text-fit` is used in a layer with this image, this option defines the part(s) of the image that can be stretched vertically.
+	 * @param options.content `[x1, y1, x2, y2]`  If `icon-text-fit` is used in a layer with this image, this option defines the part of the image that can be covered by the content in `text-field`.
+	 * @param options.stretchX `[[x1, x2], ...]` If `icon-text-fit` is used in a layer with this image, this option defines the part(s) of the image that can be stretched horizontally.
+	 * @param options.stretchY `[[y1, y2], ...]` If `icon-text-fit` is used in a layer with this image, this option defines the part(s) of the image that can be stretched vertically.
 	 *
 	 * @example
 	 * // If the style's sprite does not already contain an image with ID 'cat',
@@ -9127,7 +9603,7 @@ export declare class Map extends Camera {
 	 *
 	 * @param id The ID of the image.
 	 *
-	 * @returns {boolean}  A Boolean indicating whether the image exists.
+	 * @returns {boolean} A Boolean indicating whether the image exists.
 	 * @example
 	 * // Check if an image with the ID 'cat' exists in
 	 * // the style's sprite.
@@ -9166,16 +9642,16 @@ export declare class Map extends Camera {
 	 */
 	loadImage(url: string, callback: Callback<HTMLImageElement | ImageBitmap>): void;
 	/**
-	* Returns an Array of strings containing the IDs of all images currently available in the map.
-	* This includes both images from the style's original sprite
-	* and any images that have been added at runtime using {@link Map#addImage}.
-	*
-	* @returns {Array<string>} An Array of strings containing the names of all sprites/images currently available in the map.
-	*
-	* @example
-	* var allImages = map.listImages();
-	*
-	*/
+	 * Returns an Array of strings containing the IDs of all images currently available in the map.
+	 * This includes both images from the style's original sprite
+	 * and any images that have been added at runtime using {@link Map#addImage}.
+	 *
+	 * @returns {Array<string>} An Array of strings containing the names of all sprites/images currently available in the map.
+	 *
+	 * @example
+	 * var allImages = map.listImages();
+	 *
+	 */
 	listImages(): string[];
 	/**
 	 * Adds a [MapLibre style layer](https://maplibre.org/maplibre-gl-js-docs/style-spec/#layers)
@@ -9534,7 +10010,7 @@ export declare class Map extends Camera {
 	 *   }, 'hover');
 	 * });
 	 *
-	*/
+	 */
 	removeFeatureState(target: {
 		source: string;
 		sourceLayer?: string;
@@ -9604,7 +10080,7 @@ export declare class Map extends Camera {
 	getCanvas(): HTMLCanvasElement;
 	_containerDimensions(): number[];
 	_setupContainer(): void;
-	_resizeCanvas(width: number, height: number): void;
+	_resizeCanvas(width: number, height: number, pixelRatio: number): void;
 	_setupPainter(): void;
 	_contextLost(event: any): void;
 	_contextRestored(event: any): void;
@@ -9650,11 +10126,11 @@ export declare class Map extends Camera {
 	 */
 	_render(paintStartTimeStamp: number): this;
 	/**
-	* Force a synchronous redraw of the map.
-	* @example
-	* map.redraw();
-	* @returns {Map} `this`
-	*/
+	 * Force a synchronous redraw of the map.
+	 * @example
+	 * map.redraw();
+	 * @returns {Map} `this`
+	 */
 	redraw(): Map;
 	/**
 	 * Clean up and release all internal resources associated with this map.
@@ -10046,26 +10522,26 @@ export declare class Marker extends Evented {
 	 * the marker on screen.
 	 *
 	 * @returns {LngLat} A {@link LngLat} describing the marker's location.
-	* @example
-	* // Store the marker's longitude and latitude coordinates in a variable
-	* var lngLat = marker.getLngLat();
-	* // Print the marker's longitude and latitude values in the console
-	* console.log('Longitude: ' + lngLat.lng + ', Latitude: ' + lngLat.lat )
-	* @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
-	*/
+	 * @example
+	 * // Store the marker's longitude and latitude coordinates in a variable
+	 * var lngLat = marker.getLngLat();
+	 * // Print the marker's longitude and latitude values in the console
+	 * console.log('Longitude: ' + lngLat.lng + ', Latitude: ' + lngLat.lat )
+	 * @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
+	 */
 	getLngLat(): LngLat;
 	/**
-	* Set the marker's geographical position and move it.
-	* @param {LngLat} lnglat A {@link LngLat} describing where the marker should be located.
-	* @returns {Marker} `this`
-	* @example
-	* // Create a new marker, set the longitude and latitude, and add it to the map
-	* new maplibregl.Marker()
-	*   .setLngLat([-65.017, -16.457])
-	*   .addTo(map);
-	* @see [Add custom icons with Markers](https://maplibre.org/maplibre-gl-js-docs/example/custom-marker-icons/)
-	* @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
-	*/
+	 * Set the marker's geographical position and move it.
+	 * @param {LngLat} lnglat A {@link LngLat} describing where the marker should be located.
+	 * @returns {Marker} `this`
+	 * @example
+	 * // Create a new marker, set the longitude and latitude, and add it to the map
+	 * new maplibregl.Marker()
+	 *   .setLngLat([-65.017, -16.457])
+	 *   .addTo(map);
+	 * @see [Add custom icons with Markers](https://maplibre.org/maplibre-gl-js-docs/example/custom-marker-icons/)
+	 * @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
+	 */
 	setLngLat(lnglat: LngLatLike): this;
 	/**
 	 * Returns the `Marker`'s HTML element.
@@ -10234,23 +10710,23 @@ export declare class GeolocateControl extends Evented implements IControl {
 	_finish(): void;
 	_setupUI(supported: boolean): void;
 	/**
-	* Programmatically request and move the map to the user's location.
-	*
-	* @returns {boolean} Returns `false` if called before control was added to a map, otherwise returns `true`.
-	* @example
-	* // Initialize the geolocate control.
-	* var geolocate = new maplibregl.GeolocateControl({
-	*  positionOptions: {
-	*    enableHighAccuracy: true
-	*  },
-	*  trackUserLocation: true
-	* });
-	* // Add the control to the map.
-	* map.addControl(geolocate);
-	* map.on('load', function() {
-	*   geolocate.trigger();
-	* });
-	*/
+	 * Programmatically request and move the map to the user's location.
+	 *
+	 * @returns {boolean} Returns `false` if called before control was added to a map, otherwise returns `true`.
+	 * @example
+	 * // Initialize the geolocate control.
+	 * var geolocate = new maplibregl.GeolocateControl({
+	 *  positionOptions: {
+	 *    enableHighAccuracy: true
+	 *  },
+	 *  trackUserLocation: true
+	 * });
+	 * // Add the control to the map.
+	 * map.addControl(geolocate);
+	 * map.on('load', function() {
+	 *   geolocate.trigger();
+	 * });
+	 */
 	trigger(): boolean;
 	_clearWatch(): void;
 }
@@ -10261,6 +10737,7 @@ export declare type AttributionOptions = {
 export declare class AttributionControl implements IControl {
 	options: AttributionOptions;
 	_map: Map;
+	_compact: boolean;
 	_container: HTMLElement;
 	_innerContainer: HTMLElement;
 	_compactButton: HTMLElement;
@@ -10277,6 +10754,7 @@ export declare class AttributionControl implements IControl {
 	_updateData(e: any): void;
 	_updateAttributions(): void;
 	_updateCompact(): void;
+	_updateCompactMinimize(): void;
 }
 export declare type Unit = "imperial" | "metric" | "nautical";
 export declare type ScaleOptions = {
@@ -10322,6 +10800,72 @@ export declare class FullscreenControl implements IControl {
 }
 declare function prewarm(): void;
 declare function clearPrewarmedResources(): void;
+export declare class RasterDEMTileSource extends RasterTileSource implements Source {
+	encoding: "mapbox" | "terrarium";
+	constructor(id: string, options: RasterDEMSourceSpecification, dispatcher: Dispatcher, eventedParent: Evented);
+	serialize(): {
+		type: string;
+		url: string;
+		tileSize: number;
+		tiles: string[];
+		bounds: [
+			number,
+			number,
+			number,
+			number
+		];
+		encoding: "mapbox" | "terrarium";
+	};
+	loadTile(tile: Tile, callback: Callback<void>): void;
+	_getNeighboringTiles(tileID: OverscaledTileID): {};
+	unloadTile(tile: Tile): void;
+}
+export declare class VideoSource extends ImageSource {
+	options: VideoSourceSpecification;
+	urls: Array<string>;
+	video: HTMLVideoElement;
+	roundZoom: boolean;
+	/**
+	 * @private
+	 */
+	constructor(id: string, options: VideoSourceSpecification, dispatcher: Dispatcher, eventedParent: Evented);
+	load(): void;
+	/**
+	 * Pauses the video.
+	 */
+	pause(): void;
+	/**
+	 * Plays the video.
+	 */
+	play(): void;
+	/**
+	 * Sets playback to a timestamp, in seconds.
+	 * @private
+	 */
+	seek(seconds: number): void;
+	/**
+	 * Returns the HTML `video` element.
+	 *
+	 * @returns {HTMLVideoElement} The HTML `video` element.
+	 */
+	getVideo(): HTMLVideoElement;
+	onAdd(map: Map): void;
+	/**
+	 * Sets the video's coordinates and re-renders the map.
+	 *
+	 * @method setCoordinates
+	 * @instance
+	 * @memberof VideoSource
+	 * @returns {VideoSource} this
+	 */
+	prepare(): void;
+	serialize(): {
+		type: string;
+		urls: string[];
+		coordinates: Coordinates;
+	};
+	hasTransition(): boolean;
+}
 declare const exported: {
 	supported: import("@mapbox/mapbox-gl-supported").IsSupported;
 	setRTLTextPlugin: (url: string, callback: (error?: Error) => void, deferred?: boolean) => void;
@@ -10340,12 +10884,20 @@ declare const exported: {
 	Point: typeof Point;
 	MercatorCoordinate: typeof MercatorCoordinate;
 	Evented: typeof Evented;
+	AJAXError: typeof AJAXError;
 	config: {
 		MAX_PARALLEL_IMAGE_REQUESTS: number;
 		REGISTERED_PROTOCOLS: {
 			[x: string]: any;
 		};
 	};
+	CanvasSource: typeof CanvasSource;
+	GeoJSONSource: typeof GeoJSONSource;
+	ImageSource: typeof ImageSource;
+	RasterDEMTileSource: typeof RasterDEMTileSource;
+	RasterTileSource: typeof RasterTileSource;
+	VectorTileSource: typeof VectorTileSource;
+	VideoSource: typeof VideoSource;
 	/**
 	 * Initializes resources like WebWorkers that can be shared across maps to lower load
 	 * times in some situations. `maplibregl.workerUrl` and `maplibregl.workerCount`, if being
@@ -10493,14 +11045,14 @@ declare const exported: {
  * @see [Add support for right-to-left scripts](https://maplibre.org/maplibre-gl-js-docs/example/mapbox-gl-rtl-text/)
  */
 /**
-  * Gets the map's [RTL text plugin](https://www.mapbox.com/mapbox-gl-js/plugins/#mapbox-gl-rtl-text) status.
-  * The status can be `unavailable` (i.e. not requested or removed), `loading`, `loaded` or `error`.
-  * If the status is `loaded` and the plugin is requested again, an error will be thrown.
-  *
-  * @function getRTLTextPluginStatus
-  * @example
-  * const pluginStatus = maplibregl.getRTLTextPluginStatus();
-  */
+ * Gets the map's [RTL text plugin](https://www.mapbox.com/mapbox-gl-js/plugins/#mapbox-gl-rtl-text) status.
+ * The status can be `unavailable` (i.e. not requested or removed), `loading`, `loaded` or `error`.
+ * If the status is `loaded` and the plugin is requested again, an error will be thrown.
+ *
+ * @function getRTLTextPluginStatus
+ * @example
+ * const pluginStatus = maplibregl.getRTLTextPluginStatus();
+ */
 export default exported;
 
 export as namespace maplibregl;