v3.19.0-beta.1

Features and improvements ✨

• Fix z-fighting for elevated raster layers.
• Add raster-elevation-reference paint property to elevate raster layers relative to ground instead of sea level.
• Add line-elevation-ground-scale layout property to scale elevated lines with terrain exaggeration.
• Use native async/await when loading models. Note: Please ensure GL JS is excluded from transpilation in your build setup.
• Explicitly state minimum supported browser versions in browserslist.

Bug fixes 🐞

• Fix regressions in NavigationControl.
• Fix namespace conflicts in different featuresets' selectors.
• Recalculate layers with visibility: none in case properties were changed.
• Fix bug in border update logic of fill-extrusion layer, overriding clip layer's behaviour.

v3.18.1

Features and improvements ✨

• Add support for visibility property in clip layers.
• Improve raster-color precision for fine-grained value ranges.

Bug fixes 🐞

• Fix color interpolation throwing errors in edge cases.
• Fix appearances with no icon-size.
• Fix disappearing symbols when used with elevated raster layers.

v3.18.0

Features and improvements ✨

• Add scaleFactor support for images within text-field.
• Add showButton option to GeolocateControl that allows hiding the control button.
• Add followUserLocation option and setFollowUserLocation method to GeolocateControl to control whether the map follows the user's location.
• Improve GeolocateControl timeout handling.
• Add support for text-rotate, text-size, and text-offset properties in appearances.
• Add shadow-draw-before-layer property to directional light, allowing control over shadow draw order in the layer stack.
• Add model-allow-density-reduction property to model layers. (h/t @JoshuaJMoore)

Bug fixes 🐞

• Fix interaction handlers not working on model layers.
• Fix stretchable icons without icon-text-fit rendering with an incorrect size.
• Fix icon-size not working correctly with coalesce expressions.
• Fix raster-color interpolation when using nearest raster-resampling.
• Fix render cut off for elevated raster-layer rendering in ortho projection range.
• Fix symbol placement with optional and missing parts.
• Expose all error properties for GeolocateControl error event (h/t @lucavb).
• Fix an error when querying multipolygons in dynamic: true mode.
• Fix AttributionControl links sanitization.
• Fix appearances with no icon-size using the default value instead of the layout-defined one.
• Fix updates to model source via ModelSource.setModels while models are still loading.
• Fix polygon clipping precision errors causing rendering artifacts in elevated structures.
• Preserve featuresets in map.getStyle() output.
• Expose TypeScript types from @mapbox/mapbox-gl-style-spec for direct imports.

v3.18.0-beta.2

Features and improvements ✨

• Add showButton option to GeolocateControl that allows hiding the control button.
• Add followUserLocation option and setFollowUserLocation method to GeolocateControl to control whether the map follows the user's location.
• Improve GeolocateControl timeout handling.

Bug fixes 🐞

• Fix stretchable icons without icon-text-fit rendering with an incorrect size.
• Fix icon-size not working correctly with coalesce expressions.
• Fix render cut off for elevated raster-layer rendering in ortho projection range.
• Fix symbol placement with optional and missing parts.
• Expose all error properties for GeolocateControl error event (h/t @lucavb).

v3.18.0-beta.1

Features and improvements ✨

• Add support for text-rotate, text-size, and text-offset properties in appearances.
• Add shadow-draw-before-layer property to directional light, allowing control over shadow draw order in the layer stack.
• Add model-allow-density-reduction property to model layers. (h/t @JoshuaJMoore)

Bug fixes 🐞

• Fix an error when querying multipolygons in dynamic: true mode.
• Fix AttributionControl links sanitization.
• Fix appearances with no icon-size using the default value instead of the layout-defined one.
• Fix updates to model source via ModelSource.setModels while models are still loading.
• Fix polygon clipping precision errors causing rendering artifacts in elevated structures.
• Preserve featuresets in map.getStyle() output.
• Expose TypeScript types from @mapbox/mapbox-gl-style-spec for direct imports.

v3.17.0

Features and improvements ✨

• Add experimental ESM support.
• Make line-emissive-strength data-driven.
• Remove experimental flag from the extra_bounds property of raster and vector sources.
• Remove experimental flag from model layer.
• Remove experimental flag from building layer.
• Improve vector icons rasterization performance.
• Improve shadow rendering performance.
• Improve building layer performance.
• Improve shader initialization performance.

Bug fixes 🐞

• Fix polygon rendering for dynamic GeoJSON sources.
• Fix raster-array layers not working on iOS < 18.4.
• Fix a performance issue for symbol layers with zero fade duration and static camera.
• Fix occasional WebGL texture warnings when rendering terrain.
• Fix features not being localized in dynamic filters when a worldview is set.
• Fix an issue with clipping models on Standard.
• Fix an issue with models flashing on setData.
• Fix an issue with incorrect scoping of models added during runtime.
• Fix line patterns not elevating properly on HD roads.
• Sanitize attributions in AttributionControl.
• Correctly support filtered features in appearances.
• Fix an issue occuring when expressions are used in appearances.
• Fix appearance optimization that resulted in wrong appearances being rendered.
• Fix appearance icons not changing when feature state changed multiple times.
• Improve TypeScript types.

v3.17.0-beta.2

Features and improvements ✨

• Make line-emissive-strength data-driven.
• Remove experimental flag from the extra_bounds property of raster and vector sources.
• Various performance improvements.

Bug fixes 🐞

• Fix features not being localized in dynamic filters when a worldview is set.
• Correctly support filtered features in appearances.
• Fix an issue occuring when expressions are used in appearances.

v3.17.0-beta.1

Features and improvements ✨

• Experimental ESM support.
• Remove experimental flag from model layer.
• Conflate building parts together as a whole building.

Bug fixes 🐞

• Fix line patterns not elevating properly on HD roads.
• Sanitize attributions in AttributionControl.
• Fix appearance optimization that resulted in wrong appearances being rendered.

v3.16.0

Features and improvements ✨

• Introduce experimental Appearances API for managing layer styling based on feature state.
• Add Map setLayerProperty that combines setLayoutProperty & setPaintProperty into one method for convenience.
• Add support for node/material overrides & other improvements to model source and layer.
• Various improvements & fixes for upcoming 3D features (indoor, procedural buildings & elevated roads).
• Add response headers to the sourcedata event data.
• Improve TypeScript types for style specification.

Bug fixes 🐞

• Fix raster particle layer not rendering correctly on styles with emissive light.
• Fix icons of different sizes rendering incorrectly in appearances.
• Fix worldview filtering with dynamic expressions.
• Improve accuracy of queryRenderedFeatures for model layers.
• Fix a bug with heatmap sometimes disappearing after switching projection.
• Fix rendering of model layer with vector source on globe projection.
• Fix flickering of fill-extrusion buildings when using clip layers.
• Fix inaccuracies in 3D model query intersection.
• Fix the passing of GeolocationPosition to geolocate event listeners.
• Fix the placement of line-aligned text with a non-default scaleFactor.

v3.16.0-beta.2

Features and improvements ✨

• Introduce experimental Appearances API for managing layer styling based on feature state.
• Add Map setLayerProperty that combines setLayoutProperty & setPaintProperty into one method for convenience.
• Add support for node/material overrides & other improvements to model source and layer.
• Various improvements & fixes for upcoming 3D features (indoor, procedural buildings & elevated roads).

Bug fixes 🐞

• Improve accuracy of queryRenderedFeatures for model layers.
• Fix a bug with heatmap sometimes disappearing after switching projection.
• Fix rendering of model layer with vector source on globe projection.