UI: Improve Button layout and props

[cdedreuille]

What I did

The Button component had a lot of variants that were not used and confusing. Some versions were also missing compared to the design. This PR is an attempt to add the new props for the <Button /> component while still maintaining backward compatibility with versions that uses the old props.

• Add new props + styling for the <Button /> component
• Add depreciated mention for all props we would like to remove in 8.0
• Update documentation to improve visibility on how to use the Button component.

How to test

1. Run a sandbox for template, e.g. yarn task --task sandbox --start-from auto --template react-vite/default-ts
2. Open Storybook in your browser
3. Access the Button story

Checklist

• Make sure your changes are tested (stories and/or unit, integration, or end-to-end tests)
• Make sure to add/update documentation regarding your changes
• If you are deprecating/removing a feature, make sure to update
  MIGRATION.MD

Maintainers

• If this PR should be tested against many or all sandboxes,
  make sure to add the ci:merged or ci:daily GH label to it.
• Make sure this PR contains one of the labels below.

["cleanup", "BREAKING CHANGE", "feature request", "bug", "documentation", "maintenance", "dependencies", "other"]

[socket-security]

No top level dependency changes detected. Learn more about Socket for GitHub ↗︎