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/src/app/assets/sitemap.ts

@@ -2,7 +2,7 @@ import { MetadataRoute } from "next"
 
 import { docsConfig } from "@/config/docs"
 import { absoluteUrl } from "@/lib/absolute-url"
-import { SidebarItemType } from "docs-ui"
+import { SidebarItemType } from "types"
 
 export default function sitemap(): MetadataRoute.Sitemap {
   const now = new Date()

www/apps/ui/src/app/layout.tsx

@@ -1,18 +1,13 @@
 import type { Metadata } from "next"
-import { Inter, Roboto_Mono } from "next/font/google"
 
 import { Navbar } from "@/components/navbar"
 import { Providers } from "@/providers"
 
 import { siteConfig } from "@/config/site"
 import "../styles/globals.css"
-import { Sidebar } from "docs-ui"
-
-const inter = Inter({ subsets: ["latin"], variable: "--inter" })
-const robotoMono = Roboto_Mono({
-  subsets: ["latin"],
-  variable: "--font-roboto-mono",
-})
+import { TightLayout } from "docs-ui"
+import { Inter, Roboto_Mono } from "next/font/google"
+import clsx from "clsx"
 
 export const metadata: Metadata = {
   title: siteConfig.name,
@@ -22,34 +17,32 @@ export const metadata: Metadata = {
   ),
 }
 
+const inter = Inter({
+  subsets: ["latin"],
+  variable: "--font-inter",
+  weight: ["400", "500"],
+})
+
+const robotoMono = Roboto_Mono({
+  subsets: ["latin"],
+  variable: "--font-roboto-mono",
+})
+
 export default function RootLayout({
   children,
 }: {
   children: React.ReactNode
 }) {
   return (
-    <html lang="en" className="h-full w-full">
-      <head />
-      <body
-        className={`bg-docs-bg h-screen overflow-hidden w-full ${inter.variable} ${robotoMono.variable}`}
-      >
-        <Providers>
-          <Navbar />
-          <div
-            className="w-full h-[calc(100%-57px)] overflow-y-scroll overflow-x-hidden"
-            id="main"
-          >
-            <div className="max-w-xxl grid w-full grid-cols-1 px-6 lg:mx-auto lg:grid-cols-[280px_1fr]">
-              <Sidebar expandItems={true} />
-              <div className="relative flex w-full flex-1 items-start justify-center px-4 pb-8 pt-16 md:px-8 lg:px-16 lg:py-[112px]">
-                <main className="h-full w-full lg:max-w-[720px] lg:px-px">
-                  {children}
-                </main>
-              </div>
-            </div>
-          </div>
-        </Providers>
-      </body>
-    </html>
+    <TightLayout
+      ProvidersComponent={Providers}
+      NavbarComponent={Navbar}
+      sidebarProps={{
+        expandItems: true,
+      }}
+      bodyClassName={clsx(inter.variable, robotoMono.variable)}
+    >
+      {children}
+    </TightLayout>
   )
 }