docs: add JSON-LD schemas to docs (#14007)

www/apps/api-reference/app/globals.css

@@ -41,7 +41,7 @@
   }
 
   *::selection {
-    @apply bg-medusa-bg-highlight;
+    @apply bg-medusa-fg-subtle text-medusa-fg-on-inverted;
   }
 
   * {

www/apps/api-reference/app/layout.tsx

@@ -4,13 +4,14 @@ import { BareboneLayout, WideLayout } from "docs-ui"
 import clsx from "clsx"
 import { Metadata } from "next"
 import { inter, robotoMono } from "./fonts"
+import { config } from "@/config"
 
 const ogImage =
   "https://res.cloudinary.com/dza7lstvk/image/upload/v1732200992/Medusa%20Resources/opengraph-image_daq6nx.jpg"
 
 export const metadata: Metadata = {
-  title: "Medusa API Reference",
-  description: "Check out Medusa's API reference",
+  title: `%s - ${config.titleSuffix}`,
+  description: config.description,
   metadataBase: new URL(
     process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000"
   ),

www/apps/api-reference/config/index.ts

@@ -5,6 +5,9 @@ const baseUrl = process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000"
 
 export const config: DocsConfig = {
   ...globalConfig,
+  titleSuffix: "Medusa API Reference",
+  description:
+    "Comprehensive reference for Medusa's API routes, request/response structures, authentication methods, and error handling.",
   baseUrl,
   basePath: process.env.NEXT_PUBLIC_BASE_PATH,
   // sidebar is auto generated