CHANGELOG.md

## main
### ✨ Features and improvements
- Reduce allocation pressure while constructing DEM data and sampling terrain elevations ([#7814](https://github.com/maplibre/maplibre-gl-js/pull/7814)) (by [@DoFabien](https://github.com/DoFabien))
- _...Add new stuff here..._

### 🐞 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 (by [@kamil-sienkiewicz-asi](https://github.com/kamil-sienkiewicz-asi))

## 6.0.0-17

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/pull/7789)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Skip `undefined` properties during worker serialization ([#7801](https://github.com/maplibre/maplibre-gl-js/pull/7801)) (by [@xavierjs](https://github.com/xavierjs))

## 6.0.0-16

### ✨ Features and improvements

- ⚠️ Update maplibre-gl-style-spec to version 25, which has a breaking change in legacy expression validation ([#7792](https://github.com/maplibre/maplibre-gl-js/issues/7792)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix cross-origin module worker loading to preserve ESM semantics ([#7796](https://github.com/maplibre/maplibre-gl-js/pull/7796)) (by [@dangkyokhoang](https://github.com/dangkyokhoang))

## 6.0.0-15

### ✨ Features and improvements

- Add `fill-layer-opacity` and `line-layer-opacity` paint properties, which apply opacity to the entire layer output uniformly ([#7570](https://github.com/maplibre/maplibre-gl-js/pull/7570)) (by [@CommanderStorm](https://github.com/CommanderStorm))
- Build main and worker in same build context to extract shared chunk ([#7745](https://github.com/maplibre/maplibre-gl-js/pull/7745)) (by [@dangkyokhoang](https://github.com/dangkyokhoang))

### 🐞 Bug fixes

- Fix conflicting reloads of tiles causing an error in `queryRenderedFeatures` ([#7765](https://github.com/maplibre/maplibre-gl-js/pull/7765)) (by [@ckolin](https://github.com/ckolin))

## 6.0.0-14

### ✨ Features and improvements

- Revert the `line-opacity`-driven offscreen rendering introduced in [#7490](https://github.com/maplibre/maplibre-gl-js/pull/7490) ([#7764](https://github.com/maplibre/maplibre-gl-js/pull/7764)) (by [@CommanderStorm](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/issues/7761)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix a race condition in geojson source after init and fast update data ([#7734](https://github.com/maplibre/maplibre-gl-js/issues/7734)) (by [@HarelM](https://github.com/HarelM))

## 6.0.0-13

### ✨ Features and improvements

- Improve `ProjectionData` matrix backing types for renderer and custom layer projection matrices ([#6316](https://github.com/maplibre/maplibre-gl-js/issues/6316)) (by [@cat0825](https://github.com/cat0825))

### 🐞 Bug fixes

- Fix camera jump on dragend with globe + terrain at low pitch ([#7736](https://github.com/maplibre/maplibre-gl-js/pull/7736)) (by @kodeezabdullah)
- Fix web font rendering by awaiting document.fonts.load() before TinySDF instantiation ([#7735](https://github.com/maplibre/maplibre-gl-js/pull/7735)) (by [@kodeezabdullah](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7303)) (by [@johanrd](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/issues/7742)) (by [@springmeyer](https://github.com/springmeyer) and [@HarelM](https://github.com/HarelM))

## 6.0.0-12

### ✨ Features and improvements

- Optimization: vertex shader opacity culling for lines and fills [#7711](https://github.com/maplibre/maplibre-gl-js/pull/7711) (by [@xavierjs](https://github.com/xavierjs))

### 🐞 Bug fixes

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

## 6.0.0-11

### ✨ Features and improvements

- Use a shared FBO for the terrain cache render to texture [#7637](https://github.com/maplibre/maplibre-gl-js/pull/7637) (by [@xavierjs](https://github.com/xavierjs))
- Use `flat` to opt out of interpolation for constant shader varyings ([#7661](https://github.com/maplibre/maplibre-gl-js/pull/7661)) (by [@birkskyum](https://github.com/birkskyum))

## 6.0.0-10

### ✨ Features and improvements

- Replace texImage2D with texStorage2D for immutable textures ([#7643](https://github.com/maplibre/maplibre-gl-js/pull/7643)) (by [@birkskyum](https://github.com/birkskyum))
- Enable mipmaps for non-power-of-two raster tiles, reducing aliasing at high pitch ([#7641](https://github.com/maplibre/maplibre-gl-js/pull/7641)) (by [@birkskyum](https://github.com/birkskyum))
- Use GLSL ES 3.00 layout qualifiers for vertex attribute locations, replacing runtime `bindAttribLocation` calls ([#7644](https://github.com/maplibre/maplibre-gl-js/pull/7644)) (by [@birkskyum](https://github.com/birkskyum))

## 6.0.0-9

### ✨ Features and improvements

- Adopt isolatedDeclarations and switch dts emitter from tsgo to oxc ([#7566](https://github.com/maplibre/maplibre-gl-js/pull/7566)) (by [@birkskyum](https://github.com/birkskyum))

### 🐞 Bug fixes

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

## 6.0.0-8

### ✨ Features and improvements

- Improve 3D terrain performance ([#7549](https://github.com/maplibre/maplibre-gl-js/pull/7549)) (by [@lucaswoj](https://github.com/lucaswoj))

## 6.0.0-7

### ✨ Features and improvements

- Replace dts-bundle-generator with rolldown-plugin-dts for 78.2x faster .d.ts generation. ([#7564](https://github.com/maplibre/maplibre-gl-js/pull/7564)) (by [@birkskyum](https://github.com/birkskyum))
- Replace ts-node with Node 24's native TypeScript support for build scripts. ([#7565](https://github.com/maplibre/maplibre-gl-js/pull/7565)) (by [@birkskyum](https://github.com/birkskyum))
- Bump typescript to v7 beta - 3.5x faster typecheck ([#7556](https://github.com/maplibre/maplibre-gl-js/pull/7556)) (by [@birkskyum](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7490)) (by [@CommanderStorm](https://github.com/CommanderStorm))
- Fix issue when map's max zoom and source max zoom are close to eachother ([#7567](https://github.com/maplibre/maplibre-gl-js/issues/7567)) (by [@HarelM](https://github.com/HarelM))

## 6.0.0-6

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/pull/7523)) (by [@safwat-halaby](https://github.com/safwat-halaby))
- Bundle with Rolldown instead of Rollup ([#7555](https://github.com/maplibre/maplibre-gl-js/pull/7555)) (by [@birkskyum](https://github.com/birkskyum))
- Optimization for Feature State: Replace String-Indexed Object with Array (up to 3.4X speedup) ([#7550](https://github.com/maplibre/maplibre-gl-js/pull/7550)) (by [@xavierjs](https://github.com/xavierjs))

## 6.0.0-5

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/pull/6254)) (by [@birkskyum](https://github.com/birkskyum))

## 6.0.0-4

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/issues/7537)) (by [@HarelM](https://github.com/HarelM))

## 6.0.0-3

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/issues/7538)) (by [@HarelM](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7404)) (by [@CommanderStorm](https://github.com/CommanderStorm))

## 6.0.0-2

### ✨ 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 avaliableWebGL (e.g. due to browser restrictions).
  You can now listen to the webgl error via `.on("error")`, or by overriding `Map._showWebGL2Error`.
  See [caniuse.com/webgl2](https://caniuse.com/webgl2) for ecosystem support and [our RFC for details](https://github.com/maplibre/maplibre-gl-js/discussions/6017). ([#7453](https://github.com/maplibre/maplibre-gl-js/pull/7453)) (by [@CommanderStorm](https://github.com/CommanderStorm))

## 6.0.0-1

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/pull/6992)) (by [HarelM](https://github.com/HarelM))
- ⚠️ Improve types for `{get,set}LayoutProperty`, `{get,set}PaintProperty` to be the actual type instead of `string`/`any` ([#7481](https://github.com/maplibre/maplibre-gl-js/pull/7481)) (by [@CommanderStorm](https://github.com/CommanderStorm))

## 6.0.0-0

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/pull/7073)) (by [@CommanderStorm](https://github.com/CommanderStorm))
- Expose `getProjectionData` function in custom layer args objects ([#7471](https://github.com/maplibre/maplibre-gl-js/pull/7471)) (by [@kubapelc](https://github.com/kubapelc))
- Marked package `sideEffects` as CSS-only in package metadata, which may improve tree-shaking and reduce bundle size in some bundlers ([#7258](https://github.com/maplibre/maplibre-gl-js/pull/7258)) (by [@CommanderStorm](https://github.com/CommanderStorm))

## 5.24.0

### ✨ Features and improvements

- GPU performance optimization: Render halo and glyph in a single pass (-40% Time Reduction) ([#7436](https://github.com/maplibre/maplibre-gl-js/pull/7436)) (by [@xavierjs](https://github.com/xavierjs))
- Optimize matrix inversions and reduce GPU stalls ([#7367](https://github.com/maplibre/maplibre-gl-js/pull/7367)) (by [@xavierjs](https://github.com/xavierjs))
- Add example showing how to measure map performance using built-in events (`load`, `idle`, `render`) ([#7077](https://github.com/maplibre/maplibre-gl-js/pull/7077)) (by [@CommanderStorm](https://github.com/CommanderStorm))

### 🐞 Bug fixes

- Fix `Popup` not updating its position when switching between terrain/globe projections ([#7468](https://github.com/maplibre/maplibre-gl-js/pull/7468)) (by [@CommanderStorm](https://github.com/CommanderStorm))
- Skip fog computation when fog opacity is zero ([#7476](https://github.com/maplibre/maplibre-gl-js/pull/7476)) (by [@CommanderStorm](https://github.com/CommanderStorm))

## 5.23.0

### ✨ Features and improvements

- Add `touchZoomRotate.setZoomRate()` and `touchZoomRotate.setZoomThreshold()` to customize touch zoom speed and pinch sensitivity ([#7271](https://github.com/maplibre/maplibre-gl-js/issues/7271)) (by [@itisyb](https://github.com/itisyb))
- Improve ability to communicate with imported scripts in workers and use `makeRequest` in workres as well ([#7451](https://github.com/maplibre/maplibre-gl-js/issues/7451)) (by [@HarelM](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/issues/7433)) (by [@YuChunTsao](https://github.com/YuChunTsao))
- perf: add a bench for terrain rendering and fix `_demMatrixCache` lookup being wasted cycles by actually using the cache ([#7400](https://github.com/maplibre/maplibre-gl-js/pull/7400)) (by [@CommanderStorm](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7380)) (by [@CommanderStorm](https://github.com/CommanderStorm))
- Ensure that a successful ArrayBuffer response from a custom protocol that is null/undefined is set to an empty ArrayBuffer ([#7427](https://github.com/maplibre/maplibre-gl-js/pull/7427)) (by [@neodescis](https://github.com/neodescis))
- Fix error in `_contextRestored` when map was initialized without a style ([#7432](https://github.com/maplibre/maplibre-gl-js/issues/7432)) (by [@mvanhorn](https://github.com/mvanhorn))
- Fix issue with the cache used for zoomLevelsToOverscale feature ([#7450](https://github.com/maplibre/maplibre-gl-js/issues/7450)) (by [@HarelM](https://github.com/HarelM))
- Update stylelint and fix old issues with the CSS (mainly change rgb to use spaces) ([#7365](https://github.com/maplibre/maplibre-gl-js/issues/7365)) (by [@HarelM](https://github.com/HarelM))

## 5.22.0

### ✨ Features and improvements

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

### 🐞 Bug fixes

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

## 5.21.1

### 🐞 Bug fixes

- Add missing `promoteId` parameter to geojson worker and refactor communication object ([#7320](https://github.com/maplibre/maplibre-gl-js/issues/7320)) (by [@HarelM](https://github.com/HarelM))

## 5.21.0

### ✨ Features and improvements

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

### 🐞 Bug fixes

- Fix incorrect popup location in case of terrain and `jumpTo` ([#7267](https://github.com/maplibre/maplibre-gl-js/issues/7267)) (by [@HarelM](https://github.com/HarelM))
- Fix memory leak in VideoSource: remove `playing` event listener and pause video on source removal ([#7279](https://github.com/maplibre/maplibre-gl-js/pull/7279)) (by [@johanrd](https://github.com/johanrd))
- Fix memory leak where typed array views retained StructArray buffers after GPU upload, preventing garbage collection ([#7280](https://github.com/maplibre/maplibre-gl-js/pull/7280)) (by [@johanrd](https://github.com/johanrd))
- Fix raster DEM tiles getting stuck in `"reloading"` state ([#7284](https://github.com/maplibre/maplibre-gl-js/pull/7284)) (by [@katemihalikova](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7286)) (by [@johanrd](https://github.com/johanrd))
- Cap tile texture reuse pool to prevent unbounded VRAM growth during rapid zoom/pan ([#7289](https://github.com/maplibre/maplibre-gl-js/pull/7289)) (by [@johanrd](https://github.com/johanrd))
- Fix Marker `click` listener not removed on `remove()`, leaking the handler added in #7028 ([#7287](https://github.com/maplibre/maplibre-gl-js/pull/7287)) (by [@johanrd](https://github.com/johanrd))
- Fix Terrain GPU resource leak: free FBO, textures, and meshes when terrain is disabled via `setTerrain(null)` ([#7288](https://github.com/maplibre/maplibre-gl-js/pull/7288)) (by [@johanrd](https://github.com/johanrd))
- Fix guard against partial layout in `PauseablePlacement` ([#7079](https://github.com/maplibre/maplibre-gl-js/pull/7079)) (by [@garethbowker](https://github.com/garethbowker))
- Fix missing tile encoding for MLT queryRenderedFeatures ([#7056](https://github.com/maplibre/maplibre-gl-js/pull/7056)) (by [@dannote](https://github.com/dannote) and [@ted-piotrowski](https://github.com/ted-piotrowski))
- Fix 3D Tiles example ([#7275](https://github.com/maplibre/maplibre-gl-js/pull/7275)) (by [@hh-hang](https://github.com/hh-hang))

## 5.20.2

### 🐞 Bug fixes

- Fix update GeoJSON when using diff update by updating geojson-vt package ([#7257](https://github.com/maplibre/maplibre-gl-js/issues/7257)) (by [@HarelM](https://github.com/HarelM))

## 5.20.1

### 🐞 Bug fixes

- Fix cannot read properties of undefined (reading 'range') by updating geojson-vt package ([#7245](https://github.com/maplibre/maplibre-gl-js/issues/7245)) (by [@HarelM](https://github.com/HarelM))
- Fix a bug where `raster-resampling: nearest` was not applied as expected ([#7247](https://github.com/maplibre/maplibre-gl-js/pull/7247)) (by [@yano-h](https://github.com/yano-h))

## 5.20.0

### ✨ Features and improvements

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

### 🐞 Bug fixes

- Fix: Distance to tile is calculated incorrectly in globe projection for high pitch angles ([#7219](https://github.com/maplibre/maplibre-gl-js/issues/7219)) (by [@jtfedd](https://github.com/jtfedd))
- Fix: Tiles are not cleared when using vector tile source `setUrl/setTiles` ([#7185](https://github.com/maplibre/maplibre-gl-js/issues/7185)) (by [@madoci](https://github.com/madoci))
- Fix: Allow opaque origins ("null") in Actor message filtering ([#7047](https://github.com/maplibre/maplibre-gl-js/pull/7047)) (by [@pcardinal](https://github.com/pcardinal))

## 5.19.0

### ✨ Features and improvements

- Change the return type of `LngLatBounds.toArray()` to use a more precise type ([#7156](https://github.com/maplibre/maplibre-gl-js/pull/7156)) (by [@n4n5](https://github.com/Its-Just-Nans))
- 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](https://github.com/maplibre/maplibre-gl-js/issues/7134)) (by [@larsmaxfield](https://github.com/larsmaxfield))
- Add source id to error message ([#7107](https://github.com/maplibre/maplibre-gl-js/pull/7107)) (by [@HarelM](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7141), fixes [#6953](https://github.com/maplibre/maplibre-gl-js/issues/6953)) (by [@pcardinal](https://github.com/pcardinal))
- Fix correct bounds calculation for GeoJSON with elevation ([#6963](https://github.com/maplibre/maplibre-gl-js/pull/6963)) (by [@simonmnt](https://github.com/simonmnt))
- Fix: support elevation in bounds calculation ([#7135](https://github.com/maplibre/maplibre-gl-js/pull/7135)) (by [@simonmnt](https://github.com/simonmnt))
- Fix Firefox "Alpha-premult deprecated for non-DOM uploads" warning ([#7128](https://github.com/maplibre/maplibre-gl-js/pull/7128)) (by [@birkskyum](https://github.com/birkskyum))
- Fix raster tiles rendering with glyph/icon atlas content after WebGL context loss ([#7126](https://github.com/maplibre/maplibre-gl-js/pull/7126)) (by [@birkskyum](https://github.com/birkskyum))
- Fix popup tip in RTL pages ([#7157](https://github.com/maplibre/maplibre-gl-js/pull/7157)) (by [@HarelM](https://github.com/HarelM))

## 5.18.0

### ✨ Features and improvements

- Add support for click events on Marker ([#7028](https://github.com/maplibre/maplibre-gl-js/pull/7028)) (by [@ganesh8068](https://github.com/ganesh8068))
- Simplify and abstract the GeoJSON Worker ([#7058](https://github.com/maplibre/maplibre-gl-js/pull/7058)) (by [@wayofthefuture](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/7076)) (by [@CommanderStorm](https://github.com/CommanderStorm))
- Migrate our API docs to zensical ([#7071](https://github.com/maplibre/maplibre-gl-js/pull/7071)) (by [@CommanderStorm](https://github.com/CommanderStorm))

### 🐞 Bug fixes

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

## 5.17.0

### ✨ Features and improvements

- Refactor `_updateWorkerData` ([#6983](https://github.com/maplibre/maplibre-gl-js/pull/6983)) (by [@wayofthefuture](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/6941)) (by [@mizmay](https://github.com/mizmay))
- Add support for container elements from different windows (e.g., popup or iframe) ([#6969](https://github.com/maplibre/maplibre-gl-js/pull/6969)) (by [@Syncret](https://github.com/Syncret))
- Migrate to @maplibre/geojson-vt ([#6995](https://github.com/maplibre/maplibre-gl-js/pull/6995)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix incorrect shader selection for text labels with inline images ([#6956](https://github.com/maplibre/maplibre-gl-js/pull/6956)) (by [@ciscorn](https://github.com/ciscorn))
- Fix marker positions not updating when zoom or pitch are changed following a change in constraints ([#6925](https://github.com/maplibre/maplibre-gl-js/issues/6925)) (by [@auspicus](https://github.com/auspicus))

## 5.16.0

### ✨ Features and improvements

- Add `padding` option to `Popup` class to prevent popups from being positioned too close to map container edges ([#5978](https://github.com/maplibre/maplibre-gl-js/issues/5978)) (by [@yuiseki](https://github.com/yuiseki) and [@lucaswoj](https://github.com/lucaswoj))
- Emit `style.load` event on style diff ([#6880](https://github.com/maplibre/maplibre-gl-js/pull/6880)) (by [@lesbaa](https://github.com/lesbaa))

### 🐞 Bug fixes

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

## 5.15.0

### ✨ Features and improvements

- Support global state expression for layer visibility ([#6659](https://github.com/maplibre/maplibre-gl-js/pull/6659)) (by [@melitele](https://github.com/melitele))
- Update Node.js version to 24.11 for development ([#6851](https://github.com/maplibre/maplibre-gl-js/pull/6851)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix `LngLatBounds#intersects` returning `false` for bounds spanning 360° or more ([#6863](https://github.com/maplibre/maplibre-gl-js/pull/6863)) (by [@lucaswoj](https://github.com/lucaswoj))
- Fix getting the right zoom for getElevationForLngLat ([#6825](https://github.com/maplibre/maplibre-gl-js/pull/6825)) (by [@HarelM](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/issues/6766)) (by [@Auspicus](https://github.com/Auspicus))
- Fix GeoJSON source throwing with undefined properties ([#6730](https://github.com/maplibre/maplibre-gl-js/issues/6730)) (by [@wayofthefuture](https://github.com/wayofthefuture))

## 5.14.0

### ✨ Features and improvements

- Prevent redundant DEM border backfilling by tracking state, moved tile manager logic to helper files ([#6756](https://github.com/maplibre/maplibre-gl-js/pull/6756)) (by [@HarelM](https://github.com/HarelM))
- Improve performance of GeoJSON `updateData`, `setData`, and overzoomed tiles ([#6738](https://github.com/maplibre/maplibre-gl-js/pull/6738), [#6772](https://github.com/maplibre/maplibre-gl-js/pull/6772)) (by [@lucaswoj](https://github.com/lucaswoj))

### 🐞 Bug fixes

- Handle consecutive duplicate points in offsetLine to avoid null values in the output. ([#5431](https://github.com/maplibre/maplibre-gl-js/issues/5431)) (by [@mmc1718](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/6747)) (by [@andrewda](https://github.com/andrewda))
- Fix canvas sources with power-of-2 dimensions rendering as black squares ([#6607](https://github.com/maplibre/maplibre-gl-js/issues/6607)) (by [@Omkarthipparthi](https://github.com/Omkarthipparthi))
- Fix `queryTerrainElevation` to use higher zoom level tiles when possible ([#6791](https://github.com/maplibre/maplibre-gl-js/pull/6791)) (by [@HarelM](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/6775)) (by [@larsmaxfield](https://github.com/larsmaxfield))
- Fix issue with `static` modifier as part of mlt package ([#6796](https://github.com/maplibre/maplibre-gl-js/pull/6796)) (by [@HarelM](https://github.com/HarelM))
- Fix GeoJSONSource tile reloading when updating data ([#6800](https://github.com/maplibre/maplibre-gl-js/pull/6800)) (by [@HarelM](https://github.com/HarelM))
- `LngLatBounds#intersects` now returns `true` when bounds touch along an edge or at a corner ([#6802](https://github.com/maplibre/maplibre-gl-js/pull/6802)) (by [@lucaswoj](https://github.com/lucaswoj))

## 5.13.0

### ✨ 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](https://github.com/maplibre/maplibre-gl-js/pull/6640)) (by [@1ec5](https://github.com/1ec5))
- GeoJSON Source Diff: improve, abstract, refactor, optimize, and fix regressions. ([#6681](https://github.com/maplibre/maplibre-gl-js/pull/6681)) (by [@wayofthefuture](https://github.com/wayofthefuture))
- GeoJSONSource setData and updateData waitForCompletion option ([#6688](https://github.com/maplibre/maplibre-gl-js/pull/6688)) (by [@wayofthefuture](https://github.com/wayofthefuture))
- Improve performance of `GeoJSONSource#updateData` ([#6668](https://github.com/maplibre/maplibre-gl-js/pull/6668)) (by [@lucaswoj](https://github.com/lucaswoj))
- GeoJSON Worker Refactor ([#6702](https://github.com/maplibre/maplibre-gl-js/pull/6702)) (by [@wayofthefuture](https://github.com/wayofthefuture))

### 🐞 Bug fixes

- Misc bug fixes related to `GeoJSONSource#updateData` ([#6689](https://github.com/maplibre/maplibre-gl-js/pull/6689), [#6690](https://github.com/maplibre/maplibre-gl-js/pull/6690), [#6704](https://github.com/maplibre/maplibre-gl-js/pull/6704)) (by [@lucaswoj](https://github.com/lucaswoj))

## 5.12.0

### ✨ Features and improvements

- Add support for MapLibre Tiles (MLT) by using `encoding: 'mlt'` in vector source definition ([#6570](https://github.com/maplibre/maplibre-gl-js/pull/6570)) (by [@Salkin975](https://github.com/Salkin975) and [@HarelM](https://github.com/HarelM))
- Slice vector tiles to improve over scale vector handling ([#6521](https://github.com/maplibre/maplibre-gl-js/pull/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](https://github.com/HarelM))
- Add reduceMotion option to Map Options ([#6661](https://github.com/maplibre/maplibre-gl-js/pull/6661)) (by [@wayofthefuture](https://github.com/wayofthefuture))

### 🐞 Bug fixes

- Fix missing `constrainOverride` setter in `TransformHelper.apply` ([#6642](https://github.com/maplibre/maplibre-gl-js/pull/6642)) (by [@larsmaxfield](https://github.com/larsmaxfield))
- Fix blank map after WebGL context restore ([#6242](https://github.com/maplibre/maplibre-gl-js/issues/6242)) (by [@ToHold](https://github.com/ToHold))

## 5.11.0

### ✨ Features and improvements

- Improve performance of `GeoJSONSource#updateData` when called on small diffs ([#6562](https://github.com/maplibre/maplibre-gl-js/pull/6562)) (by [@lucaswoj](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/4564)) (by [@1ec5](https://github.com/1ec5))
- ⚠️ Refactor SourceCache to TileManager ([#6635](https://github.com/maplibre/maplibre-gl-js/pull/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](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/pull/4564)) (by [@1ec5](https://github.com/1ec5))
- Export `now()` function in timeControl API to complete the API and enable external code to read controlled time ([#6644](https://github.com/maplibre/maplibre-gl-js/pull/6644)) (by [@bjperson](https://github.com/bjperson))
- ScaleControl CSS styling contains `white-space: nowrap` to prevent wrapping ([#6647](https://github.com/maplibre/maplibre-gl-js/pull/6647)) (by [@stroebjo](https://github.com/stroebjo))
- Fix edge fading for unloaded tiles ([#6650](https://github.com/maplibre/maplibre-gl-js/pull/6650)) (by [@wayofthefuture](https://github.com/wayofthefuture))

## 5.10.0

### ✨ Features and improvements

- Add time control API (`setNow`, `restoreNow`, `isTimeFrozen`) for deterministic rendering, enabling frame-by-frame video export and deterministic testing ([#6544](https://github.com/maplibre/maplibre-gl-js/pull/6544)) (by [@bjperson](https://github.com/bjperson))
- Use styles `isHidden` logic in the worker by adding a new optional `roundMinZoom` parameter ([#6547](https://github.com/maplibre/maplibre-gl-js/pull/6547)) (by [@HarelM](https://github.com/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](https://github.com/maplibre/maplibre-gl-js/issues/6484)) (by [@larsmaxfield](https://github.com/larsmaxfield))
- Use timeControl.now() instead of browser.now() ([#6573](https://github.com/maplibre/maplibre-gl-js/pull/6573)) (by [@bjperson](https://github.com/bjperson))

### 🐞 Bug fixes

- Contextmenu events not blocked by scrolling ([#5683](https://github.com/maplibre/maplibre-gl-js/issues/5683)) (by [@mmc1718](https://github.com/mmc1718))
- Mousemove events are not blocked by scrolling ([#6302](https://github.com/maplibre/maplibre-gl-js/issues/6302)) (by [@mmc1718](https://github.com/mmc1718))
- Dashed lines have blurry rounded caps ([#6554](https://github.com/maplibre/maplibre-gl-js/pull/6554)) (by [@lucaswoj](https://github.com/lucaswoj))
- Preserve flyTo padding when prefers-reduced-motion is enabled ([#6576](https://github.com/maplibre/maplibre-gl-js/issues/6576)) (by [@manuel-em](https://github.com/manuel-em))
- Fix setClusterOptions not triggering recluster when no data changes are pending ([#6603](https://github.com/maplibre/maplibre-gl-js/pull/6603)) (by [@andrewda](https://github.com/andrewda))

## 5.9.0

### ✨ Features and improvements

- Improve fading - dynamic bi-directional raster cross-fading and self fading ([#6469](https://github.com/maplibre/maplibre-gl-js/pull/6469)) (by [@wayofthefuture](https://github.com/wayofthefuture))
- Support for usage of line-gradient together with line-dasharray ([#6487](https://github.com/maplibre/maplibre-gl-js/pull/6487)) (by [@Samarth1696](https://github.com/Samarth1696))

### 🐞 Bug fixes

- Added `button` role to marker div to fix accessibility issues with the `aria-label` ([#6435](https://github.com/maplibre/maplibre-gl-js/issues/6435)) (by [@cmburcus](https://github.com/cmburcus))
- Fix a crash on iOS when there are too many symbols to render ([#6526](https://github.com/maplibre/maplibre-gl-js/pull/6526)) (by [@HarelM](https://github.com/HarelM))

## 5.8.0

### ✨ Features and improvements

- Enable documentation admonitions in Material for MkDocs. ([#6455](https://github.com/maplibre/maplibre-gl-js/issues/6455)) (by [@morehawes](https://github.com/morehawes))
- Switch MapEventType from type to interface to allow declaration merging ([#6436](https://github.com/maplibre/maplibre-gl-js/pull/6436)) (by [@lhapaipai](https://github.com/lhapaipai))
- Implement data-driven styling support for `line-dasharray` ([#5812](https://github.com/maplibre/maplibre-gl-js/pull/5812)) (by [@lucaswoj](https://github.com/lucaswoj))

### 🐞 Bug fixes

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

## 5.7.3

### 🐞 Bug fixes

- Fix case where retain loaded children does not retain uppermost loaded children ([#6399](https://github.com/maplibre/maplibre-gl-js/pull/6399)) (by [@wayofthefuture](https://github.com/wayofthefuture))
- Fix an issue with spread operator that caused issues in Angular and esbuild ([#6438](https://github.com/maplibre/maplibre-gl-js/pull/6438)) (by [@HarelM](https://github.com/HarelM))

## 5.7.2

### 🐞 Bug fixes

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

## 5.7.1

### 🐞 Bug fixes

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

## 5.7.0

### ✨ Features and improvements

- Pass document's `lang` to Tiny-SDF to render Simplified and Traditional Chinese characters ([#6223](https://github.com/maplibre/maplibre-gl-js/pull/6223)) (by [@mapmeld](https://github.com/mapmeld))
- Enable `global-state` expressions in layout properties ([#6209](https://github.com/maplibre/maplibre-gl-js/pull/6209)) (by [@melitele](https://github.com/melitele))
- Align typescript types generation with docs generation and avoid exporting non-exported types ([#6217](https://github.com/maplibre/maplibre-gl-js/pull/6217)) (by [@HarelM](https://github.com/HarelM))
- Add `coveringTiles` method to the public API of the map object ([#6292](https://github.com/maplibre/maplibre-gl-js/pull/6292)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Prevent original input style JSON from being mutated by `Style.set*` methods ([#6216](https://github.com/maplibre/maplibre-gl-js/pull/6216)) (by [@sruenwg](https://github.com/sruenwg))
- Fix evaluating `global-state` in paint properties with other subexpressions ([#6048](https://github.com/maplibre/maplibre-gl-js/issues/6048)) (by [@melitele](https://github.com/melitele))
- Fix enabling terrain while transitioning ([#6011](https://github.com/maplibre/maplibre-gl-js/issues/6011)) (by [@NathanMOlson](https://github.com/NathanMOlson))

## 5.6.2

### 🐞 Bug fixes

- Fix white artifacts when using non-zero elevation ([#6032](https://github.com/maplibre/maplibre-gl-js/pull/6032)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix geolocate control lock loss on window resize and zoom ([#3504](https://github.com/maplibre/maplibre-gl-js/issues/3504)) (by [@tderflinger](https://github.com/tderflinger))
- Fix a memory leak in `GeoJSONSource` when rapidly updating data ([#6163](https://github.com/maplibre/maplibre-gl-js/pull/6163)) (by [@andrewda](https://github.com/andrewda))
- Fix `Map.setTransformRequest` parameter type to include `null` ([#6179](https://github.com/maplibre/maplibre-gl-js/issues/6179)) (by [@madoci](https://github.com/madoci))
- Fix typo `_rotatePitchHandler` in the `navigation_control.ts` file ([#6207](https://github.com/maplibre/maplibre-gl-js/issues/6207)) (by [@daandewaard](https://github.com/daandewaard))

## 5.6.1

### 🐞 Bug fixes

- Fix use of `textureSize` call in color relief shader ([#5980](https://github.com/maplibre/maplibre-gl-js/pull/5980)) (by [@mwilsnd](https://github.com/mwilsnd))
- Fix Y axis transformation in projectFromLabelPlaneToClipSpace ([#6021](https://github.com/maplibre/maplibre-gl-js/pull/6021)) (by [@SinHongChen](https://github.com/SinHongChen))
- Alpha-sort all examples ([#6049](https://github.com/maplibre/maplibre-gl-js/pull/6049)) (by [@coliff](https://github.com/coliff))
- Ensure opacity is reset for popups when `locationOccludedOpacity` no longer applicable ([#6088](https://github.com/maplibre/maplibre-gl-js/pull/6088)) (by [@jammie1903](https://github.com/jammie1903))

## 5.6.0

### ✨ Features and improvements

- Add `setGlobalStateProperty()` and `getGlobalState()` to the map public API ([#5613](https://github.com/maplibre/maplibre-gl-js/pull/5613)) (by [@zbigniewmatysek-tomtom](https://github.com/zbigniewmatysek-tomtom))
- Improve tile frustum culling for globe, leading to better performance and faster loading times. ([#5865](https://github.com/maplibre/maplibre-gl-js/pull/5865)) (by [@kubapelc](https://github.com/kubapelc))
- Add new `color-relief` layer type to render hypsometric tint from terrain-RGB tiles. ([#5742](https://github.com/maplibre/maplibre-gl-js/pull/5742)) (by [@NathanMOlson](https://github.com/NathanMOlson))

### 🐞 Bug fixes

- Fix `queryRenderedFeatures` bounding box crossing antimeridian in globe view. ([#5856](https://github.com/maplibre/maplibre-gl-js/pull/5856)) (by [@msbarry](https://github.com/msbarry))
- Fix handling invalid glyph placement results along lines ([#5118](https://github.com/maplibre/maplibre-gl-js/pull/5118)) (by [@ragnarok56](https://github.com/ragnarok56))
- Fix `refreshTiles()` for vector tiles ([#5875](https://github.com/maplibre/maplibre-gl-js/pull/5875)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Revert changes to polygon intersection detection ([#5590](https://github.com/maplibre/maplibre-gl-js/pull/5590) caused issue [5864](https://github.com/maplibre/maplibre-gl-js/issues/5864)) (by [@LostDragonist](https://github.com/LostDragonist))
- Fix breaking clusters when non-integer value provided for `clusterMaxZoom` (warning is shown) ([#5929](https://github.com/maplibre/maplibre-gl-js/issues/5929)) + clarify API docs (by [@igalgh](https://github.com/igalgh))
- Fix use of reserved GLSL `switch` statement in hillshade shader ([#5972](https://github.com/maplibre/maplibre-gl-js/pull/5972)) (by [@mwilsnd](https://github.com/mwilsnd))

## 5.5.0

### ✨ Features and improvements

- Add additional hillshade methods ([#5768](https://github.com/maplibre/maplibre-gl-js/pull/5768)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Add `refreshTiles()` to the map public API ([#5806](https://github.com/maplibre/maplibre-gl-js/pull/5806)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Disable geolocate control button when permission is denied and `trackUserLocation` is off ([#5824](https://github.com/maplibre/maplibre-gl-js/pull/5824)) (by [@tsegarra](https://github.com/tsegarra))

### 🐞 Bug fixes

- Fix scroll min zoom on globe view ([#5775](https://github.com/maplibre/maplibre-gl-js/pull/5775)) (by [@msbarry](https://github.com/msbarry))
- ⚠️ Fix hillshade appearance change between 256x256 and 512x512 tiles. This will change the appearance of hillshade layers using 512x512 tiles. ([#5768](https://github.com/maplibre/maplibre-gl-js/pull/5768)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix tile expiry logic for raster and raster-dem tiles ([#5798](https://github.com/maplibre/maplibre-gl-js/pull/5798)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix opacityWhenCovered not working to hide the marker behind the globe if terrain is enabled. ([#5838](https://github.com/maplibre/maplibre-gl-js/pull/5838)) (by [@acalcutt](https://github.com/acalcutt))
- Fix transparent vector tiles sometimes showing geometry beyond tile borders when terrain is active ([#5746](https://github.com/maplibre/maplibre-gl-js/pull/5746)) (by [@kubapelc](https://github.com/kubapelc))

## 5.4.0

### ✨ Features and improvements

- Add tile LOD control to the public API ([#5719](https://github.com/maplibre/maplibre-gl-js/pull/5719)) (by [@NathanMOlson](https://github.com/NathanMOlson))

### 🐞 Bug fixes

- Fix `queryRenderedFeatures` on globe view when crossing international date line ([#5765](https://github.com/maplibre/maplibre-gl-js/pull/5765)) (by [@msbarry](https://github.com/msbarry))
- Fix globe `unproject` to clamp points to horizon ([#5771](https://github.com/maplibre/maplibre-gl-js/pull/5771)) (by [@msbarry](https://github.com/msbarry))
- Fix marker drag Coordinates give Longitude off by ±360° with Globe ([#5473](https://github.com/maplibre/maplibre-gl-js/issues/5473)) (by [@docentYT](https://github.com/docentYT))

## 5.3.1

### 🐞 Bug fixes

- Only add `aria-label` on the Marker's element if it does not already has one ([#5298](https://github.com/maplibre/maplibre-gl-js/pull/5298)) (by [@liorchamla](https://github.com/liorchamla))
- The state of `glPixelStore` is now properly cleaned after texture updates to avoid `glTexSubImage2D` calls made on the same gl context acting differently at random ([#5730](https://github.com/maplibre/maplibre-gl-js/pull/5730)) (by [@kubapelc](https://github.com/kubapelc))
- Fixes an issue with popup close button not working ([#5754](https://github.com/maplibre/maplibre-gl-js/pull/5754)) (by [@HarelM](https://github.com/HarelM))

## 5.3.0

### ✨ Features and improvements

- Added `getBounds` to GeoJSON source to allow getting the boundaries of the data in it ([#5575](https://github.com/maplibre/maplibre-gl-js/pull/5575)) (by [@HarelM](https://github.com/HarelM))
- Add a check for MouseEvent, to avoid errors when bot were crawling on website using Event instance instead of MouseEvent instance for types like mouseover, mouseout etc.. ([#5466](https://github.com/maplibre/maplibre-gl-js/pull/5466)). (by [@ToHold](https://github.com/ToHold))

### 🐞 Bug fixes

- Fix intersection detection between MultiPolygons and Points ([#5590](https://github.com/maplibre/maplibre-gl-js/pull/5590)) (by [@LostDragonist](https://github.com/LostDragonist))
- Fix issue with image rendered partially on terrain tiles ([#1559](https://github.com/maplibre/maplibre-gl-js/issues/1559)). (by [@pstaszek](https://github.com/pstaszek))
- Fix circle layer hitbox in Globe projection mode ([#5599](https://github.com/maplibre/maplibre-gl-js/pull/5599)) (by [@lucaswoj](https://github.com/lucaswoj))
- Fix excessive attribution control rerendering ([#5673](https://github.com/maplibre/maplibre-gl-js/pull/5673)) (by [@viernullvier](https://github.com/viernullvier))

## 5.2.0

### ✨ Features and improvements

- Allow opacity to be set when location becomes invisible in the globe projection. ([#5532](https://github.com/maplibre/maplibre-gl-js/pull/5532)) (by [@geekdenz](https://github.com/geekdenz))

### 🐞 Bug fixes

- Fix AbortController signal listener memory leak in frameAsync and sendAsync. ([#5561](https://github.com/maplibre/maplibre-gl-js/pull/5561)) (by [@kamil-sienkiewicz-asi](https://github.com/kamil-sienkiewicz-asi))
- Remove closeButton event listener on popup.remove(). ([#5564](https://github.com/maplibre/maplibre-gl-js/pull/5564)) (by [@kamil-sienkiewicz-asi](https://github.com/kamil-sienkiewicz-asi))
- Add missing `GeoJSONFeature` type to library export as it is exposed by `querySourceFeatures` ([#5567](https://github.com/maplibre/maplibre-gl-js/pull/5567)) (by [@HarelM](https://github.com/HarelM))

## 5.1.1

### ✨ Features and improvements

- Avoid setting marker opacity twice. ([#5441](https://github.com/maplibre/maplibre-gl-js/pull/5441)) (by [@erasta](https://github.com/erasta))

### 🐞 Bug fixes

- Fix how padding is applied when using flyTo() with Globe ([#5406](https://github.com/maplibre/maplibre-gl-js/pull/5406)) (by [@pjamessteven](https://github.com/pjamessteven))
- Fix URL hash validation to support bearing range -180 to 180 ([#5461](https://github.com/maplibre/maplibre-gl-js/issues/5461)) (by [@stanislawpuda-tomtom](https://github.com/stanislawpuda-tomtom))
- Fix variable zoom tile calculation when padding is set ([#5486](https://github.com/maplibre/maplibre-gl-js/issues/5486)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix rendering Japanese symbols which are accidentally ignored. ([#5421](https://github.com/maplibre/maplibre-gl-js/pull/5421)) (by [@Kanahiro](https://github.com/Kanahiro))

## 5.1.0

### ✨ Features and improvements

- Add support for `vertical-align` in `format` expression ([specification](https://maplibre.org/maplibre-style-spec/expressions/#format))([#5043](https://github.com/maplibre/maplibre-gl-js/pull/5043)). (by [@stanislawpuda-tomtom](https://github.com/stanislawpuda-tomtom))

### 🐞 Bug fixes

- Render frame synchronized again in requestAnimationFrame callback ([#4535](https://github.com/maplibre/maplibre-gl-js/pull/4535)) (by [@xabbu42](https://github.com/xabbu42))

## 5.0.1

### ✨ Features and improvements

- ⚠️ Revert changes made in `geometry-type` ([#5331](https://github.com/maplibre/maplibre-gl-js/pull/5331)). This change was causing issues in a [large number of styles](https://github.com/maplibre/maplibre-style-spec/issues/965) and thus reverted. (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Skip control button css hover effects on touch devices ([#5285](https://github.com/maplibre/maplibre-gl-js/pull/5285)) (by [@digitaltom](https://github.com/digitaltom))

## 5.0.0

### ✨ Features and improvements

- ~~⚠️ Changed `geometry-type` to identify "Multi-" features ([#4877](https://github.com/maplibre/maplibre-gl-js/pull/4877)). Use `$type` which has no "Multi-" support or use `in` expression to get the previous behavior.~~ (by [@HarelM](https://github.com/HarelM))
- ⚠️ `StyleLayer`'s `queryIntersectsFeature` method parameters were moved to `QueryIntersectsFeatureParams`. ([#5276](https://github.com/maplibre/maplibre-gl-js/pull/5276)) Wrap the method parameters with `{}` to solve this (by [@HarelM](https://github.com/HarelM))
- ⚠️ Support setting WebGL context options on map creation ([#5196](https://github.com/maplibre/maplibre-gl-js/pull/5196)). Previously supported WebGL context options like `antialias`, `preserveDrawingBuffer` and `failIfMajorPerformanceCaveat` must now be defined inside the `canvasContextAttributes` object on `MapOptions`. (by [@ibesora](https://github.com/ibesora))
- ⚠️ Change the return type of `on` method to return a `Subscription` to allow for easy unsubscribe ([#5080](https://github.com/maplibre/maplibre-gl-js/pull/5080)). `map.on('x').on('y')` => `map.on('x'); map.on('y');`. (by [@HarelM](https://github.com/HarelM))
- ⚠️ Change drag rotate behavior to be around the center of the screen ([#5074](https://github.com/maplibre/maplibre-gl-js/pull/5074)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Return actual altitude from queryTerrainElevation + Pass non-translated matrices to custom layer on mercator map ([#3854](https://github.com/maplibre/maplibre-gl-js/pull/3854)) (by [@sbachinin](https://github.com/sbachinin))
- ⚠️ Remove unminified prod build ([#4906](https://github.com/maplibre/maplibre-gl-js/pull/4906)). You'll need to use a different build. (by [@birkskyum](https://github.com/birkskyum))
- Allows setting the desired WebGL version to use ([#5236](https://github.com/maplibre/maplibre-gl-js/pull/5236)). You can now use `contextType` inside `canvasContextAttributes` to choose which WebGL version to use (by [@ibesora](https://github.com/ibesora))
- Dual-Stack WebGL Runtime with WebGL2 to WebGL1 Fallback ([#5198](https://github.com/maplibre/maplibre-gl-js/pull/5198)) (by [@0xFA11](https://github.com/0xFA11))
- Add support for projection type expression as part of a refactoring of the transform and projection classes ([#5139](https://github.com/maplibre/maplibre-gl-js/pull/5139)) (by [@HarelM](https://github.com/HarelM))
- Export `Event` class ([#5016](https://github.com/maplibre/maplibre-gl-js/pull/5016)) (by [@zdila](https://github.com/zdila))
- Support Vertical Perspective projection ([#5023](https://github.com/maplibre/maplibre-gl-js/pull/5023)) (by [@birkskyum](https://github.com/birkskyum))
- When clustering circles and the promoteId is set to some parameter, the promoted ID is used on non-clustered features and the cluster_id is used on clustered features. Previously the ID was undefined for non-clustered features ([#4899](https://github.com/maplibre/maplibre-gl-js/pull/4899)) (by [@popkinj](https://github.com/popkinj))
- Support Terrain in Globe projection ([#4976](https://github.com/maplibre/maplibre-gl-js/pull/4976)) (by [@birkskyum](https://github.com/birkskyum))
- Improved performance of the `coveringTiles` (tile culling) function for globe ([#4937](https://github.com/maplibre/maplibre-gl-js/pull/4937)) (by [@kubapelc](https://github.com/kubapelc))
- Catches network fetching errors such as CORS, DNS or malformed URL as actual `AJAXError` to expose HTTP request details to the `"error"` event ([#4822](https://github.com/maplibre/maplibre-gl-js/pull/4822)) (by [@jonathanlurie](https://github.com/jonathanlurie))
- Add setVerticalFieldOfView() to public API ([#4717](https://github.com/maplibre/maplibre-gl-js/issues/4717)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Disable sky when using globe and blend it in when changing to mercator ([#4853](https://github.com/maplibre/maplibre-gl-js/issues/4853)) (by [@ibesora](https://github.com/ibesora))
- New GlobeControl ([#4960](https://github.com/maplibre/maplibre-gl-js/pull/4960)) (by [@birkskyum](https://github.com/birkskyum))
- Add support for pitch > 90 degrees ([#4717](https://github.com/maplibre/maplibre-gl-js/issues/4717)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Add support for camera roll angle ([#4717](https://github.com/maplibre/maplibre-gl-js/issues/4717)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Improve performance of `queryRenderedFeatures` by using JavaScript `Set`s to assess layer membership internally ([#4777](https://github.com/maplibre/maplibre-gl-js/pull/4777)) (by [@tomhicks](https://github.com/tomhicks))
- Support globe mode ([#3963](https://github.com/maplibre/maplibre-gl-js/pull/3963)) (by [@HarelM](https://github.com/HarelM))
- Merge atmosphere and sky implementation ([#3888](https://github.com/maplibre/maplibre-gl-js/issues/3888)) (by [@Pheonor](https://github.com/Pheonor))
- Add option to display a realistic atmosphere when using a Globe projection ([#3888](https://github.com/maplibre/maplibre-gl-js/issues/3888)) (by [@Pheonor](https://github.com/Pheonor))

### 🐞 Bug fixes

- ⚠️ Fix level of detail at high pitch angle by changing which tiles to load ([#3983](https://github.com/maplibre/maplibre-gl-js/issues/3983)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix holes at the poles when terrain is used with globe ([#5232](https://github.com/maplibre/maplibre-gl-js/pull/5232)) (by [@kubapelc](https://github.com/kubapelc))
- Fix geometry artifacts when globe terrain is zoomed out too much ([#5232](https://github.com/maplibre/maplibre-gl-js/pull/5232)) (by [@kubapelc](https://github.com/kubapelc))
- Fix center being incorrectly constrained when using globe ([#5186](https://github.com/maplibre/maplibre-gl-js/pull/5186)) (by [@ibesora](https://github.com/ibesora))
- Fix atmosphere improperly blending into the background ([#5235](https://github.com/maplibre/maplibre-gl-js/pull/5235)) (by [@kubapelc](https://github.com/kubapelc))
- Fix parsing wrong hash location ([#5131](https://github.com/maplibre/maplibre-gl-js/issues/5131)) (by [@mattesCZ](https://github.com/mattesCZ))
- Fix swallowing of errors ([#4532](https://github.com/maplibre/maplibre-gl-js/issues/4532)) (by [@ibesora](https://github.com/ibesora))
- Fix erroring requests not reported on `error` handler ([#4613](https://github.com/maplibre/maplibre-gl-js/issues/4613)) (by [@ibesora](https://github.com/ibesora))
- Fix children not retained when using globe ([#5271](https://github.com/maplibre/maplibre-gl-js/pull/5271)) (by [@ibesora](https://github.com/ibesora))
- Fix symbol size increasing when looking from poles ([#5275](https://github.com/maplibre/maplibre-gl-js/pull/5275)) (by [@ibesora](https://github.com/ibesora))
- Fix globe custom layers being supplied incorrect matrices after projection transition to mercator ([#5150](https://github.com/maplibre/maplibre-gl-js/pull/5150)) (by [@kubapelc](https://github.com/kubapelc))
- Fix custom 3D models disappearing during projection transition ([#5150](https://github.com/maplibre/maplibre-gl-js/pull/5150)) (by [@kubapelc](https://github.com/kubapelc))
- Fix regression in NavigationControl compass on Firefox and Safari browsers ([#5205](https://github.com/maplibre/maplibre-gl-js/pull/5205)) (by [@raboczi](https://github.com/raboczi))
- Fix smooth mouse wheel zooming ([#5154](https://github.com/maplibre/maplibre-gl-js/pull/5154)) (by [@Al-4SW](https://github.com/Al-4SW))
- Change drag rotate behavior to be less abrupt around the center ([#5104](https://github.com/maplibre/maplibre-gl-js/pull/5104)) (by [@HarelM](https://github.com/HarelM))
- Fix regression in render world copies ([#5101](https://github.com/maplibre/maplibre-gl-js/pull/5101)) (by [@HarelM](https://github.com/HarelM))
- Fix unwanted roll when motion is interrupted ([#5083](https://github.com/maplibre/maplibre-gl-js/issues/5083)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix `geometry-type` filter expression results ([#5132](https://github.com/maplibre/maplibre-gl-js/pull/5132)) (by [@HarelM](https://github.com/HarelM))
- Fix easeTo not applying padding in globe projection ([#5134](https://github.com/maplibre/maplibre-gl-js/pull/5134)) (by [@kamil-sienkiewicz-asi](https://github.com/kamil-sienkiewicz-asi))
- Convert WebGL1 shaders to WebGL2 ([#5166](https://github.com/maplibre/maplibre-gl-js/pull/5166)) (by [@0xFA11](https://github.com/0xFA11))
- Fixes line flickering problem ([#5094](https://github.com/maplibre/maplibre-gl-js/pull/5094)) (by [@ibesora](https://github.com/ibesora))
- Fix poor performance in Chrome related to passing matrices to WebGL ([#5072](https://github.com/maplibre/maplibre-gl-js/pull/5072)) (by [@kubapelc](https://github.com/kubapelc))
- Fixes scale control for globe on zoom out ([#4897](https://github.com/maplibre/maplibre-gl-js/pull/4897)) (by [@pcardinal](https://github.com/pcardinal))
- Fixes cooperative gestures displaying the mobile help text when screen width is smaller than 480px on non-touch devices ([#5053](https://github.com/maplibre/maplibre-gl-js/pull/5053)) (by [@timsluis](https://github.com/timsluis))
- Fixes incorrect cluster radius scaling in `GeoJSONSource.setClusterOptions()` ([#5055](https://github.com/maplibre/maplibre-gl-js/pull/5055)) (by [@ciscorn](https://github.com/ciscorn))
- Improve innerHTML handling in code ([#5057](https://github.com/maplibre/maplibre-gl-js/pull/5057))) (by [@HarelM](https://github.com/HarelM))
- Fix geometry beyond tile borders being rendered ([#4868](https://github.com/maplibre/maplibre-gl-js/pull/4868)) (by [@kubapelc](https://github.com/kubapelc))
- Fix line-placed map-pitch-aligned texts being too large when viewed from some latitudes on a globe ([#4786](https://github.com/maplibre/maplibre-gl-js/issues/4786)) (by [@kubapelc](https://github.com/kubapelc))
- Disabled unsupported Fog rendering, for Terrain3D on Globe ([#4963](https://github.com/maplibre/maplibre-gl-js/pull/4963)) (by [@birkskyum](https://github.com/birkskyum))
- Fix issue where raster tile source won't fetch updates following request error ([#4890](https://github.com/maplibre/maplibre-gl-js/pull/4890)) (by [@wagewarbler](https://github.com/wagewarbler))
- Fix 3D models in custom layers not being properly occluded by the globe ([#4817](https://github.com/maplibre/maplibre-gl-js/issues/4817)) (by [@kubapelc](https://github.com/kubapelc))
- Fix issue where raster tiles were not rendered correctly when using globe and terrain ([#4912](https://github.com/maplibre/maplibre-gl-js/pull/4912)) (by [@ibesora](https://github.com/ibesora))
- Fix text not being hidden behind the globe when overlap mode was set to `always` ([#4802](https://github.com/maplibre/maplibre-gl-js/issues/4802)) (by [@kubapelc](https://github.com/kubapelc))
- Fix a single white frame being displayed when the map internally transitions from mercator to globe projection ([#4816](https://github.com/maplibre/maplibre-gl-js/issues/4816)) (by [@kubapelc](https://github.com/kubapelc))
- Fix loading of RTL plugin version 0.3.0 ([#4860](https://github.com/maplibre/maplibre-gl-js/pull/4860)) (by [@HarelM](https://github.com/HarelM))
- Fix a memory leak due to missing removal of event listener registration ([#4824](https://github.com/maplibre/maplibre-gl-js/pull/4824)) (by [@HarelM](https://github.com/HarelM))
- Improve symbol collision performance for both mercator and globe projections ([#4778](https://github.com/maplibre/maplibre-gl-js/pull/4778)) (by [@kubapelc](https://github.com/kubapelc))
- Fix bad line scaling near the poles under globe projection ([#4778](https://github.com/maplibre/maplibre-gl-js/pull/4778)) (by [@kubapelc](https://github.com/kubapelc))
- Fix globe loading many tiles at an unnecessarily high zoom level when the camera is pitched ([#4778](https://github.com/maplibre/maplibre-gl-js/pull/4778)) (by [@kubapelc](https://github.com/kubapelc))

## 5.0.0-pre.10

### ✨ Features and improvements

- Add support for projection type expression as part of a refactoring of the transform and projection classes ([#5139](https://github.com/maplibre/maplibre-gl-js/pull/5139)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Support setting WebGL context options on map creation ([#5196](https://github.com/maplibre/maplibre-gl-js/pull/5196)). Previously supported WebGL context options like `antialias`, `preserveDrawingBuffer` and `failIfMajorPerformanceCaveat` must now be defined inside the `canvasContextAttributes` object on `MapOptions`. (by [@ibesora](https://github.com/ibesora))
- Dual-Stack WebGL Runtime with WebGL2 to WebGL1 Fallback ([#5198](https://github.com/maplibre/maplibre-gl-js/pull/5198)) (by [@0xFA11](https://github.com/0xFA11))

### 🐞 Bug fixes

- Fix globe custom layers being supplied incorrect matrices after projection transition to mercator ([#5150](https://github.com/maplibre/maplibre-gl-js/pull/5150)) (by [@kubapelc](https://github.com/kubapelc))
- Fix custom 3D models disappearing during projection transition ([#5150](https://github.com/maplibre/maplibre-gl-js/pull/5150)) (by [@kubapelc](https://github.com/kubapelc))
- Fix regression in NavigationControl compass on Firefox and Safari browsers ([#5205](https://github.com/maplibre/maplibre-gl-js/pull/5205)) (by [@raboczi](https://github.com/raboczi))

## 5.0.0-pre.9

### 🐞 Bug fixes

- Fix smooth mouse wheel zooming ([#5154](https://github.com/maplibre/maplibre-gl-js/pull/5154)) (by [@Al-4SW](https://github.com/Al-4SW))
- ⚠️ Change drag rotate behavior to be less abrupt around the center ([#5104](https://github.com/maplibre/maplibre-gl-js/pull/5104)) (by [@HarelM](https://github.com/HarelM))
- Fix regression in render world copies ([#5101](https://github.com/maplibre/maplibre-gl-js/pull/5101)) (by [@HarelM](https://github.com/HarelM))
- Fix unwanted roll when motion is interrupted ([#5083](https://github.com/maplibre/maplibre-gl-js/issues/5083)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- Fix `geometry-type` filter expression results ([#5132](https://github.com/maplibre/maplibre-gl-js/pull/5132)) (by [@HarelM](https://github.com/HarelM))
- Fix easeTo not applying padding in globe projection ([#5134](https://github.com/maplibre/maplibre-gl-js/pull/5134)) (by [@kamil-sienkiewicz-asi](https://github.com/kamil-sienkiewicz-asi))
- Convert WebGL1 shaders to WebGL2 ([#5166](https://github.com/maplibre/maplibre-gl-js/pull/5166)) (by [@0xFA11](https://github.com/0xFA11))

## 5.0.0-pre.8

### ✨ Features and improvements

- ⚠️ Change the return type of `on` method to return a `Subscription` to allow for easy unsubscribe ([#5080](https://github.com/maplibre/maplibre-gl-js/pull/5080)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fixes line flickering problem ([#5094](https://github.com/maplibre/maplibre-gl-js/pull/5094)) (by [@ibesora](https://github.com/ibesora))
- Fix poor performance in Chrome related to passing matrices to WebGL ([#5072](https://github.com/maplibre/maplibre-gl-js/pull/5072)) (by [@kubapelc](https://github.com/kubapelc))

## 5.0.0-pre.7

### ✨ Features and improvements

- ⚠️ Change drag rotate behavior to be around the center of the screen ([#5074](https://github.com/maplibre/maplibre-gl-js/pull/5074)) (by [@HarelM](https://github.com/HarelM))
- Export `Event` class ([#5016](https://github.com/maplibre/maplibre-gl-js/pull/5016)) (by [@zdila](https://github.com/zdila))
- Support Vertical Perspective projection ([#5023](https://github.com/maplibre/maplibre-gl-js/pull/5023)) (by [@birkskyum](https://github.com/birkskyum))

### 🐞 Bug fixes

- Fixes scale control for globe on zoom out ([#4897](https://github.com/maplibre/maplibre-gl-js/pull/4897)) (by [@pcardinal](https://github.com/pcardinal))
- Fixes cooperative gestures displaying the mobile help text when screen width is smaller than 480px on non-touch devices ([#5053](https://github.com/maplibre/maplibre-gl-js/pull/5053)) (by [@timsluis](https://github.com/timsluis))
- Fixes incorrect cluster radius scaling in `GeoJSONSource.setClusterOptions()` ([#5055](https://github.com/maplibre/maplibre-gl-js/pull/5055)) (by [@ciscorn](https://github.com/ciscorn))
- Improve innerHTML handling in code ([#5057](https://github.com/maplibre/maplibre-gl-js/pull/5057))) (by [@HarelM](https://github.com/HarelM))
- Fix geometry beyond tile borders being rendered ([#4868](https://github.com/maplibre/maplibre-gl-js/pull/4868)) (by [@kubapelc](https://github.com/kubapelc))

## 5.0.0-pre.6

### ✨ Features and improvements

- When clustering circles and the promoteId is set to some parameter, the promoted ID is used on non-clustered features and the cluster_id is used on clustered features. Previously the ID was undefined for non-clustered features ([#4899](https://github.com/maplibre/maplibre-gl-js/pull/4899)) (by [@popkinj](https://github.com/popkinj))
- Support Terrain in Globe projection ([#4976](https://github.com/maplibre/maplibre-gl-js/pull/4976)) (by [@birkskyum](https://github.com/birkskyum))
- Improved performance of the `coveringTiles` (tile culling) function for globe ([#4937](https://github.com/maplibre/maplibre-gl-js/pull/4937)) (by [@kubapelc](https://github.com/kubapelc))

### 🐞 Bug fixes

- ⚠️ Fix level of detail at high pitch angle by changing which tiles to load ([#3983](https://github.com/maplibre/maplibre-gl-js/issues/3983)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- ~~⚠️ Fix URL parsing in `normalizeSpriteURL`, sprite URLs must be absolute ([#4962](https://github.com/maplibre/maplibre-gl-js/pull/4962))~~ (by [@jcary741](https://github.com/jcary741))

## 5.0.0-pre.5

### ✨ Features and improvements

- Catches network fetching errors such as CORS, DNS or malformed URL as actual `AJAXError` to expose HTTP request details to the `"error"` event ([#4822](https://github.com/maplibre/maplibre-gl-js/pull/4822)) (by [@jonathanlurie](https://github.com/jonathanlurie))
- Add setVerticalFieldOfView() to public API ([#4717](https://github.com/maplibre/maplibre-gl-js/issues/4717)) (by [@NathanMOlson](https://github.com/NathanMOlson))
- ⚠️ Return actual altitude from queryTerrainElevation + Pass non-translated matrices to custom layer on mercator map ([#3854](https://github.com/maplibre/maplibre-gl-js/pull/3854)) (by [@sbachinin](https://github.com/sbachinin))
- Disable sky when using globe and blend it in when changing to mercator ([#4853](https://github.com/maplibre/maplibre-gl-js/issues/4853)) (by [@ibesora](https://github.com/ibesora))
- New GlobeControl ([#4960](https://github.com/maplibre/maplibre-gl-js/pull/4960)) (by [@birkskyum](https://github.com/birkskyum))

### 🐞 Bug fixes

- Fix line-placed map-pitch-aligned texts being too large when viewed from some latitudes on a globe ([#4786](https://github.com/maplibre/maplibre-gl-js/issues/4786)) (by [@kubapelc](https://github.com/kubapelc))
- Disabled unsupported Fog rendering, for Terrain3D on Globe ([#4963](https://github.com/maplibre/maplibre-gl-js/pull/4963)) (by [@birkskyum](https://github.com/birkskyum))

## 5.0.0-pre.4

### ✨ Features and improvements

- ⚠️ Changed `geometry-type` to identify "Multi-" features ([#4877](https://github.com/maplibre/maplibre-gl-js/pull/4877)) (by [@HarelM](https://github.com/HarelM))
- Add support for pitch > 90 degrees ([#4717](https://github.com/maplibre/maplibre-gl-js/issues/4717)) (by [@NathanMOlson](https://github.com/NathanMOlson))

### 🐞 Bug fixes

- ~~⚠️ Fix order of normalizeSpriteURL and transformRequest in loadSprite ([#3897](https://github.com/maplibre/maplibre-gl-js/issues/3897))~~ (by [@jcary741](https://github.com/jcary741))
- ⚠️ Remove unminified prod build ([#4906](https://github.com/maplibre/maplibre-gl-js/pull/4906)) (by [@birkskyum](https://github.com/birkskyum))
- Fix issue where raster tile source won't fetch updates following request error ([#4890](https://github.com/maplibre/maplibre-gl-js/pull/4890)) (by [@wagewarbler](https://github.com/wagewarbler))
- Fix 3D models in custom layers not being properly occluded by the globe ([#4817](https://github.com/maplibre/maplibre-gl-js/issues/4817)) (by [@kubapelc](https://github.com/kubapelc))
- Fix issue where raster tiles were not rendered correctly when using globe and terrain ([#4912](https://github.com/maplibre/maplibre-gl-js/pull/4912)) (by [@ibesora](https://github.com/ibesora))

## 5.0.0-pre.3

### ✨ Features and improvements

- Add support for camera roll angle ([#4717](https://github.com/maplibre/maplibre-gl-js/issues/4717)) (by [@NathanMOlson](https://github.com/NathanMOlson))

### 🐞 Bug fixes

- Fix text not being hidden behind the globe when overlap mode was set to `always` ([#4802](https://github.com/maplibre/maplibre-gl-js/issues/4802)) (by [@kubapelc](https://github.com/kubapelc))
- Fix a single white frame being displayed when the map internally transitions from mercator to globe projection ([#4816](https://github.com/maplibre/maplibre-gl-js/issues/4816)) (by [@kubapelc](https://github.com/kubapelc))
- Fix loading of RTL plugin version 0.3.0 ([#4860](https://github.com/maplibre/maplibre-gl-js/pull/4860)) (by [@HarelM](https://github.com/HarelM))

## 5.0.0-pre.2

### ✨ Features and improvements

- Improve performance of `queryRenderedFeatures` by using JavaScript `Set`s to assess layer membership internally ([#4777](https://github.com/maplibre/maplibre-gl-js/pull/4777)) (by [@tomhicks](https://github.com/tomhicks))

### 🐞 Bug fixes

- Fix a memory leak due to missing removal of event listener registration ([#4824](https://github.com/maplibre/maplibre-gl-js/pull/4824)) (by [@HarelM](https://github.com/HarelM))
- Improve symbol collision performance for both mercator and globe projections ([#4778](https://github.com/maplibre/maplibre-gl-js/pull/4778)) (by [@kubapelc](https://github.com/kubapelc))
- Fix bad line scaling near the poles under globe projection ([#4778](https://github.com/maplibre/maplibre-gl-js/pull/4778)) (by [@kubapelc](https://github.com/kubapelc))
- Fix globe loading many tiles at an unnecessarily high zoom level when the camera is pitched ([#4778](https://github.com/maplibre/maplibre-gl-js/pull/4778)) (by [@kubapelc](https://github.com/kubapelc))

## 5.0.0-pre.1

### ✨ Features and improvements

- Support globe mode ([#3963](https://github.com/maplibre/maplibre-gl-js/pull/3963)) (by [@HarelM](https://github.com/HarelM))
- Merge atmosphere and sky implementation ([#3888](https://github.com/maplibre/maplibre-gl-js/issues/3888)) (by [@Pheonor](https://github.com/Pheonor))
- Add option to display a realistic atmosphere when using a Globe projection ([#3888](https://github.com/maplibre/maplibre-gl-js/issues/3888)) (by [@Pheonor](https://github.com/Pheonor))

## 4.7.1

### 🐞 Bug fixes

- Fix circle won't render on mesa 24.1 with AMD GPU ([#4062](https://github.com/maplibre/maplibre-gl-js/issues/4062)) (by [@cutephoton](https://github.com/cutephoton))
- Fix hash router for urls ending with a hashtag ([#4730](https://github.com/maplibre/maplibre-gl-js/pull/4730)) (by [@birkskyum](https://github.com/birkskyum))
- Replace rollup-plugin-sourcemaps with rollup-plugin-sourcemaps2 ([#4740](https://github.com/maplibre/maplibre-gl-js/pull/4740)) (by [@birkskyum](https://github.com/birkskyum))

## 4.7.0

### ✨ Features and improvements

- Support multiple layers in `map.on`, `map.once` and `map.off` methods ([#4570](https://github.com/maplibre/maplibre-gl-js/pull/4570)) (by [@pstaszek](https://github.com/pstaszek))
- Ensure GeoJSON cluster sources emit a console warning if `maxzoom` is less than or equal to `clusterMaxZoom` since in this case you may see unexpected results. ([#4604](https://github.com/maplibre/maplibre-gl-js/pull/4604)) (by [@andrewharvey](https://github.com/andrewharvey))

### 🐞 Bug fixes

- Heatmap Fix for 3D terrain ([#4571](https://github.com/maplibre/maplibre-gl-js/pull/4571)) (by [@Samarth1696](https://github.com/Samarth1696))
- Fix Map#off to not remove listener with layer(s) registered with Map#once ([#4592](https://github.com/maplibre/maplibre-gl-js/pull/4592)) (by [@pstaszek](https://github.com/pstaszek))
- Improve types a bit for `addSource` and `getSource` ([#4616](https://github.com/maplibre/maplibre-gl-js/pull/4616)) (by [@HarelM](https://github.com/HarelM))
- Fix the color near the horizon when terrain is enabled without any sky ([#4607](https://github.com/maplibre/maplibre-gl-js/pull/4607)) (by [@HarelM](https://github.com/HarelM))
- Fix bug where `fitBounds` and `cameraForBounds` would not display across the 180th meridian (antimeridian) ([#4620](https://github.com/maplibre/maplibre-gl-js/pull/4620)) (by [@YoelRidgway](https://github.com/YoelRidgway))
- Fix white flickering on map resize ([#4158](https://github.com/maplibre/maplibre-gl-js/issues/4158)) (by [@pstaszek](https://github.com/pstaszek))
- Fixed a performance regression related to symbol placement ([#4599](https://github.com/maplibre/maplibre-gl-js/pull/4599)) (by [@kubapelc](https://github.com/kubapelc))
- Fix a bug where cloning a Transform instance didn't include the `lngRange`. This caused a bug where using `transformCameraUpdate` caused the `maxBounds` to stop working just for east/west bounds. ([#4625](https://github.com/maplibre/maplibre-gl-js/pull/4625)) (by [@tomhicks](https://github.com/tomhicks))

## 4.6.0

### ✨ Features and improvements

- Prefer local glyph rendering for all CJKV characters, not just those in the CJK Unified Ideographs, Hiragana, Katakana, and Hangul Syllables blocks. ([#4560](https://github.com/maplibre/maplibre-gl-js/pull/4560))) (by [@1ec5](https://github.com/1ec5))

### 🐞 Bug fixes

- Fix right-to-left layout of labels that contain characters in the Arabic Extended-B code block. ([#4536](https://github.com/maplibre/maplibre-gl-js/pull/4536)) (by [@1ec5](https://github.com/1ec5))
- Fix 3D map freezing when camera is adjusted against map bounds. ([#4537](https://github.com/maplibre/maplibre-gl-js/issues/4537)) (by [@larsmaxfield](https://github.com/larsmaxfield))
- Fix `getStyle()` to return a clone so the object cannot be internally changed ([#4488](https://github.com/maplibre/maplibre-gl-js/pull/4488)) (by [@gavinr-maps](https://github.com/gavinr-maps))
- Fix issues with setting sky to `undefined` ([#4587](https://github.com/maplibre/maplibre-gl-js/pull/4587))) (by [@HarelM](https://github.com/HarelM))

## 4.5.2

### ✨ Features and improvements

- Emit events when the cooperative gestures option has prevented a gesture. ([#4470](https://github.com/maplibre/maplibre-gl-js/pull/4470)) (by [@tomhicks](https://github.com/tomhicks))
- Enable anisotropic filtering only when the pitch is greater than 20 degrees to preserve image sharpness on flat or slightly tilted maps. ([#4525](https://github.com/maplibre/maplibre-gl-js/pull/4525)) (by [@e-k-m](https://github.com/e-k-m))

### 🐞 Bug fixes

- Fix camera being able to move into 3D terrain ([#1542](https://github.com/maplibre/maplibre-gl-js/issues/1542)) (by [@chrneumann](https://github.com/chrneumann))

## 4.5.1

### ✨ Features and improvements

- Allow trackpad pinch gestures to break through the `cooperativeGestures` setting, bringing it in line with other embedded map behaviours, such as Google Maps and Mapbox. ([#4465](https://github.com/maplibre/maplibre-gl-js/pull/4465)) (by [@tomhicks](https://github.com/tomhicks))
- Expose projection matrix parameters ([#3136](https://github.com/maplibre/maplibre-gl-js/pull/3136)) (by [@birkskyum](https://github.com/birkskyum))
- Add option to position markers at subpixel coordinates to prevent markers jumping on `moveend` ([#4458](https://github.com/maplibre/maplibre-gl-js/pull/4458)) (by [@JeroendeJong](https://github.com/JeroendeJong))

### 🐞 Bug fixes

- Fix lag on fast map zoom ([#4366](https://github.com/maplibre/maplibre-gl-js/pull/4366)) (by [@Codebreaker101](https://github.com/Codebreaker101))
- Fix unguarded read access to possibly undefined object ([#4431](https://github.com/maplibre/maplibre-gl-js/pull/4431)) (by [@birdofpreyru](https://github.com/birdofpreyru))
- Fix remove hash string when map is removed ([#4427](https://github.com/maplibre/maplibre-gl-js/pull/4427)) (by [@smellman](https://github.com/smellman))
- Fix GeolocateControl may be added twice when calling addControl/removeControl/addControl rapidly ([#4454](https://github.com/maplibre/maplibre-gl-js/pull/4454)) (by [@nkundu](https://github.com/nkundu))
- Fix `style.loadURL` abort error being logged when removing style ([#4425](https://github.com/maplibre/maplibre-gl-js/pull/4425)) (by [@madoci](https://github.com/madoci))
- Fix vector tiles not loading when html is opened via "resource://android" (i.e., the assets folder) in GeckoView on Android ([#4451](https://github.com/maplibre/maplibre-gl-js/issues/4451)) (by [@jwoodwardtfx](https://github.com/jwoodwardtfx))

## 4.5.0

### ✨ Features and improvements

- Add sky implementation according to spec ([#3645](https://github.com/maplibre/maplibre-gl-js/pull/3645)) (by [@prozessor13](https://github.com/prozessor13))

### 🐞 Bug fixes

- Fix (de)serialization of extends of built-ins (currently only AjaxError) not working correctly in web_worker_transfer. Also refactored related web_worker_transfer code and added more tests ([#4024](https://github.com/maplibre/maplibre-gl-js/issues/4024)) (by [@oberhamsi](https://github.com/oberhamsi))

## 4.4.1

### 🐞 Bug fixes

- Fix `terrain` listener memory leak when adding and removing Marker ([#4284](https://github.com/maplibre/maplibre-gl-js/pull/4284)) (by [@rczobor](https://github.com/rczobor))

## 4.4.0

### ✨ Features and improvements

- Improve animation curve when easeTo and flyTo with constraints ([#3793](https://github.com/maplibre/maplibre-gl-js/pull/3793)) (by [@sbachinin](https://github.com/sbachinin))
- For filled extrusions, calculate the elevation per polygon ([#3313](https://github.com/maplibre/maplibre-gl-js/issues/3313)) (by [@antonmarsden](https://github.com/antonmarsden))
- Add events to `GeolocateControl` to allow a more granular interaction ([#3847](https://github.com/maplibre/maplibre-gl-js/pull/3847)) (by [@MeysamRT76](https://github.com/MeysamRT76))
- Make `MapOptions.style` optional to be consistent with `Map.setStyle(null)` ([#4151](https://github.com/maplibre/maplibre-gl-js/pull/4151)) (by [@vicb](https://github.com/vicb))
- Use Autoprefixer to handle vendor prefixes in CSS ([#4165](https://github.com/maplibre/maplibre-gl-js/pull/4165)) (by [@coliff](https://github.com/coliff))
- Make `aria-label` configurable for Map, Marker and Popup ([#4147](https://github.com/maplibre/maplibre-gl-js/pull/4147)) (by [@thom4parisot](https://github.com/thom4parisot))
- Map `<canvas>` is focusable only when interactive ([#4147](https://github.com/maplibre/maplibre-gl-js/pull/4147)) (by [@thom4parisot](https://github.com/thom4parisot))
- "Accept" headers set in Request Transformers are not overwritten ([#4210](https://github.com/maplibre/maplibre-gl-js/pull/4210)) (by [@CalRobert](https://github.com/CalRobert))
- ⚠️ Rename projMatrix to modelViewProjectionMatrix. Also rename invProjMatrix, alignedProjMatrix accordingly ([#4215](https://github.com/maplibre/maplibre-gl-js/pull/4215)) (by [@birkskyum](https://github.com/birkskyum))
- Publish an unminified prod build ([#4265](https://github.com/maplibre/maplibre-gl-js/pull/4265)) (by [@birkskyum](https://github.com/birkskyum))

### 🐞 Bug fixes

- ⚠️ Allow breaking lines in labels before a left parenthesis ([#4138](https://github.com/maplibre/maplibre-gl-js/pull/4138)) (by [@candux](https://github.com/candux))
- ⚠️ Fix ignoring embedded line breaks when `symbol-placement` is `line` or `line-center` ([#4124](https://github.com/maplibre/maplibre-gl-js/pull/4124)) (by [@LostDragonist](https://github.com/LostDragonist))
- Ensure loseContext exists before calling it ([#4245](https://github.com/maplibre/maplibre-gl-js/pull/4245)) (by [@archmoj](https://github.com/archmoj))
- Update deprecated `-ms-high-contrast` vendor prefix to `(forced-colors: active)` and `(prefers-color-scheme: light)` as appropriate ([#4250](https://github.com/maplibre/maplibre-gl-js/pull/4250)) (by [@stacy-rendall](https://github.com/stacy-rendall))

## 4.3.2

### 🐞 Bug fixes

- Fix an issue with `moveend` zoom being different than the actual current zoom ([#4132](https://github.com/maplibre/maplibre-gl-js/pull/4132)) (by [@HarelM](https://github.com/HarelM))

## 4.3.1

### 🐞 Bug fixes

- Fix drift in zoom that may happen during flyTo and easeTo due to freezeElevation logic. ([#3878](https://github.com/maplibre/maplibre-gl-js/issues/3878)) (by [@olsen232](https://github.com/olsen232))

## 4.3.0

### ✨ Features and improvements

- Add `getData` method for GeoJSON Sources to provide the possibility to obtain all the source's features ([#4082](https://github.com/maplibre/maplibre-gl-js/pull/4082)) (by [@smellyshovel](https://github.com/smellyshovel))
- Allow cross-fading between raster tile source updates at the same zoom level ([#4072](https://github.com/maplibre/maplibre-gl-js/pull/4072)) (by [@wagewarbler](https://github.com/wagewarbler))

### 🐞 Bug fixes

- Fix normalizeSpriteURL before transformRequest throwing an Error with relative URLs ([#3897](https://github.com/maplibre/maplibre-gl-js/issues/3897)) (by [@jcary741](https://github.com/jcary741))
- Fix return type of map.cameraForBounds ([#3760](https://github.com/maplibre/maplibre-gl-js/issues/3760)) (by [@keichan34](https://github.com/keichan34))
- Fix to run benchmark with MAPLIBRE_STYLES environment variable ([#2122](https://github.com/maplibre/maplibre-gl-js/issues/2122)) (by [@smellman](https://github.com/smellman))
- Fix symbol collisions using inaccurate and sometimes entirely wrong collision boxes when the map is pitched or rotated ([#210](https://github.com/maplibre/maplibre-gl-js/issues/210)) (by [@kubapelc](https://github.com/kubapelc))
- Fix `text-translate` and `icon-translate` behaving weirdly and inconsistently with other `-translate` properties ([#3456](https://github.com/maplibre/maplibre-gl-js/issues/3456)) (by [@kubapelc](https://github.com/kubapelc))
- Fix symbol collision debug view (`showCollisionBoxes`) not showing the actual bounding boxes used for collision and click areas. The displayed boxes now match actual collision boxes exactly ([#4071](https://github.com/maplibre/maplibre-gl-js/pull/4071)) (by [@kubapelc](https://github.com/kubapelc))
- Fix symbol collision boxes not being accurate for variable-anchor symbols ([#4071](https://github.com/maplibre/maplibre-gl-js/pull/4071)) (by [@kubapelc](https://github.com/kubapelc))
- Fix icon collision boxes using `text-translate` property for translation instead of the correct `icon-translate` ([#4071](https://github.com/maplibre/maplibre-gl-js/pull/4071)) (by [@kubapelc](https://github.com/kubapelc))

## 4.2.0

### ✨ Features and improvements

- Update `Popup`'s methods `addClass` and `removeClass` to return an instance of Popup ([#3975](https://github.com/maplibre/maplibre-gl-js/pull/3975)) (by [@ferdicus](https://github.com/ferdicus))
- New map option to decide whether to cancel previous pending tiles while zooming in ([#4051](https://github.com/maplibre/maplibre-gl-js/pull/4051)) (by [@DanielForniessoria-TomTom](https://github.com/DanielForniessoria-TomTom))
- Sprites include optional textFitHeight and textFitWidth values ([#4019](https://github.com/maplibre/maplibre-gl-js/pull/4019)) (by [@DavidBuerer](https://github.com/DavidBuerer))
- Add support for `distance` expression ([#4076](https://github.com/maplibre/maplibre-gl-js/pull/4076)) (by [@HarelM](https://github.com/HarelM))

## 4.1.3

### ✨ Features and improvements

- Added const enum for actor messages to improve readability and maintainability. In tsconfig.json, `isolatedModules` flag is set to false in favor of generated JS size. ([#3879](https://github.com/maplibre/maplibre-gl-js/pull/3879)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))

### 🐞 Bug fixes

- Fix different unwanted panning changes at the end of a panning motion, that happen on a large screen ([#3935](https://github.com/maplibre/maplibre-gl-js/issues/3935)) (by [@olsen232](https://github.com/olsen232))
- Fix image sources not being marked as loaded on error ([#3981](https://github.com/maplibre/maplibre-gl-js/pull/3981)) (by [@tzetter](https://github.com/tzetter))
- Fix ScaleControl options should be optional. ([#4002](https://github.com/maplibre/maplibre-gl-js/pull/4002)) (by [@vicb](https://github.com/vicb))
- Fix race condition in `SourceCache` that makes unit tests unstable. Eliminate a redundant 'visibility' event fired from Style class. ([#3992](https://github.com/maplibre/maplibre-gl-js/pull/3992)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Fix paint property not being updated by setPaintProperty ([#2651](https://github.com/maplibre/maplibre-gl-js/issues/2651)) (by [@kumilange](https://github.com/kumilange))

## 4.1.2

### ✨ Features and improvements

- Hide Popup when its parent Marker is behind terrain ([#3865](https://github.com/maplibre/maplibre-gl-js/pull/3865)) (by [@sbachinin](https://github.com/sbachinin))

### 🐞 Bug fixes

- Fix type definition on `localIdeographFontFamily` ([#3896](https://github.com/maplibre/maplibre-gl-js/pull/3896)) (by [@Kanahiro](https://github.com/Kanahiro))
- Fix unwanted panning changes at the end of a panning motion ([#3872](https://github.com/maplibre/maplibre-gl-js/issues/3872)) (by [@olsen232](https://github.com/olsen232))
- Fix `close` events being fired for popups that aren't open ([#3901](https://github.com/maplibre/maplibre-gl-js/pull/3901)) (by [@tzetter](https://github.com/tzetter))

## 4.1.1

### ✨ Features and improvements

- Improve animation curve when easeTo and flyTo with constraints ([#3793](https://github.com/maplibre/maplibre-gl-js/pull/3793)) (by [@sbachinin](https://github.com/sbachinin))

### 🐞 Bug fixes

- Fix unwanted zoom changes at the end of a panning motion ([#2094](https://github.com/maplibre/maplibre-gl-js/issues/2094)) (by [@olsen232](https://github.com/olsen232))

## 4.1.0

### ✨ Features and improvements

- Add option to position popup at subpixel coordinates to allow for smooth animations ([#3710](https://github.com/maplibre/maplibre-gl-js/pull/3710)) (by [@ericmagnuson](https://github.com/ericmagnuson))
- Constrain horizontal panning when renderWorldCopies is set to false ([#3738](https://github.com/maplibre/maplibre-gl-js/pull/3738)) (by [@sbachinin](https://github.com/sbachinin))

### 🐞 Bug fixes

- Fix popup appearing far from marker that was moved to a side globe ([#3712](https://github.com/maplibre/maplibre-gl-js/pull/3712)) (by [@sbachinin](https://github.com/sbachinin))
- Set text color to ensure contrast in the attribution pill ([#3737](https://github.com/maplibre/maplibre-gl-js/pull/3737)) (by [@Fil](https://github.com/Fil))
- Fix memory leak in Worker when map is removed ([#3734](https://github.com/maplibre/maplibre-gl-js/pull/3734)) (by [@pasieronen](https://github.com/pasieronen))
- Fix issue with `FullscreenControl` when MapLibre is within a [ShadowRoot](https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot) ([#3573](https://github.com/maplibre/maplibre-gl-js/pull/3573)) (by [@dschep](https://github.com/dschep))
- Fix performance regression with `setRTLTextPlugin` which can cause 1 or 2 extra frames to render. ([#3728](https://github.com/maplibre/maplibre-gl-js/pull/3728)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))

## 4.0.2

### 🐞 Bug fixes

- Fix `Style.setState` ignoring validate flag ([#3709](https://github.com/maplibre/maplibre-gl-js/issues/3709)) (by [@dsshep](https://github.com/dsshep))
- Fix marker flying off near horizon ([#3704](https://github.com/maplibre/maplibre-gl-js/pull/3704)) (by [@sbachinin](https://github.com/sbachinin))

## 4.0.1

### ✨ Features and improvements

- Add `setUrl` method to RasterTileSource to dynamically update existing TileJSON resource. ([#3700](https://github.com/maplibre/maplibre-gl-js/pull/3700)) (by [@manuelroth](https://github.com/manuelroth))

### 🐞 Bug fixes

- Fix Marker losing opacity after window resize ([#3656](https://github.com/maplibre/maplibre-gl-js/pull/3656)) (by [@sbachinin](https://github.com/sbachinin))
- Fix vector tiles not loading when html is opened via "file://" ([#3681](https://github.com/maplibre/maplibre-gl-js/pull/3681)) (by [@sbachinin](https://github.com/sbachinin))

## 4.0.0

### ✨ Features and improvements

- ⚠️ Remove all global getters and setters from `maplibregl`, this is to avoid the need to use a global object and allow named exports/imports ([#3601](https://github.com/maplibre/maplibre-gl-js/pull/3601)). this means the the following methods have changed: (by [@HarelM](https://github.com/HarelM))
    - `maplibregl.version` => `getVersion()`
    - `maplibregl.workerCount` => `getWorkerCount()`, `setWorkerCount(...)`
    - `maplibregl.maxParallelImageRequests` => `getMaxParallelImageRequests()`, `setMaxParallelImageRequests(...)`
    - `maplibregl.workerUrl` => `getWorkerUrl()`, `setWorkerUrl(...)`

- ⚠️ Change attribution to be on by default, change `MapOptions.attributionControl` to be the type that the control handles, removed `MapOptions.customAttribution` ([#3618](https://github.com/maplibre/maplibre-gl-js/pull/3618)). Note: showing the logo of MapLibre is not required for using MapLibre. (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed cooperative gesture config and removed the strings from it in favor of the locale variable ([#3621](https://github.com/maplibre/maplibre-gl-js/pull/3621)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the terrain enable disable locale key to match the other keys' styles, updated the typings to allow using locale with more ease ([#3621](https://github.com/maplibre/maplibre-gl-js/pull/3621)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Add the ability to import a script in the worker thread and call `addProtocol` and `removeProtocol` there ([#3459](https://github.com/maplibre/maplibre-gl-js/pull/3459)) - this also changed how `addSourceType` works since now you'll need to load the script with `maplibregl.importScriptInWorkers`. (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changes `addProtocol` to be promise-based without the usage of callbacks and cancelable ([#3433](https://github.com/maplibre/maplibre-gl-js/pull/3433)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Moved the `addSourceType` to be a part of the global maplibregl object instead of being per map object ([#3420](https://github.com/maplibre/maplibre-gl-js/pull/3420)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Removed callback usage from `map.loadImage` in continue to below change ([#3422](https://github.com/maplibre/maplibre-gl-js/pull/3422)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `GeoJSONSource`'s `getClusterExpansionZoom`, `getClusterChildren`, `getClusterLeaves` methods to return a `Promise` instead of a callback usage ([#3421](https://github.com/maplibre/maplibre-gl-js/pull/3421)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `setRTLTextPlugin` function to return a promise instead of using callback ([#3418](https://github.com/maplibre/maplibre-gl-js/pull/3418)) this also changed how the RTL plugin code is handled internally by splitting the main thread and worker thread code. (by [@HarelM](https://github.com/HarelM))
- ⚠️ Remove `setCooperativeGestures` and `getCooperativeGestures` functions in favor of `cooperativeGestures` handler which now has an `enabled()` or `disabled()` methods ([#3430](https://github.com/maplibre/maplibre-gl-js/pull/3430)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the underlying worker communication from callbacks to promises. This has a breaking effect on the implementation of custom `WorkerSource` and how it behaves ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `Source` interface to return promises instead of callbacks ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed all the sources to be promises based. ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `map.loadImage` method to return a `Promise` instead of a callback usage ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- Add "opacity" option and `setOpacity` method to Marker ([#3620](https://github.com/maplibre/maplibre-gl-js/pull/3620)) (by [@sbachinin](https://github.com/sbachinin))
- Created a new example showing how to place a threejs scene as a `CustomLayer` over maplibre 3d-terrain ([#3429](https://github.com/maplibre/maplibre-gl-js/pull/3429)) (by [@MichaelLangbein](https://github.com/MichaelLangbein))
- Changed `ImageRequest` to be `Promise` based ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- Improved precision and added a subtle fade transition to marker opacity changes ([#3431](https://github.com/maplibre/maplibre-gl-js/pull/3431)) (by [@SnailBones](https://github.com/SnailBones))
- Adds support for terrain in `setStyle` with diff method ([#3515](https://github.com/maplibre/maplibre-gl-js/pull/3515), [#3463](https://github.com/maplibre/maplibre-gl-js/pull/3463)) (by [@HarelM](https://github.com/HarelM))
- Upgraded to use Node JS 20 and removed the dependency of `gl` package from the tests to allow easier development setup. ([#3452](https://github.com/maplibre/maplibre-gl-js/pull/3452)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix wheel zoom to be into the same direction above or under the horizon ([#3398](https://github.com/maplibre/maplibre-gl-js/issues/3398)) (by [@Pheonor](https://github.com/Pheonor))
- Fix \_cameraForBoxAndBearing not fitting bounds properly when using asymmetrical camera viewport and bearing.([#3591](https://github.com/maplibre/maplibre-gl-js/pull/3591)) (by [@fcwheat](https://github.com/fcwheat))
- Fix missing export `Map` type in the `d.ts` file ([#3564](https://github.com/maplibre/maplibre-gl-js/pull/3564)) (by [@HarelM](https://github.com/HarelM))
- Fix the shifted mouse events after a css transform scale on the map container ([#3437](https://github.com/maplibre/maplibre-gl-js/pull/3437)) (by [@HarelM](https://github.com/HarelM))
- Fix markers remaining transparent when disabling terrain ([#3431](https://github.com/maplibre/maplibre-gl-js/pull/3431)) (by [@SnailBones](https://github.com/SnailBones))
- Fix labels disappearing when enabling terrain at high zoom ([#3545](https://github.com/maplibre/maplibre-gl-js/pull/3545)) (by [@SnailBones](https://github.com/SnailBones))
- Fix zooming outside the central globe when terrain 3D is enabled ([#3425](https://github.com/maplibre/maplibre-gl-js/pull/3425)) (by [@sbachinin](https://github.com/sbachinin))
- Fix cursor being shown indefinitely as a pointer when removing a popup with its `trackPointer` method active ([#3434](https://github.com/maplibre/maplibre-gl-js/pull/3434)) (by [@simondriesen](https://github.com/simondriesen))
- Fix a bug in showing cooperative gestures when scroll zoom is disabled ([#2498](https://github.com/maplibre/maplibre-gl-js/issues/2498)) (by [@HarelM](https://github.com/HarelM))
- Handle loading of empty raster tiles (204 No Content) ([#3428](https://github.com/maplibre/maplibre-gl-js/pull/3428)) (by [@petrsloup](https://github.com/petrsloup))
- Fixes a security issue in `Actor` against XSS attacks in postMessage / onmessage ([#3239](https://github.com/maplibre/maplibre-gl-js/issues/3239)) (by [@HarelM](https://github.com/HarelM))

## 4.0.0-pre.6

### ✨ Features and improvements

- ⚠️ Change attribution to be on by default, change `MapOptions.attributionControl` to be the type that the control handles, removed `MapOptions.customAttribution` ([#3618](https://github.com/maplibre/maplibre-gl-js/pull/3618)). Note: showing the logo of MapLibre is not required for using MapLibre. (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed cooperative gesture config and removed the strings from it in favor of the locale variable ([#3621](https://github.com/maplibre/maplibre-gl-js/pull/3621)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the terrain enable disable locale key to match the other keys' styles, updated the typings to allow using locale with more ease ([#3621](https://github.com/maplibre/maplibre-gl-js/pull/3621)) (by [@HarelM](https://github.com/HarelM))
- Add "opacity" option and "setOpacity" method to Marker ([#3620](https://github.com/maplibre/maplibre-gl-js/pull/3620)) (by [@sbachinin](https://github.com/sbachinin))

## 4.0.0-pre.5

### ✨ Features and improvements

- ⚠️ Remove all global getters and setters from `maplibregl`, this is to avoid the need to use a global object and allow named exports/imports ([#3601](https://github.com/maplibre/maplibre-gl-js/pull/3601)). This means the the following methods have changed: (by [@HarelM](https://github.com/HarelM))
    - `maplibregl.version` => `getVersion()`
    - `maplibregl.workerCount` => `getWorkerCount()`, `setWorkerCount(...)`
    - `maplibregl.maxParallelImageRequests` => `getMaxParallelImageRequests()`, `setMaxParallelImageRequests(...)`
    - `maplibregl.workerUrl` => `getWorkerUrl()`, `setWorkerUrl(...)`

### 🐞 Bug fixes

- Fix wheel zoom to be into the same direction above or under the horizon ([#3398](https://github.com/maplibre/maplibre-gl-js/issues/3398)) (by [@Pheonor](https://github.com/Pheonor))
- Fix \_cameraForBoxAndBearing not fitting bounds properly when using asymmetrical camera viewport and bearing ([#3591](https://github.com/maplibre/maplibre-gl-js/pull/3591)) (by [@fcwheat](https://github.com/fcwheat))

## 4.0.0-pre.4

### 🐞 Bug fixes

- Fix missing export `Map` type in the `d.ts` file ([#3564](https://github.com/maplibre/maplibre-gl-js/pull/3564)) (by [@HarelM](https://github.com/HarelM))

## 4.0.0-pre.3

### ✨ Features and improvements

- ⚠️ Add the ability to import a script in the worker thread and call `addProtocol` and `removeProtocol` there ([#3459](https://github.com/maplibre/maplibre-gl-js/pull/3459)) - this also changed how `addSourceType` works since now you'll need to load the script with `maplibregl.importScriptInWorkers`. (by [@HarelM](https://github.com/HarelM))
- Upgraded to use Node JS 20 and removed the dependency of `gl` package from the tests to allow easier development setup. ([#3452](https://github.com/maplibre/maplibre-gl-js/pull/3452)) (by [@HarelM](https://github.com/HarelM))
- Improved precision and added a subtle fade transition to marker opacity changes ([#3431](https://github.com/maplibre/maplibre-gl-js/pull/3431)) (by [@SnailBones](https://github.com/SnailBones))
- Adds support for terrain in `setStyle` with diff method ([#3515](https://github.com/maplibre/maplibre-gl-js/pull/3515), [#3463](https://github.com/maplibre/maplibre-gl-js/pull/3463)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix the shifted mouse events after a css transform scale on the map container ([#3437](https://github.com/maplibre/maplibre-gl-js/pull/3437)) (by [@HarelM](https://github.com/HarelM))
- Fix markers remaining transparent when disabling terrain ([#3431](https://github.com/maplibre/maplibre-gl-js/pull/3431)) (by [@SnailBones](https://github.com/SnailBones))
- Fix labels disappearing when enabling terrain at high zoom ([#3545](https://github.com/maplibre/maplibre-gl-js/pull/3545)) (by [@SnailBones](https://github.com/SnailBones))

## 4.0.0-pre.2

### ✨ Features and improvements

- ⚠️ Changes `addProtocol` to be promise-based without the usage of callbacks and cancelable ([#3433](https://github.com/maplibre/maplibre-gl-js/pull/3433)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Moved the `addSourceType` to be a part of the global maplibregl object instead of being per map object ([#3420](https://github.com/maplibre/maplibre-gl-js/pull/3420)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Removed callback usage from `map.loadImage` in continue to below change ([#3422](https://github.com/maplibre/maplibre-gl-js/pull/3422)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `GeoJSONSource`'s `getClusterExpansionZoom`, `getClusterChildren`, `getClusterLeaves` methods to return a `Promise` instead of a callback usage ([#3421](https://github.com/maplibre/maplibre-gl-js/pull/3421)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `setRTLTextPlugin` function to return a promise instead of using callback ([#3418](https://github.com/maplibre/maplibre-gl-js/pull/3418)) this also changed how the RTL plugin code is handled internally by splitting the main thread and worker thread code. (by [@HarelM](https://github.com/HarelM))
- ⚠️ Remove `setCooperativeGestures` and `getCooperativeGestures` functions in favor of `cooperativeGestures` handler which now has an `enabled()` or `disabled()` methods ([#3430](https://github.com/maplibre/maplibre-gl-js/pull/3430)) (by [@HarelM](https://github.com/HarelM))
- Created a new example showing how to place a threejs scene as a `CustomLayer` over maplibre 3d-terrain ([#3429](https://github.com/maplibre/maplibre-gl-js/pull/3429)) (by [@MichaelLangbein](https://github.com/MichaelLangbein))

### 🐞 Bug fixes

- Fix zooming outside the central globe when terrain 3D is enabled ([#3425](https://github.com/maplibre/maplibre-gl-js/pull/3425)) (by [@sbachinin](https://github.com/sbachinin))
- Fix cursor being shown indefinitely as a pointer when removing a popup with its `trackPointer` method active ([#3434](https://github.com/maplibre/maplibre-gl-js/pull/3434)) (by [@simondriesen](https://github.com/simondriesen))
- Fix a bug in showing cooperative gestures when scroll zoom is disabled ([#2498](https://github.com/maplibre/maplibre-gl-js/issues/2498)) (by [@HarelM](https://github.com/HarelM))
- Handle loading of empty raster tiles (204 No Content) ([#3428](https://github.com/maplibre/maplibre-gl-js/pull/3428)) (by [@petrsloup](https://github.com/petrsloup))

## 4.0.0-pre.1

### ✨ Features and improvements

- Changed `ImageRequest` to be `Promise` based ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the underlying worker communication from callbacks to promises. This has a breaking effect on the implementation of custom `WorkerSource` and how it behaves ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `Source` interface to return promises instead of callbacks ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed all the sources to be promises based. ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Changed the `map.loadImage` method to return a `Promise` instead of a callback usage ([#3233](https://github.com/maplibre/maplibre-gl-js/pull/3233)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fixes a security issue in `Actor` against XSS attacks in postMessage / onmessage ([#3239](https://github.com/maplibre/maplibre-gl-js/issues/3239)) (by [@HarelM](https://github.com/HarelM))

## 3.6.2

### 🐞 Bug fixes

- Fix mapbox-gl-draw example ([#2601](https://github.com/maplibre/maplibre-gl-js/issues/2601), [#3394](https://github.com/maplibre/maplibre-gl-js/pull/3394)) (by [@dBitech](https://github.com/dBitech))
- Fix fill patterns sometimes not rendering at all ([#3339](https://github.com/maplibre/maplibre-gl-js/pull/3339)) (by [@CraigglesO](https://github.com/CraigglesO))

## 3.6.1

### 🐞 Bug fixes

- Fix `undefined` `_onEaseFrame` call in `Camera._renderFrameCallback()` while doing `Camera.jumpTo` during a `Camera.easeTo` ([#3332](https://github.com/maplibre/maplibre-gl-js/pull/3332)) (by [@ToHold](https://github.com/ToHold))

## 3.6.0

### ✨ Features and improvements

- Add getLayersOrder() to Map and Style ([#3279](https://github.com/maplibre/maplibre-gl-js/pull/3279)) (by [@neodescis](https://github.com/neodescis))
- Updated description of `fullscreen` example ([#3311](https://github.com/maplibre/maplibre-gl-js/pull/3311)) (by [@jhemmje](https://github.com/jhemmje))

### 🐞 Bug fixes

- Fix null feature properties in resolve_tokens ([#3272](https://github.com/maplibre/maplibre-gl-js/pull/3272)) (by [@mattesCZ](https://github.com/mattesCZ))

## 3.5.2

### ✨ Features and improvements

- Convert plantuml diagrams to mermaid ([#3217](https://github.com/maplibre/maplibre-gl-js/pull/3217)) (by [@msbarry](https://github.com/msbarry))
- Improve buffer transfer in Safari after Safari fixed a memory leak bug ([#3225](https://github.com/maplibre/maplibre-gl-js/pull/3225)) (by [@HarelM](https://github.com/HarelM))
- Minify internal exports to reduce bundle size ([#3216](https://github.com/maplibre/maplibre-gl-js/pull/3216)) (by [@msbarry](https://github.com/msbarry))

### 🐞 Bug fixes

- Add terrain property to map style object ([#3234](https://github.com/maplibre/maplibre-gl-js/pull/3234)) (by [@kumilange](https://github.com/kumilange))
- Fix exception thrown from `isWebGL2` check ([#3238](https://github.com/maplibre/maplibre-gl-js/pull/3238)) (by [@msbarry](https://github.com/msbarry))
- Fix rollup watch mode ([#3270](https://github.com/maplibre/maplibre-gl-js/pull/3270)) (by [@msbarry](https://github.com/msbarry))

## 3.5.1

### 🐞 Bug fixes

- Fix regression introduced in 3.5.0, related to async/await ([#3228](https://github.com/maplibre/maplibre-gl-js/pull/3228)) (by [@birkskyum](https://github.com/birkskyum))

## 3.5.0

### ✨ Features and improvements

- Add setTiles method to RasterTileSource to dynamically update existing tile sources. ([#3208](https://github.com/maplibre/maplibre-gl-js/pull/3208)) (by [@wagewarbler](https://github.com/wagewarbler))

## 3.4.1

### ✨ Features and improvements

- Locally rendered glyphs are double resolution (48px), greatly improving sharpness of CJK text. ([#2990](https://github.com/maplibre/maplibre-gl-js/issues/2990), [#3006](https://github.com/maplibre/maplibre-gl-js/pull/3006)) (by [@bdon](https://github.com/bdon))

### 🐞 Bug fixes

- Fix setStyle->style.setState didn't reset \_serializedLayers ([#3133](https://github.com/maplibre/maplibre-gl-js/pull/3133)). (by [@CraigglesO](https://github.com/CraigglesO))
- Fix Raster DEM decoding in safari private browsing mode ([#3185](https://github.com/maplibre/maplibre-gl-js/pull/3185)) (by [@msbarry](https://github.com/msbarry))

## 3.4.0

### ✨ Features and improvements

- Improve error message when a tile can't be loaded ([#3130](https://github.com/maplibre/maplibre-gl-js/pull/3130)) (by [@HarelM](https://github.com/HarelM))
- Support custom raster-dem encodings ([#3087](https://github.com/maplibre/maplibre-gl-js/pull/3087)) (by [@ibesora](https://github.com/ibesora))

### 🐞 Bug fixes

- Fixed Interrupting a scroll zoom causes the next scroll zoom to return to the prior zoom level by resetting scroll handler state properly ([#2709](https://github.com/maplibre/maplibre-gl-js/issues/2709), [#3051](https://github.com/maplibre/maplibre-gl-js/pull/305)) (by [@HarelM](https://github.com/HarelM))
- Fix unit test warning about duplicate module names ([#3049](https://github.com/maplibre/maplibre-gl-js/pull/3049)) (by [@miccou](https://github.com/miccou))
- Correct marker position when switching between 2D and 3D view ([#2996](https://github.com/maplibre/maplibre-gl-js/pull/2996)) (by [@sebastianoscarlopez](https://github.com/sebastianoscarlopez))
- Fix error thrown when unsetting line-gradient ([#2683](https://github.com/maplibre/maplibre-gl-js/issues/2683)) (by [@tangerine-orange](https://github.com/tangerine-orange))
- Update raster tile end points in documentation ([#3105](https://github.com/maplibre/maplibre-gl-js/pull/3105)) (by [@RossThorn](https://github.com/RossThorn))
- Avoiding inertia animation on Mac when reduced motion is on ([#3068](https://github.com/maplibre/maplibre-gl-js/pull/3068)) (by [@sebastianoscarlopez](https://github.com/sebastianoscarlopez))
- 3d buildings example doesn't work as expected ([#3165](https://github.com/maplibre/maplibre-gl-js/pull/3165)) (by [@sebastianoscarlopez](https://github.com/sebastianoscarlopez))

## 3.3.1

### ✨ Features and improvements

- Copy LICENSE.txt to dist folder so it's included in 3rdpartylicenses.txt by webpack ([#3021](https://github.com/maplibre/maplibre-gl-js/pull/3021)) (by [@miccou](https://github.com/miccou))

### 🐞 Bug fixes

- Correct declared return type of `Map.getLayer()` and `Style.getLayer()` to be `StyleLayer | undefined` to match the documentation ([#2969](https://github.com/maplibre/maplibre-gl-js/pull/2969)) (by [@RoystonS](https://github.com/RoystonS))
- Correct type of `Map.addLayer()` and `Style.addLayer()` to allow adding a layer with an embedded source, matching the documentation ([#2966](https://github.com/maplibre/maplibre-gl-js/pull/2966)) (by [@neodescis](https://github.com/neodescis))
- Throttle map resizes from ResizeObserver to reduce flicker ([#2986](https://github.com/maplibre/maplibre-gl-js/pull/2986)) (by [@neodescis](https://github.com/neodescis))
- Correct function `Map.setTerrain(options: TerrainSpecification): Map` to be `Map.setTerrain(options: TerrainSpecification | null): Map` per the API spec ([#2993](https://github.com/maplibre/maplibre-gl-js/pull/2993)) (by [@CraigglesO](https://github.com/CraigglesO))
- Correct function `Map.getTerrain(): TerrainSpecification` to be `Map.getTerrain(): TerrainSpecification | null` for consistency with the setTerrain function ([#3020](https://github.com/maplibre/maplibre-gl-js/pull/3020)) (by [@neodescis](https://github.com/neodescis))

## 3.3.0

### ✨ Features and improvements

- Add support for [`text-variable-anchor-offset`](https://maplibre.org/maplibre-style-spec/layers/#layout-symbol-text-variable-anchor-offset) symbol style layer property ([#2914](https://github.com/maplibre/maplibre-gl-js/pull/2914)) (by [@drwestco](https://github.com/drwestco))

## 3.2.2

### ✨ Features and improvements

- Add `cache` parameter to [`RequestParameters`](https://maplibre.org/maplibre-gl-js/docs/API/types/maplibregl.RequestParameters/) ([#2910](https://github.com/maplibre/maplibre-gl-js/pull/2910)) (by [@marucjmar](https://github.com/marucjmar))
- Removed some classed from the docs to better define the public API ([#2945](https://github.com/maplibre/maplibre-gl-js/pull/2945)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Properly check ImageBitmap ([#2942](https://github.com/maplibre/maplibre-gl-js/pull/2942), [#2940](https://github.com/maplibre/maplibre-gl-js/issues/2940)) (by [@HarelM](https://github.com/HarelM))
- VectorTileWorkerSource: fix reload for original's load parse would not pass the rawTileData and meta. ([#2941](https://github.com/maplibre/maplibre-gl-js/pull/2941)) (by [@ambientlight](https://github.com/ambientlight))

## 3.2.1

### ✨ Features and improvements

- Remove cooperative gesture screen from the accessibility tree since screenreaders cannot interact with the map using gestures ([#2857](https://github.com/maplibre/maplibre-gl-js/pull/2857)) (by [@manuelroth](https://github.com/manuelroth))
- Add `cooperated gestures` example to the doc.([#2860](https://github.com/maplibre/maplibre-gl-js/pull/2860)) (by [@visitskyworld](https://github.com/visitskyworld))

### 🐞 Bug fixes

- Incorrect distance field of view calculation for negative elevation, fixed by storing min elevation for the tile in view ([#1655](https://github.com/maplibre/maplibre-gl-js/issues/1655), [#2858](https://github.com/maplibre/maplibre-gl-js/pull/2858)) (by [@HarelM](https://github.com/HarelM))
- Fix reloadCallback not firing on VectorTileWorkerSource.reloadTile ([#1874](https://github.com/maplibre/maplibre-gl-js/pull/1874)) (by [@ambientlight](https://github.com/ambientlight))
- Don't draw halo pixels underneath text pixels ([#2897](https://github.com/maplibre/maplibre-gl-js/pull/2897)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Fix RasterDEMTileSource not serializing its options correctly ([#2895](https://github.com/maplibre/maplibre-gl-js/pull/2895)) (by [@neodescis](https://github.com/neodescis))
- Remove node and jest from dist type checking, fix map event and other typing problems ([#2898](https://github.com/maplibre/maplibre-gl-js/pull/2898)) (by [@neodescis](https://github.com/neodescis))

## 3.2.0

### ✨ Features and improvements

- Change all internal exports to named exports([#2711](https://github.com/maplibre/maplibre-gl-js/pull/2711)) (by [@HarelM](https://github.com/HarelM))
- Docs generation is now part of this repo([#2733](https://github.com/maplibre/maplibre-gl-js/pull/2733)) (by [@HarelM](https://github.com/HarelM))
- Add `className` option to Marker constructor ([#2729](https://github.com/maplibre/maplibre-gl-js/pull/2729)) (by [@marexandre](https://github.com/marexandre))
- Immediately redraw the map after setting pixel ratio ([#2674](https://github.com/maplibre/maplibre-gl-js/pull/2674)) (by [@handymenny](https://github.com/handymenny))
- Add maxCanvasSize option to limit canvas size. It can prevent reaching the GL limits and reduce the load on the devices. Default value is [4096, 4096]. ([#2674](https://github.com/maplibre/maplibre-gl-js/pull/2674)) (by [@handymenny](https://github.com/handymenny))
- Reduce maxCanvasSize when hitting GL limits to avoid distortions ([#2674](https://github.com/maplibre/maplibre-gl-js/pull/2674)) (by [@handymenny](https://github.com/handymenny))
- Rewrite all the code comments in TSDocs, introduced a new documentation system and moved examples into this repository for better debug options ([#2756](https://github.com/maplibre/maplibre-gl-js/pull/2756)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Removed non documented `Marker` constructor parameter ([#2756](https://github.com/maplibre/maplibre-gl-js/pull/2756)) (by [@HarelM](https://github.com/HarelM))
- Updated `check-for-support` example ([#2859](https://github.com/maplibre/maplibre-gl-js/pull/2859)) (by [@visitskyworld](https://github.com/visitskyworld))

### 🐞 Bug fixes

- Return undefined instead of throwing from `Style.serialize()` when the style hasn't loaded yet ([#2712](https://github.com/maplibre/maplibre-gl-js/pull/2712)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Don't throw an exception from `checkMaxAngle` when a label with length 0 is on the last segment of a line ([#2710](https://github.com/maplibre/maplibre-gl-js/pull/2710)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Fix the `tap then drag` zoom gesture detection to abort when the two taps are far away ([#2673](https://github.com/maplibre/maplibre-gl-js/pull/2673)) (by [@mz8i](https://github.com/mz8i))
- Fix regression - update pixel ratio when devicePixelRatio changes, restoring the v1.x behaviour ([#2706](https://github.com/maplibre/maplibre-gl-js/pull/2706)) (by [@handymenny](https://github.com/handymenny))
- Fix incorrect elevation calculation ([#2772](https://github.com/maplibre/maplibre-gl-js/pull/2772)) (by [@rotu](https://github.com/rotu))

## 3.1.0

### ✨ Features and improvements

- Expose map options.maxTileCacheZoomLevels to allow better control of tile cache ([#2581](https://github.com/maplibre/maplibre-gl-js/pull/2581)) (by [@pramilk](https://github.com/pramilk))

### 🐞 Bug fixes

- Fix regression - Add webgl1 fallback to accommodate users without webgl2 support ([#2653](https://github.com/maplibre/maplibre-gl-js/issues/2653)) (by [@birkskyum](https://github.com/birkskyum))

## 3.0.1

### ✨ Features and improvements

- Update shaders to GLSL ES 3.0 ([#2599](https://github.com/maplibre/maplibre-gl-js/pull/2599)) (by [@birkskyum](https://github.com/birkskyum))

### 🐞 Bug fixes

- Fix `RequestTransformFunction` type to return RequestParameters or undefined ([#2586](https://github.com/maplibre/maplibre-gl-js/pull/2586)) (by [@nreese](https://github.com/nreese))
- Load `EXT_color_buffer_float` WebGL2 extension to fix heatmap in firefox ([#2595](https://github.com/maplibre/maplibre-gl-js/pull/2595)) (by [@birkskyum](https://github.com/birkskyum))

## 3.0.0

## New features and improvements

- Add `transformCameraUpdate` callback to `Map` options ([#2535](https://github.com/maplibre/maplibre-gl-js/pull/2535)) (by [@Pessimistress](https://github.com/Pessimistress))
- Bump KDBush and supercluster for better memory efficiency ([#2522](https://github.com/maplibre/maplibre-gl-js/pull/2522)) (by [@birkskyum](https://github.com/birkskyum))
- Improve performance by using HTMLImageElement to download raster source images when refreshExpiredTiles tiles is false ([#2126](https://github.com/maplibre/maplibre-gl-js/pull/2126)) (by [@pramilk](https://github.com/pramilk))
- Set fetchPriority for HTMLImageElement to help improve raster-heavy scenarios ([#2459](https://github.com/maplibre/maplibre-gl-js/pull/2459)) (by [@pramilk](https://github.com/pramilk))
- Reduce rendering calls on initial load. No reason to try rendering before the style is loaded. ([#2464](https://github.com/maplibre/maplibre-gl-js/pull/2464)) (by [@pramilk](https://github.com/pramilk))
- Lazy load default style properties on demand to improve loading performance and reduce memory usage. ([#2476](https://github.com/maplibre/maplibre-gl-js/pull/2476)) (by [@pramilk](https://github.com/pramilk))
- Add queryTerrainElevation allows getting terrain elevation in meters at a specific point ([#2264](https://github.com/maplibre/maplibre-gl-js/pull/2264)) (by [@manhcuongincusar1](https://github.com/manhcuongincusar1))
- Improve performance by sending style layers to the worker thread before processing it on the main thread to allow parallel processing ([#2131](https://github.com/maplibre/maplibre-gl-js/pull/2131)) (by [@pramilk](https://github.com/pramilk))
- Add Map.getImage() to retrieve previously-loaded images. ([#2168](https://github.com/maplibre/maplibre-gl-js/pull/2168)) (by [@ZeLonewolf](https://github.com/ZeLonewolf))
- Add a method to enable/disable cooperative gestures ([#2152](https://github.com/maplibre/maplibre-gl-js/pull/2152)) (by [@kevinschaul](https://github.com/kevinschaul))
- Update CONTRIBUTING.md with details on setting up on M1 mac ([#2196](https://github.com/maplibre/maplibre-gl-js/pull/2196)) (by [@llambanna](https://github.com/llambanna))
- Update default type of originalEvent in MapLibreEvent to be `unknown` ([#2243](https://github.com/maplibre/maplibre-gl-js/pull/2243)) (by [@neodescis](https://github.com/neodescis))
- Improve performance when forcing full symbol placement by short-circuiting pause checks ([#2241](https://github.com/maplibre/maplibre-gl-js/pull/2241)) (by [@schlosna](https://github.com/schlosna))
- Adding a `warnonce` when terrain and hillshade source are the same ([#2298](https://github.com/maplibre/maplibre-gl-js/pull/2298)) (by [@tempranova](https://github.com/tempranova))
- Remove a deprecation warning by removing an empty texture that is no longer being used in the codebase ([#2299](https://github.com/maplibre/maplibre-gl-js/pull/2299)) (by [@IvanSanchez](https://github.com/IvanSanchez))
- Improve initial loading performance by lazy serializing layers only when needed. ([#2306](https://github.com/maplibre/maplibre-gl-js/pull/2306)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Add validateStyle MapOption to allow disabling style validation for faster performance in production environment. ([#2390](https://github.com/maplibre/maplibre-gl-js/pull/2390)) (by [@pramilk](https://github.com/pramilk))
- Add `setClusterOptions` to update cluster properties of the added sources: fixing these issues ([#429](https://github.com/maplibre/maplibre-gl-js/issues/429)) and ([#1384](https://github.com/maplibre/maplibre-gl-js/issues/1384)) (by [@IhsenBen](https://github.com/IhsenBen))
- Add types for `workerOptions` and `_options` in `geojson_source.ts` ([#1998](https://github.com/maplibre/maplibre-gl-js/pull/1998)) (by [@IhsenBen](https://github.com/IhsenBen))
- Add fullscreenstart, fullscreenend events to FullscreenControl ([#2128](https://github.com/maplibre/maplibre-gl-js/pull/2128)) (by [@kevinschaul](https://github.com/kevinschaul))
- Throttle the image request queue while the map is moving to improve performance ([#2097](https://github.com/maplibre/maplibre-gl-js/pull/2097)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Add support for multiple `sprite` declarations in one style file ([#1805](https://github.com/maplibre/maplibre-gl-js/pull/1805)) (by [@smellyshovel](https://github.com/smellyshovel))
- Extract sprite image on demand to reduce memory usage and improve performance by reducing the number of getImageData calls ([#1809](https://github.com/maplibre/maplibre-gl-js/pull/1809)) (by [@pramilk](https://github.com/pramilk))
- `QueryRenderedFeaturesOptions` type added to both of the params in queryRenderedFeatures in map.ts ([#1900](https://github.com/maplibre/maplibre-gl-js/issues/1900)) (by [@beharguy](https://github.com/beharguy))
- NavigationControlOptions is now optional when creating an instance of NavigationControl ([#1754](https://github.com/maplibre/maplibre-gl-js/issues/1754)) (by [@guimochila](https://github.com/guimochila))
- Listen to webglcontextcreationerror event and give detailed debug info when it fails ([#1715](https://github.com/maplibre/maplibre-gl-js/pull/1715)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Make sure `cooperativeGestures` overlay is always "on top" (z-index) of map features ([#1753](https://github.com/maplibre/maplibre-gl-js/pull/1753)) (by [@blyme](https://github.com/blyme))
- Use `willReadFrequently` hint to optimize 2D canvas usage and remove warnings ([#1808](https://github.com/maplibre/maplibre-gl-js/pull/1808)) (by [@kircher1](https://github.com/kircher1))
- Speed up the cross tile symbol index in certain circumstances ([#1755](https://github.com/maplibre/maplibre-gl-js/pull/1755)) (by [@mfedderly](https://github.com/mfedderly))
- Improve rendering speed in scenes with many colliding symbolic icons and labels ([#1757](https://github.com/maplibre/maplibre-gl-js/pull/1757)) (by [@AdamS108](https://github.com/AdamS108))
- Make request for ImageSource cancelable ([#1802](https://github.com/maplibre/maplibre-gl-js/pull/1802)) (by [@blinkzz](https://github.com/blinkzz))
- Throttle the image request queue while the map is moving to improve performance ([#2097](https://github.com/maplibre/maplibre-gl-js/pull/2097)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Return a promise from `once` method to allow easier usage of async/await in this case ([#1690](https://github.com/maplibre/maplibre-gl-js/pull/1690)) (by [@HarelM](https://github.com/HarelM))
- Add pseudo (CSS) fullscreen as a fallback for iPhones ([#1678](https://github.com/maplibre/maplibre-gl-js/pull/1678)) (by [@caspg](https://github.com/caspg))
- Add `updateData` to `GeoJSONSource` which allows for partial data updates ([#1605](https://github.com/maplibre/maplibre-gl-js/pull/1605)) (by [@mfedderly](https://github.com/mfedderly))
- Add a RenderPool to render tiles onto textures for 3D ([#1671](https://github.com/maplibre/maplibre-gl-js/pull/1671)) (by [@prozessor13](https://github.com/prozessor13))
- Add map.getCameraTargetElevation() ([#1558](https://github.com/maplibre/maplibre-gl-js/pull/1558)) (by [@birkskyum](https://github.com/birkskyum))
- Add `freezeElevation` to `AnimationOptions` to allow smooth camera movement in 3D ([#1514](https://github.com/maplibre/maplibre-gl-js/pull/1514), [#1492](https://github.com/maplibre/maplibre-gl-js/issues/1492)) (by [@prozessor13](https://github.com/prozessor13))
- Add map.setStyle's transformStyle option ([#1632](https://github.com/maplibre/maplibre-gl-js/pull/1632)) (by [@ambientlight](https://github.com/ambientlight))

## Potentially breaking changes

Most of these changes will not affect your code but read carefully through the list to asses if a migration is needed.

- ⚠️ Cancel unloaded tile request on zooming in across multiple zooms. Previously these requests were not cancelled. ([#2377](https://github.com/maplibre/maplibre-gl-js/pull/2377)) (by [@pramilk](https://github.com/pramilk))
- ⚠️ Resize map when container element is resized. The "resize"-related events now has different data associated with it ([#2157](https://github.com/maplibre/maplibre-gl-js/pull/2157), [#2551](https://github.com/maplibre/maplibre-gl-js/issues/2551)). Previously the originalEvent field was the reason of this change, for example it could be a `resize` event from the browser. Now it is `ResizeObserverEntry`, see more [here](https://developer.mozilla.org/en-US/docs/web/api/resizeobserverentry). (by [@HarelM](https://github.com/HarelM))
- ⚠️ Improve rendering of areas below sea level, and remove elevationOffset workaround ([#1578](https://github.com/maplibre/maplibre-gl-js/pull/1578)) (by [@birkskyum](https://github.com/birkskyum))
- ⚠️ Remove support for `hsl` css color in a format that does not comply with the CSS Color specification. Colors defined in `hsl(110, 0.7, 0.055)` format will no longer work, instead it is recommended to use the format with percentages `hsl(110, 70%, 5.5%)`. ([#2376](https://github.com/maplibre/maplibre-gl-js/pull/2376)) (by [@kajkal](https://github.com/kajkal))
- ⚠️ Move terrain object from style.terrain to map.terrain ([#1628](https://github.com/maplibre/maplibre-gl-js/pull/1628)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Remove deprecated `mapboxgl-` css classes (use `maplibregl-` instead) ([#1575](https://github.com/maplibre/maplibre-gl-js/pull/1575)) (by [@birkskyum](https://github.com/birkskyum))
- ⚠️ Full transition from WebGL1 to WebGL2 ([browser support](https://caniuse.com/?search=webgl2)) ([#2512](https://github.com/maplibre/maplibre-gl-js/pull/2512), [#1891](https://github.com/maplibre/maplibre-gl-js/pull/1891)) (by [@birkskyum](https://github.com/birkskyum))
- ⚠️ `LngLat.toBounds()` is replaced by a static method `LngLatBounds.fromLngLat()` ([#2188](https://github.com/maplibre/maplibre-gl-js/pull/2188)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- ⚠️ Make geojson data source a required field to align with the docs ([#1396](https://github.com/maplibre/maplibre-gl-js/issues/1396)) (by [@HarelM](https://github.com/HarelM))
- ⚠️ Improve control initial loading performance by forcing fadeDuration to 0 till first idle event ([#2447](https://github.com/maplibre/maplibre-gl-js/pull/2447)) (by [@pramilk](https://github.com/pramilk))
- ⚠️ Remove "mapbox-gl-supported" package from API. If needed, please reference it directly instead of going through MapLibre. ([#2451](https://github.com/maplibre/maplibre-gl-js/pull/2451)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- ⚠️ Improve control performance by restricting worker count to a max of 1 except for Safari browser. ([#2354](https://github.com/maplibre/maplibre-gl-js/pull/2354)) (by [@pramilk](https://github.com/pramilk))

## Bug fixes

- Fix of incorrect dash in diagonal lines with a vector source at some zoom levels. ([#2479](https://github.com/maplibre/maplibre-gl-js/pull/2479)) (by [@newlinefu](https://github.com/newlinefu))
- Fix event.isSourceLoaded to reflect the state of source loading for sourcedata event ([#2543](https://github.com/maplibre/maplibre-gl-js/pull/2543)) (by [@ambientlight](https://github.com/ambientlight))
- Fix overlapping of 3D building parts when 3D Terrain is activated ([#2513](https://github.com/maplibre/maplibre-gl-js/issues/2513)) (by [@zstadler](https://github.com/zstadler))
- Show 3D buildings located below sea level when 3D Terrain is activated ([#2544](https://github.com/maplibre/maplibre-gl-js/issues/2544)) (by [@zstadler](https://github.com/zstadler))
- Fix `LngLatBounds.extend()` to correctly handle `{ lng: number, lat: number }` coordinates. ([#2425](https://github.com/maplibre/maplibre-gl-js/pull/2425)) (by [@buffalom](https://github.com/buffalom))
- Fix the accuracy-circle in the geolocate control from randomly resizing. ([#2450](https://github.com/maplibre/maplibre-gl-js/pull/2450)) (by [@Philip2809](https://github.com/Philip2809))
- Fix the type of the `features` property on `MapLayerMouseEvent` and `MapLayerTouchEvent` to be `MapGeoJSONFeature[]` in lieu of `GeoJSON.Feature[]` ([#2244](https://github.com/maplibre/maplibre-gl-js/pull/2244)) (by [@parkerziegler](https://github.com/parkerziegler))
- Fix GeolocateControl error if removed quickly ([#2391](https://github.com/maplibre/maplibre-gl-js/pull/2391)) (by [@Pessimistress](https://github.com/Pessimistress))
- Fix issue unloading sprite sheet when using `setStyle(style, {diff:true})` ([#2146](https://github.com/maplibre/maplibre-gl-js/pull/2146)) (by [@jcary741](https://github.com/jcary741))
- Fix wrap coords in `getTerrain` when `fitBounds` across the AM ([#2155](https://github.com/maplibre/maplibre-gl-js/pull/2155)) (by [@llambanna](https://github.com/llambanna))
- Fix LngLat `toArray` method return type to [number,number] ([#2233](https://github.com/maplibre/maplibre-gl-js/issues/2233)) (by [@maxdacruz](https://github.com/maxdacruz))
- Fix handling of text-offset with symbol-placement: line ([#2170](https://github.com/maplibre/maplibre-gl-js/issues/2170) and [#2171](https://github.com/maplibre/maplibre-gl-js/issues/2171)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Fix geolocate control permissions failure on IOS16 web view with fallback to `window.navigator.geolocation` ([#2359](https://github.com/maplibre/maplibre-gl-js/pull/2359)) (by [@HarelM](https://github.com/HarelM))
- Prevent unnecessary reload of raster sources when RTL Text Plugin loads ([#2380](https://github.com/maplibre/maplibre-gl-js/issues/2380)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Fix Handle AddProtocol callback function returning an HTMLImageElement ([#2393](https://github.com/maplibre/maplibre-gl-js/pull/2393)) (by [@pramilk](https://github.com/pramilk))
- Fix raster tiles being retained when raster-fade-duration is 0 ([#2445](https://github.com/maplibre/maplibre-gl-js/issues/2445), [#2501](https://github.com/maplibre/maplibre-gl-js/issues/2501)) (by [@ibesora](https://github.com/ibesora))
- Fix the worker been terminated on setting new style ([#2123](https://github.com/maplibre/maplibre-gl-js/pull/2123)) (by [@pramilk](https://github.com/pramilk))
- Change how meta key is detected for cooperative gestures ([#2152](https://github.com/maplibre/maplibre-gl-js/pull/2152)) (by [@kevinschaul](https://github.com/kevinschaul))
- Fix the worker been terminated on setting new style ([#2123](https://github.com/maplibre/maplibre-gl-js/pull/2123)) (by [@pramilk](https://github.com/pramilk))
- Fix issue ([#1024](https://github.com/maplibre/maplibre-gl-js/issues/1024)) - Zoom center not under cursor when terrain is on (by [@HarelM](https://github.com/HarelM))
- Fix errors when running style-spec bin scripts and added missing help. Removed unnecessary script 'gl-style-composite'. ([#1971](https://github.com/maplibre/maplibre-gl-js/pull/1971)) (by [@acalcutt](https://github.com/acalcutt))
- Fix the `slice` expression type ([#1886](https://github.com/maplibre/maplibre-gl-js/issues/1886)) (by [@kevinschaul](https://github.com/kevinschaul))
- Remove dependency on `@rollup/plugin-json`, which was in conflict with `rollup-plugin-import-assert` ([#1894](https://github.com/maplibre/maplibre-gl-js/pull/1894)) (by [@rotu](https://github.com/rotu))
- Remove dependency on `@mapbox/gazetteer` which caused some build warnings ([#1757](https://github.com/maplibre/maplibre-gl-js/pull/1757) [#1898](https://github.com/maplibre/maplibre-gl-js/pull/1898)) (by [@AdamS108](https://github.com/AdamS108))
- Fix `getElevation()` causing uncaught error ([#1650](https://github.com/maplibre/maplibre-gl-js/issues/1650)). (by [@zbigniewmatysek-tomtom](https://github.com/zbigniewmatysek-tomtom))
- Fix headless benchmark execution especially on VM ([#1732](https://github.com/maplibre/maplibre-gl-js/pull/1732)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- fix issue [#860](https://github.com/maplibre/maplibre-gl-js/issues/860) fill-pattern with pixelRatio > 1 is now switched correctly at runtime. ([#1765](https://github.com/maplibre/maplibre-gl-js/pull/1765)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Fix the exception that would be thrown on `map.setStyle` when it is passed with transformStyle option and map is initialized without an initial style. ([#1824](https://github.com/maplibre/maplibre-gl-js/pull/1824)) (by [@ambientlight](https://github.com/ambientlight))
- Fix the behavior of the compass button on touch devices. ([#1852](https://github.com/maplibre/maplibre-gl-js/pull/1852)) (by [@VehpuS](https://github.com/VehpuS))
- Fix `GeoJSONSource` appearing to never finish loading when calling its `setData` method immediately after adding it to a `Map` due to it not firing a `metadata` `data` event ([#1693](https://github.com/maplibre/maplibre-gl-js/issues/1693)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Fix the gap between terrain elevated tiles ([#1602](https://github.com/maplibre/maplibre-gl-js/issues/1602)) (by [@HarelM](https://github.com/HarelM))
- Fix showTileBoundaries to show the first vector source ([#1395](https://github.com/maplibre/maplibre-gl-js/pull/1395)) (by [@jleedev](https://github.com/jleedev))
- Fix `match` expression type ([#1631](https://github.com/maplibre/maplibre-gl-js/pull/1631)) (by [@lukashass](https://github.com/lukashass))
- Fix for blurry raster tiles due to raster tiles requests stuck in image queue. ([#2511](https://github.com/maplibre/maplibre-gl-js/pull/2511)) (by [@pramilk](https://github.com/pramilk))

## 3.0.0-pre.9

### 🐞 Bug fixes

- Fixes issue with ResizeObserver firing an initial 'resize' event (since 3.0.0-pre.5) ([#2551](https://github.com/maplibre/maplibre-gl-js/issues/2551)) (by [@birkskyum](https://github.com/birkskyum))

## 3.0.0-pre.8

### ✨ Features and improvements

- Add `transformCameraUpdate` callback to `Map` options ([#2535](https://github.com/maplibre/maplibre-gl-js/pull/2535)) (by [@Pessimistress](https://github.com/Pessimistress))

### 🐞 Bug fixes

- Revise previous fix ([#2445](https://github.com/maplibre/maplibre-gl-js/issues/2445)) for raster tiles being retained when raster-fade-duration is 0 ([#2501](https://github.com/maplibre/maplibre-gl-js/issues/2501)) (by [@ibesora](https://github.com/ibesora))

## 3.0.0-pre.7

### ✨ Features and improvements

- ⚠️ Breaking - Remove WebGL1 support. Move to WebGL2 ([#2512](https://github.com/maplibre/maplibre-gl-js/pull/2512)) (by [@birkskyum](https://github.com/birkskyum))
- Bump KDBush and supercluster ([#2522](https://github.com/maplibre/maplibre-gl-js/pull/2522)) (by [@birkskyum](https://github.com/birkskyum))

## 3.0.0-pre.6

### ✨ Features and improvements

- ⚠️ Breaking - Improve control performance by restricting worker count to a max of 1 except safari browser. ([#2354](https://github.com/maplibre/maplibre-gl-js/pull/2354)) (by [@pramilk](https://github.com/pramilk))
- Improve performance by using HTMLImageElement to download raster source images when refreshExpiredTiles tiles is false ([#2126](https://github.com/maplibre/maplibre-gl-js/pull/2126)) (by [@pramilk](https://github.com/pramilk))
- ⚠️ Breaking - Improve control initial loading performance by forcing fadeDuration to 0 till first idle event ([#2447](https://github.com/maplibre/maplibre-gl-js/pull/2447)) (by [@pramilk](https://github.com/pramilk))
- ⚠️ Breaking - Remove "mapbox-gl-supported" package from API. If needed, please reference it directly instead of going through MapLibre. ([#2451](https://github.com/maplibre/maplibre-gl-js/pull/2451)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Set fetchPriority for HTMLImageElement to help improve raster heavy scenarios ([#2459](https://github.com/maplibre/maplibre-gl-js/pull/2459)) (by [@pramilk](https://github.com/pramilk))
- Reduce rendering calls on initial load. No reason to try rendering before style is loaded. ([#2464](https://github.com/maplibre/maplibre-gl-js/pull/2464)) (by [@pramilk](https://github.com/pramilk))
- Lazy load default style properties on demand to improve loading performance and reduce memory usage. ([#2476](https://github.com/maplibre/maplibre-gl-js/pull/2476)) (by [@pramilk](https://github.com/pramilk))
- Conditional WebGL2 support ([#1891](https://github.com/maplibre/maplibre-gl-js/pull/1891)) (by [@rotu](https://github.com/rotu))

### 🐞 Bug fixes

- Fix `LngLatBounds.extend()` to correctly handle `{ lng: number, lat: number }` coordinates. ([#2425](https://github.com/maplibre/maplibre-gl-js/pull/2425)) (by [@buffalom](https://github.com/buffalom))
- Fix the accuracy-circle in the geolocate control from randomly resizing. ([#2450](https://github.com/maplibre/maplibre-gl-js/pull/2450)) (by [@Philip2809](https://github.com/Philip2809))

## 3.0.0-pre.5

### ✨ Features and improvements

- Add queryTerrainElevation allows getting terrain elevation in meters at specific point ([#2264](https://github.com/maplibre/maplibre-gl-js/pull/2264)) (by [@manhcuongincusar1](https://github.com/manhcuongincusar1))
- Improve performance by sending style layers to worker thread before processing it on main thread to allow parallel processing ([#2131](https://github.com/maplibre/maplibre-gl-js/pull/2131)) (by [@pramilk](https://github.com/pramilk))
- ⚠️ Breaking - Resize map when container element is resized. The resize related events now has different data associated with it ([#2157](https://github.com/maplibre/maplibre-gl-js/pull/2157)). Previously the originalEvent field was the reason of this change, for example it could be a `resize` event from the browser. Now it is `ResizeObserverEntry`, see more [here](https://developer.mozilla.org/en-US/docs/web/api/resizeobserverentry). (by [@HarelM](https://github.com/HarelM))
- Add Map.getImage() to retrieve previously-loaded images. ([#2168](https://github.com/maplibre/maplibre-gl-js/pull/2168)) (by [@ZeLonewolf](https://github.com/ZeLonewolf))
- Add a method to enable/disable cooperative gestures ([#2152](https://github.com/maplibre/maplibre-gl-js/pull/2152)) (by [@kevinschaul](https://github.com/kevinschaul))
- ⚠️ Breaking - `LngLat.toBounds()` is replaced by a static method `LngLatBounds.fromLngLat()` ([#2188](https://github.com/maplibre/maplibre-gl-js/pull/2188)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Update CONTRIBUTING.md with details on setting up on M1 mac ([#2196](https://github.com/maplibre/maplibre-gl-js/pull/2196)) (by [@llambanna](https://github.com/llambanna))
- Update default type of originalEvent in MapLibreEvent to be `unknown` ([#2243](https://github.com/maplibre/maplibre-gl-js/pull/2243)) (by [@neodescis](https://github.com/neodescis))
- Improve performance when forcing full symbol placement by short circuiting pause checks ([#2241](https://github.com/maplibre/maplibre-gl-js/pull/2241)) (by [@schlosna](https://github.com/schlosna))
- Adding a `warnonce` when terrain and hillshade source are the same ([#2298](https://github.com/maplibre/maplibre-gl-js/pull/2298)) (by [@tempranova](https://github.com/tempranova))
- Remove a deprecation warning by removing an empty texture that is no longer being used in the codebase ([#2299](https://github.com/maplibre/maplibre-gl-js/pull/2299)) (by [@IvanSanchez](https://github.com/IvanSanchez))
- Improve initial loading performance by lazy serializing layers only when needed. ([#2306](https://github.com/maplibre/maplibre-gl-js/pull/2306)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- ⚠️ Breaking - Cancel unloaded tile request on zooming in across multiple zoom. Previously these requests were not cancelled. ([#2377](https://github.com/maplibre/maplibre-gl-js/pull/2377)) (by [@pramilk](https://github.com/pramilk))
- Add validateStyle MapOption to allow disabling style validation for faster performance in production environment. ([#2390](https://github.com/maplibre/maplibre-gl-js/pull/2390)) (by [@pramilk](https://github.com/pramilk))
- ⚠️ Breaking - Remove support for `hsl` css color in a format that does not comply with the CSS Color specification. Colors defined in `hsl(110, 0.7, 0.055)` format will no longer work, instead it is recommended to use the format with percentages `hsl(110, 70%, 5.5%)`. ([#2376](https://github.com/maplibre/maplibre-gl-js/pull/2376)) (by [@kajkal](https://github.com/kajkal))

### 🐞 Bug fixes

- Fix the type of the `features` property on `MapLayerMouseEvent` and `MapLayerTouchEvent` to be `MapGeoJSONFeature[]` in lieu of `GeoJSON.Feature[]` ([#2244](https://github.com/maplibre/maplibre-gl-js/pull/2244)) (by [@parkerziegler](https://github.com/parkerziegler))
- Fix GeolocateControl error if removed quickly ([#2391](https://github.com/maplibre/maplibre-gl-js/pull/2391)) (by [@Pessimistress](https://github.com/Pessimistress))
- Fix issue unloading sprite sheet when using `setStyle(style, {diff:true})` ([#2146](https://github.com/maplibre/maplibre-gl-js/pull/2146)) (by [@jcary741](https://github.com/jcary741))
- Fix wrap coords in `getTerrain` when `fitBounds` across the AM ([#2155](https://github.com/maplibre/maplibre-gl-js/pull/2155)) (by [@llambanna](https://github.com/llambanna))
- Fix LngLat `toArray` method return type to [number,number] ([#2233](https://github.com/maplibre/maplibre-gl-js/issues/2233)) (by [@maxdacruz](https://github.com/maxdacruz))
- Fix handling of text-offset with symbol-placement: line ([#2170](https://github.com/maplibre/maplibre-gl-js/issues/2170) and [#2171](https://github.com/maplibre/maplibre-gl-js/issues/2171)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Fix geolocate control permissions failure on IOS16 web view with fallback to `window.navigator.geolocation` ([#2359](https://github.com/maplibre/maplibre-gl-js/pull/2359)) (by [@HarelM](https://github.com/HarelM))
- Prevent unnecessary reload of raster sources when RTL Text Plugin loads ([#2380](https://github.com/maplibre/maplibre-gl-js/issues/2380)) (by [@ChrisLoer](https://github.com/ChrisLoer))
- Fix Handle AddProtocol callback function returning an HTMLImageElement ([#2393](https://github.com/maplibre/maplibre-gl-js/pull/2393)) (by [@pramilk](https://github.com/pramilk))
- Fix raster tiles being retained when raster-fade-duration is 0 ([#2445](https://github.com/maplibre/maplibre-gl-js/issues/2445)) (by [@ibesora](https://github.com/ibesora))

## 3.0.0-pre.4

### ✨ Features and improvements

- Add `setClusterOptions` to update cluster properties of the added sources: fixing these issues ([#429](https://github.com/maplibre/maplibre-gl-js/issues/429)) and ([#1384](https://github.com/maplibre/maplibre-gl-js/issues/1384)) (by [@IhsenBen](https://github.com/IhsenBen))
- Add types for `workerOptions` and `_options` in `geojson_source.ts` ([#1998](https://github.com/maplibre/maplibre-gl-js/pull/1998)) (by [@IhsenBen](https://github.com/IhsenBen))
- Add fullscreenstart, fullscreenend events to FullscreenControl ([#2128](https://github.com/maplibre/maplibre-gl-js/pull/2128)) (by [@kevinschaul](https://github.com/kevinschaul))
- Throttle the image request queue while the map is moving to improve performance ([#2097](https://github.com/maplibre/maplibre-gl-js/pull/2097)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))

### 🐞 Bug fixes

- Fix the worker been terminated on setting new style ([#2123](https://github.com/maplibre/maplibre-gl-js/pull/2123)) (by [@pramilk](https://github.com/pramilk))
- Change how meta key is detected for cooperative gestures ([#2152](https://github.com/maplibre/maplibre-gl-js/pull/2152)) (by [@kevinschaul](https://github.com/kevinschaul))
- Fix the worker been terminated on setting new style ([#2123](https://github.com/maplibre/maplibre-gl-js/pull/2123)) (by [@pramilk](https://github.com/pramilk))

## 3.0.0-pre.3

### ✨ Features and improvements

- Add support for multiple `sprite` declarations in one style file ([#1805](https://github.com/maplibre/maplibre-gl-js/pull/1805)) (by [@smellyshovel](https://github.com/smellyshovel))
- Extract sprite image on demand to reduce memory usage and improve performance by reducing number of getImageData calls ([#1809](https://github.com/maplibre/maplibre-gl-js/pull/1809)) (by [@pramilk](https://github.com/pramilk))

### 🐞 Bug fixes

- Fix issue ([#1024](https://github.com/maplibre/maplibre-gl-js/issues/1024)) - Zoom center not under cursor when terrain is on (by [@HarelM](https://github.com/HarelM))
- Fix errors when running style-spec bin scripts and added missing help. Removed unnecessary script 'gl-style-composite'. ([#1971](https://github.com/maplibre/maplibre-gl-js/pull/1971)) (by [@acalcutt](https://github.com/acalcutt))
- Fix the `slice` expression type ([#1886](https://github.com/maplibre/maplibre-gl-js/issues/1886)) (by [@kevinschaul](https://github.com/kevinschaul))

## 3.0.0-pre.2

### ✨ Features and improvements

- `QueryRenderedFeaturesOptions` type added to both of the params in queryRenderedFeatures in map.ts ([#1900](https://github.com/maplibre/maplibre-gl-js/issues/1900)) (by [@beharguy](https://github.com/beharguy))
- NavigationControlOptions is now optional when creating an instance of NavigationControl ([#1754](https://github.com/maplibre/maplibre-gl-js/issues/1754)) (by [@guimochila](https://github.com/guimochila))
- Listen to webglcontextcreationerror event and give detailed debug info when it fails ([#1715](https://github.com/maplibre/maplibre-gl-js/pull/1715)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Make sure `cooperativeGestures` overlay is always "on top" (z-index) of map features ([#1753](https://github.com/maplibre/maplibre-gl-js/pull/1753)) (by [@blyme](https://github.com/blyme))
- Use `willReadFrequently` hint to optimize 2D canvas usage and remove warnings ([#1808](https://github.com/maplibre/maplibre-gl-js/pull/1808)) (by [@kircher1](https://github.com/kircher1))
- Speed up the cross tile symbol index in certain circumstances ([#1755](https://github.com/maplibre/maplibre-gl-js/pull/1755)) (by [@mfedderly](https://github.com/mfedderly))
- Improve rendering speed in scenes with many colliding symbolic icons and labels ([#1757](https://github.com/maplibre/maplibre-gl-js/pull/1757)) (by [@AdamS108](https://github.com/AdamS108))
- Make request for ImageSource cancelable ([#1802](https://github.com/maplibre/maplibre-gl-js/pull/1802)) (by [@blinkzz](https://github.com/blinkzz))
- Throttle the image request queue while the map is moving to improve performance ([#2097](https://github.com/maplibre/maplibre-gl-js/pull/2097)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))

### 🐞 Bug fixes

- Remove dependency on `@rollup/plugin-json`, which was in conflict with `rollup-plugin-import-assert` ([#1894](https://github.com/maplibre/maplibre-gl-js/pull/1894)) (by [@rotu](https://github.com/rotu))
- Remove dependency on `@mapbox/gazetteer` which caused some build warnings ([#1757](https://github.com/maplibre/maplibre-gl-js/pull/1757) [#1898](https://github.com/maplibre/maplibre-gl-js/pull/1898)) (by [@AdamS108](https://github.com/AdamS108))
- Fix `getElevation()` causing uncaught error ([#1650](https://github.com/maplibre/maplibre-gl-js/issues/1650)). (by [@zbigniewmatysek-tomtom](https://github.com/zbigniewmatysek-tomtom))
- Fix headless benchmark execution especially on VM ([#1732](https://github.com/maplibre/maplibre-gl-js/pull/1732)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- fix issue [#860](https://github.com/maplibre/maplibre-gl-js/issues/860) fill-pattern with pixelRatio > 1 is now switched correctly at runtime. ([#1765](https://github.com/maplibre/maplibre-gl-js/pull/1765)) (by [@zhangyiatmicrosoft](https://github.com/zhangyiatmicrosoft))
- Fix the exception that would be thrown on `map.setStyle` when it is passed with transformStyle option and map is initialized without an initial style. ([#1824](https://github.com/maplibre/maplibre-gl-js/pull/1824)) (by [@ambientlight](https://github.com/ambientlight))
- Fix the behavior of the compass button on touch devices. ([#1852](https://github.com/maplibre/maplibre-gl-js/pull/1852)) (by [@VehpuS](https://github.com/VehpuS))

## 3.0.0-pre.1

### ✨ Features and improvements

- Return a promise from `once` method to allow easier usage of async/await in this case ([#1690](https://github.com/maplibre/maplibre-gl-js/pull/1690)) (by [@HarelM](https://github.com/HarelM))
- Add pseudo (CSS) fullscreen as a fallback for iPhones ([#1678](https://github.com/maplibre/maplibre-gl-js/pull/1678)) (by [@caspg](https://github.com/caspg))
- Add `updateData` to `GeoJSONSource` which allows for partial data updates ([#1605](https://github.com/maplibre/maplibre-gl-js/pull/1605)) (by [@mfedderly](https://github.com/mfedderly))

### 🐞 Bug fixes

- Fix `GeoJSONSource` appearing to never finish loading when calling its `setData` method immediately after adding it to a `Map` due to it not firing a `metadata` `data` event ([#1693](https://github.com/maplibre/maplibre-gl-js/issues/1693)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Fix the gap between terrain elevated tiles ([#1602](https://github.com/maplibre/maplibre-gl-js/issues/1602)) (by [@HarelM](https://github.com/HarelM))

## 3.0.0-pre.0

### ✨ Features and improvements

- Add a RenderPool to render tiles onto textures for 3D ([#1671](https://github.com/maplibre/maplibre-gl-js/pull/1671)) (by [@prozessor13](https://github.com/prozessor13))
- Add map.getCameraTargetElevation() ([#1558](https://github.com/maplibre/maplibre-gl-js/pull/1558)) (by [@birkskyum](https://github.com/birkskyum))
- Add `freezeElevation` to `AnimationOptions` to allow smooth camera movement in 3D ([#1514](https://github.com/maplibre/maplibre-gl-js/pull/1514), [#1492](https://github.com/maplibre/maplibre-gl-js/issues/1492)) (by [@prozessor13](https://github.com/prozessor13))
- ⚠️ Breaking - Remove deprecated `mapboxgl-` css classes ([#1575](https://github.com/maplibre/maplibre-gl-js/pull/1575)) (by [@birkskyum](https://github.com/birkskyum))
- Add map.setStyle's transformStyle option ([#1632](https://github.com/maplibre/maplibre-gl-js/pull/1632)) (by [@ambientlight](https://github.com/ambientlight))
- ⚠️ Breaking - Improve rendering of areas below sea level, and remove elevationOffset workaround ([#1578](https://github.com/maplibre/maplibre-gl-js/pull/1578)) (by [@birkskyum](https://github.com/birkskyum))
- ⚠️ Breaking - Move terrain object from style.terrain to map.terrain ([#1628](https://github.com/maplibre/maplibre-gl-js/pull/1628)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- ⚠️ Breaking - Make geojson data source a required field to align with the docs ([#1396](https://github.com/maplibre/maplibre-gl-js/issues/1396)) (by [@HarelM](https://github.com/HarelM))
- Fix showTileBoundaries to show the first vector source ([#1395](https://github.com/maplibre/maplibre-gl-js/pull/1395)) (by [@jleedev](https://github.com/jleedev))
- Fix `match` expression type ([#1631](https://github.com/maplibre/maplibre-gl-js/pull/1631)) (by [@lukashass](https://github.com/lukashass))

## 2.4.0

### ✨ Features and improvements

- Added calculateCameraOptionsFromTo to camera ([#1427](https://github.com/maplibre/maplibre-gl-js/pull/1427)) (by [@BAschl](https://github.com/BAschl))
- Improve expression types ([#1510](https://github.com/maplibre/maplibre-gl-js/pull/1510)) (by [@cns-solutions-admin](https://github.com/cns-solutions-admin))
- Improve performance for primitive size selection ([#1508](https://github.com/maplibre/maplibre-gl-js/pull/1508)) (by [@kircher1](https://github.com/kircher1))
- Upgrade target from ES2017 to ES2019 ([#1499](https://github.com/maplibre/maplibre-gl-js/pull/1499)) (by [@birkskyum](https://github.com/birkskyum))
- Improve error handling ([#1485](https://github.com/maplibre/maplibre-gl-js/pull/1485)) (by [@birkskyum](https://github.com/birkskyum))
- Removed `_interpolationType` unused field ([#264](https://github.com/maplibre/maplibre-gl-js/issues/264)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix attribution not being displayed for terrain ([#1516](https://github.com/maplibre/maplibre-gl-js/pull/1516)) (by [@acalcutt](https://github.com/acalcutt))
- No triggering of contextmenu after rotate, pitch, etc. also on Windows ([#1537](https://github.com/maplibre/maplibre-gl-js/pull/1537)) (by [@cns-solutions-admin](https://github.com/cns-solutions-admin))

## 2.3.1-pre.2

### ✨ Features and improvements

- Improve expression types ([#1510](https://github.com/maplibre/maplibre-gl-js/pull/1510)) (by [@cns-solutions-admin](https://github.com/cns-solutions-admin))
- Improve performance for primitive size selection ([#1508](https://github.com/maplibre/maplibre-gl-js/pull/1508)) (by [@kircher1](https://github.com/kircher1))
- Upgrade target from ES2017 to ES2019 ([#1499](https://github.com/maplibre/maplibre-gl-js/pull/1499)) (by [@birkskyum](https://github.com/birkskyum))

## 2.3.1-pre.1

### ✨ Features and improvements

- Improve error handling ([#1485](https://github.com/maplibre/maplibre-gl-js/pull/1485)) (by [@birkskyum](https://github.com/birkskyum))

## 2.3.0

### ✨ Features and improvements

- Re-enable method to get library version. Either with `import {version} from 'maplibre-gl'`, or on a Map instance as `map.version`. ([#1471](https://github.com/maplibre/maplibre-gl-js/pull/1471)) (by [@birkskyum](https://github.com/birkskyum))

## 2.2.1

### 🐞 Bug fixes

- Fix types generation and make sure they run as part of the CI ([#1462](https://github.com/maplibre/maplibre-gl-js/issues/1462), [#1465](https://github.com/maplibre/maplibre-gl-js/pull/1465)) (by [@HarelM](https://github.com/HarelM))

## 2.2.0

Everything from the four previous pre-releases:

### ✨ Features and improvements

- Update `icon-padding` symbol layout property to support asymmetric padding ([#1289](https://github.com/maplibre/maplibre-gl-js/pull/1289)) (by [@drwestco](https://github.com/drwestco))
- Added `cooperativeGestures` option when instantiating map to prevent inadvertent scrolling/panning when navigating a page where map is embedded inline ([#234](https://github.com/maplibre/maplibre-gl-js/issues/234)) (by [@ewagstaff](https://github.com/ewagstaff))
- Improve filter specification typings ([#1390](https://github.com/maplibre/maplibre-gl-js/pull/1390)) (by [@HarelM](https://github.com/HarelM))
- Add 3D terrain capabilities ([#165](https://github.com/maplibre/maplibre-gl-js/pull/165), [#1022](https://github.com/maplibre/maplibre-gl-js/pull/1022)) (by [@prozessor13](https://github.com/prozessor13))
- Cancel pending GeoJSON requests when `GeoJSONSource.setData()` is called instead of waiting for any pending request to complete before issuing the request for the new URL ([#1102](https://github.com/maplibre/maplibre-gl-js/pull/1102)) (by [@vanilla-lake](https://github.com/vanilla-lake))

### 🐞 Bug fixes

- Fix compact attribution style when using global CSS that sets `box-sizing: border-box;` ([#1250](https://github.com/maplibre/maplibre-gl-js/pull/1250)) (by [@lukashass](https://github.com/lukashass))
- Handle maxBounds which cross the meridian at longitude ±180° ([#1299](https://github.com/maplibre/maplibre-gl-js/pull/1299)) (by [@burleight](https://github.com/burleight))
- Hide arrow displayed in default `summary` styles on the attribution control ([#1258](https://github.com/maplibre/maplibre-gl-js/pull/1258)) (by [@pjsier](https://github.com/pjsier))
- Fix memory usage in terrain 3D ([#1291](https://github.com/maplibre/maplibre-gl-js/issues/1291), [#1302](https://github.com/maplibre/maplibre-gl-js/pull/1302)) (by [@prozessor13](https://github.com/prozessor13))
- Fix disappearance of closest tiles when 3D terrain is enabled ([#1241](https://github.com/maplibre/maplibre-gl-js/issues/1241), [#1300](https://github.com/maplibre/maplibre-gl-js/pull/1300)) (by [@prozessor13](https://github.com/prozessor13))

## 2.2.0-pre.4

### ✨ Features and improvements

- Update `icon-padding` symbol layout property to support asymmetric padding ([#1289](https://github.com/maplibre/maplibre-gl-js/pull/1289)) (by [@drwestco](https://github.com/drwestco))
- Added `cooperativeGestures` option when instantiating map to prevent inadvertent scrolling/panning when navigating a page where map is embedded inline ([#234](https://github.com/maplibre/maplibre-gl-js/issues/234)) (by [@ewagstaff](https://github.com/ewagstaff))
- Improve filter specification typings ([#1390](https://github.com/maplibre/maplibre-gl-js/pull/1390)) (by [@HarelM](https://github.com/HarelM))

### 🐞 Bug fixes

- Fix compact attribution style when using global CSS that sets `box-sizing: border-box;` ([#1250](https://github.com/maplibre/maplibre-gl-js/pull/1250)) (by [@lukashass](https://github.com/lukashass))

## 2.2.0-pre.3

### 🐞 Bug fixes

- Handle maxBounds which cross the meridian at longitude ±180° ([#1299](https://github.com/maplibre/maplibre-gl-js/pull/1299)) (by [@burleight](https://github.com/burleight))
- Hide arrow displayed in default `summary` styles on the attribution control ([#1258](https://github.com/maplibre/maplibre-gl-js/pull/1258)) (by [@pjsier](https://github.com/pjsier))
- Fix memory usage in terrain 3D ([#1291](https://github.com/maplibre/maplibre-gl-js/issues/1291), [#1302](https://github.com/maplibre/maplibre-gl-js/pull/1302)) (by [@prozessor13](https://github.com/prozessor13))
- Fix disappearance of closest tiles when 3D terrain is enabled ([#1241](https://github.com/maplibre/maplibre-gl-js/issues/1241), [#1300](https://github.com/maplibre/maplibre-gl-js/pull/1300)) (by [@prozessor13](https://github.com/prozessor13))

## 2.2.0-pre.2

### ✨ Features and improvements

- Add 3D terrain capabilities ([#165](https://github.com/maplibre/maplibre-gl-js/pull/165), [#1022](https://github.com/maplibre/maplibre-gl-js/pull/1022)) (by [@prozessor13](https://github.com/prozessor13))

## 2.2.0-pre.1

### ✨ Features and improvements

- Cancel pending GeoJSON requests when `GeoJSONSource.setData()` is called instead of waiting for any pending request to complete before issuing the request for the new URL ([#1102](https://github.com/maplibre/maplibre-gl-js/pull/1102)) (by [@vanilla-lake](https://github.com/vanilla-lake))

## 2.1.9

### 🐞 Bug fixes

- Add back typescript typings to dependencies instead of devDependencies ([#1178](https://github.com/maplibre/maplibre-gl-js/pull/1178)) (by [@HarelM](https://github.com/HarelM))

## 2.1.8

### ✨ Features and improvements

- Changed logic for showing the MapLibre logo. The MapLibre logo is now shown by setting the map option 'maplibreLogo' to true or by adding it to a map with addControl. TileJSON no longer controls if the logo is shown. ([#786](https://github.com/maplibre/maplibre-gl-js/pull/786)) (by [@acalcutt](https://github.com/acalcutt))

### 🐞 Bug fixes

- Fix missing `touchmove` in `MapTouchEvent["type"]` ([#1131](https://github.com/maplibre/maplibre-gl-js/pull/1131)) (by [@smellyshovel](https://github.com/smellyshovel))
- Type CustomLayerInterface renderingMode, onRemove, onAdd, and prerender optional ([#1122](https://github.com/maplibre/maplibre-gl-js/pull/1122)) (by [@nreese](https://github.com/nreese))

## 2.1.8-pre.3

### 🐞 Bug fixes

- Use correct location for mouse events of line layer with line-offset ([#1108](https://github.com/maplibre/maplibre-gl-js/issues/1108)). (by [@jkoelewijn](https://github.com/jkoelewijn))
- Change `GeoJSONFeature.properties` type from `{}` to `{ [name: string]: any; }` ([#1115](https://github.com/maplibre/maplibre-gl-js/pull/1115)). (by [@nreese](https://github.com/nreese))
- Fix `error TS2503: Cannot find namespace 'GeoJSON'` ([#1096](https://github.com/maplibre/maplibre-gl-js/issues/1096)). (by [@wipfli](https://github.com/wipfli))

## 2.1.8-pre.2

### ✨ Features and improvements

- Removal of the unminified production build target, so `npm run build-prod` will be the main build command going forward.

### 🐞 Bug fixes

- Dispose source resources on map style removal, it also fixes `cannot read properties of undefined (reading 'sourceCaches')` error ([#1099](https://github.com/maplibre/maplibre-gl-js/pull/1099)). (by [@khmm12](https://github.com/khmm12))
- Add MapGeoJSONFeature type as replacement for MapboxGeoJSONFeature. MapGeoJSONFeature type extends GeoJSONFeature type with layer, source, sourceLayer, and state properties ([#1104](https://github.com/maplibre/maplibre-gl-js/pull/1104)). (by [@nreese](https://github.com/nreese))
- Fix automatic refreshing of expired raster tiles ([#1106](https://github.com/maplibre/maplibre-gl-js/pull/1106)) (by [@westinrm](https://github.com/westinrm))
- Fix precision loss in some matrix calculations ([#1105](https://github.com/maplibre/maplibre-gl-js/issues/1105)) (by [@timokorkalainen](https://github.com/timokorkalainen))

## 2.1.8-pre.1

### ✨ Features and improvements

- Add option `viewport-glyph` to `text-rotation-alignment` which places glyphs along a linestring and rotates them to the x-axis of the viewport ([#716](https://github.com/maplibre/maplibre-gl-js/pull/716)). (by [@wipfli](https://github.com/wipfli))

### 🐞 Bug fixes

- Change `GeoJSONFeature.id` type from `number | string | void` to `number | string | undefined` ([#1093](https://github.com/maplibre/maplibre-gl-js/pull/1093)) (by [@nreese](https://github.com/nreese))
- Add FeatureIdentifier type to define feature parameter in setFeatureState, removeFeatureState, and getFeatureState methods. Change FeatureIdentifier.id from `id: string | number;` to `id?: string | number | undefined;` ([#1095](https://github.com/maplibre/maplibre-gl-js/pull/1095)) (by [@nreese](https://github.com/nreese))
- Change map.on, map.off, and map.once type parameter from "type: MapEvent" to "type: MapEvent | string" ([#1094](https://github.com/maplibre/maplibre-gl-js/pull/1094)) (by [@nreese](https://github.com/nreese))

## 2.1.7

### 🐞 Bug fixes

- Add adjustment for glyph rendering, CJK fonts are mainly affected ([#1002](https://github.com/maplibre/maplibre-gl-js/issues/1002)). (by [@Kanahiro](https://github.com/Kanahiro))
- Improve typings to fix Angular strict mode failure ([#790](https://github.com/maplibre/maplibre-gl-js/issues/790), [#970](https://github.com/maplibre/maplibre-gl-js/issues/970), [#934](https://github.com/maplibre/maplibre-gl-js/issues/934)) (by [@HarelM](https://github.com/HarelM))
- Fix `SourceCache.loaded()` always returning `true` following a load error ([#1025](https://github.com/maplibre/maplibre-gl-js/issues/1025)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Added back csp and dev builds to npm package ([#1042](https://github.com/maplibre/maplibre-gl-js/issues/1042)) (by [@HarelM](https://github.com/HarelM))

## 2.1.6

### 🐞 Bug fixes

- Publish `dist/package.json` ([#998](https://github.com/maplibre/maplibre-gl-js/pull/998)). (by [@wipfli](https://github.com/wipfli))

## 2.1.6-pre.1

### 🐞 Bug fixes

- Publish `dist/package.json` ([#998](https://github.com/maplibre/maplibre-gl-js/pull/998)). (by [@wipfli](https://github.com/wipfli))

## 2.1.5

### 🐞 Bug fixes

- Publish empty `postinstall.js` file. Follow-up on ([#990](https://github.com/maplibre/maplibre-gl-js/issues/990)) (by [@wipfli](https://github.com/wipfli))

## 2.1.5-pre.1

### 🐞 Bug fixes

- Publish empty `postinstall.js` file. Follow-up on ([#990](https://github.com/maplibre/maplibre-gl-js/issues/990)) (by [@wipfli](https://github.com/wipfli))

## 2.1.4

### 🐞 Bug fixes

- Fix missing `postinstall.js` file in npm publish. Follow-up on ([#990](https://github.com/maplibre/maplibre-gl-js/issues/990)) (by [@wipfli](https://github.com/wipfli))

## 2.1.3

### 🐞 Bug fixes

- Fix postinstall `ts-node` error on non-dev installs ([#900](https://github.com/maplibre/maplibre-gl-js/pull/900)) (by [@birkskyum](https://github.com/birkskyum))

## 2.1.2

### Features and improvements

- Default compact attribution to be open by default to comply with OpenStreetMap Attribution Guidelines ([#795](https://github.com/maplibre/maplibre-gl-js/pull/795)) (by [@acalcutt](https://github.com/acalcutt))
- Export `Source` classes (`GeoJSONSource` etc.) declarations. ([#801](https://github.com/maplibre/maplibre-gl-js/issues/801)) (by [@sebisteiner](https://github.com/sebisteiner))
- Make `AJAXError` public so error HTTP responses can be handled differently from other errors. ([#941](https://github.com/maplibre/maplibre-gl-js/pull/941)) (by [@vanilla-lake](https://github.com/vanilla-lake))

### 🐞 Bug fixes

- Fix compact attribution button showing when attribution is blank ([#795](https://github.com/maplibre/maplibre-gl-js/pull/795)) (by [@acalcutt](https://github.com/acalcutt))
- Fix error mismatched image size for CJK characters ([#718](https://github.com/maplibre/maplibre-gl-js/issues/718)) (by [@HarelM](https://github.com/HarelM))
- Fire `dataabort` and `sourcedataabort` events when a tile request is aborted ([#794](https://github.com/maplibre/maplibre-gl-js/issues/794)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Fix NextJs `performance` undefined ([#768](https://github.com/maplibre/maplibre-gl-js/issues/768)) (by [@HarelM](https://github.com/HarelM))

## 2.1.1

### 🐞 Bug fixes

- Fix stale tiles being shown when calling VectorTileSource#setTiles while the map is moving. ([#913](https://github.com/maplibre/maplibre-gl-js/pull/913)) (by [@vanilla-lake](https://github.com/vanilla-lake))

## 2.1.0

### ✨ Features and improvements

- Add `icon-overlap` and `text-overlap` symbol layout properties ([#347](https://github.com/maplibre/maplibre-gl-js/pull/347)) (by [@drwestco](https://github.com/drwestco))
- Deprecate `icon-allow-overlap` and `text-allow-overlap` symbol layout properties. `icon-overlap` and `text-overlap` are their replacements. ([#347](https://github.com/maplibre/maplibre-gl-js/pull/347)) (by [@drwestco](https://github.com/drwestco))
- Remove node package chalk from devDependencies ([#789](https://github.com/maplibre/maplibre-gl-js/pull/789)). (by [@astridx](https://github.com/astridx))
- Allow setting a custom pixel ratio by adding a `MapOptions#pixelRatio` property and a `Map#setPixelRatio` method. Since a high `devicePixelRatio` value can lead to performance and display problems, it is done at your own risk. ([#769](https://github.com/maplibre/maplibre-gl-js/issues/769)) (by [@vanilla-lake](https://github.com/vanilla-lake))

## 2.0.5

### 🐞 Bug fixes

- Remove list of node versions allowed to install the package.

## 2.0.4

### 🐞 Bug fixes

- Missing package.json file in version 2.0.3 dist in npm ([#811](https://github.com/maplibre/maplibre-gl-js/issues/811)) - this causes webpack to fail (by [@HarelM](https://github.com/HarelM))

## 2.0.3

### Features and improvements

- Remove node package chalk from devDependencies ([#789](https://github.com/maplibre/maplibre-gl-js/pull/789)). (by [@astridx](https://github.com/astridx))
- Remove vector-tile module declaration and revert to using point from [@mapbox/point-geometry](https://github.com/mapbox/point-geometry) ([#788](https://github.com/maplibre/maplibre-gl-js/issues/788), [#800](https://github.com/maplibre/maplibre-gl-js/pull/800)) (by [@HarelM](https://github.com/HarelM))
- Moved development environment to use NodeJs 16 ([#781](https://github.com/maplibre/maplibre-gl-js/pull/781), [#806](https://github.com/maplibre/maplibre-gl-js/pull/806)) (by [@birkskyum](https://github.com/birkskyum))

### 🐞 Bug fixes

- Fix max cluster zoom in geojson source ([#61](https://github.com/maplibre/maplibre-gl-js/issues/61)) (by [@HarelM](https://github.com/HarelM))

## 2.0.2

### 🐞 Bug fixes

- Fix typescript generated file ([#776](https://github.com/maplibre/maplibre-gl-js/issues/776)). (by [@wipfli](https://github.com/wipfli))

## 2.0.1

### 🐞 Bug fixes

- Fix documentation of `addProtocol` and `removeProtocol`. ([#779](https://github.com/maplibre/maplibre-gl-js/pull/779)) (by [@wipfli](https://github.com/wipfli))

## 2.0.0

### Features and improvements

- Migrated the production code to typescript ([#209](https://github.com/maplibre/maplibre-gl-js/pull/209)) (by [@HarelM](https://github.com/HarelM))
- ** Breaking Change ** removed `version` from the public API
- ** Breaking Change ** stopped supporting IE (internet explorer)
- ** Breaking Change ** stopped supporting Chrome 49-65. Chrome 66+ required. For Chrome 49-65 support use version 1.15.2.
- ** Breaking Change ** removed all code related to `accessToken` and Mapbox specific urls starting with `mapbox://`. Telemetry and tracking code was removed.
- ** Breaking Change ** removed `baseApiUrl` as it was used only for Mapbox related urls
- ** Breaking Change ** typescript typings have changed:
    - `Style` => `StyleSpecification`
    - `AnyLayer` => `LayerSpecification`
    - `AnySourceData` => `SourceSpecification`
    - `MapboxEvent` => `MapLibreEvent`
    - `MapboxOptions` => `MapOptions`
    - `MapBoxZoomEvent` => `MapLibreZoomEvent`
    - `*SourceRaw` + `*SourceOptions` => `*SourceSpecification`
    - `*Source` (source implementation definition) were removed
    - `*Layer` => `*LayerSpecification`
    - `*Paint` => `*LayerSpecification['paint']`
    - `*Layout` => `*LayerSpecification['layout']`
    - `MapboxGeoJSONFeature` => `GeoJSONFeature`
- Added `redraw` function to map ([#206](https://github.com/maplibre/maplibre-gl-js/issues/206)) (by [@fredj](https://github.com/fredj))
- Improve attribution controls accessibility. See ([#359](https://github.com/maplibre/maplibre-gl-js/issues/359)) (by [@astridx](https://github.com/astridx))
- Allow maxPitch value up to 85, use values greater than 60 at your own risk ([#574](https://github.com/maplibre/maplibre-gl-js/pull/574)) (by [@kibala145](https://github.com/kibala145))
- `getImage` uses createImageBitmap when supported ([#650](https://github.com/maplibre/maplibre-gl-js/pull/650)) (by [@clementgayvallet](https://github.com/clementgayvallet))

### 🐞 Bug fixes

- Fix warning due to strict comparison of SDF property in image sprite ([#303](https://github.com/maplibre/maplibre-gl-js/issues/303)) (by [@drwestco](https://github.com/drwestco))
- Fix tile placeholder replacement to allow for placeholders to be in a URL more than once. ([#348](https://github.com/maplibre/maplibre-gl-js/pull/348)) (by [@rbrundritt](https://github.com/rbrundritt))
- Fix type check for non dom environment. ([#334](https://github.com/maplibre/maplibre-gl-js/issues/334)) (by [@lhapaipai](https://github.com/lhapaipai))
- Fix precision problem in patterns when overzoomed in OpenGL ES devices. ([#416](https://github.com/maplibre/maplibre-gl-js/pull/416)) (by [@andreadapisa](https://github.com/andreadapisa))
- Fix padding-top of the popup to improve readability of popup text ([#354](https://github.com/maplibre/maplibre-gl-js/pull/354)). (by [@naogify](https://github.com/naogify))
- Fix GeoJSONSource#loaded sometimes returning true while there are still pending loads ([#669](https://github.com/maplibre/maplibre-gl-js/issues/669)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Fix MapDataEvent#isSourceLoaded being true in GeoJSONSource "dataloading" event handlers ([#694](https://github.com/maplibre/maplibre-gl-js/issues/694)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Fix events being fired after Map#remove has been called when the WebGL context is lost and restored ([#726](https://github.com/maplibre/maplibre-gl-js/issues/726)) (by [@vanilla-lake](https://github.com/vanilla-lake))
- Fix nested expressions types definition ([#757](https://github.com/maplibre/maplibre-gl-js/pull/757)) (by [@j8seangel](https://github.com/j8seangel))

## 1.15.2

### 🐞 Bug fixes

- Fix breaking changes introduced in v1.15.0 by adoption dual naming scheme for CSS class names ([#203](https://github.com/maplibre/maplibre-gl-js/pull/203)) (by [@p-j](https://github.com/p-j))

## 1.15.1

### 🐞 Bug fixes

- Add void return for some method declaration to match TS strict mode ([#194](https://github.com/maplibre/maplibre-gl-js/pull/194)) (by [@ArthurMetzger](https://github.com/ArthurMetzger))
- Fix css leftovers ([#83](https://github.com/maplibre/maplibre-gl-js/issues/83)) (by [@HarelM](https://github.com/HarelM))

## 1.15.0

### Features and improvements

- ** Breaking Change: ** Rename css classes ([#83](https://github.com/maplibre/maplibre-gl-js/issues/83)) (by [@HarelM](https://github.com/HarelM))
- Added custom protocol support to allow overriding ajax calls ([#29](https://github.com/maplibre/maplibre-gl-js/issues/29)) (by [@HarelM](https://github.com/HarelM))
- Added setTransformRequest to map ([#159](https://github.com/maplibre/maplibre-gl-js/pull/159)) (by [@thaddmt](https://github.com/thaddmt))
- Publish @maplibre/maplibre-gl-style-spec v14.0.0 on NPM ([#149](https://github.com/maplibre/maplibre-gl-js/pull/149)) (by [@wipfli](https://github.com/wipfli))
- Replace link to mapbox on LogoControl by link to maplibre ([#151](https://github.com/maplibre/maplibre-gl-js/pull/151)) (by [@habi](https://github.com/habi))
- Migrate style spec files from mapbox to maplibre ([#147](https://github.com/maplibre/maplibre-gl-js/pull/147)) (by [@wipfli](https://github.com/wipfli))
- Publish the MapLibre style spec in NPM ([#140](https://github.com/maplibre/maplibre-gl-js/pull/140)) (by [@wipfli](https://github.com/wipfli))
- Replace mapboxgl with maplibregl in JSDocs inline examples ([#134](https://github.com/maplibre/maplibre-gl-js/pull/134)) (by [@wipfli](https://github.com/wipfli))
- Bring in typescript definitions file ([#24](https://github.com/maplibre/maplibre-gl-js/issues/24)) (by [@HarelM](https://github.com/HarelM))
- Update example links to https://maplibre.org/maplibre-gl-js-docs/ ([#131](https://github.com/maplibre/maplibre-gl-js/pull/131)) (by [@wipfli](https://github.com/wipfli))
- Improve performance of layers with constant `*-sort-key` ([#78](https://github.com/maplibre/maplibre-gl-js/pull/78)) (by [@ghost](https://github.com/ghost))

### 🐞 Bug fixes

- Prevented attribution button from submitting form ([#178](https://github.com/maplibre/maplibre-gl-js/issues/178)) (by [@BartInTheField](https://github.com/BartInTheField))

## 1.14.0

### Features and improvements

- Rebranded to MapLibre
- New logo

### 🐞 Bug fixes

- Rename SVGs mapboxgl-ctrl-\*.svg to maplibregl ([#85](https://github.com/maplibre/maplibre-gl-js/pull/85)) (by [@nyurik](https://github.com/nyurik))
- fix ImageSource not working in FF/Safari ([#87](https://github.com/maplibre/maplibre-gl-js/pull/87)) (by [@lseelenbinder](https://github.com/lseelenbinder))
- Update HTML debug files to use MapLibre in titles ([#84](https://github.com/maplibre/maplibre-gl-js/pull/84)) (by [@nyurik](https://github.com/nyurik))
- fix CI checksize job to use maplibre name ([#86](https://github.com/maplibre/maplibre-gl-js/pull/86)) (by [@nyurik](https://github.com/nyurik))
- Move output files from mapbox._ to maplibre._ ([#75](https://github.com/maplibre/maplibre-gl-js/pull/75)) (by [@Joxit](https://github.com/Joxit))
- Remove mapbox specifics and branding from .github ([#64](https://github.com/maplibre/maplibre-gl-js/pull/64)) (by [@marcelnormann](https://github.com/marcelnormann))
- Fix a bug where mapbox-gl-js is no longer licensed as open source, but we owe immeasurable gratitude to Mapbox for releasing all their initial code to the community under BSD-3 license.

## 1.13.0

### ✨ Features and improvements

- Improve accessibility by fixing issues reported by WCAG 2.1. [#9991](https://github.com/mapbox/mapbox-gl-js/pull/9991)
- Improve accessibility when opening a popup by immediately focusing on the content. [#9774](https://github.com/mapbox/mapbox-gl-js/pull/9774) (by [@watofundefined](https://github.com/watofundefined)))
- Improve rendering performance of symbols with `symbol-sort-key`. [#9751](https://github.com/mapbox/mapbox-gl-js/pull/9751) (by [@osvodef](https://github.com/osvodef)))
- Add `Marker` `clickTolerance` option. [#9640](https://github.com/mapbox/mapbox-gl-js/pull/9640) (by [@ChristopherChudzicki](https://github.com/ChristopherChudzicki)))
- Add `Map` `hasControl` method. [#10035](https://github.com/mapbox/mapbox-gl-js/pull/10035)
- Add `Popup` `setOffset` method. [#9946](https://github.com/mapbox/mapbox-gl-js/pull/9946) (by [@jutaz](https://github.com/jutaz)))
- Add `KeyboardHandler` `disableRotation` and `enableRotation` methods. [#10072](https://github.com/mapbox/mapbox-gl-js/pull/10072) (by [@jmbott](https://github.com/jmbott)))

### 🐞 Bug fixes

- Fix a bug where `queryRenderedFeatures` didn't properly expose the paint values if they were data-driven. [#10074](https://github.com/mapbox/mapbox-gl-js/pull/10074) (by [@osvodef](https://github.com/osvodef)))
- Fix a bug where attribution didn't update when layer visibility changed during zooming. [#9943](https://github.com/mapbox/mapbox-gl-js/pull/9943)
- Fix a bug where hash control conflicted with external history manipulation (e.g. in single-page apps). [#9960](https://github.com/mapbox/mapbox-gl-js/pull/9960) (by [@raegen](https://github.com/raegen)))
- Fix a bug where `fitBounds` had an unexpected result with non-zero bearing and uneven padding. [#9821](https://github.com/mapbox/mapbox-gl-js/pull/9821) (by [@allison-strandberg](https://github.com/allison-strandberg)))
- Fix HTTP support when running GL JS against [Mapbox Atlas](https://www.mapbox.com/atlas). [#10090](https://github.com/mapbox/mapbox-gl-js/pull/10090)
- Fix a bug where the `within` expression didn't work in `querySourceFeatures`. [#9933](https://github.com/mapbox/mapbox-gl-js/pull/9933)
- Fix a bug where `Popup` content HTML element was removed on `setDOMContent`. [#10036](https://github.com/mapbox/mapbox-gl-js/pull/10036)
- Fix a compatibility bug when `icon-image` is used as a legacy categorical function. [#10060](https://github.com/mapbox/mapbox-gl-js/pull/10060)
- Reduce rapid memory growth in Safari by ensuring `Image` dataURI's are released. [#10118](https://github.com/mapbox/mapbox-gl-js/pull/10118)

### ⚠️ Note on IE11

We intend to remove support for Internet Explorer 11 in a future release of GL JS later this year.

## 1.12.0

### ✨ Features and improvements

- Add methods for changing a vector tile source dynamically (e.g. `setTiles`, `setUrl`). [#8048](https://github.com/mapbox/mapbox-gl-js/pull/8048) (by [@stepankuzmin](https://github.com/stepankuzmin))
- Add a `filter` option for GeoJSON sources to filter out features prior to processing (e.g. before clustering). [#9864](https://github.com/mapbox/mapbox-gl-js/pull/9864)
- Vastly increase precision of `line-gradient` for long lines. [#9694](https://github.com/mapbox/mapbox-gl-js/pull/9694)
- Improve `raster-dem` sources to properly support the `maxzoom` option and overzooming. [#9789](https://github.com/mapbox/mapbox-gl-js/pull/9789) (by [@brendan-ward](@brendanhttps://github.com/ward))

### 🐞 Bug fixes

- Fix a bug where bearing snap interfered with `easeTo` and `flyTo` animations, freezing the map. [#9884](https://github.com/mapbox/mapbox-gl-js/pull/9884) (by [@andycalder](https://github.com/andycalder))
- Fix a bug where a fallback image was not used if it was added via `addImage`. [#9911](https://github.com/mapbox/mapbox-gl-js/pull/9911) (by [@francois2metz](https://github.com/francois2metz))
- Fix a bug where `promoteId` option failed for fill extrusions with defined feature ids. [#9863](https://github.com/mapbox/mapbox-gl-js/pull/9863)

### 🛠️ Workflow

- Renamed the default development branch from `master` to `main`.

## 1.11.1

### 🐞 Bug fixes

- Fix a bug that caused `map.loaded()` to incorrectly return `false` after a click event. ([#9825](https://github.com/mapbox/mapbox-gl-js/pull/9825))

## 1.11.0

### ✨ Features and improvements

- Add an option to scale the default `Marker` icon.([#9414](https://github.com/mapbox/mapbox-gl-js/pull/9414)) (by [@adrianababakanian](https://github.com/adrianababakanian))
- Improving the shader compilation speed by manually getting the run-time attributes and uniforms.([#9497](https://github.com/mapbox/mapbox-gl-js/pull/9497))
- Added `clusterMinPoints` option for clustered GeoJSON sources that defines the minimum number of points to form a cluster.([#9748](https://github.com/mapbox/mapbox-gl-js/pull/9748))

### 🐞 Bug fixes

- Fix a bug where map got stuck in a DragRotate interaction if it's mouseup occurred outside of the browser window or iframe.([#9512](https://github.com/mapbox/mapbox-gl-js/pull/9512))
- Fix potential visual regression for `*-pattern` properties on AMD graphics card vendor.([#9681](https://github.com/mapbox/mapbox-gl-js/pull/9681))
- Fix zooming with a double tap on iOS Safari 13.([#9757](https://github.com/mapbox/mapbox-gl-js/pull/9757))
- Removed a misleading `geometry exceeds allowed extent` warning when using Mapbox Streets vector tiles.([#9753](https://github.com/mapbox/mapbox-gl-js/pull/9753))
- Fix reference error when requiring the browser bundle in Node. ([#9749](https://github.com/mapbox/mapbox-gl-js/pull/9749))

## 1.10.2

### 🐞 Bug fixes

- Fix zooming with a double tap in iOS Safari 13.([#9757](https://github.com/mapbox/mapbox-gl-js/pull/9757))

## 1.10.1

### 🐞 Bug fixes

- Fix markers interrupting touch gestures ([#9675](https://github.com/mapbox/mapbox-gl-js/issues/9675), fixed by [#9683](https://github.com/mapbox/mapbox-gl-js/pull/9683))
- Fix bug where `map.isMoving()` returned true while map was not moving ([#9647](https://github.com/mapbox/mapbox-gl-js/issues/9647), fixed by [#9679](https://github.com/mapbox/mapbox-gl-js/pull/9679))
- Fix regression that prevented `touchmove` events from firing during gestures ([#9676](https://github.com/mapbox/mapbox-gl-js/issues/9676), fixed by [#9685](https://github.com/mapbox/mapbox-gl-js/pull/9685))
- Fix `image` expression evaluation which was broken under certain conditions ([#9630](https://github.com/mapbox/mapbox-gl-js/issues/9630), fixed by [#9685](https://github.com/mapbox/mapbox-gl-js/pull/9668))
- Fix nested `within` expressions in filters not evaluating correctly ([#9605](https://github.com/mapbox/mapbox-gl-js/issues/9605), fixed by [#9611](https://github.com/mapbox/mapbox-gl-js/pull/9611))
- Fix potential `undefined` paint variable in `StyleLayer` ([#9688](https://github.com/mapbox/mapbox-gl-js/pull/9688)) (by [mannnick24](https://github.com/mannnick24))

## 1.10.0

### ✨ Features

- Add `mapboxgl.prewarm()` and `mapboxgl.clearPrewarmedResources()` methods to allow developers to optimize load times for their maps ([#9391](https://github.com/mapbox/mapbox-gl-js/pull/9391))
- Add `index-of` and `slice` expressions to search arrays and strings for the first occurrence of a specified value and return a section of the original array or string ([#9450](https://github.com/mapbox/mapbox-gl-js/pull/9450)) (by [lbutler](https://github.com/lbutler))
- Correctly set RTL text plugin status if the plugin URL could not be loaded. This allows developers to add retry logic on network errors when loading the plugin ([#9489](https://github.com/mapbox/mapbox-gl-js/pull/9489))

### 🍏 Gestures

This release significantly refactors and improves gesture handling on desktop and mobile. Three new touch gestures have been added: `two-finger swipe` to adjust pitch, `two-finger double tap` to zoom out, and `tap then drag` to adjust zoom with one finger ([#9365](https://github.com/mapbox/mapbox-gl-js/pull/9365)). In addition, this release brings the following changes and bug fixes:

- It's now possible to interact with multiple maps on the same page at the same time ([#9365](https://github.com/mapbox/mapbox-gl-js/pull/9365))
- Fix map jump when releasing one finger after pinch zoom ([#9136](https://github.com/mapbox/mapbox-gl-js/issues/9136))
- Stop mousedown and touchstart from interrupting `easeTo` animations when interaction handlers are disabled ([#8725](https://github.com/mapbox/mapbox-gl-js/issues/8725))
- Stop mouse wheel from interrupting animations when `map.scrollZoom` is disabled ([#9230](https://github.com/mapbox/mapbox-gl-js/issues/9230))
- A camera change can no longer be prevented by disabling the interaction handler within the camera change event. Selectively prevent camera changes by listening to the `mousedown` or `touchstart` map event and calling [.preventDefault()](https://docs.mapbox.com/mapbox-gl-js/api/#mapmouseevent#preventdefault) ([#9365](https://github.com/mapbox/mapbox-gl-js/pull/9365))
- Undocumented properties on the camera change events fired by the doubleClickZoom handler have been removed ([#9365](https://github.com/mapbox/mapbox-gl-js/pull/9365))

### 🐞 Improvements and bug fixes

- Line labels now have improved collision detection, with greater precision in placement, reduced memory footprint, better placement under pitched camera orientations ([#9219](https://github.com/mapbox/mapbox-gl-js/pull/9219))
- Fix `GlyphManager` continually re-requesting missing glyph ranges ([#8027](https://github.com/mapbox/mapbox-gl-js/issues/8027), fixed by [#9375](https://github.com/mapbox/mapbox-gl-js/pull/9375)) (by [oterral](https://github.com/oterral))
- Avoid throwing errors when calling certain popup methods before the popup element is created ([#9433](https://github.com/mapbox/mapbox-gl-js/pull/9433))
- Fix a bug where fill-extrusion features with colinear points were not returned by `map.queryRenderedFeatures(...)` ([#9454](https://github.com/mapbox/mapbox-gl-js/pull/9454))
- Fix a bug where using feature state on a large input could cause a stack overflow error ([#9463](https://github.com/mapbox/mapbox-gl-js/pull/9463))
- Fix exception when using `background-pattern` with data driven expressions ([#9518](https://github.com/mapbox/mapbox-gl-js/issues/9518), fixed by [#9520](https://github.com/mapbox/mapbox-gl-js/pull/9520))
- Fix a bug where UI popups were potentially leaking event listeners ([#9498](https://github.com/mapbox/mapbox-gl-js/pull/9498)) (by [mbell697](https://github.com/mbell697))
- Fix a bug where the `within` expression would return inconsistent values for points on tile boundaries ([#9411](https://github.com/mapbox/mapbox-gl-js/issues/9411), [#9428](https://github.com/mapbox/mapbox-gl-js/pull/9428))
- Fix a bug where the `within` expression would incorrectly evaluate geometries that cross the antimeridian ([#9440](https://github.com/mapbox/mapbox-gl-js/pull/9440))
- Fix possible undefined exception on paint variable of style layer ([#9437](https://github.com/mapbox/mapbox-gl-js/pull/9437)) (by [mannnick24](https://github.com/mannnick24))
- Upgrade minimist to ^1.2.5 to get fix for security issue [CVE-2020-7598](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2020-7598) upstream ([#9425](https://github.com/mapbox/mapbox-gl-js/issues/9431), fixed by [#9425](https://github.com/mapbox/mapbox-gl-js/pull/9425)) (by [watson](https://github.com/watson))

## 1.9.1

### 🐞 Bug fixes

- Fix a bug [#9477](https://github.com/mapbox/mapbox-gl-js/issues/9477) in `Map#fitBounds(..)` wherein the `padding` passed to options would get applied twice.
- Fix rendering bug [#9479](https://github.com/mapbox/mapbox-gl-js/issues/9479) caused when data-driven `*-pattern` properties reference images added with `Map#addImage(..)`.
- Fix a bug [#9468](https://github.com/mapbox/mapbox-gl-js/issues/9468) in which an exception would get thrown when updating symbol layer paint property using `setPaintProperty`.

## 1.9.0

With this release, we're adding [a new changelog policy](./CONTRIBUTING.md#changelog-conventions) to our contribution guidelines.

This release also fixes several long-standing bugs and unintentional rendering behavior with `line-pattern`. The fixes come with a visual change to how patterns added with `line-pattern` scale. Previously, patterns that became larger than the line would be clipped, sometimes distorting the pattern, particularly on mobile and retina devices. Now the pattern will be scaled to fit under all circumstances. [#9266](https://github.com/mapbox/mapbox-gl-js/pull/9266) showcases examples of the visual differences. For more information and to provide feedback on this change, see [#9394](https://github.com/mapbox/mapbox-gl-js/pull/9394).

### ✨ Features

- Add `within` expression for testing whether an evaluated feature lies within a given GeoJSON object ([#9352](https://github.com/mapbox/mapbox-gl-js/pull/9352)). - We are aware of an edge case in which points with wrapped coordinates (e.g. longitude -185) are not evaluated properly. See ([#9442](https://github.com/mapbox/mapbox-gl-js/issues/9442)) for more information. - An example of the `within` expression:<br> `"icon-opacity": ["case", ["==", ["within", "some-polygon"], true], 1,
["==", ["within", "some-polygon"], false], 0]`
- Map API functions such as `easeTo` and `flyTo` now support `padding: PaddingOptions` which lets developers shift a map's center of perspective when building floating sidebars ([#8638](https://github.com/mapbox/mapbox-gl-js/pull/8638))

### 🍏 Improvements

- Results from `queryRenderedFeatures` now have evaluated property values rather than raw expressions ([#9198](https://github.com/mapbox/mapbox-gl-js/pull/9198))
- Improve scaling of patterns used in `line-pattern` on all device resolutions and pixel ratios ([#9266](https://github.com/mapbox/mapbox-gl-js/pull/9266))
- Slightly improve GPU memory footprint ([#9377](https://github.com/mapbox/mapbox-gl-js/pull/9377))
- `LngLatBounds.extend` is more flexible because it now accepts objects with `lat` and `lon` properties as well as arrays of coordinates ([#9293](https://github.com/mapbox/mapbox-gl-js/pull/9293))
- Reduce bundle size and improve visual quality of `showTileBoundaries` debug text ([#9267](https://github.com/mapbox/mapbox-gl-js/pull/9267))

### 🐞 Bug fixes

- Correctly adjust patterns added with `addImage(id, image, pixelRatio)` by the asset pixel ratio, not the device pixel ratio ([#9372](https://github.com/mapbox/mapbox-gl-js/pull/9372))
- Allow needle argument to `in` expression to be false ([#9295](https://github.com/mapbox/mapbox-gl-js/pull/9295))
- Fix exception thrown when trying to set `feature-state` for a layer that has been removed, fixes [#8634](https://github.com/mapbox/mapbox-gl-js/issues/8634) ([#9305](https://github.com/mapbox/mapbox-gl-js/pull/9305))
- Fix a bug where maps were not displaying inside elements with `dir=rtl` ([#9332](https://github.com/mapbox/mapbox-gl-js/pull/9332))
- Fix a rendering error for very old versions of Chrome (ca. 2016) where text would appear much bigger than intended ([#9349](https://github.com/mapbox/mapbox-gl-js/pull/9349))
- Prevent exception resulting from `line-dash-array` of empty length ([#9385](https://github.com/mapbox/mapbox-gl-js/pull/9385))
- Fix a bug where `icon-image` expression that evaluates to an empty string (`''`) produced a warning ([#9380](https://github.com/mapbox/mapbox-gl-js/pull/9380))
- Fix a bug where certain `popup` methods threw errors when accessing the container element before it was created, fixes [#9429](https://github.com/mapbox/mapbox-gl-js/issues/9429)([#9433](https://github.com/mapbox/mapbox-gl-js/pull/9433))

## 1.8.1

- Fixed a bug where all labels showed up on a diagonal line on Windows when using an integrated Intel GPU from the Haswell generation ([#9327](https://github.com/mapbox/mapbox-gl-js/issues/9327), fixed by reverting [#9229](https://github.com/mapbox/mapbox-gl-js/pull/9229))

## 1.8.0

### ✨ 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)) (by [gely](https://api.github.com/users/gely)) and ([#9284](https://github.com/mapbox/mapbox-gl-js/pull/9284)) (by [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)) (by [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)) (by [Meekohi](https://api.github.com/users/Meekohi))

## 1.7.0

### ✨ 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) (by [@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)) (by [Yanonix](https://github.com/Yanonix))

## 1.6.1

### 🐞 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))

## 1.6.0

### ✨ 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 non-stretched 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)) (by [@dburnsii](https://github.com/dburnsii))
- Add methods to Popup to manipulate container class names ([#8759](https://github.com/mapbox/mapbox-gl-js/pull/8759)) (by [Ashot-KR](https://github.com/Ashot-KR))
- Add configurable inertia settings for panning (by [@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)) (by [@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)) (by [@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)) (by [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)) (by [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))

## 1.5.1

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)) (by [msbarry](https://github.com/msbarry))

## 1.5.0

### ✨ 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)) (by [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)) (by [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))

## 1.4.1

### 🐞 Bug Fixes

- Fix the way that `coalesce` handles the `image` operator so available images are rendered properly ([#8839](https://github.com/mapbox/mapbox-gl-js/pull/8839))
- Do not emit the `styleimagemissing` event for an empty string value ([#8840](https://github.com/mapbox/mapbox-gl-js/pull/8840))
- Fix serialization of `ResolvedImage` type so `*-pattern` properties work properly ([#8833](https://github.com/mapbox/mapbox-gl-js/pull/8833))

## 1.4.0

### ✨ Features

- Add `image` expression operator to determine image availability ([#8684](https://github.com/mapbox/mapbox-gl-js/pull/8684))
- Enable `text-offset` with variable label placement ([#8642](https://github.com/mapbox/mapbox-gl-js/pull/8642))

### 🍏 Improvements

- Faster loading and better look of raster terrain ([#8694](https://github.com/mapbox/mapbox-gl-js/pull/8694))
- Improved code documentation around resizing and {get/set}RenderedWorldCopies and more ([#8748](https://github.com/mapbox/mapbox-gl-js/pull/8748), [#8754](https://github.com/mapbox/mapbox-gl-js/pull/8754))
- Improve single vs. multi-touch zoom & pan interaction ([#7196](https://github.com/mapbox/mapbox-gl-js/issues/7196)) ([#8100](https://github.com/mapbox/mapbox-gl-js/pull/8100))

### 🐞 Bug fixes

- Fix rendering of `collisionBox` when `text-translate` or `icon-translate` is enabled ([#8659](https://github.com/mapbox/mapbox-gl-js/pull/8659))
- Fix `TypeError` when reloading a source and immediately removing the map ([#8711](https://github.com/mapbox/mapbox-gl-js/pull/8711))
- Adding tooltip to the geolocation control button ([#8735](https://github.com/mapbox/mapbox-gl-js/pull/8735)) (by [BAByrne](https://github.com/BAByrne))
- Add `originalEvent` property to NavigationControl events ([#8693](https://github.com/mapbox/mapbox-gl-js/pull/8693)) (by [stepankuzmin](https://github.com/stepankuzmin))
- Don't cancel follow mode in the GeolocateControl when resizing the map or rotating the screen ([#8736](https://github.com/mapbox/mapbox-gl-js/pull/8736))
- Fix error when calling `Popup#trackPointer` before setting its content or location ([#8757](https://github.com/mapbox/mapbox-gl-js/pull/8757)) (by [zxwandrew](https://github.com/zxwandrew))
- Respect newline characters when text-max-width is set to zero ([#8706](https://github.com/mapbox/mapbox-gl-js/pull/8706))
- Update earcut to v2.2.0 to fix polygon tessellation errors ([#8772](https://github.com/mapbox/mapbox-gl-js/pull/8772))
- Fix icon-fit with variable label placement ([#8755](https://github.com/mapbox/mapbox-gl-js/pull/8755))
- Icons stretched with `icon-text-fit` are now sized correctly ([#8741](https://github.com/mapbox/mapbox-gl-js/pull/8741))
- Collision detection for icons with `icon-text-fit` now works correctly ([#8741](https://github.com/mapbox/mapbox-gl-js/pull/8741))

## 1.3.2

- Fix a SecurityError in Firefox >= 69 when accessing the cache [#8780](https://github.com/mapbox/mapbox-gl-js/pull/8780)

## 1.3.1

### 🐞 Bug Fixes

- Fix a race condition that produced an error when a map was removed while reloading a source. [#8711](https://github.com/mapbox/mapbox-gl-js/pull/8711)
- Fix a race condition were `render` event was sometimes not fired after `load` event in IE11. [#8708](https://github.com/mapbox/mapbox-gl-js/pull/8708)

## 1.3.0

### 🍏 Features

- Introduce `text-writing-mode` symbol layer property to allow placing point labels vertically. [#8399](https://github.com/mapbox/mapbox-gl-js/pull/8399)
- Extend variable text placement to work when `text/icon-allow-overlap` is set to `true`. [#8620](https://github.com/mapbox/mapbox-gl-js/pull/8620)
- Allow `text-color` to be used in formatted expressions to be able to draw different parts of a label in different colors. [#8068](https://github.com/mapbox/mapbox-gl-js/pull/8068)

### ✨ Improvements

- Improve tile loading logic to cancel requests more aggressively, improving performance when zooming or panning quickly. [#8633](https://github.com/mapbox/mapbox-gl-js/pull/8633)
- Display outline on control buttons when focused (e.g. with a tab key) for better accessibility. [#8520](https://github.com/mapbox/mapbox-gl-js/pull/8520)
- Improve the shape of line round joins. [#8275](https://github.com/mapbox/mapbox-gl-js/pull/8275)
- Improve performance of processing line layers. [#8303](https://github.com/mapbox/mapbox-gl-js/pull/8303)
- Improve legibility of info displayed with `map.showTileBoundaries = true`. [#8380](https://github.com/mapbox/mapbox-gl-js/pull/8380) (by [@andrewharvey](https://github.com/andrewharvey))
- Add `MercatorCoordinate.meterInMercatorCoordinateUnits` method to make it easier to convert from meter units to coordinate values used in custom layers. [#8524](https://github.com/mapbox/mapbox-gl-js/pull/8524) (by [@andrewharvey](https://github.com/andrewharvey))
- Improve conversion of legacy filters with duplicate values. [#8542](https://github.com/mapbox/mapbox-gl-js/pull/8542)
- Move out documentation & examples website source to a separate `mapbox-gl-js-docs` repo. [#8582](https://github.com/mapbox/mapbox-gl-js/pull/8582)

### 🐞 Bug Fixes

- Fix a bug where local CJK fonts would switch to server-generated ones in overzoomed tiles. [#8657](https://github.com/mapbox/mapbox-gl-js/pull/8657)
- Fix precision issues in [deck.gl](https://deck.gl)-powered custom layers. [#8502](https://github.com/mapbox/mapbox-gl-js/pull/8502)
- Fix a bug where fill and line layers wouldn't render correctly over fill extrusions when coming from the same source. [#8661](https://github.com/mapbox/mapbox-gl-js/pull/8661)
- Fix map loading for documents loaded from Blob URLs. [#8612](https://github.com/mapbox/mapbox-gl-js/pull/8612)
- Fix classification of relative file:// URLs when in documents loaded from a file URL. [#8612](https://github.com/mapbox/mapbox-gl-js/pull/8612)
- Remove `esm` from package `dependencies` (so that it's not installed on `npm install mapbox-gl`). [#8586](https://github.com/mapbox/mapbox-gl-js/pull/8586) (by [@DatGreekChick](https://github.com/DatGreekChick))

## 1.2.1

### 🐞 Bug fixes

- Fix bug in `NavigationControl` compass button that prevented it from rotating with the map ([#8605](https://github.com/mapbox/mapbox-gl-js/pull/8605))

## 1.2.0

### Features and improvements

- Add `*-sort-key` layout property for circle, fill, and line layers, to dictate which features appear above others within a single layer([#8467](https://github.com/mapbox/mapbox-gl-js/pull/8467))
- Add ability to instantiate maps with specific access tokens ([#8364](https://github.com/mapbox/mapbox-gl-js/pull/8364))
- Accommodate `prefers-reduced-motion` settings in browser ([#8494](https://github.com/mapbox/mapbox-gl-js/pull/8494))
- Add Map `visualizePitch` option that tilts the compass as the map pitches ([#8208](https://github.com/mapbox/mapbox-gl-js/issues/8208), fixed by [#8296](https://github.com/mapbox/mapbox-gl-js/pull/8296)) (by [pakastin](https://github.com/pakastin))
- Make source options take precedence over TileJSON ([#8232](https://github.com/mapbox/mapbox-gl-js/pull/8232)) (by [jingsam](https://github.com/jingsam))
- Make requirements for text offset properties more precise ([#8418](https://github.com/mapbox/mapbox-gl-js/pull/8418))
- Expose `convertFilter` API in the style specification ([#8493](https://github.com/mapbox/mapbox-gl-js/pull/8493)

### Bug fixes

- Fix changes to `text-variable-anchor`, such that previous anchor positions would take precedence only if they are present in the updated array (considered a bug fix, but is technically a breaking change from previous behavior) ([#8473](https://github.com/mapbox/mapbox-gl-js/pull/8473))
- Fix rendering of opaque pass layers over heatmap and fill-extrusion layers ([#8440](https://github.com/mapbox/mapbox-gl-js/pull/8440))
- Fix rendering of extraneous vertical line in vector tiles ([#8477](https://github.com/mapbox/mapbox-gl-js/issues/8477), fixed by [#8479](https://github.com/mapbox/mapbox-gl-js/pull/8479))
- Turn off 'move' event listeners when removing a marker ([#8465](https://github.com/mapbox/mapbox-gl-js/pull/8465))
- Fix class toggling on navigation control for IE ([#8495](https://github.com/mapbox/mapbox-gl-js/pull/8495)) (by [@cs09g](https://github.com/cs09g))
- Fix background rotation hovering on geolocate control ([#8367](https://github.com/mapbox/mapbox-gl-js/pull/8367)) (by [GuillaumeGomez](https://github.com/GuillaumeGomez))
- Fix error in click events on markers where `startPos` is not defined ([#8462](https://github.com/mapbox/mapbox-gl-js/pull/8462)) (by [@msbarry](https://github.com/msbarry))
- Fix malformed urls when using custom `baseAPIURL` of a certain form ([#8466](https://github.com/mapbox/mapbox-gl-js/pull/8466))

## 1.1.1

### 🐞 Bug fixes

- Fix unbounded memory growth caused by failure to cancel requests to the cache ([#8472](https://github.com/mapbox/mapbox-gl-js/pull/8472))
- Fix unbounded memory growth caused by failure to cancel requests in IE ([#8481](https://github.com/mapbox/mapbox-gl-js/issues/8481))
- Fix performance of getting tiles from the cache ([#8489](https://github.com/mapbox/mapbox-gl-js/pull/8449))

## 1.1.0

### ✨ Minor features and improvements

- Improve line rendering performance by using a more compact line attributes layout ([#8306](https://github.com/mapbox/mapbox-gl-js/pull/8306))
- Improve data-driven symbol layers rendering performance ([#8295](https://github.com/mapbox/mapbox-gl-js/pull/8295))
- Add the ability to disable validation during `queryRenderedFeatures` and `querySourceFeatures` calls, as a performance optimization ([#8211](https://github.com/mapbox/mapbox-gl-js/pull/8211)) (by [gorshkov-leonid](https://github.com/gorshkov-leonid))
- Improve `setFilter` performance by caching keys in `groupByLayout` routine ([#8122](https://github.com/mapbox/mapbox-gl-js/pull/8122)) (by [vallendm](https://github.com/vallendm))
- Improve rendering of symbol layers with `symbol-z-order: viewport-y`, when icons are allowed to overlap but not text ([#8180](https://github.com/mapbox/mapbox-gl-js/pull/8180))
- Prefer breaking lines at a zero width space to allow better break point suggestions for Japanese labels ([#8255](https://github.com/mapbox/mapbox-gl-js/pull/8255))
- Add a `WebGLRenderingContext` argument to `onRemove` function of `CustomLayerInterface`, to allow direct cleanup of related context ([#8156](https://github.com/mapbox/mapbox-gl-js/pull/8156)) (by [ogiermaitre](https://github.com/ogiermaitre))
- Allow zoom speed customization by adding `setZoomRate` and `setWheelZoomRate` methods to `ScrollZoomHandler` ([#7863](https://github.com/mapbox/mapbox-gl-js/pull/7863)) (by [sf31](https://github.com/sf31))
- Add `trackPointer` method to `Popup` API that continuously repositions the popup to the mouse cursor when the cursor is within the map ([#7786](https://github.com/mapbox/mapbox-gl-js/pull/7786))
- Add `getElement` method to `Popup` to retrieve the popup's HTML element ([#8123](https://github.com/mapbox/mapbox-gl-js/pull/8123)) (by [@bravecow](https://github.com/bravecow))
- Add `fill-pattern` example to the documentation ([#8022](https://github.com/mapbox/mapbox-gl-js/pull/8022)) (by [@flawyte](https://github.com/flawyte))
- Update script detection for Unicode 12.1 ([#8158](https://github.com/mapbox/mapbox-gl-js/pull/8158))
- Add `nofollow` to Mapbox logo & "Improve this map" links ([#8106](https://github.com/mapbox/mapbox-gl-js/pull/8106)) (by [viniciuskneves](https://github.com/viniciuskneves))
- Include source name in invalid GeoJSON error ([#8113](https://github.com/mapbox/mapbox-gl-js/pull/8113)) (by [Zirak](https://github.com/Zirak))

### 🐞 Bug fixes

- Fix `updateImage` not working as expected in Chrome ([#8199](https://github.com/mapbox/mapbox-gl-js/pull/8199))
- Fix issues with double-tap zoom on touch devices ([#8086](https://github.com/mapbox/mapbox-gl-js/pull/8086))
- Fix duplication of `movestart` events when zooming ([#8259](https://github.com/mapbox/mapbox-gl-js/pull/8259)) (by [@bambielli-flex](https://github.com/bambielli-flex))
- Fix validation of `"format"` expression failing when options are provided ([#8339](https://github.com/mapbox/mapbox-gl-js/pull/8339))
- Fix `setPaintProperty` not working on `line-pattern` property ([#8289](https://github.com/mapbox/mapbox-gl-js/pull/8289))
- Fix the GL context being left in unpredictable states when using custom layers ([#8132](https://github.com/mapbox/mapbox-gl-js/pull/8132))
- Fix unnecessary updates to attribution control string ([#8082](https://github.com/mapbox/mapbox-gl-js/pull/8082)) (by [poletani](https://github.com/poletani))
- Fix bugs in `findStopLessThanOrEqualTo` algorithm ([#8134](https://github.com/mapbox/mapbox-gl-js/pull/8134)) (by [Mike96Angelo](https://github.com/Mike96Angelo))
- Fix map not displaying properly when inside an element with `text-align: center` ([#8227](https://github.com/mapbox/mapbox-gl-js/pull/8227)) (by [mc100s](https://github.com/mc100s))
- Clarify in documentation that `Popup#maxWidth` accepts all `max-width` CSS values ([#8312](https://github.com/mapbox/mapbox-gl-js/pull/8312)) (by [viniciuskneves](https://github.com/viniciuskneves))
- Fix location dot shadow not displaying ([#8119](https://github.com/mapbox/mapbox-gl-js/pull/8119)) (by [@bravecow](https://github.com/bravecow))
- Fix docs dev dependencies being mistakenly installed as package dependencies ([#8121](https://github.com/mapbox/mapbox-gl-js/pull/8121)) (by [@bravecow](https://github.com/bravecow))
- Various typo fixes ([#8230](https://github.com/mapbox/mapbox-gl-js/pull/8230), h/t [@erictheise](https://github.com/erictheise)) ([#8236](https://github.com/mapbox/mapbox-gl-js/pull/8236), h/t [@fredj](https://github.com/fredj))
- Fix geolocate button CSS ([#8367](https://github.com/mapbox/mapbox-gl-js/pull/8367), h/t [GuillaumeGomez](https://github.com/GuillaumeGomez))
- Fix caching for Mapbox tiles ([#8389](https://github.com/mapbox/mapbox-gl-js/pull/8389))

## 1.0.0

### ⚠️ Breaking changes

This release replaces the existing “map views” pricing model in favor of a “map load” model. Learn more in [a recent blog post about these changes](https://blog.mapbox.com/new-pricing-46b7c26166e7).

**By upgrading to this release, you are opting in to the new map loads pricing.**

**Why is this change being made?**

This change allows us to implement a more standardized and predictable method of billing GL JS map usage. You’ll be charged whenever your website or web application loads, not by when users pan and zoom around the map, incentivizing developers to create highly interactive map experiences. The new pricing structure also creates a significantly larger free tier to help developers get started building their applications with Mapbox tools while pay-as-you-go pricing and automatic volume discounts help your application scale with Mapbox. Session billing also aligns invoices with metrics web developers already track and makes it easier to compare usage with other mapping providers.

**What is changing?**

- Add SKU token to Mapbox API requests [#8276](https://github.com/mapbox/mapbox-gl-js/pull/8276)

When (and only when) loading tiles from a Mapbox API with a Mapbox access token set (`mapboxgl.accessToken`), a query parameter named `sku` will be added to all requests for vector, raster and raster-dem tiles. Every map instance uses a unique `sku` value, which is refreshed every 12 hours. The token itself is comprised of a token version (always “1”), a sku ID (always “01”) and a random 10-digit base-62 number. The purpose of the token is to allow for metering of map sessions on the server-side. A session lasts from a new map instantiation until the map is destroyed or 12 hours passes, whichever comes first.

For further information on the pricing changes, you can read our [blog post](https://blog.mapbox.com/new-pricing-46b7c26166e7) and check out our new [pricing page](https://www.mapbox.com/pricing), which has a price calculator. As always, you can also contact our team at [https://support.mapbox.com](https://support.mapbox.com).

## 0.54.1

### Bug fixes

- Fix unbounded memory growth caused by failure to cancel requests in IE ([#8481](https://github.com/mapbox/mapbox-gl-js/issues/8481))

## 0.54.0

### Breaking changes

- Turned `localIdeographFontFamily` map option on by default. This may change how CJK labels are rendered, but dramatically improves performance of CJK maps (because the browser no longer needs to download heavy amounts of font data from the server). Add `localIdeographFontFamily: false` to turn this off. [#8008](https://github.com/mapbox/mapbox-gl-js/pull/8008)
- Added `Popup` `maxWidth` option, set to `"240px"` by default. [#7906](https://github.com/mapbox/mapbox-gl-js/pull/7906)

### Major features

- Added support for updating and animating style images. [#7999](https://github.com/mapbox/mapbox-gl-js/pull/7999)
- Added support for generating style images dynamically (e.g. for drawing icons based on feature properties). [#7987](https://github.com/mapbox/mapbox-gl-js/pull/7987)
- Added antialiasing support for custom layers. [#7821](https://github.com/mapbox/mapbox-gl-js/pull/7821)
- Added a new `mapbox-gl-csp.js` bundle for strict CSP environments where `worker-src: blob` is disallowed. [#8044](https://github.com/mapbox/mapbox-gl-js/pull/8044)

### Minor features and improvements

- Improved performance of fill extrusions. [#7821](https://github.com/mapbox/mapbox-gl-js/pull/7821)
- Improved performance of symbol layers. [#7967](https://github.com/mapbox/mapbox-gl-js/pull/7967)
- Slightly improved rendering performance in general. [#7969](https://github.com/mapbox/mapbox-gl-js/pull/7969)
- Slightly improved performance of HTML markers. [#8018](https://github.com/mapbox/mapbox-gl-js/pull/8018)
- Improved diffing of styles with `"visibility": "visible"`. [#8005](https://github.com/mapbox/mapbox-gl-js/pull/8005)
- Improved zoom buttons to grey out when reaching min/max zoom. [#8023](https://github.com/mapbox/mapbox-gl-js/pull/8023)
- Added a title to fullscreen control button. [#8012](https://github.com/mapbox/mapbox-gl-js/pull/8012)
- Added `rel="noopener"` attributes to links that lead to external websites (such as Mapbox logo and OpenStreetMap edit link) for improved security. [#7914](https://github.com/mapbox/mapbox-gl-js/pull/7914)
- Added tile size info when `map.showTileBoundaries` is turned on. [#7963](https://github.com/mapbox/mapbox-gl-js/pull/7963)
- Significantly improved load times of the benchmark suite. [#8066](https://github.com/mapbox/mapbox-gl-js/pull/8066)
- Improved behavior of `canvasSource.pause` to be more reliable and able to render a single frame. [#8130](https://github.com/mapbox/mapbox-gl-js/pull/8130)

### Bug fixes

- Fixed a bug in Mac Safari 12+ where controls would disappear until you interact with the map. [#8193](https://github.com/mapbox/mapbox-gl-js/pull/8193)
- Fixed a memory leak when calling `source.setData(url)` many times. [#8035](https://github.com/mapbox/mapbox-gl-js/pull/8035)
- Fixed a bug where marker lost focus when dragging. [#7799](https://github.com/mapbox/mapbox-gl-js/pull/7799)
- Fixed a bug where `map.getCenter()` returned a reference to an internal `LngLat` object instead of cloning it, leading to potential mutability bugs. [#7922](https://github.com/mapbox/mapbox-gl-js/pull/7922)
- Fixed a bug where default HTML marker positioning was slightly off. [#8074](https://github.com/mapbox/mapbox-gl-js/pull/8074)
- Fixed a bug where adding a fill extrusion layer for non-polygon layers would lead to visual artifacts. [#7685](https://github.com/mapbox/mapbox-gl-js/pull/7685)
- Fixed intermittent Flow failures on CI. [#8061](https://github.com/mapbox/mapbox-gl-js/pull/8061)
- Fixed a bug where calling `Map#removeFeatureState` does not remove the state from some tile zooms [#8087](https://github.com/mapbox/mapbox-gl-js/pull/8087)
- Fixed a bug where `removeFeatureState` didn't work on features with `id` equal to `0`. [#8150](https://github.com/mapbox/mapbox-gl-js/pull/8150) (by [jutaz](https://github.com/jutaz))

## 0.53.1

### Bug fixes

- Turn off telemetry for Mapbox Atlas ([#7945](https://github.com/mapbox/mapbox-gl-js/pull/7945))
- Fix order of 3D features in query results (fix [#7883](https://github.com/mapbox/mapbox-gl-js/issues/7883)) ([#7953](https://github.com/mapbox/mapbox-gl-js/pull/7953))
- Fix RemovePaintState benchmarks ([#7930](https://github.com/mapbox/mapbox-gl-js/pull/7930))

## 0.53.0

### Features and improvements

- Enable `fill-extrusion` querying with ray picking ([#7499](https://github.com/mapbox/mapbox-gl-js/pull/7499))
- Add `clusterProperties` option for aggregated cluster properties ([#2412](https://github.com/mapbox/mapbox-gl-js/issues/2412), fixed by [#7584](https://github.com/mapbox/mapbox-gl-js/pull/7584))
- Allow initial map bounds to be adjusted with `fitBounds` options. ([#7681](https://github.com/mapbox/mapbox-gl-js/pull/7681)) (by [@elyobo](https://github.com/elyobo))
- Remove popups on `Map#remove` ([#7749](https://github.com/mapbox/mapbox-gl-js/pull/7749)) (by [@andycalder](https://github.com/andycalder))
- Add `Map#removeFeatureState` ([#7761](https://github.com/mapbox/mapbox-gl-js/pull/7761))
- Add `number-format` expression ([#7626](https://github.com/mapbox/mapbox-gl-js/pull/7626))
- Add `symbol-sort-key` style property ([#7678](https://github.com/mapbox/mapbox-gl-js/pull/7678))

### Bug fixes

- Upgrades Earcut to fix a rare bug in rendering polygons that contain a coincident chain of holes ([#7806](https://github.com/mapbox/mapbox-gl-js/issues/7806), fixed by [#7878](https://github.com/mapbox/mapbox-gl-js/pull/7878))
- Allow `file://` protocol in XHR requests for Cordova/Ionic/etc ([#7818](https://github.com/mapbox/mapbox-gl-js/pull/7818))
- Correctly handle WebP images in Edge 18 ([#7687](https://github.com/mapbox/mapbox-gl-js/pull/7687))
- Fix bug which mistakenly requested WebP images in browsers that do not support WebP ([#7817](https://github.com/mapbox/mapbox-gl-js/pull/7817)) ([#7819](https://github.com/mapbox/mapbox-gl-js/pull/7819))
- Fix images not being aborted when dequeued ([#7655](https://github.com/mapbox/mapbox-gl-js/pull/7655))
- Fix DEM layer memory leak ([#7690](https://github.com/mapbox/mapbox-gl-js/issues/7690), fixed by [#7691](https://github.com/mapbox/mapbox-gl-js/pull/7691))
- Set correct color state before rendering custom layer ([#7711](https://github.com/mapbox/mapbox-gl-js/pull/7711))
- Set `LngLat.toBounds()` default radius to 0 ([#7722](https://github.com/mapbox/mapbox-gl-js/issues/7722), fixed by [#7723](https://github.com/mapbox/mapbox-gl-js/pull/7723)) (by [@cherniavskii](https://github.com/cherniavskii))
- Fix race condition in `feature-state` dependent layers ([#7523](https://github.com/mapbox/mapbox-gl-js/issues/7523), fixed by [#7790](https://github.com/mapbox/mapbox-gl-js/pull/7790))
- Prevent `map.repaint` from mistakenly enabling continuous repaints ([#7667](https://github.com/mapbox/mapbox-gl-js/pull/7667))
- Prevent map shaking while zooming in on raster tiles ([#7426](https://github.com/mapbox/mapbox-gl-js/pull/7426))
- Fix query point translation for multi-point geometry ([#6833](https://github.com/mapbox/mapbox-gl-js/issues/6833), fixed by [#7581](https://github.com/mapbox/mapbox-gl-js/pull/7581))

## 0.52.0

### Breaking changes

- Canonicalize tile urls to `mapbox://` urls so they can be transformed with `config.API_URL` ([#7594](https://github.com/mapbox/mapbox-gl-js/pull/7594))

### Features and improvements

- Add getter and setter for `config.API_URL` ([#7594](https://github.com/mapbox/mapbox-gl-js/pull/7594))
- Allow user to define element other than map container for full screen control ([#7548](https://github.com/mapbox/mapbox-gl-js/pull/7548))
- Add validation option to style setters ([#7604](https://github.com/mapbox/mapbox-gl-js/pull/7604))
- Add 'idle' event: fires when no further rendering is expected without further interaction. ([#7625](https://github.com/mapbox/mapbox-gl-js/pull/7625))

### Bug fixes

- Fire error when map.getLayoutProperty references missing layer ([#7537](https://github.com/mapbox/mapbox-gl-js/issues/7537), fixed by [#7539](https://github.com/mapbox/mapbox-gl-js/pull/7539))
- Fix shaky sprites when zooming with scrolling ([#7558](https://github.com/mapbox/mapbox-gl-js/pull/7558))
- Fix layout problems in attribution control ([#7608](https://github.com/mapbox/mapbox-gl-js/pull/7608)) (by [lucaswoj](https://github.com/lucaswoj))
- Fixes resetting map's pitch to 0 if initial bounds is set ([#7617](https://github.com/mapbox/mapbox-gl-js/pull/7617)) (by [stepankuzmin](https://github.com/stepankuzmin))
- Fix occasional failure to load images after multiple image request abortions [#7641](https://github.com/mapbox/mapbox-gl-js/pull/7641)
- Update repo url to correct one ([#7486](https://github.com/mapbox/mapbox-gl-js/pull/7486)) (by [nicholas-l](https://github.com/nicholas-l))
- Fix bug where symbols where sometimes not rendered immediately ([#7610](https://github.com/mapbox/mapbox-gl-js/pull/7610))
- Fix bug where cameraForBounds returns incorrect CameraOptions with asymmetrical padding/offset ([#7517](https://github.com/mapbox/mapbox-gl-js/issues/7517), fixed by [#7518](https://github.com/mapbox/mapbox-gl-js/pull/7518)) (by [mike-marcacci](https://github.com/mike-marcacci))
- Use diff+patch approach to map.setStyle when the parameter is a URL ([#4025](https://github.com/mapbox/mapbox-gl-js/issues/4025), fixed by [#7562](https://github.com/mapbox/mapbox-gl-js/pull/7562))
- Begin touch zoom immediately when rotation disabled ([#7582](https://github.com/mapbox/mapbox-gl-js/pull/7582)) (by [msbarry](https://github.com/msbarry))
- Fix symbol rendering under opaque fill layers ([#7612](https://github.com/mapbox/mapbox-gl-js/pull/7612))
- Fix shaking by aligning raster sources to pixel grid only when map is idle ([#7426](https://github.com/mapbox/mapbox-gl-js/pull/7426))
- Fix raster layers in Edge 18 by disabling it's incomplete WebP support ([#7687](https://github.com/mapbox/mapbox-gl-js/pull/7687))
- Fix memory leak in hillshade layer ([#7691](https://github.com/mapbox/mapbox-gl-js/pull/7691))
- Fix disappearing custom layers ([#7711](https://github.com/mapbox/mapbox-gl-js/pull/7711))

## 0.51.0

November 7, 2018

### ✨ Features and improvements

- Add initial bounds as map constructor option ([#5518](https://github.com/mapbox/mapbox-gl-js/pull/5518)) (by [stepankuzmin](https://github.com/stepankuzmin))
- Improve performance on machines with > 8 cores ([#7407](https://github.com/mapbox/mapbox-gl-js/issues/7407), fixed by [#7430](https://github.com/mapbox/mapbox-gl-js/pull/7430))
- Add `MercatorCoordinate` type ([#7488](https://github.com/mapbox/mapbox-gl-js/pull/7488))
- Allow browser-native `contextmenu` to be enabled ([#2301](https://github.com/mapbox/mapbox-gl-js/issues/2301), fixed by [#7369](https://github.com/mapbox/mapbox-gl-js/pull/7369))
- Add an unminified production build to the NPM package ([#7403](https://github.com/mapbox/mapbox-gl-js/pull/7403))
- Add support for `LngLat` conversion from `{lat, lon}` ([#7507](https://github.com/mapbox/mapbox-gl-js/pull/7507)) (by [@bfrengley](https://github.com/bfrengley))
- Add tooltips for navigation controls ([#7373](https://github.com/mapbox/mapbox-gl-js/pull/7373))
- Show attribution only for used sources ([#7384](https://github.com/mapbox/mapbox-gl-js/pull/7384))
- Add telemetry event to log map loads ([#7431](https://github.com/mapbox/mapbox-gl-js/pull/7431))
- **Tighten style validation**
    - Disallow expressions as stop values ([#7396](https://github.com/mapbox/mapbox-gl-js/pull/7396))
    - Disallow `feature-state` expressions in filters ([#7366](https://github.com/mapbox/mapbox-gl-js/pull/7366))

### 🐛 Bug fixes

- Fix for GeoJSON geometries not working when coincident with tile boundaries([#7436](https://github.com/mapbox/mapbox-gl-js/issues/7436), fixed by [#7448](https://github.com/mapbox/mapbox-gl-js/pull/7448))
- Fix depth buffer-related rendering issues on some Android devices. ([#7471](https://github.com/mapbox/mapbox-gl-js/pull/7471))
- Fix positioning of compact attribution strings ([#7444](https://github.com/mapbox/mapbox-gl-js/pull/7444), [#7445](https://github.com/mapbox/mapbox-gl-js/pull/7445), and [#7391](https://github.com/mapbox/mapbox-gl-js/pull/7391))
- Fix an issue with removing markers in mouse event callbacks ([#7442](https://github.com/mapbox/mapbox-gl-js/pull/7442)) (by [vbud](https://github.com/vbud))
- Remove controls before destroying a map ([#7479](https://github.com/mapbox/mapbox-gl-js/pull/7479))
- Fix display of Scale control values < 1 ([#7469](https://github.com/mapbox/mapbox-gl-js/pull/7469)) (by [MichaelHedman](https://github.com/MichaelHedman))
- Fix an error when using location `hash` within iframes in IE11 ([#7411](https://github.com/mapbox/mapbox-gl-js/pull/7411))
- Fix depth mode usage in custom layers ([#7432](https://github.com/mapbox/mapbox-gl-js/pull/7432)) (by [markusjohnsson](https://github.com/markusjohnsson))
- Fix an issue with shaky sprite images during scroll zooms ([#7558](https://github.com/mapbox/mapbox-gl-js/pull/7558))

## 0.50.0

October 10, 2018

### ✨ Features and improvements

- 🎉 Add Custom Layers that can be rendered into with user-provided WebGL code ([#7039](https://github.com/mapbox/mapbox-gl-js/pull/7039))
- Add WebGL face culling for increased performance ([#7178](https://github.com/mapbox/mapbox-gl-js/pull/7178))
- Improve speed of expression evaluation ([#7334](https://github.com/mapbox/mapbox-gl-js/pull/7334))
- Automatically coerce to string for `concat` expression and `text-field` property ([#6190](https://github.com/mapbox/mapbox-gl-js/issues/6190), fixed by [#7280](https://github.com/mapbox/mapbox-gl-js/pull/7280))
- Add `fill-extrusion-vertical-gradient` property for controlling shading of fill extrusions ([#5768](https://github.com/mapbox/mapbox-gl-js/issues/5768), fixed by [#6841](https://github.com/mapbox/mapbox-gl-js/pull/6841))
- Add update functionality for images provided via `ImageSource` ([#4050](https://github.com/mapbox/mapbox-gl-js/issues/4050), fixed by [#7342](https://github.com/mapbox/mapbox-gl-js/pull/7342)) (by [@dcervelli](https://github.com/dcervelli))

### 🐛 Bug fixes

- **Expressions**
    - Fix expressions that use `log2` and `log10` in IE11 ([#7318](https://github.com/mapbox/mapbox-gl-js/issues/7318), fixed by [#7320](https://github.com/mapbox/mapbox-gl-js/pull/7320))
    - Fix `let` expression stripping expected type during parsing ([#7300](https://github.com/mapbox/mapbox-gl-js/issues/7300), fixed by [#7301](https://github.com/mapbox/mapbox-gl-js/pull/7301))
    - Fix superfluous wrapping of literals in `literal` expression ([#7336](https://github.com/mapbox/mapbox-gl-js/issues/7336), fixed by [#7337](https://github.com/mapbox/mapbox-gl-js/pull/7337))
    - Allow calling `to-color` on values that are already of type `Color` ([#7260](https://github.com/mapbox/mapbox-gl-js/pull/7260))
    - Fix `to-array` for empty arrays (([#7261](https://github.com/mapbox/mapbox-gl-js/pull/7261)))
    - Fix identity functions for `text-field` when using formatted text ([#7351](https://github.com/mapbox/mapbox-gl-js/pull/7351))
    - Fix coercion of `null` to `0` in `to-number` expression ([#7083](https://github.com/mapbox/mapbox-gl-js/issues/7083), fixed by [#7274](https://github.com/mapbox/mapbox-gl-js/pull/7274))
- **Canvas source**
    - Fix missing repeats of `CanvasSource` when it crosses the antimeridian ([#7273](https://github.com/mapbox/mapbox-gl-js/pull/7273))
    - Fix `CanvasSource` not respecting alpha values set on `canvas` element ([#7302](https://github.com/mapbox/mapbox-gl-js/issues/7302), fixed by [#7309](https://github.com/mapbox/mapbox-gl-js/pull/7309))
- **Rendering**
    - Fix rendering of fill extrusions with really high heights ([#7292](https://github.com/mapbox/mapbox-gl-js/pull/7292))
    - Fix an error where the map state wouldn't return to `loaded` after certain runtime styling changes when there were errored tiles in the viewport ([#7355](https://github.com/mapbox/mapbox-gl-js/pull/7355))
    - Fix errors when rendering symbol layers without symbols ([#7241](https://github.com/mapbox/mapbox-gl-js/issues/7241), fixed by [#7253](https://github.com/mapbox/mapbox-gl-js/pull/7253))
    - Don't fade in symbols with `*-allow-overlap: true` when panning into the viewport ([#7172](https://github.com/mapbox/mapbox-gl-js/issues/7172), fixed by[#7244](https://github.com/mapbox/mapbox-gl-js/pull/7244))
- **Library**
    - Fix disambiguation for `mouseover` event ([#7295](https://github.com/mapbox/mapbox-gl-js/issues/7295), fixed by [#7299](https://github.com/mapbox/mapbox-gl-js/pull/7299))
    - Fix silent failure of `getImage` if an SVG is requested ([#7312](https://github.com/mapbox/mapbox-gl-js/issues/7312), fixed by [#7313](https://github.com/mapbox/mapbox-gl-js/pull/7313))
    - Fix empty control group box shadow ([#7303](https://github.com/mapbox/mapbox-gl-js/issues/7303), fixed by [#7304](https://github.com/mapbox/mapbox-gl-js/pull/7304)) (by [Duder-onomy](https://github.com/Duder-onomy))
    - Fixed an issue where a wrong timestamp was sent for Mapbox turnstile events ([#7381](https://github.com/mapbox/mapbox-gl-js/pull/7381))
    - Fixed a bug that lead to attribution not showing up correctly in Internet Explorer ([#3945](https://github.com/mapbox/mapbox-gl-js/issues/3945), fixed by [#7391](https://github.com/mapbox/mapbox-gl-js/pull/7391))

## 0.49.0

September 6, 2018

### ⚠️ Breaking changes

- Use `client{Height/Width}` instead of `offset{Height/Width}` for map canvas sizing ([#6848](https://github.com/mapbox/mapbox-gl-js/issues/6848), fixed by [#7128](https://github.com/mapbox/mapbox-gl-js/pull/7128))

### 🐛 Bug fixes

- Fix [Top Issues list](https://mapbox.github.io/top-issues/#!mapbox/mapbox-gl-js) for mapbox-gl-js ([#7108](https://github.com/mapbox/mapbox-gl-js/issues/7108), fixed by [#7112](https://github.com/mapbox/mapbox-gl-js/pull/7112))
- Fix bug in which symbols with `icon-allow-overlap: true, text-allow-overlap: true, text-optional: false` would show icons when they shouldn't ([#7041](https://github.com/mapbox/mapbox-gl-js/pull/7041))
- Fix bug where the map would not stop at the exact zoom level requested by Map#FlyTo ([#7222](https://github.com/mapbox/mapbox-gl-js/issues/7222)) ([#7223](https://github.com/mapbox/mapbox-gl-js/pull/7223)) (by [@benoitbzl](https://github.com/benoitbzl))
- Keep map centered on the center point of a multi-touch gesture when zooming ([#6722](https://github.com/mapbox/mapbox-gl-js/issues/6722)) ([#7191](https://github.com/mapbox/mapbox-gl-js/pull/7191)) (by [pakastin](https://github.com/pakastin))
- Update the style-spec's old `gl-style-migrate` script to include conversion of legacy functions and filters to their expression equivalents ([#6927](https://github.com/mapbox/mapbox-gl-js/issues/6927), fixed by [#7095](https://github.com/mapbox/mapbox-gl-js/pull/7095))
- Fix `icon-size` for small data-driven values ([#7125](https://github.com/mapbox/mapbox-gl-js/pull/7125))
- Fix bug in the way AJAX requests load local files on iOS web view ([#6610](https://github.com/mapbox/mapbox-gl-js/pull/6610)) (by [oscarfonts](https://github.com/oscarfonts))
- Fix bug in which canvas sources would not render in world wrapped tiles at the edge of the viewport ([#7271]https://github.com/mapbox/mapbox-gl-js/issues/7271), fixed by [#7273](https://github.com/mapbox/mapbox-gl-js/pull/7273))

### ✨ Features and improvements

- Performance updates:
    - Improve time to first render by updating how feature ID maps are transferred to the main thread ([#7110](https://github.com/mapbox/mapbox-gl-js/issues/7110), fixed by [#7132](https://github.com/mapbox/mapbox-gl-js/pull/7132))
    - Reduce size of JSON transmitted from worker thread to main thread ([#7124](https://github.com/mapbox/mapbox-gl-js/pull/7124))
    - Improve image/glyph atlas packing algorithm ([#7171](https://github.com/mapbox/mapbox-gl-js/pull/7171))
    - Use murmur hash on symbol instance keys to reduce worker transfer costs ([#7127](https://github.com/mapbox/mapbox-gl-js/pull/7127))
- Add GL state management for uniforms ([#6018](https://github.com/mapbox/mapbox-gl-js/pull/6018))
- Add `symbol-z-order` symbol layout property to style spec ([#7219](https://github.com/mapbox/mapbox-gl-js/pull/7219))
- Implement data-driven styling support for `*-pattern properties` ([#6289](https://github.com/mapbox/mapbox-gl-js/pull/6289))
- Add `Map#fitScreenCoordinates` which fits viewport to two points, similar to `Map#fitBounds` but uses screen coordinates and supports non-zero map bearings ([#6894](https://github.com/mapbox/mapbox-gl-js/pull/6894))
- Re-implement LAB/HSL color space interpolation for expressions ([#5326](https://github.com/mapbox/mapbox-gl-js/issues/5326), fixed by [#7123](https://github.com/mapbox/mapbox-gl-js/pull/7123))
- Enable benchmark testing for Mapbox styles ([#7047](https://github.com/mapbox/mapbox-gl-js/pull/7047))
- Allow `Map#setFeatureState` and `Map#getFeatureState` to accept numeric IDs ([#7106](https://github.com/mapbox/mapbox-gl-js/pull/7106)) (by [@bfrengley](https://github.com/bfrengley))

## 0.48.0

August 16, 2018

### ⚠️ Breaking changes

- Treat tiles that error with status 404 as empty renderable tiles to prevent rendering duplicate features in some sparse tilesets ([#6803](https://github.com/mapbox/mapbox-gl-js/pull/6803))

### 🐛 Bug fixes

- Fix issue where `text-max-angle` property was being calculated incorrectly internally, causing potential rendering errors when `"symbol-placement": line`
- Require `feature.id` when using `Map#setFeatureState` ([#6974](https://github.com/mapbox/mapbox-gl-js/pull/6974))
- Fix issue with removing the `GeolocateControl` when user location is being used ([#6977](https://github.com/mapbox/mapbox-gl-js/pull/6977)) (by [sergei-zelinsky](https://github.com/sergei-zelinsky))
- Fix memory leak caused by a failure to remove all controls added to the map ([#7042](https://github.com/mapbox/mapbox-gl-js/pull/7042))
- Fix bug where the build would fail when using mapbox-gl webpack 2 and UglifyJSPlugin ([#4359](https://github.com/mapbox/mapbox-gl-js/issues/4359), fixed by [#6956](https://api.github.com/repos/mapbox/mapbox-gl-js/pulls/6956))
- Fix bug where fitBounds called with coordinates outside the bounds of Web Mercator resulted in uncaught error ([#6906](https://github.com/mapbox/mapbox-gl-js/issues/6906), fixed by [#6918](https://api.github.com/repos/mapbox/mapbox-gl-js/pulls/6918))
- Fix bug wherein `Map#querySourceFeatures` was returning bad results on zooms > maxZoom ([#7061](https://github.com/mapbox/mapbox-gl-js/pull/7061))
- Relax typing for equality and order expressions ([#6459](https://github.com/mapbox/mapbox-gl-js/issues/6459), fixed by [#6961](https://api.github.com/repos/mapbox/mapbox-gl-js/pulls/6961))
- Fix bug where `queryPadding` for all layers in a source was set by the first layer, causing incorrect querying on other layers and, in some cases, incorrect firing of events associated with individual layers ([#6909](https://github.com/mapbox/mapbox-gl-js/pull/6909))

### ✨ Features and improvements

- Performance Improvements:
    - Stop unnecessary serialization of symbol source features. ([#7013](https://github.com/mapbox/mapbox-gl-js/pull/7013))
    - Optimize calculation for getting visible tile coordinates ([#6998](https://github.com/mapbox/mapbox-gl-js/pull/6998))
    - Improve performance of creating `{Glyph/Image}Atlas`es ([#7091](https://github.com/mapbox/mapbox-gl-js/pull/7091))
    - Optimize and simplify tile retention logic ([#6995](https://github.com/mapbox/mapbox-gl-js/pull/6995))
- Add a user turnstile event for users accessing Mapbox APIs ([#6980](https://github.com/mapbox/mapbox-gl-js/pull/6980))
- Add support for autogenerating feature ids for GeoJSON sources so they can be used more easily with the `Map#setFeatureState` API ([#7043](https://www.github.com/mapbox/mapbox-gl-js/pull/7043))) ([#7091](https://github.com/mapbox/mapbox-gl-js/pull/7091))
- Add ability to style symbol layers labels with multiple fonts and text sizes via `"format"` expression ([#6994](https://www.github.com/mapbox/mapbox-gl-js/pull/6994))
- Add customAttribution option to AttributionControl ([#7033](https://github.com/mapbox/mapbox-gl-js/pull/7033)) (by [mklopets](https://github.com/mklopets))
- Publish Flow type definitions alongside compiled bundle ([#7079](https://api.github.com/repos/mapbox/mapbox-gl-js/pulls/7079))
- Introduce symbol cross fading when crossing integer zoom levels to prevent labels from disappearing before newly loaded tiles' labels can be rendered ([#6951](https://github.com/mapbox/mapbox-gl-js/pull/6951))
- Improvements in label collision detection ([#6925](https://api.github.com/repos/mapbox/mapbox-gl-js/pulls/6925)))

## 0.47.0

### ✨ Features and improvements

- Add configurable drag pan threshold ([#6809](https://github.com/mapbox/mapbox-gl-js/pull/6809)) (by [msbarry](https://github.com/msbarry))
- Add `raster-resampling` raster paint property ([#6411](https://github.com/mapbox/mapbox-gl-js/pull/6411)) (by [@andrewharvey](https://github.com/andrewharvey))
- Add `symbol-placement: line-center` ([#6821](https://github.com/mapbox/mapbox-gl-js/pull/6821))
- Add methods for inspecting GeoJSON clusters ([#3318](https://github.com/mapbox/mapbox-gl-js/issues/3318), fixed by [#6829](https://github.com/mapbox/mapbox-gl-js/pull/6829))
- Add warning to geolocate control when unsupported ([#6923](https://github.com/mapbox/mapbox-gl-js/pull/6923)) (by [@aendrew](https://github.com/aendrew))
- Upgrade geojson-vt to 3.1.4 ([#6942](https://github.com/mapbox/mapbox-gl-js/pull/6942))
- Include link to license in compiled bundle ([#6975](https://github.com/mapbox/mapbox-gl-js/pull/6975))

### 🐛 Bug fixes

- Use updateData instead of re-creating buffers for repopulated paint arrays ([#6853](https://github.com/mapbox/mapbox-gl-js/pull/6853))
- Fix ScrollZoom handler setting tr.zoom = NaN ([#6924](https://github.com/mapbox/mapbox-gl-js/pull/6924))
    - Failed to invert matrix error ([#6486](https://github.com/mapbox/mapbox-gl-js/issues/6486), fixed by [#6924](https://github.com/mapbox/mapbox-gl-js/pull/6924))
    - Fixing matrix errors ([#6782](https://github.com/mapbox/mapbox-gl-js/issues/6782), fixed by [#6924](https://github.com/mapbox/mapbox-gl-js/pull/6924))
- Fix heatmap tile clipping when layers are ordered above it ([#6806](https://github.com/mapbox/mapbox-gl-js/issues/6806), fixed by [#6807](https://github.com/mapbox/mapbox-gl-js/pull/6807))
- Fix video source in safari (macOS and iOS) ([#6443](https://github.com/mapbox/mapbox-gl-js/issues/6443), fixed by [#6811](https://github.com/mapbox/mapbox-gl-js/pull/6811))
- Do not reload errored tiles ([#6813](https://github.com/mapbox/mapbox-gl-js/pull/6813))
- Fix send / remove timing bug in Dispatcher ([#6756](https://github.com/mapbox/mapbox-gl-js/pull/6756), fixed by [#6826](https://github.com/mapbox/mapbox-gl-js/pull/6826))
- Fix flyTo not zooming to exact given zoom ([#6828](https://github.com/mapbox/mapbox-gl-js/pull/6828))
- Don't stop animation on map resize ([#6636](https://github.com/mapbox/mapbox-gl-js/pull/6636))
- Fix map.getBounds() with rotated map ([#6875](https://github.com/mapbox/mapbox-gl-js/pull/6875)) (by [zoltan-mihalyi](https://github.com/zoltan-mihalyi))
- Support collators in feature filter expressions. ([#6929](https://github.com/mapbox/mapbox-gl-js/pull/6929))
- Fix Webpack production mode compatibility ([#6981](https://github.com/mapbox/mapbox-gl-js/pull/6981))

## 0.46.0

### ⚠️ Breaking changes

- Align implicit type casting behavior of `match` expressions with with `case/==` ([#6684](https://github.com/mapbox/mapbox-gl-js/pull/6684))

### ✨ Features and improvements

- :tada: Add `Map#setFeatureState` and `feature-state` expression to support interactive styling ([#6263](https://github.com/mapbox/mapbox-gl-js/pull/6263))
- Create draggable `Marker` with `setDraggable` ([#6687](https://github.com/mapbox/mapbox-gl-js/pull/6687))
- Add `Map#listImages` for listing all currently active sprites/images ([#6381](https://github.com/mapbox/mapbox-gl-js/issues/6381))
- Add "crossSourceCollisions" option to disable cross-source collision detection ([#6566](https://github.com/mapbox/mapbox-gl-js/pull/6566))
- Handle `text/icon-rotate` for symbols with `symbol-placement: point` ([#6075](https://github.com/mapbox/mapbox-gl-js/issues/6075))
- Automatically compact Mapbox wordmark on narrow maps. ([#4282](https://github.com/mapbox/mapbox-gl-js/issues/4282)) (by [@andrewharvey](https://github.com/andrewharvey))
- Only show compacted AttributionControl on interactive displays ([#6506](https://github.com/mapbox/mapbox-gl-js/pull/6506)) (by [@andrewharvey](https://github.com/andrewharvey))
- Use postcss to inline svg files into css, reduce size of mapbox-gl.css ([#6513](https://github.com/mapbox/mapbox-gl-js/pull/6513)) (by [@andrewharvey](https://github.com/andrewharvey))
- Add support for GeoJSON attribution ([#6364](https://github.com/mapbox/mapbox-gl-js/pull/6364)) (by [@andrewharvey](https://github.com/andrewharvey))
- Add instructions for running individual unit and render tests ([#6686](https://github.com/mapbox/mapbox-gl-js/pull/6686))
- Make Map constructor fail if WebGL init fails. ([#6744](https://github.com/mapbox/mapbox-gl-js/pull/6744)) (by [uforic](https://github.com/uforic))
- Add browser fallback code for `collectResourceTiming: true` in web workers ([#6721](https://github.com/mapbox/mapbox-gl-js/pull/6721))
- Remove ignored usage of gl.lineWidth ([#5541](https://github.com/mapbox/mapbox-gl-js/pull/5541))
- Split new bounds calculation out of fitBounds into new method ([#6683](https://github.com/mapbox/mapbox-gl-js/pull/6683))
- Allow integration tests to be organized in an arbitrarily deep directory structure ([#3920](https://github.com/mapbox/mapbox-gl-js/issues/3920))
- Make "Missing Mapbox GL JS CSS" a console warning ([#5786](https://github.com/mapbox/mapbox-gl-js/issues/5786))
- Add rel="noopener" to Mapbox attribution link. ([#6729](https://github.com/mapbox/mapbox-gl-js/pull/6729)) (by [gorbypark](https://github.com/gorbypark))
- Update to deep equality check in example code ([#6599](https://github.com/mapbox/mapbox-gl-js/pull/6599)) (by [jonsadka](https://github.com/jonsadka))
- Upgrades!
    - Upgrade ESM dependency to ^3.0.39 ([#6750](https://github.com/mapbox/mapbox-gl-js/pull/6750))
    - Ditch gl-matrix fork in favor of the original package ([#6751](https://github.com/mapbox/mapbox-gl-js/pull/6751))
    - Update to latest sinon ([#6771](https://github.com/mapbox/mapbox-gl-js/pull/6771))
    - Upgrade to Flow 0.69 ([#6594](https://github.com/mapbox/mapbox-gl-js/pull/6594))
    - Update to mapbox-gl-supported 1.4.0 ([#6773](https://github.com/mapbox/mapbox-gl-js/pull/6773))

### 🐛 Bug fixes

- `collectResourceTiming: true` generates error on iOS9 Safari, IE 11 ([#6690](https://github.com/mapbox/mapbox-gl-js/issues/6690))
- Fix PopupOptions flow type declarations ([#6670](https://github.com/mapbox/mapbox-gl-js/pull/6670)) (by [TimPetricola](https://github.com/TimPetricola))
- Add className option to Popup constructor ([#6502](https://github.com/mapbox/mapbox-gl-js/pull/6502)) (by [Ashot-KR](https://github.com/Ashot-KR))
- GeoJSON MultiLineStrings with `lineMetrics=true` only rendered first line ([#6649](https://github.com/mapbox/mapbox-gl-js/issues/6649))
- Provide target property for mouseenter/over/leave/out events ([#6623](https://github.com/mapbox/mapbox-gl-js/issues/6623))
- Don't break on sources whose name contains "." ([#6660](https://github.com/mapbox/mapbox-gl-js/issues/6660))
- Rotate and pitch with navigationControl broke in v0.45 ([#6650](https://github.com/mapbox/mapbox-gl-js/issues/6650))
- Zero-width lines remained visible ([#6769](https://github.com/mapbox/mapbox-gl-js/pull/6769))
- Heatmaps inappropriately clipped at tile boundaries ([#6806](https://github.com/mapbox/mapbox-gl-js/issues/6806))
- Use named exports for style-spec entrypoint module ([#6601](https://github.com/mapbox/mapbox-gl-js/issues/6601)
- Don't fire click event if default is prevented on mousedown for a drag event ([#6697](https://github.com/mapbox/mapbox-gl-js/pull/6697), fixes [#6642](https://github.com/mapbox/mapbox-gl-js/issues/6642))
- Double clicking to zoom in breaks map dragging/panning in Edge ([#6740](https://github.com/mapbox/mapbox-gl-js/issues/6740)) (by [GUI](https://github.com/GUI))
- \*-transition properties cannot be set with setPaintProperty() ([#6706](https://github.com/mapbox/mapbox-gl-js/issues/6706))
- Marker with `a` element does not open the url when clicked ([#6730](https://github.com/mapbox/mapbox-gl-js/issues/6730))
- `setRTLTextPlugin` fails with relative URLs ([#6719](https://github.com/mapbox/mapbox-gl-js/issues/6719))
- Collision detection incorrect for symbol layers that share the same layout properties ([#6548](https://github.com/mapbox/mapbox-gl-js/pull/6548))
- Fix a possible crash when calling queryRenderedFeatures after querySourceFeatures ([#6559](https://github.com/mapbox/mapbox-gl-js/pull/6559))
- Fix a collision detection issue that could cause labels to temporarily be placed too densely during rapid panning ([#5654](https://github.com/mapbox/mapbox-gl-js/issues/5654))

## 0.45.0

### ⚠️ Breaking changes

- `Evented#fire` and `Evented#listens` are now marked as private. Though `Evented` is still exported, and `fire` and `listens` are still functional, we encourage you to seek alternatives; a future version may remove their API accessibility or change its behavior. If you are writing a class that needs event emitting functionality, consider using [`EventEmitter`](https://nodejs.org/api/events.html#events_class_eventemitter) or similar libraries instead.
- The `"to-string"` expression operator now converts `null` to an empty string rather than to `"null"`. [#6534](https://github.com/mapbox/mapbox-gl-js/pull/6534)

### ✨ Features and improvements

- :rainbow: Add `line-gradient` property [#6303](https://github.com/mapbox/mapbox-gl-js/pull/6303)
- Add `abs`, `round`, `floor`, and `ceil` expression operators [#6496](https://github.com/mapbox/mapbox-gl-js/pull/6496)
- Add `collator` expression for controlling case and diacritic sensitivity in string comparisons [#6270](https://github.com/mapbox/mapbox-gl-js/pull/6270)
    - Rename `caseSensitive` and `diacriticSensitive` expressions to `case-sensitive` and `diacritic-sensitive` for consistency [#6598](https://github.com/mapbox/mapbox-gl-js/pull/6598)
    - Prevent `collator` expressions for evaluating as constant to account for potential environment-specific differences in expression evaluation [#6596](https://github.com/mapbox/mapbox-gl-js/pull/6596)
- Add CSS linting to test suite (by [@jasonbarry](https://github.com/jasonbarry))) [#6071](https://github.com/mapbox/mapbox-gl-js/pull/6071)
- Add support for configurable maxzoom in `raster-dem` tilesets [#6103](https://github.com/mapbox/mapbox-gl-js/pull/6103)
- Add `Map#isZooming` and `Map#isRotating` methods [#6128](https://github.com/mapbox/mapbox-gl-js/pull/6128), [#6183](https://github.com/mapbox/mapbox-gl-js/pull/6183)
- Add support for Mapzen Terrarium tiles in `raster-dem` sources [#6110](https://github.com/mapbox/mapbox-gl-js/pull/6110)
- Add `preventDefault` method on `mousedown`, `touchstart`, and `dblclick` events [#6218](https://github.com/mapbox/mapbox-gl-js/pull/6218)
- Add `originalEvent` property on `zoomend` and `moveend` for user-initiated scroll events (by [@stepankuzmin](https://github.com/stepankuzmin))) [#6175](https://github.com/mapbox/mapbox-gl-js/pull/6175)
- Accept arguments of type `value` in [`"length"` expressions](https://www.mapbox.com/mapbox-gl-js/style-spec/#expressions-length) [#6244](https://github.com/mapbox/mapbox-gl-js/pull/6244)
- Introduce `MapWheelEvent`[#6237](https://github.com/mapbox/mapbox-gl-js/pull/6237)
- Add setter for `ScaleControl` units (by [@ryanhamley](https://github.com/ryanhamley))) [#6138](https://github.com/mapbox/mapbox-gl-js/pull/6138), [#6274](https://github.com/mapbox/mapbox-gl-js/pull/6274)
- Add `open` event for `Popup` [#6311](https://github.com/mapbox/mapbox-gl-js/pull/6311)
- Explicit `"object"` type assertions are no longer required when using expressions [#6235](https://github.com/mapbox/mapbox-gl-js/pull/6235)
- Add `anchor` option to `Marker` [#6350](https://github.com/mapbox/mapbox-gl-js/pull/6350)
- `HTMLElement` is now passed to `Marker` as part of the `options` object, but the old function signature is still supported for backwards compatibility [#6356](https://github.com/mapbox/mapbox-gl-js/pull/6356)
- Add support for custom colors when using the default `Marker` SVG element (by [@andrewharvey](https://github.com/andrewharvey))) [#6416](https://github.com/mapbox/mapbox-gl-js/pull/6416)
- Allow `CanvasSource` initialization from `HTMLElement` [#6424](https://github.com/mapbox/mapbox-gl-js/pull/6424)
- Add `is-supported-script` expression [#6260](https://github.com/mapbox/mapbox-gl-js/pull/6260)

### 🐛 Bug fixes

- Align `raster-dem` tiles to pixel grid to eliminate blurry rendering on some devices [#6059](https://github.com/mapbox/mapbox-gl-js/pull/6059)
- Fix label collision circle debug drawing on overzoomed tiles [#6073](https://github.com/mapbox/mapbox-gl-js/pull/6073)
- Improve error reporting for some failed requests [#6126](https://github.com/mapbox/mapbox-gl-js/pull/6126), [#6032](https://github.com/mapbox/mapbox-gl-js/pull/6032)
- Fix several `Map#queryRenderedFeatures` bugs:
    - account for `{text, icon}-offset` when querying[#6135](https://github.com/mapbox/mapbox-gl-js/pull/6135)
    - correctly query features that extend across tile boundaries [#5756](https://github.com/mapbox/mapbox-gl-js/pull/6283)
    - fix querying of `circle` layer features with `-pitch-scaling: 'viewport'` or `-pitch-alignment: 'map'` [#6036](https://github.com/mapbox/mapbox-gl-js/pull/6036)
    - eliminate flicker effects when using query results to set a hover effect by switching from tile-based to viewport-based symbol querying [#6497](https://github.com/mapbox/mapbox-gl-js/pull/6497)
- Preserve browser history state when updating the `Map` hash [#6140](https://github.com/mapbox/mapbox-gl-js/pull/6140)
- Fix undefined behavior when `Map#addLayer` is invoked with an `id` of a preexisting layer [#6147](https://github.com/mapbox/mapbox-gl-js/pull/6147)
- Fix bug where `icon-image` would not be rendered if `text-field` is an empty string [#6164](https://github.com/mapbox/mapbox-gl-js/pull/6164)
- Ensure all camera methods fire `rotatestart` and `rotateend` events [#6187](https://github.com/mapbox/mapbox-gl-js/pull/6187)
- Always hide duplicate labels [#6166](https://github.com/mapbox/mapbox-gl-js/pull/6166)
- Fix `DragHandler` bugs where a left-button mouse click would end a right-button drag rotate and a drag gesture would not end if the control key is down on `mouseup` [#6193](https://github.com/mapbox/mapbox-gl-js/pull/6193)
- Add support for calling `{DragPanHandler, DragRotateHandler}#disable` while a gesture is in progress [#6232](https://github.com/mapbox/mapbox-gl-js/pull/6232)
- Fix `GeolocateControl` user location dot sizing when `Map`'s `<div>` inherits `box-sizing: border-box;` (by [@andrewharvey](https://github.com/andrewharvey))) [#6227](https://github.com/mapbox/mapbox-gl-js/pull/6232)
- Fix bug causing an off-by-one error in `array` expression error messages (by [@drewbo](https://github.com/drewbo))) [#6269](https://github.com/mapbox/mapbox-gl-js/pull/6269)
- Improve error message when an invalid access token triggers a 401 error [#6283](https://github.com/mapbox/mapbox-gl-js/pull/6283)
- Fix bug where lines with `line-width` larger than the sprite height of the `line-pattern` property would render other sprite images [#6246](https://github.com/mapbox/mapbox-gl-js/pull/6246)
- Fix broken touch events for `DragPanHandler` on mobile using Edge (note that zoom/rotate/pitch handlers still do not support Edge touch events [#1928](https://github.com/mapbox/mapbox-gl-js/pull/1928)) [#6325](https://github.com/mapbox/mapbox-gl-js/pull/6325)
- Fix race condition in `VectorTileWorkerSource#reloadTile` causing a rendering timeout [#6308](https://github.com/mapbox/mapbox-gl-js/issues/6308)
- Fix bug causing redundant `gl.stencilFunc` calls due to incorrect state checking (by [@yangdonglai](https://github.com/yangdonglai))) [#6330](https://github.com/mapbox/mapbox-gl-js/pull/6330)
- Fix bug where `mousedown` or `touchstart` would cancel camera animations in non-interactive maps [#6338](https://github.com/mapbox/mapbox-gl-js/pull/6338)
- Fix bug causing a full-screen flicker when the map is pitched and a symbol layer uses non-zero `text-translate` [#6365](https://github.com/mapbox/mapbox-gl-js/issues/6365)
- Fix bug in `to-rgba` expression causing division by zero [#6388](https://github.com/mapbox/mapbox-gl-js/pull/6388)
- Fix bug in cross-fading for `*-pattern` properties with non-integer zoom stops [#6430](https://github.com/mapbox/mapbox-gl-js/pull/6430)
- Fix bug where calling `Map#remove` on a map with constructor option `hash: true` throws an error (by [@allthesignals](https://github.com/allthesignals))) [#6490](https://github.com/mapbox/mapbox-gl-js/pull/6497)
- Fix bug causing flickering when panning across the anti-meridian [#6438](https://github.com/mapbox/mapbox-gl-js/pull/6438)
- Fix error when using tiles of non-power-of-two size [#6444](https://github.com/mapbox/mapbox-gl-js/pull/6444)
- Fix bug causing `Map#moveLayer(layerId, beforeId)` to remove the layer when `layerId === beforeId` [#6542](https://github.com/mapbox/mapbox-gl-js/pull/6542)

* Fix Rollup build for style-spec module [#6575](https://github.com/mapbox/mapbox-gl-js/pull/6575)
* Fix bug causing `Map#querySourceFeatures` to throw an `Uncaught TypeError`(https://github.com/mapbox/mapbox-gl-js/pull/6555)
* Fix issue where label collision detection was inaccurate for some symbol layers that shared layout properties with another layer [#6558](https://github.com/mapbox/mapbox-gl-js/pull/6558)
* Restore `target` property for `mouse{enter,over,leave,out}` events [#6623](https://github.com/mapbox/mapbox-gl-js/pull/6623)

## 0.44.2

### 🐛 Bug fixes

- Workaround a breaking change in Safari causing page to scroll/zoom in response to user actions intended to pan/zoom the map [#6095](https://github.com/mapbox/mapbox-gl-js/issues/6095). (N.B., not to be confused with the workaround from April 2017 dealing with the same breaking change in Chrome [#4259](https://github.com/mapbox/mapbox-gl-js/issues/6095). See also https://github.com/WICG/interventions/issues/18, https://bugs.webkit.org/show_bug.cgi?id=182521, https://bugs.chromium.org/p/chromium/issues/detail?id=639227 .)

## 0.44.1

### 🐛 Bug fixes

- Fix bug causing features from symbol layers to be omitted from `map.queryRenderedFeatures()` [#6074](https://github.com/mapbox/mapbox-gl-js/issues/6074)
- Fix error triggered by simultaneous scroll-zooming and drag-panning. [#6106](https://github.com/mapbox/mapbox-gl-js/issues/6106)
- Fix bug wherein drag-panning failed to resume after a brief pause [#6063](https://github.com/mapbox/mapbox-gl-js/issues/6063)

## 0.44.0

### ✨ Features and improvements

- The CSP policy of a page using mapbox-gl-js no longer needs to include `script-src 'unsafe-eval'` [#559](https://github.com/mapbox/mapbox-gl-js/issues/559)
- Add `LngLatBounds#isEmpty()` method [#5917](https://github.com/mapbox/mapbox-gl-js/pull/5917)
- Updated to flow 0.62.0 [#5923](https://github.com/mapbox/mapbox-gl-js/issues/5923)
- Make compass and zoom controls optional ([#5348](https://github.com/mapbox/mapbox-gl-js/pull/5348)) (by [@matijs](https://github.com/matijs)))
- Add `collectResourceTiming` option to the enable collection of [Resource Timing](https://developer.mozilla.org/en-US/docs/Web/API/Resource_Timing_API/Using_the_Resource_Timing_API) data for requests that are made from Web Workers. ([#5948](https://github.com/mapbox/mapbox-gl-js/issues/5948))
- Improve user location dot appearance across browsers ([#5498](https://github.com/mapbox/mapbox-gl-js/pull/5498)) (by [@jasonbarry](https://github.com/jasonbarry)))

### 🐛 Bug fixes

- Fix error triggered by `==` and `!=` expressions [#5947](https://github.com/mapbox/mapbox-gl-js/issues/5947)
- Image sources honor `renderWorldCopies` [#5932](https://github.com/mapbox/mapbox-gl-js/pull/5932)
- Fix transitions to default fill-outline-color [#5953](https://github.com/mapbox/mapbox-gl-js/issues/5953)
- Fix transitions for light properties [#5982](https://github.com/mapbox/mapbox-gl-js/issues/5982)
- Fix minor symbol collisions on pitched maps [#5913](https://github.com/mapbox/mapbox-gl-js/pull/5913)
- Fix memory leaks after `Map#remove()` [#5943](https://github.com/mapbox/mapbox-gl-js/pull/5943), [#5951](https://github.com/mapbox/mapbox-gl-js/pull/5951)
- Fix bug wherein `GeoJSONSource#setData()` caused labels to fade out and back in ([#6002](https://github.com/mapbox/mapbox-gl-js/issues/6002))
- Fix bug that could cause incorrect collisions for labels placed very near to each other at low zoom levels ([#5993](https://github.com/mapbox/mapbox-gl-js/issues/5993))
- Fix bug causing `move` events to be fired out of sync with actual map movements ([#6005](https://github.com/mapbox/mapbox-gl-js/pull/6005))
- Fix bug wherein `Map` did not fire `mouseover` events ([#6000](https://github.com/mapbox/mapbox-gl-js/pull/6000)] (by [@jay-manday](https://github.com/jay-manday)))
- Fix bug causing blurry rendering of raster tiles ([#4552](https://github.com/mapbox/mapbox-gl-js/issues/4552))
- Fix potential memory leak caused by removing layers ([#5995](https://github.com/mapbox/mapbox-gl-js/issues/5995))
- Fix bug causing attribution icon to appear incorrectly in compact maps not using Mapbox data ([#6042](https://github.com/mapbox/mapbox-gl-js/pull/6042))
- Fix positioning of default marker element ([#6012](https://github.com/mapbox/mapbox-gl-js/pull/6012)) (by [@andrewharvey](https://github.com/andrewharvey)))

## 0.43.0 (December 21, 2017)

### ⚠️ Breaking changes

- It is now an error to attempt to remove a source that is in use [#5562](https://github.com/mapbox/mapbox-gl-js/pull/5562)
- It is now an error if the layer specified by the `before` parameter to `moveLayer` does not exist [#5679](https://github.com/mapbox/mapbox-gl-js/pull/5679)
- `"colorSpace": "hcl"` now uses shortest-path interpolation for hue [#5811](https://github.com/mapbox/mapbox-gl-js/issues/5811)

### ✨ Features and improvements

- Introduce client-side hillshading with `raster-dem` source type and `hillshade` layer type [#5286](https://github.com/mapbox/mapbox-gl-js/pull/5286)
- GeoJSON sources take 2x less memory and generate tiles 20%–100% faster [#5799](https://github.com/mapbox/mapbox-gl-js/pull/5799)
- Enable data-driven values for text-font [#5698](https://github.com/mapbox/mapbox-gl-js/pull/5698)
- Enable data-driven values for heatmap-radius [#5898](https://github.com/mapbox/mapbox-gl-js/pull/5898)
- Add getter and setter for offset on marker [#5759](https://github.com/mapbox/mapbox-gl-js/pull/5759)
- Add `Map#hasImage` [#5775](https://github.com/mapbox/mapbox-gl-js/pull/5775)
- Improve typing for `==` and `!=` expressions [#5840](https://github.com/mapbox/mapbox-gl-js/pull/5840)
- Made `coalesce` expressions more useful [#5755](https://github.com/mapbox/mapbox-gl-js/issues/5755)
- Enable implicit type assertions for array types [#5738](https://github.com/mapbox/mapbox-gl-js/pull/5738)
- Improve hash control precision [#5767](https://github.com/mapbox/mapbox-gl-js/pull/5767)
- `supported()` now returns false on old IE 11 versions that don't support Web Worker blob URLs [#5801](https://github.com/mapbox/mapbox-gl-js/pull/5801)
- Remove flow globals TileJSON and Transferable [#5668](https://github.com/mapbox/mapbox-gl-js/pull/5668)
- Improve performance of image, video, and canvas sources [#5845](https://github.com/mapbox/mapbox-gl-js/pull/5845)

### 🐛 Bug fixes

- Fix popups and markers lag during pan animation [#4670](https://github.com/mapbox/mapbox-gl-js/issues/4670)
- Fix fading of symbol layers caused by setData [#5716](https://github.com/mapbox/mapbox-gl-js/issues/5716)
- Fix behavior of `to-rgba` and `rgba` expressions [#5778](https://github.com/mapbox/mapbox-gl-js/pull/5778), [#5866](https://github.com/mapbox/mapbox-gl-js/pull/5866)
- Fix cross-fading of `*-pattern` and `line-dasharray` [#5791](https://github.com/mapbox/mapbox-gl-js/pull/5791)
- Fix `colorSpace` function property [#5843](https://github.com/mapbox/mapbox-gl-js/pull/5843)
- Fix style diffing when changing GeoJSON source properties [#5731](https://github.com/mapbox/mapbox-gl-js/issues/5731)
- Fix missing labels when zooming out from overzoomed tile [#5827](https://github.com/mapbox/mapbox-gl-js/issues/5827)
- Fix missing labels when zooming out and quickly using setData [#5837](https://github.com/mapbox/mapbox-gl-js/issues/5837)
- Handle NaN as input to step and interpolate expressions [#5757](https://github.com/mapbox/mapbox-gl-js/pull/5757)
- Clone property values on input and output [#5806](https://github.com/mapbox/mapbox-gl-js/pull/5806)
- Bump geojson-rewind dependency [#5769](https://github.com/mapbox/mapbox-gl-js/pull/5769)
- Allow setting Marker's popup before LngLat [#5893](https://github.com/mapbox/mapbox-gl-js/pull/5893)

## 0.42.2 (November 21, 2017)

### 🐛 Bug fixes

- Add box-sizing to the "mapboxgl-ctrl-scale"-class [#5715](https://github.com/mapbox/mapbox-gl-js/pull/5715)
- Fix rendering in Safari [#5712](https://github.com/mapbox/mapbox-gl-js/issues/5712)
- Fix "Cannot read property 'hasTransition' of undefined" error [#5714](https://github.com/mapbox/mapbox-gl-js/issues/5714)
- Fix misplaced raster tiles [#5713](https://github.com/mapbox/mapbox-gl-js/issues/5713)
- Fix raster tile fading [#5722](https://github.com/mapbox/mapbox-gl-js/issues/5722)
- Ensure that an unset filter is undefined rather than null [#5727](https://github.com/mapbox/mapbox-gl-js/pull/5727)
- Restore pitch-with-rotate to nav control [#5725](https://github.com/mapbox/mapbox-gl-js/pull/5725)
- Validate container option in map constructor [#5695](https://github.com/mapbox/mapbox-gl-js/pull/5695)
- Fix queryRenderedFeatures behavior for features displayed in multiple layers [#5172](https://github.com/mapbox/mapbox-gl-js/issues/5172)

## 0.42.1 (November 17, 2017)

### 🐛 Bug fixes

- Workaround for map flashing bug on Chrome 62+ with Intel Iris Graphics 6100 cards [#5704](https://github.com/mapbox/mapbox-gl-js/pull/5704)
- Rerender map when `map.showCollisionBoxes` is set to `false` [#5673](https://github.com/mapbox/mapbox-gl-js/pull/5673)
- Fix transitions from property default values [#5682](https://github.com/mapbox/mapbox-gl-js/pull/5682)
- Fix runtime updating of `heatmap-color` [#5682](https://github.com/mapbox/mapbox-gl-js/pull/5682)
- Fix mobile Safari `history.replaceState` error [#5613](https://github.com/mapbox/mapbox-gl-js/pull/5613)

### ✨ Features and improvements

- Provide default element for Marker class [#5661](https://github.com/mapbox/mapbox-gl-js/pull/5661)

## 0.42.0 (November 10, 2017)

### ⚠️ Breaking changes

- Require that `heatmap-color` use expressions instead of stop functions [#5624](https://github.com/mapbox/mapbox-gl-js/issues/5624)
- Remove support for validating and migrating v6 styles
- Remove support for validating v7 styles [#5604](https://github.com/mapbox/mapbox-gl-js/pull/5604)
- Remove support for including `{tokens}` in expressions for `text-field` and `icon-image` [#5599](https://github.com/mapbox/mapbox-gl-js/issues/5599)
- Split `curve` expression into `step` and `interpolate` expressions [#5542](https://github.com/mapbox/mapbox-gl-js/pull/5542)
- Disallow interpolation in expressions for `line-dasharray` [#5519](https://github.com/mapbox/mapbox-gl-js/pull/5519)

### ✨ Features and improvements

- Improve label collision detection [#5150](https://github.com/mapbox/mapbox-gl-js/pull/5150)
    - Labels from different sources will now collide with each other
    - Collisions caused by rotation and pitch are now smoothly transitioned with a fade
    - Improved algorithm for fewer erroneous collisions, denser label placement, and greater label stability during rotation
- Add `sqrt` expression [#5493](https://github.com/mapbox/mapbox-gl-js/pull/5493)

### 🐛 Bug fixes and error reporting improvements

- Fix viewport calculations for `fitBounds` when both zooming and padding change [#4846](https://github.com/mapbox/mapbox-gl-js/issues/4846)
- Fix WebGL "range out of bounds for buffer" error caused by sorted symbol layers [#5620](https://github.com/mapbox/mapbox-gl-js/issues/5620)
- Fix symbol fading across tile reloads [#5491](https://github.com/mapbox/mapbox-gl-js/issues/5491)
- Change tile rendering order to better match GL Native [#5601](https://github.com/mapbox/mapbox-gl-js/pull/5601)
- Ensure no errors are triggered when calling `queryRenderedFeatures` on a heatmap layer [#5594](https://github.com/mapbox/mapbox-gl-js/pull/5594)
- Fix bug causing `queryRenderedSymbols` to return results from different sources [#5554](https://github.com/mapbox/mapbox-gl-js/issues/5554)
- Fix CJK rendering issues [#5544](https://github.com/mapbox/mapbox-gl-js/issues/5544), [#5546](https://github.com/mapbox/mapbox-gl-js/issues/5546)
- Account for `circle-stroke-width` in `queryRenderedFeatures` [#5514](https://github.com/mapbox/mapbox-gl-js/pull/5514)
- Fix rendering of fill layers atop raster layers [#5513](https://github.com/mapbox/mapbox-gl-js/pull/5513)
- Fix rendering of circle layers with a `circle-stroke-opacity` of 0 [#5496](https://github.com/mapbox/mapbox-gl-js/issues/5496)
- Fix memory leak caused by actor callbacks [#5443](https://github.com/mapbox/mapbox-gl-js/issues/5443)
- Fix source cache size for raster sources with tile sizes other than 512px [#4313](https://github.com/mapbox/mapbox-gl-js/issues/4313)
- Validate that zoom expressions only appear at the top level of an expression [#5609](https://github.com/mapbox/mapbox-gl-js/issues/5609)
- Validate that step and interpolate expressions don't have any duplicate stops [#5605](https://github.com/mapbox/mapbox-gl-js/issues/5605)
- Fix rendering for `icon-text-fit` with a data-driven `text-size` [#5632](https://github.com/mapbox/mapbox-gl-js/pull/5632)
- Improve validation to catch uses of deprecated function syntax [#5667](https://github.com/mapbox/mapbox-gl-js/pull/5667)
- Permit altitude coordinates in `position` field in GeoJSON [#5608](https://github.com/mapbox/mapbox-gl-js/pull/5608)

## 0.41.0 (October 11, 2017)

### :warning: Breaking changes

- Removed support for paint classes [#3643](https://github.com/mapbox/mapbox-gl-js/pull/3643). Instead, use runtime styling APIs or `Map#setStyle`.
- Reverted the `canvas` source `contextType` option added in 0.40.0 [#5449](https://github.com/mapbox/mapbox-gl-js/pull/5449)

### :bug: Bug fixes

- Clip raster tiles to avoid tile overlap [#5105](https://github.com/mapbox/mapbox-gl-js/pull/5105)
- Guard for offset edgecase in flyTo [#5331](https://github.com/mapbox/mapbox-gl-js/pull/5331)
- Ensure the map is updated after the sprite loads [#5367](https://github.com/mapbox/mapbox-gl-js/pull/5367)
- Limit animation duration on flyTo with maxDuration option [#5349](https://github.com/mapbox/mapbox-gl-js/pull/5349)
- Make double-tapping on make zoom in by a factor of 2 on iOS [#5274](https://github.com/mapbox/mapbox-gl-js/pull/5274)
- Fix rendering error with translucent raster tiles [#5380](https://github.com/mapbox/mapbox-gl-js/pull/5380)
- Error if invalid 'before' argument is passed to Map#addLayer [#5401](https://github.com/mapbox/mapbox-gl-js/pull/5401)
- Revert CanvasSource intermediary image buffer fix [#5449](https://github.com/mapbox/mapbox-gl-js/pull/5449)

### :sparkles: Features and improvements

- Use setData operation when diffing geojson sources [#5332](https://github.com/mapbox/mapbox-gl-js/pull/5332)
- Return early from draw calls on layers where opacity=0 [#5429](https://github.com/mapbox/mapbox-gl-js/pull/5429)
- A [heatmap](https://www.mapbox.com/mapbox-gl-js/example/heatmap-layer/) layer type is now available. This layer type allows you to visualize and explore massive datasets of points, reflecting the shape and density of data well while also looking beautiful. See [the blog post](https://blog.mapbox.com/sneak-peek-at-heatmaps-in-mapbox-gl-73b41d4b16ae) for further details.
  ![heatmap screenshot](https://cdn-images-1.medium.com/max/1600/1*Dme5MAgdA3pYdTRHUQzvLw.png)
- The value of a style property or filter can now be an [expression](https://www.mapbox.com/mapbox-gl-js/style-spec/#expressions). Expressions are a way of doing data-driven and zoom-driven styling that provides more flexibility and control, and unifies property and filter syntax.

    Previously, data-driven and zoom-driven styling relied on stop functions: you specify a feature property and a set of input-output pairs that essentially define a “scale” for how the style should be calculated based on the feature property. For example, the following would set circle colors on a green-to-red scale based on the value of `feature.properties.population`:

    ```
    "circle-color": {
      "property": "population",
      "stops": [
        [0, "green"],
        [1000000, "red"]
      ]
    }
    ```

    This approach is powerful, but we’ve seen a number of use cases that stop functions don't satisfy. Expressions provide the flexibility to address use cases like these:

    **Multiple feature properties**
    Using more than one feature property to calculate a given style property. E.g., styling land polygon colors based on both `feature.properties.land_use_category` and `feature.properties.elevation`.

    **Arithmetic**
    For some use cases it’s necessary to do some arithmetic on the input data. One example is sizing circles to represent quantitative data. Since a circle’s visual size on the screen is really its area (and A=πr^2), the right way to scale `circle-radius` is `square_root(feature.properties.input_data_value)`. Another example is unit conversions: feature data may include properties that are in some particular unit. Displaying such data in units appropriate to, say, a user’s preference or location, requires being able to do simple arithmetic (multiplication, division) on whatever value is in the data.

    **Conditional logic**
    This is a big one: basic if-then logic, for example to decide exactly what text to display for a label based on which properties are available in the feature or even the length of the name. A key example of this is properly supporting bilingual labels, where we have to decide whether to show local + English, local-only, or English-only, based on the data that’s available for each feature.

    **String manipulation**
    More dynamic control over label text with things like uppercase/lowercase/title case transforms, localized number formatting, etc. Without this functionality, crafting and iterating on label content entails a large data-prep burden.

    **Filters**
    Style layer filters had similar limitations. Moreover, they use a different syntax, even though their job is very similar to that of data-driven styling functions: filters say, “here’s how to look at a feature and decide whether to draw it,” and data-driven style functions say, “here’s how to look at a feature and decide how to size/color/place it.” Expressions provide a unified syntax for defining parts of a style that need to be calculated dynamically from feature data.

    For information on the syntax and behavior of expressions, please see [the documentation](https://www.mapbox.com/mapbox-gl-js/style-spec/#expressions).

### :wrench: Development workflow improvements

- Made the performance benchmarking runner more informative and statistically robust

## 0.40.1 (September 18, 2017)

### :bug: Bug fixes

- Fix bug causing flicker when zooming in on overzoomed tiles [#5295](https://github.com/mapbox/mapbox-gl-js/pull/5295)
- Remove erroneous call to Tile#redoPlacement for zoom-only or low pitch camera changes [#5284](https://github.com/mapbox/mapbox-gl-js/pull/5284)
- Fix bug where `CanvasSource` coordinates were flipped and improve performance for non-animated `CanvasSource`s [#5303](https://github.com/mapbox/mapbox-gl-js/pull/5303)
- Fix bug causing map not to render on some cases on Internet Explorer 11 [#5321](https://github.com/mapbox/mapbox-gl-js/pull/5321)
- Remove upper limit on `fill-extrusion-height` property [#5320](https://github.com/mapbox/mapbox-gl-js/pull/5320)

## 0.40.0 (September 13, 2017)

### :warning: Breaking changes

- `Map#addImage` now requires the image as an `HTMLImageElement`, `ImageData`, or object with `width`, `height`, and
  `data` properties with the same format as `ImageData`. It no longer accepts a raw `ArrayBufferView` in the second
  argument and `width` and `height` options in the third argument.
- `canvas` sources now require a `contextType` option specifying the drawing context associated with the source canvas. [#5155](https://github.com/mapbox/mapbox-gl-js/pull/5155)

### :sparkles: Features and improvements

- Correct rendering for multiple `fill-extrusion` layers on the same map [#5101](https://github.com/mapbox/mapbox-gl-js/pull/5101)
- Add an `icon-anchor` property to symbol layers [#5183](https://github.com/mapbox/mapbox-gl-js/pull/5183)
- Add a per-map `transformRequest` option, allowing users to provide a callback that transforms resource request URLs [#5021](https://github.com/mapbox/mapbox-gl-js/pull/5021)
- Add data-driven styling support for
    - `text-max-width` [#5067](https://github.com/mapbox/mapbox-gl-js/pull/5067)
    - `text-letter-spacing` [#5071](https://github.com/mapbox/mapbox-gl-js/pull/5071)
    - `line-join` [#5020](https://github.com/mapbox/mapbox-gl-js/pull/5020)
- Add support for SDF icons in `Map#addImage()` [#5181](https://github.com/mapbox/mapbox-gl-js/pull/5181)
- Added nautical miles unit to ScaleControl [#5238](https://github.com/mapbox/mapbox-gl-js/pull/5238) (by [@fmairesse](https://github.com/fmairesse)))
- Eliminate the map-wide limit on the number of glyphs and sprites that may be used in a style [#141](https://github.com/mapbox/mapbox-gl-js/issues/141). (Fixed by [#5190](https://github.com/mapbox/mapbox-gl-js/pull/5190), see also [mapbox-gl-native[#9213](https://github.com/mapbox/mapbox-gl-js/issues/9213)](https://github.com/mapbox/mapbox-gl-native/pull/9213)
- Numerous performance optimizations (including [#5108](https://github.com/mapbox/mapbox-gl-js/pull/5108) h/t [@pirxpilot](https://github.com/pirxpilot)))

### :bug: Bug fixes

- Add missing documentation for mouseenter, mouseover, mouseleave events [#4772](https://github.com/mapbox/mapbox-gl-js/issues/4772)
- Add missing documentation for `Marker#getElement()` method [#5242](https://github.com/mapbox/mapbox-gl-js/pull/5242)
- Fix bug wherein removing canvas source with animate=true leaves map in render loop [#5097](https://github.com/mapbox/mapbox-gl-js/issues/5097)
- Fix fullscreen detection on Firefox [#5272](https://github.com/mapbox/mapbox-gl-js/pull/5272)
- Fix z-fighting on overlapping fills within the same layer [#3320](https://github.com/mapbox/mapbox-gl-js/issues/3320)
- Fix handling of fractional values for `layer.minzoom` [#2929](https://github.com/mapbox/mapbox-gl-js/issues/2929)
- Clarify coordinate ordering in documentation for `center` option [#5042](https://github.com/mapbox/mapbox-gl-js/pull/5042) (by [@karthikb351](https://github.com/karthikb351)))
- Fix output of stop functions where two stops have the same input value [#5020](https://github.com/mapbox/mapbox-gl-js/pull/5020) (by [@edpop](https://github.com/edpop))
- Fix bug wherein using `Map#addLayer()` with an inline source would mutate its input [#4040](https://github.com/mapbox/mapbox-gl-js/issues/4040)
- Fix invalid css keyframes selector [#5075](https://github.com/mapbox/mapbox-gl-js/pull/5075) (by [@aar0nr](https://github.com/aar0nr)))
- Fix GPU-specific bug wherein canvas sources caused an error [#4262](https://github.com/mapbox/mapbox-gl-js/issues/4262)
- Fix a race condition in symbol layer handling that caused sporadic uncaught errors [#5185](https://github.com/mapbox/mapbox-gl-js/pull/5185)
- Fix bug causing line labels to render incorrectly on overzoomed tiles [#5120](https://github.com/mapbox/mapbox-gl-js/pull/5120)
- Fix bug wherein `NavigationControl` triggered mouse events unexpectedly [#5148](https://github.com/mapbox/mapbox-gl-js/issues/5148)
- Fix bug wherein clicking on the `NavigationControl` compass caused an error in IE 11 [#4784](https://github.com/mapbox/mapbox-gl-js/issues/4784)
- Remove dependency on GPL-3-licensed `fast-stable-stringify` module [#5152](https://github.com/mapbox/mapbox-gl-js/issues/5152)
- Fix bug wherein layer-specific an event listener produced an error after its target layer was removed from the map [#5145](https://github.com/mapbox/mapbox-gl-js/issues/5145)
- Fix `Marker#togglePopup()` failing to return the marker instance [#5116](https://github.com/mapbox/mapbox-gl-js/issues/5116)
- Fix bug wherein a marker's position failed to adapt to the marker element's size changing [#5133](https://github.com/mapbox/mapbox-gl-js/issues/5133)
- Fix rendering bug affecting Broadcom GPUs [#5073](https://github.com/mapbox/mapbox-gl-js/pull/5073)

### :wrench: Development workflow improvements

- Add (and now require) Flow type annotations throughout the majority of the codebase.
- Migrate to CircleCI 2.0 [#4939](https://github.com/mapbox/mapbox-gl-js/pull/4939)

## 0.39.1 (July 24, 2017)

### :bug: Bug fixes

- Fix packaging issue in 0.39.0 [#5025](https://github.com/mapbox/mapbox-gl-js/issues/5025)
- Correctly evaluate enum-based identity functions [#5023](https://github.com/mapbox/mapbox-gl-js/issues/5023)

## 0.39.0 (July 21, 2017)

### :warning: Breaking changes

- `GeolocateControl` breaking changes [#4479](https://github.com/mapbox/mapbox-gl-js/pull/4479)
    - The option `watchPosition` has been replaced with `trackUserLocation`
    - The camera operation has changed from `jumpTo` (not animated) to `fitBounds` (animated). An effect of this is the map pitch is no longer reset, although the bearing is still reset to 0.
    - The accuracy of the geolocation provided by the device is used to set the view (previously it was fixed at zoom level 17). The `maxZoom` can be controlled via the new `fitBoundsOptions` option (defaults to 15).
- Anchor `Marker`s at their center by default [#5019](https://github.com/mapbox/mapbox-gl-js/issues/5019) [@andrewharvey](https://github.com/andrewharvey)
- Increase `significantRotateThreshold` for the `TouchZoomRotateHandler` [#4971](https://github.com/mapbox/mapbox-gl-js/pull/4971), [@dagjomar](https://github.com/dagjomar)

### :sparkles: Features and improvements

- Improve performance of updating GeoJSON sources [#4069](https://github.com/mapbox/mapbox-gl-js/pull/4069), [@ezheidtmann](https://github.com/ezheidtmann)
- Improve rendering speed of extrusion layers [#4818](https://github.com/mapbox/mapbox-gl-js/pull/4818)
- Improve line label legibility in pitched views [#4781](https://github.com/mapbox/mapbox-gl-js/pull/4781)
- Improve line label legibility on curved lines [#4853](https://github.com/mapbox/mapbox-gl-js/pull/4853)
- Add user location tracking capability to `GeolocateControl` [#4479](https://github.com/mapbox/mapbox-gl-js/pull/4479), [@andrewharvey](https://github.com/andrewharvey)
    - New option `showUserLocation` to draw a "dot" as a `Marker` on the map at the user's location
    - An active lock and background state are introduced with `trackUserLocation`. When in active lock the camera will update to follow the user location, however if the camera is changed by the API or UI then the control will enter the background state where it won't update the camera to follow the user location.
    - New option `fitBoundsOptions` to control the camera operation
    - New `trackuserlocationstart` and `trackuserlocationend` events
    - New `LngLat.toBounds` method to extend a point location by a given radius to a `LngLatBounds` object
- Include main CSS file in `package.json` [#4809](https://github.com/mapbox/mapbox-gl-js/pull/4809), [@tomscholz](https://github.com/tomscholz)
- Add property function (data-driven styling) support for `line-width` [#4773](https://github.com/mapbox/mapbox-gl-js/pull/4773)
- Add property function (data-driven styling) support for `text-anchor` [#4997](https://github.com/mapbox/mapbox-gl-js/pull/4997)
- Add property function (data-driven styling) support for `text-justify` [#5000](https://github.com/mapbox/mapbox-gl-js/pull/5000)
- Add `maxTileCacheSize` option [#4778](https://github.com/mapbox/mapbox-gl-js/pull/4778), [@jczaplew](https://github.com/jczaplew)
- Add new `icon-pitch-alignment` and `circle-pitch-alignment` properties [#4869](https://github.com/mapbox/mapbox-gl-js/pull/4869) [#4871](https://github.com/mapbox/mapbox-gl-js/pull/4871)
- Add `Map#getMaxBounds` method [#4890](https://github.com/mapbox/mapbox-gl-js/pull/4890), [@andrewharvey](https://github.com/andrewharvey) [@lamuertepeluda](https://github.com/lamuertepeluda)
- Add option (`localIdeographFontFamily`) to use TinySDF to avoid loading expensive CJK glyphs [#4895](https://github.com/mapbox/mapbox-gl-js/pull/4895)
- If `config.API_URL` includes a path prepend it to the request URL [#4995](https://github.com/mapbox/mapbox-gl-js/pull/4995)
- Bump `supercluster` version to expose `cluster_id` property on clustered sources [#5002](https://github.com/mapbox/mapbox-gl-js/pull/5002)

### :bug: Bug fixes

- Do not display `FullscreenControl` on unsupported devices [#4838](https://github.com/mapbox/mapbox-gl-js/pull/4838), [@stepankuzmin](https://github.com/stepankuzmin)
- Fix yarn build on Windows machines [#4887](https://github.com/mapbox/mapbox-gl-js/pull/4887)
- Prevent potential memory leaks by dispatching `loadData` to the same worker every time [#4877](https://github.com/mapbox/mapbox-gl-js/pull/4877)
- Fix bug preventing the rtlTextPlugin from loading before the initial style `load` [#4870](https://github.com/mapbox/mapbox-gl-js/pull/4870)
- Fix bug causing runtime-stying to not take effect in some situations [#4893](https://github.com/mapbox/mapbox-gl-js/pull/4893)
- Prevent requests of vertical glyphs for labels that can't be verticalized [#4720](https://github.com/mapbox/mapbox-gl-js/issues/4720)
- Fix character detection for Zanabazar Square [#4940](https://github.com/mapbox/mapbox-gl-js/pull/4940)
- Fix `LogoControl` logic to update correctly, and hide the `<div>` instead of removing it from the DOM when it is not needed [#4842](https://github.com/mapbox/mapbox-gl-js/pull/4842)
- Fix `GeoJSONSource#serialize` to include all options
- Fix error handling in `GlyphSource#getSimpleGlyphs`[#4992](https://github.com/mapbox/mapbox-gl-js/pull/4992)
- Fix bug causing `setStyle` to reload raster tiles [#4852](https://github.com/mapbox/mapbox-gl-js/pull/4852)
- Fix bug causing symbol layers not to render on devices with non-integer device pixel ratios [#4989](https://github.com/mapbox/mapbox-gl-js/pull/4989)
- Fix bug where `Map#queryRenderedFeatures` would error when returning no results [#4993](https://github.com/mapbox/mapbox-gl-js/pull/4993)
- Fix bug where `Map#areTilesLoaded` would always be false on `sourcedata` events for reloading tiles [#4987](https://github.com/mapbox/mapbox-gl-js/pull/4987)
- Fix bug causing categorical property functions to error on non-ascending order stops [#4996](https://github.com/mapbox/mapbox-gl-js/pull/4996)

### :hammer_and_wrench: Development workflow changes

- Use flow to type much of the code base [#4629](https://github.com/mapbox/mapbox-gl-js/pull/4629) [#4903](https://github.com/mapbox/mapbox-gl-js/pull/4903) [#4909](https://github.com/mapbox/mapbox-gl-js/pull/4909) [#4910](https://github.com/mapbox/mapbox-gl-js/pull/4910) [#4911](https://github.com/mapbox/mapbox-gl-js/pull/4911) [#4913](https://github.com/mapbox/mapbox-gl-js/pull/4913) [#4915](https://github.com/mapbox/mapbox-gl-js/pull/4915) [#4918](https://github.com/mapbox/mapbox-gl-js/pull/4918) [#4932](https://github.com/mapbox/mapbox-gl-js/pull/4932) [#4933](https://github.com/mapbox/mapbox-gl-js/pull/4933) [#4948](https://github.com/mapbox/mapbox-gl-js/pull/4948) [#4949](https://github.com/mapbox/mapbox-gl-js/pull/4949) [#4955](https://github.com/mapbox/mapbox-gl-js/pull/4955) [#4966](https://github.com/mapbox/mapbox-gl-js/pull/4966) [#4967](https://github.com/mapbox/mapbox-gl-js/pull/4967) [#4973](https://github.com/mapbox/mapbox-gl-js/pull/4973) :muscle: [@jfirebaugh](https://github.com/jfirebaugh) [@vicapow](https://github.com/vicapow)
- Use style specification to generate flow type [#4958](https://github.com/mapbox/mapbox-gl-js/pull/4958)
- Explicitly list which files to publish in `package.json` [#4819](https://github.com/mapbox/mapbox-gl-js/pull/4819) [@tomscholz](https://github.com/tomscholz)
- Move render test ignores to a separate file [#4977](https://github.com/mapbox/mapbox-gl-js/pull/4977)
- Add code of conduct [#5015](https://github.com/mapbox/mapbox-gl-js/pull/5015) :sparkling_heart:

## 0.38.0 (June 9, 2017)

#### New features :sparkles:

- Attenuate label size scaling with distance, improving readability of pitched maps [#4547](https://github.com/mapbox/mapbox-gl-js/pull/4547)

#### Bug fixes :beetle:

- Skip rendering for patterned layers when pattern is missing [#4687](https://github.com/mapbox/mapbox-gl-js/pull/4687)
- Fix bug with map failing to rerender after `webglcontextlost` event [#4725](https://github.com/mapbox/mapbox-gl-js/pull/4725) [@cdawi](https://github.com/cdawi)
- Clamp zoom level in `flyTo` to within the map's specified min- and maxzoom to prevent undefined behavior [#4726](https://github.com/mapbox/mapbox-gl-js/pull/4726) [@](https://github.com/) IvanSanchez
- Fix wordmark rendering in IE [#4741](https://github.com/mapbox/mapbox-gl-js/pull/4741)
- Fix slight pixelwise symbol rendering bugs caused by incorrect sprite calculations [#4737](https://github.com/mapbox/mapbox-gl-js/pull/4737)
- Prevent exceptions thrown by certain `flyTo` calls [#4761](https://github.com/mapbox/mapbox-gl-js/pull/4761)
- Fix "Improve this map" link [#4685](https://github.com/mapbox/mapbox-gl-js/pull/4685)
- Tweak `queryRenderedSymbols` logic to better account for pitch scaling [#4792](https://github.com/mapbox/mapbox-gl-js/pull/4792)
- Fix for symbol layers sometimes failing to render, most frequently in Safari [#4795](https://github.com/mapbox/mapbox-gl-js/pull/4795)
- Apply `text-keep-upright` after `text-offset` to keep labels upright when intended [#4779](https://github.com/mapbox/mapbox-gl-js/pull/4779) **[Potentially breaking :warning: but considered a bugfix]**
- Prevent exceptions thrown by empty GeoJSON tiles [#4803](https://github.com/mapbox/mapbox-gl-js/pull/4803)

#### Accessibility improvements :sound:

- Add `aria-label` to popup close button [#4799](https://github.com/mapbox/mapbox-gl-js/pull/4799) [@andrewharvey](https://github.com/andrewharvey)

#### Development workflow + testing improvements :wrench:

- Fix equality assertion bug in tests [#4731](https://github.com/mapbox/mapbox-gl-js/pull/4731) [@IvanSanchez](https://github.com/IvanSanchez)
- Benchmark results page improvements [#4746](https://github.com/mapbox/mapbox-gl-js/pull/4746)
- Require node version >=6.4.0, enabling the use of more ES6 features [#4752](https://github.com/mapbox/mapbox-gl-js/pull/4752)
- Document missing `pitchWithRotate` option [#4800](https://github.com/mapbox/mapbox-gl-js/pull/4800) [@simast](https://github.com/simast)
- Move Github-specific Markdown files into subdirectory [#4806](https://github.com/mapbox/mapbox-gl-js/pull/4806) [@tomscholz](https://github.com/tomscholz)

## 0.37.0 (May 2nd, 2017)

#### :warning: Breaking changes

- Removed `LngLat#wrapToBestWorld`

#### New features :rocket:

- Improve popup/marker positioning [#4577](https://github.com/mapbox/mapbox-gl-js/pull/4577)
- Add `Map#isStyleLoaded` and `Map#areTilesLoaded` events [#4321](https://github.com/mapbox/mapbox-gl-js/pull/4321)
- Support offline sprites using `file:` protocol [#4649](https://github.com/mapbox/mapbox-gl-js/pull/4649) [@oscarfonts](https://github.com/oscarfonts)

#### Bug fixes :bug:

- Fix fullscreen control in Firefox [#4666](https://github.com/mapbox/mapbox-gl-js/pull/4666)
- Fix rendering artifacts that caused tile boundaries to be visible in some cases [#4636](https://github.com/mapbox/mapbox-gl-js/pull/4636)
- Fix default calculation for categorical zoom-and-property functions [#4657](https://github.com/mapbox/mapbox-gl-js/pull/4657)
- Fix scaling of images on retina screens [#4645](https://github.com/mapbox/mapbox-gl-js/pull/4645)
- Rendering error when a transparent image is added via `Map#addImage` [#4644](https://github.com/mapbox/mapbox-gl-js/pull/4644)
- Fix an issue with rendering lines with duplicate points [#4634](https://github.com/mapbox/mapbox-gl-js/pull/4634)
- Fix error when switching from data-driven styles to a constant paint value [#4611](https://github.com/mapbox/mapbox-gl-js/pull/4611)
- Add check to make sure invalid bounds on tilejson don't error out [#4641](https://github.com/mapbox/mapbox-gl-js/pull/4641)

#### Development workflow improvements :computer:

- Add flowtype interfaces and definitions [@vicapow](https://github.com/vicapow)
- Add stylelinting to ensure `mapboxgl-` prefix on all classes [#4584](https://github.com/mapbox/mapbox-gl-js/pull/4584) [@asantos3026](https://github.com/asantos3026)

## 0.36.0 (April 19, 2017)

#### New features :sparkles:

- Replace LogoControl logo with the new Mapbox logo [#4598](https://github.com/mapbox/mapbox-gl-js/pull/4598)

#### Bug fixes :bug:

- Fix bug with the BoxZoomHandler that made it glitchy if it is enabled after the DragPanHandler [#4528](https://github.com/mapbox/mapbox-gl-js/pull/4528)
- Fix undefined behavior in `fill_outline` shaders [#4600](https://github.com/mapbox/mapbox-gl-js/pull/4600)
- Fix `Camera#easeTo` interpolation on pitched maps [#4540](https://github.com/mapbox/mapbox-gl-js/pull/4540)
- Choose property function interpolation method by the `property`'s type [#4614](https://github.com/mapbox/mapbox-gl-js/pull/4614)

#### Development workflow improvements :nerd_face:

- Fix crash on missing `style.json` in integration tests
- `gl-style-composite` is now executable in line with the other tools [@andrewharvey](https://github.com/andrewharvey) [#4595](https://github.com/mapbox/mapbox-gl-js/pull/4595)
- `gl-style-composite` utility now throws an error if a name conflict would occur between layers [@andrewharvey](https://github.com/andrewharvey) [#4595](https://github.com/mapbox/mapbox-gl-js/pull/4595)

## 0.35.1 (April 12, 2017)

#### Bug fixes :bug:

- Add `.json` extension to style-spec `require` statements for webpack compatibility [#4563](https://github.com/mapbox/mapbox-gl-js/pull/4563) [@orangemug](https://github.com/orangemug)
- Fix documentation type for `Map#fitBounde` [#4569](https://github.com/mapbox/mapbox-gl-js/pull/4569) [@andrewharvey](https://github.com/andrewharvey)
- Fix bug causing {Image,Video,Canvas}Source to throw exception if latitude is outside of +/-85.05113 [#4574](https://github.com/mapbox/mapbox-gl-js/pull/4574)
- Fix bug causing overzoomed raster tiles to disappear from map [#4567](https://github.com/mapbox/mapbox-gl-js/pull/4567)
- Fix bug causing queryRenderedFeatures to crash on polygon features that have an `id` field. [#4581](https://github.com/mapbox/mapbox-gl-js/pull/4581)

## 0.35.0 (April 7, 2017)

#### New features :rocket:

- Use anisotropic filtering to improve rendering of raster tiles on pitched maps [#1064](https://github.com/mapbox/mapbox-gl-js/issues/1064)
- Add `pitchstart` and `pitchend` events [#2449](https://github.com/mapbox/mapbox-gl-js/issues/2449)
- Add an optional `layers` parameter to `Map#on` [#1002](https://github.com/mapbox/mapbox-gl-js/issues/1002)
- Add data-driven styling support for `text-offset` [#4495](https://github.com/mapbox/mapbox-gl-js/pull/4495)
- Add data-driven styling support for `text-rotate` [#3516](https://github.com/mapbox/mapbox-gl-js/issues/3516)
- Add data-driven styling support for `icon-image` [#4304](https://github.com/mapbox/mapbox-gl-js/issues/4304)
- Add data-driven styling support for `{text,icon}-size` [#4455](https://github.com/mapbox/mapbox-gl-js/pull/4455)

#### Bug fixes :bug:

- Suppress error messages in JS console due to missing tiles [#1800](https://github.com/mapbox/mapbox-gl-js/issues/1800)
- Fix bug wherein `GeoJSONSource#setData()` could cause unnecessary DOM updates [#4447](https://github.com/mapbox/mapbox-gl-js/issues/4447)
- Fix bug wherein `Map#flyTo` did not respect the `renderWorldCopies` setting [#4449](https://github.com/mapbox/mapbox-gl-js/issues/4449)
- Fix regression in browserify support # 4453
- Fix bug causing poor touch event behavior on mobile devices [#4259](https://github.com/mapbox/mapbox-gl-js/issues/4259)
- Fix bug wherein duplicate stops in property functions could cause an infinite loop [#4498](https://github.com/mapbox/mapbox-gl-js/issues/4498)
- Respect image height/width in `addImage` api [#4531](https://github.com/mapbox/mapbox-gl-js/pull/4531)
- Fix bug preventing correct behavior of `shift+zoom` [#3334](https://github.com/mapbox/mapbox-gl-js/issues/3334)
- Fix bug preventing image source from rendering when coordinate area is too large [#4550](https://github.com/mapbox/mapbox-gl-js/issues/4550)
- Show image source on horizontally wrapped worlds [#4555](https://github.com/mapbox/mapbox-gl-js/pull/4555)
- Fix bug in the handling of `refreshedExpiredTiles` option [#4549](https://github.com/mapbox/mapbox-gl-js/pull/4549)
- Support the TileJSON `bounds` property [#1775](https://github.com/mapbox/mapbox-gl-js/issues/1775)

#### Development workflow improvements :computer:

- Upgrade flow to 0.42.0 ([#4500](https://github.com/mapbox/mapbox-gl-js/pull/4500))

## 0.34.0 (March 17, 2017)

#### New features :rocket:

- Add `Map#addImage` and `Map#removeImage` API to allow adding icon images at runtime [#4404](https://github.com/mapbox/mapbox-gl-js/pull/4404)
- Simplify non-browserify bundler usage by making the distribution build the main entrypoint [#4423](https://github.com/mapbox/mapbox-gl-js/pull/4423)

#### Bug fixes :bug:

- Fix issue where coincident start/end points of LineStrings were incorrectly rendered as joined [#4413](https://github.com/mapbox/mapbox-gl-js/pull/4413)
- Fix bug causing `queryRenderedFeatures` to fail in cases where both multiple sources and data-driven paint properties were present [#4417](https://github.com/mapbox/mapbox-gl-js/issues/4417)
- Fix bug where tile request errors caused `map.loaded()` to incorrectly return `false` [#4425](https://github.com/mapbox/mapbox-gl-js/issues/4425)

#### Testing improvements :white_check_mark:

- Improve test coverage across several core modules [#4432](https://github.com/mapbox/mapbox-gl-js/pull/4432) [#4431](https://github.com/mapbox/mapbox-gl-js/pull/4431) [#4422](https://github.com/mapbox/mapbox-gl-js/pull/4422) [#4244](https://github.com/mapbox/mapbox-gl-js/pull/4244) :bowing_man:

## 0.33.1 (March 10, 2017)

#### Bug fixes :bug:

- Prevent Mapbox logo from being added to the map more than once [#4386](https://github.com/mapbox/mapbox-gl-js/pull/4386)
- Add `type='button'` to `FullscreenControl` to prevent button from acting as a form submit [#4397](https://github.com/mapbox/mapbox-gl-js/pull/4397)
- Fix issue where map would continue to rotate if `Ctrl` key is released before the click during a `DragRotate` event [#4389](https://github.com/mapbox/mapbox-gl-js/pull/4389)
- Remove double `options.easing` description from the `Map#fitBounds` documentation [#4402](https://github.com/mapbox/mapbox-gl-js/pull/4402)

## 0.33.0 (March 8, 2017)

#### :warning: Breaking changes

- Automatically add Mapbox wordmark when required by Mapbox TOS [#3933](https://github.com/mapbox/mapbox-gl-js/pull/3933)
- Increase default `maxZoom` from 20 to 22 [#4333](https://github.com/mapbox/mapbox-gl-js/pull/4333)
- Deprecate `tiledata` and `tiledataloading` events in favor of `sourcedata` and `sourcedataloading`. [#4347](https://github.com/mapbox/mapbox-gl-js/pull/4347)
- `mapboxgl.util` is no longer exported [#1408](https://github.com/mapbox/mapbox-gl-js/issues/1408)
- `"type": "categorical"` is now required for all categorical functions. Previously, some forms of "implicitly" categorical functions worked, and others did not. [#3717](https://github.com/mapbox/mapbox-gl-js/issues/3717)

#### :white_check_mark: New features

- Add property functions support for most symbol paint properties [#4074](https://github.com/mapbox/mapbox-gl-js/pull/4074), [#4186](https://github.com/mapbox/mapbox-gl-js/pull/4186), [#4226](https://github.com/mapbox/mapbox-gl-js/pull/4226)
- Add ability to specify default property value for undefined or invalid property values used in property functions. [#4175](https://github.com/mapbox/mapbox-gl-js/pull/4175)
- Improve `Map#fitBounds` to accept different values for top, bottom, left, and right `padding` [#3890](https://github.com/mapbox/mapbox-gl-js/pull/3890)
- Add a `FullscreenControl` for displaying a fullscreen map [#3977](https://github.com/mapbox/mapbox-gl-js/pull/3977)

#### :beetle: Bug fixes

- Fix validation error on categorical zoom-and-property functions [#4220](https://github.com/mapbox/mapbox-gl-js/pull/4220)
- Fix bug causing expired resources to be re-requested causing an infinite loop [#4255](https://github.com/mapbox/mapbox-gl-js/pull/4255)
- Fix problem where `MapDataEvent#isSourceLoaded` always returned false [#4254](https://github.com/mapbox/mapbox-gl-js/pull/4254)
- Resolve an issue where tiles in the source cache were prematurely deleted, resulting in tiles flickering when zooming in and out and [#4311](https://github.com/mapbox/mapbox-gl-js/pull/4311)
- Make sure `MapEventData` is passed through on calls `Map#flyTo` [#4342](https://github.com/mapbox/mapbox-gl-js/pull/4342)
- Fix incorrect returned values for `Map#isMoving` [#4350](https://github.com/mapbox/mapbox-gl-js/pull/4350)
- Fix categorical functions not allowing boolean stop domain values [#4195](https://github.com/mapbox/mapbox-gl-js/pull/4195)
- Fix piecewise-constant functions to allow non-integer zoom levels. [#4196](https://github.com/mapbox/mapbox-gl-js/pull/4196)
- Fix issues with `$id` in filters [#4236](https://github.com/mapbox/mapbox-gl-js/pull/4236) [#4237](https://github.com/mapbox/mapbox-gl-js/pull/4237)
- Fix a race condition with polygon centroid algorithm causing tiles not to load in some cases. [#4273](https://github.com/mapbox/mapbox-gl-js/pull/4273)
- Throw a meaningful error when giving non-array `layers` parameter to `queryRenderedFeatures` [#4331](https://github.com/mapbox/mapbox-gl-js/pull/4331)
- Throw a meaningful error when supplying invalid `minZoom` and `maxZoom` values [#4324](https://github.com/mapbox/mapbox-gl-js/pull/4324)
- Fix a memory leak when using the RTL Text plugin [#4248](https://github.com/mapbox/mapbox-gl-js/pull/4248)

#### Dev workflow changes

- Merged the [Mapbox GL style specification](https://github.com/mapbox/mapbox-gl-style-spec) repo to this one (now under `src/style-spec` and `test/unit/style-spec`).

## 0.32.1 (Jan 26, 2017)

#### Bug Fixes

- Fix bug causing [`mapbox-gl-rtl-text` plugin](https://github.com/mapbox/mapbox-gl-rtl-text) to not work [#4055](https://github.com/mapbox/mapbox-gl-js/pull/4055)

## 0.32.0 (Jan 26, 2017)

#### Deprecation Notices

- [Style classes](https://www.mapbox.com/mapbox-gl-style-spec/#layer-paint.*) are deprecated and will be removed in an upcoming release of Mapbox GL JS.

#### New Features

- Add `Map#isSourceLoaded` method [#4033](https://github.com/mapbox/mapbox-gl-js/pull/4033)
- Automatically reload tiles based on their `Expires` and `Cache-Control` HTTP headers [#3944](https://github.com/mapbox/mapbox-gl-js/pull/3944)
- Add `around=center` option to `scrollZoom` and `touchZoomRotate` interaction handlers [#3876](https://github.com/mapbox/mapbox-gl-js/pull/3876)
- Add support for [`mapbox-gl-rtl-text` plugin](https://github.com/mapbox/mapbox-gl-rtl-text) to support right-to-left scripts [#3758](https://github.com/mapbox/mapbox-gl-js/pull/3758)
- Add `canvas` source type [#3765](https://github.com/mapbox/mapbox-gl-js/pull/3765)
- Add `Map#isMoving` method [#2792](https://github.com/mapbox/mapbox-gl-js/issues/2792)

#### Bug Fixes

- Fix bug causing garbled text on zoom [#3962](https://github.com/mapbox/mapbox-gl-js/pull/3962)
- Fix bug causing crash in Firefox and Mobile Safari when rendering a large map [#4037](https://github.com/mapbox/mapbox-gl-js/pull/4037)
- Fix bug causing raster tiles to flicker during zoom [#2467](https://github.com/mapbox/mapbox-gl-js/issues/2467)
- Fix bug causing exception when unsetting and resetting fill-outline-color [#3657](https://github.com/mapbox/mapbox-gl-js/issues/3657)
- Fix memory leak when removing raster sources [#3951](https://github.com/mapbox/mapbox-gl-js/issues/3951)
- Fix bug causing exception when when zooming in / out on empty GeoJSON tile [#3985](https://github.com/mapbox/mapbox-gl-js/pull/3985)
- Fix line join artifacts at very sharp angles [#4008](https://github.com/mapbox/mapbox-gl-js/pull/4008)

## 0.31.0 (Jan 10 2017)

#### New Features

- Add `renderWorldCopies` option to the `Map` constructor to give users control over whether multiple worlds are rendered in a map [#3885](https://github.com/mapbox/mapbox-gl-js/pull/3885)

#### Bug Fixes

- Fix performance regression triggered when `Map` pitch or bearing is changed [#3938](https://github.com/mapbox/mapbox-gl-js/pull/3938)
- Fix null pointer exception caused by trying to clear an `undefined` source [#3903](https://github.com/mapbox/mapbox-gl-js/pull/3903)

#### Miscellaneous

- Incorporate integration tests formerly at [`mapbox-gl-test-suite`](https://github.com/mapbox/mapbox-gl-test-suite) into this repository [#3834](https://github.com/mapbox/mapbox-gl-js/pull/3834)

## 0.30.0 (Jan 5 2017)

#### New Features

- Fire an error when map canvas is larger than allowed by `gl.MAX_RENDERBUFFER_SIZE` [#2893](https://github.com/mapbox/mapbox-gl-js/issues/2893)
- Improve error messages when referencing a nonexistent layer id [#2597](https://github.com/mapbox/mapbox-gl-js/issues/2597)
- Fire an error when layer uses a `geojson` source and specifies a `source-layer` [#3896](https://github.com/mapbox/mapbox-gl-js/pull/3896)
- Add inline source declaration syntax [#3857](https://github.com/mapbox/mapbox-gl-js/issues/3857)
- Improve line breaking behavior [#3887](https://github.com/mapbox/mapbox-gl-js/issues/3887)

#### Performance Improvements

- Improve `Map#setStyle` performance in some cases [#3853](https://github.com/mapbox/mapbox-gl-js/pull/3853)

#### Bug Fixes

- Fix unexpected popup positioning when some offsets are unspecified [#3367](https://github.com/mapbox/mapbox-gl-js/issues/3367)
- Fix incorrect interpolation in functions [#3838](https://github.com/mapbox/mapbox-gl-js/issues/3838)
- Fix incorrect opacity when multiple backgrounds are rendered [#3819](https://github.com/mapbox/mapbox-gl-js/issues/3819)
- Fix exception thrown when instantiating geolocation control in Safari [#3844](https://github.com/mapbox/mapbox-gl-js/issues/3844)
- Fix exception thrown when setting `showTileBoundaries` with no sources [#3849](https://github.com/mapbox/mapbox-gl-js/issues/3849)
- Fix incorrect rendering of transparent parts of raster layers in some cases [#3723](https://github.com/mapbox/mapbox-gl-js/issues/3723)
- Fix non-terminating render loop when zooming in in some cases [#3399](https://github.com/mapbox/mapbox-gl-js/pull/3399)

## 0.29.0 (December 20 2016)

#### New Features

- Add support for property functions for many style properties on line layers [#3033](https://github.com/mapbox/mapbox-gl-js/pull/3033)
- Make `Map#setStyle` smoothly transition to the new style [#3621](https://github.com/mapbox/mapbox-gl-js/pull/3621)
- Add `styledata`, `sourcedata`, `styledataloading`, and `sourcedataloading` events
- Add `isSourceLoaded` and `source` properties to `MapDataEvent` [#3590](https://github.com/mapbox/mapbox-gl-js/pull/3590)
- Remove "max zoom" cap of 20 [#3683](https://github.com/mapbox/mapbox-gl-js/pull/3683)
- Add `circle-stroke-*` style properties [#3672](https://github.com/mapbox/mapbox-gl-js/pull/3672)
- Add a more helpful error message when the specified `container` element doesn't exist [#3719](https://github.com/mapbox/mapbox-gl-js/pull/3719)
- Add `watchPosition` option to `GeolocateControl` [#3739](https://github.com/mapbox/mapbox-gl-js/pull/3739)
- Add `positionOptions` option to `GeolocateControl` [#3739](https://github.com/mapbox/mapbox-gl-js/pull/3739)
- Add `aria-label` to map canvas [#3782](https://github.com/mapbox/mapbox-gl-js/pull/3782)
- Adjust multipoint symbol rendering behavior [#3763](https://github.com/mapbox/mapbox-gl-js/pull/3763)
- Add support for property functions for `icon-offset` [#3791](https://github.com/mapbox/mapbox-gl-js/pull/3791)
- Improved antialiasing on pitched lines [#3790](https://github.com/mapbox/mapbox-gl-js/pull/3790)
- Allow attribution control to collapse to an ⓘ button on smaller screens [#3783](https://github.com/mapbox/mapbox-gl-js/pull/3783)
- Improve line breaking algorithm [#3743](https://github.com/mapbox/mapbox-gl-js/pull/3743)

#### Performance Improvements

- Fix memory leak when calling `Map#removeSource` [#3602](https://github.com/mapbox/mapbox-gl-js/pull/3602)
- Reduce bundle size by adding custom build of `gl-matrix` [#3734](https://github.com/mapbox/mapbox-gl-js/pull/3734)
- Improve performance of projection code [#3721](https://github.com/mapbox/mapbox-gl-js/pull/3721)
- Improve performance of style function evaluation [#3816](https://github.com/mapbox/mapbox-gl-js/pull/3816)

#### Bug fixes

- Fix exception thrown when using `line-color` property functions [#3639](https://github.com/mapbox/mapbox-gl-js/issues/3639)
- Fix exception thrown when removing a layer and then adding another layer with the same id but different type [#3655](https://github.com/mapbox/mapbox-gl-js/pull/3655)
- Fix exception thrown when passing a single point to `Map#fitBounds` [#3655](https://github.com/mapbox/mapbox-gl-js/pull/3655)
- Fix exception thrown occasionally during rapid map mutations [#3681](https://github.com/mapbox/mapbox-gl-js/pull/3681)
- Fix rendering defects on pitch=0 on some systems [#3740](https://github.com/mapbox/mapbox-gl-js/pull/3740)
- Fix unnecessary CPU usage when displaying a raster layer [#3764](https://github.com/mapbox/mapbox-gl-js/pull/3764)
- Fix bug causing sprite after `Map#setStyle` [#3829](https://github.com/mapbox/mapbox-gl-js/pull/3829)
- Fix bug preventing `Map` from emitting a `contextmenu` event on Windows browsers [#3822](https://github.com/mapbox/mapbox-gl-js/pull/3822)

## 0.28.0 (November 17 2016)

#### New features and improvements

- Performance improvements for `Map#addLayer` and `Map#removeLayer` [#3584](https://github.com/mapbox/mapbox-gl-js/pull/3584)
- Add method for changing layer order at runtime - `Map#moveLayer` [#3584](https://github.com/mapbox/mapbox-gl-js/pull/3584)
- Update vertical punctuation logic to Unicode 9.0 standard [#3608](https://github.com/mapbox/mapbox-gl-js/pull/3608)

#### Bug fixes

- Fix data-driven `fill-opacity` rendering when using a `fill-pattern` [#3598](https://github.com/mapbox/mapbox-gl-js/pull/3598)
- Fix line rendering artifacts [#3627](https://github.com/mapbox/mapbox-gl-js/pull/3627)
- Fix incorrect rendering of opaque fills on top of transparent fills [#2628](https://github.com/mapbox/mapbox-gl-js/pull/2628)
- Prevent `AssertionErrors` from pitching raster layers by only calling `Worker#redoPlacement` on vector and GeoJSON sources [#3624](https://github.com/mapbox/mapbox-gl-js/pull/3624)
- Restore IE11 compatibility [#3635](https://github.com/mapbox/mapbox-gl-js/pull/3635)
- Fix symbol placement for cached tiles [#3637](https://github.com/mapbox/mapbox-gl-js/pull/3637)

## 0.27.0 (November 11 2016)

#### ⚠️ Breaking changes ⚠️

- Replace `fill-extrude-height` and `fill-extrude-base` properties of `fill` render type with a separate `fill-extrusion` type (with corresponding `fill-extrusion-height` and `fill-extrusion-base` properties), solving problems with render parity and runtime switching between flat and extruded fills. https://github.com/mapbox/mapbox-gl-style-spec/issues/554
- Change the units for extrusion height properties (`fill-extrusion-height`, `fill-extrusion-base`) from "magic numbers" to meters. [#3509](https://github.com/mapbox/mapbox-gl-js/pull/3509)
- Remove `mapboxgl.Control` class and change the way custom controls should be implemented. [#3497](https://github.com/mapbox/mapbox-gl-js/pull/3497)
- Remove `mapboxgl.util` functions: `inherit`, `extendAll`, `debounce`, `coalesce`, `startsWith`, `supportsGeolocation`. [#3441](https://github.com/mapbox/mapbox-gl-js/pull/3441) [#3571](https://github.com/mapbox/mapbox-gl-js/pull/3571)
- **`mapboxgl.util` is deprecated** and will be removed in the next release. [#1408](https://github.com/mapbox/mapbox-gl-js/issues/1408)

#### New features and improvements

- Tons of **performance improvements** that combined make rendering **up to 3 times faster**, especially for complex styles. [#3485](https://github.com/mapbox/mapbox-gl-js/pull/3485) [#3489](https://github.com/mapbox/mapbox-gl-js/pull/3489) [#3490](https://github.com/mapbox/mapbox-gl-js/pull/3490) [#3491](https://github.com/mapbox/mapbox-gl-js/pull/3491) [#3498](https://github.com/mapbox/mapbox-gl-js/pull/3498) [#3499](https://github.com/mapbox/mapbox-gl-js/pull/3499) [#3501](https://github.com/mapbox/mapbox-gl-js/pull/3501) [#3510](https://github.com/mapbox/mapbox-gl-js/pull/3510) [#3514](https://github.com/mapbox/mapbox-gl-js/pull/3514) [#3515](https://github.com/mapbox/mapbox-gl-js/pull/3515) [#3486](https://github.com/mapbox/mapbox-gl-js/pull/3486) [#3527](https://github.com/mapbox/mapbox-gl-js/pull/3527) [#3574](https://github.com/mapbox/mapbox-gl-js/pull/3574) ⚡️⚡️⚡️
- 🈯 Added **vertical text writing mode** for languages that support it. [#3438](https://github.com/mapbox/mapbox-gl-js/pull/3438)
- 🈯 Improved **line breaking of Chinese and Japanese text** in point-placed labels. [#3420](https://github.com/mapbox/mapbox-gl-js/pull/3420)
- Reduce the default number of worker threads (`mapboxgl.workerCount`) for better performance. [#3565](https://github.com/mapbox/mapbox-gl-js/pull/3565)
- Automatically use `categorical` style function type when input values are strings. [#3384](https://github.com/mapbox/mapbox-gl-js/pull/3384)
- Improve control buttons accessibility. [#3492](https://github.com/mapbox/mapbox-gl-js/pull/3492)
- Remove geolocation button if geolocation is disabled (e.g. the page is not served through `https`). [#3571](https://github.com/mapbox/mapbox-gl-js/pull/3571)
- Added `Map#getMaxZoom` and `Map#getMinZoom` methods [#3592](https://github.com/mapbox/mapbox-gl-js/pull/3592)

#### Bugfixes

- Fix several line dash rendering bugs. [#3451](https://github.com/mapbox/mapbox-gl-js/pull/3451)
- Fix intermittent map flicker when using image sources. [#3522](https://github.com/mapbox/mapbox-gl-js/pull/3522)
- Fix incorrect rendering of semitransparent `background` layers. [#3521](https://github.com/mapbox/mapbox-gl-js/pull/3521)
- Fix broken `raster-fade-duration` property. [#3532](https://github.com/mapbox/mapbox-gl-js/pull/3532)
- Fix handling of extrusion heights with negative values (by clamping to `0`). [#3463](https://github.com/mapbox/mapbox-gl-js/pull/3463)
- Fix GeoJSON sources not placing labels/icons correctly after map rotation. [#3366](https://github.com/mapbox/mapbox-gl-js/pull/3366)
- Fix icon/label placement not respecting order for layers with numeric names. [#3404](https://github.com/mapbox/mapbox-gl-js/pull/3404)
- Fix `queryRenderedFeatures` working incorrectly on colliding labels. [#3459](https://github.com/mapbox/mapbox-gl-js/pull/3459)
- Fix a bug where changing extrusion properties at runtime sometimes threw an error. [#3487](https://github.com/mapbox/mapbox-gl-js/pull/3487) [#3468](https://github.com/mapbox/mapbox-gl-js/pull/3468)
- Fix a bug where `map.loaded()` always returned `true` when using raster tile sources. [#3302](https://github.com/mapbox/mapbox-gl-js/pull/3302)
- Fix a bug where moving the map out of bounds sometimes threw `failed to invert matrix` error. [#3518](https://github.com/mapbox/mapbox-gl-js/pull/3518)
- Fixed `queryRenderedFeatures` throwing an error if no parameters provided. [#3542](https://github.com/mapbox/mapbox-gl-js/pull/3542)
- Fixed a bug where using multiple `\n` in a text field resulted in an error. [#3570](https://github.com/mapbox/mapbox-gl-js/pull/3570)

#### Misc

- 🐞 Fix `npm install mapbox-gl` pulling in all `devDependencies`, leading to an extremely slow install. [#3377](https://github.com/mapbox/mapbox-gl-js/pull/3377)
- Switch the codebase to ES6. [#c](https://github.com/mapbox/mapbox-gl-js/pull/3388) [#3408](https://github.com/mapbox/mapbox-gl-js/pull/3408) [#3415](https://github.com/mapbox/mapbox-gl-js/pull/3415) [#3421](https://github.com/mapbox/mapbox-gl-js/pull/3421)
- A lot of internal refactoring to make the codebase simpler and more maintainable.
- Various documentation fixes. [#3440](https://github.com/mapbox/mapbox-gl-js/pull/3440)

## 0.26.0 (October 13 2016)

#### New Features & Improvements

- Add `fill-extrude-height` and `fill-extrude-base` style properties (3d buildings) :cityscape: [#3223](https://github.com/mapbox/mapbox-gl-js/pull/3223)
- Add customizable `colorSpace` interpolation to functions [#3245](https://github.com/mapbox/mapbox-gl-js/pull/3245)
- Add `identity` function type [#3274](https://github.com/mapbox/mapbox-gl-js/pull/3274)
- Add depth testing for symbols with `'pitch-alignment': 'map'` [#3243](https://github.com/mapbox/mapbox-gl-js/pull/3243)
- Add `dataloading` events for styles and sources [#3306](https://github.com/mapbox/mapbox-gl-js/pull/3306)
- Add `Control` suffix to all controls :warning: BREAKING CHANGE :warning: [#3355](https://github.com/mapbox/mapbox-gl-js/pull/3355)
- Calculate style layer `ref`s automatically and get rid of user-specified `ref`s :warning: BREAKING CHANGE :warning: [#3486](https://github.com/mapbox/mapbox-gl-js/pull/3486)

#### Performance Improvements

- Ensure removing style or source releases all tile resources [#3359](https://github.com/mapbox/mapbox-gl-js/pull/3359)

#### Bugfixes

- Fix bug causing an error when `Marker#setLngLat` is called [#3294](https://github.com/mapbox/mapbox-gl-js/pull/3294)
- Fix bug causing incorrect coordinates in `touchend` on Android Chrome [#3319](https://github.com/mapbox/mapbox-gl-js/pull/3319)
- Fix bug causing incorrect popup positioning at top of screen [#3333](https://github.com/mapbox/mapbox-gl-js/pull/3333)
- Restore `tile` property to `data` events fired when a tile is removed [#3328](https://github.com/mapbox/mapbox-gl-js/pull/3328)
- Fix bug causing "Improve this map" link to not preload map location [#3356](https://github.com/mapbox/mapbox-gl-js/pull/3356)

## 0.25.1 (September 30 2016)

#### Bugfixes

- Fix bug causing attribution to not be shown [#3278](https://github.com/mapbox/mapbox-gl-js/pull/3278)
- Fix bug causing exceptions when symbol text has a trailing newline [#3281](https://github.com/mapbox/mapbox-gl-js/pull/3281)

## 0.25.0 (September 29 2016)

#### Breaking Changes

- `Evented#off` now require two arguments; omitting the second argument in order to unbind all listeners for an event
  type is no longer supported, as it could cause unintended unbinding of internal listeners.

#### New Features & Improvements

- Consolidate undocumented data lifecycle events into `data` and `dataloading` events ([#3255](https://github.com/mapbox/mapbox-gl-js/pull/3255))
- Add `auto` value for style spec properties ([#3203](https://github.com/mapbox/mapbox-gl-js/pull/3203))

#### Bugfixes

- Fix bug causing "Map#queryRenderedFeatures" to return no features after map rotation or filter change ([#3233](https://github.com/mapbox/mapbox-gl-js/pull/3233))
- Change webpack build process ([#3235](https://github.com/mapbox/mapbox-gl-js/pull/3235)) :warning: BREAKING CHANGE :warning:
- Improved error messages for `LngLat#convert` ([#3232](https://github.com/mapbox/mapbox-gl-js/pull/3232))
- Fix bug where the `tiles` field is omitted from the `RasterTileSource#serialize` method ([#3259](https://github.com/mapbox/mapbox-gl-js/pull/3259))
- Comply with HTML spec by replacing the `div` within the `Navigation` control `<button>` with a `span` element ([#3268](https://github.com/mapbox/mapbox-gl-js/pull/3268))
- Fix bug causing `Marker` instances to be translated to non-whole pixel coordinates that caused blurriness ([#3270](https://github.com/mapbox/mapbox-gl-js/pull/3270))

#### Performance Improvements

- Avoid unnecessary style validation ([#3224](https://github.com/mapbox/mapbox-gl-js/pull/3224))
- Share a single blob URL between all workers ([#3239](https://github.com/mapbox/mapbox-gl-js/pull/3239))

## 0.24.0 (September 19 2016)

#### New Features & Improvements

- Allow querystrings in `mapbox://` URLs [#3113](https://github.com/mapbox/mapbox-gl-js/issues/3113)
- Allow "drag rotate" interaction to control pitch [#3105](https://github.com/mapbox/mapbox-gl-js/pull/3105)
- Improve performance by decreasing `Worker` script `Blob` size [#3158](https://github.com/mapbox/mapbox-gl-js/pull/3158)
- Improve vector tile performance [#3067](https://github.com/mapbox/mapbox-gl-js/pull/3067)
- Decrease size of distributed library by removing `package.json` [#3174](https://github.com/mapbox/mapbox-gl-js/pull/3174)
- Add support for new lines in `text-field` [#3179](https://github.com/mapbox/mapbox-gl-js/pull/3179)
- Make keyboard navigation smoother [#3190](https://github.com/mapbox/mapbox-gl-js/pull/3190)
- Make mouse wheel zooming smoother [#3189](https://github.com/mapbox/mapbox-gl-js/pull/3189)
- Add better error message when calling `Map#queryRenderedFeatures` on nonexistent layer [#3196](https://github.com/mapbox/mapbox-gl-js/pull/3196)
- Add support for imperial units on `Scale` control [#3160](https://github.com/mapbox/mapbox-gl-js/pull/3160)
- Add map's pitch to URL hash [#3218](https://github.com/mapbox/mapbox-gl-js/pull/3218)

#### Bugfixes

- Fix exception thrown when using box zoom handler [#3078](https://github.com/mapbox/mapbox-gl-js/pull/3078)
- Ensure style filters cannot be mutated by reference [#3093](https://github.com/mapbox/mapbox-gl-js/pull/3093)
- Fix exceptions thrown when opening marker-bound popup by click [#3104](https://github.com/mapbox/mapbox-gl-js/pull/3104)
- Fix bug causing fills with transparent colors and patterns to not render [#3107](https://github.com/mapbox/mapbox-gl-js/issues/3107)
- Fix order of latitudes in `Map#getBounds` [#3081](https://github.com/mapbox/mapbox-gl-js/issues/3081)
- Fix incorrect evaluation of zoom-and-property functions [#2827](https://github.com/mapbox/mapbox-gl-js/issues/2827) [#3155](https://github.com/mapbox/mapbox-gl-js/pull/3155)
- Fix incorrect evaluation of property functions [#2828](https://github.com/mapbox/mapbox-gl-js/issues/2828) [#3155](https://github.com/mapbox/mapbox-gl-js/pull/3155)
- Fix bug causing garbled text rendering when multiple maps are rendered on the page [#3086](https://github.com/mapbox/mapbox-gl-js/issues/3086)
- Fix rendering defects caused by `Map#setFilter` and map rotation on iOS 10 [#3207](https://github.com/mapbox/mapbox-gl-js/pull/3207)
- Fix bug causing image and video sources to disappear when zooming in [#3010](https://github.com/mapbox/mapbox-gl-js/issues/3010)

## 0.23.0 (August 25 2016)

#### New Features & Improvements

- Add support for `line-color` property functions [#2938](https://github.com/mapbox/mapbox-gl-js/pull/2938)
- Add `Scale` control [#2940](https://github.com/mapbox/mapbox-gl-js/pull/2940) [#3042](https://github.com/mapbox/mapbox-gl-js/pull/3042)
- Improve polygon label placement by rendering labels at the pole of inaccessibility [#3038](https://github.com/mapbox/mapbox-gl-js/pull/3038)
- Add `Popup` `offset` option [#1962](https://github.com/mapbox/mapbox-gl-js/issues/1962)
- Add `Marker#bindPopup` method [#3056](https://github.com/mapbox/mapbox-gl-js/pull/3056)

#### Performance Improvements

- Improve performance of pages with multiple maps using a shared `WebWorker` pool [#2952](https://github.com/mapbox/mapbox-gl-js/pull/2952)

#### Bugfixes

- Make `LatLngBounds` obey its documented argument order (`southwest`, `northeast`), allowing bounds across the dateline [#2414](https://github.com/mapbox/mapbox-gl-js/pull/2414) :warning: **BREAKING CHANGE** :warning:
- Fix bug causing `fill-opacity` property functions to not render as expected [#3061](https://github.com/mapbox/mapbox-gl-js/pull/3061)

## 0.22.1 (August 18 2016)

#### New Features & Improvements

- Reduce library size by using minified version of style specification [#2998](https://github.com/mapbox/mapbox-gl-js/pull/2998)
- Add a warning when rendering artifacts occur due to too many symbols or glyphs being rendered in a tile [#2966](https://github.com/mapbox/mapbox-gl-js/pull/2966)

#### Bugfixes

- Fix bug causing exception to be thrown by `Map#querySourceFeatures` [#3022](https://github.com/mapbox/mapbox-gl-js/pull/3022)
- Fix bug causing `Map#loaded` to return true while there are outstanding tile updates [#2847](https://github.com/mapbox/mapbox-gl-js/pull/2847)

## 0.22.0 (August 11 2016)

#### Breaking Changes

- The `GeoJSONSource`, `VideoSource`, `ImageSource` constructors are now private. Please use `map.addSource({...})` to create sources and `map.getSource(...).setData(...)` to update GeoJSON sources. [#2667](https://github.com/mapbox/mapbox-gl-js/pull/2667)
- `Map#onError` has been removed. You may catch errors by listening for the `error` event. If no listeners are bound to `error`, error messages will be printed to the console. [#2852](https://github.com/mapbox/mapbox-gl-js/pull/2852)

#### New Features & Improvements

- Increase max glyph atlas size to accommodate alphabets with large numbers of characters [#2930](https://github.com/mapbox/mapbox-gl-js/pull/2930)
- Add support for filtering features on GeoJSON / vector tile `$id` [#2888](https://github.com/mapbox/mapbox-gl-js/pull/2888)
- Update geolocate icon [#2973](https://github.com/mapbox/mapbox-gl-js/pull/2973)
- Add a `close` event to `Popup`s [#2953](https://github.com/mapbox/mapbox-gl-js/pull/2953)
- Add a `offset` option to `Marker` [#2885](https://github.com/mapbox/mapbox-gl-js/pull/2885)
- Print `error` events without any listeners to the console [#2852](https://github.com/mapbox/mapbox-gl-js/pull/2852)
- Refactored `Source` interface to prepare for custom source types [#2667](https://github.com/mapbox/mapbox-gl-js/pull/2667)

#### Bugfixes

- Fix opacity property-functions for fill layers [#2971](https://github.com/mapbox/mapbox-gl-js/pull/2971)
- Fix `DataCloneError` in Firefox and IE11 [#2559](https://github.com/mapbox/mapbox-gl-js/pull/2559)
- Fix bug preventing camera animations from being triggered in `moveend` listeners [#2944](https://github.com/mapbox/mapbox-gl-js/pull/2944)
- Fix bug preventing `fill-outline-color` from being unset [#2964](https://github.com/mapbox/mapbox-gl-js/pull/2964)
- Fix webpack support [#2887](https://github.com/mapbox/mapbox-gl-js/pull/2887)
- Prevent buttons in controls from acting like form submit buttons [#2935](https://github.com/mapbox/mapbox-gl-js/pull/2935)
- Fix bug preventing map interactions near two controls in the same corner [#2932](https://github.com/mapbox/mapbox-gl-js/pull/2932)
- Fix crash resulting for large style batch queue [#2926](https://github.com/mapbox/mapbox-gl-js/issues/2926)

## 0.21.0 (July 13 2016)

#### Breaking Changes

- GeoJSON polygon inner rings are now rewound for compliance with the [v2 vector tile](https://github.com/mapbox/vector-tile-spec/blob/master/2.1/README.md#4344-polygon-geometry-type). This may affect some uses of `line-offset`, reversing the direction of the offset. [#2889](https://github.com/mapbox/mapbox-gl-js/issues/2889)

#### New Features & Improvements

- Add `text-pitch-alignment` style property [#2668](https://github.com/mapbox/mapbox-gl-js/pull/2668)
- Allow query parameters on `mapbox://` URLs [#2702](https://github.com/mapbox/mapbox-gl-js/pull/2702)
- Add `icon-text-fit` and `icon-text-fit-padding` style properties [#2720](https://github.com/mapbox/mapbox-gl-js/pull/2720)
- Enable property functions for `icon-rotate` [#2738](https://github.com/mapbox/mapbox-gl-js/pull/2738)
- Enable property functions for `fill-opacity` [#2733](https://github.com/mapbox/mapbox-gl-js/pull/2733)
- Fire `Map#mouseout` events [#2777](https://github.com/mapbox/mapbox-gl-js/pull/2777)
- Allow query parameters on all sprite URLs [#2772](https://github.com/mapbox/mapbox-gl-js/pull/2772)
- Increase sprite atlas size to 1024px square, allowing more and larger sprites [#2802](https://github.com/mapbox/mapbox-gl-js/pull/2802)
- Add `Marker` class [#2725](https://github.com/mapbox/mapbox-gl-js/pull/2725) [#2810](https://github.com/mapbox/mapbox-gl-js/pull/2810)
- Add `{quadkey}` URL parameter [#2805](https://github.com/mapbox/mapbox-gl-js/pull/2805)
- Add `circle-pitch-scale` style property [#2821](https://github.com/mapbox/mapbox-gl-js/pull/2821)

#### Bugfixes

- Fix rendering of layers with large numbers of features [#2794](https://github.com/mapbox/mapbox-gl-js/pull/2794)
- Fix exceptions thrown during drag-rotate interactions [#2840](https://github.com/mapbox/mapbox-gl-js/pull/2840)
- Fix error when adding and removing a layer within the same update cycle [#2845](https://github.com/mapbox/mapbox-gl-js/pull/2845)
- Fix false "Geometry exceeds allowed extent" warnings [#2568](https://github.com/mapbox/mapbox-gl-js/issues/2568)
- Fix `Map#loaded` returning true while there are outstanding tile updates [#2847](https://github.com/mapbox/mapbox-gl-js/pull/2847)
- Fix style validation error thrown while removing a filter [#2847](https://github.com/mapbox/mapbox-gl-js/pull/2847)
- Fix event data object not being passed for double click events [#2814](https://github.com/mapbox/mapbox-gl-js/pull/2814)
- Fix multipolygons disappearing from map at certain zoom levels [#2704](https://github.com/mapbox/mapbox-gl-js/issues/2704)
- Fix exceptions caused by `queryRenderedFeatures` in Safari and Firefox [#2822](https://github.com/mapbox/mapbox-gl-js/pull/2822)
- Fix `mapboxgl#supported()` returning `true` in old versions of IE11 [mapbox/mapbox-gl-supported#1](https://github.com/mapbox/mapbox-gl-supported/issues/1)

## 0.20.1 (June 21 2016)

#### Bugfixes

- Fixed exception thrown when changing `*-translate` properties via `setPaintProperty` ([#2762](https://github.com/mapbox/mapbox-gl-js/issues/2762))

## 0.20.0 (June 10 2016)

#### New Features & Improvements

- Add limited WMS support [#2612](https://github.com/mapbox/mapbox-gl-js/pull/2612)
- Add `workerCount` constructor option [#2666](https://github.com/mapbox/mapbox-gl-js/pull/2666)
- Improve performance of `locationPoint` and `pointLocation` [#2690](https://github.com/mapbox/mapbox-gl-js/pull/2690)
- Remove "Not using VertexArrayObject extension" warning messages [#2707](https://github.com/mapbox/mapbox-gl-js/pull/2707)
- Add `version` property to mapboxgl [#2660](https://github.com/mapbox/mapbox-gl-js/pull/2660)
- Support property functions in `circle-opacity` and `circle-blur` [#2693](https://github.com/mapbox/mapbox-gl-js/pull/2693)

#### Bugfixes

- Fix exception thrown by "drag rotate" handler [#2680](https://github.com/mapbox/mapbox-gl-js/issues/2680)
- Return an empty array instead of an empty object from `queryRenderedFeatures` [#2694](https://github.com/mapbox/mapbox-gl-js/pull/2694)
- Fix bug causing map to not render in IE

## 0.19.1 (June 2 2016)

#### Bugfixes

- Fix rendering of polygons with more than 35k vertices [#2657](https://github.com/mapbox/mapbox-gl-js/issues/2657)

## 0.19.0 (May 31 2016)

#### New Features & Improvements

- Allow use of special characters in property field names [#2547](https://github.com/mapbox/mapbox-gl-js/pull/2547)
- Improve rendering speeds on fill layers [#1606](https://github.com/mapbox/mapbox-gl-js/pull/1606)
- Add data driven styling support for `fill-color` and `fill-outline-color` [#2629](https://github.com/mapbox/mapbox-gl-js/pull/2629)
- Add `has` and `!has` filter operators [mapbox/feature-filter#15](https://github.com/mapbox/feature-filter/pull/15)
- Improve keyboard handlers with held-down keys [#2530](https://github.com/mapbox/mapbox-gl-js/pull/2530)
- Support 'tms' tile scheme [#2565](https://github.com/mapbox/mapbox-gl-js/pull/2565)
- Add `trackResize` option to `Map` [#2591](https://github.com/mapbox/mapbox-gl-js/pull/2591)

#### Bugfixes

- Scale circles when map is displayed at a pitch [#2541](https://github.com/mapbox/mapbox-gl-js/issues/2541)
- Fix background pattern rendering bug [#2557](https://github.com/mapbox/mapbox-gl-js/pull/2557)
- Fix bug that prevented removal of a `fill-pattern` from a fill layer [#2534](https://github.com/mapbox/mapbox-gl-js/issues/2534)
- Fix `line-pattern` and `fill-pattern`rendering [#2596](https://github.com/mapbox/mapbox-gl-js/pull/2596)
- Fix some platform specific rendering bugs [#2553](https://github.com/mapbox/mapbox-gl-js/pull/2553)
- Return empty object from `queryRenderedFeatures` before the map is loaded [#2621](https://github.com/mapbox/mapbox-gl-js/pull/2621)
- Fix "there is no texture bound to the unit 1" warnings [#2509](https://github.com/mapbox/mapbox-gl-js/pull/2509)
- Allow transitioned values to be unset [#2561](https://github.com/mapbox/mapbox-gl-js/pull/2561)

## 0.18.0 (April 13 2016)

#### New Features & Improvements

- Implement zoom-and-property functions for `circle-color` and `circle-size` [#2454](https://github.com/mapbox/mapbox-gl-js/pull/2454)
- Dedupe attributions that are substrings of others [#2453](https://github.com/mapbox/mapbox-gl-js/pull/2453)
- Misc performance improvements [#2483](https://github.com/mapbox/mapbox-gl-js/pull/2483) [#2488](https://github.com/mapbox/mapbox-gl-js/pull/2488)

#### Bugfixes

- Fix errors when unsetting and resetting a style property [#2464](https://github.com/mapbox/mapbox-gl-js/pull/2464)
- Fix errors when updating paint properties while using classes [#2496](https://github.com/mapbox/mapbox-gl-js/pull/2496)
- Fix errors caused by race condition in unserializeBuckets [#2497](https://github.com/mapbox/mapbox-gl-js/pull/2497)
- Fix overzoomed tiles in wrapped worlds [#2482](https://github.com/mapbox/mapbox-gl-js/issues/2482)
- Fix errors caused by mutating a filter object after calling `Map#setFilter` [#2495](https://github.com/mapbox/mapbox-gl-js/pull/2495)

## 0.17.0 (April 13 2016)

#### Breaking Changes

- Remove `map.batch` in favor of automatically batching style mutations (i.e. calls to `Map#setLayoutProperty`, `Map#setPaintProperty`, `Map#setFilter`, `Map#setClasses`, etc.) and applying them once per frame, significantly improving performance when updating the style frequently [#2355](https://github.com/mapbox/mapbox-gl-js/pull/2355) [#2380](https://github.com/mapbox/mapbox-gl-js/pull/2380)
- Remove `util.throttle` [#2345](https://github.com/mapbox/mapbox-gl-js/issues/2345)

#### New Features & Improvements

- Improve performance of all style mutation methods by only recalculating affected properties [#2339](https://github.com/mapbox/mapbox-gl-js/issues/2339)
- Improve fading of labels and icons [#2376](https://github.com/mapbox/mapbox-gl-js/pull/2376)
- Improve rendering performance by reducing work done on the main thread [#2394](https://github.com/mapbox/mapbox-gl-js/pull/2394)
- Validate filters passed to `Map#queryRenderedFeatures` and `Map#querySourceFeatures` [#2349](https://github.com/mapbox/mapbox-gl-js/issues/2349)
- Display a warning if a vector tile's geometry extent is larger than supported [#2383](https://github.com/mapbox/mapbox-gl-js/pull/2383)
- Implement property functions (i.e. data-driven styling) for `circle-color` and `circle-size` [#1932](https://github.com/mapbox/mapbox-gl-js/pull/1932)
- Add `Popup#setDOMContent` method [#2436](https://github.com/mapbox/mapbox-gl-js/pull/2436)

#### Bugfixes

- Fix a performance regression caused by using 1 `WebWorker` instead of `# cpus - 1` `WebWorker`s, slowing down tile loading times [#2408](https://github.com/mapbox/mapbox-gl-js/pull/2408)
- Fix a bug in which `Map#queryRenderedFeatures` would sometimes return features that had been removed [#2353](https://github.com/mapbox/mapbox-gl-js/issues/2353)
- Fix `clusterMaxZoom` option on `GeoJSONSource` not working as expected [#2374](https://github.com/mapbox/mapbox-gl-js/issues/2374)
- Fix anti-aliased rendering for pattern fills [#2372](https://github.com/mapbox/mapbox-gl-js/issues/2372)
- Fix exception caused by calling `Map#queryRenderedFeatures` or `Map#querySourceFeatures` with no arguments
- Fix exception caused by calling `Map#setLayoutProperty` for `text-field` or `icon-image` [#2407](https://github.com/mapbox/mapbox-gl-js/issues/2407)

## 0.16.0 (March 24 2016)

#### Breaking Changes

- Replace `Map#featuresAt` and `Map#featuresIn` with `Map#queryRenderedFeatures` and `map.querySourceFeatures` ([#2224](https://github.com/mapbox/mapbox-gl-js/pull/2224))
    - Replace `featuresAt` and `featuresIn` with `queryRenderedFeatures`
    - Make `queryRenderedFeatures` synchronous, remove the callback and use the return value.
    - Rename `layer` parameter to `layers` and make it an array of layer names.
    - Remove the `radius` parameter. `radius` was used with `featuresAt` to account for style properties like `line-width` and `circle-radius`. `queryRenderedFeatures` accounts for these style properties. If you need to query a larger area, use a bounding box query instead of a point query.
    - Remove the `includeGeometry` parameter because `queryRenderedFeatures` always includes geometries.
- `Map#debug` is renamed to `Map#showTileBoundaries` ([#2284](https://github.com/mapbox/mapbox-gl-js/pull/2284))
- `Map#collisionDebug` is renamed to `Map#showCollisionBoxes` ([#2284](https://github.com/mapbox/mapbox-gl-js/pull/2284))

#### New Features & Improvements

- Improve overall rendering performance. ([#2221](https://github.com/mapbox/mapbox-gl-js/pull/2221))
- Improve performance of `GeoJSONSource#setData`. ([#2222](https://github.com/mapbox/mapbox-gl-js/pull/2222))
- Add `Map#setMaxBounds` method ([#2234](https://github.com/mapbox/mapbox-gl-js/pull/2234))
- Add `isActive` and `isEnabled` methods to interaction handlers ([#2238](https://github.com/mapbox/mapbox-gl-js/pull/2238))
- Add `Map#setZoomBounds` method ([#2243](https://github.com/mapbox/mapbox-gl-js/pull/2243))
- Add touch events ([#2195](https://github.com/mapbox/mapbox-gl-js/issues/2195))
- Add `map.queryRenderedFeatures` to query the styled and rendered representations of features ([#2224](https://github.com/mapbox/mapbox-gl-js/pull/2224))
- Add `map.querySourceFeatures` to get features directly from vector tiles, independent of the style ([#2224](https://github.com/mapbox/mapbox-gl-js/pull/2224))
- Add `mapboxgl.Geolocate` control ([#1939](https://github.com/mapbox/mapbox-gl-js/issues/1939))
- Make background patterns render seamlessly across tile boundaries ([#2305](https://github.com/mapbox/mapbox-gl-js/pull/2305))

#### Bugfixes

- Fix calls to `setFilter`, `setLayoutProperty`, and `setLayerZoomRange` on ref children ([#2228](https://github.com/mapbox/mapbox-gl-js/issues/2228))
- Fix `undefined` bucket errors after `setFilter` calls ([#2244](https://github.com/mapbox/mapbox-gl-js/issues/2244))
- Fix bugs causing hidden symbols to be rendered ([#2246](https://github.com/mapbox/mapbox-gl-js/pull/2246), [#2276](https://github.com/mapbox/mapbox-gl-js/pull/2276))
- Fix raster flickering ([#2236](https://github.com/mapbox/mapbox-gl-js/issues/2236))
- Fix `queryRenderedFeatures` precision at high zoom levels ([#2292](https://github.com/mapbox/mapbox-gl-js/pull/2292))
- Fix holes in GeoJSON data caused by unexpected winding order ([#2285](https://github.com/mapbox/mapbox-gl-js/pull/2285))
- Fix bug causing deleted features to be returned by `queryRenderedFeatures` ([#2306](https://github.com/mapbox/mapbox-gl-js/pull/2306))
- Fix bug causing unexpected fill patterns to be rendered ([#2307](https://github.com/mapbox/mapbox-gl-js/pull/2307))
- Fix popup location with preceding sibling elements ([#2311](https://github.com/mapbox/mapbox-gl-js/pull/2311))
- Fix polygon anti-aliasing ([#2319](https://github.com/mapbox/mapbox-gl-js/pull/2319))
- Fix slivers between non-adjacent polygons ([#2319](https://github.com/mapbox/mapbox-gl-js/pull/2319))
- Fix keyboard shortcuts causing page to scroll ([#2312](https://github.com/mapbox/mapbox-gl-js/pull/2312))

## 0.15.0 (March 1 2016)

#### New Features & Improvements

- Add `ImageSource#setCoordinates` and `VideoSource#setCoordinates` ([#2184](https://github.com/mapbox/mapbox-gl-js/pull/2184))

#### Bugfixes

- Fix flickering on raster layers ([#2211](https://github.com/mapbox/mapbox-gl-js/pull/2211))
- Fix browser hang when zooming quickly on raster layers ([#2211](https://github.com/mapbox/mapbox-gl-js/pull/2211))

## 0.14.3 (Feb 25 2016)

#### New Features & Improvements

- Improve responsiveness of zooming out by using cached parent tiles ([#2168](https://github.com/mapbox/mapbox-gl-js/pull/2168))
- Improve contextual clues on style API validation ([#2170](https://github.com/mapbox/mapbox-gl-js/issues/2170))
- Improve performance of methods including `setData` ([#2174](https://github.com/mapbox/mapbox-gl-js/pull/2174))

#### Bugfixes

- Fix incorrectly sized line dashes ([#2099](https://github.com/mapbox/mapbox-gl-js/issues/2099))
- Fix bug in which `in` feature filter drops features ([#2166](https://github.com/mapbox/mapbox-gl-js/pull/2166))
- Fix bug preventing `Map#load` from firing when tile "Not Found" errors occurred ([#2176](https://github.com/mapbox/mapbox-gl-js/pull/2176))
- Fix rendering artifacts on mobile GPUs ([#2117](https://github.com/mapbox/mapbox-gl-js/pull/2117))

## 0.14.2 (Feb 19 2016)

#### Bugfixes

- Look for loaded parent tiles in cache
- Set tile cache size based on viewport size ([#2137](https://github.com/mapbox/mapbox-gl-js/issues/2137))
- Fix tile render order for layer-by-layer
- Remove source update throttling ([#2139](https://github.com/mapbox/mapbox-gl-js/issues/2139))
- Make panning while zooming more linear ([#2070](https://github.com/mapbox/mapbox-gl-js/issues/2070))
- Round points created during bucket creation ([#2067](https://github.com/mapbox/mapbox-gl-js/issues/2067))
- Correct bounds for a rotated or tilted map ([#1842](https://github.com/mapbox/mapbox-gl-js/issues/1842))
- Fix overscaled featuresAt ([#2103](https://github.com/mapbox/mapbox-gl-js/issues/2103))
- Allow using `tileSize: 512` as a switch to trade retina support for 512px raster tiles
- Fix the serialization of paint classes ([#2107](https://github.com/mapbox/mapbox-gl-js/issues/2107))
- Fixed bug where unsetting style properties could mutate the value of other style properties ([#2105](https://github.com/mapbox/mapbox-gl-js/pull/2105))
- Less slanted dashed lines near sharp corners ([#967](https://github.com/mapbox/mapbox-gl-js/issues/967))
- Fire map#load if no initial style is set ([#2042](https://github.com/mapbox/mapbox-gl-js/issues/2042))

## 0.14.1 (Feb 10 2016)

#### Bugfixes

- Fix incorrectly rotated symbols along lines near tile boundaries ([#2062](https://github.com/mapbox/mapbox-gl-js/issues/2062))
- Fix broken rendering when a fill layer follows certain symbol layers ([#2092](https://github.com/mapbox/mapbox-gl-js/issues/2092))

## 0.14.0 (Feb 8 2016)

#### Breaking Changes

- Switch `GeoJSONSource` clustering options from being measured in extent-units to pixels ([#2026](https://github.com/mapbox/mapbox-gl-js/pull/2026))

#### New Features & Improvements

- Improved error message for invalid colors ([#2006](https://github.com/mapbox/mapbox-gl-js/pull/2006))
- Added support for tiles with variable extents ([#2010](https://github.com/mapbox/mapbox-gl-js/pull/2010))
- Improved `filter` performance and maximum size ([#2024](https://github.com/mapbox/mapbox-gl-js/issues/2024))
- Changed circle rendering such that all geometry nodes are drawn, not just the geometry's outer ring ([#2027](https://github.com/mapbox/mapbox-gl-js/pull/2027))
- Added `Map#getStyle` method ([#1982](https://github.com/mapbox/mapbox-gl-js/issues/1982))

#### Bugfixes

- Fixed bug causing WebGL contexts to be "used up" by calling `mapboxgl.supported()` ([#2018](https://github.com/mapbox/mapbox-gl-js/issues/2018))
- Fixed non-deterministic symbol z-order sorting ([#2023](https://github.com/mapbox/mapbox-gl-js/pull/2023))
- Fixed garbled labels while zooming ([#2012](https://github.com/mapbox/mapbox-gl-js/issues/2012))
- Fixed icon jumping when touching trackpad with two fingers ([#1990](https://github.com/mapbox/mapbox-gl-js/pull/1990))
- Fixed overzoomed collision debug labels ([#2033](https://github.com/mapbox/mapbox-gl-js/issues/2033))
- Fixed dashes sliding along their line during zooming ([#2039](https://github.com/mapbox/mapbox-gl-js/issues/2039))
- Fixed overscaled `minzoom` setting for GeoJSON sources ([#1651](https://github.com/mapbox/mapbox-gl-js/issues/1651))
- Fixed overly-strict function validation for duplicate stops ([#2075](https://github.com/mapbox/mapbox-gl-js/pull/2075))
- Fixed crash due to `performance.now` not being present on some browsers ([#2056](https://github.com/mapbox/mapbox-gl-js/issues/2056))
- Fixed the unsetting of paint properties ([#2037](https://github.com/mapbox/mapbox-gl-js/issues/2037))
- Fixed bug causing multiple interaction handler event listeners to be attached ([#2069](https://github.com/mapbox/mapbox-gl-js/issues/2069))
- Fixed bug causing only a single debug box to be drawn ([#2034](https://github.com/mapbox/mapbox-gl-js/issues/2034))

## 0.13.1 (Jan 27 2016)

#### Bugfixes

- Fixed broken npm package due to outdated bundled modules

## 0.13.0 (Jan 27 2016)

#### Bugfixes

- Fixed easeTo pan, zoom, and rotate when initial rotation != 0 ([#1950](https://github.com/mapbox/mapbox-gl-js/pull/1950))
- Fixed rendering of tiles with an extent != 4096 ([#1952](https://github.com/mapbox/mapbox-gl-js/issues/1952))
- Fixed missing icon collision boxes ([#1978](https://github.com/mapbox/mapbox-gl-js/issues/1978))
- Fixed null `Tile#buffers` errors ([#1987](https://github.com/mapbox/mapbox-gl-js/pull/1987))

#### New Features & Improvements

- Added `symbol-avoid-edges` style property ([#1951](https://github.com/mapbox/mapbox-gl-js/pull/1951))
- Improved `symbol-max-angle` check algorithm ([#1959](https://github.com/mapbox/mapbox-gl-js/pull/1959))
- Added marker clustering! ([#1931](https://github.com/mapbox/mapbox-gl-js/pull/1931))
- Added zoomstart, zoom, and zoomend events ([#1958](https://github.com/mapbox/mapbox-gl-js/issues/1958))
- Disabled drag on mousedown when using boxzoom ([#1907](https://github.com/mapbox/mapbox-gl-js/issues/1907))

## 0.12.4 (Jan 19 2016)

#### Bugfixes

- Fix elementGroups null value errors ([#1933](https://github.com/mapbox/mapbox-gl-js/issues/1933))
- Fix some glyph atlas overflow cases ([#1923](https://github.com/mapbox/mapbox-gl-js/pull/1923))

## 0.12.3 (Jan 14 2016)

#### API Improvements

- Support inline attribution options in map options ([#1865](https://github.com/mapbox/mapbox-gl-js/issues/1865))
- Improve flyTo options ([#1854](https://github.com/mapbox/mapbox-gl-js/issues/1854), [#1429](https://github.com/mapbox/mapbox-gl-js/issues/1429))

#### Bugfixes

- Fix flickering with overscaled tiles ([#1921](https://github.com/mapbox/mapbox-gl-js/issues/1921))
- Remove Node.remove calls for IE browser compatibility ([#1900](https://github.com/mapbox/mapbox-gl-js/issues/1900))
- Match patterns at tile boundaries ([#1908](https://github.com/mapbox/mapbox-gl-js/pull/1908))
- Fix Tile#positionAt, fix query tests ([#1899](https://github.com/mapbox/mapbox-gl-js/issues/1899))
- Fix flickering on streets ([#1875](https://github.com/mapbox/mapbox-gl-js/issues/1875))
- Fix text-max-angle property ([#1870](https://github.com/mapbox/mapbox-gl-js/issues/1870))
- Fix overscaled line patterns ([#1856](https://github.com/mapbox/mapbox-gl-js/issues/1856))
- Fix patterns and icons for mismatched pixelRatios ([#1851](https://github.com/mapbox/mapbox-gl-js/issues/1851))
- Fix missing labels when text size 0 at max zoom ([#1809](https://github.com/mapbox/mapbox-gl-js/issues/1809))
- Use linear interp when pixel ratios don't match ([#1601](https://github.com/mapbox/mapbox-gl-js/issues/1601))
- Fix blank areas, flickering in raster layers ([#1876](https://github.com/mapbox/mapbox-gl-js/issues/1876), [#675](https://github.com/mapbox/mapbox-gl-js/issues/675))
- Fix labels slipping/cropping at tile bounds ([#757](https://github.com/mapbox/mapbox-gl-js/issues/757))

#### UX Improvements

- Improve touch handler perceived performance ([#1844](https://github.com/mapbox/mapbox-gl-js/issues/1844))

## 0.12.2 (Dec 22 2015)

#### API Improvements

- Support LngLat.convert([w, s, e, n]) ([#1812](https://github.com/mapbox/mapbox-gl-js/issues/1812))
- Invalid GeoJSON is now handled better

#### Bugfixes

- Fixed `Popup#addTo` when the popup is already open ([#1811](https://github.com/mapbox/mapbox-gl-js/issues/1811))
- Fixed warping when rotating / zooming really fast
- `Map#flyTo` now flies across the antimeridian if shorter ([#1853](https://github.com/mapbox/mapbox-gl-js/issues/1853))

## 0.12.1 (Dec 8 2015)

#### Breaking changes

- Reversed the direction of `line-offset` ([#1808](https://github.com/mapbox/mapbox-gl-js/pull/1808))
- Renamed `Pinch` interaction handler to `TouchZoomRotate` ([#1777](https://github.com/mapbox/mapbox-gl-js/pull/1777))
- Made `Map#update` and `Map#render` private methods ([#1798](https://github.com/mapbox/mapbox-gl-js/pull/1798))
- Made `Map#remove` remove created DOM elements ([#1789](https://github.com/mapbox/mapbox-gl-js/issues/1789))

#### API Improvements

- Added an method to disable touch rotation ([#1777](https://github.com/mapbox/mapbox-gl-js/pull/1777))
- Added a `position` option for `Attribution` ([#1689](https://github.com/mapbox/mapbox-gl-js/issues/1689))

#### Bugfixes

- Ensure tile loading errors are properly reported ([#1799](https://github.com/mapbox/mapbox-gl-js/pull/1799))
- Ensure re-adding a previously removed pop-up works ([#1477](https://github.com/mapbox/mapbox-gl-js/issues/1477))

#### UX Improvements

- Don't round zoom level during double-click interaction ([#1640](https://github.com/mapbox/mapbox-gl-js/issues/1640))

## 0.12.0 (Dec 2 2015)

#### API Improvements

- Added `line-offset` style property ([#1778](https://github.com/mapbox/mapbox-gl-js/issues/1778))

## 0.11.5 (Dec 1 2015)

#### Bugfixes

- Fixed unstable symbol layer render order when adding / removing layers ([#1558](https://github.com/mapbox/mapbox-gl-js/issues/1558))
- Fire map loaded event even if raster tiles have errors
- Fix panning animation during easeTo with zoom change
- Fix pitching animation during flyTo
- Fix pitching animation during easeTo
- Prevent rotation from firing `mouseend` events ([#1104](https://github.com/mapbox/mapbox-gl-js/issues/1104))

#### API Improvements

- Fire `mousedown` and `mouseup` events ([#1411](https://github.com/mapbox/mapbox-gl-js/issues/1411))
- Fire `movestart` and `moveend` when panning ([#1658](https://github.com/mapbox/mapbox-gl-js/issues/1658))
- Added drag events ([#1442](https://github.com/mapbox/mapbox-gl-js/issues/1442))
- Request webp images for mapbox:// raster tiles in chrome ([#1725](https://github.com/mapbox/mapbox-gl-js/issues/1725))

#### UX Improvements

- Added inertia to map rotation ([#620](https://github.com/mapbox/mapbox-gl-js/issues/620))

## 0.11.4 (Nov 16 2015)

#### Bugfixes

- Fix alpha blending of alpha layers ([#1684](https://github.com/mapbox/mapbox-gl-js/issues/1684))

## 0.11.3 (Nov 10 2015)

#### Bugfixes

- Fix GeoJSON rendering and performance ([#1685](https://github.com/mapbox/mapbox-gl-js/pull/1685))

#### UX Improvements

- Use SVG assets for UI controls ([#1657](https://github.com/mapbox/mapbox-gl-js/pull/1657))
- Zoom out with shift + dblclick ([#1666](https://github.com/mapbox/mapbox-gl-js/issues/1666))

## 0.11.2 (Oct 29 2015)

- Misc performance improvements

#### Bugfixes

- Fix sprites on systems with non-integer `devicePixelRatio`s ([#1029](https://github.com/mapbox/mapbox-gl-js/issues/1029) [#1475](https://github.com/mapbox/mapbox-gl-js/issues/1475) [#1476](https://github.com/mapbox/mapbox-gl-js/issues/1476))
- Fix layer minZoom being ignored if not less than source maxZoom
- Fix symbol placement at the start of a line ([#1461](https://github.com/mapbox/mapbox-gl-js/issues/1461))
- Fix `raster-opacity` on non-tile sources ([#1270](https://github.com/mapbox/mapbox-gl-js/issues/1270))
- Ignore boxzoom on shift-click ([#1655](https://github.com/mapbox/mapbox-gl-js/issues/1655))

#### UX Improvements

- Enable line breaks on common punctuation ([#1115](https://github.com/mapbox/mapbox-gl-js/issues/1115))

#### API Improvements

- Add toString and toArray methods to LngLat, LngLatBounds ([#1571](https://github.com/mapbox/mapbox-gl-js/issues/1571))
- Add `Transform#resize` method
- Add `Map#getLayer` method ([#1183](https://github.com/mapbox/mapbox-gl-js/issues/1183))
- Add `Transform#unmodified` property ([#1452](https://github.com/mapbox/mapbox-gl-js/issues/1452))
- Propagate WebGL context events ([#1612](https://github.com/mapbox/mapbox-gl-js/pull/1612))

## 0.11.1 (Sep 30 2015)

#### Bugfixes

- Add statistics and checkboxes to debug page
- Fix `Map#featuresAt` for non-4096 vector sources ([#1529](https://github.com/mapbox/mapbox-gl-js/issues/1529))
- Don't fire `mousemove` on drag-pan
- Fix maxBounds constrains ([#1539](https://github.com/mapbox/mapbox-gl-js/issues/1539))
- Fix maxBounds infinite loop ([#1538](https://github.com/mapbox/mapbox-gl-js/issues/1538))
- Fix memory leak in worker
- Assert valid `TileCoord`, fix wrap calculation in `TileCoord#cover` ([#1483](https://github.com/mapbox/mapbox-gl-js/issues/1483))
- Abort raster tile load if not in viewport ([#1490](https://github.com/mapbox/mapbox-gl-js/issues/1490))

#### API Improvements

- Add `Map` event listeners for `mouseup`, `contextmenu` (right click) ([#1532](https://github.com/mapbox/mapbox-gl-js/issues/1532))

## 0.11.0 (Sep 11 2015)

#### API Improvements

- Add `Map#featuresIn`: a bounding-box feature query
- Emit stylesheet validation errors ([#1436](https://github.com/mapbox/mapbox-gl-js/issues/1436))

#### UX Improvements

- Handle v8 style `center`, `zoom`, `bearing`, `pitch` ([#1452](https://github.com/mapbox/mapbox-gl-js/issues/1452))
- Improve circle type styling ([#1446](https://github.com/mapbox/mapbox-gl-js/issues/1446))
- Improve dashed and patterned line antialiasing

#### Bugfixes

- Load images in a way that respects Cache-Control headers
- Filter for rtree matches to those crossing bbox
- Log errors by default ([#1463](https://github.com/mapbox/mapbox-gl-js/issues/1463))
- Fixed modification of `text-size` via `setLayoutProperty` ([#1451](https://github.com/mapbox/mapbox-gl-js/issues/1451))
- Throw on lat > 90 || < -90. ([#1443](https://github.com/mapbox/mapbox-gl-js/issues/1443))
- Fix circle clipping bug ([#1457](https://github.com/mapbox/mapbox-gl-js/issues/1457))

## 0.10.0 (Aug 21 2015)

#### Breaking changes

- Switched to [longitude, latitude] coordinate order, matching GeoJSON. We anticipate that mapbox-gl-js will be widely used
  with GeoJSON, and in the long term having a coordinate order that is consistent with GeoJSON will lead to less confusion
  and impedance mismatch than will a [latitude, longitude] order.

    The following APIs were renamed:
    - `LatLng` was renamed to `LngLat`
    - `LatLngBounds` was renamed to `LngLatBounds`
    - `Popup#setLatLng` was renamed to `Popup#setLngLat`
    - `Popup#getLatLng` was renamed to `Popup#getLngLat`
    - The `latLng` property of Map events was renamed `lngLat`

    The following APIs now expect array coordinates in [longitude, latitude] order:
    - `LngLat.convert`
    - `LngLatBounds.convert`
    - `Popup#setLngLat`
    - The `center` and `maxBounds` options of the `Map` constructor
    - The arguments to `Map#setCenter`, `Map#fitBounds`, `Map#panTo`, and `Map#project`
    - The `center` option of `Map#jumpTo`, `Map#easeTo`, and `Map#flyTo`
    - The `around` option of `Map#zoomTo`, `Map#rotateTo`, and `Map#easeTo`
    - The `coordinates` properties of video and image sources

- Updated to mapbox-gl-style-spec v8.0.0 ([Changelog](https://github.com/mapbox/mapbox-gl-style-spec/blob/v8.0.0/CHANGELOG.md)). Styles are
  now expected to be version 8. You can use the [gl-style-migrate](https://github.com/mapbox/mapbox-gl-style-lint#migrations)
  utility to update existing styles.

- The format for `mapbox://` style and glyphs URLs has changed. For style URLs, you should now use the format
  `mapbox://styles/:username/:style`. The `:style` portion of the URL no longer contains a username. For font URLs, you
  should now use the format `mapbox://fonts/:username/{fontstack}/{range}.pbf`.
- Mapbox default styles are now hosted via the Styles API rather than www.mapbox.com. You can make use of the Styles API
  with a `mapbox://` style URL pointing to a v8 style, e.g. `mapbox://styles/mapbox/streets-v8`.
- The v8 satellite style (`mapbox://styles/mapbox/satellite-v8`) is now a plain satellite style, and not longer supports labels
  or contour lines via classes. For a labeled satellite style, use `mapbox://styles/mapbox/satellite-hybrid`.

- Removed `mbgl.config.HTTP_URL` and `mbgl.config.FORCE_HTTPS`; https is always used when connecting to the Mapbox API.
- Renamed `mbgl.config.HTTPS_URL` to `mbgl.config.API_URL`.

#### Bugfixes

- Don't draw halo when halo-width is 0 ([#1381](https://github.com/mapbox/mapbox-gl-js/issues/1381))
- Reverted shader changes that degraded performance on IE

#### API Improvements

- You can now unset layout and paint properties via the `setLayoutProperty` and `setPaintProperty` APIs
  by passing `undefined` as a property value.
- The `layer` option of `featuresAt` now supports an array of layers.

## 0.9.0 (Jul 29 2015)

- `glyphs` URL now normalizes without the `/v4/` prefix for `mapbox://` urls. Legacy behavior for `mapbox://fontstacks` is still maintained ([#1385](https://github.com/mapbox/mapbox-gl-js/issues/1385))
- Expose `geojson-vt` options for GeoJSON sources ([#1271](https://github.com/mapbox/mapbox-gl-js/issues/1271))
- bearing snaps to "North" within a tolerance of 7 degrees ([#1059](https://github.com/mapbox/mapbox-gl-js/issues/1059))
- Now you can directly mutate the minzoom and maxzoom layer properties with `map.setLayerZoomRange(layerId, minzoom, maxzoom)`
- Exposed `mapboxgl.Control`, a base class used by all UI controls
- Refactored handlers to be individually included in Map options, or enable/disable them individually at runtime, e.g. `map.scrollZoom.disable()`.
- New feature: Batch operations can now be done at once, improving performance for calling multiple style functions: ([#1352](https://github.com/mapbox/mapbox-gl-js/pull/1352))

    ```js
    style.batch(function (s) {
        s.addLayer({ id: 'first', type: 'symbol', source: 'streets' });
        s.addLayer({ id: 'second', type: 'symbol', source: 'streets' });
        s.addLayer({ id: 'third', type: 'symbol', source: 'terrain' });
        s.setPaintProperty('first', 'text-color', 'black');
        s.setPaintProperty('first', 'text-halo-color', 'white');
    });
    ```

- Improved documentation
- `featuresAt` performance improvements by exposing `includeGeometry` option
- Better label placement along lines ([#1283](https://github.com/mapbox/mapbox-gl-js/pull/1283))
- Improvements to round linejoins on semi-transparent lines (mapbox/mapbox-gl-native[#1771](https://github.com/mapbox/mapbox-gl-js/pull/1771))
- Round zoom levels for raster tile loading ([@2a2aec](https://github.com/mapbox/mapbox-gl-js/commit/2a2aec44a39e11e73bdf663258bd6d52b83775f5))
- Source#reload cannot be called if source is not loaded ([#1198](https://github.com/mapbox/mapbox-gl-js/issues/1198))
- Events bubble to the canvas container for custom overlays ([#1301](https://github.com/mapbox/mapbox-gl-js/pull/1301))
- Move handlers are now bound on mousedown and touchstart events
- map.featuresAt() now works across the dateline

## 0.8.1 (Jun 16 2015)

- No code changes; released only to correct a build issue in 0.8.0.

## 0.8.0 (Jun 15 2015)

#### Breaking changes

- `map.setView(latlng, zoom, bearing)` has been removed. Use
  [`map.jumpTo(options)`](https://www.mapbox.com/mapbox-gl-js/api/#map/jumpto) instead:

    ```js
    map.setView([40, -74.5], 9); // 0.7.0 or earlier
    map.jumpTo({ center: [40, -74.5], zoom: 9 }); // now
    ```

- [`map.easeTo`](https://www.mapbox.com/mapbox-gl-js/api/#map/easeto) and
  [`map.flyTo`](https://www.mapbox.com/mapbox-gl-js/api/#map/flyto) now accept a single
  options object rather than positional parameters:

    ```js
    map.easeTo([40, -74.5], 9, null, { duration: 400 }); // 0.7.0 or earlier
    map.easeTo({ center: [40, -74.5], zoom: 9, duration: 400 }); // now
    ```

- `mapboxgl.Source` is no longer exported. Use `map.addSource()` instead. See the
  [GeoJSON line](https://www.mapbox.com/mapbox-gl-js/example/geojson-line/) or
  [GeoJSON markers](https://www.mapbox.com/mapbox-gl-js/example/geojson-markers/)
  examples.
- `mapboxgl.util.supported()` moved to [`mapboxgl.supported()`](https://www.mapbox.com/mapbox-gl-js/api/#mapboxgl/supported).

#### UX improvements

- Add perspective rendering ([#1049](https://github.com/mapbox/mapbox-gl-js/pull/1049))
- Better and faster labelling ([#1079](https://github.com/mapbox/mapbox-gl-js/pull/1079))
- Add touch interactions support on mobile devices ([#949](https://github.com/mapbox/mapbox-gl-js/pull/949))
- Viewport-relative popup arrows ([#1065](https://github.com/mapbox/mapbox-gl-js/pull/1065))
- Normalize mousewheel zooming speed ([#1060](https://github.com/mapbox/mapbox-gl-js/pull/1060))
- Add proper handling of GeoJSON features that cross the date line ([#1275](https://github.com/mapbox/mapbox-gl-js/issues/1275))
- Sort overlapping symbols in the y direction ([#470](https://github.com/mapbox/mapbox-gl-js/issues/470))
- Control buttons are now on a 30 pixel grid ([#1143](https://github.com/mapbox/mapbox-gl-js/issues/1143))
- Improve GeoJSON processing performance

#### API Improvements

- Switch to JSDoc for documentation
- Bundling with browserify is now supported
- Validate incoming map styles ([#1054](https://github.com/mapbox/mapbox-gl-js/pull/1054))
- Add `Map` `setPitch` `getPitch`
- Add `Map` `dblclick` event. ([#1168](https://github.com/mapbox/mapbox-gl-js/issues/1168))
- Add `Map` `getSource` ([@660a8c1](https://github.com/mapbox/mapbox-gl-js/commit/660a8c1e087f63282d24a30684d686523bce36cb))
- Add `Map` `setFilter` and `getFilter` ([#985](https://github.com/mapbox/mapbox-gl-js/issues/985))
- Add `Map` `failIfMajorPerformanceCaveat` option ([#1082](https://github.com/mapbox/mapbox-gl-js/pull/1082))
- Add `Map` `preserveDrawingBuffer` option ([#1232](https://github.com/mapbox/mapbox-gl-js/pull/1232))
- Add `VideoSource` `getVideo()` ([#1162](https://github.com/mapbox/mapbox-gl-js/issues/1162))
- Support vector tiles with extents other than 4096 ([#1227](https://github.com/mapbox/mapbox-gl-js/pull/1227))
- Use a DOM hierarchy that supports evented overlays ([#1217](https://github.com/mapbox/mapbox-gl-js/issues/1217))
- Pass `latLng` to the event object ([#1068](https://github.com/mapbox/mapbox-gl-js/pull/1068))

#### UX Bugfixes

- Fix rendering glitch on iOS 8 ([#750](https://github.com/mapbox/mapbox-gl-js/issues/750))
- Fix line triangulation errors ([#1120](https://github.com/mapbox/mapbox-gl-js/issues/1120), [#992](https://github.com/mapbox/mapbox-gl-js/issues/992))
- Support unicode range 65280-65535 ([#1108](https://github.com/mapbox/mapbox-gl-js/pull/1108))
- Fix cracks between fill patterns ([#972](https://github.com/mapbox/mapbox-gl-js/issues/972))
- Fix angle of icons aligned with lines ([@37a498a](https://github.com/mapbox/mapbox-gl-js/commit/37a498a7aa2c37d6b94611b614b4efe134e6dd59))
- Fix dashed line bug for overscaled tiles ([#1132](https://github.com/mapbox/mapbox-gl-js/issues/1132))
- Fix icon artifacts caused by sprite neighbors ([#1195](https://github.com/mapbox/mapbox-gl-js/pull/1195))

#### API Bugfixes

- Don't fire spurious `moveend` events on mouseup ([#1107](https://github.com/mapbox/mapbox-gl-js/issues/1107))
- Fix a race condition in `featuresAt` ([#1220](https://github.com/mapbox/mapbox-gl-js/pull/1220))
- Fix for brittle fontstack name convention ([#1070](https://github.com/mapbox/mapbox-gl-js/pull/1070))
- Fix broken `Popup` `setHTML` ([#1272](https://github.com/mapbox/mapbox-gl-js/issues/1272))
- Fix an issue with cross-origin image requests ([#1269](https://github.com/mapbox/mapbox-gl-js/pull/1269))

## 0.7.0 (Mar 3 2015)

#### Breaking

- Rename `Map` `hover` event to `mousemove`.
- Change `featuresAt` to return GeoJSON objects, including geometry ([#1010](https://github.com/mapbox/mapbox-gl-js/issues/1010))
- Remove `Map` `canvas` and `container` properties, add `getCanvas` and `getContainer` methods instead

#### UX Improvements

- Improve line label density
- Add boxzoom interaction ([#1038](https://github.com/mapbox/mapbox-gl-js/issues/1038))
- Add keyboard interaction ([#1034](https://github.com/mapbox/mapbox-gl-js/pull/1034))
- Faster `GeoJSONSource` `setData` without flickering ([#973](https://github.com/mapbox/mapbox-gl-js/issues/973))

#### API Improvements

- Add Popup component ([#325](https://github.com/mapbox/mapbox-gl-js/issues/325))
- Add layer API ([#1022](https://github.com/mapbox/mapbox-gl-js/issues/1022))
- Add filter API ([#985](https://github.com/mapbox/mapbox-gl-js/issues/985))
- More efficient filter API ([#1018](https://github.com/mapbox/mapbox-gl-js/issues/1018))
- Accept plain old JS object for `addSource` ([#1021](https://github.com/mapbox/mapbox-gl-js/issues/1021))
- Reparse overscaled tiles

#### Bugfixes

- Fix `featuresAt` for LineStrings ([#1006](https://github.com/mapbox/mapbox-gl-js/issues/1006))
- Fix `tileSize` argument to `GeoJSON` worker ([#987](https://github.com/mapbox/mapbox-gl-js/issues/987))
- Remove extraneous files from the npm package ([#1024](https://github.com/mapbox/mapbox-gl-js/issues/1024))
- Hide "improve map" link in print ([#988](https://github.com/mapbox/mapbox-gl-js/issues/988))

## 0.6.0 (Feb 9 2015)

#### Bugfixes

- Add wrapped padding to sprite for repeating images ([#972](https://github.com/mapbox/mapbox-gl-js/issues/972))
- Clear color buffers before rendering ([#966](https://github.com/mapbox/mapbox-gl-js/issues/966))
- Make line-opacity work with line-image ([#970](https://github.com/mapbox/mapbox-gl-js/issues/970))
- event.toElement fallback for Firefox ([#932](https://github.com/mapbox/mapbox-gl-js/issues/932))
- skip duplicate vertices at ends of lines ([#776](https://github.com/mapbox/mapbox-gl-js/issues/776))
- allow characters outside \w to be used in token
- Clear old tiles when new GeoJSON is loaded ([#905](https://github.com/mapbox/mapbox-gl-js/issues/905))

#### Improvements

- Added `map.setPaintProperty()`, `map.getPaintProperty()`, `map.setLayoutProperty()`, and `map.getLayoutProperty()`.
- Switch to ESLint and more strict code rules ([#957](https://github.com/mapbox/mapbox-gl-js/pull/957))
- Grab 2x raster tiles if retina ([#754](https://github.com/mapbox/mapbox-gl-js/issues/754))
- Support for mapbox:// style URLs ([#875](https://github.com/mapbox/mapbox-gl-js/issues/875))

#### Breaking

- Updated to mapbox-gl-style-spec v7.0.0 ([Changelog](https://github.com/mapbox/mapbox-gl-style-spec/blob/a2b0b561ce16015a1ef400dc870326b1b5255091/CHANGELOG.md)). Styles are
  now expected to be version 7. You can use the [gl-style-migrate](https://github.com/mapbox/mapbox-gl-style-lint#migrations)
  utility to update existing styles.
- HTTP_URL and HTTPS_URL config options must no longer include a `/v4` path prefix.
- `addClass`, `removeClass`, `setClasses`, `hasClass`, and `getClasses` are now methods
  on Map.
- `Style#cascade` is now private, pending a public style mutation API ([#755](https://github.com/mapbox/mapbox-gl-js/pull/755)).
- The format for `featuresAt` results changed. Instead of result-per-geometry-cross-layer,
  each result has a `layers` array with all layers that contain the feature. This avoids
  duplication of geometry and properties in the result set.

## 0.5.2 (Jan 07 2015)

#### Bugfixes

- Remove tiles for unused sources ([#863](https://github.com/mapbox/mapbox-gl-js/issues/863))
- Fix fill pattern alignment

#### Improvements

- Add GeoJSONSource maxzoom option ([#760](https://github.com/mapbox/mapbox-gl-js/issues/760))
- Return ref layers in featuresAt ([#847](https://github.com/mapbox/mapbox-gl-js/issues/847))
- Return any extra layer keys provided in the stylesheet in featuresAt
- Faster protobuf parsing

## 0.5.1 (Dec 19 2014)

#### Bugfixes

- Fix race conditions with style loading/rendering
- Fix race conditions with setStyle
- Fix map.remove()
- Fix featuresAt properties

## 0.5.0 (Dec 17 2014)

#### Bugfixes

- Fix multiple calls to setStyle

#### Improvements

- `featuresAt` now returns additional information
- Complete style/source/tile event suite:
  style.load, style.error, style.change,
  source.add, source.remove, source.load, source.error, source.change,
  tile.add, tile.remove, tile.load, tile.error
- Vastly improved performance and correctness for GeoJSON sources
- Map#setStyle accepts a style URL
- Support {prefix} in tile URL templates
- Provide a source map with minified source

#### Breaking

- Results format for `featuresAt` changed

## 0.4.2 (Nov 14 2014)

#### Bugfixes

- Ensure only one easing is active at a time ([#807](https://github.com/mapbox/mapbox-gl-js/issues/807))
- Don't require style to perform easings ([#817](https://github.com/mapbox/mapbox-gl-js/issues/817))
- Fix raster tiles sometimes not showing up ([#761](https://github.com/mapbox/mapbox-gl-js/issues/761))

#### Improvements

- Internet Explorer 11 support (experimental)

## 0.4.1 (Nov 10 2014)

#### Bugfixes

- Interpolate to the closest bearing when doing rotation animations ([#818](https://github.com/mapbox/mapbox-gl-js/issues/818))

## 0.4.0 (Nov 4 2014)

#### Breaking

- Updated to mapbox-gl-style-spec v6.0.0 ([Changelog](https://github.com/mapbox/mapbox-gl-style-spec/blob/v6.0.0/CHANGELOG.md)). Styles are
  now expected to be version 6. You can use the [gl-style-migrate](https://github.com/mapbox/mapbox-gl-style-lint#migrations)
  utility to update existing styles.

## 0.3.2 (Oct 23 2014)

#### Bugfixes

- Fix worker initialization with deferred or async scripts

#### Improvements

- Added map.remove()
- CDN assets are now served with gzip compression

## 0.3.1 (Oct 06 2014)

#### Bugfixes

- Fixed iteration over arrays with for/in
- Made browserify deps non-dev ([#752](https://github.com/mapbox/mapbox-gl-js/issues/752))

## 0.3.0 (Sep 23 2014)

#### Breaking

- Updated to mapbox-gl-style-spec v0.0.5 ([Changelog](https://github.com/mapbox/mapbox-gl-style-spec/blob/v0.0.5/CHANGELOG.md)). Styles are
  now expected to be version 5. You can use the [gl-style-migrate](https://github.com/mapbox/mapbox-gl-style-lint#migrations)
  utility to update existing styles.
- Removed support for composite layers for performance reasons. [#523](https://github.com/mapbox/mapbox-gl-js/issues/523#issuecomment-51731405)
- `raster-hue-rotate` units are now degrees.

### Improvements

- Added LatLng#wrap
- Added support for Mapbox fontstack API.
- Added support for remote, non-Mapbox TileJSON sources and inline TileJSON sources ([#535](https://github.com/mapbox/mapbox-gl-js/issues/535), [#698](https://github.com/mapbox/mapbox-gl-js/issues/698)).
- Added support for `symbol-avoid-edges` property to allow labels to be placed across tile edges.
- Fixed mkdir issue on Windows ([#674](https://github.com/mapbox/mapbox-gl-js/issues/674)).
- Fixed drawing beveled line joins without overlap.

#### Bugfixes

- Fixed performance when underzooming a layer's minzoom.
- Fixed `raster-opacity` for regular raster layers.
- Fixed various corner cases of easing functions.
- Do not modify original stylesheet ([#728](https://github.com/mapbox/mapbox-gl-js/issues/728)).
- Inherit video source from source ([#699](https://github.com/mapbox/mapbox-gl-js/issues/699)).
- Fixed interactivity for geojson layers.
- Stop dblclick on navigation so the map does not pan ([#715](https://github.com/mapbox/mapbox-gl-js/issues/715)).

## 0.2.2 (Aug 12 2014)

#### Breaking

- `map.setBearing()` no longer supports a second argument. Use `map.rotateTo` with an `offset` option and duration 0
  if you need to rotate around a point other than the map center.

#### Improvements

- Improved `GeoJSONSource` to also accept URL as `data` option, eliminating a huge performance bottleneck in case of large GeoJSON files.
  [#669](https://github.com/mapbox/mapbox-gl-js/issues/669) [#671](https://github.com/mapbox/mapbox-gl-js/issues/671)
- Switched to a different fill outlines rendering approach. [#668](https://github.com/mapbox/mapbox-gl-js/issues/668)
- Made the minified build 12% smaller gzipped (66 KB now).
- Added `around` option to `Map` `zoomTo`/`rotateTo`.
- Made the permalink hash more compact.
- Bevel linejoins no longer overlap and look much better when drawn with transparency.

#### Bugfixes

- Fixed the **broken minified build**. [#679](https://github.com/mapbox/mapbox-gl-js/issues/679)
- Fixed **blurry icons** rendering. [#666](https://github.com/mapbox/mapbox-gl-js/issues/666)
- Fixed `util.supports` WebGL detection producing false positives in some cases. [#677](https://github.com/mapbox/mapbox-gl-js/issues/677)
- Fixed invalid font configuration completely blocking tile rendering. [#662](https://github.com/mapbox/mapbox-gl-js/issues/662)
- Fixed `Map` `project`/`unproject` to properly accept array-form values.
- Fixed sprite loading race condition. [#593](https://github.com/mapbox/mapbox-gl-js/issues/593)
- Fixed `GeoJSONSource` `setData` not updating the map until zoomed or panned. [#676](https://github.com/mapbox/mapbox-gl-js/issues/676)

## 0.2.1 (Aug 8 2014)

#### Breaking

- Changed `Navigation` control signature: now it doesn't need `map` in constructor
  and gets added with `map.addControl(nav)` or `nav.addTo(map)`.
- Updated CSS classes to have consistent naming prefixed with `mapboxgl-`.

#### Improvements

- Added attribution control (present by default, disable by passing `attributionControl: false` in options).
- Added rotation by dragging the compass control.
- Added grabbing cursors for the map by default.
- Added `util.inherit` and `util.debounce` functions.
- Changed the default debug page style to OSM Bright.
- Token replacements now support dashes.
- Improved navigation control design.

#### Bugfixes

- Fixed compass control to rotate its icon with the map.
- Fixed navigation control cursors.
- Fixed inertia going to the wrong direction in a rotated map.
- Fixed inertia race condition where error was sometimes thrown after erratic panning/zooming.

## 0.2.0 (Aug 6 2014)

- First public release.