@farming-labs/docs 0.1.105 → 0.1.107

package/dist/{agent-sUT6Bsop.mjs → agent-BkBIpBPu.mjs}

@@ -4,6 +4,6 @@ import "./agent-BK7q65dn.mjs";
 import "./robots-DDrj6Cpo.mjs";
 import "./sitemap-server-DJvxOqX2.mjs";
 import "./config-Cio3byUJ.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./agents-B04j1KsE.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./agents-CpXgpIkR.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/{agents-B04j1KsE.mjs → agents-CpXgpIkR.mjs}

@@ -5,7 +5,7 @@ import { v as resolveApiReferenceConfig } from "./sitemap-server-DJvxOqX2.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, l as readNumberProperty, o as readBooleanProperty, p as resolveDocsContentDir, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-Cio3byUJ.mjs";
-import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
+import { t as detectFramework } from "./utils-TPe8H1P-.mjs";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/cli/index.mjs

@@ -77,16 +77,16 @@ async function main() {
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-BJbBtnBz.mjs");
+		const { init } = await import("../init-CCDM1jpD.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-CpvDdmY3.mjs");
+		const { dev } = await import("../dev-cvGfM7qo.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-B-zWyAlw.mjs");
+		const { runMcp } = await import("../mcp-Cbg5V9qX.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-sUT6Bsop.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BkBIpBPu.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -96,11 +96,11 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-sUT6Bsop.mjs");
+		const { printAgentCompactHelp } = await import("../agent-BkBIpBPu.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-B04j1KsE.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-CpXgpIkR.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -110,11 +110,11 @@ async function main() {
 	} else if (parsedCommand.command === "agents") {
 		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentsGenerateHelp } = await import("../agents-B04j1KsE.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-CpXgpIkR.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-DPFrn2se.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-BLBWvfy5.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -122,7 +122,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-0H8jdm8S.mjs");
+		const { syncSearch } = await import("../search-D5TyB13g.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -130,7 +130,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DqzvA3BI.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DF2RCPGq.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -140,11 +140,11 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-DqzvA3BI.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-DF2RCPGq.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-HU8yTWZv.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DuDAetXn.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -154,11 +154,19 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-HU8yTWZv.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-DuDAetXn.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
+	} else if (parsedCommand.command === "downgrade") {
+		const { downgrade } = await import("../downgrade-Bt4yrVyy.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="));
+		await downgrade({
+			framework,
+			version: typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0
+		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-G2f_v09Z.mjs");
+		const { upgrade } = await import("../upgrade-B1EMfRQJ.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;
@@ -194,6 +202,7 @@ ${pc.dim("Commands:")}
   ${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 (auto-detect or use --framework)
+  ${pc.cyan("downgrade")} Downgrade @farming-labs/* packages (auto-detect or use --framework)
 
 ${pc.dim("Supported frameworks:")}
   Next.js, TanStack Start, SvelteKit, Astro, Nuxt
@@ -281,6 +290,11 @@ ${pc.dim("Options for upgrade:")}
   ${pc.cyan("upgrade@beta")}       Shortcut for ${pc.cyan("upgrade --beta")}
   ${pc.cyan("upgrade@latest")}     Shortcut for ${pc.cyan("upgrade --latest")}
 
+${pc.dim("Options for downgrade:")}
+  ${pc.cyan("downgrade")}           Install the published version immediately below the current installed version
+  ${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 lower version (e.g. ${pc.dim("0.1.103")})
+
   ${pc.cyan("-h, --help")}         Show this help message
   ${pc.cyan("-v, --version")}     Show version
 `);

package/dist/{dev-CpvDdmY3.mjs → dev-cvGfM7qo.mjs}

@@ -1,4 +1,4 @@
-import { i as detectPackageManagerFromLockfile } from "./utils-AmYxHDoz.mjs";
+import { i as detectPackageManagerFromLockfile } from "./utils-TPe8H1P-.mjs";
 import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-BpSkUico.mjs";
 import fs from "node:fs";
 import path from "node:path";

package/dist/{doctor-DPFrn2se.mjs → doctor-BLBWvfy5.mjs}

@@ -7,8 +7,8 @@ import "./sitemap-server-DJvxOqX2.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Cio3byUJ.mjs";
-import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./agents-B04j1KsE.mjs";
+import { t as detectFramework } from "./utils-TPe8H1P-.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./agents-CpXgpIkR.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";

package/dist/downgrade-Bt4yrVyy.mjs

@@ -0,0 +1,179 @@
+import { c as fileExists, o as exec, s as execOutput } from "./utils-TPe8H1P-.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-DQgrHnSb.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(", ")));
+	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/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsSearchResultType, A as DocsConfig, At as SidebarTree, B as DocsObservabilityEventInput, C as DocsAskAIActionData, Ct as ResolvedDocsRelatedLink, D as DocsAskAIFeedbackMessage, Dt as SidebarFolderNode, E as DocsAskAIFeedbackData, Et as SidebarFolderIndexBehavior, F as DocsMcpToolsConfig, Ft as UIConfig, G as DocsSearchAdapterContext, H as DocsRobotsConfig, I as DocsMetadata, J as DocsSearchConfig, K as DocsSearchAdapterFactory, L as DocsNav, M as DocsFeedbackValue, Mt as ThemeToggleConfig, N as DocsI18nConfig, Nt as TypesenseDocsSearchConfig, O as DocsAskAIFeedbackValue, Ot as SidebarNode, P as DocsMcpConfig, Pt as TypographyConfig, Q as DocsSearchResult, R as DocsObservabilityConfig, S as DocsAnalyticsSource, St as ReadingTimeConfig, T as DocsAskAIFeedbackConfig, Tt as SidebarConfig, U as DocsRobotsRule, V as DocsRelatedItem, W as DocsSearchAdapter, X as DocsSearchEmbeddingsConfig, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, _t as PageActionsConfig, a as ApiReferenceRenderer, at as GithubConfig, b as DocsAnalyticsEventType, bt as PageSidebarFrontmatter, c as ChangelogFrontmatter, ct as LlmsTxtMaxCharsConfig, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, f as DocsAgentFeedbackContext, ft as OGConfig, g as DocsAgentTraceStatus, gt as OrderingItem, h as DocsAgentTraceEventType, ht as OpenGraphImage, i as ApiReferenceConfig, it as FontStyle, j as DocsFeedbackData, jt as SimpleDocsSearchConfig, k as DocsAskAIMcpConfig, kt as SidebarPageNode, l as CodeBlockCopyData, lt as LlmsTxtMaxCharsMode, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, n as AgentFeedbackConfig, nt as DocsTheme, o as BreadcrumbConfig, ot as LastUpdatedConfig, p as DocsAgentFeedbackData, pt as OpenDocsConfig, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, rt as FeedbackConfig, s as ChangelogConfig, st as LlmsTxtConfig, t as AIConfig, tt as DocsSitemapConfig, u as CopyMarkdownConfig, ut as LlmsTxtSectionConfig, v as DocsAnalyticsEvent, vt as PageFrontmatter, w as DocsAskAIActionType, wt as SidebarComponentProps, x as DocsAnalyticsInput, xt as PageTwitter, y as DocsAnalyticsEventInput, yt as PageOpenGraph, z as DocsObservabilityEvent } from "./types-BSnCAFHc.mjs";
-import { A as toDocsSitemapMarkdownUrl, B as resolveDocsAnalyticsConfig, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as createDocsAgentTraceContext, H as DocsCloudAnalyticsOptions, I as createDocsAgentTraceId, L as emitDocsAgentTraceEvent, M as DocsAgentTraceContext, N as ResolvedDocsAnalyticsConfig, O as resolveDocsSitemapPageLastmod, P as ResolvedDocsObservabilityConfig, R as emitDocsAnalyticsEvent, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, U as createDocsCloudAnalytics, V as resolveDocsObservabilityConfig, _ as DocsSitemapFormat, a as createMcpSearchAdapter, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as emitDocsObservabilityEvent } from "./search-BlXlCmne.mjs";
+import { $ as DocsSearchResultType, A as DocsConfig, At as SidebarTree, B as DocsObservabilityEventInput, C as DocsAskAIActionData, Ct as ResolvedDocsRelatedLink, D as DocsAskAIFeedbackMessage, Dt as SidebarFolderNode, E as DocsAskAIFeedbackData, Et as SidebarFolderIndexBehavior, F as DocsMcpToolsConfig, Ft as UIConfig, G as DocsSearchAdapterContext, H as DocsRobotsConfig, I as DocsMetadata, J as DocsSearchConfig, K as DocsSearchAdapterFactory, L as DocsNav, M as DocsFeedbackValue, Mt as ThemeToggleConfig, N as DocsI18nConfig, Nt as TypesenseDocsSearchConfig, O as DocsAskAIFeedbackValue, Ot as SidebarNode, P as DocsMcpConfig, Pt as TypographyConfig, Q as DocsSearchResult, R as DocsObservabilityConfig, S as DocsAnalyticsSource, St as ReadingTimeConfig, T as DocsAskAIFeedbackConfig, Tt as SidebarConfig, U as DocsRobotsRule, V as DocsRelatedItem, W as DocsSearchAdapter, X as DocsSearchEmbeddingsConfig, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, _t as PageActionsConfig, a as ApiReferenceRenderer, at as GithubConfig, b as DocsAnalyticsEventType, bt as PageSidebarFrontmatter, c as ChangelogFrontmatter, ct as LlmsTxtMaxCharsConfig, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, f as DocsAgentFeedbackContext, ft as OGConfig, g as DocsAgentTraceStatus, gt as OrderingItem, h as DocsAgentTraceEventType, ht as OpenGraphImage, i as ApiReferenceConfig, it as FontStyle, j as DocsFeedbackData, jt as SimpleDocsSearchConfig, k as DocsAskAIMcpConfig, kt as SidebarPageNode, l as CodeBlockCopyData, lt as LlmsTxtMaxCharsMode, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, n as AgentFeedbackConfig, nt as DocsTheme, o as BreadcrumbConfig, ot as LastUpdatedConfig, p as DocsAgentFeedbackData, pt as OpenDocsConfig, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, rt as FeedbackConfig, s as ChangelogConfig, st as LlmsTxtConfig, t as AIConfig, tt as DocsSitemapConfig, u as CopyMarkdownConfig, ut as LlmsTxtSectionConfig, v as DocsAnalyticsEvent, vt as PageFrontmatter, w as DocsAskAIActionType, wt as SidebarComponentProps, x as DocsAnalyticsInput, xt as PageTwitter, y as DocsAnalyticsEventInput, yt as PageOpenGraph, z as DocsObservabilityEvent } from "./types-DabWZeFx.mjs";
+import { A as toDocsSitemapMarkdownUrl, B as resolveDocsAnalyticsConfig, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as createDocsAgentTraceContext, H as DocsCloudAnalyticsOptions, I as createDocsAgentTraceId, L as emitDocsAgentTraceEvent, M as DocsAgentTraceContext, N as ResolvedDocsAnalyticsConfig, O as resolveDocsSitemapPageLastmod, P as ResolvedDocsObservabilityConfig, R as emitDocsAnalyticsEvent, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, U as createDocsCloudAnalytics, V as resolveDocsObservabilityConfig, _ as DocsSitemapFormat, a as createMcpSearchAdapter, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as emitDocsObservabilityEvent } from "./search-CvfF6EKZ.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts

package/dist/{init-BJbBtnBz.mjs → init-CCDM1jpD.mjs}

@@ -1,4 +1,4 @@
-import { a as devInstallCommand, c as installCommand, d as writeFileSafe, i as detectPackageManagerFromLockfile, l as readFileSafe, n as detectGlobalCssFiles, o as exec, r as detectNextAppDir, s as fileExists, t as detectFramework, u as spawnAndWaitFor } from "./utils-AmYxHDoz.mjs";
+import { a as devInstallCommand, c as fileExists, d as spawnAndWaitFor, f as writeFileSafe, i as detectPackageManagerFromLockfile, l as installCommand, n as detectGlobalCssFiles, o as exec, r as detectNextAppDir, t as detectFramework, u as readFileSafe } from "./utils-TPe8H1P-.mjs";
 import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-BpSkUico.mjs";
 import fs from "node:fs";
 import path from "node:path";

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { J as DocsSearchConfig, P as DocsMcpConfig, R as DocsObservabilityConfig, _ as DocsAnalyticsConfig, et as DocsSearchSourcePage, gt as OrderingItem } from "./types-BSnCAFHc.mjs";
+import { J as DocsSearchConfig, P as DocsMcpConfig, R as DocsObservabilityConfig, _ as DocsAnalyticsConfig, et as DocsSearchSourcePage, gt as OrderingItem } from "./types-DabWZeFx.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/package-version-DQgrHnSb.mjs

@@ -0,0 +1,125 @@
+import { i as detectPackageManagerFromLockfile, l as installCommand, t as detectFramework } from "./utils-TPe8H1P-.mjs";
+import pc from "picocolors";
+import * as p from "@clack/prompts";
+
+//#region src/cli/package-version.ts
+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;
+}
+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 buildDocsPackageInstallCommand(framework, target, pm) {
+	const packagesWithTarget = getPackagesForFramework(framework).map((name) => `${name}@${target}`);
+	return `${installCommand(pm)} ${packagesWithTarget.join(" ")}`;
+}
+function resolveDocsPackageFramework(cwd, rawFramework) {
+	if (rawFramework) {
+		const raw = rawFramework.toLowerCase().trim();
+		const normalized = raw === "nextjs" ? "next" : raw;
+		if (!PRESETS.includes(normalized)) {
+			p.log.error(`Invalid framework ${pc.cyan(rawFramework)}. Use one of: ${PRESETS.map((t) => pc.cyan(t)).join(", ")}`);
+			process.exit(1);
+		}
+		const preset = normalized;
+		return {
+			framework: frameworkFromPreset(preset),
+			preset
+		};
+	}
+	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);
+	}
+	return {
+		framework: detected,
+		preset: presetFromFramework(detected)
+	};
+}
+async function resolveDocsPackageManager(cwd, command) {
+	const detected = detectPackageManagerFromLockfile(cwd);
+	if (detected) {
+		p.log.info(`Detected ${pc.cyan(detected)} from lockfile`);
+		return detected;
+	}
+	const pmAnswer = await p.select({
+		message: `Which package manager do you want to use for this ${command}?`,
+		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)) {
+		const label = command === "upgrade" ? "Upgrade" : "Downgrade";
+		p.outro(pc.red(`${label} cancelled.`));
+		process.exit(0);
+	}
+	const pm = pmAnswer;
+	p.log.info(`Using ${pc.cyan(pm)} as package manager`);
+	return pm;
+}
+
+//#endregion
+export { getPackagesForFramework as a, resolveDocsPackageManager as c, frameworkFromPreset as i, validateUpgradeVersion as l, PRESETS as n, presetFromFramework as o, buildDocsPackageInstallCommand as r, resolveDocsPackageFramework as s, PACKAGES_BY_FRAMEWORK as t };

package/dist/{robots-HU8yTWZv.mjs → robots-DuDAetXn.mjs}

@@ -1,7 +1,7 @@
 import "./agent-BK7q65dn.mjs";
 import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DDrj6Cpo.mjs";
 import { d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-Cio3byUJ.mjs";
-import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
+import { t as detectFramework } from "./utils-TPe8H1P-.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{search-BlXlCmne.d.mts → search-CvfF6EKZ.d.mts}

@@ -1,4 +1,4 @@
-import { B as DocsObservabilityEventInput, Ct as ResolvedDocsRelatedLink, J as DocsSearchConfig, K as DocsSearchAdapterFactory, Nt as TypesenseDocsSearchConfig, Q as DocsSearchResult, R as DocsObservabilityConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, _ as DocsAnalyticsConfig, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-BSnCAFHc.mjs";
+import { B as DocsObservabilityEventInput, Ct as ResolvedDocsRelatedLink, J as DocsSearchConfig, K as DocsSearchAdapterFactory, Nt as TypesenseDocsSearchConfig, Q as DocsSearchResult, R as DocsObservabilityConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, _ as DocsAnalyticsConfig, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-DabWZeFx.mjs";
 
 //#region src/cloud-analytics.d.ts
 interface DocsCloudAnalyticsOptions {

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { A as DocsConfig, B as DocsObservabilityEventInput, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, G as DocsSearchAdapterContext, J as DocsSearchConfig, K as DocsSearchAdapterFactory, O as DocsAskAIFeedbackValue, Q as DocsSearchResult, R as DocsObservabilityConfig, T as DocsAskAIFeedbackConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-BSnCAFHc.mjs";
-import { A as toDocsSitemapMarkdownUrl, B as resolveDocsAnalyticsConfig, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as createDocsAgentTraceContext, H as DocsCloudAnalyticsOptions, I as createDocsAgentTraceId, L as emitDocsAgentTraceEvent, M as DocsAgentTraceContext, N as ResolvedDocsAnalyticsConfig, O as resolveDocsSitemapPageLastmod, P as ResolvedDocsObservabilityConfig, R as emitDocsAnalyticsEvent, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, U as createDocsCloudAnalytics, V as resolveDocsObservabilityConfig, _ as DocsSitemapFormat, a as createMcpSearchAdapter, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as emitDocsObservabilityEvent } from "./search-BlXlCmne.mjs";
+import { A as DocsConfig, B as DocsObservabilityEventInput, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, G as DocsSearchAdapterContext, J as DocsSearchConfig, K as DocsSearchAdapterFactory, O as DocsAskAIFeedbackValue, Q as DocsSearchResult, R as DocsObservabilityConfig, T as DocsAskAIFeedbackConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-DabWZeFx.mjs";
+import { A as toDocsSitemapMarkdownUrl, B as resolveDocsAnalyticsConfig, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as createDocsAgentTraceContext, H as DocsCloudAnalyticsOptions, I as createDocsAgentTraceId, L as emitDocsAgentTraceEvent, M as DocsAgentTraceContext, N as ResolvedDocsAnalyticsConfig, O as resolveDocsSitemapPageLastmod, P as ResolvedDocsObservabilityConfig, R as emitDocsAnalyticsEvent, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, U as createDocsCloudAnalytics, V as resolveDocsObservabilityConfig, _ as DocsSitemapFormat, a as createMcpSearchAdapter, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as emitDocsObservabilityEvent } from "./search-CvfF6EKZ.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts

package/dist/{sitemap-DqzvA3BI.mjs → sitemap-DF2RCPGq.mjs}

@@ -4,7 +4,7 @@ import "./sitemap-server-DJvxOqX2.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
 import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-Cio3byUJ.mjs";
-import { t as detectFramework } from "./utils-AmYxHDoz.mjs";
+import { t as detectFramework } from "./utils-TPe8H1P-.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/upgrade-B1EMfRQJ.mjs

@@ -0,0 +1,51 @@
+import { c as fileExists, o as exec } from "./utils-TPe8H1P-.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-DQgrHnSb.mjs";
+import path from "node:path";
+import pc from "picocolors";
+import * as p from "@clack/prompts";
+
+//#region src/cli/upgrade.ts
+/**
+* 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).
+*/
+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, target, pm) {
+	return buildDocsPackageInstallCommand(framework, target, pm);
+}
+async function upgrade(options = {}) {
+	const cwd = process.cwd();
+	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);
+	}
+	const { framework, preset } = resolveDocsPackageFramework(cwd, options.framework);
+	const pm = await resolveDocsPackageManager(cwd, "upgrade");
+	const cmd = buildUpgradeCommand(framework, target, pm);
+	const packages = getPackagesForFramework(framework);
+	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 ${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));
+		process.exit(1);
+	}
+}
+
+//#endregion
+export { upgrade };

