For all three, isEnabled is changed from AND to OR semantics
Bug fixes 🐞
Fix rare line artifacts on sharp corners with short segments and non-bevel joins.
Fix ambient occlusion to not render for elevated (non-zero-base) extrusions.
Fix MapresetFeatureStates not working properly in some scoped styles.
Breaking changes ⚠️
Disable text-variable-anchor when appearances are present.
Features and improvements ✨
Introduce experimentalmap.getVerticalFieldOfView(), map.setVerticalFieldOfView(), and read-only map.getHorizontalFieldOfView() and an animatable fov camera option.
Expose line-border-width and line-border-color as public paint properties.
Introduce experimentalline-border-gradient property for rendering gradient borders on lines.
Add support for Meshopt v1 compressed models.
Support string color values for the model-color in a model source.
Add map.resetFeatureStates() to clear all feature states for a featureset or layer.
Expose map.getSchema()/map.setSchema() for managing the imported style's schema.
Extract development and debug code from the ESM bundle into a separate module.
Extract more model code from the ESM core bundle.
Extract raster-array layer as a separate ESM module.
Reduce the bundle size by restructuring style, program, symbol, and expression code.
Remove experimental flag from layer appearances.
Improve symbol layer performance.
Reduce redundant repaints and checks during initial load.
Bug fixes 🐞
Fix double rotation of the FF5C character in vertical text rendering.
Preserve live gesture when camera setter is called from inside a drag/move handler.
Stop overwriting the pointerEvents of markers set by the user.
Fix models with vertex alpha 0 appearing black.
Fix incorrect rendering of fill extrusions with fill-extrusion-edge-radius at low zoom levels in some cases.
Fix wrong access token used on multi-map environments
Fix number-format dropping min/max-fraction-digits when they were 0
Fix line-aligned label placement during globe-mercator transition
Fix crash when using style expressions with prototype-derived keys
Fix atlas cache returning another scope images
Fix Style#{get,set,remove}FeatureState with {target: {layerId}} so imported-layer targets resolve against their own fragment's sources instead of the root style's
Fix missing building along tile borders
Fix dynamic imports in UMD
Fix import.meta crash under modern bundlers
Fix setPaintProperty on symbol properties with a transition duration of 0
Breaking changes ⚠️
Remove transition and interpolated flags from the camera-projection style property — enum properties cannot be transitioned, so these flags were incorrect.
Features and improvements ✨
Make published TypeScript declarations self-contained, fixing consumer builds that failed with skipLibCheck: false.
Improve terrain raycast accuracy for mouse events, camera fitting, and other pointer interactions.
Improve landmark model LOD switching with size-based distance heuristics for better rendering performance.
Bug fixes 🐞
Fix hd-road-markup elevated lines rendering flat with zero-exaggeration terrain.
Fix viewport-y symbol sorting causing a Vertex buffer is not big enough for the draw call error when a symbol bucket had multiple segments.
Fix multilinestrings not displaying labels correctly.
Fix parametric colors sometimes loading the wrong cached image.
Breaking changes ⚠️
Switch the ESM entry point to named exports (import * as mapboxgl from 'mapbox-gl/esm') so that modern bundlers can eliminate small unused parts of the code. Replace mapboxgl.accessToken with MapaccessToken option. Most of the bundle still can't be statically eliminated, but this release also improves lazy loading of code at runtime, with more improvements on the way.
Features and improvements ✨
Extend MapgetLayerProperty and setLayerProperty to support layer-level properties (minzoom, maxzoom, filter, slot, appearances)
Extend TileProvider API to accept ImageBitmap for raster and raster-dem providers.
Improve model loading and rendering performance.
Improve symbol rendering performance.
Improve performance of decoding and encoding vector tiles and other protobuf-encoded assets.
Improve color parsing performance, slightly improving load time for styles with many color values.
Extract indoor and part of the model rendering code to be loaded on demand when using the ESM entry point.
Add GeolocateControlready event and setShowAccuracyCircle, setShowUserHeading, setFitBoundsOptions, setShowUserLocation methods.