maplibre-gl 2.0.5 → 2.1.3

package/src/ui/events.ts

@@ -15,40 +15,40 @@ export type MapLayerTouchEvent = MapTouchEvent & { features?: GeoJSON.Feature[]
 export type MapSourceDataType = 'content' | 'metadata';
 
 export type MapLayerEventType = {
-     click: MapLayerMouseEvent;
-     dblclick: MapLayerMouseEvent;
-     mousedown: MapLayerMouseEvent;
-     mouseup: MapLayerMouseEvent;
-     mousemove: MapLayerMouseEvent;
-     mouseenter: MapLayerMouseEvent;
-     mouseleave: MapLayerMouseEvent;
-     mouseover: MapLayerMouseEvent;
-     mouseout: MapLayerMouseEvent;
-     contextmenu: MapLayerMouseEvent;
-
-     touchstart: MapLayerTouchEvent;
-     touchend: MapLayerTouchEvent;
-     touchcancel: MapLayerTouchEvent;
- };
+    click: MapLayerMouseEvent;
+    dblclick: MapLayerMouseEvent;
+    mousedown: MapLayerMouseEvent;
+    mouseup: MapLayerMouseEvent;
+    mousemove: MapLayerMouseEvent;
+    mouseenter: MapLayerMouseEvent;
+    mouseleave: MapLayerMouseEvent;
+    mouseover: MapLayerMouseEvent;
+    mouseout: MapLayerMouseEvent;
+    contextmenu: MapLayerMouseEvent;
+
+    touchstart: MapLayerTouchEvent;
+    touchend: MapLayerTouchEvent;
+    touchcancel: MapLayerTouchEvent;
+};
 
 export interface MapLibreEvent<TOrig = undefined> {
-     type: string;
-     target: Map;
-     originalEvent: TOrig;
- }
+    type: string;
+    target: Map;
+    originalEvent: TOrig;
+}
 
 export interface MapStyleDataEvent extends MapLibreEvent {
-     dataType: 'style';
- }
+    dataType: 'style';
+}
 
 export interface MapSourceDataEvent extends MapLibreEvent {
-     dataType: 'source';
-     isSourceLoaded: boolean;
-     source: SourceSpecification;
-     sourceId: string;
-     sourceDataType: MapSourceDataType;
-     tile: any;
- }
+    dataType: 'source';
+    isSourceLoaded: boolean;
+    source: SourceSpecification;
+    sourceId: string;
+    sourceDataType: MapSourceDataType;
+    tile: any;
+}
 /**
  * `MapMouseEvent` is the event type for mouse-related map events.
  * @extends {Event}
@@ -272,9 +272,9 @@ export class MapWheelEvent extends Event {
  * @property {Map} target The `Map` instance that triggerred the event
  */
 export type MapLibreZoomEvent = {
-  type: 'boxzoomstart' | 'boxzoomend' | 'boxzoomcancel';
-  target: Map;
-  originalEvent: MouseEvent;
+    type: 'boxzoomstart' | 'boxzoomend' | 'boxzoomcancel';
+    target: Map;
+    originalEvent: MouseEvent;
 };
 
 /**
@@ -306,87 +306,90 @@ export type MapLibreZoomEvent = {
  * });
  */
 export type MapDataEvent = {
-  type: string;
-  dataType: string;
-  sourceDataType: MapSourceDataType;
+    type: string;
+    dataType: string;
+    sourceDataType: MapSourceDataType;
 };
 
 export type MapContextEvent = {
-  type: 'webglcontextlost' | 'webglcontextrestored';
-  originalEvent: WebGLContextEvent;
+    type: 'webglcontextlost' | 'webglcontextrestored';
+    originalEvent: WebGLContextEvent;
 };
 
 export interface MapStyleImageMissingEvent extends MapLibreEvent {
-     type: 'styleimagemissing';
-     id: string;
+    type: 'styleimagemissing';
+    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 type MapEventType = {
-     error: ErrorEvent;
-
-     load: MapLibreEvent;
-     idle: MapLibreEvent;
-     remove: MapLibreEvent;
-     render: MapLibreEvent;
-     resize: MapLibreEvent;
-
-     webglcontextlost: MapContextEvent;
-     webglcontextrestored: MapContextEvent;
-
-     dataloading: MapDataEvent;
-     data: MapDataEvent;
-     tiledataloading: MapDataEvent;
-     sourcedataloading: MapSourceDataEvent;
-     styledataloading: MapStyleDataEvent;
-     sourcedata: MapSourceDataEvent;
-     styledata: MapStyleDataEvent;
-     styleimagemissing: MapStyleImageMissingEvent;
-
-     boxzoomcancel: MapLibreZoomEvent;
-     boxzoomstart: MapLibreZoomEvent;
-     boxzoomend: MapLibreZoomEvent;
-
-     touchcancel: MapTouchEvent;
-     touchmove: MapTouchEvent;
-     touchend: MapTouchEvent;
-     touchstart: MapTouchEvent;
-
-     click: MapMouseEvent;
-     contextmenu: MapMouseEvent;
-     dblclick: MapMouseEvent;
-     mousemove: MapMouseEvent;
-     mouseup: MapMouseEvent;
-     mousedown: MapMouseEvent;
-     mouseout: MapMouseEvent;
-     mouseover: MapMouseEvent;
-
-     movestart: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
-     move: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
-     moveend: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
-
-     zoomstart: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
-     zoom: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
-     zoomend: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
-
-     rotatestart: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-     rotate: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-     rotateend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-
-     dragstart: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-     drag: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-     dragend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-
-     pitchstart: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-     pitch: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-     pitchend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
-
-     wheel: MapWheelEvent;
+    error: ErrorEvent;
+
+    load: MapLibreEvent;
+    idle: MapLibreEvent;
+    remove: MapLibreEvent;
+    render: MapLibreEvent;
+    resize: MapLibreEvent;
+
+    webglcontextlost: MapContextEvent;
+    webglcontextrestored: MapContextEvent;
+
+    dataloading: MapDataEvent;
+    data: MapDataEvent;
+    tiledataloading: MapDataEvent;
+    sourcedataloading: MapSourceDataEvent;
+    styledataloading: MapStyleDataEvent;
+    sourcedata: MapSourceDataEvent;
+    styledata: MapStyleDataEvent;
+    styleimagemissing: MapStyleImageMissingEvent;
+    dataabort: MapDataEvent;
+    sourcedataabort: MapSourceDataEvent;
+
+    boxzoomcancel: MapLibreZoomEvent;
+    boxzoomstart: MapLibreZoomEvent;
+    boxzoomend: MapLibreZoomEvent;
+
+    touchcancel: MapTouchEvent;
+    touchmove: MapTouchEvent;
+    touchend: MapTouchEvent;
+    touchstart: MapTouchEvent;
+
+    click: MapMouseEvent;
+    contextmenu: MapMouseEvent;
+    dblclick: MapMouseEvent;
+    mousemove: MapMouseEvent;
+    mouseup: MapMouseEvent;
+    mousedown: MapMouseEvent;
+    mouseout: MapMouseEvent;
+    mouseover: MapMouseEvent;
+
+    movestart: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
+    move: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
+    moveend: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
+
+    zoomstart: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
+    zoom: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
+    zoomend: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>;
+
+    rotatestart: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+    rotate: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+    rotateend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+
+    dragstart: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+    drag: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+    dragend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+
+    pitchstart: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+    pitch: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+    pitchend: MapLibreEvent<MouseEvent | TouchEvent | undefined>;
+
+    wheel: MapWheelEvent;
 };
 
-export type MapEvent = /**
+export 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.
@@ -413,9 +416,9 @@ export type MapEvent = /**
      * });
      * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
      */
-'mousedown'
+    'mousedown'
 
-/**
+    /**
      * Fired when a pointing device (usually a mouse) is released within the map.
      *
      * **Note:** This event is compatible with the optional `layerId` parameter.
@@ -441,9 +444,10 @@ export type MapEvent = /**
      *   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'
+     */
+    | 'mouseup'
 
-/**
+    /**
      * 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.
@@ -473,9 +477,10 @@ export type MapEvent = /**
      * @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'
+     */
+    | 'mouseover'
 
-/**
+    /**
      * 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.
      *
@@ -504,9 +509,10 @@ export type MapEvent = /**
      * @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'
+     */
+    | 'mousemove'
 
-/**
+    /**
      * 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.
@@ -533,9 +539,10 @@ export type MapEvent = /**
      * });
      * @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'
+     */
+    | 'click'
 
-/**
+    /**
      * Fired when a pointing device (usually a mouse) is pressed and released twice at the same point on
      * the map in rapid succession.
      *
@@ -561,9 +568,10 @@ export type MapEvent = /**
      * 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'
+     */
+    | 'dblclick'
 
-/**
+    /**
      * 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.
      *
@@ -583,9 +591,10 @@ export type MapEvent = /**
      * });
      * @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'
+     */
+    | 'mouseenter'
 
-/**
+    /**
      * Fired when a pointing device (usually a mouse) leaves a visible portion of a specified layer, or leaves
      * the map canvas.
      *
@@ -607,9 +616,10 @@ export type MapEvent = /**
      * });
      * @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'
+     */
+    | 'mouseleave'
 
-/**
+    /**
      * Fired when a point device (usually a mouse) leaves the map's canvas.
      *
      * @event mouseout
@@ -625,9 +635,10 @@ export type MapEvent = /**
      * map.on('mouseout', function() {
      *   console.log('A mouseout event occurred.');
      * });
-     */ | 'mouseout'
+     */
+    | 'mouseout'
 
-/**
+    /**
      * Fired when the right button of the mouse is clicked or the context menu key is pressed within the map.
      *
      * @event contextmenu
@@ -643,9 +654,10 @@ export type MapEvent = /**
      * map.on('contextmenu', function() {
      *   console.log('A contextmenu event occurred.');
      * });
-     */ | 'contextmenu'
+     */
+    | 'contextmenu'
 
-/**
+    /**
      * Fired when a [`wheel`](https://developer.mozilla.org/en-US/docs/Web/Events/wheel) event occurs within the map.
      *
      * @event wheel
@@ -660,9 +672,10 @@ export type MapEvent = /**
      * map.on('wheel', function() {
      *   console.log('A wheel event occurred.');
      * });
-     */ | 'wheel'
+     */
+    | 'wheel'
 
-/**
+    /**
      * Fired when a [`touchstart`](https://developer.mozilla.org/en-US/docs/Web/Events/touchstart) event occurs within the map.
      *
      * @event touchstart
@@ -677,9 +690,10 @@ export type MapEvent = /**
      *   console.log('A touchstart event occurred.');
      * });
      * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-     */ | 'touchstart'
+     */
+    | 'touchstart'
 
-/**
+    /**
      * Fired when a [`touchend`](https://developer.mozilla.org/en-US/docs/Web/Events/touchend) event occurs within the map.
      *
      * @event touchend
@@ -695,9 +709,10 @@ export type MapEvent = /**
      *   console.log('A touchstart event occurred.');
      * });
      * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-     */ | 'touchend'
+     */
+    | 'touchend'
 
-/**
+    /**
      * Fired when a [`touchmove`](https://developer.mozilla.org/en-US/docs/Web/Events/touchmove) event occurs within the map.
      *
      * @event touchmove
@@ -713,9 +728,10 @@ export type MapEvent = /**
      *   console.log('A touchmove event occurred.');
      * });
      * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-point/)
-     */ | 'touchmove'
+     */
+    | 'touchmove'
 
-/**
+    /**
      * Fired when a [`touchcancel`](https://developer.mozilla.org/en-US/docs/Web/Events/touchcancel) event occurs within the map.
      *
      * @event touchcancel
@@ -730,9 +746,10 @@ export type MapEvent = /**
      * map.on('touchcancel', function() {
      *   console.log('A touchcancel event occurred.');
      * });
-     */ | 'touchcancel'
+     */
+    | 'touchcancel'
 
-/**
+    /**
      * 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}.
      *
@@ -749,9 +766,10 @@ export type MapEvent = /**
      * map.on('movestart', function() {
      *   console.log('A movestart` event occurred.');
      * });
-     */ | 'movestart'
+     */
+    | 'movestart'
 
-/**
+    /**
      * 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}.
      *
@@ -768,9 +786,10 @@ export type MapEvent = /**
      *   console.log('A move event occurred.');
      * });
      * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
-     */ | 'move'
+     */
+    | 'move'
 
-/**
+    /**
      * 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}.
      *
@@ -787,9 +806,10 @@ export type MapEvent = /**
      *   console.log('A moveend event occurred.');
      * });
      * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
-     */ | 'moveend'
+     */
+    | 'moveend'
 
-/**
+    /**
      * Fired when a "drag to pan" interaction starts. See {@link DragPanHandler}.
      *
      * @event dragstart
@@ -804,9 +824,10 @@ export type MapEvent = /**
      * map.on('dragstart', function() {
      *   console.log('A dragstart event occurred.');
      * });
-     */ | 'dragstart'
+     */
+    | 'dragstart'
 
-/**
+    /**
      * Fired repeatedly during a "drag to pan" interaction. See {@link DragPanHandler}.
      *
      * @event drag
@@ -821,9 +842,10 @@ export type MapEvent = /**
      * map.on('drag', function() {
      *   console.log('A drag event occurred.');
      * });
-     */ | 'drag'
+     */
+    | 'drag'
 
-/**
+    /**
      * Fired when a "drag to pan" interaction ends. See {@link DragPanHandler}.
      *
      * @event dragend
@@ -839,9 +861,10 @@ export type MapEvent = /**
      *   console.log('A dragend event occurred.');
      * });
      * @see [Create a draggable marker](https://maplibre.org/maplibre-gl-js-docs/example/drag-a-marker/)
-     */ | 'dragend'
+     */
+    | 'dragend'
 
-/**
+    /**
      * 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}.
      *
@@ -857,9 +880,10 @@ export type MapEvent = /**
      * map.on('zoomstart', function() {
      *   console.log('A zoomstart event occurred.');
      * });
-     */ | 'zoomstart'
+     */
+    | 'zoomstart'
 
-/**
+    /**
      * 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}.
      *
@@ -875,9 +899,10 @@ export type MapEvent = /**
      * map.on('zoom', function() {
      *   console.log('A zoom event occurred.');
      * });
-     */ | 'zoom'
+     */
+    | 'zoom'
 
-/**
+    /**
      * 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}.
      *
@@ -893,9 +918,10 @@ export type MapEvent = /**
      * map.on('zoomend', function() {
      *   console.log('A zoomend event occurred.');
      * });
-     */ | 'zoomend'
+     */
+    | 'zoomend'
 
-/**
+    /**
      * Fired when a "drag to rotate" interaction starts. See {@link DragRotateHandler}.
      *
      * @event rotatestart
@@ -910,9 +936,10 @@ export type MapEvent = /**
      * map.on('rotatestart', function() {
      *   console.log('A rotatestart event occurred.');
      * });
-     */ | 'rotatestart'
+     */
+    | 'rotatestart'
 
-/**
+    /**
      * Fired repeatedly during a "drag to rotate" interaction. See {@link DragRotateHandler}.
      *
      * @event rotate
@@ -927,9 +954,10 @@ export type MapEvent = /**
      * map.on('rotate', function() {
      *   console.log('A rotate event occurred.');
      * });
-     */ | 'rotate'
+     */
+    | 'rotate'
 
-/**
+    /**
      * Fired when a "drag to rotate" interaction ends. See {@link DragRotateHandler}.
      *
      * @event rotateend
@@ -944,9 +972,10 @@ export type MapEvent = /**
      * map.on('rotateend', function() {
      *   console.log('A rotateend event occurred.');
      * });
-     */ | 'rotateend'
+     */
+    | 'rotateend'
 
-/**
+    /**
      * Fired whenever the map's pitch (tilt) begins a change as
      * the result of either user interaction or methods such as {@link Map#flyTo} .
      *
@@ -962,9 +991,10 @@ export type MapEvent = /**
      * map.on('pitchstart', function() {
      *   console.log('A pitchstart event occurred.');
      * });
-     */ | 'pitchstart'
+     */
+    | 'pitchstart'
 
-/**
+    /**
      * 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}.
@@ -981,9 +1011,10 @@ export type MapEvent = /**
      * map.on('pitch', function() {
      *   console.log('A pitch event occurred.');
      * });
-     */ | 'pitch'
+     */
+    | 'pitch'
 
-/**
+    /**
      * Fired immediately after the map's pitch (tilt) finishes changing as
      * the result of either user interaction or methods such as {@link Map#flyTo}.
      *
@@ -999,9 +1030,10 @@ export type MapEvent = /**
      * map.on('pitchend', function() {
      *   console.log('A pitchend event occurred.');
      * });
-     */ | 'pitchend'
+     */
+    | 'pitchend'
 
-/**
+    /**
      * Fired when a "box zoom" interaction starts. See {@link BoxZoomHandler}.
      *
      * @event boxzoomstart
@@ -1016,9 +1048,10 @@ export type MapEvent = /**
      * map.on('boxzoomstart', function() {
      *   console.log('A boxzoomstart event occurred.');
      * });
-     */ | 'boxzoomstart'
+     */
+    | 'boxzoomstart'
 
-/**
+    /**
      * Fired when a "box zoom" interaction ends.  See {@link BoxZoomHandler}.
      *
      * @event boxzoomend
@@ -1034,9 +1067,10 @@ export type MapEvent = /**
      * map.on('boxzoomend', function() {
      *   console.log('A boxzoomend event occurred.');
      * });
-     */ | 'boxzoomend'
+     */
+    | 'boxzoomend'
 
-/**
+    /**
      * Fired when the user cancels a "box zoom" interaction, or when the bounding box does not meet the minimum size threshold.
      * See {@link BoxZoomHandler}.
      *
@@ -1052,9 +1086,10 @@ export type MapEvent = /**
      * map.on('boxzoomcancel', function() {
      *   console.log('A boxzoomcancel event occurred.');
      * });
-     */ | 'boxzoomcancel'
+     */
+    | 'boxzoomcancel'
 
-/**
+    /**
      * Fired immediately after the map has been resized.
      *
      * @event resize
@@ -1068,9 +1103,10 @@ export type MapEvent = /**
      * map.on('resize', function() {
      *   console.log('A resize event occurred.');
      * });
-     */ | 'resize'
+     */
+    | 'resize'
 
-/**
+    /**
      * Fired when the WebGL context is lost.
      *
      * @event webglcontextlost
@@ -1084,9 +1120,10 @@ export type MapEvent = /**
      * map.on('webglcontextlost', function() {
      *   console.log('A webglcontextlost event occurred.');
      * });
-     */ | 'webglcontextlost'
+     */
+    | 'webglcontextlost'
 
-/**
+    /**
      * Fired when the WebGL context is restored.
      *
      * @event webglcontextrestored
@@ -1100,9 +1137,10 @@ export type MapEvent = /**
      * map.on('webglcontextrestored', function() {
      *   console.log('A webglcontextrestored event occurred.');
      * });
-     */ | 'webglcontextrestored'
+     */
+    | 'webglcontextrestored'
 
-/**
+    /**
      * Fired immediately after all necessary resources have been downloaded
      * and the first visually complete rendering of the map has occurred.
      *
@@ -1121,9 +1159,10 @@ export type MapEvent = /**
      * @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'
+     */
+    | '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
@@ -1142,9 +1181,10 @@ export type MapEvent = /**
      * map.on('render', function() {
      *   console.log('A render event occurred.');
      * });
-     */ | 'render'
+     */
+    | 'render'
 
-/**
+    /**
      * Fired after the last frame rendered before the map enters an
      * "idle" state:
      *
@@ -1163,9 +1203,10 @@ export type MapEvent = /**
      * map.on('idle', function() {
      *   console.log('A idle event occurred.');
      * });
-     */ | 'idle'
+     */
+    | 'idle'
 
-/**
+    /**
      * Fired immediately after the map has been removed with {@link Map.event:remove}.
      *
      * @event remove
@@ -1179,9 +1220,10 @@ export type MapEvent = /**
      * map.on('remove', function() {
      *   console.log('A remove event occurred.');
      * });
-     */ | 'remove'
+     */
+    | '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
@@ -1199,9 +1241,10 @@ export type MapEvent = /**
      * map.on('error', function() {
      *   console.log('A error event occurred.');
      * });
-     */ | 'error'
+     */
+    | 'error'
 
-/**
+    /**
      * Fired when any map data loads or changes. See {@link MapDataEvent}
      * for more information.
      *
@@ -1218,9 +1261,10 @@ export type MapEvent = /**
      *   console.log('A data event occurred.');
      * });
      * @see [Display HTML clusters with custom properties](https://maplibre.org/maplibre-gl-js-docs/example/cluster-html/)
-     */ | 'data'
+     */
+    | 'data'
 
-/**
+    /**
      * Fired when the map's style loads or changes. See
      * {@link MapDataEvent} for more information.
      *
@@ -1236,9 +1280,10 @@ export type MapEvent = /**
      * map.on('styledata', function() {
      *   console.log('A styledata event occurred.');
      * });
-     */ | 'styledata'
+     */
+    | '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.
      *
@@ -1254,12 +1299,13 @@ export type MapEvent = /**
      * map.on('sourcedata', function() {
      *   console.log('A sourcedata event occurred.');
      * });
-     */ | 'sourcedata'
+     */
+    | '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.
+     * changing asyncronously. All `dataloading` events are followed by a `data`,
+     * `dataabort` or `error` event. See {@link MapDataEvent} for more information.
      *
      * @event dataloading
      * @memberof Map
@@ -1274,9 +1320,10 @@ export type MapEvent = /**
      * map.on('dataloading', function() {
      *   console.log('A dataloading event occurred.');
      * });
-     */ | 'dataloading'
+     */
+    | '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.
@@ -1294,11 +1341,12 @@ export type MapEvent = /**
      * map.on('styledataloading', function() {
      *   console.log('A styledataloading event occurred.');
      * });
-     */ | 'styledataloading'
+     */
+    | '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.
+     * All `sourcedataloading` events are followed by a `sourcedata`, `sourcedataabort` or `error` event.
      * See {@link MapDataEvent} for more information.
      *
      * @event sourcedataloading
@@ -1314,9 +1362,10 @@ export type MapEvent = /**
      * map.on('sourcedataloading', function() {
      *   console.log('A sourcedataloading event occurred.');
      * });
-     */ | 'sourcedataloading'
+     */
+    | '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.
@@ -1334,11 +1383,51 @@ export type MapEvent = /**
      *   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'
+     */
+    | 'styleimagemissing'
 
-/**
+    /**
      * @event style.load
      * @memberof Map
      * @instance
      * @private
-     */ | 'style.load';
+     */
+    | 'style.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 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';