@farming-labs/docs 0.0.4 → 0.0.5

package/dist/cli/index.d.mts

@@ -1 +1,5 @@
-export { };
+//#region src/cli/index.d.ts
+/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs, --framework astro (exported for tests). */
+declare function parseFlags(argv: string[]): Record<string, string | undefined>;
+//#endregion
+export { parseFlags };

package/dist/cli/index.mjs

@@ -286,7 +286,7 @@ function nextConfigMergedTemplate(existingContent) {
 	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);
+	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;
@@ -328,6 +328,32 @@ export default function RootLayout({
 }
 `;
 }
+/**
+* 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) {
 	return `\
 @import "tailwindcss";
@@ -347,9 +373,19 @@ function injectCssImport(existingContent, theme) {
 function docsLayoutTemplate(cfg) {
 	return `\
 import docsConfig from "${nextDocsLayoutConfigImport(cfg.useAlias)}";
-import { createDocsLayout } from "@farming-labs/theme";
+import { createDocsLayout, createDocsMetadata } from "@farming-labs/theme";
 
-export default createDocsLayout(docsConfig);
+export const metadata = createDocsMetadata(docsConfig);
+
+const DocsLayout = createDocsLayout(docsConfig);
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <>
+      <DocsLayout>{children}</DocsLayout>
+    </>
+  );
+}
 `;
 }
 function postcssConfigTemplate() {
@@ -1820,7 +1856,7 @@ async function init(options = {}) {
 			});
 		});
 	} catch (err) {
-		const manualCmd = framework === "sveltekit" ? "npx vite dev" : framework === "astro" ? "npx astro dev" : framework === "nuxt" ? "npx nuxt dev" : "npx next dev --webpack";
+		const manualCmd = 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."));
@@ -1838,7 +1874,16 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 			written.push(configFile + " (updated)");
 		} else skipped.push(configFile + " (already configured)");
 	} else write("next.config.ts", nextConfigTemplate());
-	write("app/layout.tsx", rootLayoutTemplate(cfg, globalCssRelPath));
+	const rootLayoutPath = path.join(cwd, "app/layout.tsx");
+	const existingRootLayout = readFileSafe(rootLayoutPath);
+	if (!existingRootLayout) write("app/layout.tsx", rootLayoutTemplate(cfg, globalCssRelPath), true);
+	else if (!existingRootLayout.includes("RootProvider")) {
+		const injected = injectRootProviderIntoLayout(existingRootLayout);
+		if (injected) {
+			writeFileSafe(rootLayoutPath, injected, true);
+			written.push("app/layout.tsx (injected RootProvider)");
+		} else skipped.push("app/layout.tsx (could not inject RootProvider)");
+	} else skipped.push("app/layout.tsx (already has RootProvider)");
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
 	if (existingGlobalCss) {
@@ -1948,11 +1993,102 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	write(`${cfg.entry}/quickstart/page.md`, nuxtQuickstartPageTemplate(cfg));
 }
 
