feat(testing): add convert-to-inferred migration generator for jest

docs/generated/manifests/menus.json

@@ -7725,6 +7725,14 @@
                 "children": [],
                 "isExternal": false,
                 "disableCollapsible": false
+              },
+              {
+                "id": "convert-to-inferred",
+                "path": "/nx-api/jest/generators/convert-to-inferred",
+                "name": "convert-to-inferred",
+                "children": [],
+                "isExternal": false,
+                "disableCollapsible": false
               }
             ],
             "isExternal": false,

docs/generated/manifests/nx-api.json

@@ -1130,6 +1130,15 @@
         "originalFilePath": "/packages/jest/src/generators/configuration/schema.json",
         "path": "/nx-api/jest/generators/configuration",
         "type": "generator"
+      },
+      "/nx-api/jest/generators/convert-to-inferred": {
+        "description": "Convert existing Jest project(s) using `@nx/jest:jest` executor to use `@nx/jest/plugin`.",
+        "file": "generated/packages/jest/generators/convert-to-inferred.json",
+        "hidden": false,
+        "name": "convert-to-inferred",
+        "originalFilePath": "/packages/jest/src/generators/convert-to-inferred/schema.json",
+        "path": "/nx-api/jest/generators/convert-to-inferred",
+        "type": "generator"
       }
     },
     "path": "/nx-api/jest"

docs/generated/packages-metadata.json

@@ -1113,6 +1113,15 @@
         "originalFilePath": "/packages/jest/src/generators/configuration/schema.json",
         "path": "jest/generators/configuration",
         "type": "generator"
+      },
+      {
+        "description": "Convert existing Jest project(s) using `@nx/jest:jest` executor to use `@nx/jest/plugin`.",
+        "file": "generated/packages/jest/generators/convert-to-inferred.json",
+        "hidden": false,
+        "name": "convert-to-inferred",
+        "originalFilePath": "/packages/jest/src/generators/convert-to-inferred/schema.json",
+        "path": "jest/generators/convert-to-inferred",
+        "type": "generator"
       }
     ],
     "githubRoot": "https://github.com/nrwl/nx/blob/master",

docs/generated/packages/jest/generators/convert-to-inferred.json

@@ -0,0 +1,30 @@
+{
+  "name": "convert-to-inferred",
+  "factory": "./src/generators/convert-to-inferred/convert-to-inferred",
+  "schema": {
+    "$schema": "https://json-schema.org/schema",
+    "$id": "NxJestConvertToInferred",
+    "description": "Convert existing Jest project(s) using `@nx/jest:jest` executor to use `@nx/jest/plugin`.",
+    "title": "Convert Jest project from executor to plugin",
+    "type": "object",
+    "properties": {
+      "project": {
+        "type": "string",
+        "description": "The project to convert from using the `@nx/jest:jest` executor to use `@nx/jest/plugin`. If not provided, all projects using the `@nx/jest:jest` executor will be converted.",
+        "x-priority": "important"
+      },
+      "skipFormat": {
+        "type": "boolean",
+        "description": "Whether to format files.",
+        "default": false
+      }
+    },
+    "presets": []
+  },
+  "description": "Convert existing Jest project(s) using `@nx/jest:jest` executor to use `@nx/jest/plugin`.",
+  "implementation": "/packages/jest/src/generators/convert-to-inferred/convert-to-inferred.ts",
+  "aliases": [],
+  "hidden": false,
+  "path": "/packages/jest/src/generators/convert-to-inferred/schema.json",
+  "type": "generator"
+}

docs/shared/reference/sitemap.md

@@ -451,6 +451,7 @@
     - [generators](/nx-api/jest/generators)
       - [init](/nx-api/jest/generators/init)
       - [configuration](/nx-api/jest/generators/configuration)
+      - [convert-to-inferred](/nx-api/jest/generators/convert-to-inferred)
   - [js](/nx-api/js)
     - [documents](/nx-api/js/documents)
       - [Overview](/nx-api/js/documents/overview)

