fix: add more should interface definitions.

[sainthkh]

• Closes Suggestion: TypeScript: remove fallback for should to increase type safety #5573

User facing changelog

Add more should interface definitions.

Additional details

• Why was this change necessary? Help users with more auto completion.
• What is affected by this change? N/A
• Any implementation details to explain?

To remove duplication in comments, I used union types. Without it, many functions have almost identical 4 different documentation comments.

How has the user experience changed?

Now, auto completions like 'have.lengthOf' work.

Note: Why not removing fallback?

It's because there are too many valid combination for chai.js. It's simply impossible to cover all of them. And we can block valid assertions in TS codes.

It's not hard to find them. All we need to do is running the test once.

PR Tasks

• Have tests been added/updated?
• Has the original issue been tagged with a release in ZenHub?
• [N/A] Has a PR for user-facing changes been opened in cypress-documentation?
• [N/A] 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.

[flotwig]

did a quick look through and didn't see any typos, lgtm i guess. wish there was a less tedious way to do this.

[bahmutov]

this is such a nice job, @sainthkh