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/ui/package.json

@@ -16,7 +16,7 @@
     "@faker-js/faker": "^8.0.2",
     "@medusajs/icons": "^1.2.0",
     "@medusajs/ui": "^2.4.1",
-    "@medusajs/ui-preset": "^1.1.2",
+    "@medusajs/ui-preset": "latest",
     "@radix-ui/react-dialog": "^1.0.4",
     "@radix-ui/react-scroll-area": "^1.0.4",
     "@radix-ui/react-tabs": "^1.0.4",
@@ -30,7 +30,7 @@
     "docs-ui": "*",
     "eslint-config-docs": "*",
     "mdast-util-toc": "^7.0.0",
-    "next": "^14",
+    "next": "^14.1.3",
     "next-contentlayer": "^0.3.4",
     "next-themes": "^0.2.1",
     "postcss": "8.4.27",
@@ -47,7 +47,8 @@
   "devDependencies": {
     "eslint": "^8.49.0",
     "react-docgen": "^7.0.1",
-    "ts-node": "^10.9.1"
+    "ts-node": "^10.9.1",
+    "types": "*"
   },
   "engines": {
     "node": ">=18.17.0"