react-native-tvos 0.87.1-0 → 0.88.0-0rc2

package/README-core.md

@@ -1,34 +1,25 @@
-<h1 align="center">
-  <a href="https://reactnative.dev/">
-    React Native
-  </a>
-</h1>
+<p align="center">
+   <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://reactnative.dev/react-native-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://reactnative.dev/react-native-light.svg">
+      <img alt="React Native logo" src="https://reactnative.dev/react-native-light.svg" height="80">
+    </picture>
+</p>
 
 <p align="center">
   <strong>Learn once, write anywhere:</strong><br>
-  Build mobile apps with React.
+  Create native apps for Android, iOS, and more using React
 </p>
 
 <p align="center">
-  <a href="https://github.com/facebook/react-native/blob/HEAD/LICENSE">
-    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="React Native is released under the MIT license." />
-  </a>
-  <a href="https://www.npmjs.org/package/react-native">
-    <img src="https://img.shields.io/npm/v/react-native?color=brightgreen&label=npm%20package" alt="Current npm package version." />
-  </a>
-  <a href="https://reactnative.dev/docs/contributing">
-    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs are welcome!" />
-  </a>
-  <a href="https://twitter.com/intent/follow?screen_name=reactnative">
-    <img src="https://img.shields.io/twitter/follow/reactnative.svg?label=Follow%20@reactnative" alt="Follow @reactnative on X" />
-  </a>
-  <a href="https://bsky.app/profile/reactnative.dev">
-    <img src="https://img.shields.io/badge/Bluesky-0285FF?logo=bluesky&logoColor=fff" alt="Follow @reactnative.dev on Bluesky" />
-  </a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="React Native is released under the MIT license" /></a>
+  <a href="https://www.npmjs.com/package/react-native"><img src="https://img.shields.io/npm/v/react-native.svg?color=blue" alt="Current npm package version" /></a>
+  <a href="https://www.npmjs.com/package/react-native"><img src="https://img.shields.io/npm/dm/react-native.svg" alt="Monthly npm downloads" /></a>
+  <a href="https://twitter.com/intent/follow?screen_name=reactnative"><img src="https://img.shields.io/badge/Follow_@reactnative-black?logo=x&logoColor=white" alt="Follow @reactnative on X" /></a>
 </p>
 
-<h3 align="center">
-  <a href="https://reactnative.dev/docs/getting-started">Getting Started</a>
+<h4 align="center">
+  <a href="https://reactnative.dev/docs/environment-setup">Getting Started</a>
   <span> · </span>
   <a href="https://reactnative.dev/docs/tutorial">Learn the Basics</a>
   <span> · </span>
@@ -38,107 +29,77 @@
   <span> · </span>
   <a href="https://reactnative.dev/help">Community</a>
   <span> · </span>
