@farming-labs/theme 0.1.1-beta.2 → 0.1.1

package/dist/docs-api.d.mts

@@ -1,4 +1,4 @@
-import { DocsI18nConfig } from "@farming-labs/docs";
+import { DocsI18nConfig, DocsMcpConfig, OrderingItem } from "@farming-labs/docs";
 
 //#region src/docs-api.d.ts
 interface AIProviderConfig {
@@ -35,6 +35,16 @@ interface DocsAPIOptions {
   /** i18n config (optional) */
   i18n?: DocsI18nConfig;
 }
+interface DocsMCPAPIOptions {
+  rootDir?: string;
+  entry?: string;
+  contentDir?: string;
+  nav?: {
+    title?: unknown;
+  };
+  ordering?: "alphabetical" | "numeric" | OrderingItem[];
+  mcp?: boolean | DocsMcpConfig;
+}
 /**
  * Create a unified docs API route handler.
  *
@@ -66,5 +76,15 @@ declare function createDocsAPI(options?: DocsAPIOptions): {
    */
   POST(request: Request): Promise<Response>;
 };
+/**
+ * Create MCP route handlers for `/api/docs/mcp`.
+ *
+ * Returns `{ GET, POST, DELETE }` for use in a Next.js route handler.
+ */
+declare function createDocsMCPAPI(options?: DocsMCPAPIOptions): {
+  GET(request: Request): Promise<Response>;
+  POST(request: Request): Promise<Response>;
+  DELETE(request: Request): Promise<Response>;
+};
 //#endregion
-export { createDocsAPI };
+export { createDocsAPI, createDocsMCPAPI };

package/dist/docs-api.mjs

@@ -5,6 +5,7 @@ import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
 import { createSearchAPI } from "fumadocs-core/search/server";
