@maydon_tech/react-native-nitro-maps 0.1.4 → 0.2.1

package/lib/typescript/src/index.d.ts

@@ -1,12 +1,25 @@
 export { NitroMap, default } from './components/NitroMap';
 export { PriceMarker } from './components/PriceMarker';
 export { ImageMarker } from './components/ImageMarker';
+export { Marker } from './components/Marker';
+export { NitroPolyline } from './components/NitroPolyline';
+export { NitroPolygon } from './components/NitroPolygon';
+export { NitroCircle } from './components/NitroCircle';
 export type { NitroMapProps, NitroMapRef } from './components/NitroMap';
-export type { Region, Coordinate, MapType, MapPressEvent, RegionChangeEvent, EdgePadding, Camera, MapBoundaries, MapStyleElement, MapStyler, MapProvider, MapStyle, MapError, Point, } from './types/map';
-export type { MarkerStyle, PriceMarkerStyle, MarkerColor, PriceMarkerConfig, ImageMarkerConfig, ClusterPressEvent, ClusterConfig, ClusterStrategy, ClusterAnimationStyle, MarkerAnimation, MarkerConfig, MarkerData, MarkerDragEvent, MarkerPressEvent, } from './types/marker';
+export type { NitroMapMethods } from './specs/NitroMap.nitro';
+export { NitroMapContext } from './context/NitroMapContext';
+export type { NitroMapContextValue } from './context/NitroMapContext';
+export type { Region, Coordinate, MapType, MapPressEvent, RegionChangeEvent, EdgePadding, Camera, MapBoundaries, MapStyleElement, MapStyler, MapProvider, MapStyle, MapError, Point, UserLocationChangeEvent, UserTrackingMode, } from './types/map';
+export type { MarkerStyle, PriceMarkerStyle, MarkerColor, ImageMarkerConfig, ClusterPressEvent, ClusterConfig, ClusterStrategy, MarkerAnimation, MarkerConfig, MarkerData, MarkerDragEvent, MarkerPressEvent, } from './types/marker';
+export type { CoordinateRing, PolylineData, PolygonData, CircleData, } from './types/overlay';
+export type { GoogleMapTheme, AppleMapTheme, YandexMapTheme, ThemeForProvider, MapTheme, } from './types/theme';
 export { NitroMapInitialize, IsNitroMapInitialized, getDefaultProvider, type NitroMapInitConfig, } from './modules';
 export type { PriceMarkerProps } from './components/PriceMarker';
 export type { ImageMarkerProps } from './components/ImageMarker';
+export type { MarkerProps } from './components/Marker';
+export type { NitroPolylineProps } from './components/NitroPolyline';
+export type { NitroPolygonProps } from './components/NitroPolygon';
+export type { NitroCircleProps } from './components/NitroCircle';
 export { rgb, hex, Colors } from './utils/colors';
 export type { ColorValue } from './utils/colors';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAExE,YAAY,EACV,MAAM,EACN,UAAU,EACV,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,KAAK,GACN,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAInB,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,YAAY,EACV,MAAM,EACN,UAAU,EACV,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAInB,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/src/specs/NitroMap.nitro.d.ts

@@ -1,6 +1,7 @@
 import type { HybridView, HybridViewMethods, HybridViewProps } from 'react-native-nitro-modules';
-import type { Camera, Coordinate, EdgePadding, MapBoundaries, MapError, MapPressEvent, MapProvider, MapStyle, MapType, Region, RegionChangeEvent } from '../types/map';
+import type { Camera, Coordinate, EdgePadding, MapBoundaries, MapError, MapPressEvent, MapProvider, MapStyle, MapType, Point, Region, RegionChangeEvent, UserLocationChangeEvent, UserTrackingMode } from '../types/map';
 import type { ClusterConfig, ClusterPressEvent, MarkerData, MarkerDragEvent, MarkerPressEvent } from '../types/marker';
+import type { PolylineData, PolygonData, CircleData } from '../types/overlay';
 /**
  * Props for the NitroMap component
  */
