@farming-labs/docs 0.1.1-beta.1 → 0.1.1-beta.4

package/dist/cli/index.mjs

@@ -1,3639 +0,0 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-import pc from "picocolors";
-import * as p from "@clack/prompts";
-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"
-	},
-	concrete: {
-		factory: "concrete",
-		nextImport: "@farming-labs/theme/concrete",
-		svelteImport: "@farming-labs/svelte-theme/concrete",
-		astroImport: "@farming-labs/astro-theme/concrete",
-		nuxtImport: "@farming-labs/nuxt-theme/concrete",
-		nextCssImport: "concrete",
-		svelteCssTheme: "concrete",
-		astroCssTheme: "concrete",
-		nuxtCssTheme: "concrete"
-	},
-	hardline: {
-		factory: "hardline",
-		nextImport: "@farming-labs/theme/hardline",
-		svelteImport: "@farming-labs/svelte-theme/hardline",
-		astroImport: "@farming-labs/astro-theme/hardline",
-		nuxtImport: "@farming-labs/nuxt-theme/hardline",
-		nextCssImport: "hardline",
-		svelteCssTheme: "hardline",
-		astroCssTheme: "hardline",
-		nuxtCssTheme: "hardline"
-	}
-};
-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 renderApiReferenceConfig(cfg, indent = "  ") {
-	const apiReference = cfg.apiReference;
-	if (!apiReference) return "";
-	return `${indent}apiReference: {\n${indent}  enabled: true,\n${indent}  path: "${apiReference.path}",\n${indent}  routeRoot: "${apiReference.routeRoot}",\n${indent}},\n`;
-}
-function toLocaleImportName(locale) {
-	return `LocalePage_${locale.replace(/[^a-zA-Z0-9_$]/g, "_")}`;
-}
-function getThemeExportName(themeName) {
-	const base = themeName.replace(/\.ts$/i, "").trim();
-	if (!base) return "customTheme";
-	return base.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).replace(/^./, (c) => c.toLowerCase());
-}
-function getCustomThemeCssImportPath(globalCssRelPath, themeName) {
-	if (globalCssRelPath.startsWith("app/")) return `../themes/${themeName}.css`;
-	if (globalCssRelPath.startsWith("src/")) return `../../themes/${themeName}.css`;
-	return `../themes/${themeName}.css`;
-}
-/** Content for themes/{name}.ts - createTheme with the given name */
-function customThemeTsTemplate(themeName) {
-	return `\
-import { createTheme } from "@farming-labs/docs";
-
-export const ${getThemeExportName(themeName)} = createTheme({
-  name: "${themeName.replace(/\.ts$/i, "")}",
-  ui: {
-    colors: {
-      primary: "#e11d48",
-      background: "#09090b",
-      foreground: "#fafafa",
-      muted: "#71717a",
-      border: "#27272a",
-    },
-    radius: "0.5rem",
-  },
-});
-`;
-}
-function customThemeCssTemplate(themeName) {
-	return `\
-/* Custom theme: ${themeName} - edit variables and selectors as needed */
-@import "@farming-labs/theme/presets/black";
-
-.dark {
-  --color-fd-primary: #e11d48;
-  --color-fd-background: #09090b;
-  --color-fd-border: #27272a;
-  --radius: 0.5rem;
-}
-`;
-}
-/** Config import for Next.js root layout → root docs.config */
-function nextRootLayoutConfigImport(useAlias, nextAppDir = "app") {
-	if (useAlias) return "@/docs.config";
-	return nextAppDir === "src/app" ? "../../docs.config" : "../docs.config";
-}
-/** Config import for Next.js app/{entry}/layout.tsx → root docs.config */
-function nextDocsLayoutConfigImport(useAlias, nextAppDir = "app") {
-	if (useAlias) return "@/docs.config";
-	return nextAppDir === "src/app" ? "../../../docs.config" : "../../docs.config";
-}
-function nextApiReferenceConfigImport(useAlias, nextAppDir = "app", filePath) {
-	if (useAlias) return "@/docs.config";
-	return relativeImport(filePath, "docs.config.ts");
-}
-/** Config import for SvelteKit src/lib/docs.server.ts → src/lib/docs.config */
-function svelteServerConfigImport(useAlias) {
-	return useAlias ? "$lib/docs.config" : "./docs.config";
-}
-/** Config import for SvelteKit src/routes/{entry}/+layout.svelte → src/lib/docs.config */
-function svelteLayoutConfigImport(useAlias) {
-	return useAlias ? "$lib/docs.config" : "../../lib/docs.config";
-}
-/** Config import for SvelteKit src/routes/{entry}/[...slug]/+page.svelte → src/lib/docs.config */
-function sveltePageConfigImport(useAlias) {
-	return useAlias ? "$lib/docs.config" : "../../../lib/docs.config";
-}
-/** Server import for SvelteKit +layout.server.js → src/lib/docs.server */
-function svelteLayoutServerImport(useAlias) {
-	return useAlias ? "$lib/docs.server" : "../../lib/docs.server";
-}
-function 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)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-	}
-	const t = getThemeInfo(cfg.theme);
-	return `\
-import { defineDocs } from "@farming-labs/docs";
-import { ${t.factory} } from "${t.nextImport}";
-
-export default defineDocs({
-  entry: "${cfg.entry}",
-  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-}
-function nextConfigTemplate() {
-	return `\
-import { withDocs } from "@farming-labs/next/config";
-
-export default withDocs();
-`;
-}
-function nextConfigMergedTemplate(existingContent) {
-	if (existingContent.includes("withDocs")) return existingContent;
-	const lines = existingContent.split("\n");
-	const importLine = "import { withDocs } from \"@farming-labs/next/config\";";
-	const exportIdx = lines.findIndex((l) => l.match(/export\s+default/));
-	if (exportIdx === -1) return `${importLine}\n\n${existingContent}\n\nexport default withDocs();\n`;
-	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("import ") ? i : acc, -1);
-	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
-	else lines.unshift(importLine, "");
-	const adjustedExportIdx = exportIdx + (lastImportIdx >= 0 ? exportIdx > lastImportIdx ? 1 : 0 : 2);
-	const simpleMatch = lines[adjustedExportIdx].match(/^(\s*export\s+default\s+)(.*?)(;?\s*)$/);
-	if (simpleMatch) {
-		const [, prefix, value, suffix] = simpleMatch;
-		lines[adjustedExportIdx] = `${prefix}withDocs(${value})${suffix}`;
-	}
-	return lines.join("\n");
-}
-function rootLayoutTemplate(cfg, globalCssRelPath = "app/globals.css") {
-	let cssImport;
-	if (globalCssRelPath.startsWith("app/")) cssImport = "./" + globalCssRelPath.slice(4);
-	else if (globalCssRelPath.startsWith("src/app/")) cssImport = "./" + globalCssRelPath.slice(8);
-	else cssImport = "../" + globalCssRelPath;
-	const appDir = cfg.nextAppDir ?? "app";
-	return `\
-import type { Metadata } from "next";
-import { RootProvider } from "@farming-labs/theme";
-import docsConfig from "${nextRootLayoutConfigImport(cfg.useAlias, appDir)}";
-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 nextApiReferenceRouteTemplate(cfg, filePath) {
-	const appDir = cfg.nextAppDir ?? "app";
-	return `
-import docsConfig from "${nextApiReferenceConfigImport(cfg.useAlias, appDir, filePath)}";
-import { createNextApiReference } from "@farming-labs/next/api-reference";
-
-export const GET = createNextApiReference(docsConfig);
-
-export const revalidate = false;
-`;
-}
-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}",
-  ${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-  nav: {
-    title: "${cfg.projectName} Docs",
-    url: "/${cfg.entry}",
-  },
-  themeToggle: {
-    enabled: true,
-    default: "dark",
-  },
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-	}
-	const t = getThemeInfo(cfg.theme);
-	return `\
-import { defineDocs } from "@farming-labs/docs";
-import { ${t.factory} } from "${t.nextImport}";
-
-export default defineDocs({
-  entry: "${cfg.entry}",
-  contentDir: "${cfg.entry}",
-  ${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-  nav: {
-    title: "${cfg.projectName} Docs",
-    url: "/${cfg.entry}",
-  },
-  themeToggle: {
-    enabled: true,
-    default: "dark",
-  },
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-}
-function tanstackDocsServerTemplate() {
-	return `\
-import { createDocsServer } from "@farming-labs/tanstack-start/server";
-import 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 tanstackApiReferenceRouteTemplate(opts) {
-	const routePath = `/${opts.apiReferencePath}${opts.catchAll ? "/$" : "/"}`;
-	return `\
-import { createFileRoute } from "@tanstack/react-router";
-import { createTanstackApiReference } from "@farming-labs/tanstack-start/api-reference";
-import docsConfig from "${tanstackDocsConfigImport(opts.filePath)}";
-
-const handler = createTanstackApiReference(docsConfig);
-
-export const Route = createFileRoute("${routePath}")({
-  server: {
-    handlers: {
-      GET: handler,
-    },
-  },
-});
-`;
-}
-function tanstackRootRouteTemplate(globalCssRelPath) {
-	return `\
-import appCss from "${relativeAssetPath("src/routes/__root.tsx", globalCssRelPath)}?url";
-import { createRootRoute, HeadContent, Outlet, Scripts } from "@tanstack/react-router";
-import { RootProvider } from "@farming-labs/theme/tanstack";
-
-export const Route = createRootRoute({
-  head: () => ({
-    links: [{ rel: "stylesheet", href: appCss }],
-    meta: [
-      { charSet: "utf-8" },
-      { name: "viewport", content: "width=device-width, initial-scale=1" },
-      { title: "Docs" },
-    ],
-  }),
-  component: RootComponent,
-});
-
-function RootComponent() {
-  return (
-    <html lang="en" suppressHydrationWarning>
-      <head>
-        <HeadContent />
-      </head>
-      <body>
-        <RootProvider>
-          <Outlet />
-        </RootProvider>
-        <Scripts />
-      </body>
-    </html>
-  );
-}
-`;
-}
-function injectTanstackRootProviderIntoRoute(content) {
-	if (!content || content.includes("RootProvider")) return null;
-	let out = addImportLine(content, "import { RootProvider } from \"@farming-labs/theme/tanstack\";");
-	if (out.includes("<Outlet />")) out = out.replace("<Outlet />", "<RootProvider><Outlet /></RootProvider>");
-	else if (out.includes("<Outlet></Outlet>")) out = out.replace("<Outlet></Outlet>", "<RootProvider><Outlet /></RootProvider>");
-	else return null;
-	return out === content ? null : out;
-}
-function tanstackViteConfigTemplate(useAlias) {
-	return `\
-import { defineConfig } from "vite";
-import tailwindcss from "@tailwindcss/vite";
-${useAlias ? "import tsconfigPaths from \"vite-tsconfig-paths\";\n" : ""}import { tanstackStart } from "@tanstack/react-start/plugin/vite";
-import { 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)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  nav: {
-    title: "${cfg.projectName}",
-    url: "/${cfg.entry}",
-  },
-
-  breadcrumb: { enabled: true },
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-	}
-	const t = getThemeInfo(cfg.theme);
-	return `\
-import { defineDocs } from "@farming-labs/docs";
-import { ${t.factory} } from "${t.svelteImport}";
-
-export default defineDocs({
-  entry: "${cfg.entry}",
-  contentDir: "${cfg.entry}",
-  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  nav: {
-    title: "${cfg.projectName}",
-    url: "/${cfg.entry}",
-  },
-
-  breadcrumb: { enabled: true },
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-}
-function svelteDocsServerTemplate(cfg) {
-	return `\
-import { createDocsServer } from "@farming-labs/svelte/server";
-import 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 svelteApiReferenceRouteTemplate(filePath, useAlias) {
-	return `\
-import { createSvelteApiReference } from "@farming-labs/svelte/api-reference";
-import config from "${useAlias ? "$lib/docs.config" : relativeImport(filePath, "src/lib/docs.config.ts")}";
-
-export const GET = createSvelteApiReference(config);
-`;
-}
-function 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)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  nav: {
-    title: "${cfg.projectName}",
-    url: "/${cfg.entry}",
-  },
-
-  breadcrumb: { enabled: true },
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-	}
-	const t = getThemeInfo(cfg.theme);
-	return `\
-import { defineDocs } from "@farming-labs/docs";
-import { ${t.factory} } from "${t.astroImport}";
-
-export default defineDocs({
-  entry: "${cfg.entry}",
-  contentDir: "${cfg.entry}",
-  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  nav: {
-    title: "${cfg.projectName}",
-    url: "/${cfg.entry}",
-  },
-
-  breadcrumb: { enabled: true },
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-}
-function astroDocsServerTemplate(cfg) {
-	return `\
-import { createDocsServer } from "@farming-labs/astro/server";
-import 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 astroApiReferenceRouteTemplate(filePath) {
-	return `\
-import { createAstroApiReference } from "@farming-labs/astro/api-reference";
-import config from "${relativeImport(filePath, "src/lib/docs.config.ts")}";
-
-export const GET = createAstroApiReference(config);
-`;
-}
-function astroGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
-	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
-@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
-`;
-	return `\
-@import "@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)}${renderApiReferenceConfig(cfg)}  theme: ${exportName}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  nav: {
-    title: "${cfg.projectName}",
-    url: "/${cfg.entry}",
-  },
-
-  breadcrumb: { enabled: true },
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-	}
-	const t = getThemeInfo(cfg.theme);
-	return `\
-import { defineDocs } from "@farming-labs/docs";
-import { ${t.factory} } from "${t.nuxtImport}";
-
-export default defineDocs({
-  entry: "${cfg.entry}",
-  contentDir: "${cfg.entry}",
-  ${renderI18nConfig(cfg)}${renderApiReferenceConfig(cfg)}  theme: ${t.factory}({
-    ui: {
-      colors: { primary: "#6366f1" },
-    },
-  }),
-
-  nav: {
-    title: "${cfg.projectName}",
-    url: "/${cfg.entry}",
-  },
-
-  breadcrumb: { enabled: true },
-
-  metadata: {
-    titleTemplate: "%s – ${cfg.projectName}",
-    description: "Documentation for ${cfg.projectName}",
-  },
-});
-`;
-}
-function 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 nuxtServerApiReferenceRouteTemplate(filePath, useAlias) {
-	return `\
-import { defineApiReferenceHandler } from "@farming-labs/nuxt/api-reference";
-import config from "${useAlias ? "~/docs.config" : relativeImport(filePath, "docs.config.ts")}";
-
-export default defineApiReferenceHandler(config);
-`;
-}
-function nuxtDocsPageTemplate(cfg) {
-	return `\
-<script setup lang="ts">
-import { DocsLayout, DocsContent } from "@farming-labs/nuxt-theme";
-import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
-
-const route = useRoute();
-const pathname = computed(() => route.path);
-
-const { data, error } = await useAsyncData(\`docs-\${pathname.value}\`, () =>
-  $fetch("/api/docs/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));
-}
-function normalizeApiRouteRoot(routeRoot) {
-	return routeRoot.replace(/^\/+|\/+$/g, "");
-}
-function detectApiRouteRoot(cwd, framework, nextAppDir = "app") {
-	const defaultRoot = "api";
-	const detectFromRecursiveRouteFiles = (baseDir, matcher) => {
-		if (!fs.existsSync(baseDir)) return null;
-		const candidates = /* @__PURE__ */ new Map();
-		const walk = (dir, prefix = "") => {
-			for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-				const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
-				const fullPath = path.join(dir, entry.name);
-				if (entry.isDirectory()) {
-					walk(fullPath, relativePath);
-					continue;
-				}
-				if (!matcher(entry, relativePath)) continue;
-				const [topLevel] = relativePath.split("/");
-				if (!topLevel) continue;
-				candidates.set(topLevel, (candidates.get(topLevel) ?? 0) + 1);
-			}
-		};
-		walk(baseDir);
-		return Array.from(candidates.entries()).sort((a, b) => b[1] - a[1])[0]?.[0] ?? null;
-	};
-	if (framework === "nextjs") {
-		const appRoot = path.join(cwd, nextAppDir);
-		if (fs.existsSync(path.join(appRoot, defaultRoot))) return defaultRoot;
-		return detectFromRecursiveRouteFiles(appRoot, (_entry, relativePath) => /\/?route\.(?:[cm]?[jt]sx?)$/i.test(relativePath)) ?? defaultRoot;
-	}
-	if (framework === "tanstack-start") {
-		const routesRoot = path.join(cwd, "src/routes");
-		if (fs.existsSync(path.join(routesRoot, defaultRoot))) return defaultRoot;
-		return detectFromRecursiveRouteFiles(routesRoot, (_entry, relativePath) => /(?:^|\/)[^/]+\.(?:[cm]?[jt]sx?)$/i.test(relativePath)) ?? defaultRoot;
-	}
-	if (framework === "sveltekit") {
-		const routesRoot = path.join(cwd, "src/routes");
-		if (fs.existsSync(path.join(routesRoot, defaultRoot))) return defaultRoot;
-		return detectFromRecursiveRouteFiles(routesRoot, (_entry, relativePath) => /\/?\+server\.(?:[cm]?[jt]s)$/i.test(relativePath)) ?? defaultRoot;
-	}
-	if (framework === "astro") {
-		const pagesRoot = path.join(cwd, "src/pages");
-		if (fs.existsSync(path.join(pagesRoot, defaultRoot))) return defaultRoot;
-		return detectFromRecursiveRouteFiles(pagesRoot, (entry, relativePath) => /\.(?:[cm]?[jt]s)$/i.test(relativePath) && !relativePath.endsWith(".d.ts") && entry.isFile()) ?? defaultRoot;
-	}
-	const serverRoot = path.join(cwd, "server");
-	if (fs.existsSync(path.join(serverRoot, defaultRoot))) return defaultRoot;
-	return detectFromRecursiveRouteFiles(serverRoot, (entry, relativePath) => /\.(?:[cm]?[jt]s)$/i.test(relativePath) && !relativePath.endsWith(".d.ts") && entry.isFile()) ?? defaultRoot;
-}
-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 {
-			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 themeOptions = [
-		{
-			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: "concrete",
-			label: "Concrete",
-			hint: "Brutalist poster-style theme with offset shadows and loud contrast"
-		},
-		{
-			value: "hardline",
-			label: "Hardline",
-			hint: "Hard-edge theme with square corners and bold borders"
-		},
-		{
-			value: "custom",
-			label: "Create your own theme",
-			hint: "Scaffold a new theme file + CSS in themes/ (name asked next)"
-		}
-	];
-	const themeValues = new Set(themeOptions.map((option) => option.value));
-	let theme;
-	if (options.theme) {
-		if (!themeValues.has(options.theme)) {
-			p.log.error(`Invalid ${pc.cyan("--theme")}. Use one of: ${themeOptions.map((option) => pc.cyan(option.value)).join(", ")}`);
-			process.exit(1);
-		}
-		theme = options.theme;
-	} else {
-		const themeAnswer = await p.select({
-			message: "Which theme would you like to use?",
-			options: themeOptions
-		});
-		if (p.isCancel(themeAnswer)) {
-			p.outro(pc.red("Init cancelled."));
-			process.exit(0);
-		}
-		theme = themeAnswer;
-	}
-	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";
-	let entryPath;
-	if (options.entry) {
-		const normalizedEntry = options.entry.trim();
-		if (normalizedEntry.startsWith("/")) {
-			p.log.error("Use a relative path for --entry (no leading /)");
-			process.exit(1);
-		}
-		if (normalizedEntry.includes(" ")) {
-			p.log.error("Path passed to --entry cannot contain spaces");
-			process.exit(1);
-		}
-		entryPath = normalizedEntry || defaultEntry;
-	} else {
-		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);
-		}
-		entryPath = entry.trim() || defaultEntry;
-	}
-	const defaultApiRouteRoot = normalizeApiRouteRoot(options.apiRouteRoot?.trim() || detectApiRouteRoot(cwd, framework, nextAppDir));
-	let apiReferenceConfig;
-	let enableApiReference;
-	if (typeof options.apiReference === "boolean") enableApiReference = options.apiReference;
-	else if (typeof options.apiRouteRoot === "string" && options.apiRouteRoot.trim()) enableApiReference = true;
-	else {
-		const apiReferenceAnswer = await p.confirm({
-			message: "Do you want to scaffold API reference support?",
-			initialValue: false
-		});
-		if (p.isCancel(apiReferenceAnswer)) {
-			p.outro(pc.red("Init cancelled."));
-			process.exit(0);
-		}
-		enableApiReference = apiReferenceAnswer;
-	}
-	if (enableApiReference) {
-		let routeRoot = options.apiRouteRoot?.trim();
-		if (!routeRoot) {
-			const routeRootAnswer = await p.text({
-				message: "API route root to scan?",
-				placeholder: defaultApiRouteRoot,
-				defaultValue: defaultApiRouteRoot,
-				validate: (value) => {
-					const normalizedValue = normalizeApiRouteRoot((value ?? "").trim());
-					if (!normalizedValue) return "Route root cannot be empty";
-					if (normalizedValue.includes(" ")) return "Route root cannot contain spaces";
-				}
-			});
-			if (p.isCancel(routeRootAnswer)) {
-				p.outro(pc.red("Init cancelled."));
-				process.exit(0);
-			}
-			routeRoot = routeRootAnswer.trim() || defaultApiRouteRoot;
-		}
-		const normalizedRouteRoot = normalizeApiRouteRoot(routeRoot);
-		if (!normalizedRouteRoot) {
-			p.log.error("Route root cannot be empty");
-			process.exit(1);
-		}
-		if (normalizedRouteRoot.includes(" ")) {
-			p.log.error("Route root cannot contain spaces");
-			process.exit(1);
-		}
-		apiReferenceConfig = {
-			path: "api-reference",
-			routeRoot: normalizedRouteRoot
-		};
-	}
-	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,
-		apiReference: apiReferenceConfig,
-		...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 {
-		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));
-	if (cfg.apiReference) {
-		const apiReferenceRoute = `${appDir}/${cfg.apiReference.path}/[[...slug]]/route.ts`;
-		write(apiReferenceRoute, nextApiReferenceRouteTemplate(cfg, apiReferenceRoute));
-	}
-	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));
-	if (cfg.apiReference) {
-		const apiReferenceIndexRoute = `src/routes/${cfg.apiReference.path}.index.ts`;
-		const apiReferenceCatchAllRoute = `src/routes/${cfg.apiReference.path}.$.ts`;
-		write(apiReferenceIndexRoute, tanstackApiReferenceRouteTemplate({
-			filePath: apiReferenceIndexRoute,
-			useAlias: cfg.useAlias,
-			apiReferencePath: cfg.apiReference.path,
-			catchAll: false
-		}));
-		write(apiReferenceCatchAllRoute, tanstackApiReferenceRouteTemplate({
-			filePath: apiReferenceCatchAllRoute,
-			useAlias: cfg.useAlias,
-			apiReferencePath: cfg.apiReference.path,
-			catchAll: true
-		}));
-	}
-	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 (cfg.apiReference) {
-		const apiReferenceIndexRoute = `src/routes/${cfg.apiReference.path}/+server.ts`;
-		const apiReferenceCatchAllRoute = `src/routes/${cfg.apiReference.path}/[...slug]/+server.ts`;
-		write(apiReferenceIndexRoute, svelteApiReferenceRouteTemplate(apiReferenceIndexRoute, cfg.useAlias));
-		write(apiReferenceCatchAllRoute, svelteApiReferenceRouteTemplate(apiReferenceCatchAllRoute, cfg.useAlias));
-	}
-	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",
-		concrete: "concrete",
-		hardline: "hardline",
-		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));
-	if (cfg.apiReference) {
-		const apiReferenceIndexRoute = `src/pages/${cfg.apiReference.path}/index.ts`;
-		const apiReferenceCatchAllRoute = `src/pages/${cfg.apiReference.path}/[...slug].ts`;
-		write(apiReferenceIndexRoute, astroApiReferenceRouteTemplate(apiReferenceIndexRoute));
-		write(apiReferenceCatchAllRoute, astroApiReferenceRouteTemplate(apiReferenceCatchAllRoute));
-	}
-	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",
-		concrete: "concrete",
-		hardline: "hardline",
-		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));
-	if (cfg.apiReference) {
-		const apiReferenceIndexRoute = `server/routes/${cfg.apiReference.path}/index.ts`;
-		const apiReferenceCatchAllRoute = `server/routes/${cfg.apiReference.path}/[...slug].ts`;
-		write(apiReferenceIndexRoute, nuxtServerApiReferenceRouteTemplate(apiReferenceIndexRoute, cfg.useAlias));
-		write(apiReferenceCatchAllRoute, nuxtServerApiReferenceRouteTemplate(apiReferenceCatchAllRoute, cfg.useAlias));
-	}
-	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",
-		concrete: "concrete",
-		hardline: "hardline",
-		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, tanstack-start, nuxt, sveltekit, astro).
-*/
-const PRESETS = [
-	"next",
-	"tanstack-start",
-	"nuxt",
-	"sveltekit",
-	"astro"
-];
-const PACKAGES_BY_FRAMEWORK = {
-	nextjs: [
-		"@farming-labs/docs",
-		"@farming-labs/theme",
-		"@farming-labs/next"
-	],
-	"tanstack-start": [
-		"@farming-labs/docs",
-		"@farming-labs/theme",
-		"@farming-labs/tanstack-start"
-	],
-	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, TanStack Start, Nuxt, SvelteKit, Astro). Use " + pc.cyan("--framework <next|tanstack-start|nuxt|sveltekit|astro>") + " to specify.");
-			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 concrete, --entry docs, --framework astro (exported for tests). */
-function parseFlags(argv) {
-	const flags = {};
-	const booleanFlags = new Set(["api-reference"]);
-	for (let i = 0; i < argv.length; i++) {
-		const arg = argv[i];
-		if (arg.startsWith("--") && arg.includes("=")) {
-			const [key, value] = arg.slice(2).split("=");
-			if (key.startsWith("no-")) flags[key.slice(3)] = false;
-			else if (booleanFlags.has(key) && value === "true") flags[key] = true;
-			else if (booleanFlags.has(key) && value === "false") flags[key] = false;
-			else flags[key] = value;
-		} else if (arg.startsWith("--") && argv[i + 1] && !argv[i + 1].startsWith("--")) {
-			flags[arg.slice(2)] = argv[i + 1];
-			i++;
-		} else if (arg.startsWith("--no-")) flags[arg.slice(5)] = false;
-		else if (arg.startsWith("--") && booleanFlags.has(arg.slice(2))) flags[arg.slice(2)] = true;
-	}
-	return flags;
-}
-async function main() {
-	const flags = parseFlags(args);
-	const initOptions = {
-		template: typeof flags.template === "string" ? flags.template : void 0,
-		name: typeof flags.name === "string" ? flags.name : void 0,
-		theme: typeof flags.theme === "string" ? flags.theme : void 0,
-		entry: typeof flags.entry === "string" ? flags.entry : void 0,
-		apiReference: typeof flags["api-reference"] === "boolean" ? flags["api-reference"] : void 0,
-		apiRouteRoot: typeof flags["api-route-root"] === "string" ? flags["api-route-root"] : void 0
-	};
-	if (!command || command === "init") await init(initOptions);
-	else if (command === "upgrade") await upgrade({
-		framework: (typeof flags.framework === "string" ? flags.framework : void 0) ?? (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, TanStack Start, 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("concrete")})
-  ${pc.cyan("--entry <path>")}     Skip entry path prompt (e.g. ${pc.dim("docs")})
-  ${pc.cyan("--api-reference")}    Scaffold API reference support during ${pc.cyan("init")}
-  ${pc.cyan("--no-api-reference")} Skip API reference scaffold during ${pc.cyan("init")}
-  ${pc.cyan("--api-route-root <path>")}  Override the API route root scanned by ${pc.cyan("apiReference.routeRoot")} (e.g. ${pc.dim("api")}, ${pc.dim("internal-api")})
-
-${pc.dim("Options for upgrade:")}
-  ${pc.cyan("--framework <name>")}  Explicit framework (${pc.dim("next")}, ${pc.dim("tanstack-start")}, ${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 };