@farming-labs/docs 0.1.1 → 0.1.2

package/dist/mcp-8rCBy2-U.mjs

@@ -0,0 +1,93 @@
+import "./api-reference-wh4_pwG8.mjs";
+import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
+import "./server.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+
+//#region src/cli/mcp.ts
+const FILE_EXTS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+async function runMcp(options = {}) {
+	const rootDir = process.cwd();
+	const content = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
+	const entry = readStringProperty(content, "entry") ?? "docs";
+	const contentDir = readStringProperty(content, "contentDir") ?? entry;
+	const navTitle = readNavTitle(content);
+	const mcp = readMcpConfig(content);
+	await runDocsMcpStdio({
+		source: createFilesystemDocsMcpSource({
+			rootDir,
+			entry,
+			contentDir,
+			siteTitle: navTitle ?? "Documentation"
+		}),
+		mcp: resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" }),
+		defaultName: navTitle ?? "@farming-labs/docs"
+	});
+}
+function resolveDocsConfigPath(rootDir, explicitPath) {
+	if (explicitPath) {
+		const resolvedPath = resolve(rootDir, explicitPath);
+		if (!existsSync(resolvedPath)) throw new Error(`Could not find docs config at ${explicitPath}.`);
+		return resolvedPath;
+	}
+	for (const ext of FILE_EXTS) {
+		const configPath = join(rootDir, `docs.config.${ext}`);
+		if (existsSync(configPath)) return configPath;
+	}
+	throw new Error("Could not find docs.config.ts or docs.config.tsx in the current project. Use --config to point at a custom path.");
+}
+function readStringProperty(content, key) {
+	return content.match(new RegExp(`${key}\\s*:\\s*["']([^"']+)["']`))?.[1];
+}
+function readNavTitle(content) {
+	const block = extractObjectLiteral(content, "nav");
+	if (!block) return void 0;
+	return readStringProperty(block, "title");
+}
+function readMcpConfig(content) {
+	if (content.match(/mcp\s*:\s*false/)) return false;
+	if (content.match(/mcp\s*:\s*true/)) return true;
+	const block = extractObjectLiteral(content, "mcp");
+	if (!block) return void 0;
+	return {
+		enabled: readBooleanProperty(block, "enabled"),
+		route: readStringProperty(block, "route"),
+		name: readStringProperty(block, "name"),
+		version: readStringProperty(block, "version"),
+		tools: {
+			listPages: readBooleanProperty(block, "listPages"),
+			readPage: readBooleanProperty(block, "readPage"),
+			searchDocs: readBooleanProperty(block, "searchDocs"),
+			getNavigation: readBooleanProperty(block, "getNavigation")
+		}
+	};
+}
+function readBooleanProperty(content, key) {
+	const match = content.match(new RegExp(`${key}\\s*:\\s*(true|false)`));
+	return match ? match[1] === "true" : void 0;
+}
+function extractObjectLiteral(content, key) {
+	const keyIndex = content.search(new RegExp(`${key}\\s*:\\s*\\{`));
+	if (keyIndex === -1) return void 0;
+	const braceStart = content.indexOf("{", keyIndex);
+	if (braceStart === -1) return void 0;
+	let depth = 0;
+	for (let index = braceStart; index < content.length; index += 1) {
+		const char = content[index];
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char !== "}") continue;
+		depth -= 1;
+		if (depth === 0) return content.slice(braceStart + 1, index);
+	}
+}
+
+//#endregion
+export { runMcp };

package/dist/mcp.d.mts