package/dist/{utils-AmYxHDoz.mjs → utils-TPe8H1P-.mjs}

@@ -99,6 +99,20 @@ function exec(command, cwd) {
 	});
 }
 /**
+* Run a shell command synchronously and return stdout.
+*/
+function execOutput(command, cwd) {
+	return execSync(command, {
+		cwd,
+		encoding: "utf-8",
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+}
+/**
 * Spawn a process and wait for a specific string in stdout,
 * then resolve with the child process (still running).
 */
@@ -142,4 +156,4 @@ function spawnAndWaitFor(command, args, cwd, waitFor, timeoutMs = 6e4) {
 }
 
 //#endregion
-export { devInstallCommand as a, installCommand as c, writeFileSafe as d, detectPackageManagerFromLockfile as i, readFileSafe as l, detectGlobalCssFiles as n, exec as o, detectNextAppDir as r, fileExists as s, detectFramework as t, spawnAndWaitFor as u };
+export { devInstallCommand as a, fileExists as c, spawnAndWaitFor as d, writeFileSafe as f, detectPackageManagerFromLockfile as i, installCommand as l, detectGlobalCssFiles as n, exec as o, detectNextAppDir as r, execOutput as s, detectFramework as t, readFileSafe as u };

package/package.json

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

package/dist/upgrade-G2f_v09Z.mjs

@@ -1,154 +0,0 @@
-import { c as installCommand, i as detectPackageManagerFromLockfile, o as exec, s as fileExists, t as detectFramework } from "./utils-AmYxHDoz.mjs";
-import path from "node:path";
-import pc from "picocolors";
-import * as p from "@clack/prompts";
-
-//#region src/cli/upgrade.ts
-/**
-* 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 = [
-	"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];
-}
-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, 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();
-	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);
-	}
-	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, target, pm);
-	const packages = getPackagesForFramework(framework);
-	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 ${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));
-		process.exit(1);
-	}
-}
-
-//#endregion
-export { upgrade };