xplat/js/react-native-github/packages/gradle-plugin/react-native-gradle-plugin/src/test/kotlin/com/facebook/react/tests/TaskTestUtils.kt

Reviewed By: rshest

Differential Revision: D80931289

.editorconfig

@@ -9,12 +9,3 @@ end_of_line = lf
 insert_final_newline = true
 indent_style = space
 indent_size = 2
-
-[*.gradle]
-indent_size = 4
-
-[*.kts]
-indent_size = 4
-
-[BUCK]
-indent_size = 4

.flowconfig

@@ -47,6 +47,7 @@ packages/react-native/flow/
 
 [options]
 enums=true
+experimental.pattern_matching=true
 casting_syntax=both
 component_syntax=true
 
@@ -74,11 +75,7 @@ module.system.haste.module_ref_prefix=m#
 
 react.runtime=automatic
 
-suppress_type=$FlowIssue
-suppress_type=$FlowFixMe
-suppress_type=$FlowFixMeProps
-suppress_type=$FlowFixMeState
-suppress_type=$FlowFixMeEmpty
+experimental.error_code_migration=new
 
 ban_spread_key_props=true
 
@@ -103,4 +100,4 @@ untyped-import
 untyped-type-import
 
 [version]
-^0.273.1
+^0.279.0

.github/ISSUE_TEMPLATE/debugger_bug_report.yml

@@ -1,6 +1,6 @@
 name: 🔍 Debugger - Bug Report
 description: Report a bug with React Native DevTools and the New Debugger
-labels: ["Needs: Triage :mag:", "Debugger"]
+labels: ["Needs: Triage :mag:", "Debugging"]
 
 body:
   - type: markdown

.github/actions/build-android/action.yml

@@ -4,9 +4,6 @@ inputs:
   release-type:
     required: true
     description: The type of release we are building. It could be nightly, release or dry-run
-  run-e2e-tests:
-    default: 'false'
-    description: If we need to build to run E2E tests. If yes, we need to build also x86.
   gradle-cache-encryption-key:
     description: "The encryption key needed to store the Gradle Configuration cache"
 runs:
@@ -31,10 +28,11 @@ runs:
       uses: actions/cache/restore@v4
       with:
         path: /github/home/.cache/ccache
-        key: v1-ccache-android-${{ github.job }}-${{ github.ref }}
+        key: v2-ccache-android-${{ github.job }}-${{ github.ref }}-${{ hashFiles('packages/react-native/ReactAndroid/**/*.cpp', 'packages/react-native/ReactAndroid/**/*.h', 'packages/react-native/ReactCommon/**/*.cpp', 'packages/react-native/ReactAndroid/**/CMakeLists.txt', 'packages/react-native/ReactCommon/**/CMakeLists.txt') }}
         restore-keys: |
-          v1-ccache-android-${{ github.job }}-
-          v1-ccache-android-
+          v2-ccache-android-${{ github.job }}-${{ github.ref }}-
+          v2-ccache-android-${{ github.job }}-
+          v2-ccache-android-
     - name: Show ccache stats
       shell: bash
       run: ccache -s -v
@@ -43,11 +41,7 @@ runs:
       run: |
         if [[ "${{ inputs.release-type }}" == "dry-run" ]]; then
           # dry-run: we only build ARM64 to save time/resources. For release/nightlies the default is to build all archs.
-          if [[ "${{ inputs.run-e2e-tests }}" == 'true' ]]; then
-            export ORG_GRADLE_PROJECT_reactNativeArchitectures="arm64-v8a,x86" # x86 is required for E2E testing
-          else
-            export ORG_GRADLE_PROJECT_reactNativeArchitectures="arm64-v8a"
-          fi
+          export ORG_GRADLE_PROJECT_reactNativeArchitectures="arm64-v8a,x86" # x86 is required for E2E testing
           TASKS="publishAllToMavenTempLocal build"
         elif [[ "${{ inputs.release-type }}" == "nightly" ]]; then
           # nightly: we set isSnapshot to true so artifacts are sent to the right repository on Maven Central.
@@ -63,7 +57,7 @@ runs:
       uses: actions/cache/save@v4
       with:
         path: /github/home/.cache/ccache
-        key: v1-ccache-android-${{ github.job }}-${{ github.ref }}
+        key: v2-ccache-android-${{ github.job }}-${{ github.ref }}-${{ hashFiles('packages/react-native/ReactAndroid/**/*.cpp', 'packages/react-native/ReactAndroid/**/*.h', 'packages/react-native/ReactCommon/**/*.cpp', 'packages/react-native/ReactAndroid/**/CMakeLists.txt', 'packages/react-native/ReactCommon/**/CMakeLists.txt') }}
     - name: Show ccache stats
       shell: bash
       run: ccache -s -v

.github/actions/build-apple-slices-hermes/action.yml

@@ -71,17 +71,17 @@ runs:
         mv build_"$SLICE" "$FINAL_PATH"
 
         # check whether everything is there
-        if [[ -d "$FINAL_PATH/API/hermes/hermes.framework" ]]; then
-          echo "Successfully built hermes.framework for $SLICE in $FLAVOR"
+        if [[ -d "$FINAL_PATH/lib/hermesvm.framework" ]]; then
+          echo "Successfully built hermesvm.framework for $SLICE in $FLAVOR"
         else
-          echo "Failed to built hermes.framework for $SLICE in $FLAVOR"
+          echo "Failed to built hermesvm.framework for $SLICE in $FLAVOR"
           exit 1
         fi
 
-        if [[ -d "$FINAL_PATH/API/hermes/hermes.framework.dSYM" ]]; then
-          echo "Successfully built hermes.framework.dSYM for $SLICE in $FLAVOR"
+        if [[ -d "$FINAL_PATH/lib/hermesvm.framework.dSYM" ]]; then
+          echo "Successfully built hermesvm.framework.dSYM for $SLICE in $FLAVOR"
         else
-          echo "Failed to built hermes.framework.dSYM for $SLICE in $FLAVOR"
+          echo "Failed to built hermesvm.framework.dSYM for $SLICE in $FLAVOR"
           echo "Please try again"
           exit 1
         fi

.github/actions/build-hermes-macos/action.yml

@@ -15,8 +15,6 @@ runs:
   steps:
     - name: Setup xcode
       uses: ./.github/actions/setup-xcode
-    - name: Setup node.js
-      uses: ./.github/actions/setup-node
     - name: Restore Hermes workspace
       uses: ./.github/actions/restore-hermes-workspace
     - name: Restore Cached Artifacts
@@ -45,6 +43,8 @@ runs:
           echo "ARTIFACTS_EXIST=true" >> $GITHUB_ENV
           echo "ARTIFACTS_EXIST=true" >> $GITHUB_OUTPUT
         fi
+    - name: Setup node.js
+      uses: ./.github/actions/setup-node
     - name: Yarn- Install Dependencies
       if: ${{ steps.check_if_apple_artifacts_are_there.outputs.ARTIFACTS_EXIST != 'true' }}
       uses: ./.github/actions/yarn-install
@@ -186,7 +186,7 @@ runs:
 
         cd ./packages/react-native/sdks/hermes || exit 1
 
-        DSYM_FILE_PATH=API/hermes/hermes.framework.dSYM
+        DSYM_FILE_PATH=lib/hermesvm.framework.dSYM
         cp -r build_macosx/$DSYM_FILE_PATH "$WORKING_DIR/macosx/"
         cp -r build_catalyst/$DSYM_FILE_PATH "$WORKING_DIR/catalyst/"
         cp -r build_iphoneos/$DSYM_FILE_PATH "$WORKING_DIR/iphoneos/"
@@ -197,10 +197,10 @@ runs:
         cp -r build_xrsimulator/$DSYM_FILE_PATH "$WORKING_DIR/xrsimulator/"
 
         DEST_DIR="/tmp/hermes/dSYM/$FLAVOR"
-        tar -C "$WORKING_DIR" -czvf "hermes.framework.dSYM" .
+        tar -C "$WORKING_DIR" -czvf "hermesvm.framework.dSYM" .
 
         mkdir -p "$DEST_DIR"
-        mv "hermes.framework.dSYM" "$DEST_DIR"
+        mv "hermesvm.framework.dSYM" "$DEST_DIR"
     - name: Upload hermes dSYM artifacts
       uses: actions/upload-artifact@v4.3.4
       with:

.github/actions/build-hermesc-windows/action.yml

@@ -14,23 +14,23 @@ runs:
       uses: actions/download-artifact@v4
       with:
         name: hermes-workspace
-        path: 'D:\tmp\hermes'
+        path: 'C:\tmp\hermes'
     - name: Set up workspace
       shell: powershell
       run: |
-        mkdir -p D:\tmp\hermes\osx-bin
+        mkdir -p C:\tmp\hermes\osx-bin
         mkdir -p .\packages\react-native\sdks\hermes
-        cp -r -Force D:\tmp\hermes\hermes\* .\packages\react-native\sdks\hermes\.
+        cp -r -Force C:\tmp\hermes\hermes\* .\packages\react-native\sdks\hermes\.
         cp -r -Force .\packages\react-native\sdks\hermes-engine\utils\* .\packages\react-native\sdks\hermes\.
     - name: Windows cache
       uses: actions/cache@v4
       with:
         key: v3-hermes-${{ github.job }}-windows-${{ inputs.hermes-version }}-${{ inputs.react-native-version }}
         path: |
-          D:\tmp\hermes\win64-bin\
-          D:\tmp\hermes\hermes\icu\
-          D:\tmp\hermes\hermes\deps\
-          D:\tmp\hermes\hermes\build_release\
+          C:\tmp\hermes\win64-bin\
+          C:\tmp\hermes\hermes\icu\
+          C:\tmp\hermes\hermes\deps\
+          C:\tmp\hermes\hermes\build_release\
     - name: setup-msbuild
       uses: microsoft/setup-msbuild@v1.3.2
     - name: Set up workspace
@@ -83,4 +83,4 @@ runs:
       uses: actions/upload-artifact@v4.3.4
       with:
         name: hermes-win64-bin
-        path: D:\tmp\hermes\win64-bin\
+        path: C:\tmp\hermes\win64-bin\

.github/actions/build-npm-package/action.yml

@@ -99,8 +99,8 @@ runs:
         mkdir -p ./packages/react-native/ReactAndroid/external-artifacts/artifacts/
         cp ${{ inputs.hermes-ws-dir }}/hermes-runtime-darwin/hermes-ios-Debug.tar.gz ./packages/react-native/ReactAndroid/external-artifacts/artifacts/hermes-ios-debug.tar.gz
         cp ${{ inputs.hermes-ws-dir }}/hermes-runtime-darwin/hermes-ios-Release.tar.gz ./packages/react-native/ReactAndroid/external-artifacts/artifacts/hermes-ios-release.tar.gz
-        cp ${{ inputs.hermes-ws-dir }}/dSYM/Debug/hermes.framework.dSYM  ./packages/react-native/ReactAndroid/external-artifacts/artifacts/hermes-framework-dSYM-debug.tar.gz
-        cp ${{ inputs.hermes-ws-dir }}/dSYM/Release/hermes.framework.dSYM  ./packages/react-native/ReactAndroid/external-artifacts/artifacts/hermes-framework-dSYM-release.tar.gz
+        cp ${{ inputs.hermes-ws-dir }}/dSYM/Debug/hermesvm.framework.dSYM  ./packages/react-native/ReactAndroid/external-artifacts/artifacts/hermes-framework-dSYM-debug.tar.gz
+        cp ${{ inputs.hermes-ws-dir }}/dSYM/Release/hermesvm.framework.dSYM  ./packages/react-native/ReactAndroid/external-artifacts/artifacts/hermes-framework-dSYM-release.tar.gz
     - name: Download ReactNativeDependencies
       uses: actions/download-artifact@v4
       with:
@@ -116,12 +116,12 @@ runs:
     - name: Print Artifacts Directory
       shell: bash
       run: ls -lR ./packages/react-native/ReactAndroid/external-artifacts/artifacts/
-    - name: Setup node.js
-      uses: ./.github/actions/setup-node
     - name: Setup gradle
       uses: ./.github/actions/setup-gradle
       with:
         cache-encryption-key: ${{ inputs.gradle-cache-encryption-key }}
+    - name: Setup node.js
+      uses: ./.github/actions/setup-node
     - name: Install dependencies
       uses: ./.github/actions/yarn-install
     - name: Build packages
@@ -129,7 +129,7 @@ runs:
       run: yarn build
     - name: Build types
       shell: bash
