npm - maplibre-gl - Versions diffs - 3.0.0 → 3.1.0 - Mend

maplibre-gl 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (104) hide show

package/README.md +9 -7
package/build/generate-shaders.ts +39 -6
package/build/readme.md +0 -5
package/dist/maplibre-gl-csp-worker.js +1 -1
package/dist/maplibre-gl-csp-worker.js.map +1 -1
package/dist/maplibre-gl-csp.js +1 -1
package/dist/maplibre-gl-csp.js.map +1 -1
package/dist/maplibre-gl-dev.js +176 -127
package/dist/maplibre-gl-dev.js.map +1 -1
package/dist/maplibre-gl.d.ts +48 -42
package/dist/maplibre-gl.js +4 -4
package/dist/maplibre-gl.js.map +1 -1
package/package.json +34 -33
package/src/geo/lng_lat.ts +2 -2
package/src/gl/context.ts +27 -9
package/src/gl/types.ts +14 -14
package/src/gl/value.ts +11 -3
package/src/gl/vertex_buffer.ts +2 -2
package/src/gl/webgl2.ts +12 -0
package/src/index.ts +0 -17
package/src/render/draw_heatmap.ts +1 -0
package/src/render/painter.ts +1 -1
package/src/render/program.ts +3 -2
package/src/render/texture.ts +4 -4
package/src/render/uniform_binding.ts +1 -1
package/src/shaders/README.md +4 -4
package/src/shaders/_prelude.fragment.glsl +2 -0
package/src/shaders/_prelude.fragment.glsl.g.ts +1 -1
package/src/shaders/_prelude.vertex.glsl +3 -3
package/src/shaders/background.fragment.glsl +2 -2
package/src/shaders/background.vertex.glsl +1 -1
package/src/shaders/background_pattern.fragment.glsl +6 -6
package/src/shaders/background_pattern.vertex.glsl +3 -4
package/src/shaders/circle.fragment.glsl +5 -9
package/src/shaders/circle.vertex.glsl +3 -3
package/src/shaders/clipping_mask.fragment.glsl +1 -1
package/src/shaders/clipping_mask.vertex.glsl +1 -1
package/src/shaders/collision_box.fragment.glsl +5 -6
package/src/shaders/collision_box.vertex.glsl +7 -7
package/src/shaders/collision_circle.fragment.glsl +5 -5
package/src/shaders/collision_circle.vertex.glsl +7 -7
package/src/shaders/debug.fragment.glsl +3 -3
package/src/shaders/debug.vertex.glsl +2 -2
package/src/shaders/fill.fragment.glsl +2 -2
package/src/shaders/fill.vertex.glsl +1 -1
package/src/shaders/fill_extrusion.fragment.glsl +3 -3
package/src/shaders/fill_extrusion.vertex.glsl +4 -4
package/src/shaders/fill_extrusion_pattern.fragment.glsl +9 -7
package/src/shaders/fill_extrusion_pattern.vertex.glsl +6 -6
package/src/shaders/fill_outline.fragment.glsl +3 -3
package/src/shaders/fill_outline.vertex.glsl +2 -2
package/src/shaders/fill_outline_pattern.fragment.glsl +7 -7
package/src/shaders/fill_outline_pattern.vertex.glsl +4 -4
package/src/shaders/fill_pattern.fragment.glsl +6 -6
package/src/shaders/fill_pattern.vertex.glsl +3 -3
package/src/shaders/heatmap.fragment.glsl +3 -3
package/src/shaders/heatmap.vertex.glsl +4 -4
package/src/shaders/heatmap_texture.fragment.glsl +6 -5
package/src/shaders/heatmap_texture.vertex.glsl +2 -2
package/src/shaders/hillshade.fragment.glsl +4 -4
package/src/shaders/hillshade.vertex.glsl +3 -3
package/src/shaders/hillshade_prepare.fragment.glsl +6 -4
package/src/shaders/hillshade_prepare.vertex.glsl +3 -3
package/src/shaders/line.fragment.glsl +5 -5
package/src/shaders/line.vertex.glsl +6 -6
package/src/shaders/line_gradient.fragment.glsl +7 -7
package/src/shaders/line_gradient.vertex.glsl +8 -8
package/src/shaders/line_pattern.fragment.glsl +8 -8
package/src/shaders/line_pattern.vertex.glsl +7 -7
package/src/shaders/line_sdf.fragment.glsl +9 -9
package/src/shaders/line_sdf.vertex.glsl +7 -7
package/src/shaders/raster.fragment.glsl +7 -6
package/src/shaders/raster.vertex.glsl +4 -4
package/src/shaders/symbol_icon.fragment.glsl +4 -4
package/src/shaders/symbol_icon.vertex.glsl +7 -7
package/src/shaders/symbol_sdf.fragment.glsl +5 -5
package/src/shaders/symbol_sdf.vertex.glsl +7 -7
package/src/shaders/symbol_text_and_icon.fragment.glsl +7 -7
package/src/shaders/symbol_text_and_icon.vertex.glsl +6 -6
package/src/shaders/terrain.fragment.glsl +2 -2
package/src/shaders/terrain.vertex.glsl +3 -3
package/src/shaders/terrain_coords.fragment.glsl +3 -3
package/src/shaders/terrain_depth.fragment.glsl +2 -2
package/src/source/raster_dem_tile_source.ts +4 -3
package/src/source/source_cache.ts +8 -3
package/src/source/vector_tile_source.test.ts +11 -11
package/src/source/vector_tile_worker_source.ts +1 -1
package/src/style/style_layer/custom_style_layer.ts +7 -7
package/src/ui/control/attribution_control.ts +1 -1
package/src/ui/control/fullscreen_control.ts +1 -1
package/src/ui/control/geolocate_control.ts +6 -6
package/src/ui/control/navigation_control.ts +4 -4
package/src/ui/control/scale_control.ts +1 -1
package/src/ui/control/terrain_control.ts +4 -5
package/src/ui/events.ts +2 -0
package/src/ui/map.test.ts +11 -0
package/src/ui/map.ts +19 -12
package/src/ui/marker.ts +2 -2
package/src/ui/popup.ts +2 -2
package/src/util/browser.ts +2 -2
package/src/util/config.ts +2 -0
package/src/util/request_manager.ts +1 -1
package/src/util/test/mock_webgl.ts +4 -1
package/src/util/webp_supported.ts +3 -3

