@farming-labs/theme 0.2.33 → 0.2.34

package/dist/docs-api.d.mts

@@ -40,6 +40,8 @@ interface DocsAPIOptions {
   docsPath?: string;
   /** Override the docs content directory when it does not live in app/<entry>. */
   contentDir?: string;
+  /** Set when the docs site is built without runtime API routes. */
+  staticExport?: boolean;
   /** Changelog configuration. */
   changelog?: boolean | ChangelogConfig;
   /** Search language (default: "english") */

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, 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 { DEFAULT_SITEMAP_MD_DOCS_ROUTE, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsRobotsResponse, createDocsSitemapResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownVaryHeader, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsDiagnosticsRequest, 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
@@ -251,6 +251,7 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms, site
 		api: {
 			docs: DEFAULT_DOCS_API_ROUTE,
 			config: `${DEFAULT_DOCS_API_ROUTE}?format=config`,
+			diagnostics: `${DEFAULT_DOCS_API_ROUTE}?format=diagnostics`,
 			agentSpec: DEFAULT_AGENT_SPEC_ROUTE,
 			agentSpecDefault: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
 			agentSpecFallback: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
@@ -2428,6 +2429,16 @@ function createDocsAPI(options) {
 	setConfigMapFallback("i18n", i18nConfig ?? void 0);
 	setConfigMapFallback("mcp", rawMcpConfig);
 	setConfigMapFallback("apiReference", apiReferenceConfig);
+	const docsDiagnosticsInput = {
+		...docsConfigMapInput,
+		docsPath: docsConfigMapInput.docsPath ?? docsPath,
+		contentDir: docsConfigMapInput.contentDir ?? contentDir,
+		feedback: docsConfigMapInput.feedback ?? options?.feedback,
+		llmsTxt: docsConfigMapInput.llmsTxt ?? llmsConfig,
+		sitemap: docsConfigMapInput.sitemap ?? sitemapConfig,
+		robots: docsConfigMapInput.robots ?? robotsConfig,
+		staticExport: docsConfigMapInput.staticExport ?? options?.staticExport
+	};
 	function trackTelemetryRequest(request) {
 		emitDocsTelemetryProjectEvent(telemetryConfig, {
 			framework: "next",
@@ -2595,6 +2606,17 @@ function createDocsAPI(options) {
 				"Cache-Control": "public, max-age=0, s-maxage=3600",
 				"X-Robots-Tag": "noindex"
 			} });
+			if (isDocsDiagnosticsRequest(url)) return Response.json(buildDocsDiagnostics(docsDiagnosticsInput, {
+				adapter: "next",
+				entry,
+				i18n,
+				mcp: mcpConfig,
+				feedback: agentFeedbackConfig,
+				openapi: openapiDiscovery
+			}), { 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.33",
+  "version": "0.2.34",
   "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.33"
+    "@farming-labs/docs": "0.2.34"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",