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

Saadnajmi · web-flow · commit 96ee79d9a318 · 2025-07-29T11:22:53.000-07:00
## Summary: Introduce [Yarn Constraints](https://yarnpkg.com/features/constraints) to the repository, that check a few things: 1. Enforce that on release branches, we have a peer dependency on React Native (used for Hermes version lookup, and aligning other dependencies) 2. Enforce that all `@react-native` scoped dependencies use that version. 3. Enforce that all public `@react-native-macos` packages align with our react-native-macos version. Some notes.. - This is effectively only `@react-native-macos/virtualized-lists` - `public`, because `@react-native-macos/nx-release-version` is private ## Test Plan: Earlier version of this PR without fixes from `yarn constraints --fix` properly failed CI: <img width="1185" height="514" alt="image" src="https://github.com/user-attachments/assets/0021c531-d57f-4b4a-80f9-ac42d57abef1" />
diff --git a/.github/workflows/microsoft-pr.yml b/.github/workflows/microsoft-pr.yml
@@ -69,3 +69,20 @@ jobs:
         run: |
           echo "Target branch: ${{ github.base_ref }}"
           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
diff --git a/package.json b/package.json
@@ -52,11 +52,12 @@
     "@definitelytyped/dtslint": "^0.0.127",
     "@jest/create-cache-key-function": "^29.6.3",
     "@nx/js": "^21.2.4",
-    "@react-native/metro-babel-transformer": "0.77.0-main",
-    "@react-native/metro-config": "0.77.0-main",
+    "@react-native/metro-babel-transformer": "workspace:*",
+    "@react-native/metro-config": "workspace:*",
     "@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",
