@nx/cypress 24.0.0-beta.2 → 24.0.0-beta.3

package/dist/internal.d.ts

@@ -2,4 +2,4 @@ export * from './src/utils/versions';
 export * from './src/utils/ct-helpers';
 export * from './src/utils/find-target-options';
 export * from './src/utils/config';
-export type { CypressExecutorOptions } from './src/executors/cypress/cypress.impl';
+export type { CypressExecutorOptions } from './src/executors/cypress/schema';

package/dist/src/executors/cypress/{cypress.impl.d.ts → schema.d.ts}

@@ -1,4 +1,3 @@
-import { ExecutorContext } from '@nx/devkit';
 export type Json = {
     [k: string]: any;
 };
@@ -7,10 +6,6 @@ export interface CypressExecutorOptions extends Json {
     watch?: boolean;
     devServerTarget?: string;
     headed?: boolean;
-    /**
-     * @deprecated Cypress runs headless by default. Use the --watch flag to
-     * control head/headless behavior instead. It will be removed in Nx v23.
-     **/
     headless?: boolean;
     exit?: boolean;
     key?: string;
@@ -33,6 +28,3 @@ export interface CypressExecutorOptions extends Json {
     runnerUi?: boolean;
     autoCancelAfterFailures?: boolean | number;
 }
-export default function cypressExecutor(options: CypressExecutorOptions, context: ExecutorContext): Promise<{
-    success: any;
-}>;

package/dist/src/executors/cypress/schema.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -8,21 +8,17 @@ const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const internal_2 = require("@nx/js/internal");
 const assert_supported_cypress_version_1 = require("../../utils/assert-supported-cypress-version");
-const deprecation_1 = require("../../utils/deprecation");
 const versions_1 = require("../../utils/versions");
 const base_setup_1 = require("../base-setup/base-setup");
-const init_1 = tslib_1.__importDefault(require("../init/init"));
+const init_1 = tslib_1.__importStar(require("../init/init"));
 function componentConfigurationGenerator(tree, options) {
-    return componentConfigurationGeneratorInternal(tree, {
-        addPlugin: false,
-        ...options,
-    });
+    return componentConfigurationGeneratorInternal(tree, options);
 }
 async function componentConfigurationGeneratorInternal(tree, options) {
     (0, assert_supported_cypress_version_1.assertSupportedCypressVersion)(tree);
     (0, internal_2.assertNotUsingTsSolutionSetup)(tree, 'cypress', 'component-configuration');
     const tasks = [];
-    const opts = normalizeOptions(tree, options);
+    const opts = normalizeOptions(options);
     if (opts.bundler === 'vite') {
         (0, versions_1.assertViteSupportsInstalledCypress)(tree);
     }
@@ -38,29 +34,18 @@ async function componentConfigurationGeneratorInternal(tree, options) {
             skipFormat: true,
         }));
     }
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    const hasPlugin = nxJson.plugins?.some((p) => typeof p === 'string'
-        ? p === '@nx/cypress/plugin'
-        : p.plugin === '@nx/cypress/plugin');
+    await (0, init_1.addPlugin)(tree, await (0, devkit_1.createProjectGraphAsync)(), false);
     const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, opts.project);
     addProjectFiles(tree, projectConfig, opts);
-    if (!hasPlugin || opts.addExplicitTargets) {
-        (0, deprecation_1.warnCypressExecutorGenerating)();
-        addTargetToProject(tree, projectConfig, opts);
-    }
-    updateNxJsonConfiguration(tree, hasPlugin);
+    updateNxJsonConfiguration(tree);
     updateTsConfigForComponentTesting(tree, projectConfig);
     if (!opts.skipFormat) {
         await (0, devkit_1.formatFiles)(tree);
     }
     return (0, devkit_1.runTasksInSerial)(...tasks);
 }
-function normalizeOptions(tree, options) {
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    const addPlugin = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
+function normalizeOptions(options) {
     return {
-        addPlugin,
         ...options,
         framework: options.framework ?? null,
         directory: options.directory ?? 'cypress',
@@ -107,17 +92,7 @@ function addProjectFiles(tree, projectConfig, opts) {
         ext: '',
     });
 }
-function addTargetToProject(tree, projectConfig, opts) {
-    projectConfig.targets['component-test'] = {
-        executor: '@nx/cypress:cypress',
-        options: {
-            cypressConfig: (0, devkit_1.joinPathFragments)(projectConfig.root, 'cypress.config.ts'),
-            testingType: 'component',
-        },
-    };
-    (0, devkit_1.updateProjectConfiguration)(tree, opts.project, projectConfig);
-}
-function updateNxJsonConfiguration(tree, hasPlugin) {
+function updateNxJsonConfiguration(tree) {
     const nxJson = (0, devkit_1.readNxJson)(tree);
     const productionFileSet = nxJson.namedInputs?.production;
     if (productionFileSet) {
@@ -128,31 +103,6 @@ function updateNxJsonConfiguration(tree, hasPlugin) {
             '!{projectRoot}/cypress.config.[jt]s',
         ]));
     }
-    if (!hasPlugin) {
-        const cacheableOperations = nxJson.tasksRunnerOptions?.default?.options?.cacheableOperations;
-        if (cacheableOperations &&
-            !cacheableOperations.includes('component-test')) {
-            cacheableOperations.push('component-test');
-        }
-        // Either a `target: 'component-test'` default or a default keyed on
-        // the executor we're scaffolding will apply to the new target — pick
-        // the more specific (target-keyed) when both are present.
-        const existingForTarget = (0, internal_1.findTargetDefault)(nxJson.targetDefaults, {
-            target: 'component-test',
-        });
-        const existingForExecutor = (0, internal_1.findTargetDefault)(nxJson.targetDefaults, {
-            executor: '@nx/cypress:cypress',
-        });
-        const existing = existingForTarget ?? existingForExecutor;
-        (0, internal_1.upsertTargetDefault)(tree, nxJson, {
-            target: 'component-test',
-            cache: existing?.cache ?? true,
-            inputs: existing?.inputs ?? [
-                'default',
-                productionFileSet ? '^production' : '^default',
-            ],
-        });
-    }
     (0, devkit_1.updateNxJson)(tree, nxJson);
 }
 function updateTsConfigForComponentTesting(tree, projectConfig) {

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

@@ -4,12 +4,10 @@ export interface CypressComponentConfigurationSchema {
   directory?: string;
   bundler?: 'webpack' | 'vite';
   jsx?: boolean;
-  addPlugin?: boolean;
   skipPackageJson?: boolean;
 
   /**
    * @internal
    */
-  addExplicitTargets?: boolean;
   framework?: 'next';
 }

package/dist/src/generators/configuration/configuration.d.ts

@@ -21,7 +21,6 @@ export interface CypressE2EConfigSchema {
     webServerCommands?: Record<string, string>;
     ciWebServerCommand?: string;
     ciBaseUrl?: string;
-    addPlugin?: boolean;
 }
 export declare function configurationGenerator(tree: Tree, options: CypressE2EConfigSchema): Promise<GeneratorCallback>;
 export declare function configurationGeneratorInternal(tree: Tree, options: CypressE2EConfigSchema): Promise<GeneratorCallback>;

package/dist/src/generators/configuration/configuration.js

@@ -11,15 +11,11 @@ const path_1 = require("path");
 const add_linter_1 = require("../../utils/add-linter");
 const assert_supported_cypress_version_1 = require("../../utils/assert-supported-cypress-version");
 const config_1 = require("../../utils/config");
-const deprecation_1 = require("../../utils/deprecation");
 const versions_1 = require("../../utils/versions");
 const base_setup_1 = require("../base-setup/base-setup");
 const init_1 = tslib_1.__importStar(require("../init/init"));
 function configurationGenerator(tree, options) {
-    return configurationGeneratorInternal(tree, {
-        addPlugin: false,
-        ...options,
-    });
+    return configurationGeneratorInternal(tree, options);
 }
 async function configurationGeneratorInternal(tree, options) {
     (0, assert_supported_cypress_version_1.assertSupportedCypressVersion)(tree);
@@ -33,18 +29,10 @@ async function configurationGeneratorInternal(tree, options) {
             skipFormat: true,
         }));
     }
