Kotlinify GuardedFrameCallback (#43841)

Summary:
Pull Request resolved: #43841

Changelog: [Internal]

As part of the Sustainability Week (see [post](https://fb.workplace.com/groups/251759413609061/permalink/742797531171911/)).

Reviewed By: cortinico

Differential Revision: D55732555

fbshipit-source-id: baab9a33be7d963dfe0fe765211de3d5abaebaca

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

@@ -4049,7 +4049,7 @@ public final class com/facebook/react/uimanager/FloatUtil {
 
 public abstract class com/facebook/react/uimanager/GuardedFrameCallback : android/view/Choreographer$FrameCallback {
 	protected fun <init> (Lcom/facebook/react/bridge/ReactContext;)V
-	public final fun doFrame (J)V
+	public fun doFrame (J)V
 	protected abstract fun doFrameGuarded (J)V
 }
 

packages/react-native/ReactAndroid/src/main/java/com/facebook/react/uimanager/GuardedFrameCallback.kt

@@ -0,0 +1,33 @@
+/*
+ * 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.uimanager
+
+import android.view.Choreographer
+import com.facebook.react.bridge.ReactContext
+
+/**
+ * Abstract base for a Choreographer FrameCallback that should have any RuntimeExceptions it throws
+ * handled by the [JSExceptionHandler] registered if the app is in dev mode.
+ */
+public abstract class GuardedFrameCallback
+protected constructor(private val reactContext: ReactContext) : Choreographer.FrameCallback {
+
+  override public fun doFrame(frameTimeNanos: Long) {
+    try {
+      doFrameGuarded(frameTimeNanos)
+    } catch (e: RuntimeException) {
+      reactContext.handleException(e)
+    }
+  }
+
+  /**
+   * Like the standard doFrame but RuntimeExceptions will be caught and passed to
+   * [ReactContext#handleException(RuntimeException)].
+   */
+  protected abstract fun doFrameGuarded(frameTimeNanos: Long)
+}