Add listener API to OverrideColorScheme for dynamic dark mode updates

Summary:
This change adds a listener mechanism to the `OverrideColorScheme` interface to enable dynamic updates when the user's dark mode preference changes via `OverrideColorScheme`.

Previously, `AppearanceModule` would only reflect the initial color scheme state when instantiated. If a user toggled dark mode through an `OverrideColorScheme` implementation, React Native JavaScript would not be notified of the change, causing UI inconsistencies.

This implementation adds:
1. An optional `addListener()` method to the `OverrideColorScheme` interface with a default no-op implementation for backward compatibility
2. Automatic listener registration in `AppearanceModule`'s init block that triggers `onConfigurationChanged()` when the color scheme changes

Changelog:
[Android][Added] - Add `addListener()` function to `OverrideColorScheme` interface to support dynamic appearance updates via override

Differential Revision: D88427482

Author: alanleedev

packages/react-native/ReactAndroid/api/ReactAndroid.api

@@ -2475,9 +2475,14 @@ public final class com/facebook/react/modules/appearance/AppearanceModule$Compan
 }
 
 public abstract interface class com/facebook/react/modules/appearance/AppearanceModule$OverrideColorScheme {
+	public abstract fun addListener (Lkotlin/jvm/functions/Function0;)V
 	public abstract fun getScheme ()Ljava/lang/String;
 }
 
+public final class com/facebook/react/modules/appearance/AppearanceModule$OverrideColorScheme$DefaultImpls {
+	public static fun addListener (Lcom/facebook/react/modules/appearance/AppearanceModule$OverrideColorScheme;Lkotlin/jvm/functions/Function0;)V
+}
+
 public abstract interface class com/facebook/react/modules/appregistry/AppRegistry : com/facebook/react/bridge/JavaScriptModule {
 	public abstract fun runApplication (Ljava/lang/String;Lcom/facebook/react/bridge/WritableMap;)V
 	public abstract fun startHeadlessTask (ILjava/lang/String;Lcom/facebook/react/bridge/WritableMap;)V
@@ -6764,4 +6769,3 @@ public final class com/facebook/react/views/virtual/viewexperimental/VirtualView
 	public fun <init> (IILcom/facebook/react/uimanager/events/EventDispatcher;)V
 	public fun emitModeChange (Lcom/facebook/react/views/virtual/VirtualViewMode;Landroid/graphics/Rect;Landroid/graphics/Rect;Z)V
 }
-

packages/react-native/ReactAndroid/src/main/java/com/facebook/react/modules/appearance/AppearanceModule.kt

@@ -28,13 +28,32 @@ constructor(
 
   private var lastEmittedColorScheme: String? = null
 
+  init {
+    // Register as a listener for color scheme changes if override is provided
+    overrideColorScheme?.addListener {
+      val activity = reactApplicationContext.getCurrentActivity()
+      onConfigurationChanged(activity ?: reactApplicationContext)
+    }
+  }
+
   /** Optional override to the current color scheme */
-  public fun interface OverrideColorScheme {
+  public interface OverrideColorScheme {
     /**
      * Color scheme will use the return value instead of the current system configuration. Available
      * scheme: {light, dark}
      */
     public fun getScheme(): String
+
+    /**
+     * Register a listener to be notified when the color scheme changes. The listener will be
+     * invoked whenever the underlying theme preference changes.
+     *
+     * Default implementation does nothing. Override this method if you want to support dynamic
+     * color scheme updates.
+     */
+    public fun addListener(listener: () -> Unit) {
+      // no-op
+    }
   }
 
   private fun colorSchemeForCurrentConfiguration(context: Context): String {