cypress 9.6.0 → 10.0.0

package/index.mjs

@@ -0,0 +1,15 @@
+import module from 'module'
+
+const require = module.createRequire(import.meta.url)
+
+const cypress = require('./lib/cypress')
+
+export default cypress
+
+export const defineConfig = cypress.defineConfig
+
+export const run = cypress.run
+
+export const open = cypress.open
+
+export const cli = cypress.cli

package/lib/cli.js

@@ -34,10 +34,6 @@ function unknownOption(flag, type = 'option') {
 
 commander.Command.prototype.unknownOption = unknownOption;
 
-const coerceFalseOrString = arg => {
-  return arg !== 'false' ? arg : false;
-};
-
 const coerceFalse = arg => {
   return arg !== 'false';
 };
@@ -110,19 +106,20 @@ const parseVariableOpts = (fnArgs, args) => {
 };
 
 const descriptions = {
-  browserOpenMode: 'path to a custom browser to be added to the list of available browsers in Cypress',
-  browserRunMode: 'runs Cypress in the browser with the given name. if a filesystem path is supplied, Cypress will attempt to use the browser at that path.',
+  browser: 'runs Cypress in the browser with the given name. if a filesystem path is supplied, Cypress will attempt to use the browser at that path.',
   cacheClear: 'delete all cached binaries',
   cachePrune: 'deletes all cached binaries except for the version currently in use',
   cacheList: 'list cached binary versions',
   cachePath: 'print the path to the binary cache',
   cacheSize: 'Used with the list command to show the sizes of the cached folders',
   ciBuildId: 'the unique identifier for a run on your CI provider. typically a "BUILD_ID" env var. this value is automatically detected for most CI providers',
-  config: 'sets configuration values. separate multiple values with a comma. overrides any value in cypress.json.',
-  configFile: 'path to JSON file where configuration values are set. defaults to "cypress.json". pass "false" to disable.',
+  component: 'runs component tests',
+  config: 'sets configuration values. separate multiple values with a comma. overrides any value in cypress.config.{js,ts,mjs,cjs}.',
+  configFile: 'path to script file where configuration values are set. defaults to "cypress.config.{js,ts,mjs,cjs}".',
   detached: 'runs Cypress application in detached mode',
   dev: 'runs cypress in development and bypasses binary check',
-  env: 'sets environment variables. separate multiple values with a comma. overrides any value in cypress.json or cypress.env.json',
+  e2e: 'runs end to end tests',
+  env: 'sets environment variables. separate multiple values with a comma. overrides any value in cypress.config.{js,ts,mjs,cjs} or cypress.env.json',
   exit: 'keep the browser open after tests finish',
   forceInstall: 'force install the Cypress binary',
   global: 'force Cypress into global mode as if its globally installed',
@@ -131,7 +128,7 @@ const descriptions = {
   headless: 'hide the browser instead of running headed (default for cypress run)',
   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',
-  port: 'runs Cypress on a specific port. overrides any value in cypress.json.',
+  port: 'runs Cypress on a specific port. overrides any value in cypress.config.{js,ts,mjs,cjs}.',
   project: 'path to the project',
   quiet: 'run quietly, using only the configured reporter',
   record: 'records the run. sends test results, screenshots and videos to your Cypress Dashboard.',
@@ -221,11 +218,19 @@ const createProgram = () => {
 };
 
 const addCypressRunCommand = program => {
-  return program.command('run').usage('[options]').description('Runs Cypress tests from the CLI without the GUI').option('-b, --browser <browser-name-or-path>', text('browserRunMode')).option('--ci-build-id <id>', text('ciBuildId')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-e, --env <env>', text('env')).option('--group <name>', text('group')).option('-k, --key <record-key>', text('key')).option('--headed', text('headed')).option('--headless', text('headless')).option('--no-exit', text('exit')).option('--parallel', text('parallel')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('-q, --quiet', text('quiet')).option('--record [bool]', text('record'), coerceFalse).option('-r, --reporter <reporter>', text('reporter')).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);
+  return program.command('run').usage('[options]').description('Runs Cypress tests from the CLI without the GUI').option('-b, --browser <browser-name-or-path>', text('browser')).option('--ci-build-id <id>', text('ciBuildId')).option('--component', text('component')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('--e2e', text('e2e')).option('-e, --env <env>', text('env')).option('--group <name>', text('group')).option('-k, --key <record-key>', text('key')).option('--headed', text('headed')).option('--headless', text('headless')).option('--no-exit', text('exit')).option('--parallel', text('parallel')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('-q, --quiet', text('quiet')).option('--record [bool]', text('record'), coerceFalse).option('-r, --reporter <reporter>', text('reporter')).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);
 };
 
 const addCypressOpenCommand = program => {
-  return program.command('open').usage('[options]').description('Opens Cypress in the interactive GUI.').option('-b, --browser <browser-path>', text('browserOpenMode')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-d, --detached [bool]', text('detached'), coerceFalse).option('-e, --env <env>', text('env')).option('--global', text('global')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('--dev', text('dev'), coerceFalse);
+  return program.command('open').usage('[options]').description('Opens Cypress in the interactive GUI.').option('-b, --browser <browser-path>', text('browser')).option('--component', text('component')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-d, --detached [bool]', text('detached'), coerceFalse).option('--e2e', text('e2e')).option('-e, --env <env>', text('env')).option('--global', text('global')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('--dev', text('dev'), coerceFalse);
+};
+
+const maybeAddInspectFlags = program => {
+  if (process.argv.includes('--dev')) {
+    return program.option('--inspect', 'Node option').option('--inspect-brk', 'Node option');
+  }
+
+  return program;
 };
 /**
  * Casts known command line options for "cypress run" to their intended type.
@@ -236,7 +241,7 @@ const addCypressOpenCommand = program => {
  */
 
 
-const castCypressRunOptions = opts => {
+const castCypressOptions = opts => {
   // only properties that have type "string | false" in our TS definition
   // require special handling, because CLI parsing takes care of purely
   // boolean arguments
@@ -247,10 +252,6 @@ const castCypressRunOptions = opts => {
     castOpts.port = coerceAnyStringToInt(opts.port);
   }
 
-  if (_.has(opts, 'configFile')) {
-    castOpts.configFile = coerceFalseOrString(opts.configFile);
-  }
-
   return castOpts;
 };
 
@@ -275,11 +276,44 @@ module.exports = {
       cliArgs.unshift(null, null);
       debug('creating program parser');
       const program = createProgram();
-      addCypressRunCommand(program).action((...fnArgs) => {
+      maybeAddInspectFlags(addCypressRunCommand(program)).action((...fnArgs) => {
         debug('parsed Cypress run %o', fnArgs);
         const options = parseVariableOpts(fnArgs, cliArgs);
         debug('parsed options %o', options);
-        const casted = castCypressRunOptions(options);
+        const casted = castCypressOptions(options);
+        debug('casted options %o', casted);
+        resolve(casted);
+      });
+      debug('parsing args: %o', cliArgs);
+      program.parse(cliArgs);
+    });
+  },
+
+  /**
+   * Parses `cypress open` command line option array into an object
+   * with options that you can feed into cy.openModeSystemTest test calls
+   * @example
+   *  const options = parseOpenCommand(['cypress', 'open', '--browser', 'chrome'])
+   *  // options is {browser: 'chrome'}
+   */
+  parseOpenCommand(args) {
+    return new Promise((resolve, reject) => {
+      if (!Array.isArray(args)) {
+        return reject(new Error('Expected array of arguments'));
+      } // make a copy of the input arguments array
+      // and add placeholders where "node ..." would usually be
+      // also remove "cypress" keyword at the start if present
+
+
+      const cliArgs = args[0] === 'cypress' ? [...args.slice(1)] : [...args];
+      cliArgs.unshift(null, null);
+      debug('creating program parser');
+      const program = createProgram();
+      maybeAddInspectFlags(addCypressOpenCommand(program)).action((...fnArgs) => {
+        debug('parsed Cypress open %o', fnArgs);
+        const options = parseVariableOpts(fnArgs, cliArgs);
+        debug('parsed options %o', options);
+        const casted = castCypressOptions(options);
         debug('casted options %o', casted);
         resolve(casted);
       });
@@ -326,25 +360,40 @@ module.exports = {
     program.option('-v, --version', text('version')).command('version').description(text('version')).action(() => {
       showVersions(args);
     });
-    addCypressOpenCommand(program).action(opts => {
+    maybeAddInspectFlags(addCypressOpenCommand(program)).action(opts => {
       debug('opening Cypress');
 
       require('./exec/open').start(util.parseOpts(opts)).then(util.exit).catch(util.logErrorExit1);
     });
-    addCypressRunCommand(program).action((...fnArgs) => {
+    maybeAddInspectFlags(addCypressRunCommand(program)).action((...fnArgs) => {
       debug('running Cypress with args %o', fnArgs);
 
       require('./exec/run').start(parseVariableOpts(fnArgs, args)).then(util.exit).catch(util.logErrorExit1);
     });
-    program.command('open-ct').usage('[options]').description('Opens Cypress component testing interactive mode.').option('-b, --browser <browser-path>', text('browserOpenMode')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-d, --detached [bool]', text('detached'), coerceFalse).option('-e, --env <env>', text('env')).option('--global', text('global')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('--dev', text('dev'), coerceFalse).action(opts => {
+    program.command('open-ct').usage('[options]').description('Opens Cypress component testing interactive mode. Deprecated: use "open --component"').option('-b, --browser <browser-path>', text('browser')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-d, --detached [bool]', text('detached'), coerceFalse).option('-e, --env <env>', text('env')).option('--global', text('global')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('--dev', text('dev'), coerceFalse).action(opts => {
       debug('opening Cypress');
+      const msg = `
+      ${logSymbols.warning} Warning: open-ct is deprecated and will be removed in a future release.
+
+      Use \`cypress open --component\` instead.
+      `;
+      logger.warn();
+      logger.warn(stripIndent(msg));
+      logger.warn();
 
       require('./exec/open').start({ ...util.parseOpts(opts),
         testingType: 'component'
       }).then(util.exit).catch(util.logErrorExit1);
     });
-    program.command('run-ct').usage('[options]').description('Runs all Cypress Component Testing suites').option('-b, --browser <browser-name-or-path>', text('browserRunMode')).option('--ci-build-id <id>', text('ciBuildId')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-e, --env <env>', text('env')).option('--group <name>', text('group')).option('-k, --key <record-key>', text('key')).option('--headed', text('headed')).option('--headless', text('headless')).option('--no-exit', text('exit')).option('--parallel', text('parallel')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('-q, --quiet', text('quiet')).option('--record [bool]', text('record'), coerceFalse).option('-r, --reporter <reporter>', text('reporter')).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).action(opts => {
+    program.command('run-ct').usage('[options]').description('Runs all Cypress component testing suites. Deprecated: use "run --component"').option('-b, --browser <browser-name-or-path>', text('browser')).option('--ci-build-id <id>', text('ciBuildId')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-e, --env <env>', text('env')).option('--group <name>', text('group')).option('-k, --key <record-key>', text('key')).option('--headed', text('headed')).option('--headless', text('headless')).option('--no-exit', text('exit')).option('--parallel', text('parallel')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('-q, --quiet', text('quiet')).option('--record [bool]', text('record'), coerceFalse).option('-r, --reporter <reporter>', text('reporter')).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).action(opts => {
       debug('running Cypress run-ct');
+      const msg = `
+      ${logSymbols.warning} Warning: run-ct is deprecated and will be removed in a future release.
+      Use \`cypress run --component\` instead.
+      `;
+      logger.warn();
+      logger.warn(stripIndent(msg));
+      logger.warn();
 
       require('./exec/run').start({ ...util.parseOpts(opts),
         testingType: 'component'

package/lib/errors.js

@@ -214,6 +214,18 @@ const invalidTestingType = {
   description: 'Invalid testingType',
   solution: `Please provide a valid testingType. Valid test types are ${chalk.cyan('\'e2e\'')} and ${chalk.cyan('\'component\'')}.`
 };
+const incompatibleTestTypeFlags = {
+  description: '`--e2e` and `--component` cannot both be passed.',
+  solution: 'Either pass `--e2e` or `--component`, but not both.'
+};
+const incompatibleTestingTypeAndFlag = {
+  description: 'Set a `testingType` and also passed `--e2e` or `--component` flags.',
+  solution: 'Either set `testingType` or pass a testing type flag, but not both.'
+};
+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
@@ -397,6 +409,9 @@ module.exports = {
     childProcessKilled,
     incompatibleHeadlessFlags,
     invalidRunProjectPath,
-    invalidTestingType
+    invalidTestingType,
+    incompatibleTestTypeFlags,
+    incompatibleTestingTypeAndFlag,
+    invalidConfigFile
   }
 };

package/lib/exec/open.js

@@ -9,10 +9,25 @@ const spawn = require('./spawn');
 const verify = require('../tasks/verify');
 
 const {
-  processTestingType
+  processTestingType,
+  checkConfigFile
 } = require('./shared');
 
-const processOpenOptions = options => {
+const {
+  exitWithError
+} = require('../errors');
+/**
+ * Maps options collected by the CLI
+ * and forms list of CLI arguments to the server.
+ *
+ * Note: there is lightweight validation, with errors
+ * thrown synchronously.
+ *
+ * @returns {string[]} list of CLI arguments
+ */
+
+
+const processOpenOptions = (options = {}) => {
   if (!util.isInstalledGlobally() && !options.global && !options.project) {
     options.project = process.cwd();
   }
@@ -24,6 +39,7 @@ const processOpenOptions = options => {
   }
 
   if (options.configFile !== undefined) {
+    checkConfigFile(options);
     args.push('--config-file', options.configFile);
   }
 
@@ -43,7 +59,19 @@ const processOpenOptions = options => {
     args.push('--project', options.project);
   }
 
-  args.push(...processTestingType(options.testingType));
+  if (options.global) {
+    args.push('--global', options.global);
+  }
+
+  if (options.inspect) {
+    args.push('--inspect');
+  }
+
+  if (options.inspectBrk) {
+    args.push('--inspectBrk');
+  }
+
+  args.push(...processTestingType(options));
   debug('opening from options %j', options);
   debug('command line arguments %j', args);
   return args;
@@ -53,14 +81,21 @@ module.exports = {
   processOpenOptions,
 
   start(options = {}) {
-    const args = processOpenOptions(options);
-
     function open() {
-      return spawn.start(args, {
-        dev: options.dev,
-        detached: Boolean(options.detached),
-        stdio: 'inherit'
-      });
+      try {
+        const args = processOpenOptions(options);
+        return spawn.start(args, {
+          dev: options.dev,
+          detached: Boolean(options.detached),
+          stdio: 'inherit'
+        });
+      } catch (err) {
+        if (err.details) {
+          return exitWithError(err.details)();
+        }
+
+        throw err;
+      }
     }
 
     if (options.dev) {

package/lib/exec/run.js

@@ -17,7 +17,8 @@ const {
 
 const {
   processTestingType,
-  throwInvalidOptionError
+  throwInvalidOptionError,
+  checkConfigFile
 } = require('./shared');
 /**
  * Typically a user passes a string path to the project.
@@ -74,6 +75,7 @@ const processRunOptions = (options = {}) => {
   }
 
   if (options.configFile !== undefined) {
+    checkConfigFile(options);
     args.push('--config-file', options.configFile);
   }
 
@@ -153,7 +155,15 @@ const processRunOptions = (options = {}) => {
     args.push('--tag', options.tag);
   }
 
-  args.push(...processTestingType(options.testingType));
+  if (options.inspect) {
+    args.push('--inspect');
+  }
+
+  if (options.inspectBrk) {
+    args.push('--inspectBrk');
+  }
+
+  args.push(...processTestingType(options));
   return args;
 };
 
@@ -172,10 +182,12 @@ module.exports = {
     });
 
     function run() {
-      let args;
-
       try {
-        args = processRunOptions(options);
+        const args = processRunOptions(options);
+        debug('run to spawn.start args %j', args);
+        return spawn.start(args, {
+          dev: options.dev
+        });
       } catch (err) {
         if (err.details) {
           return exitWithError(err.details)();
@@ -183,11 +195,6 @@ module.exports = {
 
         throw err;
       }
-
-      debug('run to spawn.start args %j', args);
-      return spawn.start(args, {
-        dev: options.dev
-      });
     }
 
     if (options.dev) {

package/lib/exec/shared.js

@@ -28,23 +28,44 @@ const throwInvalidOptionError = details => {
  */
 
 
-const processTestingType = testingType => {
-  if (testingType) {
-    if (testingType === 'e2e') {
-      return ['--testing-type', 'e2e'];
-    }
+const processTestingType = options => {
+  if (options.e2e && options.component) {
+    return throwInvalidOptionError(errors.incompatibleTestTypeFlags);
+  }
+
+  if (options.testingType && (options.component || options.e2e)) {
+    return throwInvalidOptionError(errors.incompatibleTestTypeFlags);
+  }
 
-    if (testingType === 'component') {
-      return ['--testing-type', 'component'];
-    }
+  if (options.testingType === 'component' || options.component || options.ct) {
+    return ['--testing-type', 'component'];
+  }
+
+  if (options.testingType === 'e2e' || options.e2e) {
+    return ['--testing-type', 'e2e'];
+  }
 
+  if (options.testingType) {
     return throwInvalidOptionError(errors.invalidTestingType);
   }
 
   return [];
 };
+/**
+ * Throws an error if configFile is string 'false' or boolean false
+ * @param {*} options
+ */
+
+
+const checkConfigFile = options => {
+  // CLI will parse as string, module API can pass in boolean
+  if (options.configFile === 'false' || options.configFile === false) {
+    throwInvalidOptionError(errors.invalidConfigFile);
+  }
+};
 
 module.exports = {
   throwInvalidOptionError,
-  processTestingType
+  processTestingType,
+  checkConfigFile
 };

package/lib/exec/spawn.js

@@ -175,6 +175,10 @@ module.exports = {
           args.unshift(startScriptPath);
         }
 
+        if (process.env.CYPRESS_INTERNAL_DEV_DEBUG) {
+          args.unshift(process.env.CYPRESS_INTERNAL_DEV_DEBUG);
+        }
+
         debug('spawn args %o %o', args, _.omit(stdioOptions, 'env'));
         debug('spawning Cypress with executable: %s', executable);
         const child = cp.spawn(executable, args, stdioOptions);

package/lib/exec/xvfb.js

@@ -23,6 +23,7 @@ const debug = Debug('cypress:cli');
 const debugXvfb = Debug('cypress:xvfb');
 debug.Debug = debugXvfb.Debug = Debug;
 const xvfbOptions = {
+  displayNum: process.env.XVFB_DISPLAY_NUM,
   timeout: 30000,
   // milliseconds
   // need to explicitly define screen otherwise electron will crash

package/lib/util.js

@@ -213,7 +213,7 @@ const dequote = str => {
 };
 
 const parseOpts = opts => {
-  opts = _.pick(opts, 'browser', 'cachePath', 'cacheList', 'cacheClear', 'cachePrune', 'ciBuildId', 'config', 'configFile', 'cypressVersion', 'destination', 'detached', 'dev', 'exit', 'env', 'force', 'global', 'group', 'headed', 'headless', 'key', 'path', 'parallel', 'port', 'project', 'quiet', 'reporter', 'reporterOptions', 'record', 'runProject', 'spec', 'tag');
+  opts = _.pick(opts, 'browser', 'cachePath', 'cacheList', 'cacheClear', 'cachePrune', 'ciBuildId', 'ct', 'component', 'config', 'configFile', 'cypressVersion', 'destination', 'detached', 'dev', 'e2e', 'exit', 'env', 'force', 'global', 'group', 'headed', 'headless', 'inspect', 'inspectBrk', 'key', 'path', 'parallel', 'port', 'project', 'quiet', 'reporter', 'reporterOptions', 'record', 'runProject', 'spec', 'tag');
 
   if (opts.exit) {
     opts = _.omit(opts, 'exit');
@@ -245,10 +245,15 @@ const getApplicationDataFolder = (...paths) => {
     env
   } = process; // allow overriding the app_data folder
 
-  const folder = env.CYPRESS_KONFIG_ENV || env.CYPRESS_INTERNAL_ENV || 'development';
+  let folder = env.CYPRESS_KONFIG_ENV || env.CYPRESS_INTERNAL_ENV || 'development';
   const PRODUCT_NAME = pkg.productName || pkg.name;
   const OS_DATA_PATH = ospath.data();
   const ELECTRON_APP_DATA_PATH = path.join(OS_DATA_PATH, PRODUCT_NAME);
+
+  if (process.env.CYPRESS_INTERNAL_E2E_TESTING_SELF) {
+    folder = `${folder}-e2e-test`;
+  }
+
   const p = path.join(ELECTRON_APP_DATA_PATH, 'cy', folder, ...paths);
   return p;
 };
@@ -289,7 +294,9 @@ const util = {
     // Node's builtin crypto.hash function.
 
 
-    if (process.versions && semver.satisfies(process.versions.node, '>=17.0.0') && process.versions.openssl.startsWith('3.')) {
+    if (process.versions && semver.satisfies(process.versions.node, '>=17.0.0') && semver.satisfies(process.versions.openssl, '>=3', {
+      includePrerelease: true
+    })) {
       opts.ORIGINAL_NODE_OPTIONS = `${opts.ORIGINAL_NODE_OPTIONS || ''} --openssl-legacy-provider`;
     }
 

package/mount-utils/CHANGELOG.md

@@ -0,0 +1,20 @@
+# [@cypress/mount-utils-v1.0.2](https://github.com/cypress-io/cypress/compare/@cypress/mount-utils-v1.0.1...@cypress/mount-utils-v1.0.2) (2021-04-30)
+
+
+### Bug Fixes
+
+* avoid unmounting React components twice ([#16280](https://github.com/cypress-io/cypress/issues/16280)) ([bd629d3](https://github.com/cypress-io/cypress/commit/bd629d307eca9165b2c6f44ff87164a9e07a3eb5))
+
+# [@cypress/mount-utils-v1.0.1](https://github.com/cypress-io/cypress/compare/@cypress/mount-utils-v1.0.0...@cypress/mount-utils-v1.0.1) (2021-04-26)
+
+
+### Bug Fixes
+
+* **webpack-dev-server:** remove hard dependency on html-webpack-plugin v4  ([#16108](https://github.com/cypress-io/cypress/issues/16108)) ([4cfe4b1](https://github.com/cypress-io/cypress/commit/4cfe4b1971c615d615c05ce35b9f7dd5ef8315fc))
+
+# @cypress/mount-utils-v1.0.0 (2021-04-21)
+
+
+### Bug Fixes
+
+* improve handling of userland injected styles in component testing ([#16024](https://github.com/cypress-io/cypress/issues/16024)) ([fe0b63c](https://github.com/cypress-io/cypress/commit/fe0b63c299947470c9cdce3a0d00364a1e224bdb))

package/mount-utils/README.md

@@ -0,0 +1,14 @@
+# @cypress/mount-utils
+
+> **Note** this package is not meant to be used outside of cypress component testing.
+
+This librares exports some shared types and utility functions designed to build adapters for components frameworks.
+
+It is used in:
+
+- [`@cypress/react`](https://github.com/cypress-io/cypress/tree/develop/npm/react)
+- [`@cypress/vue`](https://github.com/cypress-io/cypress/tree/develop/npm/vue)
+
+## Changelog
+
+[Changelog](./CHANGELOG.md)

package/mount-utils/dist/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Additional styles to inject into the document.
+ * A component might need 3rd party libraries from CDN,
+ * local CSS files and custom styles.
+ */
+export interface StyleOptions {
+    /**
+     * Creates <link href="..." /> element for each stylesheet
+     * @alias stylesheet
+     */
+    stylesheets: string | string[];
+    /**
+     * Creates <link href="..." /> element for each stylesheet
+     * @alias stylesheets
+     */
+    stylesheet: string | string[];
+    /**
+     * Creates <style>...</style> element and inserts given CSS.
+     * @alias styles
+     */
+    style: string | string[];
+    /**
+     * Creates <style>...</style> element for each given CSS text.
+     * @alias style
+     */
+    styles: string | string[];
+    /**
+     * Loads each file and creates a <style>...</style> element
+     * with the loaded CSS
+     * @alias cssFile
+     */
+    cssFiles: string | string[];
+    /**
+     * Single CSS file to load into a <style></style> element
+     * @alias cssFile
+     */
+    cssFile: string | string[];
+}
+export declare const ROOT_SELECTOR = "[data-cy-root]";
+export declare const getContainerEl: () => HTMLElement;
+/**
+ * Remove any style or extra link elements from the iframe placeholder
+ * left from any previous test
+ *
+ */
+export declare function cleanupStyles(): void;
+/**
+ * Injects custom style text or CSS file or 3rd party style resources
+ * into the given document.
+ */
+export declare const injectStylesBeforeElement: (options: Partial<StyleOptions & {
+    log: boolean;
+}>, document: Document, el: HTMLElement | null) => HTMLElement;
+export declare function setupHooks(optionalCallback?: Function): void;