-      run: yarn build-types
+      run: yarn build-types --skip-snapshot
     # Continue with publish steps
     - name: Set npm credentials
       if: ${{ inputs.release-type == 'release' ||

.github/actions/create-release/action.yml

@@ -14,6 +14,8 @@ inputs:
 runs:
   using: composite
   steps:
+    - name: Setup node.js
+      uses: ./.github/actions/setup-node
     - name: Yarn install
       uses: ./.github/actions/yarn-install
     - name: Configure Git

.github/actions/diff-js-api-breaking-changes/action.yml

@@ -0,0 +1,23 @@
+name: diff-js-api-breaking-changes
+description: Check for breaking changes in the public React Native JS API
+runs:
+  using: composite
+  steps:
+    - name: Fetch snapshot from PR head
+      shell: bash
+      env:
+        SCRATCH_DIR: ${{ runner.temp }}/diff-js-api-breaking-changes
+      run: |
+        mkdir $SCRATCH_DIR
+        git fetch --depth=1 origin ${{ github.event.pull_request.head.sha }}
+        git show ${{ github.event.pull_request.head.sha }}:packages/react-native/ReactNativeApi.d.ts > $SCRATCH_DIR/ReactNativeApi-after.d.ts \
+          || echo "" > $SCRATCH_DIR/ReactNativeApi.d.ts
+    - name: Run breaking change detection
+      shell: bash
+      env:
+        SCRATCH_DIR: ${{ runner.temp }}/diff-js-api-breaking-changes
+      run: |
+        node ./scripts/js-api/diff-api-snapshot \
+        ${{ github.workspace }}/packages/react-native/ReactNativeApi.d.ts  \
+        $SCRATCH_DIR/ReactNativeApi-after.d.ts \
+        > $SCRATCH_DIR/output.json

.github/actions/lint/action.yml

@@ -49,7 +49,7 @@ runs:
       run: yarn run lint-markdown
     - name: Build types
       shell: bash
-      run: yarn build-types
+      run: yarn build-types --skip-snapshot
     - name: Run typescript check of generated types
       shell: bash
       run: yarn test-generated-typescript

.github/actions/maestro-ios/action.yml

@@ -35,6 +35,8 @@ runs:
       with:
         java-version: '17'
         distribution: 'zulu'
+    - name: Setup node.js
+      uses: ./.github/actions/setup-node
     - name: Run yarn install
       uses: ./.github/actions/yarn-install
     - name: Start Metro in Debug

.github/actions/prepare-hermes-workspace/action.yml

@@ -17,9 +17,6 @@ outputs:
 runs:
   using: composite
   steps:
-    - name: Setup node.js
-      uses: ./.github/actions/setup-node
-
     - name: Setup hermes version
       shell: bash
       id: hermes-version
@@ -67,6 +64,8 @@ runs:
           echo "HERMES_CACHED=true" >> "$GITHUB_OUTPUT"
         fi
 
+    - name: Setup node.js
+      uses: ./.github/actions/setup-node
     - name: Yarn- Install Dependencies
       if: ${{ steps.meaningful-cache.outputs.HERMES_CACHED != 'true' }}
       uses: ./.github/actions/yarn-install

.github/actions/run-fantom-tests/action.yml

@@ -0,0 +1,83 @@
+name: Run Fantom Tests
+inputs:
+  release-type:
+    required: true
+    description: The type of release we are building. It could be nightly, release or dry-run
+  gradle-cache-encryption-key:
+    description: "The encryption key needed to store the Gradle Configuration cache"
+
+runs:
+  using: composite
+  steps:
+    - name: Install dependencies
+      shell: bash
+      run: |
+        sudo apt update
+        sudo apt install -y git cmake openssl libssl-dev clang
+    - name: Setup git safe folders
+      shell: bash
+      run: git config --global --add safe.directory '*'
+    - name: Setup node.js
+      uses: ./.github/actions/setup-node
+    - name: Install node dependencies
+      uses: ./.github/actions/yarn-install
+    - name: Setup gradle
+      uses: ./.github/actions/setup-gradle
+      with:
+        cache-read-only: "false"
+        cache-encryption-key: ${{ inputs.gradle-cache-encryption-key }}
+    - name: Restore Fantom ccache
+      uses: actions/cache/restore@v4
+      with:
+        path: /github/home/.cache/ccache
+        key: v2-ccache-fantom-${{ github.job }}-${{ github.ref }}-${{ hashFiles(
+            'packages/react-native/ReactAndroid/**/*.cpp',
+            'packages/react-native/ReactAndroid/**/*.h',
+            'packages/react-native/ReactAndroid/**/CMakeLists.txt',
+            'packages/react-native/ReactCommon/**/*.cpp',
+            'packages/react-native/ReactCommon/**/*.h',
+            'packages/react-native/ReactCommon/**/CMakeLists.txt',
+            'private/react-native-fantom/tester/**/*.cpp',
+            'private/react-native-fantom/tester/**/*.h',
+            'private/react-native-fantom/tester/**/CMakeLists.txt'
+          ) }}
+        restore-keys: |
+          v2-ccache-fantom-${{ github.job }}-${{ github.ref }}-
+          v2-ccache-fantom-${{ github.job }}-
+          v2-ccache-fantom-
+    - name: Show ccache stats
+      shell: bash
+      run: ccache -s -v
+    - name: Run Fantom Tests
+      shell: bash
+      run: yarn fantom
+      env:
+        CC: clang
+        CXX: clang++
+    - name: Save Fantom ccache
+      if: ${{ github.ref == 'refs/heads/main' || contains(github.ref, '-stable') }}
+      uses: actions/cache/save@v4
+      with:
+        path: /github/home/.cache/ccache
+        key: v2-ccache-fantom-${{ github.job }}-${{ github.ref }}-${{ hashFiles(
+            'packages/react-native/ReactAndroid/**/*.cpp',
+            'packages/react-native/ReactAndroid/**/*.h',
+            'packages/react-native/ReactAndroid/**/CMakeLists.txt',
+            'packages/react-native/ReactCommon/**/*.cpp',
+            'packages/react-native/ReactCommon/**/*.h',
+            'packages/react-native/ReactCommon/**/CMakeLists.txt',
+            'private/react-native-fantom/tester/**/*.cpp',
+            'private/react-native-fantom/tester/**/*.h',
+            'private/react-native-fantom/tester/**/CMakeLists.txt'
+          ) }}
+    - name: Show ccache stats
+      shell: bash
+      run: ccache -s -v
+    - name: Upload test results
+      if: ${{ always() }}
+      uses: actions/upload-artifact@v4.3.4
+      with:
+        name: run-fantom-tests-results
+        compression-level: 1
+        path: |
+          private/react-native-fantom/build/reports

.github/actions/setup-node/action.yml

@@ -4,7 +4,7 @@ inputs:
   node-version:
     description: 'The node.js version to use'
     required: false
-    default: '22'
+    default: '22.14.0'
 runs:
   using: "composite"
   steps:

.github/actions/setup-xcode-build-cache/action.yml

@@ -1,32 +0,0 @@
-name: setup-xcode-build-cache
-description: Add caching to iOS jobs to speed up builds
-inputs:
-  hermes-version:
-    description: The version of hermes
-    required: true
-  flavor:
-    description: The flavor that is going to be built
-    default: Debug
-  use-frameworks:
-    description: Whether we are bulding with DynamicFrameworks or StaticLibraries
-    default: StaticLibraries
-  ruby-version:
-    description: The ruby version we are going to use
-    default: 2.6.10
-
-runs:
-  using: composite
-  steps:
-    - name: See commands.yml with_xcodebuild_cache
-      shell: bash
-      run: echo "See commands.yml with_xcodebuild_cache"
-    - name: Cache podfile lock
-      uses: actions/cache@v4
-      with:
-        path: packages/rn-tester/Podfile.lock
-        key: v13-podfilelock-${{ github.job }}-NewArch-${{ inputs.flavor }}-${{ inputs.use-frameworks }}-${{ inputs.ruby-version }}-${{ hashfiles('packages/rn-tester/Podfile') }}-${{ inputs.hermes-version }}
-    - name: Cache cocoapods
-      uses: actions/cache@v4
-      with:
-        path: packages/rn-tester/Pods
-        key: v15-cocoapods-${{ github.job }}-NewArch-${{ inputs.flavor }}-${{ inputs.use-frameworks }}-${{ inputs.ruby-version }}-${{ hashfiles('packages/rn-tester/Podfile.lock') }}-${{ hashfiles('packages/rn-tester/Podfile') }}-${{ inputs.hermes-version}}

.github/actions/test-ios-helloworld/action.yml

@@ -23,6 +23,8 @@ runs:
       uses: ./.github/actions/setup-xcode
     - name: Setup node.js
       uses: ./.github/actions/setup-node
+    - name: Run yarn install
+      uses: ./.github/actions/yarn-install
     - name: Create Hermes folder
       shell: bash
       run: mkdir -p "$HERMES_WS_DIR"
@@ -34,8 +36,6 @@ runs:
     - name: Print Downloaded hermes
       shell: bash
       run: ls -lR "$HERMES_WS_DIR"
-    - name: Run yarn
-      uses: ./.github/actions/yarn-install
     - name: Setup ruby
       uses: ruby/setup-ruby@v1
       with:
@@ -48,6 +48,14 @@ runs:
     - name: Print third-party folder
       shell: bash
       run: ls -lR /tmp/third-party
+    - name: Download React Native Prebuilds
+      uses: actions/download-artifact@v4
+      with:
+        name: ReactCore${{ inputs.flavor }}.xcframework.tar.gz
+        path: /tmp/ReactCore
+    - name: Print ReactCore folder
+      shell: bash
+      run: ls -lR /tmp/ReactCore
     - name: Install iOS dependencies - Configuration ${{ inputs.flavor }};
       shell: bash
       run: |
@@ -73,6 +81,7 @@ runs:
         TARBALL_FILENAME=$(node ../../packages/react-native/scripts/hermes/get-tarball-name.js --buildType "$BUILD_TYPE")
         export HERMES_ENGINE_TARBALL_PATH="$HERMES_WS_DIR/hermes-runtime-darwin/$TARBALL_FILENAME"
         export RCT_USE_LOCAL_RN_DEP="/tmp/third-party/ReactNativeDependencies${{ inputs.flavor }}.xcframework.tar.gz"
+        export RCT_TESTONLY_RNCORE_TARBALL_PATH="/tmp/ReactCore/ReactCore${{ inputs.flavor }}.xcframework.tar.gz"
 
         yarn bootstrap ios "${args[@]}" | cat
 

.github/actions/test-ios-rntester/action.yml

@@ -94,23 +94,25 @@ runs:
     - name: Print third-party folder
       shell: bash
       run: ls -lR /tmp/third-party
-    - name: Setup xcode build cache
-      uses: ./.github/actions/setup-xcode-build-cache
+    - name: Download React Native Prebuilds
+      uses: actions/download-artifact@v4
       with:
-        hermes-version: ${{ inputs.hermes-version }}
-        use-frameworks: ${{ inputs.use-frameworks }}
-        flavor: ${{ inputs.flavor }}
-        ruby-version: ${{ inputs.ruby-version }}
+        name: ReactCore${{ inputs.flavor }}.xcframework.tar.gz
+        path: /tmp/ReactCore
+    - name: Print ReactCore folder
+      shell: bash
+      run: ls -lR /tmp/ReactCore
     - name: Install CocoaPods dependencies
       shell: bash
       run: |
         export HERMES_ENGINE_TARBALL_PATH=$HERMES_ENGINE_TARBALL_PATH
+        export RCT_USE_LOCAL_RN_DEP="/tmp/third-party/ReactNativeDependencies${{ inputs.flavor }}.xcframework.tar.gz"
+        export RCT_TESTONLY_RNCORE_TARBALL_PATH="/tmp/ReactCore/ReactCore${{ inputs.flavor }}.xcframework.tar.gz"
 
         if [[ ${{ inputs.use-frameworks }} == "DynamicFrameworks" ]]; then
           export USE_FRAMEWORKS=dynamic
         fi
 
-        export RCT_USE_LOCAL_RN_DEP="/tmp/third-party/ReactNativeDependencies${{ inputs.flavor }}.xcframework.tar.gz"
         cd packages/rn-tester
 
         bundle install

.github/actions/test-library-on-nightly/action.yml

@@ -1,52 +0,0 @@
-name: test-library-on-nightly
-description: Tests a library on a nightly
-inputs:
-  library-npm-package:
-    description: The library npm package to add
-    required: true
-  platform:
-    description: whether we want to build for iOS or Android
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Create new app
-      shell: bash
-      run: |
-        cd /tmp
-        npx @react-native-community/cli init RNApp --skip-install --version nightly
-    - name: Add library
-      shell: bash
-      run: |
-        cd /tmp/RNApp
-        yarn add ${{ inputs.library-npm-package }}
-
-    # iOS
-    - name: Setup xcode
-      if: ${{ inputs.platform == 'ios' }}
-      uses: ./.github/actions/setup-xcode
-    - name: Build iOS
-      shell: bash
-      if: ${{ inputs.platform == 'ios' }}
-      run: |
-        cd /tmp/RNApp/ios
-        bundle install
-        bundle exec pod install
-        xcodebuild build \
-          -workspace RNApp.xcworkspace \
-          -scheme RNApp \
-          -sdk iphonesimulator
-
-    # Android
-    - name: Setup Java for Android
-      if: ${{ inputs.platform == 'android' }}
-      uses: actions/setup-java@v2
-      with:
-        java-version: '17'
-        distribution: 'zulu'
-    - name: Build Android
-      shell: bash
-      if: ${{ inputs.platform == 'android' }}
-      run: |
-        cd /tmp/RNApp/android
-        ./gradlew assembleDebug

.github/workflow-scripts/__tests__/notifyDiscord-test.js

@@ -1,189 +0,0 @@
-/**
- * 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.
- *
- * @format
- */
-
-'use strict';
-
-const {
-  prepareFailurePayload,
-  sendMessageToDiscord,
-} = require('../notifyDiscord');
-
-describe('prepareFailurePayload', () => {
-  it('should handle undefined failures', () => {
-    const message = prepareFailurePayload(undefined);
-    expect(message).toEqual({
-      content:
-        '⚠️ **React Native Nightly Integration Failures** ⚠️\n\nNo failures to report.',
-    });
-  });
-
-  it('should handle empty failures array', () => {
-    const message = prepareFailurePayload([]);
-    expect(message).toEqual({
-      content:
-        '⚠️ **React Native Nightly Integration Failures** ⚠️\n\nNo failures to report.',
-    });
-  });
-
-  it('should format a single failure correctly', () => {
-    const failures = [
-      {
-        library: 'react-native-reanimated',
-        platform: 'iOS',
-      },
-    ];
-
-    const message = prepareFailurePayload(failures);
-    expect(message).toEqual({
-      content:
-        '⚠️ **React Native Nightly Integration Failures** ⚠️\n\nThe integration of libraries with React Native nightly failed for the following libraries:\n\n❌ [iOS] react-native-reanimated',
-    });
-  });
-
-  it('should sort multiple failures by platform and library name', () => {
-    const failures = [
-      {
-        library: 'react-native-reanimated',
-        platform: 'iOS',
-      },
-      {
-        library: 'react-native-gesture-handler',
-        platform: 'Android',
-      },
-      {
-        library: 'react-native-screens',
-        platform: 'iOS',
-      },
-      {
-        library: 'react-native-svg',
-        platform: 'Android',
-      },
-    ];
-
-    const message = prepareFailurePayload(failures);
-
-    // The failures should be sorted: first Android (alphabetically), then iOS
-    // Within each platform, libraries should be sorted alphabetically
-    expect(message).toEqual({
-      content:
-        '⚠️ **React Native Nightly Integration Failures** ⚠️\n\nThe integration of libraries with React Native nightly failed for the following libraries:\n\n❌ [Android] react-native-gesture-handler\n❌ [Android] react-native-svg\n❌ [iOS] react-native-reanimated\n❌ [iOS] react-native-screens',
-    });
-  });
-
-  it('should handle failures with missing properties', () => {
-    const failures = [
-      {
-        // Missing library
-        platform: 'iOS',
-      },
-      {
-        library: 'react-native-gesture-handler',
-        // Missing platform
-      },
-      {
-        // Both missing
-      },
-    ];
-
-    const message = prepareFailurePayload(failures);
-
-    expect(message).toEqual({
-      content:
-        '⚠️ **React Native Nightly Integration Failures** ⚠️\n\nThe integration of libraries with React Native nightly failed for the following libraries:\n\n❌ [iOS] Unknown\n❌ [Unknown] react-native-gesture-handler\n❌ [Unknown] Unknown',
-    });
-  });
-});
-
-describe('sendMessageToDiscord', () => {
-  // Store the original fetch function
-  const originalFetch = global.fetch;
-
-  // Setup and teardown for each test
-  beforeEach(() => {
-    // Mock the global fetch function
-    global.fetch = jest.fn();
-    // Silence console logs during tests
-    jest.spyOn(console, 'log').mockImplementation(() => {});
-    jest.spyOn(console, 'error').mockImplementation(() => {});
-  });
-
-  afterEach(() => {
-    // Restore the original fetch function
-    global.fetch = originalFetch;
-    // Restore console functions
-    jest.restoreAllMocks();
-  });
-
-  it('should throw an error if webhook URL is missing', async () => {
-    await expect(sendMessageToDiscord(null, {})).rejects.toThrow(
-      'Discord webhook URL is missing',
-    );
-  });
-
-  it('should send a message successfully', async () => {
-    // Mock a successful response
-    global.fetch.mockResolvedValueOnce({
-      ok: true,
-      status: 200,
-    });
-
-    const webhook = 'https://discord.com/api/webhooks/123/abc';
-    const message = {content: 'Test message'};
-
-    await expect(sendMessageToDiscord(webhook, message)).resolves.not.toThrow();
-
-    // Verify fetch was called with the right arguments
-    expect(global.fetch).toHaveBeenCalledWith(webhook, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(message),
-    });
-
-    // Verify console.log was called
-    expect(console.log).toHaveBeenCalledWith(
-      'Successfully sent message to Discord',
-    );
-  });
-
-  it('should throw an error if the response is not ok', async () => {
-    // Mock a failed response
-    global.fetch.mockResolvedValueOnce({
-      ok: false,
-      status: 400,
-      text: jest.fn().mockResolvedValueOnce('Bad Request'),
-    });
-
-    const webhook = 'https://discord.com/api/webhooks/123/abc';
-    const message = {content: 'Test message'};
-
-    await expect(sendMessageToDiscord(webhook, message)).rejects.toThrow(
-      'HTTP status code: 400',
-    );
-
-    // Verify console.error was called
-    expect(console.error).toHaveBeenCalledWith(
-      'Failed to send message to Discord: 400 Bad Request',
-    );
-  });
-
-  it('should throw an error if fetch fails', async () => {
-    // Mock a network error
-    const networkError = new Error('Network error');
-    global.fetch.mockRejectedValueOnce(networkError);
-
-    const webhook = 'https://discord.com/api/webhooks/123/abc';
-    const message = {content: 'Test message'};
-
-    await expect(sendMessageToDiscord(webhook, message)).rejects.toThrow(
-      'Network error',
-    );
-  });
-});

.github/workflow-scripts/__tests__/publishTemplate-test.js

@@ -117,13 +117,13 @@ describe('#verifyPublishedTemplate', () => {
     it('will timeout if npm does not update package version after a set number of retries', async () => {
       const RETRIES = 2;
 
-      await verifyPublishedTemplate('0.77.0', true, RETRIES),
+      (await verifyPublishedTemplate('0.77.0', true, RETRIES),
         expect(mockVerifyPublishedPackage).toHaveBeenCalledWith(
           '@react-native-community/template',
           '0.77.0',
           'latest',
           2,
-        );
+        ));
     });
   });
 });

.github/workflow-scripts/__tests__/verifyArtifactsAreOnMaven-test.js

@@ -38,7 +38,7 @@ describe('#verifyArtifactsAreOnMaven', () => {
 
     expect(mockSleep).toHaveBeenCalledTimes(1);
     expect(mockFetch).toHaveBeenCalledWith(
-      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1',
+      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1/react-native-artifacts-0.78.1.pom',
     );
   });
 
