@nx/cypress 20.7.2 → 20.8.0-beta.0

package/migrations.json

@@ -11,6 +11,42 @@
       "version": "19.6.0-beta.4",
       "description": "Update ciWebServerCommand to use static serve for the application.",
       "implementation": "./src/migrations/update-19-6-0/update-ci-webserver-for-static-serve"
+    },
+    "set-inject-document-domain": {
+      "cli": "nx",
+      "version": "20.8.0-beta.0",
+      "requires": {
+        "cypress": ">=14.0.0"
+      },
+      "description": "Replaces the `experimentalSkipDomainInjection` configuration option with the new `injectDocumentDomain` configuration option.",
+      "implementation": "./src/migrations/update-20-8-0/set-inject-document-domain"
+    },
+    "remove-experimental-fetch-polyfill": {
+      "cli": "nx",
+      "version": "20.8.0-beta.0",
+      "requires": {
+        "cypress": ">=14.0.0"
+      },
+      "description": "Removes the `experimentalFetchPolyfill` configuration option.",
+      "implementation": "./src/migrations/update-20-8-0/remove-experimental-fetch-polyfill"
+    },
+    "replace-experimental-just-in-time-compile": {
+      "cli": "nx",
+      "version": "20.8.0-beta.0",
+      "requires": {
+        "cypress": ">=14.0.0"
+      },
+      "description": "Replaces the `experimentalJustInTimeCompile` configuration option with the new `justInTimeCompile` configuration option.",
+      "implementation": "./src/migrations/update-20-8-0/replace-experimental-just-in-time-compile"
+    },
+    "update-component-testing-mount-imports": {
+      "cli": "nx",
+      "version": "20.8.0-beta.0",
+      "requires": {
+        "cypress": ">=14.0.0"
+      },
+      "description": "Updates the module specifier for the Component Testing `mount` function.",
+      "implementation": "./src/migrations/update-20-8-0/update-component-testing-mount-imports"
     }
   },
   "packageJsonUpdates": {
@@ -59,6 +95,27 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "20.8.0": {
+      "version": "20.8.0-beta.0",
+      "x-prompt": "Do you want to update the Cypress version to v14?",
+      "requires": {
+        "cypress": ">=13.0.0 <14.0.0"
+      },
+      "packages": {
+        "cypress": {
+          "version": "^14.2.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@cypress/vite-dev-server": {
+          "version": "^6.0.3",
+          "alwaysAddToPackageJson": false
+        },
+        "@cypress/webpack-dev-server": {
+          "version": "^4.0.2",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/cypress",
-  "version": "20.7.2",
+  "version": "20.8.0-beta.0",
   "private": false,
   "description": "The Nx Plugin for Cypress contains executors and generators allowing your workspace to use the powerful Cypress integration testing capabilities.",
   "repository": {
@@ -36,15 +36,16 @@
     "migrations": "./migrations.json"
   },
   "dependencies": {
-    "@nx/devkit": "20.7.2",
-    "@nx/eslint": "20.7.2",
-    "@nx/js": "20.7.2",
+    "@nx/devkit": "20.8.0-beta.0",
+    "@nx/eslint": "20.8.0-beta.0",
+    "@nx/js": "20.8.0-beta.0",
     "@phenomnomnominal/tsquery": "~5.0.1",
     "detect-port": "^1.5.1",
+    "semver": "^7.6.3",
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "cypress": ">= 3 < 14"
+    "cypress": ">= 3 < 15"
   },
   "peerDependenciesMeta": {
     "cypress": {

package/src/executors/cypress/cypress.impl.js

@@ -5,11 +5,12 @@ const devkit_1 = require("@nx/devkit");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const ct_helpers_1 = require("../../utils/ct-helpers");
-const cypress_version_1 = require("../../utils/cypress-version");
+const versions_1 = require("../../utils/versions");
 const start_dev_server_1 = require("../../utils/start-dev-server");
 const Cypress = require('cypress'); // @NOTE: Importing via ES6 messes the whole test dependencies.
 async function cypressExecutor(options, context) {
-    options = normalizeOptions(options, context);
+    const installedCypressMajorVersion = (0, versions_1.getInstalledCypressMajorVersion)();
+    options = normalizeOptions(options, context, installedCypressMajorVersion);
     // this is used by cypress component testing presets to build the executor contexts with the correct configuration options.
     process.env.NX_CYPRESS_TARGET_CONFIGURATION = context.configurationName;
     let success;
@@ -19,7 +20,7 @@ async function cypressExecutor(options, context) {
             success = await runCypress(devServerValues.baseUrl, {
                 ...options,
                 portLockFilePath: devServerValues.portLockFilePath,
-            });
+            }, installedCypressMajorVersion);
             if (!options.watch) {
                 generatorInstance.return();
                 break;
@@ -34,7 +35,7 @@ async function cypressExecutor(options, context) {
     }
     return { success };
 }
-function normalizeOptions(options, context) {
+function normalizeOptions(options, context, installedCypressMajorVersion) {
     options.env = options.env || {};
     if (options.testingType === 'component') {
         const project = context?.projectGraph?.nodes?.[context.projectName];
@@ -42,17 +43,17 @@ function normalizeOptions(options, context) {
             options.ctTailwindPath = (0, ct_helpers_1.getTempTailwindPath)(context);
         }
     }
-    checkSupportedBrowser(options);
-    warnDeprecatedHeadless(options);
-    warnDeprecatedCypressVersion();
+    checkSupportedBrowser(options, installedCypressMajorVersion);
+    warnDeprecatedHeadless(options, installedCypressMajorVersion);
+    warnDeprecatedCypressVersion(installedCypressMajorVersion);
     return options;
 }
-function checkSupportedBrowser({ browser }) {
+function checkSupportedBrowser({ browser }, installedCypressMajorVersion) {
     // Browser was not passed in as an option, cypress will use whatever default it has set and we dont need to check it
     if (!browser) {
         return;
     }
-    if ((0, cypress_version_1.installedCypressVersion)() >= 4 && browser == 'canary') {
+    if (installedCypressMajorVersion >= 4 && browser == 'canary') {
         devkit_1.logger.warn((0, devkit_1.stripIndents) `
   Warning:
   You are using a browser that is not supported by cypress v4+.
@@ -63,7 +64,7 @@ function checkSupportedBrowser({ browser }) {
         return;
     }
     const supportedV3Browsers = ['electron', 'chrome', 'canary', 'chromium'];
-    if ((0, cypress_version_1.installedCypressVersion)() <= 3 &&
+    if (installedCypressMajorVersion <= 3 &&
         !supportedV3Browsers.includes(browser)) {
         devkit_1.logger.warn((0, devkit_1.stripIndents) `
     Warning:
@@ -72,8 +73,8 @@ function checkSupportedBrowser({ browser }) {
         return;
     }
 }
-function warnDeprecatedHeadless({ headless }) {
-    if ((0, cypress_version_1.installedCypressVersion)() < 8 || headless === undefined) {
+function warnDeprecatedHeadless({ headless }, installedCypressMajorVersion) {
+    if (installedCypressMajorVersion < 8 || headless === undefined) {
         return;
     }
     if (headless) {
@@ -83,8 +84,8 @@ function warnDeprecatedHeadless({ headless }) {
         devkit_1.logger.warn(deprecatedMsg);
     }
 }
-function warnDeprecatedCypressVersion() {
-    if ((0, cypress_version_1.installedCypressVersion)() < 10) {
+function warnDeprecatedCypressVersion(installedCypressMajorVersion) {
+    if (installedCypressMajorVersion < 10) {
         devkit_1.logger.warn((0, devkit_1.stripIndents) `
 NOTE:
 Support for Cypress versions < 10 is deprecated. Please upgrade to at least Cypress version 10.
@@ -97,8 +98,7 @@ A generator to migrate from v8 to v10 is provided. See https://nx.dev/cypress/v1
  * By default, Cypress will run tests from the CLI without the GUI and provide directly the results in the console output.
  * If `watch` is `true`: Open Cypress in the interactive GUI to interact directly with the application.
  */
-async function runCypress(baseUrl, opts) {
-    const cypressVersion = (0, cypress_version_1.installedCypressVersion)();
+async function runCypress(baseUrl, opts, installedCypressMajorVersion) {
     // Cypress expects the folder where a cypress config is present
     const projectFolderPath = (0, path_1.dirname)(opts.cypressConfig);
     const options = {
@@ -134,7 +134,7 @@ async function runCypress(baseUrl, opts) {
     options.ciBuildId = opts.ciBuildId?.toString();
     options.group = opts.group;
     // renamed in cy 10
-    if (cypressVersion >= 10) {
+    if (installedCypressMajorVersion >= 10) {
         options.config ??= {};
         options.config[opts.testingType] = {
             excludeSpecPattern: opts.ignoreTestFiles,

package/src/generators/component-configuration/component-configuration.d.ts

@@ -1,4 +1,4 @@
-import { ProjectConfiguration, Tree, GeneratorCallback } from '@nx/devkit';
+import { GeneratorCallback, ProjectConfiguration, Tree } from '@nx/devkit';
 import { CypressComponentConfigurationSchema } from './schema';
 export declare function componentConfigurationGenerator(tree: Tree, options: CypressComponentConfigurationSchema): Promise<GeneratorCallback>;
 export declare function componentConfigurationGeneratorInternal(tree: Tree, options: CypressComponentConfigurationSchema): Promise<GeneratorCallback>;

package/src/generators/component-configuration/component-configuration.js

@@ -5,7 +5,6 @@ exports.componentConfigurationGeneratorInternal = componentConfigurationGenerato
 exports.updateTsConfigForComponentTesting = updateTsConfigForComponentTesting;
 const devkit_1 = require("@nx/devkit");
 const ts_solution_setup_1 = require("@nx/js/src/utils/typescript/ts-solution-setup");
-const cypress_version_1 = require("../../utils/cypress-version");
 const versions_1 = require("../../utils/versions");
 const base_setup_1 = require("../base-setup/base-setup");
 const init_1 = require("../init/init");
@@ -19,10 +18,12 @@ async function componentConfigurationGeneratorInternal(tree, options) {
     (0, ts_solution_setup_1.assertNotUsingTsSolutionSetup)(tree, 'cypress', 'component-configuration');
     const tasks = [];
     const opts = normalizeOptions(tree, options);
-    tasks.push(await (0, init_1.default)(tree, {
-        ...opts,
-        skipFormat: true,
-    }));
+    if (!(0, versions_1.getInstalledCypressMajorVersion)(tree)) {
+        tasks.push(await (0, init_1.default)(tree, {
+            ...opts,
+            skipFormat: true,
+        }));
+    }
     const nxJson = (0, devkit_1.readNxJson)(tree);
     const hasPlugin = nxJson.plugins?.some((p) => typeof p === 'string'
         ? p === '@nx/cypress/plugin'
@@ -41,7 +42,7 @@ async function componentConfigurationGeneratorInternal(tree, options) {
     return (0, devkit_1.runTasksInSerial)(...tasks);
 }
 function normalizeOptions(tree, options) {
-    const cyVersion = (0, cypress_version_1.installedCypressVersion)();
+    const cyVersion = (0, versions_1.getInstalledCypressMajorVersion)(tree);
     if (cyVersion && cyVersion < 10) {
         throw new Error('Cypress version of 10 or higher is required to use component testing. See the migration guide to upgrade. https://nx.dev/cypress/v11-migration-guide');
     }
@@ -56,17 +57,19 @@ function normalizeOptions(tree, options) {
     };
 }
 function updateDeps(tree, opts) {
+    const pkgVersions = (0, versions_1.versions)(tree);
     const devDeps = {
-        cypress: versions_1.cypressVersion,
+        cypress: pkgVersions.cypressVersion,
     };
     if (opts.bundler === 'vite') {
-        devDeps['@cypress/vite-dev-server'] = versions_1.cypressViteDevServerVersion;
+        devDeps['@cypress/vite-dev-server'] =
+            pkgVersions.cypressViteDevServerVersion;
     }
     else {
-        devDeps['@cypress/webpack-dev-server'] = versions_1.cypressWebpackVersion;
-        devDeps['html-webpack-plugin'] = versions_1.htmlWebpackPluginVersion;
+        devDeps['@cypress/webpack-dev-server'] = pkgVersions.cypressWebpackVersion;
+        devDeps['html-webpack-plugin'] = pkgVersions.htmlWebpackPluginVersion;
     }
-    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, devDeps);
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, devDeps, undefined, true);
 }
 function addProjectFiles(tree, projectConfig, opts) {
     (0, base_setup_1.addBaseCypressSetup)(tree, {

package/src/generators/configuration/configuration.js

@@ -4,6 +4,7 @@ exports.configurationGenerator = configurationGenerator;
 exports.configurationGeneratorInternal = configurationGeneratorInternal;
 const devkit_1 = require("@nx/devkit");
 const project_name_and_root_utils_1 = require("@nx/devkit/src/generators/project-name-and-root-utils");
+const prompt_1 = require("@nx/devkit/src/generators/prompt");
 const js_1 = require("@nx/js");
 const generator_prompts_1 = require("@nx/js/src/utils/generator-prompts");
 const package_manager_workspaces_1 = require("@nx/js/src/utils/package-manager-workspaces");
@@ -11,11 +12,9 @@ const ts_solution_setup_1 = require("@nx/js/src/utils/typescript/ts-solution-set
 const path_1 = require("path");
 const add_linter_1 = require("../../utils/add-linter");
 const config_1 = require("../../utils/config");
-const cypress_version_1 = require("../../utils/cypress-version");
 const versions_1 = require("../../utils/versions");
 const base_setup_1 = require("../base-setup/base-setup");
 const init_1 = require("../init/init");
-const prompt_1 = require("@nx/devkit/src/generators/prompt");
 function configurationGenerator(tree, options) {
     return configurationGeneratorInternal(tree, {
         addPlugin: false,
@@ -26,7 +25,7 @@ async function configurationGeneratorInternal(tree, options) {
     const opts = await normalizeOptions(tree, options);
     const tasks = [];
     const projectGraph = await (0, devkit_1.createProjectGraphAsync)();
-    if (!(0, cypress_version_1.installedCypressVersion)()) {
+    if (!(0, versions_1.getInstalledCypressMajorVersion)(tree)) {
         tasks.push(await (0, js_1.initGenerator)(tree, { ...options, skipFormat: true }));
         tasks.push(await (0, init_1.default)(tree, {
             ...opts,
@@ -92,13 +91,14 @@ async function configurationGeneratorInternal(tree, options) {
     return (0, devkit_1.runTasksInSerial)(...tasks);
 }
 function ensureDependencies(tree, options) {
+    const pkgVersions = (0, versions_1.versions)(tree);
     const devDependencies = {
-        '@types/node': versions_1.typesNodeVersion,
+        '@types/node': pkgVersions.typesNodeVersion,
     };
     if (options.bundler === 'vite') {
-        devDependencies['vite'] = versions_1.viteVersion;
+        devDependencies['vite'] = pkgVersions.viteVersion;
     }
-    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, devDependencies);
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, devDependencies, undefined, true);
 }
 async function normalizeOptions(tree, options) {
     const linter = await (0, generator_prompts_1.normalizeLinterOption)(tree, options.linter);
@@ -164,7 +164,7 @@ async function promptForMissingServeData(projectName) {
 }
 async function addFiles(tree, options, projectGraph, hasPlugin) {
     const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, options.project);
-    const cyVersion = (0, cypress_version_1.installedCypressVersion)();
+    const cyVersion = (0, versions_1.getInstalledCypressMajorVersion)(tree);
     const filesToUse = cyVersion && cyVersion < 10 ? 'v9' : 'v10';
     const hasTsConfig = tree.exists((0, devkit_1.joinPathFragments)(projectConfig.root, 'tsconfig.json'));
     const offsetFromProjectRoot = options.directory
@@ -245,7 +245,7 @@ async function addFiles(tree, options, projectGraph, hasPlugin) {
 }
 function addTarget(tree, opts, projectGraph) {
     const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, opts.project);
-    const cyVersion = (0, cypress_version_1.installedCypressVersion)();
+    const cyVersion = (0, versions_1.getInstalledCypressMajorVersion)(tree);
     projectConfig.targets ??= {};
     projectConfig.targets.e2e = {
         executor: '@nx/cypress:cypress',

package/src/generators/migrate-to-cypress-11/migrate-to-cypress-11.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.migrateCypressProject = migrateCypressProject;
-const cypress_version_1 = require("../../utils/cypress-version");
 const devkit_1 = require("@nx/devkit");
 const executor_options_utils_1 = require("@nx/devkit/src/generators/executor-options-utils");
+const versions_1 = require("../../utils/versions");
 const conversion_util_1 = require("./conversion.util");
 function migrateCypressExecutorOptions(tree, projectName, target, configuration, previousCypressConfigs) {
     try {
@@ -57,8 +57,8 @@ https://nx.dev/cypress/v10-migration-guide
     }
 }
 async function migrateCypressProject(tree) {
-    (0, cypress_version_1.assertMinimumCypressVersion)(8);
-    if ((0, cypress_version_1.installedCypressVersion)() >= 10) {
+    (0, versions_1.assertMinimumCypressVersion)(8);
+    if ((0, versions_1.getInstalledCypressMajorVersion)(tree) >= 10) {
         devkit_1.logger.info('NX This workspace is already using Cypress v10+');
         return;
     }

package/src/migrations/update-18-1-0/update-cypress-version-13-6-6.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
 const devkit_1 = require("@nx/devkit");
-const cypress_version_1 = require("../../utils/cypress-version");
+const versions_1 = require("../../utils/versions");
 async function default_1(tree) {
-    if ((0, cypress_version_1.installedCypressVersion)() < 13) {
+    if ((0, versions_1.getInstalledCypressMajorVersion)(tree) < 13) {
         return;
     }
     (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { cypress: '^13.6.6' });

package/src/migrations/update-20-8-0/remove-experimental-fetch-polyfill.d.ts

@@ -0,0 +1,2 @@
+import { type Tree } from '@nx/devkit';
+export default function (tree: Tree): Promise<void>;

package/src/migrations/update-20-8-0/remove-experimental-fetch-polyfill.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const config_1 = require("../../utils/config");
+const migrations_1 = require("../../utils/migrations");
+let printer;
+let ts;
+// https://docs.cypress.io/app/references/changelog#:~:text=The%20experimentalFetchPolyfill%20configuration%20option%20was,cy.intercept()%20for%20handling%20fetch%20requests
+async function default_1(tree) {
+    for await (const { cypressConfigPath } of (0, migrations_1.cypressProjectConfigs)(tree)) {
+        if (!tree.exists(cypressConfigPath)) {
+            // cypress config file doesn't exist, so skip
+            continue;
+        }
+        ts ??= (0, ensure_typescript_1.ensureTypescript)();
+        printer ??= ts.createPrinter();
+        const cypressConfig = tree.read(cypressConfigPath, 'utf-8');
+        const updatedConfig = removeExperimentalFetchPolyfill(cypressConfig);
+        tree.write(cypressConfigPath, updatedConfig);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+function removeExperimentalFetchPolyfill(cypressConfig) {
+    const config = (0, config_1.resolveCypressConfigObject)(cypressConfig);
+    if (!config) {
+        // couldn't find the config object, leave as is
+        return cypressConfig;
+    }
+    const sourceFile = tsquery_1.tsquery.ast(cypressConfig);
+    const updatedConfig = ts.factory.updateObjectLiteralExpression(config, config.properties
+        // remove the experimentalFetchPolyfill property from the top level config object
+        .filter((p) => !ts.isPropertyAssignment(p) ||
+        p.name.getText() !== 'experimentalFetchPolyfill')
+        .map((p) => {
+        if (ts.isPropertyAssignment(p) &&
+            ['component', 'e2e'].includes(p.name.getText()) &&
+            ts.isObjectLiteralExpression(p.initializer)) {
+            // remove the experimentalFetchPolyfill property from the component or e2e config object
+            return ts.factory.updatePropertyAssignment(p, p.name, ts.factory.updateObjectLiteralExpression(p.initializer, p.initializer.properties.filter((ip) => !ts.isPropertyAssignment(ip) ||
+                ip.name.getText() !== 'experimentalFetchPolyfill')));
+        }
+        return p;
+    }));
+    return cypressConfig.replace(config.getText(), printer.printNode(ts.EmitHint.Unspecified, updatedConfig, sourceFile));
+}

package/src/migrations/update-20-8-0/replace-experimental-just-in-time-compile.d.ts

@@ -0,0 +1,2 @@
+import { type Tree } from '@nx/devkit';
+export default function (tree: Tree): Promise<void>;

package/src/migrations/update-20-8-0/replace-experimental-just-in-time-compile.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const config_utils_1 = require("@nx/devkit/src/utils/config-utils");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const node_path_1 = require("node:path");
+const config_1 = require("../../utils/config");
+const migrations_1 = require("../../utils/migrations");
+let printer;
+let ts;
+// https://docs.cypress.io/app/references/migration-guide#CT-Just-in-Time-Compile-changes
+async function default_1(tree) {
+    for await (const { cypressConfigPath } of (0, migrations_1.cypressProjectConfigs)(tree)) {
+        if (!tree.exists(cypressConfigPath)) {
+            // cypress config file doesn't exist, so skip
+            continue;
+        }
+        const updatedConfig = await updateCtJustInTimeCompile(tree, cypressConfigPath);
+        tree.write(cypressConfigPath, updatedConfig);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+async function updateCtJustInTimeCompile(tree, cypressConfigPath) {
+    const cypressConfig = tree.read(cypressConfigPath, 'utf-8');
+    const config = (0, config_1.resolveCypressConfigObject)(cypressConfig);
+    if (!config) {
+        // couldn't find the config object, leave as is
+        return cypressConfig;
+    }
+    if (!(0, migrations_1.getObjectProperty)(config, 'component')) {
+        // no component config, leave as is
+        return cypressConfig;
+    }
+    ts ??= (0, ensure_typescript_1.ensureTypescript)();
+    printer ??= ts.createPrinter();
+    const sourceFile = tsquery_1.tsquery.ast(cypressConfig);
+    let updatedConfig = config;
+    const bundler = await resolveBundler(updatedConfig, cypressConfigPath);
+    const isViteBundler = bundler === 'vite';
+    const existingJustInTimeCompileProperty = (0, migrations_1.getObjectProperty)(updatedConfig, 'experimentalJustInTimeCompile');
+    if (existingJustInTimeCompileProperty) {
+        if (isViteBundler ||
+            existingJustInTimeCompileProperty.initializer.kind ===
+                ts.SyntaxKind.TrueKeyword) {
+            // if it's using vite or it's set to true (the new default value), remove it
+            updatedConfig = (0, migrations_1.removeObjectProperty)(updatedConfig, existingJustInTimeCompileProperty);
+        }
+        else {
+            // rename to justInTimeCompile
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, existingJustInTimeCompileProperty, { newName: 'justInTimeCompile' });
+        }
+    }
+    const componentProperty = (0, migrations_1.getObjectProperty)(updatedConfig, 'component');
+    if (componentProperty &&
+        ts.isObjectLiteralExpression(componentProperty.initializer)) {
+        const componentConfigObject = componentProperty.initializer;
+        const existingJustInTimeCompileProperty = (0, migrations_1.getObjectProperty)(componentConfigObject, 'experimentalJustInTimeCompile');
+        if (existingJustInTimeCompileProperty) {
+            if (isViteBundler ||
+                existingJustInTimeCompileProperty.initializer.kind ===
+                    ts.SyntaxKind.TrueKeyword) {
+                // if it's using vite or it's set to true (the new default value), remove it
+                updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, componentProperty, {
+                    newValue: (0, migrations_1.removeObjectProperty)(componentConfigObject, existingJustInTimeCompileProperty),
+                });
+            }
+            else {
+                // rename to justInTimeCompile
+                updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, componentProperty, {
+                    newValue: (0, migrations_1.updateObjectProperty)(componentConfigObject, existingJustInTimeCompileProperty, { newName: 'justInTimeCompile' }),
+                });
+            }
+        }
+    }
+    return cypressConfig.replace(config.getText(), printer.printNode(ts.EmitHint.Unspecified, updatedConfig, sourceFile));
+}
+async function resolveBundler(config, cypressConfigPath) {
+    const bundlerProperty = tsquery_1.tsquery.query(config, 'PropertyAssignment:has(Identifier[name=component]) PropertyAssignment:has(Identifier[name=devServer]) PropertyAssignment:has(Identifier[name=bundler])')[0];
+    if (bundlerProperty) {
+        return ts.isStringLiteral(bundlerProperty.initializer)
+            ? bundlerProperty.initializer.getText().replace(/['"`]/g, '')
+            : null;
+    }
+    try {
+        // we can't statically resolve the bundler from the config, so we load the config
+        const cypressConfig = await (0, config_utils_1.loadConfigFile)((0, node_path_1.join)(devkit_1.workspaceRoot, cypressConfigPath));
+        return cypressConfig.component?.devServer?.bundler;
+    }
+    catch {
+        return null;
+    }
+}

package/src/migrations/update-20-8-0/set-inject-document-domain.d.ts

@@ -0,0 +1,2 @@
+import { type Tree } from '@nx/devkit';
+export default function (tree: Tree): Promise<void>;

package/src/migrations/update-20-8-0/set-inject-document-domain.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const config_1 = require("../../utils/config");
+const migrations_1 = require("../../utils/migrations");
+let printer;
+let ts;
+// https://docs.cypress.io/app/references/migration-guide#Changes-to-cyorigin
+// https://docs.cypress.io/app/references/changelog#:~:text=The%20experimentalSkipDomainInjection%20configuration%20has%20been,injectDocumentDomain%20configuration
+async function default_1(tree) {
+    for await (const { cypressConfigPath } of (0, migrations_1.cypressProjectConfigs)(tree)) {
+        if (!tree.exists(cypressConfigPath)) {
+            // cypress config file doesn't exist, so skip
+            continue;
+        }
+        ts ??= (0, ensure_typescript_1.ensureTypescript)();
+        printer ??= ts.createPrinter();
+        const cypressConfig = tree.read(cypressConfigPath, 'utf-8');
+        const updatedConfig = setInjectDocumentDomain(cypressConfig);
+        tree.write(cypressConfigPath, updatedConfig);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+function setInjectDocumentDomain(cypressConfig) {
+    const config = (0, config_1.resolveCypressConfigObject)(cypressConfig);
+    if (!config) {
+        // couldn't find the config object, leave as is
+        return cypressConfig;
+    }
+    const sourceFile = tsquery_1.tsquery.ast(cypressConfig);
+    let e2eProperty = (0, migrations_1.getObjectProperty)(config, 'e2e');
+    let componentProperty = (0, migrations_1.getObjectProperty)(config, 'component');
+    let updatedConfig = config;
+    const topLevelExperimentalSkipDomainInjectionProperty = (0, migrations_1.getObjectProperty)(updatedConfig, 'experimentalSkipDomainInjection');
+    const topLevelSkipDomainState = !topLevelExperimentalSkipDomainInjectionProperty
+        ? 'not-set'
+        : !ts.isArrayLiteralExpression(topLevelExperimentalSkipDomainInjectionProperty.initializer) ||
+            topLevelExperimentalSkipDomainInjectionProperty.initializer.elements
+                .length > 0
+            ? 'skipping'
+            : 'not-skipping';
+    let e2eSkipDomainState = 'not-set';
+    if (e2eProperty) {
+        let experimentalSkipDomainInjectionProperty;
+        let isObjectLiteral = false;
+        if (ts.isObjectLiteralExpression(e2eProperty.initializer)) {
+            experimentalSkipDomainInjectionProperty = (0, migrations_1.getObjectProperty)(e2eProperty.initializer, 'experimentalSkipDomainInjection');
+            isObjectLiteral = true;
+        }
+        if (experimentalSkipDomainInjectionProperty) {
+            e2eSkipDomainState =
+                !ts.isArrayLiteralExpression(experimentalSkipDomainInjectionProperty.initializer) ||
+                    experimentalSkipDomainInjectionProperty.initializer.elements.length > 0
+                    ? 'skipping'
+                    : 'not-skipping';
+        }
+        if (e2eSkipDomainState === 'not-set' &&
+            topLevelSkipDomainState === 'not-set') {
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, e2eProperty, {
+                newValue: setInjectDocumentDomainInObject(e2eProperty.initializer),
+            });
+        }
+        else if (e2eSkipDomainState === 'not-skipping') {
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, e2eProperty, {
+                newValue: replaceExperimentalSkipDomainInjectionInObject(e2eProperty.initializer),
+            });
+        }
+        else if (e2eSkipDomainState === 'skipping') {
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, e2eProperty, {
+                newValue: (0, migrations_1.removeObjectProperty)(
+                // we only determine that it's skipping if it's an object literal
+                e2eProperty.initializer, (0, migrations_1.getObjectProperty)(e2eProperty.initializer, 'experimentalSkipDomainInjection')),
+            });
+        }
+    }
+    let componentSkipDomainState = 'not-set';
+    if (componentProperty) {
+        let experimentalSkipDomainInjectionProperty;
+        let isObjectLiteral = false;
+        if (ts.isObjectLiteralExpression(componentProperty.initializer)) {
+            experimentalSkipDomainInjectionProperty = (0, migrations_1.getObjectProperty)(componentProperty.initializer, 'experimentalSkipDomainInjection');
+            isObjectLiteral = true;
+        }
+        if (experimentalSkipDomainInjectionProperty) {
+            componentSkipDomainState =
+                !ts.isArrayLiteralExpression(experimentalSkipDomainInjectionProperty.initializer) ||
+                    experimentalSkipDomainInjectionProperty.initializer.elements.length > 0
+                    ? 'skipping'
+                    : 'not-skipping';
+        }
+        if (componentSkipDomainState === 'not-set' &&
+            topLevelSkipDomainState === 'not-set') {
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, componentProperty, {
+                newValue: setInjectDocumentDomainInObject(componentProperty.initializer),
+            });
+        }
+        else if (componentSkipDomainState === 'not-skipping') {
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, componentProperty, {
+                newValue: replaceExperimentalSkipDomainInjectionInObject(componentProperty.initializer),
+            });
+        }
+        else if (componentSkipDomainState === 'skipping') {
+            updatedConfig = (0, migrations_1.updateObjectProperty)(updatedConfig, componentProperty, {
+                newValue: (0, migrations_1.removeObjectProperty)(
+                // we only determine that it's skipping if it's an object literal
+                componentProperty.initializer, (0, migrations_1.getObjectProperty)(componentProperty.initializer, 'experimentalSkipDomainInjection')),
+            });
+        }
+    }
+    if (topLevelSkipDomainState === 'not-set' &&
+        !e2eProperty &&
+        !componentProperty) {
+        updatedConfig = setInjectDocumentDomainInObject(updatedConfig);
+    }
+    else if (topLevelSkipDomainState === 'not-skipping') {
+        updatedConfig =
+            replaceExperimentalSkipDomainInjectionInObject(updatedConfig);
+    }
+    else if (topLevelSkipDomainState === 'skipping') {
+        updatedConfig = (0, migrations_1.removeObjectProperty)(updatedConfig, topLevelExperimentalSkipDomainInjectionProperty);
+    }
+    return cypressConfig.replace(config.getText(), printer.printNode(ts.EmitHint.Unspecified, updatedConfig, sourceFile));
+}
+function setInjectDocumentDomainInObject(config) {
+    let configToUpdate;
+    if (ts.isObjectLiteralExpression(config)) {
+        configToUpdate = config;
+    }
+    else {
+        // spread the current expression into a new object literal
+        configToUpdate = ts.factory.createObjectLiteralExpression([
+            ts.factory.createSpreadAssignment(config),
+        ]);
+    }
+    return ts.factory.updateObjectLiteralExpression(configToUpdate, ts.factory.createNodeArray([
+        ...configToUpdate.properties,
+        getInjectDocumentDomainPropertyAssignment(),
+    ]));
+}
+function replaceExperimentalSkipDomainInjectionInObject(config) {
+    let configToUpdate;
+    if (ts.isObjectLiteralExpression(config)) {
+        configToUpdate = config;
+    }
+    else {
+        // spread the current expression into a new object literal
+        configToUpdate = ts.factory.createObjectLiteralExpression([
+            ts.factory.createSpreadAssignment(config),
+        ]);
+    }
+    return ts.factory.updateObjectLiteralExpression(configToUpdate, configToUpdate.properties.map((property) => property.name?.getText() === 'experimentalSkipDomainInjection'
+        ? getInjectDocumentDomainPropertyAssignment()
+        : property));
+}
+function getInjectDocumentDomainPropertyAssignment() {
+    return ts.addSyntheticLeadingComment(ts.addSyntheticLeadingComment(ts.factory.createPropertyAssignment(ts.factory.createIdentifier('injectDocumentDomain'), ts.factory.createTrue()), ts.SyntaxKind.SingleLineCommentTrivia, ' Please ensure you use `cy.origin()` when navigating between domains and remove this option.'), ts.SyntaxKind.SingleLineCommentTrivia, ' See https://docs.cypress.io/app/references/migration-guide#Changes-to-cyorigin');
+}

package/src/migrations/update-20-8-0/update-component-testing-mount-imports.d.ts

@@ -0,0 +1,2 @@
+import { type Tree } from '@nx/devkit';
+export default function (tree: Tree): Promise<void>;

package/src/migrations/update-20-8-0/update-component-testing-mount-imports.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const semver_1 = require("semver");
+const config_1 = require("../../utils/config");
+const migrations_1 = require("../../utils/migrations");
+let printer;
+let ts;
+async function default_1(tree) {
+    const projectGraph = await (0, devkit_1.createProjectGraphAsync)();
+    for await (const { cypressConfigPath, projectName, projectConfig, } of (0, migrations_1.cypressProjectConfigs)(tree)) {
+        if (!tree.exists(cypressConfigPath)) {
+            // cypress config file doesn't exist, so skip
+            continue;
+        }
+        ts ??= (0, ensure_typescript_1.ensureTypescript)();
+        printer ??= ts.createPrinter();
+        const migrationInfo = parseMigrationInfo(tree, cypressConfigPath, projectName, projectGraph);
+        if (!migrationInfo) {
+            continue;
+        }
+        if (migrationInfo.framework === 'angular') {
+            migrateAngularFramework(tree, projectConfig, migrationInfo.isLegacyVersion);
+        }
+        else if (migrationInfo.framework === 'react') {
+            migrateReactFramework(tree, projectConfig);
+        }
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+function parseMigrationInfo(tree, cypressConfigPath, projectName, projectGraph) {
+    const cypressConfig = tree.read(cypressConfigPath, 'utf-8');
+    const config = (0, config_1.resolveCypressConfigObject)(cypressConfig);
+    if (!config) {
+        // couldn't find the config object, leave as is
+        return null;
+    }
+    if (!(0, migrations_1.getObjectProperty)(config, 'component')) {
+        // no component config, leave as is
+        return null;
+    }
+    const framework = resolveFramework(cypressConfig, config, projectName, projectGraph);
+    if (framework === 'react') {
+        return { framework: 'react' };
+    }
+    if (framework === 'angular') {
+        const angularCoreDep = projectGraph.dependencies[projectName].find((d) => 
+        // account for possible different versions of angular core
+        d.target.startsWith('npm:@angular/core'));
+        if (angularCoreDep) {
+            const angularVersion = projectGraph.externalNodes?.[angularCoreDep.target]?.data?.version;
+            if ((0, semver_1.valid)(angularVersion) && (0, semver_1.lt)(angularVersion, '17.2.0')) {
+                return {
+                    framework: 'angular',
+                    isLegacyVersion: true,
+                };
+            }
+        }
+        return {
+            framework: 'angular',
+            isLegacyVersion: false,
+        };
+    }
+    return null;
+}
+function resolveFramework(cypressConfig, config, projectName, projectGraph) {
+    const frameworkProperty = tsquery_1.tsquery.query(config, 'PropertyAssignment:has(Identifier[name=component]) PropertyAssignment:has(Identifier[name=devServer]) PropertyAssignment:has(Identifier[name=framework])')[0];
+    if (frameworkProperty) {
+        return ts.isStringLiteral(frameworkProperty.initializer)
+            ? frameworkProperty.initializer.getText().replace(/['"`]/g, '')
+            : null;
+    }
+    // component might be assigned to an Nx preset function call, so we try to
+    // infer the framework from the Nx preset import
+    const sourceFile = tsquery_1.tsquery.ast(cypressConfig);
+    const nxPresetModuleSpecifiers = [
+        '@nx/angular/plugins/component-testing',
+        '@nx/react/plugins/component-testing',
+        '@nx/next/plugins/component-testing',
+        '@nx/remix/plugins/component-testing',
+    ];
+    const nxPresetImportModuleSpecifier = sourceFile.statements
+        .find((s) => ts.isImportDeclaration(s) &&
+        nxPresetModuleSpecifiers.includes(s.moduleSpecifier.getText().replace(/['"`]/g, '')))
+        ?.moduleSpecifier.getText()
+        .replace(/['"`]/g, '');
+    if (nxPresetImportModuleSpecifier) {
+        const plugin = nxPresetImportModuleSpecifier.split('/').at(1);
+        return plugin === 'angular' ? 'angular' : 'react';
+    }
+    // it might be set to something else, so we fall back to checking the
+    // project dependencies
+    if (projectGraph.dependencies[projectName]?.some((d) => d.target.startsWith('npm:@angular/core'))) {
+        return 'angular';
+    }
+    if (projectGraph.dependencies[projectName]?.some((d) => d.target.startsWith('npm:react') || d.target.startsWith('npm:next'))) {
+        return 'react';
+    }
+    return null;
+}
+// https://docs.cypress.io/app/references/migration-guide#Angular-1720-CT-no-longer-supported
+function migrateAngularFramework(tree, projectConfig, isLegacyVersion) {
+    (0, devkit_1.visitNotIgnoredFiles)(tree, projectConfig.root, (filePath) => {
+        if (!isJsTsFile(filePath)) {
+            return;
+        }
+        const content = tree.read(filePath, 'utf-8');
+        let updatedFileContent;
+        if (isLegacyVersion) {
+            let needPackage = false;
+            updatedFileContent = tsquery_1.tsquery.replace(content, 'ImportDeclaration', importTransformerFactory(content, 'cypress/angular', '@cypress/angular', () => {
+                needPackage = true;
+            }));
+            if (needPackage) {
+                (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@cypress/angular': '^2.1.0' }, undefined, true);
+            }
+        }
+        else {
+            updatedFileContent = tsquery_1.tsquery.replace(content, 'ImportDeclaration', importTransformerFactory(content, 'cypress/angular-signals', 'cypress/angular'));
+        }
+        tree.write(filePath, updatedFileContent);
+    });
+}
+// https://docs.cypress.io/app/references/migration-guide#React-18-CT-no-longer-supported
+function migrateReactFramework(tree, projectConfig) {
+    (0, devkit_1.visitNotIgnoredFiles)(tree, projectConfig.root, (filePath) => {
+        if (!isJsTsFile(filePath)) {
+            return;
+        }
+        const content = tree.read(filePath, 'utf-8');
+        const updatedContent = tsquery_1.tsquery.replace(content, 'ImportDeclaration', importTransformerFactory(content, 'cypress/react18', 'cypress/react'));
+        tree.write(filePath, updatedContent);
+    });
+}
+function importTransformerFactory(fileContent, sourceModuleSpecifier, targetModuleSpecifier, matchImportCallback) {
+    return (node) => {
+        if (node.moduleSpecifier.getText().replace(/['"`]/g, '') ===
+            sourceModuleSpecifier) {
+            matchImportCallback?.();
+            const updatedImport = ts.factory.updateImportDeclaration(node, node.modifiers, node.importClause, ts.factory.createStringLiteral(targetModuleSpecifier), node.attributes);
+            return printer.printNode(ts.EmitHint.Unspecified, updatedImport, tsquery_1.tsquery.ast(fileContent));
+        }
+        return node.getText();
+    };
+}
+function isJsTsFile(filePath) {
+    return /\.[cm]?[jt]sx?$/.test(filePath);
+}

package/src/utils/add-linter.js

@@ -3,11 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addLinterToCyProject = addLinterToCyProject;
 const devkit_1 = require("@nx/devkit");
 const eslint_1 = require("@nx/eslint");
-const cypress_version_1 = require("./cypress-version");
-const versions_1 = require("./versions");
-const eslint_file_1 = require("@nx/eslint/src/generators/utils/eslint-file");
 const global_eslint_config_1 = require("@nx/eslint/src/generators/init/global-eslint-config");
+const eslint_file_1 = require("@nx/eslint/src/generators/utils/eslint-file");
 const flat_config_1 = require("@nx/eslint/src/utils/flat-config");
+const versions_1 = require("./versions");
 async function addLinterToCyProject(tree, options) {
     if (options.linter === eslint_1.Linter.None) {
         return () => { };
@@ -31,9 +30,10 @@ async function addLinterToCyProject(tree, options) {
         return (0, devkit_1.runTasksInSerial)(...tasks);
     }
     options.overwriteExisting = options.overwriteExisting || !eslintFile;
-    tasks.push(!options.skipPackageJson
-        ? (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { 'eslint-plugin-cypress': versions_1.eslintPluginCypressVersion })
-        : () => { });
+    if (!options.skipPackageJson) {
+        const pkgVersions = (0, versions_1.versions)(tree);
+        tasks.push((0, devkit_1.addDependenciesToPackageJson)(tree, {}, { 'eslint-plugin-cypress': pkgVersions.eslintPluginCypressVersion }));
+    }
     if ((0, eslint_file_1.isEslintConfigSupported)(tree, projectConfig.root) ||
         (0, eslint_file_1.isEslintConfigSupported)(tree)) {
         const overrides = [];
@@ -53,7 +53,7 @@ async function addLinterToCyProject(tree, options) {
             const addExtendsTask = (0, eslint_file_1.addExtendsToLintConfig)(tree, projectConfig.root, 'plugin:cypress/recommended');
             tasks.push(addExtendsTask);
         }
-        const cyVersion = (0, cypress_version_1.installedCypressVersion)();
+        const cyVersion = (0, versions_1.getInstalledCypressMajorVersion)(tree);
         /**
          * We need this override because we enabled allowJS in the tsconfig to allow for JS based Cypress tests.
          * That however leads to issues with the CommonJS Cypress plugin file.

package/src/utils/config.d.ts

@@ -1,4 +1,5 @@
 import { type Tree } from '@nx/devkit';
+import type { ObjectLiteralExpression } from 'typescript';
 import type { NxComponentTestingOptions, NxCypressE2EPresetOptions } from '../../plugins/cypress-preset';
 export declare const CYPRESS_CONFIG_FILE_NAME_PATTERN = "cypress.config.{js,ts,mjs,cjs}";
 export declare function addDefaultE2EConfig(cyConfigContents: string, options: NxCypressE2EPresetOptions, baseUrl: string): Promise<string>;
@@ -15,3 +16,4 @@ export declare function addDefaultCTConfig(cyConfigContents: string, options?: N
  **/
 export declare function addMountDefinition(cmpCommandFileContents: string): Promise<string>;
 export declare function getProjectCypressConfigPath(tree: Tree, projectRoot: string): string;
+export declare function resolveCypressConfigObject(cypressConfigContents: string): ObjectLiteralExpression | null;

package/src/utils/config.js

@@ -5,7 +5,9 @@ exports.addDefaultE2EConfig = addDefaultE2EConfig;
 exports.addDefaultCTConfig = addDefaultCTConfig;
 exports.addMountDefinition = addMountDefinition;
 exports.getProjectCypressConfigPath = getProjectCypressConfigPath;
+exports.resolveCypressConfigObject = resolveCypressConfigObject;
 const devkit_1 = require("@nx/devkit");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
 exports.CYPRESS_CONFIG_FILE_NAME_PATTERN = 'cypress.config.{js,ts,mjs,cjs}';
 const TS_QUERY_COMMON_JS_EXPORT_SELECTOR = 'BinaryExpression:has(Identifier[name="module"]):has(Identifier[name="exports"])';
 const TS_QUERY_EXPORT_CONFIG_PREFIX = `:matches(ExportAssignment, ${TS_QUERY_COMMON_JS_EXPORT_SELECTOR}) `;
@@ -117,3 +119,47 @@ function getProjectCypressConfigPath(tree, projectRoot) {
     }
     return cypressConfigPaths[0];
 }
+function resolveCypressConfigObject(cypressConfigContents) {
+    const ts = (0, ensure_typescript_1.ensureTypescript)();
+    const { tsquery } = (require('@phenomnomnominal/tsquery'));
+    const sourceFile = tsquery.ast(cypressConfigContents);
+    const exportDefaultStatement = sourceFile.statements.find((statement) => ts.isExportAssignment(statement));
+    if (exportDefaultStatement) {
+        return resolveCypressConfigObjectFromExportExpression(exportDefaultStatement.expression, sourceFile);
+    }
+    const moduleExportsStatement = sourceFile.statements.find((statement) => ts.isExpressionStatement(statement) &&
+        ts.isBinaryExpression(statement.expression) &&
+        statement.expression.left.getText() === 'module.exports');
+    if (moduleExportsStatement) {
+        return resolveCypressConfigObjectFromExportExpression(moduleExportsStatement.expression.right, sourceFile);
+    }
+    return null;
+}
+function resolveCypressConfigObjectFromExportExpression(exportExpression, sourceFile) {
+    const ts = (0, ensure_typescript_1.ensureTypescript)();
+    if (ts.isObjectLiteralExpression(exportExpression)) {
+        return exportExpression;
+    }
+    if (ts.isIdentifier(exportExpression)) {
+        // try to locate the identifier in the source file
+        const variableStatements = sourceFile.statements.filter((statement) => ts.isVariableStatement(statement));
+        for (const variableStatement of variableStatements) {
+            for (const declaration of variableStatement.declarationList
+                .declarations) {
+                if (ts.isIdentifier(declaration.name) &&
+                    declaration.name.getText() === exportExpression.getText() &&
+                    ts.isObjectLiteralExpression(declaration.initializer)) {
+                    return declaration.initializer;
+                }
+            }
+        }
+        return null;
+    }
+    if (ts.isCallExpression(exportExpression) &&
+        ts.isIdentifier(exportExpression.expression) &&
+        exportExpression.expression.getText() === 'defineConfig' &&
+        ts.isObjectLiteralExpression(exportExpression.arguments[0])) {
+        return exportExpression.arguments[0];
+    }
+    return null;
+}

package/src/utils/cypress-version.d.ts

@@ -1,5 +1,11 @@
+/**
+ * @deprecated use the `getInstalledCypressMajorVersion` exported from
+ * `@nx/cypress/src/utils/versions` instead. It will be removed in v22.
+ */
 export declare function installedCypressVersion(): number;
 /**
  * will not throw if cypress is not installed
+ * @deprecated use the `assertMinimumCypressVersion` exported from
+ * `@nx/cypress/src/utils/versions` instead. It will be removed in v22.
  */
 export declare function assertMinimumCypressVersion(minVersion: number): void;

package/src/utils/cypress-version.js

@@ -4,6 +4,10 @@ exports.installedCypressVersion = installedCypressVersion;
 exports.assertMinimumCypressVersion = assertMinimumCypressVersion;
 let cypressPackageJson;
 let loadedCypress = false;
+/**
+ * @deprecated use the `getInstalledCypressMajorVersion` exported from
+ * `@nx/cypress/src/utils/versions` instead. It will be removed in v22.
+ */
 function installedCypressVersion() {
     if (!loadedCypress) {
         try {
@@ -23,6 +27,8 @@ function installedCypressVersion() {
 }
 /**
  * will not throw if cypress is not installed
+ * @deprecated use the `assertMinimumCypressVersion` exported from
+ * `@nx/cypress/src/utils/versions` instead. It will be removed in v22.
  */
 function assertMinimumCypressVersion(minVersion) {
     const version = installedCypressVersion();

package/src/utils/migrations.d.ts

@@ -0,0 +1,13 @@
+import { type ProjectConfiguration, type Tree } from '@nx/devkit';
+import type { Expression, ObjectLiteralExpression, PropertyAssignment } from 'typescript';
+export declare function cypressProjectConfigs(tree: Tree): AsyncGenerator<{
+    projectName: string;
+    projectConfig: ProjectConfiguration;
+    cypressConfigPath: string;
+}>;
+export declare function getObjectProperty(config: ObjectLiteralExpression, name: string): PropertyAssignment | undefined;
+export declare function removeObjectProperty(config: ObjectLiteralExpression, property: PropertyAssignment): ObjectLiteralExpression;
+export declare function updateObjectProperty(config: ObjectLiteralExpression, property: PropertyAssignment, { newName, newValue }: {
+    newName?: string;
+    newValue?: Expression;
+}): ObjectLiteralExpression;

package/src/utils/migrations.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cypressProjectConfigs = cypressProjectConfigs;
+exports.getObjectProperty = getObjectProperty;
+exports.removeObjectProperty = removeObjectProperty;
+exports.updateObjectProperty = updateObjectProperty;
+const devkit_1 = require("@nx/devkit");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+const path_1 = require("path");
+const config_1 = require("./config");
+let ts;
+async function* cypressProjectConfigs(tree) {
+    const projects = (0, devkit_1.getProjects)(tree);
+    for (const [projectName, projectConfig] of projects) {
+        const targetWithExecutor = Object.values(projectConfig.targets ?? {}).find((target) => target.executor === '@nx/cypress:cypress');
+        if (targetWithExecutor) {
+            for (const [, options] of allTargetOptions(targetWithExecutor)) {
+                if (options.cypressConfig) {
+                    yield {
+                        projectName,
+                        projectConfig,
+                        cypressConfigPath: options.cypressConfig,
+                    };
+                }
+            }
+        }
+        else {
+            // might be using the crystal plugin
+            const result = await (0, devkit_1.globAsync)(tree, [
+                path_1.posix.join(projectConfig.root, config_1.CYPRESS_CONFIG_FILE_NAME_PATTERN),
+            ]);
+            if (result.length > 0) {
+                yield {
+                    projectName,
+                    projectConfig,
+                    cypressConfigPath: result[0],
+                };
+            }
+        }
+    }
+}
+function getObjectProperty(config, name) {
+    ts ??= (0, ensure_typescript_1.ensureTypescript)();
+    return config.properties.find((p) => ts.isPropertyAssignment(p) && p.name.getText() === name);
+}
+function removeObjectProperty(config, property) {
+    ts ??= (0, ensure_typescript_1.ensureTypescript)();
+    return ts.factory.updateObjectLiteralExpression(config, config.properties.filter((p) => p !== property));
+}
+function updateObjectProperty(config, property, { newName, newValue }) {
+    ts ??= (0, ensure_typescript_1.ensureTypescript)();
+    if (!newName && !newValue) {
+        throw new Error('newName or newValue must be provided');
+    }
+    return ts.factory.updateObjectLiteralExpression(config, config.properties.map((p) => p === property
+        ? ts.factory.updatePropertyAssignment(p, newName ? ts.factory.createIdentifier(newName) : p.name, newValue ? newValue : p.initializer)
+        : p));
+}
+function* allTargetOptions(target) {
+    if (target.options) {
+        yield [undefined, target.options];
+    }
+    if (!target.configurations) {
+        return;
+    }
+    for (const [name, options] of Object.entries(target.configurations)) {
+        if (options !== undefined) {
+            yield [name, options];
+        }
+    }
+}

package/src/utils/versions.d.ts

@@ -1,8 +1,21 @@
+import { type Tree } from '@nx/devkit';
 export declare const nxVersion: any;
 export declare const eslintPluginCypressVersion = "^3.5.0";
 export declare const typesNodeVersion = "18.16.9";
-export declare const cypressViteDevServerVersion = "^2.2.1";
-export declare const cypressVersion = "^13.13.0";
-export declare const cypressWebpackVersion = "^3.8.0";
-export declare const viteVersion = "~5.0.0";
+export declare const cypressViteDevServerVersion = "^6.0.3";
+export declare const cypressVersion = "^14.2.1";
+export declare const cypressWebpackVersion = "^4.0.2";
+export declare const viteVersion = "^6.0.0";
 export declare const htmlWebpackPluginVersion = "^5.5.0";
+export declare function versions(tree: Tree, cypressMajorVersion?: number): Omit<typeof import("./versions"), "versions" | "getInstalledCypressMajorVersion" | "assertMinimumCypressVersion"> | {
+    nxVersion: any;
+    eslintPluginCypressVersion: string;
+    typesNodeVersion: string;
+    cypressViteDevServerVersion: string;
+    cypressVersion: string;
+    cypressWebpackVersion: string;
+    viteVersion: string;
+    htmlWebpackPluginVersion: string;
+};
+export declare function getInstalledCypressMajorVersion(tree?: Tree): number | null;
+export declare function assertMinimumCypressVersion(minVersion: number, tree?: Tree): void;

package/src/utils/versions.js

@@ -1,11 +1,90 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.htmlWebpackPluginVersion = exports.viteVersion = exports.cypressWebpackVersion = exports.cypressVersion = exports.cypressViteDevServerVersion = exports.typesNodeVersion = exports.eslintPluginCypressVersion = exports.nxVersion = void 0;
+exports.versions = versions;
+exports.getInstalledCypressMajorVersion = getInstalledCypressMajorVersion;
+exports.assertMinimumCypressVersion = assertMinimumCypressVersion;
+const devkit_1 = require("@nx/devkit");
+const semver_1 = require("semver");
 exports.nxVersion = require('../../package.json').version;
 exports.eslintPluginCypressVersion = '^3.5.0';
 exports.typesNodeVersion = '18.16.9';
-exports.cypressViteDevServerVersion = '^2.2.1';
-exports.cypressVersion = '^13.13.0';
-exports.cypressWebpackVersion = '^3.8.0';
-exports.viteVersion = '~5.0.0';
+exports.cypressViteDevServerVersion = '^6.0.3';
+exports.cypressVersion = '^14.2.1';
+exports.cypressWebpackVersion = '^4.0.2';
+exports.viteVersion = '^6.0.0';
 exports.htmlWebpackPluginVersion = '^5.5.0';
+const latestVersions = {
+    nxVersion: exports.nxVersion,
+    eslintPluginCypressVersion: exports.eslintPluginCypressVersion,
+    typesNodeVersion: exports.typesNodeVersion,
+    cypressViteDevServerVersion: exports.cypressViteDevServerVersion,
+    cypressVersion: exports.cypressVersion,
+    cypressWebpackVersion: exports.cypressWebpackVersion,
+    viteVersion: exports.viteVersion,
+    htmlWebpackPluginVersion: exports.htmlWebpackPluginVersion,
+};
+function versions(tree, cypressMajorVersion = getInstalledCypressMajorVersion(tree)) {
+    if (!cypressMajorVersion) {
+        return latestVersions;
+    }
+    if (cypressMajorVersion > 14) {
+        throw new Error(`Unsupported Cypress version: ${exports.cypressVersion}`);
+    }
+    if (cypressMajorVersion === 14) {
+        return latestVersions;
+    }
+    return {
+        nxVersion: exports.nxVersion,
+        eslintPluginCypressVersion: '^3.5.0',
+        typesNodeVersion: '18.16.9',
+        cypressViteDevServerVersion: '^2.2.1',
+        cypressVersion: '^13.13.0',
+        cypressWebpackVersion: '^3.8.0',
+        viteVersion: '~5.0.0',
+        htmlWebpackPluginVersion: '^5.5.0',
+    };
+}
+function getInstalledCypressMajorVersion(tree) {
+    try {
+        let version;
+        if (tree) {
+            version = getCypressVersionFromTree(tree);
+        }
+        else {
+            version = getCypressVersionFromFileSystem();
+        }
+        return version ? (0, semver_1.major)(version) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function assertMinimumCypressVersion(minVersion, tree) {
+    const version = getInstalledCypressMajorVersion(tree);
+    if (version && version < minVersion) {
+        throw new Error(`Cypress version of ${minVersion} or higher is not installed. Expected Cypress v${minVersion}+, found Cypress v${version} instead.`);
+    }
+}
+function getCypressVersionFromTree(tree) {
+    const packageJson = (0, devkit_1.readJson)(tree, 'package.json');
+    const installedVersion = packageJson.devDependencies?.cypress ?? packageJson.dependencies?.cypress;
+    if (!installedVersion) {
+        return null;
+    }
+    if (installedVersion === 'latest' || installedVersion === 'next') {
+        return (0, semver_1.clean)(exports.cypressVersion) ?? (0, semver_1.coerce)(exports.cypressVersion)?.version;
+    }
+    return (0, semver_1.clean)(installedVersion) ?? (0, semver_1.coerce)(installedVersion)?.version;
+}
+function getCypressVersionFromFileSystem() {
+    let packageJson;
+    try {
+        packageJson = require('cypress/package.json');
+    }
+    catch { }
+    if (!packageJson) {
+        return null;
+    }
+    return packageJson.version;
+}