chore(0.78): add Yarn constraints to enforce dependency alignment (#2583)

## Summary:

Backport #2582

Author: Saadnajmi

.github/workflows/microsoft-pr.yml

@@ -62,4 +62,20 @@ jobs:
       - name: Version and publish packages (dry run)
         run: |
           echo "Target branch: ${{ github.base_ref }}"
-          yarn nx release --dry-run --verbose
+          yarn nx release --dry-run --verbose
+  yarn-constraints:
+    name: "Check Yarn Constraints"
+    permissions: {}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          filter: blob:none
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Install dependencies
+        run: yarn
+      - name: Check constraints
+        run: yarn constraints

package.json

@@ -57,6 +57,7 @@
     "@tsconfig/node18": "1.0.1",
     "@types/react": "^19.0.0",
     "@typescript-eslint/parser": "^7.1.1",
+    "@yarnpkg/types": "^4.0.1",
     "ansi-styles": "^4.2.1",
     "babel-plugin-minify-dead-code-elimination": "^0.5.2",
     "babel-plugin-syntax-hermes-parser": "0.25.1",

packages/nx-release-version/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@react-native-macos/nx-release-version",
   "version": "0.0.1-dev",
+  "private": true,
   "description": "Nx Release Version Actions for React Native macOS",
   "homepage": "https://github.com/microsoft/react-native-macos/tree/HEAD/packages/nx-release-version#readme",
   "license": "MIT",

packages/react-native-test-library/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@react-native/oss-library-example",
-  "version": "0.78.3",
+  "version": "0.78.2",
   "private": true,
-  "description": "Package that includes native module exapmle, native component example, targets both the old and the new architecture. It should serve as an example of a real-world OSS library.",
+  "description": "Package that includes native module example, native component example, targets both the old and the new architecture. It should serve as an example of a real-world OSS library.",
   "license": "MIT",
   "homepage": "https://github.com/facebook/react-native.git",
   "repository": {
@@ -26,7 +26,7 @@
   ],
   "devDependencies": {
     "@babel/core": "^7.25.2",
-    "@react-native/babel-preset": "workspace:*",
+    "@react-native/babel-preset": "0.78.2",
     "react-native-macos": "workspace:*"
   },
   "peerDependencies": {

packages/react-native/package.json

@@ -111,7 +111,7 @@
   },
   "dependencies": {
     "@jest/create-cache-key-function": "^29.6.3",
-    "@react-native-macos/virtualized-lists": "0.78.4",
+    "@react-native-macos/virtualized-lists": "workspcace:*",
     "@react-native/assets-registry": "0.78.2",
     "@react-native/codegen": "0.78.2",
     "@react-native/community-cli-plugin": "0.78.2",

packages/rn-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/tester",
-  "version": "0.78.3",
+  "version": "0.78.2",
   "private": true,
   "description": "React Native tester app.",
   "license": "MIT",
@@ -27,8 +27,8 @@
     "e2e-test-ios": "./scripts/maestro-test-ios.sh"
   },
   "dependencies": {
-    "@react-native/oss-library-example": "0.78.3",
-    "@react-native/popup-menu-android": "workspace:*",
+    "@react-native/oss-library-example": "workspace:*",
+    "@react-native/popup-menu-android": "0.78.2",
     "flow-enums-runtime": "^0.0.6",
     "invariant": "^2.2.4",
     "nullthrows": "^1.1.1"

yarn.config.cjs

@@ -0,0 +1,116 @@
+// @ts-check
+
+/** @type {import('@yarnpkg/types')} */
+const {defineConfig} = require('@yarnpkg/types');
+
+/**
+ * @typedef {import('@yarnpkg/types').Yarn.Constraints.Context} Context
+ * @typedef {import('@yarnpkg/types').Yarn.Constraints.Workspace} Workspace
+ * @typedef {import('@yarnpkg/types').Yarn.Constraints.Dependency} Dependency
+ */
+
+/**
+ * Enforce that react-native-macos declares a peer dependency on react-native on release branches,
+ * except on the main branch, where there is no published version of React Native to align to.
+ * @param {Context} context
+ */
+function expectReactNativePeerDependency({Yarn}) {
+    const rnmWorkspace = Yarn.workspace({ident: 'react-native-macos'});
+    if (!rnmWorkspace) {
+        // Report error on root workspace since react-native-macos doesn't exist
+        Yarn.workspace().error('react-native-macos workspace must exist in the monorepo');
+        return;
+    }
+
+    // Check if react-native-macos version is 1000.0.0 - implying we are on the main branch
+    const isMainBranch = rnmWorkspace.manifest.version === '1000.0.0';
+    if (!isMainBranch) {
+        const rnPeerDependency = rnmWorkspace.pkg.peerDependencies.get('react-native');
+        if (!rnPeerDependency) {
+            rnmWorkspace.error('react-native-macos must declare a peer dependency on react-native on release branches');
+        }
+    }
+}
+
+/**
+ * Enforce that all @react-native/ scoped packages use the same version
+ * as the react-native peer dependency declared in react-native-macos.
+ * On the main branch, enforce that we use workspace:* for @react-native/ packages.
+ * @param {Context} context
+ */
+function enforceReactNativeVersionConsistency({Yarn}) {
+    const rnmWorkspace = Yarn.workspace({ident: 'react-native-macos'});
+    if (!rnmWorkspace) {
+        // Report error on root workspace since react-native-macos doesn't exist
+        Yarn.workspace().error('react-native-macos workspace must exist in the monorepo');
+        return;
+    }
+
+    // Check if react-native-macos version is 1000.0.0 - implying we are on the main branch
+    const isMainBranch = rnmWorkspace.manifest.version === '1000.0.0';
+    
+    let targetVersion;
+    if (isMainBranch) {
+        // On main branch, use workspace:* for @react-native/ packages
+        targetVersion = 'workspace:*';
+    } else {
+        const rnPeerDependency = rnmWorkspace.pkg.peerDependencies.get('react-native');
+        if (!rnPeerDependency) {
+            rnmWorkspace.error('react-native-macos must declare a peer dependency on react-native on release branches');
+            return;
+        }
+        targetVersion = rnPeerDependency;
+    }    // Enforce this version on all @react-native/ scoped packages across all workspaces
+    for (const dependency of Yarn.dependencies()) {
+        if (dependency.ident.startsWith('@react-native/')) {
+            // Check if the target package is private (not published)
+            const targetWorkspace = Yarn.workspace({ident: dependency.ident});
+            const isPrivatePackage = targetWorkspace && targetWorkspace.manifest.private;
+            
+            if (isPrivatePackage) {
+                // Private packages should always use workspace:* since they're not published
+                dependency.update('workspace:*');
+            } else {
+                dependency.update(targetVersion);
+            }
+        }
+    }
+}
+
+/**
+ * Enforce that all @react-native-macos/ scoped packages use the same version
+ * as react-native-macos, but only for non-private packages.
+ * @param {Context} context
+ */
+function enforceReactNativeMacosVersionConsistency({Yarn}) {
+    const rnmWorkspace = Yarn.workspace({ident: 'react-native-macos'});
+    if (!rnmWorkspace) {
+        // Report error on root workspace since react-native-macos doesn't exist
+        Yarn.workspace().error('react-native-macos workspace must exist in the monorepo');
+        return;
+    }
+
+    const targetVersion = rnmWorkspace.manifest.version;
+    if (!targetVersion) {
+        rnmWorkspace.error('react-native-macos must have a version');
+        return;
+    }
+
+    // Enforce this version on all non-private @react-native-macos/ scoped packages
+    for (const workspace of Yarn.workspaces()) {
+        const isReactNativeMacosScoped = workspace.ident && workspace.ident.startsWith('@react-native-macos/');
+        const isPrivate = workspace.manifest.private;
+        
+        if (isReactNativeMacosScoped && !isPrivate) {
+            workspace.set('version', targetVersion);
+        }
+    }
+}
+
+module.exports = defineConfig({
+  constraints: async ctx => {
+    expectReactNativePeerDependency(ctx);
+    enforceReactNativeVersionConsistency(ctx);
+    enforceReactNativeMacosVersionConsistency(ctx);
+  },
+});

yarn.lock

@@ -2738,6 +2738,7 @@ __metadata:
     "@tsconfig/node18": "npm:1.0.1"
     "@types/react": "npm:^19.0.0"
     "@typescript-eslint/parser": "npm:^7.1.1"
+    "@yarnpkg/types": "npm:^4.0.1"
     ansi-styles: "npm:^4.2.1"
     babel-plugin-minify-dead-code-elimination: "npm:^0.5.2"
     babel-plugin-syntax-hermes-parser: "npm:0.25.1"
@@ -2802,7 +2803,7 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@react-native-macos/virtualized-lists@npm:0.78.4, @react-native-macos/virtualized-lists@workspace:packages/virtualized-lists":
+"@react-native-macos/virtualized-lists@workspace:packages/virtualized-lists, @react-native-macos/virtualized-lists@workspcace:*":
   version: 0.0.0-use.local
   resolution: "@react-native-macos/virtualized-lists@workspace:packages/virtualized-lists"
   dependencies:
@@ -2835,7 +2836,7 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@react-native/babel-preset@npm:0.78.2, @react-native/babel-preset@workspace:*, @react-native/babel-preset@workspace:packages/react-native-babel-preset":
+"@react-native/babel-preset@npm:0.78.2, @react-native/babel-preset@workspace:packages/react-native-babel-preset":
   version: 0.0.0-use.local
   resolution: "@react-native/babel-preset@workspace:packages/react-native-babel-preset"
   dependencies:
@@ -3107,20 +3108,20 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@react-native/oss-library-example@npm:0.78.3, @react-native/oss-library-example@workspace:packages/react-native-test-library":
+"@react-native/oss-library-example@workspace:*, @react-native/oss-library-example@workspace:packages/react-native-test-library":
   version: 0.0.0-use.local
   resolution: "@react-native/oss-library-example@workspace:packages/react-native-test-library"
   dependencies:
     "@babel/core": "npm:^7.25.2"
-    "@react-native/babel-preset": "workspace:*"
+    "@react-native/babel-preset": "npm:0.78.2"
     react-native-macos: "workspace:*"
   peerDependencies:
     react: "*"
     react-native-macos: "*"
   languageName: unknown
   linkType: soft
 
-"@react-native/popup-menu-android@workspace:*, @react-native/popup-menu-android@workspace:packages/react-native-popup-menu-android":
+"@react-native/popup-menu-android@npm:0.78.2, @react-native/popup-menu-android@workspace:packages/react-native-popup-menu-android":
   version: 0.0.0-use.local
   resolution: "@react-native/popup-menu-android@workspace:packages/react-native-popup-menu-android"
   dependencies:
@@ -3143,8 +3144,8 @@ __metadata:
     "@react-native-community/cli": "npm:15.0.0-alpha.2"
     "@react-native-community/cli-platform-android": "npm:15.0.0-alpha.2"
     "@react-native-community/cli-platform-ios": "npm:15.0.0-alpha.2"
-    "@react-native/oss-library-example": "npm:0.78.3"
-    "@react-native/popup-menu-android": "workspace:*"
+    "@react-native/oss-library-example": "workspace:*"
+    "@react-native/popup-menu-android": "npm:0.78.2"
     flow-enums-runtime: "npm:^0.0.6"
     invariant: "npm:^2.2.4"
     nullthrows: "npm:^1.1.1"
@@ -3931,6 +3932,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@yarnpkg/types@npm:^4.0.1":
+  version: 4.0.1
+  resolution: "@yarnpkg/types@npm:4.0.1"
+  dependencies:
+    tslib: "npm:^2.4.0"
+  checksum: 10c0/90226789475680ba599833571dd76c0718dd5b4c5022481263ef309d6a628f6246671cd6ca86e49c966ddefa7aca6ccef82240dc1476d2cea702ea5bee2a6b72
+  languageName: node
+  linkType: hard
+
 "@zkochan/js-yaml@npm:0.0.7":
   version: 0.0.7
   resolution: "@zkochan/js-yaml@npm:0.0.7"
@@ -10894,7 +10904,7 @@ __metadata:
   resolution: "react-native-macos@workspace:packages/react-native"
   dependencies:
     "@jest/create-cache-key-function": "npm:^29.6.3"
-    "@react-native-macos/virtualized-lists": "npm:0.78.4"
+    "@react-native-macos/virtualized-lists": "workspcace:*"
     "@react-native/assets-registry": "npm:0.78.2"
     "@react-native/codegen": "npm:0.78.2"
     "@react-native/community-cli-plugin": "npm:0.78.2"