docs: fixes and refactoring for API reference

[shahednasser]

• Refactor how data is retrieved in the API reference to retrieve the base specs server side and retrieve paths / schema only when a tag is in view.
• Other general refactoring to improve experience and performance

[changeset-bot]

⚠️ No Changeset found

Latest commit: 1695aae

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
api-reference	🔄 Building (Inspect)	Visit Preview	💬 Add feedback	Oct 22, 2024 10:44am
api-reference-v2	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 22, 2024 10:44am
docs-ui	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 22, 2024 10:44am
docs-v2	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 22, 2024 10:44am
medusa-dashboard	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 22, 2024 10:44am
resources-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 22, 2024 10:44am

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
medusa-docs	⬜️ Ignored (Inspect)	Visit Preview		Oct 22, 2024 10:44am