maplibre-gl

✨ Features and improvements

• Stop the scale control forcing a synchronous layout and rewriting its DOM on every frame of a pan or zoom (#8403) (by @cherenkov)
• Speed up merging adjacent symbol-placement: line features that share a label, which took time quadratic in the number of features that chain together (#8436) (by @cherenkov)
• Convert the fill-extrusion-rounded-corner-distance rounding distance to tile units once per tile instead of once per feature (#8435) (by @cherenkov)

🐞 Bug fixes

• Redraw terrain depth when DEM tiles arrive so occluded symbols and markers stay hidden (#8447) (by @ArcSolver)
• Fix raster tiles getting stuck at the start of a fade-in until the map moves. (#8430) (by @Kanahiro)
• Fix fill-extrusion-vertical-gradient disappearing over 3D terrain, where the gradient was computed from the extrusion's height above sea level instead of its own height (#8410) (by @ArcSolver)
• Fix missing map layers after custom layer rendering (#8406) (by @birkskyum)
• Fix 3D terrain reading elevation from the wrong part of a parent DEM tile while the deepest DEM tile is still loading (#8407) (by @ArcSolver)
• Align 3D terrain DEM sampling with hillshade and color-relief at cell centres (#8420) (by @ArcSolver)
• Fix setting one paint, light or sky property transitioning every property alongside it, which delayed idle even when nothing could animate and restarted transitions that were still running (#8376) (by @cherenkov)
• Fix fill-extrusion-rounded-corner-distance rounding every feature twice, which over-rounded the corners and inflated the vertex count (#8429) (by @cherenkov)
• Fix Map#project returning an incorrect on-screen point for a location behind the camera. It now returns a point outside the viewport, on the side through which the location left the screen, so DOM markers and popups are moved off-screen as expected. (#8292) (by @schickm)

✨ Features and improvements

• Improved support for drawing the letters of Devanagari, Khmer, Burmese and the other complex scripts and also draws Arabic and Hebrew labels correctly without loading a right-to-left text plugin, which deprecates setRTLTextPlugin and getRTLTextPluginStatus (#8343) (by @HarelM)
• Read sprite and image pixels back through an OffscreenCanvas where available, removing a main-thread stall of tens of milliseconds on GPU-accelerated browsers when a sprite loads (#8339) (by @cherenkov)
• Skip clipping masks for layers hidden at the current zoom and stop re-binding dynamic buffers on cached vertex array binds, removing redundant WebGL calls every frame (#8369) (by @johncarmack1984)
• Re-render at most one stale terrain drape per frame and keep drapes that differ only by zoom while the map moves, so a finger lift over terrain no longer re-renders every tile at once (#8368) (by @johncarmack1984)

🐞 Bug fixes

• Fix setStyle() throwing while terrain is still loading because an intermediate render tried to compile a terrain shader before the replacement style initialized its projection (#6824) (by @miakh)
• Fix queued GeoJSON updateData property removals throwing after geometry-only updates or retaining previously updated values (#8372) (by @jokrasno)
• Treat camera options passed as undefined as not given in jumpTo, easeTo and flyTo; they were coerced to NaN (#8373) (by @vlumi)
• Fix a Not implemented. error that broke panning and zooming when the projection was changed while the camera was moving, on maps with terrain enabled or a transformCameraUpdate callback (#8351) (by @lazerg)
• Fix a map created inside a hidden container staying at the 400x300 fallback size when the container is shown before the resize observer's first notification is delivered (#8277) (by @spliffone)
• Fix MercatorTransform throwing when it is resized to a zero width, and skip the matrix calculation of every projection while the transform has a zero width or height (#8374) (by @avosa)
• Fix every style update opening a redundant sky and light transition, which kept idle from firing for the transition duration after the map was otherwise done, and could ease the sky and the light on a different curve from the layers (#8348) (by @cherenkov)
• Fix DOM sanitization for iframe and srcdoc (#8396) (by @HarelM)

✨ Features and improvements

• Add map.getStyleUrl(), which returns the URL the style was loaded from, or null when the style was given as an object (#7109) (by @bradymadden97 and @giswqs)
• Sample terrain render-to-texture output through mipmaps with trilinear filtering, so draped layers stop shimmering and aliasing at high pitch (#8328, continues #7673) (by @AveryanAlex)
• Build the Intl.Segmenter instances used for text shaping on first use instead of at import, shaving several milliseconds off loading MapLibre on the main thread (#8337) (by @cherenkov)
• Link shader programs before reading their compile status, so the driver can overlap the compiles and the main thread waits less on shader compilation (#8338) (by @cherenkov)
• Build the default Marker pin once and clone it per marker, so creating many default markers takes roughly half the constructor time (#8340) (by @cherenkov)
• Add SDF rendering support for fill patterns, using fill-color as the foreground color (#7747) (by @bradymadden97 and @deniial00)
• Warn once when the canvas is clamped to maxCanvasSize, which previously lowered the rendered resolution silently (#8200) (by @str0kes)

🐞 Bug fixes

• Fix a marker's popup jumping to another world copy when the marker is moved across the antimeridian on a zoomed-out map (#5655, #8326, continues #5956) (by @yuiseki)
• Fix terrain drape textures not being refreshed after zoom changes, causing stale rendering at the new zoom level (#8251) (by @patte)
• Fix a gap between the sky and the ground at high pitch while globe transitions to mercator (#7382) (by @birkskyum)
• Treat an empty tile response (e.g. HTTP 204) as no data: raster-DEM tiles now load without elevation instead of failing with a dem dimension mismatch error, and empty raster tiles render as transparent (#1551) (by @clement-igonet)
• Validate the before layer in map.moveLayer before reordering, so passing the id of a layer that does not exist leaves the layer order untouched instead of dropping the moved layer out of it (#8301) (by @lazerg)
• Fix visible seams between hillshade tiles when using linear interpolation. (#8302) (by @Turbo87)
• Fix the map freezing when a render task throws an error (#6093) (by @UberMouse)
• Fix getCameraAltitude() returning NaN under globe and vertical-perspective, which disabled marker terrain occlusion and the camera terrain check; the altitude now follows the sphere (#6584) (by @bigmistqke and @patte)
• Draw an elevated symbol on globe when the symbol itself is in view but the ground under it is behind the horizon; occlusion now follows the line of sight to the elevated point (#8253) (by @clement-igonet)
• Fix setTiles producing stale tile URLs when loadTile runs in the same frame (#8323) (by @johncarmack1984 and @nostrorom)
• Keep the tile under an elevated symbol from being culled near the horizon, so a symbol with a large symbol-height-offset stays visible until it is behind the planet (#8316) (by @clement-igonet)

✨ Features and improvements

• Support the style specification's font-faces property, with map.setFontFaces and map.getFontFaces and improve complex script languages such as Devanagari, Khmer, Burmese and Hebrew (#8237) (by @HarelM)
• Wrap Thai, Khmer, Burmese, Lao, Tibetan, Javanese and Balinese labels at word boundaries instead of running them on in one line, which applies to every style whether or not it declares font-faces (#8237) (by @HarelM)
• Throw GPUInitializationError from the Map constructor when the WebGL2 context cannot be created, instead of firing an error event no listener can catch and returning a partially constructed map (#8066) (by @johncarmack1984)
• Allow adding an image source without a url. The source starts empty and makes no network request; call updateImage({image}) or updateImage({url}) later to show an image (#8167) (by @mondsichtung)
• Skip symbol re-placement when its inputs are unchanged, so repaints from animated style images or custom layers cost a single frame (#8208) (by @lucaswoj)
• Add Style#triggerSymbolPlacement, which re-places symbols when something the map cannot see for itself has moved them (#8208) (by @lucaswoj)
• Make {validate: false} skip the style snapshot the style setters only build as error context, so adding layers one at a time no longer serializes the whole style on every call (#8259) (by @lazerg)

🐞 Bug fixes

• Disable the navigation control's zoom-out button when viewport constraints prevent zooming out further (#5316) (by @miakh)
• Keep a vector tile's etag when the tile is reloaded after a style change, so the next expiry refresh can still skip unchanged tiles (#3309) (by @johncarmack1984)
• Fix project() and queryTerrainElevation disagreeing with the rendered terrain surface when the elevation lookup sampled a different DEM zoom than the drawn mesh (#8212) (by @johncarmack1984)
• Draw numbers (e.g. “21” in “반포대로21길”) and short uppercase codes (e.g. “A1”) upright in vertical line labels instead of rotating them along the line (#5404) (by @NEKOYASAN)
• Fix the camera jumping at the end of a pan or zoom gesture on terrain by sampling the center elevation from the rendered terrain surface (#7989, #3982) (by @johncarmack1984)
• Ensure style state defaults are serialized (#8263) (by @hiddewie)

✨ Features and improvements

• Add support for symbol-height-offset and symbol-height-anchor layout properties, which raise icons and text above the map. symbol-height-anchor selects whether the offset is measured from the terrain surface (ground, the default) or from the zero elevation datum (absolute) (#7827) (by @HarelM)
• Pick terrain coordinates with a CPU raycast against the DEM instead of a coords framebuffer readback: full DEM resolution, no GPU stall on pointer events, and about 4MB less GPU memory (#7640) (by @johncarmack1984)

🐞 Bug fixes

• Fix labels briefly appearing too large when zooming out several levels at once (e.g. a scroll-wheel or pinch fling) with a zoom-dependent text-size/icon-size (#8175) (by @mondsichtung)
• Fix globe tile selection measuring distances from the ground point below the camera instead of the camera itself, refining some views past the requested zoom and leaving others coarser (#8187) (by @Alchez)
• Fix the style's center, zoom, bearing, pitch and roll being ignored when the map was created with a minZoom or minPitch option, since applying those limits marked the transform as modified (#5932)
• Upload the color-relief DEM texture once per tile instead of on every frame (#8209)

✨ Features and improvements

• Add experimental ImageSource.setWarp and ImageSource.getWarp, choosing between a auto, perspective and a flat warp of the image (#8172) (by @HarelM)

🐞 Bug fixes

• Fixed incorrect image source on projection on globe view (#8172) (by @HarelM)
• Fix the globe zooming itself in when panned away from a pole at the minimum zoom, where the latitude zoom compensation was applied on top of the constrain's own clamp (#8182) (by @mondsichtung)
• Fix dragging the globe from the empty space around it, which barely moved the map and often in the wrong direction (#8174) (by @mondsichtung)

🐞 Bug fixes

• Fix DOM.sanitize leaving dangerous attributes behind when multiple consecutive attributes are present. Iterating the live NamedNodeMap from elem.attributes while calling removeAttribute skipped the attribute directly after a removed one, so a second dangerous attribute (for example an ontoggle on a <details open> element) could survive sanitisation and later execute (#8189) (by @0xKirisame)
• Give custom layers the live globe transition in CustomRenderMethodInput.defaultProjectionData.projectionTransition, which was hardcoded to 1 for the whole globe/mercator transition, so a custom layer jumped straight to the fully bent globe while every other layer eased (#8169) (by @mondsichtung)

✨ Features and improvements

• Avoid a per-query Array.sort() in cross-tile symbol matching (TileLayerIndex.findMatches), claiming the lowest-index unclaimed candidate in a single pass instead; reduces main-thread symbol-placement cost on dense/coincident symbol layers (#7797) (by @pholmstr)
• Use texelFetch for exact DEM and color-relief elevation stop lookups instead of normalized texture coordinate arithmetic (#7640) (by @johncarmack1984)
• Make default draggable markers keyboard-focusable and movable with the arrow keys (1 px per press, 10 px with Shift); custom marker elements stay application-owned (#8020) (by @smmariquit)

🐞 Bug fixes

• Fix a permanent frame rate degradation after switching styles: every sprite reload marked its images as updated forever, making every in-view tile re-check and re-upload them on every frame. Also stop leaking the images of a replaced sprite, which were never removed from the image manager (#8052) (by @HarelM)
• Prevent a rejected missing style image resolver from blocking successfully resolved images in the same batch (#8146) (by @birkskyum)
• Explicitly request no browser color management when decoding raster-DEM tiles so their RGB-encoded elevation values are not changed (what would otherwise happen with gfx.color_management.mode = 1 in Firefox) (#8125) (by @tnikkel)
• Let an abort reach an image or raster tile load that is still awaiting its transformRequest, so ImageSource.updateImage no longer loses the image it was just handed and an aborted tile is no longer fetched (#8071) (by @mondsichtung)
• Fix raster tiles fading in again when they are reloaded, briefly flashing the map background, most visibly when switching projection (#8106) (by @mondsichtung)
• Fix globe panning inverting and stalling near and across the poles by rotating the globe with a versor, keeping the drag direction consistent at every latitude. Panning also eases off as the cursor approaches the edge of the globe and continues past it, instead of stopping. The bearing is preserved while panning, as before (#5296) (by @jcolot)
• Fix fill-extrusion-rounded-corner-distance producing spikes: corner arcs now land on the integer tile grid, and corners created by tile clipping are left sharp (#8153) (by @HarelM)
• Fix a gesture which was held still before being released still flinging the map (#1303) (by @zdila)

✨ Features and improvements

• Make fired/listened map events typed. This means that map.on("something", ...) (and once, listens) will now give you an typescript error and better autocomplete. If you relied on firing/listening custom events via the map, this still works via the escape hatches map.fire("something" as any) -> map.on("something" as any, ...) (#8072) (by @CommanderStorm)
• Let a StyleImageInterface give a {renderWithWebGL} callback as its data, an escape hatch for plugin developers and advanced users that renders a style image on the GPU instead of moving its pixels through the CPU. Nothing new is possible that pixels could not already express, but an image that changes often, such as an animated icon, gets more performant (#7954) (by @lucaswoj)
• Use integer vertex attributes for packed line data instead of float conversion (#7640) (by @johncarmack1984)
• Use integer vertex attributes for packed circle, heatmap, symbol, and fill-extrusion data instead of float conversion (#7640, #8143) (by @johncarmack1984)
• Redesign benchmarks to use vitest bench capabilities and remove custom build for benchmarks code (#982) (by @johncarmack1984)

🐞 Bug fixes

• Fix terrain pan/zoom gestures losing the grabbed terrain point: gestures are now solved against the elevation of the terrain under the gesture instead of the frozen center elevation, so terrain under the pointer/fingers no longer slips during moving-centroid pinches and drags (#8067) (by @StrawberryJam22)
• Fix ImageSource, VideoSource and CanvasSource leaking a GPU texture on every image update and on removal, and a resized texture losing its wrap and filter settings (#8094) (by @mondsichtung)
• Fix map.queryRenderedFeatures() sometimes causing "Out of bounds" error due to race condition while loading tile data (#8064) (by @smvjohansenbouvet)
• Fix zooming the globe with the scroll wheel or a two-finger pinch drifting away from the pointer while the globe is small on screen, instead of keeping the location under the pointer as it does when zoomed in (#8095) (by @mondsichtung)
• Fix projective rendering for non-parallelogram image source quads (#7887) (by @i4innovationnet)

✨ Features and improvements

• Add the fill-extrusion-rounded-corner-distance layout property, which replaces each fill-extrusion corner with an arc spanning the given distance (in meters) along the adjacent edges. The distance is clamped to 20% of each adjacent edge's length so that short edges don't collapse, and near-straight corners (turns below 5°) are left untouched. Defaults to 0, which keeps corners sharp (#7934) (by @CommanderStorm)
• Improve Mercator rendering performance by skipping a redundant clipping mask border pass (#8038) (by @DoFabien)
• Add a docker-compose service to build and serve the examples (#57) (#8026) (by @clement-igonet)

🐞 Bug fixes

• Fix rare rendering bug causing two adjacent layers with different data driven property set to render wrong (#8068) (by @CommanderStorm)
• Improve terrain elevation sampling performance by caching DEM tile lookups and coordinate transforms within each render (#8025) (by @DoFabien)

✨ Features and improvements

• Add support for updating an ImageSource with an already-decoded image (HTMLImageElement, HTMLCanvasElement, ImageBitmap or ImageData) directly via ImageSource.updateImage({image}), skipping the network request (#7944) (by @mondsichtung)
• Add GeoJSONSource.getClusterOptions to get a source's current cluster options (cluster, clusterMaxZoom, clusterRadius) (#7948) (by @lazerg)
• Support global-state expressions in sky.*, light.* and projection.type properties (#7966, #7967, #7968) (by @CommanderStorm)
• Add MapOptions.rotateSpeed and MapOptions.pitchSpeed, the degrees the bearing/pitch change per pixel dragged (#7949) (by @clement-igonet)
• Show a grab cursor over draggable markers, including on non-interactive maps (#8019) (by @hugosmoreira)

🐞 Bug fixes

• Use role=img for non-interactive default markers and role=button when they become interactive (#7790) (by @cat0825)
• Fix an error thrown when a paint property transitions between arrays of different length (#6606) (by @HarelM)
• Fix renderer crash when RasterTileSource.setTiles/setUrl is called while the source contains errored tiles (#7911) (by @lazerg)
• Fix 3D buildings disappearing when the camera pitches up to look near the horizon, by growing tile-culling bounds as the frustum's bottom edge (from pitch and FOV) approaches horizontal (#7633) (by @clement-igonet)
• Fix globe latitude precision on some GPUs (e.g. Mali) by reformulating the mercator-to-sphere Y coordinate algebraically (exp + rational arithmetic instead of atan/sin/cos), avoiding float32 cancellation and imprecise hardware transcendentals near the equator; the runtime GPU atan-error measurement/correction this superseded has also been removed (#7419) (by @clement-igonet)
• Fix a race in RasterTileSource.loadTile and ImageSource.load where a tile/image aborted during an awaited transformRequest passed an undefined AbortController into the image request queue, crashing it with TypeError: Cannot read properties of undefined (reading 'signal') (#8004) (by @jan-grzybek)
• Fix setTerrain not destroying the previously active terrain when switching to a new configuration, which leaked its GPU resources and left the old source still configured as a terrain source (#7990) (by @lazerg)
• Fix fill and line layers being rendered twice near the antimeridian on globe when looking at poles or when zoomed out (#6248) (by @pabueco)

The following incorporates all the pre-releases for version 6 changes. Check-out our migration guide from v5 to v6 for more information.

✨ Features and improvements

• ⚠️ Switch to an ESM-only distribution (maplibre-gl.mjs). The UMD bundles (maplibre-gl.js, maplibre-gl-csp.js) are no longer published. The CSP-specific bundle is also dropped: the ESM build loads its worker as a real URL, so worker-src blob: is no longer required. Consumers using <script src=".../maplibre-gl.js"> must switch to <script type="module">, and consumers using import maplibregl from 'maplibre-gl' must switch to import * as maplibregl from 'maplibre-gl' or named imports. See the docs ESM section or our migration guide for migration steps. (#6254) (by @birkskyum)
• ⚠️ Interpolate the light position in spherical coordinates instead of cartesian ones, so that a transition keeps its radial distance. (#7919) (by @HarelM)
• ⚠️ styleimagemissing is now a notify-only event instead of the previous callback that allowed to provide an image. This aligns the event with standard event semantics (notify, not resolve). Use Map.setMissingStyleImageResolver to on-demand supply images instead via an function that can now also be async. (#7892) (by @birkskyum)
• ⚠️ Map now composes a Camera instead of extending it (Map extends Evented directly and forwards the camera API). The internal map.transform was removed — use map's public API instead or open a PR if you need something that's not exposed. Removed the internal transform.getMatrixForModel helper (#7800) (by @HarelM)
• ⚠️ All map events are now real classes that are instantiated when they are fired. Renamed the Maps' BoxZoom handler from MapLibreZoomEvent to MapBoxZoomEvent, added the rollstart/roll/rollend and style.load (as MapStyleLoadEvent) events to MapEventType, and added event classes and type-map for Marker, Popup, GeolocateControl and FullscreenControl. Removed MapDataEvent: the data/dataloading/dataabort events are now MapSourceDataEvent | MapStyleDataEvent, so source data events carry the full source info (sourceId, tile, sourceDataType, …). Added MapMovementEvent as the type for all camera-transition events (move/zoom/rotate/pitch/roll/drag and their start/end variants). Evented is now generic over an event-type map (Evented<EventType>) and is abstract, so subclasses get strongly-typed on/once/off automatically without re-declaring overloads — this also types the events on Camera/Style (via MapEventType) and on the sources (via the new SourceEventType) (#7789) (by @HarelM)
• ⚠️ Update maplibre-gl-style-spec to version 25, which now throws an error with warning severity instead of silently failing on encoutering legacy expressions (#7792) (by @HarelM)
• ⚠️ Removed the remaining mapbox references in the code and in the tests. This changes the #pragma mapbox to #pragma maplibre in case you have shader code that relied on it. (#7761) (by @HarelM)
• ⚠️ zoomLevelsToOverscale default value was changed to 4 to support better handling of high level zoom with dense labels. This might have a side effect of changing a bit the results of queryRenderedFeatures and some rendering of polygon center label. To revert this change, set the value to undefined (#7537) (by @HarelM)
• ⚠️ Remove the second parameter from GeoJSONSource.setData (waitForCompletion) and remove the return value of this to allow future changes to the API (#7538) (by @HarelM)
• ⚠️ The TypeScript target has been updated to ES2022. This results in smaller bundles and improved runtime performance by relying on modern JavaScript features and reducing transpilation. Consumers targeting browsers or using some tooling released before 2022 may need to transpile MapLibre or update. This change also aligns all internal build configurations to a single target instead of ES2016 + ES2019, avoiding inconsistencies in emitted code. (#7404) (by @CommanderStorm)
• ⚠️ WebGL (v1) support has been removed; WebGL2 is now required. In practical terms, this will not change how you interact with the map. This enables performance improvements (e.g. line opacity), Terrain3D enhancements, and several bug fixes. WebGL2 support has been widely available for years, and usage of the legacy path had plateaued, so maintaining it no longer justified the added complexity. To ease this breaking change, we have also refactored how we handle the case that no webgl is avaliable (e.g. due to browser restrictions). You can now listen to the webgl error via .on("error"). See caniuse.com/webgl2 for ecosystem support and our RFC for details. (#7453) (by @CommanderStorm)
• ⚠️ Support geojson nested objects, this is a breaking change as it encodes __$json__ before properties that used to be an object. It also parses them back, but this is still a breaking change if you assumed this bug existed. (#6992) (by HarelM)
• ⚠️ Improve types for {get,set}LayoutProperty, {get,set}PaintProperty to be the actual type instead of string/any (#7481) (by @CommanderStorm)
• ⚠️ Refactored the Hash-based location control (the option that syncs map state to the URL like #map=5/1/2) to use URLSearchParams internally. This improves extensibility for custom use cases, but may break existing code that relies on the previous implementation. It also changes how certain edge cases are parsed—for example, strings like #10%2F3.00%2F-1.00 are now accepted, and hashes like #foo are normalized to #foo=. (#7073) (by @CommanderStorm)
• Validate the terrain passed to map.setTerrain, which was previously applied unchecked (#7941) (by @HarelM)
• Improve runtime error warnings to point at the offending style location (e.g. layers[3].paint.line-color, layers[3].filter) instead of just logging the bare error message (#7869) (by @CommanderStorm)
• Improve terrain render-to-texture preparation performance by skipping sources that are not rendered to terrain textures (#7863) (by @DoFabien)
• Add Map.setMissingStyleImageResolver for resolving missing style images with sync or async callbacks (#7850) (by @birkskyum)
• Add RasterTileSource#setPremultiplyAlpha(false) to preserve raw RGBA tile values when alpha is used for data instead of opacity (#7235) (by @plantain).
• Drop the archived @mapbox/whoots-js dependency by inlining its single getTileBBox helper (#7838) (by @qorexdevs)
• Debounce setImages broadcast to once per animation frame, fixing O(n²) serialization overhead when adding many images (#7614) (by @bradymadden97)
• Improve terrain rendering performance by avoiding unnecessary terrain data lookups during Mercator render-to-texture passes (#7833) (by @DoFabien)
• Reduce allocation pressure while constructing DEM data and sampling terrain elevations (#7814) (by @DoFabien)
• Reuse terrain DEM texture when preparing terrain (#7813) (by @DoFabien)
• Add fill-layer-opacity and line-layer-opacity paint properties, which apply opacity to the entire layer output uniformly (#7570) (by @CommanderStorm)
• Build main and worker in same build context to extract shared chunk (#7745) (by @dangkyokhoang)
• Revert the line-opacity-driven offscreen rendering introduced in #7490 (#7764) (by @CommanderStorm). The overlap-artefact fix is now driven by line-layer-opacity instead.
• Improve ProjectionData matrix backing types for renderer and custom layer projection matrices (#6316) (by @cat0825)
• Optimization: vertex shader opacity culling for lines and fills #7711 (by @xavierjs)
• Use a shared FBO for the terrain cache render to texture #7637 (by @xavierjs)
• Use flat to opt out of interpolation for constant shader varyings (#7661) (by @birkskyum)
• Replace texImage2D with texStorage2D for immutable textures (#7643) (by @birkskyum)
• Enable mipmaps for non-power-of-two raster tiles, reducing aliasing at high pitch (#7641) (by @birkskyum)
• Use GLSL ES 3.00 layout qualifiers for vertex attribute locations, replacing runtime bindAttribLocation calls (#7644) (by @birkskyum)
• Adopt isolatedDeclarations and switch dts emitter from tsgo to oxc (#7566) (by @birkskyum)
• Improve 3D terrain performance (#7549) (by @lucaswoj)
• Replace dts-bundle-generator with rolldown-plugin-dts for 78.2x faster .d.ts generation. (#7564) (by @birkskyum)
• Replace ts-node with Node 24's native TypeScript support for build scripts. (#7565) (by @birkskyum)
• Bump typescript to v7 beta - 3.5x faster typecheck (#7556) (by @birkskyum)
• Add a new map creation option, terrainSkirtLength, which allows the removal of visually unappealing vertical artifacts when using a terrain along with a transparent background (#7523) (by @safwat-halaby)
• Bundle with Rolldown instead of Rollup (#7555) (by @birkskyum)
• Optimization for Feature State: Replace String-Indexed Object with Array (up to 3.4X speedup) (#7550) (by @xavierjs)
• Expose getProjectionData function in custom layer args objects (#7471) (by @kubapelc)
• Marked package sideEffects as CSS-only in package metadata, which may improve tree-shaking and reduce bundle size in some bundlers (#7258) (by @CommanderStorm)

🐞 Bug fixes

• ⚠️ Fix transparent, overlapping lines creating artefacts. This is fixed for line-opacity, but purposefully not for transparent line-color properties, thus still allowing transparent colors to stack their effect. (#7490) (by @CommanderStorm)
• ⚠️ Disable icon scaling with offset, this is a render breaking change which we have decided to incorporate in both maplibre-gl-js and maplibre-native (#7742) (by @springmeyer and @HarelM)
• Log style validation warnings instead of treating them as errors, so that a filter mixing legacy and expression syntax no longer aborts the style load and blanks the map (#7941) (by @HarelM)
• Validate raster-dem sources passed to map.addSource, which were previously skipped. Stop a source type the style spec has no schema for, such as one registered with addSourceType, from failing the whole style. Previously only canvas was let through (#7941) (by @HarelM)
• Fix line-layer-opacity/fill-layer-opacity clipping away a subsequent layer that shares the same source (#7867) (by @CommanderStorm)
• Fix camera jump in flyTo when minZoom is set (#7743) (by @YuChunTsao)
• Fix stale terrain depth and coordinate framebuffers when terrain tiles change without camera movement (#7812) (by @DoFabien)
• Fix a memory leak where aborting a worker request (e.g. a GeoJSON tile load cancelled while panning) left its promise pending forever, so the awaiting async frame and everything it captured was never released; Actor.sendAsync now rejects with an AbortError on abort (#7826) (by @kamil-sienkiewicz-asi)
• Skip undefined properties during worker serialization (#7801) (by @xavierjs)
• Fix cross-origin module worker loading to preserve ESM semantics (#7796) (by @dangkyokhoang)
• Fix conflicting reloads of tiles causing an error in queryRenderedFeatures (#7765) (by @ckolin)
• Fix a race condition in geojson source after init and fast update data (#7734) (by @HarelM)
• Fix camera jump on dragend with globe + terrain at low pitch (#7736) (by @kodeezabdullah)
• Fix web font rendering by awaiting document.fonts.load() before TinySDF instantiation (#7735) (by @kodeezabdullah)
• Remove the framebuffer completeness check that threw an unhandled Framebuffer is not complete error on transient GPU resource loss (e.g. when a tab wakes from sleep); incomplete framebuffers now self-heal on the next frame instead (#7303) (by @johanrd)
• Fix handling cross-origin blob URL in Ajax utils (#7675) (by @katemihalikova)
• Avoid TypeErrors from style methods while the WebGL context is lost (#7710) (by @cyphercodes)
• querySourceFeatures() throws 'Block overruns tile' on overzoomed MLT tiles because the reported encoding doesn't match the re-encoded MVT data (#7707) (by @ted-piotrowski)
• Fix geometry length check for polygons and lines in LineBucket after duplicate vertex trimming(#7638) (by @widefire)
• line-dasharray step transition lags one zoom level when the step's branches are data-driven (#7705) (by @lucaswoj)
• Fix feature state bulk remove + feature set per-id set does not remove state of first feature (#7554) (by @xavierjs)
• Remove error when actor doesn't have a registered message type for better usability of custom messages in workers (#7589) (by @HarelM)
• Auto-load worker module for CDN usage (#7595) (by @birkskyum)
• Fix Large number of feature state keys leads to zoom lag when loading cached tiles (#7590) (by @xavierjs)
• Fix issue when map's max zoom and source max zoom are close to eachother (#7567) (by @HarelM)

✨ Features and improvements

• Validate the terrain passed to map.setTerrain, which was previously applied unchecked (#7941) (by @HarelM)
• Improve runtime error warnings to point at the offending style location (e.g. layers[3].paint.line-color, layers[3].filter) instead of just logging the bare error message (#7869) (by @CommanderStorm)
• ⚠️ Interpolate the light position in spherical coordinates instead of cartesian ones, so that a transition keeps its radial distance. (#7919) (by @HarelM)

🐞 Bug fixes

• Log style validation warnings instead of treating them as errors, so that a filter mixing legacy and expression syntax no longer aborts the style load and blanks the map (#7941) (by @HarelM)
• Validate raster-dem sources passed to map.addSource, which were previously skipped. Stop a source type the style spec has no schema for, such as one registered with addSourceType, from failing the whole style. Previously only canvas was let through (#7941) (by @HarelM)

✨ Features and improvements

• Improve terrain render-to-texture preparation performance by skipping sources that are not rendered to terrain textures (#7863) (by @DoFabien)
• Add Map.setMissingStyleImageResolver for resolving missing style images with sync or async callbacks (#7850) (by @birkskyum)
• ⚠️ Stop allowing styleimagemissing listeners to resolve the current image request; use Map.setMissingStyleImageResolver instead (#7892) (by @birkskyum)
• Add RasterTileSource#setPremultiplyAlpha(false) to preserve raw RGBA tile values when alpha is used for data instead of opacity (#7235) (by @plantain).

✨ Features and improvements

• ⚠️ Map now composes a Camera instead of extending it (Map extends Evented directly and forwards the camera API). The internal map.transform was removed — use map's public API instead or open a PR if you need something that's not exposed. Removed the internal transform.getMatrixForModel helper (#7800) (by @HarelM)

🐞 Bug fixes

• Fix line-layer-opacity/fill-layer-opacity clipping away a subsequent layer that shares the same source (#7867) (by @CommanderStorm)
• Fix camera jump in flyTo when minZoom is set (#7743) (by @YuChunTsao)

✨ Features and improvements

• Drop the archived @mapbox/whoots-js dependency by inlining its single getTileBBox helper (#7838) (by @qorexdevs)
• Debounce setImages broadcast to once per animation frame, fixing O(n²) serialization overhead when adding many images (#7614) (by @bradymadden97)

🐞 Bug fixes

• Fix stale terrain depth and coordinate framebuffers when terrain tiles change without camera movement (#7812) (by @DoFabien)

✨ Features and improvements

• Improve terrain rendering performance by avoiding unnecessary terrain data lookups during Mercator render-to-texture passes (#7833) (by @DoFabien)
• Reduce allocation pressure while constructing DEM data and sampling terrain elevations (#7814) (by @DoFabien)
• Reuse terrain DEM texture when preparing terrain (#7813) (by @DoFabien)

🐞 Bug fixes

• Fix a memory leak where aborting a worker request (e.g. a GeoJSON tile load cancelled while panning) left its promise pending forever, so the awaiting async frame and everything it captured was never released; Actor.sendAsync now rejects with an AbortError on abort (#7826) (by @kamil-sienkiewicz-asi)

✨ Features and improvements

• ⚠️ All map events are now real classes that are instantiated when they are fired. Renamed MapLibreZoomEvent to MapBoxZoomEvent, added the rollstart/roll/rollend and style.load (as MapStyleLoadEvent) events to MapEventType, and added event classes and type-map for Marker, Popup, GeolocateControl and FullscreenControl. Removed MapDataEvent: the data/dataloading/dataabort events are now MapSourceDataEvent | MapStyleDataEvent, so source data events carry the full source info (sourceId, tile, sourceDataType, …). Added MapMovementEvent as the type for all camera-transition events (move/zoom/rotate/pitch/roll/drag and their start/end variants). Evented is now generic over an event-type map (Evented<EventType>) and is abstract, so subclasses get strongly-typed on/once/off automatically without re-declaring overloads — this also types the events on Camera/Style (via MapEventType) and on the sources (via the new SourceEventType) (#7789) (by @HarelM)

🐞 Bug fixes

• Skip undefined properties during worker serialization (#7801) (by @xavierjs)

✨ Features and improvements

• ⚠️ Update maplibre-gl-style-spec to version 25, which has a breaking change in legacy expression validation (#7792) (by @HarelM)

🐞 Bug fixes

• Fix cross-origin module worker loading to preserve ESM semantics (#7796) (by @dangkyokhoang)

✨ Features and improvements

• Add fill-layer-opacity and line-layer-opacity paint properties, which apply opacity to the entire layer output uniformly (#7570) (by @CommanderStorm)
• Build main and worker in same build context to extract shared chunk (#7745) (by @dangkyokhoang)

🐞 Bug fixes

• Fix conflicting reloads of tiles causing an error in queryRenderedFeatures (#7765) (by @ckolin)

✨ Features and improvements

• Revert the line-opacity-driven offscreen rendering introduced in #7490 (#7764) (by @CommanderStorm). The overlap-artefact fix is now driven by line-layer-opacity instead.
• ⚠️ Removed the remaining mapbox references in the code and in the tests. This changes the #pragma mapbox to #pragma maplibre in case you have shader code that relied on it. (#7761) (by @HarelM)

🐞 Bug fixes

• Fix a race condition in geojson source after init and fast update data (#7734) (by @HarelM)

✨ Features and improvements

• Improve ProjectionData matrix backing types for renderer and custom layer projection matrices (#6316) (by @cat0825)

🐞 Bug fixes

• Fix camera jump on dragend with globe + terrain at low pitch (#7736) (by @kodeezabdullah)
• Fix web font rendering by awaiting document.fonts.load() before TinySDF instantiation (#7735) (by @kodeezabdullah)
• Remove the framebuffer completeness check that threw an unhandled Framebuffer is not complete error on transient GPU resource loss (e.g. when a tab wakes from sleep); incomplete framebuffers now self-heal on the next frame instead (#7303) (by @johanrd)
• ⚠️ Disable icon scaling with offset, this is a render breaking change which we have decided to incorporate in both maplibre-gl-js and maplibre-native (#7742) (by @springmeyer and @HarelM)

✨ Features and improvements

• Optimization: vertex shader opacity culling for lines and fills #7711 (by @xavierjs)

🐞 Bug fixes

• Fix handling cross-origin blob URL in Ajax utils (#7675) (by @katemihalikova)
• Avoid TypeErrors from style methods while the WebGL context is lost (#7710) (by @cyphercodes)
• querySourceFeatures() throws 'Block overruns tile' on overzoomed MLT tiles because the reported encoding doesn't match the re-encoded MVT data (#7707) (by @ted-piotrowski)
• Fix geometry length check for polygons and lines in LineBucket after duplicate vertex trimming(#7638) (by @widefire)
• line-dasharray step transition lags one zoom level when the step's branches are data-driven (#7705) (by @lucaswoj)

✨ Features and improvements

• Use a shared FBO for the terrain cache render to texture #7637 (by @xavierjs)
• Use flat to opt out of interpolation for constant shader varyings (#7661) (by @birkskyum)

✨ Features and improvements

• Replace texImage2D with texStorage2D for immutable textures (#7643) (by @birkskyum)
• Enable mipmaps for non-power-of-two raster tiles, reducing aliasing at high pitch (#7641) (by @birkskyum)
• Use GLSL ES 3.00 layout qualifiers for vertex attribute locations, replacing runtime bindAttribLocation calls (#7644) (by @birkskyum)

✨ Features and improvements

• Adopt isolatedDeclarations and switch dts emitter from tsgo to oxc (#7566) (by @birkskyum)

🐞 Bug fixes

• Fix feature state bulk remove + feature set per-id set does not remove state of first feature (#7554) (by @xavierjs)
• Remove error when actor doesn't have a registered message type for better usability of custom messages in workers (#7589) (by @HarelM)
• Auto-load worker module for CDN usage (#7595) (by @birkskyum)
• Fix Large number of feature state keys leads to zoom lag when loading cached tiles (#7590) (by @xavierjs)

✨ Features and improvements

• Improve 3D terrain performance (#7549) (by @lucaswoj)

✨ Features and improvements

• Replace dts-bundle-generator with rolldown-plugin-dts for 78.2x faster .d.ts generation. (#7564) (by @birkskyum)
• Replace ts-node with Node 24's native TypeScript support for build scripts. (#7565) (by @birkskyum)
• Bump typescript to v7 beta - 3.5x faster typecheck (#7556) (by @birkskyum)

🐞 Bug fixes

• ⚠️ Fix transparent, overlapping lines creating artefacts. This is fixed for line-opacity, but purposefully not for transparent line-color properties, thus still allowing transparent colors to stack their effect. (#7490) (by @CommanderStorm)
• Fix issue when map's max zoom and source max zoom are close to eachother (#7567) (by @HarelM)

✨ Features and improvements

• Add a new map creation option, terrainSkirtLength, which allows the removal of visually unappealing vertical artifacts when using a terrain along with a transparent background (#7523) (by @safwat-halaby)
• Bundle with Rolldown instead of Rollup (#7555) (by @birkskyum)
• Optimization for Feature State: Replace String-Indexed Object with Array (up to 3.4X speedup) (#7550) (by @xavierjs)

✨ Features and improvements

• ⚠️ Switch to an ESM-only distribution (maplibre-gl.mjs). The UMD bundles (maplibre-gl.js, maplibre-gl-csp.js) are no longer published. The CSP-specific bundle is also dropped: the ESM build loads its worker as a real URL, so worker-src blob: is no longer required. Consumers using <script src=".../maplibre-gl.js"> must switch to <script type="module">, and consumers using import maplibregl from 'maplibre-gl' must switch to import * as maplibregl from 'maplibre-gl' or named imports. See the docs ESM section for migration steps. (#6254) (by @birkskyum)

✨ Features and improvements

• ⚠️ zoomLevelsToOverscale default value was changed to 4 to support better handling of high level zoom with dense labels. This might have a side effect of changing a bit the results of queryRenderedFeatures and some rendering of polygon center label. To revert this change, set the value to undefined (#7537) (by @HarelM)

✨ Features and improvements

• ⚠️ Remove the second parameter from GeoJSONSource.setData (waitForCompletion) and remove the return value of this to allow future changes to the API (#7538) (by @HarelM)
• ⚠️ The TypeScript target has been updated to ES2022. This results in smaller bundles and improved runtime performance by relying on modern JavaScript features and reducing transpilation. Consumers targeting browsers or using some tooling released before 2022 may need to transpile MapLibre or update. This change also aligns all internal build configurations to a single target instead of ES2016 + ES2019, avoiding inconsistencies in emitted code. (#7404) (by @CommanderStorm)

✨ Features and improvements

• ⚠️ WebGL (v1) support has been removed; WebGL2 is now required. In practical terms, this will not change how you interact with the map. This enables performance improvements (e.g. line opacity), Terrain3D enhancements, and several bug fixes. WebGL2 support has been widely available for years, and usage of the legacy path had plateaued, so maintaining it no longer justified the added complexity. To ease this breaking change, we have also refactored how we handle the case that no webgl is avaliable (e.g. due to browser restrictions). You can now listen to the webgl error via .on("error"). See caniuse.com/webgl2 for ecosystem support and our RFC for details. (#7453) (by @CommanderStorm)

✨ Features and improvements

• ⚠️ Support geojson nested objects, this is a breaking change as it encodes __$json__ before properties that used to be an object. It also parses them back, but this is still a breaking change if you assumed this bug existed. (#6992) (by HarelM)
• ⚠️ Improve types for {get,set}LayoutProperty, {get,set}PaintProperty to be the actual type instead of string/any (#7481) (by @CommanderStorm)

✨ Features and improvements

• ⚠️ Refactored the Hash-based location control (the option that syncs map state to the URL like #map=5/1/2) to use URLSearchParams internally. This improves extensibility for custom use cases, but may break existing code that relies on the previous implementation. It also changes how certain edge cases are parsed—for example, strings like #10%2F3.00%2F-1.00 are now accepted, and hashes like #foo are normalized to #foo=. (#7073) (by @CommanderStorm)
• Expose getProjectionData function in custom layer args objects (#7471) (by @kubapelc)
• Marked package sideEffects as CSS-only in package metadata, which may improve tree-shaking and reduce bundle size in some bundlers (#7258) (by @CommanderStorm)

✨ Features and improvements

• GPU performance optimization: Render halo and glyph in a single pass (-40% Time Reduction) (#7436) (by @xavierjs)
• Optimize matrix inversions and reduce GPU stalls (#7367) (by @xavierjs)
• Add example showing how to measure map performance using built-in events (load, idle, render) (#7077) (by @CommanderStorm)

🐞 Bug fixes

• Fix Popup not updating its position when switching between terrain/globe projections (#7468) (by @CommanderStorm)
• Skip fog computation when fog opacity is zero (#7476) (by @CommanderStorm)

✨ Features and improvements

• Add touchZoomRotate.setZoomRate() and touchZoomRotate.setZoomThreshold() to customize touch zoom speed and pinch sensitivity (#7271) (by @itisyb)
• Improve ability to communicate with imported scripts in workers and use makeRequest in workres as well (#7451) (by @HarelM)
• Allow opacity and opacityWhenCovered in Marker and MarkerOptions to accept number in addition to string, and add maplibregl-marker-covered CSS class to Marker element when covered by 3D terrain or a globe (#7433) (by @YuChunTsao)
• perf: add a bench for terrain rendering and fix _demMatrixCache lookup being wasted cycles by actually using the cache (#7400) (by @CommanderStorm)

🐞 Bug fixes

• Fix polygon text label placement drifting far from center for convex polygons at high zoom due to coordinate rounding in geojson-vt (#7380) (by @CommanderStorm)
• Ensure that a successful ArrayBuffer response from a custom protocol that is null/undefined is set to an empty ArrayBuffer (#7427) (by @neodescis)
• Fix error in _contextRestored when map was initialized without a style (#7432) (by @mvanhorn)
• Fix issue with the cache used for zoomLevelsToOverscale feature (#7450) (by @HarelM)
• Update stylelint and fix old issues with the CSS (mainly change rgb to use spaces) (#7365) (by @HarelM)

✨ Features and improvements

• Make line-cap, line-miter-limit, and line-round-limit data-driven properties, allowing per-feature values (#7351) (by @CommanderStorm)
• GPU performance optimization: early culling of transparent symbols in vertex shaders (#7364) (by @xavierjs)
• Add example showing how to measure map performance using built-in events (load, idle, render) (#7077) (by @CommanderStorm)
• UX: Clarify error message language so if layout and paint properties are confused in setPaintProperty or setLayoutProperty (#6954) (by @Willjfield and @CommanderStorm)

🐞 Bug fixes

• Fix startup crash caused by a stale async style load completing after the style was cleared or replaced (#7377)
• Make fitBounds and fitScreenCoordinates respect the zoomSnap map option by snapping the zoom level down to keep bounds fully visible (#7332 (by @CommanderStorm)
• Make jumpTo, easeTo, and flyTo respect the zoomSnap map option by snapping the zoom level to the nearest valid increment (#7333 (by @CommanderStorm)
• Fix setState crash when switching styles while globe projection is active (#7314) (by @ashwinuae)
• Prevent crashes when calling map.remove() immediately after creation by canceling in-flight style URL loads (#7368) (by @CommanderStorm)
• Fixed symbol collision flickering by adding tolerance to GridIndex AABB comparison (#7360) (by @kkokkoejong)
• Fix fitBounds ignoring maxZoom option in vertical-perspective projection (#7372) (by @CommanderStorm)
• Prevent stale async style loads from completing after style clear (#7378) (by @Lievesley)
• Fix broken example for fill-pattern (#7326) (by @k-yle)

🐞 Bug fixes

• Add missing promoteId parameter to geojson worker and refactor communication object (#7320) (by @HarelM)

✨ Features and improvements

• Add compatibility for ES2020 (#7283) (by @claudiobgit)
• Add referrerPolicy option to RequestParameters to allow controlling the referrer policy for tile requests (#7278) (by @Bingtagui404)
• Wait for the GPU to finish its callstack for rendering benchmarks (#7285) (by @xavierjs)
• Remove Edge 18 WebP detection workaround; always send Accept: image/webp header for image requests (#7293) (by @johanrd)
• Remove legacy browser compatibility code targeting IE11 and pre-2016 browsers (#7294) (by @johanrd)
• Remove legacy DOM.remove() and DOM.mouseButton() wrappers; use native APIs directly (baseline 2015) (#7295) (by @johanrd)
• Make setTransformRequest accept an async function in addition to a sync function. (#7184) (by @kikuomax)

🐞 Bug fixes

• Fix incorrect popup location in case of terrain and jumpTo (#7267) (by @HarelM)
• Fix memory leak in VideoSource: remove playing event listener and pause video on source removal (#7279) (by @johanrd)
• Fix memory leak where typed array views retained StructArray buffers after GPU upload, preventing garbage collection (#7280) (by @johanrd)
• Fix raster DEM tiles getting stuck in "reloading" state (#7284) (by @katemihalikova)
• Fix GeolocateControl leaking a movestart listener on the map after removal, which could also crash if the control was in active tracking state when removed (#7286) (by @johanrd)
• Cap tile texture reuse pool to prevent unbounded VRAM growth during rapid zoom/pan (#7289) (by @johanrd)
• Fix Marker click listener not removed on remove(), leaking the handler added in #7028 (#7287) (by @johanrd)
• Fix Terrain GPU resource leak: free FBO, textures, and meshes when terrain is disabled via setTerrain(null) (#7288) (by @johanrd)
• Fix guard against partial layout in PauseablePlacement (#7079) (by @garethbowker)
• Fix missing tile encoding for MLT queryRenderedFeatures (#7056) (by @dannote and @ted-piotrowski)
• Fix 3D Tiles example (#7275) (by @hh-hang)

🐞 Bug fixes

• Fix update GeoJSON when using diff update by updating geojson-vt package (#7257) (by @HarelM)

🐞 Bug fixes

• Fix cannot read properties of undefined (reading 'range') by updating geojson-vt package (#7245) (by @HarelM)
• Fix a bug where raster-resampling: nearest was not applied as expected (#7247) (by @yano-h)

✨ Features and improvements

• Add Etag unmodified support to optimize vector tile reloading (#7074) (by [@rivkamatan](https://github.com/rivkamatan and @wayofthefuture)
• Add boxZoom.boxZoomEnd option to customize the action after Shift-drag box selection (#6397) (by @itisyb)
• Implement resampling paint property for raster, hillshade, and color-relief layers (#7074) (by @larsmaxfield)
• Add updateable support for GeoJSON-VT (#7172) (by @wayofthefuture and @HarelM)
• Add example for 3D Tiles using three.js (#7198) (by @hh-hang)

🐞 Bug fixes

• Fix: Distance to tile is calculated incorrectly in globe projection for high pitch angles (#7219) (by @jtfedd)
• Fix: Tiles are not cleared when using vector tile source setUrl/setTiles (#7185) (by @madoci)
• Fix: Allow opaque origins ("null") in Actor message filtering (#7047) (by @pcardinal)

✨ Features and improvements

• Change the return type of LngLatBounds.toArray() to use a more precise type (#7156) (by @n4n5)
• Add anisotropicFilterPitch map option to set the pitch above which the anisotropic filter is applied to all raster layers, the default of which is 20° (#7134) (by @larsmaxfield)
• Add source id to error message (#7107) (by @HarelM)

🐞 Bug fixes

• Fix SDF icon-text-fit rendering by correctly unpacking packed shader values in symbol_sdf.vertex.glsl, with render-test coverage (#7141, fixes #6953) (by @pcardinal)
• Fix correct bounds calculation for GeoJSON with elevation (#6963) (by @simonmnt)
• Fix: support elevation in bounds calculation (#7135) (by @simonmnt)
• Fix Firefox "Alpha-premult deprecated for non-DOM uploads" warning (#7128) (by @birkskyum)
• Fix raster tiles rendering with glyph/icon atlas content after WebGL context loss (#7126) (by @birkskyum)
• Fix popup tip in RTL pages (#7157) (by @HarelM)

✨ Features and improvements

• Add support for click events on Marker (#7028) (by @ganesh8068)
• Simplify and abstract the GeoJSON Worker (#7058) (by @wayofthefuture)
• Add pseudo option to FullscreenControl to force CSS-based fullscreen mode instead of native fullscreen API. Users might want this because this is faster on some devices (#7076) (by @CommanderStorm)
• Migrate our API docs to zensical (#7071) (by @CommanderStorm)

🐞 Bug fixes

• Fix WebGL context loss error when style is not yet loaded (#7094) (by @kaigritun)
• Fix updating terrain tiles on feature state changes (#6231) (by @pstaszek)
• Fix LngLatBounds.intersects for zero-width bounds (#7055) (by @lucaswoj)
• Fix GlobeControl not updating when Map.setProjection() is called programmatically (#7005, #7075) (by @CommanderStorm)
• Fix map.getProjection() returning undefined after calling map.setProjection() with the default "mercator" projection (#7072) (by @CommanderStorm)
• Fix incorrect text placement along line in 3D mode (#7039) (by @russellporter)
• When the prefers-reduced-motion media query is active, we now no longer display the pulsing GeoLocation animation (#7066) (by @CommanderStorm)

✨ Features and improvements

• Refactor _updateWorkerData (#6983) (by @wayofthefuture)
• ⚠️ Add zoomSnap option to Map to allow snapping zoom levels to a grid when zooming in and out; aligns the behavior across all UI patterns (keyboard, scroll wheel, on-screen zoom buttons, double-click, double-tap). Previously, pressing +/- on the keyboard zoomed to rounded whole integers, more or less than 1 zoom level when starting from a fractional zoom. Now any number can be specified for zoomSnap; a value of 1.0 produces the rounded whole integer behavior across all UI patterns. (#6941) (by @mizmay)
• Add support for container elements from different windows (e.g., popup or iframe) (#6969) (by @Syncret)
• Migrate to @maplibre/geojson-vt (#6995) (by @HarelM)

🐞 Bug fixes

• Fix incorrect shader selection for text labels with inline images (#6956) (by @ciscorn)
• Fix marker positions not updating when zoom or pitch are changed following a change in constraints (#6925) (by @auspicus)

✨ Features and improvements

• Add padding option to Popup class to prevent popups from being positioned too close to map container edges (#5978) (by @yuiseki and @lucaswoj)
• Emit style.load event on style diff (#6880) (by @lesbaa)

🐞 Bug fixes

• Fix setting visibility on custom layer (#6883) (by @melitele)
• Hide leading and trailing control characters in format expressions (#6907) (by @1ec5)
• Fix image sources being clipped at -180 and 180 longitude when terrain is enabled (#4088) (by @pstaszek)
• Fix map not immediately constraining to a valid zoom and center when changing projections (#6892) (by @larsmaxfield)
• Fix a blank map when a resize event is triggered before a WebGL context restoration (#6935) (by @ToHold)
• Diffed changes when json is passed to setStyle emit a style.load event. (#2587, #4757) (by @lesbaa)
• Fix a precision issue in the atomsphere shader in globe projection. (#6916) (by @tavimori)

✨ Features and improvements

• Support global state expression for layer visibility (#6659) (by @melitele)
• Update Node.js version to 24.11 for development (#6851) (by @HarelM)

🐞 Bug fixes

• Fix LngLatBounds#intersects returning false for bounds spanning 360° or more (#6863) (by @lucaswoj)
• Fix getting the right zoom for getElevationForLngLat (#6825) (by @HarelM)
• Fix stale transform state being applied after changing minZoom or maxZoom due to old copies from transformCameraUpdate taking precedence. transformCameraUpdate is now called from setMinZoom and setMaxZoom to allow user to control subsequent changes to zoom (#6766) (by @Auspicus)
• Fix GeoJSON source throwing with undefined properties (#6730) (by @wayofthefuture)

✨ Features and improvements

• Prevent redundant DEM border backfilling by tracking state, moved tile manager logic to helper files (#6756) (by @HarelM)
• Improve performance of GeoJSON updateData, setData, and overzoomed tiles (#6738, #6772) (by @lucaswoj)

🐞 Bug fixes

• Handle consecutive duplicate points in offsetLine to avoid null values in the output. (#5431) (by @mmc1718)
• ⚠️ Gracefully handle internal AbortErrors (e.g., when a TileJSON URL is updated while a request in flight). Previously, such aborted requests would throw an AbortError in an unhandled rejection that was not easily caught in user code. Since aborted requests are fully handled internally, these unhandled rejections were superfluous and resulted in unhelpful client errors. (#6747) (by @andrewda)
• Fix canvas sources with power-of-2 dimensions rendering as black squares (#6607) (by @Omkarthipparthi)
• Fix queryTerrainElevation to use higher zoom level tiles when possible (#6791) (by @HarelM)
• Fix unwanted movement when moving a pitched terrain map at high latitudes; fix freezes when moving a pitched and rotated terrain map at low zoom (#6775) (by @larsmaxfield)
• Fix issue with static modifier as part of mlt package (#6796) (by @HarelM)
• Fix GeoJSONSource tile reloading when updating data (#6800) (by @HarelM)
• LngLatBounds#intersects now returns true when bounds touch along an edge or at a corner (#6802) (by @lucaswoj)

✨ Features and improvements

• Text labels can now include relatively uncommon Chinese, Japanese, Korean, and Vietnamese characters, as well as characters from historical writing systems. When using server-side fonts, the map may request glyph PBFs beyond U+FFFF from the server instead of throwing an error as before. (#6640) (by @1ec5)
• GeoJSON Source Diff: improve, abstract, refactor, optimize, and fix regressions. (#6681) (by @wayofthefuture)
• GeoJSONSource setData and updateData waitForCompletion option (#6688) (by @wayofthefuture)
• Improve performance of GeoJSONSource#updateData (#6668) (by @lucaswoj)
• GeoJSON Worker Refactor (#6702) (by @wayofthefuture)

🐞 Bug fixes

• Misc bug fixes related to GeoJSONSource#updateData (#6689, #6690, #6704) (by @lucaswoj)

✨ Features and improvements

• Add support for MapLibre Tiles (MLT) by using encoding: 'mlt' in vector source definition (#6570) (by @Salkin975 and @HarelM)
• Slice vector tiles to improve over scale vector handling (#6521). It adds the experimentalZoomLevelsToOverscale flag to MapOptions to allow controlling how many zoom levels to slice and how many to scale. It seems to have better performance at high zoom levels. It can prevent Safari crashes in some scenarios by setting it to 4 or less. (by @HarelM)
• Add reduceMotion option to Map Options (#6661) (by @wayofthefuture)

🐞 Bug fixes

• Fix missing constrainOverride setter in TransformHelper.apply (#6642) (by @larsmaxfield)
• Fix blank map after WebGL context restore (#6242) (by @ToHold)

✨ Features and improvements

• Improve performance of GeoJSONSource#updateData when called on small diffs (#6562) (by @lucaswoj)
• If the stylesheet lacks a glyphs property at the root level, interpret the text-font property as a cascading fallback list of font names and render all text using local or system fonts. (#4564) (by @1ec5)
• ⚠️ Refactor SourceCache to TileManager (#6635) - this is not a breaking change since SourceCache is not part of the public API, but if you have a plugin that uses internal stuff, it might break... (by @wayofthefuture)

🐞 Bug fixes

• If a required glyph PBF is unavailable or it lacks a glyph for a character in a text-field, try to render it locally instead of crashing. (#4564) (by @1ec5)
• Export now() function in timeControl API to complete the API and enable external code to read controlled time (#6644) (by @bjperson)
• ScaleControl CSS styling contains white-space: nowrap to prevent wrapping (#6647) (by @stroebjo)
• Fix edge fading for unloaded tiles (#6650) (by @wayofthefuture)

✨ Features and improvements

• Add time control API (setNow, restoreNow, isTimeFrozen) for deterministic rendering, enabling frame-by-frame video export and deterministic testing (#6544) (by @bjperson)
• Use styles isHidden logic in the worker by adding a new optional roundMinZoom parameter (#6547) (by @HarelM)
• Add transformConstrain callback to the Map options to override the transform's constrain with new type TransformConstrainFunction; refactor transform constructor options to a TransformOptions object (#6484) (by @larsmaxfield)
• Use timeControl.now() instead of browser.now() (#6573) (by @bjperson)

🐞 Bug fixes

• Contextmenu events not blocked by scrolling (#5683) (by @mmc1718)
• Mousemove events are not blocked by scrolling (#6302) (by @mmc1718)
• Dashed lines have blurry rounded caps (#6554) (by @lucaswoj)
• Preserve flyTo padding when prefers-reduced-motion is enabled (#6576) (by @manuel-em)
• Fix setClusterOptions not triggering recluster when no data changes are pending (#6603) (by @andrewda)

✨ Features and improvements

• Improve fading - dynamic bi-directional raster cross-fading and self fading (#6469) (by @wayofthefuture)
• Support for usage of line-gradient together with line-dasharray (#6487) (by @Samarth1696)

🐞 Bug fixes

• Added button role to marker div to fix accessibility issues with the aria-label (#6435) (by @cmburcus)
• Fix a crash on iOS when there are too many symbols to render (#6526) (by @HarelM)

✨ Features and improvements

• Enable documentation admonitions in Material for MkDocs. (#6455) (by @morehawes)
• Switch MapEventType from type to interface to allow declaration merging (#6436) (by @lhapaipai)
• Implement data-driven styling support for line-dasharray (#5812) (by @lucaswoj)

🐞 Bug fixes

• Fix raster flickering when using terrain 3D and optimize terrain logic. (#6446) (by @wayofthefuture)
• Fix issue where parent tiles are retained when deeper descendant tiles already cover the missing ideal tile. (#6442) (by @wayofthefuture)
• Fix an issue when GeolocateControl fires outofmaxbounds event with trackUserLocation disabled (#6464) (by @sorami)
• Fix an issue with globe+terrain "zooming" in when dragging towards the poles (#6470) (by @birkskyum)
• Fix integer overflow in symbol placement (#6476) (by @HarelM)

🐞 Bug fixes

• Fix case where retain loaded children does not retain uppermost loaded children (#6399) (by @wayofthefuture)
• Fix an issue with spread operator that caused issues in Angular and esbuild (#6438) (by @HarelM)

🐞 Bug fixes

• Fix _updateRetainedTiles checking for children when children length is 1 overscaled tile "child" (#6388) (by @NathanMOlson)
• Fix evaluating global-state for layers added after loading style (#6361) (by @melitele)
• Change the pathway for passing global-state object from Style to expression to fix a hack that was introduced in previous versions (#6366) (by @melitele)
• Fix triggering load and idle events when source TileJSON fails to load (#5430) (by @melitele)
• Fix mouse events on heatmap features (#714) (by @melitele)

🐞 Bug fixes

• Fix accuracy circle on locate user control (#5432) (by @geekdenz)
• Fix evaluating global-state in paint ...-pattern properties (#6301) (by @melitele)
• Fix pan moving in the wrong direction when map is pitched (#6111) (by @NathanMOlson)
• Fix evaluation of text-color when using format within step (#5833) (by @sim51)
• Fix regression in mergeSourceDiffs: handle add/remove/removeAll (#6342) (by @lhapaipai)
• Fix evaluating global-state in layout properties icon-size and text-size (#6308) (by @melitele)

✨ Features and improvements

• Pass document's lang to Tiny-SDF to render Simplified and Traditional Chinese characters (#6223) (by @mapmeld)
• Enable global-state expressions in layout properties (#6209) (by @melitele)
• Align typescript types generation with docs generation and avoid exporting non-exported types (#6217) (by @HarelM)
• Add coveringTiles method to the public API of the map object (#6292) (by @HarelM)

🐞 Bug fixes

• Prevent original input style JSON from being mutated by Style.set* methods (#6216) (by @sruenwg)
• Fix evaluating global-state in paint properties with other subexpressions (#6048) (by @melitele)
• Fix enabling terrain while transitioning (#6011) (by @NathanMOlson)