maplibre-gl 3.2.0 → 3.2.1

package/dist/maplibre-gl-dev.js

@@ -1,4 +1,4 @@
-/* MapLibre GL JS is licensed under the 3-Clause BSD License. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v3.2.0/LICENSE.txt */
+/* MapLibre GL JS is licensed under the 3-Clause BSD License. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v3.2.1/LICENSE.txt */
 (function (global, factory) {
 typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
 typeof define === 'function' && define.amd ? define(factory) :
@@ -50,10 +50,7 @@ function getAugmentedNamespace(n) {
 	if (typeof f == "function") {
 		var a = function a () {
 			if (this instanceof a) {
-				var args = [null];
-				args.push.apply(args, arguments);
-				var Ctor = Function.bind.apply(f, args);
-				return new Ctor();
+        return Reflect.construct(f, arguments, this.constructor);
 			}
 			return f.apply(this, arguments);
 		};
@@ -5077,7 +5074,7 @@ function hslToRgb([h, s, l, alpha]) {
  * or `undefined` if the input is not a valid color string.
  */
 function parseCssColor(input) {
-    input = input.toLowerCase();
+    input = input.toLowerCase().trim();
     if (input === 'transparent') {
         return [0, 0, 0, 0];
     }
@@ -9002,7 +8999,7 @@ const filterSpec = {
  * passes its test.
  *
  * @private
- * @param {Array} filter maplibre gl filter
+ * @param {Array} filter MapLibre filter
  * @returns {Function} filter-evaluating function
  */
 function createFilter(filter) {
@@ -10723,7 +10720,7 @@ function validateGlyphsUrl(options) {
 }
 
 /**
- * Validate a MapLibre GL style against the style specification. This entrypoint,
+ * Validate a MapLibre style against the style specification. This entrypoint,
  * `maplibre-gl-style-spec/lib/validate_style.min`, is designed to produce as
  * small a browserify bundle as possible by omitting unnecessary functionality
  * and legacy style specifications.
@@ -31195,6 +31192,8 @@ class WorkerTile {
         this.collectResourceTiming = !!params.collectResourceTiming;
         this.returnDependencies = !!params.returnDependencies;
         this.promoteId = params.promoteId;
+        this.inFlightDependencies = [];
+        this.dependencySentinel = -1;
     }
     parse(data, layerIndex, availableImages, actor, callback) {
         this.status = 'parsing';
@@ -31259,40 +31258,53 @@ class WorkerTile {
         let iconMap;
         let patternMap;
         const stacks = performance.mapObject(options.glyphDependencies, (glyphs) => Object.keys(glyphs).map(Number));
+        this.inFlightDependencies.forEach((request) => request === null || request === void 0 ? void 0 : request.cancel());
+        this.inFlightDependencies = [];
+        // cancelling seems to be not sufficient, we seems to still manage to get a callback hit, so use a sentinel to drop stale results
+        const dependencySentinel = ++this.dependencySentinel;
         if (Object.keys(stacks).length) {
-            actor.send('getGlyphs', { uid: this.uid, stacks, source: this.source, tileID: this.tileID, type: 'glyphs' }, (err, result) => {
+            this.inFlightDependencies.push(actor.send('getGlyphs', { uid: this.uid, stacks, source: this.source, tileID: this.tileID, type: 'glyphs' }, (err, result) => {
+                if (dependencySentinel !== this.dependencySentinel) {
+                    return;
+                }
                 if (!error) {
                     error = err;
                     glyphMap = result;
                     maybePrepare.call(this);
                 }
-            });
+            }));
         }
         else {
             glyphMap = {};
         }
         const icons = Object.keys(options.iconDependencies);
         if (icons.length) {
-            actor.send('getImages', { icons, source: this.source, tileID: this.tileID, type: 'icons' }, (err, result) => {
+            this.inFlightDependencies.push(actor.send('getImages', { icons, source: this.source, tileID: this.tileID, type: 'icons' }, (err, result) => {
+                if (dependencySentinel !== this.dependencySentinel) {
+                    return;
+                }
                 if (!error) {
                     error = err;
                     iconMap = result;
                     maybePrepare.call(this);
                 }
-            });
+            }));
         }
         else {
             iconMap = {};
         }
         const patterns = Object.keys(options.patternDependencies);
         if (patterns.length) {
-            actor.send('getImages', { icons: patterns, source: this.source, tileID: this.tileID, type: 'patterns' }, (err, result) => {
+            this.inFlightDependencies.push(actor.send('getImages', { icons: patterns, source: this.source, tileID: this.tileID, type: 'patterns' }, (err, result) => {
+                if (dependencySentinel !== this.dependencySentinel) {
+                    return;
+                }
                 if (!error) {
                     error = err;
                     patternMap = result;
                     maybePrepare.call(this);
                 }
-            });
+            }));
         }
         else {
             patternMap = {};
@@ -31443,28 +31455,21 @@ class VectorTileWorkerSource {
      * Implements {@link WorkerSource#reloadTile}.
      */
     reloadTile(params, callback) {
-        const loaded = this.loaded, uid = params.uid, vtSource = this;
+        const loaded = this.loaded;
+        const uid = params.uid;
         if (loaded && loaded[uid]) {
             const workerTile = loaded[uid];
             workerTile.showCollisionBoxes = params.showCollisionBoxes;
-            const done = (err, data) => {
-                const reloadCallback = workerTile.reloadCallback;
-                if (reloadCallback) {
-                    delete workerTile.reloadCallback;
-                    workerTile.parse(workerTile.vectorTile, vtSource.layerIndex, this.availableImages, vtSource.actor, reloadCallback);
-                }
-                callback(err, data);
-            };
             if (workerTile.status === 'parsing') {
-                workerTile.reloadCallback = done;
+                workerTile.parse(workerTile.vectorTile, this.layerIndex, this.availableImages, this.actor, callback);
             }
             else if (workerTile.status === 'done') {
                 // if there was no vector tile data on the initial load, don't try and re-parse tile
                 if (workerTile.vectorTile) {
-                    workerTile.parse(workerTile.vectorTile, this.layerIndex, this.availableImages, this.actor, done);
+                    workerTile.parse(workerTile.vectorTile, this.layerIndex, this.availableImages, this.actor, callback);
                 }
                 else {
-                    done();
+                    callback();
                 }
             }
         }
@@ -33711,7 +33716,7 @@ define(['./shared'], (function (performance) { 'use strict';
 
 var name = "maplibre-gl";
 var description = "BSD licensed community fork of mapbox-gl, a WebGL interactive maps library";
-var version$2 = "3.2.0";
+var version$2 = "3.2.1";
 var main = "dist/maplibre-gl.js";
 var style = "dist/maplibre-gl.css";
 var license = "BSD-3-Clause";
@@ -33730,11 +33735,12 @@ var dependencies = {
 	"@mapbox/unitbezier": "^0.0.1",
 	"@mapbox/vector-tile": "^1.3.1",
 	"@mapbox/whoots-js": "^3.1.0",
-	"@maplibre/maplibre-gl-style-spec": "^19.2.1",
+	"@maplibre/maplibre-gl-style-spec": "^19.2.2",
 	"@types/geojson": "^7946.0.10",
 	"@types/mapbox__point-geometry": "^0.1.2",
 	"@types/mapbox__vector-tile": "^1.3.0",
 	"@types/pbf": "^3.0.2",
+	"@types/supercluster": "^7.1.0",
 	earcut: "^2.2.4",
 	"geojson-vt": "^3.2.1",
 	"gl-matrix": "^3.4.3",
@@ -33751,7 +33757,7 @@ var dependencies = {
 var devDependencies = {
 	"@mapbox/mapbox-gl-rtl-text": "^0.2.3",
 	"@mapbox/mvt-fixtures": "^3.10.0",
-	"@rollup/plugin-commonjs": "^25.0.2",
+	"@rollup/plugin-commonjs": "^25.0.3",
 	"@rollup/plugin-json": "^6.0.0",
 	"@rollup/plugin-node-resolve": "^15.1.0",
 	"@rollup/plugin-replace": "^5.0.2",
@@ -33763,49 +33769,48 @@ var devDependencies = {
 	"@types/d3": "^7.4.0",
 	"@types/diff": "^5.0.3",
 	"@types/earcut": "^2.1.1",
-	"@types/eslint": "^8.40.2",
+	"@types/eslint": "^8.44.0",
 	"@types/gl": "^6.0.2",
 	"@types/glob": "^8.1.0",
-	"@types/jest": "^29.5.2",
+	"@types/jest": "^29.5.3",
 	"@types/jsdom": "^21.1.1",
 	"@types/minimist": "^1.2.2",
 	"@types/murmurhash-js": "^1.0.4",
 	"@types/nise": "^1.4.1",
-	"@types/node": "^20.3.3",
+	"@types/node": "^20.4.4",
 	"@types/offscreencanvas": "^2019.7.0",
 	"@types/pixelmatch": "^5.2.4",
 	"@types/pngjs": "^6.0.1",
-	"@types/react": "^18.2.14",
-	"@types/react-dom": "^18.2.6",
+	"@types/react": "^18.2.15",
+	"@types/react-dom": "^18.2.7",
 	"@types/request": "^2.48.8",
 	"@types/shuffle-seed": "^1.1.0",
-	"@types/supercluster": "^7.1.0",
 	"@types/window-or-global": "^1.0.4",
-	"@typescript-eslint/eslint-plugin": "^5.60.1",
-	"@typescript-eslint/parser": "^5.60.1",
+	"@typescript-eslint/eslint-plugin": "^5.61.0",
+	"@typescript-eslint/parser": "^5.62.0",
 	address: "^1.2.2",
 	benchmark: "^2.1.4",
 	canvas: "^2.11.2",
 	cssnano: "^6.0.1",
 	d3: "^7.8.5",
 	"d3-queue": "^3.0.7",
-	"devtools-protocol": "^0.0.1165014",
+	"devtools-protocol": "^0.0.1170846",
 	diff: "^5.1.0",
 	"dts-bundle-generator": "^8.0.1",
-	eslint: "^8.44.0",
+	eslint: "^8.45.0",
 	"eslint-config-mourner": "^3.0.0",
 	"eslint-plugin-html": "^7.1.0",
 	"eslint-plugin-import": "^2.27.5",
-	"eslint-plugin-jest": "^27.2.2",
+	"eslint-plugin-jest": "^27.2.3",
 	"eslint-plugin-tsdoc": "0.2.17",
-	"eslint-plugin-react": "^7.32.2",
+	"eslint-plugin-react": "^7.33.0",
 	expect: "^29.5.0",
 	gl: "^6.0.2",
-	glob: "^10.3.1",
+	glob: "^10.3.3",
 	"is-builtin-module": "^3.2.1",
-	jest: "^29.5.0",
+	jest: "^29.6.1",
 	"jest-canvas-mock": "^2.5.2",
-	"jest-environment-jsdom": "^29.5.0",
+	"jest-environment-jsdom": "^29.6.1",
 	jsdom: "^22.1.0",
 	"json-stringify-pretty-compact": "^4.0.0",
 	minimist: "^1.2.8",
@@ -33817,22 +33822,22 @@ var devDependencies = {
 	"pdf-merger-js": "^4.3.0",
 	pixelmatch: "^5.3.0",
 	pngjs: "^7.0.0",
-	postcss: "^8.4.24",
+	postcss: "^8.4.26",
 	"postcss-cli": "^10.1.0",
 	"postcss-inline-svg": "^6.0.0",
-	"pretty-bytes": "^6.1.0",
-	puppeteer: "^20.7.4",
+	"pretty-bytes": "^6.1.1",
+	puppeteer: "^20.9.0",
 	react: "^18.2.0",
 	"react-dom": "^18.2.0",
-	rollup: "^3.26.0",
+	rollup: "^3.26.3",
 	"rollup-plugin-sourcemaps": "^0.6.3",
 	rw: "^1.3.3",
-	semver: "^7.5.3",
+	semver: "^7.5.4",
 	"shuffle-seed": "^1.1.6",
 	"source-map-explorer": "^2.5.3",
 	st: "^3.0.0",
-	stylelint: "^15.10.1",
-	"stylelint-config-standard": "^33.0.0",
+	stylelint: "^15.10.2",
+	"stylelint-config-standard": "^34.0.0",
 	"ts-jest": "^29.1.1",
 	"ts-node": "^10.9.1",
 	tslib: "^2.6.0",
@@ -36069,16 +36074,6 @@ class RasterDEMTileSource extends RasterTileSource {
         this._options = performance.extend({ type: 'raster-dem' }, options);
         this.encoding = options.encoding || 'mapbox';
     }
-    serialize() {
-        return {
-            type: 'raster-dem',
-            url: this.url,
-            tileSize: this.tileSize,
-            tiles: this.tiles,
-            bounds: this.bounds,
-            encoding: this.encoding
-        };
-    }
     loadTile(tile, callback) {
         const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme);
         tile.request = ImageRequest.getImage(this.map._requestManager.transformRequest(url, ResourceType.Tile), imageLoaded.bind(this), this.map._refreshExpiredTiles);
@@ -42923,7 +42918,7 @@ function getTokenizedAttributesAndUniforms(array) {
  * A webgl program to execute in the GPU space
  */
 class Program {
-    constructor(context, name, source, configuration, fixedUniforms, showOverdrawInspector, terrain) {
+    constructor(context, source, configuration, fixedUniforms, showOverdrawInspector, terrain) {
         const gl = context.gl;
         this.program = gl.createProgram();
         const staticAttrInfo = getTokenizedAttributesAndUniforms(source.staticAttributes);
@@ -46198,7 +46193,7 @@ class Painter {
             (this._showOverdrawInspector ? '/overdraw' : '') +
             (this.style.map.terrain ? '/terrain' : '');
         if (!this.cache[key]) {
-            this.cache[key] = new Program(this.context, name, shaders[name], programConfiguration, programUniforms[name], this._showOverdrawInspector, this.style.map.terrain);
+            this.cache[key] = new Program(this.context, shaders[name], programConfiguration, programUniforms[name], this._showOverdrawInspector, this.style.map.terrain);
         }
         return this.cache[key];
     }
@@ -46452,7 +46447,6 @@ class Transform {
     constructor(minZoom, maxZoom, minPitch, maxPitch, renderWorldCopies) {
         this.tileSize = 512; // constant
         this.maxValidLatitude = 85.051129; // constant
-        this.freezeElevation = false;
         this._renderWorldCopies = renderWorldCopies === undefined ? true : !!renderWorldCopies;
         this._minZoom = minZoom || 0;
         this._maxZoom = maxZoom || 22;
@@ -46471,6 +46465,7 @@ class Transform {
         this._edgeInsets = new EdgeInsets();
         this._posMatrixCache = {};
         this._alignedPosMatrixCache = {};
+        this._minEleveationForCurrentTile = 0;
     }
     clone() {
         const clone = new Transform(this._minZoom, this._maxZoom, this._minPitch, this.maxPitch, this._renderWorldCopies);
@@ -46484,6 +46479,7 @@ class Transform {
         this.height = that.height;
         this._center = that._center;
         this._elevation = that._elevation;
+        this._minEleveationForCurrentTile = that._minEleveationForCurrentTile;
         this.zoom = that.zoom;
         this.angle = that.angle;
         this._fov = that._fov;
@@ -46795,29 +46791,6 @@ class Transform {
         return new performance.MercatorCoordinate(point.x / this.worldSize, point.y / this.worldSize).toLngLat();
     }
     get point() { return this.project(this.center); }
-    /**
-     * Updates the center-elevation value unless freezeElevation is activated.
-     * @param terrain - the terrain
-     */
-    updateElevation(terrain) {
-        if (this.freezeElevation)
-            return;
-        this.elevation = terrain ? this.getElevation(this._center, terrain) : 0;
-    }
-    /**
-     * get the elevation from terrain for the current zoomlevel.
-     * @param lnglat - the location
-     * @param terrain - the terrain
-     * @returns elevation in meters
-     */
-    getElevation(lnglat, terrain) {
-        const merc = performance.MercatorCoordinate.fromLngLat(lnglat.wrap());
-        const worldSize = (1 << this.tileZoom) * performance.EXTENT;
-        const mercX = merc.x * worldSize, mercY = merc.y * worldSize;
-        const tileX = Math.floor(mercX / performance.EXTENT), tileY = Math.floor(mercY / performance.EXTENT);
-        const tileID = new performance.OverscaledTileID(this.tileZoom, 0, this.tileZoom, tileX, tileY);
-        return terrain.getElevation(tileID, mercX % performance.EXTENT, mercY % performance.EXTENT, performance.EXTENT);
-    }
     /**
      * get the camera position in LngLat and altitudes in meter
      * @returns An object with lngLat & altitude.
@@ -46836,7 +46809,7 @@ class Transform {
     recalculateZoom(terrain) {
         // find position the camera is looking on
         const center = this.pointLocation(this.centerPoint, terrain);
-        const elevation = this.getElevation(center, terrain);
+        const elevation = terrain.getElevationForLngLatZoom(center, this.tileZoom);
         const deltaElevation = this.elevation - elevation;
         if (!deltaElevation)
             return;
@@ -46871,7 +46844,7 @@ class Transform {
      */
     locationPoint(lnglat, terrain) {
         return terrain ?
-            this.coordinatePoint(this.locationCoordinate(lnglat), this.getElevation(lnglat, terrain), this.pixelMatrix3D) :
+            this.coordinatePoint(this.locationCoordinate(lnglat), terrain.getElevationForLngLatZoom(lnglat, this.tileZoom), this.pixelMatrix3D) :
             this.coordinatePoint(this.locationCoordinate(lnglat));
     }
     /**
@@ -47091,9 +47064,11 @@ class Transform {
         performance.scale(m, m, [2 / this.width, 2 / this.height, 1]);
         this.glCoordMatrix = m;
         // Calculate the camera to sea-level distance in pixel in respect of terrain
-        // In case of negative elevation (e.g. the dead see) use the lower plane for calculation
-        this.cameraToSeaLevelDistance = this.cameraToCenterDistance + this._elevation * this._pixelPerMeter / Math.cos(this._pitch);
-        const lowestPlane = this._elevation < 0 ? this.cameraToCenterDistance : this.cameraToSeaLevelDistance;
+        const cameraToSeaLevelDistance = this.cameraToCenterDistance + this._elevation * this._pixelPerMeter / Math.cos(this._pitch);
+        // In case of negative minimum elevation (e.g. the dead see, under the sea maps) use a lower plane for calculation
+        const minElevation = Math.min(this.elevation, this._minEleveationForCurrentTile);
+        const cameraToLowestPointDistance = cameraToSeaLevelDistance - minElevation * this._pixelPerMeter / Math.cos(this._pitch);
+        const lowestPlane = minElevation < 0 ? cameraToLowestPointDistance : cameraToSeaLevelDistance;
         // Find the distance from the center point [width/2 + offset.x, height/2 + offset.y] to the
         // center top point [width/2 + offset.x, 0] in Z units, using the law of sines.
         // 1 Z unit is equivalent to 1 horizontal px at the center of the map
@@ -49775,10 +49750,10 @@ class HandlerManager {
                 (combinedEventsInProgress.drag || combinedEventsInProgress.zoom)) {
                 // When starting to drag or move, flag it and register moveend to clear flagging
                 this._terrainMovement = true;
-                tr.freezeElevation = true;
+                this._map._elevationFreeze = true;
                 tr.setLocationAtPoint(loc, around);
                 this._map.once('moveend', () => {
-                    tr.freezeElevation = false;
+                    this._map._elevationFreeze = false;
                     this._terrainMovement = false;
                     tr.recalculateZoom(map.terrain);
                 });
@@ -49912,10 +49887,10 @@ class Camera extends performance.Evented {
     /**
      * Sets the map's geographical centerpoint. Equivalent to `jumpTo({center: center})`.
      *
+     * Triggers the following events: `movestart` and `moveend`.
+     *
      * @param center - The centerpoint to set.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @example
      * ```ts
@@ -49928,11 +49903,11 @@ class Camera extends performance.Evented {
     /**
      * Pans the map by the specified offset.
      *
+     * Triggers the following events: `movestart` and `moveend`.
+     *
      * @param offset - `x` and `y` coordinates by which to pan the map.
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @see [Navigate the map with game-like controls](https://maplibre.org/maplibre-gl-js/docs/examples/game-controls/)
      */
@@ -49943,11 +49918,11 @@ class Camera extends performance.Evented {
     /**
      * Pans the map to the specified location with an animated transition.
      *
+     * Triggers the following events: `movestart` and `moveend`.
+     *
      * @param lnglat - The location to pan the map to.
      * @param options - Options describing the destination and animation of the transition.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @example
      * ```ts
@@ -49975,14 +49950,10 @@ class Camera extends performance.Evented {
     /**
      * Sets the map's zoom level. Equivalent to `jumpTo({zoom: zoom})`.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`.
+     *
      * @param zoom - The zoom level to set (0-20).
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `move`
-     * @event `zoom`
-     * @event `moveend`
-     * @event `zoomend`
      * @returns `this`
      * @example
      * Zoom to the zoom level 5 without an animated transition
@@ -49997,15 +49968,11 @@ class Camera extends performance.Evented {
     /**
      * Zooms the map to the specified zoom level, with an animated transition.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`.
+     *
      * @param zoom - The zoom level to transition to.
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `move`
-     * @event `zoom`
-     * @event `moveend`
-     * @event `zoomend`
      * @returns `this`
      * @example
      * ```ts
@@ -50026,14 +49993,10 @@ class Camera extends performance.Evented {
     /**
      * Increases the map's zoom level by 1.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`.
+     *
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `move`
-     * @event `zoom`
-     * @event `moveend`
-     * @event `zoomend`
      * @returns `this`
      * @example
      * Zoom the map in one level with a custom animation duration
@@ -50048,14 +50011,10 @@ class Camera extends performance.Evented {
     /**
      * Decreases the map's zoom level by 1.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`.
+     *
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `move`
-     * @event `zoom`
-     * @event `moveend`
-     * @event `zoomend`
      * @returns `this`
      * @example
      * Zoom the map out one level with a custom animation offset
@@ -50081,10 +50040,10 @@ class Camera extends performance.Evented {
      *
      * Equivalent to `jumpTo({bearing: bearing})`.
      *
+     * Triggers the following events: `movestart`, `moveend`, and `rotate`.
+     *
      * @param bearing - The desired bearing.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @example
      * Rotate the map to 90 degrees
@@ -50107,10 +50066,10 @@ class Camera extends performance.Evented {
      *
      * Equivalent to `jumpTo({padding: padding})`.
      *
+     * Triggers the following events: `movestart` and `moveend`.
+     *
      * @param padding - The desired padding.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @example
      * Sets a left padding of 300px, and a top padding of 50px
@@ -50126,11 +50085,11 @@ class Camera extends performance.Evented {
      * Rotates the map to the specified bearing, with an animated transition. The bearing is the compass direction
      * that is "up"; for example, a bearing of 90° orients the map so that east is up.
      *
+     * Triggers the following events: `movestart`, `moveend`, and `rotate`.
+     *
      * @param bearing - The desired bearing.
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      */
     rotateTo(bearing, options, eventData) {
@@ -50141,10 +50100,10 @@ class Camera extends performance.Evented {
     /**
      * Rotates the map so that north is up (0° bearing), with an animated transition.
      *
+     * Triggers the following events: `movestart`, `moveend`, and `rotate`.
+     *
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      */
     resetNorth(options, eventData) {
@@ -50154,10 +50113,10 @@ class Camera extends performance.Evented {
     /**
      * Rotates and pitches the map so that north is up (0° bearing) and pitch is 0°, with an animated transition.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `pitchstart`, `pitch`, `pitchend`, and `rotate`.
+     *
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      */
     resetNorthPitch(options, eventData) {
@@ -50172,10 +50131,10 @@ class Camera extends performance.Evented {
      * Snaps the map so that north is up (0° bearing), if the current bearing is close enough to it (i.e. within the
      * `bearingSnap` threshold).
      *
+     * Triggers the following events: `movestart`, `moveend`, and `rotate`.
+     *
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      */
     snapToNorth(options, eventData) {
@@ -50193,11 +50152,10 @@ class Camera extends performance.Evented {
     /**
      * Sets the map's pitch (tilt). Equivalent to `jumpTo({pitch: pitch})`.
      *
+     * Triggers the following events: `movestart`, `moveend`, `pitchstart`, and `pitchend`.
+     *
      * @param pitch - The pitch to set, measured in degrees away from the plane of the screen (0-60).
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `pitchstart`
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      */
     setPitch(pitch, eventData) {
@@ -50305,12 +50263,12 @@ class Camera extends performance.Evented {
      * Pans and zooms the map to contain its visible area within the specified geographical bounds.
      * This function will also reset the map's bearing to 0 if bearing is nonzero.
      *
+     * Triggers the following events: `movestart` and `moveend`.
+     *
      * @param bounds - Center these bounds in the viewport and use the highest
      * zoom level up to and including `Map#getMaxZoom()` that fits them in the viewport.
      * @param options- Options supports all properties from {@link AnimationOptions} and {@link CameraOptions} in addition to the fields below.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @example
      * ```ts
@@ -50329,13 +50287,13 @@ class Camera extends performance.Evented {
      * once the map is rotated to the specified bearing. To zoom without rotating,
      * pass in the current map bearing.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend` and `rotate`.
+     *
      * @param p0 - First point on screen, in pixel coordinates
      * @param p1 - Second point on screen, in pixel coordinates
      * @param bearing - Desired map bearing at end of animation, in degrees
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `moveend`
      * @returns `this`
      * @example
      * ```ts
@@ -50366,18 +50324,11 @@ class Camera extends performance.Evented {
      * an animated transition. The map will retain its current values for any
      * details not specified in `options`.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend`, `pitchstart`,
+     * `pitch`, `pitchend`, and `rotate`.
+     *
      * @param options - Options object
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `pitchstart`
-     * @event `rotate`
-     * @event `move`
-     * @event `zoom`
-     * @event `pitch`
-     * @event `moveend`
-     * @event `zoomend`
-     * @event `pitchend`
      * @returns `this`
      * @example
      * ```ts
@@ -50475,19 +50426,12 @@ class Camera extends performance.Evented {
      * the `reduced motion` accessibility feature enabled in their operating system,
      * unless `options` includes `essential: true`.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend`, `pitchstart`,
+     * `pitch`, `pitchend`, and `rotate`.
+     *
      * @param options - Options describing the destination and animation of the transition.
      * Accepts {@link CameraOptions} and {@link AnimationOptions}.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `pitchstart`
-     * @event `rotate`
-     * @event `move`
-     * @event `zoom`
-     * @event `pitch`
-     * @event `moveend`
-     * @event `zoomend`
-     * @event `pitchend`
      * @returns `this`
      * @see [Navigate the map with game-like controls](https://maplibre.org/maplibre-gl-js/docs/examples/game-controls/)
      */
@@ -50585,11 +50529,12 @@ class Camera extends performance.Evented {
     _prepareElevation(center) {
         this._elevationCenter = center;
         this._elevationStart = this.transform.elevation;
-        this._elevationTarget = this.transform.getElevation(center, this.terrain);
-        this.transform.freezeElevation = true;
+        this._elevationTarget = this.terrain.getElevationForLngLatZoom(center, this.transform.tileZoom);
+        this._elevationFreeze = true;
     }
     _updateElevation(k) {
-        const elevation = this.transform.getElevation(this._elevationCenter, this.terrain);
+        this.transform._minEleveationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this._elevationCenter, this.transform.tileZoom);
+        const elevation = this.terrain.getElevationForLngLatZoom(this._elevationCenter, this.transform.tileZoom);
         // target terrain updated during flight, slowly move camera to new height
         if (k < 1 && elevation !== this._elevationTarget) {
             const pitch1 = this._elevationTarget - this._elevationStart;
@@ -50600,7 +50545,7 @@ class Camera extends performance.Evented {
         this.transform.elevation = performance.interpolate.number(this._elevationStart, this._elevationTarget, k);
     }
     _finalizeElevation() {
-        this.transform.freezeElevation = false;
+        this._elevationFreeze = false;
         this.transform.recalculateZoom(this.terrain);
     }
     /**
@@ -50608,6 +50553,7 @@ class Camera extends performance.Evented {
      * If `transformCameraUpdate` is specified, a copy of the current transform is created to track the accumulated changes.
      * This underlying transform represents the "desired state" proposed by input handlers / animations / UI controls.
      * It may differ from the state used for rendering (`this.transform`).
+     * @hidden
      * @returns Transform to apply changes to
      */
     _getTransformForUpdate() {
@@ -50620,6 +50566,7 @@ class Camera extends performance.Evented {
     }
     /**
      * Called after the camera is done being manipulated.
+     * @hidden
      * @param tr - the requested camera end state
      * Call `transformCameraUpdate` if present, and then apply the "approved" changes.
      */
@@ -50687,20 +50634,13 @@ class Camera extends performance.Evented {
      * if the user has the `reduced motion` accessibility feature enabled in their operating system,
      * unless 'options' includes `essential: true`.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend`, `pitchstart`,
+     * `pitch`, `pitchend`, and `rotate`.
+     *
      * @param options - Options describing the destination and animation of the transition.
      * Accepts {@link CameraOptions}, {@link AnimationOptions},
      * and the following additional options.
      * @param eventData - Additional properties to be added to event objects of events triggered by this method.
-     * @event `movestart`
-     * @event `zoomstart`
-     * @event `pitchstart`
-     * @event `move`
-     * @event `zoom`
-     * @event `rotate`
-     * @event `pitch`
-     * @event `moveend`
-     * @event `zoomend`
-     * @event `pitchend`
      * @returns `this`
      * @example
      * ```ts
@@ -50929,9 +50869,9 @@ class Camera extends performance.Evented {
         if (!this.terrain) {
             return null;
         }
-        const elevation = this.transform.getElevation(performance.LngLat.convert(lngLatLike), this.terrain);
+        const elevation = this.terrain.getElevationForLngLatZoom(performance.LngLat.convert(lngLatLike), this.transform.tileZoom);
         /**
-         * Different zoomlevels with different terrain-tiles the elvation-values are not the same.
+         * Different zoomlevels with different terrain-tiles the elevation-values are not the same.
          * map.transform.elevation variable with the center-altitude.
          * In maplibre the proj-matrix is translated by this value in negative z-direction.
          * So we need to add this value to the elevation to get the correct value.
@@ -51451,7 +51391,17 @@ class Terrain {
             dem.get(cx + 1, cy + 1) * (tx) * (ty));
     }
     /**
-     * get the Elevation for given coordinate in respect of exaggeration.
+     * Get the elevation for given {@link LngLat} in respect of exaggeration.
+     * @param lnglat - the location
+     * @param zoom - the zoom
+     * @returns the elevation
+     */
+    getElevationForLngLatZoom(lnglat, zoom) {
+        const { tileID, mercatorX, mercatorY } = this._getOverscaledTileIDFromLngLatZoom(lnglat, zoom);
+        return this.getElevation(tileID, mercatorX % performance.EXTENT, mercatorY % performance.EXTENT, performance.EXTENT);
+    }
+    /**
+     * Get the elevation for given coordinate in respect of exaggeration.
      * @param tileID - the tile id
      * @param x - between 0 .. EXTENT
      * @param y - between 0 .. EXTENT
@@ -51665,6 +51615,11 @@ class Terrain {
         // divide by 5 is evaluated by trial & error to get a frame in the right height
         return 2 * Math.PI * performance.earthRadius / Math.pow(2, zoom) / 5;
     }
+    getMinTileElevationForLngLatZoom(lnglat, zoom) {
+        var _a;
+        const { tileID } = this._getOverscaledTileIDFromLngLatZoom(lnglat, zoom);
+        return (_a = this.getMinMaxElevation(tileID).minElevation) !== null && _a !== void 0 ? _a : 0;
+    }
     /**
      * Get the minimum and maximum elevation contained in a tile. This includes any
      * exaggeration included in the terrain.
@@ -51682,6 +51637,19 @@ class Terrain {
         }
         return minMax;
     }
+    _getOverscaledTileIDFromLngLatZoom(lnglat, zoom) {
+        const mercatorCoordinate = performance.MercatorCoordinate.fromLngLat(lnglat.wrap());
+        const worldSize = (1 << zoom) * performance.EXTENT;
+        const mercatorX = mercatorCoordinate.x * worldSize;
+        const mercatorY = mercatorCoordinate.y * worldSize;
+        const tileX = Math.floor(mercatorX / performance.EXTENT), tileY = Math.floor(mercatorY / performance.EXTENT);
+        const tileID = new performance.OverscaledTileID(zoom, 0, zoom, tileX, tileY);
+        return {
+            tileID,
+            mercatorX,
+            mercatorY
+        };
+    }
 }
 
 /**
@@ -51934,7 +51902,7 @@ const defaultOptions$4 = {
     fadeDuration: 300,
     crossSourceCollisions: true,
     validateStyle: true,
-    /** Because GL MAX_TEXTURE_SIZE is usually at least 4096px. */
+    /**Because GL MAX_TEXTURE_SIZE is usually at least 4096px. */
     maxCanvasSize: [4096, 4096]
 };
 /**
@@ -52125,6 +52093,7 @@ let Map$1 = class Map extends Camera {
     /**
      * Returns a unique number for this map instance which is used for the MapLoadEvent
      * to make sure we only fire one event per instantiated map object.
+     * @hidden
      * @returns the uniq map ID
      */
     _getMapId() {
@@ -52133,6 +52102,8 @@ let Map$1 = class Map extends Camera {
     /**
      * Adds an {@link IControl} to the map, calling `control.onAdd(this)`.
      *
+     * An {@link ErrorEvent} will be fired if the image parameter is invald.
+     *
      * @param control - The {@link IControl} to add.
      * @param position - position on the map to which the control will be added.
      * Valid values are `'top-left'`, `'top-right'`, `'bottom-left'`, and `'bottom-right'`. Defaults to `'top-right'`.
@@ -52170,6 +52141,8 @@ let Map$1 = class Map extends Camera {
     /**
      * Removes the control from the map.
      *
+     * An {@link ErrorEvent} will be fired if the image parameter is invald.
+     *
      * @param control - The {@link IControl} to remove.
      * @returns `this`
      * @example
@@ -52212,7 +52185,7 @@ let Map$1 = class Map extends Camera {
     }
     calculateCameraOptionsFromTo(from, altitudeFrom, to, altitudeTo) {
         if (altitudeTo == null && this.terrain) {
-            altitudeTo = this.transform.getElevation(to, this.terrain);
+            altitudeTo = this.terrain.getElevationForLngLatZoom(to, this.transform.tileZoom);
         }
         return super.calculateCameraOptionsFromTo(from, altitudeFrom, to, altitudeTo);
     }
@@ -52224,6 +52197,8 @@ let Map$1 = class Map extends Camera {
      * This method must be called after the map's `container` is resized programmatically
      * or when the map is shown after being initially hidden with CSS.
      *
+     * Triggers the following events: `movestart`, `move`, `moveend`, and `resize`.
+     *
      * @param eventData - Additional properties to be passed to `movestart`, `move`, `resize`, and `moveend`
      * events that get triggered as a result of resize. This can be useful for differentiating the
      * source of an event (for example, user-initiated or programmatically-triggered events).
@@ -52265,9 +52240,10 @@ let Map$1 = class Map extends Camera {
             this.fire(new performance.Event('moveend', eventData));
         return this;
     }
-    /*
+    /**
      * Return the map's pixel ratio eventually scaled down to respect maxCanvasSize.
      * Internally you should use this and not getPixelRatio().
+     * @hidden
      */
     _getClampedPixelRatio(width, height) {
         const { 0: maxCanvasWidth, 1: maxCanvasHeight } = this._maxCanvasSize;
@@ -52358,6 +52334,8 @@ let Map$1 = class Map extends Camera {
      * if the map is 512px tall it will not be possible to zoom below zoom 0
      * no matter what the `minZoom` is set to.
      *
+     * A {@link ErrorEvent} event will be fired if minZoom is out of bounds.
+     *
      * @param minZoom - The minimum zoom level to set (-2 - 24).
      * If `null` or `undefined` is provided, the function removes the current minimum zoom (i.e. sets it to -2).
      * @returns `this`
@@ -52393,6 +52371,8 @@ let Map$1 = class Map extends Camera {
      * If the map's current zoom level is higher than the new maximum,
      * the map will zoom to the new maximum.
      *
+     * A {@link ErrorEvent} event will be fired if minZoom is out of bounds.
+     *
      * @param maxZoom - The maximum zoom level to set.
      * If `null` or `undefined` is provided, the function removes the current maximum zoom (sets it to 22).
      * @returns `this`
@@ -52428,6 +52408,8 @@ let Map$1 = class Map extends Camera {
      * If the map's current pitch is lower than the new minimum,
      * the map will pitch to the new minimum.
      *
+     * A {@link ErrorEvent} event will be fired if minPitch is out of bounds.
+     *
      * @param minPitch - The minimum pitch to set (0-85). Values greater than 60 degrees are experimental and may result in rendering issues. If you encounter any, please raise an issue with details in the MapLibre project.
      * If `null` or `undefined` is provided, the function removes the current minimum pitch (i.e. sets it to 0).
      * @returns `this`
@@ -52458,6 +52440,8 @@ let Map$1 = class Map extends Camera {
      * If the map's current pitch is higher than the new maximum,
      * the map will pitch to the new maximum.
      *
+     * A {@link ErrorEvent} event will be fired if maxPitch is out of bounds.
+     *
      * @param maxPitch - The maximum pitch to set (0-85). Values greater than 60 degrees are experimental and may result in rendering issues. If you encounter any, please raise an issue with details in the MapLibre project.
      * If `null` or `undefined` is provided, the function removes the current maximum pitch (sets it to 60).
      * @returns `this`
@@ -52661,13 +52645,6 @@ let Map$1 = class Map extends Camera {
             return { layer: layerId, listener, delegates: { [type]: delegate } };
         }
     }
-    /**
-     * This is an overload of the `on` method that allows to listen to events based on the `layerId`
-     * @param type - The type of the event.
-     * @param layerIdOrListener - The ID of the layer.
-     * @param listener - The listener callback.
-     * @returns `this`
-     */
     on(type, layerIdOrListener, listener) {
         if (listener === undefined) {
             return super.on(type, layerIdOrListener);
@@ -53026,11 +53003,14 @@ let Map$1 = class Map extends Camera {
     /**
      * Adds a source to the map's style.
      *
+     * Events triggered:
+     *
+     * Triggers the `source.add` event.
+     *
      * @param id - The ID of the source to add. Must not conflict with existing sources.
      * @param source - The source object, conforming to the
-     * MapLibre Style Specification's [source definition](https://maplibre.org/maplibre-style-spec/#sources) or
+     * MapLibre Style Specification's [source definition](https://maplibre.org/maplibre-style-spec/sources) or
      * {@link CanvasSourceSpecification}.
-     * @event `source.add`
      * @returns `this`
      * @example
      * ```ts
@@ -53067,6 +53047,8 @@ let Map$1 = class Map extends Camera {
      * Returns a Boolean indicating whether the source is loaded. Returns `true` if the source with
      * the given ID in the map's style has no outstanding network requests, otherwise `false`.
      *
+     * A {@link ErrorEvent} event will be fired if there is no source wit the specified ID.
+     *
      * @param id - The ID of the source to be checked.
      * @returns A Boolean indicating whether the source is loaded.
      * @example
@@ -53084,6 +53066,9 @@ let Map$1 = class Map extends Camera {
     }
     /**
      * Loads a 3D terrain mesh, based on a "raster-dem" source.
+     *
+     * Triggers the `terrain` event.
+     *
      * @param options - Options object.
      * @returns `this`
      * @example
@@ -53104,7 +53089,8 @@ let Map$1 = class Map extends Camera {
             if (this.painter.renderToTexture)
                 this.painter.renderToTexture.destruct();
             this.painter.renderToTexture = null;
-            this.transform.updateElevation(this.terrain);
+            this.transform._minEleveationForCurrentTile = 0;
+            this.transform.elevation = 0;
         }
         else {
             // add terrain
@@ -53120,14 +53106,17 @@ let Map$1 = class Map extends Camera {
             }
             this.terrain = new Terrain(this.painter, sourceCache, options);
             this.painter.renderToTexture = new RenderToTexture(this.painter, this.terrain);
-            this.transform.updateElevation(this.terrain);
+            this.transform._minEleveationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this.transform.center, this.transform.tileZoom);
+            this.transform.elevation = this.terrain.getElevationForLngLatZoom(this.transform.center, this.transform.tileZoom);
             this._terrainDataCallback = e => {
                 if (e.dataType === 'style') {
                     this.terrain.sourceCache.freeRtt();
                 }
                 else if (e.dataType === 'source' && e.tile) {
-                    if (e.sourceId === options.source)
-                        this.transform.updateElevation(this.terrain);
+                    if (e.sourceId === options.source && !this._elevationFreeze) {
+                        this.transform._minEleveationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this.transform.center, this.transform.tileZoom);
+                        this.transform.elevation = this.terrain.getElevationForLngLatZoom(this.transform.center, this.transform.tileZoom);
+                    }
                     this.terrain.sourceCache.freeRtt(e.tile.tileID);
                 }
             };
@@ -53223,11 +53212,12 @@ let Map$1 = class Map extends Camera {
     /**
      * Add an image to the style. This image can be displayed on the map like any other icon in the style's
      * sprite using the image's ID with
-     * [`icon-image`](https://maplibre.org/maplibre-style-spec/#layout-symbol-icon-image),
-     * [`background-pattern`](https://maplibre.org/maplibre-style-spec/#paint-background-background-pattern),
-     * [`fill-pattern`](https://maplibre.org/maplibre-style-spec/#paint-fill-fill-pattern),
-     * or [`line-pattern`](https://maplibre.org/maplibre-style-spec/#paint-line-line-pattern).
-     * A {@link ErrorEvent} event will be fired if there is not enough space in the sprite to add this image.
+     * [`icon-image`](https://maplibre.org/maplibre-style-spec/layers/#layout-symbol-icon-image),
+     * [`background-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-background-background-pattern),
+     * [`fill-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-fill-fill-pattern),
+     * or [`line-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-line-line-pattern).
+     *
+     * A {@link ErrorEvent} event will be fired if the image parameter is invalid or there is not enough space in the sprite to add this image.
      *
      * @param id - The ID of the image.
      * @param image - The image as an `HTMLImageElement`, `ImageData`, `ImageBitmap` or object with `width`, `height`, and `data`
@@ -53293,10 +53283,12 @@ let Map$1 = class Map extends Camera {
     /**
      * Update an existing image in a style. This image can be displayed on the map like any other icon in the style's
      * sprite using the image's ID with
-     * [`icon-image`](https://maplibre.org/maplibre-style-spec/#layout-symbol-icon-image),
-     * [`background-pattern`](https://maplibre.org/maplibre-style-spec/#paint-background-background-pattern),
-     * [`fill-pattern`](https://maplibre.org/maplibre-style-spec/#paint-fill-fill-pattern),
-     * or [`line-pattern`](https://maplibre.org/maplibre-style-spec/#paint-line-line-pattern).
+     * [`icon-image`](https://maplibre.org/maplibre-style-spec/layers/#layout-symbol-icon-image),
+     * [`background-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-background-background-pattern),
+     * [`fill-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-fill-fill-pattern),
+     * or [`line-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-line-line-pattern).
+     *
+     * An {@link ErrorEvent} will be fired if the image parameter is invald.
      *
      * @param id - The ID of the image.
      * @param image - The image as an `HTMLImageElement`, `ImageData`, `ImageBitmap` or object with `width`, `height`, and `data`
@@ -53351,6 +53343,8 @@ let Map$1 = class Map extends Camera {
      * in the style's original sprite and any images
      * that have been added at runtime using {@link Map#addImage}.
      *
+     * An {@link ErrorEvent} will be fired if the image parameter is invald.
+     *
      * @param id - The ID of the image.
      *
      * @returns A Boolean indicating whether the image exists.
@@ -53421,14 +53415,14 @@ let Map$1 = class Map extends Camera {
         return this.style.listImages();
     }
     /**
-     * Adds a [MapLibre style layer](https://maplibre.org/maplibre-style-spec/#layers)
+     * Adds a [MapLibre style layer](https://maplibre.org/maplibre-style-spec/layers)
      * to the map's style.
      *
      * A layer defines how data from a specified source will be styled. Read more about layer types
-     * and available paint and layout properties in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/#layers).
+     * and available paint and layout properties in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/layers).
      *
      * @param layer - The layer to add,
-     * conforming to either the MapLibre Style Specification's [layer definition](https://maplibre.org/maplibre-style-spec/#layers) or,
+     * conforming to either the MapLibre Style Specification's [layer definition](https://maplibre.org/maplibre-style-spec/layers) or,
      * less commonly, the {@link CustomLayerInterface} specification.
      * The MapLibre Style Specification's layer definition is appropriate for most layers.
      *
@@ -53526,10 +53520,9 @@ let Map$1 = class Map extends Camera {
     /**
      * Removes the layer with the given ID from the map's style.
      *
-     * If no such layer exists, an `error` event is fired.
+     * An {@link ErrorEvent} will be fired if the image parameter is invald.
      *
      * @param id - The ID of the layer to remove
-     * @event `error`
      * @returns `this`
      *
      * @example
@@ -53561,8 +53554,8 @@ let Map$1 = class Map extends Camera {
     }
     /**
      * Sets the zoom extent for the specified style layer. The zoom extent includes the
-     * [minimum zoom level](https://maplibre.org/maplibre-style-spec/#layer-minzoom)
-     * and [maximum zoom level](https://maplibre.org/maplibre-style-spec/#layer-maxzoom))
+     * [minimum zoom level](https://maplibre.org/maplibre-style-spec/layers/#minzoom)
+     * and [maximum zoom level](https://maplibre.org/maplibre-style-spec/layers/#maxzoom))
      * at which the layer will be rendered.
      *
      * Note: For style layers using vector sources, style layers cannot be rendered at zoom levels lower than the
@@ -53713,12 +53706,11 @@ let Map$1 = class Map extends Camera {
         return this.style.getGlyphsUrl();
     }
     /**
-     * Adds a sprite to the map's style.
+     * Adds a sprite to the map's style. Fires the `style` event.
      *
      * @param id - The ID of the sprite to add. Must not conflict with existing sprites.
      * @param url - The URL to load the sprite from
      * @param options - Options object.
-     * @event `style`
      * @returns `this`
      * @example
      * ```ts
@@ -53735,10 +53727,9 @@ let Map$1 = class Map extends Camera {
         return this;
     }
     /**
-     * Removes the sprite from the map's style.
+     * Removes the sprite from the map's style. Fires the `style` event.
      *
      * @param id - The ID of the sprite to remove. If the sprite is declared as a single URL, the ID must be "default".
-     * @event `style`
      * @returns `this`
      * @example
      * ```ts
@@ -53782,7 +53773,7 @@ let Map$1 = class Map extends Camera {
     /**
      * Sets the any combination of light values.
      *
-     * @param light - Light properties to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/#light).
+     * @param light - Light properties to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/light).
      * @param options - Options object.
      * @returns `this`
      *
@@ -54002,6 +53993,8 @@ let Map$1 = class Map extends Camera {
             <div class="maplibregl-desktop-message">${desktopMessage}</div>
             <div class="maplibregl-mobile-message">${mobileMessage}</div>
         `;
+        // Remove cooperative gesture screen from the accessibility tree since screenreaders cannot interact with the map using gestures
+        this._cooperativeGesturesScreen.setAttribute('aria-hidden', 'true');
         // Add event to canvas container since gesture container is pointer-events: none
         this._canvasContainer.addEventListener('wheel', this._cooperativeGesturesOnWheel, false);
         // Add a cooperative gestures class (enable touch-action: pan-x pan-y;)
@@ -54077,6 +54070,7 @@ let Map$1 = class Map extends Camera {
     /**
      * Update this map's style and sources, and re-render the map.
      *
+     * @hidden
      * @param updateStyle - mark the map's style for reprocessing as
      * well as its sources
      * @returns `this`
@@ -54092,6 +54086,7 @@ let Map$1 = class Map extends Camera {
     /**
      * Request that the given callback be executed during the next render
      * frame.  Schedule a render frame if one is not already scheduled.
+     * @hidden
      * @returns An id that can be used to cancel the callback
      */
     _requestRenderFrame(callback) {
@@ -54109,6 +54104,7 @@ let Map$1 = class Map extends Camera {
      * - A transition is in progress
      *
      * @param paintStartTimeStamp - The time when the animation frame began executing.
+     * @hidden
      *
      * @returns `this`
      */
@@ -54151,9 +54147,17 @@ let Map$1 = class Map extends Camera {
             this.style._updateSources(this.transform);
         }
         // update terrain stuff
-        if (this.terrain)
+        if (this.terrain) {
             this.terrain.sourceCache.update(this.transform, this.terrain);
-        this.transform.updateElevation(this.terrain);
+            this.transform._minEleveationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this.transform.center, this.transform.tileZoom);
+            if (!this._elevationFreeze) {
+                this.transform.elevation = this.terrain.getElevationForLngLatZoom(this.transform.center, this.transform.tileZoom);
+            }
+        }
+        else {
+            this.transform._minEleveationForCurrentTile = 0;
+            this.transform.elevation = 0;
+        }
         this._placementDirty = this.style && this.style._updatePlacement(this.painter.transform, this.showCollisionBoxes, fadeDuration, this._crossSourceCollisions);
         // Actually draw
         this.painter.render(this.style, {