react-native-tvos 0.83.1-0 → 0.84.0-0rc0

package/ReactAndroid/hermes-engine/build.gradle.kts

@@ -11,7 +11,6 @@ import de.undercouch.gradle.tasks.download.Download
 import org.apache.tools.ant.taskdefs.condition.Os
 
 plugins {
-  id("maven-publish")
   id("signing")
   alias(libs.plugins.android.library)
   alias(libs.plugins.download)
@@ -350,10 +349,7 @@ android {
     java.srcDirs("$hermesDir/lib/Platform/Intl/java", "$hermesDir/lib/Platform/Unicode/java")
   }
 
-  buildFeatures {
-    prefab = true
-    prefabPublishing = true
-  }
+  buildFeatures { prefab = true }
 
   dependencies {
     implementation(libs.fbjni)
@@ -367,13 +363,6 @@ android {
     jniLibs.excludes.add("**/libfbjni.so")
   }
 
-  publishing {
-    multipleVariants {
-      withSourcesJar()
-      allVariants()
-    }
-  }
-
   prefab { create("hermesvm") { headers = prefabHeadersDir.absolutePath } }
 }
 

package/ReactAndroid/src/main/java/com/facebook/react/NativeModuleRegistryBuilder.kt

@@ -41,10 +41,7 @@ public class NativeModuleRegistryBuilder(
     // We use an iterable instead of an iterator here to ensure thread safety, and that this list
     // cannot be modified
     val moduleHolders =
-        @Suppress("DEPRECATION")
-        if (reactPackage is LazyReactPackage) {
-          reactPackage.getNativeModuleIterator(reactApplicationContext)
-        } else if (reactPackage is BaseReactPackage) {
+        if (reactPackage is BaseReactPackage) {
           reactPackage.getNativeModuleIterator(reactApplicationContext)
         } else {
           ReactPackageHelper.getNativeModuleIterator(reactPackage, reactApplicationContext)

package/ReactAndroid/src/main/java/com/facebook/react/ReactActivity.java

@@ -124,6 +124,9 @@ public abstract class ReactActivity extends AppCompatActivity
     // as super.onBackPressed() will call all enabled callbacks in the dispatcher.
     mBackPressedCallback.setEnabled(false);
     super.onBackPressed();
+    // Re-enable callback to ensure custom back handling works after activity resume
+    // Without this, the callback remains disabled when the app returns from background
+    mBackPressedCallback.setEnabled(true);
   }
 
   @Override

package/ReactAndroid/src/main/java/com/facebook/react/ReactDelegate.kt

@@ -68,9 +68,9 @@ public open class ReactDelegate {
       launchOptions: Bundle?,
   ) {
     this.activity = activity
-    mainComponentName = appKey
+    this.mainComponentName = appKey
     this.launchOptions = launchOptions
-    doubleTapReloadRecognizer = DoubleTapReloadRecognizer()
+    this.doubleTapReloadRecognizer = DoubleTapReloadRecognizer()
     this.reactNativeHost = reactNativeHost
   }
 
@@ -81,9 +81,9 @@ public open class ReactDelegate {
       launchOptions: Bundle?,
   ) {
     this.activity = activity
-    mainComponentName = appKey
+    this.mainComponentName = appKey
     this.launchOptions = launchOptions
-    doubleTapReloadRecognizer = DoubleTapReloadRecognizer()
+    this.doubleTapReloadRecognizer = DoubleTapReloadRecognizer()
     this.reactHost = reactHost
   }
 
@@ -95,11 +95,11 @@ public open class ReactDelegate {
       launchOptions: Bundle?,
       fabricEnabled: Boolean,
   ) {
-    isFabricEnabled = fabricEnabled
+    this.isFabricEnabled = fabricEnabled
     this.activity = activity
-    mainComponentName = appKey
+    this.mainComponentName = appKey
     this.launchOptions = launchOptions
-    doubleTapReloadRecognizer = DoubleTapReloadRecognizer()
+    this.doubleTapReloadRecognizer = DoubleTapReloadRecognizer()
     this.reactNativeHost = reactNativeHost
   }
 
@@ -178,13 +178,10 @@ public open class ReactDelegate {
     if (
         ReactNativeNewArchitectureFeatureFlags.enableBridgelessArchitecture() && reactHost != null
     ) {
-      reactHost?.onBackPressed()
+      return reactHost?.onBackPressed() == true
+    } else if (reactNativeHost?.hasInstance() == true) {
+      reactNativeHost?.reactInstanceManager?.onBackPressed()
       return true
-    } else {
-      if (reactNativeHost?.hasInstance() == true) {
-        reactNativeHost?.reactInstanceManager?.onBackPressed()
-        return true
-      }
     }
     return false
   }

package/ReactAndroid/src/main/java/com/facebook/react/ReactInstanceManager.java

@@ -57,11 +57,8 @@ import com.facebook.react.bridge.JSExceptionHandler;
 import com.facebook.react.bridge.JavaScriptExecutor;
 import com.facebook.react.bridge.JavaScriptExecutorFactory;
 import com.facebook.react.bridge.NativeModuleRegistry;
-import com.facebook.react.bridge.NotThreadSafeBridgeIdleDebugListener;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContext;
-import com.facebook.react.bridge.ReactCxxErrorHandler;
-import com.facebook.react.bridge.ReactInstanceManagerInspectorTarget;
 import com.facebook.react.bridge.ReactMarker;
 import com.facebook.react.bridge.ReactMarkerConstants;
 import com.facebook.react.bridge.ReactNoCrashSoftException;
@@ -77,16 +74,11 @@ import com.facebook.react.common.SurfaceDelegateFactory;
 import com.facebook.react.common.annotations.internal.LegacyArchitecture;
 import com.facebook.react.common.annotations.internal.LegacyArchitectureLogLevel;
 import com.facebook.react.common.annotations.internal.LegacyArchitectureLogger;
-import com.facebook.react.common.build.ReactBuildConfig;
 import com.facebook.react.devsupport.DevSupportManagerFactory;
-import com.facebook.react.devsupport.InspectorFlags;
 import com.facebook.react.devsupport.ReactInstanceDevHelper;
-import com.facebook.react.devsupport.inspector.InspectorNetworkHelper;
-import com.facebook.react.devsupport.inspector.InspectorNetworkRequestListener;
 import com.facebook.react.devsupport.interfaces.DevBundleDownloadListener;
 import com.facebook.react.devsupport.interfaces.DevLoadingViewManager;
 import com.facebook.react.devsupport.interfaces.DevSupportManager;
-import com.facebook.react.devsupport.interfaces.DevSupportManager.PausedInDebuggerOverlayCommandListener;
 import com.facebook.react.devsupport.interfaces.PackagerStatusCallback;
 import com.facebook.react.devsupport.interfaces.PausedInDebuggerOverlayManager;
 import com.facebook.react.devsupport.interfaces.RedBoxHandler;
@@ -102,7 +94,6 @@ import com.facebook.react.modules.core.DefaultHardwareBackBtnHandler;
 import com.facebook.react.modules.core.DeviceEventManagerModule;
 import com.facebook.react.modules.core.ReactChoreographer;
 import com.facebook.react.modules.debug.interfaces.DeveloperSettings;
-import com.facebook.react.modules.systeminfo.AndroidInfoHelpers;
 import com.facebook.react.packagerconnection.RequestHandler;
 import com.facebook.react.uimanager.DisplayMetricsHolder;
 import com.facebook.react.uimanager.ReactRoot;
@@ -114,8 +105,6 @@ import com.facebook.react.views.imagehelper.ResourceDrawableIdHelper;
 import com.facebook.soloader.SoLoader;
 import com.facebook.systrace.Systrace;
 import com.facebook.systrace.SystraceMessage;
-import java.lang.ref.WeakReference;
-import java.lang.reflect.Method;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
@@ -183,13 +172,11 @@ public class ReactInstanceManager {
   private final boolean mUseDeveloperSupport;
   private final boolean mRequireActivity;
   private final boolean mKeepActivity;
-  private final @Nullable NotThreadSafeBridgeIdleDebugListener mBridgeIdleDebugListener;
   private final Object mReactContextLock = new Object();
   private @Nullable volatile ReactContext mCurrentReactContext;
   private final Context mApplicationContext;
   private @Nullable @ThreadConfined(UI) DefaultHardwareBackBtnHandler mDefaultBackButtonImpl;
   private @Nullable Activity mCurrentActivity;
-  private @Nullable ReactInstanceManagerInspectorTarget mInspectorTarget;
   private final Collection<com.facebook.react.ReactInstanceEventListener>
       mReactInstanceEventListeners =
           Collections.synchronizedList(
@@ -246,7 +233,6 @@ public class ReactInstanceManager {
       DevSupportManagerFactory devSupportManagerFactory,
       boolean requireActivity,
       boolean keepActivity,
-      @Nullable NotThreadSafeBridgeIdleDebugListener bridgeIdleDebugListener,
       LifecycleState initialLifecycleState,
       JSExceptionHandler jSExceptionHandler,
       @Nullable RedBoxHandler redBoxHandler,
@@ -292,7 +278,6 @@ public class ReactInstanceManager {
             devLoadingViewManager,
             pausedInDebuggerOverlayManager);
     Systrace.endSection(TRACE_TAG_REACT);
-    mBridgeIdleDebugListener = bridgeIdleDebugListener;
     mLifecycleState = initialLifecycleState;
     mMemoryPressureRouter = new MemoryPressureRouter(applicationContext);
     mJSExceptionHandler = jSExceptionHandler;
@@ -316,8 +301,6 @@ public class ReactInstanceManager {
       mDevSupportManager.startInspector();
     }
 
-    registerCxxErrorHandlerFunc();
-
     // Using `if (true)` just to prevent tests / lint errors.
     if (true) {
       // Legacy architecture of React Native is deprecated and can't be initialized anymore.
@@ -414,24 +397,6 @@ public class ReactInstanceManager {
     mDevSupportManager.handleException(e);
   }
 
-  private void registerCxxErrorHandlerFunc() {
-    if (!ReactBuildConfig.UNSTABLE_ENABLE_MINIFY_LEGACY_ARCHITECTURE) {
-      Class[] parameterTypes = new Class[1];
-      parameterTypes[0] = Exception.class;
-      Method handleCxxErrorFunc = null;
-      try {
-        handleCxxErrorFunc = ReactInstanceManager.class.getMethod("handleCxxError", parameterTypes);
-      } catch (NoSuchMethodException e) {
-        FLog.e("ReactInstanceHolder", "Failed to set cxx error handler function", e);
-      }
-      ReactCxxErrorHandler.setHandleErrorFunc(this, handleCxxErrorFunc);
-    }
-  }
-
-  private void unregisterCxxErrorHandlerFunc() {
-    ReactCxxErrorHandler.setHandleErrorFunc(null, null);
-  }
-
   static void initializeSoLoaderIfNecessary(Context applicationContext) {
     // Call SoLoader.initialize here, this is required for apps that does not use exopackage and
     // does not use SoLoader for loading other native code except from the one used by React Native
@@ -811,7 +776,6 @@ public class ReactInstanceManager {
 
     moveToBeforeCreateLifecycleState();
     mMemoryPressureRouter.destroy(mApplicationContext);
-    unregisterCxxErrorHandlerFunc();
 
     mCreateReactContextThread = null;
     synchronized (mAttachedReactRoots) {
@@ -830,15 +794,6 @@ public class ReactInstanceManager {
       }
     }
 
-    // If the host has been invalidated, now that the current context/instance
-    // has been destroyed, we can safely destroy the host's inspector target.
-    if (mInstanceManagerInvalidated) {
-      if (mInspectorTarget != null) {
-        mInspectorTarget.close();
-        mInspectorTarget = null;
-      }
-    }
-
     mHasStartedCreatingInitialContext = false;
     if (!mKeepActivity) {
       mCurrentActivity = null;
@@ -1462,8 +1417,7 @@ public class ReactInstanceManager {
             .setJSExecutor(jsExecutor)
             .setRegistry(nativeModuleRegistry)
             .setJSBundleLoader(jsBundleLoader)
-            .setJSExceptionHandler(exceptionHandler)
-            .setInspectorTarget(getOrCreateInspectorTarget());
+            .setJSExceptionHandler(exceptionHandler);
 
     ReactMarker.logMarker(CREATE_CATALYST_INSTANCE_START);
     // CREATE_CATALYST_INSTANCE_END is in JSCExecutor.cpp
@@ -1517,9 +1471,6 @@ public class ReactInstanceManager {
         catalystInstance.setFabricUIManager(uiManager);
       }
     }
-    if (mBridgeIdleDebugListener != null) {
-      catalystInstance.addBridgeIdleDebugListener(mBridgeIdleDebugListener);
-    }
     if (BuildConfig.ENABLE_PERFETTO || Systrace.isTracing(TRACE_TAG_REACT)) {
       catalystInstance.setGlobalVariable("__RCTProfileIsProfiling", "true");
     }
@@ -1572,73 +1523,4 @@ public class ReactInstanceManager {
     nativeModuleRegistryBuilder.processPackage(reactPackage);
     SystraceMessage.endSection(TRACE_TAG_REACT).flush();
   }
-
-  private static class InspectorTargetDelegateImpl
-      implements ReactInstanceManagerInspectorTarget.TargetDelegate {
-    // This weak reference breaks the cycle between the C++ HostTarget and the
-    // Java ReactInstanceManager, preventing memory leaks in apps that create
-    // multiple ReactInstanceManagers over time.
-    private WeakReference<ReactInstanceManager> mReactInstanceManagerWeak;
-
-    public InspectorTargetDelegateImpl(ReactInstanceManager inspectorTarget) {
-      mReactInstanceManagerWeak = new WeakReference<ReactInstanceManager>(inspectorTarget);
-    }
-
-    @Override
-    public Map<String, String> getMetadata() {
-      ReactInstanceManager reactInstanceManager = mReactInstanceManagerWeak.get();
-
-      return AndroidInfoHelpers.getInspectorHostMetadata(
-          reactInstanceManager != null ? reactInstanceManager.mApplicationContext : null);
-    }
-
-    @Override
-    public void onReload() {
-      UiThreadUtil.runOnUiThread(
-          () -> {
-            ReactInstanceManager reactInstanceManager = mReactInstanceManagerWeak.get();
-            if (reactInstanceManager != null) {
-              reactInstanceManager.mDevSupportManager.handleReloadJS();
-            }
-          });
-    }
-
-    @Override
-    public void onSetPausedInDebuggerMessage(@Nullable String message) {
-      ReactInstanceManager reactInstanceManager = mReactInstanceManagerWeak.get();
-      if (reactInstanceManager == null) {
-        return;
-      }
-      if (message == null) {
-        reactInstanceManager.mDevSupportManager.hidePausedInDebuggerOverlay();
-      } else {
-        reactInstanceManager.mDevSupportManager.showPausedInDebuggerOverlay(
-            message,
-            new PausedInDebuggerOverlayCommandListener() {
-              @Override
-              public void onResume() {
-                UiThreadUtil.assertOnUiThread();
-                if (reactInstanceManager.mInspectorTarget != null) {
-                  reactInstanceManager.mInspectorTarget.sendDebuggerResumeCommand();
-                }
-              }
-            });
-      }
-    }
-
-    @Override
-    public void loadNetworkResource(String url, InspectorNetworkRequestListener listener) {
-      InspectorNetworkHelper.loadNetworkResource(url, listener);
-    }
-  }
-
-  private @Nullable ReactInstanceManagerInspectorTarget getOrCreateInspectorTarget() {
-    if (mInspectorTarget == null && InspectorFlags.getFuseboxEnabled()) {
-
-      mInspectorTarget =
-          new ReactInstanceManagerInspectorTarget(new InspectorTargetDelegateImpl(this));
-    }
-
-    return mInspectorTarget;
-  }
 }

package/ReactAndroid/src/main/java/com/facebook/react/ReactInstanceManagerBuilder.kt

@@ -19,7 +19,6 @@ import com.facebook.react.ReactInstanceManager.initializeSoLoaderIfNecessary
 import com.facebook.react.bridge.JSBundleLoader
 import com.facebook.react.bridge.JSExceptionHandler
 import com.facebook.react.bridge.JavaScriptExecutorFactory
-import com.facebook.react.bridge.NotThreadSafeBridgeIdleDebugListener
 import com.facebook.react.bridge.UIManagerProvider
 import com.facebook.react.common.LifecycleState
 import com.facebook.react.common.SurfaceDelegateFactory
@@ -49,7 +48,6 @@ public class ReactInstanceManagerBuilder {
   private var jsBundleAssetUrl: String? = null
   private var jsBundleLoader: JSBundleLoader? = null
   private var jsMainModulePath: String? = null
-  private var bridgeIdleDebugListener: NotThreadSafeBridgeIdleDebugListener? = null
   private var application: Application? = null
   private var useDeveloperSupport = false
   private var devSupportManagerFactory: DevSupportManagerFactory? = null
@@ -145,13 +143,6 @@ public class ReactInstanceManagerBuilder {
     return this
   }
 
-  public fun setBridgeIdleDebugListener(
-      bridgeIdleDebugListener: NotThreadSafeBridgeIdleDebugListener
-  ): ReactInstanceManagerBuilder {
-    this.bridgeIdleDebugListener = bridgeIdleDebugListener
-    return this
-  }
-
   /** Required. This must be your `Application` instance. */
   public fun setApplication(application: Application): ReactInstanceManagerBuilder {
     this.application = application
@@ -359,7 +350,6 @@ public class ReactInstanceManagerBuilder {
         devSupportManagerFactory ?: DefaultDevSupportManagerFactory(),
         requireActivity,
         keepActivity,
-        bridgeIdleDebugListener,
         checkNotNull(initialLifecycleState) { "Initial lifecycle state was not set" },
         jsExceptionHandler,
         redBoxHandler,

package/ReactAndroid/src/main/java/com/facebook/react/ReactPackageHelper.kt

@@ -27,7 +27,7 @@ internal object ReactPackageHelper {
   ): Iterable<ModuleHolder> {
     FLog.d(
         ReactConstants.TAG,
-        "${reactPackage.javaClass.simpleName} is not a LazyReactPackage, falling back to old version.",
+        "${reactPackage.javaClass.simpleName} is not a BaseReactPackage, falling back to old version.",
     )
     @Suppress("DEPRECATION")
     val nativeModules = reactPackage.createNativeModules(reactApplicationContext)

package/ReactAndroid/src/main/java/com/facebook/react/ReactPackageTurboModuleManagerDelegate.kt

@@ -8,8 +8,6 @@
 package com.facebook.react
 
 import com.facebook.jni.HybridData
-import com.facebook.react.bridge.CxxModuleWrapper
-import com.facebook.react.bridge.ModuleSpec
 import com.facebook.react.bridge.NativeModule
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.internal.featureflags.ReactNativeNewArchitectureFeatureFlags
@@ -17,7 +15,6 @@ import com.facebook.react.internal.turbomodule.core.TurboModuleManagerDelegate
 import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.module.model.ReactModuleInfo
 import com.facebook.react.turbomodule.core.interfaces.TurboModule
-import javax.inject.Provider
 
 public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManagerDelegate {
   internal fun interface ModuleProvider {
@@ -61,26 +58,6 @@ public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManage
         continue
       }
 
-      @Suppress("DEPRECATION")
-      if (shouldSupportLegacyPackages() && reactPackage is LazyReactPackage) {
-        // TODO(T145105887): Output warnings that LazyReactPackage was used
-        val lazyPkg = reactPackage
-        val moduleSpecs: List<ModuleSpec> =
-            lazyPkg.internal_getNativeModules(reactApplicationContext)
-        val moduleSpecProviderMap: MutableMap<String?, Provider<out NativeModule>> = mutableMapOf()
-        for (moduleSpec in moduleSpecs) {
-          moduleSpecProviderMap[moduleSpec.getName()] = moduleSpec.getProvider()
-        }
-
-        val moduleProvider = ModuleProvider { moduleName: String ->
-          moduleSpecProviderMap[moduleName]?.get()
-        }
-
-        moduleProviders.add(moduleProvider)
-        packageModuleInfos[moduleProvider] = lazyPkg.reactModuleInfoProvider.getReactModuleInfos()
-        continue
-      }
-
       if (shouldSupportLegacyPackages()) {
         // TODO(T145105887): Output warnings that ReactPackage was used
         @Suppress("DEPRECATION")
@@ -103,7 +80,7 @@ public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManage
                       moduleClass.name,
                       reactModule.canOverrideExistingModule,
                       true,
-                      reactModule.isCxxModule,
+                      false,
                       ReactModuleInfo.classIsTurboModule(moduleClass),
                   )
               else
@@ -112,7 +89,7 @@ public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManage
                       moduleClass.name,
                       module.canOverrideExistingModule(),
                       true,
-                      CxxModuleWrapper::class.java.isAssignableFrom(moduleClass),
+                      false,
                       ReactModuleInfo.classIsTurboModule(moduleClass),
                   )
 
@@ -128,8 +105,6 @@ public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManage
     }
   }
 
-  override fun unstable_shouldEnableLegacyModuleInterop(): Boolean = shouldEnableLegacyModuleInterop
-
   override fun getModule(moduleName: String): TurboModule? {
     var resolvedModule: NativeModule? = null
 
@@ -176,7 +151,7 @@ public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManage
   }
 
   override fun getLegacyModule(moduleName: String): NativeModule? {
-    if (!unstable_shouldEnableLegacyModuleInterop()) {
+    if (!shouldEnableLegacyModuleInterop) {
       return null
     }
 
@@ -214,7 +189,7 @@ public abstract class ReactPackageTurboModuleManagerDelegate : TurboModuleManage
     }
   }
 
-  private fun shouldSupportLegacyPackages(): Boolean = unstable_shouldEnableLegacyModuleInterop()
+  private fun shouldSupportLegacyPackages(): Boolean = shouldEnableLegacyModuleInterop
 
   public abstract class Builder {
     private var packages: List<ReactPackage>? = null

package/ReactAndroid/src/main/java/com/facebook/react/ReactRootView.java

@@ -57,6 +57,7 @@ import com.facebook.react.modules.appregistry.AppRegistry;
 import com.facebook.react.modules.deviceinfo.DeviceInfoModule;
 import com.facebook.react.uimanager.DisplayMetricsHolder;
 import com.facebook.react.uimanager.IllegalViewOperationException;
+import com.facebook.react.uimanager.JSKeyDispatcher;
 import com.facebook.react.uimanager.JSPointerDispatcher;
 import com.facebook.react.uimanager.JSTouchDispatcher;
 import com.facebook.react.uimanager.PixelUtil;
@@ -106,6 +107,7 @@ public class ReactRootView extends FrameLayout implements RootView, ReactRoot {
   private boolean mShouldLogContentAppeared;
   private @Nullable JSTouchDispatcher mJSTouchDispatcher;
   private @Nullable JSPointerDispatcher mJSPointerDispatcher;
+  private @Nullable JSKeyDispatcher mJSKeyDispatcher;
   private final ReactAndroidHWInputDeviceHelper mAndroidHWInputDeviceHelper =
       new ReactAndroidHWInputDeviceHelper();
   private boolean mWasMeasured = false;
@@ -334,10 +336,17 @@ public class ReactRootView extends FrameLayout implements RootView, ReactRoot {
       FLog.w(TAG, "Unable to handle key event as the catalyst instance has not been attached");
       return super.dispatchKeyEvent(ev);
     }
+
     ReactContext context = getCurrentReactContext();
-    if (context != null) {
-      mAndroidHWInputDeviceHelper.handleKeyEvent(ev, context);
+    if (context == null) {
+      return super.dispatchKeyEvent(ev);
     }
+
+    mAndroidHWInputDeviceHelper.handleKeyEvent(ev, context);
+
+    // Dispatch during the capture phase before children handle the event as the focus could shift
+    dispatchJSKeyEvent(ev);
+
     return super.dispatchKeyEvent(ev);
   }
 
@@ -378,6 +387,31 @@ public class ReactRootView extends FrameLayout implements RootView, ReactRoot {
     }
   }
 
+  protected void dispatchJSKeyEvent(KeyEvent ev) {
+    if (!ReactNativeFeatureFlags.enableKeyEvents()) {
+      // Silently return early if key events are disabled
+      return;
+    }
+    if (!hasActiveReactContext() || !isViewAttachedToReactInstance()) {
+      FLog.w(
+          TAG, "Unable to dispatch key event to JS as the catalyst instance has not been attached");
+      return;
+    }
+    if (mJSKeyDispatcher == null) {
+      FLog.w(TAG, "Unable to dispatch key event to JS before the dispatcher is available");
+      return;
+    }
+    ReactContext context = getCurrentReactContext();
+    if (context != null) {
+      EventDispatcher eventDispatcher =
+          UIManagerHelper.getEventDispatcher(context, getUIManagerType());
+      int surfaceId = UIManagerHelper.getSurfaceId(context);
+      if (eventDispatcher != null) {
+        mJSKeyDispatcher.handleKeyEvent(ev, eventDispatcher, surfaceId);
+      }
+    }
+  }
+
   @Override
   public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) {
     // Override in order to still receive events to onInterceptTouchEvent even when some other
@@ -634,6 +668,10 @@ public class ReactRootView extends FrameLayout implements RootView, ReactRoot {
       mJSPointerDispatcher = new JSPointerDispatcher(this);
     }
 
+    if (ReactNativeFeatureFlags.enableKeyEvents()) {
+      mJSKeyDispatcher = new JSKeyDispatcher();
+    }
+
     if (mRootViewEventListener != null) {
       mRootViewEventListener.onAttachedToReactInstance(this);
     }
@@ -712,6 +750,9 @@ public class ReactRootView extends FrameLayout implements RootView, ReactRoot {
     if (ReactFeatureFlags.dispatchPointerEvents) {
       mJSPointerDispatcher = new JSPointerDispatcher(this);
     }
+    if (ReactNativeFeatureFlags.enableKeyEvents()) {
+      mJSKeyDispatcher = new JSKeyDispatcher();
+    }
   }
 
   @VisibleForTesting

package/ReactAndroid/src/main/java/com/facebook/react/ViewManagerOnDemandReactPackage.kt

@@ -10,16 +10,65 @@ package com.facebook.react
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.uimanager.ViewManager
 
+/**
+ * Interface for React Native packages that provide ViewManagers on-demand rather than eagerly.
+ *
+ * This interface enables lazy initialization of ViewManagers, improving startup performance by
+ * deferring the creation of ViewManager instances until they are actually needed by the JavaScript
+ * code. Instead of instantiating all ViewManagers during package initialization, implementing
+ * classes can defer creation until a specific ViewManager is requested by name.
+ *
+ * This pattern is particularly beneficial for applications with many ViewManagers, as it reduces
+ * memory footprint and initialization time by only creating the ViewManagers that are actively
+ * used.
+ *
+ * Implementing classes should maintain a registry or factory mechanism to create ViewManagers based
+ * on their names when requested.
+ *
+ * @see com.facebook.react.uimanager.ViewManager
+ * @see com.facebook.react.ReactPackage
+ */
 public interface ViewManagerOnDemandReactPackage {
   /**
-   * Provides a list of names of ViewManagers with which these modules can be accessed from JS.
-   * Typically, this is ViewManager.getName().
+   * Provides the names of all ViewManagers available in this package.
+   *
+   * This method returns a collection of ViewManager names that can be accessed from JavaScript. The
+   * names returned should match the values returned by [ViewManager.getName] for each ViewManager
+   * that this package can create. The React Native framework uses these names to determine which
+   * ViewManagers are available and to request their creation on-demand.
+   *
+   * This method is called during the initialization phase to register available ViewManagers
+   * without actually instantiating them, enabling lazy loading.
+   *
+   * @param reactContext The React application context, which provides access to the Android
+   *   application context and React Native lifecycle information
+   * @return A collection of ViewManager names. Returns an empty collection if no ViewManagers are
+   *   available. The returned names should be unique within this package
    */
   public fun getViewManagerNames(reactContext: ReactApplicationContext): Collection<String>
 
   /**
-   * Creates and returns a ViewManager with a specific name {@param viewManagerName}. It's up to an
-   * implementing package how to interpret the name.
+   * Creates and returns a ViewManager instance for the specified name.
+   *
+   * This method is called lazily when a ViewManager is actually needed by the JavaScript code,
+   * rather than during package initialization. The implementation should create and configure the
+   * appropriate ViewManager based on the provided name. The name parameter corresponds to one of
+   * the names returned by [getViewManagerNames].
+   *
+   * Implementations have flexibility in how they interpret the name and create ViewManagers. For
+   * example, they might use a factory pattern, reflection, or a simple name-to-class mapping.
+   *
+   * This method may be called on any thread, so implementations should ensure thread safety if
+   * necessary.
+   *
+   * @param reactContext The React application context, which provides access to the Android
+   *   application context and React Native lifecycle information needed to initialize the
+   *   ViewManager
+   * @param viewManagerName The name of the ViewManager to create, matching one of the names
+   *   returned by [getViewManagerNames]
+   * @return A ViewManager instance for the specified name, or null if the name is not recognized or
+   *   the ViewManager cannot be created. Returning null will result in a JavaScript error when the
+   *   native component is used
    */
   public fun createViewManager(
       reactContext: ReactApplicationContext,

package/ReactAndroid/src/main/java/com/facebook/react/bridge/CatalystInstance.kt

@@ -75,24 +75,6 @@ public interface CatalystInstance : MemoryPressureListener, JSInstance, JSBundle
    */
   public fun extendNativeModules(modules: NativeModuleRegistry)
 
-  /**
-   * Adds a idle listener for this Catalyst instance. The listener will receive notifications
-   * whenever the bridge transitions from idle to busy and vice-versa, where the busy state is
-   * defined as there being some non-zero number of calls to JS that haven't resolved via a
-   * onBatchCompleted call. The listener should be purely passive and not affect application logic.
-   */
-  public fun addBridgeIdleDebugListener(
-      @Suppress("DEPRECATION") listener: NotThreadSafeBridgeIdleDebugListener
-  )
-
-  /**
-   * Removes a NotThreadSafeBridgeIdleDebugListener previously added with
-   * [addBridgeIdleDebugListener]
-   */
-  public fun removeBridgeIdleDebugListener(
-      @Suppress("DEPRECATION") listener: NotThreadSafeBridgeIdleDebugListener
-  )
-
   /** This method registers the file path of an additional JS segment by its ID. */
   public fun registerSegment(segmentId: Int, path: String)