@@ -24,6 +25,23 @@ export interface NitroMapProps extends HybridViewProps {
      * ```
      */
     initialRegion?: Region;
+    /**
+     * Controlled region prop — moves the camera whenever the value changes.
+     *
+     * Unlike `initialRegion` (set once on mount) or the imperative
+     * `animateToRegion()` (called via ref), this is **declarative**:
+     * updating the state that feeds this prop re-renders and moves the camera.
+     *
+     * Pass `undefined` to stop controlling the region.
+     *
+     * @example
+     * ```tsx
+     * const [region, setRegion] = useState<Region>();
+     * <NitroMap region={region} />
+     * <Button onPress={() => setRegion({ latitude: 40.7, longitude: -74, latitudeDelta: 0.05, longitudeDelta: 0.05 })} />
+     * ```
+     */
+    region?: Region;
     /**
      * Show the user's current location on the map
      * Requires location permissions
@@ -59,24 +77,87 @@ export interface NitroMapProps extends HybridViewProps {
      */
     mapType?: MapType;
     /**
-     * Custom JSON styling for the map
+     * Custom JSON styling for the map.
+     * Currently uses Google Maps JSON format. Future providers (Apple, Yandex)
+     * will need provider-specific styling approaches.
      * @see https://mapstyle.withgoogle.com/
      */
     customMapStyle?: MapStyle;
     /**
-     * Show the "my location" button on the map
+     * Configuration for marker clustering behavior
+     */
+    clusterConfig?: ClusterConfig;
+    /**
+     * Padding around the map edges to offset the map center and controls.
+     * Use when UI elements (navigation bars, bottom sheets) cover parts of the map.
+     * Values are in pixels (React Native logical pixels).
+     */
+    mapPadding: EdgePadding;
+    /**
+     * Show real-time traffic conditions overlay on the map.
+     * Displays colored road segments indicating traffic flow.
+     * @default false
+     */
+    showsTraffic?: boolean;
+    /**
+     * Show 3D building models on the map when zoomed in.
      * @default true
      */
-    showsMyLocationButton?: boolean;
+    showsBuildings?: boolean;
     /**
-     * Configuration for marker clustering behavior
+     * Show the compass indicator on the map.
+     * The compass appears when the map is rotated away from north.
+     * @default true
      */
-    clusterConfig?: ClusterConfig;
+    showsCompass?: boolean;
+    /**
+     * Minimum zoom level the user can zoom out to.
+     * Google Maps range: 1 (world) to 22 (building).
+     * @default 1
+     */
+    minZoom: number;
+    /**
+     * Maximum zoom level the user can zoom in to.
+     * Google Maps range: 1 (world) to 22 (building).
+     * @default 22
+     */
+    maxZoom: number;
     /**
      * Enable dark mode styling for the map
      * @default false
      */
     darkMode?: boolean;
+    /**
+     * User tracking mode for automatic camera following.
+     * - `'none'` - No tracking (default)
+     * - `'follow'` - Camera follows the user's position
+     * - `'followWithHeading'` - Camera follows and rotates with heading
+     * Requires `showsUserLocation={true}`.
+     * @default 'none'
+     */
+    userTrackingMode?: UserTrackingMode;
+    /**
+     * Custom image URL for the user location marker.
+     * When set to a non-empty string, replaces the default blue dot with a custom marker.
+     * Supports remote URLs (https://) and local asset names.
+     * Set to `''` (empty string) to use the default blue dot.
+     * Requires `showsUserLocation={true}`.
+     * @default ''
+     */
+    userLocationImage: string;
+    /**
+     * Size of the custom user location marker in points.
+     * Only applies when `userLocationImage` is set.
+     * @default 40
+     */
+    userLocationSize: number;
+    /**
+     * Anchor point for the custom user location marker.
+     * Values are in 0-1 range: {x: 0, y: 0} = top-left, {x: 0.5, y: 0.5} = center.
+     * Only applies when `userLocationImage` is set.
+     * @default { x: 0.5, y: 0.5 }
+     */
+    userLocationAnchor?: Point;
     /**
      * Called when the user taps on the map (not on a marker)
      * @param event - Contains the coordinate and screen position of the tap
@@ -128,11 +209,77 @@ export interface NitroMapProps extends HybridViewProps {
      * @param event - Contains the cluster coordinate, marker IDs, and count
      */
     onClusterPress?: (event: ClusterPressEvent) => void;
+    /**
+     * Called when a tappable polyline is tapped.
+     * Requires `tappable={true}` on the `<NitroPolyline>`.
+     * @param id - The polyline ID
+     */
+    onPolylinePress?: (id: string) => void;
+    /**
+     * Called when a tappable polygon is tapped.
+     * Requires `tappable={true}` on the `<NitroPolygon>`.
+     * @param id - The polygon ID
+     */
+    onPolygonPress?: (id: string) => void;
+    /**
+     * Called when a tappable circle is tapped.
+     * Requires `tappable={true}` on the `<NitroCircle>`.
+     * @param id - The circle ID
+     */
+    onCirclePress?: (id: string) => void;
     /**
      * Called when an error occurs in the map or marker operations
      * @param error - Error information with code and message
      */
     onError?: (error: MapError) => void;
+    /**
+     * Called when the user's location changes.
+     * Requires `showsUserLocation={true}`.
+     * @param event - Contains coordinate, accuracy, and heading
+     */
+    onUserLocationChange?: (event: UserLocationChangeEvent) => void;
+    /**
+     * Called when the library changes the tracking mode internally.
+     * For example, when the user pans the map during follow/heading mode,
+     * tracking is automatically disabled. Update your state accordingly:
+     *
+     * @example
+     * ```tsx
+     * onUserTrackingModeChange={(mode) => setTrackingMode(mode)}
+     * ```
+     */
+    onUserTrackingModeChange?: (mode: UserTrackingMode) => void;
+    /**
+     * Called when location services fail (e.g. permission denied, location unavailable).
+     * Requires `showsUserLocation={true}`.
+     *
+     * @example
+     * ```tsx
+     * onUserLocationError={(error) => {
+     *   if (error.code === 'LOCATION_PERMISSION_DENIED') {
+     *     showPermissionDialog();
+     *   }
+     * }}
+     * ```
+     */
+    onUserLocationError?: (error: MapError) => void;
+    /**
+     * Called when the map becomes fully idle — no pending animations,
+     * no active user gestures, all tiles loaded.
+     *
+     * **How it differs from `onRegionChangeComplete`:**
+     * - `onRegionChangeComplete` fires after each individual gesture or animation ends.
+     * - `onMapIdle` fires once when the map is completely settled.
+     *
+     * **Use case:** Fetch data for the visible region only after the user has
+     * finished navigating (not during every intermediate pan/zoom).
+     *
+     * @example
+     * ```tsx
+     * onMapIdle={() => fetchListingsForRegion(currentRegion)}
+     * ```
+     */
+    onMapIdle?: () => void;
 }
 /**
  * Methods available on the NitroMap ref
@@ -152,6 +299,14 @@ export interface NitroMapMethods extends HybridViewMethods {
      * @param animated - Whether to animate the transition (default: true)
      */
     fitToCoordinates(coordinates: Coordinate[], edgePadding?: EdgePadding, animated?: boolean): void;
+    /**
+     * Fit the map to show markers by their IDs.
+     * Looks up marker coordinates internally.
+     * @param markerIds - Array of marker IDs to fit
+     * @param edgePadding - Optional padding from edges
+     * @param animated - Whether to animate the transition (default: true)
+     */
+    fitToSuppliedMarkers(markerIds: string[], edgePadding?: EdgePadding, animated?: boolean): void;
     /**
      * Animate the camera to a specific position
      * @param camera - Target camera configuration
@@ -178,6 +333,31 @@ export interface NitroMapMethods extends HybridViewMethods {
      * @returns Promise resolving to northeast/southwest corners
      */
     getMapBoundaries(): Promise<MapBoundaries>;
+    /**
+     * Animate the camera to the user's current location.
+     * Requires `showsUserLocation={true}` and location permissions.
+     * No-op if the user's location is not yet available.
+     *
+     * @example
+     * ```tsx
+     * <TouchableOpacity onPress={() => mapRef.current?.centerOnUserLocation()}>
+     *   <Text>📍 My Location</Text>
+     * </TouchableOpacity>
+     * ```
+     */
+    centerOnUserLocation(): void;
+    /**
+     * Convert a geographic coordinate to a screen point.
+     * @param coordinate - Geographic coordinate (latitude/longitude)
+     * @returns Screen point in pixels (React Native logical pixels, not physical)
+     */
+    pointForCoordinate(coordinate: Coordinate): Point;
+    /**
+     * Convert a screen point to a geographic coordinate.
+     * @param point - Screen point in pixels (React Native logical pixels)
+     * @returns Geographic coordinate (latitude/longitude)
+     */
+    coordinateForPoint(point: Point): Coordinate;
     /**
      * Enable or disable dark mode styling
      * @param enabled - Whether dark mode should be enabled
@@ -208,6 +388,11 @@ export interface NitroMapMethods extends HybridViewMethods {
      * @param id - ID of the marker to select
      */
     selectMarker(id: string): void;
+    /**
+     * Deselect the currently selected marker and dismiss its info window.
+     * No-op if no marker is selected.
+     */
+    deselectMarker(): void;
     /**
      * Remove all markers from the map
      */
@@ -222,6 +407,63 @@ export interface NitroMapMethods extends HybridViewMethods {
      * Call after dynamically adding/removing markers
      */
     refreshClusters(): void;
+    /**
+     * Add a polyline overlay to the map
+     * @param polyline - Polyline data configuration
+     */
+    addPolyline(polyline: PolylineData): void;
+    /**
+     * Update an existing polyline's properties
+     * @param polyline - Updated polyline data (must include existing ID)
+     */
+    updatePolyline(polyline: PolylineData): void;
+    /**
+     * Remove a polyline from the map
+     * @param id - ID of the polyline to remove
+     */
+    removePolyline(id: string): void;
+    /**
+     * Remove all polylines from the map
+     */
+    clearPolylines(): void;
+    /**
+     * Add a polygon overlay to the map
+     * @param polygon - Polygon data configuration
+     */
+    addPolygon(polygon: PolygonData): void;
+    /**
+     * Update an existing polygon's properties
+     * @param polygon - Updated polygon data (must include existing ID)
+     */
+    updatePolygon(polygon: PolygonData): void;
+    /**
+     * Remove a polygon from the map
+     * @param id - ID of the polygon to remove
+     */
+    removePolygon(id: string): void;
+    /**
+     * Remove all polygons from the map
+     */
+    clearPolygons(): void;
+    /**
+     * Add a circle overlay to the map
+     * @param circle - Circle data configuration
+     */
+    addCircle(circle: CircleData): void;
+    /**
+     * Update an existing circle's properties
+     * @param circle - Updated circle data (must include existing ID)
+     */
+    updateCircle(circle: CircleData): void;
+    /**
+     * Remove a circle from the map
+     * @param id - ID of the circle to remove
+     */
+    removeCircle(id: string): void;
+    /**
+     * Remove all circles from the map
+     */
+    clearCircles(): void;
 }
 export type NitroMap = HybridView<NitroMapProps, NitroMapMethods>;
 //# sourceMappingURL=NitroMap.nitro.d.ts.map

package/lib/typescript/src/specs/NitroMap.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroMap.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroMap.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NitroMap.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroMap.nitro.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types/map.d.ts

@@ -102,7 +102,12 @@ export type MapBoundaries = {
     southWest: Coordinate;
 };
 /**
- * Individual style element for Google Maps styling
+ * Individual style modifier for map styling.
+ *
+ * **Provider note:** Currently uses Google Maps JSON styling format.
+ * Apple Maps and Yandex Maps use different styling APIs and will require
+ * a provider-specific adapter when implemented.
+ * @see https://developers.google.com/maps/documentation/javascript/style-reference
  */
 export type MapStyler = {
     /** Color in hex format (e.g., "#FF0000") */
@@ -119,7 +124,12 @@ export type MapStyler = {
     gamma?: number;
 };
 /**
- * Map style element targeting specific features
+ * Map style element targeting specific map features.
+ *
+ * **Provider note:** Uses Google Maps JSON styling format (featureType/elementType/stylers).
+ * Future providers will need their own styling approach:
+ * - Apple Maps: `MKMapConfiguration` + visual features
+ * - Yandex Maps: Custom style format
  * @see https://developers.google.com/maps/documentation/javascript/style-reference
  */
 export type MapStyleElement = {
@@ -131,8 +141,8 @@ export type MapStyleElement = {
     stylers: MapStyler[];
 };
 /**
- * Complete map style definition
- * Array of style elements to customize map appearance
+ * Complete map style definition (Google Maps JSON format).
+ * Array of style elements to customize map appearance.
  * @example
  * ```ts
  * const darkStyle: MapStyle = [
@@ -151,4 +161,24 @@ export type MapError = {
     /** Human-readable error description */
     message: string;
 };
+/**
+ * Event data when the user's location changes
+ */
+export type UserLocationChangeEvent = {
+    /** The user's updated geographic coordinate */
+    coordinate: Coordinate;
+    /** Accuracy of the location in meters (may be 0 if unavailable) */
+    accuracy: number;
+    /** Heading in degrees (0-360, 0 = north; -1 if unavailable) */
+    heading: number;
+    /** Speed in meters per second (-1 if unavailable) */
+    speed: number;
+};
+/**
+ * User tracking mode for the map camera
+ * - `'none'` - No automatic camera tracking
+ * - `'follow'` - Camera follows the user's location
+ * - `'followWithHeading'` - Camera follows and rotates based on heading
+ */
+export type UserTrackingMode = 'none' | 'follow' | 'followWithHeading';
 //# sourceMappingURL=map.d.ts.map

package/lib/typescript/src/types/map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../src/types/map.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../src/types/map.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types/marker.d.ts

@@ -3,30 +3,17 @@ import type { ColorValue } from '../utils/colors';
 /**
  * Visual style of the marker
  * - `'default'` - Standard Google Maps marker
- * - `'price'` - Simple price tag
  * - `'image'` - Custom image marker
  * - `'priceMarker'` - Full-featured price marker with currency
- * - `'reactView'` - React Native view marker (internal use by NitroCustomMarker)
- *
- * Note: For React Native views as markers, use the NitroCustomMarker component.
  */
 export type MarkerStyle = 'default' | 'image' | 'priceMarker';
 /**
- * Animation type for individual markers when they appear
+ * Animation type for markers when they appear on the map.
+ * Uses semantic intents — each provider maps to its best native animation.
  * - `'none'` - No animation
- * - `'pop'` - Pop/bounce effect
- * - `'fadeIn'` - Fade in animation
+ * - `'appear'` - Platform's native appear animation (iOS: pop, Android: drop)
  */
-export type MarkerAnimation = 'none' | 'pop' | 'fadeIn';
-/**
- * Animation style for cluster expand/collapse
- * - `'default'` - Standard Google Maps Utils animation
- * - `'bounce'` - Markers bounce when appearing
- * - `'scale'` - Scale up from 0 to full size
- * - `'fade'` - Fade in/out
- * - `'spring'` - Spring effect animation
- */
-export type ClusterAnimationStyle = 'default' | 'bounce' | 'scale' | 'fade' | 'spring';
+export type MarkerAnimation = 'none' | 'appear';
 /**
  * Style configuration for price markers
  * Colors can be hex strings ("#FF0000", "#F00") or MarkerColor objects
@@ -69,23 +56,6 @@ export type MarkerColor = {
     /** Alpha/opacity component (0-255) */
     a: number;
 };
-/**
- * Configuration for price-style markers
- */
-export type PriceMarkerConfig = {
-    /** Price text to display */
-    price: string;
-    /** Background color */
-    backgroundColor: MarkerColor;
-    /** Text color */
-    textColor: MarkerColor;
-    /** Font size in pixels */
-    fontSize: number;
-    /** Corner radius in pixels */
-    cornerRadius: number;
-    /** Whether marker is in selected state */
-    selected: boolean;
-};
 /**
  * Configuration for image-style markers
  * Colors can be hex strings ("#FF0000", "#F00") or MarkerColor objects
@@ -141,10 +111,23 @@ export type MarkerData = {
     anchor: Point;
     /** Visual configuration for the marker */
     config: MarkerConfig;
+    /** Accessibility label read by screen readers (VoiceOver / TalkBack) */
+    accessibilityLabel?: string;
     /** Whether this marker should be included in clustering */
     clusteringEnabled: boolean;
     /** Animation when marker appears */
     animation: MarkerAnimation;
+    /**
+     * Animation duration in seconds.
+     * @default 0.3
+     */
+    animationDuration: number;
+    /**
+     * Whether the marker should animate every time it reappears on the map
+     * (e.g., emerging from a cluster, scrolling back into viewport).
+     * When false, the animation only plays on the initial mount.
+     */
+    animateOnReappear: boolean;
 };
 /**
  * Event data when a marker is pressed
@@ -219,10 +202,15 @@ export type ClusterConfig = {
     borderColor?: ColorValue;
     /** Enable cluster animations @default true */
     animatesClusters?: boolean;
