Maplibre

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 `MapremoveFeatureState` 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) (h/t [jutaz](https://github.com/jutaz))

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

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)) (h/t [elyobo](https://github.com/elyobo))
- Remove popups on `Mapremove` ([7749](https://github.com/mapbox/mapbox-gl-js/pull/7749)) (h/t [andycalder](https://github.com/andycalder))
- Add `MapremoveFeatureState` ([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)) (h/t [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))

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)) (h/t [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)) (h/t [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)) (h/t [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)) (h/t [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)) (h/t [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))

November 7, 2018

✨ Features and improvements

- Add initial bounds as map constructor option ([5518](https://github.com/mapbox/mapbox-gl-js/pull/5518)) (h/t [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)) (h/t [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)) (h/t [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)) (h/t [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)) (h/t [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))

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)) (h/t [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)) (h/t [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))