react-native-tvos 0.75.2-0rc0 → 0.76.0-0rc0

package/ReactAndroid/src/main/java/com/facebook/react/bridge/{JavaJSExecutor.java → JavaJSExecutor.kt}

@@ -5,40 +5,35 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-package com.facebook.react.bridge;
+package com.facebook.react.bridge
 
-import com.facebook.proguard.annotations.DoNotStrip;
+import com.facebook.proguard.annotations.DoNotStrip
 
 /**
- * This is class represents java version of native js executor interface. When set through {@link
- * ProxyJavaScriptExecutor} as a {@link CatalystInstance} executor, native code will delegate js
- * calls to the given implementation of this interface.
+ * This is class represents java version of native js executor interface. When set through
+ * [ProxyJavaScriptExecutor] as a [CatalystInstance] executor, native code will delegate js calls to
+ * the given implementation of this interface.
  */
 @DoNotStrip
 public interface JavaJSExecutor {
-  interface Factory {
-    JavaJSExecutor create() throws Exception;
+  public interface Factory {
+    @Throws(Exception::class) public fun create(): JavaJSExecutor?
   }
 
-  class ProxyExecutorException extends Exception {
-    public ProxyExecutorException(Throwable cause) {
-      super(cause);
-    }
-  }
+  public class ProxyExecutorException(cause: Throwable) : Exception(cause)
 
   /**
    * Close this executor and cleanup any resources that it was using. No further calls are expected
    * after this.
    */
-  void close();
+  public fun close()
 
   /**
    * Load javascript into the js context
    *
    * @param sourceURL url or file location from which script content was loaded
    */
-  @DoNotStrip
-  void loadBundle(String sourceURL) throws ProxyExecutorException;
+  @DoNotStrip @Throws(ProxyExecutorException::class) public fun loadBundle(sourceURL: String)
 
   /**
    * Execute javascript method within js context
@@ -48,8 +43,8 @@ public interface JavaJSExecutor {
    * @return json encoded value returned from the method call
    */
   @DoNotStrip
-  String executeJSCall(String methodName, String jsonArgsArray) throws ProxyExecutorException;
+  @Throws(ProxyExecutorException::class)
+  public fun executeJSCall(methodName: String, jsonArgsArray: String?): String?
 
-  @DoNotStrip
-  void setGlobalVariable(String propertyName, String jsonEncodedValue);
+  @DoNotStrip public fun setGlobalVariable(propertyName: String, jsonEncodedValue: String)
 }

package/ReactAndroid/src/main/java/com/facebook/react/bridge/{JavaScriptExecutorFactory.java → JavaScriptExecutorFactory.kt}

@@ -5,21 +5,21 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-package com.facebook.react.bridge;
+package com.facebook.react.bridge
 
 public interface JavaScriptExecutorFactory {
-  JavaScriptExecutor create() throws Exception;
+  @Throws(Exception::class) public fun create(): JavaScriptExecutor
 
   /**
    * Starts the sampling profiler for this specific JavaScriptExecutor Sampling profiler is usually
-   * a singleton on the runtime, hence the method exists here and not in {@link JavaScriptExecutor}
+   * a singleton on the runtime, hence the method exists here and not in [JavaScriptExecutor]
    */
-  void startSamplingProfiler();
+  public fun startSamplingProfiler()
 
   /**
    * Stops the Sampling profile
    *
    * @param filename The filename where the results of the sampling profiler are dumped to
    */
-  void stopSamplingProfiler(String filename);
+  public fun stopSamplingProfiler(filename: String)
 }

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

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+package com.facebook.react.bridge
+
+import com.facebook.proguard.annotations.DoNotStripAny
+
+/**
+ * Interface denoting that a class is the interface to a module with the same name in JS. Calling
+ * functions on this interface will result in corresponding methods in JS being called.
+ *
+ * When extending JavaScriptModule and registering it with a CatalystInstance, all public methods
+ * are assumed to be implemented on a JS module with the same name as this class. Calling methods on
+ * the object returned from [ReactContext.getJSModule] or [CatalystInstance.getJSModule] will result
+ * in the methods with those names exported by that module being called in JS.
+ *
+ * NB: JavaScriptModule does not allow method name overloading because JS does not allow method name
+ * overloading.
+ */
+@DoNotStripAny public interface JavaScriptModule

package/ReactAndroid/src/main/java/com/facebook/react/{animated/AnimatedNodeValueListener.java → bridge/PerformanceCounter.kt}

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-package com.facebook.react.animated;
+package com.facebook.react.bridge
+public interface PerformanceCounter {
+  public fun profileNextBatch()
 
-/** Interface used to listen to {@link ValueAnimatedNode} updates. */
-interface AnimatedNodeValueListener {
-  void onValueUpdate(double value);
+  public val performanceCounters: Map<String, Long>?
 }

package/ReactAndroid/src/main/java/com/facebook/react/bridge/{Promise.java → Promise.kt}

@@ -5,10 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-package com.facebook.react.bridge;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
+package com.facebook.react.bridge
 
 /*
  * Interface that represents a JavaScript Promise which can be passed to the native module as a
@@ -18,13 +15,12 @@ import androidx.annotation.Nullable;
  * will be marked as "promise" and will return a promise when invoked from JavaScript.
  */
 public interface Promise {
-
   /**
    * Successfully resolve the Promise with an optional value.
    *
    * @param value Object
    */
-  void resolve(@Nullable Object value);
+  public fun resolve(value: Any?)
 
   /**
    * Report an error without an exception using a custom code and error message.
@@ -32,7 +28,7 @@ public interface Promise {
    * @param code String
    * @param message String
    */
-  void reject(String code, String message);
+  public fun reject(code: String, message: String?)
 
   /**
    * Report an exception with a custom code.
@@ -40,7 +36,7 @@ public interface Promise {
    * @param code String
    * @param throwable Throwable
    */
-  void reject(String code, Throwable throwable);
+  public fun reject(code: String, throwable: Throwable?)
 
   /**
    * Report an exception with a custom code and error message.
@@ -49,7 +45,7 @@ public interface Promise {
    * @param message String
    * @param throwable Throwable
    */
-  void reject(String code, String message, Throwable throwable);
+  public fun reject(code: String, message: String?, throwable: Throwable?)
 
   /**
    * Report an exception, with default error code. Useful in catch-all scenarios where it's unclear
@@ -57,12 +53,11 @@ public interface Promise {
    *
    * @param throwable Throwable
    */
-  void reject(Throwable throwable);
+  public fun reject(throwable: Throwable)
 
   /* ---------------------------
    *  With userInfo WritableMap
    * --------------------------- */
-
   /**
    * Report an exception, with default error code, with userInfo. Useful in catch-all scenarios
    * where it's unclear why the error occurred.
@@ -70,7 +65,7 @@ public interface Promise {
    * @param throwable Throwable
    * @param userInfo WritableMap
    */
-  void reject(Throwable throwable, WritableMap userInfo);
+  public fun reject(throwable: Throwable, userInfo: WritableMap)
 
   /**
    * Reject with a code and userInfo WritableMap.
@@ -78,7 +73,7 @@ public interface Promise {
    * @param code String
    * @param userInfo WritableMap
    */
-  void reject(String code, @NonNull WritableMap userInfo);
+  public fun reject(code: String, userInfo: WritableMap)
 
   /**
    * Report an exception with a custom code and userInfo.
@@ -87,7 +82,7 @@ public interface Promise {
    * @param throwable Throwable
    * @param userInfo WritableMap
    */
-  void reject(String code, Throwable throwable, WritableMap userInfo);
+  public fun reject(code: String, throwable: Throwable?, userInfo: WritableMap)
 
   /**
    * Report an error with a custom code, error message and userInfo, an error not caused by an
@@ -97,7 +92,7 @@ public interface Promise {
    * @param message String
    * @param userInfo WritableMap
    */
-  void reject(String code, String message, @NonNull WritableMap userInfo);
+  public fun reject(code: String, message: String?, userInfo: WritableMap)
 
   /**
    * Report an exception with a custom code, error message and userInfo.
@@ -107,18 +102,13 @@ public interface Promise {
    * @param throwable Throwable
    * @param userInfo WritableMap
    */
-  void reject(String code, String message, Throwable throwable, WritableMap userInfo);
-
-  /* ------------
-   *  Deprecated
-   * ------------ */
-
-  /**
-   * Report an error which wasn't caused by an exception.
-   *
-   * @deprecated Prefer passing a module-specific error code to JS. Using this method will pass the
-   *     error code "EUNSPECIFIED".
-   */
-  @Deprecated
-  void reject(String message);
+  public fun reject(code: String?, message: String?, throwable: Throwable?, userInfo: WritableMap?)
+
+  /** Report an error which wasn't caused by an exception. */
+  @Deprecated(
+      message =
+          """Prefer passing a module-specific error code to JS. Using this method will pass the
+        error code EUNSPECIFIED""",
+      replaceWith = ReplaceWith("reject(code, message)"))
+  public fun reject(message: String)
 }

package/ReactAndroid/src/main/java/com/facebook/react/bridge/ReactContext.java

@@ -265,6 +265,19 @@ public abstract class ReactContext extends ContextWrapper {
     ReactMarker.logMarker(ReactMarkerConstants.ON_HOST_RESUME_END);
   }
 
+  @ThreadConfined(UI)
+  public void onUserLeaveHint(@Nullable Activity activity) {
+    ReactMarker.logMarker(ReactMarkerConstants.ON_USER_LEAVE_HINT_START);
+    for (ActivityEventListener listener : mActivityEventListeners) {
+      try {
+        listener.onUserLeaveHint(activity);
+      } catch (RuntimeException e) {
+        handleException(e);
+      }
+    }
+    ReactMarker.logMarker(ReactMarkerConstants.ON_USER_LEAVE_HINT_END);
+  }
+
   @ThreadConfined(UI)
   public void onNewIntent(@Nullable Activity activity, Intent intent) {
     UiThreadUtil.assertOnUiThread();

package/ReactAndroid/src/main/java/com/facebook/react/bridge/ReactInstanceManagerInspectorTarget.java

@@ -10,6 +10,8 @@ package com.facebook.react.bridge;
 import com.facebook.infer.annotation.Nullsafe;
 import com.facebook.jni.HybridData;
 import com.facebook.proguard.annotations.DoNotStripAny;
+import com.facebook.react.devsupport.inspector.InspectorNetworkRequestListener;
+import java.util.Map;
 import java.util.concurrent.Executor;
 import javax.annotation.Nullable;
 
@@ -18,9 +20,17 @@ import javax.annotation.Nullable;
 public class ReactInstanceManagerInspectorTarget implements AutoCloseable {
   @DoNotStripAny
   public interface TargetDelegate {
+    /** Android implementation for {@code HostTargetDelegate::getMetadata} */
+    public Map<String, String> getMetadata();
+
+    /** Android implementation for {@code HostTargetDelegate::onReload} */
     public void onReload();
 
+    /** Android implementation for {@code HostTargetDelegate::onSetPausedInDebuggerMessage} */
     public void onSetPausedInDebuggerMessage(@Nullable String message);
+
+    /** Android implementation for {@code HostTargetDelegate::loadNetworkResource} */
+    public void loadNetworkResource(String url, InspectorNetworkRequestListener listener);
   }
 
   private final HybridData mHybridData;

package/ReactAndroid/src/main/java/com/facebook/react/bridge/ReactMarkerConstants.java

@@ -52,6 +52,8 @@ public enum ReactMarkerConstants {
   INITIALIZE_MODULE_END,
   ON_HOST_RESUME_START,
   ON_HOST_RESUME_END,
+  ON_USER_LEAVE_HINT_START,
+  ON_USER_LEAVE_HINT_END,
   ON_HOST_PAUSE_START,
   ON_HOST_PAUSE_END,
   CONVERT_CONSTANTS_START,

package/ReactAndroid/src/main/java/com/facebook/react/bridge/ReactNoCrashSoftException.java

@@ -7,6 +7,8 @@
 
 package com.facebook.react.bridge;
 
+import javax.annotation.Nullable;
+
 /**
  * Extends RuntimeException so that it may be caught by a {@link ReactSoftExceptionListener}. Any
  * {@link ReactSoftExceptionListener} that catches a ReactNoCrashSoftException should log it only
@@ -21,7 +23,7 @@ public class ReactNoCrashSoftException extends RuntimeException {
     super(e);
   }
 
-  public ReactNoCrashSoftException(String m, Throwable e) {
+  public ReactNoCrashSoftException(String m, @Nullable Throwable e) {
     super(m, e);
   }
 }

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

@@ -0,0 +1,178 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+package com.facebook.react.bridge
+
+import android.view.View
+import androidx.annotation.AnyThread
+import androidx.annotation.UiThread
+import com.facebook.infer.annotation.ThreadConfined
+import com.facebook.react.common.annotations.UnstableReactNativeAPI
+
+@OptIn(UnstableReactNativeAPI::class)
+public interface UIManager : PerformanceCounter {
+  /** Registers a new root view. @Deprecated call startSurface instead */
+  @UiThread
+  @ThreadConfined(ThreadConfined.UI)
+  @Deprecated("")
+  public fun <T : View?> addRootView(rootView: T, initialProps: WritableMap?): Int
+
+  /** Registers a new root view with width and height. */
+  @AnyThread
+  public fun <T : View?> startSurface(
+      rootView: T,
+      moduleName: String,
+      initialProps: WritableMap?,
+      widthMeasureSpec: Int,
+      heightMeasureSpec: Int
+  ): Int
+
+  /**
+   * Stop a surface from running in JS and clears up native memory usage. Assumes that the native
+   * View hierarchy has already been cleaned up. Fabric-only.
+   */
+  @AnyThread public fun stopSurface(surfaceId: Int)
+
+  /**
+   * Updates the layout specs of the RootShadowNode based on the Measure specs received by
+   * parameters. offsetX and offsetY are the position of the RootView within the screen.
+   */
+  @UiThread
+  @ThreadConfined(ThreadConfined.UI)
+  public fun updateRootLayoutSpecs(
+      rootTag: Int,
+      widthMeasureSpec: Int,
+      heightMeasureSpec: Int,
+      offsetX: Int,
+      offsetY: Int
+  )
+
+  /**
+   * Dispatches the commandId received by parameter to the view associated with the reactTag. The
+   * command will be processed in the UIThread.
+   *
+   * Receiving commands as ints is deprecated and will be removed in a future release.
+   *
+   * Pre-Fabric, this is only called on the Native Module Thread.
+   *
+   * @param reactTag that identifies the view that will receive this command
+   * @param commandId command id
+   * @param commandArgs [ReadableArray] parameters associated with the command
+   */
+  public fun dispatchCommand(reactTag: Int, commandId: Int, commandArgs: ReadableArray?)
+
+  /**
+   * Dispatches the commandId received by parameter to the view associated with the reactTag. The
+   * command will be processed in the UIThread.
+   *
+   * Pre-Fabric, this is only called on the Native Module Thread.
+   *
+   * @param reactTag that identifies the view that will receive this command
+   * @param commandId command id
+   * @param commandArgs [ReadableArray] parameters associated with the command
+   */
+  public fun dispatchCommand(reactTag: Int, commandId: String, commandArgs: ReadableArray?)
+
+  /** @return the [EventDispatcher] object that is used by this class. */
+  public fun <T> getEventDispatcher(): T
+
+  /**
+   * Used by native animated module to bypass the process of updating the values through the shadow
+   * view hierarchy. This method will directly update native views, which means that updates for
+   * layout-related propertied won't be handled properly. Make sure you know what you're doing
+   * before calling this method :)
+   *
+   * @param reactTag that identifies the view that will be updated
+   * @param props [ReadableMap] props that should be immediately updated in view
+   */
+  @UiThread
+  @ThreadConfined(ThreadConfined.UI)
+  public fun synchronouslyUpdateViewOnUIThread(reactTag: Int, props: ReadableMap?)
+
+  /**
+   * Dispatch an accessibility event to a view asynchronously.
+   *
+   * Pre-Fabric, this is only called on the Native Module Thread.
+   *
+   * @param reactTag
+   * @param eventType
+   */
+  public fun sendAccessibilityEvent(reactTag: Int, eventType: Int)
+
+  /**
+   * Register a [UIManagerListener] with this UIManager to receive lifecycle callbacks.
+   *
+   * @param listener
+   */
+  public fun addUIManagerEventListener(listener: UIManagerListener?)
+
+  /**
+   * Unregister a [UIManagerListener] from this UIManager to stop receiving lifecycle callbacks.
+   *
+   * @param listener
+   */
+  public fun removeUIManagerEventListener(listener: UIManagerListener?)
+
+  /**
+   * Resolves a view based on its reactTag. Do not mutate properties on this view that are already
+   * managed by React, as there are no guarantees this changes will be preserved.
+   *
+   * @param reactTag tag
+   * @return view if found
+   * @throws IllegalViewOperationException if tag could not be resolved.
+   */
+  public fun resolveView(reactTag: Int): View?
+
+  /**
+   * This method dispatches events from RN Android code to JS. The delivery of this event will not
+   * be queued in EventDispatcher class.
+   *
+   * @param reactTag tag
+   * @param eventName name of the event
+   * @param event parameters
+   */
+  @Deprecated("", ReplaceWith("receiveEvent(surfaceId, reactTag, eventName, event)"))
+  public fun receiveEvent(reactTag: Int, eventName: String, event: WritableMap?)
+
+  /**
+   * This method dispatches events from RN Android code to JS. The delivery of this event will not
+   * be queued in EventDispatcher class.
+   *
+   * @param surfaceId
+   * @param reactTag tag
+   * @param eventName name of the event
+   * @param event parameters
+   */
+  public fun receiveEvent(surfaceId: Int, reactTag: Int, eventName: String, event: WritableMap?)
+
+  /** Resolves Direct Event name exposed to JS from the one known to the Native side. */
+  @Deprecated("") public fun resolveCustomDirectEventName(eventName: String): String?
+
+  /** This method is called after [ReactApplicationContext] has been created. */
+  public fun initialize()
+
+  /** Called before React Native instance is destroyed. */
+  public fun invalidate()
+
+  /**
+   * Mark a view as currently active for a touch event. This information could be used by the
+   * [UIManager] to decide if a view could be safely destroyed or not.
+   *
+   * @param surfaceId The surface ID where the view is rendered.
+   * @param reactTag The react tag for the specific view
+   */
+  public fun markActiveTouchForTag(surfaceId: Int, reactTag: Int)
+
+  /**
+   * Sweep a view as currently not active for a touch event. This tells the [UIManager] that the
+   * view is not being interacted by the user and can safely be destroyed.
+   *
+   * @param surfaceId The surface ID where the view is rendered.
+   * @param reactTag The react tag for the specific view
+   */
+  public fun sweepActiveTouchForTag(surfaceId: Int, reactTag: Int)
+}

package/ReactAndroid/src/main/java/com/facebook/react/bridge/interop/InteropModuleRegistry.java

@@ -10,6 +10,7 @@ package com.facebook.react.bridge.interop;
 import androidx.annotation.Nullable;
 import com.facebook.react.bridge.JavaScriptModule;
 import com.facebook.react.config.ReactFeatureFlags;
+import com.facebook.react.internal.featureflags.ReactNativeFeatureFlags;
 import java.util.HashMap;
 
 /**
@@ -51,6 +52,6 @@ public class InteropModuleRegistry {
   }
 
   private boolean checkReactFeatureFlagsConditions() {
-    return ReactFeatureFlags.enableFabricRenderer && ReactFeatureFlags.unstable_useFabricInterop;
+    return ReactFeatureFlags.enableFabricRenderer && ReactNativeFeatureFlags.useFabricInterop();
   }
 }

package/ReactAndroid/src/main/java/com/facebook/react/bridge/queue/MessageQueueThread.java

@@ -7,6 +7,7 @@
 
 package com.facebook.react.bridge.queue;
 
+import androidx.annotation.Nullable;
 import com.facebook.proguard.annotations.DoNotStrip;
 import java.util.concurrent.Callable;
 import java.util.concurrent.Future;
@@ -60,6 +61,7 @@ public interface MessageQueueThread {
    * Returns the perf counters taken when the framework was started. This method is intended to be
    * used for instrumentation purposes.
    */
+  @Nullable
   @DoNotStrip
   MessageQueueThreadPerfStats getPerfStats();