@farming-labs/docs 0.1.103 → 0.1.105

package/dist/cli/index.mjs

@@ -158,10 +158,14 @@ async function main() {
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-Nh6Jn6Kk.mjs");
+		const { upgrade } = await import("../upgrade-G2f_v09Z.mjs");
+		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
+		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
+		const version = typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0;
 		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" : args.includes("--latest") ? "latest" : parsedCommand.tag ?? "latest"
+			framework,
+			tag: version !== void 0 ? void 0 : args.includes("--beta") ? "beta" : args.includes("--latest") ? "latest" : parsedCommand.tag ?? "latest",
+			version
 		});
 	} else if (parsedCommand.command === "--help" || parsedCommand.command === "-h") printHelp();
 	else if (parsedCommand.command === "--version" || parsedCommand.command === "-v") printVersion();
@@ -189,7 +193,7 @@ ${pc.dim("Commands:")}
   ${pc.cyan("robots")}   Robots.txt utilities (${pc.dim("generate")} for agent access policy)
   ${pc.cyan("search")}   Search utilities (${pc.dim("sync")} for external indexes)
   ${pc.cyan("sitemap")}  Sitemap utilities (${pc.dim("generate")} for sitemap XML/Markdown data)
-  ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages to latest (auto-detect or use --framework)
+  ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages (auto-detect or use --framework)
 
 ${pc.dim("Supported frameworks:")}
   Next.js, TanStack Start, SvelteKit, Astro, Nuxt
@@ -271,6 +275,7 @@ ${pc.dim("Options for robots generate:")}
 
 ${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("--version <version>")} Install an exact version (e.g. ${pc.dim("0.1.104")})
   ${pc.cyan("--latest")}            Install latest stable (default)
   ${pc.cyan("--beta")}             Install beta versions
   ${pc.cyan("upgrade@beta")}       Shortcut for ${pc.cyan("upgrade --beta")}

package/dist/{upgrade-Nh6Jn6Kk.mjs → upgrade-G2f_v09Z.mjs}

@@ -5,7 +5,7 @@ import * as p from "@clack/prompts";
 
 //#region src/cli/upgrade.ts
 /**
-* Upgrade @farming-labs/* packages to latest.
+* Upgrade @farming-labs/* packages to a dist-tag or exact version.
 * Detects framework from package.json by default, or use --framework (next, tanstack-start, nuxt, sveltekit, astro).
 */
 const PRESETS = [
@@ -52,15 +52,31 @@ function frameworkFromPreset(preset) {
 function getPackagesForFramework(framework) {
 	return PACKAGES_BY_FRAMEWORK[framework];
 }
+const exactSemverPattern = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+function validateUpgradeVersion(version) {
+	const normalized = version.trim();
+	if (!exactSemverPattern.test(normalized)) throw new Error(`Invalid version "${version}". Use an exact semver version like 0.1.104.`);
+	return normalized;
+}
+function resolveUpgradeTarget(options) {
+	if (options.version !== void 0) return validateUpgradeVersion(options.version);
+	return options.tag ?? "latest";
+}
 /** 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(" ")}`;
+function buildUpgradeCommand(framework, target, pm) {
+	const packagesWithTarget = PACKAGES_BY_FRAMEWORK[framework].map((name) => `${name}@${target}`);
+	return `${installCommand(pm)} ${packagesWithTarget.join(" ")}`;
 }
 async function upgrade(options = {}) {
 	const cwd = process.cwd();
-	const tag = options.tag ?? "latest";
 	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs upgrade ")));
+	let target;
+	try {
+		target = resolveUpgradeTarget(options);
+	} catch (error) {
+		p.log.error(error instanceof Error ? error.message : "Invalid upgrade version.");
+		process.exit(1);
+	}
 	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);
@@ -120,13 +136,13 @@ async function upgrade(options = {}) {
 		pm = pmAnswer;
 		p.log.info(`Using ${pc.cyan(pm)} as package manager`);
 	}
-	const cmd = buildUpgradeCommand(framework, tag, pm);
+	const cmd = buildUpgradeCommand(framework, target, pm);
 	const packages = getPackagesForFramework(framework);
-	p.log.step(`Upgrading ${preset} docs packages to ${tag}...`);
+	p.log.step(`Upgrading ${preset} docs packages to ${target}...`);
 	p.log.message(pc.dim(packages.join(", ")));
 	try {
 		exec(cmd, cwd);
-		p.log.success(`Packages upgraded to ${tag}.`);
+		p.log.success(`Packages upgraded to ${target}.`);
 		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));

package/package.json

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