@@ -1,5 +1,5 @@
-import { u as DocsMcpConfig, w as OrderingItem } from "./types-Bd3kyFF1.mjs";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
+import { u as DocsMcpConfig, w as OrderingItem } from "./types-dqnMXLdw.mjs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
 interface DocsMcpPage {

package/dist/mcp.mjs

@@ -2,10 +2,10 @@ import fs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
 import matter from "gray-matter";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp";
-import { isInitializeRequest } from "@modelcontextprotocol/sdk/types";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 import * as z from "zod/v4";
 
 //#region src/mcp.ts

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-import { o as DocsConfig } from "./types-Bd3kyFF1.mjs";
+import { o as DocsConfig } from "./types-dqnMXLdw.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts

package/dist/upgrade-BbEyR_JB.mjs

@@ -0,0 +1,138 @@
+import { c as installCommand, i as detectPackageManagerFromLockfile, o as exec, s as fileExists, t as detectFramework } from "./utils-D5Wn7Q5E.mjs";
+import path from "node:path";
+import pc from "picocolors";
+import * as p from "@clack/prompts";
+
+//#region src/cli/upgrade.ts
+/**
+* Upgrade @farming-labs/* packages to latest.
+* Detects framework from package.json by default, or use --framework (next, tanstack-start, nuxt, sveltekit, astro).
+*/
+const PRESETS = [
+	"next",
+	"tanstack-start",
+	"nuxt",
+	"sveltekit",
+	"astro"
+];
+const PACKAGES_BY_FRAMEWORK = {
+	nextjs: [
+		"@farming-labs/docs",
+		"@farming-labs/theme",
+		"@farming-labs/next"
+	],
+	"tanstack-start": [
+		"@farming-labs/docs",
+		"@farming-labs/theme",
+		"@farming-labs/tanstack-start"
+	],
+	nuxt: [
+		"@farming-labs/docs",
+		"@farming-labs/nuxt",
+		"@farming-labs/nuxt-theme"
+	],
+	sveltekit: [
+		"@farming-labs/docs",
+		"@farming-labs/svelte",
+		"@farming-labs/svelte-theme"
+	],
+	astro: [
+		"@farming-labs/docs",
+		"@farming-labs/astro",
+		"@farming-labs/astro-theme"
+	]
+};
+function presetFromFramework(fw) {
+	return fw === "nextjs" ? "next" : fw;
+}
+function frameworkFromPreset(preset) {
+	return preset === "next" ? "nextjs" : preset;
+}
+/** Return package list for a framework (for testing and CLI). */
+function getPackagesForFramework(framework) {
+	return PACKAGES_BY_FRAMEWORK[framework];
+}
+/** Build the install command for upgrade (for testing). */
+function buildUpgradeCommand(framework, tag, pm) {
+	const packagesWithTag = PACKAGES_BY_FRAMEWORK[framework].map((name) => `${name}@${tag}`);
+	return `${installCommand(pm)} ${packagesWithTag.join(" ")}`;
+}
+async function upgrade(options = {}) {
+	const cwd = process.cwd();
+	const tag = options.tag ?? "latest";
+	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs upgrade ")));
+	if (!fileExists(path.join(cwd, "package.json"))) {
+		p.log.error("No package.json found in the current directory. Run this from your project root.");
+		process.exit(1);
+	}
+	let framework = null;
+	let preset;
+	if (options.framework) {
+		const raw = options.framework.toLowerCase().trim();
+		const normalized = raw === "nextjs" ? "next" : raw;
+		if (!PRESETS.includes(normalized)) {
+			p.log.error(`Invalid framework ${pc.cyan(options.framework)}. Use one of: ${PRESETS.map((t) => pc.cyan(t)).join(", ")}`);
+			process.exit(1);
+		}
+		preset = normalized;
+		framework = frameworkFromPreset(preset);
+	} else {
+		const detected = detectFramework(cwd);
+		if (!detected) {
+			p.log.error("Could not detect a supported framework (Next.js, TanStack Start, Nuxt, SvelteKit, Astro). Use " + pc.cyan("--framework <next|tanstack-start|nuxt|sveltekit|astro>") + " to specify.");
+			process.exit(1);
+		}
+		framework = detected;
+		preset = presetFromFramework(framework);
+	}
+	let pm = detectPackageManagerFromLockfile(cwd);
+	if (pm) p.log.info(`Detected ${pc.cyan(pm)} from lockfile`);
+	else {
+		const pmAnswer = await p.select({
+			message: "Which package manager do you want to use for this upgrade?",
+			options: [
+				{
+					value: "pnpm",
+					label: "pnpm",
+					hint: "Use pnpm add"
+				},
+				{
+					value: "npm",
+					label: "npm",
+					hint: "Use npm add"
+				},
+				{
+					value: "yarn",
+					label: "yarn",
+					hint: "Use yarn add"
+				},
+				{
+					value: "bun",
+					label: "bun",
+					hint: "Use bun add"
+				}
+			]
+		});
+		if (p.isCancel(pmAnswer)) {
+			p.outro(pc.red("Upgrade cancelled."));
+			process.exit(0);
+		}
+		pm = pmAnswer;
+		p.log.info(`Using ${pc.cyan(pm)} as package manager`);
+	}
+	const cmd = buildUpgradeCommand(framework, tag, pm);
+	const packages = getPackagesForFramework(framework);
+	p.log.step(`Upgrading ${preset} docs packages to ${tag}...`);
+	p.log.message(pc.dim(packages.join(", ")));
+	try {
+		exec(cmd, cwd);
+		p.log.success(`Packages upgraded to ${tag}.`);
+		p.outro(pc.green("Done. Run your dev server to confirm everything works."));
+	} catch {
+		p.log.error("Upgrade failed. Try running manually:\n  " + pc.cyan(cmd));
+		process.exit(1);
+	}
+}
+
+//#endregion
+export { upgrade };

package/dist/utils-D5Wn7Q5E.mjs

@@ -0,0 +1,145 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSync, spawn } from "node:child_process";
+
+//#region src/cli/utils.ts
+function detectFramework(cwd) {
+	const pkgPath = path.join(cwd, "package.json");
+	if (!fs.existsSync(pkgPath)) return null;
+	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	const allDeps = {
+		...pkg.dependencies,
+		...pkg.devDependencies
+	};
+	if (allDeps["next"]) return "nextjs";
+	if (allDeps["@tanstack/react-start"]) return "tanstack-start";
+	if (allDeps["@sveltejs/kit"]) return "sveltekit";
+	if (allDeps["astro"]) return "astro";
+	if (allDeps["nuxt"]) return "nuxt";
+	return null;
+}
+function detectPackageManagerFromLockfile(cwd) {
+	if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+	if (fs.existsSync(path.join(cwd, "bun.lockb")) || fs.existsSync(path.join(cwd, "bun.lock"))) return "bun";
+	if (fs.existsSync(path.join(cwd, "yarn.lock"))) return "yarn";
+	if (fs.existsSync(path.join(cwd, "package-lock.json"))) return "npm";
+	return null;
+}
+function installCommand(pm) {
+	return pm === "yarn" ? "yarn add" : `${pm} add`;
+}
+function devInstallCommand(pm) {
+	if (pm === "yarn") return "yarn add -D";
+	if (pm === "npm") return "npm install -D";
+	return `${pm} add -D`;
+}
+/**
+* Write a file, creating parent directories as needed.
+* Returns true if the file was written, false if it already existed and was skipped.
+*/
+function writeFileSafe(filePath, content, overwrite = false) {
+	if (fs.existsSync(filePath) && !overwrite) return false;
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	fs.writeFileSync(filePath, content, "utf-8");
+	return true;
+}
+/**
+* Check if a file exists.
+*/
+function fileExists(filePath) {
+	return fs.existsSync(filePath);
+}
+/**
+* Read a file, returning null if it does not exist.
+*/
+function readFileSafe(filePath) {
+	if (!fs.existsSync(filePath)) return null;
+	return fs.readFileSync(filePath, "utf-8");
+}
+/** Common locations where global CSS files live in Next.js / SvelteKit projects. */
+const GLOBAL_CSS_CANDIDATES = [
+	"app/globals.css",
+	"app/global.css",
+	"src/app/globals.css",
+	"src/app/global.css",
+	"src/app.css",
+	"src/styles/app.css",
+	"styles/globals.css",
+	"styles/global.css",
+	"src/styles/globals.css",
+	"src/styles/global.css",
+	"assets/css/main.css",
+	"assets/main.css"
+];
+/**
+* Find existing global CSS files in the project.
+* Returns relative paths that exist.
+*/
+function detectGlobalCssFiles(cwd) {
+	return GLOBAL_CSS_CANDIDATES.filter((rel) => fs.existsSync(path.join(cwd, rel)));
+}
+/**
+* Detect whether the Next.js project uses `app` or `src/app` for the App Router.
+* Returns the directory that exists; if both exist, prefers src/app; if neither, returns null.
+*/
+function detectNextAppDir(cwd) {
+	const hasSrcApp = fs.existsSync(path.join(cwd, "src", "app"));
+	const hasApp = fs.existsSync(path.join(cwd, "app"));
+	if (hasSrcApp) return "src/app";
+	if (hasApp) return "app";
+	return null;
+}
+/**
+* Run a shell command synchronously, inheriting stdio.
+*/
+function exec(command, cwd) {
+	execSync(command, {
+		cwd,
+		stdio: "inherit"
+	});
+}
+/**
+* Spawn a process and wait for a specific string in stdout,
+* then resolve with the child process (still running).
+*/
+function spawnAndWaitFor(command, args, cwd, waitFor, timeoutMs = 6e4) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			shell: true
+		});
+		let output = "";
+		const timer = setTimeout(() => {
+			child.kill();
+			reject(/* @__PURE__ */ new Error(`Timed out waiting for "${waitFor}" after ${timeoutMs}ms`));
+		}, timeoutMs);
+		child.stdout?.on("data", (data) => {
+			const text = data.toString();
+			output += text;
+			process.stdout.write(text);
+			if (output.includes(waitFor)) {
+				clearTimeout(timer);
+				resolve(child);
+			}
+		});
+		child.stderr?.on("data", (data) => {
+			process.stderr.write(data.toString());
+		});
+		child.on("error", (err) => {
+			clearTimeout(timer);
+			reject(err);
+		});
+		child.on("close", (code) => {
+			clearTimeout(timer);
+			if (!output.includes(waitFor)) reject(/* @__PURE__ */ new Error(`Process exited with code ${code} before "${waitFor}" appeared`));
+		});
+	});
+}
+
+//#endregion
+export { devInstallCommand as a, installCommand as c, writeFileSafe as d, detectPackageManagerFromLockfile as i, readFileSafe as l, detectGlobalCssFiles as n, exec as o, detectNextAppDir as r, fileExists as s, detectFramework as t, spawnAndWaitFor as u };

package/package.json

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