feat(docs): add HTTP markdown negotiation support

packages/docs/app/llms.mdx/[[...slug]]/route.ts

@@ -0,0 +1,21 @@
+import { getLLMText } from "@/loaders/get-llm-text";
+import { source } from "@/loaders/source";
+import { notFound } from "next/navigation";
+
+export const revalidate = false;
+
+export async function GET(_req: Request, { params }: { params: Promise<{ slug?: string[] }> }) {
+  const { slug } = await params;
+  const page = source.getPage(slug);
+  if (!page) notFound();
+
+  return new Response(await getLLMText(page), {
+    headers: {
+      "Content-Type": "text/markdown; charset=utf-8",
+    },
+  });
+}
+
+export function generateStaticParams() {
+  return source.generateParams();
+}

packages/docs/middleware.ts

@@ -0,0 +1,23 @@
+import { isMarkdownPreferred, rewritePath } from "fumadocs-core/negotiation";
+import { type NextRequest, NextResponse } from "next/server";
+
+const { rewrite: rewriteLLM } = rewritePath("/*path", "/llms.mdx/*path");
+
+export function middleware(request: NextRequest) {
+  const pathname = request.nextUrl.pathname;
+
+  // Handle content negotiation via Accept header
+  if (isMarkdownPreferred(request)) {
+    const result = rewriteLLM(pathname);
+
+    if (result) {
+      return NextResponse.rewrite(new URL(result, request.nextUrl));
+    }
+  }
+
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: ["/((?!api|_next/static|_next/image|favicon.ico).*)"],
+};

packages/docs/next.config.mjs

@@ -36,6 +36,14 @@ function generateRedirects(idmap, page, origin = "/") {
 /** @type {import('next').NextConfig} */
 const config = {
   reactStrictMode: true,
+  async rewrites() {
+    return [
+      {
+        source: "/:path*.md{x}?",
+        destination: "/llms.mdx/:path*",
+      },
+    ];
+  },
   redirects() {
     const mainPageRedirects = [
       // INTRO
@@ -52,7 +60,7 @@ const config = {
           requirements: "requirements",
           "from-npm": "installation",
         },
-        "/"
+        "/",
       ),
 
       // ECOSYSTEM
@@ -68,7 +76,7 @@ const config = {
           "powered-by-zod": "powered-by-zod",
           "utilities-for-zod": "zod-utilities",
         },
-        "/ecosystem"
+        "/ecosystem",
       ),
 
       // BASIC USAGE
@@ -82,7 +90,7 @@ const config = {
           safeparse: "handling-errors",
           safeparseasync: "handling-errors",
         },
-        "/basics"
+        "/basics",
       ),
 
       // API
@@ -173,15 +181,15 @@ const config = {
           readonly: "readonly",
           pipe: "pipes",
         },
-        "/api"
+        "/api",
       ),
 
       // METADATA
       ...generateRedirects(
         {
           describe: "",
         },
-        "/metadata"
+        "/metadata",
       ),
 
       // FOR MAINTAINERS
@@ -191,7 +199,7 @@ const config = {
           "inferring-the-inferred-type": "how-to-accept-user-defined-schemas",
           "constraining-allowable-inputs": "how-to-accept-user-defined-schemas",
         },
-        "/library-authors"
+        "/library-authors",
       ),
 
       // FORMATTING ERRORS
@@ -200,14 +208,14 @@ const config = {
         {
           "error-formatting": "",
         },
-        "/error-formatting"
+        "/error-formatting",
       ),
 
       ...generateRedirects(
         {
           "error-handling": "handling-errors",
         },
-        "/basics"
+        "/basics",
       ),
 
       // DROPPED
@@ -238,7 +246,7 @@ const config = {
           zodparsedtype: "",
         },
         "/error-customization",
-        "/ERROR_HANDLING"
+        "/ERROR_HANDLING",
       ),
       ...generateRedirects(
         {
@@ -248,7 +256,7 @@ const config = {
           "flattening-errors": "zflattenerror",
         },
         "/error-formatting",
-        "/ERROR_HANDLING"
+        "/ERROR_HANDLING",
       ),
     ];
 
@@ -261,7 +269,11 @@ const config = {
       },
     ];
 
-    const redirects = [...mainPageRedirects, ...errorHandlingRedirects, ...changelogRedirects];
+    const redirects = [
+      ...mainPageRedirects,
+      ...errorHandlingRedirects,
+      ...changelogRedirects,
+    ];
     return redirects;
   },
 };

packages/docs/package.json

@@ -13,7 +13,7 @@
     "@radix-ui/react-accordion": "^1.2.4",
     "@vercel/analytics": "^1.5.0",
     "@vercel/og": "^0.6.8",
-    "fumadocs-core": "15.1.0",
+    "fumadocs-core": "15.8.3",
     "fumadocs-mdx": "11.5.6",
     "fumadocs-ui": "15.1.0",
     "gray-matter": "^4.0.3",