package/dist/maplibre-gl-dev.js CHANGED Viewed

@@ -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.0.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.1.0/LICENSE.txt */
 (function (global, factory) {
 typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
 typeof define === 'function' && define.amd ? define(factory) :
@@ -1056,6 +1056,7 @@ const exported = {
 const config = {
     MAX_PARALLEL_IMAGE_REQUESTS: 16,
     MAX_PARALLEL_IMAGE_REQUESTS_PER_FRAME: 8,
+    MAX_TILE_CACHE_ZOOM_LEVELS: 5,
     REGISTERED_PROTOCOLS: {},
     WORKER_URL: ''
 };
@@ -5149,57 +5150,61 @@ function parseCssColor(input) {
         return [r / 255, g / 255, b / 255, 1];
     }
     // #f0c, #f0cf, #ff00cc, #ff00ccff
-    const hexRegexp = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/;
-    if (hexRegexp.test(input)) {
-        const step = input.length < 6 ? 1 : 2;
-        let i = 1;
-        return [
-            parseHex(input.slice(i, i += step)),
-            parseHex(input.slice(i, i += step)),
-            parseHex(input.slice(i, i += step)),
-            parseHex(input.slice(i, i + step) || 'ff'),
-        ];
+    if (input.startsWith('#')) {
+        const hexRegexp = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/;
+        if (hexRegexp.test(input)) {
+            const step = input.length < 6 ? 1 : 2;
+            let i = 1;
+            return [
+                parseHex(input.slice(i, i += step)),
+                parseHex(input.slice(i, i += step)),
+                parseHex(input.slice(i, i += step)),
+                parseHex(input.slice(i, i + step) || 'ff'),
+            ];
+        }
     }
     // rgb(128 0 0), rgb(50% 0% 0%), rgba(255,0,255,0.6), rgb(255 0 255 / 60%), rgb(100% 0% 100% /.6)
-    const rgbRegExp = /^rgba?\(\s*([\de.+-]+)(%)?(?:\s+|\s*(,)\s*)([\de.+-]+)(%)?(?:\s+|\s*(,)\s*)([\de.+-]+)(%)?(?:\s*([,\/])\s*([\de.+-]+)(%)?)?\s*\)$/;
-    const rgbMatch = input.match(rgbRegExp);
-    if (rgbMatch) {
-        const [_, // eslint-disable-line @typescript-eslint/no-unused-vars
-        r, // <numeric>
-        rp, // %         (optional)
-        f1, // ,         (optional)
-        g, // <numeric>
-        gp, // %         (optional)
-        f2, // ,         (optional)
-        b, // <numeric>
-        bp, // %         (optional)
-        f3, // ,|/       (optional)
-        a, // <numeric> (optional)
-        ap, // %         (optional)
-        ] = rgbMatch;
-        const argFormat = [f1 || ' ', f2 || ' ', f3].join('');
-        if (argFormat === '  ' ||
-            argFormat === '  /' ||
-            argFormat === ',,' ||
-            argFormat === ',,,') {
-            const valFormat = [rp, gp, bp].join('');
-            const maxValue = (valFormat === '%%%') ? 100 :
-                (valFormat === '') ? 255 : 0;
-            if (maxValue) {
-                const rgba = [
-                    clamp(+r / maxValue, 0, 1),
-                    clamp(+g / maxValue, 0, 1),
-                    clamp(+b / maxValue, 0, 1),
-                    a ? parseAlpha(+a, ap) : 1,
-                ];
-                if (validateNumbers(rgba)) {
-                    return rgba;
+    if (input.startsWith('rgb')) {
+        const rgbRegExp = /^rgba?\(\s*([\de.+-]+)(%)?(?:\s+|\s*(,)\s*)([\de.+-]+)(%)?(?:\s+|\s*(,)\s*)([\de.+-]+)(%)?(?:\s*([,\/])\s*([\de.+-]+)(%)?)?\s*\)$/;
+        const rgbMatch = input.match(rgbRegExp);
+        if (rgbMatch) {
+            const [_, // eslint-disable-line @typescript-eslint/no-unused-vars
+            r, // <numeric>
+            rp, // %         (optional)
+            f1, // ,         (optional)
+            g, // <numeric>
+            gp, // %         (optional)
+            f2, // ,         (optional)
+            b, // <numeric>
+            bp, // %         (optional)
+            f3, // ,|/       (optional)
+            a, // <numeric> (optional)
+            ap, // %         (optional)
+            ] = rgbMatch;
+            const argFormat = [f1 || ' ', f2 || ' ', f3].join('');
+            if (argFormat === '  ' ||
+                argFormat === '  /' ||
+                argFormat === ',,' ||
+                argFormat === ',,,') {
+                const valFormat = [rp, gp, bp].join('');
+                const maxValue = (valFormat === '%%%') ? 100 :
+                    (valFormat === '') ? 255 : 0;
+                if (maxValue) {
+                    const rgba = [
+                        clamp(+r / maxValue, 0, 1),
+                        clamp(+g / maxValue, 0, 1),
+                        clamp(+b / maxValue, 0, 1),
+                        a ? parseAlpha(+a, ap) : 1,
+                    ];
+                    if (validateNumbers(rgba)) {
+                        return rgba;
+                    }
+                    // invalid numbers
                 }
-                // invalid numbers
+                // values must be all numbers or all percentages
             }
-            // values must be all numbers or all percentages
+            return; // comma optional syntax requires no commas at all
         }
-        return; // comma optional syntax requires no commas at all
     }
     // hsl(120 50% 80%), hsla(120deg,50%,80%,.9), hsl(12e1 50% 80% / 90%)
     const hslRegExp = /^hsla?\(\s*([\de.+-]+)(?:deg)?(?:\s+|\s*(,)\s*)([\de.+-]+)%(?:\s+|\s*(,)\s*)([\de.+-]+)%(?:\s*([,\/])\s*([\de.+-]+)(%)?)?\s*\)$/;
@@ -28540,10 +28545,10 @@ const earthRadius = 6371008.8;
  * A `LngLat` object represents a given longitude and latitude coordinate, measured in degrees.
  * These coordinates are based on the [WGS84 (EPSG:4326) standard](https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84).
  *
- * MapLibre GL uses longitude, latitude coordinate order (as opposed to latitude, longitude) to match the
+ * MapLibre GL JS uses longitude, latitude coordinate order (as opposed to latitude, longitude) to match the
  * [GeoJSON specification](https://tools.ietf.org/html/rfc7946).
  *
- * Note that any MapLibre GL method that accepts a `LngLat` object as an argument or option
+ * Note that any MapLibre GL JS method that accepts a `LngLat` object as an argument or option
  * can also accept an `Array` of two numbers and will perform an implicit conversion.
  * This flexible type is documented as {@link LngLatLike}.
  *
@@ -33820,7 +33825,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.0.0";
+var version$2 = "3.1.0";
 var main = "dist/maplibre-gl.js";
 var style = "dist/maplibre-gl.css";
 var license = "BSD-3-Clause";
@@ -33839,7 +33844,7 @@ 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.0",
+	"@maplibre/maplibre-gl-style-spec": "^19.2.1",
 	"@types/geojson": "^7946.0.10",
 	"@types/mapbox__point-geometry": "^0.1.2",
 	"@types/mapbox__vector-tile": "^1.3.0",
@@ -33860,22 +33865,22 @@ var dependencies = {
 var devDependencies = {
 	"@mapbox/mapbox-gl-rtl-text": "^0.2.3",
 	"@mapbox/mvt-fixtures": "^3.10.0",
-	"@rollup/plugin-commonjs": "^25.0.0",
+	"@rollup/plugin-commonjs": "^25.0.1",
 	"@rollup/plugin-json": "^6.0.0",
-	"@rollup/plugin-node-resolve": "^15.0.2",
+	"@rollup/plugin-node-resolve": "^15.1.0",
 	"@rollup/plugin-replace": "^5.0.2",
 	"@rollup/plugin-strip": "^3.0.2",
-	"@rollup/plugin-terser": "^0.4.1",
+	"@rollup/plugin-terser": "^0.4.3",
 	"@rollup/plugin-typescript": "^11.1.1",
 	"@types/benchmark": "^2.1.2",
 	"@types/cssnano": "^5.0.0",
 	"@types/d3": "^7.4.0",
 	"@types/diff": "^5.0.3",
 	"@types/earcut": "^2.1.1",
-	"@types/eslint": "^8.37.0",
+	"@types/eslint": "^8.40.0",
 	"@types/gl": "^6.0.2",
 	"@types/glob": "^8.1.0",
-	"@types/jest": "^29.5.1",
+	"@types/jest": "^29.5.2",
 	"@types/jsdom": "^21.1.1",
 	"@types/minimist": "^1.2.2",
 	"@types/murmurhash-js": "^1.0.4",
@@ -33884,39 +33889,39 @@ var devDependencies = {
 	"@types/offscreencanvas": "^2019.7.0",
 	"@types/pixelmatch": "^5.2.4",
 	"@types/pngjs": "^6.0.1",
-	"@types/react": "^18.2.6",
+	"@types/react": "^18.2.11",
 	"@types/react-dom": "^18.2.4",
 	"@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.59.6",
-	"@typescript-eslint/parser": "^5.59.5",
+	"@typescript-eslint/eslint-plugin": "^5.59.9",
+	"@typescript-eslint/parser": "^5.59.11",
 	address: "^1.2.2",
 	benchmark: "^2.1.4",
 	canvas: "^2.11.2",
 	cssnano: "^6.0.1",
-	d3: "^7.8.4",
+	d3: "^7.8.5",
 	"d3-queue": "^3.0.7",
-	"devtools-protocol": "^0.0.1144541",
+	"devtools-protocol": "^0.0.1155872",
 	diff: "^5.1.0",
-	documentation: "14.0.1",
+	documentation: "14.0.2",
 	"dts-bundle-generator": "^8.0.1",
-	eslint: "^8.40.0",
+	eslint: "^8.42.0",
 	"eslint-config-mourner": "^3.0.0",
 	"eslint-plugin-html": "^7.1.0",
 	"eslint-plugin-import": "^2.27.5",
 	"eslint-plugin-jest": "^27.2.1",
-	"eslint-plugin-jsdoc": "^44.2.3",
+	"eslint-plugin-jsdoc": "^46.2.6",
 	"eslint-plugin-react": "^7.32.2",
 	expect: "^29.5.0",
 	gl: "^6.0.2",
-	glob: "^10.2.4",
+	glob: "^10.2.7",
 	"is-builtin-module": "^3.2.1",
 	jest: "^29.5.0",
-	"jest-canvas-mock": "^2.5.0",
+	"jest-canvas-mock": "^2.5.1",
 	"jest-environment-jsdom": "^29.5.0",
-	jsdom: "^22.0.0",
+	jsdom: "^22.1.0",
 	"json-stringify-pretty-compact": "^4.0.0",
 	minimist: "^1.2.8",
 	"mock-geolocation": "^1.0.11",
@@ -33927,26 +33932,26 @@ var devDependencies = {
 	"pdf-merger-js": "^4.3.0",
 	pixelmatch: "^5.3.0",
 	pngjs: "^7.0.0",
-	postcss: "^8.4.23",
+	postcss: "^8.4.24",
 	"postcss-cli": "^10.1.0",
 	"postcss-inline-svg": "^6.0.0",
 	"pretty-bytes": "^6.1.0",
-	puppeteer: "^20.2.0",
+	puppeteer: "^20.7.1",
 	react: "^18.2.0",
 	"react-dom": "^18.2.0",
-	rollup: "^3.21.5",
+	rollup: "^3.25.1",
 	"rollup-plugin-sourcemaps": "^0.6.3",
 	rw: "^1.3.3",
 	semver: "^7.5.1",
 	"shuffle-seed": "^1.1.6",
 	"source-map-explorer": "^2.5.3",
 	st: "^3.0.0",
-	stylelint: "^15.6.1",
+	stylelint: "^15.7.0",
 	"stylelint-config-standard": "^33.0.0",
 	"ts-jest": "^29.1.0",
 	"ts-node": "^10.9.1",
-	tslib: "^2.5.0",
-	typescript: "^5.0.4"
+	tslib: "^2.5.2",
+	typescript: "^5.1.3"
 };
 var overrides = {
 	"postcss-inline-svg": {
@@ -33957,11 +33962,11 @@ var overrides = {
 	}
 };
 var scripts = {
-	"generate-dist-package": "ts-node build/generate-dist-package",
-	"generate-shaders": "ts-node build/generate-shaders.ts",
-	"generate-struct-arrays": "ts-node build/generate-struct-arrays.ts",
-	"generate-style-code": "ts-node build/generate-style-code.ts",
-	"generate-typings": "ts-node build/generate-typings.ts",
+	"generate-dist-package": "npm run tsnode build/generate-dist-package.js",
+	"generate-shaders": "npm run tsnode build/generate-shaders.ts",
+	"generate-struct-arrays": "npm run tsnode build/generate-struct-arrays.ts",
+	"generate-style-code": "npm run tsnode build/generate-style-code.ts",
+	"generate-typings": "npm run tsnode build/generate-typings.ts",
 	"build-dist": "run-p --print-label generate-typings build-dev build-prod build-csp build-csp-dev build-css",
 	"build-dev": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:dev",
 	"watch-dev": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:dev --watch",
@@ -33984,14 +33989,15 @@ var scripts = {
 	"jest-ci": "jest --reporters=github-actions --reporters=summary",
 	"test-build": "jest --selectProjects=build",
 	"test-integration": "jest --selectProjects=integration",
-	"test-render": "ts-node test/integration/render/run_render_tests.ts",
+	"test-render": "npm run tsnode test/integration/render/run_render_tests.ts",
 	"test-unit": "jest --selectProjects=unit",
 	"test-watch-roots": "jest --watch",
 	codegen: "run-p generate-dist-package generate-style-code generate-struct-arrays generate-shaders",
-	benchmark: "ts-node test/bench/run-benchmarks.ts",
-	"gl-stats": "ts-node test/bench/gl-stats.ts",
+	benchmark: "npm run tsnode test/bench/run-benchmarks.ts",
+	"gl-stats": "npm run tsnode test/bench/gl-stats.ts",
 	prepare: "npm run codegen",
-	typecheck: "tsc --noEmit"
+	typecheck: "tsc --noEmit && tsc --project tsconfig.dist.json",
+	tsnode: "node --experimental-loader=ts-node/esm --no-warnings"
 };
 var files = [
 	"build/",
@@ -38062,6 +38068,7 @@ class SourceCache extends performance.Evented {
         this._timers = {};
         this._cacheTimers = {};
         this._maxTileCacheSize = null;
+        this._maxTileCacheZoomLevels = null;
         this._loadedParentTiles = {};
         this._coveredTiles = {};
         this._state = new SourceFeatureState();
@@ -38071,6 +38078,7 @@ class SourceCache extends performance.Evented {
     onAdd(map) {
         this.map = map;
         this._maxTileCacheSize = map ? map._maxTileCacheSize : null;
+        this._maxTileCacheZoomLevels = map ? map._maxTileCacheZoomLevels : null;
         if (this._source && this._source.onAdd) {
             this._source.onAdd(map);
         }
@@ -38371,9 +38379,11 @@ class SourceCache extends performance.Evented {
         const widthInTiles = Math.ceil(transform.width / this._source.tileSize) + 1;
         const heightInTiles = Math.ceil(transform.height / this._source.tileSize) + 1;
         const approxTilesInView = widthInTiles * heightInTiles;
-        const commonZoomRange = 5;
+        const commonZoomRange = this._maxTileCacheZoomLevels === null ?
+            performance.config.MAX_TILE_CACHE_ZOOM_LEVELS : this._maxTileCacheZoomLevels;
         const viewDependentMaxSize = Math.floor(approxTilesInView * commonZoomRange);
-        const maxSize = typeof this._maxTileCacheSize === 'number' ? Math.min(this._maxTileCacheSize, viewDependentMaxSize) : viewDependentMaxSize;
+        const maxSize = typeof this._maxTileCacheSize === 'number' ?
+            Math.min(this._maxTileCacheSize, viewDependentMaxSize) : viewDependentMaxSize;
         this._cache.setMaxSize(maxSize);
     }
     handleWrapJump(lng) {
@@ -42545,7 +42555,7 @@ var posAttributes = performance.createLayout([
 ]);
 // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`.
-var preludeFrag = '#ifdef GL_ES\nprecision mediump float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif';
+var preludeFrag = '#ifdef GL_ES\nprecision mediump float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif\n';
 // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`.
 var preludeVert = '#ifdef GL_ES\nprecision highp float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif\nvec2 unpack_float(const float packedValue) {int packedIntValue=int(packedValue);int v0=packedIntValue/256;return vec2(v0,packedIntValue-v0*256);}vec2 unpack_opacity(const float packedOpacity) {int intOpacity=int(packedOpacity)/2;return vec2(float(intOpacity)/127.0,mod(packedOpacity,2.0));}vec4 decode_color(const vec2 encodedColor) {return vec4(unpack_float(encodedColor[0])/255.0,unpack_float(encodedColor[1])/255.0\n);}float unpack_mix_vec2(const vec2 packedValue,const float t) {return mix(packedValue[0],packedValue[1],t);}vec4 unpack_mix_color(const vec4 packedColors,const float t) {vec4 minColor=decode_color(vec2(packedColors[0],packedColors[1]));vec4 maxColor=decode_color(vec2(packedColors[2],packedColors[3]));return mix(minColor,maxColor,t);}vec2 get_pattern_pos(const vec2 pixel_coord_upper,const vec2 pixel_coord_lower,const vec2 pattern_size,const float tile_units_to_pixels,const vec2 pos) {vec2 offset=mod(mod(mod(pixel_coord_upper,pattern_size)*256.0,pattern_size)*256.0+pixel_coord_lower,pattern_size);return (tile_units_to_pixels*pos+offset)/pattern_size;}\n#ifdef TERRAIN3D\nuniform sampler2D u_terrain;uniform float u_terrain_dim;uniform mat4 u_terrain_matrix;uniform vec4 u_terrain_unpack;uniform float u_terrain_exaggeration;uniform highp sampler2D u_depth;\n#endif\nconst highp vec4 bitSh=vec4(256.*256.*256.,256.*256.,256.,1.);const highp vec4 bitShifts=vec4(1.)/bitSh;highp float unpack(highp vec4 color) {return dot(color,bitShifts);}highp float depthOpacity(vec3 frag) {\n#ifdef TERRAIN3D\nhighp float d=unpack(texture2D(u_depth,frag.xy*0.5+0.5))+0.0001-frag.z;return 1.0-max(0.0,min(1.0,-d*500.0));\n#else\nreturn 1.0;\n#endif\n}float calculate_visibility(vec4 pos) {\n#ifdef TERRAIN3D\nvec3 frag=pos.xyz/pos.w;highp float d=depthOpacity(frag);if (d > 0.95) return 1.0;return (d+depthOpacity(frag+vec3(0.0,0.01,0.0)))/2.0;\n#else\nreturn 1.0;\n#endif\n}float ele(vec2 pos) {\n#ifdef TERRAIN3D\nvec4 rgb=(texture2D(u_terrain,pos)*255.0)*u_terrain_unpack;return rgb.r+rgb.g+rgb.b-u_terrain_unpack.a;\n#else\nreturn 0.0;\n#endif\n}float get_elevation(vec2 pos) {\n#ifdef TERRAIN3D\nvec2 coord=(u_terrain_matrix*vec4(pos,0.0,1.0)).xy*u_terrain_dim+1.0;vec2 f=fract(coord);vec2 c=(floor(coord)+0.5)/(u_terrain_dim+2.0);float d=1.0/(u_terrain_dim+2.0);float tl=ele(c);float tr=ele(c+vec2(d,0.0));float bl=ele(c+vec2(0.0,d));float br=ele(c+vec2(d,d));float elevation=mix(mix(tl,tr,f.x),mix(bl,br,f.x),f.y);return elevation*u_terrain_exaggeration;\n#else\nreturn 0.0;\n#endif\n}';
@@ -43854,6 +43864,18 @@ class VertexBuffer {
     }
 }
+const cache = new WeakMap();
+function isWebGL2(gl) {
+    if (cache.has(gl)) {
+        return cache.get(gl);
+    }
+    else {
+        const value = gl.getParameter(gl.VERSION).startsWith('WebGL 2.0');
+        cache.set(gl, value);
+        return value;
+    }
+}
 class BaseValue {
     constructor(context) {
         this.gl = context.gl;
@@ -44246,10 +44268,16 @@ class BindVertexArray extends BaseValue {
         return null;
     }
     set(v) {
+        var _a;
         if (v === this.current && !this.dirty)
             return;
         const gl = this.gl;
-        gl.bindVertexArray(v);
+        if (isWebGL2(gl)) {
+            gl.bindVertexArray(v);
+        }
+        else {
+            (_a = gl.getExtension('OES_vertex_array_object')) === null || _a === void 0 ? void 0 : _a.bindVertexArrayOES(v);
+        }
         this.current = v;
         this.dirty = false;
     }
@@ -44395,6 +44423,7 @@ ColorMode.alphaBlended = new ColorMode([ONE, ONE_MINUS_SRC_ALPHA], performance.C
 class Context {
     constructor(gl) {
+        var _a, _b;
         this.gl = gl;
         this.clearColor = new ClearColor(this);
         this.clearDepth = new ClearDepth(this);
@@ -44427,15 +44456,26 @@ class Context {
         this.pixelStoreUnpack = new PixelStoreUnpack(this);
         this.pixelStoreUnpackPremultiplyAlpha = new PixelStoreUnpackPremultiplyAlpha(this);
         this.pixelStoreUnpackFlipY = new PixelStoreUnpackFlipY(this);
-        this.extTextureFilterAnisotropic = gl.getExtension('EXT_texture_filter_anisotropic');
+        this.extTextureFilterAnisotropic = (gl.getExtension('EXT_texture_filter_anisotropic') ||
+            gl.getExtension('MOZ_EXT_texture_filter_anisotropic') ||
+            gl.getExtension('WEBKIT_EXT_texture_filter_anisotropic'));
         if (this.extTextureFilterAnisotropic) {
             this.extTextureFilterAnisotropicMax = gl.getParameter(this.extTextureFilterAnisotropic.MAX_TEXTURE_MAX_ANISOTROPY_EXT);
         }
         this.maxTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE);
-        this.HALF_FLOAT = gl.HALF_FLOAT;
-        gl.getExtension('EXT_color_buffer_half_float');
-        this.RGBA16F = gl.RGBA16F;
-        this.RGB16F = gl.RGB16F;
+        if (isWebGL2(gl)) {
+            this.HALF_FLOAT = gl.HALF_FLOAT;
+            const extColorBufferHalfFloat = gl.getExtension('EXT_color_buffer_half_float');
+            this.RGBA16F = (_a = gl.RGBA16F) !== null && _a !== void 0 ? _a : extColorBufferHalfFloat === null || extColorBufferHalfFloat === void 0 ? void 0 : extColorBufferHalfFloat.RGBA16F_EXT;
+            this.RGB16F = (_b = gl.RGB16F) !== null && _b !== void 0 ? _b : extColorBufferHalfFloat === null || extColorBufferHalfFloat === void 0 ? void 0 : extColorBufferHalfFloat.RGB16F_EXT;
+            gl.getExtension('EXT_color_buffer_float');
+        }
+        else {
+            gl.getExtension('EXT_color_buffer_half_float');
+            gl.getExtension('OES_texture_half_float_linear');
+            const extTextureHalfFloat = gl.getExtension('OES_texture_half_float');
+            this.HALF_FLOAT = extTextureHalfFloat === null || extTextureHalfFloat === void 0 ? void 0 : extTextureHalfFloat.HALF_FLOAT_OES;
+        }
     }
     setDefault() {
         this.unbindVAO();
@@ -44586,10 +44626,16 @@ class Context {
         this.colorMask.set(colorMode.mask);
     }
     createVertexArray() {
-        return this.gl.createVertexArray();
+        var _a;
+        if (isWebGL2(this.gl))
+            return this.gl.createVertexArray();
+        return (_a = this.gl.getExtension('OES_vertex_array_object')) === null || _a === void 0 ? void 0 : _a.createVertexArrayOES();
     }
     deleteVertexArray(x) {
-        return this.gl.deleteVertexArray(x);
+        var _a;
+        if (isWebGL2(this.gl))
+            return this.gl.deleteVertexArray(x);
+        return (_a = this.gl.getExtension('OES_vertex_array_object')) === null || _a === void 0 ? void 0 : _a.deleteVertexArrayOES(x);
     }
     unbindVAO() {
         // Unbinding the VAO prevents other things (custom layers, new buffer creation) from
@@ -50978,7 +51024,7 @@ let canary; // eslint-disable-line
  * An `AttributionControl` control presents the map's attribution information. By default, the attribution control is expanded (regardless of map width).
  *
  * @implements {IControl}
- * @param {Object} [options]
+ * @param {AttributionOptions} [options]
  * @param {boolean} [options.compact] If `true`, the attribution control will always collapse when moving the map. If `false`, force the expanded attribution control. The default is a responsive attribution that collapses when the user moves the map on maps less than 640 pixels wide.  **Attribution should not be collapsed if it can comfortably fit on the map. `compact` should only be used to modify default attribution when map size makes it impossible to fit default attribution and when the automatic compact resizing for default settings are not sufficient.**
  * @param {string | Array<string>} [options.customAttribution] String or strings to show in addition to any other attributions.
  * @example
@@ -51962,6 +52008,7 @@ const defaultOptions$4 = {
     renderWorldCopies: true,
     refreshExpiredTiles: true,
     maxTileCacheSize: null,
+    maxTileCacheZoomLevels: performance.config.MAX_TILE_CACHE_ZOOM_LEVELS,
     localIdeographFontFamily: 'sans-serif',
     transformRequest: null,
     transformCameraUpdate: null,
@@ -52021,7 +52068,7 @@ const defaultOptions$4 = {
  * @param {boolean|Object} [options.touchPitch=true] If `true`, the "drag to pitch" interaction is enabled. An `Object` value is passed as options to {@link TwoFingersTouchPitchHandler#enable}.
  * @param {boolean|GestureOptions} [options.cooperativeGestures=undefined] If `true` or set to an options object, map is only accessible on desktop while holding Command/Ctrl and only accessible on mobile with two fingers. Interacting with the map using normal gestures will trigger an informational screen. With this option enabled, "drag to pitch" requires a three-finger gesture. Cooperative gestures are disabled when a map enters fullscreen using {@link #FullscreenControl}.
  * @param {boolean} [options.trackResize=true] If `true`, the map will automatically resize when the browser window resizes.
- * @param {LngLatLike} [options.center=[0, 0]] The initial geographical centerpoint of the map. If `center` is not specified in the constructor options, MapLibre GL JS will look for it in the map's style object. If it is not specified in the style, either, it will default to `[0, 0]` Note: MapLibre GL uses longitude, latitude coordinate order (as opposed to latitude, longitude) to match GeoJSON.
+ * @param {LngLatLike} [options.center=[0, 0]] The initial geographical centerpoint of the map. If `center` is not specified in the constructor options, MapLibre GL JS will look for it in the map's style object. If it is not specified in the style, either, it will default to `[0, 0]` Note: MapLibre GL JS uses longitude, latitude coordinate order (as opposed to latitude, longitude) to match GeoJSON.
  * @param {number} [options.zoom=0] The initial zoom level of the map. If `zoom` is not specified in the constructor options, MapLibre GL JS will look for it in the map's style object. If it is not specified in the style, either, it will default to `0`.
  * @param {number} [options.bearing=0] The initial bearing (rotation) of the map, measured in degrees counter-clockwise from north. If `bearing` is not specified in the constructor options, MapLibre GL JS will look for it in the map's style object. If it is not specified in the style, either, it will default to `0`.
  * @param {number} [options.pitch=0] The initial pitch (tilt) of the map, measured in degrees away from the plane of the screen (0-85). If `pitch` is not specified in the constructor options, MapLibre GL JS will look for it in the map's style object. If it is not specified in the style, either, it will default to `0`. 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.
@@ -52032,8 +52079,9 @@ const defaultOptions$4 = {
  * container, there will be blank space beyond 180 and -180 degrees longitude.
  * - Features that cross 180 and -180 degrees longitude will be cut in two (with one portion on the right edge of the
  * map and the other on the left edge of the map) at every zoom level.
- * @param {number} [options.maxTileCacheSize=null] The maximum number of tiles stored in the tile cache for a given source. If omitted, the cache will be dynamically sized based on the current viewport.
- * @param {string} [options.validateStyle=true] If false, style validation will be skipped. Useful in production environment.
+ * @param {number} [options.maxTileCacheSize=null] The maximum number of tiles stored in the tile cache for a given source. If omitted, the cache will be dynamically sized based on the current viewport which can be set using `maxTileCacheZoomLevels` constructor options.
+ * @param {number} [options.maxTileCacheZoomLevels=5] The maximum number of zoom levels for which to store tiles for a given source. Tile cache dynamic size is calculated by multiplying `maxTileCacheZoomLevels` with approx number of tiles in the viewport for a given source.
+ * @param {boolean} [options.validateStyle=true] If false, style validation will be skipped. Useful in production environment.
  * @param {string} [options.localIdeographFontFamily='sans-serif'] Defines a CSS
  * font-family for locally overriding generation of glyphs in the 'CJK Unified Ideographs', 'Hiragana', 'Katakana' and 'Hangul Syllables' ranges.
  * In these ranges, font settings from the map's style will be ignored, except for font-weight keywords (light/regular/medium/bold).
@@ -52090,6 +52138,7 @@ let Map$1 = class Map extends Camera {
         this._cooperativeGestures = options.cooperativeGestures;
         this._metaKey = navigator.platform.indexOf('Mac') === 0 ? 'metaKey' : 'ctrlKey';
         this._maxTileCacheSize = options.maxTileCacheSize;
+        this._maxTileCacheZoomLevels = options.maxTileCacheZoomLevels;
         this._failIfMajorPerformanceCaveat = options.failIfMajorPerformanceCaveat;
         this._preserveDrawingBuffer = options.preserveDrawingBuffer;
         this._antialias = options.antialias;
@@ -52741,7 +52790,7 @@ let Map$1 = class Map extends Camera {
      * @param {FilterSpecification} [options.filter] (optional) A [filter](https://maplibre.org/maplibre-style-spec/layers/#filter)
      * to limit query results.
      * @param {Array<string>} [options.availableImages] (optional) An array of string representing the available images
-     * @param {boolean} [options.validate=true] (optional) Whether to check if the [options.filter] conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] (optional) Whether to check if the [options.filter] conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      *
      * @returns {Array<MapGeoJSONFeature>} An array of MapGeoJSONFeature objects.
      *
@@ -52830,7 +52879,7 @@ let Map$1 = class Map extends Camera {
      * to query. *For vector tile sources, this parameter is required.* For GeoJSON sources, it is ignored.
      * @param {Array} [parameters.filter] A [filter](https://maplibre.org/maplibre-style-spec/layers/#filter)
      * to limit query results.
-     * @param {boolean} [parameters.validate=true] Whether to check if the [parameters.filter] conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [parameters.validate=true] Whether to check if the [parameters.filter] conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      *
      * @returns {Array<MapGeoJSONFeature>} An array of MapGeoJSONFeature objects.
      *
@@ -53622,7 +53671,7 @@ let Map$1 = class Map extends Camera {
      * @param {Array | null | undefined} filter The filter, conforming to the MapLibre Style Specification's
      * [filter definition](https://maplibre.org/maplibre-style-spec/layers/#filter).  If `null` or `undefined` is provided, the function removes any existing filter from the layer.
      * @param {Object} [options] Options object.
-     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      * @returns {Map} `this`
      *
      * @example
@@ -53658,7 +53707,7 @@ let Map$1 = class Map extends Camera {
      * @param {*} value The value of the paint property to set.
      * Must be of a type appropriate for the property, as defined in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/).
      * @param {Object} [options] Options object.
-     * @param {boolean} [options.validate=true] Whether to check if `value` conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] Whether to check if `value` conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      * @returns {Map} `this`
      * @example
      * map.setPaintProperty('my-layer', 'fill-color', '#faafee');
@@ -53686,7 +53735,7 @@ let Map$1 = class Map extends Camera {
      * @param {string} name The name of the layout property to set.
      * @param {*} value The value of the layout property. Must be of a type appropriate for the property, as defined in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/).
      * @param {Object} [options] Options object.
-     * @param {boolean} [options.validate=true] Whether to check if `value` conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] Whether to check if `value` conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      * @returns {Map} `this`
      * @example
      * map.setLayoutProperty('my-layer', 'visibility', 'none');
@@ -53710,7 +53759,7 @@ let Map$1 = class Map extends Camera {
      *
      * @param glyphsUrl Glyph URL to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/glyphs/).
      * @param {StyleSetterOptions} [options] Options object.
-     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      * @returns {Map} `this`
      * @example
      * map.setGlyphs('https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf');
@@ -53777,7 +53826,7 @@ let Map$1 = class Map extends Camera {
      *
      * @param spriteUrl Sprite URL to set.
      * @param {StyleSetterOptions} [options] Options object.
-     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      * @returns {Map} `this`
      * @example
      * map.setSprite('YOUR_SPRITE_URL');
@@ -53796,7 +53845,7 @@ let Map$1 = class Map extends Camera {
      *
      * @param light Light properties to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/#light).
      * @param {Object} [options] Options object.
-     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre GL Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
+     * @param {boolean} [options.validate=true] Whether to check if the filter conforms to the MapLibre Style Specification. Disabling validation is a performance optimization that should only be used if you have previously validated the values you will be passing to this function.
      * @returns {Map} `this`
      * @example
      * var layerVisibility = map.getLayoutProperty('my-layer', 'visibility');
@@ -54054,7 +54103,8 @@ let Map$1 = class Map extends Camera {
                 webglcontextcreationerrorDetailObject.type = args.type;
             }
         }, { once: true });
-        const gl = this._canvas.getContext('webgl2', attributes);
+        const gl = this._canvas.getContext('webgl2', attributes) ||
+            this._canvas.getContext('webgl', attributes);
         if (!gl) {
             const msg = 'Failed to initialize WebGL';
             if (webglcontextcreationerrorDetailObject) {
@@ -54477,10 +54527,10 @@ const defaultOptions$3 = {
  * A `NavigationControl` control contains zoom buttons and a compass.
  *
  * @implements {IControl}
- * @param {Object} [options]
- * @param {Boolean} [options.showCompass=true] If `true` the compass button is included.
- * @param {Boolean} [options.showZoom=true] If `true` the zoom-in and zoom-out buttons are included.
- * @param {Boolean} [options.visualizePitch=false] If `true` the pitch is visualized by rotating X-axis of compass.
+ * @param {NavigationOptions} [options]
+ * @param {boolean} [options.showCompass=true] If `true` the compass button is included.
+ * @param {boolean} [options.showZoom=true] If `true` the zoom-in and zoom-out buttons are included.
+ * @param {boolean} [options.visualizePitch=false] If `true` the pitch is visualized by rotating X-axis of compass.
  * @example
  * var nav = new maplibregl.NavigationControl();
  * map.addControl(nav, 'top-left');
@@ -54799,9 +54849,9 @@ function applyAnchorClass(element, anchor, prefix) {
 /**
  * Creates a marker component
- * @param {Object} [options]
+ * @param {MarkerOptions} [options]
  * @param {HTMLElement} [options.element] DOM element to use as a marker. The default is a light blue, droplet-shaped SVG marker.
- * @param {string} [options.anchor='center'] A string indicating the part of the Marker that should be positioned closest to the coordinate set via {@link Marker#setLngLat}.
+ * @param {PositionAnchor} [options.anchor='center'] A string indicating the part of the Marker that should be positioned closest to the coordinate set via {@link Marker#setLngLat}.
  * Options are `'center'`, `'top'`, `'bottom'`, `'left'`, `'right'`, `'top-left'`, `'top-right'`, `'bottom-left'`, and `'bottom-right'`.
  * @param {PointLike} [options.offset] The offset in pixels as a {@link PointLike} object to apply relative to the element's center. Negatives indicate left and up.
  * @param {string} [options.color='#3FB1CE'] The color to use for the default marker if options.element is not provided. The default is light blue.
@@ -55401,12 +55451,12 @@ let noTimeout = false;
  * These interaction states can't be controlled programmatically, rather they are set based on user interactions.
  *
  * @implements {IControl}
- * @param {Object} [options]
- * @param {Object} [options.positionOptions={enableHighAccuracy: false, timeout: 6000}] A Geolocation API [PositionOptions](https://developer.mozilla.org/en-US/docs/Web/API/PositionOptions) object.
- * @param {Object} [options.fitBoundsOptions={maxZoom: 15}] A {@link Map#fitBounds} options object to use when the map is panned and zoomed to the user's location. The default is to use a `maxZoom` of 15 to limit how far the map will zoom in for very accurate locations.
- * @param {Object} [options.trackUserLocation=false] If `true` the Geolocate Control becomes a toggle button and when active the map will receive updates to the user's location as it changes.
- * @param {Object} [options.showAccuracyCircle=true] By default, if showUserLocation is `true`, a transparent circle will be drawn around the user location indicating the accuracy (95% confidence level) of the user's location. Set to `false` to disable. Always disabled when showUserLocation is `false`.
- * @param {Object} [options.showUserLocation=true] By default a dot will be shown on the map at the user's location. Set to `false` to disable.
+ * @param {GeolocateOptions} [options]
+ * @param {PositionOptions} [options.positionOptions={enableHighAccuracy: false, timeout: 6000}] A Geolocation API [PositionOptions](https://developer.mozilla.org/en-US/docs/Web/API/PositionOptions) object.
+ * @param {FitBoundsOptions} [options.fitBoundsOptions={maxZoom: 15}] A {@link Map#fitBounds} options object to use when the map is panned and zoomed to the user's location. The default is to use a `maxZoom` of 15 to limit how far the map will zoom in for very accurate locations.
+ * @param {boolean} [options.trackUserLocation=false] If `true` the Geolocate Control becomes a toggle button and when active the map will receive updates to the user's location as it changes.
+ * @param {boolean} [options.showAccuracyCircle=true] By default, if showUserLocation is `true`, a transparent circle will be drawn around the user location indicating the accuracy (95% confidence level) of the user's location. Set to `false` to disable. Always disabled when showUserLocation is `false`.
+ * @param {boolean} [options.showUserLocation=true] By default a dot will be shown on the map at the user's location. Set to `false` to disable.
  *
  * @example
  * map.addControl(new maplibregl.GeolocateControl({
@@ -55959,7 +56009,7 @@ const defaultOptions$1 = {
  * A `ScaleControl` control displays the ratio of a distance on the map to the corresponding distance on the ground.
  *
  * @implements {IControl}
- * @param {Object} [options]
+ * @param {ScaleOptions} [options]
  * @param {number} [options.maxWidth='100'] The maximum length of the scale control in pixels.
  * @param {string} [options.unit='metric'] Unit of the distance (`'imperial'`, `'metric'` or `'nautical'`).
  * @example
@@ -56069,7 +56119,7 @@ function getRoundNum(num) {
  * is in fullscreen mode, and is restored when the map exist fullscreen mode.
  *
  * @implements {IControl}
- * @param {Object} [options]
+ * @param {FullscreenOptions} [options]
  * @param {HTMLElement} [options.container] `container` is the [compatible DOM element](https://developer.mozilla.org/en-US/docs/Web/API/Element/requestFullScreen#Compatible_elements) which should be made full screen. By default, the map container element will be made full screen.
  *
  * @example
@@ -56226,13 +56276,12 @@ class FullscreenControl extends performance.Evented {
 }
 /**
- * An `TerrainControl` control adds a button to turn terrain on and off.
+ * A `TerrainControl` control contains a button for turning the terrain on and off.
  *
  * @implements {IControl}
- * @param {Object} [options]
- * @param {string} [options.id] The ID of the raster-dem source to use.
- * @param {Object} [options.options]
- * @param {number} [options.options.exaggeration]
+ * @param {TerrainSpecification} [options]
+ * @param {string} [options.source] The ID of the raster-dem source to use.
+ * @param {number} [options.exaggeration]
  * @example
  * var map = new maplibregl.Map({TerrainControl: false})
  *     .addControl(new maplibregl.TerrainControl({
@@ -56305,7 +56354,7 @@ const focusQuerySelector = [
 /**
  * A popup component.
  *
- * @param {Object} [options]
+ * @param {PopupOptions} [options]
  * @param {boolean} [options.closeButton=true] If `true`, a close button will appear in the
  * top right corner of the popup.
  * @param {boolean} [options.closeOnClick=true] If `true`, the popup will closed when the
@@ -56314,7 +56363,7 @@ const focusQuerySelector = [
  * map moves.
  * @param {boolean} [options.focusAfterOpen=true] If `true`, the popup will try to focus the
  * first focusable element inside the popup.
- * @param {string} [options.anchor] - A string indicating the part of the Popup that should
+ * @param {PositionAnchor} [options.anchor] - A string indicating the part of the Popup that should
  * be positioned closest to the coordinate set via {@link Popup#setLngLat}.
  * Options are `'center'`, `'top'`, `'bottom'`, `'left'`, `'right'`, `'top-left'`,
  * `'top-right'`, `'bottom-left'`, and `'bottom-right'`. If unset the anchor will be