-    else if (opts.addPlugin) {
+    else {
         await (0, init_1.addPlugin)(tree, projectGraph, false);
     }
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    const hasPlugin = nxJson.plugins?.some((p) => typeof p === 'string'
-        ? p === '@nx/cypress/plugin'
-        : p.plugin === '@nx/cypress/plugin');
-    await addFiles(tree, opts, projectGraph, hasPlugin);
-    if (!hasPlugin) {
-        (0, deprecation_1.warnCypressExecutorGenerating)();
-        addTarget(tree, opts, projectGraph);
-    }
+    await addFiles(tree, opts, projectGraph);
     const projectTsConfigPath = (0, devkit_1.joinPathFragments)(opts.projectRoot, 'tsconfig.json');
     if (tree.exists(projectTsConfigPath)) {
         (0, devkit_1.updateJson)(tree, projectTsConfigPath, (json) => {
@@ -130,10 +118,6 @@ In this case you need to provide a devServerTarget,'<projectName>:<targetName>[:
     if (!options.baseUrl && !devServerTarget) {
         throw new Error('Either baseUrl or devServerTarget must be provided');
     }
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    options.addPlugin ??=
-        process.env.NX_ADD_PLUGINS !== 'false' &&
-            nxJson.useInferencePlugins !== false;
     return {
         ...options,
         bundler: options.bundler ?? 'webpack',
@@ -166,7 +150,7 @@ async function promptForMissingServeData(projectName) {
         baseUrl: `http://localhost:${port}`,
     };
 }
-async function addFiles(tree, options, projectGraph, hasPlugin) {
+async function addFiles(tree, options, projectGraph) {
     const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, options.project);
     const hasTsConfig = tree.exists((0, devkit_1.joinPathFragments)(projectConfig.root, 'tsconfig.json'));
     const offsetFromProjectRoot = options.directory
@@ -194,12 +178,12 @@ async function addFiles(tree, options, projectGraph, hasPlugin) {
     let webServerCommands;
     let ciWebServerCommand;
     let ciBaseUrl;
-    if (hasPlugin && options.webServerCommands && options.ciWebServerCommand) {
+    if (options.webServerCommands && options.ciWebServerCommand) {
         webServerCommands = options.webServerCommands;
         ciWebServerCommand = options.ciWebServerCommand;
         ciBaseUrl = options.ciBaseUrl;
     }
-    else if (hasPlugin && options.devServerTarget) {
+    else if (options.devServerTarget) {
         webServerCommands = {};
         webServerCommands.default = 'nx run ' + options.devServerTarget;
         const parsedTarget = (0, devkit_1.parseTargetString)(options.devServerTarget, projectGraph);
@@ -214,6 +198,13 @@ async function addFiles(tree, options, projectGraph, hasPlugin) {
             ciWebServerCommand = `nx run ${parsedTarget.project}:serve-static`;
         }
     }
+    if (typeof options.port === 'number') {
+        for (const name of Object.keys(webServerCommands ?? {})) {
+            webServerCommands[name] += ` --port=${options.port}`;
+        }
+        if (ciWebServerCommand)
+            ciWebServerCommand += ` --port=${options.port}`;
+    }
     const e2ePresetOptions = {
         cypressDir: options.directory,
         bundler: options.bundler === 'vite' ? 'vite' : undefined,
@@ -242,48 +233,6 @@ async function addFiles(tree, options, projectGraph, hasPlugin) {
         (0, devkit_1.toJS)(tree);
     }
 }
-function addTarget(tree, opts, projectGraph) {
-    const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, opts.project);
-    projectConfig.targets ??= {};
-    projectConfig.targets.e2e = {
-        executor: '@nx/cypress:cypress',
-        options: {
-            cypressConfig: (0, devkit_1.joinPathFragments)(projectConfig.root, `cypress.config.${opts.js ? 'js' : 'ts'}`),
-            testingType: 'e2e',
-        },
-    };
-    if (opts.devServerTarget) {
-        const parsedTarget = (0, devkit_1.parseTargetString)(opts.devServerTarget, projectGraph);
-        projectConfig.targets.e2e.options = {
-            ...projectConfig.targets.e2e.options,
-            devServerTarget: opts.devServerTarget,
-            port: opts.port,
-        };
-        const devServerProjectConfig = (0, devkit_1.readProjectConfiguration)(tree, parsedTarget.project);
-        // Add production e2e target if serve target is found
-        if (parsedTarget.configuration !== 'production' &&
-            devServerProjectConfig.targets?.[parsedTarget.target]?.configurations?.['production']) {
-            projectConfig.targets.e2e.configurations ??= {};
-            projectConfig.targets.e2e.configurations['production'] = {
-                devServerTarget: `${parsedTarget.project}:${parsedTarget.target}:production`,
-            };
-        }
-        // Add ci/static e2e target if serve target is found
-        if (devServerProjectConfig.targets?.['serve-static']) {
-            projectConfig.targets.e2e.configurations ??= {};
-            projectConfig.targets.e2e.configurations.ci = {
-                devServerTarget: `${parsedTarget.project}:serve-static`,
-            };
-        }
-    }
-    else if (opts.baseUrl) {
-        projectConfig.targets.e2e.options = {
-            ...projectConfig.targets.e2e.options,
-            baseUrl: opts.baseUrl,
-        };
-    }
-    (0, devkit_1.updateProjectConfiguration)(tree, opts.project, projectConfig);
-}
 function createPackageJson(tree, options) {
     const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, options.project);
     const packageJsonPath = (0, devkit_1.joinPathFragments)(projectConfig.root, 'package.json');

package/dist/src/generators/init/init.js

@@ -8,40 +8,6 @@ const devkit_1 = require("@nx/devkit");
 const plugin_1 = require("../../plugins/plugin");
 const assert_supported_cypress_version_1 = require("../../utils/assert-supported-cypress-version");
 const versions_1 = require("../../utils/versions");
-function setupE2ETargetDefaults(tree) {
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    if (!nxJson.namedInputs) {
-        return;
-    }
-    // E2e targets depend on all their project's sources + production sources of dependencies
-    const productionFileSet = !!nxJson.namedInputs?.production;
-    const existing = findExistingE2eDefault(nxJson.targetDefaults);
-    const patch = {};
-    if (existing?.cache === undefined)
-        patch.cache = true;
-    if (existing?.inputs === undefined) {
-        patch.inputs = ['default', productionFileSet ? '^production' : '^default'];
-    }
-    if (Object.keys(patch).length > 0) {
-        (0, internal_1.upsertTargetDefault)(tree, nxJson, { target: 'e2e', ...patch });
-        (0, devkit_1.updateNxJson)(tree, nxJson);
-    }
-}
-function findExistingE2eDefault(td) {
-    if (!td)
-        return undefined;
-    const value = td['e2e'];
-    if (value === undefined)
-        return undefined;
-    if (Array.isArray(value)) {
-        const found = value.find((e) => e.filter === undefined);
-        if (!found)
-            return undefined;
-        const { filter: _f, ...rest } = found;
-        return rest;
-    }
-    return value;
-}
 function updateDependencies(tree, options) {
     const tasks = [];
     tasks.push((0, devkit_1.removeDependenciesFromPackageJson)(tree, ['@nx/cypress'], []));
@@ -86,21 +52,12 @@ function updateProductionFileset(tree) {
     (0, devkit_1.updateNxJson)(tree, nxJson);
 }
 async function cypressInitGenerator(tree, options) {
-    return cypressInitGeneratorInternal(tree, { addPlugin: false, ...options });
+    return cypressInitGeneratorInternal(tree, options);
 }
 async function cypressInitGeneratorInternal(tree, options) {
     (0, assert_supported_cypress_version_1.assertSupportedCypressVersion)(tree);
     updateProductionFileset(tree);
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    options.addPlugin ??=
-        process.env.NX_ADD_PLUGINS !== 'false' &&
-            nxJson.useInferencePlugins !== false;
-    if (options.addPlugin) {
-        await addPlugin(tree, await (0, devkit_1.createProjectGraphAsync)(), options.updatePackageScripts);
-    }
-    else {
-        setupE2ETargetDefaults(tree);
-    }
+    await addPlugin(tree, await (0, devkit_1.createProjectGraphAsync)(), options.updatePackageScripts);
     let installTask = () => { };
     if (!options.skipPackageJson) {
         installTask = updateDependencies(tree, options);

package/dist/src/generators/init/schema.d.ts

@@ -3,5 +3,4 @@ export interface Schema {
   skipPackageJson?: boolean;
   keepExistingVersions?: boolean;
   updatePackageScripts?: boolean;
-  addPlugin?: boolean;
 }

package/dist/src/migrations/update-23-3-0/adapt-query-command-overwrites.md

@@ -8,7 +8,7 @@ Cypress 16 turned `cy.getCookie()`, `cy.getCookies()`, `cy.getAllCookies()`, `cy
 
 Confirm both conditions before changing anything. If either fails, make no changes and stop.
 
-1. `<files_changed>` or `<advisory_context>` lists at least one file with a renamed `Cypress.Commands.overwriteQuery()` call. Search the workspace for `Cypress.Commands.overwriteQuery(` if the wrapper sections are absent.
+1. `impl.changes` or `impl.agentContext` in the step's `nx_migrate_prompt` block lists at least one file with a renamed `Cypress.Commands.overwriteQuery()` call. Search the workspace for `Cypress.Commands.overwriteQuery(` if those fields are absent.
 2. The workspace is on Cypress 16 or later (`cypress` in `package.json`).
 
 ## Step 1: Verify the pre-pass

package/dist/src/migrations/update-23-3-0/ai-instructions-for-cypress-16.md

@@ -9,7 +9,7 @@ Migrate the workspace's Cypress projects from Cypress 15 to 16. Cypress 16 remov
 1. Confirm `cypress` in `package.json` resolves to 16 or later. If it does not, make no changes and stop.
 2. Confirm Node is 22, 24, or 26+ (`node -v`). Cypress 16 declares `engines` `^22.0.0 || ^24.0.0 || >=26.0.0` and refuses to install on Node 20 or 25.
 3. List the Cypress projects: every project with a `cypress.config.{ts,js,mjs,cjs}` file. Search their spec and support files for the strings in the steps below.
-4. Review `<advisory_context>` from the deterministic migrations: each entry (a non-literal `experimentalFastVisibility`, a removed `execTimeout`, a removed `experimentalSourceRewriting: true`, an unresolved spread, a renamed `overwriteQuery` callback) is pending work for the matching step.
+4. When the step's `nx_migrate_prompt` block has `impl.agentContext`, review the deterministic migrations' entries in it: each entry (a non-literal `experimentalFastVisibility`, a removed `execTimeout`, a removed `experimentalSourceRewriting: true`, an unresolved spread, a renamed `overwriteQuery` callback) is pending work for the matching step.
 
 ## Step 1: Replace `Cypress.env()`
 
@@ -139,7 +139,7 @@ it('renders on mobile', { viewportWidth: 375 }, () => {
 
 `cy.getCookie()`, `cy.getCookies()`, `cy.getAllCookies()`, `cy.getAllLocalStorage()` and `cy.getAllSessionStorage()` are queries: they retry assertions chained with `.should()` and follow `defaultCommandTimeout` (4000ms) instead of `responseTimeout` (30000ms). A `.then()` callback still runs once and does not retry. Change nothing unless a test fails; then move the assertion from `.then()` onto `.should()` so it retries, or pass `{ timeout }` when a cookie read needs longer than 4 seconds.
 
-The deterministic migration renamed `Cypress.Commands.overwrite()` to `overwriteQuery()` for those five names; `<advisory_context>` lists each renamed call. Do not re-apply the rename. Adapt each renamed callback to the query contract: `overwriteQuery` calls the callback with the command as `this`, the original query function as the first argument, and then the arguments the test passed, and the callback must return a function that takes the subject. Cypress calls that returned function, possibly many times while retrying, to compute the result. It must not return a chainable, call `cy.*` commands or use `.then()`. The original query reads `this` as well, so every callback must be a `function` expression that calls `originalFn.call(this, ...)`. An arrow callback, or a plain `originalFn(...)` call, fails to typecheck (TS2684, `QueryFnWithOriginalFn` declares `this: Command`) and throws at runtime. Convert arrow callbacks even when they only forward their arguments:
+The deterministic migration renamed `Cypress.Commands.overwrite()` to `overwriteQuery()` for those five names; `impl.agentContext` lists each renamed call when present, and otherwise search the workspace for `Cypress.Commands.overwriteQuery(`. Do not re-apply the rename. Adapt each renamed callback to the query contract: `overwriteQuery` calls the callback with the command as `this`, the original query function as the first argument, and then the arguments the test passed, and the callback must return a function that takes the subject. Cypress calls that returned function, possibly many times while retrying, to compute the result. It must not return a chainable, call `cy.*` commands or use `.then()`. The original query reads `this` as well, so every callback must be a `function` expression that calls `originalFn.call(this, ...)`. An arrow callback, or a plain `originalFn(...)` call, fails to typecheck (TS2684, `QueryFnWithOriginalFn` declares `this: Command`) and throws at runtime. Convert arrow callbacks even when they only forward their arguments:
 
 **Before:**
 

package/dist/src/migrations/update-24-0-0/finish-inferred-conversion.md

@@ -0,0 +1,12 @@
+# Replace removed @nx/cypress executors with inferred tasks
+
+Nx 24 removed `@nx/cypress:cypress` (including old `@nrwl` aliases).
+
+Before changing anything, check for leftover work: a project target, a package.json target or a `targetDefaults` entry still uses a removed executor, or the advisory context reports a conversion error. If none applies, make no changes and stop. Treat each advisory-context item as pending work.
+
+1. Inspect all affected projects and workspace defaults. Repair config-loading errors first. Do not restore executor registrations or install older Nx packages.
+2. Preserve Cypress config, browser choice, testing type, CI options and dev-server orchestration. Ensure webServerCommands/target dependencies start the intended app.
+3. Register `@nx/cypress/plugin` with options/includes that preserve custom target names and mixed inferred/explicit projects. Replace remaining removed-executor targets, including those in package.json and filtered targetDefaults. Transfer their behavior before removing obsolete defaults. Preserve configurations, dependencies, cache inputs/outputs and environment behavior. Do not silently delete unsupported options or unrelated targets. Migrate old @nrwl aliases too.
+4. Run project graph creation with the daemon and graph cache disabled (`NX_DAEMON=false NX_CACHE_PROJECT_GRAPH=false`), using the workspace package manager. Inspect resolved project targets and verify each migrated entrypoint exists and is inferred (a thin alias to an inferred target is acceptable). Resolve graph errors before completing this migration, even if task validation was skipped. Configs must load for subsequent migrations.
+5. By default run relevant real builds/tests with task cache disabled, including alternate configurations. Honor an existing preference to skip expensive task validation; otherwise offer that option when validation is slow. Skipping expensive tasks never skips conversion or the graph check. Report each skipped task as unverified. Never weaken assertions or change application behavior to make checks pass.
+6. Report converted projects, graph validation, task results and any skipped checks. Unconverted targets or a broken graph mean the migration is incomplete. Investigate task failures and distinguish missing environment prerequisites from conversion regressions; do not claim a working workspace with unresolved regressions.

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.d.ts

@@ -0,0 +1,6 @@
+import type { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<{
+    nextSteps?: string[];
+    agentContext?: string[];
+    skipAgentic?: boolean;
+}>;

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const internal_1 = require("@nx/devkit/internal");
+function update(tree) {
+    return (0, internal_1.migrateRemovedExecutors)(tree, ['@nx/cypress:cypress', '@nrwl/cypress:cypress'], async (tree, options) => {
+        const { convertToInferred } = require('../../generators/convert-to-inferred/convert-to-inferred');
+        return convertToInferred(tree, options);
+    });
+}

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.md

@@ -0,0 +1,61 @@
+#### Convert `@nx/cypress:cypress` targets to inferred tasks
+
+Nx 24 removes the `@nx/cypress:cypress` executor and its `@nrwl/cypress:cypress` alias. The migration registers `@nx/cypress/plugin` in `nx.json` and converts the targets that use those executors to inferred tasks. It moves the dev server and `baseUrl` settings into `cypress.config.*`. A target with nothing left to override is removed from project configuration. When several projects share the same remaining options, those options move to a `targetDefaults` entry scoped to the plugin. `targetDefaults` entries keyed by a removed executor are removed once no target uses that executor.
+
+The migration lists the targets the converter cannot convert safely. In agentic runs, an AI prompt finishes them and validates the project graph.
+
+#### Sample code changes
+
+##### Before
+
+```json title="myapp-e2e/project.json"
+{
+  "name": "myapp-e2e",
+  "targets": {
+    "e2e": {
+      "executor": "@nx/cypress:cypress",
+      "options": {
+        "cypressConfig": "myapp-e2e/cypress.config.ts",
+        "testingType": "e2e",
+        "devServerTarget": "myapp:serve"
+      },
+      "configurations": {
+        "ci": {
+          "devServerTarget": "myapp:static-serve"
+        }
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="myapp-e2e/project.json"
+{
+  "name": "myapp-e2e",
+  "targets": {
+    "e2e": {
+      "options": {
+        "config-file": "./cypress.config.ts"
+      }
+    }
+  }
+}
+```
+
+```json title="nx.json"
+{
+  "plugins": [
+    {
+      "plugin": "@nx/cypress/plugin",
+      "options": {
+        "ciTargetName": "e2e-ci",
+        "componentTestingTargetName": "component-test",
+        "openTargetName": "open-cypress",
+        "targetName": "e2e"
+      }
+    }
+  ]
+}
+```

package/dist/src/plugins/plugin.js

@@ -297,7 +297,7 @@ async function buildCypressTargets(configFilePath, projectRoot, options, context
                 else {
                     targets[targetName].parallelism = false;
                 }
-                targets[targetName] = (0, internal_1.applyTestFileDirectives)(targets[targetName], context.workspaceRoot, file, ['depends-on', 'ultracache']);
+                targets[targetName] = (0, internal_1.applyTestFileDirectives)(targets[targetName], context.workspaceRoot, file, { ignoreServerInputs: true });
             }
             targets[options.ciTargetName] = {
                 executor: 'nx:noop',

package/dist/src/utils/add-linter.d.ts

@@ -21,6 +21,5 @@ export interface CyLinterOptions {
      * This is useful when adding linting to a brand new project vs an existing one
      **/
     overwriteExisting?: boolean;
-    addPlugin?: boolean;
 }
 export declare function addLinterToCyProject(tree: Tree, options: CyLinterOptions): Promise<GeneratorCallback>;

package/dist/src/utils/add-linter.js

@@ -24,7 +24,6 @@ async function addLinterToCyProject(tree, options) {
             enableTypedLinting,
             skipPackageJson: options.skipPackageJson,
             rootProject: options.rootProject,
-            addPlugin: options.addPlugin,
         }));
     }
     // Everything below configures ESLint — predefined configs, `extends`, ignore

package/executors.json

@@ -1,9 +1,3 @@
 {
-  "executors": {
-    "cypress": {
-      "implementation": "./dist/src/executors/cypress/cypress.impl",
-      "schema": "./dist/src/executors/cypress/schema.json",
-      "description": "Run Cypress E2E tests."
-    }
-  }
+  "executors": {}
 }

package/migrations.json

@@ -108,6 +108,13 @@
       "implementation": "./dist/src/migrations/update-23-3-0/upgrade-to-cypress-16",
       "prompt": "./dist/src/migrations/update-23-3-0/ai-instructions-for-cypress-16.md",
       "documentation": "./dist/src/migrations/update-23-3-0/upgrade-to-cypress-16.md"
+    },
+    "remove-deprecated-executors": {
+      "version": "24.0.0-beta.3",
+      "description": "Converts targets using the removed `@nx/cypress` executors to inferred tasks; an AI prompt finishes the targets the converter cannot convert safely and validates the project graph.",
+      "implementation": "./dist/src/migrations/update-24-0-0/remove-deprecated-executors",
+      "prompt": "./dist/src/migrations/update-24-0-0/finish-inferred-conversion.md",
+      "documentation": "./dist/src/migrations/update-24-0-0/remove-deprecated-executors.md"
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/cypress",
-  "version": "24.0.0-beta.2",
+  "version": "24.0.0-beta.3",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -10,7 +10,7 @@
     "executors.json",
     "generators.json"
   ],
-  "description": "The Nx Plugin for Cypress contains executors and generators allowing your workspace to use the powerful Cypress integration testing capabilities.",
+  "description": "The Nx Plugin for Cypress infers tasks and provides generators allowing your workspace to use the powerful Cypress integration testing capabilities.",
   "repository": {
     "type": "git",
     "url": "https://github.com/nrwl/nx.git",
@@ -84,17 +84,16 @@
     "supportsOptionalMigrations": true
   },
   "dependencies": {
-    "@nx/devkit": "24.0.0-beta.2",
-    "@nx/eslint": "24.0.0-beta.2",
-    "@nx/js": "24.0.0-beta.2",
+    "@nx/devkit": "24.0.0-beta.3",
+    "@nx/eslint": "24.0.0-beta.3",
+    "@nx/js": "24.0.0-beta.3",
     "@phenomnomnominal/tsquery": "~6.2.0",
-    "detect-port": "^2.1.0",
     "semver": "^7.6.3",
     "tree-kill": "^1.2.2",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
-    "nx": "24.0.0-beta.2"
+    "nx": "24.0.0-beta.3"
   },
   "peerDependencies": {
     "cypress": ">= 13 < 17"

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

@@ -1,136 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = cypressExecutor;
-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 deprecation_1 = require("../../utils/deprecation");
-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) {
-    (0, deprecation_1.warnCypressExecutorDeprecation)();
-    options = normalizeOptions(options, context);
-    // 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;
-    const generatorInstance = (0, start_dev_server_1.startDevServer)(options, context);
-    for await (const devServerValues of generatorInstance) {
-        try {
-            success = await runCypress(devServerValues.baseUrl, {
-                ...options,
-                portLockFilePath: devServerValues.portLockFilePath,
-            });
-            if (!options.watch) {
-                generatorInstance.return();
-                break;
-            }
-        }
-        catch (e) {
-            devkit_1.logger.error(e.message);
-            success = false;
-            if (!options.watch)
-                break;
-        }
-    }
-    return { success };
-}
-function normalizeOptions(options, context) {
-    options.env = options.env || {};
-    options.testingType ??= 'e2e';
-    if (options.testingType === 'component') {
-        const project = context?.projectGraph?.nodes?.[context.projectName];
-        if (project?.data?.root) {
-            options.ctTailwindPath = (0, ct_helpers_1.getTempTailwindPath)(context);
-        }
-    }
-    return options;
-}
-/**
- * @whatItDoes Initialize the Cypress test runner with the provided project configuration.
- * 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) {
-    // Cypress expects the folder where a cypress config is present
-    const projectFolderPath = (0, path_1.dirname)(opts.cypressConfig);
-    const options = {
-        project: projectFolderPath,
-        configFile: (0, path_1.basename)(opts.cypressConfig),
-    };
-    // If not, will use the `baseUrl` normally from `cypress.json`
-    if (baseUrl) {
-        options.config = { baseUrl };
-    }
-    if (opts.browser) {
-        options.browser = opts.browser;
-    }
-    if (opts.env) {
-        options.env = {
-            ...options.env,
-            ...opts.env,
-        };
-    }
-    if (opts.spec) {
-        options.spec = opts.spec;
-    }
-    options.tag = opts.tag;
-    options.exit = opts.exit;
-    options.headed = opts.headed;
-    options.runnerUi = opts.runnerUi;
-    if (opts.headless) {
-        options.headless = opts.headless;
-    }
-    options.record = opts.record;
-    options.key = opts.key;
-    options.parallel = opts.parallel;
-    options.ciBuildId = opts.ciBuildId?.toString();
-    options.group = opts.group;
-    // renamed in cy 10
-    options.config ??= {};
-    options.config[opts.testingType] = {
-        excludeSpecPattern: opts.ignoreTestFiles,
-    };
-    if (opts.reporter) {
-        options.reporter = opts.reporter;
-    }
-    if (opts.reporterOptions) {
-        options.reporterOptions = opts.reporterOptions;
-    }
-    if (opts.quiet) {
-        options.quiet = opts.quiet;
-    }
-    if (opts.autoCancelAfterFailures !== undefined) {
-        options.autoCancelAfterFailures = opts.autoCancelAfterFailures;
-    }
-    options.testingType = opts.testingType;
-    const result = await (opts.watch
-        ? Cypress.open(options)
-        : Cypress.run(options));
-    cleanupTmpFile(opts.ctTailwindPath);
-    cleanupTmpFile(opts.portLockFilePath);
-    if (process.env.NX_VERBOSE_LOGGING === 'true' && opts.portLockFilePath) {
-        (0, fs_1.readdirSync)((0, path_1.dirname)(opts.portLockFilePath)).forEach((f) => {
-            if (f.endsWith('.txt')) {
-                devkit_1.logger.debug(`Lock file ${f} still present`);
-            }
-        });
-    }
-    /**
-     * `cypress.open` is returning `0` and is not of the same type as `cypress.run`.
-     * `cypress.open` is the graphical UI, so it will be obvious to know what wasn't
-     * working. Forcing the build to success when `cypress.open` is used.
-     */
-    return !result.totalFailed && !result.failures;
-}
-function cleanupTmpFile(path) {
-    try {
-        if (path && (0, fs_1.existsSync)(path)) {
-            (0, fs_1.unlinkSync)(path);
-        }
-        return true;
-    }
-    catch (err) {
-        return false;
-    }
-}

package/dist/src/executors/cypress/schema.json

@@ -1,186 +0,0 @@
-{
-  "version": 2,
-  "title": "Cypress Target",
-  "description": "Run Cypress for e2e, integration and component testing.",
-  "type": "object",
-  "outputCapture": "pipe",
-  "cli": "nx",
-  "x-deprecated": "The `@nx/cypress:cypress` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/cypress:convert-to-inferred` to migrate to the `@nx/cypress/plugin` inferred plugin. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.",
-  "presets": [
-    {
-      "name": "Starting Dev Server",
-      "keys": ["cypressConfig", "devServerTarget"]
-    },
-    {
-      "name": "Custom Base Url",
-      "keys": ["cypressConfig", "baseUrl"]
-    },
-    {
-      "name": "Component Testing",
-      "keys": ["cypressConfig", "devServerTarget", "testingType", "skipServe"]
-    }
-  ],
-  "properties": {
-    "cypressConfig": {
-      "type": "string",
-      "description": "The path of the Cypress configuration json file.",
-      "x-completion-type": "file",
-      "x-completion-glob": "cypress?(*)@(.js|.ts|.json)"
-    },
-    "watch": {
-      "type": "boolean",
-      "description": "Recompile and run tests when files change.",
-      "default": false
-    },
-    "devServerTarget": {
-      "type": "string",
-      "description": "Dev server target to run tests against."
-    },
-    "headed": {
-      "type": "boolean",
-      "description": "Displays the browser instead of running headlessly. Set this to `true` if your run depends on a Chrome extension being loaded.",
-      "default": false
-    },
-    "headless": {
-      "type": "boolean",
-      "description": "Hide the browser instead of running headed.",
-      "default": false,
-      "x-deprecated": "Cypress runs headless by default. Use the --watch flag to control head/headless behavior instead. It will be removed in Nx v23."
-    },
-    "exit": {
-      "type": "boolean",
-      "description": "Whether or not the Cypress Test Runner will stay open after running tests in a spec file.",
-      "default": true
-    },
-    "key": {
-      "type": "string",
-      "description": "The key cypress should use to run tests in parallel/record the run (CI only)."
-    },
-    "record": {
-      "type": "boolean",
-      "description": "Whether or not Cypress should record the results of the tests.",
-      "default": false
-    },
-    "parallel": {
-      "aliases": ["p"],
-      "type": "boolean",
-      "description": "Whether or not Cypress should run its tests in parallel (CI only).",
-      "default": false
-    },
-    "baseUrl": {
-      "type": "string",
-      "description": "The address (with the port) which your application is running on.",
-      "x-priority": "important"
-    },
-    "browser": {
-      "type": "string",
-      "description": "The browser to run tests in."
-    },
-    "env": {
-      "type": "object",
-      "description": "A key-value Pair of environment variables to pass to Cypress runner."
-    },
-    "spec": {
-      "type": "string",
-      "description": "A comma delimited glob string that is provided to the Cypress runner to specify which spec files to run. i.e. `**examples/**,**actions.spec**`."
-    },
-    "ciBuildId": {
-      "oneOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "number"
-        }
-      ],
-      "description": "A unique identifier for a run to enable grouping or parallelization."
-    },
-    "group": {
-      "type": "string",
-      "description": "A named group for recorded runs in the Cypress dashboard."
-    },
-    "ignoreTestFiles": {
-      "aliases": ["excludeSpecPattern"],
-      "oneOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        }
-      ],
-      "description": "A String or Array of glob patterns used to ignore test files that would otherwise be shown in your list of tests. Cypress uses minimatch with the options: `{dot: true, matchBase: true}`. We suggest using https://globster.xyz to test what files would match."
-    },
-    "reporter": {
-      "type": "string",
-      "description": "The reporter used during cypress run."
-    },
-    "reporterOptions": {
-      "oneOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "object"
-        }
-      ],
-      "description": "The reporter options used. Supported options depend on the reporter. https://docs.cypress.io/guides/tooling/reporters#Reporter-Options"
-    },
-    "skipServe": {
-      "type": "boolean",
-      "description": "Skip dev-server build.",
-      "default": false
-    },
-    "testingType": {
-      "type": "string",
-      "description": "Specify the type of tests to execute.",
-      "enum": ["component", "e2e"],
-      "default": "e2e"
-    },
-    "tag": {
-      "type": "string",
-      "description": "A comma delimited list to identify a run with.",
-      "aliases": ["t"]
-    },
-    "port": {
-      "oneOf": [
-        {
-          "type": "string",
-          "enum": ["cypress-auto"]
-        },
-        {
-          "type": "number"
-        }
-      ],
-      "description": "Pass a specified port value to the devServerTarget, if the value is 'cypress-auto' a free port will automatically be picked for the devServerTarget."
-    },
-    "quiet": {
-      "aliases": ["q"],
-      "type": "boolean",
-      "description": "If passed, Cypress output will not be printed to stdout. Only output from the configured Mocha reporter will print.",
-      "default": false
-    },
-    "runnerUi": {
-      "type": "boolean",
-      "description": "Displays the Cypress Runner UI. Useful for when Test Replay is enabled and you would still like the Cypress Runner UI to be displayed for screenshots and video."
-    },
-    "autoCancelAfterFailures": {
-      "oneOf": [
-        {
-          "type": "number"
-        },
-        {
-          "type": "boolean",
-          "const": false
-        }
-      ],
-      "description": "Specify the number of failures to cancel a run being recorded to the Cypress Cloud or `false` to disable auto-cancellation."
-    }
-  },
-  "additionalProperties": true,
-  "required": ["cypressConfig"],
-  "examplesFile": "../../../docs/cypress-examples.md"
-}

package/dist/src/utils/deprecation.d.ts

@@ -1,3 +0,0 @@
-export declare const CYPRESS_EXECUTOR_DEPRECATION_MESSAGE = "The `@nx/cypress:cypress` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/cypress:convert-to-inferred` to migrate to the `@nx/cypress/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.";
-export declare function warnCypressExecutorDeprecation(): void;
-export declare function warnCypressExecutorGenerating(): void;

package/dist/src/utils/deprecation.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CYPRESS_EXECUTOR_DEPRECATION_MESSAGE = void 0;
-exports.warnCypressExecutorDeprecation = warnCypressExecutorDeprecation;
-exports.warnCypressExecutorGenerating = warnCypressExecutorGenerating;
-const devkit_1 = require("@nx/devkit");
-// TODO(v24): Remove the @nx/cypress:cypress executor. The inferred plugin
-// (@nx/cypress/plugin) and the convert-to-inferred generator stay supported.
-exports.CYPRESS_EXECUTOR_DEPRECATION_MESSAGE = 'The `@nx/cypress:cypress` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/cypress:convert-to-inferred` to migrate to the `@nx/cypress/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.';
-function warnCypressExecutorDeprecation() {
-    devkit_1.logger.warn(exports.CYPRESS_EXECUTOR_DEPRECATION_MESSAGE);
-}
-// Fired when the @nx/cypress:configuration or :component-configuration
-// generator is about to generate a target that uses the deprecated executor —
-// i.e. when @nx/cypress/plugin isn't registered in nx.json. Surfaces the
-// deprecation at generation time rather than only when the user later runs the
-// generated target.
-function warnCypressExecutorGenerating() {
-    devkit_1.logger.warn('Generating a target that uses the deprecated `@nx/cypress:cypress` executor. The executor will be removed in Nx v24. Run `nx g @nx/cypress:convert-to-inferred` next to migrate this target to the `@nx/cypress/plugin` inferred plugin and prevent future generators from emitting executor targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.');
-}

package/dist/src/utils/start-dev-server.d.ts

@@ -1,9 +0,0 @@
-import { ExecutorContext } from '@nx/devkit';
-import { CypressExecutorOptions } from '../executors/cypress/cypress.impl';
-export declare function startDevServer(opts: Omit<CypressExecutorOptions, 'cypressConfig'>, context: ExecutorContext): AsyncGenerator<{
-    baseUrl: any;
-    portLockFilePath?: undefined;
-} | {
-    baseUrl: any;
-    portLockFilePath: string;
-}, void, unknown>;

package/dist/src/utils/start-dev-server.js

@@ -1,165 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startDevServer = startDevServer;
-const tslib_1 = require("tslib");
-const devkit_1 = require("@nx/devkit");
-const path_1 = require("path");
-const detect_port_1 = tslib_1.__importDefault(require("detect-port"));
-const fs_1 = require("fs");
-const os_1 = require("os");
-const internal_1 = require("@nx/devkit/internal");
-const PORT_LOCK_DIR = (0, path_1.join)((0, os_1.tmpdir)(), 'nx-cypress-port-locks');
-async function* startDevServer(opts, context) {
-    // no dev server, return the provisioned base url
-    if (!opts.devServerTarget || opts.skipServe) {
-        yield { baseUrl: opts.baseUrl };
-        return;
-    }
-    const parsedDevServerTarget = (0, devkit_1.parseTargetString)(opts.devServerTarget, context);
-    const [targetSupportsWatchOpt] = getValueFromSchema(context, parsedDevServerTarget, 'watch');
-    const overrides = {
-        // @NOTE: Do not forward watch option if not supported by the target dev server,
-        //  this is relevant for running Cypress against dev server target that does not support this option,
-        //  for instance @nguniversal/builders:ssr-dev-server.
-        ...(targetSupportsWatchOpt ? { watch: opts.watch } : {}),
-    };
-    if (opts.port === 'cypress-auto') {
-        const freePort = await getPortForProject(context, parsedDevServerTarget);
-        overrides['port'] = freePort;
-    }
-    else if (opts.port !== undefined) {
-        overrides['port'] = opts.port;
-        // zero is a special case that means any valid port so there is no reason to try to 'lock it'
-        if (opts.port !== 0) {
-            const didLock = attemptToLockPort(opts.port);
-            if (!didLock) {
-                devkit_1.logger.warn((0, devkit_1.stripIndents) `${opts.port} is potentially already in use by another cypress run.
-If the port is in use, try using a different port value or passing --port='cypress-auto' to find a free port.`);
-            }
-        }
-    }
-    for await (const output of await (0, devkit_1.runExecutor)(parsedDevServerTarget, overrides, context)) {
-        if (!output.success && !opts.watch)
-            throw new Error('Could not compile application files');
-        if (!opts.baseUrl &&
-            !output.baseUrl &&
-            !output.info?.baseUrl &&
-            (output.port || output.info?.port)) {
-            output.baseUrl = `http://localhost:${output.info.port}`;
-        }
-        yield {
-            baseUrl: opts.baseUrl || output.baseUrl || output.info?.baseUrl,
-            portLockFilePath: overrides.port && (0, path_1.join)(PORT_LOCK_DIR, `${overrides.port}.lock`),
-        };
-    }
-}
-/**
- * try to find a free port for the project to run on
- * will return undefined if no port is found or the project doesn't have a port option
- **/
-async function getPortForProject(context, target, defaultPort = 4200) {
-    const fmtTarget = (0, devkit_1.targetToTargetString)(target);
-    const [hasPortOpt, schemaPortValue] = getValueFromSchema(context, target, 'port');
-    let freePort;
-    if (hasPortOpt) {
-        let normalizedPortValue;
-        if (!schemaPortValue) {
-            devkit_1.logger.info(`NX ${fmtTarget} did not have a defined port value, checking for free port with the default value of ${defaultPort}`);
-            normalizedPortValue = defaultPort;
-        }
-        else {
-            normalizedPortValue = Number(schemaPortValue);
-        }
-        if (isNaN(normalizedPortValue)) {
-            devkit_1.output.warn({
-                title: `Port Not a Number`,
-                bodyLines: [
-                    `The port value found was not a number or can't be parsed to a number`,
-                    `When reading the devServerTarget (${fmtTarget}) schema, expected ${schemaPortValue} to be a number but got NaN.`,
-                    `Nx will use the default value of ${defaultPort} instead.`,
-                    `You can manually specify a port by setting the 'port' option`,
-                ],
-            });
-            normalizedPortValue = defaultPort;
-        }
-        try {
-            let attempts = 0;
-            // make sure when this check happens in parallel,
-            // we don't let the same port be used by multiple projects
-            do {
-                freePort = await (0, detect_port_1.default)(freePort || normalizedPortValue);
-                if (attemptToLockPort(freePort)) {
-                    break;
-                }
-                attempts++;
-                // increment port in case the lock file isn't cleaned up
-                freePort++;
-            } while (attempts < 20);
-            devkit_1.logger.info(`NX Using port ${freePort} for ${fmtTarget}`);
-        }
-        catch (err) {
-            throw new Error((0, devkit_1.stripIndents) `Unable to find a free port for the dev server, ${fmtTarget}.
-You can disable auto port detection by specifing a port or not passing a value to --port`);
-        }
-    }
-    else {
-        devkit_1.output.warn({
-            title: `No Port Option Found`,
-            bodyLines: [
-                `The 'port' option is set to 'cypress-auto', but the devServerTarget (${fmtTarget}) does not have a port option.`,
-                `Because of this, Nx is unable to verify the port is free before starting the dev server.`,
-                `This might cause issues if the devServerTarget is trying to use a port that is already in use.`,
-            ],
-        });
-    }
-    return freePort;
-}
-/**
- * Check if the given target has the given property in it's options.
- * if the property is does not have a default value or is not in the actual executor options,
- * the value will be undefined even if it's in the executor schema.
- **/
-function getValueFromSchema(context, target, property) {
-    let targetOpts;
-    try {
-        targetOpts = (0, devkit_1.readTargetOptions)(target, context);
-    }
-    catch (e) {
-        throw new Error(`Unable to read the target options for  ${(0, devkit_1.targetToTargetString)(target)}.
-Are you sure this is a valid target?
-Was trying to read the target for the property: '${property}', but got the following error: 
-${e.message || e}`);
-    }
-    let targetHasOpt = Object.keys(targetOpts).includes(property);
-    if (!targetHasOpt) {
-        // NOTE: readTargetOptions doesn't apply non defaulted values, i.e. @nx/vite has a port options but is optional
-        // so we double check the schema if readTargetOptions didn't return a value for the property
-        const projectConfig = context.projectsConfigurations?.projects?.[target.project];
-        const targetConfig = projectConfig.targets[target.target];
-        const [collection, executor] = (0, internal_1.parseExecutor)(targetConfig.executor);
-        const { schema } = (0, internal_1.getExecutorInformation)(collection, executor, context.root, context.projectsConfigurations.projects);
-        // NOTE: schema won't have a default since readTargetOptions would have
-        // already set that and this check wouldn't need to be made
-        targetHasOpt = Object.keys(schema.properties).includes(property);
-    }
-    return [targetHasOpt, targetOpts[property]];
-}
-function attemptToLockPort(port) {
-    try {
-        (0, fs_1.mkdirSync)(PORT_LOCK_DIR, { recursive: true });
-    }
-    catch {
-        // ignore if already exists
-    }
-    const portLockFilePath = (0, path_1.join)(PORT_LOCK_DIR, `${port}.lock`);
-    try {
-        if ((0, fs_1.existsSync)(portLockFilePath)) {
-            return false;
-        }
-        (0, fs_1.writeFileSync)(portLockFilePath, 'locked');
-        return true;
-    }
-    catch (err) {
-        return false;
-    }
-}