@farming-labs/theme 0.2.31 → 0.2.33

package/dist/docs-api.mjs

@@ -3,7 +3,7 @@ import { getNextAppDir } from "./get-app-dir.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { DEFAULT_SITEMAP_MD_DOCS_ROUTE, buildDocsAskAIContext, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsRobotsResponse, createDocsSitemapResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownVaryHeader, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, normalizeDocsRelated, performDocsSearch, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownRecovery, resolveDocsMetadataBaseUrl, resolveDocsSitemapConfig, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent } from "@farming-labs/docs";
+import { DEFAULT_SITEMAP_MD_DOCS_ROUTE, buildDocsAskAIContext, buildDocsConfigMap, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsRobotsResponse, createDocsSitemapResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownVaryHeader, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, normalizeDocsRelated, performDocsSearch, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownRecovery, resolveDocsMetadataBaseUrl, resolveDocsSitemapConfig, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent } from "@farming-labs/docs";
 import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
@@ -250,6 +250,7 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms, site
 		},
 		api: {
 			docs: DEFAULT_DOCS_API_ROUTE,
+			config: `${DEFAULT_DOCS_API_ROUTE}?format=config`,
 			agentSpec: DEFAULT_AGENT_SPEC_ROUTE,
 			agentSpecDefault: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
 			agentSpecFallback: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
@@ -259,6 +260,10 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms, site
 			agents: `${DEFAULT_DOCS_API_ROUTE}?format=agents`,
 			openapi: `${DEFAULT_DOCS_API_ROUTE}?format=openapi`
 		},
+		config: {
+			format: "docs-config-map.v1",
+			endpoint: `${DEFAULT_DOCS_API_ROUTE}?format=config`
+		},
 		markdown: {
 			enabled: true,
 			acceptHeader: "text/markdown",
@@ -2410,6 +2415,19 @@ function createDocsAPI(options) {
 		apiReference: apiReferenceConfig,
 		metadata: options?.metadata
 	};
+	const { rootDir: _rootDir, language: _language, ...docsConfigMapOptions } = options ?? {};
+	const docsConfigMapInput = { ...docsConfigMapOptions };
+	const setConfigMapFallback = (key, value) => {
+		if (Object.prototype.hasOwnProperty.call(docsConfigMapInput, key) || value === void 0) return;
+		docsConfigMapInput[key] = value;
+	};
+	setConfigMapFallback("entry", entry);
+	setConfigMapFallback("ai", Object.keys(aiConfig).length > 0 ? aiConfig : void 0);
+	setConfigMapFallback("cloud", cloudConfig);
+	setConfigMapFallback("search", searchConfig);
+	setConfigMapFallback("i18n", i18nConfig ?? void 0);
+	setConfigMapFallback("mcp", rawMcpConfig);
+	setConfigMapFallback("apiReference", apiReferenceConfig);
 	function trackTelemetryRequest(request) {
 		emitDocsTelemetryProjectEvent(telemetryConfig, {
 			framework: "next",
@@ -2573,6 +2591,10 @@ function createDocsAPI(options) {
 			const ctx = resolveContextFromRequest(request);
 			const url = new URL(request.url);
 			const requestAnalyticsProperties = getRequestAnalyticsProperties(request);
+			if (isDocsConfigRequest(url)) return Response.json(buildDocsConfigMap(docsConfigMapInput), { headers: {
+				"Cache-Control": "public, max-age=0, s-maxage=3600",
+				"X-Robots-Tag": "noindex"
+			} });
 			if (resolveAgentSpecRequest(url)) {
 				await emitDocsAnalyticsEvent(analytics, {
 					type: "agent_spec_request",

package/package.json

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