azure-maps-control 3.2.0 → 3.2.1

package/dist/atlas-esm.js

@@ -85,12 +85,12 @@ function getAugmentedNamespace(n) {
 
 var azuremapsMaplibreGlDev = {exports: {}};
 
-/* Build timestamp: Mon, 04 Mar 2024 19:21:28 GMT */
+/* Build timestamp: Mon, 22 Apr 2024 08:56:33 GMT */
 
 (function (module, exports) {
 	/**
 	 * The Azure Maps fork of MapLibre GL JS
-	 * @license 3-Clause BSD. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v4.0.2/LICENSE.txt
+	 * @license 3-Clause BSD. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v4.1.2/LICENSE.txt
 	 */
 	(function (global, factory) {
 	module.exports = factory() ;
@@ -1275,9 +1275,16 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            const body = yield response.blob();
 	            throw new AJAXError(response.status, response.statusText, requestParameters.url, body);
 	        }
-	        const parsePromise = (requestParameters.type === 'arrayBuffer' || requestParameters.type === 'image') ? response.arrayBuffer() :
-	            requestParameters.type === 'json' ? response.json() :
-	                response.text();
+	        let parsePromise;
+	        if ((requestParameters.type === 'arrayBuffer' || requestParameters.type === 'image')) {
+	            parsePromise = response.arrayBuffer();
+	        }
+	        else if (requestParameters.type === 'json') {
+	            parsePromise = response.json();
+	        }
+	        else {
+	            parsePromise = response.text();
+	        }
 	        const result = yield parsePromise;
 	        if (abortController.signal.aborted) {
 	            throw createAbortError();
@@ -1348,7 +1355,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            return protocolLoadFn(requestParameters, abortController);
 	        }
 	        if (isWorker(self) && self.worker && self.worker.actor) {
-	            return self.worker.actor.sendAsync({ type: 'getResource', data: requestParameters, targetMapId: GLOBAL_DISPATCHER_ID }, abortController);
+	            return self.worker.actor.sendAsync({ type: "GR" /* MessageType.getResource */, data: requestParameters, targetMapId: GLOBAL_DISPATCHER_ID }, abortController);
 	        }
 	    }
 	    if (!isFileURL(requestParameters.url)) {
@@ -1356,7 +1363,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            return makeFetchRequest(requestParameters, abortController);
 	        }
 	        if (isWorker(self) && self.worker && self.worker.actor) {
-	            return self.worker.actor.sendAsync({ type: 'getResource', data: requestParameters, mustQueue: true, targetMapId: GLOBAL_DISPATCHER_ID }, abortController);
+	            return self.worker.actor.sendAsync({ type: "GR" /* MessageType.getResource */, data: requestParameters, mustQueue: true, targetMapId: GLOBAL_DISPATCHER_ID }, abortController);
 	        }
 	    }
 	    return makeXMLHttpRequest(requestParameters, abortController);
@@ -11873,6 +11880,12 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        this.pluginStatus = state.pluginStatus;
 	        this.pluginURL = state.pluginURL;
 	    }
+	    getState() {
+	        return {
+	            pluginStatus: this.pluginStatus,
+	            pluginURL: this.pluginURL
+	        };
+	    }
 	    setMethods(rtlTextPlugin) {
 	        this.applyArabicShaping = rtlTextPlugin.applyArabicShaping;
 	        this.processBidirectionalText = rtlTextPlugin.processBidirectionalText;
@@ -15687,6 +15700,17 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	 */
 
 	var ortho = orthoNO;
+	/**
+	 * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)
+	 *
+	 * @param {ReadonlyMat4} a The first matrix.
+	 * @param {ReadonlyMat4} b The second matrix.
+	 * @returns {Boolean} True if the matrices are equal, false otherwise.
+	 */
+
+	function exactEquals$5(a, b) {
+	  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8] && a[9] === b[9] && a[10] === b[10] && a[11] === b[11] && a[12] === b[12] && a[13] === b[13] && a[14] === b[14] && a[15] === b[15];
+	}
 	/**
 	 * Returns whether or not the matrices have approximately the same elements in the same position.
 	 *
@@ -21217,12 +21241,11 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                // conversion here.
 	                const resolvedTokens = layer.getValueAndResolveTokens('text-field', evaluationFeature, canonical, availableImages);
 	                const formattedText = Formatted.factory(resolvedTokens);
-	                if (containsRTLText(formattedText)) {
-	                    this.hasRTLText = true;
-	                }
-	                if (!this.hasRTLText || // non-rtl text so can proceed safely
+	                // on this instance: if hasRTLText is already true, all future calls to containsRTLText can be skipped.
+	                const bucketHasRTLText = this.hasRTLText = (this.hasRTLText || containsRTLText(formattedText));
+	                if (!bucketHasRTLText || // non-rtl text so can proceed safely
 	                    rtlWorkerPlugin.getRTLTextPluginStatus() === 'unavailable' || // We don't intend to lazy-load the rtl text plugin, so proceed with incorrect shaping
-	                    this.hasRTLText && rtlWorkerPlugin.isParsed() // Use the rtlText plugin to shape text
+	                    bucketHasRTLText && rtlWorkerPlugin.isParsed() // Use the rtlText plugin to shape text
 	                ) {
 	                    text = transformText(formattedText, layer, evaluationFeature);
 	                }
@@ -24862,6 +24885,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	exports.equals = equals$6;
 	exports.evaluateSizeForFeature = evaluateSizeForFeature;
 	exports.evaluateSizeForZoom = evaluateSizeForZoom;
+	exports.exactEquals = exactEquals$5;
 	exports.extend = extend;
 	exports.filterObject = filterObject;
 	exports.findLineIntersection = findLineIntersection;
@@ -25103,6 +25127,8 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                    featureIndex.bucketLayerIDs.push(family.map((l) => l.id));
 	                }
 	            }
+	            // options.glyphDependencies looks like: {"SomeFontName":{"10":true,"32":true}}
+	            // this line makes an object like: {"SomeFontName":[10,32]}
 	            const stacks = performance.mapObject(options.glyphDependencies, (glyphs) => Object.keys(glyphs).map(Number));
 	            this.inFlightDependencies.forEach((request) => request === null || request === void 0 ? void 0 : request.abort());
 	            this.inFlightDependencies = [];
@@ -25110,21 +25136,21 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            if (Object.keys(stacks).length) {
 	                const abortController = new AbortController();
 	                this.inFlightDependencies.push(abortController);
-	                getGlyphsPromise = actor.sendAsync({ type: 'getGlyphs', data: { stacks, source: this.source, tileID: this.tileID, type: 'glyphs' } }, abortController);
+	                getGlyphsPromise = actor.sendAsync({ type: "GG" /* MessageType.getGlyphs */, data: { stacks, source: this.source, tileID: this.tileID, type: 'glyphs' } }, abortController);
 	            }
 	            const icons = Object.keys(options.iconDependencies);
 	            let getIconsPromise = Promise.resolve({});
 	            if (icons.length) {
 	                const abortController = new AbortController();
 	                this.inFlightDependencies.push(abortController);
-	                getIconsPromise = actor.sendAsync({ type: 'getImages', data: { icons, source: this.source, tileID: this.tileID, type: 'icons' } }, abortController);
+	                getIconsPromise = actor.sendAsync({ type: "GI" /* MessageType.getImages */, data: { icons, source: this.source, tileID: this.tileID, type: 'icons' } }, abortController);
 	            }
 	            const patterns = Object.keys(options.patternDependencies);
 	            let getPatternsPromise = Promise.resolve({});
 	            if (patterns.length) {
 	                const abortController = new AbortController();
 	                this.inFlightDependencies.push(abortController);
-	                getPatternsPromise = actor.sendAsync({ type: 'getImages', data: { icons: patterns, source: this.source, tileID: this.tileID, type: 'patterns' } }, abortController);
+	                getPatternsPromise = actor.sendAsync({ type: "GI" /* MessageType.getImages */, data: { icons: patterns, source: this.source, tileID: this.tileID, type: 'patterns' } }, abortController);
 	            }
 	            const [glyphMap, iconMap, patternMap] = yield Promise.all([getGlyphsPromise, getIconsPromise, getPatternsPromise]);
 	            const glyphAtlas = new GlyphAtlas(glyphMap);
@@ -27174,8 +27200,8 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	     * @returns a promise that resolves when the data is loaded and parsed into a GeoJSON object
 	     */
 	    loadData(params) {
-	        var _a;
 	        return performance.__awaiter(this, void 0, void 0, function* () {
+	            var _a;
 	            (_a = this._pendingRequest) === null || _a === void 0 ? void 0 : _a.abort();
 	            const perf = (params && params.request && params.request.collectResourceTiming) ?
 	                new performance.RequestPerformance(params.request) : false;
@@ -27352,37 +27378,37 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            }
 	            performance.rtlWorkerPlugin.setMethods(rtlTextPlugin);
 	        };
-	        this.actor.registerMessageHandler('loadDEMTile', (mapId, params) => {
+	        this.actor.registerMessageHandler("LDT" /* MessageType.loadDEMTile */, (mapId, params) => {
 	            return this._getDEMWorkerSource(mapId, params.source).loadTile(params);
 	        });
-	        this.actor.registerMessageHandler('removeDEMTile', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("RDT" /* MessageType.removeDEMTile */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            this._getDEMWorkerSource(mapId, params.source).removeTile(params);
 	        }));
-	        this.actor.registerMessageHandler('getClusterExpansionZoom', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("GCEZ" /* MessageType.getClusterExpansionZoom */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            return this._getWorkerSource(mapId, params.type, params.source).getClusterExpansionZoom(params);
 	        }));
-	        this.actor.registerMessageHandler('getClusterChildren', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("GCC" /* MessageType.getClusterChildren */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            return this._getWorkerSource(mapId, params.type, params.source).getClusterChildren(params);
 	        }));
-	        this.actor.registerMessageHandler('getClusterLeaves', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("GCL" /* MessageType.getClusterLeaves */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            return this._getWorkerSource(mapId, params.type, params.source).getClusterLeaves(params);
 	        }));
