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.

v3.16.0-beta.1

Features and improvements ✨

• Add response headers to the sourcedata event data.
• Improve TypeScript types for style specification.

Bug fixes 🐞

• 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.15.0

3.15.0

Features and improvements ✨

• Add queryRasterValue method for querying values in raster-array layers.
• Add icon-image-use-theme property.
• Add support for Mapbox vector tiles with precalculated line metrics (for line gradients).
• Improve HD Roads loading performance.
• Optimize applying LUT when updating images at runtime.
• Improve TypeScript types in Style Spec validation methods.
• Slightly improve hsla expression performance.
• Optimize applying LUT for patterns.
• Round queryRasterValue results to 12 decimal digits to fix precision issues.
• Improvements on typing and testing.

Bug fixes 🐞

• Fix an issue with refreshing expired raster array tiles.
• Fix an error on GeoJSON with "Infinity" and similar ids.
• Fix GL_INVALID_VALUE console warning on Mapbox Satellite Standard and a few other styles.
• Fix model layer positioning during globe to mercator transition.
• Fix an issue with incorrect transparency for some icons with LUT applied.
• Fix an issue where updating *-occlusion-opacity properties didn't have any effect.
• Fix an issue with MRT layers throwing an error when reloading.
• Fix occlusion layer ordering.
• Fix an issue where using too many data-driven properties on the symbol layer could break the map.
• Fix gradients and interpolations with fully-transparent colors.
• Fix model layer density reduction.
• Fix performance regression on styles that use feature-state expressions.

v3.15.0-beta.2

3.15.0-beta.2

Features and improvements ✨

• Slightly improve hsla expression performance.
• Optimize applying LUT for patterns.
• Round queryRasterValue results to 12 decimal digits to fix precision issues.

Bug fixes 🐞

• Fix an error on GeoJSON with `"Infinity"`` and similar ids.
• Fix GL_INVALID_VALUE console warning on Mapbox Satellite Standard and a few other styles.
• Fix model layer positioning during globe to mercator transition.
• Fix an issue with incorrect transparency for some icons with LUT applied.
• Fix an issue where updating *-occlusion-opacity properties didn't have any effect.

v3.15.0-beta.1

Features and improvements ✨

• Add queryRasterValue method for querying values in raster-array layers.
• Add icon-image-use-theme property.
• Add support for Mapbox vector tiles with precalculated line metrics (for line gradients).
• Improve HD Roads loading performance.
• Optimize applying LUT when updating images at runtime.
• Improve TypeScript types in Style Spec validation methods.

Bug fixes 🐞

• Fix an issue with refreshing expired raster array tiles.