fix(pagination): support accessible markup

[dancormier]

STACKS-687, A11Y-122

---

This PR introduces support for more accessible markup of the pagination component. Existing implementations using the previous markup should render as they did before.

Notable changes

• In order for pagination item heights to render as desired with the new markup, this PR adds display: inline-block to these items.
• I've added a deprecation notice that recommends consumers migrate to the new markup.
• In addition to modifying the markup used in visual tests, I've added legacy markup for child elements using the deprecated structure. I figure this will help us identify any issues that could arise when rendering the deprecated markup.

To test

• Visit the pagination component documentation page
• Inspect the example pagination element to verify the new structure

[netlify]

✅ Deploy Preview for stacks ready!

Name	Link
🔨 Latest commit	2604c4e
🔍 Latest deploy log	https://app.netlify.com/sites/stacks/deploys/675b550499a7a00008b53d6f
😎 Deploy Preview	https://deploy-preview-1870--stacks.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[giamir]

Great work @dancormier. I have only left a couple of suggestions but I would be ok to merge the PR even as it is. I will leave it up to you if you think it makes sense to follow up on them.

Thanks for taking care of this a11y bug. 🎉

[dancormier]

@giamir thank you for your review. I've made the changes you've suggested and I plan to merge this today. If you see anything you think could use revision, let me know!