feat: Improve clicking with modifiers.

[sainthkh]

• Closes Improve clicking with modifier(s) #486

User facing changelog

You can not send click with simple options like this:

cy.get('#button').click({
  ctrlKey: true,
});

Additional details

• Why was this change necessary? Clicking with modifiers was a bit complicated.
• What is affected by this change? N/A
• Any implementation details to explain? It uses cy.devices.keyboard inside click.

How has the user experience changed?

Before:

cy.get('body').type('{ctrl}', { release: false })
cy.get('#some-el').click()

After:

cy.get('#button').click({
  ctrlKey: true,
});

PR Tasks

• Have tests been added/updated?
• Has the original issue been tagged with a release in ZenHub?
• Has a PR for user-facing changes been opened in cypress-documentation? => Coming soon...
• Have API changes been updated in the type definitions?
• [N/A] Have new configuration options been added to the cypress.schema.json?

[cypress-bot]

Thanks for taking the time to open a PR!

• Create a Draft Pull Request if your PR is not ready for review. Mark the PR as Ready for Review when you're ready for a Cypress team member to review the PR.
• Become familiar with the Code Review Checklist for guidelines on coding standards and what needs to be done before a PR can be merged.

[sainthkh]

Flaky failure.

[jennifer-shehane]

• Any reason to leave out the {meta} modifier?
• The type modifiers also have aliases, to account for Mac vs Windows, etc. Should we also implement: optionKey (alias for altKey), controlKey (alias for ctrlKey), meta / commandKey / cmdKey?

[sainthkh]

No. I just forgot it. I'll cover them tomorrow.

[sainthkh]

Flaky failures.

Dismissing my previous review as addressed

[chrisbreiding]

Looks good! I think we just need docs for this and it's good to go.

[sainthkh]

Add doc at cypress-io/cypress-documentation#3062