Maplibre

✨ Features and improvements

- Reduce size of line atlas by removing unused channels ([9232](https://github.com/mapbox/mapbox-gl-js/pull/9232))
- Prevent empty buffers from being created for debug data when unused ([9237](https://github.com/mapbox/mapbox-gl-js/pull/9237))
- Add space between distance and unit in scale control ([9276](https://github.com/mapbox/mapbox-gl-js/pull/9276)) (h/t [gely](https://api.github.com/users/gely)) and ([#9284](https://github.com/mapbox/mapbox-gl-js/pull/9284)) (h/t [pakastin](https://api.github.com/users/pakastin))
- Add a `showAccuracyCircle` option to GeolocateControl that shows the accuracy of the user's location as a transparent circle. Mapbox GL JS will show this circle by default. ([9253](https://github.com/mapbox/mapbox-gl-js/pull/9253)) (h/t [Meekohi](https://api.github.com/users/Meekohi))
- Implemented a new tile coverage algorithm to enable level-of-detail support in a future release ([8975](https://github.com/mapbox/mapbox-gl-js/pull/8975))

🐞 Bug fixes

- `line-dasharray` is now ignored correctly when `line-pattern` is set ([9189](https://github.com/mapbox/mapbox-gl-js/pull/9189))
- Fix line distances breaking gradient across tile boundaries ([9220](https://github.com/mapbox/mapbox-gl-js/pull/9220))
- Fix a bug where lines with duplicate endpoints could disappear at zoom 18+ ([9218](https://github.com/mapbox/mapbox-gl-js/pull/9218))
- Fix a bug where Ctrl-click to drag rotate the map was disabled if the Alt, Cmd or Windows key is also pressed ([9203](https://github.com/mapbox/mapbox-gl-js/pull/9203))
- Pass errors to `getClusterExpansionZoom`, `getClusterChildren`, and `getClusterLeaves` callbacks ([9251](https://github.com/mapbox/mapbox-gl-js/pull/9251))
- Fix a rendering performance regression ([9261](https://github.com/mapbox/mapbox-gl-js/pull/9261))
- Fix visual artifact for `line-dasharray` ([9246](https://github.com/mapbox/mapbox-gl-js/pull/9246))
- Fixed a bug in the GeolocateControl which resulted in an error when `trackUserLocation` was `false` and the control was removed before the Geolocation API had returned a location ([9291](https://github.com/mapbox/mapbox-gl-js/pull/9291))
- Fix `promoteId` for line layers ([9210](https://github.com/mapbox/mapbox-gl-js/pull/9210))
- Improve accuracy of distance calculations ([9202](https://github.com/mapbox/mapbox-gl-js/pull/9202)) (h/t [Meekohi](https://api.github.com/users/Meekohi))

✨ Features

- Add `promoteId` option to use a feature property as ID for feature state ([8987](https://github.com/mapbox/mapbox-gl-js/pull/8987))
- Add a new constructor option to `mapboxgl.Popup`, `closeOnMove`, that closes the popup when the map's position changes ([9163](https://github.com/mapbox/mapbox-gl-js/pull/9163))
- Allow creating a map without a style (an empty one will be created automatically) (h/t [stepankuzmin](https://github.com/stepankuzmin)) ([#8924](https://github.com/mapbox/mapbox-gl-js/pull/8924))
- `map.once()` now allows specifying a layer id as a third parameter making it consistent with `map.on()` ([8875](https://github.com/mapbox/mapbox-gl-js/pull/8875))

🍏 Improvements

- Improve performance of raster layers on large screens ([9050](https://github.com/mapbox/mapbox-gl-js/pull/9050))
- Improve performance for hillshade and raster layers by implementing a progressive enhancement that utilizes `ImageBitmap` and `OffscreenCanvas` ([8845](https://github.com/mapbox/mapbox-gl-js/pull/8845))
- Improve performance for raster tile rendering by using the stencil buffer ([9012](https://github.com/mapbox/mapbox-gl-js/pull/9012))
- Update `symbol-avoid-edges` documentation to acknowledge the existence of global collision detection ([9157](https://github.com/mapbox/mapbox-gl-js/pull/9157))
- Remove reference to `in` function which has been replaced by the `in` expression ([9102](https://github.com/mapbox/mapbox-gl-js/pull/9102))

🐞 Bug Fixes

- Change the type of tile id key to string to prevent hash collisions ([8979](https://github.com/mapbox/mapbox-gl-js/pull/8979))
- Prevent changing bearing via URL hash when rotation is disabled ([9156](https://github.com/mapbox/mapbox-gl-js/pull/9156))
- Fix URL hash with no bearing causing map to fail to load ([9170](https://github.com/mapbox/mapbox-gl-js/pull/9170))
- Fix bug in `GeolocateControl` where multiple instances of the control on one page may result in the user location not being updated ([9092](https://github.com/mapbox/mapbox-gl-js/pull/9092))
- Fix query `fill-extrusions` made from polygons with coincident points and polygons with less than four points ([9138](https://github.com/mapbox/mapbox-gl-js/pull/9138))
- Fix bug where `symbol-sort-key` was not used for collisions that crossed tile boundaries ([9054](https://github.com/mapbox/mapbox-gl-js/pull/9054))
- Fix bug in `DragRotateHandler._onMouseUp` getting stuck in drag/rotate ([9137](https://github.com/mapbox/mapbox-gl-js/pull/9137))
- Fix "Click on Compass" on some mobile devices (add `clickTolerance` to `DragRotateHandler`) ([9015](https://github.com/mapbox/mapbox-gl-js/pull/9015)) (h/t [Yanonix](https://github.com/Yanonix))

🐞 Bug Fixes

- Fix style validation error messages not being displayed ([9073](https://github.com/mapbox/mapbox-gl-js/pull/9073))
- Fix deferred loading of rtl-text-plugin not working for labels created from GeoJSON sources ([9091](https://github.com/mapbox/mapbox-gl-js/pull/9091))
- Fix RTL text not being rendered with the rtl-text-plugin on pages that don't allow `script-src: blob:` in their CSP.([9122](https://github.com/mapbox/mapbox-gl-js/pull/9122))

✨ Features

- Add ability to insert images into text labels using an `image` expression within a `format` expression: `"text-field": ["format", "Some text", ["image", "my-image"], "some more text"]` ([8904](https://github.com/mapbox/mapbox-gl-js/pull/8904))
- Add support for stretchable images (aka nine-part or nine-patch images). Stretchable images can be used with `icon-text-fit` to draw resized images with unstretched corners and borders. ([8997](https://github.com/mapbox/mapbox-gl-js/pull/8997))
- Add `in` expression. It can check if a value is in an array (`["in", value, array]`) or a substring is in a string (`["in", substring, string]`) ([8876](https://github.com/mapbox/mapbox-gl-js/pull/8876))
- Add `minPitch` and `maxPitch` map options ([8834](https://github.com/mapbox/mapbox-gl-js/pull/8834))
- Add `rotation`, `rotationAlignment` and `pitchAlignment` options to markers ([8836](https://github.com/mapbox/mapbox-gl-js/pull/8836)) (h/t [dburnsii](https://github.com/dburnsii))
- Add methods to Popup to manipulate container class names ([8759](https://github.com/mapbox/mapbox-gl-js/pull/8759)) (h/t [Ashot-KR](https://github.com/Ashot-KR))
- Add configurable inertia settings for panning (h/t [aMoniker](https://github.com/aMoniker))) ([#8887](https://github.com/mapbox/mapbox-gl-js/pull/8887))
- Add ability to localize UI controls ([8095](https://github.com/mapbox/mapbox-gl-js/pull/8095)) (h/t [dmytro-gokun](https://github.com/dmytro-gokun))
- Add LatLngBounds.contains() method ([7512](https://github.com/mapbox/mapbox-gl-js/issues/7512), fixed by [#8200](https://github.com/mapbox/mapbox-gl-js/pull/8200))
- Add option to load rtl-text-plugin lazily ([8865](https://github.com/mapbox/mapbox-gl-js/pull/8865))
- Add `essential` parameter to AnimationOptions that can override `prefers-reduced-motion: reduce` ([8743](https://github.com/mapbox/mapbox-gl-js/issues/8743), fixed by [#8883](https://github.com/mapbox/mapbox-gl-js/pull/8883))

🍏 Improvements

- Allow rendering full world smaller than 512px. To restore the previous limit call `map.setMinZoom(0)` ([9028](https://github.com/mapbox/mapbox-gl-js/pull/9028))
- Add an es modules build for mapbox-gl-style-spec in dist/ ([8247](https://github.com/mapbox/mapbox-gl-js/pull/8247)) (h/t [ahocevar](https://github.com/ahocevar))
- Add 'image/webp,_/_' accept header to fetch/ajax image requests when webp supported ([8262](https://github.com/mapbox/mapbox-gl-js/pull/8262))
- Improve documentation for setStyle, getStyle, and isStyleLoaded ([8807](https://github.com/mapbox/mapbox-gl-js/pull/8807))

🐞 Bug Fixes

- Fix map rendering after addImage and removeImage are used to change a used image ([9016](https://github.com/mapbox/mapbox-gl-js/pull/9016))
- Fix visibility of controls in High Contrast mode in IE ([8874](https://github.com/mapbox/mapbox-gl-js/pull/8874))
- Fix customizable url hash string in IE 11 ([8990](https://github.com/mapbox/mapbox-gl-js/pull/8990)) (h/t [pakastin](https://github.com/pakastin))
- Allow expression stops up to zoom 24 instead of 22 ([8908](https://github.com/mapbox/mapbox-gl-js/pull/8908)) (h/t [nicholas-l](https://github.com/nicholas-l))
- Fix alignment of lines in really overscaled tiles ([9024](https://github.com/mapbox/mapbox-gl-js/pull/9024))
- Fix `Failed to execute 'shaderSource' on 'WebGLRenderingContext'` errors ([9017](https://github.com/mapbox/mapbox-gl-js/pull/9017))
- Make expression validation fail on NaN ([8615](https://github.com/mapbox/mapbox-gl-js/pull/8615))
- Fix setLayerZoomRange bug that caused tiles to be re-requested ([7865](https://github.com/mapbox/mapbox-gl-js/issues/7865), fixed by [#8854](https://github.com/mapbox/mapbox-gl-js/pull/8854))
- Fix `map.showTileBoundaries` rendering ([7314](https://github.com/mapbox/mapbox-gl-js/pull/7314))
- Fix using `generateId` in conjunction with `cluster` in a GeoJSONSource ([8223](https://github.com/mapbox/mapbox-gl-js/issues/8223), fixed by [#8945](https://github.com/mapbox/mapbox-gl-js/pull/8945))
- Fix opening popup on a marker from keyboard ([6835](https://github.com/mapbox/mapbox-gl-js/pull/6835))
- Fix error thrown when request aborted ([7614](https://github.com/mapbox/mapbox-gl-js/issues/7614), fixed by [#9021](https://github.com/mapbox/mapbox-gl-js/pull/9021))
- Fix attribution control when repeatedly removing and adding it ([9052](https://github.com/mapbox/mapbox-gl-js/pull/9052))

This patch introduces two workarounds that address longstanding issues related to unbounded memory growth in Safari, including [8771](https://github.com/mapbox/mapbox-gl-js/issues/8771) and [#4695](https://github.com/mapbox/mapbox-gl-js/issues/4695). We’ve identified two memory leaks in Safari: one in the [CacheStorage](https://developer.mozilla.org/en-US/docs/Web/API/CacheStorage) API, addressed by [#8956](https://github.com/mapbox/mapbox-gl-js/pull/8956), and one in transferring data between web workers through [Transferables](https://developer.mozilla.org/en-US/docs/Web/API/Transferable), addressed by [#9003](https://github.com/mapbox/mapbox-gl-js/pull/9003).

🍏 Improvements

- Implement workaround for memory leak in Safari when using the `CacheStorage` API. ([8856](https://github.com/mapbox/mapbox-gl-js/pull/8956))
- Implement workaround for memory leak in Safari when using `Transferable` objects to transfer `ArrayBuffers` to WebWorkers. If GL-JS detects that it is running in Safari, the use of `Transferables` to transfer data to WebWorkers is disabled. ([9003](https://github.com/mapbox/mapbox-gl-js/pull/9003))
- Improve animation performance when using `map.setData`. ([8913](https://github.com/mapbox/mapbox-gl-js/pull/8913)) (h/t [msbarry](https://github.com/msbarry))

✨ Features

- Add disabled icon to GeolocateControl if user denies geolocation permission. [8871](https://github.com/mapbox/mapbox-gl-js/pull/8871))
- Add `outofmaxbounds` event to GeolocateControl, which is emitted when the user is outside of `map.maxBounds` ([8756](https://github.com/mapbox/mapbox-gl-js/pull/8756)) (h/t [MoradiDavijani](https://github.com/MoradiDavijani))
- Add `mapboxgl.getRTLTextPluginStatus()` to query the current status of the `rtl-text-plugin` to make it easier to allow clearing the plugin when necessary. (ref. [7869](https://github.com/mapbox/mapbox-gl-js/issues/7869)) ([#8864](https://github.com/mapbox/mapbox-gl-js/pull/8864))
- Allow `hash` Map option to be set as a string, which sets the map hash in the url to a custom query parameter. ([8603](https://github.com/mapbox/mapbox-gl-js/pull/8603)) (h/t [SebCorbin](https://github.com/SebCorbin))

🍏 Improvements

- Fade symbols faster when zooming out quickly, reducing overlap. ([8628](https://github.com/mapbox/mapbox-gl-js/pull/8628))
- Reduce memory usage for vector tiles that contain long strings in feature properties. ([8863](https://github.com/mapbox/mapbox-gl-js/pull/8863))

🐞 Bug Fixes

- Fix `text-variable-anchor` not trying multiple placements during collision with icons when `icon-text-fit` is enabled. ([8803](https://github.com/mapbox/mapbox-gl-js/pull/8803))
- Fix `icon-text-fit` not properly respecting vertical labels. ([8835](https://github.com/mapbox/mapbox-gl-js/pull/8835))
- Fix opacity interpolation for composition expressions. ([8818](https://github.com/mapbox/mapbox-gl-js/pull/8818))
- Fix rotate and pitch events being fired at the same time. ([8872](https://github.com/mapbox/mapbox-gl-js/pull/8872))
- Fix memory leaks that occurred during tile loading and map removal.([8813](https://github.com/mapbox/mapbox-gl-js/pull/8813) and [#8850](https://github.com/mapbox/mapbox-gl-js/pull/8850))
- Fix web-worker transfer of `ArrayBuffers` in environments where `instanceof ArrayBuffer` fails.(e.g `cypress`) ([8868](https://github.com/mapbox/mapbox-gl-js/pull/8868))