docs: prep for v2 documentation (#6710)

This PR includes documentation that preps for v2 docs (but doesn't introduce new docs).

_Note: The number of file changes in the PR is due to find-and-replace within the `references` which is unavoidable. Let me know if I should move it to another PR._

## Changes

- Change Medusa version in base OAS used for v2.
- Fix to docblock generator related to not catching all path parameters.
- Added typedoc plugin that generates ER Diagrams, which will be used specifically for data model references in commerce modules.
- Changed OAS tool to output references in `www/apps/api-reference/specs-v2` directory when the `--v2` option is used.
- Added a version switcher to the API reference to switch between V1 and V2. This switcher is enabled by an environment variable, so it won't be visible/usable at the moment.
- Upgraded docusaurus to v3.0.1
- Added new Vale rules to ensure correct spelling of Medusa Admin and module names.
- Added new components to the `docs-ui` package that will be used in future documentation changes.

www/apps/docs/src/theme/MDXComponents/index.tsx

@@ -9,7 +9,7 @@ import MDXDetails from "./Details"
 import DocCard from "@theme/DocCard"
 import DocCardList from "@theme/DocCardList"
 
-export default {
+const components = {
   // Re-use the default mapping
   ...MDXComponents,
   code: MDXCode,
@@ -23,3 +23,5 @@ export default {
   DocCard,
   DocCardList,
 }
+
+export default components

www/apps/docs/src/theme/NavbarItem/NavbarNavLink.tsx

@@ -12,6 +12,7 @@ export default function NavbarNavLink({
   label,
   html,
   prependBaseUrlToHref,
+  isDropdownLink,
   ...props
 }: Omit<Props, "key">): JSX.Element {
   // TODO all this seems hacky