chore(0.76): update to nx 21 (#2570)

## Summary:

Backport #2560

Author: Saadnajmi

.ado/scripts/prepublish-check.mjs

@@ -12,13 +12,11 @@ const RNMACOS_LATEST = "react-native-macos@latest";
 const RNMACOS_NEXT = "react-native-macos@next";
 
 /**
- * @typedef {import("nx/src/command-line/release/version").ReleaseVersionGeneratorSchema} ReleaseVersionGeneratorSchema;
+ * @typedef {import("nx/src/config/nx-json").NxReleaseVersionConfiguration} NxReleaseVersionConfiguration;
  * @typedef {{
  *   defaultBase: string;
  *   release: {
- *     version: {
- *       generatorOptions: ReleaseVersionGeneratorSchema;
- *     };
+ *     version: NxReleaseVersionConfiguration;
  *   };
  * }} NxConfig;
  * @typedef {{
@@ -273,36 +271,36 @@ function enablePublishing(config, currentBranch, { npmTag: tag, prerelease, isNe
   }
 
   // Determines whether we need to add "nightly" or "rc" to the version string.
-  const { generatorOptions } = release.version;
-  if (generatorOptions.preid !== prerelease) {
+  const { versionActionsOptions = {} } = release.version;
+  if (versionActionsOptions.preid !== prerelease) {
     if (prerelease) {
-      errors.push(`'release.version.generatorOptions.preid' must be set to '${prerelease}'`);
-      generatorOptions.preid = prerelease;
+      errors.push(`'release.version.versionActionsOptions.preid' must be set to '${prerelease}'`);
+      versionActionsOptions.preid = prerelease;
     } else {
-      errors.push(`'release.version.generatorOptions.preid' must be removed`);
-      generatorOptions.preid = undefined;
+      errors.push(`'release.version.versionActionsOptions.preid' must be removed`);
+      versionActionsOptions.preid = undefined;
     }
   }
 
   // What the published version should be tagged as e.g., "latest" or "nightly".
-  const { currentVersionResolverMetadata } = generatorOptions;
-  if (currentVersionResolverMetadata?.tag !== tag) {
-    errors.push(`'release.version.generatorOptions.currentVersionResolverMetadata.tag' must be set to '${tag}'`);
-    generatorOptions.currentVersionResolverMetadata ??= {};
-    generatorOptions.currentVersionResolverMetadata.tag = tag;
+  const currentVersionResolverMetadata = /** @type {{ tag?: string }} */ (versionActionsOptions.currentVersionResolverMetadata || {});
+  if (currentVersionResolverMetadata.tag !== tag) {
+    errors.push(`'release.version.versionActionsOptions.currentVersionResolverMetadata.tag' must be set to '${tag}'`);
+    versionActionsOptions.currentVersionResolverMetadata ??= {};
+    /** @type {any} */ (versionActionsOptions.currentVersionResolverMetadata).tag = tag;
   }
 
   // If we're demoting a branch, we will need to create a new tag. This will
   // make Nx trip if we don't specify a fallback. In all other scenarios, the
   // tags should exist and therefore prefer it to fail.
   if (isNewTag) {
-    if (generatorOptions.fallbackCurrentVersionResolver !== "disk") {
-      errors.push("'release.version.generatorOptions.fallbackCurrentVersionResolver' must be set to 'disk'");
-      generatorOptions.fallbackCurrentVersionResolver = "disk";
+    if (versionActionsOptions.fallbackCurrentVersionResolver !== "disk") {
+      errors.push("'release.version.versionActionsOptions.fallbackCurrentVersionResolver' must be set to 'disk'");
+      versionActionsOptions.fallbackCurrentVersionResolver = "disk";
     }
-  } else if (typeof generatorOptions.fallbackCurrentVersionResolver === "string") {
-    errors.push("'release.version.generatorOptions.fallbackCurrentVersionResolver' must be removed");
-    generatorOptions.fallbackCurrentVersionResolver = undefined;
+  } else if (typeof versionActionsOptions.fallbackCurrentVersionResolver === "string") {
+    errors.push("'release.version.versionActionsOptions.fallbackCurrentVersionResolver' must be removed");
+    versionActionsOptions.fallbackCurrentVersionResolver = undefined;
   }
 
   if (errors.length > 0) {

.gitignore

@@ -178,4 +178,6 @@ vendor/
 # Nx
 .nx/cache
 .nx/workspace-data
+.cursor/rules/nx-rules.mdc
+.github/instructions/nx.instructions.md
 # macOS]

.nx/version-plans/version-plan-1751411273803.md

@@ -1,6 +1,5 @@
 ---
 react-native-macos: patch
-'@react-native-mac/virtualized-lists': patch
 ---
 
 new patch release

.yarn/releases/yarn-4.5.1.cjs

@@ -1,3 +1,3 @@
 nodeLinker: node-modules
 
-yarnPath: .yarn/releases/yarn-4.5.1.cjs
+yarnPath: .yarn/releases/yarn-4.9.2.cjs

.yarn/releases/yarn-4.9.2.cjs

@@ -3,9 +3,7 @@
   "defaultBase": "0.76-stable",
   "targetDefaults": {
     "build": {
-      "dependsOn": [
-        "^build"
-      ]
+      "dependsOn": ["^build"]
     }
   },
   "release": {
@@ -16,21 +14,18 @@
       },
       "workspaceChangelog": false
     },
-    "projects": [
-      "packages/react-native",
-      "packages/virtualized-lists"
-    ],
-    "projectsRelationship": "independent",
+    "projects": ["packages/react-native", "packages/virtualized-lists"],
     "versionPlans": true,
     "version": {
-      "generator": "@react-native-mac/nx-release-version:release-version",
-      "generatorOptions": {
+      "versionActions": "@react-native-macos/nx-release-version",
+      "versionActionsOptions": {
         "currentVersionResolver": "registry",
         "currentVersionResolverMetadata": {
           "tag": "v0.76-stable"
         },
         "fallbackCurrentVersionResolver": "disk"
-      }
+      },
+      "useLegacyVersioning": false
     }
   }
 }

