react-native-tvos 0.83.0-0rc4 → 0.83.1-1

package/Libraries/Core/ReactNativeVersion.js

@@ -28,8 +28,8 @@
 export default class ReactNativeVersion {
   static major: number = 0;
   static minor: number = 83;
-  static patch: number = 0;
-  static prerelease: string | null = '0rc4';
+  static patch: number = 1;
+  static prerelease: string | null = '1';
 
   static getVersionString(): string {
     return `${this.major}.${this.minor}.${this.patch}${this.prerelease != null ? `-${this.prerelease}` : ''}`;

package/README.md

@@ -94,64 +94,26 @@ See the [Building Expo apps for TV](https://docs.expo.dev/guides/building-for-tv
 
 Using Expo's [continuous native generation (CNG)](https://docs.expo.dev/workflow/continuous-native-generation/) model, projects created this way can be used to build either mobile or TV apps, taking advantage of the full support for both mobile and TV platforms in this repo.
 
-### Project creation using the React Native Community CLI
+### Creating a new project with the Community CLI
 
-As of React Native 0.75.x, the template that used to reside in the `react-native` core package has been moved to a [new community repo](https://github.com/react-native-community/template) and will be maintained there. To support developers that wish to continue using the community CLI, we have created a [new TV template repository](https://github.com/react-native-tvos/template-tv) and will maintain a TV port of this template.
+We maintain [template-tv](https://github.com/react-native-tvos/template-tv), a TV-specific template for developers using the React Native Community CLI. This project extends the Community CLI with `run-tvos`, `build-tvos`, and `log-tvos` commands for tvOS development.
 
-> _Note:_ The new TV template will only build apps for Apple TV and Android TV. Multiple platform targets are no longer supported in React Native app Podfiles.
-
-To create a new project for RNTV 0.81:
+> [!NOTE]
+> This template only supports Apple TV and Android TV. Multiple platform targets are no longer supported in React Native app Podfiles.
 
+**Quick start:**
 ```sh
-# 
-# Init an app called 'TVTest', note that you must not be in a node module (directory with node_modules sub-directory) for this to work
-$ npx @react-native-community/cli@latest init TVTest --template @react-native-tvos/template-tv
-                                                          
-               ######                ######               
-             ###     ####        ####     ###             
-            ##          ###    ###          ##            
-            ##             ####             ##            
-            ##             ####             ##            
-            ##           ##    ##           ##            
-            ##         ###      ###         ##            
-             ##  ########################  ##             
-          ######    ###            ###    ######          
-      ###     ##    ##              ##    ##     ###      
-   ###         ## ###      ####      ### ##         ###   
-  ##           ####      ########      ####           ##  
- ##             ###     ##########     ###             ## 
-  ##           ####      ########      ####           ##  
-   ###         ## ###      ####      ### ##         ###   
-      ###     ##    ##              ##    ##     ###      
-          ######    ###            ###    ######          
-             ##  ########################  ##             
-            ##         ###      ###         ##            
-            ##           ##    ##           ##            
-            ##             ####             ##            
-            ##             ####             ##            
-            ##          ###    ###          ##            
-             ###     ####        ####     ###             
-               ######                ######               
-                                                          
-
-              Welcome to React Native 0.81!                
-                 Learn once, write anywhere               
-
-✔ Downloading template
-✔ Copying template
-✔ Processing template
-✔ Installing dependencies
-✔ Do you want to install CocoaPods now? Only needed if you run your project in Xcode directly … yes
-✔ Installing Ruby Gems
-✔ Installing CocoaPods dependencies  (this may take a few minutes)
-.
-.
-.
-$ cd TVTest
-# Now build and start the app in the tvOS Simulator - this will only work on a macOS machine.
-npx react-native run-ios --simulator "Apple TV"
-# This command builds and starts the app in an Android TV emulator (needs to be created in advance).
-npx react-native run:android --device tv_api_31
+# Initialize a new app called 'TVTest'
+# This command should be run outside of any existing node project
+npx @react-native-community/cli@latest init TVTest --template @react-native-tvos/template-tv
+
+cd TVTest
+
+# Build and run on tvOS Simulator (macOS only, requires Apple TV simulator)
+npx react-native run-tvos --simulator "Apple TV"
+
+# Build and run on Android TV emulator (requires Android TV emulator)
+npx react-native run-android --device tv_api_31
 ```
 
 ## How to support TV specific file extensions

package/React/Base/RCTVersion.m

@@ -23,8 +23,8 @@ NSDictionary* RCTGetReactNativeVersion(void)
     __rnVersion = @{
                   RCTVersionMajor: @(0),
                   RCTVersionMinor: @(83),
-                  RCTVersionPatch: @(0),
-                  RCTVersionPrerelease: @"0rc4",
+                  RCTVersionPatch: @(1),
+                  RCTVersionPrerelease: @"1",
                   };
   });
   return __rnVersion;

package/React/Fabric/Mounting/ComponentViews/ScrollView/RCTScrollViewComponentView.mm

@@ -1146,13 +1146,11 @@ static inline UIViewAnimationOptions animationOptionsWithCurve(UIViewAnimationCu
     if (context.nextFocusedView == self) {
         [self becomeFirstResponder];
         [self addSwipeGestureRecognizers];
-        [self sendFocusNotification];
         // if we enter the scroll view from different view then block first touch event since it is the event that triggered the focus
         _blockFirstTouch = (unsigned long)context.focusHeading != 0;
         [self addArrowsListeners];
     } else if (context.previouslyFocusedView == self) {
         [self removeArrowsListeners];
-        [self sendBlurNotification];
         [self removeSwipeGestureRecognizers];
         [self resignFirstResponder];
         // If scrolling is enabled:
@@ -1261,16 +1259,6 @@ static inline UIViewAnimationOptions animationOptionsWithCurve(UIViewAnimationCu
     return [super shouldUpdateFocusInContext:context];
 }
 
-- (void)sendFocusNotification
-{
-    [[NSNotificationCenter defaultCenter] postNavigationFocusEventWithTag:@(self.tag) target:nil];
-}
-
-- (void)sendBlurNotification
-{
-    [[NSNotificationCenter defaultCenter] postNavigationBlurEventWithTag:@(self.tag) target:nil];
-}
-
 - (NSInteger)swipeVerticalInterval
 {
     RCTEnhancedScrollView *scrollView = (RCTEnhancedScrollView *)_scrollView;

package/React/Fabric/Mounting/ComponentViews/View/RCTViewComponentView.mm

@@ -265,16 +265,6 @@ const CGFloat BACKGROUND_COLOR_ZPOSITION = -1024.0f;
   [self handleFocusGuide];
 }
 
-- (void)sendFocusNotification:(__unused UIFocusUpdateContext *)context
-{
-    [[NSNotificationCenter defaultCenter] postNavigationFocusEventWithTag:@(self.tag) target:@(self.tag)];
-}
-
-- (void)sendBlurNotification:(__unused UIFocusUpdateContext *)context
-{
-    [[NSNotificationCenter defaultCenter] postNavigationBlurEventWithTag:@(self.tag) target:@(self.tag)];
-}
-
 - (void)sendSelectNotification
 {
   [[NSNotificationCenter defaultCenter] postNavigationPressEventWithType:RCTTVRemoteEventSelect keyAction:RCTTVRemoteEventKeyActionUp tag:@(self.tag) target:@(self.tag)];
@@ -596,7 +586,6 @@ const CGFloat BACKGROUND_COLOR_ZPOSITION = -1024.0f;
       [self enableDirectionalFocusGuides];
       [coordinator addCoordinatedAnimations:^(void){
           if (self->_eventEmitter) self->_eventEmitter->onFocus();
-          [self sendFocusNotification:context];
           [self addParallaxMotionEffects];
       } completion:^(void){}];
       // Without this check, onBlur would also trigger when `TVFocusGuideView` transfers focus to its children.
@@ -607,7 +596,6 @@ const CGFloat BACKGROUND_COLOR_ZPOSITION = -1024.0f;
       [coordinator addCoordinatedAnimations:^(void){
           [self removeParallaxMotionEffects];
           if (self->_eventEmitter) self->_eventEmitter->onBlur();
-          [self sendBlurNotification:context];
       } completion:^(void){}];
       [self resignFirstResponder];
     }
@@ -1166,7 +1154,6 @@ const CGFloat BACKGROUND_COLOR_ZPOSITION = -1024.0f;
   // `autoFocus`
   if (oldViewProps.autoFocus != newViewProps.autoFocus) {
     _autoFocus = newViewProps.autoFocus;
-    [self handleFocusGuide];
   }
 
   _trapFocusUp = newViewProps.trapFocusUp;
@@ -1228,7 +1215,7 @@ const CGFloat BACKGROUND_COLOR_ZPOSITION = -1024.0f;
       [self requestFocusSelf];
     }
   }
-
+  [self handleFocusGuide];
 #endif
 
   if (_swiftUIWrapper != nullptr) {

package/React/Views/RCTTVView.h

@@ -70,11 +70,17 @@
 
 /**
  * Send Focus Notifications to listeners
+ * @deprecated This method emits focus events to TVEventHandler, which is deprecated.
+ * Use onFocus/onBlur component props instead. Will be removed when old arch is removed.
+ * See: https://github.com/react-native-tvos/react-native-tvos/issues/1037
  */
 - (void)sendFocusNotification:(UIFocusUpdateContext *)context;
 
 /**
  * Send Blur Notifications to listeners
+ * @deprecated This method emits blur events to TVEventHandler, which is deprecated.
+ * Use onFocus/onBlur component props instead. Will be removed when old arch is removed.
+ * See: https://github.com/react-native-tvos/react-native-tvos/issues/1037
  */
 - (void)sendBlurNotification:(UIFocusUpdateContext *)context;
 

package/ReactAndroid/gradle.properties

@@ -1,4 +1,4 @@
-VERSION_NAME=0.83.0-0rc4
+VERSION_NAME=0.83.1-1
 react.internal.publishingGroup=io.github.react-native-tvos
 react.internal.hermesPublishingGroup=com.facebook.hermes
 

package/ReactAndroid/src/main/java/com/facebook/react/modules/network/NetworkEventUtil.kt

@@ -15,6 +15,7 @@ import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.bridge.buildReadableArray
+import com.facebook.react.common.build.ReactBuildConfig
 import com.facebook.react.internal.featureflags.ReactNativeFeatureFlags
 import java.net.SocketTimeoutException
 import okhttp3.Headers
@@ -30,12 +31,21 @@ internal object NetworkEventUtil {
   fun onCreateRequest(devToolsRequestId: String, request: Request) {
     if (ReactNativeFeatureFlags.enableNetworkEventReporting()) {
       val headersMap = okHttpHeadersToMap(request.headers())
+      var requestBody = ""
+
+      if (ReactBuildConfig.DEBUG) {
+        // Debug build: Process request body for preview (CDP only)
+        requestBody =
+            (request.body() as? ProgressRequestBody)?.getBodyPreview()
+                ?: request.body()?.toString().orEmpty()
+      }
+
       InspectorNetworkReporter.reportRequestStart(
           devToolsRequestId,
           request.url().toString(),
           request.method(),
           headersMap,
-          request.body()?.toString().orEmpty(),
+          requestBody,
           request.body()?.contentLength() ?: 0,
       )
       InspectorNetworkReporter.reportConnectionTiming(devToolsRequestId, headersMap)

package/ReactAndroid/src/main/java/com/facebook/react/modules/network/ProgressRequestBody.kt

@@ -78,4 +78,9 @@ internal class ProgressRequestBody(
         }
     )
   }
+
+  fun getBodyPreview(): String {
+    // TODO: Safely implement request body previews
+    return "[Preview unavailable]"
+  }
 }

package/ReactAndroid/src/main/java/com/facebook/react/modules/systeminfo/ReactNativeVersion.kt

@@ -14,7 +14,7 @@ public object ReactNativeVersion {
   public val VERSION: Map<String, Any?> = mapOf(
     "major" to 0,
     "minor" to 83,
-    "patch" to 0,
-    "prerelease" to "0rc4"
+    "patch" to 1,
+    "prerelease" to "1"
   )
 }

package/ReactAndroid/src/main/java/com/facebook/react/views/view/ReactViewGroup.kt

@@ -1448,7 +1448,13 @@ public open class ReactViewGroup public constructor(context: Context?) :
     if (isFocusDestinationsSet) {
       val destination = findDestinationView()
 
-      if (destination != null && requestFocusViewOrAncestor(destination)) {
+      // Destination is set but there's no such element on the tree
+      // Just skip it to prevent cyclic issues.
+      if (destination == null) {
+        return false
+      }
+
+      if (destination.requestFocus()) {
         return true
       }
     }
@@ -1472,9 +1478,7 @@ public open class ReactViewGroup public constructor(context: Context?) :
       }
 
       // Try moving the focus to the first focusable element otherwise.
-      if (moveFocusToFirstFocusable(this)) {
-        return true
-      }
+      return moveFocusToFirstFocusable(this)
     }
 
     return super.requestFocus(direction, previouslyFocusedRect)
@@ -1606,21 +1610,5 @@ public open class ReactViewGroup public constructor(context: Context?) :
     fun setViewClipped(view: View, clipped: Boolean) {
       view.setTag(R.id.view_clipped, clipped)
     }
-
-    private fun requestFocusViewOrAncestor(destination: View): Boolean {
-      var v: View? = destination
-      while (v != null) {
-        if (v.requestFocus()) {
-          return true
-        }
-        val parent = v.parent
-        v = if (parent is View) {
-          parent
-        } else {
-          null
-        }
-      }
-      return false
-    }
   }
 }

package/ReactAndroid/src/main/java/com/facebook/react/views/view/ReactViewManager.kt

@@ -109,13 +109,13 @@ public open class ReactViewManager : ReactClippingViewManager<ReactViewGroup>()
 
   @ReactProp(name = "tvFocusable")
   public open fun setTvFocusable(view: ReactViewGroup, focusable: Boolean) {
-    setFocusable(view, focusable)
     if (!focusable) {
       view.isFocusable = false
       view.descendantFocusability = ViewGroup.FOCUS_BLOCK_DESCENDANTS
     } else {
       view.descendantFocusability = ViewGroup.FOCUS_AFTER_DESCENDANTS
     }
+    setFocusable(view, focusable)
   }
 
   @ReactProp(name = ViewProps.ACCESSIBILITY_ORDER)

package/ReactAndroid/src/main/jni/CMakeLists.txt

@@ -338,3 +338,10 @@ target_include_directories(reactnative
         $<TARGET_PROPERTY:uimanagerjni,INTERFACE_INCLUDE_DIRECTORIES>
         $<TARGET_PROPERTY:yoga,INTERFACE_INCLUDE_DIRECTORIES>
 )
+
+if(${CMAKE_BUILD_TYPE} MATCHES Debug OR REACT_NATIVE_DEBUG_OPTIMIZED)
+  target_compile_options(reactnative PRIVATE
+          -DREACT_NATIVE_DEBUGGER_ENABLED=1
+          -DREACT_NATIVE_DEBUGGER_ENABLED_DEVONLY=1
+  )
+endif ()

package/ReactAndroid/src/main/jni/react/devsupport/CMakeLists.txt

@@ -23,3 +23,10 @@ target_link_libraries(react_devsupportjni
         react_networking)
 
 target_compile_reactnative_options(react_devsupportjni PRIVATE)
+
+if(${CMAKE_BUILD_TYPE} MATCHES Debug OR REACT_NATIVE_DEBUG_OPTIMIZED)
+  target_compile_options(react_devsupportjni PRIVATE
+          -DREACT_NATIVE_DEBUGGER_ENABLED=1
+          -DREACT_NATIVE_DEBUGGER_ENABLED_DEVONLY=1
+  )
+endif ()

package/ReactCommon/cxxreact/ReactNativeVersion.h

@@ -14,15 +14,15 @@
 
 #define REACT_NATIVE_VERSION_MAJOR 0
 #define REACT_NATIVE_VERSION_MINOR 83
-#define REACT_NATIVE_VERSION_PATCH 0
+#define REACT_NATIVE_VERSION_PATCH 1
 
 namespace facebook::react {
 
 constexpr struct {
   int32_t Major = 0;
   int32_t Minor = 83;
-  int32_t Patch = 0;
-  std::string_view Prerelease = "0rc4";
+  int32_t Patch = 1;
+  std::string_view Prerelease = "1";
 } ReactNativeVersion;
 
 } // namespace facebook::react

package/ReactCommon/jsinspector-modern/HostAgent.cpp

@@ -147,7 +147,7 @@ class HostAgent::Impl final {
     if (InspectorFlags::getInstance().getNetworkInspectionEnabled()) {
       if (req.method == "Network.enable") {
         auto& inspector = getInspectorInstance();
-        if (inspector.getSystemState().registeredPagesCount > 1) {
+        if (inspector.getSystemState().registeredHostsCount > 1) {
           frontendChannel_(
               cdp::jsonError(
                   req.id,
@@ -231,7 +231,7 @@ class HostAgent::Impl final {
               "ReactNativeApplication.metadataUpdated",
               createHostMetadataPayload(hostMetadata_)));
       auto& inspector = getInspectorInstance();
-      bool isSingleHost = inspector.getSystemState().registeredPagesCount <= 1;
+      bool isSingleHost = inspector.getSystemState().registeredHostsCount <= 1;
       if (!isSingleHost) {
         emitSystemStateChanged(isSingleHost);
       }

package/ReactCommon/jsinspector-modern/InspectorInterfaces.cpp

@@ -67,8 +67,8 @@ class InspectorImpl : public IInspector {
    public:
     explicit SystemStateListener(InspectorSystemState& state) : state_(state) {}
 
-    void onPageAdded(int /*pageId*/) override {
-      state_.registeredPagesCount++;
+    void unstable_onHostTargetAdded() override {
+      state_.registeredHostsCount++;
     }
 
    private:
@@ -94,6 +94,7 @@ class InspectorImpl : public IInspector {
     ConnectFunc connectFunc_;
     InspectorTargetCapabilities capabilities_;
   };
+
   mutable std::mutex mutex_;
   int nextPageId_{1};
   std::map<int, Page> pages_;
@@ -142,9 +143,13 @@ int InspectorImpl::addPage(
       pageId,
       Page{pageId, description, vm, std::move(connectFunc), capabilities});
 
-  for (const auto& listenerWeak : listeners_) {
-    if (auto listener = listenerWeak.lock()) {
-      listener->onPageAdded(pageId);
+  // Strong assumption: If prefersFuseboxFrontend is set, the page added is a
+  // HostTarget and not a legacy Hermes runtime target.
+  if (capabilities.prefersFuseboxFrontend) {
+    for (const auto& listenerWeak : listeners_) {
+      if (auto listener = listenerWeak.lock()) {
+        listener->unstable_onHostTargetAdded();
+      }
     }
   }
 

package/ReactCommon/jsinspector-modern/InspectorInterfaces.h

@@ -53,7 +53,7 @@ using InspectorPage = InspectorPageDescription;
 
 struct InspectorSystemState {
   /** The total count of pages registered during the app lifetime. */
-  int registeredPagesCount;
+  int registeredHostsCount;
 };
 
 /// IRemoteConnection allows the VM to send debugger messages to the client.
@@ -83,7 +83,7 @@ class JSINSPECTOR_EXPORT ILocalConnection : public IDestructible {
 class JSINSPECTOR_EXPORT IPageStatusListener : public IDestructible {
  public:
   virtual ~IPageStatusListener() = 0;
-  virtual void onPageAdded(int /*pageId*/) {}
+  virtual void unstable_onHostTargetAdded() {}
   virtual void onPageRemoved(int /*pageId*/) {}
 };
 

package/ReactCommon/jsinspector-modern/TracingAgent.cpp

@@ -54,7 +54,7 @@ TracingAgent::~TracingAgent() {
 bool TracingAgent::handleRequest(const cdp::PreparsedRequest& req) {
   if (req.method == "Tracing.start") {
     auto& inspector = getInspectorInstance();
-    if (inspector.getSystemState().registeredPagesCount > 1) {
+    if (inspector.getSystemState().registeredHostsCount > 1) {
       frontendChannel_(
           cdp::jsonError(
               req.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-tvos",
-  "version": "0.83.0-0rc4",
+  "version": "0.83.1-1",
   "description": "A framework for building native apps using React",
   "license": "MIT",
   "repository": {
@@ -91,6 +91,7 @@
     "React-Core.podspec",
     "React-Core-prebuilt.podspec",
     "react-native.config.js",
+    "tvosCommands.js",
     "React.podspec",
     "React",
     "!React/Fabric/RCTThirdPartyFabricComponentsProvider.*",
@@ -164,12 +165,12 @@
   },
   "dependencies": {
     "@jest/create-cache-key-function": "^29.7.0",
-    "@react-native/assets-registry": "0.83.0-rc.4",
-    "@react-native/codegen": "0.83.0-rc.4",
-    "@react-native/community-cli-plugin": "0.83.0-rc.4",
-    "@react-native/gradle-plugin": "0.83.0-rc.4",
-    "@react-native/js-polyfills": "0.83.0-rc.4",
-    "@react-native/normalize-colors": "0.83.0-rc.4",
+    "@react-native/assets-registry": "0.83.1",
+    "@react-native/codegen": "0.83.1",
+    "@react-native/community-cli-plugin": "0.83.1",
+    "@react-native/gradle-plugin": "0.83.1",
+    "@react-native/js-polyfills": "0.83.1",
+    "@react-native/normalize-colors": "0.83.1",
     "abort-controller": "^3.0.0",
     "anser": "^1.4.9",
     "ansi-regex": "^5.0.0",
@@ -197,7 +198,7 @@
     "whatwg-fetch": "^3.0.0",
     "ws": "^7.5.10",
     "yargs": "^17.6.2",
-    "@react-native-tvos/virtualized-lists": "0.83.0-0rc4"
+    "@react-native-tvos/virtualized-lists": "0.83.1-1"
   },
   "codegenConfig": {
     "libraries": [

package/react-native.config.js

@@ -136,4 +136,21 @@ if (android != null) {
   };
 }
 
+try {
+  const apple = require('@react-native-community/cli-platform-apple');
+  const tvosCommands = require('./tvosCommands');
+
+  config.commands.push(...tvosCommands);
+  config.platforms.tvos = {
+    projectConfig: apple.getProjectConfig({platformName: 'tvos'}),
+    dependencyConfig: apple.getDependencyConfig({platformName: 'tvos'}),
+  };
+} catch {
+  if (verbose) {
+    console.warn(
+      '@react-native-community/cli-platform-apple not found, the react-native.config.js may be unusable.',
+    );
+  }
+}
+
 module.exports = config;

package/scripts/cocoapods/utils.rb

@@ -58,9 +58,11 @@ class ReactNativePodsUtils
 
     def self.set_gcc_preprocessor_definition_for_debugger(installer)
         self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED=1", "React-jsinspector", :debug)
+        self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED=1", "React-jsinspectornetwork", :debug)
         self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED=1", "React-RCTNetwork", :debug)
         self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED=1", "React-networking", :debug)
         self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED_DEVONLY=1", "React-jsinspector", :debug)
+        self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED_DEVONLY=1", "React-jsinspectornetwork", :debug)
         self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED_DEVONLY=1", "React-RCTNetwork", :debug)
         self.add_build_settings_to_pod(installer, "GCC_PREPROCESSOR_DEFINITIONS", "REACT_NATIVE_DEBUGGER_ENABLED_DEVONLY=1", "React-networking", :debug)
     end

package/tvosCommands.js

@@ -0,0 +1,51 @@
+/**
+ * @flow
+ */
+
+let apple;
+try {
+  apple = require('@react-native-community/cli-platform-apple');
+} catch {
+  if (verbose) {
+    console.warn(
+      '@react-native-community/cli-platform-apple not found, the react-native.config.js may be unusable.'
+    );
+  }
+}
+
+const platformName = 'tvos';
+
+const run = {
+  name: `run-${platformName}`,
+  description: 'builds your app and starts it on a tvOS simulator or Apple TV device',
+  func: apple.createRun({platformName}),
+  examples: [
+    {
+      desc: 'Run on a specific simulator',
+      cmd: `npx react-native run-${platformName} --simulator "Apple TV"`,
+    },
+  ],
+  options: apple.getRunOptions({platformName}),
+};
+
+const log = {
+  name: `log-${platformName}`,
+  description: 'displays system logs from a connected tvOS device or simulator',
+  func: apple.createLog({platformName: platformName}),
+  options: apple.getLogOptions({platformName}),
+};
+
+const build = {
+  name: `build-${platformName}`,
+  description: 'builds your app for tvOS',
+  func: apple.createBuild({platformName}),
+  examples: [
+      {
+      desc: 'Build the app for all tvOS devices in Release mode',
+      cmd: `npx react-native build-${platformName} --mode "Release"`,
+      },
+  ],
+  options: apple.getBuildOptions({platformName}),
+};
+
+module.exports = [run, log, build];

package/types/public/ReactNativeTVTypes.d.ts

@@ -52,6 +52,13 @@ declare module 'react-native' {
     disableGestureHandlersCancelTouches(): void;
   };
 
+  /**
+   * Hardware event received from TVEventHandler
+   * 
+   * Note: The 'blur' and 'focus' event types are deprecated and will no longer be 
+   * emitted on new architecture (Fabric). Use onFocus/onBlur component props instead.
+   * See: https://github.com/react-native-tvos/react-native-tvos/issues/1037
+   */
   export type HWEvent = {
     eventType: 'up' | 'down' | 'right' | 'left' | 'longUp' | 'longDown' | 'longRight' | 'longLeft' | 'blur' | 'focus' | 'pan' | string;
     eventKeyAction?: -1 | 1 | 0 | number | undefined;