@farming-labs/docs 0.2.62 → 0.2.63

package/dist/downgrade-w7e6Se0L.mjs

@@ -0,0 +1,184 @@
+import { c as fileExists, o as exec, s as execOutput } from "./utils-DpiIioYb.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-n5AFur8a.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import * as p from "@clack/prompts";
+
+//#region src/cli/downgrade.ts
+/**
+* Downgrade @farming-labs/* packages to a lower exact version.
+* Detects framework from package.json by default, or use --framework (next, tanstack-start, nuxt, sveltekit, astro).
+*/
+function parseSemver(version) {
+	const normalized = validateUpgradeVersion(version).split("+", 1)[0] ?? version;
+	const prereleaseIndex = normalized.indexOf("-");
+	const core = prereleaseIndex === -1 ? normalized : normalized.slice(0, prereleaseIndex);
+	const prerelease = prereleaseIndex === -1 ? "" : normalized.slice(prereleaseIndex + 1);
+	const [major = "0", minor = "0", patch = "0"] = core.split(".");
+	return {
+		major: Number.parseInt(major, 10),
+		minor: Number.parseInt(minor, 10),
+		patch: Number.parseInt(patch, 10),
+		prerelease: prerelease ? prerelease.split(".") : []
+	};
+}
+function comparePrereleaseIdentifier(a, b) {
+	const aNumber = /^\d+$/.test(a) ? Number.parseInt(a, 10) : null;
+	const bNumber = /^\d+$/.test(b) ? Number.parseInt(b, 10) : null;
+	if (aNumber !== null && bNumber !== null) return Math.sign(aNumber - bNumber);
+	if (aNumber !== null) return -1;
+	if (bNumber !== null) return 1;
+	return a.localeCompare(b);
+}
+function compareSemver(a, b) {
+	const left = parseSemver(a);
+	const right = parseSemver(b);
+	for (const key of [
+		"major",
+		"minor",
+		"patch"
+	]) if (left[key] !== right[key]) return Math.sign(left[key] - right[key]);
+	if (left.prerelease.length === 0 && right.prerelease.length === 0) return 0;
+	if (left.prerelease.length === 0) return 1;
+	if (right.prerelease.length === 0) return -1;
+	const length = Math.max(left.prerelease.length, right.prerelease.length);
+	for (let index = 0; index < length; index++) {
+		const leftPart = left.prerelease[index];
+		const rightPart = right.prerelease[index];
+		if (leftPart === void 0) return -1;
+		if (rightPart === void 0) return 1;
+		const compared = comparePrereleaseIdentifier(leftPart, rightPart);
+		if (compared !== 0) return compared;
+	}
+	return 0;
+}
+function normalizeMaybeVersion(value) {
+	try {
+		return validateUpgradeVersion(value);
+	} catch {
+		return null;
+	}
+}
+function extractVersionFromSpec(spec) {
+	const exact = normalizeMaybeVersion(spec);
+	if (exact) return exact;
+	const rangeMatch = spec.match(/^[~^]([^~^<>=|\s]+)/);
+	if (!rangeMatch) return null;
+	return normalizeMaybeVersion(rangeMatch[1] ?? "");
+}
+function readJsonFile(filePath) {
+	try {
+		return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+function packageJsonPath(cwd, packageName) {
+	return path.join(cwd, "node_modules", ...packageName.split("/"), "package.json");
+}
+function readCurrentPackageVersion(cwd, packageNames) {
+	for (const packageName of packageNames) {
+		const installedPackageJson = readJsonFile(packageJsonPath(cwd, packageName));
+		const installedVersion = typeof installedPackageJson?.version === "string" ? normalizeMaybeVersion(installedPackageJson.version) : null;
+		if (installedVersion) return installedVersion;
+	}
+	const projectPackageJson = readJsonFile(path.join(cwd, "package.json"));
+	const dependencyGroups = [
+		projectPackageJson?.dependencies,
+		projectPackageJson?.devDependencies,
+		projectPackageJson?.peerDependencies
+	];
+	for (const group of dependencyGroups) {
+		if (!group || typeof group !== "object") continue;
+		for (const packageName of packageNames) {
+			const spec = group[packageName];
+			if (typeof spec !== "string") continue;
+			const version = extractVersionFromSpec(spec);
+			if (version) return version;
+		}
+	}
+	return null;
+}
+function parsePublishedVersions(raw) {
+	const parsed = JSON.parse(raw);
+	return (Array.isArray(parsed) ? parsed : [parsed]).filter((version) => typeof version === "string").map((version) => normalizeMaybeVersion(version)).filter((version) => version !== null);
+}
+function getPreviousVersion(versions, currentVersion) {
+	const current = validateUpgradeVersion(currentVersion);
+	return versions.filter((version) => compareSemver(version, current) < 0).sort(compareSemver).at(-1) ?? null;
+}
+function fetchPublishedVersions(cwd) {
+	return parsePublishedVersions(execOutput("npm view @farming-labs/docs versions --json", cwd));
+}
+function buildDowngradeCommand(framework, version, pm) {
+	return buildDocsPackageInstallCommand(framework, validateUpgradeVersion(version), pm);
+}
+async function downgrade(options = {}) {
+	const cwd = process.cwd();
+	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs downgrade ")));
+	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);
+	}
+	const { framework, preset } = resolveDocsPackageFramework(cwd, options.framework);
+	const packages = getPackagesForFramework(framework);
+	const currentVersion = readCurrentPackageVersion(cwd, packages);
+	if (!currentVersion) {
+		p.log.error("Could not determine the current @farming-labs docs package version. Install dependencies first or use an exact package version in package.json.");
+		process.exit(1);
+	}
+	let targetVersion;
+	if (options.version !== void 0) {
+		try {
+			targetVersion = validateUpgradeVersion(options.version);
+		} catch (error) {
+			p.log.error(error instanceof Error ? error.message : "Invalid downgrade version.");
+			process.exit(1);
+		}
+		const comparison = compareSemver(targetVersion, currentVersion);
+		if (comparison > 0) {
+			p.log.error(`Version ${pc.cyan(targetVersion)} is newer than current ${pc.cyan(currentVersion)}.`);
+			p.log.info(`Use ${pc.cyan(`docs upgrade --version ${targetVersion}`)} instead.`);
+			process.exit(1);
+		}
+		if (comparison === 0) {
+			p.log.error(`Version ${pc.cyan(targetVersion)} is already installed. Choose a lower version to downgrade.`);
+			process.exit(1);
+		}
+	} else {
+		let publishedVersions;
+		try {
+			publishedVersions = fetchPublishedVersions(cwd);
+		} catch {
+			p.log.error("Could not fetch published @farming-labs/docs versions. Pass an exact version with " + pc.cyan("--version <version>") + ".");
+			process.exit(1);
+		}
+		const previousVersion = getPreviousVersion(publishedVersions, currentVersion);
+		if (!previousVersion) {
+			p.log.error(`No published version found below current ${pc.cyan(currentVersion)}.`);
+			process.exit(1);
+		}
+		targetVersion = previousVersion;
+	}
+	const pm = await resolveDocsPackageManager(cwd, "downgrade");
+	const cmd = buildDowngradeCommand(framework, targetVersion, pm);
+	p.log.step(`Downgrading ${preset} docs packages from ${currentVersion} to ${targetVersion}...`);
+	p.log.message(pc.dim(packages.join(", ")));
+	if (options.dryRun) {
+		p.log.info("Dry run. Would run:\n  " + pc.cyan(cmd));
+		p.outro(pc.green("Dry run complete. No changes made."));
+		return;
+	}
+	try {
+		exec(cmd, cwd);
+		p.log.success(`Packages downgraded to ${targetVersion}.`);
+		p.outro(pc.green("Done. Run your dev server to confirm everything works."));
+	} catch {
+		p.log.error("Downgrade failed. Try running manually:\n  " + pc.cyan(cmd));
+		process.exit(1);
+	}
+}
+
+//#endregion
+export { downgrade };

package/dist/errors-DbOhkE1h.mjs

@@ -0,0 +1,20 @@
+//#region src/cli/errors.ts
+const CLI_ERROR_REPORTED_KEY = "__farmingLabsDocsCliErrorReported";
+function formatCliError(error) {
+	if (error instanceof Error && error.message.trim()) return error.message.trim();
+	if (typeof error === "string" && error.trim()) return error.trim();
+	return "An unexpected error occurred.";
+}
+function markCliErrorReported(error) {
+	if (error && typeof error === "object") error[CLI_ERROR_REPORTED_KEY] = true;
+}
+function wasCliErrorReported(error) {
+	return Boolean(error && typeof error === "object" && error[CLI_ERROR_REPORTED_KEY] === true);
+}
+function shouldPrintStackTrace(env = process.env) {
+	const debug = env.DOCS_DEBUG ?? env.DEBUG;
+	return debug === "1" || debug === "true" || debug === "@farming-labs/docs";
+}
+
+//#endregion
+export { wasCliErrorReported as i, markCliErrorReported as n, shouldPrintStackTrace as r, formatCliError as t };