+//#endregion
+//#region src/cli/upgrade.ts
+/**
+* Upgrade @farming-labs/* packages to latest.
+* Detects framework from package.json by default, or use --framework (next, nuxt, sveltekit, astro).
+*/
+const PRESETS = [
+	"next",
+	"nuxt",
+	"sveltekit",
+	"astro"
+];
+const PACKAGES_BY_FRAMEWORK = {
+	nextjs: [
+		"@farming-labs/docs",
+		"@farming-labs/theme",
+		"@farming-labs/next"
+	],
+	nuxt: [
+		"@farming-labs/docs",
+		"@farming-labs/nuxt",
+		"@farming-labs/nuxt-theme"
+	],
+	sveltekit: [
+		"@farming-labs/docs",
+		"@farming-labs/svelte",
+		"@farming-labs/svelte-theme"
+	],
+	astro: [
+		"@farming-labs/docs",
+		"@farming-labs/astro",
+		"@farming-labs/astro-theme"
+	]
+};
+function presetFromFramework(fw) {
+	return fw === "nextjs" ? "next" : fw;
+}
+function frameworkFromPreset(preset) {
+	return preset === "next" ? "nextjs" : preset;
+}
+/** Return package list for a framework (for testing and CLI). */
+function getPackagesForFramework(framework) {
+	return PACKAGES_BY_FRAMEWORK[framework];
+}
+/** Build the install command for upgrade (for testing). */
+function buildUpgradeCommand(framework, tag, pm) {
+	const packagesWithTag = PACKAGES_BY_FRAMEWORK[framework].map((name) => `${name}@${tag}`);
+	return `${installCommand(pm)} ${packagesWithTag.join(" ")}`;
+}
+async function upgrade(options = {}) {
+	const cwd = process.cwd();
+	const tag = options.tag ?? "latest";
+	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs upgrade ")));
+	if (!fileExists(path.join(cwd, "package.json"))) {
+		p.log.error("No package.json found in the current directory. Run this from your project root.");
+		process.exit(1);
+	}
+	let framework = null;
+	let preset;
+	if (options.framework) {
+		const raw = options.framework.toLowerCase().trim();
+		const normalized = raw === "nextjs" ? "next" : raw;
+		if (!PRESETS.includes(normalized)) {
+			p.log.error(`Invalid framework ${pc.cyan(options.framework)}. Use one of: ${PRESETS.map((t) => pc.cyan(t)).join(", ")}`);
+			process.exit(1);
+		}
+		preset = normalized;
+		framework = frameworkFromPreset(preset);
+	} else {
+		framework = detectFramework(cwd);
+		if (!framework) {
+			p.log.error("Could not detect a supported framework (Next.js, Nuxt, SvelteKit, Astro). Use " + pc.cyan("--framework <next|nuxt|sveltekit|astro>") + " to specify.");
+			process.exit(1);
+		}
+		preset = presetFromFramework(framework);
+	}
+	const pm = detectPackageManager(cwd);
+	const cmd = buildUpgradeCommand(framework, tag, pm);
+	const packages = getPackagesForFramework(framework);
+	p.log.step(`Upgrading ${preset} docs packages to ${tag}...`);
+	p.log.message(pc.dim(packages.join(", ")));
+	try {
+		exec(cmd, cwd);
+		p.log.success(`Packages upgraded to ${tag}.`);
+		p.outro(pc.green("Done. Run your dev server to confirm everything works."));
+	} catch {
+		p.log.error("Upgrade failed. Try running manually:\n  " + pc.cyan(cmd));
+		process.exit(1);
+	}
+}
+
 //#endregion
 //#region src/cli/index.ts
 const args = process.argv.slice(2);
 const command = args[0];
-/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs */
+/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs, --framework astro (exported for tests). */
 function parseFlags(argv) {
 	const flags = {};
 	for (let i = 0; i < argv.length; i++) {
@@ -1976,6 +2112,10 @@ async function main() {
 		entry: flags.entry
 	};
 	if (!command || command === "init") await init(initOptions);
+	else if (command === "upgrade") await upgrade({
+		framework: flags.framework ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0),
+		tag: args.includes("--beta") ? "beta" : "latest"
+	});
 	else if (command === "--help" || command === "-h") printHelp();
 	else if (command === "--version" || command === "-v") printVersion();
 	else {
@@ -1993,7 +2133,8 @@ ${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("init")}     Scaffold docs in your project (default)
+  ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages to latest (auto-detect or use --framework)
 
 ${pc.dim("Supported frameworks:")}
   Next.js, SvelteKit, Astro, Nuxt
@@ -2003,6 +2144,12 @@ ${pc.dim("Options for init:")}
   ${pc.cyan("--name <project>")}  Project folder name when using ${pc.cyan("--template")}; prompt if omitted (e.g. ${pc.dim("my-docs")})
   ${pc.cyan("--theme <name>")}     Skip theme prompt (e.g. ${pc.dim("darksharp")}, ${pc.dim("greentree")})
   ${pc.cyan("--entry <path>")}     Skip entry path prompt (e.g. ${pc.dim("docs")})
+
+${pc.dim("Options for upgrade:")}
+  ${pc.cyan("--framework <name>")}  Explicit framework (${pc.dim("next")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}); omit to auto-detect
+  ${pc.cyan("--latest")}            Install latest stable (default)
+  ${pc.cyan("--beta")}             Install beta versions
+
   ${pc.cyan("-h, --help")}         Show this help message
   ${pc.cyan("-v, --version")}     Show version
 `);
@@ -2017,4 +2164,4 @@ main().catch((err) => {
 });
 
 //#endregion
-export {  };
+export { parseFlags };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -34,11 +34,14 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }