@farming-labs/docs 0.1.106 → 0.1.108

package/dist/cli/index.mjs

@@ -158,7 +158,7 @@ async function main() {
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-C2Hg1Yz7.mjs");
+		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({
@@ -166,7 +166,7 @@ async function main() {
 			version: typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-BZ6SnqKP.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;

package/dist/{downgrade-C2Hg1Yz7.mjs → downgrade-Bt4yrVyy.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, i as detectPackageManagerFromLockfile, o as exec, s as execOutput, t as detectFramework } from "./utils-TPe8H1P-.mjs";
-import { PRESETS, buildUpgradeCommand, frameworkFromPreset, getPackagesForFramework, presetFromFramework, validateUpgradeVersion } from "./upgrade-BZ6SnqKP.mjs";
+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";
@@ -112,70 +112,7 @@ function fetchPublishedVersions(cwd) {
 	return parsePublishedVersions(execOutput("npm view @farming-labs/docs versions --json", cwd));
 }
 function buildDowngradeCommand(framework, version, pm) {
-	return buildUpgradeCommand(framework, validateUpgradeVersion(version), pm);
-}
-function resolveFramework(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 resolvePackageManager(cwd) {
-	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 downgrade?",
-		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("Downgrade cancelled."));
-		process.exit(0);
-	}
-	const pm = pmAnswer;
-	p.log.info(`Using ${pc.cyan(pm)} as package manager`);
-	return pm;
+	return buildDocsPackageInstallCommand(framework, validateUpgradeVersion(version), pm);
 }
 async function downgrade(options = {}) {
 	const cwd = process.cwd();
@@ -184,7 +121,7 @@ async function downgrade(options = {}) {
 		p.log.error("No package.json found in the current directory. Run this from your project root.");
 		process.exit(1);
 	}
-	const { framework, preset } = resolveFramework(cwd, options.framework);
+	const { framework, preset } = resolveDocsPackageFramework(cwd, options.framework);
 	const packages = getPackagesForFramework(framework);
 	const currentVersion = readCurrentPackageVersion(cwd, packages);
 	if (!currentVersion) {
@@ -224,7 +161,7 @@ async function downgrade(options = {}) {
 		}
 		targetVersion = previousVersion;
 	}
-	const pm = await resolvePackageManager(cwd);
+	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(", ")));

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-fGTXVS-r.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-BjQMhpS-.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/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-fGTXVS-r.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/{search-BjQMhpS-.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-fGTXVS-r.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-fGTXVS-r.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-BjQMhpS-.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/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/package.json

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

package/dist/upgrade-BZ6SnqKP.mjs

@@ -1,154 +0,0 @@
-import { c as fileExists, i as detectPackageManagerFromLockfile, l as installCommand, o as exec, t as detectFramework } from "./utils-TPe8H1P-.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 { PRESETS, buildUpgradeCommand, frameworkFromPreset, getPackagesForFramework, presetFromFramework, upgrade, validateUpgradeVersion };