Tooltip: Update the component markup for a11y remediations & refactor the existing styles towards more static styling

[broccolinisoup]

Closeshttps://github.com/github/primer/issues/1909
Closeshttps://github.com/github/primer/issues/1907
Closeshttps://github.com/github/primer/issues/1918

Storybook features: https://primer-7bad896c1f-13348165.drafts.github.io/storybook/?path=/story/components-tooltip-features--tooltip-description-type-tooltip
Docs: https://primer-7bad896c1f-13348165.drafts.github.io/Tooltip

This PR refactors the current Tooltip component to update the markup and styles to match with the expected accessibility requirements.

Merge checklist

• Added/updated tests
• Added/updated documentation
• Tested in Chrome
• Tested in Firefox
• Tested in Safari
• Tested in Edge

Take a look at the What we look for in reviews section of the contributing guidelines for more information on how we review PRs.

[changeset-bot]

🦋 Changeset detected

Latest commit: 7a816fb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@primer/react	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

size-limit report 📦

Path	Size
dist/browser.esm.js	95.82 KB (+0.33% 🔺)
dist/browser.umd.js	96.45 KB (+0.42% 🔺)

[broccolinisoup]

Note that the snapshots are failing on main. It should be good once we resolve the issue on main

[TylerJDev]

Amazing work @broccolinisoup! 🤩

This tooltip will be a huge improvement over our current one in terms of accessibility. As far as my comments, you've addressed all of them! Thanks so much for all the work on this! 🎉

[joshblack]

🥳