v0.23.0

[gabbopalma]

What's Changed

This consolidated release delivers runtime style switching, hover interactions, heatmap & visibility features, native SDK updates, and broad naming / enum casing harmonization. It also fixes several interaction and stability issues across web and mobile.

If you are upgrading from <= 0.22.x:

• Review the breaking rename (Maplibre -> MapLibre) and enum / const lowerCamelCase migration.
• Adapt feature interaction callbacks: onFeatureTapped / onFeatureDrag now receive an Annotation instead of an id argument.
• Ensure any style access happens after onStyleLoaded due to stricter style readiness checks.

A big thank you to everyone who contributed to this update!

Warning

Breaking changes

• Rename Maplibre to MapLibre across APIs (feat!: rename Maplibre to MapLibre #441).
• Enum fields & const identifiers migrated to lower camel case (feat!: use lower camel case for enum fields and consts #415).
• onFeatureTapped / onFeatureDrag replaced the raw id parameter with an Annotation annotation instance (update handler signatures).

Added / Features

• Runtime style switching APIs on controller (feat: added set style method on controller #444) and raw style JSON setting on iOS / Web (Support setting style JSON on iOS, web #603).
• Hover interaction events (onFeatureHover) (Expose hovering events #614).
• Heatmap layer support (feat: heatmap layer #365).
• Bounds fitting API to change viewport to given bounds (feat: add support for changing the receiver’s viewport to fit given bounds #133).
• Layer visibility control (feat: Set layer visibility #138).
• LatLngBounds.contains convenience (feat: contains method for LatLngBounds #498).

Changed / Updates

• MapLibre Native: Android 11.13.5 & iOS 6.19.1.
• Flutter / Gradle plugin & tooling compatibility update (feat: upgrade FGP & compatible with flutter 3.29.0 #542).
• Lint and analysis alignment via very_good_analysis and flutter_lints (refactor: enable and fix some lint rules #452, feat: use lints from very_good_analysis #434, feat: add flutter_lints, fix or ignore lints #414, feat: allow latest flutter_lints version #419).
• Package link updates & style resource relocation (MaplibreStyles moved to main package) (refactor: move MaplibreStyles to maplibre_gl #435, feat: update package links in pubspec.yaml files #413).

Fixed

• iOS code generation (Offset / Translate / expression arrays) (Fix: Update of generate.dart and its template files. Fixed Offset, Translate and expressions arrays on iOS. #481).
• Annotation tap consumption now properly respected (annotationConsumeTapEvents).
• Prevent calling notifyListeners() after controller disposal (Prevented calling notifyListeners() after the controller is disposed. #621).
• Web: event listener cancellation & hover handling robustness (Fixed: Event listener cancellation and hover handling on web. #623).
• Offline region download crash in example (Fix offline region download crashing the example app #569).
• Added style loaded safety checks (Added checks if style is fully loaded before accessing it #563).
• Aligned example and web pubspec versions (Fix: Aligned example and maplibre_gl_web pubspec versions. #476).
• Web: enforce maplibre-gl-js 4.x & remove shadow root stylesheet workaround (fix(web): ensure the usage of maplibre-gl-js version 4.x.x, remove _addStylesheetToShadowRoot #409).

Refactor / Quality

• Enable and fix additional lint rules (refactor: enable and fix some lint rules #452).

New Contributors

• @louwers made their first contribution in Add MapLibre logo to README.md #589
• @mhernz made their first contribution in Remove unnecessary long press delay on iOS #600

Contributors:

@AlexanderThiele, @mhernz, @TarekTolba1, @srmncnk, @itheamc, @kuhnroyal, @albertmoravec, @gabbopalma

Full Changelog: v0.22.0...v0.23.0

---

This discussion was created from the release v0.23.0.