doc: support markdown response for AI

packages/docs/next.config.mjs

@@ -16,6 +16,32 @@ const config = {
     ]
   },
   reactStrictMode: true,
+  async rewrites() {
+		return [
+			{
+				source: "/docs/:path*",
+				has: [
+					{
+						type: "header",
+						key: "accept",
+						value: ".*text/(markdown|plain).*",
+					},
+				],
+				missing: [
+					{
+						type: "header", 
+						key: "accept",
+						value: ".*text/html.*",
+					},
+				],
+				destination: "/llms/docs/:path*",
+			},
+      {
+        source: "/docs/:path*.md(x)?",
+        destination: "/llms/docs/:path*",
+      }
+		];
+	},
   redirects: async () => {
     return [
       {

packages/docs/package.json

@@ -20,7 +20,7 @@
     "build:registry": "shadcn build --output ./public",
     "start": "next start",
     "postinstall": "fumadocs-mdx",
-    "test": "tsc"
+    "test": "next typegen && tsc"
   },
   "dependencies": {
     "@faker-js/faker": "^9.9.0",
@@ -47,9 +47,9 @@
     "clsx": "^2.1.1",
     "dayjs": "^1.11.13",
     "effect": "^3.17.8",
-    "fumadocs-core": "^15.6.12",
-    "fumadocs-mdx": "^11.7.5",
-    "fumadocs-ui": "^15.6.12",
+    "fumadocs-core": "^15.8.5",
+    "fumadocs-mdx": "^12.0.3",
+    "fumadocs-ui": "^15.8.5",
     "lucide-react": "^0.540.0",
     "next": "15.5.0",
     "nuqs": "workspace:*",

packages/docs/source.config.ts

@@ -17,7 +17,12 @@ export default defineConfig({
 })
 
 export const { docs, meta } = defineDocs({
-  dir: 'content/docs'
+  dir: 'content/docs',
+  docs: {
+    postprocess: {
+      includeProcessedMarkdown: true,
+    },
+  }
 })
 
 export const blog = defineCollections({

packages/docs/src/app/docs/[[...slug]]/page.tsx

@@ -9,7 +9,9 @@ import {
 } from 'fumadocs-ui/page'
 import type { Metadata } from 'next'
 import { notFound } from 'next/navigation'
+import { Suspense } from 'react'
 import { stat } from 'node:fs/promises'
+import { LLMCopyButton, PageActionsSkeleton, ViewOptions } from '@/src/components/page-actions'
 
 type PageProps = {
   params: Promise<{ slug?: string[] }>
@@ -28,7 +30,20 @@ export default async function Page(props: PageProps) {
   return (
     <DocsPage toc={page.data.toc}>
       <DocsTitle>{page.data.title}</DocsTitle>
-      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsDescription className="mb-0">{page.data.description}</DocsDescription>
+
+      <div className="border-b pb-6">
+        <Suspense fallback={<PageActionsSkeleton />}>
+          <div className="flex flex-row gap-2 items-center">
+            <LLMCopyButton markdownUrl={`${page.url}.mdx`} />
+            <ViewOptions
+              markdownUrl={`${page.url}.mdx`}
+              githubUrl={`https://github.com/47ng/nuqs/blob/dev/packages/docs/content/docs/${page.path}`}
+            />
+          </div>
+        </Suspense>
+      </div>
+
       <DocsBody>
         <MDX components={useMDXComponents()} />
       </DocsBody>

packages/docs/src/app/llms-full.txt/route.ts

@@ -0,0 +1,17 @@
+import { source } from '@/src/app/source';
+import { getLLMText } from '@/src/lib/get-llm-text';
+
+// cached forever
+export const revalidate = false;
+
+const PAGE_EXCLUSIONS = [
+  "/docs/about",
+];
+
+export async function GET() {
+  const pages = source.getPages().filter(page => !PAGE_EXCLUSIONS.includes(page.url));
+  const scan = pages.map(getLLMText);
+  const scanned = await Promise.all(scan);
+
+  return new Response(scanned.join('\n\n'));
+}

packages/docs/src/app/llms.txt/route.ts

@@ -0,0 +1,25 @@
+import { source } from '@/src/app/source';
+import { getLLMText } from '@/src/lib/get-llm-text';
+
+// cached forever
+export const revalidate = false;
+
+export async function GET() {
+  const scanned: string[] = [];
+  scanned.push('# Docs');
+  const map = new Map<string, string[]>();
+
+  for (const page of source.getPages()) {
+    const dir = page.slugs[0];
+    const list = map.get(dir) ?? [];
+    list.push(`- [${page.data.title}](${page.url}): ${page.data.description}`);
+    map.set(dir, list);
+  }
+
+  for (const [key, value] of map) {
+    scanned.push(`## ${key}`);
+    scanned.push(value.join('\n'));
+  }
+
+  return new Response(scanned.join('\n\n'));
+}

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

@@ -0,0 +1,24 @@
+import { getLLMText } from '@/src/lib/get-llm-text';
+import { source } from '@/src/app/source';
+import { notFound } from 'next/navigation';
+
+export const revalidate = false;
+
+export async function GET(
+  _req: Request,
+  { params }: RouteContext<'/llms/docs/[[...slug]]'>,
+) {
+  const { slug } = await params;
+  const page = source.getPage(slug);
+  if (!page) notFound();
+
+  return new Response(await getLLMText(page), {
+    headers: {
+      'Content-Type': 'text/markdown',
+    },
+  });
+}
+
+export function generateStaticParams() {
+  return source.generateParams();
+}