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/vale/styles/docs/MedusaAdmin.yml

@@ -0,0 +1,10 @@
+extends: substitution
+message: "Consider using '%s' instead of '%s'."
+level: error
+ignorecase: false
+action:
+  name: replace
+swap:
+  medusa admin: Medusa Admin
+  Medusa admin: Medusa Admin
+  medusa Admin: Medusa Admin

www/vale/styles/docs/ModuleNames.yml

@@ -0,0 +1,10 @@
+extends: existence
+message: Consider capitalizing module name.
+level: error
+ignorecase: false
+tokens:
+  - the [a-z]\w+ [mM]odule
+  - the \w+ module
+exceptions:
+  - the custom module
+  - the commerce module

www/vale/styles/docs/Numbers.yml

@@ -1,14 +1,16 @@
 extends: existence
 message: "Numbers must be spelled out"
 link: https://medusajs.notion.site/Style-Guide-Docs-fad86dd1c5f84b48b145e959f36628e0#24a7270d3eee4d8e97657b0e12cd979a
-level: error
+level: warning
 ignorecase: true
-scope: paragraph
+scope: sentence
 tokens:
-  - '.*[0-9]+\s(?!(AM|PM))+' #need to match words before to add exceptions
+  - '.*[0-9]+\s*(?!(AM|PM))+' #need to match words before to add exceptions
   - '.*[0-9][.]'
 exceptions:
   - '[pP]ort [0-9]+'
   - 'WSL2'
   - '[vV]ersions? [0-9]'
   - '[v.]+[0-9]+'
+  - '.*\s*\$[0-9]+'
+  - 'itemsPerRow'