@farming-labs/docs 0.0.34 → 0.0.37

package/dist/cli/index.mjs

@@ -0,0 +1,3365 @@
+#!/usr/bin/env node
+import pc from "picocolors";
+import path from "node:path";
+import * as p from "@clack/prompts";
+import fs from "node:fs";
+import { execSync, spawn } from "node:child_process";
+
+//#region src/cli/utils.ts
+function detectFramework(cwd) {
+	const pkgPath = path.join(cwd, "package.json");
+	if (!fs.existsSync(pkgPath)) return null;
+	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	const allDeps = {
+		...pkg.dependencies,
+		...pkg.devDependencies
+	};
+	if (allDeps["next"]) return "nextjs";
+	if (allDeps["@tanstack/react-start"]) return "tanstack-start";
+	if (allDeps["@sveltejs/kit"]) return "sveltekit";
+	if (allDeps["astro"]) return "astro";
+	if (allDeps["nuxt"]) return "nuxt";
+	return null;
+}
+function detectPackageManagerFromLockfile(cwd) {
+	if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+	if (fs.existsSync(path.join(cwd, "bun.lockb")) || fs.existsSync(path.join(cwd, "bun.lock"))) return "bun";
+	if (fs.existsSync(path.join(cwd, "yarn.lock"))) return "yarn";
+	if (fs.existsSync(path.join(cwd, "package-lock.json"))) return "npm";
+	return null;
+}
+function installCommand(pm) {
+	return pm === "yarn" ? "yarn add" : `${pm} add`;
+}
+function devInstallCommand(pm) {
+	if (pm === "yarn") return "yarn add -D";
+	if (pm === "npm") return "npm install -D";
+	return `${pm} add -D`;
+}
+/**
+* Write a file, creating parent directories as needed.
+* Returns true if the file was written, false if it already existed and was skipped.
+*/
+function writeFileSafe(filePath, content, overwrite = false) {
+	if (fs.existsSync(filePath) && !overwrite) return false;
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	fs.writeFileSync(filePath, content, "utf-8");
+	return true;
+}
+/**
+* Check if a file exists.
+*/
+function fileExists(filePath) {
+	return fs.existsSync(filePath);
+}
+/**
+* Read a file, returning null if it does not exist.
+*/
+function readFileSafe(filePath) {
+	if (!fs.existsSync(filePath)) return null;
+	return fs.readFileSync(filePath, "utf-8");
+}
+/** Common locations where global CSS files live in Next.js / SvelteKit projects. */
+const GLOBAL_CSS_CANDIDATES = [
+	"app/globals.css",
+	"app/global.css",
+	"src/app/globals.css",
+	"src/app/global.css",
+	"src/app.css",
+	"src/styles/app.css",
+	"styles/globals.css",
+	"styles/global.css",
+	"src/styles/globals.css",
+	"src/styles/global.css",
+	"assets/css/main.css",
+	"assets/main.css"
+];
+/**
+* Find existing global CSS files in the project.
+* Returns relative paths that exist.
+*/
+function detectGlobalCssFiles(cwd) {
+	return GLOBAL_CSS_CANDIDATES.filter((rel) => fs.existsSync(path.join(cwd, rel)));
+}
+/**
+* Detect whether the Next.js project uses `app` or `src/app` for the App Router.
+* Returns the directory that exists; if both exist, prefers src/app; if neither, returns null.
+*/
+function detectNextAppDir(cwd) {
+	const hasSrcApp = fs.existsSync(path.join(cwd, "src", "app"));
+	const hasApp = fs.existsSync(path.join(cwd, "app"));
+	if (hasSrcApp) return "src/app";
+	if (hasApp) return "app";
+	return null;
+}
+/**
+* Run a shell command synchronously, inheriting stdio.
+*/
+function exec(command, cwd) {
+	execSync(command, {
+		cwd,
+		stdio: "inherit"
+	});
+}
+/**
+* Spawn a process and wait for a specific string in stdout,
+* then resolve with the child process (still running).
+*/
+function spawnAndWaitFor(command, args, cwd, waitFor, timeoutMs = 6e4) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			shell: true
+		});
+		let output = "";
+		const timer = setTimeout(() => {
+			child.kill();
+			reject(/* @__PURE__ */ new Error(`Timed out waiting for "${waitFor}" after ${timeoutMs}ms`));
+		}, timeoutMs);
+		child.stdout?.on("data", (data) => {
+			const text = data.toString();
+			output += text;
+			process.stdout.write(text);
+			if (output.includes(waitFor)) {
+				clearTimeout(timer);
+				resolve(child);
+			}
+		});
+		child.stderr?.on("data", (data) => {
+			process.stderr.write(data.toString());
+		});
+		child.on("error", (err) => {
+			clearTimeout(timer);
+			reject(err);
+		});
+		child.on("close", (code) => {
+			clearTimeout(timer);
+			if (!output.includes(waitFor)) reject(/* @__PURE__ */ new Error(`Process exited with code ${code} before "${waitFor}" appeared`));
+		});
+	});
+}
+
+//#endregion
+//#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",
+		svelteCssTheme: "fumadocs",
+		astroCssTheme: "fumadocs",
+		nuxtCssTheme: "fumadocs"
+	},
+	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",
+		svelteCssTheme: "darksharp",
+		astroCssTheme: "darksharp",
+		nuxtCssTheme: "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",
+		svelteCssTheme: "pixel-border",
+		astroCssTheme: "pixel-border",
+		nuxtCssTheme: "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",
+		svelteCssTheme: "colorful",
+		astroCssTheme: "colorful",
+		nuxtCssTheme: "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",
+		svelteCssTheme: "darkbold",
+		astroCssTheme: "darkbold",
+		nuxtCssTheme: "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",
+		svelteCssTheme: "shiny",
+		astroCssTheme: "shiny",
+		nuxtCssTheme: "shiny"
+	},
+	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",
+		svelteCssTheme: "greentree",
+		astroCssTheme: "greentree",
+		nuxtCssTheme: "greentree"
+	}
+};
+function getThemeInfo(theme) {
+	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
+}
+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 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";
+}
+/** 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 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 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)}  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)}  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)}";
+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 "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";
+`;
+}
+function injectCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = theme === "custom" && customThemeName && globalCssRelPath ? `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";` : `@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";`;
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/theme/") && existingContent.includes("/css")) 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 { createDocsLayout, createDocsMetadata } from "@farming-labs/theme";
+
+export const metadata = createDocsMetadata(docsConfig);
+
+const DocsLayout = createDocsLayout(docsConfig);
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <>
+      <DocsLayout>{children}</DocsLayout>
+    </>
+  );
+}
+`;
+}
+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
+\`\`\`
+
+## 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}",
+  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}",
+  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 docsConfig from "../../docs.config";
+
+export const docsServer = createDocsServer({
+  ...docsConfig,
+  rootDir: process.cwd(),
+});
+`;
+}
+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 { 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 }) => ({
+    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, "")}`;
+	return `\
+import { createFileRoute, notFound } from "@tanstack/react-router";
+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: 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 }) => ({
+    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 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 { docsMdx } from "@farming-labs/tanstack-start/vite";
+
+export default defineConfig({
+  plugins: [tailwindcss(), docsMdx(), ${useAlias ? "tsconfigPaths({ ignoreConfigErrors: true }), " : ""}tanstackStart()],
+});
+`;
+}
+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\";");
+	const additions = [];
+	if (!out.includes("tailwindcss()")) additions.push("tailwindcss()");
+	if (!out.includes("docsMdx()")) additions.push("docsMdx()");
+	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
+\`\`\`
+`;
+	}
+	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)}  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)}  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 config from "${svelteServerConfigImport(cfg.useAlias)}";
+
+// preload for production
+const contentFiles = import.meta.glob("/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx}", {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const { load, GET, POST } = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+});
+`;
+}
+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 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 "@farming-labs/svelte-theme/${theme}/css";
+`;
+}
+function svelteCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
+	return `@import "@farming-labs/svelte-theme/${theme}/css";`;
+}
+function injectSvelteCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = svelteCssImportLine(theme, customThemeName, globalCssRelPath);
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/svelte-theme/") && existingContent.includes("/css")) 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
+\`\`\`
+
+## 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/
+  lib/
+    docs.config.ts             # Docs configuration
+    docs.server.ts             # Server-side docs loader
+  routes/
+    ${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)}  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)}  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 config from "${astroServerConfigImport(cfg.useAlias)}";
+
+const contentFiles = import.meta.glob("/${cfg.entry ?? "docs"}/**/*.{md,mdx}", {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const { load, GET, POST } = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+});
+`;
+}
+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}";
+
+export default defineConfig({
+  output: "server",
+  adapter: ${adapterCall},
+});
+`;
+}
+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 "${`@farming-labs/astro-theme/${getThemeInfo(cfg.theme).astroCssTheme}/css`}";
+
+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 "${`@farming-labs/astro-theme/${getThemeInfo(cfg.theme).astroCssTheme}/css`}";
+
+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 astroGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
+	return `\
+@import "@farming-labs/astro-theme/${theme}/css";
+`;
+}
+function astroCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
+	return `@import "@farming-labs/astro-theme/${theme}/css";`;
+}
+function injectAstroCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = astroCssImportLine(theme, customThemeName, globalCssRelPath);
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/astro-theme/") && existingContent.includes("/css")) 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
+\\\`\\\`\\\`
+
+## 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/
+  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)}  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)}  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 nuxtDocsServerTemplate(cfg) {
+	const contentDirName = cfg.entry ?? "docs";
+	return `\
+import { createDocsServer } from "@farming-labs/nuxt/server";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
+
+const contentFiles = import.meta.glob("/${contentDirName}/**/*.{md,mdx}", {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const docsServer = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+});
+`;
+}
+function nuxtServerApiDocsGetTemplate() {
+	return `\
+import { getRequestURL } from "h3";
+import { docsServer } from "../utils/docs-server";
+
+export default defineEventHandler((event) => {
+  const url = getRequestURL(event);
+  const request = new Request(url.href, {
+    method: event.method,
+    headers: event.headers,
+  });
+  return docsServer.GET({ request });
+});
+`;
+}
+function nuxtServerApiDocsPostTemplate() {
+	return `\
+import { getRequestURL, readRawBody } from "h3";
+import { docsServer } from "../utils/docs-server";
+
+export default defineEventHandler(async (event) => {
+  const url = getRequestURL(event);
+  const body = await readRawBody(event);
+  const request = new Request(url.href, {
+    method: "POST",
+    headers: event.headers,
+    body: body ?? undefined,
+  });
+  return docsServer.POST({ request });
+});
+`;
+}
+function nuxtServerApiDocsLoadTemplate() {
+	return `\
+import { getQuery } from "h3";
+import { docsServer } from "../../utils/docs-server";
+
+export default defineEventHandler(async (event) => {
+  const query = getQuery(event);
+  const pathname = (query.pathname as string) ?? "/docs";
+  return docsServer.load(pathname);
+});
+`;
+}
+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/load", {
+    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 `\
+export default defineNuxtConfig({
+  compatibilityDate: "2024-11-01",
+
+  css: ["@farming-labs/nuxt-theme/${getThemeInfo(cfg.theme).nuxtCssTheme}/css"],
+
+  vite: {
+    optimizeDeps: {
+      include: ["@farming-labs/docs", "@farming-labs/nuxt", "@farming-labs/nuxt-theme"],
+    },
+  },
+
+  nitro: {
+    moduleSideEffects: ["@farming-labs/nuxt/server"],
+  },
+});
+`;
+}
+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
+\`\`\`
+
+## 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/
+  utils/docs-server.ts          # createDocsServer + preloaded content
+  api/docs/
+    load.get.ts                 # Page data API
+    docs.get.ts                 # Search API
+    docs.post.ts                # AI chat API
+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 "@farming-labs/nuxt-theme/${theme}/css";
+`;
+}
+function nuxtCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
+	return `@import "@farming-labs/nuxt-theme/${theme}/css";`;
+}
+function injectNuxtCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = nuxtCssImportLine(theme, customThemeName, globalCssRelPath);
+	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/nuxt-theme/") && existingContent.includes("/css")) 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
+//#region src/cli/init.ts
+const EXAMPLES_REPO = "farming-labs/docs";
+const VALID_TEMPLATES = [
+	"next",
+	"nuxt",
+	"sveltekit",
+	"astro",
+	"tanstack-start"
+];
+const COMMON_LOCALE_OPTIONS = [
+	{
+		value: "en",
+		label: "English",
+		hint: "en"
+	},
+	{
+		value: "fr",
+		label: "French",
+		hint: "fr"
+	},
+	{
+		value: "es",
+		label: "Spanish",
+		hint: "es"
+	},
+	{
+		value: "de",
+		label: "German",
+		hint: "de"
+	},
+	{
+		value: "pt",
+		label: "Portuguese",
+		hint: "pt"
+	},
+	{
+		value: "it",
+		label: "Italian",
+		hint: "it"
+	},
+	{
+		value: "ja",
+		label: "Japanese",
+		hint: "ja"
+	},
+	{
+		value: "ko",
+		label: "Korean",
+		hint: "ko"
+	},
+	{
+		value: "zh",
+		label: "Chinese",
+		hint: "zh"
+	},
+	{
+		value: "ar",
+		label: "Arabic",
+		hint: "ar"
+	},
+	{
+		value: "hi",
+		label: "Hindi",
+		hint: "hi"
+	},
+	{
+		value: "ru",
+		label: "Russian",
+		hint: "ru"
+	}
+];
+function normalizeLocaleCode(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "";
+	const [language, ...rest] = trimmed.split("-");
+	const normalizedLanguage = language.toLowerCase();
+	if (rest.length === 0) return normalizedLanguage;
+	return `${normalizedLanguage}-${rest.join("-").toUpperCase()}`;
+}
+function parseLocaleInput(input) {
+	return Array.from(new Set(input.split(",").map((value) => normalizeLocaleCode(value)).filter(Boolean)));
+}
+function normalizeEntryPath(entry) {
+	return entry.replace(/^\/+|\/+$/g, "");
+}
+function getTanstackDocsRouteDir(entry) {
+	return path.posix.join("src/routes", normalizeEntryPath(entry));
+}
+async function init(options = {}) {
+	const cwd = process.cwd();
+	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs ")));
+	let projectType = "existing";
+	if (!options.template) {
+		const projectTypeAnswer = await p.select({
+			message: "Are you adding docs to an existing project or starting fresh?",
+			options: [{
+				value: "existing",
+				label: "Existing project",
+				hint: "Add docs to the current app in this directory"
+			}, {
+				value: "fresh",
+				label: "Fresh project",
+				hint: "Bootstrap a new app from a template (Next, Nuxt, SvelteKit, Astro, TanStack Start)"
+			}]
+		});
+		if (p.isCancel(projectTypeAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		projectType = projectTypeAnswer;
+	}
+	if (projectType === "fresh" || options.template) {
+		let template;
+		if (options.template) {
+			template = options.template.toLowerCase();
+			if (!VALID_TEMPLATES.includes(template)) {
+				p.log.error(`Invalid ${pc.cyan("--template")}. Use one of: ${VALID_TEMPLATES.map((t) => pc.cyan(t)).join(", ")}`);
+				process.exit(1);
+			}
+		} else {
+			const templateAnswer = await p.select({
+				message: "Which framework would you like to use?",
+				options: [
+					{
+						value: "next",
+						label: "Next.js",
+						hint: "React with App Router"
+					},
+					{
+						value: "nuxt",
+						label: "Nuxt",
+						hint: "Vue 3 with file-based routing"
+					},
+					{
+						value: "sveltekit",
+						label: "SvelteKit",
+						hint: "Svelte with file-based routing"
+					},
+					{
+						value: "astro",
+						label: "Astro",
+						hint: "Content-focused with islands"
+					},
+					{
+						value: "tanstack-start",
+						label: "TanStack Start",
+						hint: "React with TanStack Router and server functions"
+					}
+				]
+			});
+			if (p.isCancel(templateAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			template = templateAnswer;
+		}
+		const defaultProjectName = "my-docs";
+		let projectName = options.name?.trim();
+		if (!projectName) {
+			const nameAnswer = await p.text({
+				message: "Project name? (we'll create this folder and bootstrap the app here)",
+				placeholder: defaultProjectName,
+				defaultValue: defaultProjectName,
+				validate: (value) => {
+					const v = (value ?? "").trim();
+					if (v.includes("/") || v.includes("\\")) return "Project name cannot contain path separators";
+					if (v.includes(" ")) return "Project name cannot contain spaces";
+				}
+			});
+			if (p.isCancel(nameAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			projectName = nameAnswer.trim() || defaultProjectName;
+		}
+		const templateLabel = template === "next" ? "Next.js" : template === "nuxt" ? "Nuxt" : template === "sveltekit" ? "SvelteKit" : template === "astro" ? "Astro" : "TanStack Start";
+		const targetDir = path.join(cwd, projectName);
+		const fs = await import("node:fs");
+		if (fs.existsSync(targetDir)) {
+			p.log.error(`Directory ${pc.cyan(projectName)} already exists. Choose a different ${pc.cyan("--name")} or remove it.`);
+			process.exit(1);
+		}
+		fs.mkdirSync(targetDir, { recursive: true });
+		p.log.step(`Bootstrapping project with ${pc.cyan(`'${projectName}'`)} (${templateLabel})...`);
+		try {
+			exec(`npx degit ${EXAMPLES_REPO}/examples/${template} . --force`, targetDir);
+		} catch (err) {
+			p.log.error("Failed to bootstrap. Check your connection and that the repo exists.");
+			process.exit(1);
+		}
+		const pmAnswer = await p.select({
+			message: "Which package manager do you want to use in this new project?",
+			options: [
+				{
+					value: "pnpm",
+					label: "pnpm",
+					hint: "Fast, disk-efficient (recommended)"
+				},
+				{
+					value: "npm",
+					label: "npm",
+					hint: "Default Node.js package manager"
+				},
+				{
+					value: "yarn",
+					label: "yarn",
+					hint: "Classic yarn (script: yarn dev)"
+				},
+				{
+					value: "bun",
+					label: "bun",
+					hint: "Bun runtime + bun install/dev"
+				}
+			]
+		});
+		if (p.isCancel(pmAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		const pmFresh = pmAnswer;
+		p.log.success(`Bootstrapped ${pc.cyan(`'${projectName}'`)}. Installing dependencies with ${pc.cyan(pmFresh)}...`);
+		const installCmd = pmFresh === "yarn" ? "yarn install" : pmFresh === "npm" ? "npm install" : pmFresh === "bun" ? "bun install" : "pnpm install";
+		try {
+			exec(installCmd, targetDir);
+		} catch {
+			p.log.warn(`${pmFresh} install failed. Run ${pc.cyan(installCmd)} manually inside the project.`);
+		}
+		const devCmd = pmFresh === "yarn" ? "yarn dev" : pmFresh === "npm" ? "npm run dev" : pmFresh === "bun" ? "bun dev" : "pnpm dev";
+		p.outro(pc.green(`Done! Run ${pc.cyan(`cd ${projectName} && ${devCmd}`)} to start the dev server and navigate to the /docs.`));
+		p.outro(pc.green("Happy documenting!"));
+		process.exit(0);
+	}
+	let framework = detectFramework(cwd);
+	if (framework) {
+		const frameworkName = framework === "nextjs" ? "Next.js" : framework === "tanstack-start" ? "TanStack Start" : framework === "sveltekit" ? "SvelteKit" : framework === "astro" ? "Astro" : "Nuxt";
+		p.log.success(`Detected framework: ${pc.cyan(frameworkName)}`);
+	} else {
+		p.log.warn("Could not auto-detect a framework from " + pc.cyan("package.json") + ".");
+		const picked = await p.select({
+			message: "Which framework are you using?",
+			options: [
+				{
+					value: "nextjs",
+					label: "Next.js",
+					hint: "React framework with App Router"
+				},
+				{
+					value: "tanstack-start",
+					label: "TanStack Start",
+					hint: "React with TanStack Router and server functions"
+				},
+				{
+					value: "sveltekit",
+					label: "SvelteKit",
+					hint: "Svelte framework with file-based routing"
+				},
+				{
+					value: "astro",
+					label: "Astro",
+					hint: "Content-focused framework with island architecture"
+				},
+				{
+					value: "nuxt",
+					label: "Nuxt",
+					hint: "Vue 3 framework with file-based routing and Nitro server"
+				}
+			]
+		});
+		if (p.isCancel(picked)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		framework = picked;
+	}
+	let nextAppDir = "app";
+	if (framework === "nextjs") {
+		const detected = detectNextAppDir(cwd);
+		if (detected) {
+			nextAppDir = detected;
+			p.log.info(`Using App Router at ${pc.cyan(nextAppDir)} (detected ${detected === "src/app" ? "src directory" : "root app"})`);
+		} else {
+			const useSrcApp = await p.confirm({
+				message: "Do you use the src directory for the App Router? (e.g. src/app instead of app)",
+				initialValue: false
+			});
+			if (p.isCancel(useSrcApp)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			nextAppDir = useSrcApp ? "src/app" : "app";
+		}
+	}
+	const theme = await p.select({
+		message: "Which theme would you like to use?",
+		options: [
+			{
+				value: "fumadocs",
+				label: "Fumadocs (Default)",
+				hint: "Clean, modern docs theme with sidebar, search, and dark mode"
+			},
+			{
+				value: "darksharp",
+				label: "Darksharp",
+				hint: "All-black, sharp edges, zero-radius look"
+			},
+			{
+				value: "pixel-border",
+				label: "Pixel Border",
+				hint: "Rounded borders, pixel-perfect spacing, refined sidebar"
+			},
+			{
+				value: "colorful",
+				label: "Colorful",
+				hint: "Fumadocs-style neutral theme with description support"
+			},
+			{
+				value: "darkbold",
+				label: "DarkBold",
+				hint: "Pure monochrome, Geist typography, clean minimalism"
+			},
+			{
+				value: "shiny",
+				label: "Shiny",
+				hint: "Glossy, modern look with subtle shimmer effects"
+			},
+			{
+				value: "greentree",
+				label: "GreenTree",
+				hint: "Emerald green accent, Inter font, Mintlify-inspired"
+			},
+			{
+				value: "custom",
+				label: "Create your own theme",
+				hint: "Scaffold a new theme file + CSS in themes/ (name asked next)"
+			}
+		]
+	});
+	if (p.isCancel(theme)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	const defaultThemeName = "my-theme";
+	let customThemeName;
+	if (theme === "custom") {
+		const nameAnswer = await p.text({
+			message: "Theme name? (we'll create themes/<name>.ts and themes/<name>.css)",
+			placeholder: defaultThemeName,
+			defaultValue: defaultThemeName,
+			validate: (value) => {
+				const v = (value ?? "").trim().replace(/\.(ts|css)$/i, "");
+				if (v.includes("/") || v.includes("\\")) return "Theme name cannot contain path separators";
+				if (v.includes(" ")) return "Theme name cannot contain spaces";
+				if (v && !/^[a-z0-9_-]+$/i.test(v)) return "Use only letters, numbers, hyphens, and underscores";
+			}
+		});
+		if (p.isCancel(nameAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		customThemeName = nameAnswer.trim().replace(/\.(ts|css)$/i, "") || defaultThemeName;
+	}
+	const aliasHint = framework === "nextjs" ? `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)` : framework === "tanstack-start" ? `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)` : framework === "sveltekit" ? `Uses ${pc.cyan("$lib/")} prefix (SvelteKit built-in)` : framework === "nuxt" ? `Uses ${pc.cyan("~/")} prefix (Nuxt built-in)` : `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)`;
+	const useAlias = await p.confirm({
+		message: `Use path aliases for imports? ${pc.dim(aliasHint)}`,
+		initialValue: false
+	});
+	if (p.isCancel(useAlias)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	let astroAdapter;
+	if (framework === "astro") {
+		const adapter = await p.select({
+			message: "Where will you deploy?",
+			options: [
+				{
+					value: "vercel",
+					label: "Vercel",
+					hint: "Recommended for most projects"
+				},
+				{
+					value: "netlify",
+					label: "Netlify"
+				},
+				{
+					value: "cloudflare",
+					label: "Cloudflare Pages"
+				},
+				{
+					value: "node",
+					label: "Node.js / Docker",
+					hint: "Self-hosted standalone server"
+				}
+			]
+		});
+		if (p.isCancel(adapter)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		astroAdapter = adapter;
+	}
+	const defaultEntry = "docs";
+	const entry = await p.text({
+		message: "Where should your docs live?",
+		placeholder: defaultEntry,
+		defaultValue: defaultEntry,
+		validate: (value) => {
+			const v = (value ?? "").trim();
+			if (v.startsWith("/")) return "Use a relative path (no leading /)";
+			if (v.includes(" ")) return "Path cannot contain spaces";
+		}
+	});
+	if (p.isCancel(entry)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	const entryPath = entry.trim() || defaultEntry;
+	let docsI18n;
+	if (framework === "tanstack-start") p.log.info("Skipping i18n scaffold for TanStack Start. Configure localized routes manually if needed.");
+	else {
+		const enableI18n = await p.confirm({
+			message: "Do you want to scaffold internationalized docs ?",
+			initialValue: false
+		});
+		if (p.isCancel(enableI18n)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		if (!enableI18n) docsI18n = void 0;
+		else {
+			const selectedLocales = await p.multiselect({
+				message: "Which languages should we scaffold?",
+				options: COMMON_LOCALE_OPTIONS.map((option) => ({
+					value: option.value,
+					label: option.label,
+					hint: option.hint
+				}))
+			});
+			if (p.isCancel(selectedLocales)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			const extraLocalesAnswer = await p.text({
+				message: "Any additional locale codes? (comma-separated, optional)",
+				placeholder: "nl, sv, pt-BR",
+				defaultValue: "",
+				validate: (value) => {
+					return parseLocaleInput(value ?? "").every((locale) => /^[a-z]{2,3}(?:-[A-Z]{2})?$/.test(locale)) ? void 0 : "Use locale codes like en, fr, zh, or pt-BR";
+				}
+			});
+			if (p.isCancel(extraLocalesAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			const locales = Array.from(new Set([...(selectedLocales ?? []).map((locale) => normalizeLocaleCode(locale)), ...parseLocaleInput(extraLocalesAnswer ?? "")])).filter(Boolean);
+			if (locales.length === 0) {
+				p.log.error("Pick at least one locale to scaffold i18n support.");
+				p.outro(pc.red("Init cancelled."));
+				process.exit(1);
+			}
+			const defaultLocaleAnswer = await p.select({
+				message: "Which locale should be the default?",
+				options: locales.map((locale) => ({
+					value: locale,
+					label: locale,
+					hint: locale === "en" ? "Recommended default" : void 0
+				})),
+				initialValue: locales[0]
+			});
+			if (p.isCancel(defaultLocaleAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			docsI18n = {
+				locales,
+				defaultLocale: defaultLocaleAnswer
+			};
+		}
+	}
+	const detectedCssFiles = detectGlobalCssFiles(cwd);
+	let globalCssRelPath;
+	const defaultCssPath = framework === "tanstack-start" ? "src/styles/app.css" : framework === "sveltekit" ? "src/app.css" : framework === "astro" ? "src/styles/global.css" : framework === "nuxt" ? "assets/css/main.css" : framework === "nextjs" ? `${nextAppDir}/globals.css` : "app/globals.css";
+	if (detectedCssFiles.length === 1) {
+		globalCssRelPath = detectedCssFiles[0];
+		p.log.info(`Found global CSS at ${pc.cyan(globalCssRelPath)}`);
+	} else if (detectedCssFiles.length > 1) {
+		const picked = await p.select({
+			message: "Multiple global CSS files found. Which one should we use?",
+			options: detectedCssFiles.map((f) => ({
+				value: f,
+				label: f
+			}))
+		});
+		if (p.isCancel(picked)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		globalCssRelPath = picked;
+	} else {
+		const cssPathAnswer = await p.text({
+			message: "Where is your global CSS file?",
+			placeholder: defaultCssPath,
+			defaultValue: defaultCssPath,
+			validate: (value) => {
+				const v = (value ?? "").trim();
+				if (v && !v.endsWith(".css")) return "Path must end with .css";
+			}
+		});
+		if (p.isCancel(cssPathAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		globalCssRelPath = cssPathAnswer.trim() || defaultCssPath;
+	}
+	const pkgJsonContent = readFileSafe(path.join(cwd, "package.json"));
+	const pkgJson = pkgJsonContent ? JSON.parse(pkgJsonContent) : { name: "my-project" };
+	const projectName = pkgJson.name || "My Project";
+	const cfg = {
+		entry: entryPath,
+		theme,
+		customThemeName,
+		projectName,
+		framework,
+		useAlias,
+		astroAdapter,
+		i18n: docsI18n,
+		...framework === "nextjs" && { nextAppDir }
+	};
+	const s = p.spinner();
+	s.start("Scaffolding docs files");
+	const written = [];
+	const skipped = [];
+	function write(rel, content, overwrite = false) {
+		if (writeFileSafe(path.join(cwd, rel), content, overwrite)) written.push(rel);
+		else skipped.push(rel);
+	}
+	if (framework === "tanstack-start") scaffoldTanstackStart(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else if (framework === "sveltekit") scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else if (framework === "astro") scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else if (framework === "nuxt") scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written);
+	s.stop("Files scaffolded");
+	if (written.length > 0) p.log.success(`Created ${written.length} file${written.length > 1 ? "s" : ""}:\n` + written.map((f) => `  ${pc.green("+")} ${f}`).join("\n"));
+	if (skipped.length > 0) p.log.info(`Skipped ${skipped.length} existing file${skipped.length > 1 ? "s" : ""}:\n` + skipped.map((f) => `  ${pc.dim("-")} ${f}`).join("\n"));
+	let pm = detectPackageManagerFromLockfile(cwd);
+	if (pm) p.log.info(`Detected ${pc.cyan(pm)}`);
+	const pmAnswerExisting = await p.select({
+		...pm ? { initialValue: pm } : {},
+		message: "Which package manager do you want to use in this project?",
+		options: [
+			{
+				value: "pnpm",
+				label: "pnpm",
+				hint: "Fast, disk-efficient (recommended)"
+			},
+			{
+				value: "npm",
+				label: "npm",
+				hint: "Default Node.js package manager"
+			},
+			{
+				value: "yarn",
+				label: "yarn",
+				hint: "Classic yarn (script: yarn dev)"
+			},
+			{
+				value: "bun",
+				label: "bun",
+				hint: "Bun runtime + bun install/dev"
+			}
+		]
+	});
+	if (p.isCancel(pmAnswerExisting)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	pm = pmAnswerExisting;
+	p.log.info(`Using ${pc.cyan(pm)} as package manager`);
+	const s2 = p.spinner();
+	s2.start("Installing dependencies");
+	try {
+		if (framework === "tanstack-start") {
+			exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/theme @farming-labs/tanstack-start`, cwd);
+			const devDeps = ["@tailwindcss/vite", "tailwindcss"];
+			if (useAlias) devDeps.push("vite-tsconfig-paths");
+			const allDeps = {
+				...pkgJson.dependencies,
+				...pkgJson.devDependencies
+			};
+			const missingDevDeps = devDeps.filter((d) => !allDeps[d]);
+			if (missingDevDeps.length > 0) exec(`${devInstallCommand(pm)} ${missingDevDeps.join(" ")}`, cwd);
+		} else if (framework === "sveltekit") exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/svelte @farming-labs/svelte-theme`, cwd);
+		else if (framework === "astro") {
+			const adapterPkg = getAstroAdapterPkg(cfg.astroAdapter ?? "vercel");
+			exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/astro @farming-labs/astro-theme ${adapterPkg}`, cwd);
+		} else if (framework === "nuxt") exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/nuxt @farming-labs/nuxt-theme`, cwd);
+		else {
+			exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/next @farming-labs/theme`, cwd);
+			const devDeps = [
+				"@tailwindcss/postcss",
+				"postcss",
+				"tailwindcss",
+				"@types/mdx",
+				"@types/node"
+			];
+			const allDeps = {
+				...pkgJson.dependencies,
+				...pkgJson.devDependencies
+			};
+			const missingDevDeps = devDeps.filter((d) => !allDeps[d]);
+			if (missingDevDeps.length > 0) exec(`${devInstallCommand(pm)} ${missingDevDeps.join(" ")}`, cwd);
+		}
+	} catch {
+		s2.stop("Failed to install dependencies");
+		p.log.error(`Dependency installation failed. Run the install command manually:
+  ${pc.cyan(`${installCommand(pm)} @farming-labs/docs`)}`);
+		p.outro(pc.yellow("Setup partially complete. Install deps and run dev server manually."));
+		process.exit(1);
+	}
+	s2.stop("Dependencies installed");
+	const startDev = await p.confirm({
+		message: "Start the dev server now?",
+		initialValue: true
+	});
+	if (p.isCancel(startDev) || !startDev) {
+		p.log.info(`You can start the dev server later with:
+  ${pc.cyan(`${pm === "yarn" ? "yarn" : pm + " run"} dev`)}`);
+		p.outro(pc.green("Done! Happy documenting."));
+		process.exit(0);
+	}
+	p.log.step("Starting dev server...");
+	const devCommand = framework === "tanstack-start" ? {
+		cmd: "npx",
+		args: ["vite", "dev"],
+		waitFor: "ready"
+	} : framework === "sveltekit" ? {
+		cmd: "npx",
+		args: ["vite", "dev"],
+		waitFor: "ready"
+	} : framework === "astro" ? {
+		cmd: "npx",
+		args: ["astro", "dev"],
+		waitFor: "ready"
+	} : framework === "nuxt" ? {
+		cmd: "npx",
+		args: ["nuxt", "dev"],
+		waitFor: "Local"
+	} : {
+		cmd: "npx",
+		args: [
+			"next",
+			"dev",
+			"--webpack"
+		],
+		waitFor: "Ready"
+	};
+	const defaultPort = framework === "tanstack-start" ? "5173" : framework === "sveltekit" ? "5173" : framework === "astro" ? "4321" : framework === "nuxt" ? "3000" : "3000";
+	try {
+		const child = await spawnAndWaitFor(devCommand.cmd, devCommand.args, cwd, devCommand.waitFor, 6e4);
+		const url = `http://localhost:${defaultPort}/${entryPath}`;
+		console.log();
+		p.log.success(`Dev server is running! Your docs are live at:\n\n  ${pc.cyan(pc.underline(url))}\n\n  Press ${pc.dim("Ctrl+C")} to stop the server.`);
+		p.outro(pc.green("Happy documenting!"));
+		await new Promise((resolve) => {
+			child.on("close", () => resolve());
+			process.on("SIGINT", () => {
+				child.kill("SIGINT");
+				resolve();
+			});
+			process.on("SIGTERM", () => {
+				child.kill("SIGTERM");
+				resolve();
+			});
+		});
+	} catch (err) {
+		const manualCmd = framework === "tanstack-start" ? "npx vite dev" : framework === "sveltekit" ? "npx vite dev" : framework === "astro" ? "npx astro dev" : framework === "nuxt" ? "npx nuxt dev" : "pnpm dev";
+		p.log.error(`Could not start dev server. Try running manually:
+  ${pc.cyan(manualCmd)}`);
+		p.outro(pc.yellow("Setup complete. Start the server manually."));
+		process.exit(1);
+	}
+}
+function getScaffoldContentRoots(cfg) {
+	return cfg.i18n?.locales?.length ? cfg.i18n.locales.map((locale) => `${cfg.entry}/${locale}`) : [cfg.entry];
+}
+function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	const appDir = cfg.nextAppDir ?? "app";
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
+	write("docs.config.ts", docsConfigTemplate(cfg));
+	const existingNextConfig = readFileSafe(path.join(cwd, "next.config.ts")) ?? readFileSafe(path.join(cwd, "next.config.mjs")) ?? readFileSafe(path.join(cwd, "next.config.js"));
+	if (existingNextConfig) {
+		const configFile = fileExists(path.join(cwd, "next.config.ts")) ? "next.config.ts" : fileExists(path.join(cwd, "next.config.mjs")) ? "next.config.mjs" : "next.config.js";
+		const merged = nextConfigMergedTemplate(existingNextConfig);
+		if (merged !== existingNextConfig) {
+			writeFileSafe(path.join(cwd, configFile), merged, true);
+			written.push(configFile + " (updated)");
+		} else skipped.push(configFile + " (already configured)");
+	} else write("next.config.ts", nextConfigTemplate());
+	const rootLayoutPath = path.join(cwd, `${appDir}/layout.tsx`);
+	const existingRootLayout = readFileSafe(rootLayoutPath);
+	if (!existingRootLayout) write(`${appDir}/layout.tsx`, rootLayoutTemplate(cfg, globalCssRelPath), true);
+	else if (!existingRootLayout.includes("RootProvider")) {
+		const injected = injectRootProviderIntoLayout(existingRootLayout);
+		if (injected) {
+			writeFileSafe(rootLayoutPath, injected, true);
+			written.push(`${appDir}/layout.tsx (injected RootProvider)`);
+		} else skipped.push(`${appDir}/layout.tsx (could not inject RootProvider)`);
+	} else skipped.push(`${appDir}/layout.tsx (already has RootProvider)`);
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	if (existingGlobalCss) {
+		const injected = injectCssImport(existingGlobalCss, cfg.theme, cfg.customThemeName, globalCssRelPath);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, globalCssTemplate(cfg.theme, cfg.customThemeName, globalCssRelPath));
+	write(`${appDir}/${cfg.entry}/layout.tsx`, docsLayoutTemplate(cfg));
+	write("postcss.config.mjs", postcssConfigTemplate());
+	if (!fileExists(path.join(cwd, "tsconfig.json"))) write("tsconfig.json", tsconfigTemplate(cfg.useAlias));
+	if (cfg.i18n?.locales.length) {
+		write(`${appDir}/components/locale-doc-page.tsx`, nextLocaleDocPageTemplate(cfg.i18n.defaultLocale));
+		write(`${appDir}/${cfg.entry}/page.tsx`, nextLocalizedPageTemplate({
+			locales: cfg.i18n.locales,
+			defaultLocale: cfg.i18n.defaultLocale,
+			componentName: "DocsIndexPage",
+			helperImport: "../components/locale-doc-page",
+			pageImports: cfg.i18n.locales.map((locale) => ({
+				locale,
+				importPath: `./${locale}/page.mdx`
+			}))
+		}));
+		write(`${appDir}/${cfg.entry}/installation/page.tsx`, nextLocalizedPageTemplate({
+			locales: cfg.i18n.locales,
+			defaultLocale: cfg.i18n.defaultLocale,
+			componentName: "InstallationPage",
+			helperImport: "../../components/locale-doc-page",
+			pageImports: cfg.i18n.locales.map((locale) => ({
+				locale,
+				importPath: `../${locale}/installation/page.mdx`
+			}))
+		}));
+		write(`${appDir}/${cfg.entry}/quickstart/page.tsx`, nextLocalizedPageTemplate({
+			locales: cfg.i18n.locales,
+			defaultLocale: cfg.i18n.defaultLocale,
+			componentName: "QuickstartPage",
+			helperImport: "../../components/locale-doc-page",
+			pageImports: cfg.i18n.locales.map((locale) => ({
+				locale,
+				importPath: `../${locale}/quickstart/page.mdx`
+			}))
+		}));
+		for (const locale of cfg.i18n.locales) {
+			const base = `${appDir}/${cfg.entry}/${locale}`;
+			write(`${base}/page.mdx`, welcomePageTemplate(cfg));
+			write(`${base}/installation/page.mdx`, installationPageTemplate(cfg));
+			write(`${base}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
+		}
+		return;
+	}
+	write(`${appDir}/${cfg.entry}/page.mdx`, welcomePageTemplate(cfg));
+	write(`${appDir}/${cfg.entry}/installation/page.mdx`, installationPageTemplate(cfg));
+	write(`${appDir}/${cfg.entry}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
+}
+function scaffoldTanstackStart(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
+	write("docs.config.ts", tanstackDocsConfigTemplate(cfg));
+	write("src/lib/docs.server.ts", tanstackDocsServerTemplate());
+	write("src/lib/docs.functions.ts", tanstackDocsFunctionsTemplate());
+	const routeDir = getTanstackDocsRouteDir(cfg.entry);
+	const docsIndexRoute = `${routeDir}/index.tsx`;
+	const docsCatchAllRoute = `${routeDir}/$.tsx`;
+	const apiRoute = "src/routes/api/docs.ts";
+	write(docsIndexRoute, tanstackDocsIndexRouteTemplate({
+		entry: cfg.entry,
+		filePath: docsIndexRoute,
+		useAlias: cfg.useAlias,
+		projectName: cfg.projectName
+	}));
+	write(docsCatchAllRoute, tanstackDocsCatchAllRouteTemplate({
+		entry: cfg.entry,
+		filePath: docsCatchAllRoute,
+		useAlias: cfg.useAlias,
+		projectName: cfg.projectName
+	}));
+	write(apiRoute, tanstackApiDocsRouteTemplate(cfg.useAlias, apiRoute));
+	const rootRoutePath = path.join(cwd, "src/routes/__root.tsx");
+	const existingRootRoute = readFileSafe(rootRoutePath);
+	if (!existingRootRoute) write("src/routes/__root.tsx", tanstackRootRouteTemplate(globalCssRelPath), true);
+	else if (!existingRootRoute.includes("RootProvider")) {
+		const injected = injectTanstackRootProviderIntoRoute(existingRootRoute);
+		if (injected) {
+			writeFileSafe(rootRoutePath, injected, true);
+			written.push("src/routes/__root.tsx (injected RootProvider)");
+		} else skipped.push("src/routes/__root.tsx (could not inject RootProvider)");
+	} else skipped.push("src/routes/__root.tsx (already has RootProvider)");
+	const viteConfigRel = fileExists(path.join(cwd, "vite.config.ts")) ? "vite.config.ts" : fileExists(path.join(cwd, "vite.config.mts")) ? "vite.config.mts" : fileExists(path.join(cwd, "vite.config.js")) ? "vite.config.js" : "vite.config.ts";
+	const viteConfigPath = path.join(cwd, viteConfigRel);
+	const existingViteConfig = readFileSafe(viteConfigPath);
+	if (!existingViteConfig) write(viteConfigRel, tanstackViteConfigTemplate(cfg.useAlias), true);
+	else {
+		const injected = injectTanstackVitePlugins(existingViteConfig, cfg.useAlias);
+		if (injected) {
+			writeFileSafe(viteConfigPath, injected, true);
+			written.push(`${viteConfigRel} (updated)`);
+		} else skipped.push(`${viteConfigRel} (already configured)`);
+	}
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	if (existingGlobalCss) {
+		const injected = injectCssImport(existingGlobalCss, cfg.theme, cfg.customThemeName, globalCssRelPath);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, globalCssTemplate(cfg.theme, cfg.customThemeName, globalCssRelPath));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.mdx`, tanstackWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.mdx`, tanstackInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.mdx`, tanstackQuickstartPageTemplate(cfg));
+	}
+}
+function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
+	write("src/lib/docs.config.ts", svelteDocsConfigTemplate(cfg));
+	write("src/lib/docs.server.ts", svelteDocsServerTemplate(cfg));
+	write(`src/routes/${cfg.entry}/+layout.svelte`, svelteDocsLayoutTemplate(cfg));
+	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate(cfg));
+	write(`src/routes/${cfg.entry}/[...slug]/+page.svelte`, svelteDocsPageTemplate(cfg));
+	if (cfg.i18n?.locales.length) write(`src/routes/${cfg.entry}/+page.svelte`, svelteDocsPageTemplate(cfg));
+	if (!readFileSafe(path.join(cwd, "src/routes/+layout.svelte"))) write("src/routes/+layout.svelte", svelteRootLayoutTemplate(globalCssRelPath));
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	const cssTheme = {
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
+		"pixel-border": "pixel-border",
+		colorful: "colorful",
+		darkbold: "darkbold",
+		shiny: "shiny",
+		greentree: "greentree",
+		default: "fumadocs"
+	}[cfg.theme] || "fumadocs";
+	if (existingGlobalCss) {
+		const injected = cfg.theme === "custom" && cfg.customThemeName ? injectSvelteCssImport(existingGlobalCss, "custom", cfg.customThemeName, globalCssRelPath) : injectSvelteCssImport(existingGlobalCss, cssTheme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? svelteGlobalCssTemplate("custom", cfg.customThemeName, globalCssRelPath) : svelteGlobalCssTemplate(cssTheme));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.md`, svelteWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.md`, svelteInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.md`, svelteQuickstartPageTemplate(cfg));
+	}
+}
+function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
+	write("src/lib/docs.config.ts", astroDocsConfigTemplate(cfg));
+	write("src/lib/docs.server.ts", astroDocsServerTemplate(cfg));
+	if (!fileExists(path.join(cwd, "astro.config.mjs")) && !fileExists(path.join(cwd, "astro.config.ts"))) write("astro.config.mjs", astroConfigTemplate(cfg.astroAdapter ?? "vercel"));
+	write(`src/pages/${cfg.entry}/index.astro`, astroDocsIndexTemplate(cfg));
+	write(`src/pages/${cfg.entry}/[...slug].astro`, astroDocsPageTemplate(cfg));
+	write(`src/pages/api/${cfg.entry}.ts`, astroApiRouteTemplate(cfg));
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	const cssTheme = {
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
+		"pixel-border": "pixel-border",
+		colorful: "colorful",
+		darkbold: "darkbold",
+		shiny: "shiny",
+		greentree: "greentree",
+		default: "fumadocs"
+	}[cfg.theme] || "fumadocs";
+	if (existingGlobalCss) {
+		const injected = cfg.theme === "custom" && cfg.customThemeName ? injectAstroCssImport(existingGlobalCss, "custom", cfg.customThemeName, globalCssRelPath) : injectAstroCssImport(existingGlobalCss, cssTheme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? astroGlobalCssTemplate("custom", cfg.customThemeName, globalCssRelPath) : astroGlobalCssTemplate(cssTheme));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.md`, astroWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.md`, astroInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.md`, astroQuickstartPageTemplate(cfg));
+	}
+}
+function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
+	write("docs.config.ts", nuxtDocsConfigTemplate(cfg));
+	write("server/utils/docs-server.ts", nuxtDocsServerTemplate(cfg));
+	write("server/api/docs.get.ts", nuxtServerApiDocsGetTemplate());
+	write("server/api/docs.post.ts", nuxtServerApiDocsPostTemplate());
+	write("server/api/docs/load.get.ts", nuxtServerApiDocsLoadTemplate());
+	write(`pages/${cfg.entry}/[[...slug]].vue`, nuxtDocsPageTemplate(cfg));
+	path.join(cwd, "nuxt.config.ts");
+	if (!fileExists(path.join(cwd, "nuxt.config.ts")) && !fileExists(path.join(cwd, "nuxt.config.js"))) write("nuxt.config.ts", nuxtConfigTemplate(cfg));
+	const cssTheme = {
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
+		"pixel-border": "pixel-border",
+		colorful: "colorful",
+		darkbold: "darkbold",
+		shiny: "shiny",
+		greentree: "greentree",
+		default: "fumadocs"
+	}[cfg.theme] || "fumadocs";
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	if (existingGlobalCss) {
+		const injected = cfg.theme === "custom" && cfg.customThemeName ? injectNuxtCssImport(existingGlobalCss, "custom", cfg.customThemeName, globalCssRelPath) : injectNuxtCssImport(existingGlobalCss, cssTheme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? nuxtGlobalCssTemplate("custom", cfg.customThemeName, globalCssRelPath) : nuxtGlobalCssTemplate(cssTheme));
+	for (const base of getScaffoldContentRoots(cfg)) {
+		write(`${base}/page.md`, nuxtWelcomePageTemplate(cfg));
+		write(`${base}/installation/page.md`, nuxtInstallationPageTemplate(cfg));
+		write(`${base}/quickstart/page.md`, nuxtQuickstartPageTemplate(cfg));
+	}
+}
+
+//#endregion
+//#region src/cli/upgrade.ts
+/**
+* Upgrade @farming-labs/* packages to latest.
+* Detects framework from package.json by default, or use --framework (next, nuxt, sveltekit, astro).
+*/
+const PRESETS = [
+	"next",
+	"nuxt",
+	"sveltekit",
+	"astro"
+];
+const PACKAGES_BY_FRAMEWORK = {
+	nextjs: [
+		"@farming-labs/docs",
+		"@farming-labs/theme",
+		"@farming-labs/next"
+	],
+	nuxt: [
+		"@farming-labs/docs",
+		"@farming-labs/nuxt",
+		"@farming-labs/nuxt-theme"
+	],
+	sveltekit: [
+		"@farming-labs/docs",
+		"@farming-labs/svelte",
+		"@farming-labs/svelte-theme"
+	],
+	astro: [
+		"@farming-labs/docs",
+		"@farming-labs/astro",
+		"@farming-labs/astro-theme"
+	]
+};
+function presetFromFramework(fw) {
+	return fw === "nextjs" ? "next" : fw;
+}
+function frameworkFromPreset(preset) {
+	return preset === "next" ? "nextjs" : preset;
+}
+/** Return package list for a framework (for testing and CLI). */
+function getPackagesForFramework(framework) {
+	return PACKAGES_BY_FRAMEWORK[framework];
+}
+/** Build the install command for upgrade (for testing). */
+function buildUpgradeCommand(framework, tag, pm) {
+	const packagesWithTag = PACKAGES_BY_FRAMEWORK[framework].map((name) => `${name}@${tag}`);
+	return `${installCommand(pm)} ${packagesWithTag.join(" ")}`;
+}
+async function upgrade(options = {}) {
+	const cwd = process.cwd();
+	const tag = options.tag ?? "latest";
+	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs upgrade ")));
+	if (!fileExists(path.join(cwd, "package.json"))) {
+		p.log.error("No package.json found in the current directory. Run this from your project root.");
+		process.exit(1);
+	}
+	let framework = null;
+	let preset;
+	if (options.framework) {
+		const raw = options.framework.toLowerCase().trim();
+		const normalized = raw === "nextjs" ? "next" : raw;
+		if (!PRESETS.includes(normalized)) {
+			p.log.error(`Invalid framework ${pc.cyan(options.framework)}. Use one of: ${PRESETS.map((t) => pc.cyan(t)).join(", ")}`);
+			process.exit(1);
+		}
+		preset = normalized;
+		framework = frameworkFromPreset(preset);
+	} else {
+		const detected = detectFramework(cwd);
+		if (!detected) {
+			p.log.error("Could not detect a supported framework (Next.js, Nuxt, SvelteKit, Astro). Use " + pc.cyan("--framework <next|nuxt|sveltekit|astro>") + " to specify.");
+			process.exit(1);
+		}
+		if (detected === "tanstack-start") {
+			p.log.error("TanStack Start is supported by " + pc.cyan("init") + " but not by " + pc.cyan("upgrade") + " yet. Upgrade the docs packages manually for now.");
+			process.exit(1);
+		}
+		framework = detected;
+		preset = presetFromFramework(framework);
+	}
+	let pm = detectPackageManagerFromLockfile(cwd);
+	if (pm) p.log.info(`Detected ${pc.cyan(pm)} from lockfile`);
+	else {
+		const pmAnswer = await p.select({
+			message: "Which package manager do you want to use for this upgrade?",
+			options: [
+				{
+					value: "pnpm",
+					label: "pnpm",
+					hint: "Use pnpm add"
+				},
+				{
+					value: "npm",
+					label: "npm",
+					hint: "Use npm add"
+				},
+				{
+					value: "yarn",
+					label: "yarn",
+					hint: "Use yarn add"
+				},
+				{
+					value: "bun",
+					label: "bun",
+					hint: "Use bun add"
+				}
+			]
+		});
+		if (p.isCancel(pmAnswer)) {
+			p.outro(pc.red("Upgrade cancelled."));
+			process.exit(0);
+		}
+		pm = pmAnswer;
+		p.log.info(`Using ${pc.cyan(pm)} as package manager`);
+	}
+	const cmd = buildUpgradeCommand(framework, tag, pm);
+	const packages = getPackagesForFramework(framework);
+	p.log.step(`Upgrading ${preset} docs packages to ${tag}...`);
+	p.log.message(pc.dim(packages.join(", ")));
+	try {
+		exec(cmd, cwd);
+		p.log.success(`Packages upgraded to ${tag}.`);
+		p.outro(pc.green("Done. Run your dev server to confirm everything works."));
+	} catch {
+		p.log.error("Upgrade failed. Try running manually:\n  " + pc.cyan(cmd));
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region src/cli/index.ts
+const args = process.argv.slice(2);
+const command = args[0];
+/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs, --framework astro (exported for tests). */
+function parseFlags(argv) {
+	const flags = {};
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg.startsWith("--") && arg.includes("=")) {
+			const [key, value] = arg.slice(2).split("=");
+			flags[key] = value;
+		} else if (arg.startsWith("--") && argv[i + 1] && !argv[i + 1].startsWith("--")) {
+			flags[arg.slice(2)] = argv[i + 1];
+			i++;
+		}
+	}
+	return flags;
+}
+async function main() {
+	const flags = parseFlags(args);
+	const initOptions = {
+		template: flags.template,
+		name: flags.name,
+		theme: flags.theme,
+		entry: flags.entry
+	};
+	if (!command || command === "init") await init(initOptions);
+	else if (command === "upgrade") await upgrade({
+		framework: flags.framework ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0),
+		tag: args.includes("--beta") ? "beta" : "latest"
+	});
+	else if (command === "--help" || command === "-h") printHelp();
+	else if (command === "--version" || command === "-v") printVersion();
+	else {
+		console.error(pc.red(`Unknown command: ${command}`));
+		console.error();
+		printHelp();
+		process.exit(1);
+	}
+}
+function printHelp() {
+	console.log(`
+${pc.bold("@farming-labs/docs")} — Documentation framework CLI
+
+${pc.dim("Usage:")}
+  npx @farming-labs/docs@latest ${pc.cyan("<command>")}
+
+${pc.dim("Commands:")}
+  ${pc.cyan("init")}     Scaffold docs in your project (default)
+  ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages to latest (auto-detect or use --framework)
+
+${pc.dim("Supported frameworks:")}
+  Next.js, SvelteKit, Astro, Nuxt
+
+${pc.dim("Options for init:")}
+  ${pc.cyan("--template <name>")}  Bootstrap a project (${pc.dim("next")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}, ${pc.dim("tanstack-start")}); use with ${pc.cyan("--name")}
+  ${pc.cyan("--name <project>")}  Project folder name when using ${pc.cyan("--template")}; prompt if omitted (e.g. ${pc.dim("my-docs")})
+  ${pc.cyan("--theme <name>")}     Skip theme prompt (e.g. ${pc.dim("darksharp")}, ${pc.dim("greentree")})
+  ${pc.cyan("--entry <path>")}     Skip entry path prompt (e.g. ${pc.dim("docs")})
+
+${pc.dim("Options for upgrade:")}
+  ${pc.cyan("--framework <name>")}  Explicit framework (${pc.dim("next")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}); omit to auto-detect
+  ${pc.cyan("--latest")}            Install latest stable (default)
+  ${pc.cyan("--beta")}             Install beta versions
+
+  ${pc.cyan("-h, --help")}         Show this help message
+  ${pc.cyan("-v, --version")}     Show version
+`);
+}
+function printVersion() {
+	console.log("0.1.0");
+}
+main().catch((err) => {
+	console.error(pc.red("An unexpected error occurred:"));
+	console.error(err);
+	process.exit(1);
+});
+
+//#endregion
+export { parseFlags };