+    /**
+     * Whether cluster icons should animate every time they reappear
+     * (e.g., during pan/zoom re-clustering).
+     * When false, clusters only animate on first render.
+     * @default true
+     */
+    animateOnReappear?: boolean;
     /** Animation duration in seconds (e.g., 0.3) @default 0.3 */
     animationDuration?: number;
-    /** Animation style for cluster expand/collapse @default 'default' */
-    animationStyle?: ClusterAnimationStyle;
     /**
      * When true, clusters update live during pan/zoom gestures (throttled).
      * When false, clusters only update after the gesture ends (debounced).

package/lib/typescript/src/types/marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../../../../src/types/marker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../../../../src/types/marker.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types/overlay.d.ts

@@ -0,0 +1,84 @@
+import type { Coordinate } from './map';
+import type { MarkerColor } from './marker';
+/**
+ * Wrapper struct for an array of coordinates.
+ * Used to avoid nested arrays (Coordinate[][]) which trigger a Nitrogen codegen bug
+ * where variable names collide in the generated C++ JNI bridge code.
+ */
+export type CoordinateRing = {
+    /** Array of coordinates forming a ring (e.g., a polygon hole boundary) */
+    coordinates: Coordinate[];
+};
+/**
+ * Data structure for a polyline overlay on the map.
+ * Represents a line connecting multiple geographic points.
+ */
+export type PolylineData = {
+    /** Unique identifier for the polyline */
+    id: string;
+    /** Array of geographic coordinates that form the polyline path */
+    coordinates: Coordinate[];
+    /** Stroke color as RGBA */
+    strokeColor: MarkerColor;
+    /** Stroke width in pixels */
+    strokeWidth: number;
+    /** Whether the line follows Earth's curvature (great circle) */
+    geodesic: boolean;
+    /** Whether the line is dashed */
+    dashed: boolean;
+    /** Z-index for controlling overlay order */
+    zIndex: number;
+    /** Whether this overlay responds to tap events */
+    tappable: boolean;
+    /** Accessibility label read by screen readers (VoiceOver / TalkBack) */
+    accessibilityLabel?: string;
+};
+/**
+ * Data structure for a polygon overlay on the map.
+ * Represents a closed shape with fill and stroke.
+ */
+export type PolygonData = {
+    /** Unique identifier for the polygon */
+    id: string;
+    /** Array of geographic coordinates that form the polygon boundary */
+    coordinates: Coordinate[];
+    /** Array of holes — each hole is a CoordinateRing cut out from the fill */
+    holes: CoordinateRing[];
+    /** Fill color as RGBA */
+    fillColor: MarkerColor;
+    /** Stroke color as RGBA */
+    strokeColor: MarkerColor;
+    /** Stroke width in pixels */
+    strokeWidth: number;
+    /** Z-index for controlling overlay order */
+    zIndex: number;
+    /** Whether this overlay responds to tap events */
+    tappable: boolean;
+    /** Accessibility label read by screen readers (VoiceOver / TalkBack) */
+    accessibilityLabel?: string;
+};
+/**
+ * Data structure for a circle overlay on the map.
+ * Represents a circle with center, radius, and styling.
+ */
+export type CircleData = {
+    /** Unique identifier for the circle */
+    id: string;
+    /** Center coordinate of the circle */
+    center: Coordinate;
+    /** Radius in meters */
+    radius: number;
+    /** Fill color as RGBA */
+    fillColor: MarkerColor;
+    /** Stroke color as RGBA */
+    strokeColor: MarkerColor;
+    /** Stroke width in pixels */
+    strokeWidth: number;
+    /** Z-index for controlling overlay order */
+    zIndex: number;
+    /** Whether this overlay responds to tap events */
+    tappable: boolean;
+    /** Accessibility label read by screen readers (VoiceOver / TalkBack) */
+    accessibilityLabel?: string;
+};
+//# sourceMappingURL=overlay.d.ts.map