@farming-labs/docs 0.2.62 → 0.2.64

package/dist/templates-Bq_P7ctv.mjs

@@ -0,0 +1,2465 @@
+import path from "node:path";
+
+//#region src/cli/templates.ts
+const THEME_INFO = {
+	fumadocs: {
+		factory: "fumadocs",
+		nextImport: "@farming-labs/theme",
+		svelteImport: "@farming-labs/svelte-theme",
+		astroImport: "@farming-labs/astro-theme",
+		nuxtImport: "@farming-labs/nuxt-theme",
+		nextCssImport: "default"
+	},
+	darksharp: {
+		factory: "darksharp",
+		nextImport: "@farming-labs/theme/darksharp",
+		svelteImport: "@farming-labs/svelte-theme/darksharp",
+		astroImport: "@farming-labs/astro-theme/darksharp",
+		nuxtImport: "@farming-labs/nuxt-theme/darksharp",
+		nextCssImport: "darksharp"
+	},
+	"pixel-border": {
+		factory: "pixelBorder",
+		nextImport: "@farming-labs/theme/pixel-border",
+		svelteImport: "@farming-labs/svelte-theme/pixel-border",
+		astroImport: "@farming-labs/astro-theme/pixel-border",
+		nuxtImport: "@farming-labs/nuxt-theme/pixel-border",
+		nextCssImport: "pixel-border"
+	},
+	colorful: {
+		factory: "colorful",
+		nextImport: "@farming-labs/theme/colorful",
+		svelteImport: "@farming-labs/svelte-theme/colorful",
+		astroImport: "@farming-labs/astro-theme/colorful",
+		nuxtImport: "@farming-labs/nuxt-theme/colorful",
+		nextCssImport: "colorful"
+	},
+	darkbold: {
+		factory: "darkbold",
+		nextImport: "@farming-labs/theme/darkbold",
+		svelteImport: "@farming-labs/svelte-theme/darkbold",
+		astroImport: "@farming-labs/astro-theme/darkbold",
+		nuxtImport: "@farming-labs/nuxt-theme/darkbold",
+		nextCssImport: "darkbold"
+	},
+	shiny: {
+		factory: "shiny",
+		nextImport: "@farming-labs/theme/shiny",
+		svelteImport: "@farming-labs/svelte-theme/shiny",
+		astroImport: "@farming-labs/astro-theme/shiny",
+		nuxtImport: "@farming-labs/nuxt-theme/shiny",
+		nextCssImport: "shiny"
+	},
+	ledger: {
+		factory: "ledger",
+		nextImport: "@farming-labs/theme/ledger",
+		svelteImport: "@farming-labs/svelte-theme/ledger",
+		astroImport: "@farming-labs/astro-theme/ledger",
+		nuxtImport: "@farming-labs/nuxt-theme/ledger",
+		nextCssImport: "ledger"
+	},
+	greentree: {
+		factory: "greentree",
+		nextImport: "@farming-labs/theme/greentree",
+		svelteImport: "@farming-labs/svelte-theme/greentree",
+		astroImport: "@farming-labs/astro-theme/greentree",
+		nuxtImport: "@farming-labs/nuxt-theme/greentree",
+		nextCssImport: "greentree"
+	},
+	concrete: {
+		factory: "concrete",
+		nextImport: "@farming-labs/theme/concrete",
+		svelteImport: "@farming-labs/svelte-theme/concrete",
+		astroImport: "@farming-labs/astro-theme/concrete",
+		nuxtImport: "@farming-labs/nuxt-theme/concrete",
+		nextCssImport: "concrete"
+	},
+	"command-grid": {
+		factory: "commandGrid",
+		nextImport: "@farming-labs/theme/command-grid",
+		svelteImport: "@farming-labs/svelte-theme/command-grid",
+		astroImport: "@farming-labs/astro-theme/command-grid",
+		nuxtImport: "@farming-labs/nuxt-theme/command-grid",
+		nextCssImport: "command-grid"
+	},
+	hardline: {
+		factory: "hardline",
+		nextImport: "@farming-labs/theme/hardline",
+		svelteImport: "@farming-labs/svelte-theme/hardline",
+		astroImport: "@farming-labs/astro-theme/hardline",
+		nuxtImport: "@farming-labs/nuxt-theme/hardline",
+		nextCssImport: "hardline"
+	}
+};
+function getThemeInfo(theme) {
+	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
+}
+function getThemeCssImport(theme) {
+	return `@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css`;
+}
+function hasBuiltInThemeCssImport(content) {
+	return /["']@farming-labs\/(?:theme|svelte-theme|astro-theme|nuxt-theme)\/[^"'\n]*\/css["']/.test(content);
+}
+function toPosixPath(value) {
+	return value.replace(/\\/g, "/");
+}
+function stripScriptExtension(value) {
+	return value.replace(/\.(?:[cm]?[jt]sx?)$/i, "");
+}
+function relativeImport(fromFile, toFile) {
+	const fromPosix = toPosixPath(fromFile);
+	const toPosix = stripScriptExtension(toPosixPath(toFile));
+	const rel = path.posix.relative(path.posix.dirname(fromPosix), toPosix);
+	return rel.startsWith(".") ? rel : `./${rel}`;
+}
+function relativeAssetPath(fromFile, toFile) {
+	const fromPosix = toPosixPath(fromFile);
+	const toPosix = toPosixPath(toFile);
+	const rel = path.posix.relative(path.posix.dirname(fromPosix), toPosix);
+	return rel.startsWith(".") ? rel : `./${rel}`;
+}
+function extractImportSpecifier(importLine) {
+	const fromMatch = importLine.match(/\bfrom\s+["']([^"']+)["']/);
+	if (fromMatch) return fromMatch[1];
+	const bareImportMatch = importLine.match(/^\s*import\s+["']([^"']+)["']/);
+	if (bareImportMatch) return bareImportMatch[1];
+	return null;
+}
+function addImportLine(content, importLine) {
+	if (content.includes(importLine)) return content;
+	const specifier = extractImportSpecifier(importLine);
+	if (specifier) {
+		if (new RegExp(String.raw`\bimport(?:\s+type)?[\s\S]*?\bfrom\s+["']${specifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']|^\s*import\s+["']${specifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']`, "m").test(content)) return content;
+	}
+	const lines = content.split("\n");
+	const lastImportIdx = lines.reduce((acc, line, index) => {
+		const trimmed = line.trimStart();
+		return trimmed.startsWith("import ") || trimmed.startsWith("import type ") ? index : acc;
+	}, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine, "");
+	return lines.join("\n");
+}
+function renderI18nConfig(cfg, indent = "  ") {
+	const i18n = cfg.i18n;
+	if (!i18n || i18n.locales.length === 0) return "";
+	return `${indent}i18n: {\n${indent}  locales: [${i18n.locales.map((locale) => `"${locale}"`).join(", ")}],\n${indent}  defaultLocale: "${i18n.defaultLocale}",\n${indent}},\n`;
+}
+function renderApiReferenceConfig(cfg, indent = "  ") {
+	const apiReference = cfg.apiReference;
+	if (!apiReference) return "";
+	const rendererLine = cfg.framework === "nextjs" ? `${indent}  renderer: "fumadocs",\n` : "";
+	return `${indent}apiReference: {\n${indent}  enabled: true,\n${indent}  path: "${apiReference.path}",\n${rendererLine}${indent}  routeRoot: "${apiReference.routeRoot}",\n${indent}},\n`;
+}
+function toLocaleImportName(locale) {
+	return `LocalePage_${locale.replace(/[^a-zA-Z0-9_$]/g, "_")}`;
+}
+function getThemeExportName(themeName) {
+	const base = themeName.replace(/\.ts$/i, "").trim();
+	if (!base) return "customTheme";
+	return base.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).replace(/^./, (c) => c.toLowerCase());
+}
+function getCustomThemeCssImportPath(globalCssRelPath, themeName) {
+	if (globalCssRelPath.startsWith("app/")) return `../themes/${themeName}.css`;
+	if (globalCssRelPath.startsWith("src/")) return `../../themes/${themeName}.css`;
+	return `../themes/${themeName}.css`;
+}
+/** Content for themes/{name}.ts - createTheme with the given name */
+function customThemeTsTemplate(themeName) {
+	return `\
+import { createTheme } from "@farming-labs/docs";
+
+export const ${getThemeExportName(themeName)} = createTheme({
+  name: "${themeName.replace(/\.ts$/i, "")}",
+  ui: {
+    colors: {
+      primary: "#e11d48",
+      background: "#09090b",
+      foreground: "#fafafa",
+      muted: "#71717a",
+      border: "#27272a",
+    },
+    radius: "0.5rem",
+  },
+});
+`;
+}
+function customThemeCssTemplate(themeName) {
+	return `\
+/* Custom theme: ${themeName} - edit variables and selectors as needed */
+@import "@farming-labs/theme/presets/black";
+
+.dark {
+  --color-fd-primary: #e11d48;
+  --color-fd-background: #09090b;
+  --color-fd-border: #27272a;
+  --radius: 0.5rem;
+}
+`;
+}
+/** Config import for Next.js root layout → root docs.config */
+function nextRootLayoutConfigImport(useAlias, nextAppDir = "app") {
+	if (useAlias) return "@/docs.config";
+	return nextAppDir === "src/app" ? "../../docs.config" : "../docs.config";
+}
+/** Config import for Next.js app/{entry}/layout.tsx → root docs.config */
+function nextDocsLayoutConfigImport(useAlias, nextAppDir = "app") {
+	if (useAlias) return "@/docs.config";
+	return nextAppDir === "src/app" ? "../../../docs.config" : "../../docs.config";
+}
+function nextApiReferenceConfigImport(useAlias, nextAppDir = "app", filePath) {
+	if (useAlias) return "@/docs.config";
+	return relativeImport(filePath, "docs.config.ts");
+}
+/** Config import for SvelteKit src/lib/docs.server.ts → src/lib/docs.config */
+function svelteServerConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config" : "./docs.config";
+}
+/** Config import for SvelteKit src/routes/{entry}/+layout.svelte → src/lib/docs.config */
+function svelteLayoutConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config" : "../../lib/docs.config";
+}
+/** Config import for SvelteKit src/routes/{entry}/[...slug]/+page.svelte → src/lib/docs.config */
+function sveltePageConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config" : "../../../lib/docs.config";
+}
+/** Server import for SvelteKit +layout.server.js → src/lib/docs.server */
+function svelteLayoutServerImport(useAlias) {
+	return useAlias ? "$lib/docs.server" : "../../lib/docs.server";
+}
+function svelteRouteServerImport(filePath, useAlias) {
+	if (useAlias) return "$lib/docs.server";
+	return relativeImport(filePath, "src/lib/docs.server.ts");
+}
+function svelteRouteConfigImport(filePath, useAlias) {
+	if (useAlias) return "$lib/docs.config";
+	return relativeImport(filePath, "src/lib/docs.config.ts");
+}
+function astroServerConfigImport(useAlias) {
+	return useAlias ? "@/lib/docs.config" : "./docs.config";
+}
+function astroPageConfigImport(useAlias, depth) {
+	if (useAlias) return "@/lib/docs.config";
+	return `${"../".repeat(depth)}lib/docs.config`;
+}
+function astroPageServerImport(useAlias, depth) {
+	if (useAlias) return "@/lib/docs.server";
+	return `${"../".repeat(depth)}lib/docs.server`;
+}
+function astroRouteServerImport(filePath, useAlias) {
+	if (useAlias) return "@/lib/docs.server";
+	return relativeImport(filePath, "src/lib/docs.server.ts");
+}
+function astroRouteConfigImport(filePath, useAlias) {
+	if (useAlias) return "@/lib/docs.config";
+	return relativeImport(filePath, "src/lib/docs.config.ts");
+}
+function docsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${cfg.useAlias ? "@/themes/" + cfg.customThemeName.replace(/\.ts$/i, "") : "./themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nextImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function nextConfigTemplate() {
+	return `\
+import { withDocs } from "@farming-labs/next/config";
+
+export default withDocs();
+`;
+}
+function nextConfigMergedTemplate(existingContent) {
+	if (existingContent.includes("withDocs")) return existingContent;
+	const lines = existingContent.split("\n");
+	const importLine = "import { withDocs } from \"@farming-labs/next/config\";";
+	const exportIdx = lines.findIndex((l) => l.match(/export\s+default/));
+	if (exportIdx === -1) return `${importLine}\n\n${existingContent}\n\nexport default withDocs();\n`;
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("import ") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine, "");
+	const adjustedExportIdx = exportIdx + (lastImportIdx >= 0 ? exportIdx > lastImportIdx ? 1 : 0 : 2);
+	const simpleMatch = lines[adjustedExportIdx].match(/^(\s*export\s+default\s+)(.*?)(;?\s*)$/);
+	if (simpleMatch) {
+		const [, prefix, value, suffix] = simpleMatch;
+		lines[adjustedExportIdx] = `${prefix}withDocs(${value})${suffix}`;
+	}
+	return lines.join("\n");
+}
+function rootLayoutTemplate(cfg, globalCssRelPath = "app/globals.css") {
+	let cssImport;
+	if (globalCssRelPath.startsWith("app/")) cssImport = "./" + globalCssRelPath.slice(4);
+	else if (globalCssRelPath.startsWith("src/app/")) cssImport = "./" + globalCssRelPath.slice(8);
+	else cssImport = "../" + globalCssRelPath;
+	const appDir = cfg.nextAppDir ?? "app";
+	return `\
+import type { Metadata } from "next";
+import { RootProvider } from "@farming-labs/theme";
+import docsConfig from "${nextRootLayoutConfigImport(cfg.useAlias, appDir)}";
+${cfg.apiReference ? "import \"@farming-labs/next/api-reference.css\";\n" : ""}import "${cssImport}";
+
+export const metadata: Metadata = {
+  title: {
+    default: "Docs",
+    template: docsConfig.metadata?.titleTemplate ?? "%s",
+  },
+  description: docsConfig.metadata?.description,
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body>
+        <RootProvider>{children}</RootProvider>
+      </body>
+    </html>
+  );
+}
+`;
+}
+/**
+* Injects RootProvider (import + wrapper) into an existing root layout without overwriting.
+* Returns the modified content, or null if RootProvider is already present or injection isn't possible.
+*/
+function injectRootProviderIntoLayout(content) {
+	if (!content || content.includes("RootProvider")) return null;
+	let out = content;
+	const themeImport = "import { RootProvider } from \"@farming-labs/theme\";";
+	if (!out.includes("@farming-labs/theme")) {
+		const lines = out.split("\n");
+		let lastImportIdx = -1;
+		for (let i = 0; i < lines.length; i++) {
+			const trimmed = lines[i].trimStart();
+			if (trimmed.startsWith("import ") || trimmed.startsWith("import type ")) lastImportIdx = i;
+		}
+		if (lastImportIdx >= 0) {
+			lines.splice(lastImportIdx + 1, 0, themeImport);
+			out = lines.join("\n");
+		} else out = themeImport + "\n" + out;
+	}
+	if (!out.includes("<RootProvider>")) {
+		const childrenPattern = /\{children\}/;
+		if (childrenPattern.test(out)) out = out.replace(childrenPattern, "<RootProvider>{children}</RootProvider>");
+	}
+	return out === content ? null : out;
+}
+function globalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "tailwindcss";
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
+	return `\
+@import "tailwindcss";
+@import "${getThemeCssImport(theme)}";
+`;
+}
+function injectCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = theme === "custom" && customThemeName && globalCssRelPath ? `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";` : `@import "${getThemeCssImport(theme)}";`;
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && hasBuiltInThemeCssImport(existingContent)) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && existingContent.includes(".css")) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+function docsLayoutTemplate(cfg) {
+	const appDir = cfg.nextAppDir ?? "app";
+	return `\
+import docsConfig from "${nextDocsLayoutConfigImport(cfg.useAlias, appDir)}";
+import { createNextDocsLayout, createNextDocsMetadata } from "@farming-labs/next/layout";
+
+export const metadata = createNextDocsMetadata(docsConfig);
+
+const DocsLayout = createNextDocsLayout(docsConfig);
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <>
+      <DocsLayout>{children}</DocsLayout>
+    </>
+  );
+}
+`;
+}
+function nextApiReferencePageTemplate(cfg, filePath) {
+	const appDir = cfg.nextAppDir ?? "app";
+	return `
+import docsConfig from "${nextApiReferenceConfigImport(cfg.useAlias, appDir, filePath)}";
+import { createNextApiReferencePage } from "@farming-labs/next/api-reference";
+
+const ApiReferencePage = createNextApiReferencePage(docsConfig);
+
+export const dynamic = "force-dynamic";
+export const revalidate = 0;
+
+export default ApiReferencePage;
+`;
+}
+function nextLocaleDocPageTemplate(defaultLocale) {
+	return `\
+import type { ComponentType } from "react";
+
+type SearchParams = Promise<{ lang?: string | string[] | undefined }> | undefined;
+
+function normalizeLang(value: string | string[] | undefined) {
+  return Array.isArray(value) ? value[0] : value;
+}
+
+export async function resolveLocaleDocPage<T extends ComponentType>(
+  searchParams: SearchParams,
+  pages: Record<string, T>,
+  fallbackLocale = "${defaultLocale}",
+) {
+  const params = (await searchParams) ?? {};
+  const locale = normalizeLang(params.lang) ?? fallbackLocale;
+
+  return pages[locale] ?? pages[fallbackLocale];
+}
+`;
+}
+function nextLocalizedPageTemplate(options) {
+	const importLines = options.pageImports.map(({ locale, importPath }) => `import ${toLocaleImportName(locale)} from "${importPath}";`).join("\n");
+	const pageMap = options.pageImports.map(({ locale }) => `    ${JSON.stringify(locale)}: ${toLocaleImportName(locale)},`).join("\n");
+	return `\
+${importLines}
+import { resolveLocaleDocPage } from "${options.helperImport}";
+
+type PageProps = {
+  searchParams?: Promise<{ lang?: string | string[] | undefined }>;
+};
+
+export default async function ${options.componentName}({ searchParams }: PageProps) {
+  const Page = await resolveLocaleDocPage(searchParams, {
+${pageMap}
+  }, "${options.defaultLocale}");
+
+  return <Page />;
+}
+`;
+}
+function postcssConfigTemplate() {
+	return `\
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;
+`;
+}
+/** @param useAlias - When false, paths (e.g. @/*) are omitted so no alias is added. */
+function tsconfigTemplate(useAlias = false) {
+	return `\
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [{ "name": "next" }]${useAlias ? ",\n    \"paths\": { \"@/*\": [\"./*\"] }" : ""}
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
+`;
+}
+function welcomePageTemplate(cfg) {
+	const appDir = cfg.nextAppDir ?? "app";
+	return `\
+---
+title: "Documentation"
+description: "Welcome to ${cfg.projectName} documentation"
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+<Callout type="info">
+  This documentation was generated by \`@farming-labs/docs\`. Edit the MDX files in \`${appDir}/${cfg.entry}/\` to customize.
+</Callout>
+
+## Overview
+
+This is your documentation home page. From here you can navigate to:
+
+- [Installation](/${cfg.entry}/installation) — How to install and set up the project
+- [Quickstart](/${cfg.entry}/quickstart) — Get up and running in minutes
+
+## Features
+
+- **MDX Support** — Write docs with Markdown and React components
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function installationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+<Callout type="info">
+  Prerequisites: Node.js 18+ and a package manager (pnpm, npm, or yarn).
+</Callout>
+
+## Install Dependencies
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/next @farming-labs/theme
+\`\`\`
+
+## Configuration
+
+Your project includes a \`docs.config.ts\` at the root:
+
+\`\`\`ts
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nextImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${cfg.nextAppDir ?? "app"}/
+  ${cfg.entry}/
+    layout.tsx          # Docs layout
+    page.mdx            # /${cfg.entry}
+    installation/
+      page.mdx          # /${cfg.entry}/installation
+    quickstart/
+      page.mdx          # /${cfg.entry}/quickstart
+docs.config.ts          # Docs configuration
+next.config.ts          # Next.js config with withDocs()
+\`\`\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function quickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Quickstart"
+description: "Get up and running in minutes"
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \`${cfg.nextAppDir ?? "app"}/${cfg.entry}/\` with a \`page.mdx\` file:
+
+\`\`\`bash
+mkdir -p ${cfg.nextAppDir ?? "app"}/${cfg.entry}/my-page
+\`\`\`
+
+Then create \`${cfg.nextAppDir ?? "app"}/${cfg.entry}/my-page/page.mdx\`:
+
+\`\`\`mdx
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown** and JSX components.
+\`\`\`
+
+Your page is now available at \`/${cfg.entry}/my-page\`.
+
+## Using Components
+
+### Callouts
+
+<Callout type="info">
+  This is an informational callout. Use it for tips and notes.
+</Callout>
+
+<Callout type="warn">
+  This is a warning callout. Use it for important caveats.
+</Callout>
+
+### Code Blocks
+
+Code blocks are automatically syntax-highlighted:
+
+\`\`\`typescript
+function greet(name: string): string {
+  return \\\`Hello, \\\${name}!\\\`;
+}
+
+console.log(greet("World"));
+\`\`\`
+
+## Customizing the Theme
+
+Edit \`docs.config.ts\` to change colors, typography, and component defaults:
+
+\`\`\`ts
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\`\`\`
+
+## Deploying
+
+Build your docs for production:
+
+\`\`\`bash
+pnpm build
+\`\`\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function tanstackDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "./themes/${cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+  nav: {
+    title: "${cfg.projectName} Docs",
+    url: "/${cfg.entry}",
+  },
+  themeToggle: {
+    enabled: true,
+    default: "dark",
+  },
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nextImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+  nav: {
+    title: "${cfg.projectName} Docs",
+    url: "/${cfg.entry}",
+  },
+  themeToggle: {
+    enabled: true,
+    default: "dark",
+  },
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function tanstackDocsServerTemplate() {
+	return `\
+import { createDocsServer } from "@farming-labs/tanstack-start/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
+import docsConfig from "../../docs.config";
+
+export const docsServer = createDocsServer({
+  ...docsConfig,
+  rootDir: process.cwd(),
+  _preloadedAgentSkills: bundledAgentSkills,
+});
+`;
+}
+function tanstackDocsFunctionsTemplate() {
+	return `\
+import { createServerFn } from "@tanstack/react-start";
+import { docsServer } from "./docs.server";
+
+export const loadDocPage = createServerFn({ method: "GET" })
+  .inputValidator((data: { pathname: string; locale?: string }) => data)
+  .handler(async ({ data }) => docsServer.load(data));
+`;
+}
+function tanstackDocsFunctionsImport(opts) {
+	if (opts.useAlias) return "@/lib/docs.functions";
+	return relativeImport(opts.filePath, "src/lib/docs.functions.ts");
+}
+function tanstackDocsConfigImport(filePath) {
+	return relativeImport(filePath, "docs.config.ts");
+}
+function tanstackDocsIndexRouteTemplate(opts) {
+	const entryUrl = `/${opts.entry.replace(/^\/+|\/+$/g, "")}`;
+	return `\
+import { createFileRoute } from "@tanstack/react-router";
+import { toDocsMarkdownUrl } from "@farming-labs/docs";
+import { TanstackDocsPage } from "@farming-labs/tanstack-start/react";
+import { loadDocPage } from "${tanstackDocsFunctionsImport(opts)}";
+import docsConfig from "${tanstackDocsConfigImport(opts.filePath)}";
+
+export const Route = createFileRoute("${entryUrl}/")({
+  loader: () => loadDocPage({ data: { pathname: "${entryUrl}" } }),
+  head: ({ loaderData }) => ({
+    links: loaderData && !docsConfig.staticExport
+      ? [{ rel: "alternate", type: "text/markdown", href: toDocsMarkdownUrl(loaderData.url, { locale: loaderData.locale }) }]
+      : [],
+    meta: [
+      { title: loaderData ? \`\${loaderData.title} – ${opts.projectName}\` : "${opts.projectName}" },
+      ...(loaderData?.description
+        ? [{ name: "description", content: loaderData.description }]
+        : []),
+    ],
+  }),
+  component: DocsIndexPage,
+});
+
+function DocsIndexPage() {
+  const data = Route.useLoaderData();
+  return <TanstackDocsPage config={docsConfig} data={data} />;
+}
+`;
+}
+function tanstackDocsCatchAllRouteTemplate(opts) {
+	const entryUrl = `/${opts.entry.replace(/^\/+|\/+$/g, "")}`;
+	const serverImport = opts.useAlias ? "@/lib/docs.server" : relativeImport(opts.filePath, "src/lib/docs.server.ts");
+	return `\
+import { createFileRoute, notFound } from "@tanstack/react-router";
+import { isDocsPublicGetRequest, toDocsMarkdownUrl } from "@farming-labs/docs";
+import { TanstackDocsPage } from "@farming-labs/tanstack-start/react";
+import { loadDocPage } from "${tanstackDocsFunctionsImport(opts)}";
+import { docsServer } from "${serverImport}";
+import docsConfig from "${tanstackDocsConfigImport(opts.filePath)}";
+
+export const Route = createFileRoute("${entryUrl}/$")({
+  server: {
+    handlers: {
+      GET: async ({ request }) => {
+        const url = new URL(request.url);
+        if (isDocsPublicGetRequest(${JSON.stringify(opts.entry)}, url, request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+          return docsServer.GET({ request });
+        }
+        return undefined;
+      },
+    },
+  },
+  loader: async ({ location }) => {
+    try {
+      return await loadDocPage({ data: { pathname: location.pathname } });
+    } catch (error) {
+      if (
+        error &&
+        typeof error === "object" &&
+        "status" in error &&
+        (error as { status?: unknown }).status === 404
+      ) {
+        throw notFound();
+      }
+      throw error;
+    }
+  },
+  head: ({ loaderData }) => ({
+    links: loaderData && !docsConfig.staticExport
+      ? [{ rel: "alternate", type: "text/markdown", href: toDocsMarkdownUrl(loaderData.url, { locale: loaderData.locale }) }]
+      : [],
+    meta: [
+      { title: loaderData ? \`\${loaderData.title} – ${opts.projectName}\` : "${opts.projectName}" },
+      ...(loaderData?.description
+        ? [{ name: "description", content: loaderData.description }]
+        : []),
+    ],
+  }),
+  component: DocsCatchAllPage,
+});
+
+function DocsCatchAllPage() {
+  const data = Route.useLoaderData();
+  return <TanstackDocsPage config={docsConfig} data={data} />;
+}
+`;
+}
+function tanstackApiDocsRouteTemplate(useAlias, filePath) {
+	return `\
+import { createFileRoute } from "@tanstack/react-router";
+import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
+
+export const Route = createFileRoute("/api/docs")({
+  server: {
+    handlers: {
+      GET: async ({ request }) => docsServer.GET({ request }),
+      POST: async ({ request }) => docsServer.POST({ request }),
+    },
+  },
+});
+`;
+}
+function tanstackDocsPublicRouteTemplate(useAlias, filePath, entry) {
+	return `\
+import { createFileRoute } from "@tanstack/react-router";
+import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
+import docsConfig from "${tanstackDocsConfigImport(filePath)}";
+
+const docsEntry = ${JSON.stringify(entry)};
+
+async function handlePublicDocsRequest(request: Request) {
+  const url = new URL(request.url);
+  const method = request.method.toUpperCase();
+
+  if (isDocsMcpRequest(url, docsConfig.mcp)) {
+    if (method === "OPTIONS") return docsServer.MCP.OPTIONS({ request });
+    if (method === "POST") return docsServer.MCP.POST({ request });
+    if (method === "DELETE") return docsServer.MCP.DELETE({ request });
+    if (method === "GET" || method === "HEAD") return docsServer.MCP.GET({ request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE, OPTIONS" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, url, request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+    return docsServer.GET({ request });
+  }
+
+  return new Response("Not Found", { status: 404 });
+}
+
+export const Route = createFileRoute("/$")({
+  server: {
+    handlers: {
+      GET: async ({ request }) => handlePublicDocsRequest(request),
+      POST: async ({ request }) => handlePublicDocsRequest(request),
+      DELETE: async ({ request }) => handlePublicDocsRequest(request),
+      OPTIONS: async ({ request }) => handlePublicDocsRequest(request),
+    },
+  },
+});
+`;
+}
+function tanstackApiReferenceRouteTemplate(opts) {
+	const routePath = `/${opts.apiReferencePath}${opts.catchAll ? "/$" : "/"}`;
+	return `\
+import { createFileRoute } from "@tanstack/react-router";
+import { createTanstackApiReference } from "@farming-labs/tanstack-start/api-reference";
+import docsConfig from "${tanstackDocsConfigImport(opts.filePath)}";
+
+const handler = createTanstackApiReference(docsConfig);
+
+export const Route = createFileRoute("${routePath}")({
+  server: {
+    handlers: {
+      GET: handler,
+    },
+  },
+});
+`;
+}
+function tanstackRootRouteTemplate(globalCssRelPath) {
+	return `\
+import appCss from "${relativeAssetPath("src/routes/__root.tsx", globalCssRelPath)}?url";
+import { createRootRoute, HeadContent, Outlet, Scripts } from "@tanstack/react-router";
+import { RootProvider } from "@farming-labs/theme/tanstack";
+
+export const Route = createRootRoute({
+  head: () => ({
+    links: [{ rel: "stylesheet", href: appCss }],
+    meta: [
+      { charSet: "utf-8" },
+      { name: "viewport", content: "width=device-width, initial-scale=1" },
+      { title: "Docs" },
+    ],
+  }),
+  component: RootComponent,
+});
+
+function RootComponent() {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head>
+        <HeadContent />
+      </head>
+      <body>
+        <RootProvider>
+          <Outlet />
+        </RootProvider>
+        <Scripts />
+      </body>
+    </html>
+  );
+}
+`;
+}
+function injectTanstackRootProviderIntoRoute(content) {
+	if (!content || content.includes("RootProvider")) return null;
+	let out = addImportLine(content, "import { RootProvider } from \"@farming-labs/theme/tanstack\";");
+	if (out.includes("<Outlet />")) out = out.replace("<Outlet />", "<RootProvider><Outlet /></RootProvider>");
+	else if (out.includes("<Outlet></Outlet>")) out = out.replace("<Outlet></Outlet>", "<RootProvider><Outlet /></RootProvider>");
+	else return null;
+	return out === content ? null : out;
+}
+function tanstackViteConfigTemplate(useAlias) {
+	return `\
+import { defineConfig } from "vite";
+import tailwindcss from "@tailwindcss/vite";
+${useAlias ? "import tsconfigPaths from \"vite-tsconfig-paths\";\n" : ""}import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import { docsMdx } from "@farming-labs/tanstack-start/vite";
+import docsConfig from "./docs.config";
+
+export default defineConfig({
+  plugins: [tailwindcss(), docsMdx(), docsAgentSkills(docsConfig), ${useAlias ? "tsconfigPaths({ ignoreConfigErrors: true }), " : ""}tanstackStart()],
+});
+`;
+}
+function svelteViteConfigTemplate() {
+	return `\
+import { sveltekit } from "@sveltejs/kit/vite";
+import { defineConfig } from "vite";
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import docsConfig from "./src/lib/docs.config";
+
+export default defineConfig({
+  plugins: [sveltekit(), docsAgentSkills(docsConfig)],
+});
+`;
+}
+/** Add the Agent Skills snapshot plugin to an existing Vite config. */
+function injectDocsAgentSkillsVitePlugin(content, configImportPath) {
+	if (!content) return null;
+	let out = addImportLine(content, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, `import docsConfig from ${JSON.stringify(configImportPath)};`);
+	if (out.includes("docsAgentSkills(docsConfig)")) return out === content ? null : out;
+	const pluginsMatch = out.match(/plugins\s*:\s*\[([\s\S]*?)\]/m);
+	if (pluginsMatch) {
+		const current = pluginsMatch[1].trim();
+		const existing = current ? `${current}${current.endsWith(",") ? "" : ","}` : "";
+		return out.replace(pluginsMatch[0], `plugins: [${existing}${existing ? " " : ""}docsAgentSkills(docsConfig)]`);
+	}
+	const configMatch = out.match(/defineConfig\(\s*\{/);
+	if (!configMatch) return null;
+	return out.replace(configMatch[0], "defineConfig({\n  plugins: [docsAgentSkills(docsConfig)],");
+}
+function injectTanstackVitePlugins(content, useAlias) {
+	if (!content) return null;
+	let out = content;
+	out = addImportLine(out, "import tailwindcss from \"@tailwindcss/vite\";");
+	if (useAlias) out = addImportLine(out, "import tsconfigPaths from \"vite-tsconfig-paths\";");
+	out = addImportLine(out, "import { docsMdx } from \"@farming-labs/tanstack-start/vite\";");
+	out = addImportLine(out, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, "import docsConfig from \"./docs.config\";");
+	const additions = [];
+	if (!out.includes("tailwindcss()")) additions.push("tailwindcss()");
+	if (!out.includes("docsMdx()")) additions.push("docsMdx()");
+	if (!out.includes("docsAgentSkills(")) additions.push("docsAgentSkills(docsConfig)");
+	if (useAlias && !out.includes("tsconfigPaths(")) additions.push("tsconfigPaths({ ignoreConfigErrors: true })");
+	if (additions.length === 0) return out === content ? null : out;
+	const pluginsMatch = out.match(/plugins\s*:\s*\[([\s\S]*?)\]/m);
+	if (pluginsMatch) {
+		const current = pluginsMatch[1].trim();
+		const existing = current ? `${current}${current.endsWith(",") ? "" : ","}` : "";
+		const replacement = `plugins: [\n    ${existing}${existing ? "\n    " : ""}${additions.join(",\n    ")}\n  ]`;
+		return out.replace(pluginsMatch[0], replacement);
+	}
+	const configMatch = out.match(/defineConfig\(\s*\{/);
+	if (configMatch) {
+		const insertion = `defineConfig({\n  plugins: [${additions.join(", ")}],`;
+		return out.replace(configMatch[0], insertion);
+	}
+	return out === content ? null : out;
+}
+function tanstackWelcomePageTemplate(cfg) {
+	return `\
+---
+title: "Documentation"
+description: "Welcome to ${cfg.projectName} documentation"
+---
+
+# Welcome to ${cfg.projectName}
+
+This docs site is powered by \`@farming-labs/docs\` and TanStack Start.
+
+## Overview
+
+- Content lives in \`${cfg.entry}/\`
+- Routes live in \`src/routes/${cfg.entry}/\`
+- Search is served from \`/api/docs\`
+
+## Next Steps
+
+Read the [Installation](/${cfg.entry}/installation) guide, then continue to [Quickstart](/${cfg.entry}/quickstart).
+`;
+}
+function tanstackInstallationPageTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		const exportName = getThemeExportName(baseName);
+		const cssImportPath = getCustomThemeCssImportPath("src/styles/app.css", baseName);
+		return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Add the docs packages to your TanStack Start app:
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/theme @farming-labs/tanstack-start
+\`\`\`
+
+The scaffold also configures MDX through \`docsMdx()\` in \`vite.config.ts\`.
+
+## Theme CSS
+
+Keep your config theme and global CSS import aligned:
+
+\`\`\`ts title="docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "./themes/${baseName}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${exportName}(),
+});
+\`\`\`
+
+\`\`\`css title="src/styles/app.css"
+@import "tailwindcss";
+@import "${cssImportPath}";
+\`\`\`
+
+## Generated Files
+
+\`\`\`
+docs.config.ts
+themes/${baseName}.ts
+themes/${baseName}.css
+${cfg.entry}/
+src/lib/docs.server.ts
+src/lib/docs.functions.ts
+src/routes/${cfg.entry}/index.tsx
+src/routes/${cfg.entry}/$.tsx
+src/routes/api/docs.ts
+src/routes/$.ts
+\`\`\`
+`;
+	}
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Add the docs packages to your TanStack Start app:
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/theme @farming-labs/tanstack-start
+\`\`\`
+
+The scaffold also configures MDX through \`docsMdx()\` in \`vite.config.ts\`.
+
+## Theme CSS
+
+Keep your config theme and global CSS import aligned:
+
+\`\`\`ts title="docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nextImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}(),
+});
+\`\`\`
+
+\`\`\`css title="src/styles/app.css"
+@import "tailwindcss";
+@import "@farming-labs/theme/${t.nextCssImport}/css";
+\`\`\`
+
+## Generated Files
+
+\`\`\`
+docs.config.ts
+${cfg.entry}/
+src/lib/docs.server.ts
+src/lib/docs.functions.ts
+src/routes/${cfg.entry}/index.tsx
+src/routes/${cfg.entry}/$.tsx
+src/routes/api/docs.ts
+\`\`\`
+`;
+}
+function tanstackQuickstartPageTemplate(cfg) {
+	return `\
+---
+title: "Quickstart"
+description: "Get up and running in minutes"
+---
+
+# Quickstart
+
+Create a new page under \`${cfg.entry}/\`:
+
+\`\`\`bash
+mkdir -p ${cfg.entry}/my-page
+\`\`\`
+
+Then add \`${cfg.entry}/my-page/page.mdx\`:
+
+\`\`\`mdx
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **MDX**.
+\`\`\`
+
+Visit [/${cfg.entry}/my-page](/${cfg.entry}/my-page) after starting the dev server.
+`;
+}
+function svelteDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${"../../themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.svelteImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function svelteDocsServerTemplate(cfg) {
+	return `\
+import { createDocsServer } from "@farming-labs/svelte/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
+import config from "${svelteServerConfigImport(cfg.useAlias)}";
+
+// preload for production
+const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx}", "/AGENTS.md", "/AGENT.md", "/skill.md", "/.farming-labs/sitemap-manifest.json"], {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const { load, GET, POST, MCP } = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+  _preloadedAgentSkills: bundledAgentSkills,
+});
+`;
+}
+function svelteDocsLayoutTemplate(cfg) {
+	return `\
+<script>
+  import { DocsLayout } from "@farming-labs/svelte-theme";
+  import config from "${svelteLayoutConfigImport(cfg.useAlias)}";
+
+  let { data, children } = $props();
+<\/script>
+
+<DocsLayout tree={data.tree} {config}>
+  {@render children()}
+</DocsLayout>
+`;
+}
+function svelteDocsLayoutServerTemplate(cfg) {
+	return `\
+export { load } from "${svelteLayoutServerImport(cfg.useAlias)}";
+`;
+}
+function svelteDocsPageTemplate(cfg) {
+	return `\
+<script>
+  import { DocsContent } from "@farming-labs/svelte-theme";
+  import config from "${sveltePageConfigImport(cfg.useAlias)}";
+
+  let { data } = $props();
+<\/script>
+
+<DocsContent {data} {config} />
+`;
+}
+function svelteApiReferenceRouteTemplate(filePath, useAlias) {
+	return `\
+import { createSvelteApiReference } from "@farming-labs/svelte/api-reference";
+import config from "${useAlias ? "$lib/docs.config" : relativeImport(filePath, "src/lib/docs.config.ts")}";
+
+export const GET = createSvelteApiReference(config);
+`;
+}
+function svelteDocsApiRouteTemplate(filePath, useAlias) {
+	return `\
+export { GET, POST } from "${svelteRouteServerImport(filePath, useAlias)}";
+`;
+}
+function svelteDocsPublicHookTemplate(filePath, useAlias) {
+	const serverImport = svelteRouteServerImport(filePath, useAlias);
+	return `\
+import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import type { Handle } from "@sveltejs/kit";
+import config from "${svelteRouteConfigImport(filePath, useAlias)}";
+import { GET, MCP } from "${serverImport}";
+
+const docsEntry = config.entry ?? "docs";
+
+export const handle: Handle = async ({ event, resolve }) => {
+  const method = event.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(event.url, config.mcp)) {
+    if (method === "OPTIONS") return MCP.OPTIONS({ request: event.request });
+    if (method === "POST") return MCP.POST({ request: event.request });
+    if (method === "DELETE") return MCP.DELETE({ request: event.request });
+    if (method === "GET" || method === "HEAD") return MCP.GET({ request: event.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE, OPTIONS" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(event.url, config.llmsTxt, docsEntry)) {
+    const nativeResponse = await resolve(event);
+    if (nativeResponse.status !== 404) return nativeResponse;
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { sitemap: config.sitemap, llms: config.llmsTxt, robots: config.robots })) {
+    return GET({ url: event.url, request: event.request });
+  }
+
+  return resolve(event);
+};
+`;
+}
+function injectSvelteDocsPublicHook(content, filePath, useAlias) {
+	if (content.includes("isDocsPublicGetRequest") || content.includes("docsPublicHandle")) return null;
+	if (/export\s*{\s*handle\b/.test(content)) return null;
+	const serverImport = svelteRouteServerImport(filePath, useAlias);
+	const configImport = svelteRouteConfigImport(filePath, useAlias);
+	let next = content.trimEnd();
+	let hasExistingHandle = false;
+	for (const [pattern, replacement] of [
+		[/\bexport\s+const\s+handle(\s*:\s*[^=]+)?\s*=/, "const existingHandle$1 ="],
+		[/\bexport\s+async\s+function\s+handle\b/, "async function existingHandle"],
+		[/\bexport\s+function\s+handle\b/, "function existingHandle"]
+	]) if (pattern.test(next)) {
+		next = next.replace(pattern, replacement);
+		next = next.replace(/const existingHandle(:[^=\n]*?)\s+=/, "const existingHandle$1 =");
+		hasExistingHandle = true;
+		break;
+	}
+	const imports = [
+		"import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from \"@farming-labs/docs\";",
+		...next.includes("Handle") ? [] : ["import type { Handle } from \"@sveltejs/kit\";"],
+		...hasExistingHandle && !next.includes("sequence") ? ["import { sequence } from \"@sveltejs/kit/hooks\";"] : [],
+		`import docsConfig from "${configImport}";`,
+		`import { GET as docsGET, MCP as docsMCP } from "${serverImport}";`
+	];
+	const docsHandle = `\
+const docsEntry = docsConfig.entry ?? "docs";
+
+const docsPublicHandle: Handle = async ({ event, resolve }) => {
+  const method = event.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(event.url, docsConfig.mcp)) {
+    if (method === "OPTIONS") return docsMCP.OPTIONS({ request: event.request });
+    if (method === "POST") return docsMCP.POST({ request: event.request });
+    if (method === "DELETE") return docsMCP.DELETE({ request: event.request });
+    if (method === "GET" || method === "HEAD") return docsMCP.GET({ request: event.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE, OPTIONS" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(event.url, docsConfig.llmsTxt, docsEntry)) {
+    const nativeResponse = await resolve(event);
+    if (nativeResponse.status !== 404) return nativeResponse;
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+    return docsGET({ url: event.url, request: event.request });
+  }
+
+  return resolve(event);
+};`;
+	const exportLine = hasExistingHandle ? "export const handle = sequence(docsPublicHandle, existingHandle);" : "export const handle = docsPublicHandle;";
+	return `${imports.join("\n")}\n${next}\n\n${docsHandle}\n\n${exportLine}\n`;
+}
+function svelteRootLayoutTemplate(globalCssRelPath) {
+	let cssImport;
+	if (globalCssRelPath.startsWith("src/")) cssImport = "./" + globalCssRelPath.slice(4);
+	else cssImport = "../" + globalCssRelPath;
+	return `\
+<script>
+  import "${cssImport}";
+
+  let { children } = $props();
+<\/script>
+
+{@render children()}
+`;
+}
+function svelteGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
+	return `\
+@import "${getThemeCssImport(theme)}";
+`;
+}
+function svelteCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
+	return `@import "${getThemeCssImport(theme)}";`;
+}
+function injectSvelteCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = svelteCssImportLine(theme, customThemeName, globalCssRelPath);
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && hasBuiltInThemeCssImport(existingContent)) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && existingContent.includes(".css")) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+function svelteWelcomePageTemplate(cfg) {
+	return `\
+---
+title: "Documentation"
+description: "Welcome to ${cfg.projectName} documentation"
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+## Overview
+
+This documentation was generated by \`@farming-labs/docs\`. Edit the markdown files in \`${cfg.entry}/\` to customize.
+
+## Features
+
+- **Markdown Support** — Write docs with standard Markdown
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function svelteInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+## Prerequisites
+
+- Node.js 18+
+- A package manager (pnpm, npm, or yarn)
+
+## Install Dependencies
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/svelte @farming-labs/svelte-theme @farming-labs/theme
+\`\`\`
+
+## Configuration
+
+Your project includes a \`docs.config.ts\` in \`src/lib/\`:
+
+\`\`\`ts title="src/lib/docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.svelteImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${cfg.entry}/                   # Markdown content
+  page.md                      # /${cfg.entry}
+  installation/
+    page.md                    # /${cfg.entry}/installation
+  quickstart/
+    page.md                    # /${cfg.entry}/quickstart
+src/
+  hooks.server.ts             # Public docs aliases
+  lib/
+    docs.config.ts             # Docs configuration
+    docs.server.ts             # Server-side docs loader
+  routes/
+    api/docs/+server.ts        # Search/AI API route
+    ${cfg.entry}/
+      +layout.svelte           # Docs layout
+      +layout.server.js        # Layout data loader
+      [...slug]/
+        +page.svelte           # Dynamic doc page
+\`\`\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function svelteQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Quickstart"
+description: "Get up and running in minutes"
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \`${cfg.entry}/\` with a \`page.md\` file:
+
+\`\`\`bash
+mkdir -p ${cfg.entry}/my-page
+\`\`\`
+
+Then create \`${cfg.entry}/my-page/page.md\`:
+
+\`\`\`md
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown**.
+\`\`\`
+
+Your page is now available at \`/${cfg.entry}/my-page\`.
+
+## Code Blocks
+
+Code blocks are automatically syntax-highlighted:
+
+\`\`\`typescript
+function greet(name: string): string {
+  return \\\`Hello, \\\${name}!\\\`;
+}
+
+console.log(greet("World"));
+\`\`\`
+
+## Customizing the Theme
+
+Edit \`src/lib/docs.config.ts\` to change colors, typography, and component defaults:
+
+\`\`\`ts title="src/lib/docs.config.ts"
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\`\`\`
+
+## Deploying
+
+Build your docs for production:
+
+\`\`\`bash
+pnpm build
+\`\`\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function astroDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${"../../themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.astroImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function astroDocsServerTemplate(cfg) {
+	return `\
+import { createDocsServer } from "@farming-labs/astro/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
+import config from "${astroServerConfigImport(cfg.useAlias)}";
+
+const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx}", "/AGENTS.md", "/AGENT.md", "/skill.md", "/.farming-labs/sitemap-manifest.json"], {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const { load, GET, POST, MCP } = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+  _preloadedAgentSkills: bundledAgentSkills,
+});
+`;
+}
+const ASTRO_ADAPTER_INFO = {
+	vercel: {
+		pkg: "@astrojs/vercel",
+		import: "@astrojs/vercel"
+	},
+	netlify: {
+		pkg: "@astrojs/netlify",
+		import: "@astrojs/netlify"
+	},
+	node: {
+		pkg: "@astrojs/node",
+		import: "@astrojs/node"
+	},
+	cloudflare: {
+		pkg: "@astrojs/cloudflare",
+		import: "@astrojs/cloudflare"
+	}
+};
+function getAstroAdapterPkg(adapter) {
+	return ASTRO_ADAPTER_INFO[adapter]?.pkg ?? ASTRO_ADAPTER_INFO.vercel.pkg;
+}
+function astroConfigTemplate(adapter = "vercel") {
+	const info = ASTRO_ADAPTER_INFO[adapter] ?? ASTRO_ADAPTER_INFO.vercel;
+	const adapterCall = adapter === "node" ? `${adapter}({ mode: "standalone" })` : `${adapter}()`;
+	return `\
+import { defineConfig } from "astro/config";
+import ${adapter} from "${info.import}";
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import docsConfig from "./src/lib/docs.config";
+
+export default defineConfig({
+  output: "server",
+  adapter: ${adapterCall},
+  vite: { plugins: [docsAgentSkills(docsConfig)] },
+});
+`;
+}
+/** Add the Agent Skills snapshot plugin to an existing Astro config. */
+function injectAstroAgentSkillsPlugin(content) {
+	if (!content) return null;
+	let out = addImportLine(content, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, "import docsConfig from \"./src/lib/docs.config\";");
+	if (out.includes("docsAgentSkills(docsConfig)")) return out === content ? null : out;
+	const vitePlugins = out.match(/(vite\s*:\s*\{[\s\S]*?plugins\s*:\s*\[)([\s\S]*?)(\])/m);
+	if (vitePlugins) {
+		const current = vitePlugins[2].trim();
+		const next = `${current}${current && !current.endsWith(",") ? "," : ""}${current ? " " : ""}docsAgentSkills(docsConfig)`;
+		return out.replace(vitePlugins[0], `${vitePlugins[1]}${next}${vitePlugins[3]}`);
+	}
+	const viteBlock = out.match(/vite\s*:\s*\{/);
+	if (viteBlock) return out.replace(viteBlock[0], `${viteBlock[0]}\n    plugins: [docsAgentSkills(docsConfig)],`);
+	const configMatch = out.match(/defineConfig\(\s*\{/);
+	if (!configMatch) return null;
+	return out.replace(configMatch[0], "defineConfig({\n  vite: { plugins: [docsAgentSkills(docsConfig)] },");
+}
+function astroDocsPageTemplate(cfg) {
+	return `\
+---
+import DocsLayout from "@farming-labs/astro-theme/src/components/DocsLayout.astro";
+import DocsContent from "@farming-labs/astro-theme/src/components/DocsContent.astro";
+import SearchDialog from "@farming-labs/astro-theme/src/components/SearchDialog.astro";
+import config from "${astroPageConfigImport(cfg.useAlias, 2)}";
+import { load } from "${astroPageServerImport(cfg.useAlias, 2)}";
+import "${getThemeCssImport(cfg.theme)}";
+
+const data = await load(Astro.url.pathname);
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{data.title} – Docs</title>
+  </head>
+  <body>
+    <DocsLayout tree={data.tree} config={config}>
+      <DocsContent data={data} config={config} />
+    </DocsLayout>
+    <SearchDialog config={config} />
+  </body>
+</html>
+`;
+}
+function astroDocsIndexTemplate(cfg) {
+	return `\
+---
+import DocsLayout from "@farming-labs/astro-theme/src/components/DocsLayout.astro";
+import DocsContent from "@farming-labs/astro-theme/src/components/DocsContent.astro";
+import SearchDialog from "@farming-labs/astro-theme/src/components/SearchDialog.astro";
+import config from "${astroPageConfigImport(cfg.useAlias, 2)}";
+import { load } from "${astroPageServerImport(cfg.useAlias, 2)}";
+import "${getThemeCssImport(cfg.theme)}";
+
+const data = await load(Astro.url.pathname);
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{data.title} – Docs</title>
+  </head>
+  <body>
+    <DocsLayout tree={data.tree} config={config}>
+      <DocsContent data={data} config={config} />
+    </DocsLayout>
+    <SearchDialog config={config} />
+  </body>
+</html>
+`;
+}
+function astroApiRouteTemplate(cfg) {
+	return `\
+import type { APIRoute } from "astro";
+import { GET as docsGET, POST as docsPOST } from "${astroPageServerImport(cfg.useAlias, 2)}";
+
+export const GET: APIRoute = async ({ request }) => {
+  return docsGET({ request });
+};
+
+export const POST: APIRoute = async ({ request }) => {
+  return docsPOST({ request });
+};
+`;
+}
+function astroDocsMiddlewareTemplate(filePath, useAlias) {
+	const serverImport = astroRouteServerImport(filePath, useAlias);
+	return `\
+import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import type { MiddlewareHandler } from "astro";
+import config from "${astroRouteConfigImport(filePath, useAlias)}";
+import { GET, MCP } from "${serverImport}";
+
+const docsEntry = config.entry ?? "docs";
+
+export const onRequest: MiddlewareHandler = async (context, next) => {
+  const method = context.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(context.url, config.mcp)) {
+    if (method === "OPTIONS") return MCP.OPTIONS({ request: context.request });
+    if (method === "POST") return MCP.POST({ request: context.request });
+    if (method === "DELETE") return MCP.DELETE({ request: context.request });
+    if (method === "GET" || method === "HEAD") return MCP.GET({ request: context.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE, OPTIONS" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(context.url, config.llmsTxt, docsEntry)) {
+    const nativeResponse = await next();
+    if (nativeResponse.status !== 404) return nativeResponse;
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { sitemap: config.sitemap, llms: config.llmsTxt, robots: config.robots })) {
+    return GET({ request: context.request });
+  }
+
+  return next();
+};
+`;
+}
+function injectAstroDocsMiddleware(content, filePath, useAlias) {
+	if (content.includes("isDocsPublicGetRequest") || content.includes("docsPublicMiddleware")) return null;
+	if (/export\s*{\s*onRequest\b/.test(content)) return null;
+	const serverImport = astroRouteServerImport(filePath, useAlias);
+	const configImport = astroRouteConfigImport(filePath, useAlias);
+	let next = content.trimEnd();
+	let hasExistingMiddleware = false;
+	for (const [pattern, replacement] of [
+		[/\bexport\s+const\s+onRequest(\s*:\s*[^=]+)?\s*=/, "const existingOnRequest$1 ="],
+		[/\bexport\s+async\s+function\s+onRequest\b/, "async function existingOnRequest"],
+		[/\bexport\s+function\s+onRequest\b/, "function existingOnRequest"]
+	]) if (pattern.test(next)) {
+		next = next.replace(pattern, replacement);
+		next = next.replace(/const existingOnRequest(:[^=\n]*?)\s+=/, "const existingOnRequest$1 =");
+		hasExistingMiddleware = true;
+		break;
+	}
+	const imports = [
+		"import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from \"@farming-labs/docs\";",
+		...next.includes("MiddlewareHandler") ? [] : ["import type { MiddlewareHandler } from \"astro\";"],
+		...hasExistingMiddleware && !next.includes("sequence") ? ["import { sequence } from \"astro:middleware\";"] : [],
+		`import docsConfig from "${configImport}";`,
+		`import { GET as docsGET, MCP as docsMCP } from "${serverImport}";`
+	];
+	const docsMiddleware = `\
+const docsEntry = docsConfig.entry ?? "docs";
+
+const docsPublicMiddleware: MiddlewareHandler = async (context, next) => {
+  const method = context.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(context.url, docsConfig.mcp)) {
+    if (method === "OPTIONS") return docsMCP.OPTIONS({ request: context.request });
+    if (method === "POST") return docsMCP.POST({ request: context.request });
+    if (method === "DELETE") return docsMCP.DELETE({ request: context.request });
+    if (method === "GET" || method === "HEAD") return docsMCP.GET({ request: context.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE, OPTIONS" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(context.url, docsConfig.llmsTxt, docsEntry)) {
+    const nativeResponse = await next();
+    if (nativeResponse.status !== 404) return nativeResponse;
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+    return docsGET({ request: context.request });
+  }
+
+  return next();
+};`;
+	const exportLine = hasExistingMiddleware ? "export const onRequest = sequence(docsPublicMiddleware, existingOnRequest);" : "export const onRequest = docsPublicMiddleware;";
+	return `${imports.join("\n")}\n${next}\n\n${docsMiddleware}\n\n${exportLine}\n`;
+}
+function astroApiReferenceRouteTemplate(filePath) {
+	return `\
+import { createAstroApiReference } from "@farming-labs/astro/api-reference";
+import config from "${relativeImport(filePath, "src/lib/docs.config.ts")}";
+
+export const GET = createAstroApiReference(config);
+`;
+}
+function astroGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
+	return `\
+@import "${getThemeCssImport(theme)}";
+`;
+}
+function astroCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
+	return `@import "${getThemeCssImport(theme)}";`;
+}
+function injectAstroCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = astroCssImportLine(theme, customThemeName, globalCssRelPath);
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && hasBuiltInThemeCssImport(existingContent)) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && existingContent.includes(".css")) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+function astroWelcomePageTemplate(cfg) {
+	return `\
+---
+title: "Documentation"
+description: "Welcome to ${cfg.projectName} documentation"
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+## Overview
+
+This documentation was generated by \`@farming-labs/docs\`. Edit the markdown files in \`${cfg.entry}/\` to customize.
+
+## Features
+
+- **Markdown Support** — Write docs with standard Markdown
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function astroInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+## Prerequisites
+
+- Node.js 18+
+- A package manager (pnpm, npm, or yarn)
+
+## Install Dependencies
+
+\\\`\\\`\\\`bash
+pnpm add @farming-labs/docs @farming-labs/astro @farming-labs/astro-theme @farming-labs/theme
+\\\`\\\`\\\`
+
+## Configuration
+
+Your project includes a \\\`docs.config.ts\\\` in \\\`src/lib/\\\`:
+
+\\\`\\\`\\\`ts title="src/lib/docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.astroImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\\\`\\\`\\\`
+
+## Project Structure
+
+\\\`\\\`\\\`
+${cfg.entry}/                   # Markdown content
+  page.md                      # /${cfg.entry}
+  installation/
+    page.md                    # /${cfg.entry}/installation
+  quickstart/
+    page.md                    # /${cfg.entry}/quickstart
+src/
+  middleware.ts                # Public docs aliases
+  lib/
+    docs.config.ts             # Docs configuration
+    docs.server.ts             # Server-side docs loader
+  pages/
+    ${cfg.entry}/
+      index.astro              # Docs index page
+      [...slug].astro          # Dynamic doc page
+    api/
+      ${cfg.entry}.ts          # Search/AI API route
+\\\`\\\`\\\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function astroQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Quickstart"
+description: "Get up and running in minutes"
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \\\`${cfg.entry}/\\\` with a \\\`page.md\\\` file:
+
+\\\`\\\`\\\`bash
+mkdir -p ${cfg.entry}/my-page
+\\\`\\\`\\\`
+
+Then create \\\`${cfg.entry}/my-page/page.md\\\`:
+
+\\\`\\\`\\\`md
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown**.
+\\\`\\\`\\\`
+
+Your page is now available at \\\`/${cfg.entry}/my-page\\\`.
+
+## Customizing the Theme
+
+Edit \\\`src/lib/docs.config.ts\\\` to change colors, typography, and component defaults:
+
+\\\`\\\`\\\`ts title="src/lib/docs.config.ts"
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\\\`\\\`\\\`
+
+## Deploying
+
+Build your docs for production:
+
+\\\`\\\`\\\`bash
+pnpm build
+\\\`\\\`\\\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function nuxtDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${cfg.useAlias ? "~/themes/" + cfg.customThemeName.replace(/\.ts$/i, "") : "./themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nuxtImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function nuxtServerApiDocsRouteTemplate(cfg) {
+	return `\
+import { defineDocsHandler } from "@farming-labs/nuxt/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
+
+export default defineDocsHandler(
+  { ...config, _preloadedAgentSkills: bundledAgentSkills },
+  useStorage,
+);
+`;
+}
+function nuxtServerDocsPublicMiddlewareTemplate(cfg) {
+	return `\
+import { defineDocsPublicHandler } from "@farming-labs/nuxt/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
+
+export default defineDocsPublicHandler(
+  { ...config, _preloadedAgentSkills: bundledAgentSkills },
+  useStorage,
+);
+`;
+}
+function nuxtServerApiReferenceRouteTemplate(filePath, useAlias) {
+	return `\
+import { defineApiReferenceHandler } from "@farming-labs/nuxt/api-reference";
+import config from "${useAlias ? "~/docs.config" : relativeImport(filePath, "docs.config.ts")}";
+
+export default defineApiReferenceHandler(config);
+`;
+}
+function nuxtDocsPageTemplate(cfg) {
+	return `\
+<script setup lang="ts">
+import { DocsLayout, DocsContent } from "@farming-labs/nuxt-theme";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
+
+const route = useRoute();
+const pathname = computed(() => route.path);
+
+const { data, error } = await useAsyncData(\`docs-\${pathname.value}\`, () =>
+  $fetch("/api/docs", {
+    query: { pathname: pathname.value },
+  })
+);
+
+if (error.value) {
+  throw createError({
+    statusCode: 404,
+    statusMessage: "Page not found",
+  });
+}
+<\/script>
+
+<template>
+  <div v-if="data" class="fd-docs-wrapper">
+    <DocsLayout :tree="data.tree" :config="config">
+      <DocsContent :data="data" :config="config" />
+    </DocsLayout>
+  </div>
+</template>
+`;
+}
+function nuxtConfigTemplate(cfg) {
+	return `\
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import docsConfig from "./docs.config";
+
+export default defineNuxtConfig({
+  compatibilityDate: "2024-11-01",
+
+  css: ["${getThemeCssImport(cfg.theme)}"],
+
+  vite: {
+    optimizeDeps: {
+      include: ["@farming-labs/docs", "@farming-labs/nuxt", "@farming-labs/nuxt-theme", "@farming-labs/theme"],
+    },
+  },
+
+  nitro: {
+    moduleSideEffects: ["@farming-labs/nuxt/server"],
+    serverAssets: [{ baseName: "${cfg.entry}", dir: "${cfg.entry}" }],
+    rollupConfig: { plugins: [docsAgentSkills(docsConfig)] },
+  },
+});
+`;
+}
+/** Add the Agent Skills snapshot plugin to Nitro's server Rollup build. */
+function injectNuxtAgentSkillsPlugin(content) {
+	if (!content) return null;
+	let out = addImportLine(content, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, "import docsConfig from \"./docs.config\";");
+	if (out.includes("docsAgentSkills(docsConfig)")) return out === content ? null : out;
+	const rollupPlugins = out.match(/(rollupConfig\s*:\s*\{[\s\S]*?plugins\s*:\s*\[)([\s\S]*?)(\])/m);
+	if (rollupPlugins) {
+		const current = rollupPlugins[2].trim();
+		const next = `${current}${current && !current.endsWith(",") ? "," : ""}${current ? " " : ""}docsAgentSkills(docsConfig)`;
+		return out.replace(rollupPlugins[0], `${rollupPlugins[1]}${next}${rollupPlugins[3]}`);
+	}
+	const rollupBlock = out.match(/rollupConfig\s*:\s*\{/);
+	if (rollupBlock) return out.replace(rollupBlock[0], `${rollupBlock[0]}\n      plugins: [docsAgentSkills(docsConfig)],`);
+	const nitroBlock = out.match(/nitro\s*:\s*\{/);
+	if (nitroBlock) return out.replace(nitroBlock[0], `${nitroBlock[0]}\n    rollupConfig: { plugins: [docsAgentSkills(docsConfig)] },`);
+	const configMatch = out.match(/defineNuxtConfig\(\s*\{/);
+	if (!configMatch) return null;
+	return out.replace(configMatch[0], "defineNuxtConfig({\n  nitro: { rollupConfig: { plugins: [docsAgentSkills(docsConfig)] } },");
+}
+function nuxtWelcomePageTemplate(cfg) {
+	return `\
+---
+order: 1
+title: Documentation
+description: Welcome to ${cfg.projectName} documentation
+icon: book
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+## Overview
+
+This documentation was generated by \`@farming-labs/docs\`. Edit the markdown files in \`${cfg.entry}/\` to customize.
+
+## Features
+
+- **Markdown Support** — Write docs with standard Markdown
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages (⌘ K)
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function nuxtInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+order: 3
+title: Installation
+description: How to install and set up ${cfg.projectName}
+icon: terminal
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+## Prerequisites
+
+- Node.js 18+
+- A package manager (pnpm, npm, or yarn)
+
+## Install Dependencies
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/nuxt @farming-labs/nuxt-theme @farming-labs/theme
+\`\`\`
+
+## Configuration
+
+Your project includes a \`docs.config.ts\` at the root:
+
+\`\`\`ts title="docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nuxtImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${cfg.entry}/                   # Markdown content
+  page.md
+  installation/page.md
+  quickstart/page.md
+server/
+  api/docs.ts                   # Page data, search, and AI chat API
+  middleware/docs-public.ts     # llms.txt, sitemap, .well-known, .md, and MCP aliases
+pages/
+  ${cfg.entry}/[[...slug]].vue   # Docs catch-all page
+docs.config.ts
+nuxt.config.ts
+\`\`\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function nuxtQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+order: 2
+title: Quickstart
+description: Get up and running in minutes
+icon: rocket
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \`${cfg.entry}/\` with a \`page.md\` file:
+
+\`\`\`bash
+mkdir -p ${cfg.entry}/my-page
+\`\`\`
+
+Then create \`${cfg.entry}/my-page/page.md\`:
+
+\`\`\`md
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown**.
+\`\`\`
+
+Your page is now available at \`/${cfg.entry}/my-page\`.
+
+## Customizing the Theme
+
+Edit \`docs.config.ts\` to change colors and typography:
+
+\`\`\`ts
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\`\`\`
+
+## Deploying
+
+Build your docs for production:
+
+\`\`\`bash
+pnpm build
+\`\`\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function nuxtGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
+	return `\
+@import "${getThemeCssImport(theme)}";
+`;
+}
+function nuxtCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
+	return `@import "${getThemeCssImport(theme)}";`;
+}
+function injectNuxtCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = nuxtCssImportLine(theme, customThemeName, globalCssRelPath);
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && hasBuiltInThemeCssImport(existingContent)) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && existingContent.includes(".css")) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+
+//#endregion
+export { svelteDocsLayoutServerTemplate as $, injectTanstackVitePlugins as A, nuxtGlobalCssTemplate as B, injectDocsAgentSkillsVitePlugin as C, tsconfigTemplate as Ct, injectSvelteCssImport as D, injectRootProviderIntoLayout as E, nextLocaleDocPageTemplate as F, nuxtServerDocsPublicMiddlewareTemplate as G, nuxtQuickstartPageTemplate as H, nextLocalizedPageTemplate as I, quickstartPageTemplate as J, nuxtWelcomePageTemplate as K, nuxtConfigTemplate as L, nextApiReferencePageTemplate as M, nextConfigMergedTemplate as N, injectSvelteDocsPublicHook as O, nextConfigTemplate as P, svelteDocsConfigTemplate as Q, nuxtDocsConfigTemplate as R, injectCssImport as S, tanstackWelcomePageTemplate as St, injectNuxtCssImport as T, nuxtServerApiDocsRouteTemplate as U, nuxtInstallationPageTemplate as V, nuxtServerApiReferenceRouteTemplate as W, svelteApiReferenceRouteTemplate as X, rootLayoutTemplate as Y, svelteDocsApiRouteTemplate as Z, getAstroAdapterPkg as _, tanstackDocsServerTemplate as _t, astroDocsIndexTemplate as a, svelteInstallationPageTemplate as at, injectAstroCssImport as b, tanstackRootRouteTemplate as bt, astroDocsServerTemplate as c, svelteViteConfigTemplate as ct, astroQuickstartPageTemplate as d, tanstackApiReferenceRouteTemplate as dt, svelteDocsLayoutTemplate as et, astroWelcomePageTemplate as f, tanstackDocsCatchAllRouteTemplate as ft, docsLayoutTemplate as g, tanstackDocsPublicRouteTemplate as gt, docsConfigTemplate as h, tanstackDocsIndexRouteTemplate as ht, astroDocsConfigTemplate as i, svelteGlobalCssTemplate as it, installationPageTemplate as j, injectTanstackRootProviderIntoRoute as k, astroGlobalCssTemplate as l, svelteWelcomePageTemplate as lt, customThemeTsTemplate as m, tanstackDocsFunctionsTemplate as mt, astroApiRouteTemplate as n, svelteDocsPublicHookTemplate as nt, astroDocsMiddlewareTemplate as o, svelteQuickstartPageTemplate as ot, customThemeCssTemplate as p, tanstackDocsConfigTemplate as pt, postcssConfigTemplate as q, astroConfigTemplate as r, svelteDocsServerTemplate as rt, astroDocsPageTemplate as s, svelteRootLayoutTemplate as st, astroApiReferenceRouteTemplate as t, svelteDocsPageTemplate as tt, astroInstallationPageTemplate as u, tanstackApiDocsRouteTemplate as ut, globalCssTemplate as v, tanstackInstallationPageTemplate as vt, injectNuxtAgentSkillsPlugin as w, welcomePageTemplate as wt, injectAstroDocsMiddleware as x, tanstackViteConfigTemplate as xt, injectAstroAgentSkillsPlugin as y, tanstackQuickstartPageTemplate as yt, nuxtDocsPageTemplate as z };