@lugg/maps 1.0.0-beta.9 → 1.1.0

package/ios/core/MapProviderDelegate.h

@@ -13,6 +13,8 @@ NS_ASSUME_NONNULL_BEGIN
 
 @protocol MapProviderDelegate <NSObject>
 - (void)mapProviderDidReady;
+- (void)mapProviderDidFinishStaticSnapshot;
+- (void)mapProviderDidCaptureStaticImage:(UIImage *)image;
 - (void)mapProviderDidMoveCamera:(double)latitude
                        longitude:(double)longitude
                             zoom:(double)zoom
@@ -36,6 +38,10 @@ NS_ASSUME_NONNULL_BEGIN
 @property(nonatomic, weak, nullable) id<MapProviderDelegate> delegate;
 @property(nonatomic, readonly) BOOL isMapReady;
 
+// Non-interactive static map. Must be set before initializeMapInView.
+// Once fully rendered, the live map is replaced with a snapshot image.
+@property(nonatomic, assign) BOOL staticMode;
+
 - (void)initializeMapInView:(UIView *)wrapperView
           initialCoordinate:(CLLocationCoordinate2D)coordinate
                 initialZoom:(double)zoom;
@@ -48,6 +54,7 @@ NS_ASSUME_NONNULL_BEGIN
 - (void)setScrollEnabled:(BOOL)enabled;
 - (void)setRotateEnabled:(BOOL)enabled;
 - (void)setPitchEnabled:(BOOL)enabled;
+- (void)setCompassEnabled:(BOOL)enabled;
 - (void)setUserLocationEnabled:(BOOL)enabled;
 - (void)setMapType:(facebook::react::LuggMapViewMapType)mapType;
 - (void)setTheme:(facebook::react::LuggMapViewTheme)theme;
@@ -82,6 +89,10 @@ NS_ASSUME_NONNULL_BEGIN
 - (void)removeTileOverlayView:(LuggTileOverlayView *)tileOverlayView;
 - (void)syncTileOverlayView:(LuggTileOverlayView *)tileOverlayView;
 
+// Current camera (the initial camera until the map is ready)
+@property(nonatomic, readonly) CLLocationCoordinate2D coordinate;
+@property(nonatomic, readonly) double zoom;
+
 // Lifecycle
 - (void)pauseAnimations;
 - (void)resumeAnimations;

package/ios/core/StaticMapProviderBase.h

@@ -0,0 +1,80 @@
+#import "MapProviderDelegate.h"
+#import <MapKit/MapKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// Projects a coordinate into view points for a static map covering mapRect
+CGPoint LuggStaticPointForCoordinate(MKMapRect mapRect, CGSize size,
+                                     CLLocationCoordinate2D coordinate);
+
+/**
+ * Shared behavior for static (non-interactive) map providers - the iOS
+ * equivalent of Android's lite mode. The base map renders asynchronously
+ * (subclass-specific), so static maps keep loading while the user scrolls
+ * without blocking the main thread.
+ *
+ * Markers are live views positioned over the base map via a mercator
+ * projection (mirroring Android's live markers on lite maps), so async
+ * marker content (e.g. remote images) still updates when it loads.
+ * Polylines, polygons, circles and ground overlays are drawn into a
+ * single CoreGraphics overlay view. All overlays stay hidden over the
+ * placeholder and reveal together with the base map. Tile overlays are
+ * not supported.
+ */
+@interface StaticMapProviderBase : NSObject <MapProvider>
+
+/// Previously captured base map for the same cache key; when set, the base
+/// render is skipped and the image is shown immediately.
+@property(nonatomic, strong, nullable) UIImage *cachedBaseImage;
+
+// State for subclasses
+@property(nonatomic, readonly, nullable) UIView *wrapperView;
+@property(nonatomic, readonly) CLLocationCoordinate2D coordinate;
+@property(nonatomic, readonly) double zoom;
+@property(nonatomic, readonly) MKMapRect mapRect;
+@property(nonatomic, readonly) CGSize projectedSize;
+@property(nonatomic, readonly) UIEdgeInsets edgeInsets;
+@property(nonatomic, readonly) BOOL projectionReady;
+@property(nonatomic, readonly) facebook::react::LuggMapViewMapType mapType;
+@property(nonatomic, readonly) facebook::react::LuggMapViewTheme theme;
+
+/// Shows the base image below the overlays, emits the static snapshot
+/// delegate callbacks and marks the base render done.
+- (void)displayBaseImage:(UIImage *)image fromCache:(BOOL)fromCache;
+
+/// Discards any cached, displayed or in-flight base render and renders
+/// again at the current camera. The displayed image stays until the new
+/// one replaces it.
+- (void)rerenderBaseMap;
+
+/// Shows the marker and shape overlays (idempotent). Called automatically
+/// when the base image displays; subclasses whose base map is already
+/// visible earlier (e.g. a live warmup map) can call it sooner.
+- (void)revealOverlays;
+
+#pragma mark - Subclass hooks
+
+/// The map rect the base render covers for the given view size; must match
+/// the SDK's camera framing so overlays align with the base map exactly.
+- (MKMapRect)mapRectForSize:(CGSize)size;
+
+/// Overlay view shown for markers without a custom child view.
+- (UIView *)newDefaultMarkerOverlayView;
+
+/// Zoom level at which the base map renders at the given scale (map points
+/// per view point) for the current coordinate and view size; the inverse of
+/// mapRectForSize. Used by fitCoordinates.
+- (double)zoomForMapPointsPerPoint:(double)mapPointsPerPoint;
+
+/// Starts rendering the base map for the current projection (guaranteed
+/// projectionReady, no cached image). Called after mount (once initial
+/// props have applied), after a resize, and from resumeAnimations to retry
+/// a failed or cancelled render (e.g. device back online).
+- (void)renderBaseMap;
+
+/// Cancels an in-flight base render (resize or teardown).
+- (void)cancelBaseRender;
+
+@end
+
+NS_ASSUME_NONNULL_END