@farming-labs/docs 0.0.3 → 0.0.5-beta.1

package/dist/cli/index.mjs

@@ -1948,11 +1948,93 @@ 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;
+}
+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 packages = PACKAGES_BY_FRAMEWORK[framework];
+	const packagesWithTag = packages.map((name) => `${name}@${tag}`);
+	const cmd = `${installCommand(detectPackageManager(cwd))} ${packagesWithTag.join(" ")}`;
+	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 */
 function parseFlags(argv) {
 	const flags = {};
 	for (let i = 0; i < argv.length; i++) {
@@ -1976,6 +2058,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 {
@@ -1990,10 +2076,11 @@ function printHelp() {
 ${pc.bold("@farming-labs/docs")} — Documentation framework CLI
 
 ${pc.dim("Usage:")}
-  npx @farming-labs/docs ${pc.cyan("<command>")}
+  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 +2090,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
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.3",
+  "version": "0.0.5-beta.1",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",