@farming-labs/next 0.1.77 → 0.1.79

package/dist/changelog.mjs

@@ -438,7 +438,7 @@ function createNextChangelogIndexMetadata(config) {
 	return createPageMetadata(config, {
 		title: changelog.title,
 		description: changelog.description
-	});
+	}, void 0, getListingUrl(config));
 }
 function createNextChangelogEntryMetadata(config, entries) {
 	return async function generateMetadata(props) {
@@ -449,12 +449,12 @@ function createNextChangelogEntryMetadata(config, entries) {
 			return createPageMetadata(config, {
 				title: changelog.title,
 				description: changelog.description
-			});
+			}, void 0, getListingUrl(config));
 		}
 		return createPageMetadata(config, {
 			title: entry.title,
 			description: entry.description
-		});
+		}, void 0, `${getListingUrl(config)}/${entry.slug}`);
 	};
 }
 

package/dist/config.mjs

@@ -92,6 +92,44 @@ export const { GET, POST } = createDocsAPI({
   ai: docsConfig.ai,
 });
 
+export const revalidate = false;
+`;
+const DOCS_MARKDOWN_ROUTE_TEMPLATE = `\
+${GENERATED_BANNER}
+import docsConfig from "@/docs.config";
+import { createDocsAPI } from "@farming-labs/next/api";
+
+const docsApi = createDocsAPI({
+  entry: docsConfig.entry,
+  contentDir: docsConfig.contentDir,
+  i18n: docsConfig.i18n,
+  changelog: docsConfig.changelog,
+  feedback: docsConfig.feedback,
+  mcp: docsConfig.mcp,
+  sitemap: docsConfig.sitemap,
+  search: docsConfig.search,
+  analytics: docsConfig.analytics,
+  observability: docsConfig.observability,
+  ai: docsConfig.ai,
+});
+
+type MarkdownRouteContext = {
+  params?: Promise<{ slug?: string[] }> | { slug?: string[] };
+};
+
+export async function GET(request: Request, context: MarkdownRouteContext = {}) {
+  const params = context.params ? await context.params : undefined;
+  const slug = params?.slug?.join("/") ?? "";
+  const url = new URL(request.url);
+
+  url.pathname = "/api/docs";
+  url.search = "";
+  url.searchParams.set("format", "markdown");
+  if (slug) url.searchParams.set("path", slug);
+
+  return docsApi.GET(new Request(url.toString(), request));
+}
+
 export const revalidate = false;
 `;
 const DOCS_MCP_ROUTE_TEMPLATE = `\
