chore: merge dev into main

Author: pinpong

.github/actions/setup/action.yml

@@ -11,7 +11,7 @@ runs:
 
     - name: Restore dependencies
       id: yarn-cache
-      uses: actions/cache/restore@v4.2.4
+      uses: actions/cache/restore@v4.3.0
       with:
         path: |
           **/node_modules
@@ -28,7 +28,7 @@ runs:
 
     - name: Cache dependencies
       if: steps.yarn-cache.outputs.cache-hit != 'true'
-      uses: actions/cache/save@v4.2.4
+      uses: actions/cache/save@v4.3.0
       with:
         path: |
           **/node_modules

.github/workflows/deploy_docs.yaml.yml

@@ -0,0 +1,41 @@
+name: Deploy docs to GH pages
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: 'pages'
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.event.release.target_commitish, 'main')
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+        with:
+          fetch-depth: 0
+      - name: Setup
+        uses: ./.github/actions/setup
+      - name: Build
+        run: yarn docs
+      - name: Setup Pages
+        uses: actions/[email protected]
+      - name: Upload artifact
+        uses: actions/[email protected]
+        with:
+          path: './docs'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/[email protected]

.github/workflows/pull_request.yml

@@ -48,9 +48,27 @@ jobs:
       - name: Run unit tests
         run: yarn test --maxWorkers=2 --coverage
 
+  docs:
+    runs-on: ubuntu-latest
+    needs: [lint]
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+        with:
+          fetch-depth: 0
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: Generate nitrogen code
+        run: yarn nitrogen
+
+      - name: Build docs
+        run: yarn docs
+
   build-android:
     runs-on: ubuntu-latest
-    needs: [lint, test]
+    needs: [lint, test, docs]
     steps:
       - name: Checkout
         uses: actions/[email protected]
@@ -74,7 +92,7 @@ jobs:
           /bin/bash -c "yes | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --licenses > /dev/null"
 
       - name: Cache Gradle
-        uses: actions/cache@v4.2.4
+        uses: actions/cache@v4.3.0
         with:
           path: |
             ~/.gradle/wrapper
@@ -93,7 +111,7 @@ jobs:
         run: yarn build:android
   build-ios:
     runs-on: macos-latest
-    needs: [lint, test]
+    needs: [lint, test, docs]
     env:
       XCODE_VERSION: '26.0.1'
     steps:

.gitignore

@@ -95,3 +95,4 @@ android/.kotlinc/
 
 tsconfig.tsbuildinfo
 expoConfig/build
+docs/

.prettierignore

@@ -2,3 +2,5 @@ CHANGELOG.md
 node_modules/
 lib/
 expoConfig/build/
+docs/
+.yarn

README.md

