@farming-labs/next 0.1.77 → 0.1.78

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

@@ -231,6 +231,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",
@@ -1149,6 +1150,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 +1213,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")
 		});

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.78",
   "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.78",
+    "@farming-labs/theme": "0.1.78"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",