feat: add support to nx v21 (#701)

Author: dianjuar

.github/workflows/backwards-compatibility-test.yml

@@ -1,4 +1,5 @@
 name: Backwards Compatibility Test
+description: 'Test backwards compatibility with different Nx versions and Node versions. For more information about Nx and Node versions, see https://nx.dev/reference/core-api/workspace/documents/nx-nodejs-typescript-version-matrix'
 
 on: workflow_call
 
@@ -8,18 +9,25 @@ jobs:
       matrix:
         include:
           # '' means current workspace version
-          - nx-version: ''
+          - nx-version: '' # 21.x
             node-version: 22
           - nx-version: ''
             node-version: 20
 
-          - nx-version: 'previous'
+          - nx-version: 'previous' # 20.x
             node-version: 22
           - nx-version: 'previous'
             node-version: 20
           - nx-version: 'previous'
             node-version: 18
 
+          - nx-version: '19.8.14'
+            node-version: 22
+          - nx-version: '19.8.14'
+            node-version: 20
+          - nx-version: '19.8.14'
+            node-version: 18
+
           - nx-version: '18.3.5'
             node-version: 20
           - nx-version: '18.3.5'
@@ -34,8 +42,6 @@ jobs:
             node-version: 20
           - nx-version: '16.10.0'
             node-version: 18
-          - nx-version: '16.10.0'
-            node-version: 16 # This node's version is deprecated
 
     name: Backwards Compatibility Test
     uses: ./.github/workflows/smoke-test-nx-workspace.yml

.gitignore

@@ -61,3 +61,5 @@ reports/*
 # End of https://www.toptal.com/developers/gitignore/api/sonarqube
 
 .env
+.cursor/rules/nx-rules.mdc
+.github/instructions/nx.instructions.md

README.md

@@ -239,14 +239,15 @@ For testing: Run through without making any changes. Execute with `--dry-run`, a
 
 ## Compatibility overview with Nx
 
-| Version | Nx Workspace Version                                          |
-| ------- | ------------------------------------------------------------- |
-| v8.3.0  | `^20.0.0 \|\| ^19.0.0 \|\| ^18.0.0 \|\| ^17.0.0 \|\| ^16.0.0` |
-| v8.2.0  | `^19.0.0 \|\| ^18.0.0 \|\| ^17.0.0 \|\| ^16.0.0`              |
-| v8.1.0  | `^18.0.0 \|\| ^17.0.0 \|\| ^16.0.0`                           |
-| v8.0.0  | `^17.0.0 \|\| ^16.0.0`                                        |
-| v7.1.0  | `^17.0.0 \|\| ^16.0.0`                                        |
-| v7.0.1  | `^16.0.0`                                                     |
+| Version | Nx Workspace Version |
+| ------- | -------------------- |
+| v8.5.0  | `>=16.x  <21.x`      |
+| v8.4.0  | `>=16.x  <20.x`      |
+| v8.2.0  | `>=16.x  <19.x`      |
+| v8.1.0  | `>=16.x  <18.x`      |
+| v8.0.0  | `>=16.x  <17.x`      |
+| v7.1.0  | `>=16.x  <17.x`      |
+| v7.0.1  | `16.x`               |
 
 ## 📁 Configuration File <a name="configuration-file"></a>
 

migrations.json

@@ -0,0 +1,54 @@
+{
+  "migrations": [
+    {
+      "version": "21.0.0-beta.8",
+      "description": "Removes the legacy cache configuration from nx.json",
+      "implementation": "./src/migrations/update-21-0-0/remove-legacy-cache",
+      "package": "nx",
+      "name": "remove-legacy-cache"
+    },
+    {
+      "version": "21.0.0-beta.8",
+      "description": "Removes the legacy cache configuration from nx.json",
+      "implementation": "./src/migrations/update-21-0-0/remove-custom-tasks-runner",
+      "package": "nx",
+      "name": "remove-custom-tasks-runner"
+    },
+    {
+      "version": "21.0.0-beta.11",
+      "description": "Updates release version config based on the breaking changes in Nx v21",
+      "implementation": "./src/migrations/update-21-0-0/release-version-config-changes",
+      "package": "nx",
+      "name": "release-version-config-changes"
+    },
+    {
+      "version": "21.0.0-beta.11",
+      "description": "Updates release changelog config based on the breaking changes in Nx v21",
+      "implementation": "./src/migrations/update-21-0-0/release-changelog-config-changes",
+      "package": "nx",
+      "name": "release-changelog-config-changes"
+    },
+    {
+      "version": "21.1.0-beta.2",
+      "description": "Adds **/nx-rules.mdc and **/nx.instructions.md to .gitignore if not present",
+      "implementation": "./src/migrations/update-21-1-0/add-gitignore-entry",
+      "package": "nx",
+      "name": "21-1-0-add-ignore-entries-for-nx-rule-files"
+    },
+    {
+      "cli": "nx",
+      "version": "21.0.0-beta.9",
+      "description": "Replace usage of `getJestProjects` with `getJestProjectsAsync`.",
+      "implementation": "./src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync",
+      "package": "@nx/jest",
+      "name": "replace-getJestProjects-with-getJestProjectsAsync-v21"
+    },
+    {
+      "version": "21.0.0-beta.10",
+      "description": "Remove the previously deprecated and unused `tsConfig` option from the `@nx/jest:jest` executor.",
+      "implementation": "./src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor",
+      "package": "@nx/jest",
+      "name": "remove-tsconfig-option-from-jest-executor"
+    }
+  ]
+}

nx.json

@@ -43,6 +43,5 @@
       }
     }
   },
-  "defaultBase": "main",
-  "useLegacyCache": true
+  "defaultBase": "main"
 }