@@ -55,7 +55,7 @@ describe('#verifyArtifactsAreOnMaven', () => {
 
     expect(mockSleep).toHaveBeenCalledTimes(1);
     expect(mockFetch).toHaveBeenCalledWith(
-      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1',
+      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1/react-native-artifacts-0.78.1.pom',
     );
   });
 
@@ -67,7 +67,7 @@ describe('#verifyArtifactsAreOnMaven', () => {
 
     expect(mockSleep).toHaveBeenCalledTimes(0);
     expect(mockFetch).toHaveBeenCalledWith(
-      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1',
+      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1/react-native-artifacts-0.78.1.pom',
     );
   });
 
@@ -81,7 +81,7 @@ describe('#verifyArtifactsAreOnMaven', () => {
     expect(mockSleep).toHaveBeenCalledTimes(90);
     expect(mockExit).toHaveBeenCalledWith(1);
     expect(mockFetch).toHaveBeenCalledWith(
-      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1',
+      'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.78.1/react-native-artifacts-0.78.1.pom',
     );
   });
 });

.github/workflow-scripts/__tests__/verifyReleaseOnNpm-test.js

@@ -83,13 +83,13 @@ describe('#verifyReleaseOnNPM', () => {
     it('will timeout if npm does not update package version after a set number of retries', async () => {
       const RETRIES = 2;
 
-      await verifyReleaseOnNpm('0.77.0', true, RETRIES),
+      (await verifyReleaseOnNpm('0.77.0', true, RETRIES),
         expect(mockVerifyPublishedPackage).toHaveBeenCalledWith(
           'react-native',
           '0.77.0',
           'latest',
           2,
-        );
+        ));
     });
 
     it('will timeout if npm does not update latest tag after a set number of retries', async () => {

.github/workflow-scripts/collectNightlyOutcomes.js

@@ -1,121 +0,0 @@
-/**
- * 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.
- *
- * @format
- */
-
-const fs = require('fs');
-const path = require('path');
-const {
-  prepareFailurePayload,
-  sendMessageToDiscord,
-} = require('./notifyDiscord');
-
-function readOutcomes() {
-  const baseDir = '/tmp';
-  let outcomes = [];
-  fs.readdirSync(baseDir).forEach(file => {
-    const fullPath = path.join(baseDir, file);
-    if (fullPath.endsWith('outcome') && fs.statSync(fullPath).isDirectory) {
-      fs.readdirSync(fullPath).forEach(subFile => {
-        const subFullPath = path.join(fullPath, subFile);
-        if (subFullPath.endsWith('outcome')) {
-          const [library, status] = String(fs.readFileSync(subFullPath, 'utf8'))
-            .trim()
-            .split(':');
-          const platform = subFile.includes('android') ? 'Android' : 'iOS';
-          console.log(
-            `[${platform}] ${library} completed with status ${status}`,
-          );
-          outcomes.push({
-            library: library.trim(),
-            platform,
-            status: status.trim(),
-          });
-        }
-      });
-    } else if (fullPath.endsWith('outcome')) {
-      const [library, status] = String(fs.readFileSync(fullPath, 'utf8'))
-        .trim()
-        .split(':');
-      const platform = file.includes('android') ? 'Android' : 'iOS';
-      console.log(`[${platform}] ${library} completed with status ${status}`);
-      outcomes.push({
-        library: library.trim(),
-        platform,
-        status: status.trim(),
-      });
-    }
-  });
-  return outcomes;
-}
-
-function printFailures(outcomes) {
-  console.log('Printing failures...');
-  let failedLibraries = [];
-  outcomes.forEach(entry => {
-    if (entry.status !== 'success') {
-      console.log(
-        `❌ [${entry.platform}] ${entry.library} failed with status ${entry.status}`,
-      );
-      failedLibraries.push({
-        library: entry.library,
-        platform: entry.platform,
-      });
-    }
-  });
-  return failedLibraries;
-}
-
-/**
- * Sends a message to Discord with the list of failures.
- * @param {string} webHook - The Discord webhook URL
- * @param {Array<Object>} failures - List of failures to report
- * @returns {Promise<void>} - A promise that resolves when the message is sent
- */
-async function notifyDiscord(webHook, failures) {
-  if (!webHook) {
-    console.error('Discord webhook URL is missing');
-    return;
-  }
-
-  if (!failures || failures.length === 0) {
-    console.log('No failures to report to Discord');
-    return;
-  }
-
-  try {
-    // Use the prepareFailurePayload function to format the message
-    const message = prepareFailurePayload(failures);
-
-    // Use the sendMessageToDiscord function to send the message
-    await sendMessageToDiscord(webHook, message);
-  } catch (error) {
-    console.error('Error in notifyDiscord function:', error);
-    throw error;
-  }
-}
-
-async function collectResults(discordWebHook) {
-  const outcomes = readOutcomes();
-  const failures = printFailures(outcomes);
-
-  if (failures.length > 0) {
-    if (discordWebHook) {
-      console.log('Sending to discord');
-      await notifyDiscord(discordWebHook, failures);
-    } else {
-      console.log('Web hook not set');
-    }
-    process.exit(1);
-  }
-  console.log('✅ All tests passed!');
-}
-
-module.exports = {
-  collectResults,
-  notifyDiscord,
-};

.github/workflow-scripts/extractIssueOncalls.js

@@ -25,6 +25,31 @@ function extractUsersFromScheduleAndDate(schedule, userMap, date) {
   return [user1, user2];
 }
 
+/**
+ * You can invoke this script by doing:
+ * ```
+ * node .github/workflow-scripts/extractIssueOncalls.js $DATA
+ * ```
+ *
+ * the $DATA is stored in the github secrets as ONCALL_SCHEDULE variable.
+ * The format of the data is:
+ * ```
+ * {
+ *   \"userMap\": {
+ *     \"discord_handle1\": \"discord_id1\",
+ *     \"discord_handle2\": \"discord_id2\",
+ *    ...
+ *  },
+ *  \"schedule\": {
+ *    \"2025-07-29\": [\"discord_handle1\", \"discord_handle2\"],
+ *    \"2025-08-05\": [\"discord_handle3\", \"discord_handle4\"],
+ *   ...
+ * }
+ * ```
+ *
+ * When uploading the secret, make sure that the JSON strings are escaped!
+ * The script will fail otherwise, because GitHub will remove the `"` characters.
+ */
 function main() {
   const configuration = process.argv[2];
   const {userMap, schedule} = JSON.parse(configuration);

.github/workflow-scripts/maestro-ios.js

@@ -87,11 +87,11 @@ async function launchAppOnSimulator(appId, udid, isDebug) {
 
 function startVideoRecording(jsengine, currentAttempt) {
   console.log(
-    `Start video record using pid: video_record_${jsengine}_${currentAttempt}.pid`,
+    `Start video record using pid: video_record_${currentAttempt}.pid`,
   );
 
   const recordingArgs =
-    `simctl io booted recordVideo video_record_${jsengine}_${currentAttempt}.mov`.split(
+    `simctl io booted recordVideo video_record_${currentAttempt}.mov`.split(
       ' ',
     );
   const recordingProcess = childProcess.spawn('xcrun', recordingArgs, {

.github/workflow-scripts/notifyDiscord.js

@@ -1,90 +0,0 @@
-/**
- * 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.
- *
- * @format
- */
-
-/**
- * Sends a message to Discord using the webhook URL.
- * @param {string} webHook - The Discord webhook URL
- * @param {Object} message - The message to send
- * @returns {Promise<void>} - A promise that resolves when the message is sent
- */
-async function sendMessageToDiscord(webHook, message) {
-  if (!webHook) {
-    throw new Error('Discord webhook URL is missing');
-  }
-
-  // Send the request using fetch
-  const response = await fetch(webHook, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify(message),
-  });
-
-  // Handle the response
-  if (response.ok) {
-    console.log('Successfully sent message to Discord');
-    return;
-  } else {
-    const errorText = await response.text();
-    console.error(
-      `Failed to send message to Discord: ${response.status} ${errorText}`,
-    );
-    throw new Error(`HTTP status code: ${response.status}`);
-  }
-}
-
-/**
- * Prepares a formatted Discord message payload from a list of failures.
- * @param {Array<Object>} failures - List of failures to format
- * @returns {Object} - The formatted Discord message payload
- */
-function prepareFailurePayload(failures) {
-  if (!failures || failures.length === 0) {
-    return {
-      content:
-        '⚠️ **React Native Nightly Integration Failures** ⚠️\n\nNo failures to report.',
-    };
-  }
-
-  // Sort failures by platform and then by library name
-  const sortedFailures = [...failures].sort((a, b) => {
-    // First sort by platform
-    const platformA = a.platform || 'Unknown';
-    const platformB = b.platform || 'Unknown';
-
-    if (platformA !== platformB) {
-      return platformA.localeCompare(platformB);
-    }
-
-    // Then sort by library name
-    const libraryA = a.library || 'Unknown';
-    const libraryB = b.library || 'Unknown';
-    return libraryA.localeCompare(libraryB);
-  });
-
-  // Format the failures into a message
-  const formattedFailures = sortedFailures
-    .map(failure => {
-      const library = failure.library || 'Unknown';
-      const platform = failure.platform || 'Unknown';
-      return `❌ [${platform}] ${library}`;
-    })
-    .join('\n');
-
-  return {
-    content: `⚠️ **React Native Nightly Integration Failures** ⚠️\n\nThe integration of libraries with React Native nightly failed for the following libraries:\n\n${formattedFailures}`,
-  };
-}
-
-// Export the functions using CommonJS syntax
-module.exports = {
-  prepareFailurePayload,
-  sendMessageToDiscord,
-};

.github/workflow-scripts/verifyArtifactsAreOnMaven.js

@@ -13,13 +13,14 @@ const SLEEP_S = 60; // 1 minute
 const MAX_RETRIES = 90; // 90 attempts. Waiting between attempt: 1 min. Total time: 90 min.
 const ARTIFACT_URL =
   'https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/';
+const ARTIFACT_NAME = 'react-native-artifacts-';
 
 async function verifyArtifactsAreOnMaven(version, retries = MAX_RETRIES) {
   if (version.startsWith('v')) {
     version = version.substring(1);
   }
 
-  const artifactUrl = `${ARTIFACT_URL}${version}`;
+  const artifactUrl = `${ARTIFACT_URL}${version}/${ARTIFACT_NAME}${version}.pom`;
   for (let currentAttempt = 1; currentAttempt <= retries; currentAttempt++) {
     const response = await fetch(artifactUrl);
 

.github/workflows/bump-podfile-lock.yml

@@ -18,6 +18,10 @@ jobs:
         run: |
           git config --local user.email "bot@reactnative.dev"
           git config --local user.name "React Native Bot"
+      - name: Setup xcode
+        uses: ./.github/actions/setup-xcode
+        with:
+          xcode-version: '16.2.0'
       - name: Extract branch name
         run: |
           TAG="${{ github.ref_name }}";

.github/workflows/check-nightly.yml

@@ -1,34 +0,0 @@
-# This jobs runs every day 2 hours after the nightly job and its purpose is to report
-# a failure in case the nightly failed to be published. We are going to hook this to an internal automation.
-name: Check Nightlies
-
-on:
-  workflow_dispatch:
-  # nightly build @ 4:15 AM UTC
-  schedule:
-    - cron: '15 4 * * *'
-
-jobs:
-  check-nightly:
-    runs-on: ubuntu-latest
-    if: github.repository == 'facebook/react-native'
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Check nightly
-        run: |
-          TODAY=$(date "+%Y%m%d")
-          echo "Checking nightly for $TODAY"
-          NIGHTLY="$(npm view react-native | grep $TODAY)"
-          if [[ -z $NIGHTLY ]]; then
-            echo 'Nightly job failed.'
-            exit 1
-          else
-            echo 'Nightly Worked, All Good!'
-          fi
-
-  test-libraries:
-    uses: ./.github/workflows/test-libraries-on-nightlies.yml
-    needs: check-nightly
-    secrets:
-      discord_webhook_url: ${{ secrets.NIGHTLY_DISCORD_WEBHOOK }}

.github/workflows/danger-pr.yml

@@ -22,6 +22,8 @@ jobs:
         uses: ./.github/actions/setup-node
       - name: Run yarn install
         uses: ./.github/actions/yarn-install
+      - name: Run diff-js-api-breaking-changes
+        uses: ./.github/actions/diff-js-api-breaking-changes
       - name: Danger
         run: yarn danger ci --use-github-checks --failOnErrors
         working-directory: private/react-native-bots

.github/workflows/monitor-new-issues.yml

@@ -27,10 +27,6 @@ jobs:
           ONCALL2=$(echo $ONCALLS | cut -d ' ' -f 2)
           echo "oncall1=$ONCALL1" >> $GITHUB_ENV
           echo "oncall2=$ONCALL2" >> $GITHUB_ENV
-      - name: Print oncalls
-        run: |
-          echo "oncall1: ${{ env.oncall1 }}"
-          echo "oncall2: ${{ env.oncall2 }}"
       - name: Monitor New Issues
         uses: react-native-community/repo-monitor@v1.0.1
         with:

.github/workflows/nightly.yml

@@ -128,9 +128,9 @@ jobs:
     runs-on: windows-2025
     needs: prepare_hermes_workspace
     env:
-      HERMES_WS_DIR: 'D:\tmp\hermes'
-      HERMES_TARBALL_ARTIFACTS_DIR: 'D:\tmp\hermes\hermes-runtime-darwin'
-      HERMES_OSXBIN_ARTIFACTS_DIR: 'D:\tmp\hermes\osx-bin'
+      HERMES_WS_DIR: 'C:\tmp\hermes'
+      HERMES_TARBALL_ARTIFACTS_DIR: 'C:\tmp\hermes\hermes-runtime-darwin'
+      HERMES_OSXBIN_ARTIFACTS_DIR: 'C:\tmp\hermes\osx-bin'
       ICU_URL: "https://github.com/unicode-org/icu/releases/download/release-64-2/icu4c-64_2-Win64-MSVC2017.zip"
       MSBUILD_DIR: 'C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Current\Bin'
       CMAKE_DIR: 'C:\Program Files\CMake\bin'

.github/workflows/prebuild-ios-core.yml

@@ -23,7 +23,7 @@ jobs:
         id: restore-ios-slice
         uses: actions/cache/restore@v4
         with:
-          key: v3-ios-core-${{ matrix.slice }}-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift') }}-${{ hashFiles('packages/react-native/scripts/ios-prebuild/setup.js') }}
+          key: v3-ios-core-${{ matrix.slice }}-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift', 'packages/react-native/scripts/ios-prebuild/*.js', 'packages/react-native/scripts/ios-prebuild.js', 'packages/react-native/React/**/*', 'packages/react-native/ReactCommon/**/*', 'packages/react-native/Libraries/**/*') }}
           path: packages/react-native/
       - name: Setup node.js
         if: steps.restore-ios-slice.outputs.cache-hit != 'true'
@@ -83,7 +83,7 @@ jobs:
           # Move the XCFramework in the destination directory
           mv /tmp/third-party/packages/react-native/third-party/ReactNativeDependencies.xcframework packages/react-native/third-party/ReactNativeDependencies.xcframework
 
-          VERSION=$(jq -r '.version' package.json)
+          VERSION=$(jq -r '.version' packages/react-native/package.json)
           echo "$VERSION-${{matrix.flavor}}" > "packages/react-native/third-party/version.txt"
           cat "packages/react-native/third-party/version.txt"
           # Check destination directory
@@ -117,7 +117,7 @@ jobs:
         uses: actions/cache/save@v4
         if: ${{ github.ref == 'refs/heads/main' }} # To avoid that the cache explode
         with:
-          key: v3-ios-core-${{ matrix.slice }}-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift') }}-${{ hashFiles('packages/react-native/scripts/ios-prebuild/setup.js') }}
+          key: v3-ios-core-${{ matrix.slice }}-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift', 'packages/react-native/scripts/ios-prebuild/*.js', 'packages/react-native/scripts/ios-prebuild.js', 'packages/react-native/React/**/*', 'packages/react-native/ReactCommon/**/*', 'packages/react-native/Libraries/**/*') }}
           path: |
             packages/react-native/.build/output/spm/${{ matrix.flavor }}/Build/Products
             packages/react-native/.build/headers
@@ -140,7 +140,7 @@ jobs:
         uses: actions/cache/restore@v4
         with:
           path: packages/react-native/.build/output/xcframeworks
-          key: v2-ios-core-xcframework-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift') }}-${{ hashFiles('packages/react-native/scripts/ios-prebuild/setup.js') }}
+          key: v2-ios-core-xcframework-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift', 'packages/react-native/scripts/ios-prebuild/*.js', 'packages/react-native/scripts/ios-prebuild.js', 'packages/react-native/React/**/*', 'packages/react-native/ReactCommon/**/*', 'packages/react-native/Libraries/**/*') }}
       - name: Setup node.js
         if: steps.restore-ios-xcframework.outputs.cache-hit != 'true'
         uses: ./.github/actions/setup-node
@@ -209,4 +209,4 @@ jobs:
           path: |
             packages/react-native/.build/output/xcframeworks/ReactCore${{matrix.flavor}}.xcframework.tar.gz
             packages/react-native/.build/output/xcframeworks/ReactCore${{matrix.flavor}}.framework.dSYM.tar.gz
-          key: v2-ios-core-xcframework-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift') }}-${{ hashFiles('packages/react-native/scripts/ios-prebuild/setup.js') }}
+          key: v2-ios-core-xcframework-${{ matrix.flavor }}-${{ hashFiles('packages/react-native/Package.swift', 'packages/react-native/scripts/ios-prebuild/*.js', 'packages/react-native/scripts/ios-prebuild.js', 'packages/react-native/React/**/*', 'packages/react-native/ReactCommon/**/*', 'packages/react-native/Libraries/**/*') }}

.github/workflows/prebuild-ios-dependencies.yml

@@ -179,8 +179,9 @@ jobs:
       - name: Compress and Rename dSYM
         if: steps.restore-xcframework.outputs.cache-hit != 'true'
         run: |
-          tar -cz -f packages/react-native/third-party/Symbols/ReactNativeDependencies${{ matrix.flavor }}.framework.dSYM.tar.gz \
-            packages/react-native/third-party/Symbols/ReactNativeDependencies.framework.dSYM
+          cd packages/react-native/third-party/Symbols/
+          tar -cz -f ../ReactNativeDependencies${{ matrix.flavor }}.framework.dSYM.tar.gz .
+          mv ../ReactNativeDependencies${{ matrix.flavor }}.framework.dSYM.tar.gz ./ReactNativeDependencies${{ matrix.flavor }}.framework.dSYM.tar.gz
       - name: Upload XCFramework Artifact
         uses: actions/upload-artifact@v4
         with:

.github/workflows/publish-bumped-packages.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Build packages
         run: yarn build
       - name: Build types
-        run: yarn build-types
+        run: yarn build-types --skip-snapshot
       - name: Set NPM auth token
         run: echo "//registry.npmjs.org/:_authToken=$GHA_NPM_TOKEN" > ~/.npmrc
       - name: Find and publish all bumped packages

.github/workflows/publish-release.yml

@@ -125,9 +125,9 @@ jobs:
     runs-on: windows-2025
     needs: prepare_hermes_workspace
     env:
-      HERMES_WS_DIR: 'D:\tmp\hermes'
-      HERMES_TARBALL_ARTIFACTS_DIR: 'D:\tmp\hermes\hermes-runtime-darwin'
-      HERMES_OSXBIN_ARTIFACTS_DIR: 'D:\tmp\hermes\osx-bin'
+      HERMES_WS_DIR: 'C:\tmp\hermes'
+      HERMES_TARBALL_ARTIFACTS_DIR: 'C:\tmp\hermes\hermes-runtime-darwin'
+      HERMES_OSXBIN_ARTIFACTS_DIR: 'C:\tmp\hermes\osx-bin'
       ICU_URL: "https://github.com/unicode-org/icu/releases/download/release-64-2/icu4c-64_2-Win64-MSVC2017.zip"
       MSBUILD_DIR: 'C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Current\Bin'
       CMAKE_DIR: 'C:\Program Files\CMake\bin'

.github/workflows/stale-bot.yml

@@ -14,8 +14,8 @@ jobs:
         with:
           repo-token: ${{ secrets.REACT_NATIVE_BOT_GITHUB_TOKEN }}
           days-before-stale: 180
-          stale-issue-message: 'This issue is stale because it has been open 180 days with no activity. Remove stale label or comment or this will be closed in 7 days.'
-          stale-pr-message: 'This PR is stale because it has been open 180 days with no activity. Remove stale label or comment or this will be closed in 7 days.'
+          stale-issue-message: 'This issue is stale because it has been open for 180 days with no activity. It will be closed in 7 days unless you comment on it or remove the "Stale" label.'
+          stale-pr-message: 'This PR is stale because it has been open for 180 days with no activity. It will be closed in 7 days unless you comment on it or remove the "Stale" label.'
           close-issue-message: 'This issue was closed because it has been stalled for 7 days with no activity.'
           close-pr-message: 'This PR was closed because it has been stalled for 7 days with no activity.'
           exempt-issue-labels: 'Help Wanted :octocat:, Good first issue, Never gets stale, Issue: Author Provided Repro'

.github/workflows/test-all.yml

@@ -2,11 +2,6 @@ name: Test All
 
 on:
   workflow_dispatch:
-    inputs:
-      run-e2e-tests:
-        description: Whether to run E2E tests or not
-        type: boolean
-        default: false
   pull_request:
   push:
     branches:
@@ -128,7 +123,7 @@ jobs:
   test_ios_rntester_ruby_3_2_0:
     runs-on: macos-14
     needs:
-      [build_apple_slices_hermes, prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies]
+      [build_apple_slices_hermes, prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies, prebuild_react_native_core]
     env:
       HERMES_WS_DIR: /tmp/hermes
       HERMES_TARBALL_ARTIFACTS_DIR: /tmp/hermes/hermes-runtime-darwin
@@ -141,31 +136,12 @@ jobs:
           ruby-version: "3.2.0"
           hermes-version: ${{ needs.prepare_hermes_workspace.outputs.hermes-version }}
           react-native-version: ${{ needs.prepare_hermes_workspace.outputs.react-native-version }}
-
-  test_ios_rntester_dynamic_frameworks:
-    runs-on: macos-14
-    needs:
-      [build_apple_slices_hermes, prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies]
-    env:
-      HERMES_WS_DIR: /tmp/hermes
-      HERMES_TARBALL_ARTIFACTS_DIR: /tmp/hermes/hermes-runtime-darwin
-    continue-on-error: true
-    strategy:
-      fail-fast: false
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Run it
-        uses: ./.github/actions/test-ios-rntester
-        with:
-          use-frameworks: DynamicFrameworks
-          hermes-version: ${{ needs.prepare_hermes_workspace.outputs.hermes-version }}
-          react-native-version: ${{ needs.prepare_hermes_workspace.outputs.react-native-version }}
+          flavor: Debug
 
   test_ios_rntester:
     runs-on: macos-14-large
     needs:
-      [build_apple_slices_hermes, prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies]
+      [build_apple_slices_hermes, prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies, prebuild_react_native_core]
     env:
       HERMES_WS_DIR: /tmp/hermes
       HERMES_TARBALL_ARTIFACTS_DIR: /tmp/hermes/hermes-runtime-darwin
@@ -174,20 +150,19 @@ jobs:
       fail-fast: false
       matrix:
         flavor: [Debug, Release]
+        frameworks: [StaticLibraries, DynamicFrameworks]
     steps:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Run it
         uses: ./.github/actions/test-ios-rntester
         with:
-          run-unit-tests: "false"
-          use-frameworks: StaticLibraries
+          use-frameworks: ${{ matrix.frameworks }}
           hermes-version: ${{ needs.prepare_hermes_workspace.outputs.hermes-version }}
           react-native-version: ${{ needs.prepare_hermes_workspace.outputs.react-native-version }}
           flavor: ${{ matrix.flavor }}
 
   test_e2e_ios_rntester:
-    if: ${{ github.ref == 'refs/heads/main' || contains(github.ref,  'stable') || inputs.run-e2e-tests }}
     runs-on: macos-14-large
     needs:
       [test_ios_rntester]
@@ -221,7 +196,6 @@ jobs:
           flavor: ${{ matrix.flavor }}
 
   test_e2e_ios_templateapp:
-    if: ${{ github.ref == 'refs/heads/main' || contains(github.ref,  'stable') || inputs.run-e2e-tests }}
     runs-on: macos-14-large
     needs: [build_npm_package, prebuild_apple_dependencies]
     env:
@@ -264,6 +238,19 @@ jobs:
       - name: Print third-party folder
         shell: bash
         run: ls -lR /tmp/third-party
+      - name: Download React Native Prebuilds
+        uses: actions/download-artifact@v4
+        with:
+          name: ReactCore${{ matrix.flavor }}.xcframework.tar.gz
+          path: /tmp/ReactCore
+      - name: Print ReactCore folder
+        shell: bash
+        run: ls -lR /tmp/ReactCore
+      - name: Configure git
+        shell: bash
+        run: |
+            git config --global user.email "react-native-bot@meta.com"
+            git config --global user.name "React Native Bot"
       - name: Prepare artifacts
         run: |
           REACT_NATIVE_PKG=$(find /tmp/react-native-tmp -type f -name "*.tgz")
@@ -286,6 +273,7 @@ jobs:
           NEW_ARCH_ENABLED=1
 
           export RCT_USE_LOCAL_RN_DEP=/tmp/third-party/ReactNativeDependencies${{ matrix.flavor }}.xcframework.tar.gz
+          export RCT_TESTONLY_RNCORE_TARBALL_PATH="/tmp/ReactCore/ReactCore${{ matrix.flavor }}.xcframework.tar.gz"
           HERMES_ENGINE_TARBALL_PATH=$HERMES_PATH RCT_NEW_ARCH_ENABLED=$NEW_ARCH_ENABLED bundle exec pod install
 
           xcodebuild \
@@ -305,7 +293,6 @@ jobs:
           working-directory: /tmp/RNTestProject
 
   test_e2e_android_templateapp:
-    if: ${{ github.ref == 'refs/heads/main' || contains(github.ref,  'stable') || inputs.run-e2e-tests }}
     runs-on: 4-core-ubuntu
     needs: build_npm_package
     strategy:
@@ -388,13 +375,32 @@ jobs:
           hermes-version: ${{ needs.prepare_hermes_workspace.outputs.hermes-version }}
           react-native-version: ${{ needs.prepare_hermes_workspace.outputs.react-native-version }}
 
+  run_fantom_tests:
+    runs-on: 8-core-ubuntu
+    needs: [set_release_type]
+    container:
+      image: reactnativecommunity/react-native-android:latest
+      env:
+        TERM: "dumb"
+        GRADLE_OPTS: "-Dorg.gradle.daemon=false"
+        ORG_GRADLE_PROJECT_SIGNING_PWD: ${{ secrets.ORG_GRADLE_PROJECT_SIGNING_PWD }}
+        ORG_GRADLE_PROJECT_SIGNING_KEY: ${{ secrets.ORG_GRADLE_PROJECT_SIGNING_KEY }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build and Test Fantom
+        uses: ./.github/actions/run-fantom-tests
+        with:
+          release-type: ${{ needs.set_release_type.outputs.RELEASE_TYPE }}
+          gradle-cache-encryption-key: ${{ secrets.GRADLE_CACHE_ENCRYPTION_KEY }}
+
   build_hermesc_windows:
     runs-on: windows-2025
     needs: prepare_hermes_workspace
     env:
-      HERMES_WS_DIR: 'D:\tmp\hermes'
-      HERMES_TARBALL_ARTIFACTS_DIR: 'D:\tmp\hermes\hermes-runtime-darwin'
-      HERMES_OSXBIN_ARTIFACTS_DIR: 'D:\tmp\hermes\osx-bin'
+      HERMES_WS_DIR: 'C:\tmp\hermes'
+      HERMES_TARBALL_ARTIFACTS_DIR: 'C:\tmp\hermes\hermes-runtime-darwin'
+      HERMES_OSXBIN_ARTIFACTS_DIR: 'C:\tmp\hermes\osx-bin'
       ICU_URL: "https://github.com/unicode-org/icu/releases/download/release-64-2/icu4c-64_2-Win64-MSVC2017.zip"
       MSBUILD_DIR: 'C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Current\Bin'
       CMAKE_DIR: 'C:\Program Files\CMake\bin'
@@ -424,11 +430,9 @@ jobs:
         uses: ./.github/actions/build-android
         with:
           release-type: ${{ needs.set_release_type.outputs.RELEASE_TYPE }}
-          run-e2e-tests: ${{ github.ref == 'refs/heads/main' || contains(github.ref,  'stable') || inputs.run-e2e-tests }}
           gradle-cache-encryption-key: ${{ secrets.GRADLE_CACHE_ENCRYPTION_KEY }}
 
   test_e2e_android_rntester:
-    if: ${{ github.ref == 'refs/heads/main' || contains(github.ref,  'stable') || inputs.run-e2e-tests }}
     runs-on: 4-core-ubuntu
     needs: [build_android]
     strategy:
@@ -548,7 +552,7 @@ jobs:
 
   test_ios_helloworld_with_ruby_3_2_0:
     runs-on: macos-14
-    needs: [prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies] # prepare_hermes_workspace must be there because we need its reference to retrieve a couple of outputs
+    needs: [prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies, prebuild_react_native_core] # prepare_hermes_workspace must be there because we need its reference to retrieve a couple of outputs
     env:
       PROJECT_NAME: iOSTemplateProject
       HERMES_WS_DIR: /tmp/hermes
@@ -565,7 +569,7 @@ jobs:
 
   test_ios_helloworld:
     runs-on: macos-14
-    needs: [prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies] # prepare_hermes_workspace must be there because we need its reference to retrieve a couple of outputs
+    needs: [prepare_hermes_workspace, build_hermes_macos, prebuild_apple_dependencies, prebuild_react_native_core] # prepare_hermes_workspace must be there because we need its reference to retrieve a couple of outputs
     strategy:
       matrix:
         flavor: [Debug, Release]
@@ -593,7 +597,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: ["24", "22"]
+        node-version: ["24.4.1", "22", "20.19.4"]
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -626,7 +630,7 @@ jobs:
   rerun-failed-jobs:
     runs-on: ubuntu-latest
     needs: [test_e2e_ios_rntester, test_e2e_android_rntester, test_e2e_ios_templateapp, test_e2e_android_templateapp]
-    if: always()
+    if: ${{ github.ref == 'refs/heads/main' && always() }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/test-libraries-on-nightlies.yml

@@ -1,100 +0,0 @@
-name: Test Libraries on Nightlies
-
-on:
-  workflow_call:
-    secrets:
-      discord_webhook_url:
-        required: true
-
-
-# We use the matrix.library entry to specify the dependency we want to use
-# The key is used directly as the <pkg> in the `yarn add <pkg>` command.
-jobs:
-  runner-setup:
-    runs-on: ubuntu-latest
-    outputs:
-      runners: '{"ios":"macos-14-large", "android": "ubuntu-latest"}'
-    steps:
-      - run: echo no-op
-
-  test-library-on-nightly:
-    name: "[${{ matrix.platform }}] ${{ matrix.library }}"
-    needs: runner-setup
-    runs-on: ${{ fromJSON(needs.runner-setup.outputs.runners)[matrix.platform] }}
-    continue-on-error: true
-    strategy:
-      matrix:
-        library: [
-          "react-native-async-storage",
-          "react-native-blob-util",
-          "@react-native-clipboard/clipboard",
-          "@react-native-community/datetimepicker",
-          "react-native-gesture-handler",
-          "react-native-image-picker",
-          "react-native-linear-gradient",
-          "@react-native-masked-view/masked-view",
-          # "react-native-maps", React Native Maps with the New Arch support has a complex cocoapods setup for iOS. It needs a dedicated workflow.
-          "@react-native-community/netinfo",
-          "react-native-reanimated@nightly react-native-worklets@nightly", #reanimated requires worklet to be explicitly installed as a separate package
-          "react-native-svg",
-          "react-native-video",
-          "react-native-webview",
-          "react-native-mmkv",
-          "react-native-screens",
-          "react-native-pager-view",
-          "@react-native-community/slider",
-          # additional OSS libs used internally
-          "scandit-react-native-datacapture-barcode scandit-react-native-datacapture-core",
-          "react-native-contacts",
-          "react-native-device-info",
-          "react-native-email-link",
-          "@dr.pogodin/react-native-fs",
-          "react-native-permissions",
-          "react-native-vector-icons",
-          "react-native-masked-view",
-          "@react-native-community/image-editor",
-        ]
-        platform: [ios, android]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Set up Node.js
-        uses: ./.github/actions/setup-node
-      - name: Test ${{ matrix.library }}
-        id: run-test
-        uses: ./.github/actions/test-library-on-nightly
-        with:
-          library-npm-package: ${{ matrix.library }}
-          platform: ${{ matrix.platform}}
-      - name: Save outcome
-        id: save-outcome
-        if: always()
-        run: |
-          LIB_FOLDER=$(echo "${{matrix.library}}"  | tr ' ' '_' | tr '/' '_')
-          echo "${{matrix.library}}: ${{steps.run-test.outcome}}" > "/tmp/$LIB_FOLDER-${{ matrix.platform }}-outcome"
-          echo "lib_folder=$LIB_FOLDER" >> $GITHUB_OUTPUT
-      - name: Upload Artifact
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: ${{ steps.save-outcome.outputs.lib_folder }}-${{ matrix.platform }}-outcome
-          path: /tmp/${{ steps.save-outcome.outputs.lib_folder }}-${{ matrix.platform }}-outcome
-
-
-  collect-results:
-    runs-on: ubuntu-latest
-    needs: [test-library-on-nightly]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Restore outcomes
-        uses: actions/download-artifact@v4
-        with:
-          pattern: '*-outcome'
-          path: /tmp
-      - name: Collect failures
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const {collectResults} = require('./.github/workflow-scripts/collectNightlyOutcomes.js');
-            await collectResults('${{secrets.discord_webhook_url}}');

.gitignore

@@ -43,7 +43,6 @@ project.xcworkspace
 /private/helloworld/android/app/build/
 /private/helloworld/android/build/
 /packages/react-native-popup-menu-android/android/build/
-/packages/react-native-test-library/android/build/
 
 # Buck
 .buckd
@@ -171,7 +170,11 @@ fix_*.patch
 
 # Jest Integration
 /private/react-native-fantom/build/
+/private/react-native-fantom/.out/
 /private/react-native-fantom/tester/build/
 
 # [Experimental] Generated TS type definitions
 /packages/**/types_generated/
+
+/packages/debugger-shell/build/
+/packages/*/dist/

.prettierrc

@@ -1,36 +0,0 @@
-{
-  "arrowParens": "avoid",
-  "bracketSameLine": true,
-  "bracketSpacing": false,
-  "requirePragma": true,
-  "singleQuote": true,
-  "trailingComma": "all",
-  "endOfLine": "lf",
-  "overrides": [
-    {
-      "files": ["*.code-workspace"],
-      "options": {
-        "parser": "json"
-      }
-    },
-    {
-      "files": [
-        "*.js",
-        "*.js.flow"
-      ],
-      "options": {
-        "parser": "hermes"
-      }
-    },
-    {
-      "files": [
-        "**/__docs__/*.md"
-      ],
-      "options": {
-        "parser": "markdown",
-        "proseWrap": "always",
-        "requirePragma": false
-      }
-    }
-  ]
-}

.prettierrc.js

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ *
+ * @format
+ */
+
+let plugins = ['prettier-plugin-hermes-parser'];
+try {
+  plugins = require('./.prettier-plugins.fb.js');
+} catch {}
+
+module.exports = {
+  arrowParens: 'avoid',
+  bracketSameLine: true,
+  bracketSpacing: false,
+  requirePragma: true,
+  singleQuote: true,
+  trailingComma: 'all',
+  endOfLine: 'lf',
+  plugins,
+  overrides: [
+    {
+      files: ['*.code-workspace'],
+      options: {
+        parser: 'json',
+      },
+    },
+    {
+      files: ['*.js', '*.js.flow'],
+      options: {
+        parser: 'hermes',
+      },
+    },
+    {
+      files: ['**/__docs__/*.md'],
+      options: {
+        parser: 'markdown',
+        proseWrap: 'always',
+        requirePragma: false,
+      },
+    },
+  ],
+};

build.gradle.kts

@@ -13,6 +13,7 @@ plugins {
   alias(libs.plugins.kotlin.android) apply false
   alias(libs.plugins.binary.compatibility.validator) apply true
   alias(libs.plugins.android.test) apply false
+  alias(libs.plugins.ktfmt) apply true
 }
 
 val reactAndroidProperties = java.util.Properties()
@@ -25,10 +26,12 @@ fun getListReactAndroidProperty(name: String) = reactAndroidProperties.getProper
 
 apiValidation {
   ignoredPackages.addAll(
-      getListReactAndroidProperty("binaryCompatibilityValidator.ignoredPackages"))
+      getListReactAndroidProperty("binaryCompatibilityValidator.ignoredPackages")
+  )
   ignoredClasses.addAll(getListReactAndroidProperty("binaryCompatibilityValidator.ignoredClasses"))
   nonPublicMarkers.addAll(
-      getListReactAndroidProperty("binaryCompatibilityValidator.nonPublicMarkers"))
+      getListReactAndroidProperty("binaryCompatibilityValidator.nonPublicMarkers")
+  )
   validationDisabled =
       reactAndroidProperties
           .getProperty("binaryCompatibilityValidator.validationDisabled")
@@ -36,8 +39,9 @@ apiValidation {
 }
 
 version =
-    if (project.hasProperty("isSnapshot") &&
-        (project.property("isSnapshot") as? String).toBoolean()) {
+    if (
+        project.hasProperty("isSnapshot") && (project.property("isSnapshot") as? String).toBoolean()
+    ) {
       "${reactAndroidProperties.getProperty("VERSION_NAME")}-SNAPSHOT"
     } else {
       reactAndroidProperties.getProperty("VERSION_NAME")
@@ -65,8 +69,10 @@ tasks.register("clean", Delete::class.java) {
   description = "Remove all the build files and intermediate build outputs"
   dependsOn(gradle.includedBuild("gradle-plugin").task(":clean"))
   subprojects.forEach {
-    if (it.project.plugins.hasPlugin("com.android.library") ||
-        it.project.plugins.hasPlugin("com.android.application")) {
+    if (
+        it.project.plugins.hasPlugin("com.android.library") ||
+            it.project.plugins.hasPlugin("com.android.application")
+    ) {
       dependsOn(it.tasks.named("clean"))
     }
   }
@@ -76,10 +82,13 @@ tasks.register("clean", Delete::class.java) {
   delete(rootProject.file("./packages/react-native/sdks/download/"))
   delete(rootProject.file("./packages/react-native/sdks/hermes/"))
   delete(
-      rootProject.file("./packages/react-native/ReactAndroid/src/main/jni/prebuilt/lib/arm64-v8a/"))
+      rootProject.file("./packages/react-native/ReactAndroid/src/main/jni/prebuilt/lib/arm64-v8a/")
+  )
   delete(
       rootProject.file(
-          "./packages/react-native/ReactAndroid/src/main/jni/prebuilt/lib/armeabi-v7a/"))
+          "./packages/react-native/ReactAndroid/src/main/jni/prebuilt/lib/armeabi-v7a/"
+      )
+  )
   delete(rootProject.file("./packages/react-native/ReactAndroid/src/main/jni/prebuilt/lib/x86/"))
   delete(rootProject.file("./packages/react-native/ReactAndroid/src/main/jni/prebuilt/lib/x86_64/"))
   delete(rootProject.file("./packages/react-native-codegen/lib"))
@@ -97,7 +106,8 @@ tasks.register("publishAllToMavenTempLocal") {
   dependsOn(":packages:react-native:ReactAndroid:publishAllPublicationsToMavenTempLocalRepository")
   // We don't publish the external-artifacts to Maven Local as ci is using it via workspace.
   dependsOn(
-      ":packages:react-native:ReactAndroid:hermes-engine:publishAllPublicationsToMavenTempLocalRepository")
+      ":packages:react-native:ReactAndroid:hermes-engine:publishAllPublicationsToMavenTempLocalRepository"
+  )
 }
 
 tasks.register("publishAndroidToSonatype") {
@@ -119,14 +129,55 @@ if (project.findProperty("react.internal.useHermesNightly")?.toString()?.toBoole
       That's fine for local development, but you should not commit this change.
       ********************************************************************************
   """
-          .trimIndent())
+          .trimIndent()
+  )
   allprojects {
     configurations.all {
       resolutionStrategy.dependencySubstitution {
         substitute(project(":packages:react-native:ReactAndroid:hermes-engine"))
-            .using(module("com.facebook.react:hermes-android:0.0.0-+"))
+            .using(module("com.facebook.react:hermes-android:0.+"))
             .because("Users opted to use hermes from nightly")
       }
     }
   }
 }
+
+ktfmt {
+  blockIndent.set(2)
+  continuationIndent.set(4)
+  maxWidth.set(100)
+  removeUnusedImports.set(false)
+  manageTrailingCommas.set(false)
+}
+
+// Configure ktfmt tasks to include gradle-plugin
+listOf("ktfmtCheck", "ktfmtFormat").forEach { taskName ->
+  tasks.named(taskName) { dependsOn(gradle.includedBuild("gradle-plugin").task(":$taskName")) }
+}
+
+allprojects {
+  // Apply exclusions for specific files that should not be formatted
+  val excludePatterns =
+      listOf(
+          "**/build/**",
+          "**/hermes-engine/**",
+          "**/internal/featureflags/**",
+          "**/systeminfo/ReactNativeVersion.kt",
+      )
+  listOf(
+          com.ncorti.ktfmt.gradle.tasks.KtfmtCheckTask::class,
+          com.ncorti.ktfmt.gradle.tasks.KtfmtFormatTask::class,
+      )
+      .forEach { tasks.withType(it) { exclude(excludePatterns) } }
+
+  // Disable the problematic ktfmt script tasks due to symbolic link issues in subprojects
+  afterEvaluate {
+    listOf("ktfmtCheckScripts", "ktfmtFormatScripts").forEach {
+      tasks.findByName(it)?.enabled = false
+    }
+  }
+}
+
+// We intentionally disable the `ktfmtCheck` tasks as the formatting is primarly handled inside
+// fbsource
+allprojects { tasks.withType<com.ncorti.ktfmt.gradle.tasks.KtfmtCheckTask>() { enabled = false } }

flow-typed/npm/electron-packager_v18.x.x.js

@@ -0,0 +1,149 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+declare module '@electron/packager' {
+  declare export type AsarOptions = $FlowFixMe;
+
+  declare export type ElectronDownloadRequestOptions = $FlowFixMe;
+
+  declare export type TargetDefinition = {
+    arch: TargetArch,
+    platform: TargetPlatform,
+  };
+
+  declare export type FinalizePackageTargetsHookFunction = (
+    targets: TargetDefinition[],
+    callback: HookFunctionErrorCallback,
+  ) => void;
+
+  declare export type HookFunction = (
+    buildPath: string,
+    electronVersion: string,
+    platform: TargetPlatform,
+    arch: TargetArch,
+    callback: HookFunctionErrorCallback,
+  ) => void;
+
+  declare export type IgnoreFunction = (path: string) => boolean;
+
+  declare export type HookFunctionErrorCallback = (err?: Error | null) => void;
+
+  declare export interface MacOSProtocol {
+    name: string;
+    schemes: string[];
+  }
+
+  declare export type NotaryToolCredentials = $FlowFixMe;
+
+  declare export type OsxSignOptions = $FlowFixMe;
+
+  declare export type OsxUniversalOptions = $FlowFixMe;
+
+  declare export type Win32MetadataOptions = $ReadOnly<{
+    CompanyName?: string,
+    FileDescription?: string,
+    OriginalFilename?: string,
+    ProductName?: string,
+    InternalName?: string,
+    'requested-execution-level'?:
+      | 'asInvoker'
+      | 'highestAvailable'
+      | 'requireAdministrator',
+    'application-manifest'?: string,
+  }>;
+
+  declare export type WindowsSignOptions = $FlowFixMe;
+
+  declare export type OfficialArch =
+    | 'ia32'
+    | 'x64'
+    | 'armv7l'
+    | 'arm64'
+    | 'mips64el'
+    | 'universal';
+
+  declare export type OfficialPlatform = 'linux' | 'win32' | 'darwin' | 'mas';
+
+  declare export type TargetArch = OfficialArch | string;
+
+  declare export type TargetPlatform = OfficialPlatform | string;
+
+  declare export type ArchOption = TargetArch | 'all';
+
+  declare export type PlatformOption = TargetPlatform | 'all';
+
+  declare export interface Options {
+    dir: string;
+    afterAsar?: HookFunction[];
+    afterComplete?: HookFunction[];
+    afterCopy?: HookFunction[];
+    afterCopyExtraResources?: HookFunction[];
+    afterExtract?: HookFunction[];
+    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
+    afterInitialize?: HookFunction[];
+    afterPrune?: HookFunction[];
+    all?: boolean;
+    appBundleId?: string;
+    appCategoryType?: string;
+    appCopyright?: string;
+    appVersion?: string;
+    arch?: ArchOption | ArchOption[];
+    asar?: boolean | AsarOptions;
+    beforeAsar?: HookFunction[];
+    beforeCopy?: HookFunction[];
+    beforeCopyExtraResources?: HookFunction[];
+    buildVersion?: string;
+    darwinDarkModeSupport?: boolean;
+    derefSymlinks?: boolean;
+    download?: ElectronDownloadRequestOptions;
+    electronVersion?: string;
+    electronZipDir?: string;
+    executableName?: string;
+    extendHelperInfo?:
+      | string
+      | {
+          [property: string]: any,
+        };
+    extendInfo?:
+      | string
+      | {
+          [property: string]: any,
+        };
+    extraResource?: string | string[];
+    helperBundleId?: string;
+    icon?: string;
+    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
+    junk?: boolean;
+    name?: string;
+    osxNotarize?: NotaryToolCredentials;
+    osxSign?: true | OsxSignOptions;
+    osxUniversal?: OsxUniversalOptions;
+    out?: string;
+    overwrite?: boolean;
+    platform?: TargetPlatform | 'all' | Array<TargetPlatform | 'all'>;
+    prebuiltAsar?: string;
+    protocols?: MacOSProtocol[];
+    prune?: boolean;
+    quiet?: boolean;
+    tmpdir?: string | false;
+    usageDescription?: {
+      [property: string]: string,
+    };
+    win32metadata?: Win32MetadataOptions;
+    windowsSign?: true | WindowsSignOptions;
+  }
+
+  declare function packager(options: Options): Promise<string[]>;
+
+  declare module.exports: typeof packager & {
+    packager: typeof packager,
+    default: typeof packager,
+  };
+}

flow-typed/npm/tinybench_v4.1.x.js

@@ -91,7 +91,19 @@ declare module 'tinybench' {
     beforeEach?: (this: Task) => void | Promise<void>,
   };
 
-  export type Fn = () => Promise<mixed> | mixed;
+  // This is defined as an interface in tinybench but we define it as an object
+  // to catch problems like `overriddenDuration` being misspelled.
+  export type FnReturnedObject = {
+    overriddenDuration?: number,
+  };
+
+  // This type is defined as returning `unknown` instead of `void` in tinybench,
+  // but we type it this way to avoid mistakes (we can make breaking changes
+  // in our definition that they can't).
+  export type Fn = () =>
+    | Promise<void | FnReturnedObject>
+    | void
+    | FnReturnedObject;
 
   declare export class Bench extends EventTarget {
     concurrency: null | 'task' | 'bench';

flow-typed/npm/ws_v7.x.x.js

@@ -21,7 +21,7 @@ declare type ws$PerMessageDeflateOptions = {
   maxPayload?: number,
 };
 
-/* $FlowFixMe[incompatible-extend] - Found with Flow v0.143.1 upgrade
+/* $FlowFixMe[incompatible-type] - Found with Flow v0.143.1 upgrade
  * "on" definition failing with string is incompatible with string literal */
 declare class ws$WebSocketServer extends events$EventEmitter {
   /**
@@ -141,7 +141,7 @@ declare type ws$UnexpectedResponseListener = (
 ) => mixed;
 declare type ws$UpgradeListener = (response: http$IncomingMessage<>) => mixed;
 
-/* $FlowFixMe[incompatible-extend] - Found with Flow v0.143.1 upgrade
+/* $FlowFixMe[incompatible-type] - Found with Flow v0.143.1 upgrade
  * "on" definition failing with string is incompatible with string literal */
 declare class ws$WebSocket extends events$EventEmitter {
   static Server: typeof ws$WebSocketServer;

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.0.0-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

gradlew

@@ -1,7 +1,7 @@
 #!/bin/sh
 
 #
-# Copyright © 2015-2021 the original authors.
+# Copyright © 2015 the original authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

jest/preprocessor.js

@@ -32,7 +32,7 @@ if (process.env.FBSOURCE_ENV === '1') {
   require('@fb-tools/babel-register');
 } else {
   // Register Babel to allow local packages to be loaded from source
-  require('../scripts/babel-register').registerForMonorepo();
+  require('../scripts/shared/babelRegister').registerForMonorepo();
 }
 
 const transformer = require('@react-native/metro-babel-transformer');
@@ -86,7 +86,7 @@ module.exports = {
         globalPrefix: '',
         hermesParser: true,
         hot: false,
-        // $FlowFixMe[incompatible-call] TODO: Remove when `inlineRequires` has been removed from metro-babel-transformer in OSS
+        // $FlowFixMe[incompatible-type] TODO: Remove when `inlineRequires` has been removed from metro-babel-transformer in OSS
         inlineRequires: true,
         minify: false,
         platform: '',
@@ -111,7 +111,7 @@ module.exports = {
 
     return generate(
       ast,
-      // $FlowFixMe[prop-missing] Error found when improving flow typing for libs
+      // $FlowFixMe[incompatible-type] Error found when improving flow typing for libs
       {
         code: true,
         comments: false,

package.json

@@ -8,15 +8,19 @@
     "android": "yarn --cwd packages/rn-tester android",
     "build-android": "./gradlew :packages:react-native:ReactAndroid:build",
     "build": "node ./scripts/build/build.js",
-    "build-types": "node ./scripts/build-types",
+    "build-types": "node ./scripts/js-api/build-types",
     "clang-format": "clang-format -i --glob=*/**/*.{h,cpp,m,mm}",
     "clean": "node ./scripts/build/clean.js",
+    "cxx-api-build": "node ./scripts/cxx-api/public-api.js",
     "flow-check": "flow check",
     "flow": "flow",
     "format-check": "prettier --list-different \"./**/*.{js,md,yml,ts,tsx}\"",
     "format": "npm run prettier && npm run clang-format",
     "featureflags": "yarn --cwd packages/react-native featureflags",
+    "js-api-diff": "node ./scripts/js-api/diff-api-snapshot",
     "lint-ci": "./.github/workflow-scripts/analyze_code.sh && yarn shellcheck",
+    "lint-kotlin-check": "./gradlew ktfmtCheck",
+    "lint-kotlin": "./gradlew ktfmtFormat",
     "lint-markdown": "markdownlint-cli2 2>&1",
     "lint": "eslint --max-warnings 0 .",
     "prettier": "prettier --write \"./**/*.{js,md,yml,ts,tsx}\"",
@@ -26,13 +30,13 @@
     "set-version": "node ./scripts/releases/set-version.js",
     "test-android": "./gradlew :packages:react-native:ReactAndroid:test",
     "test-ci": "jest --maxWorkers=2 --ci --reporters=\"default\" --reporters=\"jest-junit\"",
-    "test-e2e-local-clean": "node ./scripts/release-testing/test-e2e-local-clean.js",
-    "test-e2e-local": "node ./scripts/release-testing/test-e2e-local.js",
+    "test-release-local-clean": "node ./scripts/release-testing/test-release-local-clean.js",
+    "test-release-local": "node ./scripts/release-testing/test-release-local.js",
     "test-ios": "./scripts/objc-test.sh test",
     "test-typescript": "tsc -p packages/react-native/types/tsconfig.json",
     "test-generated-typescript": "tsc -p packages/react-native/types_generated/tsconfig.test.json",
     "test": "jest",
-    "fantom": "JS_DIR='..' yarn jest --config private/react-native-fantom/config/jest.config.js",
+    "fantom": "./scripts/fantom.sh",
     "trigger-react-native-release": "node ./scripts/releases-local/trigger-react-native-release.js",
     "update-lock": "npx yarn-deduplicate"
   },
@@ -49,16 +53,17 @@
     "@babel/plugin-transform-regenerator": "^7.24.7",
     "@babel/preset-env": "^7.25.3",
     "@babel/preset-flow": "^7.24.7",
+    "@electron/packager": "^18.3.6",
     "@jest/create-cache-key-function": "^29.7.0",
     "@microsoft/api-extractor": "^7.52.2",
-    "@react-native/metro-babel-transformer": "0.80.0-main",
-    "@react-native/metro-config": "0.80.0-main",
+    "@react-native/metro-babel-transformer": "0.82.0-main",
+    "@react-native/metro-config": "0.82.0-main",
     "@tsconfig/node22": "22.0.2",
     "@types/react": "^19.1.0",
-    "@typescript-eslint/parser": "^7.1.1",
+    "@typescript-eslint/parser": "^8.36.0",
     "ansi-styles": "^4.2.1",
     "babel-plugin-minify-dead-code-elimination": "^0.5.2",
-    "babel-plugin-syntax-hermes-parser": "0.28.1",
+    "babel-plugin-syntax-hermes-parser": "0.32.0",
     "babel-plugin-transform-define": "^2.1.4",
     "babel-plugin-transform-flow-enums": "^0.0.2",
     "clang-format": "^1.8.0",
@@ -70,17 +75,18 @@
     "eslint-plugin-babel": "^5.3.1",
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-ft-flow": "^2.0.1",
-    "eslint-plugin-jest": "^27.9.0",
+    "eslint-plugin-jest": "^29.0.1",
     "eslint-plugin-jsx-a11y": "^6.6.0",
     "eslint-plugin-react": "^7.30.1",
     "eslint-plugin-react-native": "^4.0.0",
     "eslint-plugin-redundant-undefined": "^0.4.0",
     "eslint-plugin-relay": "^1.8.3",
-    "flow-api-translator": "0.28.1",
-    "flow-bin": "^0.273.1",
+    "flow-api-translator": "0.32.0",
+    "flow-bin": "^0.279.0",
     "glob": "^7.1.1",
-    "hermes-eslint": "0.28.1",
-    "hermes-transform": "0.28.1",
+    "hermes-eslint": "0.32.0",
+    "hermes-transform": "0.32.0",
+    "ini": "^5.0.0",
     "inquirer": "^7.1.0",
     "jest": "^29.7.0",
     "jest-config": "^29.7.0",
@@ -89,27 +95,29 @@
     "jest-snapshot": "^29.7.0",
     "markdownlint-cli2": "^0.17.2",
     "markdownlint-rule-relative-links": "^3.0.0",
-    "metro-babel-register": "^0.82.4",
-    "metro-memory-fs": "^0.82.4",
-    "metro-transform-plugins": "^0.82.4",
+    "memfs": "^4.7.7",
+    "metro-babel-register": "^0.83.1",
+    "metro-transform-plugins": "^0.83.1",
     "micromatch": "^4.0.4",
     "node-fetch": "^2.2.0",
     "nullthrows": "^1.1.1",
-    "prettier": "2.8.8",
-    "prettier-plugin-hermes-parser": "0.28.1",
-    "react": "19.1.0",
-    "react-test-renderer": "19.1.0",
+    "prettier": "3.6.2",
+    "prettier-plugin-hermes-parser": "0.32.0",
+    "react": "19.1.1",
+    "react-test-renderer": "19.1.1",
     "rimraf": "^3.0.2",
     "shelljs": "^0.8.5",
     "signedsource": "^1.0.0",
     "supports-color": "^7.1.0",
     "temp-dir": "^2.0.0",
-    "tinybench": "^3.1.0",
+    "tinybench": "^4.1.0",
     "typescript": "5.8.3",
     "ws": "^6.2.3"
   },
   "resolutions": {
     "eslint-plugin-react-hooks": "6.1.0-canary-12bc60f5-20250613",
-    "react-is": "19.1.0"
+    "react-is": "19.1.1",
+    "on-headers": "1.1.0",
+    "compression": "1.8.1"
   }
 }

packages/assets/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/assets-registry",
-  "version": "0.80.0-main",
+  "version": "0.82.0-main",
   "description": "Asset support code for React Native.",
   "license": "MIT",
   "repository": {
@@ -17,7 +17,7 @@
   ],
   "bugs": "https://github.com/facebook/react-native/issues",
   "engines": {
-    "node": ">= 22.14.0"
+    "node": ">= 20.19.4"
   },
   "files": [
     "path-support.js",

packages/babel-plugin-codegen/__test_fixtures__/failures.js

@@ -81,10 +81,147 @@ export {Commands};
 export default (codegenNativeComponent<ModuleProps>('Module'): NativeType);
 `;
 
+const COMMANDS_WITH_COVERAGE_INVALID = `
+// @flow
+
+const codegenNativeComponent = require('codegenNativeComponent');
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+import type {ViewProps} from 'ViewPropTypes';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+// Coverage instrumentation of invalid Commands export - should still fail
+export const Commands = (cov_1234567890().s[0]++, {
+  hotspotUpdate: () => {},
+  scrollTo: () => {},
+});
+
+export default (codegenNativeComponent<ModuleProps>('Module'): NativeType);
+`;
+
+const COMMANDS_WITH_COVERAGE_WRONG_FUNCTION = `
+// @flow
+
+const codegenNativeComponent = require('codegenNativeComponent');
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+import type {ViewProps} from 'ViewPropTypes';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+// Coverage instrumentation of wrong function call - should fail
+export const Commands = (cov_abcdef123().s[0]++, someOtherFunction({
+  supportedCommands: ['pause', 'play'],
+}));
+
+export default (codegenNativeComponent<ModuleProps>('Module'): NativeType);
+`;
+
+const COMMANDS_WITH_COMPLEX_COVERAGE_INVALID = `
+// @flow
+
+const codegenNativeComponent = require('codegenNativeComponent');
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+import type {ViewProps} from 'ViewPropTypes';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+// Complex coverage instrumentation with invalid nested structure - should fail
+export const Commands = (
+  cov_xyz789().f[1]++,
+  cov_xyz789().s[2]++,
+  {
+    pause: (ref) => {},
+    play: (ref) => {},
+  }
+);
+
+export default (codegenNativeComponent<ModuleProps>('Module'): NativeType);
+`;
+
+const COMMANDS_WITH_COVERAGE_WRONG_NAME = `
+// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+import type {ViewProps} from 'ViewPropTypes';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+interface NativeCommands {
+  +pause: (viewRef: React.ElementRef<NativeType>) => void;
+  +play: (viewRef: React.ElementRef<NativeType>) => void;
+}
+
+// Coverage instrumentation with correct function but wrong export name - should fail
+export const WrongName = (cov_wrong123().s[0]++, codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['pause', 'play'],
+}));
+
+export default (codegenNativeComponent<ModuleProps>('Module'): NativeType);
+`;
+
+const COMMANDS_WITH_COVERAGE_TYPE_CAST_INVALID = `
+// @flow
+
+const codegenNativeComponent = require('codegenNativeComponent');
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+import type {ViewProps} from 'ViewPropTypes';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+interface NativeCommands {
+  +pause: (viewRef: React.ElementRef<NativeType>) => void;
+  +play: (viewRef: React.ElementRef<NativeType>) => void;
+}
+
+// Coverage instrumentation with type cast but wrong function - should fail
+export const Commands: NativeCommands = (cov_cast123().s[0]++, invalidFunction({
+  supportedCommands: ['pause', 'play'],
+}));
+
+export default (codegenNativeComponent<ModuleProps>('Module'): NativeType);
+`;
+
 module.exports = {
   'CommandsExportedWithDifferentNameNativeComponent.js':
     COMMANDS_EXPORTED_WITH_DIFFERENT_NAME,
   'CommandsExportedWithShorthandNativeComponent.js':
     COMMANDS_EXPORTED_WITH_SHORTHAND,
   'OtherCommandsExportNativeComponent.js': OTHER_COMMANDS_EXPORT,
+  'CommandsWithCoverageInvalidNativeComponent.js':
+    COMMANDS_WITH_COVERAGE_INVALID,
+  'CommandsWithCoverageWrongFunctionNativeComponent.js':
+    COMMANDS_WITH_COVERAGE_WRONG_FUNCTION,
+  'CommandsWithComplexCoverageInvalidNativeComponent.js':
+    COMMANDS_WITH_COMPLEX_COVERAGE_INVALID,
+  'CommandsWithCoverageWrongNameNativeComponent.js':
+    COMMANDS_WITH_COVERAGE_WRONG_NAME,
+  'CommandsWithCoverageTypeCastInvalidNativeComponent.js':
+    COMMANDS_WITH_COVERAGE_TYPE_CAST_INVALID,
 };

packages/babel-plugin-codegen/__test_fixtures__/fixtures.js

@@ -59,6 +59,92 @@ export default codegenNativeComponent<ModuleProps>('Module', {
 });
 `;
 
+// Coverage instrumentation test cases - should be recognized as valid
+const COMMANDS_WITH_SIMPLE_COVERAGE = `
+// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+
+import type {ViewProps} from 'ViewPropTypes';
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+interface NativeCommands {
+  +pause: (viewRef: React.ElementRef<NativeType>) => void;
+  +play: (viewRef: React.ElementRef<NativeType>) => void;
+}
+
+export const Commands = (cov_1234567890.s[0]++, codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['pause', 'play'],
+}));
+
+export default codegenNativeComponent<ModuleProps>('Module');
+`;
+
+const COMMANDS_WITH_COMPLEX_COVERAGE = `
+// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+
+import type {ViewProps} from 'ViewPropTypes';
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+interface NativeCommands {
+  +seek: (viewRef: React.ElementRef<NativeType>, position: number) => void;
+  +stop: (viewRef: React.ElementRef<NativeType>) => void;
+}
+
+export const Commands = (
+  cov_abcdef123().f[2]++,
+  cov_abcdef123().s[5]++,
+  codegenNativeCommands<NativeCommands>({
+    supportedCommands: ['seek', 'stop'],
+  })
+);
+
+export default codegenNativeComponent<ModuleProps>('Module');
+`;
+
+const COMMANDS_WITH_TYPE_CAST_COVERAGE = `
+// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+
+import type {ViewProps} from 'ViewPropTypes';
+import type {NativeComponentType} from 'codegenNativeComponent';
+
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps,
+|}>;
+
+type NativeType = NativeComponentType<ModuleProps>;
+
+interface NativeCommands {
+  +mute: (viewRef: React.ElementRef<NativeType>) => void;
+  +unmute: (viewRef: React.ElementRef<NativeType>) => void;
+}
+
+export const Commands: NativeCommands = (cov_xyz789().s[1]++, codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['mute', 'unmute'],
+}));
+
+export default codegenNativeComponent<ModuleProps>('Module');
+`;
+
 const FULL_NATIVE_COMPONENT_WITH_TYPE_EXPORT = `
 // @flow
 
@@ -107,4 +193,9 @@ module.exports = {
   'NotANativeComponent.js': NOT_A_NATIVE_COMPONENT,
   'FullNativeComponent.js': FULL_NATIVE_COMPONENT,
   'FullTypedNativeComponent.js': FULL_NATIVE_COMPONENT_WITH_TYPE_EXPORT,
+  'CommandsWithSimpleCoverageNativeComponent.js': COMMANDS_WITH_SIMPLE_COVERAGE,
+  'CommandsWithComplexCoverageNativeComponent.js':
+    COMMANDS_WITH_COMPLEX_COVERAGE,
+  'CommandsWithTypeCastCoverageNativeComponent.js':
+    COMMANDS_WITH_TYPE_CAST_COVERAGE,
 };

packages/babel-plugin-codegen/__tests__/__snapshots__/index-test.js.snap

@@ -1,5 +1,77 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`Babel plugin inline view configs can inline config for CommandsWithComplexCoverageNativeComponent.js 1`] = `
+"// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+import type { ViewProps } from 'ViewPropTypes';
+import type { NativeComponentType } from 'codegenNativeComponent';
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps
+|}>;
+type NativeType = NativeComponentType<ModuleProps>;
+interface NativeCommands {
+  +seek: (viewRef: React.ElementRef<NativeType>, position: number) => void,
+  +stop: (viewRef: React.ElementRef<NativeType>) => void,
+}
+const NativeComponentRegistry = require('react-native/Libraries/NativeComponent/NativeComponentRegistry');
+let nativeComponentName = 'Module';
+export const __INTERNAL_VIEW_CONFIG = {
+  uiViewClassName: \\"Module\\",
+  validAttributes: {}
+};
+export default NativeComponentRegistry.get(nativeComponentName, () => __INTERNAL_VIEW_CONFIG);"
+`;
+
+exports[`Babel plugin inline view configs can inline config for CommandsWithSimpleCoverageNativeComponent.js 1`] = `
+"// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+import type { ViewProps } from 'ViewPropTypes';
+import type { NativeComponentType } from 'codegenNativeComponent';
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps
+|}>;
+type NativeType = NativeComponentType<ModuleProps>;
+interface NativeCommands {
+  +pause: (viewRef: React.ElementRef<NativeType>) => void,
+  +play: (viewRef: React.ElementRef<NativeType>) => void,
+}
+const NativeComponentRegistry = require('react-native/Libraries/NativeComponent/NativeComponentRegistry');
+let nativeComponentName = 'Module';
+export const __INTERNAL_VIEW_CONFIG = {
+  uiViewClassName: \\"Module\\",
+  validAttributes: {}
+};
+export default NativeComponentRegistry.get(nativeComponentName, () => __INTERNAL_VIEW_CONFIG);"
+`;
+
+exports[`Babel plugin inline view configs can inline config for CommandsWithTypeCastCoverageNativeComponent.js 1`] = `
+"// @flow
+
+const codegenNativeCommands = require('codegenNativeCommands');
+const codegenNativeComponent = require('codegenNativeComponent');
+import type { ViewProps } from 'ViewPropTypes';
+import type { NativeComponentType } from 'codegenNativeComponent';
+type ModuleProps = $ReadOnly<{|
+  ...ViewProps
+|}>;
+type NativeType = NativeComponentType<ModuleProps>;
+interface NativeCommands {
+  +mute: (viewRef: React.ElementRef<NativeType>) => void,
+  +unmute: (viewRef: React.ElementRef<NativeType>) => void,
+}
+const NativeComponentRegistry = require('react-native/Libraries/NativeComponent/NativeComponentRegistry');
+let nativeComponentName = 'Module';
+export const __INTERNAL_VIEW_CONFIG = {
+  uiViewClassName: \\"Module\\",
+  validAttributes: {}
+};
+export default NativeComponentRegistry.get(nativeComponentName, () => __INTERNAL_VIEW_CONFIG);"
+`;
+
 exports[`Babel plugin inline view configs can inline config for FullNativeComponent.js 1`] = `
 "// @flow
 
@@ -153,6 +225,61 @@ exports[`Babel plugin inline view configs fails on inline config for CommandsExp
   24 |"
 `;
 
+exports[`Babel plugin inline view configs fails on inline config for CommandsWithComplexCoverageInvalidNativeComponent.js 1`] = `
+"/CommandsWithComplexCoverageInvalidNativeComponent.js: 'Commands' is a reserved export and may only be used to export the result of codegenNativeCommands.
+  14 |
+  15 | // Complex coverage instrumentation with invalid nested structure - should fail
+> 16 | export const Commands = (
+     | ^
+  17 |   cov_xyz789().f[1]++,
+  18 |   cov_xyz789().s[2]++,
+  19 |   {"
+`;
+
+exports[`Babel plugin inline view configs fails on inline config for CommandsWithCoverageInvalidNativeComponent.js 1`] = `
+"/CommandsWithCoverageInvalidNativeComponent.js: 'Commands' is a reserved export and may only be used to export the result of codegenNativeCommands.
+  14 |
+  15 | // Coverage instrumentation of invalid Commands export - should still fail
+> 16 | export const Commands = (cov_1234567890().s[0]++, {
+     | ^
+  17 |   hotspotUpdate: () => {},
+  18 |   scrollTo: () => {},
+  19 | });"
+`;
+
+exports[`Babel plugin inline view configs fails on inline config for CommandsWithCoverageTypeCastInvalidNativeComponent.js 1`] = `
+"/CommandsWithCoverageTypeCastInvalidNativeComponent.js: 'Commands' is a reserved export and may only be used to export the result of codegenNativeCommands.
+  19 |
+  20 | // Coverage instrumentation with type cast but wrong function - should fail
+> 21 | export const Commands: NativeCommands = (cov_cast123().s[0]++, invalidFunction({
+     | ^
+  22 |   supportedCommands: ['pause', 'play'],
+  23 | }));
+  24 |"
+`;
+
+exports[`Babel plugin inline view configs fails on inline config for CommandsWithCoverageWrongFunctionNativeComponent.js 1`] = `
+"/CommandsWithCoverageWrongFunctionNativeComponent.js: 'Commands' is a reserved export and may only be used to export the result of codegenNativeCommands.
+  14 |
+  15 | // Coverage instrumentation of wrong function call - should fail
+> 16 | export const Commands = (cov_abcdef123().s[0]++, someOtherFunction({
+     | ^
+  17 |   supportedCommands: ['pause', 'play'],
+  18 | }));
+  19 |"
+`;
+
+exports[`Babel plugin inline view configs fails on inline config for CommandsWithCoverageWrongNameNativeComponent.js 1`] = `
+"/CommandsWithCoverageWrongNameNativeComponent.js: Native commands must be exported with the name 'Commands'
+  20 |
+  21 | // Coverage instrumentation with correct function but wrong export name - should fail
+> 22 | export const WrongName = (cov_wrong123().s[0]++, codegenNativeCommands<NativeCommands>({
+     | ^
+  23 |   supportedCommands: ['pause', 'play'],
+  24 | }));
+  25 |"
+`;
+
 exports[`Babel plugin inline view configs fails on inline config for OtherCommandsExportNativeComponent.js 1`] = `
 "/OtherCommandsExportNativeComponent.js: 'Commands' is a reserved export and may only be used to export the result of codegenNativeCommands.
   17 | }

packages/babel-plugin-codegen/index.js

@@ -24,12 +24,12 @@ try {
 } catch (e) {
   // Fallback to lib when source doesn't exit (e.g. when installed as a dev dependency)
   FlowParser =
-    // $FlowIgnore[cannot-resolve-module]
+    // $FlowFixMe[cannot-resolve-module]
     require('@react-native/codegen/lib/parsers/flow/parser').FlowParser;
   TypeScriptParser =
-    // $FlowIgnore[cannot-resolve-module]
+    // $FlowFixMe[cannot-resolve-module]
     require('@react-native/codegen/lib/parsers/typescript/parser').TypeScriptParser;
-  // $FlowIgnore[cannot-resolve-module]
+  // $FlowFixMe[cannot-resolve-module]
   RNCodegen = require('@react-native/codegen/lib/generators/RNCodegen');
 }
 
@@ -102,6 +102,58 @@ function isCodegenDeclaration(declaration) {
   return false;
 }
 
+function isCodegenNativeCommandsDeclaration(declaration) {
+  if (!declaration) {
+    return false;
+  }
+
+  // Handle direct calls: codegenNativeCommands()
+  if (
+    declaration.type === 'CallExpression' &&
+    declaration.callee &&
+    declaration.callee.type === 'Identifier' &&
+    declaration.callee.name === 'codegenNativeCommands'
+  ) {
+    return true;
+  }
+
+  // Handle coverage instrumentation: (cov_xxx().s[0]++, codegenNativeCommands())
+  if (declaration.type === 'SequenceExpression' && declaration.expressions) {
+    // Get the last expression in the sequence (the actual function call)
+    const lastExpression =
+      declaration.expressions[declaration.expressions.length - 1];
+    // Recursively check if the last expression is a valid codegenNativeCommands call
+    return isCodegenNativeCommandsDeclaration(lastExpression);
+  }
+
+  // Handle Flow type casts: (codegenNativeCommands(): NativeCommands)
+  if (
+    (declaration.type === 'TypeCastExpression' ||
+      declaration.type === 'AsExpression') &&
+    declaration.expression &&
+    declaration.expression.type === 'CallExpression' &&
+    declaration.expression.callee &&
+    declaration.expression.callee.type === 'Identifier' &&
+    declaration.expression.callee.name === 'codegenNativeCommands'
+  ) {
+    return true;
+  }
+
+  // Handle TypeScript assertions: codegenNativeCommands() as NativeCommands
+  if (
+    declaration.type === 'TSAsExpression' &&
+    declaration.expression &&
+    declaration.expression.type === 'CallExpression' &&
+    declaration.expression.callee &&
+    declaration.expression.callee.type === 'Identifier' &&
+    declaration.expression.callee.name === 'codegenNativeCommands'
+  ) {
+    return true;
+  }
+
+  return false;
+}
+
 module.exports = function ({parse, types: t}) {
   return {
     pre(state) {
@@ -125,12 +177,12 @@ module.exports = function ({parse, types: t}) {
           const firstDeclaration = path.node.declaration.declarations[0];
 
           if (firstDeclaration.type === 'VariableDeclarator') {
-            if (
-              firstDeclaration.init &&
-              firstDeclaration.init.type === 'CallExpression' &&
-              firstDeclaration.init.callee.type === 'Identifier' &&
-              firstDeclaration.init.callee.name === 'codegenNativeCommands'
-            ) {
+            // Check if this is a valid codegenNativeCommands call, handling type annotations
+            const isValidCommandsExport = isCodegenNativeCommandsDeclaration(
+              firstDeclaration.init,
+            );
+
+            if (isValidCommandsExport) {
               if (
                 firstDeclaration.id.type === 'Identifier' &&
                 firstDeclaration.id.name !== 'Commands'

packages/babel-plugin-codegen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/babel-plugin-codegen",
-  "version": "0.80.0-main",
+  "version": "0.82.0-main",
   "description": "Babel plugin to generate native module and view manager code for React Native.",
   "license": "MIT",
   "repository": {
@@ -19,14 +19,14 @@
   ],
   "bugs": "https://github.com/facebook/react-native/issues",
   "engines": {
-    "node": ">= 22.14.0"
+    "node": ">= 20.19.4"
   },
   "files": [
     "index.js"
   ],
   "dependencies": {
     "@babel/traverse": "^7.25.3",
-    "@react-native/codegen": "0.80.0-main"
+    "@react-native/codegen": "0.82.0-main"
   },
   "devDependencies": {
     "@babel/core": "^7.25.2"

packages/community-cli-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/community-cli-plugin",
-  "version": "0.80.0-main",
+  "version": "0.82.0-main",
   "description": "Core CLI commands for React Native",
   "keywords": [
     "react-native",
@@ -22,16 +22,16 @@
     "dist"
   ],
   "dependencies": {
-    "@react-native/dev-middleware": "0.80.0-main",
+    "@react-native/dev-middleware": "0.82.0-main",
     "debug": "^4.4.0",
     "invariant": "^2.2.4",
-    "metro": "^0.82.4",
-    "metro-config": "^0.82.4",
-    "metro-core": "^0.82.4",
+    "metro": "^0.83.1",
+    "metro-config": "^0.83.1",
+    "metro-core": "^0.83.1",
     "semver": "^7.1.3"
   },
   "devDependencies": {
-    "metro-resolver": "^0.82.4"
+    "metro-resolver": "^0.83.1"
   },
   "peerDependencies": {
     "@react-native-community/cli": "*",
@@ -40,9 +40,12 @@
   "peerDependenciesMeta": {
     "@react-native-community/cli": {
       "optional": true
+    },
+    "@react-native/metro-config": {
+      "optional": true
     }
   },
   "engines": {
-    "node": ">= 22.14.0"
+    "node": ">= 20.19.4"
   }
 }

packages/community-cli-plugin/src/commands/bundle/saveAssets.js

@@ -116,7 +116,7 @@ function copyAll(filesToCopy: CopiedFiles) {
         const src = queue.shift();
         // $FlowFixMe[incompatible-type]
         const dest = filesToCopy[src];
-        // $FlowFixMe[incompatible-call]
+        // $FlowFixMe[incompatible-type]
         copy(src, dest, copyNext);
       }
     };

packages/community-cli-plugin/src/commands/start/middleware.js

@@ -31,9 +31,9 @@ type MiddlewareReturn = {
   ...
 };
 
-// $FlowFixMe
+// $FlowFixMe[incompatible-type]
 const unusedStubWSServer: ws$WebSocketServer = {};
-// $FlowFixMe
+// $FlowFixMe[incompatible-type]
 const unusedMiddlewareStub: Server = {};
 
 const communityMiddlewareFallback = {
@@ -80,7 +80,7 @@ try {
     '@react-native-community/cli-server-api',
     {paths: [communityCliPath]},
   );
-  // $FlowIgnore[unsupported-syntax] dynamic import
+  // $FlowFixMe[unsupported-syntax] dynamic import
   communityMiddlewareFallback.createDevServerMiddleware = require(
     communityCliServerApiPath,
   ).createDevServerMiddleware as CreateDevServerMiddleware;

packages/community-cli-plugin/src/commands/start/runServer.js

@@ -92,14 +92,14 @@ async function runServer(
   console.info(`Starting dev server on ${devServerUrl}\n`);
 
   if (args.assetPlugins) {
-    // $FlowIgnore[cannot-write] Assigning to readonly property
+    // $FlowFixMe[cannot-write] Assigning to readonly property
     metroConfig.transformer.assetPlugins = args.assetPlugins.map(plugin =>
       require.resolve(plugin),
     );
   }
   // TODO(T214991636): Remove legacy Metro log forwarding
   if (!args.clientLogs) {
-    // $FlowIgnore[cannot-write] Assigning to readonly property
+    // $FlowFixMe[cannot-write] Assigning to readonly property
     metroConfig.server.forwardClientLogs = false;
   }
 
@@ -127,6 +127,8 @@ async function runServer(
   const reporter: Reporter = {
     update(event: TerminalReportableEvent) {
       terminalReporter.update(event);
+      /* $FlowFixMe[constant-condition] Error discovered during Constant
+       * Condition roll out. See https://fburl.com/workplace/1v97vimq. */
       if (reportEvent) {
         reportEvent(event);
       }
@@ -144,10 +146,10 @@ async function runServer(
       }
     },
   };
-  // $FlowIgnore[cannot-write] Assigning to readonly property
+  // $FlowFixMe[cannot-write] Assigning to readonly property
   metroConfig.reporter = reporter;
 
-  const serverInstance = await Metro.runServer(metroConfig, {
+  await Metro.runServer(metroConfig, {
     host: args.host,
     secure: args.https,
     secureCert: args.cert,
@@ -161,18 +163,6 @@ async function runServer(
 
   reportEvent = eventsSocketEndpoint.reportEvent;
 
-  // In Node 8, the default keep-alive for an HTTP connection is 5 seconds. In
-  // early versions of Node 8, this was implemented in a buggy way which caused
-  // some HTTP responses (like those containing large JS bundles) to be
-  // terminated early.
-  //
-  // As a workaround, arbitrarily increase the keep-alive from 5 to 30 seconds,
-  // which should be enough to send even the largest of JS bundles.
-  //
-  // For more info: https://github.com/nodejs/node/issues/13391
-  //
-  serverInstance.keepAliveTimeout = 30000;
-
   await version.logIfUpdateAvailable(cliConfig, terminalReporter);
 }
 
@@ -185,7 +175,7 @@ function getReporterImpl(
   try {
     // First we let require resolve it, so we can require packages in node_modules
     // as expected. eg: require('my-package/reporter');
-    // $FlowIgnore[unsupported-syntax]
+    // $FlowFixMe[unsupported-syntax]
     return require(customLogReporterPath);
   } catch (e) {
     if (e.code !== 'MODULE_NOT_FOUND') {
@@ -193,7 +183,7 @@ function getReporterImpl(
     }
     // If that doesn't work, then we next try relative to the cwd, eg:
     // require('./reporter');
-    // $FlowIgnore[unsupported-syntax]
+    // $FlowFixMe[unsupported-syntax]
     return require(path.resolve(customLogReporterPath));
   }
 }

packages/community-cli-plugin/src/index.js

@@ -13,7 +13,7 @@ export type * from './index.flow';
 */
 
 if (!process.env.BUILD_EXCLUDE_BABEL_REGISTER) {
-  require('../../../scripts/babel-register').registerForMonorepo();
+  require('../../../scripts/shared/babelRegister').registerForMonorepo();
 }
 
 module.exports = require('./index.flow');

packages/community-cli-plugin/src/utils/version.js

@@ -153,7 +153,7 @@ function buildDiffUrl(oldVersion: string, newVersion: string) {
  * Returns the most recent React Native version available to upgrade to.
  */
 async function getLatestRnDiffPurgeVersion(): Promise<LatestVersions | void> {
-  const options = {
+  const options: RequestOptions = {
     // https://developer.github.com/v3/#user-agent-required
     headers: {'User-Agent': '@react-native/community-cli-plugin'} as Headers,
   };

packages/core-cli-utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/core-cli-utils",
-  "version": "0.80.0-main",
+  "version": "0.82.0-main",
   "description": "React Native CLI library for Frameworks to build on",
   "license": "MIT",
   "main": "./src/index.flow.js",
@@ -21,7 +21,7 @@
   ],
   "bugs": "https://github.com/facebook/react-native/issues",
   "engines": {
-    "node": ">= 22.14.0"
+    "node": ">= 20.19.4"
   },
   "files": [
     "dist"

packages/core-cli-utils/src/index.js

@@ -13,7 +13,7 @@ export type * from './index.flow';
 */
 
 if (process.env.BUILD_EXCLUDE_BABEL_REGISTER == null) {
-  require('../../../scripts/babel-register').registerForMonorepo();
+  require('../../../scripts/shared/babelRegister').registerForMonorepo();
 }
 
 module.exports = require('./index.flow');

packages/core-cli-utils/src/private/app.js

@@ -71,14 +71,13 @@ const FIRST = 1,
   FOURTH = 4;
 
 function getNodePackagePath(packageName: string): string {
-  // $FlowIgnore[prop-missing] type definition is incomplete
+  // $FlowFixMe[prop-missing] type definition is incomplete
   return require.resolve(packageName, {cwd: [process.cwd(), ...module.paths]});
 }
 
 function metro(...args: $ReadOnlyArray<string>): ExecaPromise {
-  const metroPath = getNodePackagePath(path.join('metro', 'src', 'cli.js'));
-  log(`🚇 ${metroPath} ${args.join(' ')} `);
-  return execa('node', [metroPath, ...args]);
+  log(`🚇 metro ${args.join(' ')} `);
+  return execa('npx', ['--offline', 'metro', ...args]);
 }
 
 export const tasks = {

packages/core-cli-utils/src/private/apple.js

@@ -75,7 +75,7 @@ const FIRST = 1,
   FIFTH = 5;
 
 function getNodePackagePath(packageName: string): string {
-  // $FlowIgnore[prop-missing] type definition is incomplete
+  // $FlowFixMe[prop-missing] type definition is incomplete
   return require.resolve(packageName, {cwd: [process.cwd(), ...module.paths]});
 }
 
@@ -125,7 +125,7 @@ export const tasks = {
       }),
     ),
     installDependencies: task(FIFTH, 'Install CocoaPods dependencies', () => {
-      const env = {
+      const env: {[string]: string | void} = {
         RCT_NEW_ARCH_ENABLED: options.newArchitecture ? '1' : '0',
         USE_FRAMEWORKS: options.frameworks,
         USE_HERMES: options.hermes ? '1' : '0',

packages/core-cli-utils/src/public/version.js

@@ -13,7 +13,7 @@ export type * from './version.flow';
 */
 
 if (process.env.BUILD_EXCLUDE_BABEL_REGISTER == null) {
-  require('../../../../scripts/babel-register').registerForMonorepo();
+  require('../../../../scripts/shared/babelRegister').registerForMonorepo();
 }
 
 module.exports = require('./version.flow');

packages/debugger-frontend/BUILD_INFO

@@ -1,5 +1,5 @@
-@generated SignedSource<<9ada78dff12dcfc7937c8934261f47f4>>
-Git revision: 68cfd0ae84acb0ed8e47b421afd64ae3b0b5b727
+@generated SignedSource<<b6a779e724ecce5e727ee674dc20f809>>
+Git revision: e87564a24cf233c60aaebee8c418ec85724f7214
 Built with --nohooks: false
 Is local checkout: false
 Remote URL: https://github.com/facebook/react-native-devtools-frontend

packages/debugger-frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/debugger-frontend",
-  "version": "0.80.0-main",
+  "version": "0.82.0-main",
   "description": "Debugger frontend for React Native based on Chrome DevTools",
   "keywords": [
     "react-native",
@@ -20,6 +20,6 @@
     "BUILD_INFO"
   ],
   "engines": {
-    "node": ">= 22.14.0"
+    "node": ">= 20.19.4"
   }
 }

packages/debugger-shell/__tests__/electron-dependency-test.js

@@ -19,13 +19,13 @@ const semver = require('semver');
 // safety to ensure the target of the resolution is in sync with the declared dependency.
 describe('Electron dependency', () => {
   test('should be semver-satisfied by the actual electron version', () => {
-    // $FlowIssue[untyped-import] - package.json is not typed
+    // $FlowFixMe[untyped-import] - package.json is not typed
     const ourPackageJson = require('../package.json');
 
     const declaredElectronVersion = ourPackageJson.dependencies.electron;
     expect(declaredElectronVersion).toBeTruthy();
 
-    // $FlowIssue[untyped-import] - package.json is not typed
+    // $FlowFixMe[untyped-import] - package.json is not typed
     const electronPackageJson = require('electron/package.json');
 
     const actualElectronVersion = electronPackageJson.version;

packages/debugger-shell/bin/react-native-devtools

@@ -0,0 +1,62 @@
+#!/usr/bin/env dotslash
+
+// @generated SignedSource<<14de73ea0ed751d80c7c687c6aeb123f>>
+
+
+{
+    "name": "React Native DevTools",
+    "platforms": {
+        "linux-aarch64": {
+            "size": 116120331,
+            "hash": "sha256",
+            "digest": "5a1747bdb50f8140d96e99b31f9a603ceaf52e777e5dd59f65edacd87f8c6348",
+            "providers": [
+                {
+                    "type": "http",
+                    "url": "https://scontent.xx.fbcdn.net/mci_ab/uap/?ab_b=m&ab_page=react_native_devtools_binaries&ab_entry=AQMRq1ou56GjpsIRFHpozEYiPfCuVvgWQVwiMMPBbwKyBnebit8HDGKof5XgDHbAKCqAZSgC8L22eJETnqIUM3kEAMYNXcHviIGy41rsXKVDYDgyWlGFB1zP2WzHrjWagfD062Pt4q5GqvCG5RVlhz656BOsutU7B4pDXGFCIdry7FveKn0PXGxvd1E"
+                }
+            ],
+            "format": "tar.gz",
+            "path": "React Native DevTools-linux-arm64/React Native DevTools"
+        },
+        "linux-x86_64": {
+            "size": 116056146,
+            "hash": "sha256",
+            "digest": "b48a3e392ac482de8058917879cf07fd5934dcb84aa901d4fe0d29273b503f54",
+            "providers": [
+                {
+                    "type": "http",
+                    "url": "https://scontent.xx.fbcdn.net/mci_ab/uap/?ab_b=m&ab_page=react_native_devtools_binaries&ab_entry=AQOyyb_LXrME2ubBGSkEi1vDw-2hwuHgHwnR-kAGQyhJK7lnELQDXKX1xW_u0joDwbTOhmiptwenq07G2NFkrY3t_AXefb_xTu2qHzpmrsX2YcwJlewbprgbuX7Uvdhqncb_IRAnJ4ogYKHUg6CZBNmLCQsyDsoqmkXtJ9ikJcQeDu2aiqbb-RWJ"
+                }
+            ],
+            "format": "tar.gz",
+            "path": "React Native DevTools-linux-x64/React Native DevTools"
+        },
+        "macos-aarch64": {
+            "size": 110957864,
+            "hash": "sha256",
+            "digest": "7964d83c857f12bb741abf4377771f3f3697b81df6283dd88d75ae43991afb73",
+            "providers": [
+                {
+                    "type": "http",
+                    "url": "https://scontent.xx.fbcdn.net/mci_ab/uap/?ab_b=m&ab_page=react_native_devtools_binaries&ab_entry=AQM7USVzavWxZkjOO6CasnSfPIfE08jJAkwfVO0qWiYBli136vpzA_HS89ZqsIsAC_GXeT7K-K9BxdON7z5qBoRMUygAay7z4DGT5OZ9YSf9MDCd0JOzah5_6s3ijw2j4eeRu8ZNYzI3aTutDXtPMJAb2KfBHGx2lEiSW5YK9idcB5Y2boAWeDXXX5nb"
+                }
+            ],
+            "format": "tar.gz",
+            "path": "React Native DevTools.app/Contents/MacOS/React Native DevTools"
+        },
+        "macos-x86_64": {
+            "size": 117827315,
+            "hash": "sha256",
+            "digest": "bab2fac43def4a82fb88300aac05180eeda24f31cc00402a3ff7ca2e612bd532",
+            "providers": [
+                {
+                    "type": "http",
+                    "url": "https://scontent.xx.fbcdn.net/mci_ab/uap/?ab_b=m&ab_page=react_native_devtools_binaries&ab_entry=AQPYS0ZRQ7RV1S-yy3tut6pRqcKdPcOiKfekrA5AXdd_M-HDaXLwJS57iAFU2K2X-EA_cyg25C3L-5L7O3eyNKPMToZHbV282GiojnNSKFNjsjj9_B737lOwHI_XqbDQEIiNJZ7NjbkZ8_iMKK-LNL-Ydha2ORWWqytuzP4sWQ6sm0XIxsdyQ6bOLw"
+                }
+            ],
+            "format": "tar.gz",
+            "path": "React Native DevTools.app/Contents/MacOS/React Native DevTools"
+        }
+    }
+}

packages/debugger-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/debugger-shell",
-  "version": "0.80.0-main",
+  "version": "0.82.0-main",
   "description": "Experimental debugger shell for React Native for use with @react-native/debugger-frontend",
   "keywords": [
     "react-native",
@@ -8,7 +8,7 @@
   ],
   "homepage": "https://github.com/facebook/react-native/tree/HEAD/packages/debugger-shell#readme",
   "bugs": "https://github.com/facebook/react-native/issues",
-  "main": "./src/node/index.js",
+  "main": "./src/index.js",
   "exports": {
     ".": {
       "node": "./src/node/index.js",
@@ -26,12 +26,12 @@
   },
   "license": "MIT",
   "engines": {
-    "node": ">= 22.14.0",
-    "electron": ">=36.2.0"
+    "node": ">= 20.19.4",
+    "electron": ">=37.2.6"
   },
   "dependencies": {
     "cross-spawn": "^7.0.6",
-    "electron": "36.2.0"
+    "electron": "37.2.6"
   },
   "devDependencies": {
     "semver": "^7.1.3"

packages/debugger-shell/src/electron/MainInstanceEntryPoint.js

@@ -10,6 +10,7 @@
 
 // $FlowFixMe[unclear-type] We have no Flow types for the Electron API.
 const {BrowserWindow, app, shell, ipcMain} = require('electron') as any;
+const path = require('path');
 const util = require('util');
 
 const windowMetadata = new WeakMap<
@@ -35,7 +36,7 @@ function handleLaunchArgs(argv: string[]) {
   });
 
   // Find an existing window for this app and launch configuration.
-  const existingWindow = BrowserWindow.getAllWindows().find(window => {
+  let frontendWindow = BrowserWindow.getAllWindows().find(window => {
     const metadata = windowMetadata.get(window);
     if (!metadata) {
       return false;
@@ -43,39 +44,37 @@ function handleLaunchArgs(argv: string[]) {
     return metadata.windowKey === windowKey;
   });
 
-  if (existingWindow) {
+  if (frontendWindow) {
     // If the window is already visible, flash it.
-    if (existingWindow.isVisible()) {
-      existingWindow.flashFrame(true);
+    if (frontendWindow.isVisible()) {
+      frontendWindow.flashFrame(true);
       setTimeout(() => {
-        existingWindow.flashFrame(false);
+        frontendWindow.flashFrame(false);
       }, 1000);
     }
-    if (process.platform === 'darwin') {
-      app.focus({
-        steal: true,
-      });
-    }
-    existingWindow.focus();
-    return;
+  } else {
+    // Create the browser window.
+    frontendWindow = new BrowserWindow({
+      width: 1200,
+      height: 600,
+      webPreferences: {
+        partition: 'persist:react-native-devtools',
+        preload: require.resolve('./preload.js'),
+      },
+      // Icon for Linux
+      icon: path.join(__dirname, 'resources', 'icon.png'),
+    });
   }
 
-  // Create the browser window.
-  const frontendWindow = new BrowserWindow({
-    width: 1200,
-    height: 600,
-    webPreferences: {
-      partition: 'persist:react-native-devtools',
-      preload: require.resolve('./preload.js'),
-    },
-  });
-
   // Open links in the default browser instead of in new Electron windows.
   frontendWindow.webContents.setWindowOpenHandler(({url}) => {
     shell.openExternal(url);
     return {action: 'deny'};
   });
 
+  // TODO: If the window contains a live, working frontend instance with a valid connection to the backend,
+  // we should avoid this reload and instead send the frontend a message to handle the launch arguments
+  // dynamically (e.g. update the launch ID for telemetry purposes, handle deeplinking to a specific CDT panel, etc).
   frontendWindow.loadURL(frontendUrl);
 
   windowMetadata.set(frontendWindow, {
@@ -87,10 +86,11 @@ function handleLaunchArgs(argv: string[]) {
       steal: true,
     });
   }
+  frontendWindow.focus();
 }
 
 app.whenReady().then(() => {
-  handleLaunchArgs(process.argv.slice(2));
+  handleLaunchArgs(process.argv.slice(app.isPackaged ? 1 : 2));
 
   app.on(
     'second-instance',

packages/debugger-shell/src/electron/index.flow.js

@@ -10,9 +10,25 @@
 
 // $FlowFixMe[unclear-type] We have no Flow types for the Electron API.
 const {app} = require('electron') as any;
+const util = require('util');
+
+// Handle global command line arguments which don't require a window
+// or the single instance lock to be held.
+const {
+  values: {version = false},
+} = util.parseArgs({
+  options: {version: {type: 'boolean'}},
+  args: process.argv.slice(app.isPackaged ? 1 : 2),
+  strict: false,
+});
+if (version) {
+  console.log(`${app.getName()} v${app.getVersion()}`);
+  // Not app.quit() - we want to exit immediately without initialising the graphical subsystem.
+  app.exit(0);
+}
 
 const gotTheLock = app.requestSingleInstanceLock({
-  argv: process.argv.slice(2),
+  argv: process.argv.slice(app.isPackaged ? 1 : 2),
 });
 
 if (!gotTheLock) {

packages/debugger-shell/src/electron/index.js

@@ -13,7 +13,7 @@ export type * from './index.flow';
 */
 
 if (!Boolean(process.env.BUILD_EXCLUDE_BABEL_REGISTER)) {
-  require('../../../../scripts/babel-register').registerForMonorepo();
+  require('../../../../scripts/shared/babelRegister').registerForMonorepo();
 }
 
 module.exports = require('./index.flow');

packages/debugger-shell/src/electron/preload.js

@@ -16,7 +16,7 @@ contextBridge.executeInMainWorld({
     let didDecorateInspectorFrontendHostInstance = false;
     // reactNativeDecorateInspectorFrontendHostInstance was introduced in
     // https://github.com/facebook/react-native-devtools-frontend/pull/168
-    // $FlowIgnore[prop-missing]
+    // $FlowFixMe[prop-missing]
     globalThis.reactNativeDecorateInspectorFrontendHostInstance = (
       InspectorFrontendHostInstance: $FlowFixMe,
     ) => {

packages/debugger-shell/src/index.js

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+// As far as Flow is concerned, this package is Node-only.
+/*::
+export type * from './node';
+const Node = require('./node');
+declare module.exports: typeof Node;
+*/
+
+// Because Electron doesn't support package.json `exports`, we need to
+// switch at runtime.
+if ('electron' in process.versions) {
+  // $FlowFixMe[invalid-export]
+  module.exports = require('./electron');
+} else {
+  // $FlowFixMe[invalid-export]
+  module.exports = require('./node');
+}