packages/devkit/src/generators/plugin-migrations/executor-to-plugin-migrator.ts

@@ -32,7 +32,7 @@ type PostTargetTransformer = (
   tree: Tree,
   projectDetails: { projectName: string; root: string },
   inferredTargetConfiguration: TargetConfiguration
-) => TargetConfiguration;
+) => TargetConfiguration | Promise<TargetConfiguration>;
 type SkipTargetFilter = (
   targetConfiguration: TargetConfiguration
 ) => [boolean, string];
@@ -80,7 +80,7 @@ class ExecutorToPluginMigrator<T> {
     await this.#init();
     if (this.#targetAndProjectsToMigrate.size > 0) {
       for (const targetName of this.#targetAndProjectsToMigrate.keys()) {
-        this.#migrateTarget(targetName);
+        await this.#migrateTarget(targetName);
       }
       await this.#addPlugins();
     }
@@ -100,12 +100,12 @@ class ExecutorToPluginMigrator<T> {
     await this.#getCreateNodesResults();
   }
 
-  #migrateTarget(targetName: string) {
+  async #migrateTarget(targetName: string) {
     const include: string[] = [];
     for (const projectName of this.#targetAndProjectsToMigrate.get(
       targetName
     )) {
-      include.push(this.#migrateProject(projectName, targetName));
+      include.push(await this.#migrateProject(projectName, targetName));
     }
 
     this.#pluginToAddForTarget.set(targetName, {
@@ -115,7 +115,7 @@ class ExecutorToPluginMigrator<T> {
     });
   }
 
-  #migrateProject(projectName: string, targetName: string) {
+  async #migrateProject(projectName: string, targetName: string) {
     const projectFromGraph = this.#projectGraph.nodes[projectName];
     const projectConfig = readProjectConfiguration(this.tree, projectName);
 
@@ -131,7 +131,7 @@ class ExecutorToPluginMigrator<T> {
     delete projectTarget.executor;
 
     deleteMatchingProperties(projectTarget, createdTarget);
-    projectTarget = this.#postTargetTransformer(
+    projectTarget = await this.#postTargetTransformer(
       projectTarget,
       this.tree,
       { projectName, root: projectFromGraph.data.root },

packages/devkit/src/generators/plugin-migrations/plugin-migration-utils.ts

@@ -1,4 +1,5 @@
-import type { TargetConfiguration } from 'nx/src/devkit-exports';
+import { relative, resolve } from 'node:path/posix';
+import { workspaceRoot, type TargetConfiguration } from 'nx/src/devkit-exports';
 import { interpolate } from 'nx/src/devkit-internals';
 
 /**
@@ -128,6 +129,24 @@ export function processTargetOutputs(
   target.outputs = targetOutputs;
 }
 
+export function toProjectRelativePath(
+  path: string,
+  projectRoot: string
+): string {
+  if (projectRoot === '.') {
+    // workspace and project root are the same, we add a leading './' which is
+    // required by some tools (e.g. Jest)
+    return path.startsWith('.') ? path : `./${path}`;
+  }
+
+  const relativePath = relative(
+    resolve(workspaceRoot, projectRoot),
+    resolve(workspaceRoot, path)
+  );
+
+  return relativePath.startsWith('.') ? relativePath : `./${relativePath}`;
+}
+
 function updateOutputRenamingOption(
   output: string,
   option: string,

packages/jest/generators.json

@@ -14,6 +14,11 @@
       "schema": "./src/generators/configuration/schema.json",
       "description": "Add Jest configuration to a project.",
       "hidden": true
+    },
+    "convert-to-inferred": {
+      "factory": "./src/generators/convert-to-inferred/convert-to-inferred",
+      "schema": "./src/generators/convert-to-inferred/schema.json",
+      "description": "Convert existing Jest project(s) using `@nx/jest:jest` executor to use `@nx/jest/plugin`."
     }
   }
 }