@farming-labs/theme 0.1.28 → 0.1.30

package/dist/docs-api.mjs

@@ -156,6 +156,8 @@ function isSearchEnabled(search) {
 }
 function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 	const normalizedEntry = normalizePathSegment(entry) || "docs";
+	const localesEnabled = i18n !== null;
+	const searchEnabled = isSearchEnabled(search);
 	return {
 		version: "1",
 		name: "@farming-labs/docs",
@@ -167,12 +169,23 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 			baseUrl: llms.baseUrl ?? origin
 		},
 		locales: {
-			enabled: i18n !== null,
+			enabled: localesEnabled,
 			available: i18n?.locales ?? [],
 			default: i18n?.defaultLocale ?? null,
 			queryParam: "lang",
 			fallbackQueryParam: "locale"
 		},
+		capabilities: {
+			markdownRoutes: true,
+			agentMdOverrides: true,
+			agentBlocks: true,
+			llms: llms.enabled,
+			skills: true,
+			mcp: mcp.enabled,
+			search: searchEnabled,
+			agentFeedback: feedback.enabled,
+			locales: localesEnabled
+		},
 		api: {
 			docs: DEFAULT_DOCS_API_ROUTE,
 			agentSpec: DEFAULT_AGENT_SPEC_ROUTE,
@@ -180,6 +193,7 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 		},
 		markdown: {
 			enabled: true,
+			acceptHeader: "text/markdown",
 			pagePattern: `/${normalizedEntry}/{slug}.md`,
 			rootPage: `/${normalizedEntry}.md`,
 			apiPattern: `${DEFAULT_DOCS_API_ROUTE}?format=markdown&path={slug}`,
@@ -195,7 +209,7 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 			full: `${DEFAULT_DOCS_API_ROUTE}?format=llms-full`
 		},
 		search: {
-			enabled: isSearchEnabled(search),
+			enabled: searchEnabled,
 			endpoint: `${DEFAULT_DOCS_API_ROUTE}?query={query}`,
 			method: "GET",
 			queryParam: "query",
@@ -728,13 +742,30 @@ function findDocsMcpPage(entry, pages, requestedPath) {
 	for (const page of pages) if (normalizePathSegment(page.slug) === normalizedSlug) return page;
 	return null;
 }
-function resolveMarkdownRequest(entry, url) {
+function acceptsMarkdown(request) {
+	const accept = request.headers.get("accept");
+	if (!accept) return false;
+	return accept.split(",").map((value) => value.trim()).some((value) => {
+		const [mediaType, ...params] = value.split(";").map((part) => part.trim().toLowerCase());
+		if (mediaType !== "text/markdown") return false;
+		const qualityParam = params.find((param) => param.split("=", 1)[0]?.trim() === "q");
+		if (!qualityParam) return true;
+		const qualityValue = qualityParam.slice(qualityParam.indexOf("=") + 1).trim();
+		const quality = Number.parseFloat(qualityValue);
+		return Number.isFinite(quality) ? quality > 0 : true;
+	});
+}
+function resolveMarkdownRequest(entry, url, request) {
 	if (url.searchParams.get("format")?.trim() === "markdown") return { requestedPath: url.searchParams.get("path")?.trim() ?? "" };
 	const pathname = normalizeUrlPath(url.pathname);
 	const normalizedEntry = `/${normalizePathSegment(entry)}`;
 	if (pathname === `${normalizedEntry}.md`) return { requestedPath: "" };
 	const slugPrefix = `${normalizedEntry}/`;
 	if (pathname.startsWith(slugPrefix) && pathname.endsWith(".md")) return { requestedPath: pathname.slice(slugPrefix.length, -3) };
+	if (acceptsMarkdown(request)) {
+		if (pathname === normalizedEntry) return { requestedPath: "" };
+		if (pathname.startsWith(slugPrefix)) return { requestedPath: pathname.slice(slugPrefix.length) };
+	}
 	return null;
 }
 function renderMarkdownDocument(page) {
@@ -1041,7 +1072,7 @@ function createDocsAPI(options) {
 					"X-Robots-Tag": "noindex"
 				} });
 			}
-			const markdownRequest = resolveMarkdownRequest(entry, url);
+			const markdownRequest = resolveMarkdownRequest(entry, url, request);
 			if (markdownRequest) {
 				const document = await getMarkdownDocument(ctx, markdownRequest.requestedPath);
 				if (!document) return new Response("Not Found", {

package/package.json

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