maplibre-gl 6.11.0 → 6.11.2

package/dist/maplibre-gl-dev.mjs

@@ -1,10 +1,10 @@
 /**
 * MapLibre GL JS
-* @license 3-Clause BSD. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v6.11.0/LICENSE.txt
+* @license 3-Clause BSD. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v6.11.2/LICENSE.txt
 */
 import { $ as projectToWorldCoordinates, $n as differenceOfAnglesDegrees, $r as add, $t as Transitionable, A as evaluateSizeForZoom, Ai as rotateX, An as addProtocol, Ar as scaleZoom, At as toEvaluationFeature, B as isCluster, Bi as rotate, Bn as arrayBufferToImage, Br as EXTENT, Bt as SegmentVector, C as addDynamicAttributes, Ci as exactEquals, Cn as GLOBAL_DISPATCHER_ID, Cr as pointPlaneSignedDistance, Ct as HEATMAP_FULL_RENDER_FBO_KEY, Di as multiply, Dn as getVideo, Dr as remapSaturate, Dt as RGBAImage, E as TextAnchorEnum, Ei as invert$1, En as getReferrer, Er as readImageUsingVideoFrame, Et as AlphaImage, F as potpack, Fi as create$4, Fn as isAbortError, Fr as uniqueId, Ft as Uniform4f, Gn as createIdentityMat4f32, Gr as zero, Gt as PosArray, Hi as offscreenCanvasSupported, Hn as bezier, Hr as length$1, Ht as CollisionCircleLayoutArray, I as isStyleImageWebGLData, Ii as fromRotation, In as throwIfAborted, Ir as warnOnce, It as UniformColor, J as cameraDirectionFromPitchBearing, Jn as createVec3f64, Jr as multiply$1, Jt as TriangleIndexArray, K as isFillExtrusionStyleLayer, Kn as createIdentityMat4f64, Kr as fromEuler, Kt as QuadTriangleArray, L as renderStyleImage, Li as create$2, Lr as wrap, Lt as UniformColorArray, M as getAnchorAlignment, Mi as rotateZ, Mn as removeProtocol, Mr as subscribe, Mt as Uniform1i, Ni as scale, Nn as config, Nr as threePlaneIntersection, Nt as Uniform2f, O as clipLine, Oi as ortho, On as makeRequest, Or as rollPitchBearingEqual, Ot as isCircleStyleLayer, P as ImagePosition, Pi as translate, Pn as AbortError, Pr as translatePosition, Pt as Uniform3f, Q as maxMercatorHorizonAngle, Qn as degreesToRadians, Qr as transformMat4, Qt as Properties, R as parseGlyphPbf, Ri as determinant, Rn as MAX_VALID_LATITUDE, Rr as zoomScale, Rt as UniformFloatArray, S as SymbolBucket, Si as equals, Sn as AJAXError, Sr as pick, St as isHillshadeStyleLayer, T as getAnchorJustification, Ti as identity, Tn as getJSON, Tr as rayPlaneIntersection, Tt as renderColorRamp, U as collisionCircleLayout, Ui as Point, Un as clamp, Ur as scale$3, Ut as LineStripIndexArray, V as codePointUsesLocalIdeographFontFamily, Vi as isOffscreenCanvasDistorted, Vn as arrayBufferToImageBitmap, Vr as create$3, Vt as CollisionBoxArray, W as isLineStyleLayer, Wn as clone$2, Wr as sqrLen, Wt as Pos3dArray, X as cameraMercatorCoordinateFromCenterAndRotation, Xn as deepEqual, Xr as mul, Xt as isRasterStyleLayer, Y as cameraMercatorCoordinate, Yn as createVec4f64, Yr as slerp, Yt as createLayout, Z as getMercatorHorizon, Zn as defaultEasing, Zr as scale$2, Zt as DataConstantProperty, _ as createStyleLayer, _i as transformQuat, _n as derefLayers, _r as lerp, _t as SubdivisionGranularityExpression, a as GeoJSONFeature, ai as length, an as validateAndEmit, ar as findLineIntersection, at as lngFromMercatorX, b as isBackgroundStyleLayer, bi as copy, bn as Event, br as nextPowerOfTwo, ci as rotateX$1, cn as emptyStyle, cr as getEdgeTiles, ct as mercatorZfromAltitude, d as OverscaledTileID, di as scale$1, dr as isImageBitmap, ei as clone, en as EvaluationParameters, er as distanceOfAnglesRadians, et as tileCoordinatesToMercatorCoordinates, f as UnwrappedTileID, fi as scaleAndAdd, fn as interpolateFactory, fr as isPointableEvent, ft as EXTENT_BOUNDS, g as Actor, gi as transformMat4$1, gn as diff, gr as isWorker, gt as SOUTH_POLE_Y, h as isInBoundsForZoomLngLat, hi as transformMat3, hn as ValidationError, hr as isTouchableOrPointableType, ht as NORTH_POLE_Y, ii as len, in as emitValidationErrors, ir as filterObject, it as latFromMercatorY, ji as rotateY$1, jn as getProtocol, jr as sphericalToCartesian, jt as Uniform1f, k as evaluateSizeForFeature, ki as perspective, kn as sameOrigin, kr as rollPitchBearingToQuat, kt as polygonIntersectsPolygon, li as rotateY, lt as LngLat, m as compareTileId, mi as subtract, mn as Color, mr as isTouchableEvent, mt as isFillStyleLayer, n as TileCache, ni as distance, nr as evaluateZoomSnap, nt as MercatorCoordinate, oi as negate, on as validateStyle, or as getAABB, ot as mercatorXfromLng, p as calculateTileKey, pi as sub, pn as ProjectionDefinition, pr as isSafari, pt as Bounds, q as calculateTileMatrix, qn as createMat4f64, qr as fromValues, qt as RasterBoundsArray, ri as dot, rn as SPEC_SOURCE_TYPES, rr as extend, rt as altitudeFromMercatorZ, s as GEOJSON_TILE_LAYER_NAME, si as normalize, sn as validateStyleAndEmit, sr as getAngleDelta, st as mercatorYfromLat, ti as cross, tn as ZoomHistory, tr as ensureError, tt as unprojectFromWorldCoordinates, u as CanonicalTileID, ui as rotateZ$1, un as featureFilter, ur as getRollPitchBearing, ut as earthRadius, v as isCustomStyleLayer, vi as zero$1, vn as latest, vr as mapObject, vt as SubdivisionGranularitySetting, w as getOverlapMode, wi as fromScaling, wn as getArrayBuffer, wr as radiansToDegrees, wt as isHeatmapStyleLayer, x as isSymbolStyleLayer, xi as create$1, xn as Evented, xr as parseCacheControl, xt as Texture, y as validateCustomStyleLayer, yi as clone$1, yn as ErrorEvent, yr as mod, yt as isColorReliefStyleLayer, zi as invert, zn as angleToRotateBetweenVectors2D, zr as pixelsToTileUnits, zt as UniformMatrix4f } from "./maplibre-gl-shared-dev.mjs";
 //#region package.json
-var version$2 = "6.11.0";
+var version$2 = "6.11.2";
 //#endregion
 //#region src/util/browser.ts
 let linkEl;
@@ -198,6 +198,92 @@ function isTimeFrozen() {
 }
 //#endregion
 //#region src/util/dom.ts
