@farming-labs/next 0.1.73 → 0.1.75

package/dist/config.mjs

@@ -85,6 +85,7 @@ export const { GET, POST } = createDocsAPI({
   changelog: docsConfig.changelog,
   feedback: docsConfig.feedback,
   mcp: docsConfig.mcp,
+  sitemap: docsConfig.sitemap,
   search: docsConfig.search,
   analytics: docsConfig.analytics,
   observability: docsConfig.observability,
@@ -171,6 +172,10 @@ const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
 const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
 const DEFAULT_SKILL_MD_ROUTE = "/skill.md";
 const DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE = "/.well-known/skill.md";
+const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
+const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
+const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
+const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
 const MARKDOWN_ACCEPT_HEADER_VALUE = [
 	"(?:^|.*,\\s*)",
 	"text/markdown",
@@ -720,6 +725,48 @@ function normalizeRoutePath(route) {
 	const normalized = `/${route}`.replace(/\/+/g, "/");
 	return normalized !== "/" ? normalized.replace(/\/+$/, "") : DEFAULT_MCP_ROUTE;
 }
+function normalizeRoutePrefix(prefix) {
+	if (!prefix) return "";
+	const normalized = `/${prefix.replace(/^\/+|\/+$/g, "")}`.replace(/\/+/g, "/");
+	return normalized === "/" ? "" : normalized;
+}
+function joinPublicRoute(prefix, route) {
+	return `${prefix}/${route.replace(/^\/+/, "")}`.replace(/\/+/g, "/");
+}
+function readSitemapConfig(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = join(root, `docs.config.${ext}`);
+		if (!existsSync(configPath)) continue;
+		try {
+			const content = readFileSync(configPath, "utf-8");
+			if (content.match(/sitemap\s*:\s*false/)) return {
+				enabled: false,
+				routePrefix: ""
+			};
+			if (content.match(/sitemap\s*:\s*true/)) return {
+				enabled: true,
+				routePrefix: ""
+			};
+			const block = extractObjectLiteral(content, "sitemap");
+			if (!block) continue;
+			const enabledMatch = block.match(/enabled\s*:\s*(true|false)/);
+			const routePrefixMatch = block.match(/routePrefix\s*:\s*["']([^"']+)["']/);
+			return {
+				enabled: enabledMatch ? enabledMatch[1] !== "false" : true,
+				routePrefix: normalizeRoutePrefix(routePrefixMatch?.[1])
+			};
+		} catch {
+			return {
+				enabled: false,
+				routePrefix: ""
+			};
+		}
+	}
+	return {
+		enabled: false,
+		routePrefix: ""
+	};
+}
 function normalizeAgentFeedbackRoute(route, fallback = DEFAULT_AGENT_FEEDBACK_ROUTE) {
 	if (!route || route.trim().length === 0) return fallback;
 	const normalized = `/${route}`.replace(/\/+/g, "/");
@@ -834,6 +881,24 @@ function buildSkillMdRewrites() {
 		destination: "/api/docs?format=skill"
 	}];
 }
+function buildSitemapRewrites(config) {
+	if (!config.enabled) return [];
+	const prefix = config.routePrefix;
+	return [
+		{
+			source: joinPublicRoute(prefix, DEFAULT_SITEMAP_XML_ROUTE),
+			destination: "/api/docs?format=sitemap-xml"
+		},
+		{
+			source: joinPublicRoute(prefix, DEFAULT_SITEMAP_MD_ROUTE),
+			destination: "/api/docs?format=sitemap-md"
+		},
+		{
+			source: joinPublicRoute(prefix, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE),
+			destination: "/api/docs?format=sitemap-md"
+		}
+	];
+}
 function buildMcpRewrites(config) {
 	if (!config.enabled) return [];
 	return [DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE].filter((source) => source !== config.route).map((source) => ({
@@ -962,12 +1027,13 @@ function buildHiddenFolderRedirects(docsDir, entry) {
 	scan(docsDir, []);
 	return dedupeRedirects(redirects);
 }
-function mergeDocsMarkdownRewrites(entry, mcp, agentFeedback, result) {
+function mergeDocsMarkdownRewrites(entry, mcp, sitemap, agentFeedback, result) {
 	const autoRewrites = [
 		...buildAgentSpecRewrites(),
 		...buildMcpRewrites(mcp),
 		...buildLlmsTxtRewrites(),
 		...buildSkillMdRewrites(),
+		...buildSitemapRewrites(sitemap),
 		...buildDocsMarkdownRewrites(entry),
 		...buildAgentFeedbackRewrites(agentFeedback)
 	];
@@ -1008,6 +1074,7 @@ function withDocs(nextConfig = {}) {
 		writeFileSync(join(docsApiRouteDir, "route.ts"), DOCS_API_ROUTE_TEMPLATE);
 	}
 	const mcp = readMcpConfig(root);
+	const sitemap = readSitemapConfig(root);
 	const docsMcpRouteDir = join(root, appDir, "api", "docs", "mcp");
 	if (mcp.enabled && mcp.route === DEFAULT_MCP_ROUTE && !isStaticExport && !hasFile(docsMcpRouteDir, "route")) {
 		mkdirSync(docsMcpRouteDir, { recursive: true });
@@ -1158,11 +1225,12 @@ function withDocs(nextConfig = {}) {
 	const existingTracingIncludes = nextConfig.outputFileTracingIncludes ?? {};
 	const docsTraceGlob = docsContentDir.replace(/\\/g, "/").replace(/^\.?\//, "") + "/**/*";
 	const skillTraceFile = "skill.md";
+	const sitemapManifestTraceFile = DEFAULT_SITEMAP_MANIFEST_PATH;
 	const docsContentRoot = isAbsolute(docsContentDir) ? docsContentDir : join(root, docsContentDir);
 	if (!isStaticExport) {
 		const existingRewrites = nextConfig.rewrites;
 		nextConfig.rewrites = async () => {
-			return mergeDocsMarkdownRewrites(entry, mcp, agentFeedback, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
+			return mergeDocsMarkdownRewrites(entry, mcp, sitemap, agentFeedback, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
 		};
 		const autoRedirects = buildHiddenFolderRedirects(docsContentRoot, entry);
 		if (autoRedirects.length > 0) {
@@ -1177,7 +1245,8 @@ function withDocs(nextConfig = {}) {
 		"/api/docs": [...new Set([
 			...existingTracingIncludes["/api/docs"] ?? [],
 			docsTraceGlob,
-			skillTraceFile
+			skillTraceFile,
+			sitemapManifestTraceFile
 		])],
 		[DEFAULT_MCP_ROUTE]: [...new Set([...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [], docsTraceGlob])]
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.1.73",
+  "version": "0.1.75",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -95,8 +95,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.73",
-    "@farming-labs/theme": "0.1.73"
+    "@farming-labs/docs": "0.1.75",
+    "@farming-labs/theme": "0.1.75"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",