+import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
 /**
@@ -90,6 +91,190 @@ function readAIConfig(root) {
 	}
 	return {};
 }
+function readMcpConfig(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = path.join(root, `docs.config.${ext}`);
+		if (!fs.existsSync(configPath)) continue;
+		try {
+			const content = fs.readFileSync(configPath, "utf-8");
+			const sanitized = stripCommentsAndStrings(content);
+			const configObject = extractRootConfigObject(content, sanitized);
+			const scopedContent = configObject?.content ?? content;
+			const scopedSanitized = configObject?.sanitized ?? sanitized;
+			const booleanValue = readTopLevelBoolean(scopedSanitized, "mcp");
+			if (booleanValue !== void 0) return booleanValue;
+			const block = extractObjectLiteral(scopedContent, scopedSanitized, "mcp");
+			if (!block) continue;
+			return {
+				enabled: readBooleanFromBlock(block, "enabled"),
+				route: readStringFromBlock(block, "route"),
+				name: readStringFromBlock(block, "name"),
+				version: readStringFromBlock(block, "version"),
+				tools: {
+					listPages: readBooleanFromBlock(block, "listPages"),
+					readPage: readBooleanFromBlock(block, "readPage"),
+					searchDocs: readBooleanFromBlock(block, "searchDocs"),
+					getNavigation: readBooleanFromBlock(block, "getNavigation")
+				}
+			};
+		} catch {}
+	}
+}
+function readStringFromBlock(block, key) {
+	return block.match(new RegExp(`${key}\\s*:\\s*["']([^"']+)["']`))?.[1];
+}
+function readBooleanFromBlock(block, key) {
+	const match = block.match(new RegExp(`${key}\\s*:\\s*(true|false)`));
+	return match ? match[1] === "true" : void 0;
+}
+function extractObjectLiteral(content, sanitized, key) {
+	const keyIndex = findTopLevelPropertyIndex(sanitized, key);
+	if (keyIndex === -1) return void 0;
+	const colonIndex = sanitized.indexOf(":", keyIndex + key.length);
+	if (colonIndex === -1) return void 0;
+	const braceStart = sanitized.indexOf("{", colonIndex);
+	if (braceStart === -1) return void 0;
+	let depth = 0;
+	for (let index = braceStart; index < sanitized.length; index += 1) {
+		const char = sanitized[index];
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char !== "}") continue;
+		depth -= 1;
+		if (depth === 0) return content.slice(braceStart + 1, index);
+	}
+}
+function readTopLevelBoolean(content, key) {
+	const keyIndex = findTopLevelPropertyIndex(content, key);
+	if (keyIndex === -1) return void 0;
+	const match = content.slice(keyIndex + key.length).match(/^\s*:\s*(true|false)\b/);
+	if (!match) return void 0;
+	return match[1] === "true";
+}
+function findTopLevelPropertyIndex(content, key) {
+	let depth = 0;
+	for (let index = 0; index < content.length; index += 1) {
+		const char = content[index];
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char === "}") {
+			depth = Math.max(0, depth - 1);
+			continue;
+		}
+		if (depth !== 0) continue;
+		if (!content.startsWith(key, index)) continue;
+		const previous = index === 0 ? "" : content[index - 1];
+		if (previous && /[\w$]/.test(previous)) continue;
+		const next = content[index + key.length] ?? "";
+		if (next && /[\w$]/.test(next)) continue;
+		if (!content.slice(index + key.length).match(/^\s*:/)) continue;
+		return index;
+	}
+	return -1;
+}
+function extractRootConfigObject(content, sanitized) {
+	const defineDocsIndex = sanitized.indexOf("defineDocs");
+	const exportDefaultIndex = sanitized.indexOf("export default");
+	let braceStart = -1;
+	if (defineDocsIndex !== -1) {
+		const parenIndex = sanitized.indexOf("(", defineDocsIndex);
+		if (parenIndex !== -1) braceStart = sanitized.indexOf("{", parenIndex);
+	}
+	if (braceStart === -1 && exportDefaultIndex !== -1) braceStart = sanitized.indexOf("{", exportDefaultIndex);
+	if (braceStart === -1) return void 0;
+	let depth = 0;
+	for (let index = braceStart; index < sanitized.length; index += 1) {
+		const char = sanitized[index];
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char !== "}") continue;
+		depth -= 1;
+		if (depth === 0) return {
+			content: content.slice(braceStart + 1, index),
+			sanitized: sanitized.slice(braceStart + 1, index)
+		};
+	}
+}
+function stripCommentsAndStrings(content) {
+	let result = "";
+	let index = 0;
+	let state = "normal";
+	while (index < content.length) {
+		const char = content[index];
+		const next = content[index + 1];
+		if (state === "lineComment") {
+			if (char === "\n") {
+				state = "normal";
+				result += "\n";
+			} else result += " ";
+			index += 1;
+			continue;
+		}
+		if (state === "blockComment") {
+			if (char === "*" && next === "/") {
+				result += "  ";
+				index += 2;
+				state = "normal";
+			} else {
+				result += char === "\n" ? "\n" : " ";
+				index += 1;
+			}
+			continue;
+		}
+		if (state === "singleQuote" || state === "doubleQuote" || state === "template") {
+			const quote = state === "singleQuote" ? "'" : state === "doubleQuote" ? "\"" : "`";
+			if (char === "\\") {
+				result += " ";
+				if (next) result += next === "\n" ? "\n" : " ";
+				index += 2;
+				continue;
+			}
+			result += char === "\n" ? "\n" : " ";
+			if (char === quote) state = "normal";
+			index += 1;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			result += "  ";
+			index += 2;
+			state = "lineComment";
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			result += "  ";
+			index += 2;
+			state = "blockComment";
+			continue;
+		}
+		if (char === "'") {
+			result += " ";
+			index += 1;
+			state = "singleQuote";
+			continue;
+		}
+		if (char === "\"") {
+			result += " ";
+			index += 1;
+			state = "doubleQuote";
+			continue;
+		}
+		if (char === "`") {
+			result += " ";
+			index += 1;
+			state = "template";
+			continue;
+		}
+		result += char;
+		index += 1;
+	}
+	return result;
+}
 function stripMdx(raw) {
 	const { content } = matter(raw);
 	return content.replace(/^(import|export)\s.*$/gm, "").replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/```[\s\S]*?```/g, "").replace(/`([^`]+)`/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
@@ -353,6 +538,40 @@ function createDocsAPI(options) {
 		}
 	};
 }
+/**
+* Create MCP route handlers for `/api/docs/mcp`.
+*
+* Returns `{ GET, POST, DELETE }` for use in a Next.js route handler.
+*/
+function createDocsMCPAPI(options = {}) {
+	const rootDir = options.rootDir ?? process.cwd();
+	const entry = options.entry ?? readEntry(rootDir);
+	const appDir = getNextAppDir(rootDir);
+	const contentDir = options.contentDir ?? path.join(appDir, entry);
+	const navTitle = typeof options.nav?.title === "string" && options.nav.title.trim().length > 0 ? options.nav.title : "Documentation";
+	const handlers = createDocsMcpHttpHandler({
+		source: createFilesystemDocsMcpSource({
+			rootDir,
+			entry,
+			contentDir,
+			siteTitle: navTitle,
+			ordering: options.ordering
+		}),
+		mcp: options.mcp ?? readMcpConfig(rootDir),
+		defaultName: navTitle
+	});
+	return {
+		GET(request) {
+			return handlers.GET({ request });
+		},
+		POST(request) {
+			return handlers.POST({ request });
+		},
+		DELETE(request) {
+			return handlers.DELETE({ request });
+		}
+	};
+}
 
 //#endregion
-export { createDocsAPI };
+export { createDocsAPI, createDocsMCPAPI };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.1-beta.2",
+  "version": "0.1.1",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -127,7 +127,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.1-beta.2"
+    "@farming-labs/docs": "0.1.1"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",