cypress 15.16.0 → 15.17.0

package/dist/bin/cypress

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 'use strict';
 
-var cli = require('../cli-B97CK6L9.js');
-require('../xvfb-SgoMy1_9.js');
+var cli = require('../cli-CqSCkgQ7.js');
+require('../xvfb-CqCqXRC-.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');
@@ -32,7 +32,7 @@ require('commander');
 require('cli-table3');
 require('dayjs');
 require('dayjs/plugin/relativeTime');
-require('../spawn-BZQfzolX.js');
+require('../spawn-Cnrq9zm4.js');
 require('child_process');
 require('listr2');
 require('readline');

package/dist/{cli-B97CK6L9.js → cli-CqSCkgQ7.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var xvfb = require('./xvfb-SgoMy1_9.js');
+var xvfb = require('./xvfb-CqCqXRC-.js');
 var _ = require('lodash');
 var commander = require('commander');
 var commonTags = require('common-tags');
@@ -13,7 +13,7 @@ var dayjs = require('dayjs');
 var relativeTime = require('dayjs/plugin/relativeTime');
 var chalk = require('chalk');
 var Bluebird = require('bluebird');
-var spawn = require('./spawn-BZQfzolX.js');
+var spawn = require('./spawn-Cnrq9zm4.js');
 var os = require('os');
 var listr2 = require('listr2');
 var timers = require('timers/promises');
@@ -1575,6 +1575,8 @@ const descriptions = {
     group: 'a named group for recorded runs in Cypress Cloud',
     headed: 'displays the browser instead of running headlessly',
     headless: 'hide the browser instead of running headed (default for cypress run)',
+    inspect: 'enable the Node.js inspector to debug the Cypress development process. only available when used with --dev',
+    inspectBrk: 'enable the Node.js inspector and break before the Cypress development process starts. only available when used with --dev',
     key: 'your secret Record Key. you can omit this if you set a CYPRESS_RECORD_KEY environment variable.',
     parallel: 'enables concurrent runs and automatic load balancing of specs across multiple machines or processes',
     passWithNoTests: 'pass when no tests are found',
@@ -1703,8 +1705,7 @@ const addCypressRunCommand = (program) => {
         .option('--no-runner-ui', text('noRunnerUi'))
         .option('-o, --reporter-options <reporter-options>', text('reporterOptions'))
         .option('-s, --spec <spec>', text('spec'))
-        .option('-t, --tag <tag>', text('tag'))
-        .option('--dev', text('dev'), coerceFalse);
+        .option('-t, --tag <tag>', text('tag'));
 };
 const addCypressOpenCommand = (program) => {
     return program
@@ -1721,14 +1722,24 @@ const addCypressOpenCommand = (program) => {
         .option('-x, --expose <expose>', text('expose'))
         .option('--global', text('global'))
         .option('-p, --port <port>', text('port'))
-        .option('-P, --project <project-path>', text('project'))
-        .option('--dev', text('dev'), coerceFalse);
+        .option('-P, --project <project-path>', text('project'));
+};
+// `--dev`, `--inspect` and `--inspect-brk` are internal flags used when
+// developing Cypress itself. They are intentionally hidden from the public
+// `--help` output and only registered when `--dev` is actually passed, so that
+// released versions don't advertise flags that error for end users.
+// See https://github.com/cypress-io/cypress/issues/21320
+const maybeAddDevFlag = (program, args) => {
+    if (args.includes('--dev')) {
+        return program.option('--dev', text('dev'), coerceFalse);
+    }
+    return program;
 };
-const maybeAddInspectFlags = (program) => {
-    if (process.argv.includes('--dev')) {
+const maybeAddInspectFlags = (program, args) => {
+    if (args.includes('--dev')) {
         return program
-            .option('--inspect', 'Node option')
-            .option('--inspect-brk', 'Node option');
+            .option('--inspect', text('inspect'))
+            .option('--inspect-brk', text('inspectBrk'));
     }
     return program;
 };
@@ -1769,7 +1780,7 @@ const cliModule = {
             cliArgs.unshift(null, null);
             debug('creating program parser');
             const program = createProgram();
-            maybeAddInspectFlags(addCypressRunCommand(program))
+            maybeAddInspectFlags(maybeAddDevFlag(addCypressRunCommand(program), cliArgs), cliArgs)
                 .action((...fnArgs) => {
                 debug('parsed Cypress run %o', fnArgs);
                 const options = parseVariableOpts(fnArgs, cliArgs);
@@ -1801,7 +1812,7 @@ const cliModule = {
             cliArgs.unshift(null, null);
             debug('creating program parser');
             const program = createProgram();
-            maybeAddInspectFlags(addCypressOpenCommand(program))
+            maybeAddInspectFlags(maybeAddDevFlag(addCypressOpenCommand(program), cliArgs), cliArgs)
                 .action((...fnArgs) => {
                 debug('parsed Cypress open %o', fnArgs);
                 const options = parseVariableOpts(fnArgs, cliArgs);
@@ -1871,7 +1882,7 @@ const cliModule = {
                 .option('-v, --version', text('version'))
                 .command('version')
                 .description(text('version')));
-            maybeAddInspectFlags(addCypressOpenCommand(program))
+            maybeAddInspectFlags(maybeAddDevFlag(addCypressOpenCommand(program), args), args)
                 .action((opts) => xvfb.__awaiter(this, void 0, void 0, function* () {
                 debug('opening Cypress');
                 try {
@@ -1882,7 +1893,7 @@ const cliModule = {
                     xvfb.util.logErrorExit1(e);
                 }
             }));
-            maybeAddInspectFlags(addCypressRunCommand(program))
+            maybeAddInspectFlags(maybeAddDevFlag(addCypressRunCommand(program), args), args)
                 .action((...fnArgs) => xvfb.__awaiter(this, void 0, void 0, function* () {
                 debug('running Cypress with args %o', fnArgs);
                 try {
@@ -1906,11 +1917,10 @@ const cliModule = {
                     xvfb.util.logErrorExit1(e);
                 }
             }));
-            program
+            maybeAddDevFlag(program
                 .command('verify')
                 .usage('[options]')
-                .description('Verifies that Cypress is installed correctly and executable')
-                .option('--dev', text('dev'), coerceFalse)
+                .description('Verifies that Cypress is installed correctly and executable'), args)
                 .action((opts) => xvfb.__awaiter(this, void 0, void 0, function* () {
                 const defaultOpts = { force: true, welcomeMessage: false };
                 const parsedOpts = xvfb.util.parseOpts(opts);
@@ -1961,11 +1971,10 @@ const cliModule = {
                     cacheModule[command]();
                 });
             });
-            program
+            maybeAddDevFlag(program
                 .command('info')
                 .usage('[command]')
-                .description('Prints Cypress and system information')
-                .option('--dev', text('dev'), coerceFalse)
+                .description('Prints Cypress and system information'), args)
                 .action((opts) => xvfb.__awaiter(this, void 0, void 0, function* () {
                 try {
                     const code = yield methods.start(opts);

package/dist/cli.js

@@ -2,14 +2,14 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-require('./xvfb-SgoMy1_9.js');
+require('./xvfb-CqCqXRC-.js');
 require('lodash');
 require('commander');
 require('common-tags');
 require('log-symbols');
 require('debug');
-var cli = require('./cli-B97CK6L9.js');
-require('./spawn-BZQfzolX.js');
+var cli = require('./cli-CqSCkgQ7.js');
+require('./spawn-Cnrq9zm4.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');

package/dist/{cypress-DuMyFGfr.js → cypress-BZS7OvER.js}

@@ -1,9 +1,9 @@
 'use strict';
 
-var xvfb = require('./xvfb-SgoMy1_9.js');
+var xvfb = require('./xvfb-CqCqXRC-.js');
 var tmp = require('tmp');
 var fs = require('fs-extra');
-var cli$1 = require('./cli-B97CK6L9.js');
+var cli$1 = require('./cli-CqSCkgQ7.js');
 
 /**
  * Opens Cypress GUI

package/dist/cypress.js

@@ -1,10 +1,10 @@
 'use strict';
 
-require('./xvfb-SgoMy1_9.js');
+require('./xvfb-CqCqXRC-.js');
 require('tmp');
 require('fs-extra');
-require('./cli-B97CK6L9.js');
-var cypress = require('./cypress-DuMyFGfr.js');
+require('./cli-CqSCkgQ7.js');
+var cypress = require('./cypress-BZS7OvER.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');
@@ -33,7 +33,7 @@ require('commander');
 require('cli-table3');
 require('dayjs');
 require('dayjs/plugin/relativeTime');
-require('./spawn-BZQfzolX.js');
+require('./spawn-Cnrq9zm4.js');
 require('child_process');
 require('listr2');
 require('readline');

package/dist/exec/spawn.js

@@ -1,12 +1,12 @@
 'use strict';
 
-require('../xvfb-SgoMy1_9.js');
+require('../xvfb-CqCqXRC-.js');
 require('lodash');
 require('os');
 require('child_process');
 require('path');
 require('debug');
-var spawn = require('../spawn-BZQfzolX.js');
+var spawn = require('../spawn-Cnrq9zm4.js');
 require('readline');
 require('process');
 require('stream');

package/dist/exec/xvfb.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var xvfb = require('../xvfb-SgoMy1_9.js');
+var xvfb = require('../xvfb-CqCqXRC-.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');

package/dist/index.js

@@ -2,12 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var xvfb = require('./xvfb-SgoMy1_9.js');
+var xvfb = require('./xvfb-CqCqXRC-.js');
 var minimist = require('minimist');
 var Debug = require('debug');
-var cli$1 = require('./cli-B97CK6L9.js');
-var spawn = require('./spawn-BZQfzolX.js');
-var cypress = require('./cypress-DuMyFGfr.js');
+var cli$1 = require('./cli-CqSCkgQ7.js');
+var spawn = require('./spawn-Cnrq9zm4.js');
+var cypress = require('./cypress-BZS7OvER.js');
 require('os');
 require('bluebird');
 require('@cypress/xvfb');

package/dist/{spawn-BZQfzolX.js → spawn-Cnrq9zm4.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var xvfb = require('./xvfb-SgoMy1_9.js');
+var xvfb = require('./xvfb-CqCqXRC-.js');
 var _ = require('lodash');
 var os = require('os');
 var cp = require('child_process');
@@ -1060,6 +1060,8 @@ var distExports = requireDist();
 const debug = Debug('cypress:cli');
 const debugElectron = Debug('cypress:electron');
 const debugStderr = Debug('cypress:internal-stderr');
+// Must match CYPRESS_OPEN_READY_MESSAGE in packages/server/lib/modes/interactive.ts
+const CYPRESS_OPEN_READY_MESSAGE = 'Cypress is ready';
 function isPlatform(platform) {
     return os.platform() === platform;
 }
@@ -1131,6 +1133,13 @@ function createSpawnFunction(executable, args, options) {
                 debug('passing DISPLAY', process$1.env.DISPLAY);
                 stdioOptions.env.DISPLAY = process$1.env.DISPLAY;
             }
+            if (stdioOptions.detached) {
+                // Ask interactive mode to print a ready sentinel on stdout; pipe stdio during
+                // startup so errors are visible and we can detect it. Streams are destroyed
+                // once it arrives so they don't keep the parent event loop alive.
+                args.push('--emit-when-ready');
+                stdioOptions.stdio = ['ignore', 'pipe', 'pipe'];
+            }
             if (stdioOptions.env.ELECTRON_RUN_AS_NODE) {
                 // Since we are running electron as node, we need to add an entry point file.
                 startScriptPath = path.join(xvfb.stateModule.getBinaryPkgPath(path.dirname(executable)), '..', 'index.js');
@@ -1205,6 +1214,26 @@ function createSpawnFunction(executable, args, options) {
                     });
                 }
             }
+            if (stdioOptions.detached) {
+                child.stdout.on('data', (data) => {
+                    const str = data.toString();
+                    const readyMessageIndex = str.indexOf(CYPRESS_OPEN_READY_MESSAGE);
+                    const isReady = readyMessageIndex !== -1;
+                    if (isReady) {
+                        const outputBeforeReady = str.slice(0, readyMessageIndex);
+                        if (outputBeforeReady)
+                            process$1.stdout.write(outputBeforeReady);
+                        child.stdout.destroy();
+                        child.stderr.destroy();
+                        child.unref();
+                        resolve(0);
+                        return;
+                    }
+                    process$1.stdout.write(data);
+                });
+                child.stderr.pipe(process$1.stderr, { end: false });
+                return;
+            }
             // if stdio options is set to 'pipe', then
             //   we should set up pipes:
             //  process STDIN (read stream) => child STDIN (writeable)
@@ -1258,9 +1287,6 @@ function createSpawnFunction(executable, args, options) {
                 }
                 reject(err);
             });
-            if (stdioOptions.detached) {
-                child.unref();
-            }
         }));
     };
 }

package/dist/{xvfb-SgoMy1_9.js → xvfb-CqCqXRC-.js}

@@ -907,19 +907,6 @@ const invalidConfigFile = {
     description: '`--config-file` cannot be false.',
     solution: 'Either pass a relative path to a valid Cypress config file or remove this option.',
 };
-/**
- * This error happens when CLI detects that the child Test Runner process
- * was killed with a signal, like SIGBUS
- * @see https://github.com/cypress-io/cypress/issues/5808
- * @param {'close'|'event'} eventName Child close event name
- * @param {string} signal Signal that closed the child process, like "SIGBUS"
-*/
-const childProcessKilled = (eventName, signal) => {
-    return {
-        description: `The Test Runner unexpectedly exited via a ${chalk.cyan(eventName)} event with signal ${chalk.cyan(signal)}`,
-        solution: solutionUnknown,
-    };
-};
 const CYPRESS_RUN_BINARY = {
     notValid: (value) => {
         const properFormat = `**/${stateModule.getPlatformExecutable()}`;
@@ -1033,7 +1020,6 @@ const errors = {
     invalidCacheDirectory,
     CYPRESS_RUN_BINARY,
     smokeTestFailure,
-    childProcessKilled,
     incompatibleHeadlessFlags,
     invalidRunProjectPath,
     invalidTestingType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress",
-  "version": "15.16.0",
+  "version": "15.17.0",
   "main": "dist/index.js",
   "scripts": {
     "postinstall": "node dist/index.js --exec install",
@@ -138,8 +138,8 @@
   },
   "buildInfo": {
     "commitBranch": "develop",
-    "commitSha": "22aaf2371462ec13f138fd96c11e8f9f885ed575",
-    "commitDate": "2026-05-26T16:59:59.000Z",
+    "commitSha": "b22780a9bb118b86730e22243aba16e25e7a5bed",
+    "commitDate": "2026-06-09T13:13:52.000Z",
     "stable": true
   },
   "description": "Cypress is a next generation front end testing tool built for the modern web",

package/types/cypress.d.ts

@@ -1486,6 +1486,22 @@ declare namespace Cypress {
      *    cy.get('button').should('be.visible')
      */
     get<K extends keyof HTMLElementTagNameMap>(selector: K, options?: Partial<Loggable & Timeoutable & Withinable & Shadow>): Chainable<JQuery<HTMLElementTagNameMap[K]>>
+    /**
+     * Get aliased DOM elements, intercepts, spies, stubs, or wrapped values via `@` prefix.
+     * Use the `S` type parameter to specify the type of the aliased subject.
+     * @see https://on.cypress.io/get#Alias
+     * @example
+     *    // Get the aliased 'todos' elements
+     *    cy.get('ul#todos').as('todos')
+     *    cy.get<JQuery<HTMLLIElement>>('@todos')
+     *
+     *    // Alias a wrapped value and retrieve it with proper typing
+     *    cy.wrap({ name: 'Jane' }).as('user')
+     *    cy.get<{ name: string }>('@user').then((user) => {
+     *      // user is typed as { name: string }
+     *    })
+     */
+    get<S = any>(alias: `@${string}`, options?: Partial<Loggable & Timeoutable & Withinable & Shadow>): Chainable<S>
     /**
      * Get one or more DOM elements by selector.
      * The querying behavior of this command matches exactly how $(…) works in jQuery.
@@ -1496,17 +1512,6 @@ declare namespace Cypress {
      *    cy.get('.dropdown-menu').click()
      */
     get<E extends Node = HTMLElement>(selector: string, options?: Partial<Loggable & Timeoutable & Withinable & Shadow>): Chainable<JQuery<E>>
-    /**
-     * Get one or more DOM elements by alias.
-     * @see https://on.cypress.io/get#Alias
-     * @example
-     *    // Get the aliased 'todos' elements
-     *    cy.get('ul#todos').as('todos')
-     *    //...hack hack hack...
-     *    //later retrieve the todos
-     *    cy.get('@todos')
-     */
-    get<S = any>(alias: string, options?: Partial<Loggable & Timeoutable & Withinable & Shadow>): Chainable<S>
 
     /**
      * Get a browser cookie by its name.
@@ -3442,6 +3447,7 @@ declare namespace Cypress {
   >, Partial<Pick<ResolvedConfigOptions, 'baseUrl' | 'testIsolation'>> {
     browser?: IsBrowserMatcher | IsBrowserMatcher[]
     keystrokeDelay?: number
+    expose?: Record<string, any>
   }
 
   interface TestConfigOverrides extends Partial<
@@ -3449,6 +3455,7 @@ declare namespace Cypress {
   >, Partial<Pick<ResolvedConfigOptions, 'baseUrl'>> {
     browser?: IsBrowserMatcher | IsBrowserMatcher[]
     keystrokeDelay?: number
+    expose?: Record<string, any>
   }
 
   /**

package/types/net-stubbing.d.ts

@@ -548,7 +548,7 @@ declare global {
       })
       ```
       */
-      wait<TRequest = any, TResponse = any>(alias: string, options?: Partial<WaitOptions>): Chainable<Interception<TRequest, TResponse>>
+      wait<TRequest = any, TResponse = any>(alias: `@${string}`, options?: Partial<WaitOptions>): Chainable<Interception<TRequest, TResponse>>
       /**
        * Wait for list of requests to complete.
        *
@@ -568,7 +568,7 @@ declare global {
         })
       ```
       */
-      wait(aliases: string[], options?: Partial<WaitOptions>): Chainable<Interception[]>
+      wait(aliases: `@${string}`[], options?: Partial<WaitOptions>): Chainable<Interception[]>
     }
   }
 }