@@ -231,6 +269,7 @@ function createDocsWorkspaceAliases() {
 		"@farming-labs/next/mdx-plugins/rehype-toc": "./packages/next/src/mdx-plugins/rehype-toc.ts",
 		"@farming-labs/next/mdx-plugins/remark-heading": "./packages/next/src/mdx-plugins/remark-heading.ts",
 		"@farming-labs/next/mdx-plugins/remark-og": "./packages/next/src/mdx-plugins/remark-og.ts",
+		"@farming-labs/next/mdx-plugins/remark-markdown-alternate": "./packages/next/src/mdx-plugins/remark-markdown-alternate.ts",
 		"@farming-labs/theme": "./packages/fumadocs/src/index.ts",
 		"@farming-labs/theme/api": "./packages/fumadocs/src/docs-api.ts",
 		"@farming-labs/theme/client-hooks": "./packages/fumadocs/src/docs-client-hooks.tsx",
@@ -815,6 +854,10 @@ function buildDocsMarkdownRewrites(entry) {
 		key: "accept",
 		value: MARKDOWN_ACCEPT_HEADER_VALUE
 	};
+	const markdownSignatureAgentHeader = {
+		type: "header",
+		key: "signature-agent"
+	};
 	return [
 		{
 			source: `/${normalizedEntry}.md`,
@@ -833,6 +876,16 @@ function buildDocsMarkdownRewrites(entry) {
 			source: `/${normalizedEntry}/:slug*`,
 			has: [markdownAcceptHeader],
 			destination: "/api/docs?format=markdown&path=:slug*"
+		},
+		{
+			source: `/${normalizedEntry}`,
+			has: [markdownSignatureAgentHeader],
+			destination: "/api/docs/markdown"
+		},
+		{
+			source: `/${normalizedEntry}/:slug*`,
+			has: [markdownSignatureAgentHeader],
+			destination: "/api/docs/markdown/:slug*"
 		}
 	];
 }
@@ -920,7 +973,12 @@ function dedupeRewrites(rewrites) {
 	const seen = /* @__PURE__ */ new Set();
 	const result = [];
 	for (const rewrite of rewrites) {
-		const key = `${rewrite.source}=>${rewrite.destination}`;
+		const key = JSON.stringify({
+			source: rewrite.source,
+			destination: rewrite.destination,
+			has: rewrite.has ?? [],
+			missing: rewrite.missing ?? []
+		});
 		if (seen.has(key)) continue;
 		seen.add(key);
 		result.push(rewrite);
@@ -1073,6 +1131,12 @@ function withDocs(nextConfig = {}) {
 		mkdirSync(docsApiRouteDir, { recursive: true });
 		writeFileSync(join(docsApiRouteDir, "route.ts"), DOCS_API_ROUTE_TEMPLATE);
 	}
+	const docsMarkdownRouteDir = join(root, appDir, "api", "docs", "markdown", "[[...slug]]");
+	const docsMarkdownRoutePath = join(docsMarkdownRouteDir, "route.ts");
+	if (!isStaticExport && (!hasFile(docsMarkdownRouteDir, "route") || isManagedGeneratedFile(docsMarkdownRoutePath))) {
+		mkdirSync(docsMarkdownRouteDir, { recursive: true });
+		writeFileSync(docsMarkdownRoutePath, DOCS_MARKDOWN_ROUTE_TEMPLATE);
+	}
 	const mcp = readMcpConfig(root);
 	const sitemap = readSitemapConfig(root);
 	const docsMcpRouteDir = join(root, appDir, "api", "docs", "mcp");
@@ -1149,6 +1213,12 @@ function withDocs(nextConfig = {}) {
 	const ogEndpoint = readOgEndpoint(root);
 	const remarkPlugins = ["remark-gfm", "remark-frontmatter"];
 	if (ogEndpoint) remarkPlugins.push(["@farming-labs/next/mdx-plugins/remark-og", { endpoint: ogEndpoint }]);
+	remarkPlugins.push(["@farming-labs/next/mdx-plugins/remark-markdown-alternate", {
+		entry,
+		appDir,
+		contentDir: docsContentDir,
+		enabled: !isStaticExport
+	}]);
 	remarkPlugins.push(["remark-mdx-frontmatter", { name: "metadata" }], "@farming-labs/next/mdx-plugins/remark-heading");
 	const withMDX = createMDX({
 		extension: /\.mdx?$/,
@@ -1206,6 +1276,7 @@ function withDocs(nextConfig = {}) {
 			"@farming-labs/next/changelog": join(workspaceRoot, "packages", "next", "dist", "changelog.mjs"),
 			"@farming-labs/next/client-callbacks": join(workspaceRoot, "packages", "next", "dist", "client-callbacks.mjs"),
 			"@farming-labs/next/layout": join(workspaceRoot, "packages", "next", "dist", "layout.mjs"),
+			"@farming-labs/next/mdx-plugins/remark-markdown-alternate": join(workspaceRoot, "packages", "next", "dist", "mdx-plugins", "remark-markdown-alternate.mjs"),
 			"@farming-labs/theme$": join(workspaceRoot, "packages", "fumadocs", "dist", "index.mjs"),
 			"@farming-labs/theme/api": join(workspaceRoot, "packages", "fumadocs", "dist", "docs-api.mjs")
 		});
@@ -1248,6 +1319,18 @@ function withDocs(nextConfig = {}) {
 			skillTraceFile,
 			sitemapManifestTraceFile
 		])],
+		"/api/docs/markdown": [...new Set([
+			...existingTracingIncludes["/api/docs/markdown"] ?? [],
+			docsTraceGlob,
+			skillTraceFile,
+			sitemapManifestTraceFile
+		])],
+		"/api/docs/markdown/:path*": [...new Set([
+			...existingTracingIncludes["/api/docs/markdown/:path*"] ?? [],
+			docsTraceGlob,
+			skillTraceFile,
+			sitemapManifestTraceFile
+		])],
 		[DEFAULT_MCP_ROUTE]: [...new Set([...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [], docsTraceGlob])]
 	};
 	return withMDX(nextConfig);

package/dist/mdx-plugins/remark-markdown-alternate.d.mts

@@ -0,0 +1,20 @@
+//#region src/mdx-plugins/remark-markdown-alternate.d.ts
+interface RemarkMarkdownAlternateOptions {
+  entry?: string;
+  appDir?: string;
+  contentDir?: string;
+  enabled?: boolean;
+}
+interface MarkdownNode {
+  type: string;
+  value?: string;
+}
+interface VFileLike {
+  path?: string;
+  history?: string[];
+}
+declare function remarkMarkdownAlternate(options?: RemarkMarkdownAlternateOptions): (tree: {
+  children: MarkdownNode[];
+}, file?: VFileLike) => void;
+//#endregion
+export { remarkMarkdownAlternate as default };

package/dist/mdx-plugins/remark-markdown-alternate.mjs

@@ -0,0 +1,68 @@
+import { toDocsMarkdownUrl } from "@farming-labs/docs";
+
+//#region src/mdx-plugins/remark-markdown-alternate.ts
+function normalizePath(value) {
+	return value.replace(/\\/g, "/").replace(/\/+/g, "/");
+}
+function normalizeSegment(value, fallback) {
+	return (value ?? fallback).replace(/^\/+|\/+$/g, "") || fallback;
+}
+function escapeYamlString(value) {
+	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function routeFromSourcePath(filePath, options) {
+	const normalized = `/${normalizePath(filePath).replace(/^\/+/, "")}`;
+	if (!/\/page\.mdx?$/.test(normalized)) return null;
+	const entry = normalizeSegment(options.entry, "docs");
+	const candidates = [
+		options.contentDir,
+		options.appDir ? `${options.appDir}/${entry}` : void 0,
+		`src/app/${entry}`,
+		`app/${entry}`
+	].filter((candidate) => typeof candidate === "string" && candidate.length > 0).map((candidate) => normalizePath(candidate).replace(/^\/+|\/+$/g, ""));
+	for (const candidate of candidates) {
+		const marker = `/${candidate}/`;
+		const markerIndex = normalized.lastIndexOf(marker);
+		if (markerIndex === -1) continue;
+		const relativePath = normalized.slice(markerIndex + marker.length);
+		if (!relativePath.endsWith("page.mdx") && !relativePath.endsWith("page.md")) continue;
+		const slug = relativePath.replace(/\/?page\.mdx?$/, "").replace(/^\/+|\/+$/g, "");
+		return slug ? `/${entry}/${slug}` : `/${entry}`;
+	}
+	return null;
+}
+function getFilePath(file) {
+	return file?.path ?? file?.history?.[0];
+}
+function hasAlternates(yaml) {
+	return /^\s*alternates\s*:/m.test(yaml);
+}
+function alternateYaml(url) {
+	return [
+		"alternates:",
+		"  types:",
+		`    text/markdown: "${escapeYamlString(toDocsMarkdownUrl(url))}"`
+	].join("\n");
+}
+function remarkMarkdownAlternate(options = {}) {
+	return (tree, file) => {
+		if (options.enabled === false) return;
+		const filePath = getFilePath(file);
+		if (!filePath) return;
+		const route = routeFromSourcePath(filePath, options);
+		if (!route) return;
+		const yamlNode = tree.children.find((node) => node.type === "yaml");
+		if (yamlNode?.value) {
+			if (hasAlternates(yamlNode.value)) return;
+			yamlNode.value += `\n${alternateYaml(route)}`;
+			return;
+		}
+		tree.children.unshift({
+			type: "yaml",
+			value: alternateYaml(route)
+		});
+	};
+}
+
+//#endregion
+export { remarkMarkdownAlternate as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.1.77",
+  "version": "0.1.79",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -73,6 +73,11 @@
       "types": "./dist/mdx-plugins/remark-og.d.mts",
       "import": "./dist/mdx-plugins/remark-og.mjs",
       "default": "./dist/mdx-plugins/remark-og.mjs"
+    },
+    "./mdx-plugins/remark-markdown-alternate": {
+      "types": "./dist/mdx-plugins/remark-markdown-alternate.d.mts",
+      "import": "./dist/mdx-plugins/remark-markdown-alternate.mjs",
+      "default": "./dist/mdx-plugins/remark-markdown-alternate.mjs"
     }
   },
   "dependencies": {
@@ -95,8 +100,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.77",
-    "@farming-labs/theme": "0.1.77"
+    "@farming-labs/docs": "0.1.79",
+    "@farming-labs/theme": "0.1.79"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",