@farming-labs/docs 0.2.42 → 0.2.44

package/dist/cli/index.mjs

@@ -105,36 +105,36 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DAPFsEK8.mjs");
+		const { init } = await import("../init-Drt3Q3Y7.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
 		const { dev } = await import("../dev-CBha7knT.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { runCloudDeploy } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { runCloudPreview } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { runCloudDeploy } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { runCloudPreview } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { runCloudInit } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { syncCloudConfig } = await import("../cloud-C_Ok9rC5.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { runCloudCheck } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudCheck(cloudOptions);
 	} else if (parsedCommand.command === "cloud") {
 		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCloudHelp } = await import("../cloud-Cbgjl3Pk.mjs");
+		const { printCloudHelp } = await import("../cloud-C_Ok9rC5.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {

package/dist/{cloud-Cbgjl3Pk.mjs → cloud-C_Ok9rC5.mjs}

@@ -1,6 +1,6 @@
 import { n as markCliErrorReported } from "./errors-CW1LnxaQ.mjs";
 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-tiQCZ46q.mjs";
-import { t as detectFramework } from "./utils-D-xTRNuh.mjs";
+import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-D-xTRNuh.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -31,6 +31,7 @@ const CLOUD_CHECK_TARGETS = [
 	"analytics",
 	"ask-ai"
 ];
+const FUMADOCS_CONNECT_MARKER = "@farming-labs/docs cloud connect: fumadocs";
 function isRecord(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -51,6 +52,100 @@ function readPackageName(rootDir) {
 		return;
 	}
 }
+function readPackageJsonRecord(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 isRecord(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+function readPackageDependencies(rootDir) {
+	const packageJson = readPackageJsonRecord(rootDir);
+	const names = /* @__PURE__ */ new Set();
+	for (const key of [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies",
+		"optionalDependencies"
+	]) {
+		const dependencies = packageJson?.[key];
+		if (!isRecord(dependencies)) continue;
+		for (const name of Object.keys(dependencies)) names.add(name);
+	}
+	return names;
+}
+function hasFumadocsDependency(dependencies) {
+	return [...dependencies].some((name) => name === "fumadocs-core" || name === "fumadocs-ui" || name === "fumadocs-mdx" || name === "fumadocs-openapi" || name === "fumadocs-docgen");
+}
+function firstExistingFile(rootDir, candidates) {
+	return candidates.find((candidate) => fs.existsSync(path.join(rootDir, candidate)));
+}
+function hasMarkdownDescendant(rootDir, relativeDir) {
+	const absoluteDir = path.join(rootDir, relativeDir);
+	if (!fs.existsSync(absoluteDir)) return false;
+	const queue = [absoluteDir];
+	while (queue.length > 0) {
+		const current = queue.shift();
+		let entries;
+		try {
+			entries = fs.readdirSync(current, { withFileTypes: true });
+		} catch {
+			continue;
+		}
+		for (const entry of entries) {
+			const fullPath = path.join(current, entry.name);
+			if (entry.isDirectory()) {
+				queue.push(fullPath);
+				continue;
+			}
+			if (entry.isFile() && /\.(?:md|mdx)$/i.test(entry.name)) return true;
+		}
+	}
+	return false;
+}
+function detectFumadocsContentRoots(rootDir) {
+	const roots = [
+		"content/docs",
+		"src/content/docs",
+		"docs",
+		"content"
+	].filter((candidate) => hasMarkdownDescendant(rootDir, candidate));
+	return roots.filter((root) => !roots.some((other) => other !== root && other.startsWith(`${root}/`)));
+}
+function detectConnectedFumadocsProfile(rootDir) {
+	const dependencies = readPackageDependencies(rootDir);
+	const sourceConfig = firstExistingFile(rootDir, [
+		"source.config.ts",
+		"source.config.tsx",
+		"source.config.js",
+		"source.config.mjs",
+		"source.config.cjs"
+	]);
+	const sourceFile = firstExistingFile(rootDir, [
+		"lib/source.ts",
+		"lib/source.tsx",
+		"src/lib/source.ts",
+		"src/lib/source.tsx"
+	]);
+	const contentRoots = detectFumadocsContentRoots(rootDir);
+	if (!(hasFumadocsDependency(dependencies) || Boolean(sourceConfig) || Boolean(sourceFile)) || contentRoots.length === 0) return;
+	const framework = detectFramework(rootDir) ?? "nextjs";
+	const configFiles = [sourceConfig, sourceFile].filter((file) => Boolean(file));
+	const packageManager = detectPackageManagerFromProject(rootDir)?.packageManager;
+	return {
+		engine: "fumadocs",
+		runtime: framework,
+		appRoot: ".",
+		contentRoots,
+		configFiles,
+		...packageManager ? { packageManager } : {},
+		confidence: sourceConfig || sourceFile ? "high" : "medium",
+		reason: sourceConfig ? `Detected Fumadocs source config at ${sourceConfig}.` : "Detected Fumadocs dependencies and markdown content."
+	};
+}
 function runGit(rootDir, args) {
 	try {
 		return execFileSync("git", [
@@ -363,6 +458,19 @@ ${renderCloudConfigProperty("  ", apiKeyEnv)}
 });
 `;
 }
+function renderFumadocsConnectDocsConfig(apiKeyEnv, profile) {
+	const contentDir = profile.contentRoots[0] ?? "content/docs";
+	return `// ${FUMADOCS_CONNECT_MARKER}
+import { defineDocs } from "@farming-labs/docs";
+
+export default defineDocs({
+  entry: "docs",
+  contentDir: ${JSON.stringify(contentDir)},
+${renderAnalyticsConfigProperty("  ")}
+${renderCloudConfigProperty("  ", apiKeyEnv)}
+});
+`;
+}
 function normalizeEnvName(value, fallback) {
 	const normalized = value?.trim();
 	if (!normalized) return fallback;
@@ -373,7 +481,7 @@ function ensureDocsConfigCloudInit(options) {
 	const resolvedConfigPath = tryResolveDocsConfigPath(options.rootDir, options.configPath);
 	const configPath = resolvedConfigPath ?? path.join(options.rootDir, "docs.config.ts");
 	if (!resolvedConfigPath) {
-		fs.writeFileSync(configPath, renderCloudInitDocsConfig(options.apiKeyEnv), "utf-8");
+		fs.writeFileSync(configPath, options.docsInfraProfile ? renderFumadocsConnectDocsConfig(options.apiKeyEnv, options.docsInfraProfile) : renderCloudInitDocsConfig(options.apiKeyEnv), "utf-8");
 		return {
 			configPath,
 			created: true,
@@ -525,6 +633,13 @@ function resolveApiReferenceRoot(snapshot) {
 	if (!apiReferenceBlock) return void 0;
 	return readStringProperty(apiReferenceBlock, "path");
 }
+function resolveConnectedDocsProfile(params) {
+	if (!(params.snapshot.content?.includes(FUMADOCS_CONNECT_MARKER) || !params.snapshot.path)) return void 0;
+	const detectedProfile = detectConnectedFumadocsProfile(params.rootDir);
+	if (detectedProfile) return detectedProfile;
+	const existingProfile = params.existing?.extensions?.docsInfraProfile;
+	if (isRecord(existingProfile) && existingProfile.engine === "fumadocs" && Array.isArray(existingProfile.contentRoots)) return existingProfile;
+}
 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 ?? "");
@@ -540,17 +655,19 @@ function resolveSiteConfig(rootDir, snapshot, existing) {
 		...typeof description === "string" ? { description } : {}
 	};
 }
-function resolveDocsRoot(rootDir, snapshot, existing) {
+function resolveDocsRoot(rootDir, snapshot, existing, docsInfraProfile) {
+	if (docsInfraProfile?.contentRoots[0]) return docsInfraProfile.contentRoots[0];
 	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);
+function resolveDocsBlock(rootDir, snapshot, existing, docsInfraProfile) {
 	const existingDocs = existing?.docs;
-	const runtime = detectedFramework ?? existingDocs?.runtime ?? "nextjs";
+	if (!snapshot.path && existingDocs) return existingDocs;
+	const detectedFramework = detectFramework(rootDir);
+	const runtime = detectedFramework ?? docsInfraProfile?.runtime ?? existingDocs?.runtime ?? "nextjs";
 	if (!Boolean(snapshot.path || detectedFramework) && existingDocs) return existingDocs;
 	return {
 		mode: "framework",
@@ -558,12 +675,30 @@ function resolveDocsBlock(rootDir, snapshot, existing) {
 		root: existingDocs?.root || "."
 	};
 }
+function resolveExtensions(existing, docsInfraProfile, options = {}) {
+	const existingExtensions = toJsonRecord(existing?.extensions);
+	if (!docsInfraProfile) {
+		if (!existingExtensions?.docsInfraProfile || options.dropStaleDocsInfraProfile === false) return existingExtensions;
+		const { docsInfraProfile: _staleDocsInfraProfile, ...rest } = existingExtensions;
+		return Object.keys(rest).length > 0 ? rest : void 0;
+	}
+	return {
+		...existingExtensions,
+		docsInfraProfile: toJsonRecord(docsInfraProfile)
+	};
+}
 function materializeDocsJsonObject(params) {
 	const cloud = resolveCloudConfig(params.snapshot, params.existing);
-	const docsRoot = resolveDocsRoot(params.rootDir, params.snapshot, params.existing);
+	const docsInfraProfile = params.docsInfraProfile ?? (params.detectConnectedDocsProfile === false ? void 0 : resolveConnectedDocsProfile({
+		rootDir: params.rootDir,
+		snapshot: params.snapshot,
+		existing: params.existing
+	}));
+	const docsRoot = resolveDocsRoot(params.rootDir, params.snapshot, params.existing, docsInfraProfile);
 	const apiReferenceRoot = resolveApiReferenceRoot(params.snapshot);
 	const existingContent = toJsonRecord(params.existing?.content);
 	const site = resolveSiteConfig(params.rootDir, params.snapshot, params.existing);
+	const extensions = resolveExtensions(params.existing, docsInfraProfile, { dropStaleDocsInfraProfile: params.dropStaleDocsInfraProfile });
 	const content = {
 		...existingContent,
 		docsRoot,
@@ -573,37 +708,65 @@ function materializeDocsJsonObject(params) {
 		...params.existing,
 		$schema: params.existing?.$schema ?? DOCS_CLOUD_SCHEMA_URL,
 		version: 1,
-		docs: resolveDocsBlock(params.rootDir, params.snapshot, params.existing),
+		docs: resolveDocsBlock(params.rootDir, params.snapshot, params.existing, docsInfraProfile),
 		content,
 		...site ? { site } : {},
-		cloud
+		cloud,
+		...extensions ? { extensions } : {}
 	};
 }
 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);
+function withCloudInitDefaults(cloud, existingCloud, apiKeyEnv) {
+	const normalized = normalizeCloudConfig(cloud);
+	if (!existingCloud?.apiKey?.env) normalized.apiKey = { env: apiKeyEnv };
+	if (!normalized.deploy) normalized.deploy = { enabled: true };
+	if (typeof normalized.analytics === "undefined") normalized.analytics = {
+		enabled: true,
+		console: false,
+		includeInputs: false
+	};
+	return normalizeCloudConfig(normalized);
+}
+function writeMaterializedCloudConfig(params) {
 	const config = materializeDocsJsonObject({
-		rootDir,
-		snapshot,
-		existing
+		rootDir: params.rootDir,
+		snapshot: params.snapshot,
+		existing: params.existing,
+		docsInfraProfile: params.docsInfraProfile,
+		detectConnectedDocsProfile: params.detectConnectedDocsProfile,
+		dropStaleDocsInfraProfile: params.dropStaleDocsInfraProfile
 	});
+	if (params.cloudInitApiKeyEnv) config.cloud = withCloudInitDefaults(config.cloud, params.existing?.cloud, params.cloudInitApiKeyEnv);
 	const serialized = serializeMaterializedDocsJson(config);
-	const updated = (existing ? fs.readFileSync(docsJsonPath, "utf-8") : void 0) !== serialized;
-	if (updated) fs.writeFileSync(docsJsonPath, serialized, "utf-8");
+	const updated = (params.existing ? fs.readFileSync(params.docsJsonPath, "utf-8") : void 0) !== serialized;
+	if (updated) fs.writeFileSync(params.docsJsonPath, serialized, "utf-8");
 	return {
-		configPath: snapshot.path ?? docsJsonPath,
-		docsJsonPath,
+		configPath: params.snapshot.path ?? params.docsJsonPath,
+		docsJsonPath: params.docsJsonPath,
 		config,
 		apiKeyEnv: config.cloud?.apiKey?.env ?? DOCS_CLOUD_DEFAULT_API_KEY_ENV,
-		created: !existing,
+		created: !params.existing,
 		updated
 	};
 }
+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 useDocsJsonAsSource = Boolean(existing && !snapshot.path);
+	return writeMaterializedCloudConfig({
+		rootDir,
+		docsJsonPath,
+		existing,
+		snapshot,
+		docsInfraProfile: options.docsInfraProfile,
+		detectConnectedDocsProfile: !useDocsJsonAsSource,
+		dropStaleDocsInfraProfile: !useDocsJsonAsSource
+	});
+}
 function readCombinedEnv(rootDir) {
 	const env = { ...loadProjectEnv(rootDir) };
 	for (const [key, value] of Object.entries(process.env)) if (typeof value === "string") env[key] = value;
@@ -1277,16 +1440,46 @@ async function syncCloudConfig(options = {}) {
 }
 async function initCloudConfig(options = {}) {
 	const rootDir = options.rootDir ?? process.cwd();
+	const docsJsonPath = path.join(rootDir, DOCS_JSON_FILE);
+	const existingDocsJson = readExistingDocsJson(docsJsonPath);
 	const apiKeyEnv = normalizeEnvName(options.apiKeyEnv, DOCS_CLOUD_DEFAULT_API_KEY_ENV);
+	const existingConfigPath = tryResolveDocsConfigPath(rootDir, options.configPath);
+	const useDocsJsonAsSource = Boolean(existingDocsJson && !existingConfigPath);
+	const docsInfraProfile = options.docsInfraProfile ?? (existingConfigPath || existingDocsJson ? void 0 : detectConnectedFumadocsProfile(rootDir));
+	if (useDocsJsonAsSource) {
+		const materialized = writeMaterializedCloudConfig({
+			rootDir,
+			docsJsonPath,
+			existing: existingDocsJson,
+			snapshot: {},
+			docsInfraProfile,
+			cloudInitApiKeyEnv: apiKeyEnv,
+			detectConnectedDocsProfile: false,
+			dropStaleDocsInfraProfile: false
+		});
+		return {
+			configPath: materialized.configPath,
+			docsJsonPath: materialized.docsJsonPath,
+			apiKeyEnv: materialized.apiKeyEnv,
+			analyticsProjectIdEnv: DOCS_CLOUD_DEFAULT_ANALYTICS_PROJECT_ID_ENV,
+			configCreated: false,
+			configUpdated: false,
+			docsJsonCreated: false,
+			docsJsonUpdated: materialized.updated,
+			...docsInfraProfile ? { docsInfraProfile } : {}
+		};
+	}
 	const configUpdate = ensureDocsConfigCloudInit({
 		rootDir,
 		configPath: options.configPath,
-		apiKeyEnv
+		apiKeyEnv,
+		docsInfraProfile
 	});
 	const materialized = await materializeCloudConfig({
 		...options,
 		rootDir,
-		configPath: path.relative(rootDir, configUpdate.configPath)
+		configPath: path.relative(rootDir, configUpdate.configPath),
+		docsInfraProfile
 	});
 	return {
 		configPath: configUpdate.configPath,
@@ -1296,7 +1489,8 @@ async function initCloudConfig(options = {}) {
 		configCreated: configUpdate.created,
 		configUpdated: configUpdate.updated,
 		docsJsonCreated: materialized.created,
-		docsJsonUpdated: materialized.updated
+		docsJsonUpdated: materialized.updated,
+		...docsInfraProfile ? { docsInfraProfile } : {}
 	};
 }
 async function runCloudInit(options = {}) {
@@ -1311,6 +1505,7 @@ async function runCloudInit(options = {}) {
 	const docsJsonAction = result.docsJsonCreated ? "created" : result.docsJsonUpdated ? "updated" : "checked";
 	console.log(`${pc.green("ok")} ${configAction} ${pc.cyan(relativeConfigPath)}`);
 	console.log(`${pc.green("ok")} ${docsJsonAction} ${pc.cyan(relativeDocsJsonPath)}`);
+	if (result.docsInfraProfile?.engine === "fumadocs") console.log(`${pc.green("ok")} Connected existing ${pc.cyan("Fumadocs")} content at ${pc.cyan(result.docsInfraProfile.contentRoots.join(", "))}`);
 	console.log();
 	console.log(pc.bold("Add these env vars"));
 	console.log(`${pc.cyan(result.apiKeyEnv)}=${pc.dim("paste_your_docs_cloud_api_key")}`);

package/dist/{init-DAPFsEK8.mjs → init-Drt3Q3Y7.mjs}

@@ -188,7 +188,7 @@ async function configureDocsCloudOnboarding(options) {
 		enabled = cloudAnswer;
 	}
 	if (!enabled) return;
-	const { initCloudConfig } = await import("./cloud-Cbgjl3Pk.mjs");
+	const { initCloudConfig } = await import("./cloud-C_Ok9rC5.mjs");
 	printDocsCloudOnboardingInstructions(await initCloudConfig({
 		rootDir: options.rootDir,
 		configPath: getDocsCloudConfigPathForFramework(options.framework)

package/package.json

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