-  <a href="https://github.com/facebook/react-native/blob/HEAD/.github/SUPPORT.md">Support</a>
-</h3>
-
-React Native brings [**React**'s][r] declarative UI framework to iOS and Android. With React Native, you use native UI controls and have full access to the native platform.
-
-- **Declarative.** React makes it painless to create interactive UIs. Declarative views make your code more predictable and easier to debug.
-- **Component-Based.** Build encapsulated components that manage their state, then compose them to make complex UIs.
-- **Developer Velocity.** See local changes in seconds. Changes to JavaScript code can be live reloaded without rebuilding the native app.
-- **Portability.** Reuse code across iOS, Android, and [other platforms][p].
+  <a href="./.github/SUPPORT.md">Support</a>
+</h4>
 
-React Native is developed and supported by many companies and individual core contributors. Find out more in our [ecosystem overview][e].
+# React Native
 
-[r]: https://react.dev/
-[p]: https://reactnative.dev/docs/out-of-tree-platforms
-[e]: https://github.com/facebook/react-native/blob/HEAD/ECOSYSTEM.md
+React Native lets you build native apps using [React](https://react.dev/). Written
+in JavaScript, rendered with native code.
 
-## Contents
+- **Native UI.** React Native primitives render to native platform UI, meaning your app
+  uses the same native platform APIs other apps do. Gestures, text scaling, and
+  accessibility behave the way users expect on each OS.
+- **React, everywhere.** Declarative UI, components, hooks, and Suspense, reused
+  across Android, iOS, and [other platforms](https://reactnative.dev/docs/out-of-tree-platforms).
+- **Developer Velocity.** See local changes in seconds. Changes to JavaScript code are applied with Fast Refresh, without rebuilding the native app.
+- **Extend it yourself.** Native Modules let you call platform code directly from JavaScript, synchronously and type-safe — or reach for [thousands of existing libraries](https://reactnative.directory/).
 
-- [Requirements](#-requirements)
-- [Building your first React Native app](#-building-your-first-react-native-app)
-- [Documentation](#-documentation)
-- [Upgrading](#-upgrading)
-- [How to Contribute](#-how-to-contribute)
-- [Code of Conduct](#code-of-conduct)
-- [License](#-license)
+React Native is developed and supported by many companies and individual core contributors. Find out more on the [React Foundation website](https://react.foundation/).
 
+## Building your first React Native app
 
-## 📋 Requirements
+Follow the [Getting Started guide](https://reactnative.dev/docs/environment-setup) for a new app, or [Integration with Existing Apps](https://reactnative.dev/docs/integration-with-existing-apps) to adopt React Native incrementally.
 
-React Native apps may target iOS 15.1 and Android 7.0 (API 24) or newer. You may use Windows, macOS, or Linux as your development operating system, though building and running iOS apps is limited to macOS. Tools like [Expo](https://expo.dev) can be used to work around this.
+### Using a Framework
 
-## 🎉 Building your first React Native app
+We believe that the best way to experience React Native is through a Framework, a toolbox with all the necessary APIs to let you build production ready apps. [Expo](https://docs.expo.dev/get-started/set-up-your-environment/) is a production-grade React Native Framework, with file-based routing, a standard library of native modules, and much more.
 
-Follow the [Getting Started guide](https://reactnative.dev/docs/getting-started). The recommended way to install React Native depends on your project. Here you can find short guides for the most common scenarios:
+To create a new Expo project, run the following in your terminal:
 
-- [Trying out React Native][hello-world]
-- [Creating a New Application][new-app]
-- [Adding React Native to an Existing Application][existing]
+    npx create-expo-app@latest
 
-[hello-world]: https://snack.expo.dev/@samples/hello-world
-[new-app]: https://reactnative.dev/docs/getting-started
-[existing]: https://reactnative.dev/docs/integration-with-existing-apps
+Then follow the rest of [Expo's getting started guide](https://docs.expo.dev/get-started/set-up-your-environment/) to start building.
 
-## 📖 Documentation
+### Without a Framework
 
-The full documentation for React Native can be found on our [website][docs].
+You can also use React Native without a Framework, however we've found that most developers benefit from one — navigation, native dependencies, and platform tooling are problems the ecosystem has already solved. If a Framework doesn't suit your app, follow [Getting Started Without a Framework](https://reactnative.dev/docs/getting-started-without-a-framework).
 
-The React Native documentation discusses components, APIs, and topics that are specific to React Native. For further documentation on the React API that is shared between React Native and React DOM, refer to the [React documentation][r-docs].
+## Documentation
 
-The source for the React Native documentation and website is hosted on a separate repository, [**@facebook/react-native-website**][repo-website].
+The full documentation for React Native can be found on our [website](https://reactnative.dev/docs/getting-started).
 
-[docs]: https://reactnative.dev/docs/getting-started
-[r-docs]: https://react.dev/learn
-[repo-website]: https://github.com/facebook/react-native-website
+- [Introduction](https://reactnative.dev/docs/getting-started)
+- [Getting Started](https://reactnative.dev/docs/environment-setup)
+- [Learn the Basics](https://reactnative.dev/docs/tutorial)
+- [Components and APIs](https://reactnative.dev/docs/components-and-apis)
+- [UI & Interaction](https://reactnative.dev/docs/style)
+- [Native Modules](https://reactnative.dev/docs/native-platform)
+- [Debugging](https://reactnative.dev/docs/debugging)
+- [Upgrading](https://reactnative.dev/docs/upgrading)
+- [Architecture](https://reactnative.dev/architecture/overview)
 
-## 🚀 Upgrading
+The source for the React Native docs and website is hosted on a separate repository, [**react/react-native-website**](https://github.com/react/react-native-website).
 
-Upgrading to new versions of React Native may give you access to more APIs, views, developer tools, and other goodies. See the [Upgrading Guide][u] for instructions.
-
-React Native releases are discussed [in this discussion repo](https://github.com/reactwg/react-native-releases/discussions).
-
-[u]: https://reactnative.dev/docs/upgrading
-[repo-releases]: https://github.com/react-native-community/react-native-releases
-
-## 👏 How to Contribute
+## Contributing
 
 The main purpose of this repository is to continue evolving React Native core. We want to make contributing to this project as easy and transparent as possible, and we are grateful to the community for contributing bug fixes and improvements. Read below to learn how you can take part in improving React Native.
 
-### [Code of Conduct][code]
-
-Facebook has adopted a Code of Conduct that we expect project participants to adhere to.
-Please read the [full text][code] so that you can understand what actions will and will not be tolerated.
+### [Code of Conduct](https://code.fb.com/codeofconduct/)
 
-[code]: https://code.fb.com/codeofconduct/
+Meta has adopted a Code of Conduct that we expect project participants to adhere to.
+Please read the [full text](https://code.fb.com/codeofconduct/) so that you can understand what actions will and will not be tolerated.
 
-### [Contributing Guide][contribute]
+### [Contributing Guide](https://reactnative.dev/docs/contributing)
 
-Read our [**Contributing Guide**][contribute] to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to React Native.
-
-[contribute]: https://reactnative.dev/docs/contributing
-
-### [Open Source Roadmap][roadmap]
-
-You can learn more about our vision for React Native in the [**Roadmap**][roadmap].
-
-[roadmap]: https://github.com/facebook/react-native/wiki/Roadmap
-
-### Good First Issues
-
-We have a list of [good first issues][gfi] that contain bugs which have a relatively limited scope. This is a great place to get started, gain experience, and get familiar with our contribution process.
-
-[gfi]: https://github.com/facebook/react-native/labels/good%20first%20issue
+Read our [**Contributing Guide**](https://reactnative.dev/docs/contributing) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to React Native.
 
 ### Discussions
 
-Larger discussions and proposals are discussed in [**@react-native-community/discussions-and-proposals**][repo-meta].
-
-[repo-meta]: https://github.com/react-native-community/discussions-and-proposals
+Larger discussions and proposals are discussed in [**react-native-community/discussions-and-proposals**](https://github.com/react-native-community/discussions-and-proposals).
 
-## 📄 License
+React Native releases are discussed in [**reactwg/react-native-releases**](https://github.com/reactwg/react-native-releases/discussions).
 
-React Native is MIT licensed, as found in the [LICENSE][l] file.
+## License
 
-[l]: https://github.com/facebook/react-native/blob/main/LICENSE
+React Native is MIT licensed, as found in the [LICENSE](./LICENSE) file.

package/React/Base/RCTBridge+Private.h

@@ -11,8 +11,10 @@
 @class RCTModuleData;
 @protocol RCTJavaScriptExecutor;
 
+#if !defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) || !defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
 RCT_EXTERN NSArray<Class> *RCTGetModuleClasses(void);
 RCT_EXTERN void RCTRegisterModule(Class);
+#endif // !defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) || !defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
 
 @interface RCTBridge ()
 

package/React/Base/RCTBridge.mm

@@ -31,6 +31,7 @@
 #import "RCTReloadCommand.h"
 #import "RCTUtils.h"
 
+#if !defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) || !defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
 static NSMutableArray<Class> *RCTModuleClasses;
 static dispatch_queue_t RCTModuleClassesSyncQueue;
 NSArray<Class> *RCTGetModuleClasses(void)
@@ -53,7 +54,6 @@ NSSet<NSString *> *getCoreModuleClasses(void)
       @"RCTActivityIndicatorViewManager",
       @"RCTDebuggingOverlayManager",
       @"RCTModalHostViewManager",
-      @"RCTModalManager",
       @"RCTRefreshControlManager",
       @"RCTSafeAreaViewManager",
       @"RCTScrollContentViewManager",
@@ -115,6 +115,7 @@ NSSet<NSString *> *getCoreModuleClasses(void)
 
   return coreModuleClasses;
 }
+#endif // !defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) || !defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
 
 static NSMutableArray<NSString *> *modulesLoadedWithOldArch;
 void addModuleLoadedWithOldArch(NSString * /*moduleName*/);
@@ -133,6 +134,7 @@ NSMutableArray<NSString *> *getModulesLoadedWithOldArch(void)
   return modulesLoadedWithOldArch;
 }
 
+#if !defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) || !defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
 /**
  * Register the given class as a bridge module. All modules must be registered
  * prior to the first bridge initialization.
@@ -161,6 +163,7 @@ void RCTRegisterModule(Class moduleClass)
     [RCTModuleClasses addObject:moduleClass];
   });
 }
+#endif // !defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) || !defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
 
 /**
  * This function returns the module name for a given class.

package/React/Base/RCTBridgeModule.h

@@ -69,6 +69,18 @@ RCT_EXTERN_C_END
  * will be used as the JS module name. If omitted, the JS module name will
  * match the Objective-C class name.
  */
+#if defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) && defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
+
+// With both legacy interop layers removed, RCTRegisterModule is compiled out, so
+// static module registration is a no-op: only the JS module name is emitted.
+#define RCT_EXPORT_MODULE(js_name) \
+  +(NSString *)moduleName          \
+  {                                \
+    return @ #js_name;             \
+  }
+
+#else
+
 #ifndef RCT_DISABLE_STATIC_MODULE_REGISTRATION
 #define RCT_EXPORT_MODULE(js_name)          \
   RCT_EXTERN void RCTRegisterModule(Class); \
@@ -108,6 +120,8 @@ RCT_EXTERN_C_END
     RCTRegisterModule([objc_name class]);                                           \
   }
 
+#endif // defined(RCT_REMOVE_LEGACY_MODULE_INTEROP) && defined(RCT_REMOVE_LEGACY_COMPONENT_INTEROP)
+
 // Implemented by RCT_EXPORT_MODULE
 + (NSString *)moduleName;
 

package/React/Base/RCTBundleManager.h

@@ -72,5 +72,13 @@ typedef NSMutableArray<NSURLQueryItem *> *_Nullable (^RCTPackagerOptionsUpdater)
                     andDefaultGetter:(nullable RCTBridgelessBundleURLGetter)defaultGetter;
 - (void)resetBundleURL;
 @property (nonatomic, nullable) NSURL *bundleURL;
+
+/**
+ * File URL of the most recently downloaded bundle persisted to disk. Only set
+ * when the bundle was fetched from a remote URL (e.g. the packager); nil when
+ * the bundle was loaded from a local file, in which case its location on disk
+ * is the bundleURL itself.
+ */
+@property (nonatomic, nullable) NSURL *downloadedBundleFileURL;
 @property (nonatomic, nonnull) RCTBundleConfiguration *bundleConfig;
 @end

package/React/Base/RCTBundleURLProvider.h

@@ -14,15 +14,15 @@
 RCT_EXTERN NSString *_Nonnull const RCTBundleURLProviderUpdatedNotification;
 RCT_EXTERN const NSUInteger kRCTBundleURLProviderDefaultPort;
 
-#if RCT_DEV_MENU | RCT_PACKAGER_LOADING_FUNCTIONALITY
 /**
  * Allow/disallow accessing the packager server for various runtime scenario.
  * For instance, if a test run should never access the packager, disable it
  * by calling this function before initializing React Native (RCTBridge etc).
- * By default the access is enabled.
+ * By default the access is enabled. When packager support is compiled out
+ * (neither RCT_DEV_MENU nor RCT_PACKAGER_LOADING_FUNCTIONALITY is set),
+ * calling this function is a no-op.
  */
 RCT_EXTERN void RCTBundleURLProviderAllowPackagerServerAccess(BOOL allowed);
-#endif
 
 NS_ASSUME_NONNULL_BEGIN
 

package/React/Base/RCTBundleURLProvider.mm

@@ -19,13 +19,14 @@ NSString *const RCTBundleURLProviderUpdatedNotification = @"RCTBundleURLProvider
 
 const NSUInteger kRCTBundleURLProviderDefaultPort = RCT_METRO_PORT;
 
-#if RCT_DEV_MENU | RCT_PACKAGER_LOADING_FUNCTIONALITY
+// Declared unconditionally so out-of-tree callers link in every configuration,
+// same shape as RCTDevLoadingViewSetEnabled. Reads stay gated below, so this is
+// a no-op when packager support is compiled out.
 static BOOL kRCTAllowPackagerAccess = YES;
 void RCTBundleURLProviderAllowPackagerServerAccess(BOOL allowed)
 {
   kRCTAllowPackagerAccess = allowed;
 }
-#endif
 static NSString *const kRCTPackagerSchemeKey = @"RCT_packager_scheme";
 static NSString *const kRCTJsLocationKey = @"RCT_jsLocation";
 static NSString *const kRCTEnableDevKey = @"RCT_enableDev";

package/React/Base/RCTJavaScriptLoader.h

@@ -68,6 +68,14 @@ NS_ENUM(NSInteger){
  */
 @property (nonatomic, readonly) NSInteger filesChangedCount;
 
+/**
+ * File URL of the downloaded bundle persisted to disk, from which self.data is
+ * memory-mapped. Only set when the bundle was fetched from a remote URL (e.g. the
+ * packager); nil when the bundle was loaded from a local file, in which case the
+ * bundle's location on disk is self.url.
+ */
+@property (strong, nonatomic, readonly) NSURL *downloadedBundleFileURL;
+
 @end
 
 typedef void (^RCTSourceLoadProgressBlock)(RCTLoadingProgress *progressData);

package/React/Base/RCTJavaScriptLoader.mm

@@ -25,6 +25,7 @@ NSString *const RCTJavaScriptLoaderErrorDomain = @"RCTJavaScriptLoaderErrorDomai
   NSData *_data;
   NSUInteger _length;
   NSInteger _filesChangedCount;
+  NSURL *_downloadedBundleFileURL;
 }
 
 @end
@@ -210,6 +211,15 @@ static void parseHeaders(NSDictionary *headers, RCTSource *source)
   source->_filesChangedCount = [headers[@"X-Metro-Files-Changed-Count"] integerValue];
 }
 
+static NSURL *persistDownloadedBundle(NSData *data, NSError **error)
+{
+  NSString *bundlePath = [NSTemporaryDirectory() stringByAppendingPathComponent:@"ReactNativeDevBundle.js"];
+  if (![data writeToFile:bundlePath options:NSDataWritingAtomic error:error]) {
+    return nil;
+  }
+  return [NSURL fileURLWithPath:bundlePath];
+}
+
 static void attemptAsynchronousLoadOfBundleAtURL(
     NSURL *scriptURL,
     RCTSourceLoadProgressBlock onProgress,
@@ -247,7 +257,7 @@ static void attemptAsynchronousLoadOfBundleAtURL(
                              [@"Could not connect to development server.\n\n"
                                "Ensure the following:\n"
                                "- Node server is running and available on the same network - run 'npm start' from react-native root\n"
-                               "- Node server URL is correctly set in AppDelegate\n"
+                               "- Node server URL is correctly set in your AppDelegate or SceneDelegate factory delegate\n"
                                "- WiFi is enabled and connected to the same network as the Node Server\n\n"
                                "URL: " stringByAppendingString:scriptURL.absoluteString],
                          NSLocalizedFailureReasonErrorKey : error.localizedDescription,
@@ -314,7 +324,24 @@ static void attemptAsynchronousLoadOfBundleAtURL(
           }
         }
 
-        RCTSource *source = RCTSourceCreate(sourceURL, data, data.length);
+        NSError *persistError;
+        NSURL *downloadedBundleFileURL = persistDownloadedBundle(data, &persistError);
+        if (downloadedBundleFileURL == nil) {
+          onComplete(persistError, nil);
+          return;
+        }
+
+        NSError *mappingError;
+        NSData *bundleData = [NSData dataWithContentsOfURL:downloadedBundleFileURL
+                                                   options:NSDataReadingMappedIfSafe
+                                                     error:&mappingError];
+        if (bundleData == nil) {
+          onComplete(mappingError, nil);
+          return;
+        }
+
+        RCTSource *source = RCTSourceCreate(sourceURL, bundleData, static_cast<int64_t>(bundleData.length));
+        source->_downloadedBundleFileURL = downloadedBundleFileURL;
         parseHeaders(headers, source);
         onComplete(nil, source);
       }

package/React/Base/RCTUtils.h

@@ -93,6 +93,9 @@ RCT_EXTERN UIApplication *__nullable RCTSharedApplication(void);
 // or view controller
 RCT_EXTERN UIWindow *__nullable RCTKeyWindow(void);
 
+// Is this app a SceneDelegate app?
+RCT_EXTERN BOOL RCTIsSceneDelegateApp(void);
+
 // Returns the presented view controller, useful if you need
 // e.g. to present a modal view controller or alert over it
 RCT_EXTERN UIViewController *__nullable RCTPresentedViewController(void);
@@ -139,6 +142,11 @@ RCT_EXTERN NSData *__nullable RCTDecompressGzipData(NSData *__nullable data, NSU
 // (or nil, if the URL does not specify a path within the main bundle)
 RCT_EXTERN NSString *__nullable RCTBundlePathForURL(NSURL *__nullable URL);
 
+// Returns the asset catalog image name for a packager asset URL, or nil if the
+// URL is not a main-bundle packager asset. The name matches the identifier the
+// CLI uses when generating the catalog (see assetPathUtils.getResourceIdentifier).
+RCT_EXTERN NSString *__nullable RCTAssetCatalogNameForURL(NSURL *__nullable URL);
+
 // Returns the Path of Library directory
 RCT_EXTERN NSString *__nullable RCTLibraryPath(void);