+const HTML_NAMESPACE = "http://www.w3.org/1999/xhtml";
+const ALLOWED_TAGS = /* @__PURE__ */ new Set([
+	"a",
+	"abbr",
+	"b",
+	"bdi",
+	"bdo",
+	"br",
+	"cite",
+	"code",
+	"del",
+	"div",
+	"em",
+	"i",
+	"img",
+	"ins",
+	"kbd",
+	"li",
+	"mark",
+	"ol",
+	"p",
+	"q",
+	"s",
+	"samp",
+	"small",
+	"span",
+	"strong",
+	"sub",
+	"sup",
+	"time",
+	"u",
+	"ul",
+	"var",
+	"wbr"
+]);
+const ALLOWED_ATTRIBUTES = /* @__PURE__ */ new Set([
+	"alt",
+	"class",
+	"datetime",
+	"dir",
+	"height",
+	"href",
+	"hreflang",
+	"lang",
+	"referrerpolicy",
+	"rel",
+	"role",
+	"src",
+	"target",
+	"title",
+	"translate",
+	"type",
+	"width"
+]);
+const URL_ATTRIBUTES = /* @__PURE__ */ new Set(["href", "src"]);
+const ALLOWED_PROTOCOLS = /* @__PURE__ */ new Set([
+	"http:",
+	"https:",
+	"mailto:"
+]);
+/**
+* Relative URLs have to resolve against something before their protocol can be read. Only the protocol of the
+* result is used, so the base never leaks into the sanitized markup.
+*/
+const RELATIVE_URL_BASE = "https://maplibre.invalid/";
+let elementInternals;
+/**
+* The `Element` members the sanitizer uses, read off the prototype rather than off the element it is looking at.
+* A form control named `children`, `remove` or `localName` shadows the same-named property of its own form element,
+* which would otherwise let untrusted markup pick what the sanitizer walking that tree sees.
+*
+* They are read on first use rather than when this module is loaded, since the module is also imported where there
+* is no DOM at all, such as during server side rendering.
+*/
+function getElementInternals() {
+	elementInternals ??= {
+		getAttribute: Element.prototype.getAttribute,
+		getAttributeNames: Element.prototype.getAttributeNames,
+		querySelectorAll: Element.prototype.querySelectorAll,
+		remove: Element.prototype.remove,
+		removeAttribute: Element.prototype.removeAttribute,
+		localName: Object.getOwnPropertyDescriptor(Element.prototype, "localName").get,
+		namespaceURI: Object.getOwnPropertyDescriptor(Element.prototype, "namespaceURI").get
+	};
+	return elementInternals;
+}
 var DOM = class DOM {
 	static {
 		this.docStyle = typeof window !== "undefined" && window.document?.documentElement.style;
@@ -257,55 +343,54 @@ var DOM = class DOM {
 		return points;
 	}
 	/**
-	* Sanitize an HTML string - this might not be enough to prevent all XSS attacks
-	* Base on https://javascriptsource.com/sanitize-an-html-string-to-reduce-the-risk-of-xss-attacks/
-	* (c) 2021 Chris Ferdinandi, MIT License, https://gomakethings.com
+	* Sanitize an untrusted HTML string, such as the attribution a remote TileJSON asks the map to display.
 	*
-	* Returns the sanitized nodes rather than a string, since re-parsing serialized HTML can produce a different tree.
+	* Only the elements in `ALLOWED_TAGS` and the attributes in `ALLOWED_ATTRIBUTES` survive; anything else is
+	* dropped along with its subtree. An allow list is used rather than a list of known-dangerous markup because
+	* the latter silently permits whatever it has not heard of yet, including markup added to HTML after it was
+	* written.
+	*
+	* The sanitized nodes are returned rather than a string: serializing and re-parsing is not a round trip, so
+	* a string result lets carefully nested markup mutate into a different - and no longer sanitized - tree.
 	*/
 	static sanitize(str) {
-		const html = new DOMParser().parseFromString(str, "text/html").body || document.createElement("body");
-		const dangerousElements = html.querySelectorAll("script, iframe");
-		for (const element of dangerousElements) element.remove();
-		DOM.clean(html);
+		const body = new DOMParser().parseFromString(str, "text/html").body;
+		const { querySelectorAll, remove } = getElementInternals();
+		for (const element of Array.from(querySelectorAll.call(body, "*"))) if (DOM.isAllowedElement(element)) DOM.removeDisallowedAttributes(element);
+		else remove.call(element);
 		const fragment = document.createDocumentFragment();
-		fragment.append(...html.childNodes);
+		fragment.append(...body.childNodes);
 		return fragment;
 	}
 	/**
-	* Check if the attribute is potentially dangerous
+	* An element is allowed only when it is plain HTML markup on the allow list. Elements in the SVG and MathML
+	* namespaces are rejected even when their local name is allowed, since foreign content follows different
+	* parsing rules and is what makes most mutation attacks possible in the first place.
 	*/
-	static isPossiblyDangerous(name, value) {
-		const val = value.replace(/\s+/g, "").toLowerCase();
-		if ([
-			"src",
-			"href",
-			"xlink:href"
-		].includes(name)) {
-			if (val.includes("javascript:") || val.includes("data:")) return true;
-		}
-		if (name === "srcdoc") return true;
-		if (name.startsWith("on")) return true;
+	static isAllowedElement(element) {
+		const { namespaceURI, localName } = getElementInternals();
+		return namespaceURI.call(element) === HTML_NAMESPACE && ALLOWED_TAGS.has(localName.call(element));
 	}
-	/**
-	* Remove dangerous stuff from the HTML document's nodes
-	* @param html - The HTML document
-	*/
-	static clean(html) {
-		const nodes = html.children;
-		for (const node of nodes) {
-			DOM.removeAttributes(node);
-			DOM.clean(node);
+	static removeDisallowedAttributes(element) {
+		const { getAttributeNames, getAttribute, removeAttribute } = getElementInternals();
+		for (const name of getAttributeNames.call(element)) {
+			if (DOM.isAllowedAttribute(name, getAttribute.call(element, name))) continue;
+			removeAttribute.call(element, name);
 		}
 	}
 	/**
-	* Remove potentially dangerous attributes from an element
-	* @param elem - The element
+	* `href` and `src` are further restricted to the protocols in `ALLOWED_PROTOCOLS`, so that `javascript:` and
+	* `data:` URLs cannot turn an otherwise harmless link or image into a script. The protocol is taken from a
+	* parsed URL rather than matched against the raw string, since the URL parser is what the browser will apply
+	* and it ignores tabs, newlines and leading control characters that a string comparison would trip over.
 	*/
-	static removeAttributes(elem) {
-		for (const { name, value } of Array.from(elem.attributes)) {
-			if (!DOM.isPossiblyDangerous(name, value)) continue;
-			elem.removeAttribute(name);
+	static isAllowedAttribute(name, value) {
+		if (!ALLOWED_ATTRIBUTES.has(name) && !name.startsWith("aria-")) return false;
+		if (!URL_ATTRIBUTES.has(name)) return true;
+		try {
+			return ALLOWED_PROTOCOLS.has(new URL(value, RELATIVE_URL_BASE).protocol);
+		} catch {
+			return false;
 		}
 	}
 };
@@ -1534,12 +1619,13 @@ var GlyphManager = class {
 	}
 	async getGlyphs(glyphs) {
 		const glyphsPromises = [];
-		for (const stack in glyphs) for (const id of glyphs[stack]) glyphsPromises.push(this._getAndCacheGlyphsPromise(stack, id));
+		for (const stack in glyphs) for (const variant in glyphs[stack]) for (const id of glyphs[stack][variant]) glyphsPromises.push(this._getAndCacheGlyphsPromise(stack, id, variant));
 		const updatedGlyphs = await Promise.all(glyphsPromises);
 		const result = {};
-		for (const { stack, id, glyph } of updatedGlyphs) {
+		for (const { stack, id, variant, glyph } of updatedGlyphs) {
 			result[stack] ||= {};
-			result[stack][id] = glyph && {
+			result[stack][variant] ||= {};
+			result[stack][variant][id] = glyph && {
 				id: glyph.id,
 				bitmap: glyph.bitmap.clone(),
 				metrics: glyph.metrics
@@ -1555,39 +1641,56 @@ var GlyphManager = class {
 	* has no way to serve the one shape they are written as. A file the style pinned with
 	* `font-faces` draws it where one covers it, and the local fonts otherwise. For a single
 	* codepoint a declared file still wins over the glyphs URL and the local fallbacks.
+	* Providers support the `default` variant; unsupported variants return `null`.
 	*/
-	async _getAndCacheGlyphsPromise(stack, id) {
+	async _getAndCacheGlyphsPromise(stack, id, variant) {
 		this.entries[stack] ??= {
-			glyphs: {},
+			glyphs: { default: {} },
 			requests: {},
 			ranges: {}
 		};
 		const entry = this.entries[stack];
-		let glyph = entry.glyphs[id];
+		const glyphs = entry.glyphs[variant] ||= {};
+		let glyph = glyphs[id];
 		if (glyph !== void 0) return {
 			stack,
 			id,
+			variant,
 			glyph
 		};
+		if (variant !== "default") {
+			glyphs[id] = null;
+			return {
+				stack,
+				id,
+				variant,
+				glyph: null
+			};
+		}
 		const codePoint = id.codePointAt(0);
 		const fontFaceFamily = this.fontFaceManager.hasFontFaces() ? await this.fontFaceManager.getFontFamily(stack, codePoint) : null;
 		if (fontFaceFamily) {
-			glyph = entry.glyphs[id] = await this._drawGlyph(entry, stack, id, fontFaceFamily);
+			glyph = glyphs[id] = await this._drawGlyph(entry, stack, id, fontFaceFamily);
 			return {
 				stack,
 				id,
+				variant,
 				glyph
 			};
 		}
 		if (!this.url || isCluster(id) || this._charUsesLocalIdeographFontFamily(codePoint)) {
-			glyph = entry.glyphs[id] = await this._drawGlyph(entry, stack, id);
+			glyph = glyphs[id] = await this._drawGlyph(entry, stack, id);
 			return {
 				stack,
 				id,
+				variant,
 				glyph
 			};
 		}
-		return await this._downloadAndCacheRangePromise(stack, id);
+		return {
+			...await this._downloadAndCacheRangePromise(stack, id),
+			variant
+		};
 	}
 	/**
 	* Gets a glyph from the server-side cache, downloading the PBF range it falls in if need be.
@@ -1607,7 +1710,7 @@ var GlyphManager = class {
 		entry.requests[range] ||= this._loadGlyphRange(stack, range);
 		try {
 			const response = await entry.requests[range];
-			for (const responseId in response) entry.glyphs[String.fromCodePoint(+responseId)] = response[+responseId];
+			for (const responseId in response) entry.glyphs.default[String.fromCodePoint(+responseId)] = response[+responseId];
 			entry.ranges[range] = true;
 			return {
 				stack,
@@ -1615,7 +1718,7 @@ var GlyphManager = class {
 				glyph: response[codePoint] || null
 			};
 		} catch (e) {
-			const glyph = entry.glyphs[id] = await this._drawGlyph(entry, stack, id);
+			const glyph = entry.glyphs.default[id] = await this._drawGlyph(entry, stack, id);
 			this._warnOnMissingGlyphRange(glyph, range, codePoint, ensureError(e));
 			return {
 				stack,
@@ -1790,7 +1893,7 @@ var GlyphManager = class {
 			entry.tinySDF = null;
 			entry.ideographTinySDF = null;
 			entry.fontFaceTinySDFs = {};
-			entry.glyphs = {};
+			entry.glyphs = { default: {} };
 			entry.requests = {};
 			entry.ranges = {};
 		}
@@ -2963,6 +3066,7 @@ var VectorTileSource = class extends Evented {
 		};
 		params.request.collectResourceTiming = this._collectResourceTiming;
 		await this.dispatcher.waitForInitComplete();
+		if (tile.aborted) return;
 		let messageType = "RT";
 		if (!tile.actor || tile.state === "expired") {
 			tile.actor = this.dispatcher.getReadyActor();
@@ -3474,18 +3578,13 @@ function applySourceDiff(updateable, diff, promoteId) {
 /**
 * Merge two GeoJSONSourceDiffs, considering the order of operations as specified above (remove, add, update).
 *
-* For `add` features that use promoteId, the feature id will be set to the promoteId value temporarily so that
-* the merge can be completed, then reverted to the original promoteId state after the merge.
+* `add` features of a promoteId source carry their id in a property, so `promoteId` is needed to key them.
 */
 function mergeSourceDiffs(prevDiff, nextDiff, promoteId) {
 	if (!prevDiff) return nextDiff || {};
 	if (!nextDiff) return prevDiff || {};
-	if (promoteId) {
-		promoteFeatureIds(prevDiff.add, promoteId);
-		promoteFeatureIds(nextDiff.add, promoteId);
-	}
-	const prev = diffToHashed(prevDiff);
-	const next = diffToHashed(nextDiff);
+	const prev = diffToHashed(prevDiff, promoteId);
+	const next = diffToHashed(nextDiff, promoteId);
 	resolveMergeConflicts(prev, next);
 	const merged = {};
 	if (prev.removeAll || next.removeAll) merged.removeAll = true;
@@ -3493,9 +3592,7 @@ function mergeSourceDiffs(prevDiff, nextDiff, promoteId) {
 	merged.add = new Map([...prev.add, ...next.add]);
 	merged.update = new Map([...prev.update, ...next.update]);
 	if (merged.remove.size && merged.add.size) for (const id of merged.add.keys()) merged.remove.delete(id);
-	const mergedDiff = hashedToDiff(merged);
-	if (promoteId) demoteFeatureIds(mergedDiff.add, promoteId);
-	return mergedDiff;
+	return hashedToDiff(merged);
 }
 /**
 * Resolve merge conflicts between two GeoJSONSourceDiffs considering the ordering above (remove/add/update).
@@ -3542,32 +3639,16 @@ function mergeFeatureDiffs(prev, next) {
 	return merged;
 }
 /**
-* Mutates diff.add and applies a feature id using the promoteId property
-*/
-function promoteFeatureIds(add, promoteId) {
-	if (!add) return;
-	for (const feature of add) {
-		const id = getFeatureId(feature, promoteId);
-		if (id != null) feature.id = id;
-	}
-}
-/**
-* Mutates diff.add and removes the feature id if using the promoteId property
-*/
-function demoteFeatureIds(add, promoteId) {
-	if (!add) return;
-	for (const feature of add) if (getFeatureId(feature, promoteId) != null) delete feature.id;
-}
-/**
 * @internal
 * Convert a GeoJSONSourceDiff to an idempotent hashed representation using Sets and Maps
+* @param promoteId - If set, `add` features are keyed by that property instead of by `id`.
 */
-function diffToHashed(diff) {
+function diffToHashed(diff, promoteId) {
 	if (!diff) return {};
 	const hashed = {};
 	hashed.removeAll = diff.removeAll;
 	hashed.remove = new Set(diff.remove || []);
-	hashed.add = new Map(diff.add?.map((feature) => [feature.id, feature]));
+	hashed.add = new Map(diff.add?.map((feature) => [getFeatureId(feature, promoteId), feature]));
 	hashed.update = new Map(diff.update?.map((update) => [update.id, update]));
 	return hashed;
 }
@@ -3718,7 +3799,7 @@ var GeoJSONSource = class extends Evented {
 				maxZoom: this.maxzoom,
 				lineMetrics: options.lineMetrics || false,
 				generateId: options.generateId || false,
-				promoteId: typeof options.promoteId === "string" ? options.promoteId : void 0,
+				promoteId: this._promoteIdKey,
 				cluster: options.cluster || false,
 				clusterOptions: {
 					maxZoom: this._getClusterMaxZoom(options.clusterMaxZoom),
@@ -3733,6 +3814,10 @@ var GeoJSONSource = class extends Evented {
 			filter: options.filter
 		}, options.workerOptions);
 	}
+	/** The `promoteId` property name, when it is a plain string. */
+	get _promoteIdKey() {
+		return typeof this.promoteId === "string" ? this.promoteId : void 0;
+	}
 	_hasPendingWorkerUpdate() {
 		return this._pendingWorkerUpdate.data !== void 0 || this._pendingWorkerUpdate.diff !== void 0 || this._pendingWorkerUpdate.updateCluster;
 	}
@@ -3779,7 +3864,7 @@ var GeoJSONSource = class extends Evented {
 	* @param diff - The changes that need to be applied.
 	*/
 	updateData(diff) {
-		this._pendingWorkerUpdate.diff = mergeSourceDiffs(this._pendingWorkerUpdate.diff, diff);
+		this._pendingWorkerUpdate.diff = mergeSourceDiffs(this._pendingWorkerUpdate.diff, diff, this._promoteIdKey);
 		return this._updateWorkerData();
 	}
 	/**
@@ -4011,7 +4096,7 @@ var GeoJSONSource = class extends Evented {
 	*/
 	_applyDiffToSource(diff) {
 		if (!diff) return;
-		const promoteId = typeof this.promoteId === "string" ? this.promoteId : void 0;
+		const promoteId = this._promoteIdKey;
 		if (!this._data.url && !this._data.updateable) {
 			const updateable = toUpdateable(this._data.geojson, promoteId);
 			if (!updateable) throw new Error(`GeoJSONSource "${this.id}": GeoJSON data is not compatible with updateData`);
@@ -9556,8 +9641,8 @@ const shaders = {
 	fillPattern: prepare("#ifdef GL_ES\nprecision highp float;\n#endif\nuniform vec2 u_texsize;uniform float u_fade;uniform bool u_sdf_pattern;uniform sampler2D u_image;in vec2 v_pos_a;in vec2 v_pos_b;\n#pragma maplibre: define lowp float opacity\n#pragma maplibre: define highp vec4 color\n#pragma maplibre: define lowp vec4 pattern_from\n#pragma maplibre: define lowp vec4 pattern_to\nvoid main() {\n#pragma maplibre: initialize lowp float opacity\n#pragma maplibre: initialize highp vec4 color\n#pragma maplibre: initialize mediump vec4 pattern_from\n#pragma maplibre: initialize mediump vec4 pattern_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture(u_image,pos2);if (u_sdf_pattern) {highp float sdf_edge=(256.0-64.0)/256.0;highp float sdf_gamma_a=max(fwidth(color1.a)*0.5,1.0/255.0/16.0);highp float sdf_gamma_b=max(fwidth(color2.a)*0.5,1.0/255.0/16.0);float sdf_alpha_a=smoothstep(sdf_edge-sdf_gamma_a,sdf_edge+sdf_gamma_a,color1.a);float sdf_alpha_b=smoothstep(sdf_edge-sdf_gamma_b,sdf_edge+sdf_gamma_b,color2.a);fragColor=mix(color*sdf_alpha_a,color*sdf_alpha_b,u_fade)*opacity;} else {fragColor=mix(color1,color2,u_fade)*opacity;}\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;uniform vec2 u_fill_translate;layout(location=0) in vec2 a_pos;out vec2 v_pos_a;out vec2 v_pos_b;\n#pragma maplibre: define lowp float opacity\n#pragma maplibre: define highp vec4 color\n#pragma maplibre: define lowp vec4 pattern_from\n#pragma maplibre: define lowp vec4 pattern_to\n#pragma maplibre: define lowp float pixel_ratio_from\n#pragma maplibre: define lowp float pixel_ratio_to\nvoid main() {\n#pragma maplibre: initialize lowp float opacity\n#pragma maplibre: initialize highp vec4 color\n#pragma maplibre: initialize mediump vec4 pattern_from\n#pragma maplibre: initialize mediump vec4 pattern_to\n#pragma maplibre: initialize lowp float pixel_ratio_from\n#pragma maplibre: initialize lowp float pixel_ratio_to\nif (opacity < 0.01) {gl_Position=vec4(-2.0,-2.0,-2.0,1.0);return;}vec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;gl_Position=projectTile(a_pos+u_fill_translate,a_pos);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileZoomRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileZoomRatio,a_pos);}"),
 	fillExtrusion: prepare("in vec4 v_color;void main() {fragColor=v_color;\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp vec3 u_lightpos_globe;uniform lowp float u_lightintensity;uniform float u_vertical_gradient;uniform lowp float u_opacity;uniform vec2 u_fill_translate;layout(location=0) in vec2 a_pos;layout(location=1) in ivec4 a_normal_ed;\n#ifdef TERRAIN3D\nlayout(location=2) in vec2 a_centroid;\n#endif\nout vec4 v_color;\n#pragma maplibre: define highp float base\n#pragma maplibre: define highp float height\n#pragma maplibre: define highp vec4 color\nvoid main() {\n#pragma maplibre: initialize highp float base\n#pragma maplibre: initialize highp float height\n#pragma maplibre: initialize highp vec4 color\nvec3 normal=vec3(a_normal_ed.xyz);float gradient_base=max(0.0,base);float gradient_height=max(0.0,height);\n#ifdef TERRAIN3D\nfloat height_terrain3d_offset=get_elevation(a_centroid);float base_terrain3d_offset=height_terrain3d_offset-(base > 0.0 ? 0.0 : 10.0);\n#else\nfloat height_terrain3d_offset=0.0;float base_terrain3d_offset=0.0;\n#endif\nbase=max(0.0,base)+base_terrain3d_offset;height=max(0.0,height)+height_terrain3d_offset;float t=float(a_normal_ed.x & 1);float elevation=t > 0.0 ? height : base;vec2 posInTile=a_pos+u_fill_translate;\n#ifdef GLOBE\nvec3 spherePos=projectToSphere(posInTile,a_pos);gl_Position=interpolateProjectionFor3D(posInTile,spherePos,elevation);\n#else\ngl_Position=u_projection_matrix*vec4(posInTile,elevation,1.0);\n#endif\nfloat colorvalue=color.r*0.2126+color.g*0.7152+color.b*0.0722;v_color=vec4(0.0,0.0,0.0,1.0);vec4 ambientlight=vec4(0.03,0.03,0.03,1.0);color+=ambientlight;vec3 normalForLighting=normal/16384.0;float directional=clamp(dot(normalForLighting,u_lightpos),0.0,1.0);\n#ifdef GLOBE\nmat3 rotMatrix=globeGetRotationMatrix(spherePos);normalForLighting=rotMatrix*normalForLighting;directional=mix(directional,clamp(dot(normalForLighting,u_lightpos_globe),0.0,1.0),u_projection_transition);\n#endif\ndirectional=mix((1.0-u_lightintensity),max((1.0-colorvalue+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+gradient_base)*pow(gradient_height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_color.r+=clamp(color.r*directional*u_lightcolor.r,mix(0.0,0.3,1.0-u_lightcolor.r),1.0);v_color.g+=clamp(color.g*directional*u_lightcolor.g,mix(0.0,0.3,1.0-u_lightcolor.g),1.0);v_color.b+=clamp(color.b*directional*u_lightcolor.b,mix(0.0,0.3,1.0-u_lightcolor.b),1.0);v_color*=u_opacity;}"),
 	fillExtrusionPattern: prepare("uniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;in vec2 v_pos_a;in vec2 v_pos_b;in vec4 v_lighting;\n#pragma maplibre: define lowp float base\n#pragma maplibre: define lowp float height\n#pragma maplibre: define lowp vec4 pattern_from\n#pragma maplibre: define lowp vec4 pattern_to\n#pragma maplibre: define lowp float pixel_ratio_from\n#pragma maplibre: define lowp float pixel_ratio_to\nvoid main() {\n#pragma maplibre: initialize lowp float base\n#pragma maplibre: initialize lowp float height\n#pragma maplibre: initialize mediump vec4 pattern_from\n#pragma maplibre: initialize mediump vec4 pattern_to\n#pragma maplibre: initialize lowp float pixel_ratio_from\n#pragma maplibre: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture(u_image,pos2);vec4 mixedColor=mix(color1,color2,u_fade);fragColor=mixedColor*v_lighting;\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_height_factor;uniform vec3 u_scale;uniform float u_vertical_gradient;uniform lowp float u_opacity;uniform vec2 u_fill_translate;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp vec3 u_lightpos_globe;uniform lowp float u_lightintensity;layout(location=0) in vec2 a_pos;layout(location=1) in ivec4 a_normal_ed;\n#ifdef TERRAIN3D\nlayout(location=2) in vec2 a_centroid;\n#endif\n#ifdef GLOBE\nout vec3 v_sphere_pos;\n#endif\nout vec2 v_pos_a;out vec2 v_pos_b;out vec4 v_lighting;\n#pragma maplibre: define lowp float base\n#pragma maplibre: define lowp float height\n#pragma maplibre: define lowp vec4 pattern_from\n#pragma maplibre: define lowp vec4 pattern_to\n#pragma maplibre: define lowp float pixel_ratio_from\n#pragma maplibre: define lowp float pixel_ratio_to\nvoid main() {\n#pragma maplibre: initialize lowp float base\n#pragma maplibre: initialize lowp float height\n#pragma maplibre: initialize mediump vec4 pattern_from\n#pragma maplibre: initialize mediump vec4 pattern_to\n#pragma maplibre: initialize lowp float pixel_ratio_from\n#pragma maplibre: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec3 normal=vec3(a_normal_ed.xyz);float edgedistance=float(a_normal_ed.w);vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;float gradient_base=max(0.0,base);float gradient_height=max(0.0,height);\n#ifdef TERRAIN3D\nfloat height_terrain3d_offset=get_elevation(a_centroid);float base_terrain3d_offset=height_terrain3d_offset-(base > 0.0 ? 0.0 : 10.0);\n#else\nfloat height_terrain3d_offset=0.0;float base_terrain3d_offset=0.0;\n#endif\nbase=max(0.0,base)+base_terrain3d_offset;height=max(0.0,height)+height_terrain3d_offset;float t=float(a_normal_ed.x & 1);float elevation=t > 0.0 ? height : base;vec2 posInTile=a_pos+u_fill_translate;\n#ifdef GLOBE\nvec3 spherePos=projectToSphere(posInTile,a_pos);vec3 elevatedPos=spherePos*(1.0+elevation/GLOBE_RADIUS);v_sphere_pos=elevatedPos;gl_Position=interpolateProjectionFor3D(posInTile,spherePos,elevation);\n#else\ngl_Position=u_projection_matrix*vec4(posInTile,elevation,1.0);\n#endif\nvec2 pos=a_normal_ed.x==1 && a_normal_ed.y==0 && a_normal_ed.z==16384\n? a_pos\n: vec2(edgedistance,elevation*u_height_factor);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,pos);v_lighting=vec4(0.0,0.0,0.0,1.0);float directional=clamp(dot(normal/16383.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((0.5+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+gradient_base)*pow(gradient_height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_lighting.rgb+=clamp(directional*u_lightcolor,mix(vec3(0.0),vec3(0.3),1.0-u_lightcolor),vec3(1.0));v_lighting*=u_opacity;}"),
-	hillshadePrepare: prepare("#ifdef GL_ES\nprecision highp float;\n#endif\nuniform sampler2D u_image;in vec2 v_pos;uniform vec2 u_dimension;uniform float u_zoom;uniform vec4 u_unpack;float getElevation(ivec2 texel) {vec4 data=texelFetch(u_image,texel,0)*255.0;data.a=-1.0;return dot(data,u_unpack);}void main() {ivec2 pos=ivec2(gl_FragCoord.xy)+ivec2(1);float tileSize=u_dimension.x-4.0;float a=getElevation(pos+ivec2(-1,-1));float b=getElevation(pos+ivec2(0,-1));float c=getElevation(pos+ivec2(1,-1));float d=getElevation(pos+ivec2(-1,0));float e=getElevation(pos);float f=getElevation(pos+ivec2(1,0));float g=getElevation(pos+ivec2(-1,1));float h=getElevation(pos+ivec2(0,1));float i=getElevation(pos+ivec2(1,1));float exaggerationFactor=u_zoom < 2.0 ? 0.4 : u_zoom < 4.5 ? 0.35 : 0.3;float exaggeration=u_zoom < 15.0 ? (u_zoom-15.0)*exaggerationFactor : 0.0;vec2 deriv=vec2((c+f+f+i)-(a+d+d+g),(g+h+h+i)-(a+b+b+c))*tileSize/pow(2.0,exaggeration+(28.2562-u_zoom));fragColor=clamp(vec4(deriv.x/8.0+0.5,deriv.y/8.0+0.5,1.0,1.0),0.0,1.0);\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform mat4 u_matrix;uniform vec2 u_dimension;layout(location=0) in vec2 a_pos;layout(location=1) in vec2 a_texture_pos;out vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);highp vec2 epsilon=1.0/u_dimension;float scale=(u_dimension.x-2.0)/u_dimension.x;v_pos=(a_texture_pos/8192.0)*scale+epsilon;}"),
-	hillshade: prepare("uniform sampler2D u_image;in highp vec2 v_pos;uniform vec2 u_latrange;uniform float u_exaggeration;uniform vec4 u_accent;uniform int u_method;uniform float u_altitudes[NUM_ILLUMINATION_SOURCES];uniform float u_azimuths[NUM_ILLUMINATION_SOURCES];uniform vec4 u_shadows[NUM_ILLUMINATION_SOURCES];uniform vec4 u_highlights[NUM_ILLUMINATION_SOURCES];\n#define PI 3.141592653589793\n#define STANDARD 0\n#define COMBINED 1\n#define IGOR 2\n#define MULTIDIRECTIONAL 3\n#define BASIC 4\nfloat get_aspect(vec2 deriv){return deriv.x !=0.0 ? atan(deriv.y,-deriv.x) : PI/2.0*(deriv.y > 0.0 ? 1.0 :-1.0);}void igor_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;float aspect=get_aspect(deriv);float azimuth=u_azimuths[0]+PI;float slope_stength=atan(length(deriv))*2.0/PI;float aspect_strength=1.0-abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);float shadow_strength=slope_stength*aspect_strength;float highlight_strength=slope_stength*(1.0-aspect_strength);fragColor=u_shadows[0]*shadow_strength+u_highlights[0]*highlight_strength;}void standard_hillshade(vec2 deriv){float azimuth=u_azimuths[0]+PI;float slope=atan(0.625*length(deriv));float aspect=get_aspect(deriv);float intensity=u_exaggeration;float base=1.875-intensity*1.75;float maxValue=0.5*PI;float scaledSlope=intensity !=0.5 ? ((pow(base,slope)-1.0)/(pow(base,maxValue)-1.0))*maxValue : slope;float accent=cos(scaledSlope);vec4 accent_color=(1.0-accent)*u_accent*clamp(intensity*2.0,0.0,1.0);float shade=abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);vec4 shade_color=mix(u_shadows[0],u_highlights[0],shade)*sin(scaledSlope)*clamp(intensity*2.0,0.0,1.0);fragColor=accent_color*(1.0-shade_color.a)+shade_color;}void basic_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;float azimuth=u_azimuths[0]+PI;float cos_az=cos(azimuth);float sin_az=sin(azimuth);float cos_alt=cos(u_altitudes[0]);float sin_alt=sin(u_altitudes[0]);float cang=(sin_alt-(deriv.y*cos_az*cos_alt-deriv.x*sin_az*cos_alt))/sqrt(1.0+dot(deriv,deriv));float shade=clamp(cang,0.0,1.0);if(shade > 0.5){fragColor=u_highlights[0]*(2.0*shade-1.0);}else\n{fragColor=u_shadows[0]*(1.0-2.0*shade);}}void multidirectional_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;fragColor=vec4(0,0,0,0);for(int i=0; i < NUM_ILLUMINATION_SOURCES; i++){float cos_alt=cos(u_altitudes[i]);float sin_alt=sin(u_altitudes[i]);float cos_az=-cos(u_azimuths[i]);float sin_az=-sin(u_azimuths[i]);float cang=(sin_alt-(deriv.y*cos_az*cos_alt-deriv.x*sin_az*cos_alt))/sqrt(1.0+dot(deriv,deriv));float shade=clamp(cang,0.0,1.0);if(shade > 0.5){fragColor+=u_highlights[i]*(2.0*shade-1.0)/float(NUM_ILLUMINATION_SOURCES);}else\n{fragColor+=u_shadows[i]*(1.0-2.0*shade)/float(NUM_ILLUMINATION_SOURCES);}}}void combined_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;float azimuth=u_azimuths[0]+PI;float cos_az=cos(azimuth);float sin_az=sin(azimuth);float cos_alt=cos(u_altitudes[0]);float sin_alt=sin(u_altitudes[0]);float cang=acos((sin_alt-(deriv.y*cos_az*cos_alt-deriv.x*sin_az*cos_alt))/sqrt(1.0+dot(deriv,deriv)));cang=clamp(cang,0.0,PI/2.0);float shade=cang*atan(length(deriv))*4.0/PI/PI;float highlight=(PI/2.0-cang)*atan(length(deriv))*4.0/PI/PI;fragColor=u_shadows[0]*shade+u_highlights[0]*highlight;}void main() {highp vec2 size=vec2(textureSize(u_image,0));highp vec2 texturePos=(v_pos*(size-2.0)+1.0)/size;vec4 pixel=texture(u_image,texturePos);float scaleFactor=cos(radians((u_latrange[0]-u_latrange[1])*(1.0-v_pos.y)+u_latrange[1]));vec2 deriv=((pixel.rg*8.0)-4.0)/scaleFactor;if (u_method==BASIC) {basic_hillshade(deriv);} else if (u_method==COMBINED) {combined_hillshade(deriv);} else if (u_method==IGOR) {igor_hillshade(deriv);} else if (u_method==MULTIDIRECTIONAL) {multidirectional_hillshade(deriv);} else if (u_method==STANDARD) {standard_hillshade(deriv);} else {standard_hillshade(deriv);}\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform mat4 u_matrix;layout(location=0) in vec2 a_pos;out vec2 v_pos;void main() {gl_Position=projectTile(a_pos,a_pos);v_pos=a_pos/8192.0;if (a_pos.y <-32767.5) {v_pos.y=0.0;}if (a_pos.y > 32766.5) {v_pos.y=1.0;}}"),
+	hillshadePrepare: prepare("#ifdef GL_ES\nprecision highp float;\n#endif\nuniform sampler2D u_image;in vec2 v_pos;uniform vec2 u_dimension;uniform float u_zoom;uniform vec4 u_unpack;float getElevation(ivec2 texel) {vec4 data=texelFetch(u_image,texel,0)*255.0;data.a=-1.0;return dot(data,u_unpack);}void main() {ivec2 pos=ivec2(gl_FragCoord.xy)+ivec2(1);float tileSize=u_dimension.x-4.0;float a=getElevation(pos+ivec2(-1,-1));float b=getElevation(pos+ivec2(0,-1));float c=getElevation(pos+ivec2(1,-1));float d=getElevation(pos+ivec2(-1,0));float e=getElevation(pos);float f=getElevation(pos+ivec2(1,0));float g=getElevation(pos+ivec2(-1,1));float h=getElevation(pos+ivec2(0,1));float i=getElevation(pos+ivec2(1,1));float exaggerationFactor=u_zoom < 2.0 ? 0.4 : u_zoom < 4.5 ? 0.35 : 0.3;float exaggeration=u_zoom < 15.0 ? (u_zoom-15.0)*exaggerationFactor : 0.0;vec2 deriv=vec2((c+f+f+i)-(a+d+d+g),(g+h+h+i)-(a+b+b+c))*tileSize/pow(2.0,exaggeration+(28.2562-u_zoom));fragColor=clamp(vec4(deriv.x/8.0+128.0/255.0,deriv.y/8.0+128.0/255.0,1.0,1.0),0.0,1.0);\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform mat4 u_matrix;uniform vec2 u_dimension;layout(location=0) in vec2 a_pos;layout(location=1) in vec2 a_texture_pos;out vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);highp vec2 epsilon=1.0/u_dimension;float scale=(u_dimension.x-2.0)/u_dimension.x;v_pos=(a_texture_pos/8192.0)*scale+epsilon;}"),
+	hillshade: prepare("uniform sampler2D u_image;in highp vec2 v_pos;uniform vec2 u_latrange;uniform float u_exaggeration;uniform vec4 u_accent;uniform int u_method;uniform float u_altitudes[NUM_ILLUMINATION_SOURCES];uniform float u_azimuths[NUM_ILLUMINATION_SOURCES];uniform vec4 u_shadows[NUM_ILLUMINATION_SOURCES];uniform vec4 u_highlights[NUM_ILLUMINATION_SOURCES];\n#define PI 3.141592653589793\n#define STANDARD 0\n#define COMBINED 1\n#define IGOR 2\n#define MULTIDIRECTIONAL 3\n#define BASIC 4\nfloat get_aspect(vec2 deriv){return deriv.x !=0.0 ? atan(deriv.y,-deriv.x) : PI/2.0*(deriv.y > 0.0 ? 1.0 :-1.0);}void igor_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;float aspect=get_aspect(deriv);float azimuth=u_azimuths[0]+PI;float slope_stength=atan(length(deriv))*2.0/PI;float aspect_strength=1.0-abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);float shadow_strength=slope_stength*aspect_strength;float highlight_strength=slope_stength*(1.0-aspect_strength);fragColor=u_shadows[0]*shadow_strength+u_highlights[0]*highlight_strength;}void standard_hillshade(vec2 deriv){float azimuth=u_azimuths[0]+PI;float slope=atan(0.625*length(deriv));float aspect=get_aspect(deriv);float intensity=u_exaggeration;float base=1.875-intensity*1.75;float maxValue=0.5*PI;float scaledSlope=intensity !=0.5 ? ((pow(base,slope)-1.0)/(pow(base,maxValue)-1.0))*maxValue : slope;float accent=cos(scaledSlope);vec4 accent_color=(1.0-accent)*u_accent*clamp(intensity*2.0,0.0,1.0);float shade=abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);vec4 shade_color=mix(u_shadows[0],u_highlights[0],shade)*sin(scaledSlope)*clamp(intensity*2.0,0.0,1.0);fragColor=accent_color*(1.0-shade_color.a)+shade_color;}void basic_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;float azimuth=u_azimuths[0]+PI;float cos_az=cos(azimuth);float sin_az=sin(azimuth);float cos_alt=cos(u_altitudes[0]);float sin_alt=sin(u_altitudes[0]);float cang=(sin_alt-(deriv.y*cos_az*cos_alt-deriv.x*sin_az*cos_alt))/sqrt(1.0+dot(deriv,deriv));float shade=clamp(cang,0.0,1.0);if(shade > 0.5){fragColor=u_highlights[0]*(2.0*shade-1.0);}else\n{fragColor=u_shadows[0]*(1.0-2.0*shade);}}void multidirectional_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;fragColor=vec4(0,0,0,0);for(int i=0; i < NUM_ILLUMINATION_SOURCES; i++){float cos_alt=cos(u_altitudes[i]);float sin_alt=sin(u_altitudes[i]);float cos_az=-cos(u_azimuths[i]);float sin_az=-sin(u_azimuths[i]);float cang=(sin_alt-(deriv.y*cos_az*cos_alt-deriv.x*sin_az*cos_alt))/sqrt(1.0+dot(deriv,deriv));float shade=clamp(cang,0.0,1.0);if(shade > 0.5){fragColor+=u_highlights[i]*(2.0*shade-1.0)/float(NUM_ILLUMINATION_SOURCES);}else\n{fragColor+=u_shadows[i]*(1.0-2.0*shade)/float(NUM_ILLUMINATION_SOURCES);}}}void combined_hillshade(vec2 deriv){deriv=deriv*u_exaggeration*2.0;float azimuth=u_azimuths[0]+PI;float cos_az=cos(azimuth);float sin_az=sin(azimuth);float cos_alt=cos(u_altitudes[0]);float sin_alt=sin(u_altitudes[0]);float cang=acos((sin_alt-(deriv.y*cos_az*cos_alt-deriv.x*sin_az*cos_alt))/sqrt(1.0+dot(deriv,deriv)));cang=clamp(cang,0.0,PI/2.0);float shade=cang*atan(length(deriv))*4.0/PI/PI;float highlight=(PI/2.0-cang)*atan(length(deriv))*4.0/PI/PI;fragColor=u_shadows[0]*shade+u_highlights[0]*highlight;}void main() {highp vec2 size=vec2(textureSize(u_image,0));highp vec2 texturePos=(v_pos*(size-2.0)+1.0)/size;vec4 pixel=texture(u_image,texturePos);float scaleFactor=cos(radians((u_latrange[0]-u_latrange[1])*(1.0-v_pos.y)+u_latrange[1]));vec2 deriv=(pixel.rg-128.0/255.0)*8.0/scaleFactor;if (u_method==BASIC) {basic_hillshade(deriv);} else if (u_method==COMBINED) {combined_hillshade(deriv);} else if (u_method==IGOR) {igor_hillshade(deriv);} else if (u_method==MULTIDIRECTIONAL) {multidirectional_hillshade(deriv);} else if (u_method==STANDARD) {standard_hillshade(deriv);} else {standard_hillshade(deriv);}\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "uniform mat4 u_matrix;layout(location=0) in vec2 a_pos;out vec2 v_pos;void main() {gl_Position=projectTile(a_pos,a_pos);v_pos=a_pos/8192.0;if (a_pos.y <-32767.5) {v_pos.y=0.0;}if (a_pos.y > 32766.5) {v_pos.y=1.0;}}"),
 	line: prepare("flat in vec2 v_width2;in vec2 v_normal;in float v_gamma_scale;\n#ifdef GLOBE\nin float v_depth;\n#endif\n#pragma maplibre: define highp vec4 color\n#pragma maplibre: define lowp float blur\n#pragma maplibre: define lowp float opacity\nvoid main() {\n#pragma maplibre: initialize highp vec4 color\n#pragma maplibre: initialize lowp float blur\n#pragma maplibre: initialize lowp float opacity\nclipAntimeridian();float dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);fragColor=color*(alpha*opacity);\n#ifdef GLOBE\nif (v_depth > 1.0) {discard;}\n#endif\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "\n#define scale 0.015873016\nlayout(location=0) in ivec2 a_pos_normal;layout(location=1) in uvec4 a_data;uniform vec2 u_translation;uniform mediump float u_ratio;out vec2 v_normal;flat out vec2 v_width2;out float v_gamma_scale;out highp float v_linesofar;\n#ifdef GLOBE\nout float v_depth;\n#endif\n#pragma maplibre: define highp vec4 color\n#pragma maplibre: define lowp float blur\n#pragma maplibre: define lowp float opacity\n#pragma maplibre: define mediump float gapwidth\n#pragma maplibre: define lowp float offset\n#pragma maplibre: define mediump float width\nvoid main() {\n#pragma maplibre: initialize highp vec4 color\n#pragma maplibre: initialize lowp float blur\n#pragma maplibre: initialize lowp float opacity\n#pragma maplibre: initialize mediump float gapwidth\n#pragma maplibre: initialize lowp float offset\n#pragma maplibre: initialize mediump float width\nif (opacity < 0.01) {gl_Position=vec4(-2.0,-2.0,-2.0,1.0);return;}float ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=vec2(ivec2(a_data.xy)-128);float a_direction=float(int(a_data.z & 3u)-1);v_linesofar=float((a_data.z >> 2u)+a_data.w*64u)*2.0;vec2 pos=vec2(a_pos_normal >> 1);mediump vec2 normal=vec2(a_pos_normal & 1);normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);float adjustedThickness=projectLineThickness(pos.y);vec4 projected_no_extrude=projectTile(pos+offset2/u_ratio*adjustedThickness+u_translation);vec4 projected_with_extrude=projectTile(pos+offset2/u_ratio*adjustedThickness+u_translation+dist/u_ratio*adjustedThickness);gl_Position=projected_with_extrude;\n#ifdef GLOBE\nv_depth=gl_Position.z/gl_Position.w;\n#endif\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length((projected_with_extrude.xy-projected_no_extrude.xy)/projected_with_extrude.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_width2=vec2(outset,inset);}"),
 	lineGradient: prepare("uniform sampler2D u_image;flat in vec2 v_width2;in vec2 v_normal;in float v_gamma_scale;in highp vec2 v_uv;\n#ifdef GLOBE\nin float v_depth;\n#endif\n#pragma maplibre: define lowp float blur\n#pragma maplibre: define lowp float opacity\nvoid main() {\n#pragma maplibre: initialize lowp float blur\n#pragma maplibre: initialize lowp float opacity\nclipAntimeridian();float dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);vec4 color=texture(u_image,v_uv);fragColor=color*(alpha*opacity);\n#ifdef GLOBE\nif (v_depth > 1.0) {discard;}\n#endif\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "\n#define scale 0.015873016\nlayout(location=0) in ivec2 a_pos_normal;layout(location=1) in uvec4 a_data;layout(location=2) in float a_uv_x;layout(location=3) in float a_split_index;uniform vec2 u_translation;uniform mediump float u_ratio;uniform float u_image_height;out vec2 v_normal;flat out vec2 v_width2;out float v_gamma_scale;out highp vec2 v_uv;\n#ifdef GLOBE\nout float v_depth;\n#endif\n#pragma maplibre: define lowp float blur\n#pragma maplibre: define lowp float opacity\n#pragma maplibre: define mediump float gapwidth\n#pragma maplibre: define lowp float offset\n#pragma maplibre: define mediump float width\nvoid main() {\n#pragma maplibre: initialize lowp float blur\n#pragma maplibre: initialize lowp float opacity\n#pragma maplibre: initialize mediump float gapwidth\n#pragma maplibre: initialize lowp float offset\n#pragma maplibre: initialize mediump float width\nif (opacity < 0.01) {gl_Position=vec4(-2.0,-2.0,-2.0,1.0);return;}float ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=vec2(ivec2(a_data.xy)-128);float a_direction=float(int(a_data.z & 3u)-1);highp float texel_height=1.0/u_image_height;highp float half_texel_height=0.5*texel_height;v_uv=vec2(a_uv_x,a_split_index*texel_height-half_texel_height);vec2 pos=vec2(a_pos_normal >> 1);mediump vec2 normal=vec2(a_pos_normal & 1);normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);float adjustedThickness=projectLineThickness(pos.y);vec4 projected_no_extrude=projectTile(pos+offset2/u_ratio*adjustedThickness+u_translation);vec4 projected_with_extrude=projectTile(pos+offset2/u_ratio*adjustedThickness+u_translation+dist/u_ratio*adjustedThickness);gl_Position=projected_with_extrude;\n#ifdef GLOBE\nv_depth=gl_Position.z/gl_Position.w;\n#endif\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length((projected_with_extrude.xy-projected_no_extrude.xy)/projected_with_extrude.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_width2=vec2(outset,inset);}"),
 	linePattern: prepare("#ifdef GL_ES\nprecision highp float;\n#endif\nuniform vec2 u_texsize;uniform float u_fade;uniform mediump vec3 u_scale;uniform sampler2D u_image;in vec2 v_normal;flat in vec2 v_width2;in float v_linesofar;in float v_gamma_scale;flat in float v_width;\n#ifdef GLOBE\nin float v_depth;\n#endif\n#pragma maplibre: define lowp vec4 pattern_from\n#pragma maplibre: define lowp vec4 pattern_to\n#pragma maplibre: define lowp float pixel_ratio_from\n#pragma maplibre: define lowp float pixel_ratio_to\n#pragma maplibre: define lowp float blur\n#pragma maplibre: define lowp float opacity\nvoid main() {\n#pragma maplibre: initialize mediump vec4 pattern_from\n#pragma maplibre: initialize mediump vec4 pattern_to\n#pragma maplibre: initialize lowp float pixel_ratio_from\n#pragma maplibre: initialize lowp float pixel_ratio_to\n#pragma maplibre: initialize lowp float blur\n#pragma maplibre: initialize lowp float opacity\nclipAntimeridian();vec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;vec2 pattern_size_a=vec2(display_size_a.x*fromScale/tileZoomRatio,display_size_a.y);vec2 pattern_size_b=vec2(display_size_b.x*toScale/tileZoomRatio,display_size_b.y);float aspect_a=display_size_a.y/v_width;float aspect_b=display_size_b.y/v_width;float dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float x_a=mod(v_linesofar/pattern_size_a.x*aspect_a,1.0);float x_b=mod(v_linesofar/pattern_size_b.x*aspect_b,1.0);float y=0.5*v_normal.y+0.5;vec2 texel_size=1.0/u_texsize;vec2 pos_a=mix(pattern_tl_a*texel_size-texel_size,pattern_br_a*texel_size+texel_size,vec2(x_a,y));vec2 pos_b=mix(pattern_tl_b*texel_size-texel_size,pattern_br_b*texel_size+texel_size,vec2(x_b,y));vec4 color=mix(texture(u_image,pos_a),texture(u_image,pos_b),u_fade);fragColor=color*alpha*opacity;\n#ifdef GLOBE\nif (v_depth > 1.0) {discard;}\n#endif\n#ifdef OVERDRAW_INSPECTOR\nfragColor=vec4(1.0);\n#endif\n}", "\n#define scale 0.015873016\n#define LINE_DISTANCE_SCALE 2.0\nlayout(location=0) in ivec2 a_pos_normal;layout(location=1) in uvec4 a_data;uniform vec2 u_translation;uniform mediump float u_ratio;out vec2 v_normal;flat out vec2 v_width2;out float v_linesofar;out float v_gamma_scale;flat out float v_width;\n#ifdef GLOBE\nout float v_depth;\n#endif\n#pragma maplibre: define lowp float blur\n#pragma maplibre: define lowp float opacity\n#pragma maplibre: define lowp float offset\n#pragma maplibre: define mediump float gapwidth\n#pragma maplibre: define mediump float width\n#pragma maplibre: define lowp float floorwidth\n#pragma maplibre: define lowp vec4 pattern_from\n#pragma maplibre: define lowp vec4 pattern_to\n#pragma maplibre: define lowp float pixel_ratio_from\n#pragma maplibre: define lowp float pixel_ratio_to\nvoid main() {\n#pragma maplibre: initialize lowp float blur\n#pragma maplibre: initialize lowp float opacity\n#pragma maplibre: initialize lowp float offset\n#pragma maplibre: initialize mediump float gapwidth\n#pragma maplibre: initialize mediump float width\n#pragma maplibre: initialize lowp float floorwidth\n#pragma maplibre: initialize mediump vec4 pattern_from\n#pragma maplibre: initialize mediump vec4 pattern_to\n#pragma maplibre: initialize lowp float pixel_ratio_from\n#pragma maplibre: initialize lowp float pixel_ratio_to\nif (opacity < 0.01) {gl_Position=vec4(-2.0,-2.0,-2.0,1.0);return;}float ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=vec2(ivec2(a_data.xy)-128);float a_direction=float(int(a_data.z & 3u)-1);float a_linesofar=float((a_data.z >> 2u)+a_data.w*64u)*LINE_DISTANCE_SCALE;vec2 pos=vec2(a_pos_normal >> 1);mediump vec2 normal=vec2(a_pos_normal & 1);normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);float adjustedThickness=projectLineThickness(pos.y);vec4 projected_no_extrude=projectTile(pos+offset2/u_ratio*adjustedThickness+u_translation);vec4 projected_with_extrude=projectTile(pos+offset2/u_ratio*adjustedThickness+u_translation+dist/u_ratio*adjustedThickness);gl_Position=projected_with_extrude;\n#ifdef GLOBE\nv_depth=gl_Position.z/gl_Position.w;\n#endif\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length((projected_with_extrude.xy-projected_no_extrude.xy)/projected_with_extrude.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_linesofar=a_linesofar;v_width2=vec2(outset,inset);v_width=floorwidth;}"),
@@ -10300,7 +10385,7 @@ var TransformHelper = class {
 		const altitudeAGL = alt - elevation;
 		let distanceToCenter;
 		let clampedElevation = elevation;
-		if (dzNormalized * altitudeAGL >= 0 || Math.abs(dzNormalized) < .1) {
+		if (dzNormalized * altitudeAGL >= 0 || Math.abs(dzNormalized) < Math.cos(degreesToRadians(89.25))) {
 			distanceToCenter = 1e4;
 			clampedElevation = alt + distanceToCenter * dzNormalized;
 		} else distanceToCenter = -altitudeAGL / dzNormalized;
@@ -11618,7 +11703,7 @@ var MercatorTransform = class MercatorTransform {
 	}
 	isPointOnMapSurface(p, terrain) {
 		if (terrain) return this.screenTerrainPointToMercatorCoordinate(p, terrain) != null;
-		return p.y > this.height / 2 - getMercatorHorizon(this);
+		return p.y > this.centerPoint.y - getMercatorHorizon(this);
 	}
 	calculatePosMatrix(tileID, aligned = false, useFloat32 = false) {
 		const posMatrixKey = tileID.key ?? calculateTileKey(tileID.wrap, tileID.canonical.z, tileID.canonical.z, tileID.canonical.x, tileID.canonical.y);
@@ -12104,42 +12189,64 @@ var MercatorCameraHelper = class {
 				tr.setLocationAtPoint(tr.renderWorldCopies ? newCenter.wrap() : newCenter, pointAtOffset);
 			}
 		};
+		const endTransform = this._transformAtAnimationEnd(tr, endZoom, endEulerAngles, options.padding);
+		if (options.around) endTransform.setLocationAtPoint(options.around, options.aroundPoint);
+		else endTransform.setLocationAtPoint(center, endTransform.centerPoint.add(options.offsetAsPoint));
 		return {
 			easeFunc,
 			isZooming,
-			elevationCenter: center
+			elevationCenter: endTransform.center
 		};
 	}
 	handleFlyTo(tr, options) {
 		const optionsZoom = typeof options.zoom !== "undefined";
 		const startZoom = tr.zoom;
 		const constrained = tr.applyConstrain(LngLat.convert(options.center || options.locationAtOffset), optionsZoom ? +options.zoom : startZoom);
-		const targetCenter = constrained.center;
+		const constrainedCenter = constrained.center;
 		const targetZoom = constrained.zoom;
-		normalizeCenter(tr, targetCenter);
+		normalizeCenter(tr, constrainedCenter);
 		const startWorldSize = tr.worldSize;
 		const from = projectToWorldCoordinates(startWorldSize, options.locationAtOffset);
-		const delta = projectToWorldCoordinates(startWorldSize, targetCenter).sub(from);
+		const delta = projectToWorldCoordinates(startWorldSize, constrainedCenter).sub(from);
 		const pixelPathLength = delta.mag();
 		const scaleOfZoom = zoomScale(targetZoom - startZoom);
 		const requestedMinZoom = typeof options.minZoom !== "undefined" ? +options.minZoom : tr.minZoom;
 		const effectiveMinZoom = Math.max(requestedMinZoom, tr.minZoom);
 		const minZoomPreConstrain = Math.min(effectiveMinZoom, startZoom, targetZoom);
-		const minZoom = tr.applyConstrain(targetCenter, minZoomPreConstrain).zoom;
+		const minZoom = tr.applyConstrain(constrainedCenter, minZoomPreConstrain).zoom;
 		const scaleOfMinZoom = zoomScale(minZoom - startZoom);
 		const easeFunc = (k, scale, centerFactor, pointAtOffset) => {
 			tr.setZoom(k === 1 ? targetZoom : startZoom + scaleZoom(scale));
-			const newCenter = k === 1 ? targetCenter : unprojectFromWorldCoordinates(startWorldSize, from.add(delta.mult(centerFactor)));
+			const newCenter = k === 1 ? constrainedCenter : unprojectFromWorldCoordinates(startWorldSize, from.add(delta.mult(centerFactor)));
 			tr.setLocationAtPoint(tr.renderWorldCopies ? newCenter.wrap() : newCenter, pointAtOffset);
 		};
+		const endTransform = this._transformAtAnimationEnd(tr, targetZoom, {
+			roll: options.roll,
+			pitch: options.pitch,
+			bearing: options.bearing
+		}, options.padding);
+		endTransform.setLocationAtPoint(constrainedCenter, endTransform.centerPoint.add(options.offsetAsPoint));
 		return {
 			easeFunc,
 			scaleOfZoom,
-			targetCenter,
+			targetCenter: endTransform.center,
 			scaleOfMinZoom,
 			pixelPathLength
 		};
 	}
+	/**
+	* A copy of the transform at the animation's end zoom, angles and padding, for reading where the map center
+	* ends up once a location is placed at its screen point.
+	*/
+	_transformAtAnimationEnd(tr, zoom, angles, padding) {
+		const endTransform = tr.clone();
+		endTransform.setZoom(zoom);
+		endTransform.setRoll(angles.roll);
+		endTransform.setPitch(angles.pitch);
+		endTransform.setBearing(angles.bearing);
+		endTransform.setPadding(padding);
+		return endTransform;
+	}
 };
 //#endregion
 //#region src/style/projection_properties.g.ts
@@ -12647,9 +12754,11 @@ function raySphereIntersection(origin, direction, radius = 1) {
 	const q = -originDotDirection + (originDotDirection < 0 ? 1 : -1) * Math.sqrt(discriminant);
 	const t0 = c / q;
 	const t1 = q;
+	const tMax = Math.max(t0, t1);
+	if (tMax < 0) return null;
 	return {
 		tMin: Math.min(t0, t1),
-		tMax: Math.max(t0, t1)
+		tMax
 	};
 }
 /** Height of the atmosphere relative to the globe radius, 100 km for Earth. */
@@ -14472,6 +14581,7 @@ var VerticalPerspectiveCameraHelper = class VerticalPerspectiveCameraHelper {
 	}
 	cameraForBoxAndBearing(options, padding, bounds, bearing, tr) {
 		const result = cameraForBoxAndBearing(options, padding, bounds, bearing, tr);
+		if (!result) return;
 		const xLeft = padding.left / tr.width * 2 - 1;
 		const xRight = (tr.width - padding.right) / tr.width * 2 - 1;
 		const yTop = padding.top / tr.height * -2 + 1;
@@ -16263,13 +16373,11 @@ var UniformBuffer = class {
 		this.buffer = gl.createBuffer();
 		gl.bindBuffer(gl.UNIFORM_BUFFER, this.buffer);
 		gl.bufferData(gl.UNIFORM_BUFFER, layout.sizeWords * 4, gl.DYNAMIC_DRAW);
-		gl.bindBufferBase(gl.UNIFORM_BUFFER, binding, this.buffer);
 		this.uploaded = new Float32Array(layout.sizeWords);
 		this.pending = new Float32Array(layout.sizeWords);
 		this.uploadedWords = new Uint32Array(this.uploaded.buffer);
 		this.pendingWords = new Uint32Array(this.pending.buffer);
 		this.hasData = false;
-		this.bindingDirty = false;
 	}
 	upload() {
 		const gl = this.context.gl;
@@ -16282,19 +16390,23 @@ var UniformBuffer = class {
 				break;
 			}
 		}
-		this.bind();
-		if (!changed) return;
+		if (!changed) {
+			this.bind();
+			return;
+		}
 		gl.bindBufferBase(gl.UNIFORM_BUFFER, this.binding, this.buffer);
+		this.context.boundUniformBuffers[this.binding] = this.buffer;
 		gl.bufferData(gl.UNIFORM_BUFFER, this.pending, gl.DYNAMIC_DRAW);
 		this.uploaded.set(this.pending);
 		this.hasData = true;
 	}
 	/** Restores the indexed binding after external rendering without uploading unchanged data. */
 	bind() {
-		if (!this.bindingDirty) return;
+		const boundUniformBuffers = this.context.boundUniformBuffers;
+		if (boundUniformBuffers[this.binding] === this.buffer) return;
 		const gl = this.context.gl;
 		gl.bindBufferBase(gl.UNIFORM_BUFFER, this.binding, this.buffer);
-		this.bindingDirty = false;
+		boundUniformBuffers[this.binding] = this.buffer;
 	}
 	destroy() {
 		const gl = this.context.gl;
@@ -16335,7 +16447,7 @@ const layout$2 = std140Layout([
 const offsets$2 = layout$2.offsets;
 /**
 * @internal
-* The buffer behind the `ProjectionUBO` block in the shader preludes, written by `Program.draw` before each draw.
+* The buffer behind the `ProjectionUBO` block in the shader preludes.
 */
 function createProjectionUniformBuffer(context) {
 	return new UniformBuffer(context, UBO_BINDINGS.ProjectionUBO, layout$2);
@@ -16350,6 +16462,34 @@ function updateProjectionUniformBuffer(buffer, projectionData) {
 	buffer.pendingWords[offsets$2.u_projection_clip_antimeridian] = projectionData.clipAntimeridian ? 1 : 0;
 	buffer.upload();
 }
+function bindProjectionUniformBuffer(context, projectionData) {
+	if (!projectionData) {
+		context.projectionUniformBuffer.bind();
+		return;
+	}
+	const key = projectionData.uniformBufferKey;
+	if (key === void 0) {
+		updateProjectionUniformBuffer(context.projectionUniformBuffer, projectionData);
+		return;
+	}
+	const keyedBuffer = context.keyedProjectionUniformBuffers.get(key);
+	if (keyedBuffer) {
+		keyedBuffer.bind();
+		return;
+	}
+	const buffer = context.freeProjectionUniformBuffers.pop() ?? createProjectionUniformBuffer(context);
+	context.keyedProjectionUniformBuffers.set(key, buffer);
+	updateProjectionUniformBuffer(buffer, projectionData);
+}
+function releaseProjectionUniformBuffers(context) {
+	context.freeProjectionUniformBuffers.push(...context.keyedProjectionUniformBuffers.values());
+	context.keyedProjectionUniformBuffers.clear();
+}
+function destroyProjectionUniformBuffers(context) {
+	context.projectionUniformBuffer.destroy();
+	for (const buffer of context.keyedProjectionUniformBuffers.values()) buffer.destroy();
+	for (const buffer of context.freeProjectionUniformBuffers) buffer.destroy();
+}
 //#endregion
 //#region src/webgl/terrain_uniform_buffer.ts
 const layout$1 = std140Layout([
@@ -16494,7 +16634,6 @@ var Program = class {
 		const gl = context.gl;
 		if (this.failedToCreate) return;
 		context.program.set(this.program);
-		context.projectionUniformBuffer.bind();
 		context.terrainUniformBuffer.bind();
 		context.frameUniformBuffer.bind();
 		context.setDepthMode(depthMode);
@@ -16509,7 +16648,7 @@ var Program = class {
 			for (const name in this.terrainUniforms) this.terrainUniforms[name].set(terrain[name]);
 			updateTerrainUniformBuffer(context.terrainUniformBuffer, terrain);
 		}
-		if (projectionData) updateProjectionUniformBuffer(context.projectionUniformBuffer, projectionData);
+		bindProjectionUniformBuffer(context, projectionData);
 		if (uniformValues) for (const name in this.fixedUniforms) this.fixedUniforms[name].set(uniformValues[name]);
 		if (configuration) configuration.setUniforms(context, this.binderUniforms, currentProperties, { zoom });
 		let primitiveSize = 0;
@@ -17897,7 +18036,10 @@ var Context = class {
 		this.maxTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE);
 		gl.getExtension("EXT_color_buffer_half_float");
 		gl.getExtension("EXT_color_buffer_float");
+		this.boundUniformBuffers = [];
 		this.projectionUniformBuffer = createProjectionUniformBuffer(this);
+		this.keyedProjectionUniformBuffers = /* @__PURE__ */ new Map();
+		this.freeProjectionUniformBuffers = [];
 		this.terrainUniformBuffer = createTerrainUniformBuffer(this);
 		this.frameUniformBuffer = createFrameUniformBuffer(this);
 	}
@@ -17961,9 +18103,7 @@ var Context = class {
 		this.pixelStoreUnpack.dirty = true;
 		this.pixelStoreUnpackPremultiplyAlpha.dirty = true;
 		this.pixelStoreUnpackFlipY.dirty = true;
-		this.projectionUniformBuffer.bindingDirty = true;
-		this.terrainUniformBuffer.bindingDirty = true;
-		this.frameUniformBuffer.bindingDirty = true;
+		this.boundUniformBuffers = [];
 	}
 	/**
 	* Reset some GL state to default values before handing users the raw context, as we do for
@@ -18142,12 +18282,15 @@ function createRenderContext(transform, projection, terrain) {
 	};
 }
 function getProjectionDataForTile(renderContext, tileID, options = {}) {
-	return renderContext.transform.getProjectionData({
+	const projectionData = renderContext.transform.getProjectionData({
 		overscaledTileID: tileID,
 		aligned: options.aligned,
 		applyGlobeMatrix: !renderContext.isRenderingToTexture,
 		applyTerrainMatrix: options.applyTerrainMatrix ?? true
 	});
+	if (renderContext.isRenderingToTexture) return projectionData;
+	projectionData.uniformBufferKey = options.aligned ? `${tileID.key}/aligned` : tileID.key;
+	return projectionData;
 }
 /**
 * Returns terrain data for a tile.
@@ -19700,8 +19843,8 @@ var Painter = class Painter {
 		this.crossTileSymbolIndex = new CrossTileSymbolIndex();
 	}
 	resize(width, height, pixelRatio) {
-		this.width = Math.floor(width * pixelRatio);
-		this.height = Math.floor(height * pixelRatio);
+		this.width = Math.round(width * pixelRatio);
+		this.height = Math.round(height * pixelRatio);
 		this.pixelRatio = pixelRatio;
 		this.context.viewport.set([
 			0,
@@ -19957,6 +20100,7 @@ var Painter = class Painter {
 		this.symbolFadeChange = style.placement.symbolFadeChange(now());
 		updateFrameUniformBuffer(this.context.frameUniformBuffer, this);
 		this.imageManager.beginFrame();
+		releaseProjectionUniformBuffers(this.context);
 		const layerIds = this.style._order;
 		const tileManagers = this.style.tileManagers;
 		const coordsAscending = {};
@@ -20262,7 +20406,7 @@ var Painter = class Painter {
 		if (this.tileExtentMesh) this.tileExtentMesh.vertexBuffer?.destroy();
 		if (this.tileExtentMesh) this.tileExtentMesh.indexBuffer?.destroy();
 		if (this.debugOverlayTexture) this.debugOverlayTexture.destroy();
-		this.context.projectionUniformBuffer.destroy();
+		destroyProjectionUniformBuffers(this.context);
 		this.context.terrainUniformBuffer.destroy();
 		this.context.frameUniformBuffer.destroy();
 		if (this.cache) {
@@ -20998,7 +21142,7 @@ var TapZoomHandler = class {
 			return { cameraAnimation: (map) => map.easeTo({
 				duration: 300,
 				zoom: evaluateZoomSnap(tr.zoom + 1, map.getZoomSnap()),
-				around: tr.unproject(zoomInPoint)
+				around: tr.transform.isPointOnMapSurface(zoomInPoint) ? tr.unproject(zoomInPoint) : void 0
 			}, { originalEvent: e }) };
 		} else if (zoomOutPoint) {
 			this._active = true;
@@ -21007,7 +21151,7 @@ var TapZoomHandler = class {
 			return { cameraAnimation: (map) => map.easeTo({
 				duration: 300,
 				zoom: evaluateZoomSnap(tr.zoom - 1, map.getZoomSnap()),
-				around: tr.unproject(zoomOutPoint)
+				around: tr.transform.isPointOnMapSurface(zoomOutPoint) ? tr.unproject(zoomOutPoint) : void 0
 			}, { originalEvent: e }) };
 		}
 	}
@@ -22058,7 +22202,7 @@ var ClickZoomHandler = class {
 			map.easeTo({
 				duration: 300,
 				zoom: evaluateZoomSnap(this._tr.zoom + (e.shiftKey ? -1 : 1), map.getZoomSnap()),
-				around: this._tr.unproject(point)
+				around: this._tr.transform.isPointOnMapSurface(point) ? this._tr.unproject(point) : void 0
 			}, { originalEvent: e });
 		} };
 	}
@@ -22544,7 +22688,10 @@ var HandlerManager = class {
 		return this._el?.ownerDocument?.defaultView || window;
 	}
 	constructor(map, camera, options) {
-		this._terrainGestureAnchorElevation = null;
+		this._terrainGesture = {
+			inFlight: false,
+			anchorElevation: null
+		};
 		this.handleWindowEvent = (e) => {
 			this.handleEvent(e, `${e.type}Window`);
 		};
@@ -22729,7 +22876,7 @@ var HandlerManager = class {
 		const touchPitch = map.touchPitch = new TwoFingersTouchPitchHandler(map);
 		this._add("touchPitch", touchPitch);
 		if (options.interactive && options.touchPitch) map.touchPitch.enable(options.touchPitch);
-		const getCenter = () => map.project(map.getCenter());
+		const getCenter = () => this._camera.transform.centerPoint;
 		const mouseRotate = generateMouseRotationHandler(options, getCenter);
 		const mousePitch = generateMousePitchHandler(options);
 		const mouseRoll = generateMouseRollHandler(options, getCenter);
@@ -22833,14 +22980,18 @@ var HandlerManager = class {
 		this._updateMapTransform(combined, combinedEventsInProgress, combinedDeactivatedHandlers);
 		this._changes = [];
 	}
+	/**
+	* Applies a frame's combined handler deltas to the requested camera state and fires the movement
+	* events. A frame without a change only fires the events and takes no requested camera state, so a
+	* trailing frame that merely ends a handler leaves none behind for the next gesture to start from.
+	*/
 	_updateMapTransform(combinedResult, combinedEventsInProgress, deactivatedHandlers) {
-		const map = this._map;
-		const tr = this._camera.getTransformForUpdate();
-		const terrain = map.terrain;
-		if (!hasChange(combinedResult) && !(terrain && this._terrainMovement)) {
+		const terrain = this._map.terrain;
+		if (!hasChange(combinedResult)) {
 			this._fireEvents(combinedEventsInProgress, deactivatedHandlers, true);
 			return;
 		}
+		const tr = this._camera.getTransformForUpdate();
 		this._camera.stop(true);
 		const { panDelta, zoomDelta, bearingDelta, pitchDelta, rollDelta } = combinedResult;
 		let { around, aroundOnSurface } = this._resolveAround(combinedResult, terrain, tr);
@@ -22895,12 +23046,12 @@ var HandlerManager = class {
 	*/
 	_terrainGestureElevation(terrain, around, aroundOnSurface, tr, combinedEventsInProgress) {
 		if (!aroundOnSurface) return;
-		if (!this._terrainMovement && (combinedEventsInProgress.drag || combinedEventsInProgress.zoom)) {
+		if (this._terrainGesture.anchorElevation === null && (combinedEventsInProgress.drag || combinedEventsInProgress.zoom)) {
 			const anchor = tr.screenTerrainPointToMercatorCoordinate(around, terrain);
-			this._terrainGestureAnchorElevation = anchor ? anchor.z : null;
+			this._terrainGesture.anchorElevation = anchor ? anchor.z : void 0;
 		}
-		if (this._terrainGestureAnchorElevation === null) return;
-		const elevation = this._terrainGestureAnchorElevation;
+		const elevation = this._terrainGesture.anchorElevation;
+		if (elevation === null || elevation === void 0) return;
 		if (around.distSqr(tr.centerPoint) < .01) return;
 		if (elevation - tr.elevation >= TERRAIN_ANCHOR_MAX_CAMERA_ALTITUDE_FRACTION * (tr.getCameraAltitude() - tr.elevation)) return;
 		return elevation;
@@ -22920,25 +23071,21 @@ var HandlerManager = class {
 	_handleMapControls({ terrain, tr, deltasForHelper, preZoomAroundLoc, combinedEventsInProgress, panDelta }) {
 		const cameraHelper = this._camera.cameraHelper;
 		cameraHelper.handleMapControlsRollPitchBearingZoom(deltasForHelper, tr);
-		if (!terrain) {
-			cameraHelper.handleMapControlsPan(deltasForHelper, tr, preZoomAroundLoc);
+		if (!terrain && !cameraHelper.useGlobeControls && !tr.isPointOnMapSurface(deltasForHelper.around)) {
+			if (panDelta) tr.setCenter(tr.screenPointToLocation(tr.centerPoint.sub(panDelta)));
 			return;
 		}
-		if (cameraHelper.useGlobeControls) {
-			if (!this._terrainMovement && (combinedEventsInProgress.drag || combinedEventsInProgress.zoom)) {
-				this._terrainMovement = true;
-				this._camera.elevationFreeze = true;
-			}
+		if (!terrain) {
 			cameraHelper.handleMapControlsPan(deltasForHelper, tr, preZoomAroundLoc);
 			return;
 		}
-		if (!this._terrainMovement && (combinedEventsInProgress.drag || combinedEventsInProgress.zoom)) {
-			this._terrainMovement = true;
+		if (!this._terrainGesture.inFlight) {
+			this._terrainGesture.inFlight = true;
 			this._camera.elevationFreeze = true;
 			cameraHelper.handleMapControlsPan(deltasForHelper, tr, preZoomAroundLoc);
 			return;
 		}
-		if (deltasForHelper.aroundElevation === void 0 && combinedEventsInProgress.drag && this._terrainMovement && panDelta) {
+		if (!cameraHelper.useGlobeControls && deltasForHelper.aroundElevation === void 0 && combinedEventsInProgress.drag && panDelta) {
 			tr.setCenter(tr.screenPointToLocation(tr.centerPoint.sub(panDelta)));
 			return;
 		}
@@ -22973,10 +23120,12 @@ var HandlerManager = class {
 		for (const name in endEvents) this._fireEvent(name, endEvents[name]);
 		const stillMoving = isMoving(this._eventsInProgress);
 		const finishedMoving = (wasMoving || nowMoving) && !stillMoving;
-		if (finishedMoving && this._terrainMovement) {
+		if (finishedMoving && this._terrainGesture.inFlight) {
 			this._camera.elevationFreeze = false;
-			this._terrainMovement = false;
-			this._terrainGestureAnchorElevation = null;
+			this._terrainGesture = {
+				inFlight: false,
+				anchorElevation: null
+			};
 			const tr = this._camera.getTransformForUpdate();
 			if (this._map.getCenterClampedToGround()) tr.recalculateZoomAndCenter(this._map.terrain);
 			this._camera.applyUpdatedTransform(tr);
@@ -22990,14 +23139,19 @@ var HandlerManager = class {
 				inertialEase.freezeElevation = true;
 				this._map.easeTo(inertialEase, { originalEvent: originalEndEvent });
 			} else {
-				this._map.fire(new MapMovementEvent("moveend", { originalEvent: originalEndEvent }));
+				this._fireEvent("moveend", originalEndEvent);
 				if (shouldSnapToNorth(this._map.getBearing())) this._map.resetNorth();
 			}
 			this._updatingCamera = false;
 		}
 	}
+	/**
+	* Fires a movement event through the camera, whose evented parent is the map: the map's listeners
+	* see the event as before, and the camera's own `moveend` listener drops the requested camera state,
+	* so the next gesture starts from the rendered transform instead of the state this one ended in.
+	*/
 	_fireEvent(type, e) {
-		this._map.fire(new MapMovementEvent(type, e ? { originalEvent: e } : {}));
+		this._camera.fire(new MapMovementEvent(type, e ? { originalEvent: e } : {}));
 	}
 	_requestFrame() {
 		this._map.triggerRepaint();
@@ -23044,6 +23198,15 @@ var Camera = class extends Evented {
 			delete this._requestedCameraState;
 		});
 	}
+	/**
+	* @internal
+	* Hands the camera the map's terrain, or null when the map has none, and brings the center
+	* elevation up to date with it, see {@link Camera.applyTerrainChange}.
+	*/
+	setTerrain(terrain) {
+		this.terrain = terrain;
+		this.applyTerrainChange();
+	}
 	migrateProjection(newTransform, newCameraHelper) {
 		newTransform.apply(this.transform, true);
 		this.transform = newTransform;
@@ -23103,7 +23266,7 @@ var Camera = class extends Evented {
 	}
 	setVerticalFieldOfView(fov, eventData) {
 		if (fov != this.transform.fov) {
-			this.transform.setFov(fov);
+			this.applyTransformChange((tr) => tr.setFov(fov));
 			this.fire(new MapMovementEvent("movestart", eventData)).fire(new MapMovementEvent("move", eventData)).fire(new MapMovementEvent("moveend", eventData));
 		}
 		return this;
@@ -23340,14 +23503,15 @@ var Camera = class extends Evented {
 		this._zooming ||= easeHandler.isZooming;
 		this._easeId = options.easeId;
 		this._prepareEase(eventData, options.noMoveStart, currently);
-		if (this.terrain) this._prepareElevation(easeHandler.elevationCenter);
+		if (this.terrain) this._prepareElevation(easeHandler.elevationCenter, tr);
 		this._ease((k) => {
 			easeHandler.easeFunc(k);
-			if (this.terrain && !options.freezeElevation) this._updateElevation(k);
+			if (this.terrain && !options.freezeElevation) this._updateElevation(k, tr);
 			this.applyUpdatedTransform(tr);
 			this._fireMoveEvents(eventData);
 		}, (interruptingEaseId) => {
 			if (this.terrain && options.freezeElevation) this._finalizeElevation();
+			else this.elevationFreeze = false;
 			this._afterEase(eventData, interruptingEaseId);
 		}, options);
 		return this;
@@ -23360,23 +23524,37 @@ var Camera = class extends Evented {
 		if (this._pitching && !currently.pitching) this.fire(new MapMovementEvent("pitchstart", eventData));
 		if (this._rolling && !currently.rolling) this.fire(new MapMovementEvent("rollstart", eventData));
 	}
-	_prepareElevation(center) {
+	/**
+	* @internal
+	* Starts easing the center elevation: records where it stands on the transform the animation edits and
+	* samples the terrain under the map center the animation ends on.
+	* @param center - the map center when the animation ends
+	* @param tr - the transform the animation edits
+	*/
+	_prepareElevation(center, tr) {
 		this._elevationCenter = center;
-		this._elevationStart = this.transform.elevation;
-		this._elevationTarget = this.terrain.getElevationForLngLat(center, this.transform);
+		this._elevationStart = tr.elevation;
+		this._elevationTarget = this.terrain.getElevationForLngLat(center, tr);
 		this.elevationFreeze = true;
 	}
-	_updateElevation(k) {
-		if (this._elevationStart === void 0 || this._elevationCenter === void 0) this._prepareElevation(this.transform.center);
-		this.transform.setMinElevationForCurrentTile(this.terrain.getMinTileElevationForLngLatZoom(this._elevationCenter, this.transform.tileZoom));
-		const elevation = this.terrain.getElevationForLngLat(this._elevationCenter, this.transform);
+	/**
+	* @internal
+	* Eases the center elevation towards the terrain under `_elevationCenter`, on the transform the
+	* animation edits, so that `applyUpdatedTransform` carries it to the rendered transform.
+	* @param k - the animation's progress, 0 to 1
+	* @param tr - the transform the animation edits
+	*/
+	_updateElevation(k, tr) {
+		if (this._elevationStart === void 0 || this._elevationCenter === void 0) this._prepareElevation(tr.center, tr);
+		tr.setMinElevationForCurrentTile(this.terrain.getMinTileElevationForLngLatZoom(this._elevationCenter, tr.tileZoom));
+		const elevation = this.terrain.getElevationForLngLat(this._elevationCenter, tr);
 		if (k < 1 && elevation !== this._elevationTarget) {
 			const pitch1 = this._elevationTarget - this._elevationStart;
 			const pitch2 = (elevation - (pitch1 * k + this._elevationStart)) / (1 - k);
 			this._elevationStart += k * (pitch1 - pitch2);
 			this._elevationTarget = elevation;
 		}
-		this.transform.setElevation(interpolateFactory.number(this._elevationStart, this._elevationTarget, k));
+		tr.setElevation(interpolateFactory.number(this._elevationStart, this._elevationTarget, k));
 	}
 	_finalizeElevation() {
 		this.elevationFreeze = false;
@@ -23384,6 +23562,23 @@ var Camera = class extends Evented {
 	}
 	/**
 	* @internal
+	* Applies a change of the terrain under the center to the transform: the terrain was set or
+	* removed, or a DEM tile landed. The center keeps its place and the camera moves with the
+	* center's elevation, as it does on every rendered frame while nothing holds the elevation.
+	* While a gesture or an ease holds it this does nothing: the camera stays where the user put
+	* it and the hold's end re-solves zoom and center onto the new terrain without moving it.
+	* Nothing is in flight when this writes, so it writes the rendered transform, like the
+	* per-frame clamp; a requested camera state created here would outlive the call and the
+	* next gesture would start from it.
+	*/
+	applyTerrainChange() {
+		if (this.elevationFreeze) return;
+		const tr = this.transform;
+		tr.setMinElevationForCurrentTile(this.terrain ? this.terrain.getMinTileElevationForLngLatZoom(tr.center, tr.tileZoom) : 0);
+		if (this.getCenterClampedToGround()) tr.setElevation(this.terrain ? this.terrain.getElevationForLngLat(tr.center, tr) : 0);
+	}
+	/**
+	* @internal
 	* Called when the camera is about to be manipulated.
 	* If `transformCameraUpdate` is specified or terrain is enabled, a copy of
 	* the current transform is created to track the accumulated changes.
@@ -23447,6 +23642,19 @@ var Camera = class extends Evented {
 		}
 		this.transform.apply(finalTransform, false);
 	}
+	/**
+	* @internal
+	* Applies a change that is not itself a movement, such as new bounds, limits or field of view, the way
+	* any camera update is applied. A requested camera state created only for this change is dropped again,
+	* so a later movement cannot restore the old values.
+	*/
+	applyTransformChange(change) {
+		const hadRequestedCameraState = this._requestedCameraState !== void 0;
+		const tr = this.getTransformForUpdate();
+		change(tr);
+		this.applyUpdatedTransform(tr);
+		if (!hadRequestedCameraState) delete this._requestedCameraState;
+	}
 	_fireMoveEvents(eventData) {
 		this.fire(new MapMovementEvent("move", eventData));
 		if (this._zooming) this.fire(new MapMovementEvent("zoom", eventData));
@@ -23565,7 +23773,7 @@ var Camera = class extends Evented {
 		this._rolling = roll !== startRoll;
 		this._padding = !tr.isPaddingEqual(padding);
 		this._prepareEase(eventData, false);
-		if (this.terrain) this._prepareElevation(flyToHandler.targetCenter);
+		if (this.terrain) this._prepareElevation(flyToHandler.targetCenter, tr);
 		this._ease((k) => {
 			const s = k * S;
 			const scale = 1 / w(s);
@@ -23578,11 +23786,12 @@ var Camera = class extends Evented {
 				pointAtOffset = tr.centerPoint.add(offsetAsPoint);
 			}
 			flyToHandler.easeFunc(k, scale, centerFactor, pointAtOffset);
-			if (this.terrain && !options.freezeElevation) this._updateElevation(k);
+			if (this.terrain && !options.freezeElevation) this._updateElevation(k, tr);
 			this.applyUpdatedTransform(tr);
 			this._fireMoveEvents(eventData);
 		}, () => {
 			if (this.terrain && options.freezeElevation) this._finalizeElevation();
+			else this.elevationFreeze = false;
 			this._afterEase(eventData);
 		}, options);
 		return this;
@@ -25310,7 +25519,7 @@ var Map$1 = class extends Evented {
 	* ```
 	*/
 	setMaxBounds(bounds) {
-		this._camera.transform.setMaxBounds(LngLatBounds.convert(bounds));
+		this._camera.applyTransformChange((tr) => tr.setMaxBounds(LngLatBounds.convert(bounds)));
 		return this._update();
 	}
 	/**
@@ -25337,9 +25546,7 @@ var Map$1 = class extends Evented {
 		minZoom = minZoom === null || minZoom === void 0 ? defaultMinZoom : minZoom;
 		if (minZoom >= defaultMinZoom && minZoom <= this._camera.transform.maxZoom) {
 			const zoomBefore = this._camera.transform.zoom;
-			const tr = this._camera.getTransformForUpdate();
-			tr.setMinZoom(minZoom);
-			this._camera.applyUpdatedTransform(tr);
+			this._camera.applyTransformChange((tr) => tr.setMinZoom(minZoom));
 			this._update();
 			if (zoomBefore !== this._camera.transform.zoom) this.fire(new MapMovementEvent("zoomstart")).fire(new MapMovementEvent("zoom")).fire(new MapMovementEvent("zoomend")).fire(new MapMovementEvent("movestart")).fire(new MapMovementEvent("move")).fire(new MapMovementEvent("moveend"));
 			return this;
@@ -25379,9 +25586,7 @@ var Map$1 = class extends Evented {
 		maxZoom = maxZoom === null || maxZoom === void 0 ? defaultMaxZoom : maxZoom;
 		if (maxZoom >= this._camera.transform.minZoom) {
 			const zoomBefore = this._camera.transform.zoom;
-			const tr = this._camera.getTransformForUpdate();
-			tr.setMaxZoom(maxZoom);
-			this._camera.applyUpdatedTransform(tr);
+			this._camera.applyTransformChange((tr) => tr.setMaxZoom(maxZoom));
 			this._update();
 			if (zoomBefore !== this._camera.transform.zoom) this.fire(new MapMovementEvent("zoomstart")).fire(new MapMovementEvent("zoom")).fire(new MapMovementEvent("zoomend")).fire(new MapMovementEvent("movestart")).fire(new MapMovementEvent("move")).fire(new MapMovementEvent("moveend"));
 			return this;
@@ -25415,9 +25620,7 @@ var Map$1 = class extends Evented {
 		if (minPitch < defaultMinPitch) throw new Error(`minPitch must be greater than or equal to ${defaultMinPitch}`);
 		if (minPitch >= defaultMinPitch && minPitch <= this._camera.transform.maxPitch) {
 			const pitchBefore = this._camera.transform.pitch;
-			const tr = this._camera.getTransformForUpdate();
-			tr.setMinPitch(minPitch);
-			this._camera.applyUpdatedTransform(tr);
+			this._camera.applyTransformChange((tr) => tr.setMinPitch(minPitch));
 			this._update();
 			if (pitchBefore !== this._camera.transform.pitch) this.fire(new MapMovementEvent("pitchstart")).fire(new MapMovementEvent("pitch")).fire(new MapMovementEvent("pitchend")).fire(new MapMovementEvent("movestart")).fire(new MapMovementEvent("move")).fire(new MapMovementEvent("moveend"));
 			return this;
@@ -25447,9 +25650,7 @@ var Map$1 = class extends Evented {
 		if (maxPitch > maxPitchThreshold) throw new Error(`maxPitch must be less than or equal to ${maxPitchThreshold}`);
 		if (maxPitch >= this._camera.transform.minPitch) {
 			const pitchBefore = this._camera.transform.pitch;
-			const tr = this._camera.getTransformForUpdate();
-			tr.setMaxPitch(maxPitch);
-			this._camera.applyUpdatedTransform(tr);
+			this._camera.applyTransformChange((tr) => tr.setMaxPitch(maxPitch));
 			this._update();
 			if (pitchBefore !== this._camera.transform.pitch) this.fire(new MapMovementEvent("pitchstart")).fire(new MapMovementEvent("pitch")).fire(new MapMovementEvent("pitchend")).fire(new MapMovementEvent("movestart")).fire(new MapMovementEvent("move")).fire(new MapMovementEvent("moveend"));
 			return this;
@@ -25532,7 +25733,7 @@ var Map$1 = class extends Evented {
 	* @see [Render world copies](https://maplibre.org/maplibre-gl-js/docs/examples/render-world-copies/)
 	*/
 	setRenderWorldCopies(renderWorldCopies) {
-		this._camera.transform.setRenderWorldCopies(renderWorldCopies);
+		this._camera.applyTransformChange((tr) => tr.setRenderWorldCopies(renderWorldCopies));
 		return this._update();
 	}
 	/** Sets or clears the callback overriding how the map constrains the viewport's lnglat and zoom to respect the longitude and latitude bounds.
@@ -25550,7 +25751,7 @@ var Map$1 = class extends Evented {
 	* @see [Customize the map transform constrain](https://maplibre.org/maplibre-gl-js/docs/examples/customize-the-map-transform-constrain/)
 	*/
 	setTransformConstrain(constrain) {
-		this._camera.transform.setConstrainOverride(constrain);
+		this._camera.applyTransformChange((tr) => tr.setConstrainOverride(constrain));
 		return this._update();
 	}
 	/**
@@ -25622,7 +25823,7 @@ var Map$1 = class extends Evented {
 	isRotating() {
 		return this._camera.isRotating() || this._handlers?.isRotating() || false;
 	}
-	_createDelegatedListener(type, layerIds, listener) {
+	_createDelegates(type, layerIds, listener) {
 		if (type === "mouseenter" || type === "mouseover") {
 			let mousein = false;
 			const mousemove = (e) => {
@@ -25638,12 +25839,8 @@ var Map$1 = class extends Evented {
 				mousein = false;
 			};
 			return {
-				layers: layerIds,
-				listener,
-				delegates: {
-					mousemove,
-					mouseout
-				}
+				mousemove,
+				mouseout
 			};
 		} else if (type === "mouseleave" || type === "mouseout") {
 			let mousein = false;
@@ -25662,12 +25859,8 @@ var Map$1 = class extends Evented {
 				}
 			};
 			return {
-				layers: layerIds,
-				listener,
-				delegates: {
-					mousemove,
-					mouseout
-				}
+				mousemove,
+				mouseout
 			};
 		} else {
 			const delegate = (e) => {
@@ -25679,17 +25872,14 @@ var Map$1 = class extends Evented {
 					delete e.features;
 				}
 			};
-			return {
-				layers: layerIds,
-				listener,
-				delegates: { [type]: delegate }
-			};
+			return { [type]: delegate };
 		}
 	}
-	_saveDelegatedListener(type, delegatedListener) {
+	_addDelegatedListener(type, delegatedListener) {
 		this._delegatedListeners ||= {};
 		this._delegatedListeners[type] ||= [];
 		this._delegatedListeners[type].push(delegatedListener);
+		for (const event in delegatedListener.delegates) this.on(event, delegatedListener.delegates[event]);
 	}
 	_removeDelegatedListener(type, layerIds, listener) {
 		if (!this._delegatedListeners?.[type]) return;
@@ -25706,9 +25896,12 @@ var Map$1 = class extends Evented {
 	on(type, layerIdsOrListener, listener) {
 		if (listener === void 0) return super.on(type, layerIdsOrListener);
 		const layerIds = typeof layerIdsOrListener === "string" ? [layerIdsOrListener] : layerIdsOrListener;
-		const delegatedListener = this._createDelegatedListener(type, layerIds, listener);
-		this._saveDelegatedListener(type, delegatedListener);
-		for (const event in delegatedListener.delegates) this.on(event, delegatedListener.delegates[event]);
+		const delegatedListener = {
+			layers: layerIds,
+			listener,
+			delegates: this._createDelegates(type, layerIds, listener)
+		};
+		this._addDelegatedListener(type, delegatedListener);
 		return { unsubscribe: () => {
 			this._removeDelegatedListener(type, layerIds, listener);
 		} };
@@ -25716,16 +25909,15 @@ var Map$1 = class extends Evented {
 	once(type, layerIdsOrListener, listener) {
 		if (listener === void 0) return super.once(type, layerIdsOrListener);
 		const layerIds = typeof layerIdsOrListener === "string" ? [layerIdsOrListener] : layerIdsOrListener;
-		const delegatedListener = this._createDelegatedListener(type, layerIds, listener);
-		for (const key in delegatedListener.delegates) {
-			const delegate = delegatedListener.delegates[key];
-			delegatedListener.delegates[key] = (...args) => {
+		const delegatedListener = {
+			layers: layerIds,
+			listener,
+			delegates: this._createDelegates(type, layerIds, (e) => {
 				this._removeDelegatedListener(type, layerIds, listener);
-				delegate(...args);
-			};
-		}
-		this._saveDelegatedListener(type, delegatedListener);
-		for (const event in delegatedListener.delegates) this.once(event, delegatedListener.delegates[event]);
+				listener.call(this, e);
+			})
+		};
+		this._addDelegatedListener(type, delegatedListener);
 		return this;
 	}
 	off(type, layerIdsOrListener, listener) {
@@ -26155,9 +26347,7 @@ var Map$1 = class extends Evented {
 			this.terrain = null;
 			this.painter.renderToTexture = null;
 			this.painter.destroyRTTResources();
-			this._camera.terrain = null;
-			this._camera.transform.setMinElevationForCurrentTile(0);
-			if (this.getCenterClampedToGround()) this._camera.transform.setElevation(0);
+			this._camera.setTerrain(null);
 		} else {
 			const tileManager = this.style.tileManagers[options.source];
 			if (!tileManager) throw new Error(`cannot load terrain, because there exists no source with ID: ${options.source}`);
@@ -26170,9 +26360,7 @@ var Map$1 = class extends Evented {
 			if (this.terrain) this.terrain.destroy();
 			this.terrain = new Terrain(this.painter, tileManager, options, this._terrainSkirtLength);
 			this.painter.renderToTexture = new RenderToTexture(this.painter, this.terrain);
-			this._camera.terrain = this.terrain;
-			this._camera.transform.setMinElevationForCurrentTile(this.terrain.getMinTileElevationForLngLatZoom(this._camera.transform.center, this._camera.transform.tileZoom));
-			this._camera.transform.setElevation(this.terrain.getElevationForLngLat(this._camera.transform.center, this._camera.transform));
+			this._camera.setTerrain(this.terrain);
 			this._terrainDataCallback = (e) => this._handleTerrainDataEvent(e, options.source);
 			this.style.on("data", this._terrainDataCallback);
 		}
@@ -26190,10 +26378,9 @@ var Map$1 = class extends Evented {
 			this.terrain.resetElevationCache();
 			this.style.triggerSymbolPlacement();
 		}
-		if (isTerrainSourceEvent && event.tile) this.painter.markTerrainDepthDirty();
-		if (isTerrainSourceEvent && event.tile && !this._camera.elevationFreeze) {
-			this._camera.transform.setMinElevationForCurrentTile(this.terrain.getMinTileElevationForLngLatZoom(this._camera.transform.center, this._camera.transform.tileZoom));
-			if (this.getCenterClampedToGround()) this._camera.transform.setElevation(this.terrain.getElevationForLngLat(this._camera.transform.center, this._camera.transform));
+		if (isTerrainSourceEvent && event.tile) {
+			this.painter.markTerrainDepthDirty();
+			this._camera.applyTerrainChange();
 		}
 		if (!event.tile) return;
 		if (event.source?.type === "image") {
@@ -27150,12 +27337,16 @@ var Map$1 = class extends Evented {
 	getCanvas() {
 		return this._canvas;
 	}
+	/**
+	* @internal
+	* The viewport in whole CSS pixels, shared by the canvas, the painter and the transform.
+	*/
 	_containerDimensions() {
 		let width = 0;
 		let height = 0;
 		if (this._container) {
-			width = this._container.clientWidth || 400;
-			height = this._container.clientHeight || 300;
+			width = Math.floor(this._container.clientWidth) || 400;
+			height = Math.floor(this._container.clientHeight) || 300;
 		}
 		return [width, height];
 	}
@@ -27243,11 +27434,19 @@ var Map$1 = class extends Evented {
 		this._container.removeEventListener("scroll", this._onMapScroll, false);
 		this._container.classList.remove("maplibregl-map");
 	}
+	/**
+	* @internal
+	* Sizes the backing store to whole device pixels and the CSS box to cover exactly that many, so
+	* the compositor never rescales the canvas. A pixel ratio can sit a fraction below a whole
+	* number, where truncating the count would cost a whole pixel per axis.
+	*/
 	_resizeCanvas(width, height, pixelRatio) {
-		this._canvas.width = Math.floor(pixelRatio * width);
-		this._canvas.height = Math.floor(pixelRatio * height);
-		this._canvas.style.width = `${width}px`;
-		this._canvas.style.height = `${height}px`;
+		const canvasWidth = Math.round(pixelRatio * width);
+		const canvasHeight = Math.round(pixelRatio * height);
+		this._canvas.width = canvasWidth;
+		this._canvas.height = canvasHeight;
+		this._canvas.style.width = `${canvasWidth / pixelRatio}px`;
+		this._canvas.style.height = `${canvasHeight / pixelRatio}px`;
 	}
 	/**
 	* @internal