feat: add isPromptVisible to android auto base screen

Author: illuminati1911

ANDROIDAUTO.md

@@ -61,6 +61,32 @@ public Template onGetTemplate() {
 }
 ```
 
+### Avoiding overlap with Navigation SDK prompts
+
+`AndroidAutoBaseScreen` detects Navigation SDK prompts, including traffic and rerouting prompts,
+and automatically invalidates the Android Auto template when their visibility changes. If your
+custom `NavigationTemplate` includes a `TravelEstimate`, conditionally omit it while a prompt is
+visible. This prevents the host-controlled estimate from overlapping the Navigation SDK modal
+prompt:
+
+```java
+@Override
+public Template onGetTemplate() {
+  NavigationTemplate.Builder builder = new NavigationTemplate.Builder();
+  // Configure actions, map action strip, and navigation info.
+
+  if (!isPromptVisible()) {
+    builder.setDestinationTravelEstimate(travelEstimate);
+  }
+
+  return builder.build();
+}
+```
+
+`isPromptVisible()` is provided by `AndroidAutoBaseScreen`; subclasses do not need to register a
+listener or call `invalidate()` themselves. The estimate is restored automatically when the prompt
+disappears.
+
 For advanced customization, you can bypass the base class and implement your own screen by inheriting `Screen`. You can use the provided `AndroidAutoBaseScreen` base class as a reference on how to do that.
 
 ### React Native specific setup

android/src/main/java/com/google/android/react/navsdk/AndroidAutoBaseScreen.java

@@ -43,6 +43,7 @@
 import com.google.android.gms.maps.GoogleMap;
 import com.google.android.gms.maps.GoogleMapOptions;
 import com.google.android.libraries.navigation.NavigationView;
+import com.google.android.libraries.navigation.PromptVisibilityChangedListener;
 import com.google.android.libraries.navigation.StylingOptions;
 import org.json.JSONObject;
 
@@ -64,7 +65,9 @@ public abstract class AndroidAutoBaseScreen extends Screen
   protected GoogleMap mGoogleMap;
   protected volatile boolean mNavigationInitialized = false;
   private MapViewController mMapViewController;
+  private PromptVisibilityChangedListener mPromptVisibilityChangedListener;
   private boolean mIsSurfaceDestroyed = true;
+  private boolean mIsPromptVisible = false;
 
   private boolean mAndroidAutoModuleInitialized = false;
   private boolean mNavModuleInitialized = false;
@@ -95,6 +98,31 @@ private void updateNavigationUiEnabled(boolean ready) {
         });
   }
 
+  private void handlePromptVisibilityChanged(
+      NavigationView navigationView, boolean promptVisible) {
+    UiThreadUtil.runOnUiThread(
+        () -> {
+          if (mIsSurfaceDestroyed
+              || navigationView != mNavigationView
+              || mIsPromptVisible == promptVisible) {
+            return;
+          }
+
+          mIsPromptVisible = promptVisible;
+          onPromptVisibilityChanged(promptVisible);
+        });
+  }
+
+  /** Returns whether a Navigation SDK prompt is visible over the Android Auto map. */
+  protected final boolean isPromptVisible() {
+    return mIsPromptVisible;
+  }
+
+  /** Called when Navigation SDK prompt visibility changes on the Android Auto map. */
+  protected void onPromptVisibilityChanged(boolean promptVisible) {
+    invalidate();
+  }
+
   /**
    * Called when the navigation session state changes. Override this method in your subclass to
    * handle navigation ready state changes.
@@ -211,10 +239,14 @@ public void onSurfaceAvailable(@NonNull SurfaceContainer surfaceContainer) {
     mNavigationView.setReportIncidentButtonEnabled(false);
     mNavigationView.setNavigationUiEnabled(mNavigationInitialized);
 
-    mPresentation.setContentView(mNavigationView);
+    NavigationView navigationView = mNavigationView;
+    mPromptVisibilityChangedListener =
+        promptVisible -> handlePromptVisibilityChanged(navigationView, promptVisible);
+    navigationView.addPromptVisibilityChangedListener(mPromptVisibilityChangedListener);
+
+    mPresentation.setContentView(navigationView);
     mPresentation.show();
 
-    NavigationView navigationView = mNavigationView;
     navigationView.getMapAsync(
         (GoogleMap googleMap) -> {
           if (mIsSurfaceDestroyed || navigationView != mNavigationView) {
@@ -249,12 +281,18 @@ public void onSurfaceDestroyed(@NonNull SurfaceContainer surfaceContainer) {
     unRegisterControllersForAndroidAutoModule();
     mMapViewController = null;
 
+    if (mNavigationView != null && mPromptVisibilityChangedListener != null) {
+      mNavigationView.removePromptVisibilityChangedListener(mPromptVisibilityChangedListener);
+    }
+    mPromptVisibilityChangedListener = null;
+
     if (mNavigationView != null) {
       mNavigationView.onPause();
       mNavigationView.onStop();
       mNavigationView.onDestroy();
       mNavigationView = null;
     }
+    mIsPromptVisible = false;
     mGoogleMap = null;
 
     if (mPresentation != null) {