@farming-labs/docs 0.1.126 → 0.1.129

package/dist/{agent-DO7T2pnN.mjs → agent-CJNYhzu7.mjs}

@@ -1,9 +1,9 @@
-import "./reading-time-HpTq-0VB.mjs";
+import "./reading-time-DPAazAGu.mjs";
 import "./search-BL7o2rXk.mjs";
 import "./agent-BS39vnhS.mjs";
 import "./robots-B2BfoyVM.mjs";
 import "./sitemap-server-idLUrmmU.mjs";
-import "./config-B8wA38OC.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-B4QzFqNC.mjs";
+import "./config-CBoixmrv.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-DbJrclYa.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/{agents-B11bgT3b.mjs → agents-BuL01_U0.mjs}

@@ -3,7 +3,7 @@ import { K as resolveDocsAgentFeedbackConfig, V as renderDocsAgentsDocument, a a
 import { S as resolveApiReferenceConfig } from "./sitemap-server-idLUrmmU.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-B8wA38OC.mjs";
+import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/cli/index.mjs

@@ -24,7 +24,8 @@ function parseFlags(argv) {
 		"typesense",
 		"algolia",
 		"verbose",
-		"host"
+		"host",
+		"json"
 	]);
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
@@ -76,17 +77,38 @@ async function main() {
 		indexName: typeof flags["index-name"] === "string" ? flags["index-name"] : void 0,
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
+	const cloudOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		apiBaseUrl: typeof flags["api-base-url"] === "string" ? flags["api-base-url"] : typeof flags.url === "string" ? flags.url : void 0,
+		apiKey: typeof flags["api-key"] === "string" ? flags["api-key"] : void 0,
+		json: typeof flags.json === "boolean" ? flags.json : void 0
+	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DzQWiVN1.mjs");
+		const { init } = await import("../init-BJqy-LK2.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-1VFeAWUi.mjs");
+		const { dev } = await import("../dev-DdlhqXNU.mjs");
 		await dev(devOptions);
+	} else if (parsedCommand.command === "preview") {
+		const { runCloudPreview } = await import("../cloud-88xTLXn3.mjs");
+		await runCloudPreview(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
+		const { runCloudPreview } = await import("../cloud-88xTLXn3.mjs");
+		await runCloudPreview(cloudOptions);
+	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
+		const { syncCloudConfig } = await import("../cloud-88xTLXn3.mjs");
+		await syncCloudConfig(cloudOptions);
+	} else if (parsedCommand.command === "cloud") {
+		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printCloudHelp } = await import("../cloud-88xTLXn3.mjs");
+		printCloudHelp();
+		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DxIxIGjq.mjs");
+		const { runMcp } = await import("../mcp-CUAR3XfW.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DO7T2pnN.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CJNYhzu7.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -96,11 +118,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-DO7T2pnN.mjs");
+		const { printAgentCompactHelp } = await import("../agent-CJNYhzu7.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-B11bgT3b.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BuL01_U0.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -110,11 +132,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-B11bgT3b.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-BuL01_U0.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-ylvdBm1D.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-D_c7vJCb.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -122,7 +144,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-ClNDYRnn.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-CjyI-bVg.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -130,7 +152,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-B4QzFqNC.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-DbJrclYa.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -140,11 +162,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-B4QzFqNC.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-DbJrclYa.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-D9iNWiKQ.mjs");
+		const { syncSearch } = await import("../search-Cekr2OyP.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -152,7 +174,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-ChZG2_Bv.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BBfGr3tJ.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -162,11 +184,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-ChZG2_Bv.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-BBfGr3tJ.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CNLiZCay.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-Dx2uMF3g.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -176,11 +198,11 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-CNLiZCay.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-Dx2uMF3g.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-BGANzvQb.mjs");
+		const { downgrade } = await import("../downgrade-BayU3nlg.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({
@@ -188,7 +210,7 @@ async function main() {
 			version: typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-C7DvvfTR.mjs");
+		const { upgrade } = await import("../upgrade-DDWolmHe.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;
@@ -216,6 +238,8 @@ ${pc.dim("Usage:")}
 ${pc.dim("Commands:")}
   ${pc.cyan("init")}     Scaffold docs in your project (default)
   ${pc.cyan("dev")}      Run frameworkless docs locally from ${pc.dim("docs.json")}
+  ${pc.cyan("preview")}  Sync cloud config and request a hosted Docs Cloud preview
+  ${pc.cyan("cloud")}    Docs Cloud utilities (${pc.dim("preview")}, ${pc.dim("sync")})
   ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} to generate sibling agent.md files)
   ${pc.cyan("agents")}   AGENTS.md utilities (${pc.dim("generate")} for static agent instructions)
   ${pc.cyan("doctor")}   Inspect and score agent or reader-facing docs quality
@@ -249,6 +273,15 @@ ${pc.dim("Options for dev:")}
   ${pc.cyan("--host [host]")}       Expose the preview on your network; optionally pass a host value
   ${pc.cyan("--verbose")}           Show raw runtime logs in addition to branded CLI output
 
+${pc.dim("Options for cloud preview:")}
+  ${pc.cyan("preview")}                              Sync ${pc.dim("docs.config.ts")} into ${pc.dim("docs.json")} and request a hosted preview
+  ${pc.cyan("cloud preview")}                        Same as ${pc.cyan("preview")}
+  ${pc.cyan("cloud sync")}                           Only materialize cloud settings into ${pc.dim("docs.json")}
+  ${pc.cyan("--config <path>")}                      Use a custom docs config path
+  ${pc.cyan("--api-base-url <url>")}                 Override the Docs Cloud API base URL
+  ${pc.cyan("--api-key <key>")}                      Use an API key directly; prefer ${pc.dim("cloud.apiKey.env")}
+  ${pc.cyan("--json")}                              Print machine-readable output
+
 ${pc.dim("Options for agent compact:")}
   ${pc.cyan("agent compact <page...>")}             Compact pages and write sibling ${pc.dim("agent.md")} files
   ${pc.cyan("agent compact --all")}                 Compact every folder-based docs page

package/dist/cloud-88xTLXn3.mjs

@@ -0,0 +1,529 @@
+import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelBooleanProperty, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
+import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import { execFileSync } from "node:child_process";
+
+//#region src/cli/cloud.ts
+const DOCS_JSON_FILE = "docs.json";
+const DOCS_CLOUD_SCHEMA_URL = "https://docs.farming-labs.dev/schema/docs.json";
+const DOCS_CLOUD_DEFAULT_API_KEY_ENV = "DOCS_CLOUD_API_KEY";
+const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://docs-app.farming-labs.dev";
+const DEFAULT_PREVIEW_TIMEOUT_MS = 300 * 1e3;
+const DEFAULT_PREVIEW_POLL_INTERVAL_MS = 2e3;
+function isRecord(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function isJsonRecord(value) {
+	return isRecord(value);
+}
+function toJsonRecord(value) {
+	if (!isRecord(value)) return void 0;
+	return JSON.parse(JSON.stringify(value));
+}
+function readPackageName(rootDir) {
+	const packagePath = path.join(rootDir, "package.json");
+	if (!fs.existsSync(packagePath)) return void 0;
+	try {
+		const parsed = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+		return typeof parsed.name === "string" && parsed.name.trim() ? parsed.name.trim() : void 0;
+	} catch {
+		return;
+	}
+}
+function runGit(rootDir, args) {
+	try {
+		return execFileSync("git", [
+			"-C",
+			rootDir,
+			...args
+		], {
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim();
+	} catch {
+		return;
+	}
+}
+function parseGitHubRemote(remoteUrl) {
+	const trimmed = remoteUrl.trim();
+	const match = trimmed.match(/^git@github\.com:([^/]+)\/(.+?)(?:\.git)?$/) ?? trimmed.match(/^https:\/\/github\.com\/([^/]+)\/(.+?)(?:\.git)?(?:\/)?$/);
+	if (!match?.[1] || !match[2]) return null;
+	return {
+		owner: match[1],
+		name: match[2].replace(/\.git$/i, "")
+	};
+}
+function resolveGitRepositoryMetadata(rootDir) {
+	const gitRoot = runGit(rootDir, ["rev-parse", "--show-toplevel"]);
+	const remoteUrl = runGit(rootDir, [
+		"remote",
+		"get-url",
+		"origin"
+	]);
+	if (!gitRoot || !remoteUrl) return;
+	const parsedRemote = parseGitHubRemote(remoteUrl);
+	if (!parsedRemote) return;
+	const branch = runGit(rootDir, ["branch", "--show-current"]) ?? runGit(rootDir, [
+		"rev-parse",
+		"--abbrev-ref",
+		"HEAD"
+	]);
+	const resolvedGitRoot = fs.realpathSync(gitRoot);
+	const resolvedRootDir = fs.realpathSync(rootDir);
+	const rootDirectory = path.relative(resolvedGitRoot, resolvedRootDir).split(path.sep).filter(Boolean).join("/");
+	return {
+		...parsedRemote,
+		branch: branch && branch !== "HEAD" ? branch : void 0,
+		rootDirectory: rootDirectory || ".",
+		remoteUrl
+	};
+}
+function titleFromPackageName(name) {
+	if (!name) return void 0;
+	const normalized = name.replace(/^@[^/]+\//, "").replace(/[-_]+/g, " ").trim();
+	if (!normalized) return void 0;
+	return normalized.replace(/\b\w/g, (match) => match.toUpperCase());
+}
+function tryResolveDocsConfigPath(rootDir, explicitPath) {
+	if (explicitPath) return resolveDocsConfigPath(rootDir, explicitPath);
+	try {
+		return resolveDocsConfigPath(rootDir);
+	} catch {
+		return;
+	}
+}
+async function loadDocsConfigSnapshot(rootDir, explicitPath) {
+	const configPath = tryResolveDocsConfigPath(rootDir, explicitPath);
+	if (!configPath) return {};
+	return {
+		path: configPath,
+		content: fs.readFileSync(configPath, "utf-8"),
+		config: (await loadDocsConfigModule(rootDir, configPath, { silent: true }))?.config
+	};
+}
+function readExistingDocsJson(docsJsonPath) {
+	if (!fs.existsSync(docsJsonPath)) return void 0;
+	try {
+		const parsed = JSON.parse(fs.readFileSync(docsJsonPath, "utf-8"));
+		if (!isJsonRecord(parsed)) throw new Error(`${DOCS_JSON_FILE} must contain a JSON object.`);
+		return parsed;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Could not parse ${DOCS_JSON_FILE}: ${message}`);
+	}
+}
+function normalizeApiKeyConfig(apiKey) {
+	return { env: apiKey?.env?.trim() || DOCS_CLOUD_DEFAULT_API_KEY_ENV };
+}
+function normalizePreviewConfig(preview) {
+	return { enabled: preview?.enabled ?? true };
+}
+function normalizePublishConfig(publish) {
+	return {
+		mode: publish?.mode === "direct-commit" ? "direct-commit" : "draft-pr",
+		baseBranch: publish?.baseBranch?.trim() || "main"
+	};
+}
+function normalizeFeatureConfig(feature) {
+	if (!feature) return void 0;
+	return { enabled: feature.enabled ?? true };
+}
+function normalizeAnalyticsConfig(analytics) {
+	if (typeof analytics === "undefined") return void 0;
+	if (typeof analytics === "boolean") return analytics;
+	return {
+		enabled: analytics.enabled ?? true,
+		...typeof analytics.console !== "undefined" ? { console: analytics.console } : {},
+		includeInputs: analytics.includeInputs ?? false
+	};
+}
+function normalizeCloudConfig(cloud) {
+	const normalized = {
+		apiKey: normalizeApiKeyConfig(cloud?.apiKey),
+		preview: normalizePreviewConfig(cloud?.preview),
+		publish: normalizePublishConfig(cloud?.publish)
+	};
+	if (cloud?.enabled === false) normalized.enabled = false;
+	const analytics = normalizeAnalyticsConfig(cloud?.analytics);
+	if (typeof analytics !== "undefined") normalized.analytics = analytics;
+	const ai = normalizeFeatureConfig(cloud?.ai);
+	if (ai) normalized.ai = ai;
+	const deploy = normalizeFeatureConfig(cloud?.deploy);
+	if (deploy) normalized.deploy = deploy;
+	return normalized;
+}
+function readStaticCloudConfig(content) {
+	if (!content || !extractNestedObjectLiteral(content, ["cloud"])) return void 0;
+	const cloudBlock = extractNestedObjectLiteral(content, ["cloud"]);
+	const apiKeyBlock = extractNestedObjectLiteral(content, ["cloud", "apiKey"]);
+	const previewBlock = extractNestedObjectLiteral(content, ["cloud", "preview"]);
+	const publishBlock = extractNestedObjectLiteral(content, ["cloud", "publish"]);
+	const analyticsBlock = extractNestedObjectLiteral(content, ["cloud", "analytics"]);
+	const aiBlock = extractNestedObjectLiteral(content, ["cloud", "ai"]);
+	const deployBlock = extractNestedObjectLiteral(content, ["cloud", "deploy"]);
+	const cloud = {};
+	const enabled = cloudBlock ? readTopLevelBooleanProperty(cloudBlock, "enabled") : void 0;
+	if (typeof enabled === "boolean") cloud.enabled = enabled;
+	const apiKeyEnv = apiKeyBlock ? readStringProperty(apiKeyBlock, "env") : void 0;
+	if (apiKeyEnv) cloud.apiKey = { env: apiKeyEnv };
+	const previewEnabled = previewBlock ? readTopLevelBooleanProperty(previewBlock, "enabled") : void 0;
+	if (typeof previewEnabled === "boolean") cloud.preview = { enabled: previewEnabled };
+	const publishMode = publishBlock ? readStringProperty(publishBlock, "mode") : void 0;
+	const baseBranch = publishBlock ? readStringProperty(publishBlock, "baseBranch") : void 0;
+	if (publishMode || baseBranch) cloud.publish = {
+		...publishMode === "direct-commit" || publishMode === "draft-pr" ? { mode: publishMode } : {},
+		...baseBranch ? { baseBranch } : {}
+	};
+	const analyticsEnabled = cloudBlock ? readTopLevelBooleanProperty(cloudBlock, "analytics") : void 0;
+	if (typeof analyticsEnabled === "boolean") cloud.analytics = analyticsEnabled;
+	else if (analyticsBlock) {
+		const analytics = {};
+		const enabledValue = readTopLevelBooleanProperty(analyticsBlock, "enabled");
+		const consoleBoolean = readTopLevelBooleanProperty(analyticsBlock, "console");
+		const consoleMode = readStringProperty(analyticsBlock, "console");
+		const includeInputs = readTopLevelBooleanProperty(analyticsBlock, "includeInputs");
+		if (typeof enabledValue === "boolean") analytics.enabled = enabledValue;
+		if (typeof consoleBoolean === "boolean") analytics.console = consoleBoolean;
+		else if (consoleMode === "log" || consoleMode === "info" || consoleMode === "debug") analytics.console = consoleMode;
+		if (typeof includeInputs === "boolean") analytics.includeInputs = includeInputs;
+		cloud.analytics = analytics;
+	}
+	const aiEnabled = aiBlock ? readTopLevelBooleanProperty(aiBlock, "enabled") : void 0;
+	if (typeof aiEnabled === "boolean") cloud.ai = { enabled: aiEnabled };
+	const deployEnabled = deployBlock ? readTopLevelBooleanProperty(deployBlock, "enabled") : void 0;
+	if (typeof deployEnabled === "boolean") cloud.deploy = { enabled: deployEnabled };
+	return cloud;
+}
+function resolveCloudConfig(snapshot, existing) {
+	const moduleCloud = snapshot.config?.cloud;
+	const staticCloud = readStaticCloudConfig(snapshot.content);
+	const existingCloud = existing?.cloud;
+	return normalizeCloudConfig(moduleCloud ?? staticCloud ?? existingCloud);
+}
+function resolveApiReferenceRoot(snapshot) {
+	const apiReference = snapshot.config?.apiReference;
+	if (isRecord(apiReference) && typeof apiReference.path === "string" && apiReference.path.trim()) return apiReference.path.trim();
+	const apiReferenceBlock = extractNestedObjectLiteral(snapshot.content ?? "", ["apiReference"]);
+	if (!apiReferenceBlock) return void 0;
+	return readStringProperty(apiReferenceBlock, "path");
+}
+function resolveSiteConfig(rootDir, snapshot, existing) {
+	const existingSite = toJsonRecord(existing?.site);
+	const navTitle = isRecord(snapshot.config?.nav) && typeof snapshot.config.nav.title === "string" ? snapshot.config.nav.title : readNavTitle(snapshot.content ?? "");
+	const metadata = isRecord(snapshot.config?.metadata) ? snapshot.config.metadata : void 0;
+	const metadataDescription = typeof metadata?.description === "string" && metadata.description.trim() ? metadata.description.trim() : void 0;
+	const packageTitle = titleFromPackageName(readPackageName(rootDir));
+	const name = navTitle?.trim() || existingSite?.name || packageTitle;
+	const description = metadataDescription || existingSite?.description;
+	if (!name && !description && !existingSite) return void 0;
+	return {
+		...existingSite ?? {},
+		...typeof name === "string" ? { name } : {},
+		...typeof description === "string" ? { description } : {}
+	};
+}
+function resolveDocsRoot(rootDir, snapshot, existing) {
+	const entry = snapshot.config?.entry ?? readTopLevelStringProperty(snapshot.content ?? "", "entry") ?? "docs";
+	if (snapshot.config?.contentDir) return snapshot.config.contentDir;
+	if (snapshot.content) return resolveDocsContentDir(rootDir, snapshot.content, entry);
+	if (typeof existing?.content?.docsRoot === "string") return existing.content.docsRoot;
+	return fs.existsSync(path.join(rootDir, "app", entry)) ? path.join("app", entry) : entry;
+}
+function resolveDocsBlock(rootDir, snapshot, existing) {
+	const detectedFramework = detectFramework(rootDir);
+	const existingDocs = existing?.docs;
+	const runtime = detectedFramework ?? existingDocs?.runtime ?? "nextjs";
+	if (!Boolean(snapshot.path || detectedFramework) && existingDocs) return existingDocs;
+	return {
+		mode: "framework",
+		runtime,
+		root: existingDocs?.root || "."
+	};
+}
+function materializeDocsJsonObject(params) {
+	const cloud = resolveCloudConfig(params.snapshot, params.existing);
+	const docsRoot = resolveDocsRoot(params.rootDir, params.snapshot, params.existing);
+	const apiReferenceRoot = resolveApiReferenceRoot(params.snapshot);
+	const existingContent = toJsonRecord(params.existing?.content);
+	const site = resolveSiteConfig(params.rootDir, params.snapshot, params.existing);
+	const content = {
+		...existingContent ?? {},
+		docsRoot,
+		...apiReferenceRoot ? { apiReferenceRoot } : {}
+	};
+	return {
+		...params.existing ?? {},
+		$schema: params.existing?.$schema ?? DOCS_CLOUD_SCHEMA_URL,
+		version: 1,
+		docs: resolveDocsBlock(params.rootDir, params.snapshot, params.existing),
+		content,
+		...site ? { site } : {},
+		cloud
+	};
+}
+function serializeMaterializedDocsJson(config) {
+	return `${JSON.stringify(config, null, 2)}\n`;
+}
+async function materializeCloudConfig(options = {}) {
+	const rootDir = options.rootDir ?? process.cwd();
+	const docsJsonPath = path.join(rootDir, DOCS_JSON_FILE);
+	const existing = readExistingDocsJson(docsJsonPath);
+	const snapshot = await loadDocsConfigSnapshot(rootDir, options.configPath);
+	const config = materializeDocsJsonObject({
+		rootDir,
+		snapshot,
+		existing
+	});
+	const serialized = serializeMaterializedDocsJson(config);
+	const updated = (existing ? fs.readFileSync(docsJsonPath, "utf-8") : void 0) !== serialized;
+	if (updated) fs.writeFileSync(docsJsonPath, serialized, "utf-8");
+	return {
+		configPath: snapshot.path ?? docsJsonPath,
+		docsJsonPath,
+		config,
+		apiKeyEnv: config.cloud?.apiKey?.env ?? DOCS_CLOUD_DEFAULT_API_KEY_ENV,
+		created: !existing,
+		updated
+	};
+}
+function resolveApiBaseUrl(options) {
+	return (options.apiBaseUrl ?? process.env.DOCS_CLOUD_API_URL ?? process.env.NEXT_PUBLIC_DOCS_CLOUD_URL ?? DEFAULT_DOCS_CLOUD_API_BASE_URL).replace(/\/+$/, "");
+}
+function resolveApiKey(options, rootDir, envName) {
+	if (options.apiKey?.trim()) return options.apiKey.trim();
+	const token = {
+		...loadProjectEnv(rootDir),
+		...process.env
+	}[envName]?.trim();
+	if (token) return token;
+	throw new Error(`Missing Docs Cloud API key. Set ${envName} in your shell or .env.local, or configure cloud.apiKey.env in docs.config.ts.`);
+}
+async function readJsonResponse(response) {
+	const text = await response.text();
+	if (!text.trim()) return {};
+	try {
+		return JSON.parse(text);
+	} catch {
+		return { message: text };
+	}
+}
+function readResponseMessage(body, fallback) {
+	if (isRecord(body)) for (const key of [
+		"error",
+		"message",
+		"detail"
+	]) {
+		const value = body[key];
+		if (typeof value === "string" && value.trim()) return value.trim();
+	}
+	return fallback;
+}
+async function fetchCloudJson(params) {
+	const headers = new Headers(params.init?.headers);
+	headers.set("authorization", `Bearer ${params.apiKey}`);
+	headers.set("accept", "application/json");
+	if (params.init?.body && !headers.has("content-type")) headers.set("content-type", "application/json");
+	const response = await fetch(params.url, {
+		...params.init,
+		headers
+	});
+	const body = await readJsonResponse(response);
+	if (!response.ok) {
+		const requestPath = new URL(params.url).pathname;
+		if (response.status === 404 && requestPath === "/api/cloud/preview") throw new Error("Docs Cloud preview API is not available on this cloud host yet. The API key was validated, but the host did not expose /api/cloud/preview.");
+		const message = readResponseMessage(body, `Docs Cloud request failed with HTTP ${response.status}.`);
+		throw new Error(message);
+	}
+	return body;
+}
+function readPreviewUrl(body) {
+	if (!isRecord(body)) return void 0;
+	const direct = body.url ?? body.previewUrl;
+	if (typeof direct === "string" && direct.trim()) return direct.trim();
+	const preview = body.preview;
+	if (isRecord(preview) && typeof preview.url === "string" && preview.url.trim()) return preview.url.trim();
+}
+function readStatusUrl(body, apiBaseUrl) {
+	if (!isRecord(body)) return void 0;
+	const statusUrl = body.statusUrl ?? body.pollUrl;
+	if (typeof statusUrl !== "string" || !statusUrl.trim()) return void 0;
+	return new URL(statusUrl, apiBaseUrl).toString();
+}
+function readPreviewStatus(body) {
+	if (!isRecord(body)) return void 0;
+	const status = body.status;
+	return typeof status === "string" ? status : void 0;
+}
+async function requestPreview(params) {
+	const initial = await fetchCloudJson({
+		url: `${params.apiBaseUrl}/api/cloud/preview`,
+		apiKey: params.apiKey,
+		init: {
+			method: "POST",
+			body: JSON.stringify({
+				config: params.config,
+				configPath: path.relative(params.rootDir, params.configPath) || DOCS_JSON_FILE,
+				repository: resolveGitRepositoryMetadata(params.rootDir)
+			})
+		}
+	});
+	const initialUrl = readPreviewUrl(initial);
+	if (initialUrl) return {
+		url: initialUrl,
+		response: initial
+	};
+	const statusUrl = readStatusUrl(initial, params.apiBaseUrl);
+	if (!statusUrl) throw new Error("Docs Cloud accepted the preview request but did not return a preview URL or status URL.");
+	const startedAt = Date.now();
+	while (Date.now() - startedAt < params.timeoutMs) {
+		await new Promise((resolve) => setTimeout(resolve, params.pollIntervalMs));
+		params.spinner.update("Waiting for Docs Cloud preview deployment");
+		const statusBody = await fetchCloudJson({
+			url: statusUrl,
+			apiKey: params.apiKey
+		});
+		const url = readPreviewUrl(statusBody);
+		if (url) return {
+			url,
+			response: statusBody
+		};
+		const status = readPreviewStatus(statusBody);
+		if (status === "failed" || status === "error") throw new Error(readResponseMessage(statusBody, "Docs Cloud preview failed."));
+	}
+	throw new Error("Docs Cloud preview timed out before a URL was ready.");
+}
+function createSpinner(initialMessage, options = {}) {
+	const interactive = Boolean(process.stdout.isTTY && !options.json && process.env.NODE_ENV !== "test");
+	const frames = [
+		"-",
+		"\\",
+		"|",
+		"/"
+	];
+	let frame = 0;
+	let message = initialMessage;
+	let timer;
+	const render = () => {
+		process.stdout.write(`\r${pc.cyan(frames[frame % frames.length])} ${message}`);
+		frame += 1;
+	};
+	if (interactive) {
+		render();
+		timer = setInterval(render, 90);
+	} else if (!options.json) console.log(`${pc.dim("-")} ${initialMessage}`);
+	const clear = () => {
+		if (timer) {
+			clearInterval(timer);
+			timer = void 0;
+		}
+		if (interactive) process.stdout.write("\r\x1B[K");
+	};
+	return {
+		update(nextMessage) {
+			message = nextMessage;
+			if (!interactive && !options.json) console.log(`${pc.dim("-")} ${nextMessage}`);
+		},
+		succeed(doneMessage) {
+			clear();
+			if (!options.json) console.log(`${pc.green("ok")} ${doneMessage}`);
+		},
+		fail(doneMessage) {
+			clear();
+			if (!options.json) console.log(`${pc.red("error")} ${doneMessage}`);
+		},
+		stop() {
+			clear();
+		}
+	};
+}
+async function syncCloudConfig(options = {}) {
+	const result = await materializeCloudConfig(options);
+	if (options.json) {
+		console.log(JSON.stringify(result, null, 2));
+		return result;
+	}
+	const action = result.created ? "Created" : result.updated ? "Synced" : "Checked";
+	console.log(`${pc.green("ok")} ${action} ${pc.cyan(path.relative(process.cwd(), result.docsJsonPath) || DOCS_JSON_FILE)}`);
+	console.log(`${pc.dim("api key env")} ${result.apiKeyEnv}`);
+	return result;
+}
+async function runCloudPreview(options = {}) {
+	const rootDir = options.rootDir ?? process.cwd();
+	const spinner = createSpinner("Preparing Docs Cloud preview", options);
+	try {
+		const materialized = await materializeCloudConfig({
+			...options,
+			rootDir
+		});
+		spinner.update(`${materialized.created ? "Created" : "Synced"} ${DOCS_JSON_FILE}`);
+		if (materialized.config.cloud?.enabled === false) throw new Error("Docs Cloud is disabled in cloud.enabled. Remove that override or set cloud.enabled: true before requesting a preview.");
+		if (materialized.config.cloud?.preview?.enabled === false) throw new Error("Docs Cloud preview is disabled in cloud.preview.enabled. Set it to true before requesting a preview.");
+		const apiKey = resolveApiKey(options, rootDir, materialized.apiKeyEnv);
+		const apiBaseUrl = resolveApiBaseUrl(options);
+		spinner.update("Validating Docs Cloud API key");
+		const identity = await fetchCloudJson({
+			url: `${apiBaseUrl}/api/cloud/me`,
+			apiKey
+		});
+		spinner.update("Requesting Docs Cloud preview deployment");
+		const preview = await requestPreview({
+			apiBaseUrl,
+			apiKey,
+			config: materialized.config,
+			configPath: materialized.docsJsonPath,
+			rootDir,
+			spinner,
+			timeoutMs: options.timeoutMs ?? DEFAULT_PREVIEW_TIMEOUT_MS,
+			pollIntervalMs: options.pollIntervalMs ?? DEFAULT_PREVIEW_POLL_INTERVAL_MS
+		});
+		spinner.succeed("Docs Cloud preview is ready");
+		const result = {
+			url: preview.url,
+			docsJsonPath: materialized.docsJsonPath,
+			apiBaseUrl,
+			identity,
+			response: preview.response
+		};
+		if (options.json) console.log(JSON.stringify(result, null, 2));
+		else console.log(`${pc.bold("Preview")} ${pc.cyan(preview.url)}`);
+		return result;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		spinner.fail(message);
+		throw error;
+	} finally {
+		spinner.stop();
+	}
+}
+function printCloudHelp() {
+	console.log(`
+${pc.bold("@farming-labs/docs cloud")}
+
+${pc.dim("Usage:")}
+  ${pc.cyan("docs preview")}              Sync ${pc.dim("docs.config.ts")} to ${pc.dim("docs.json")} and request a cloud preview
+  ${pc.cyan("docs cloud preview")}        Same as ${pc.cyan("docs preview")}
+  ${pc.cyan("docs cloud sync")}           Only materialize cloud settings into ${pc.dim("docs.json")}
+
+${pc.dim("Options:")}
+  ${pc.cyan("--config <path>")}           Use a custom docs config path
+  ${pc.cyan("--api-base-url <url>")}      Override Docs Cloud API base URL
+  ${pc.cyan("--api-key <key>")}           Use an API key directly; prefer ${pc.dim("cloud.apiKey.env")}
+  ${pc.cyan("--json")}                    Print machine-readable output
+
+${pc.dim("Config example:")}
+  cloud: {
+    apiKey: { env: "DOCS_CLOUD_API_KEY" },
+    preview: { enabled: true },
+    publish: { mode: "draft-pr", baseBranch: "main" },
+  }
+`);
+}
+
+//#endregion
+export { printCloudHelp, runCloudPreview, syncCloudConfig };

package/dist/{codeblocks-B4QzFqNC.mjs → codeblocks-DbJrclYa.mjs}

@@ -3,7 +3,7 @@ import { E as findDocsMarkdownPage, U as renderDocsMarkdownDocument } from "./ag
 import "./index.mjs";
 import { createFilesystemDocsMcpSource } 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-B8wA38OC.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, l as readNumberProperty, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{config-B8wA38OC.mjs → config-CBoixmrv.mjs}

@@ -230,6 +230,14 @@ function readTopLevelStringProperty(content, key) {
 		if (match) return match[1];
 	}
 }
+function readTopLevelBooleanProperty(content, key) {
+	const source = extractTopLevelConfigObject(content) ?? content;
+	const propertyPattern = new RegExp(`^\\s*${escapeRegExp(key)}\\s*:\\s*(true|false)\\b`);
+	for (const property of splitTopLevelProperties(source)) {
+		const match = property.trim().match(propertyPattern);
+		if (match) return match[1] === "true";
+	}
+}
 function readNavTitle(content) {
 	const block = extractObjectLiteral(extractTopLevelConfigObject(content) ?? content, "nav");
 	if (!block) return void 0;
@@ -295,4 +303,4 @@ async function loadDocsConfigModule(rootDir, explicitPath, options = {}) {
 }
 
 //#endregion
-export { loadProjectEnv as a, readNavTitle as c, readTopLevelStringProperty as d, resolveDocsConfigPath as f, loadDocsConfigModule as i, readNumberProperty as l, extractObjectLiteral as n, readBooleanProperty as o, resolveDocsContentDir as p, extractTopLevelConfigObject as r, readEnvReferenceProperty as s, extractNestedObjectLiteral as t, readStringProperty as u };
+export { loadProjectEnv as a, readNavTitle as c, readTopLevelBooleanProperty as d, readTopLevelStringProperty as f, loadDocsConfigModule as i, readNumberProperty as l, resolveDocsContentDir as m, extractObjectLiteral as n, readBooleanProperty as o, resolveDocsConfigPath as p, extractTopLevelConfigObject as r, readEnvReferenceProperty as s, extractNestedObjectLiteral as t, readStringProperty as u };

package/dist/{dev-1VFeAWUi.mjs → dev-DdlhqXNU.mjs}

@@ -1,5 +1,5 @@
 import { i as detectPackageManagerFromLockfile } from "./utils-x5EtYWjC.mjs";
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-CGaORZOY.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-DomB3eeS.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -203,6 +203,12 @@ const managedConfigSchema = z.object({
 	theme: z.object({ preset: z.string().optional() }).passthrough().optional(),
 	cloud: z.object({
 		enabled: z.boolean().optional(),
+		apiKey: z.object({ env: z.string().min(1).optional() }).passthrough().optional(),
+		preview: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
+		publish: z.object({
+			mode: z.enum(["draft-pr", "direct-commit"]).optional(),
+			baseBranch: z.string().min(1).optional()
+		}).passthrough().optional(),
 		analytics: z.union([z.boolean(), z.object({
 			enabled: z.boolean().optional(),
 			console: z.union([z.boolean(), z.enum([

package/dist/{doctor-ylvdBm1D.mjs → doctor-D_c7vJCb.mjs}

@@ -1,4 +1,4 @@
-import "./reading-time-HpTq-0VB.mjs";
+import "./reading-time-DPAazAGu.mjs";
 import "./search-BL7o2rXk.mjs";
 import { a as DEFAULT_SITEMAP_XML_ROUTE, d as resolveDocsSitemapConfig, i as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, r as DEFAULT_SITEMAP_MD_ROUTE } from "./sitemap-CMNj0Pt3.mjs";
 import { T as buildDocsMcpEndpointCandidates, b as DEFAULT_SKILL_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, d as DEFAULT_LLMS_FULL_TXT_ROUTE, g as DEFAULT_MCP_PUBLIC_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, m as DEFAULT_LLMS_TXT_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_MCP_WELL_KNOWN_ROUTE, x as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE } from "./agent-BS39vnhS.mjs";
@@ -6,9 +6,9 @@ import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveD
 import "./sitemap-server-idLUrmmU.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-B8wA38OC.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-CBoixmrv.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-B4QzFqNC.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-DbJrclYa.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-BGANzvQb.mjs → downgrade-BayU3nlg.mjs}

@@ -1,5 +1,5 @@
 import { c as fileExists, o as exec, s as execOutput } from "./utils-x5EtYWjC.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-OrjpmqoR.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-CQm0KO-H.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsReviewRulesConfig, A as DocsCodeBlocksConfig, At as OpenDocsProviderId, B as DocsFeedbackValue, Bt as ResolvedDocsRelatedLink, C as DocsAskAIActionData, Ct as LlmsTxtMaxCharsMode, D as DocsAskAIFeedbackMessage, Dt as OpenDocsConfig, E as DocsAskAIFeedbackData, Et as OGConfig, F as DocsCodeBlocksValidateConfig, Ft as PageFrontmatter, G as DocsNav, Gt as SidebarNode, H as DocsMcpConfig, Ht as SidebarConfig, I as DocsCodeBlocksValidationMode, It as PageOpenGraph, J as DocsObservabilityEventInput, Jt as SimpleDocsSearchConfig, K as DocsObservabilityConfig, Kt as SidebarPageNode, L as DocsCodeBlocksValidationPolicy, Lt as PageSidebarFrontmatter, M as DocsCodeBlocksPlannerProvider, Mt as OpenGraphImage, N as DocsCodeBlocksRunnerConfig, Nt as OrderingItem, O as DocsAskAIFeedbackValue, Ot as OpenDocsProvider, P as DocsCodeBlocksRunnerProvider, Pt as PageActionsConfig, Q as DocsReviewConfig, Qt as UIConfig, R as DocsConfig, Rt as PageTwitter, S as DocsAnalyticsSource, St as LlmsTxtMaxCharsConfig, T as DocsAskAIFeedbackConfig, Tt as McpDocsSearchConfig, U as DocsMcpToolsConfig, Ut as SidebarFolderIndexBehavior, V as DocsI18nConfig, Vt as SidebarComponentProps, W as DocsMetadata, Wt as SidebarFolderNode, X as DocsReviewCiConfig, Xt as TypesenseDocsSearchConfig, Y as DocsRelatedItem, Yt as ThemeToggleConfig, Z as DocsReviewCiMode, Zt as TypographyConfig, _ as DocsAnalyticsConfig, _t as FeedbackConfig, a as ApiReferenceRenderer, at as DocsSearchAdapterContext, b as DocsAnalyticsEventType, bt as LastUpdatedConfig, c as ChangelogFrontmatter, ct as DocsSearchConfig, d as CustomDocsSearchConfig, dt as DocsSearchQuery, et as DocsReviewScoreConfig, f as DocsAgentFeedbackContext, ft as DocsSearchResult, g as DocsAgentTraceStatus, gt as DocsTheme, h as DocsAgentTraceEventType, ht as DocsSitemapConfig, i as ApiReferenceConfig, it as DocsSearchAdapter, j as DocsCodeBlocksPlannerConfig, jt as OpenDocsTarget, k as DocsAskAIMcpConfig, kt as OpenDocsProviderConfig, l as CodeBlockCopyData, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, n as AgentFeedbackConfig, nt as DocsRobotsConfig, o as BreadcrumbConfig, ot as DocsSearchAdapterFactory, p as DocsAgentFeedbackData, pt as DocsSearchResultType, q as DocsObservabilityEvent, qt as SidebarTree, r as AlgoliaDocsSearchConfig, rt as DocsRobotsRule, s as ChangelogConfig, st as DocsSearchChunkingConfig, t as AIConfig, tt as DocsReviewSeverity, u as CopyMarkdownConfig, ut as DocsSearchEmbeddingsConfig, v as DocsAnalyticsEvent, vt as FontStyle, w as DocsAskAIActionType, wt as LlmsTxtSectionConfig, x as DocsAnalyticsInput, xt as LlmsTxtConfig, y as DocsAnalyticsEventInput, yt as GithubConfig, z as DocsFeedbackData, zt as ReadingTimeConfig } from "./types-Dg82p0Fm.mjs";
-import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as DocsCloudAnalyticsOptions, 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 resolveDocsObservabilityConfig, 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, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, 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-G0otDMfP.mjs";
+import { $ as DocsObservabilityEventInput, $t as SimpleDocsSearchConfig, A as DocsCloudApiKeyConfig, At as McpDocsSearchConfig, B as DocsCodeBlocksValidateConfig, Bt as PageFrontmatter, C as DocsAskAIActionData, Ct as FontStyle, D as DocsAskAIFeedbackMessage, Dt as LlmsTxtMaxCharsConfig, E as DocsAskAIFeedbackData, Et as LlmsTxtConfig, F as DocsCodeBlocksConfig, Ft as OpenDocsProviderId, G as DocsFeedbackValue, Gt as ResolvedDocsRelatedLink, H as DocsCodeBlocksValidationPolicy, Ht as PageSidebarFrontmatter, I as DocsCodeBlocksPlannerConfig, It as OpenDocsTarget, J as DocsMcpToolsConfig, Jt as SidebarFolderIndexBehavior, K as DocsI18nConfig, Kt as SidebarComponentProps, L as DocsCodeBlocksPlannerProvider, Lt as OpenGraphImage, M as DocsCloudFeatureConfig, Mt as OpenDocsConfig, N as DocsCloudPreviewConfig, Nt as OpenDocsProvider, O as DocsAskAIFeedbackValue, Ot as LlmsTxtMaxCharsMode, P as DocsCloudPublishConfig, Pt as OpenDocsProviderConfig, Q as DocsObservabilityEvent, Qt as SidebarTree, R as DocsCodeBlocksRunnerConfig, Rt as OrderingItem, S as DocsAnalyticsSource, St as FeedbackConfig, T as DocsAskAIFeedbackConfig, Tt as LastUpdatedConfig, U as DocsConfig, Ut as PageTwitter, V as DocsCodeBlocksValidationMode, Vt as PageOpenGraph, W as DocsFeedbackData, Wt as ReadingTimeConfig, X as DocsNav, Xt as SidebarNode, Y as DocsMetadata, Yt as SidebarFolderNode, Z as DocsObservabilityConfig, Zt as SidebarPageNode, _ as DocsAnalyticsConfig, _t as DocsSearchResult, a as ApiReferenceRenderer, at as DocsReviewScoreConfig, b as DocsAnalyticsEventType, bt as DocsSitemapConfig, c as ChangelogFrontmatter, ct as DocsRobotsRule, d as CustomDocsSearchConfig, dt as DocsSearchAdapterFactory, en as ThemeToggleConfig, et as DocsRelatedItem, f as DocsAgentFeedbackContext, ft as DocsSearchChunkingConfig, g as DocsAgentTraceStatus, gt as DocsSearchQuery, h as DocsAgentTraceEventType, ht as DocsSearchEmbeddingsConfig, i as ApiReferenceConfig, it as DocsReviewRulesConfig, j as DocsCloudConfig, jt as OGConfig, k as DocsAskAIMcpConfig, kt as LlmsTxtSectionConfig, l as CodeBlockCopyData, lt as DocsSearchAdapter, m as DocsAgentTraceEventInput, mt as DocsSearchDocument, n as AgentFeedbackConfig, nn as TypographyConfig, nt as DocsReviewCiMode, o as BreadcrumbConfig, ot as DocsReviewSeverity, p as DocsAgentFeedbackData, pt as DocsSearchConfig, q as DocsMcpConfig, qt as SidebarConfig, r as AlgoliaDocsSearchConfig, rn as UIConfig, rt as DocsReviewConfig, s as ChangelogConfig, st as DocsRobotsConfig, t as AIConfig, tn as TypesenseDocsSearchConfig, tt as DocsReviewCiConfig, u as CopyMarkdownConfig, ut as DocsSearchAdapterContext, v as DocsAnalyticsEvent, vt as DocsSearchResultType, w as DocsAskAIActionType, wt as GithubConfig, x as DocsAnalyticsInput, xt as DocsTheme, y as DocsAnalyticsEventInput, yt as DocsSearchSourcePage, z as DocsCodeBlocksRunnerProvider, zt as PageActionsConfig } from "./types-C-C-9SMJ.mjs";
+import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as DocsCloudAnalyticsOptions, 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 resolveDocsObservabilityConfig, 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, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, 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-CNoiftmI.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts
@@ -668,4 +668,4 @@ declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOption
 declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
 declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsRenderOptions): DocsRobotsAnalysis;
 //#endregion
-export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAnalyticsOptions, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStructuredDataBreadcrumb, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRobotsAllowRoutes, hasDocsMarkdownSignatureAgent, hashGeneratedAgentContent, inferDocsAskAIPackageHints, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, validateDocsAgentFeedbackPayload };
+export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAnalyticsOptions, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStructuredDataBreadcrumb, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRobotsAllowRoutes, hasDocsMarkdownSignatureAgent, hashGeneratedAgentContent, inferDocsAskAIPackageHints, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, validateDocsAgentFeedbackPayload };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { _ as extendTheme, a as resolveReadingTimeOptions, b as defineDocs, c as buildPageTwitter, d as resolveOGImage, f as resolveTitle, g as createTheme, h as resolveDocsPath, i as resolveReadingTimeFromSource, l as renderDocsPageStructuredDataJson, m as resolveDocsLocale, n as resolvePageReadingTime, o as buildDocsPageStructuredData, p as resolveDocsI18n, r as resolveReadingTimeFromContent, s as buildPageOpenGraph, t as estimateReadingTimeMinutes, u as resolveDocsMetadataBaseUrl, v as deepMerge, y as resolveChangelogConfig } from "./reading-time-HpTq-0VB.mjs";
+import { _ as extendTheme, a as resolveReadingTimeOptions, b as defineDocs, c as buildPageTwitter, d as resolveOGImage, f as resolveTitle, g as createTheme, h as resolveDocsPath, i as resolveReadingTimeFromSource, l as renderDocsPageStructuredDataJson, m as resolveDocsLocale, n as resolvePageReadingTime, o as buildDocsPageStructuredData, p as resolveDocsI18n, r as resolveReadingTimeFromContent, s as buildPageOpenGraph, t as estimateReadingTimeMinutes, u as resolveDocsMetadataBaseUrl, v as deepMerge, y as resolveChangelogConfig } from "./reading-time-DPAazAGu.mjs";
 import { A as resolveDocsAnalyticsConfig, C as resolveSidebarFolderIndexBehaviorForPath, D as emitDocsAgentTraceEvent, E as createDocsAgentTraceId, M as createDocsCloudAnalytics, O as emitDocsAnalyticsEvent, S as resolveSidebarFolderIndexBehavior, T as createDocsAgentTraceContext, _ as parseGeneratedAgentDocument, a as createMcpSearchAdapter, b as applySidebarFolderIndexBehavior, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as normalizeGeneratedAgentContent, h as hashGeneratedAgentContent, i as createCustomSearchAdapter, j as resolveDocsObservabilityConfig, k as emitDocsObservabilityEvent, l as inferDocsAskAIPackageHints, m as GENERATED_AGENT_PROVENANCE_VERSION, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as GENERATED_AGENT_PROVENANCE_MARKER, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as serializeGeneratedAgentDocument, w as DOCS_AGENT_TRACE_EVENT_TYPES, x as resolvePageSidebarFolderIndexBehavior, y as stripGeneratedAgentProvenance } from "./search-BL7o2rXk.mjs";
 import { n as renderDocsRelatedMarkdownLines, t as normalizeDocsRelated } from "./related-BNj_NdHq.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";

package/dist/{init-DzQWiVN1.mjs → init-BJqy-LK2.mjs}

@@ -1,5 +1,5 @@
 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-x5EtYWjC.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-CGaORZOY.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-DomB3eeS.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{mcp-DxIxIGjq.mjs → mcp-CUAR3XfW.mjs}

@@ -2,7 +2,7 @@ import "./search-BL7o2rXk.mjs";
 import "./sitemap-server-idLUrmmU.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, f as resolveDocsConfigPath, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsContentDir, u as readStringProperty } from "./config-B8wA38OC.mjs";
+import { c as readNavTitle, m as resolveDocsContentDir, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsConfigPath, u as readStringProperty } from "./config-CBoixmrv.mjs";
 import { readFileSync } from "node:fs";
 
 //#region src/cli/mcp.ts

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { H as DocsMcpConfig, K as DocsObservabilityConfig, Nt as OrderingItem, _ as DocsAnalyticsConfig, ct as DocsSearchConfig, mt as DocsSearchSourcePage } from "./types-Dg82p0Fm.mjs";
+import { Rt as OrderingItem, Z as DocsObservabilityConfig, _ as DocsAnalyticsConfig, pt as DocsSearchConfig, q as DocsMcpConfig, yt as DocsSearchSourcePage } from "./types-C-C-9SMJ.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/mcp.mjs

@@ -239,6 +239,42 @@ const DOCS_CONFIG_SCHEMA_OPTIONS = [
 			description: "Maximum result count returned by search requests."
 		}]
 	},
+	{
+		path: "cloud",
+		name: "cloud",
+		type: "DocsCloudConfig",
+		description: "Docs Cloud integration settings mirrored into docs.json by cloud CLI commands.",
+		children: [
+			{
+				path: "cloud.apiKey.env",
+				name: "env",
+				type: "string",
+				default: "DOCS_CLOUD_API_KEY",
+				description: "Environment variable that stores the Docs Cloud API key. The key value is never written to docs.json."
+			},
+			{
+				path: "cloud.preview.enabled",
+				name: "enabled",
+				type: "boolean",
+				default: true,
+				description: "Request hosted preview deployments when running docs preview."
+			},
+			{
+				path: "cloud.publish.mode",
+				name: "mode",
+				type: "\"draft-pr\" | \"direct-commit\"",
+				default: "draft-pr",
+				description: "How Docs Cloud publishes generated docs changes."
+			},
+			{
+				path: "cloud.publish.baseBranch",
+				name: "baseBranch",
+				type: "string",
+				default: "main",
+				description: "Branch generated docs work should target."
+			}
+		]
+	},
 	{
 		path: "llmsTxt",
 		name: "llmsTxt",

package/dist/{reading-time-HpTq-0VB.mjs → reading-time-DPAazAGu.mjs}

@@ -18,6 +18,7 @@ function defineDocs(config) {
 		sidebar: config.sidebar,
 		components: config.components,
 		analytics: config.analytics,
+		cloud: config.cloud,
 		observability: config.observability,
 		onCopyClick: config.onCopyClick,
 		codeBlocks: config.codeBlocks,

package/dist/{review-ClNDYRnn.mjs → review-CjyI-bVg.mjs}

@@ -1,5 +1,5 @@
 import { a as ensureDocsReviewWorkflow, o as readDocsReviewConfigFromSource, s as resolveDocsReviewConfig } from "./review-B7goPYUb.mjs";
-import { d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, p as resolveDocsContentDir } from "./config-B8wA38OC.mjs";
+import { f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath } from "./config-CBoixmrv.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-CNLiZCay.mjs → robots-Dx2uMF3g.mjs}

@@ -1,6 +1,6 @@
 import "./agent-BS39vnhS.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-B2BfoyVM.mjs";
-import { d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-B8wA38OC.mjs";
+import { f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{search-G0otDMfP.d.mts → search-CNoiftmI.d.mts}

@@ -1,4 +1,4 @@
-import { Bt as ResolvedDocsRelatedLink, J as DocsObservabilityEventInput, K as DocsObservabilityConfig, Ot as OpenDocsProvider, Tt as McpDocsSearchConfig, Xt as TypesenseDocsSearchConfig, _ as DocsAnalyticsConfig, ct as DocsSearchConfig, d as CustomDocsSearchConfig, ft as DocsSearchResult, ht as DocsSitemapConfig, it as DocsSearchAdapter, jt as OpenDocsTarget, k as DocsAskAIMcpConfig, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, ot as DocsSearchAdapterFactory, q as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, st as DocsSearchChunkingConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput } from "./types-Dg82p0Fm.mjs";
+import { $ as DocsObservabilityEventInput, At as McpDocsSearchConfig, Gt as ResolvedDocsRelatedLink, It as OpenDocsTarget, Nt as OpenDocsProvider, Q as DocsObservabilityEvent, Z as DocsObservabilityConfig, _ as DocsAnalyticsConfig, _t as DocsSearchResult, bt as DocsSitemapConfig, d as CustomDocsSearchConfig, dt as DocsSearchAdapterFactory, ft as DocsSearchChunkingConfig, k as DocsAskAIMcpConfig, lt as DocsSearchAdapter, m as DocsAgentTraceEventInput, mt as DocsSearchDocument, pt as DocsSearchConfig, r as AlgoliaDocsSearchConfig, tn as TypesenseDocsSearchConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, yt as DocsSearchSourcePage } from "./types-C-C-9SMJ.mjs";
 
 //#region src/cloud-analytics.d.ts
 interface DocsCloudAnalyticsOptions {

package/dist/{search-D9iNWiKQ.mjs → search-Cekr2OyP.mjs}

@@ -2,7 +2,7 @@ import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as cr
 import "./sitemap-server-idLUrmmU.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, d as readTopLevelStringProperty, f as resolveDocsConfigPath, p as resolveDocsContentDir } from "./config-B8wA38OC.mjs";
+import { a as loadProjectEnv, f as readTopLevelStringProperty, m as resolveDocsContentDir, p as resolveDocsConfigPath } from "./config-CBoixmrv.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsReviewRulesConfig, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, J as DocsObservabilityEventInput, K as DocsObservabilityConfig, O as DocsAskAIFeedbackValue, Q as DocsReviewConfig, R as DocsConfig, T as DocsAskAIFeedbackConfig, Tt as McpDocsSearchConfig, Z as DocsReviewCiMode, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, at as DocsSearchAdapterContext, ct as DocsSearchConfig, dt as DocsSearchQuery, ft as DocsSearchResult, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, ht as DocsSitemapConfig, it as DocsSearchAdapter, k as DocsAskAIMcpConfig, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, ot as DocsSearchAdapterFactory, q as DocsObservabilityEvent, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput } from "./types-Dg82p0Fm.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 DocsCloudAnalyticsOptions, 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 resolveDocsObservabilityConfig, 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, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, 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-G0otDMfP.mjs";
+import { $ as DocsObservabilityEventInput, At as McpDocsSearchConfig, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, O as DocsAskAIFeedbackValue, Q as DocsObservabilityEvent, T as DocsAskAIFeedbackConfig, U as DocsConfig, Z as DocsObservabilityConfig, _ as DocsAnalyticsConfig, _t as DocsSearchResult, a as ApiReferenceRenderer, bt as DocsSitemapConfig, dt as DocsSearchAdapterFactory, g as DocsAgentTraceStatus, gt as DocsSearchQuery, h as DocsAgentTraceEventType, it as DocsReviewRulesConfig, k as DocsAskAIMcpConfig, lt as DocsSearchAdapter, m as DocsAgentTraceEventInput, mt as DocsSearchDocument, nt as DocsReviewCiMode, pt as DocsSearchConfig, rt as DocsReviewConfig, ut as DocsSearchAdapterContext, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, yt as DocsSearchSourcePage } from "./types-C-C-9SMJ.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 DocsCloudAnalyticsOptions, 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 resolveDocsObservabilityConfig, 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, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, 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-CNoiftmI.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/{sitemap-ChZG2_Bv.mjs → sitemap-BBfGr3tJ.mjs}

@@ -3,7 +3,7 @@ import { d as resolveDocsSitemapConfig, l as renderDocsSitemapMarkdown, o as bui
 import "./sitemap-server-idLUrmmU.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-B8wA38OC.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-CBoixmrv.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{types-Dg82p0Fm.d.mts → types-C-C-9SMJ.d.mts}

@@ -753,6 +753,53 @@ interface DocsAnalyticsConfig {
   /** Callback fired for every emitted event. */
   onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
 }
+interface DocsCloudApiKeyConfig {
+  /**
+   * Environment variable that stores the Docs Cloud API key.
+   *
+   * The key value is never written to docs.json; only this env var name is
+   * mirrored for CLI and CI workflows.
+   *
+   * @default "DOCS_CLOUD_API_KEY"
+   */
+  env?: string;
+}
+interface DocsCloudPreviewConfig {
+  /** Whether Docs Cloud should request live preview deployments. @default true */
+  enabled?: boolean;
+}
+interface DocsCloudPublishConfig {
+  /** How Docs Cloud should publish generated docs changes. @default "draft-pr" */
+  mode?: "draft-pr" | "direct-commit";
+  /** Branch that generated docs work should target. @default "main" */
+  baseBranch?: string;
+}
+interface DocsCloudFeatureConfig {
+  /** Whether the hosted cloud feature is enabled. @default true */
+  enabled?: boolean;
+}
+interface DocsCloudConfig {
+  /**
+   * Optional explicit cloud toggle.
+   *
+   * Prefer omitting this in new projects; the presence of `cloud` opts the
+   * project into cloud-aware CLI flows. This remains available for backwards
+   * compatibility with older docs.json files.
+   */
+  enabled?: boolean;
+  /** API key lookup used by `docs preview` and other cloud CLI commands. */
+  apiKey?: DocsCloudApiKeyConfig;
+  /** Hosted preview deployment settings. */
+  preview?: DocsCloudPreviewConfig;
+  /** Generated docs publishing settings. */
+  publish?: DocsCloudPublishConfig;
+  /** Hosted analytics settings that can be mirrored to docs.json. */
+  analytics?: boolean | Omit<DocsAnalyticsConfig, "onEvent">;
+  /** Hosted AI feature toggle. */
+  ai?: DocsCloudFeatureConfig;
+  /** Hosted deployment feature toggle. */
+  deploy?: DocsCloudFeatureConfig;
+}
 interface DocsObservabilityConfig {
   /** Enable trace emission. Defaults to `true` when this object is provided. */
   enabled?: boolean;
@@ -2287,6 +2334,23 @@ interface DocsConfig {
    * included unless `includeInputs: true` is set.
    */
   analytics?: boolean | DocsAnalyticsConfig;
+  /**
+   * Docs Cloud integration settings.
+   *
+   * Use this to configure the API key env var and cloud preview defaults once
+   * in `docs.config.ts`; cloud CLI commands mirror the serializable subset into
+   * `docs.json` automatically.
+   *
+   * @example
+   * ```ts
+   * cloud: {
+   *   apiKey: { env: "DOCS_CLOUD_API_KEY" },
+   *   preview: { enabled: true },
+   *   publish: { mode: "draft-pr", baseBranch: "main" },
+   * }
+   * ```
+   */
+  cloud?: DocsCloudConfig;
   /**
    * Built-in observability stream for agent traces, timing, errors, and runtime debugging.
    * This is separate from `analytics`; it emits span-like Ask AI and MCP trace events.
@@ -2722,4 +2786,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsReviewRulesConfig as $, DocsCodeBlocksConfig as A, OpenDocsProviderId as At, DocsFeedbackValue as B, ResolvedDocsRelatedLink as Bt, DocsAskAIActionData as C, LlmsTxtMaxCharsMode as Ct, DocsAskAIFeedbackMessage as D, OpenDocsConfig as Dt, DocsAskAIFeedbackData as E, OGConfig as Et, DocsCodeBlocksValidateConfig as F, PageFrontmatter as Ft, DocsNav as G, SidebarNode as Gt, DocsMcpConfig as H, SidebarConfig as Ht, DocsCodeBlocksValidationMode as I, PageOpenGraph as It, DocsObservabilityEventInput as J, SimpleDocsSearchConfig as Jt, DocsObservabilityConfig as K, SidebarPageNode as Kt, DocsCodeBlocksValidationPolicy as L, PageSidebarFrontmatter as Lt, DocsCodeBlocksPlannerProvider as M, OpenGraphImage as Mt, DocsCodeBlocksRunnerConfig as N, OrderingItem as Nt, DocsAskAIFeedbackValue as O, OpenDocsProvider as Ot, DocsCodeBlocksRunnerProvider as P, PageActionsConfig as Pt, DocsReviewConfig as Q, UIConfig as Qt, DocsConfig as R, PageTwitter as Rt, DocsAnalyticsSource as S, LlmsTxtMaxCharsConfig as St, DocsAskAIFeedbackConfig as T, McpDocsSearchConfig as Tt, DocsMcpToolsConfig as U, SidebarFolderIndexBehavior as Ut, DocsI18nConfig as V, SidebarComponentProps as Vt, DocsMetadata as W, SidebarFolderNode as Wt, DocsReviewCiConfig as X, TypesenseDocsSearchConfig as Xt, DocsRelatedItem as Y, ThemeToggleConfig as Yt, DocsReviewCiMode as Z, TypographyConfig as Zt, DocsAnalyticsConfig as _, FeedbackConfig as _t, ApiReferenceRenderer as a, DocsSearchAdapterContext as at, DocsAnalyticsEventType as b, LastUpdatedConfig as bt, ChangelogFrontmatter as c, DocsSearchConfig as ct, CustomDocsSearchConfig as d, DocsSearchQuery as dt, DocsReviewScoreConfig as et, DocsAgentFeedbackContext as f, DocsSearchResult as ft, DocsAgentTraceStatus as g, DocsTheme as gt, DocsAgentTraceEventType as h, DocsSitemapConfig as ht, ApiReferenceConfig as i, DocsSearchAdapter as it, DocsCodeBlocksPlannerConfig as j, OpenDocsTarget as jt, DocsAskAIMcpConfig as k, OpenDocsProviderConfig as kt, CodeBlockCopyData as l, DocsSearchDocument as lt, DocsAgentTraceEventInput as m, DocsSearchSourcePage as mt, AgentFeedbackConfig as n, DocsRobotsConfig as nt, BreadcrumbConfig as o, DocsSearchAdapterFactory as ot, DocsAgentFeedbackData as p, DocsSearchResultType as pt, DocsObservabilityEvent as q, SidebarTree as qt, AlgoliaDocsSearchConfig as r, DocsRobotsRule as rt, ChangelogConfig as s, DocsSearchChunkingConfig as st, AIConfig as t, DocsReviewSeverity as tt, CopyMarkdownConfig as u, DocsSearchEmbeddingsConfig as ut, DocsAnalyticsEvent as v, FontStyle as vt, DocsAskAIActionType as w, LlmsTxtSectionConfig as wt, DocsAnalyticsInput as x, LlmsTxtConfig as xt, DocsAnalyticsEventInput as y, GithubConfig as yt, DocsFeedbackData as z, ReadingTimeConfig as zt };
+export { DocsObservabilityEventInput as $, SimpleDocsSearchConfig as $t, DocsCloudApiKeyConfig as A, McpDocsSearchConfig as At, DocsCodeBlocksValidateConfig as B, PageFrontmatter as Bt, DocsAskAIActionData as C, FontStyle as Ct, DocsAskAIFeedbackMessage as D, LlmsTxtMaxCharsConfig as Dt, DocsAskAIFeedbackData as E, LlmsTxtConfig as Et, DocsCodeBlocksConfig as F, OpenDocsProviderId as Ft, DocsFeedbackValue as G, ResolvedDocsRelatedLink as Gt, DocsCodeBlocksValidationPolicy as H, PageSidebarFrontmatter as Ht, DocsCodeBlocksPlannerConfig as I, OpenDocsTarget as It, DocsMcpToolsConfig as J, SidebarFolderIndexBehavior as Jt, DocsI18nConfig as K, SidebarComponentProps as Kt, DocsCodeBlocksPlannerProvider as L, OpenGraphImage as Lt, DocsCloudFeatureConfig as M, OpenDocsConfig as Mt, DocsCloudPreviewConfig as N, OpenDocsProvider as Nt, DocsAskAIFeedbackValue as O, LlmsTxtMaxCharsMode as Ot, DocsCloudPublishConfig as P, OpenDocsProviderConfig as Pt, DocsObservabilityEvent as Q, SidebarTree as Qt, DocsCodeBlocksRunnerConfig as R, OrderingItem as Rt, DocsAnalyticsSource as S, FeedbackConfig as St, DocsAskAIFeedbackConfig as T, LastUpdatedConfig as Tt, DocsConfig as U, PageTwitter as Ut, DocsCodeBlocksValidationMode as V, PageOpenGraph as Vt, DocsFeedbackData as W, ReadingTimeConfig as Wt, DocsNav as X, SidebarNode as Xt, DocsMetadata as Y, SidebarFolderNode as Yt, DocsObservabilityConfig as Z, SidebarPageNode as Zt, DocsAnalyticsConfig as _, DocsSearchResult as _t, ApiReferenceRenderer as a, DocsReviewScoreConfig as at, DocsAnalyticsEventType as b, DocsSitemapConfig as bt, ChangelogFrontmatter as c, DocsRobotsRule as ct, CustomDocsSearchConfig as d, DocsSearchAdapterFactory as dt, ThemeToggleConfig as en, DocsRelatedItem as et, DocsAgentFeedbackContext as f, DocsSearchChunkingConfig as ft, DocsAgentTraceStatus as g, DocsSearchQuery as gt, DocsAgentTraceEventType as h, DocsSearchEmbeddingsConfig as ht, ApiReferenceConfig as i, DocsReviewRulesConfig as it, DocsCloudConfig as j, OGConfig as jt, DocsAskAIMcpConfig as k, LlmsTxtSectionConfig as kt, CodeBlockCopyData as l, DocsSearchAdapter as lt, DocsAgentTraceEventInput as m, DocsSearchDocument as mt, AgentFeedbackConfig as n, TypographyConfig as nn, DocsReviewCiMode as nt, BreadcrumbConfig as o, DocsReviewSeverity as ot, DocsAgentFeedbackData as p, DocsSearchConfig as pt, DocsMcpConfig as q, SidebarConfig as qt, AlgoliaDocsSearchConfig as r, UIConfig as rn, DocsReviewConfig as rt, ChangelogConfig as s, DocsRobotsConfig as st, AIConfig as t, TypesenseDocsSearchConfig as tn, DocsReviewCiConfig as tt, CopyMarkdownConfig as u, DocsSearchAdapterContext as ut, DocsAnalyticsEvent as v, DocsSearchResultType as vt, DocsAskAIActionType as w, GithubConfig as wt, DocsAnalyticsInput as x, DocsTheme as xt, DocsAnalyticsEventInput as y, DocsSearchSourcePage as yt, DocsCodeBlocksRunnerProvider as z, PageActionsConfig as zt };

package/dist/{upgrade-C7DvvfTR.mjs → upgrade-DDWolmHe.mjs}

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

package/package.json

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