@farming-labs/docs 0.2.24 → 0.2.25

package/dist/{search-B3JYx2zk.mjs → search-CdUxMazn.mjs}

@@ -1,10 +1,12 @@
+import { $ as resolveDocsAgentsFormat, B as isDocsSkillRequest, F as isDocsAgentDiscoveryRequest, I as isDocsAgentsRequest, X as resolveDocsAgentFeedbackConfig, Z as resolveDocsAgentFeedbackRequest, at as resolveDocsMarkdownRequest, st as resolveDocsSkillFormat, tt as resolveDocsLlmsTxtRequest } from "./agent-DEr3FFdg.mjs";
+
 //#region src/cloud-analytics.ts
 const DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT = "https://api.farming-labs.dev/v1/analytics/events";
 function normalizeRuntimeEnvValue(value) {
 	const normalized = value?.trim();
 	return normalized ? normalized : void 0;
 }
-function readRuntimeEnv(name) {
+function readRuntimeEnv$1(name) {
 	if (typeof process === "undefined" || !process.env) return;
 	switch (name) {
 		case "NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID);
@@ -18,17 +20,17 @@ function readRuntimeEnv(name) {
 		default: return;
 	}
 }
-function isFalsyEnv(value) {
+function isFalsyEnv$1(value) {
 	if (!value) return false;
 	return /^(0|false|no|off)$/i.test(value);
 }
 function resolveDocsCloudAnalyticsOptions(analytics) {
 	if (analytics === false || analytics && typeof analytics === "object" && analytics.enabled === false) return null;
-	const projectId = readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID") ?? readRuntimeEnv("DOCS_CLOUD_PROJECT_ID");
-	const apiKey = readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_KEY");
-	const enabled = readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_ENABLED");
-	const endpoint = readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT;
-	if (isFalsyEnv(enabled)) return null;
+	const projectId = readRuntimeEnv$1("NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID") ?? readRuntimeEnv$1("DOCS_CLOUD_PROJECT_ID");
+	const apiKey = readRuntimeEnv$1("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY") ?? readRuntimeEnv$1("DOCS_CLOUD_ANALYTICS_KEY");
+	const enabled = readRuntimeEnv$1("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED") ?? readRuntimeEnv$1("DOCS_CLOUD_ANALYTICS_ENABLED");
+	const endpoint = readRuntimeEnv$1("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? readRuntimeEnv$1("DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT;
+	if (isFalsyEnv$1(enabled)) return null;
 	if (!projectId) return null;
 	return {
 		endpoint,
@@ -297,6 +299,264 @@ async function emitDocsAgentTraceEvent(observability, event) {
 	});
 }
 
+//#endregion
+//#region src/telemetry.ts
+const DOCS_PACKAGE_NAME = "@farming-labs/docs";
+const DOCS_PACKAGE_VERSION = "0.2.24";
+const DEFAULT_DOCS_TELEMETRY_ENDPOINT = "https://docs.farming-labs.dev/api/telemetry/events";
+const PROJECT_TELEMETRY_CACHE_TTL_MS = 1440 * 60 * 1e3;
+const PROJECT_TELEMETRY_CACHE_MAX_KEYS = 256;
+function getRuntimeEnv() {
+	if (typeof process === "undefined" || !process.env) return;
+	return process.env;
+}
+function readRuntimeEnv(name) {
+	const value = getRuntimeEnv()?.[name]?.trim();
+	return value ? value : void 0;
+}
+function isTruthyEnv(value) {
+	return /^(1|true|yes|on)$/i.test(value ?? "");
+}
+function isFalsyEnv(value) {
+	return /^(0|false|no|off)$/i.test(value ?? "");
+}
+function isBrowserRuntime() {
+	return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function isProductionTelemetryRuntime() {
+	if (isBrowserRuntime()) return false;
+	const env = getRuntimeEnv();
+	if (!env) return true;
+	if (env.NODE_ENV === "test") return false;
+	if (env.VERCEL_ENV === "production") return true;
+	if (env.CONTEXT === "production" && isTruthyEnv(env.NETLIFY)) return true;
+	if (isTruthyEnv(env.CF_PAGES)) return true;
+	if (env.RENDER_SERVICE_ID || env.FLY_APP_NAME || env.RAILWAY_ENVIRONMENT) return true;
+	return env.NODE_ENV === "production";
+}
+function resolveDocsTelemetryConfig(telemetry) {
+	const envToggle = readRuntimeEnv("DOCS_TELEMETRY");
+	const envDisabled = readRuntimeEnv("DOCS_TELEMETRY_DISABLED");
+	if (isFalsyEnv(envToggle) || isTruthyEnv(envDisabled) || telemetry === false) return { enabled: false };
+	const objectConfig = telemetry && typeof telemetry === "object" ? telemetry : void 0;
+	if (objectConfig?.enabled === false) return { enabled: false };
+	return {
+		enabled: telemetry === true || objectConfig?.enabled === true || isTruthyEnv(envToggle) || isProductionTelemetryRuntime(),
+		endpoint: objectConfig?.endpoint?.trim() || readRuntimeEnv("DOCS_TELEMETRY_ENDPOINT") || DEFAULT_DOCS_TELEMETRY_ENDPOINT
+	};
+}
+function readRequestOrigin(request) {
+	if (!request?.url) return void 0;
+	try {
+		return new URL(request.url).origin;
+	} catch {
+		return;
+	}
+}
+function readDeploymentOrigin() {
+	const candidates = [
+		readRuntimeEnv("DOCS_SITE_URL"),
+		readRuntimeEnv("NEXT_PUBLIC_SITE_URL"),
+		readRuntimeEnv("SITE_URL"),
+		readRuntimeEnv("URL"),
+		readRuntimeEnv("CF_PAGES_URL"),
+		readRuntimeEnv("VERCEL_PROJECT_PRODUCTION_URL"),
+		readRuntimeEnv("VERCEL_URL"),
+		readRuntimeEnv("DEPLOY_PRIME_URL")
+	];
+	for (const candidate of candidates) {
+		if (!candidate) continue;
+		try {
+			const withProtocol = /^https?:\/\//i.test(candidate) ? candidate : `https://${candidate}`;
+			return new URL(withProtocol).origin;
+		} catch {}
+	}
+}
+function detectDeployment() {
+	const env = getRuntimeEnv();
+	if (!env) return void 0;
+	if (env.VERCEL || env.VERCEL_ENV) return {
+		provider: "vercel",
+		environment: env.VERCEL_ENV,
+		id: env.VERCEL_DEPLOYMENT_ID ?? env.VERCEL_GIT_COMMIT_SHA,
+		region: env.VERCEL_REGION
+	};
+	if (env.NETLIFY) return {
+		provider: "netlify",
+		environment: env.CONTEXT,
+		id: env.DEPLOY_ID ?? env.COMMIT_REF
+	};
+	if (env.CF_PAGES) return {
+		provider: "cloudflare-pages",
+		environment: env.CF_PAGES_BRANCH,
+		id: env.CF_PAGES_COMMIT_SHA
+	};
+	if (env.RENDER_SERVICE_ID) return {
+		provider: "render",
+		environment: env.RENDER_ENV,
+		id: env.RENDER_SERVICE_ID
+	};
+	if (env.FLY_APP_NAME) return {
+		provider: "fly",
+		environment: env.FLY_APP_NAME,
+		id: env.FLY_ALLOC_ID,
+		region: env.FLY_REGION
+	};
+	if (env.RAILWAY_ENVIRONMENT) return {
+		provider: "railway",
+		environment: env.RAILWAY_ENVIRONMENT,
+		id: env.RAILWAY_DEPLOYMENT_ID
+	};
+	return env.NODE_ENV === "production" ? { environment: "production" } : void 0;
+}
+function detectRuntime() {
+	if (typeof process !== "undefined" && process.versions?.node) return {
+		name: "node",
+		version: process.versions.node
+	};
+	if (typeof navigator !== "undefined" && navigator.userAgent) return { name: "web-standard" };
+}
+function isObjectConfigEnabled(value, defaultEnabled) {
+	if (value === false) return false;
+	if (value === true) return true;
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const enabled = value.enabled;
+		return enabled === false ? false : defaultEnabled || enabled === true;
+	}
+	return defaultEnabled;
+}
+function hasObjectConfig(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function getDocsTelemetryFeatures(config) {
+	const pageActions = config.pageActions;
+	const feedback = config.feedback;
+	return {
+		search: isObjectConfigEnabled(config.search, true),
+		ai: isObjectConfigEnabled(config.ai, false),
+		mcp: isObjectConfigEnabled(config.mcp, true),
+		llmsTxt: isObjectConfigEnabled(config.llmsTxt, true),
+		pageActions: hasObjectConfig(pageActions),
+		feedback: feedback === true || hasObjectConfig(feedback) && feedback.enabled !== false,
+		agentFeedback: feedback !== false && !(hasObjectConfig(feedback) && feedback.agent === false) && !(hasObjectConfig(feedback) && hasObjectConfig(feedback.agent) && feedback.agent.enabled === false),
+		sitemap: isObjectConfigEnabled(config.sitemap, true),
+		robots: isObjectConfigEnabled(config.robots, true),
+		apiReference: isObjectConfigEnabled(config.apiReference, false),
+		staticExport: config.staticExport === true,
+		changelog: isObjectConfigEnabled(config.changelog, false),
+		cloud: typeof config.cloud !== "undefined" && isObjectConfigEnabled(config.cloud, true),
+		review: isObjectConfigEnabled(config.review, true),
+		codeBlocksValidate: hasObjectConfig(config.codeBlocks) && Boolean(config.codeBlocks.validate)
+	};
+}
+function createDocsTelemetryEvent(config, input, context = {}) {
+	const siteOrigin = context.siteOrigin ?? input.site?.origin ?? readRequestOrigin(context.request) ?? readDeploymentOrigin();
+	const deployment = input.deployment ?? detectDeployment();
+	const properties = context.properties || input.properties ? {
+		...input.properties ?? {},
+		...context.properties ?? {}
+	} : void 0;
+	return {
+		...input,
+		timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+		package: {
+			name: DOCS_PACKAGE_NAME,
+			version: DOCS_PACKAGE_VERSION,
+			...input.package
+		},
+		framework: input.framework ?? context.framework,
+		runtime: input.runtime ?? detectRuntime(),
+		site: siteOrigin ? { origin: siteOrigin } : input.site,
+		deployment,
+		features: input.features ?? getDocsTelemetryFeatures(config),
+		properties
+	};
+}
+function projectEventKey(event) {
+	return [
+		event.package.name,
+		event.package.version,
+		event.framework ?? "",
+		event.site?.origin ?? "",
+		event.deployment?.provider ?? "",
+		event.deployment?.environment ?? "",
+		event.deployment?.id ?? ""
+	].join("|");
+}
+function getSentProjectKeys() {
+	const globalValue = globalThis;
+	globalValue.__farmingLabsDocsTelemetryProjectKeys__ ??= /* @__PURE__ */ new Map();
+	return globalValue.__farmingLabsDocsTelemetryProjectKeys__;
+}
+function pruneSentProjectKeys(sent, now) {
+	for (const [key, expiresAt] of sent) if (expiresAt <= now) sent.delete(key);
+	while (sent.size >= PROJECT_TELEMETRY_CACHE_MAX_KEYS) {
+		const oldestKey = sent.keys().next().value;
+		if (!oldestKey) return;
+		sent.delete(oldestKey);
+	}
+}
+async function emitDocsTelemetryEvent(telemetry, event) {
+	const resolved = resolveDocsTelemetryConfig(telemetry);
+	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function") return;
+	try {
+		const ingestKey = readRuntimeEnv("DOCS_TELEMETRY_INGEST_KEY");
+		const headers = { "content-type": "application/json" };
+		if (ingestKey) headers["x-docs-telemetry-key"] = ingestKey;
+		await fetch(resolved.endpoint, {
+			method: "POST",
+			headers,
+			body: JSON.stringify({ event }),
+			keepalive: true
+		});
+	} catch {}
+}
+function emitDocsTelemetryProjectEvent(config, context = {}) {
+	const event = createDocsTelemetryEvent(config, { type: "project_detected" }, context);
+	const key = projectEventKey(event);
+	const sent = getSentProjectKeys();
+	const now = Date.now();
+	const expiresAt = sent.get(key);
+	if (expiresAt && expiresAt > now) return;
+	if (typeof expiresAt === "number") sent.delete(key);
+	pruneSentProjectKeys(sent, now);
+	sent.set(key, now + PROJECT_TELEMETRY_CACHE_TTL_MS);
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function emitDocsTelemetryAgentSurfaceEvent(config, context) {
+	const event = createDocsTelemetryEvent(config, {
+		type: context.surface === "mcp" ? "mcp_request" : "agent_surface_used",
+		properties: { surface: context.surface }
+	}, context);
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function emitDocsTelemetryMcpToolEvent(config, context) {
+	const event = createDocsTelemetryEvent(config, {
+		type: "mcp_tool_used",
+		properties: {
+			tool: context.tool,
+			locale: context.locale,
+			resultCount: context.resultCount
+		}
+	}, context);
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function inferDocsTelemetryAgentSurface(request, options) {
+	const url = new URL(request.url);
+	const method = request.method.toUpperCase();
+	const feedbackRequest = resolveDocsAgentFeedbackRequest(url, resolveDocsAgentFeedbackConfig(options.feedback));
+	if ((method === "GET" || method === "HEAD") && isDocsAgentDiscoveryRequest(url)) return "agent_spec";
+	if ((method === "GET" || method === "HEAD") && feedbackRequest?.kind === "schema") return "agent_feedback_schema";
+	if (method === "POST" && feedbackRequest?.kind === "submit") return "agent_feedback_submit";
+	if (method === "GET" || method === "HEAD") {
+		if (isDocsAgentsRequest(url) || resolveDocsAgentsFormat(url) === "agents") return "agents";
+		if (isDocsSkillRequest(url) || resolveDocsSkillFormat(url) === "skill") return "skill";
+		if (resolveDocsMarkdownRequest(options.entry, url, request)) return "markdown";
+		if (resolveDocsLlmsTxtRequest(url, options.llmsTxt, options.entry)) return "llms";
+	}
+	if (method === "POST") return "ask_ai";
+}
+
 //#endregion
 //#region src/sidebar.ts
 function resolvePageSidebarFolderIndexBehavior(sidebar) {
@@ -1428,4 +1688,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { getDocsRequestAnalyticsProperties as A, resolveSidebarFolderIndexBehaviorForPath as C, emitDocsAgentTraceEvent as D, createDocsAgentTraceId as E, resolveDocsObservabilityConfig as M, emitDocsAnalyticsEvent as O, resolveSidebarFolderIndexBehavior as S, createDocsAgentTraceContext as T, parseGeneratedAgentDocument as _, createMcpSearchAdapter as a, applySidebarFolderIndexBehavior as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveSearchRequestConfig as f, normalizeGeneratedAgentContent as g, hashGeneratedAgentContent as h, createCustomSearchAdapter as i, resolveDocsAnalyticsConfig as j, emitDocsObservabilityEvent as k, inferDocsAskAIPackageHints as l, GENERATED_AGENT_PROVENANCE_VERSION as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, GENERATED_AGENT_PROVENANCE_MARKER as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, serializeGeneratedAgentDocument as v, DOCS_AGENT_TRACE_EVENT_TYPES as w, resolvePageSidebarFolderIndexBehavior as x, stripGeneratedAgentProvenance as y };
+export { resolveDocsTelemetryConfig as A, resolveSidebarFolderIndexBehaviorForPath as C, emitDocsTelemetryProjectEvent as D, emitDocsTelemetryMcpToolEvent as E, emitDocsAnalyticsEvent as F, emitDocsObservabilityEvent as I, getDocsRequestAnalyticsProperties as L, createDocsAgentTraceContext as M, createDocsAgentTraceId as N, getDocsTelemetryFeatures as O, emitDocsAgentTraceEvent as P, resolveDocsAnalyticsConfig as R, resolveSidebarFolderIndexBehavior as S, emitDocsTelemetryEvent as T, parseGeneratedAgentDocument as _, createMcpSearchAdapter as a, applySidebarFolderIndexBehavior as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveSearchRequestConfig as f, normalizeGeneratedAgentContent as g, hashGeneratedAgentContent as h, createCustomSearchAdapter as i, DOCS_AGENT_TRACE_EVENT_TYPES as j, inferDocsTelemetryAgentSurface as k, inferDocsAskAIPackageHints as l, GENERATED_AGENT_PROVENANCE_VERSION as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, GENERATED_AGENT_PROVENANCE_MARKER as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, serializeGeneratedAgentDocument as v, emitDocsTelemetryAgentSurfaceEvent as w, resolvePageSidebarFolderIndexBehavior as x, stripGeneratedAgentProvenance as y, resolveDocsObservabilityConfig as z };

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsObservabilityEvent, A as DocsAskAIMcpConfig, D as DocsAskAIFeedbackData, E as DocsAskAIFeedbackConfig, O as DocsAskAIFeedbackMessage, Q as DocsObservabilityConfig, W as DocsConfig, _ as DocsAgentTraceStatus, _t as DocsSearchQuery, a as ApiReferenceRenderer, at as DocsReviewRulesConfig, b as DocsAnalyticsEventInput, bt as DocsSearchSourcePage, dt as DocsSearchAdapterContext, et as DocsObservabilityEventInput, ft as DocsSearchAdapterFactory, g as DocsAgentTraceEventType, h as DocsAgentTraceEventInput, ht as DocsSearchDocument, it as DocsReviewConfig, jt as McpDocsSearchConfig, k as DocsAskAIFeedbackValue, mt as DocsSearchConfig, rt as DocsReviewCiMode, ut as DocsSearchAdapter, v as DocsAnalyticsConfig, vt as DocsSearchResult, xt as DocsSitemapConfig, y as DocsAnalyticsEvent } from "./types-BCEobEGw.mjs";
-import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as resolveDocsObservabilityConfig, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsAnalyticsConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as getDocsRequestAnalyticsProperties, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-D-iBv3VC.mjs";
+import { $ as DocsObservabilityEvent, A as DocsAskAIMcpConfig, D as DocsAskAIFeedbackData, E as DocsAskAIFeedbackConfig, O as DocsAskAIFeedbackMessage, Q as DocsObservabilityConfig, Rt as McpDocsSearchConfig, W as DocsConfig, _ as DocsAgentTraceStatus, _t as DocsSearchQuery, a as ApiReferenceRenderer, at as DocsReviewRulesConfig, b as DocsAnalyticsEventInput, bt as DocsSearchSourcePage, dt as DocsSearchAdapterContext, et as DocsObservabilityEventInput, ft as DocsSearchAdapterFactory, g as DocsAgentTraceEventType, h as DocsAgentTraceEventInput, ht as DocsSearchDocument, it as DocsReviewConfig, k as DocsAskAIFeedbackValue, mt as DocsSearchConfig, rt as DocsReviewCiMode, ut as DocsSearchAdapter, v as DocsAnalyticsConfig, vt as DocsSearchResult, xt as DocsSitemapConfig, y as DocsAnalyticsEvent } from "./types-CtF_65E4.mjs";
+import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as resolveDocsObservabilityConfig, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsAnalyticsConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as getDocsRequestAnalyticsProperties, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-CLP7-Z9w.mjs";
 import { DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/code-group-mdx.d.ts

package/dist/server.mjs

@@ -1,7 +1,7 @@
-import { A as getDocsRequestAnalyticsProperties, D as emitDocsAgentTraceEvent, E as createDocsAgentTraceId, M as resolveDocsObservabilityConfig, O as emitDocsAnalyticsEvent, T as createDocsAgentTraceContext, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as resolveDocsAnalyticsConfig, k as emitDocsObservabilityEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, w as DOCS_AGENT_TRACE_EVENT_TYPES } from "./search-B3JYx2zk.mjs";
-import { a as DEFAULT_SITEMAP_XML_ROUTE, c as readDocsSitemapManifestFromContentMap, d as resolveDocsSitemapConfig, f as resolveDocsSitemapPageLastmod, i as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, l as renderDocsSitemapMarkdown, m as toDocsSitemapMarkdownUrl, n as DEFAULT_SITEMAP_MD_DOCS_ROUTE, o as buildDocsSitemapManifest, p as resolveDocsSitemapRequest, r as DEFAULT_SITEMAP_MD_ROUTE, s as createDocsSitemapResponse, t as DEFAULT_SITEMAP_MANIFEST_PATH, u as renderDocsSitemapXml } from "./sitemap-CMNj0Pt3.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-CVSQQszk.mjs";
-import { a as ensureDocsReviewWorkflow, i as buildDocsReviewWorkflowPathFilters, n as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, o as readDocsReviewConfigFromSource, r as buildDocsReviewWorkflow, s as resolveDocsReviewConfig, t as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD } from "./review-B7goPYUb.mjs";
+import { F as emitDocsAnalyticsEvent, I as emitDocsObservabilityEvent, L as getDocsRequestAnalyticsProperties, M as createDocsAgentTraceContext, N as createDocsAgentTraceId, P as emitDocsAgentTraceEvent, R as resolveDocsAnalyticsConfig, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as DOCS_AGENT_TRACE_EVENT_TYPES, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, z as resolveDocsObservabilityConfig } from "./search-CdUxMazn.mjs";
+import { Ct as resolveDocsSitemapRequest, St as resolveDocsSitemapPageLastmod, _t as createDocsSitemapResponse, bt as renderDocsSitemapXml, dt as DEFAULT_SITEMAP_MANIFEST_PATH, ft as DEFAULT_SITEMAP_MD_DOCS_ROUTE, gt as buildDocsSitemapManifest, ht as DEFAULT_SITEMAP_XML_ROUTE, mt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, pt as DEFAULT_SITEMAP_MD_ROUTE, vt as readDocsSitemapManifestFromContentMap, wt as toDocsSitemapMarkdownUrl, xt as resolveDocsSitemapConfig, yt as renderDocsSitemapMarkdown } from "./agent-DEr3FFdg.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-RZG9eOJB.mjs";
+import { a as ensureDocsReviewWorkflow, i as buildDocsReviewWorkflowPathFilters, n as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, o as readDocsReviewConfigFromSource, r as buildDocsReviewWorkflow, s as resolveDocsReviewConfig, t as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD } from "./review-CJD85JTm.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/{sitemap-BfViRvLP.mjs → sitemap-BSv5EDeM.mjs}

@@ -1,9 +1,10 @@
-import { d as resolveDocsSitemapConfig, l as renderDocsSitemapMarkdown, o as buildDocsSitemapManifest, u as renderDocsSitemapXml } from "./sitemap-CMNj0Pt3.mjs";
-import "./sitemap-server-CVSQQszk.mjs";
+import "./search-CdUxMazn.mjs";
+import { bt as renderDocsSitemapXml, gt as buildDocsSitemapManifest, xt as resolveDocsSitemapConfig, yt as renderDocsSitemapMarkdown } from "./agent-DEr3FFdg.mjs";
+import "./sitemap-server-RZG9eOJB.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-rHQQuz98.mjs";
-import { t as detectFramework } from "./utils-CGlOADu1.mjs";
+import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-De5z-2LK.mjs";
+import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{sitemap-server-CVSQQszk.mjs → sitemap-server-RZG9eOJB.mjs}

@@ -1,4 +1,4 @@
-import { d as resolveDocsSitemapConfig } from "./sitemap-CMNj0Pt3.mjs";
+import { xt as resolveDocsSitemapConfig } from "./agent-DEr3FFdg.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import path, { basename, join, relative } from "node:path";

package/dist/{types-BCEobEGw.d.mts → types-CtF_65E4.d.mts}

@@ -767,6 +767,64 @@ interface DocsAnalyticsConfig {
   /** Callback fired for every emitted event. */
   onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
 }
+type DocsTelemetryFramework = "next" | "tanstack-start" | "sveltekit" | "astro" | "nuxt" | "mcp" | (string & {});
+type DocsTelemetryEventType = "project_detected" | "agent_surface_used" | "mcp_request" | "mcp_tool_used" | (string & {});
+type DocsTelemetryAgentSurface = "agent_spec" | "agents" | "skill" | "markdown" | "llms" | "agent_feedback_schema" | "agent_feedback_submit" | "ask_ai" | "mcp";
+interface DocsTelemetryConfig {
+  /** Enable Farming Labs maintainer telemetry. Defaults to production-only enabled. */
+  enabled?: boolean;
+  /**
+   * Override the telemetry ingestion endpoint.
+   *
+   * This is mostly useful for self-hosting, development verification, or tests.
+   */
+  endpoint?: string;
+}
+interface DocsTelemetryFeatures {
+  search: boolean;
+  ai: boolean;
+  mcp: boolean;
+  llmsTxt: boolean;
+  pageActions: boolean;
+  feedback: boolean;
+  agentFeedback: boolean;
+  sitemap: boolean;
+  robots: boolean;
+  apiReference: boolean;
+  staticExport: boolean;
+  changelog: boolean;
+  cloud: boolean;
+  review: boolean;
+  codeBlocksValidate: boolean;
+}
+interface DocsTelemetryEvent {
+  type: DocsTelemetryEventType;
+  timestamp: string;
+  package: {
+    name: "@farming-labs/docs";
+    version?: string;
+  };
+  framework?: DocsTelemetryFramework;
+  runtime?: {
+    name?: string;
+    version?: string;
+  };
+  site?: {
+    origin?: string;
+  };
+  deployment?: {
+    provider?: string;
+    environment?: string;
+    id?: string;
+    region?: string;
+  };
+  features?: Partial<DocsTelemetryFeatures>;
+  properties?: Record<string, unknown>;
+}
+type DocsTelemetryEventInput = Omit<DocsTelemetryEvent, "timestamp" | "package"> & {
+  timestamp?: string;
+  package?: Partial<DocsTelemetryEvent["package"]>;
+};
 interface DocsCloudApiKeyConfig {
   /**
    * Environment variable that stores the Docs Cloud API key.
@@ -2414,6 +2472,16 @@ interface DocsConfig {
    * included unless `includeInputs: true` is set.
    */
   analytics?: boolean | DocsAnalyticsConfig;
+  /**
+   * Farming Labs maintainer telemetry for production adoption and coarse
+   * agent-optimized feature usage.
+   *
+   * This is separate from project-owned `analytics`. It avoids visitor
+   * identities, page views, raw inputs, docs content, cookies, and per-user
+   * sessions. Disable with `telemetry: false`, `DOCS_TELEMETRY=false`, or
+   * `DOCS_TELEMETRY_DISABLED=1`.
+   */
+  telemetry?: boolean | DocsTelemetryConfig;
   /**
    * Docs Cloud integration settings.
    *
@@ -2866,4 +2934,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsObservabilityEvent as $, SidebarPageNode as $t, DocsAskAIMcpConfig as A, LlmsTxtSectionConfig as At, DocsCodeBlocksRunnerProvider as B, PageActionsConfig as Bt, DocsAnalyticsSource as C, FeedbackConfig as Ct, DocsAskAIFeedbackData as D, LlmsTxtConfig as Dt, DocsAskAIFeedbackConfig as E, LastUpdatedConfig as Et, DocsCloudPublishConfig as F, OpenDocsProviderConfig as Ft, DocsFeedbackData as G, ReadingTimeConfig as Gt, DocsCodeBlocksValidationMode as H, PageOpenGraph as Ht, DocsCodeBlocksConfig as I, OpenDocsProviderId as It, DocsMcpConfig as J, SidebarComponentProps as Jt, DocsFeedbackValue as K, ReadingTimeFormat as Kt, DocsCodeBlocksPlannerConfig as L, OpenDocsTarget as Lt, DocsCloudConfig as M, OGConfig as Mt, DocsCloudFeatureConfig as N, OpenDocsConfig as Nt, DocsAskAIFeedbackMessage as O, LlmsTxtMaxCharsConfig as Ot, DocsCloudPreviewConfig as P, OpenDocsProvider as Pt, DocsObservabilityConfig as Q, SidebarNode as Qt, DocsCodeBlocksPlannerProvider as R, OpenGraphImage as Rt, DocsAnalyticsInput as S, DocsTheme as St, DocsAskAIActionType as T, GithubConfig as Tt, DocsCodeBlocksValidationPolicy as U, PageSidebarFrontmatter as Ut, DocsCodeBlocksValidateConfig as V, PageFrontmatter as Vt, DocsConfig as W, PageTwitter as Wt, DocsMetadata as X, SidebarFolderIndexBehavior as Xt, DocsMcpToolsConfig as Y, SidebarConfig as Yt, DocsNav as Z, SidebarFolderNode as Zt, DocsAgentTraceStatus as _, DocsSearchQuery as _t, ApiReferenceRenderer as a, UIConfig as an, DocsReviewRulesConfig as at, DocsAnalyticsEventInput as b, DocsSearchSourcePage as bt, ChangelogFrontmatter as c, DocsRobotsConfig as ct, CopyMarkdownFormat as d, DocsSearchAdapterContext as dt, SidebarTree as en, DocsObservabilityEventInput as et, CustomDocsSearchConfig as f, DocsSearchAdapterFactory as ft, DocsAgentTraceEventType as g, DocsSearchEmbeddingsConfig as gt, DocsAgentTraceEventInput as h, DocsSearchDocument as ht, ApiReferenceConfig as i, TypographyConfig as in, DocsReviewConfig as it, DocsCloudApiKeyConfig as j, McpDocsSearchConfig as jt, DocsAskAIFeedbackValue as k, LlmsTxtMaxCharsMode as kt, CodeBlockCopyData as l, DocsRobotsRule as lt, DocsAgentFeedbackData as m, DocsSearchConfig as mt, AgentFeedbackConfig as n, ThemeToggleConfig as nn, DocsReviewCiConfig as nt, BreadcrumbConfig as o, DocsReviewScoreConfig as ot, DocsAgentFeedbackContext as p, DocsSearchChunkingConfig as pt, DocsI18nConfig as q, ResolvedDocsRelatedLink as qt, AlgoliaDocsSearchConfig as r, TypesenseDocsSearchConfig as rn, DocsReviewCiMode as rt, ChangelogConfig as s, DocsReviewSeverity as st, AIConfig as t, SimpleDocsSearchConfig as tn, DocsRelatedItem as tt, CopyMarkdownConfig as u, DocsSearchAdapter as ut, DocsAnalyticsConfig as v, DocsSearchResult as vt, DocsAskAIActionData as w, FontStyle as wt, DocsAnalyticsEventType as x, DocsSitemapConfig as xt, DocsAnalyticsEvent as y, DocsSearchResultType as yt, DocsCodeBlocksRunnerConfig as z, OrderingItem as zt };
+export { DocsObservabilityEvent as $, ReadingTimeFormat as $t, DocsAskAIMcpConfig as A, FeedbackConfig as At, DocsCodeBlocksRunnerProvider as B, OpenDocsConfig as Bt, DocsAnalyticsSource as C, DocsTelemetryConfig as Ct, DocsAskAIFeedbackData as D, DocsTelemetryFeatures as Dt, DocsAskAIFeedbackConfig as E, DocsTelemetryEventType as Et, DocsCloudPublishConfig as F, LlmsTxtMaxCharsConfig as Ft, DocsFeedbackData as G, OpenGraphImage as Gt, DocsCodeBlocksValidationMode as H, OpenDocsProviderConfig as Ht, DocsCodeBlocksConfig as I, LlmsTxtMaxCharsMode as It, DocsMcpConfig as J, PageFrontmatter as Jt, DocsFeedbackValue as K, OrderingItem as Kt, DocsCodeBlocksPlannerConfig as L, LlmsTxtSectionConfig as Lt, DocsCloudConfig as M, GithubConfig as Mt, DocsCloudFeatureConfig as N, LastUpdatedConfig as Nt, DocsAskAIFeedbackMessage as O, DocsTelemetryFramework as Ot, DocsCloudPreviewConfig as P, LlmsTxtConfig as Pt, DocsObservabilityConfig as Q, ReadingTimeConfig as Qt, DocsCodeBlocksPlannerProvider as R, McpDocsSearchConfig as Rt, DocsAnalyticsInput as S, DocsTelemetryAgentSurface as St, DocsAskAIActionType as T, DocsTelemetryEventInput as Tt, DocsCodeBlocksValidationPolicy as U, OpenDocsProviderId as Ut, DocsCodeBlocksValidateConfig as V, OpenDocsProvider as Vt, DocsConfig as W, OpenDocsTarget as Wt, DocsMetadata as X, PageSidebarFrontmatter as Xt, DocsMcpToolsConfig as Y, PageOpenGraph as Yt, DocsNav as Z, PageTwitter as Zt, DocsAgentTraceStatus as _, DocsSearchQuery as _t, ApiReferenceRenderer as a, SidebarNode as an, DocsReviewRulesConfig as at, DocsAnalyticsEventInput as b, DocsSearchSourcePage as bt, ChangelogFrontmatter as c, SimpleDocsSearchConfig as cn, DocsRobotsConfig as ct, CopyMarkdownFormat as d, TypographyConfig as dn, DocsSearchAdapterContext as dt, ResolvedDocsRelatedLink as en, DocsObservabilityEventInput as et, CustomDocsSearchConfig as f, UIConfig as fn, DocsSearchAdapterFactory as ft, DocsAgentTraceEventType as g, DocsSearchEmbeddingsConfig as gt, DocsAgentTraceEventInput as h, DocsSearchDocument as ht, ApiReferenceConfig as i, SidebarFolderNode as in, DocsReviewConfig as it, DocsCloudApiKeyConfig as j, FontStyle as jt, DocsAskAIFeedbackValue as k, DocsTheme as kt, CodeBlockCopyData as l, ThemeToggleConfig as ln, DocsRobotsRule as lt, DocsAgentFeedbackData as m, DocsSearchConfig as mt, AgentFeedbackConfig as n, SidebarConfig as nn, DocsReviewCiConfig as nt, BreadcrumbConfig as o, SidebarPageNode as on, DocsReviewScoreConfig as ot, DocsAgentFeedbackContext as p, DocsSearchChunkingConfig as pt, DocsI18nConfig as q, PageActionsConfig as qt, AlgoliaDocsSearchConfig as r, SidebarFolderIndexBehavior as rn, DocsReviewCiMode as rt, ChangelogConfig as s, SidebarTree as sn, DocsReviewSeverity as st, AIConfig as t, SidebarComponentProps as tn, DocsRelatedItem as tt, CopyMarkdownConfig as u, TypesenseDocsSearchConfig as un, DocsSearchAdapter as ut, DocsAnalyticsConfig as v, DocsSearchResult as vt, DocsAskAIActionData as w, DocsTelemetryEvent as wt, DocsAnalyticsEventType as x, DocsSitemapConfig as xt, DocsAnalyticsEvent as y, DocsSearchResultType as yt, DocsCodeBlocksRunnerConfig as z, OGConfig as zt };

package/dist/{upgrade-C1nInojy.mjs → upgrade-Dzej61y4.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-CGlOADu1.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-DMFdOnyC.mjs";
+import { c as fileExists, o as exec } from "./utils-CoHZJ1i4.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-CeNAB4NZ.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/dist/{utils-CGlOADu1.mjs → utils-CoHZJ1i4.mjs}

@@ -18,13 +18,79 @@ function detectFramework(cwd) {
 	if (allDeps["nuxt"]) return "nuxt";
 	return null;
 }
-function detectPackageManagerFromLockfile(cwd) {
-	if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-	if (fs.existsSync(path.join(cwd, "bun.lockb")) || fs.existsSync(path.join(cwd, "bun.lock"))) return "bun";
-	if (fs.existsSync(path.join(cwd, "yarn.lock"))) return "yarn";
-	if (fs.existsSync(path.join(cwd, "package-lock.json"))) return "npm";
+const PACKAGE_MANAGER_LOCKFILES = [
+	{
+		fileName: "pnpm-lock.yaml",
+		packageManager: "pnpm"
+	},
+	{
+		fileName: "bun.lockb",
+		packageManager: "bun"
+	},
+	{
+		fileName: "bun.lock",
+		packageManager: "bun"
+	},
+	{
+		fileName: "yarn.lock",
+		packageManager: "yarn"
+	},
+	{
+		fileName: "package-lock.json",
+		packageManager: "npm"
+	}
+];
+function readPackageManagerName(value) {
+	if (typeof value !== "string") return null;
+	const name = value.trim().split("@")[0];
+	if (name === "pnpm" || name === "yarn" || name === "npm" || name === "bun") return name;
+	return null;
+}
+function detectPackageManagerLockfileInDirectory(directory) {
+	for (const { fileName, packageManager } of PACKAGE_MANAGER_LOCKFILES) {
+		const filePath = path.join(directory, fileName);
+		if (fs.existsSync(filePath)) return {
+			packageManager,
+			directory,
+			filePath,
+			source: "lockfile"
+		};
+	}
 	return null;
 }
+function detectPackageManagerInDirectory(directory) {
+	const lockfile = detectPackageManagerLockfileInDirectory(directory);
+	if (lockfile) return lockfile;
+	const packageJsonPath = path.join(directory, "package.json");
+	if (!fs.existsSync(packageJsonPath)) return null;
+	try {
+		const packageManager = readPackageManagerName(JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")).packageManager);
+		if (!packageManager) return null;
+		return {
+			packageManager,
+			directory,
+			filePath: packageJsonPath,
+			source: "packageManager"
+		};
+	} catch {
+		return null;
+	}
+}
+function detectPackageManagerFromProject(cwd) {
+	let current = path.resolve(cwd);
+	while (true) {
+		const detected = detectPackageManagerInDirectory(current);
+		if (detected) return detected;
+		const parent = path.dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+}
+function formatPackageManagerDetection(cwd, detection) {
+	const displayPath = path.relative(path.resolve(cwd), detection.filePath) || path.basename(detection.filePath);
+	if (detection.source === "packageManager") return `packageManager in ${displayPath}`;
+	return displayPath;
+}
 function installCommand(pm) {
 	return pm === "yarn" ? "yarn add" : `${pm} add`;
 }
@@ -156,4 +222,4 @@ function spawnAndWaitFor(command, args, cwd, waitFor, timeoutMs = 6e4) {
 }
 
 //#endregion
-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 };
+export { devInstallCommand as a, fileExists as c, readFileSafe as d, spawnAndWaitFor as f, detectPackageManagerFromProject as i, formatPackageManagerDetection as l, detectGlobalCssFiles as n, exec as o, writeFileSafe as p, detectNextAppDir as r, execOutput as s, detectFramework as t, installCommand as u };

package/package.json

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

package/dist/related-BNj_NdHq.mjs

@@ -1,50 +0,0 @@
-//#region src/related.ts
-function normalizeDocsRelated(value) {
-	if (!Array.isArray(value)) return [];
-	const seen = /* @__PURE__ */ new Set();
-	const links = [];
-	for (const item of value) {
-		const parsed = parseRelatedInput(item);
-		if (!parsed) continue;
-		const dedupeKey = normalizeRelatedLookupPath(parsed.href) ?? parsed.href;
-		if (seen.has(dedupeKey)) continue;
-		seen.add(dedupeKey);
-		links.push({ href: parsed.href });
-	}
-	return links;
-}
-function renderDocsRelatedMarkdownLines(related) {
-	if (!related?.length) return [];
-	return [`Related: ${related.map((link) => normalizeInlineText(link.href)).join(", ")}`];
-}
-function parseRelatedInput(value) {
-	if (typeof value === "string") {
-		const href = cleanString(value);
-		return href ? { href } : null;
-	}
-	return null;
-}
-function cleanString(value) {
-	if (typeof value !== "string") return void 0;
-	return value.trim() || void 0;
-}
-function normalizeRelatedLookupPath(value) {
-	const trimmed = value.trim();
-	if (!trimmed) return null;
-	let pathname = trimmed;
-	try {
-		pathname = new URL(trimmed, "https://docs.local").pathname;
-	} catch {
-		pathname = trimmed.split(/[?#]/, 1)[0] ?? trimmed;
-	}
-	pathname = pathname.replace(/\/+/g, "/").replace(/\.md$/i, "");
-	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
-	if (pathname !== "/") pathname = pathname.replace(/\/+$/, "");
-	return pathname;
-}
-function normalizeInlineText(value) {
-	return value.replace(/\s+/g, " ").trim();
-}
-
-//#endregion
-export { renderDocsRelatedMarkdownLines as n, normalizeDocsRelated as t };