.yarnrc.yml

@@ -1,8 +1,9 @@
 {
-  "name": "@react-native-mac/monorepo",
+  "name": "@react-native-macos/monorepo",
   "private": true,
   "version": "1000.0.0",
   "license": "MIT",
+  "packageManager": "[email protected]",
   "scripts": {
     "android": "cd packages/rn-tester && npm run android",
     "build-android": "./gradlew :packages:react-native:ReactAndroid:build",
@@ -48,7 +49,7 @@
     "@babel/preset-flow": "^7.24.7",
     "@definitelytyped/dtslint": "^0.0.127",
     "@jest/create-cache-key-function": "^29.6.3",
-    "@nx/js": "~20.0.0",
+    "@nx/js": "^21.2.4",
     "@pkgjs/parseargs": "^0.11.0",
     "@react-native/metro-babel-transformer": "0.76.9",
     "@react-native/metro-config": "0.76.9",
@@ -93,7 +94,7 @@
     "mkdirp": "^0.5.1",
     "node-fetch": "^2.2.0",
     "nullthrows": "^1.1.1",
-    "nx": "~20.0.0",
+    "nx": "21.2.4",
     "prettier": "2.8.8",
     "prettier-plugin-hermes-parser": "0.23.1",
     "react": "18.3.1",
@@ -124,6 +125,5 @@
     "readable-stream": "Eliminates dependency on outdated string_decoder component",
     "shell-quote": "Versions prior to 1.7.3 have an RCE vulnerability. Should be removable once we upgrade CLI tools to ^8.0.0 with RN 0.69.",
     "tough-cookie": "@definitelytyped/dtslint indirectly depends on this through an out-of-date library, and our particular use case doesn't need cookies"
-  },
-  "packageManager": "[email protected]"
+  }
 }

nx.json

@@ -0,0 +1,21 @@
+# os/nx-release-version
+
+Nx (v21) Version Actions for React Native macOS releases.
+
+## Overview
+
+This package provides custom Version Actions for Nx 21's modern release system (`useLegacyVersioning: false`). It extends the built-in `JsVersionActions` to include React Native platform-specific artifact updates.
+
+## What it does
+
+When versioning the `react-native-macos` project, this package automatically:
+
+1. **Updates standard package.json files** (via the base `JsVersionActions`)
+2. **Updates React Native platform artifacts**:
+   - `ReactAndroid/gradle.properties`
+   - `ReactNativeVersion.java`
+   - `RCTVersion.m`
+   - `ReactNativeVersion.h`
+   - `ReactNativeVersion.js`
+3. **Creates a `.rnm-publish` marker file** to indicate successful versioning
+