marker_widget 2.0.0

Render Flutter widgets into google_maps_flutter bitmaps, glyphs, markers, and ground overlays with caching and modern Flutter View APIs.

Changelog

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.0.0 - 2026-03-08

Breaking

• Removed MarkerIconScalingMode.
• Replaced the old flat scaling parameters with:
  • WidgetBitmapRenderOptions for off-screen rendering
  • MapBitmapOptions for map bitmap output
• Updated MarkerIconRenderer.render() to accept WidgetBitmapRenderOptions.
• Renamed Widget.toMarkerBitmap() to Widget.toBitmapDescriptor().
• Removed the top-level widgetTo* helpers in favor of widget extensions with optional named context.
• Removed MarkerBuildOptions and AdvancedMarkerBuildOptions. Marker builder APIs now accept real upstream Marker and AdvancedMarker objects.
• Updated widget extensions to use optional named context, renderOptions, and bitmapOptions.
• Replaced MapBitmapOptions.renderedDpr() with MapBitmapOptions.pixelPerfect().
• Raised the minimum supported SDK versions to Flutter 3.41.4 and Dart 3.10.

Added

• MapBitmapOptions and WidgetBitmapRenderOptions value objects.
• MapBitmapOptions.pixelPerfect() for pixel-perfect display using the rendered widget DPR.
• MarkerIcon.toGroundOverlayBitmap().
• MarkerIcon.toBitmapGlyph().
• MarkerIcon.toPinConfig().
• MarkerIcon.toMarker() and MarkerIcon.toAdvancedMarker().
• MarkerIcon.toAdvancedPinMarker() for one-call widget-to-pin-marker flow.
• Widget extension helpers:
  • toGroundOverlayBitmap()
  • toBitmapGlyph()
  • toPinConfig()
  • toMarker()
  • toAdvancedMarker()
  • toAdvancedPinMarker()
• buildClusterCacheKey().
• buildMarkerCacheKey(extra: ...) for additional visual-state cache inputs.
• defaultMarkerIconRenderer exposed for cache inspection, clearing, and prewarming.
• Equatable on all value objects for structural equality.
• Curated re-exports for advanced marker types that are missing from google_maps_flutter.

Changed

• MapBitmapScaling.none is now supported through raw bitmap conversion.
• toGroundOverlayBitmap() is a discoverability alias for the raw MapBitmapScaling.none path.
• Renderer context capture now includes Localizations and DefaultAssetBundle, not just themes and MediaQuery.
• Cache invalidation now blocks stale in-flight renders from repopulating cache after clearCache() or removeFromCache().
• README and example app now demonstrate base Marker / AdvancedMarker inputs, advanced marker pins, and ground overlays.

1.1.0 - 2025-12-04

Added

• MarkerIcon.toMapBitmap(): Returns BytesMapBitmap directly for users who need the concrete type for storage or interoperability.
• MarkerIcon.sizeInBytes: Getter for memory tracking.
• Memory-based cache eviction: New maxCacheBytes parameter (default 50 MB) on MarkerIconRenderer to prevent unbounded memory growth.
• Concurrent render deduplication: Multiple simultaneous calls with the same cacheKey now share a single render operation instead of duplicating work.
• Cache introspection:
  • MarkerIconRenderer.cacheSize — current entry count.
  • MarkerIconRenderer.cacheSizeInBytes — current memory usage.
  • MarkerIconRenderer.isCached(key) — check if a key exists.
  • MarkerIconRenderer.peekCache(key) — get without LRU bump.
• New extension methods on Widget:
  • toMapBitmap() — returns BytesMapBitmap directly.
  • toMarkerIcon() — returns MarkerIcon for storage and later conversion.
• New standalone functions:
  • widgetToMapBitmap() — convenience without BuildContext, returns BytesMapBitmap.
  • widgetToMarkerIcon() — convenience without BuildContext, returns MarkerIcon.
• @immutable annotation on MarkerIcon for correctness.
• Enhanced documentation: Added "Render Once, Reuse Everywhere" pattern examples in README and class docs.

Changed

• MapBitmapScaling.none validation: Now throws StateError for both scaling modes (not just imagePixelRatio). This was already invalid at the platform level; the error message is now clearer and fails earlier.
• Improved code style: explicit type annotations throughout for better readability.
• Updated README with performance tips, memory management guidance, and static vs dynamic marker strategies.

1.0.0 - 2025-11-24

Added

• Initial release of marker_widget.
• Off-screen renderer that converts any Widget into PNG bytes using:
  • RenderView + ViewConfiguration with logical & physical constraints.
  • RepaintBoundary and explicit PipelineOwner / BuildOwner lifecycle.
• MarkerIcon value object that encapsulates:
  • PNG bytes.
  • Logical size.
  • Device pixel ratio.
  • Conversion to BitmapDescriptor.bytes with MapBitmapScaling.
• MarkerIconRenderer:
  • Configurable default logical size.
  • Optional LRU-based in-memory cache with size limit.
  • Optional image-aware second pass via waitForImages.
• MarkerIconScalingMode:
  • logicalSize mode (stable logical size, default).
  • imagePixelRatio mode (pixel-perfect using imagePixelRatio).
• WidgetMarkerExtension.toMarkerBitmap:
  • Convert any widget into a BitmapDescriptor using the default (or injected) renderer.
  • Supports waitForImages, custom pixel ratio, bitmap scaling, and scaling mode.
• Top-level widgetToMarkerBitmap helper for use without a BuildContext.
• buildMarkerCacheKey helper for theme/locale/size-aware marker caching.
• Example app demonstrating:
  • Basic usage with a custom card-like marker.
  • Toggling between logical-size and image-pixel-ratio scaling modes.