-	        this.actor.registerMessageHandler('loadData', (mapId, params) => {
+	        this.actor.registerMessageHandler("LD" /* MessageType.loadData */, (mapId, params) => {
 	            return this._getWorkerSource(mapId, params.type, params.source).loadData(params);
 	        });
-	        this.actor.registerMessageHandler('loadTile', (mapId, params) => {
+	        this.actor.registerMessageHandler("LT" /* MessageType.loadTile */, (mapId, params) => {
 	            return this._getWorkerSource(mapId, params.type, params.source).loadTile(params);
 	        });
-	        this.actor.registerMessageHandler('reloadTile', (mapId, params) => {
+	        this.actor.registerMessageHandler("RT" /* MessageType.reloadTile */, (mapId, params) => {
 	            return this._getWorkerSource(mapId, params.type, params.source).reloadTile(params);
 	        });
-	        this.actor.registerMessageHandler('abortTile', (mapId, params) => {
+	        this.actor.registerMessageHandler("AT" /* MessageType.abortTile */, (mapId, params) => {
 	            return this._getWorkerSource(mapId, params.type, params.source).abortTile(params);
 	        });
-	        this.actor.registerMessageHandler('removeTile', (mapId, params) => {
+	        this.actor.registerMessageHandler("RMT" /* MessageType.removeTile */, (mapId, params) => {
 	            return this._getWorkerSource(mapId, params.type, params.source).removeTile(params);
 	        });
-	        this.actor.registerMessageHandler('removeSource', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("RS" /* MessageType.removeSource */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            if (!this.workerSources[mapId] ||
 	                !this.workerSources[mapId][params.type] ||
 	                !this.workerSources[mapId][params.type][params.source]) {
@@ -27394,22 +27420,28 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                worker.removeSource(params);
 	            }
 	        }));
-	        this.actor.registerMessageHandler('setReferrer', (_mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("RM" /* MessageType.removeMap */, (mapId) => performance.__awaiter(this, void 0, void 0, function* () {
+	            delete this.layerIndexes[mapId];
+	            delete this.availableImages[mapId];
+	            delete this.workerSources[mapId];
+	            delete this.demWorkerSources[mapId];
+	        }));
+	        this.actor.registerMessageHandler("SR" /* MessageType.setReferrer */, (_mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            this.referrer = params;
 	        }));
-	        this.actor.registerMessageHandler('syncRTLPluginState', (mapId, params) => {
+	        this.actor.registerMessageHandler("SRPS" /* MessageType.syncRTLPluginState */, (mapId, params) => {
 	            return this._syncRTLPluginState(mapId, params);
 	        });
-	        this.actor.registerMessageHandler('importScript', (_mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("IS" /* MessageType.importScript */, (_mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            this.self.importScripts(params);
 	        }));
-	        this.actor.registerMessageHandler('setImages', (mapId, params) => {
+	        this.actor.registerMessageHandler("SI" /* MessageType.setImages */, (mapId, params) => {
 	            return this._setImages(mapId, params);
 	        });
-	        this.actor.registerMessageHandler('updateLayers', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("UL" /* MessageType.updateLayers */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            this._getLayerIndex(mapId).update(params.layers, params.removedIds);
 	        }));
-	        this.actor.registerMessageHandler('setLayers', (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
+	        this.actor.registerMessageHandler("SL" /* MessageType.setLayers */, (mapId, params) => performance.__awaiter(this, void 0, void 0, function* () {
 	            this._getLayerIndex(mapId).replace(params);
 	        }));
 	    }
@@ -27424,19 +27456,34 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            }
 	        });
 	    }
-	    _syncRTLPluginState(map, state) {
+	    _syncRTLPluginState(mapId, incomingState) {
 	        return performance.__awaiter(this, void 0, void 0, function* () {
-	            performance.rtlWorkerPlugin.setState(state);
-	            const pluginURL = performance.rtlWorkerPlugin.getPluginURL();
-	            if (state.pluginStatus === 'loaded' && !performance.rtlWorkerPlugin.isParsed() && pluginURL != null) {
-	                this.self.importScripts(pluginURL);
-	                const complete = performance.rtlWorkerPlugin.isParsed();
-	                if (complete) {
-	                    return complete;
-	                }
-	                throw new Error(`RTL Text Plugin failed to import scripts from ${pluginURL}`);
+	            // Parsed plugin cannot be changed, so just return its current state.
+	            if (performance.rtlWorkerPlugin.isParsed()) {
+	                return performance.rtlWorkerPlugin.getState();
+	            }
+	            if (incomingState.pluginStatus !== 'loading') {
+	                // simply sync and done
+	                performance.rtlWorkerPlugin.setState(incomingState);
+	                return incomingState;
+	            }
+	            const urlToLoad = incomingState.pluginURL;
+	            this.self.importScripts(urlToLoad);
+	            const complete = performance.rtlWorkerPlugin.isParsed();
+	            if (complete) {
+	                const loadedState = {
+	                    pluginStatus: 'loaded',
+	                    pluginURL: urlToLoad
+	                };
+	                performance.rtlWorkerPlugin.setState(loadedState);
+	                return loadedState;
 	            }
-	            return false;
+	            // error case
+	            performance.rtlWorkerPlugin.setState({
+	                pluginStatus: 'error',
+	                pluginURL: ''
+	            });
+	            throw new Error(`RTL Text Plugin failed to import scripts from ${urlToLoad}`);
 	        });
 	    }
 	    _getAvailableImages(mapId) {
@@ -27514,11 +27561,15 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	define('index', ['exports', './shared'], (function (exports, performance$1) {
 	var name = "azuremaps-maplibre-gl";
 	var description = "BSD licensed community fork of mapbox-gl, a WebGL interactive maps library";
-	var version$2 = "4.0.2";
+	var version$2 = "4.1.2";
 	var main = "dist/azuremaps-maplibre-gl.js";
 	var style = "dist/azuremaps-maplibre-gl.css";
 	var license = "BSD-3-Clause";
+	var homepage = "https://maplibre.org/";
 	var funding = "https://github.com/maplibre/maplibre-gl-js?sponsor=1";
+	var bugs = {
+		url: "https://github.com/maplibre/maplibre-gl-js/issues/"
+	};
 	var repository = {
 		type: "git",
 		url: "https://dev.azure.com/msazure/One/_git/Azure-IoT-Maps-maplibre-gl-js"
@@ -27568,7 +27619,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 		"@types/d3": "^7.4.3",
 		"@types/diff": "^5.0.9",
 		"@types/earcut": "^2.1.4",
-		"@types/eslint": "^8.56.2",
+		"@types/eslint": "^8.56.7",
 		"@types/gl": "^6.0.5",
 		"@types/glob": "^8.1.0",
 		"@types/jest": "^29.5.12",
@@ -27576,74 +27627,74 @@ var azuremapsMaplibreGlDev = {exports: {}};
 		"@types/minimist": "^1.2.5",
 		"@types/murmurhash-js": "^1.0.6",
 		"@types/nise": "^1.4.4",
-		"@types/node": "^20.11.19",
+		"@types/node": "^20.12.6",
 		"@types/offscreencanvas": "^2019.7.3",
 		"@types/pixelmatch": "^5.2.6",
 		"@types/pngjs": "^6.0.4",
-		"@types/react": "^18.2.56",
-		"@types/react-dom": "^18.2.19",
+		"@types/react": "^18.2.75",
+		"@types/react-dom": "^18.2.24",
 		"@types/request": "^2.48.12",
 		"@types/shuffle-seed": "^1.1.3",
 		"@types/window-or-global": "^1.0.6",
-		"@typescript-eslint/eslint-plugin": "^7.0.0",
-		"@typescript-eslint/parser": "^6.21.0",
-		address: "^2.0.1",
+		"@typescript-eslint/eslint-plugin": "^7.6.0",
+		"@typescript-eslint/parser": "^7.6.0",
+		address: "^2.0.2",
 		benchmark: "^2.1.4",
 		canvas: "^2.11.2",
-		cssnano: "^6.0.3",
-		d3: "^7.8.5",
+		cssnano: "^6.1.2",
+		d3: "^7.9.0",
 		"d3-queue": "^3.0.7",
-		"devtools-protocol": "^0.0.1262051",
+		"devtools-protocol": "^0.0.1284279",
 		diff: "^5.2.0",
 		"dts-bundle-generator": "^9.3.1",
-		eslint: "^8.56.0",
+		eslint: "^8.57.0",
 		"eslint-config-mourner": "^3.0.0",
 		"eslint-plugin-html": "^8.0.0",
 		"eslint-plugin-import": "^2.29.1",
-		"eslint-plugin-jest": "^27.9.0",
-		"eslint-plugin-react": "^7.33.2",
+		"eslint-plugin-jest": "^28.2.0",
+		"eslint-plugin-react": "^7.34.1",
 		"eslint-plugin-tsdoc": "0.2.17",
 		expect: "^29.7.0",
-		glob: "^10.3.10",
+		glob: "^10.3.12",
 		"is-builtin-module": "^3.2.1",
 		jest: "^29.7.0",
 		"jest-environment-jsdom": "^29.7.0",
-		"jest-monocart-coverage": "^1.0.2",
+		"jest-monocart-coverage": "^1.1.0",
 		"jest-webgl-canvas-mock": "^2.5.3",
 		jsdom: "^24.0.0",
 		"json-stringify-pretty-compact": "^4.0.0",
 		minimist: "^1.2.8",
 		"mock-geolocation": "^1.0.11",
-		"monocart-coverage-reports": "^2.5.0",
+		"monocart-coverage-reports": "^2.7.8",
 		nise: "^5.1.9",
 		"npm-font-open-sans": "^1.1.0",
 		"npm-run-all": "^4.1.5",
 		"pdf-merger-js": "^5.1.1",
 		pixelmatch: "^5.3.0",
 		pngjs: "^7.0.0",
-		postcss: "^8.4.35",
+		postcss: "^8.4.38",
 		"postcss-cli": "^11.0.0",
 		"postcss-inline-svg": "^6.0.0",
 		"pretty-bytes": "^6.1.1",
-		puppeteer: "^22.1.0",
+		puppeteer: "^22.6.3",
 		react: "^18.2.0",
 		"react-dom": "^18.2.0",
-		rollup: "^4.12.0",
+		rollup: "^4.14.1",
 		"rollup-plugin-sourcemaps": "^0.6.3",
 		rw: "^1.3.3",
 		semver: "^7.6.0",
 		"shuffle-seed": "^1.1.6",
 		"source-map-explorer": "^2.5.3",
 		st: "^3.0.0",
-		stylelint: "^16.2.1",
+		stylelint: "^16.3.1",
 		"stylelint-config-standard": "^36.0.0",
 		"ts-jest": "^29.1.2",
 		"ts-node": "^10.9.2",
 		tslib: "^2.6.2",
-		typedoc: "^0.25.8",
+		typedoc: "^0.25.13",
 		"typedoc-plugin-markdown": "^3.17.1",
 		"typedoc-plugin-missing-exports": "^2.2.0",
-		typescript: "^5.3.3"
+		typescript: "^5.4.4"
 	};
 	var overrides = {
 		"postcss-inline-svg": {
@@ -27658,18 +27709,17 @@ var azuremapsMaplibreGlDev = {exports: {}};
 		"generate-shaders": "node --no-warnings --loader ts-node/esm build/generate-shaders.ts",
 		"generate-struct-arrays": "node --no-warnings --loader ts-node/esm build/generate-struct-arrays.ts",
 		"generate-style-code": "node --no-warnings --loader ts-node/esm build/generate-style-code.ts",
-		"generate-typings": "dts-bundle-generator --export-referenced-types --umd-module-name=maplibregl -o ./dist/azuremaps-maplibre-gl.d.ts ./src/index.ts",
+		"generate-typings": "dts-bundle-generator --export-referenced-types --umd-module-name=maplibregl -o ./dist/maplibre-gl.d.ts ./src/index.ts",
 		"generate-docs": "typedoc && node --no-warnings --loader ts-node/esm build/generate-docs.ts",
 		"generate-images": "node --no-warnings --loader ts-node/esm build/generate-doc-images.ts",
 		"build-dist": "npm run build-css && npm run generate-typings && npm run build-dev && npm run build-csp-dev && npm run build-prod && npm run build-csp",
-		"build-aml-package": "npm run build-dist && node ./build/build-aml-package.js",
 		"build-dev": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:dev",
 		"watch-dev": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:dev --watch",
 		"build-prod": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:production",
 		"build-csp": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.csp.ts",
 		"build-csp-dev": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.csp.ts --environment BUILD:dev",
-		"build-css": "postcss -o dist/azuremaps-maplibre-gl.css src/css/azuremaps-maplibre-gl.css",
-		"watch-css": "postcss --watch -o dist/azuremaps-maplibre-gl.css src/css/azuremaps-maplibre-gl.css",
+		"build-css": "postcss -o dist/maplibre-gl.css src/css/maplibre-gl.css",
+		"watch-css": "postcss --watch -o dist/maplibre-gl.css src/css/maplibre-gl.css",
 		"build-benchmarks": "npm run build-dev && rollup --configPlugin @rollup/plugin-typescript -c test/bench/rollup_config_benchmarks.ts",
 		"watch-benchmarks": "rollup --configPlugin @rollup/plugin-typescript -c test/bench/rollup_config_benchmarks.ts --watch",
 		"start-server": "st --no-cache -H 0.0.0.0 --port 9966 .",
@@ -27693,7 +27743,14 @@ var azuremapsMaplibreGlDev = {exports: {}};
 		"gl-stats": "node --no-warnings --loader ts-node/esm test/bench/gl-stats.ts",
 		prepare: "npm run codegen",
 		typecheck: "tsc --noEmit && tsc --project tsconfig.dist.json",
-		tsnode: "node --experimental-loader=ts-node/esm --no-warnings"
+		tsnode: "node --experimental-loader=ts-node/esm --no-warnings",
+		"build-aml-css": "postcss -o dist/azuremaps-maplibre-gl.css src/css/azuremaps-maplibre-gl.css",
+		"watch-aml-css": "postcss --watch -o dist/azuremaps-maplibre-gl.css src/css/azuremaps-maplibre-gl.css",
+		"build-es2017-dev": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.es2017.ts --environment BUILD:dev",
+		"build-es2017": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.es2017.ts --environment BUILD:production",
+		"generate-aml-typings": "dts-bundle-generator --export-referenced-types --umd-module-name=maplibregl -o ./dist/azuremaps-maplibre-gl.d.ts ./src/index.ts",
+		"build-aml-dist": "npm run generate-aml-typings && run-p --print-label build-aml-css build-dev build-prod build-es2017-dev build-es2017",
+		"build-aml-package": "npm run build-aml-dist && node ./build/build-aml-package.js"
 	};
 	var files = [
 		"build/",
@@ -27712,7 +27769,9 @@ var azuremapsMaplibreGlDev = {exports: {}};
 		main: main,
 		style: style,
 		license: license,
+		homepage: homepage,
 		funding: funding,
+		bugs: bugs,
 		repository: repository,
 		types: types,
 		type: type,
@@ -28142,20 +28201,6 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	})(ImageRequest || (ImageRequest = {}));
 	ImageRequest.resetRequestQueue();
 
-	/**
-	 * A type of MapLibre resource.
-	 */
-	var ResourceType;
-	(function (ResourceType) {
-	    ResourceType["Glyphs"] = "Glyphs";
-	    ResourceType["Image"] = "Image";
-	    ResourceType["Source"] = "Source";
-	    ResourceType["SpriteImage"] = "SpriteImage";
-	    ResourceType["SpriteJSON"] = "SpriteJSON";
-	    ResourceType["Style"] = "Style";
-	    ResourceType["Tile"] = "Tile";
-	    ResourceType["Unknown"] = "Unknown";
-	})(ResourceType || (ResourceType = {}));
 	class RequestManager {
 	    constructor(transformRequestFn) {
 	        this._transformRequestFn = transformRequestFn;
@@ -28225,9 +28270,9 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        const jsonsMap = {};
 	        const imagesMap = {};
 	        for (const { id, url } of spriteArray) {
-	            const jsonRequestParameters = requestManager.transformRequest(requestManager.normalizeSpriteURL(url, format, '.json'), ResourceType.SpriteJSON);
+	            const jsonRequestParameters = requestManager.transformRequest(requestManager.normalizeSpriteURL(url, format, '.json'), "SpriteJSON" /* ResourceType.SpriteJSON */);
 	            jsonsMap[id] = performance$1.getJSON(jsonRequestParameters, abortController);
-	            const imageRequestParameters = requestManager.transformRequest(requestManager.normalizeSpriteURL(url, format, '.png'), ResourceType.SpriteImage);
+	            const imageRequestParameters = requestManager.transformRequest(requestManager.normalizeSpriteURL(url, format, '.png'), "SpriteImage" /* ResourceType.SpriteImage */);
 	            imagesMap[id] = ImageRequest.getImage(imageRequestParameters, abortController);
 	        }
 	        yield Promise.all([...Object.values(jsonsMap), ...Object.values(imagesMap)]);
@@ -28599,7 +28644,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	    return performance$1.__awaiter(this, void 0, void 0, function* () {
 	        const begin = range * 256;
 	        const end = begin + 255;
-	        const request = requestManager.transformRequest(urlTemplate.replace('{fontstack}', fontstack).replace('{range}', `${begin}-${end}`), ResourceType.Glyphs);
+	        const request = requestManager.transformRequest(urlTemplate.replace('{fontstack}', fontstack).replace('{range}', `${begin}-${end}`), "Glyphs" /* ResourceType.Glyphs */);
 	        const response = yield performance$1.getArrayBuffer(request, new AbortController());
 	        if (!response || !response.data) {
 	            throw new Error(`Could not load glyph range. range: ${range}, ${begin}-${end}`);
@@ -29302,7 +29347,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	function getGlobalDispatcher() {
 	    if (!globalDispatcher) {
 	        globalDispatcher = new Dispatcher(getGlobalWorkerPool(), performance$1.GLOBAL_DISPATCHER_ID);
-	        globalDispatcher.registerMessageHandler('getResource', (_mapId, params, abortController) => {
+	        globalDispatcher.registerMessageHandler("GR" /* MessageType.getResource */, (_mapId, params, abortController) => {
 	            return performance$1.makeRequest(params, abortController);
 	        });
 	    }
@@ -29466,7 +29511,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	    return performance$1.__awaiter(this, void 0, void 0, function* () {
 	        let tileJSON = options;
 	        if (options.url) {
-	            const response = yield performance$1.getJSON(requestManager.transformRequest(options.url, ResourceType.Source), abortController);
+	            const response = yield performance$1.getJSON(requestManager.transformRequest(options.url, "Source" /* ResourceType.Source */), abortController);
 	            tileJSON = response.data;
 	        }
 	        else {
@@ -29934,7 +29979,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        return performance$1.__awaiter(this, void 0, void 0, function* () {
 	            const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme);
 	            const params = {
-	                request: this.map._requestManager.transformRequest(url, ResourceType.Tile),
+	                request: this.map._requestManager.transformRequest(url, "Tile" /* ResourceType.Tile */),
 	                uid: tile.uid,
 	                tileID: tile.tileID,
 	                zoom: tile.tileID.overscaledZ,
@@ -29946,10 +29991,10 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                promoteId: this.promoteId
 	            };
 	            params.request.collectResourceTiming = this._collectResourceTiming;
-	            let messageType = 'reloadTile';
+	            let messageType = "RT" /* MessageType.reloadTile */;
 	            if (!tile.actor || tile.state === 'expired') {
 	                tile.actor = this.dispatcher.getActor();
-	                messageType = 'loadTile';
+	                messageType = "LT" /* MessageType.loadTile */;
 	            }
 	            else if (tile.state === 'loading') {
 	                return new Promise((resolve, reject) => {
@@ -29998,7 +30043,10 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                delete tile.abortController;
 	            }
 	            if (tile.actor) {
-	                yield tile.actor.sendAsync({ type: 'abortTile', data: { uid: tile.uid, type: this.type, source: this.id } });
+	                yield tile.actor.sendAsync({
+	                    type: "AT" /* MessageType.abortTile */,
+	                    data: { uid: tile.uid, type: this.type, source: this.id }
+	                });
 	            }
 	        });
 	    }
@@ -30006,7 +30054,14 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        return performance$1.__awaiter(this, void 0, void 0, function* () {
 	            tile.unloadVectorData();
 	            if (tile.actor) {
-	                yield tile.actor.sendAsync({ type: 'removeTile', data: { uid: tile.uid, type: this.type, source: this.id } });
+	                yield tile.actor.sendAsync({
+	                    type: "RMT" /* MessageType.removeTile */,
+	                    data: {
+	                        uid: tile.uid,
+	                        type: this.type,
+	                        source: this.id
+	                    }
+	                });
 	            }
 	        });
 	    }
@@ -30143,7 +30198,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme);
 	            tile.abortController = new AbortController();
 	            try {
-	                const response = yield ImageRequest.getImage(this.map._requestManager.transformRequest(url, ResourceType.Tile), tile.abortController, this.map._refreshExpiredTiles);
+	                const response = yield ImageRequest.getImage(this.map._requestManager.transformRequest(url, "Tile" /* ResourceType.Tile */), tile.abortController, this.map._refreshExpiredTiles);
 	                delete tile.abortController;
 	                if (tile.aborted) {
 	                    tile.state = 'unloaded';
@@ -30233,7 +30288,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	    loadTile(tile) {
 	        return performance$1.__awaiter(this, void 0, void 0, function* () {
 	            const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme);
-	            const request = this.map._requestManager.transformRequest(url, ResourceType.Tile);
+	            const request = this.map._requestManager.transformRequest(url, "Tile" /* ResourceType.Tile */);
 	            tile.neighboringTiles = this._getNeighboringTiles(tile.tileID);
 	            tile.abortController = new AbortController();
 	            try {
@@ -30264,7 +30319,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                    if (!tile.actor || tile.state === 'expired') {
 	                        tile.actor = this.dispatcher.getActor();
 	                        /* eslint-disable require-atomic-updates */
-	                        const data = yield tile.actor.sendAsync({ type: 'loadDEMTile', data: params });
+	                        const data = yield tile.actor.sendAsync({ type: "LDT" /* MessageType.loadDEMTile */, data: params });
 	                        tile.dem = data;
 	                        tile.needsHillshadePrepare = true;
 	                        tile.needsTerrainPrepare = true;
@@ -30338,7 +30393,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            delete tile.neighboringTiles;
 	            tile.state = 'unloaded';
 	            if (tile.actor) {
-	                yield tile.actor.sendAsync({ type: 'removeDEMTile', data: { type: this.type, uid: tile.uid, source: this.id } });
+	                yield tile.actor.sendAsync({ type: "RDT" /* MessageType.removeDEMTile */, data: { type: this.type, uid: tile.uid, source: this.id } });
 	            }
 	        });
 	    }
@@ -30524,7 +30579,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	     * @returns a promise that is resolved with the zoom number
 	     */
 	    getClusterExpansionZoom(clusterId) {
-	        return this.actor.sendAsync({ type: 'getClusterExpansionZoom', data: { type: this.type, clusterId, source: this.id } });
+	        return this.actor.sendAsync({ type: "GCEZ" /* MessageType.getClusterExpansionZoom */, data: { type: this.type, clusterId, source: this.id } });
 	    }
 	    /**
 	     * For clustered sources, fetches the children of the given cluster on the next zoom level (as an array of GeoJSON features).
@@ -30533,7 +30588,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	     * @returns a promise that is resolved when the features are retrieved
 	     */
 	    getClusterChildren(clusterId) {
-	        return this.actor.sendAsync({ type: 'getClusterChildren', data: { type: this.type, clusterId, source: this.id } });
+	        return this.actor.sendAsync({ type: "GCC" /* MessageType.getClusterChildren */, data: { type: this.type, clusterId, source: this.id } });
 	    }
 	    /**
 	     * For clustered sources, fetches the original points that belong to the cluster (as an array of GeoJSON features).
@@ -30561,7 +30616,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	     * ```
 	     */
 	    getClusterLeaves(clusterId, limit, offset) {
-	        return this.actor.sendAsync({ type: 'getClusterLeaves', data: {
+	        return this.actor.sendAsync({ type: "GCL" /* MessageType.getClusterLeaves */, data: {
 	                type: this.type,
 	                source: this.id,
 	                clusterId,
@@ -30582,7 +30637,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                options.dataDiff = diff;
 	            }
 	            else if (typeof this._data === 'string') {
-	                options.request = this.map._requestManager.transformRequest(browser.resolveURL(this._data), ResourceType.Source);
+	                options.request = this.map._requestManager.transformRequest(browser.resolveURL(this._data), "Source" /* ResourceType.Source */);
 	                options.request.collectResourceTiming = this._collectResourceTiming;
 	            }
 	            else {
@@ -30591,7 +30646,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            this._pendingLoads++;
 	            this.fire(new performance$1.Event('dataloading', { dataType: 'source' }));
 	            try {
-	                const result = yield this.actor.sendAsync({ type: 'loadData', data: options });
+	                const result = yield this.actor.sendAsync({ type: "LD" /* MessageType.loadData */, data: options });
 	                this._pendingLoads--;
 	                if (this._removed || result.abandoned) {
 	                    this.fire(new performance$1.Event('dataabort', { dataType: 'source' }));
@@ -30625,7 +30680,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	    }
 	    loadTile(tile) {
 	        return performance$1.__awaiter(this, void 0, void 0, function* () {
-	            const message = !tile.actor ? 'loadTile' : 'reloadTile';
+	            const message = !tile.actor ? "LT" /* MessageType.loadTile */ : "RT" /* MessageType.reloadTile */;
 	            tile.actor = this.actor;
 	            const params = {
 	                type: this.type,
@@ -30644,7 +30699,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            delete tile.abortController;
 	            tile.unloadVectorData();
 	            if (!tile.aborted) {
-	                tile.loadVectorData(data, this.map.painter, message === 'reloadTile');
+	                tile.loadVectorData(data, this.map.painter, message === "RT" /* MessageType.reloadTile */);
 	            }
 	        });
 	    }
@@ -30660,12 +30715,12 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	    unloadTile(tile) {
 	        return performance$1.__awaiter(this, void 0, void 0, function* () {
 	            tile.unloadVectorData();
-	            yield this.actor.sendAsync({ type: 'removeTile', data: { uid: tile.uid, type: this.type, source: this.id } });
+	            yield this.actor.sendAsync({ type: "RMT" /* MessageType.removeTile */, data: { uid: tile.uid, type: this.type, source: this.id } });
 	        });
 	    }
 	    onRemove() {
 	        this._removed = true;
-	        this.actor.sendAsync({ type: 'removeSource', data: { type: this.type, source: this.id } });
+	        this.actor.sendAsync({ type: "RS" /* MessageType.removeSource */, data: { type: this.type, source: this.id } });
 	    }
 	    serialize() {
 	        return performance$1.extend({}, this._options, {
@@ -30749,7 +30804,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            this.url = this.options.url;
 	            this._request = new AbortController();
 	            try {
-	                const image = yield ImageRequest.getImage(this.map._requestManager.transformRequest(this.url, ResourceType.Image), this._request);
+	                const image = yield ImageRequest.getImage(this.map._requestManager.transformRequest(this.url, "Image" /* ResourceType.Image */), this._request);
 	                this._request = null;
 	                this._loaded = true;
 	                if (image && image.data) {
@@ -30977,7 +31032,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            const options = this.options;
 	            this.urls = [];
 	            for (const url of options.urls) {
-	                this.urls.push(this.map._requestManager.transformRequest(url, ResourceType.Source).url);
+	                this.urls.push(this.map._requestManager.transformRequest(url, "Source" /* ResourceType.Source */).url);
 	            }
 	            try {
 	                const video = yield performance$1.getVideo(this.urls);
@@ -31344,65 +31399,78 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	    return output;
 	}
 
+	const RTLPluginLoadedEventName = 'RTLPluginLoaded';
+
 	class RTLMainThreadPlugin extends performance$1.Evented {
 	    constructor() {
 	        super(...arguments);
-	        this.pluginStatus = 'unavailable';
-	        this.pluginURL = null;
+	        this.status = 'unavailable';
+	        this.url = null;
 	        this.dispatcher = getGlobalDispatcher();
-	        this.queue = [];
 	    }
-	    _sendPluginStateToWorker() {
-	        return performance$1.__awaiter(this, void 0, void 0, function* () {
-	            yield this.dispatcher.broadcast('syncRTLPluginState', { pluginStatus: this.pluginStatus, pluginURL: this.pluginURL });
-	            this.fire(new performance$1.Event('pluginStateChange', { pluginStatus: this.pluginStatus, pluginURL: this.pluginURL }));
+	    /** Sync RTL plugin state by broadcasting a message to the worker */
+	    _syncState(statusToSend) {
+	        this.status = statusToSend;
+	        return this.dispatcher.broadcast("SRPS" /* MessageType.syncRTLPluginState */, { pluginStatus: statusToSend, pluginURL: this.url })
+	            .catch((e) => {
+	            this.status = 'error';
+	            throw e;
 	        });
 	    }
+	    /** This one is exposed to outside */
 	    getRTLTextPluginStatus() {
-	        return this.pluginStatus;
+	        return this.status;
 	    }
 	    clearRTLTextPlugin() {
-	        this.pluginStatus = 'unavailable';
-	        this.pluginURL = null;
+	        this.status = 'unavailable';
+	        this.url = null;
 	    }
-	    setRTLTextPlugin(url, deferred = false) {
-	        return performance$1.__awaiter(this, void 0, void 0, function* () {
-	            if (this.pluginStatus === 'deferred' || this.pluginStatus === 'loading' || this.pluginStatus === 'loaded') {
+	    setRTLTextPlugin(url_1) {
+	        return performance$1.__awaiter(this, arguments, void 0, function* (url, deferred = false) {
+	            if (this.url) {
+	                // error
 	                throw new Error('setRTLTextPlugin cannot be called multiple times.');
 	            }
-	            this.pluginURL = browser.resolveURL(url);
-	            this.pluginStatus = 'deferred';
-	            yield this._sendPluginStateToWorker();
-	            if (!deferred) {
-	                //Start downloading the plugin immediately if not intending to lazy-load
-	                yield this._downloadRTLTextPlugin();
-	            }
-	        });
-	    }
-	    _downloadRTLTextPlugin() {
-	        return performance$1.__awaiter(this, void 0, void 0, function* () {
-	            if (this.pluginStatus !== 'deferred' || !this.pluginURL) {
-	                throw new Error('rtl-text-plugin cannot be downloaded unless a pluginURL is specified');
-	            }
-	            try {
-	                this.pluginStatus = 'loading';
-	                yield this._sendPluginStateToWorker();
-	                yield performance$1.getArrayBuffer({ url: this.pluginURL }, new AbortController());
-	                this.pluginStatus = 'loaded';
+	            this.url = browser.resolveURL(url);
+	            if (!this.url) {
+	                throw new Error(`requested url ${url} is invalid`);
+	            }
+	            if (this.status === 'unavailable') {
+	                // from initial state:
+	                if (deferred) {
+	                    this.status = 'deferred';
+	                    // fire and forget: in this case it does not need wait for the broadcasting result
+	                    // it is important to sync the deferred status once because
+	                    // symbol_bucket will be checking it in worker
+	                    this._syncState(this.status);
+	                }
+	                else {
+	                    return this._requestImport();
+	                }
 	            }
-	            catch (_a) {
-	                this.pluginStatus = 'error';
+	            else if (this.status === 'requested') {
+	                return this._requestImport();
 	            }
-	            yield this._sendPluginStateToWorker();
 	        });
 	    }
-	    lazyLoadRTLTextPlugin() {
+	    /** Send a message to worker which will import the RTL plugin script */
+	    _requestImport() {
 	        return performance$1.__awaiter(this, void 0, void 0, function* () {
-	            if (this.pluginStatus === 'deferred') {
-	                yield this._downloadRTLTextPlugin();
-	            }
+	            // all errors/exceptions will be handled by _syncState
+	            yield this._syncState('loading');
+	            this.status = 'loaded';
+	            this.fire(new performance$1.Event(RTLPluginLoadedEventName));
 	        });
 	    }
+	    /** Start a lazy loading process of RTL plugin */
+	    lazyLoad() {
+	        if (this.status === 'unavailable') {
+	            this.status = 'requested';
+	        }
+	        else if (this.status === 'deferred') {
+	            this._requestImport();
+	        }
+	    }
 	}
 	let rtlMainThreadPlugin = null;
 	function rtlMainThreadPluginFactory() {
@@ -31514,7 +31582,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	                if (bucket instanceof performance$1.SymbolBucket) {
 	                    if (bucket.hasRTLText) {
 	                        this.hasRTLText = true;
-	                        rtlMainThreadPluginFactory().lazyLoadRTLTextPlugin();
+	                        rtlMainThreadPluginFactory().lazyLoad();
 	                        break;
 	                    }
 	                }
@@ -35272,7 +35340,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	class Style extends performance$1.Evented {
 	    constructor(map, options = {}) {
 	        super();
-	        this._rtlTextPluginStateChange = () => {
+	        this._rtlPluginLoaded = () => {
 	            for (const id in this.sourceCaches) {
 	                const sourceType = this.sourceCaches[id].getSource().type;
 	                if (sourceType === 'vector' || sourceType === 'geojson') {
@@ -35285,10 +35353,10 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        };
 	        this.map = map;
 	        this.dispatcher = new Dispatcher(getGlobalWorkerPool(), map._getMapId());
-	        this.dispatcher.registerMessageHandler('getGlyphs', (mapId, params) => {
+	        this.dispatcher.registerMessageHandler("GG" /* MessageType.getGlyphs */, (mapId, params) => {
 	            return this.getGlyphs(mapId, params);
 	        });
-	        this.dispatcher.registerMessageHandler('getImages', (mapId, params) => {
+	        this.dispatcher.registerMessageHandler("GI" /* MessageType.getImages */, (mapId, params) => {
 	            return this.getImages(mapId, params);
 	        });
 	        this.imageManager = new ImageManager();
@@ -35304,8 +35372,8 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        this._loaded = false;
 	        this._availableImages = [];
 	        this._resetUpdates();
-	        this.dispatcher.broadcast('setReferrer', performance$1.getReferrer());
-	        rtlMainThreadPluginFactory().on('pluginStateChange', this._rtlTextPluginStateChange);
+	        this.dispatcher.broadcast("SR" /* MessageType.setReferrer */, performance$1.getReferrer());
+	        rtlMainThreadPluginFactory().on(RTLPluginLoadedEventName, this._rtlPluginLoaded);
 	        this.on('data', (event) => {
 	            if (event.dataType !== 'source' || event.sourceDataType !== 'metadata') {
 	                return;
@@ -35330,7 +35398,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        this.fire(new performance$1.Event('dataloading', { dataType: 'style' }));
 	        options.validate = typeof options.validate === 'boolean' ?
 	            options.validate : true;
-	        const request = this.map._requestManager.transformRequest(url, ResourceType.Style);
+	        const request = this.map._requestManager.transformRequest(url, "Style" /* ResourceType.Style */);
 	        this._loadStyleRequest = new AbortController();
 	        performance$1.getJSON(request, this._loadStyleRequest).then((response) => {
 	            this._loadStyleRequest = null;
@@ -35383,7 +35451,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        const dereferencedLayers = performance$1.derefLayers(this.stylesheet.layers);
 	        // Broadcast layers to workers first, so that expensive style processing (createStyleLayer)
 	        // can happen in parallel on both main and worker threads.
-	        this.dispatcher.broadcast('setLayers', dereferencedLayers);
+	        this.dispatcher.broadcast("SL" /* MessageType.setLayers */, dereferencedLayers);
 	        this._order = dereferencedLayers.map((layer) => layer.id);
 	        this._layers = {};
 	        // reset serialization field, to be populated only when needed
@@ -35436,7 +35504,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            if (isUpdate) {
 	                this._changed = true;
 	            }
-	            this.dispatcher.broadcast('setImages', this._availableImages);
+	            this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages);
 	            this.fire(new performance$1.Event('data', { dataType: 'style' }));
 	            if (completion) {
 	                completion(err);
@@ -35451,7 +35519,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        this._spritesImagesIds = {};
 	        this._availableImages = this.imageManager.listImages();
 	        this._changed = true;
-	        this.dispatcher.broadcast('setImages', this._availableImages);
+	        this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages);
 	        this.fire(new performance$1.Event('data', { dataType: 'style' }));
 	    }
 	    _validateLayer(layer) {
@@ -35622,7 +35690,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        }
 	    }
 	    _updateWorkerLayers(updatedIds, removedIds) {
-	        this.dispatcher.broadcast('updateLayers', {
+	        this.dispatcher.broadcast("UL" /* MessageType.updateLayers */, {
 	            layers: this._serializeByIds(updatedIds),
 	            removedIds
 	        });
@@ -35757,7 +35825,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        this._availableImages = this.imageManager.listImages();
 	        this._changedImages[id] = true;
 	        this._changed = true;
-	        this.dispatcher.broadcast('setImages', this._availableImages);
+	        this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages);
 	        this.fire(new performance$1.Event('data', { dataType: 'style' }));
 	    }
 	    listImages() {
@@ -36336,7 +36404,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	            this._spriteRequest.abort();
 	            this._spriteRequest = null;
 	        }
-	        rtlMainThreadPluginFactory().off('pluginStateChange', this._rtlTextPluginStateChange);
+	        rtlMainThreadPluginFactory().off(RTLPluginLoadedEventName, this._rtlPluginLoaded);
 	        for (const layerId in this._layers) {
 	            const layer = this._layers[layerId];
 	            layer.setEventedParent(null);
@@ -36348,6 +36416,9 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        }
 	        this.imageManager.setEventedParent(null);
 	        this.setEventedParent(null);
+	        if (mapRemoved) {
+	            this.dispatcher.broadcast("RM" /* MessageType.removeMap */, undefined);
+	        }
 	        this.dispatcher.remove(mapRemoved);
 	    }
 	    _clearSource(id) {
@@ -36522,7 +36593,7 @@ var azuremapsMaplibreGlDev = {exports: {}};
 	        delete this._spritesImagesIds[id];
 	        this._availableImages = this.imageManager.listImages();
 	        this._changed = true;
-	        this.dispatcher.broadcast('setImages', this._availableImages);
+	        this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages);
 	        this.fire(new performance$1.Event('data', { dataType: 'style' }));
 	    }
 	    /**
@@ -39065,12 +39136,10 @@ uniform ${precision} ${type} u_${name};
 	    for (const segmentState of tileRenderState) {
 	        const state = segmentState.state;
 	        context.activeTexture.set(gl.TEXTURE0);
-	        // @ts-ignore
 	        state.atlasTexture.bind(state.atlasInterpolation, gl.CLAMP_TO_EDGE);
 	        if (state.atlasTextureIcon) {
 	            context.activeTexture.set(gl.TEXTURE1);
 	            if (state.atlasTextureIcon) {
-	                // @ts-ignore
 	                state.atlasTextureIcon.bind(state.atlasInterpolationIcon, gl.CLAMP_TO_EDGE);
 	            }
 	        }
@@ -39938,7 +40007,7 @@ uniform ${precision} ${type} u_${name};
 	        this.context = new Context(gl);
 	        this.transform = transform;
 	        this._tileTextures = {};
-	        this.terrainFacilitator = { dirty: true, matrix: performance$1.create(), renderTime: 0 };
+	        this.terrainFacilitator = { dirty: true, matrix: performance$1.identity(new Float64Array(16)), renderTime: 0 };
 	        this.setup();
 	        // Within each layer there are multiple distinct z-planes that can be drawn to.
 	        // This is implemented using the WebGL depth buffer.
@@ -40147,19 +40216,11 @@ uniform ${precision} ${type} u_${name};
 	                break;
 	            }
 	        }
+	        this.maybeDrawDepthAndCoords(false);
 	        if (this.renderToTexture) {
 	            this.renderToTexture.prepareForRender(this.style, this.transform.zoom);
 	            // this is disabled, because render-to-texture is rendering all layers from bottom to top.
 	            this.opaquePassCutoff = 0;
-	            // update coords/depth-framebuffer on camera movement, or tile reloading
-	            const newTiles = this.style.map.terrain.sourceCache.tilesAfterTime(this.terrainFacilitator.renderTime);
-	            if (this.terrainFacilitator.dirty || !performance$1.equals(this.terrainFacilitator.matrix, this.transform.projMatrix) || newTiles.length) {
-	                performance$1.copy(this.terrainFacilitator.matrix, this.transform.projMatrix);
-	                this.terrainFacilitator.renderTime = Date.now();
-	                this.terrainFacilitator.dirty = false;
-	                drawDepth(this, this.style.map.terrain);
-	                drawCoords(this, this.style.map.terrain);
-	            }
 	        }
 	        // Offscreen pass ===============================================
 	        // We first do all rendering that requires rendering to a separate
@@ -40222,6 +40283,30 @@ uniform ${precision} ${type} u_${name};
 	        // encounters more expected values.
 	        this.context.setDefault();
 	    }
+	    /**
+	     * Update the depth and coords framebuffers, if the contents of those frame buffers is out of date.
+	     * If requireExact is false, then the contents of those frame buffers is not updated if it is close
+	     * to accurate (that is, the camera has not moved much since it was updated last).
+	     */
+	    maybeDrawDepthAndCoords(requireExact) {
+	        if (!this.style || !this.style.map || !this.style.map.terrain) {
+	            return;
+	        }
+	        const prevMatrix = this.terrainFacilitator.matrix;
+	        const currMatrix = this.transform.projMatrix;
+	        // Update coords/depth-framebuffer on camera movement, or tile reloading
+	        let doUpdate = this.terrainFacilitator.dirty;
+	        doUpdate || (doUpdate = requireExact ? !performance$1.exactEquals(prevMatrix, currMatrix) : !performance$1.equals(prevMatrix, currMatrix));
+	        doUpdate || (doUpdate = this.style.map.terrain.sourceCache.tilesAfterTime(this.terrainFacilitator.renderTime).length > 0);
+	        if (!doUpdate) {
+	            return;
+	        }
+	        performance$1.copy(prevMatrix, currMatrix);
+	        this.terrainFacilitator.renderTime = Date.now();
+	        this.terrainFacilitator.dirty = false;
+	        drawDepth(this, this.style.map.terrain);
+	        drawCoords(this, this.style.map.terrain);
+	    }
 	    renderLayer(painter, sourceCache, layer, coords) {
 	        if (layer.isHidden(this.transform.zoom))
 	            return;
@@ -40569,6 +40654,7 @@ uniform ${precision} ${type} u_${name};
 	    }
 	}
 
+	const MAX_VALID_LATITUDE = 85.051129;
 	/**
 	 * @internal
 	 * A single transform, generally used for a single tile to be
@@ -40577,7 +40663,6 @@ uniform ${precision} ${type} u_${name};
 	class Transform {
 	    constructor(minZoom, maxZoom, minPitch, maxPitch, renderWorldCopies) {
 	        this.tileSize = 512; // constant
-	        this.maxValidLatitude = 85.051129; // constant
 	        this._renderWorldCopies = renderWorldCopies === undefined ? true : !!renderWorldCopies;
 	        this._minZoom = minZoom || 0;
 	        this._maxZoom = maxZoom || 22;
@@ -40723,6 +40808,9 @@ uniform ${precision} ${type} u_${name};
 	        this._constrain();
 	        this._calcMatrices();
 	    }
+	    /**
+	     * Elevation at current center point, meters above sea level
+	     */
 	    get elevation() { return this._elevation; }
 	    set elevation(elevation) {
 	        if (elevation === this._elevation)
@@ -40920,7 +41008,7 @@ uniform ${precision} ${type} u_${name};
 	     * @returns Point
 	     */
 	    project(lnglat) {
-	        const lat = performance$1.clamp(lnglat.lat, -this.maxValidLatitude, this.maxValidLatitude);
+	        const lat = performance$1.clamp(lnglat.lat, -MAX_VALID_LATITUDE, MAX_VALID_LATITUDE);
 	        return new performance$1.Point(performance$1.mercatorXfromLng(lnglat.lng) * this.worldSize, performance$1.mercatorYfromLat(lat) * this.worldSize);
 	    }
 	    /**
@@ -40948,20 +41036,24 @@ uniform ${precision} ${type} u_${name};
 	     * @param terrain - the terrain
 	     */
 	    recalculateZoom(terrain) {
+	        const origElevation = this.elevation;
+	        const origAltitude = Math.cos(this._pitch) * this.cameraToCenterDistance / this._pixelPerMeter;
 	        // find position the camera is looking on
 	        const center = this.pointLocation(this.centerPoint, terrain);
 	        const elevation = terrain.getElevationForLngLatZoom(center, this.tileZoom);
 	        const deltaElevation = this.elevation - elevation;
 	        if (!deltaElevation)
 	            return;
-	        // calculate mercator distance between camera & target
-	        const cameraPosition = this.getCameraPosition();
-	        const camera = performance$1.MercatorCoordinate.fromLngLat(cameraPosition.lngLat, cameraPosition.altitude);
-	        const target = performance$1.MercatorCoordinate.fromLngLat(center, elevation);
-	        const dx = camera.x - target.x, dy = camera.y - target.y, dz = camera.z - target.z;
-	        const distance = Math.sqrt(dx * dx + dy * dy + dz * dz);
-	        // from this distance we calculate the new zoomlevel
-	        const zoom = this.scaleZoom(this.cameraToCenterDistance / distance / this.tileSize);
+	        // The camera's altitude off the ground + the ground's elevation = a constant:
+	        // this means the camera stays at the same total height.
+	        const requiredAltitude = origAltitude + origElevation - elevation;
+	        // Since altitude = Math.cos(this._pitch) * this.cameraToCenterDistance / pixelPerMeter:
+	        const requiredPixelPerMeter = Math.cos(this._pitch) * this.cameraToCenterDistance / requiredAltitude;
+	        // Since pixelPerMeter = mercatorZfromAltitude(1, center.lat) * worldSize:
+	        const requiredWorldSize = requiredPixelPerMeter / performance$1.mercatorZfromAltitude(1, center.lat);
+	        // Since worldSize = this.tileSize * scale:
+	        const requiredScale = requiredWorldSize / this.tileSize;
+	        const zoom = this.scaleZoom(requiredScale);
 	        // update matrices
 	        this._elevation = elevation;
 	        this._center = center;
@@ -41104,7 +41196,7 @@ uniform ${precision} ${type} u_${name};
 	        }
 	        else {
 	            this.lngRange = null;
-	            this.latRange = [-this.maxValidLatitude, this.maxValidLatitude];
+	            this.latRange = [-MAX_VALID_LATITUDE, MAX_VALID_LATITUDE];
 	        }
 	    }
 	    /**
@@ -41130,60 +41222,92 @@ uniform ${precision} ${type} u_${name};
 	    customLayerMatrix() {
 	        return this.mercatorMatrix.slice();
 	    }
-	    _constrain() {
-	        if (!this.center || !this.width || !this.height || this._constraining)
-	            return;
-	        this._constraining = true;
-	        let minY = -90;
-	        let maxY = 90;
-	        let minX = -180;
-	        let maxX = 180;
-	        let sy, sx, x2, y2;
-	        const size = this.size, unmodified = this._unmodified;
+	    /**
+	     * Get center lngLat and zoom to ensure that
+	     * 1) everything beyond the bounds is excluded
+	     * 2) a given lngLat is as near the center as possible
+	     * Bounds are those set by maxBounds or North & South "Poles" and, if only 1 globe is displayed, antimeridian.
+	     */
+	    getConstrained(lngLat, zoom) {
+	        zoom = performance$1.clamp(+zoom, this.minZoom, this.maxZoom);
+	        const result = {
+	            center: new performance$1.LngLat(lngLat.lng, lngLat.lat),
+	            zoom
+	        };
+	        let lngRange = this.lngRange;
+	        if (!this._renderWorldCopies && lngRange === null) {
+	            const almost180 = 180 - 1e-10;
+	            lngRange = [-almost180, almost180];
+	        }
+	        const worldSize = this.tileSize * this.zoomScale(result.zoom); // A world size for the requested zoom level, not the current world size
+	        let minY = 0;
+	        let maxY = worldSize;
+	        let minX = 0;
+	        let maxX = worldSize;
+	        let scaleY = 0;
+	        let scaleX = 0;
+	        const { x: screenWidth, y: screenHeight } = this.size;
 	        if (this.latRange) {
 	            const latRange = this.latRange;
-	            minY = performance$1.mercatorYfromLat(latRange[1]) * this.worldSize;
-	            maxY = performance$1.mercatorYfromLat(latRange[0]) * this.worldSize;
-	            sy = maxY - minY < size.y ? size.y / (maxY - minY) : 0;
-	        }
-	        if (this.lngRange) {
-	            const lngRange = this.lngRange;
-	            minX = performance$1.wrap(performance$1.mercatorXfromLng(lngRange[0]) * this.worldSize, 0, this.worldSize);
-	            maxX = performance$1.wrap(performance$1.mercatorXfromLng(lngRange[1]) * this.worldSize, 0, this.worldSize);
+	            minY = performance$1.mercatorYfromLat(latRange[1]) * worldSize;
+	            maxY = performance$1.mercatorYfromLat(latRange[0]) * worldSize;
+	            const shouldZoomIn = maxY - minY < screenHeight;
+	            if (shouldZoomIn)
+	                scaleY = screenHeight / (maxY - minY);
+	        }
+	        if (lngRange) {
+	            minX = performance$1.wrap(performance$1.mercatorXfromLng(lngRange[0]) * worldSize, 0, worldSize);
+	            maxX = performance$1.wrap(performance$1.mercatorXfromLng(lngRange[1]) * worldSize, 0, worldSize);
 	            if (maxX < minX)
-	                maxX += this.worldSize;
-	            sx = maxX - minX < size.x ? size.x / (maxX - minX) : 0;
-	        }
-	        const point = this.point;
-	        // how much the map should scale to fit the screen into given latitude/longitude ranges
-	        const s = Math.max(sx || 0, sy || 0);
-	        if (s) {
-	            this.center = this.unproject(new performance$1.Point(sx ? (maxX + minX) / 2 : point.x, sy ? (maxY + minY) / 2 : point.y));
-	            this.zoom += this.scaleZoom(s);
-	            this._unmodified = unmodified;
-	            this._constraining = false;
-	            return;
+	                maxX += worldSize;
+	            const shouldZoomIn = maxX - minX < screenWidth;
+	            if (shouldZoomIn)
+	                scaleX = screenWidth / (maxX - minX);
+	        }
+	        const { x: originalX, y: originalY } = this.project.call({ worldSize }, lngLat);
+	        let modifiedX, modifiedY;
+	        const scale = Math.max(scaleX || 0, scaleY || 0);
+	        if (scale) {
+	            // zoom in to exclude all beyond the given lng/lat ranges
+	            const newPoint = new performance$1.Point(scaleX ? (maxX + minX) / 2 : originalX, scaleY ? (maxY + minY) / 2 : originalY);
+	            result.center = this.unproject.call({ worldSize }, newPoint).wrap();
+	            result.zoom += this.scaleZoom(scale);
+	            return result;
 	        }
 	        if (this.latRange) {
-	            const y = point.y, h2 = size.y / 2;
-	            if (y - h2 < minY)
-	                y2 = minY + h2;
-	            if (y + h2 > maxY)
-	                y2 = maxY - h2;
+	            const h2 = screenHeight / 2;
+	            if (originalY - h2 < minY)
+	                modifiedY = minY + h2;
+	            if (originalY + h2 > maxY)
+	                modifiedY = maxY - h2;
 	        }
-	        if (this.lngRange) {
+	        if (lngRange) {
 	            const centerX = (minX + maxX) / 2;
-	            const x = performance$1.wrap(point.x, centerX - this.worldSize / 2, centerX + this.worldSize / 2);
-	            const w2 = size.x / 2;
-	            if (x - w2 < minX)
-	                x2 = minX + w2;
-	            if (x + w2 > maxX)
-	                x2 = maxX - w2;
+	            let wrappedX = originalX;
+	            if (this._renderWorldCopies) {
+	                wrappedX = performance$1.wrap(originalX, centerX - worldSize / 2, centerX + worldSize / 2);
+	            }
+	            const w2 = screenWidth / 2;
+	            if (wrappedX - w2 < minX)
+	                modifiedX = minX + w2;
+	            if (wrappedX + w2 > maxX)
+	                modifiedX = maxX - w2;
 	        }
 	        // pan the map if the screen goes off the range
-	        if (x2 !== undefined || y2 !== undefined) {
-	            this.center = this.unproject(new performance$1.Point(x2 !== undefined ? x2 : point.x, y2 !== undefined ? y2 : point.y)).wrap();
+	        if (modifiedX !== undefined || modifiedY !== undefined) {
+	            const newPoint = new performance$1.Point(modifiedX !== null && modifiedX !== void 0 ? modifiedX : originalX, modifiedY !== null && modifiedY !== void 0 ? modifiedY : originalY);
+	            result.center = this.unproject.call({ worldSize }, newPoint).wrap();
 	        }
+	        return result;
+	    }
+	    _constrain() {
+	        if (!this.center || !this.width || !this.height || this._constraining)
+	            return;
+	        this._constraining = true;
+	        const unmodified = this._unmodified;
+	        const { center, zoom } = this.getConstrained(this.center, this.zoom);
+	        this.center = center;
+	        this.zoom = zoom;
 	        this._unmodified = unmodified;
 	        this._constraining = false;
 	    }
@@ -44693,6 +44817,7 @@ uniform ${precision} ${type} u_${name};
 	     * @see [Navigate the map with game-like controls](https://maplibre.org/maplibre-gl-js/docs/examples/game-controls/)
 	     */
 	    easeTo(options, eventData) {
+	        var _a;
 	        this._stop(false, options.easeId);
 	        options = performance$1.extend({
 	            offset: [0, 0],
@@ -44701,11 +44826,11 @@ uniform ${precision} ${type} u_${name};
 	        }, options);
 	        if (options.animate === false || (!options.essential && browser.prefersReducedMotion))
 	            options.duration = 0;
-	        const tr = this._getTransformForUpdate(), startZoom = this.getZoom(), startBearing = this.getBearing(), startPitch = this.getPitch(), startPadding = this.getPadding(), zoom = 'zoom' in options ? +options.zoom : startZoom, bearing = 'bearing' in options ? this._normalizeBearing(options.bearing, startBearing) : startBearing, pitch = 'pitch' in options ? +options.pitch : startPitch, padding = 'padding' in options ? options.padding : tr.padding;
+	        const tr = this._getTransformForUpdate(), startZoom = this.getZoom(), startBearing = this.getBearing(), startPitch = this.getPitch(), startPadding = this.getPadding(), bearing = 'bearing' in options ? this._normalizeBearing(options.bearing, startBearing) : startBearing, pitch = 'pitch' in options ? +options.pitch : startPitch, padding = 'padding' in options ? options.padding : tr.padding;
 	        const offsetAsPoint = performance$1.Point.convert(options.offset);
 	        let pointAtOffset = tr.centerPoint.add(offsetAsPoint);
 	        const locationAtOffset = tr.pointLocation(pointAtOffset);
-	        const center = performance$1.LngLat.convert(options.center || locationAtOffset);
+	        const { center, zoom } = tr.getConstrained(performance$1.LngLat.convert(options.center || locationAtOffset), (_a = options.zoom) !== null && _a !== void 0 ? _a : startZoom);
 	        this._normalizeCenter(center);
 	        const from = tr.project(locationAtOffset);
 	        const delta = tr.project(center).sub(from);
@@ -44921,6 +45046,7 @@ uniform ${precision} ${type} u_${name};
 	     * @see [Fly to a location based on scroll position](https://maplibre.org/maplibre-gl-js/docs/examples/scroll-fly-to/)
 	     */
 	    flyTo(options, eventData) {
+	        var _a;
 	        // Fall through to jumpTo if user has set prefers-reduced-motion
 	        if (!options.essential && browser.prefersReducedMotion) {
 	            const coercedOptions = performance$1.pick(options, ['center', 'zoom', 'bearing', 'pitch', 'around']);
@@ -44941,16 +45067,15 @@ uniform ${precision} ${type} u_${name};
 	            easing: performance$1.defaultEasing
 	        }, options);
 	        const tr = this._getTransformForUpdate(), startZoom = this.getZoom(), startBearing = this.getBearing(), startPitch = this.getPitch(), startPadding = this.getPadding();
-	        const zoom = 'zoom' in options ? performance$1.clamp(+options.zoom, tr.minZoom, tr.maxZoom) : startZoom;
 	        const bearing = 'bearing' in options ? this._normalizeBearing(options.bearing, startBearing) : startBearing;
 	        const pitch = 'pitch' in options ? +options.pitch : startPitch;
 	        const padding = 'padding' in options ? options.padding : tr.padding;
-	        const scale = tr.zoomScale(zoom - startZoom);
 	        const offsetAsPoint = performance$1.Point.convert(options.offset);
 	        let pointAtOffset = tr.centerPoint.add(offsetAsPoint);
 	        const locationAtOffset = tr.pointLocation(pointAtOffset);
-	        const center = performance$1.LngLat.convert(options.center || locationAtOffset);
+	        const { center, zoom } = tr.getConstrained(performance$1.LngLat.convert(options.center || locationAtOffset), (_a = options.zoom) !== null && _a !== void 0 ? _a : startZoom);
 	        this._normalizeCenter(center);
+	        const scale = tr.zoomScale(zoom - startZoom);
 	        const from = tr.project(locationAtOffset);
 	        const delta = tr.project(center).sub(from);
 	        let rho = options.curve;
@@ -45120,21 +45245,19 @@ uniform ${precision} ${type} u_${name};
 	                delta < -180 ? 360 : 0;
 	    }
 	    /**
-	     * Query the current elevation of location. Returns `null` if terrain is not enabled. Elevation is in meters relative to mean sea-level.
+	     * Get the elevation difference between a given point
+	     * and a point that is currently in the middle of the screen.
+	     * This method should be used for proper positioning of custom 3d objects, as explained [here](https://maplibre.org/maplibre-gl-js/docs/examples/add-3d-model-with-terrain/)
+	     * Returns null if terrain is not enabled.
+	     * This method is subject to change in Maplibre GL JS v5.
 	     * @param lngLatLike - [x,y] or LngLat coordinates of the location
-	     * @returns elevation in meters
+	     * @returns elevation offset in meters
 	     */
 	    queryTerrainElevation(lngLatLike) {
 	        if (!this.terrain) {
 	            return null;
 	        }
 	        const elevation = this.terrain.getElevationForLngLatZoom(performance$1.LngLat.convert(lngLatLike), this.transform.tileZoom);
-	        /**
-	         * 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.
-	         */
 	        return elevation - this.transform.elevation;
 	    }
 	}
@@ -45781,11 +45904,16 @@ uniform ${precision} ${type} u_${name};
 	     * @returns mercator coordinate for a screen pixel
 	     */
 	    pointCoordinate(p) {
+	        // First, ensure the coords framebuffer is up to date.
+	        this.painter.maybeDrawDepthAndCoords(true);
 	        const rgba = new Uint8Array(4);
 	        const context = this.painter.context, gl = context.gl;
+	        const px = Math.round(p.x * this.painter.pixelRatio / devicePixelRatio);
+	        const py = Math.round(p.y * this.painter.pixelRatio / devicePixelRatio);
+	        const fbHeight = Math.round(this.painter.height / devicePixelRatio);
 	        // grab coordinate pixel from coordinates framebuffer
 	        context.bindFramebuffer.set(this.getFramebuffer('coords').framebuffer);
-	        gl.readPixels(p.x, this.painter.height / devicePixelRatio - p.y - 1, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, rgba);
+	        gl.readPixels(px, fbHeight - py - 1, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, rgba);
 	        context.bindFramebuffer.set(null);
 	        // decode coordinates (encoding see getCoordsTexture)
 	        const x = rgba[0] + ((rgba[2] >> 4) << 8);
@@ -47204,7 +47332,7 @@ uniform ${precision} ${type} u_${name};
 	    _diffStyle(style, options) {
 	        if (typeof style === 'string') {
 	            const url = style;
-	            const request = this._requestManager.transformRequest(url, ResourceType.Style);
+	            const request = this._requestManager.transformRequest(url, "Style" /* ResourceType.Style */);
 	            performance$1.getJSON(request, new AbortController()).then((response) => {
 	                this._updateDiff(response.data, options);
 	            }).catch((error) => {
@@ -47648,7 +47776,7 @@ uniform ${precision} ${type} u_${name};
 	     * @see [Add an icon to the map](https://maplibre.org/maplibre-gl-js/docs/examples/add-image/)
 	     */
 	    loadImage(url) {
-	        return ImageRequest.getImage(this._requestManager.transformRequest(url, ResourceType.Image), new AbortController());
+	        return ImageRequest.getImage(this._requestManager.transformRequest(url, "Image" /* ResourceType.Image */), new AbortController());
 	    }
 	    /**
 	     * Returns an Array of strings containing the IDs of all images currently available in the map.
@@ -48875,8 +49003,8 @@ uniform ${precision} ${type} u_${name};
 	}
 
 	let supportsGeolocation;
-	function checkGeolocationSupport(forceRecalculation = false) {
-	    return performance$1.__awaiter(this, void 0, void 0, function* () {
+	function checkGeolocationSupport() {
+	    return performance$1.__awaiter(this, arguments, void 0, function* (forceRecalculation = false) {
 	        if (supportsGeolocation !== undefined && !forceRecalculation) {
 	            return supportsGeolocation;
 	        }
@@ -49026,6 +49154,7 @@ uniform ${precision} ${type} u_${name};
 	            }
 	        };
 	        this._update = (e) => {
+	            var _a;
 	            if (!this._map)
 	                return;
 	            const isFullyLoaded = this._map.loaded() && !this._map.isMoving();
@@ -49035,6 +49164,9 @@ uniform ${precision} ${type} u_${name};
 	            if (this._map.transform.renderWorldCopies) {
 	                this._lngLat = smartWrap(this._lngLat, this._flatPos, this._map.transform);
 	            }
+	            else {
+	                this._lngLat = (_a = this._lngLat) === null || _a === void 0 ? void 0 : _a.wrap();
+	            }
 	            this._flatPos = this._pos = this._map.project(this._lngLat)._add(this._offset);
 	            if (this._map.terrain) {
 	                // flat position is saved because smartWrap needs non-elevated points
@@ -49423,6 +49555,8 @@ uniform ${precision} ${type} u_${name};
 	     */
 	    togglePopup() {
 	        const popup = this._popup;
+	        if (this._element.style.opacity === this._opacityWhenCovered)
+	            return this;
 	        if (!popup)
 	            return this;
 	        else if (popup.isOpen())
@@ -49434,7 +49568,7 @@ uniform ${precision} ${type} u_${name};
 	        return this;
 	    }
 	    _updateOpacity(force = false) {
-	        var _a;
+	        var _a, _b;
 	        const terrain = (_a = this._map) === null || _a === void 0 ? void 0 : _a.terrain;
 	        if (!terrain) {
 	            if (this._element.style.opacity !== this._opacity) {
@@ -49471,6 +49605,8 @@ uniform ${precision} ${type} u_${name};
 	        const markerDistanceCenter = map.transform.lngLatToCameraDepth(this._lngLat, elevation + elevationToCenter);
 	        // Display at full opacity if center is visible.
 	        const centerIsInvisible = markerDistanceCenter - terrainDistanceCenter > forgiveness;
+	        if (((_b = this._popup) === null || _b === void 0 ? void 0 : _b.isOpen()) && centerIsInvisible)
+	            this._popup.remove();
 	        this._element.style.opacity = centerIsInvisible ? this._opacityWhenCovered : this._opacity;
 	    }
 	    /**
@@ -50314,10 +50450,14 @@ uniform ${precision} ${type} u_${name};
 	    constructor(options = {}) {
 	        super();
 	        this._onFullscreenChange = () => {
-	            const fullscreenElement = window.document.fullscreenElement ||
+	            var _a;
+	            let fullscreenElement = window.document.fullscreenElement ||
 	                window.document.mozFullScreenElement ||
 	                window.document.webkitFullscreenElement ||
 	                window.document.msFullscreenElement;
+	            while ((_a = fullscreenElement === null || fullscreenElement === void 0 ? void 0 : fullscreenElement.shadowRoot) === null || _a === void 0 ? void 0 : _a.fullscreenElement) {
+	                fullscreenElement = fullscreenElement.shadowRoot.fullscreenElement;
+	            }
 	            if ((fullscreenElement === this._container) !== this._fullscreen) {
 	                this._handleFullscreenChange();
 	            }
@@ -50507,7 +50647,8 @@ uniform ${precision} ${type} u_${name};
 	    closeOnClick: true,
 	    focusAfterOpen: true,
 	    className: '',
-	    maxWidth: '240px'
+	    maxWidth: '240px',
+	    subpixelPositioning: false
 	};
 	const focusQuerySelector = [
 	    'a[href]',
@@ -50607,8 +50748,8 @@ uniform ${precision} ${type} u_${name};
 	                this._map.off('drag', this._onDrag);
 	                this._map._canvasContainer.classList.remove('maplibregl-track-pointer');
 	                delete this._map;
+	                this.fire(new performance$1.Event('close'));
 	            }
-	            this.fire(new performance$1.Event('close'));
 	            return this;
 	        };
 	        this._onMouseUp = (event) => {
@@ -50621,6 +50762,7 @@ uniform ${precision} ${type} u_${name};
 	            this._update(event.point);
 	        };
 	        this._update = (cursor) => {
+	            var _a;
 	            const hasPosition = this._lngLat || this._trackPointer;
 	            if (!this._map || !hasPosition || !this._content) {
 	                return;
@@ -50644,6 +50786,9 @@ uniform ${precision} ${type} u_${name};
 	            if (this._map.transform.renderWorldCopies && !this._trackPointer) {
 	                this._lngLat = smartWrap(this._lngLat, this._flatPos, this._map.transform);
 	            }
+	            else {
+	                this._lngLat = (_a = this._lngLat) === null || _a === void 0 ? void 0 : _a.wrap();
+	            }
 	            if (this._trackPointer && !cursor)
 	                return;
 	            const pos = this._flatPos = this._pos = this._trackPointer && cursor ? cursor : this._map.project(this._lngLat);
@@ -50679,7 +50824,10 @@ uniform ${precision} ${type} u_${name};
 	                    anchor = anchorComponents.join('-');
 	                }
 	            }
-	            const offsetedPos = pos.add(offset[anchor]).round();
+	            let offsetedPos = pos.add(offset[anchor]);
+	            if (!this.options.subpixelPositioning) {
+	                offsetedPos = offsetedPos.round();
+	            }
 	            DOM.setTransform(this._container, `${anchorTranslate[anchor]} translate(${offsetedPos.x}px,${offsetedPos.y}px)`);
 	            applyAnchorClass(this._container, anchor, 'popup');
 	        };
@@ -50988,6 +51136,20 @@ uniform ${precision} ${type} u_${name};
 	            return this._container.classList.toggle(className);
 	        }
 	    }
+	    /**
+	     * Set the option to allow subpixel positioning of the popup by passing a boolean
+	     *
+	     * @param value - When boolean is true, subpixel positioning is enabled for the popup.
+	     *
+	     * @example
+	     * ```ts
+	     * let popup = new Popup()
+	     * popup.setSubpixelPositioning(true);
+	     * ```
+	     */
+	    setSubpixelPositioning(value) {
+	        this.options.subpixelPositioning = value;
+	    }
 	    _createCloseButton() {
 	        if (this.options.closeButton) {
 	            this._closeButton = DOM.create('button', 'maplibregl-popup-close-button', this._content);
@@ -51069,7 +51231,9 @@ uniform ${precision} ${type} u_${name};
 	 * ```
 	 * @see [Add support for right-to-left scripts](https://maplibre.org/maplibre-gl-js/docs/examples/mapbox-gl-rtl-text/)
 	 */
-	function setRTLTextPlugin(pluginURL, lazy) { return rtlMainThreadPluginFactory().setRTLTextPlugin(pluginURL, lazy); }
+	function setRTLTextPlugin(pluginURL, lazy) {
+	    return rtlMainThreadPluginFactory().setRTLTextPlugin(pluginURL, lazy);
+	}
 	/**
 	 * Gets the map's [RTL text plugin](https://www.mapbox.com/mapbox-gl-js/plugins/#mapbox-gl-rtl-text) status.
 	 * The status can be `unavailable` (i.e. not requested or removed), `loading`, `loaded` or `error`.
@@ -51080,7 +51244,9 @@ uniform ${precision} ${type} u_${name};
 	 * const pluginStatus = getRTLTextPluginStatus();
 	 * ```
 	 */
-	function getRTLTextPluginStatus() { return rtlMainThreadPluginFactory().getRTLTextPluginStatus(); }
+	function getRTLTextPluginStatus() {
+	    return rtlMainThreadPluginFactory().getRTLTextPluginStatus();
+	}
 	/**
 	 * Returns the package version of the library
 	 * @returns Package version of the library
@@ -51170,7 +51336,7 @@ uniform ${precision} ${type} u_${name};
 	 * importScriptInWorkers('add-protocol-worker.js');
 	 * ```
 	 */
-	function importScriptInWorkers(workerUrl) { return getGlobalDispatcher().broadcast('importScript', workerUrl); }
+	function importScriptInWorkers(workerUrl) { return getGlobalDispatcher().broadcast("IS" /* MessageType.importScript */, workerUrl); }
 
 	exports.AJAXError = performance$1.AJAXError;
 	exports.Evented = performance$1.Evented;
@@ -52045,7 +52211,7 @@ var UserAgent = /** @class */ (function () {
     return UserAgent;
 }());
 
-var version$3 = "3.2.0";
+var version$3 = "3.2.1";
 
 /**
  * A helper class that provides methods for getting various forms of the map controls current version.
@@ -53479,6 +53645,7 @@ var CompassControl = /** @class */ (function (_super) {
         var grid = document.createElement("div");
         grid.classList.add("sub-container");
         grid.classList.add("hidden-accessible-element");
+        grid.setAttribute("aria-hidden", "true");
         var rotationRightButton = this.constructRightRotationButton(map);
         var rotationLeftButton = this.constructLeftRotationButton(map);
         var tooltipLeft = buildAccessibleTooltip("Rotate Left");
@@ -53774,6 +53941,7 @@ var PitchControl = /** @class */ (function (_super) {
         var grid = document.createElement("div");
         grid.classList.add("sub-container");
         grid.classList.add("hidden-accessible-element");
+        grid.setAttribute("aria-hidden", "true");
         this.pitchIncrementButton = this.constructPitchIncrementButton(map);
         this.pitchDecrementButton = this.constructPitchDecrementButton(map);
         var tooltipIncrement = buildAccessibleTooltip("Increase Pitch");
@@ -57414,9 +57582,9 @@ var StyleControlOptions = /** @class */ (function (_super) {
     function StyleControlOptions() {
         var _this = _super !== null && _super.apply(this, arguments) || this;
         /**
-         * The layout to display the styles in.
-         * <p>`"icons"`: A row of clickable icons for each style.</p>
-         * <p>`"list"`: A scrollable list with the icons and names for each style.</p>
+         * The layout to display the styles in.<br />
+         * `"icons"`: A row of clickable icons for each style.<br />
+         * `"list"`: A scrollable list with the icons and names for each style.<br />
          * Default `"icons"`
          * @default "icons"
          */
@@ -57821,6 +57989,7 @@ var StyleControl = /** @class */ (function (_super) {
         }
         styleOpsGrid.setAttribute("aria-label", "Style Options");
         styleOpsGrid.classList.add("hidden-accessible-element");
+        styleOpsGrid.setAttribute("aria-hidden", "true");
         // Once the map's style definition is initialized create a map between style names and icons.
         // If a style is one of those to be shown by the style picker also create it's element.
         this.map.styles.definitions().then(function (definitions) { return __awaiter$7(_this, void 0, void 0, function () {
@@ -57913,13 +58082,13 @@ var TrafficOptions = /** @class */ (function (_super) {
     function TrafficOptions() {
         var _this = _super !== null && _super.apply(this, arguments) || this;
         /**
-         * The type of traffic flow to display:
-         * <p>"none" is to display no traffic flow data</p>
-         * <p>"relative" is the speed of the road relative to free-flow</p>
-         * <p>@deprecated "absolute" is the absolute speed of the road</p>
-         * <p>@deprecated "relative-delay" displays relative speed only where they differ from free-flow;
-         * false to stop displaying the traffic flow.</p>
-         * default `"none"``
+         * The type of traffic flow to display:<br />
+         * `"none"` is to display no traffic flow data<br />
+         * `"relative"` is the speed of the road relative to free-flow<br />
+         * @deprecated `"absolute"` is the absolute speed of the road<br />
+         * @deprecated `"relative-delay"` displays relative speed only where they differ from free-flow;
+         * false to stop displaying the traffic flow.<br />
+         * default `"none"`
          * @default "none"
          */
         _this.flow = "none";
@@ -64293,9 +64462,9 @@ var ElevationTileSourceOptions = /** @class */ (function (_super) {
     function ElevationTileSourceOptions() {
         var _this = _super !== null && _super.apply(this, arguments) || this;
         /**
-         * DEM tiles encoding format. Supported: `mapbox` or `terrarium`.
-         * <p>`"terrarium": Terrarium format PNG tiles. See https://aws.amazon.com/es/public-datasets/terrain/ for more info.</p>
-         * <p>`"mapbox": Mapbox Terrain RGB tiles. See https://www.mapbox.com/help/access-elevation-data/#mapbox-terrain-rgb for more info.</p>
+         * DEM tiles encoding format. Supported: `mapbox` or `terrarium`.<br />
+         * `"terrarium": Terrarium format PNG tiles. See https://aws.amazon.com/es/public-datasets/terrain/ for more info.<br />
+         * `"mapbox": Mapbox Terrain RGB tiles. See https://www.mapbox.com/help/access-elevation-data/#mapbox-terrain-rgb for more info.<br />
          * default `mapbox`
          * @default mapbox
          */
@@ -64641,9 +64810,9 @@ var BubbleLayerOptions = /** @class */ (function (_super) {
          */
         _this.strokeWidth = 2;
         /**
-         * Specifies the orientation of circle when map is pitched.
-         * <p>`"map"`: The circle is aligned to the plane of the map.</p>
-         * <p>`"viewport"`: The circle is aligned to the plane of the viewport.</p>
+         * Specifies the orientation of circle when map is pitched.<br />
+         * `"map"`: The circle is aligned to the plane of the map.<br />
+         * `"viewport"`: The circle is aligned to the plane of the viewport.<br />
          * Default: `"viewport"`
          * @default "viewport"
          */
@@ -65681,24 +65850,24 @@ var LineLayerOptions = /** @class */ (function (_super) {
          */
         _this.sourceLayer = undefined;
         /**
-         * Specifies how the ends of the lines are rendered.
-         * <p>`"butt"`: A cap with a squared-off end which is drawn to the exact endpoint of the line.</p>
-         * <p>`"round"`: A cap with a rounded end which is drawn beyond the endpoint of the line
-         * at a radius of one-half of the lines width and centered on the endpoint of the line.</p>
-         * <p>`"square"`: A cap with a squared-off end which is drawn beyond the endpoint of the line
-         * at a distance of one-half of the line width.</p>
+         * Specifies how the ends of the lines are rendered.<br />
+         * `"butt"`: A cap with a squared-off end which is drawn to the exact endpoint of the line.<br />
+         * `"round"`: A cap with a rounded end which is drawn beyond the endpoint of the line
+         * at a radius of one-half of the lines width and centered on the endpoint of the line.<br />
+         * `"square"`: A cap with a squared-off end which is drawn beyond the endpoint of the line
+         * at a distance of one-half of the line width.<br />
          * Default `"round"`.
          * @default "round"
          */
         _this.lineCap = "round";
         /**
-         * Specifies how the joints in the lines are rendered.
-         * <p>`"bevel"`: A join with a squared-off end which is drawn beyond the endpoint of the line
-         * at a distance of one-half of the lines width.</p>
-         * <p>`"round"`: A join with a rounded end which is drawn beyond the endpoint of the line
-         * at a radius of one-half of the lines width and centered on the endpoint of the line.</p>
-         * <p>`"miter"`: A join with a sharp, angled corner which is drawn with the outer sides
-         * beyond the endpoint of the path until they meet.</p>
+         * Specifies how the joints in the lines are rendered.<br />
+         * `"bevel"`: A join with a squared-off end which is drawn beyond the endpoint of the line
+         * at a distance of one-half of the lines width.<br />
+         * `"round"`: A join with a rounded end which is drawn beyond the endpoint of the line
+         * at a radius of one-half of the lines width and centered on the endpoint of the line.<br />
+         * `"miter"`: A join with a sharp, angled corner which is drawn with the outer sides
+         * beyond the endpoint of the path until they meet.<br />
          * Default `"round"`.
          * @default "round"
          */
@@ -65749,9 +65918,9 @@ var LineLayerOptions = /** @class */ (function (_super) {
          */
         _this.translate = new Pixel(0, 0);
         /**
-         * Specifies the frame of reference for `translate`.
-         * <p>`"map"`: Lines are translated relative to the map.</p>
-         * <p>`"viewport"`: Lines are translated relative to the viewport</p>
+         * Specifies the frame of reference for `translate`.<br />
+         * `"map"`: Lines are translated relative to the map.<br />
+         * `"viewport"`: Lines are translated relative to the viewport<br />
          * Default: `"map"`
          * @default "map"
          */
@@ -65963,9 +66132,9 @@ var PolygonExtrusionLayerOptions = /** @class */ (function (_super) {
          */
         _this.translate = new Pixel(0, 0);
         /**
-         * Specifies the frame of reference for `translate`.
-         * <p>`"map"`: Polygons are translated relative to the map.</p>
-         * <p>`"viewport"`: Polygons are translated relative to the viewport.</p>
+         * Specifies the frame of reference for `translate`.<br />
+         * `"map"`: Polygons are translated relative to the map.<br />
+         * `"viewport"`: Polygons are translated relative to the viewport.<br />
          * Default: `"map"`
          * @default "map"
          */
@@ -66318,16 +66487,16 @@ var IconOptions = /** @class */ (function (_super) {
          */
         _this.allowOverlap = false;
         /**
-         * Specifies which part of the icon is placed closest to the icons anchor position on the map.
-         * <p>`"center"`: The center of the icon is placed closest to the anchor.</p>
-         * <p>`"left"`: The left side of the icon is placed closest to the anchor.</p>
-         * <p>`"right"`: The right side of the icon is placed closest to the anchor.</p>
-         * <p>`"top"`: The top of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom"`: The bottom of the icon is placed closest to the anchor.</p>
-         * <p>`"top-left"`: The top left corner of the icon is placed closest to the anchor.</p>
-         * <p>`"top-right"`: The top right corner of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom-left"`: The bottom left corner of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom-right"`: The bottom right corner of the icon is placed closest to the anchor.</p>
+         * Specifies which part of the icon is placed closest to the icons anchor position on the map.<br />
+         * `"center"`: The center of the icon is placed closest to the anchor.<br />
+         * `"left"`: The left side of the icon is placed closest to the anchor.<br />
+         * `"right"`: The right side of the icon is placed closest to the anchor.<br />
+         * `"top"`: The top of the icon is placed closest to the anchor.<br />
+         * `"bottom"`: The bottom of the icon is placed closest to the anchor.<br />
+         * `"top-left"`: The top left corner of the icon is placed closest to the anchor.<br />
+         * `"top-right"`: The top right corner of the icon is placed closest to the anchor.<br />
+         * `"bottom-left"`: The bottom left corner of the icon is placed closest to the anchor.<br />
+         * `"bottom-right"`: The bottom right corner of the icon is placed closest to the anchor.<br />
          * Default `"bottom"`.
          * @default "bottom"
          */
@@ -66372,10 +66541,10 @@ var IconOptions = /** @class */ (function (_super) {
          */
         _this.padding = 2;
         /**
-         * Specifies the orientation of the icon when the map is pitched.
-         * <p>`"auto"`: Automatically matches the value of `rotationAlignment`.</p>
-         * <p>`"map"`: The icon is aligned to the plane of the map.</p>
-         * <p>`"viewport"`: The icon is aligned to the plane of the viewport</p>
+         * Specifies the orientation of the icon when the map is pitched.<br />
+         * `"auto"`: Automatically matches the value of `rotationAlignment`.<br />
+         * `"map"`: The icon is aligned to the plane of the map.<br />
+         * `"viewport"`: The icon is aligned to the plane of the viewport<br />
          * Default `"auto"`
          * @default "auto"
          */
@@ -66388,12 +66557,12 @@ var IconOptions = /** @class */ (function (_super) {
         _this.rotation = 0;
         /**
          * In combination with the placement property of a SymbolLayerOptions
-         * this determines the rotation behavior of icons.
-         * <p>`"auto"`: When placement is "point" this is equivalent to "viewport".
-         * When placement is "line" this is equivalent to "map".</p>
-         * <p>`"map"`: When placement is "point" aligns icons east-west.
-         * When placement is "line" aligns the icons' x-axes with the line.</p>
-         * <p>`"viewport"`: Icons' x-axes will align with the x-axis of the viewport.</p>
+         * this determines the rotation behavior of icons.<br />
+         * `"auto"`: When placement is "point" this is equivalent to "viewport".
+         * When placement is "line" this is equivalent to "map".<br />
+         * `"map"`: When placement is "point" aligns icons east-west.
+         * When placement is "line" aligns the icons' x-axes with the line.<br />
+         * `"viewport"`: Icons' x-axes will align with the x-axis of the viewport.<br />
          * Default `"auto"`.
          * @default "auto"
          */
@@ -66446,16 +66615,16 @@ var TextOptions = /** @class */ (function (_super) {
          */
         _this.allowOverlap = false;
         /**
-         * Specifies which part of the icon is placed closest to the icons anchor position on the map.
-         * <p>`"center"`: The center of the icon is placed closest to the anchor.</p>
-         * <p>`"left"`: The left side of the icon is placed closest to the anchor.</p>
-         * <p>`"right"`: The right side of the icon is placed closest to the anchor.</p>
-         * <p>`"top"`: The top of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom"`: The bottom of the icon is placed closest to the anchor.</p>
-         * <p>`"top-left"`: The top left corner of the icon is placed closest to the anchor.</p>
-         * <p>`"top-right"`: The top right corner of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom-left"`: The bottom left corner of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom-right"`: The bottom right corner of the icon is placed closest to the anchor.</p>
+         * Specifies which part of the icon is placed closest to the icons anchor position on the map.<br />
+         * `"center"`: The center of the icon is placed closest to the anchor.<br />
+         * `"left"`: The left side of the icon is placed closest to the anchor.<br />
+         * `"right"`: The right side of the icon is placed closest to the anchor.<br />
+         * `"top"`: The top of the icon is placed closest to the anchor.<br />
+         * `"bottom"`: The bottom of the icon is placed closest to the anchor.<br />
+         * `"top-left"`: The top left corner of the icon is placed closest to the anchor.<br />
+         * `"top-right"`: The top right corner of the icon is placed closest to the anchor.<br />
+         * `"bottom-left"`: The bottom left corner of the icon is placed closest to the anchor.<br />
+         * `"bottom-right"`: The bottom right corner of the icon is placed closest to the anchor.<br />
          * Default `"center"`.
          * @default "center"
          */
@@ -66485,11 +66654,11 @@ var TextOptions = /** @class */ (function (_super) {
          */
         _this.ignorePlacement = false;
         /**
-         * Text justification options.
-         * <p>`"auto"`: The text is aligned towards the anchor position.
-         * <p>`"left"`: The text is aligned to the left.
-         * <p>`"center"`: The text is centered.
-         * <p>`"right"`: The text is aligned to the right.
+         * Text justification options.<br />
+         * `"auto"`: The text is aligned towards the anchor position.<br />
+         * `"left"`: The text is aligned to the left.<br />
+         * `"center"`: The text is centered.<br />
+         * `"right"`: The text is aligned to the right.<br />
          * Default `"center"`.
          * @default "center"
          */
@@ -66517,10 +66686,10 @@ var TextOptions = /** @class */ (function (_super) {
          */
         _this.padding = 2;
         /**
-         * Specifies the orientation of the text when the map is pitched.
-         * <p>`"auto"`: Automatically matches the value of `rotationAlignment`.</p>
-         * <p>`"map"`: The text is aligned to the plane of the map.</p>
-         * <p>`"viewport"`: The text is aligned to the plane of the viewport.</p>
+         * Specifies the orientation of the text when the map is pitched.<br />
+         * `"auto"`: Automatically matches the value of `rotationAlignment`.<br />
+         * `"map"`: The text is aligned to the plane of the map.<br />
+         * `"viewport"`: The text is aligned to the plane of the viewport.<br />
          * Default: `"auto"`
          * @default "auto"
          */
@@ -66540,13 +66709,13 @@ var TextOptions = /** @class */ (function (_super) {
         _this.rotation = 0;
         /**
          * In combination with the `placement` property of the `SymbolLayerOptions`,
-         * specifies the rotation behavior of the individual glyphs forming the text.
-         * <p>`"auto"`: When the `placement` is set to `"point"`, this is equivalent to `"map"`.
-         * When the `placement` is set to `"line"` this is equivalent to `"map"`.</p>
-         * <p>`"map"`: When the `placement` is set to `"point"`, aligns text east-west.
-         * When the `placement` is set to `"line"`, aligns text x-axes with the line.</p>
-         * <p>`"viewport"`: Produces glyphs whose x-axes are aligned with the x-axis of the viewport,
-         * regardless of the value of `placement`.</p>
+         * specifies the rotation behavior of the individual glyphs forming the text.<br />
+         * `"auto"`: When the `placement` is set to `"point"`, this is equivalent to `"map"`.
+         * When the `placement` is set to `"line"` this is equivalent to `"map"`.<br />
+         * `"map"`: When the `placement` is set to `"point"`, aligns text east-west.
+         * When the `placement` is set to `"line"`, aligns text x-axes with the line.<br />
+         * `"viewport"`: Produces glyphs whose x-axes are aligned with the x-axis of the viewport,
+         * regardless of the value of `placement`.<br />
          * Default: `"auto"`
          * @default "auto"
          */
@@ -66556,16 +66725,16 @@ var TextOptions = /** @class */ (function (_super) {
          * labels on the map. The renderer will attempt to place the label at each location,
          * in order, before moving onto the next label. Use `justify: "auto"` to choose text
          * justification based on anchor position. To apply an offset use the `radialOffset` or
-         * two-dimensional `offset` options.
-         * <p>`"center"`: The center of the icon is placed closest to the anchor.</p>
-         * <p>`"left"`: The left side of the icon is placed closest to the anchor.</p>
-         * <p>`"right"`: The right side of the icon is placed closest to the anchor.</p>
-         * <p>`"top"`: The top of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom"`: The bottom of the icon is placed closest to the anchor.</p>
-         * <p>`"top-left"`: The top left corner of the icon is placed closest to the anchor.</p>
-         * <p>`"top-right"`: The top right corner of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom-left"`: The bottom left corner of the icon is placed closest to the anchor.</p>
-         * <p>`"bottom-right"`: The bottom right corner of the icon is placed closest to the anchor.</p>
+         * two-dimensional `offset` options.<br />
+         * `"center"`: The center of the icon is placed closest to the anchor.<br />
+         * `"left"`: The left side of the icon is placed closest to the anchor.<br />
+         * `"right"`: The right side of the icon is placed closest to the anchor.<br />
+         * `"top"`: The top of the icon is placed closest to the anchor.<br />
+         * `"bottom"`: The bottom of the icon is placed closest to the anchor.<br />
+         * `"top-left"`: The top left corner of the icon is placed closest to the anchor.<br />
+         * `"top-right"`: The top right corner of the icon is placed closest to the anchor.<br />
+         * `"bottom-left"`: The bottom left corner of the icon is placed closest to the anchor.<br />
+         * `"bottom-right"`: The bottom right corner of the icon is placed closest to the anchor.<br />
          * Default: `undefined`
          * @default undefined
          */
@@ -66658,12 +66827,12 @@ var SymbolLayerOptions = /** @class */ (function (_super) {
          */
         _this.textOptions = new TextOptions();
         /**
-         * Specifies the label placement relative to its geometry.
-         * <p>`"point"`: The label is placed at the point where the geometry is located.</p>
-         * <p>`"line"`: The label is placed along the line of the geometry.
-         * Can only be used on LineString and Polygon geometries.</p>
-         * <p> `"line-center"`: The label is placed at the center of the line of the geometry.
-         * Can only be used on `LineString` and `Polygon` geometries </p>
+         * Specifies the label placement relative to its geometry.<br />
+         * `"point"`: The label is placed at the point where the geometry is located.<br />
+         * `"line"`: The label is placed along the line of the geometry.
+         * Can only be used on LineString and Polygon geometries.<br />
+         *  `"line-center"`: The label is placed at the center of the line of the geometry.
+         * Can only be used on `LineString` and `Polygon` geometries <br />
          * Default `"point"`.
          * @default "point"
          */
@@ -66678,12 +66847,12 @@ var SymbolLayerOptions = /** @class */ (function (_super) {
         /**
          * Determines whether overlapping symbols in the same layer are rendered in the order
          * that they appear in the data source, or by their y position relative to the viewport.
-         * To control the order and prioritization of symbols otherwise, use `sortKey`.
-         * <p>`"auto"`: Sorts symbols by `sortKey` if set. Otherwise behaves like `"viewport-y"`.
-         * <p>`"viewport-y"`: Sorts symbols by their y position if `allowOverlap` is `true` or
-         * if `ignorePlacement` is `false`.
-         * <p>`"source"`: Sorts symbols by `sortKey` if set. Otherwise, symbols are rendered in the
-         * same order as the source data.
+         * To control the order and prioritization of symbols otherwise, use `sortKey`.<br />
+         * `"auto"`: Sorts symbols by `sortKey` if set. Otherwise behaves like `"viewport-y"`.<br />
+         * `"viewport-y"`: Sorts symbols by their y position if `allowOverlap` is `true` or
+         * if `ignorePlacement` is `false`.<br />
+         * `"source"`: Sorts symbols by `sortKey` if set. Otherwise, symbols are rendered in the
+         * same order as the source data.<br />
          * Default `"auto"`
          * @default "auto"
          */
@@ -114728,14 +114897,14 @@ var LayerManager = /** @class */ (function () {
     /**
         * Retrieve all Shapes and GeoJSON features that are visible on the map that are in a DataSource or VectorTileSource.
         * Shape objects are editable, while Feature objects are not editable and either reside in a VectorTileSource or represent a cluster point.
-        * Clusters have the following properties:
-        * <p>cluster: `boolean` - Indicates that the point is a cluster.
+        * Clusters have the following properties:<br />
+        * `cluster`: `boolean` - Indicates that the point is a cluster.
         * This will be set to true if Point object represents a cluster.
         * All other point objects are unlikely to have this value unless
-        * a property with this same name was added to the Point property data from your app.</p>
-        * <p>cluster_id: `string` - A unique id for the cluster.</p>
-        * <p>point_count: `number` - The number of points inside the cluster.</p>
-        * <p>point_count_abbreviated: `string` - An abbreviated string version of the point count. i.e. `"10K"`</p>
+        * a property with this same name was added to the Point property data from your app.<br />
+        * `cluster_id`: `string` - A unique id for the cluster.<br />
+        * `point_count`: `number` - The number of points inside the cluster.<br />
+        * `point_count_abbreviated`: `string` - An abbreviated string version of the point count. i.e. `"10K"`<br />
         * Features/Shapes that are not visible or who's layer zoom range does not include the current zoom level will not be returned.
         * Symbol features/Shapes that have been hidden due to text or icon collisions are not included.
         * Features/Shapes from all other layers are included even if they have no contribution to the map rendering, e.g. alpha set to zero.
@@ -115403,10 +115572,10 @@ var AnimationOptions = /** @class */ (function (_super) {
          */
         _this.duration = 1000;
         /**
-         * The type of animation.
-         * <p>"jump" is an immediate change.</p>
-         * <p>"ease" is a gradual change of the camera's settings.</p>
-         * <p>"fly" is a gradual change of the camera's settings following an arc resembling flight.</p>
+         * The type of animation.<br />
+         * `"jump"` is an immediate change.<br />
+         * `"ease"` is a gradual change of the camera's settings.<br />
+         * `"fly"` is a gradual change of the camera's settings following an arc resembling flight.<br />
          * Default `"jump"`.
          * @default "jump"
          */
@@ -115649,6 +115818,7 @@ var CameraOptions = /** @class */ (function (_super) {
         _this.pitch = 0;
         /**
          * The minimum zoom level that the map can be zoomed out to during the animation. Must be between 0 and 24, and less than or equal to `maxZoom`.
+         * Setting `minZoom` below 1 may result in an empty map when the zoom level is less than 1.
          * Default `1`.
          * @default 1
          */
@@ -116013,15 +116183,15 @@ var LightOptions = /** @class */ (function (_super) {
         var _this = _super !== null && _super.apply(this, arguments) || this;
         /**
          * Specifies wether extruded geometries are lit relative to the map or viewport.
-         * Supported values:
-         * <p>`"map"`: The position of the light source is aligned to the rotation of the map.</p>
-         * <p>`"viewport"`: The position fo the light source is aligned to the rotation of the viewport.</p>
+         * Supported values:<br />
+         * `"map"`: The position of the light source is aligned to the rotation of the map.<br />
+         * `"viewport"`: The position fo the light source is aligned to the rotation of the viewport.<br />
          * Default: `"map"`
          * @default "map"
          */
         _this.anchor = "map";
         /**
-         * Color tint for lighting extruded geometries
+         * Color tint for lighting extruded geometries.
          * Default: `"#FFFFFF"`
          * @default "#FFFFFF"
          */
@@ -118088,6 +118258,9 @@ var Map$1 = /** @class */ (function (_super) {
                 pitch: cameraOptions.pitch,
                 around: undefined
             };
+            if (cameraOptions.minZoom < 1) {
+                console.warn("Setting minZoom below 1 may result in an empty map when the zoom level is less than 1.");
+            }
             this.map.setMinZoom(cameraOptions.minZoom);
             this.map.setMaxZoom(cameraOptions.maxZoom);
             if (cameraOptions.minPitch) {