diff --git a/packages/babel-plugin-codegen/package.json b/packages/babel-plugin-codegen/package.json
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "@babel/traverse": "^7.25.3",
-    "@react-native/codegen": "0.77.0-main"
+    "@react-native/codegen": "workspace:*"
   },
   "devDependencies": {
     "@babel/core": "^7.25.2"
diff --git a/packages/community-cli-plugin/package.json b/packages/community-cli-plugin/package.json
@@ -23,8 +23,8 @@
     "dist"
   ],
   "dependencies": {
-    "@react-native/dev-middleware": "0.77.0-main",
-    "@react-native/metro-babel-transformer": "0.77.0-main",
+    "@react-native/dev-middleware": "workspace:*",
+    "@react-native/metro-babel-transformer": "workspace:*",
     "chalk": "^4.0.0",
     "debug": "^2.2.0",
     "invariant": "^2.2.4",
diff --git a/packages/dev-middleware/package.json b/packages/dev-middleware/package.json
@@ -24,7 +24,7 @@
   ],
   "dependencies": {
     "@isaacs/ttlcache": "^1.4.1",
-    "@react-native/debugger-frontend": "0.77.0-main",
+    "@react-native/debugger-frontend": "workspace:*",
     "chrome-launcher": "^0.15.2",
     "chromium-edge-launcher": "^0.2.0",
     "connect": "^3.6.5",
diff --git a/packages/eslint-config-react-native/package.json b/packages/eslint-config-react-native/package.json
@@ -23,7 +23,7 @@
   "dependencies": {
     "@babel/core": "^7.25.2",
     "@babel/eslint-parser": "^7.25.1",
-    "@react-native/eslint-plugin": "0.77.0-main",
+    "@react-native/eslint-plugin": "workspace:*",
     "@typescript-eslint/eslint-plugin": "^7.1.1",
     "@typescript-eslint/parser": "^7.1.1",
     "eslint-config-prettier": "^8.5.0",
diff --git a/packages/eslint-plugin-specs/package.json b/packages/eslint-plugin-specs/package.json
@@ -27,7 +27,7 @@
   "dependencies": {
     "@babel/core": "^7.25.2",
     "@babel/plugin-transform-flow-strip-types": "^7.25.2",
-    "@react-native/codegen": "0.77.0-main",
+    "@react-native/codegen": "workspace:*",
     "make-dir": "^2.1.0",
     "pirates": "^4.0.1",
     "source-map-support": "0.5.0"
diff --git a/packages/metro-config/package.json b/packages/metro-config/package.json
@@ -27,8 +27,8 @@
     "dist"
   ],
   "dependencies": {
-    "@react-native/js-polyfills": "0.77.0-main",
-    "@react-native/metro-babel-transformer": "0.77.0-main",
+    "@react-native/js-polyfills": "workspace:*",
+    "@react-native/metro-babel-transformer": "workspace:*",
     "metro-config": "^0.81.0",
     "metro-runtime": "^0.81.0"
   }
diff --git a/packages/nx-release-version/package.json b/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",
diff --git a/packages/react-native-babel-preset/package.json b/packages/react-native-babel-preset/package.json
@@ -56,7 +56,7 @@
     "@babel/plugin-transform-typescript": "^7.25.2",
     "@babel/plugin-transform-unicode-regex": "^7.24.7",
     "@babel/template": "^7.25.0",
-    "@react-native/babel-plugin-codegen": "0.77.0-main",
+    "@react-native/babel-plugin-codegen": "workspace:*",
     "babel-plugin-syntax-hermes-parser": "0.25.1",
     "babel-plugin-transform-flow-enums": "^0.0.2",
     "react-refresh": "^0.14.0"
diff --git a/packages/react-native-babel-transformer/package.json b/packages/react-native-babel-transformer/package.json
@@ -17,7 +17,7 @@
   "license": "MIT",
   "dependencies": {
     "@babel/core": "^7.25.2",
-    "@react-native/babel-preset": "0.77.0-main",
+    "@react-native/babel-preset": "workspace:*",
     "hermes-parser": "0.25.1",
     "nullthrows": "^1.1.1"
   },
diff --git a/packages/react-native-codegen-typescript-test/package.json b/packages/react-native-codegen-typescript-test/package.json
@@ -19,7 +19,7 @@
     "prepare": "yarn run build"
   },
   "dependencies": {
-    "@react-native/codegen": "0.77.0-main"
+    "@react-native/codegen": "workspace:*"
   },
   "devDependencies": {
     "@babel/core": "^7.25.2",
diff --git a/packages/react-native-popup-menu-android/package.json b/packages/react-native-popup-menu-android/package.json
@@ -18,7 +18,7 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "@react-native/codegen": "0.77.0-main"
+    "@react-native/codegen": "workspace:*"
   },
   "peerDependencies": {
     "@types/react": "^19.0.0",
diff --git a/packages/react-native-test-library/package.json b/packages/react-native-test-library/package.json
@@ -26,7 +26,7 @@
   ],
   "devDependencies": {
     "@babel/core": "^7.25.2",
-    "@react-native/babel-preset": "0.77.0-main",
+    "@react-native/babel-preset": "workspace:*",
     "react-native-macos": "workspace:*"
   },
   "peerDependencies": {
diff --git a/packages/react-native/package.json b/packages/react-native/package.json
@@ -112,12 +112,12 @@
   "dependencies": {
     "@jest/create-cache-key-function": "^29.6.3",
     "@react-native-macos/virtualized-lists": "workspace:*",
-    "@react-native/assets-registry": "0.77.0-main",
-    "@react-native/codegen": "0.77.0-main",
-    "@react-native/community-cli-plugin": "0.77.0-main",
-    "@react-native/gradle-plugin": "0.77.0-main",
-    "@react-native/js-polyfills": "0.77.0-main",
-    "@react-native/normalize-colors": "0.77.0-main",
+    "@react-native/assets-registry": "workspace:*",
+    "@react-native/codegen": "workspace:*",
+    "@react-native/community-cli-plugin": "workspace:*",
+    "@react-native/gradle-plugin": "workspace:*",
+    "@react-native/js-polyfills": "workspace:*",
+    "@react-native/normalize-colors": "workspace:*",
     "abort-controller": "^3.0.0",
     "anser": "^1.4.9",
     "ansi-regex": "^5.0.0",
diff --git a/yarn.config.cjs b/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);
+  },
+});
diff --git a/yarn.lock b/yarn.lock

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