@@ -3,131 +3,29 @@
 [![npm version](https://img.shields.io/npm/v/react-native-google-maps-plus.svg?logo=npm&color=cb0000)](https://www.npmjs.com/package/react-native-google-maps-plus)
 [![Dev Release](https://img.shields.io/npm/v/react-native-google-maps-plus/dev.svg?label=dev%20release&color=orange)](https://www.npmjs.com/package/react-native-google-maps-plus)
 [![Build](https://github.com/pinpong/react-native-google-maps-plus/actions/workflows/release.yml/badge.svg)](https://github.com/pinpong/react-native-google-maps-plus/actions/workflows/release.yml)
+[![API Docs](https://img.shields.io/static/v1?label=typedoc&message=docs&color=informational)](https://pinpong.github.io/react-native-google-maps-plus)
 ![React Native](https://img.shields.io/badge/react--native-%3E%3D0.81.0-61dafb.svg?logo=react)
 
 React Native wrapper for Android & iOS Google Maps SDK.
 
-## Installation
+## Documentation
 
-`react-native-nitro-modules` is required as this library relies on [Nitro Modules](https://nitro.margelo.com/).
+Full installation guide and API reference:
+https://pinpong.github.io/react-native-google-maps-plus
 
-```sh
-yarn add react-native-google-maps-plus react-native-nitro-modules
-```
-
-**iOS**
-
-Add this to your Podfile only for bare React Native apps.
-(Not required for Expo, handled by the config plugin.)
-
-```ruby
-post_install do |installer|
-  react_native_post_install(
-      installer,
-      config[:reactNativePath],
-      :mac_catalyst_enabled => false,
-      # :ccache_enabled => true
-    )
-
-  require_relative '../node_modules/react-native-google-maps-plus/scripts/svgkit_patch'
-  apply_svgkit_patch(installer)
-end
-```
-
-### Expo Projects
-
-Add your keys to the `app.json`.
-The config plugin automatically injects them into your native Android and iOS builds during `expo prebuild`.
-
-```json
-{
-  "expo": {
-    "plugins": [
-      [
-        "react-native-google-maps-plus",
-        {
-          "googleMapsAndroidApiKey": "YOUR_ANDROID_MAPS_API_KEY",
-          "googleMapsIosApiKey": "YOUR_IOS_MAPS_API_KEY"
-        }
-      ]
-    ]
-  }
-}
-```
-
-## Setup API Key
-
-You will need a valid **Google Maps API Key** from the [Google Cloud Console](https://console.cloud.google.com/).
-
-### Android
-
-**Note:** These instructions apply to **bare React Native apps only**.
-Expo projects should use the config plugin instead (see Expo section above).
-
-See the official [Google Maps Android SDK configuration guide](https://developers.google.com/maps/documentation/android-sdk/config#step_3_add_your_api_key_to_the_project) for more details.
-
-### iOS
-
-**Note:** These instructions apply to **bare React Native apps only**.
-Expo projects should use the config plugin instead (see Expo section above).
-
-See the official [Google Maps iOS SDK configuration guide](https://developers.google.com/maps/documentation/ios-sdk/config#get-key) for more details.
-
-## Dependencies & Native Documentation
-
-This package is React Native wrapper around the official Google Maps SDKs.
-For full API behavior, configuration options, and feature reference, please consult the native documentation:
-
-- **iOS Google Maps SDK**
-  https://developers.google.com/maps/documentation/ios-sdk
-
-- **Android Google Maps SDK**
-  https://developers.google.com/maps/documentation/android-sdk
-
-- **Maps Utility Libraries (iOS & Android)**
-  https://developers.google.com/maps/documentation/ios-sdk/utility
-  https://developers.google.com/maps/documentation/android-sdk/utility
-
-- **SVG Rendering** (used for custom marker icons)
-  - iOS: https://github.com/SVGKit/SVGKit
-  - Android: https://bigbadaboom.github.io/androidsvg/
-
-These libraries are automatically linked during installation.
-If you encounter build issues, try cleaning and rebuilding your native project.
-
-> **Note:** This package follows the native SDKs closely. Props and behavior match the underlying Google Maps APIs whenever possible.
+## Contributing
 
-## Usage
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
 
-Basic map:
+## License
 
-```tsx
-import React from 'react';
-import { GoogleMapsView } from 'react-native-google-maps-plus';
+MIT
 
-export default function App() {
-  return (
-    <GoogleMapsView
-      style={{ flex: 1 }}
-      initialProps={{
-        camera: {
-          center: { latitude: 37.7749, longitude: -122.4194 },
-          zoom: 12,
-        },
-      }}
-      markers={[
-        {
-          id: '1',
-          zIndex: 1,
-          coordinate: { latitude: 37.7749, longitude: -122.4194 },
-        },
-      ]}
-    />
-  );
-}
-```
+---
 
-Check out the example app in the [example](./example) folder.
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)
 
 ## Contributing
 

android/src/main/java/com/rngooglemapsplus/GoogleMapsViewImpl.kt

@@ -867,10 +867,9 @@ class GoogleMapsViewImpl(
   }
 
   override fun onDetachedFromWindow() {
-    super.onDetachedFromWindow()
     lifecycleObserver?.let { lifecycle?.removeObserver(it) }
     lifecycle = null
-    lifecycleObserver?.toCreatedState()
+    super.onDetachedFromWindow()
   }
 
   override fun onMarkerClick(marker: Marker): Boolean {

android/src/main/java/com/rngooglemapsplus/MapLifecycleEventObserver.kt

@@ -35,6 +35,7 @@ class MapLifecycleEventObserver(
   }
 
   private fun toState(state: Lifecycle.State) {
+    if (currentState == Lifecycle.State.DESTROYED) return
     while (currentState != state) {
       when {
         currentState < state -> upFromCurrentState()

android/src/main/java/com/rngooglemapsplus/extensions/LocationExtension.kt

@@ -20,38 +20,53 @@ fun Location.toRnLocation(): RNLocation =
         elapsedRealtimeNanos = elapsedRealtimeNanos.toDouble(),
         bearingAccuracyDegrees =
           when {
-            Build.VERSION.SDK_INT >= Build.VERSION_CODES.O ->
-              bearingAccuracyDegrees.toDouble()
-
-            else -> null
+            Build.VERSION.SDK_INT < Build.VERSION_CODES.O -> null
+            else ->
+              try {
+                if (hasBearingAccuracy()) bearingAccuracyDegrees.toDouble() else null
+              } catch (_: IllegalStateException) {
+                null
+              }
           },
         speedAccuracyMetersPerSecond =
           when {
-            Build.VERSION.SDK_INT >= Build.VERSION_CODES.O ->
-              speedAccuracyMetersPerSecond.toDouble()
-
-            else -> null
+            Build.VERSION.SDK_INT < Build.VERSION_CODES.O -> null
+            else ->
+              try {
+                if (hasSpeedAccuracy()) speedAccuracyMetersPerSecond.toDouble() else null
+              } catch (_: IllegalStateException) {
+                null
+              }
           },
         verticalAccuracyMeters =
           when {
-            Build.VERSION.SDK_INT >= Build.VERSION_CODES.O ->
-              verticalAccuracyMeters.toDouble()
-
-            else -> null
+            Build.VERSION.SDK_INT < Build.VERSION_CODES.O -> null
+            else ->
+              try {
+                if (hasVerticalAccuracy()) verticalAccuracyMeters.toDouble() else null
+              } catch (_: IllegalStateException) {
+                null
+              }
           },
         mslAltitudeMeters =
           when {
-            Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE ->
-              mslAltitudeMeters
-
-            else -> null
+            Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE -> null
+            else ->
+              try {
+                if (hasMslAltitude()) mslAltitudeMeters else null
+              } catch (_: IllegalStateException) {
+                null
+              }
           },
         mslAltitudeAccuracyMeters =
           when {
-            Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE ->
-              mslAltitudeAccuracyMeters.toDouble()
-
-            else -> null
+            Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE -> null
+            else ->
+              try {
+                if (hasMslAltitude()) mslAltitudeAccuracyMeters.toDouble() else null
+              } catch (_: IllegalStateException) {
+                null
+              }
           },
         isMock =
           when {