@farming-labs/next 0.1.108 → 0.1.111

package/dist/config.mjs

@@ -258,6 +258,15 @@ function readDocsContentDir(root) {
 		} catch {}
 	}
 }
+function readDocsPath(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = join(root, `docs.config.${ext}`);
+		if (!existsSync(configPath)) continue;
+		try {
+			return readTopLevelStringProperty(readFileSync(configPath, "utf-8"), "docsPath");
+		} catch {}
+	}
+}
 function readDocsConfigPath(root) {
 	for (const ext of FILE_EXTS) {
 		const relativePath = `docs.config.${ext}`;
@@ -910,8 +919,74 @@ function readAgentFeedbackConfig(root) {
 	}
 	return enabled;
 }
-function buildDocsMarkdownRewrites(entry) {
-	const normalizedEntry = entry.replace(/^\/+|\/+$/g, "") || "docs";
+function normalizeRouteSegment(value, fallback = "docs") {
+	return (value ?? fallback).replace(/^\/+|\/+$/g, "") || fallback;
+}
+function normalizeDocsPath(value, entry) {
+	if (typeof value !== "string") return `/${normalizeRouteSegment(entry)}`;
+	const cleaned = value.trim();
+	if (cleaned === "" || cleaned === "/") return "";
+	return `/${cleaned.replace(/^\/+|\/+$/g, "")}`;
+}
+function docsRootSource(entry) {
+	return [
+		"/:slug((?!",
+		"_next/",
+		"|api/",
+		`|${normalizeRouteSegment(entry)}(?:/|$)`,
+		"|favicon\\.ico",
+		"|robots\\.txt",
+		"|sitemap\\.xml",
+		"|sitemap\\.md",
+		"|docs\\.md",
+		"|llms\\.txt",
+		"|llms-full\\.txt",
+		"|mcp(?:/|$)",
+		"|AGENTS\\.md",
+		"|AGENT\\.md",
+		"|skill\\.md",
+		"|\\.well-known/",
+		"|.*\\..*",
+		").*)"
+	].join("");
+}
+function docsRootMarkdownSource(entry) {
+	return [
+		"/:slug((?!",
+		"_next/",
+		"|api/",
+		`|${normalizeRouteSegment(entry)}/`,
+		"|docs\\.md",
+		"|sitemap\\.md",
+		"|AGENTS\\.md",
+		"|AGENT\\.md",
+		"|skill\\.md",
+		"|\\.well-known/",
+		").*)\\.md"
+	].join("");
+}
+function buildDocsPathRewrites(entry, docsPath) {
+	const normalizedEntry = normalizeRouteSegment(entry);
+	const internalBase = `/${normalizedEntry}`;
+	if (docsPath === internalBase) return [];
+	if (docsPath === "") return [{
+		source: "/",
+		destination: `${internalBase}/`
+	}, {
+		source: docsRootSource(normalizedEntry),
+		destination: `${internalBase}/:slug`
+	}];
+	return [{
+		source: docsPath,
+		destination: internalBase
+	}, {
+		source: `${docsPath}/:slug*`,
+		destination: `${internalBase}/:slug*`
+	}];
+}
+function buildDocsMarkdownRewrites(entry, docsPath) {
+	const normalizedEntry = normalizeRouteSegment(entry);
+	const publicBase = docsPath || "";
 	const markdownAcceptHeader = {
 		type: "header",
 		key: "accept",
@@ -922,32 +997,65 @@ function buildDocsMarkdownRewrites(entry) {
 		key: "signature-agent",
 		value: ".+"
 	};
+	if (publicBase === "") {
+		const rootPageSource = docsRootSource(normalizedEntry);
+		return [
+			{
+				source: `/${normalizedEntry}.md`,
+				destination: "/api/docs?format=markdown"
+			},
+			{
+				source: docsRootMarkdownSource(normalizedEntry),
+				destination: "/api/docs?format=markdown&path=:slug"
+			},
+			{
+				source: "/",
+				has: [markdownAcceptHeader],
+				destination: "/api/docs?format=markdown"
+			},
+			{
+				source: rootPageSource,
+				has: [markdownAcceptHeader],
+				destination: "/api/docs?format=markdown&path=:slug"
+			},
+			{
+				source: "/",
+				has: [markdownSignatureAgentHeader],
+				destination: "/api/docs?format=markdown"
+			},
+			{
+				source: rootPageSource,
+				has: [markdownSignatureAgentHeader],
+				destination: "/api/docs?format=markdown&path=:slug"
+			}
+		];
+	}
 	return [
 		{
-			source: `/${normalizedEntry}.md`,
+			source: `${publicBase}.md`,
 			destination: "/api/docs?format=markdown"
 		},
 		{
-			source: `/${normalizedEntry}/:slug*.md`,
+			source: `${publicBase}/:slug*.md`,
 			destination: "/api/docs?format=markdown&path=:slug*"
 		},
 		{
-			source: `/${normalizedEntry}`,
+			source: publicBase,
 			has: [markdownAcceptHeader],
 			destination: "/api/docs?format=markdown"
 		},
 		{
-			source: `/${normalizedEntry}/:slug*`,
+			source: `${publicBase}/:slug*`,
 			has: [markdownAcceptHeader],
 			destination: "/api/docs?format=markdown&path=:slug*"
 		},
 		{
-			source: `/${normalizedEntry}`,
+			source: publicBase,
 			has: [markdownSignatureAgentHeader],
 			destination: "/api/docs?format=markdown"
 		},
 		{
-			source: `/${normalizedEntry}/:slug*`,
+			source: `${publicBase}/:slug*`,
 			has: [markdownSignatureAgentHeader],
 			destination: "/api/docs?format=markdown&path=:slug*"
 		}
@@ -970,7 +1078,7 @@ function buildAgentSpecRewrites() {
 	];
 }
 function buildLlmsTxtRewrites(entry) {
-	const normalizedEntry = entry.replace(/^\/+|\/+$/g, "") || "docs";
+	const normalizedEntry = normalizeRouteSegment(entry);
 	return [
 		{
 			source: DEFAULT_LLMS_TXT_ROUTE,
@@ -1161,7 +1269,12 @@ function findFirstVisibleDocsChildSlug(dir, slugParts) {
 		return childSlugParts;
 	}
 }
-function buildHiddenFolderRedirects(docsDir, entry) {
+function publicDocsRoute(docsPath, slugParts = []) {
+	const slug = slugParts.join("/");
+	if (!slug) return docsPath || "/";
+	return docsPath ? `${docsPath}/${slug}` : `/${slug}`;
+}
+function buildHiddenFolderRedirects(docsDir, docsPath) {
 	const redirects = [];
 	function scan(dir, slugParts) {
 		if (!existsSync(dir)) return;
@@ -1170,8 +1283,8 @@ function buildHiddenFolderRedirects(docsDir, entry) {
 			if (resolveDocsPageFolderIndexBehavior(readDocsPageFrontmatter(pageSource)) === "hidden") {
 				const destinationSlug = findFirstVisibleDocsChildSlug(dir, slugParts);
 				if (destinationSlug && destinationSlug.join("/") !== slugParts.join("/")) {
-					const source = slugParts.length > 0 ? `/${entry}/${slugParts.join("/")}` : `/${entry}`;
-					const destination = destinationSlug.length > 0 ? `/${entry}/${destinationSlug.join("/")}` : `/${entry}`;
+					const source = publicDocsRoute(docsPath, slugParts);
+					const destination = publicDocsRoute(docsPath, destinationSlug);
 					redirects.push({
 						source,
 						destination,
@@ -1185,7 +1298,7 @@ function buildHiddenFolderRedirects(docsDir, entry) {
 	scan(docsDir, []);
 	return dedupeRedirects(redirects);
 }
-function mergeDocsMarkdownRewrites(entry, mcp, sitemap, agentFeedback, robots, result) {
+function mergeDocsMarkdownRewrites(entry, docsPath, mcp, sitemap, agentFeedback, robots, result) {
 	const autoBeforeFilesRewrites = [
 		...buildAgentSpecRewrites(),
 		...buildMcpRewrites(mcp),
@@ -1193,7 +1306,8 @@ function mergeDocsMarkdownRewrites(entry, mcp, sitemap, agentFeedback, robots, r
 		...buildSkillMdRewrites(),
 		...buildSitemapRewrites(sitemap),
 		...buildRobotsRewrites(robots),
-		...buildDocsMarkdownRewrites(entry),
+		...buildDocsMarkdownRewrites(entry, docsPath),
+		...buildDocsPathRewrites(entry, docsPath),
 		...buildAgentFeedbackRewrites(agentFeedback)
 	];
 	const autoAfterFilesRewrites = buildLlmsTxtRewrites(entry);
@@ -1223,6 +1337,7 @@ function withDocs(nextConfig = {}) {
 	const docsConfigRelativeAlias = docsConfigPath.startsWith("./") || docsConfigPath.startsWith("../") ? docsConfigPath : `./${docsConfigPath}`;
 	if (!hasFile(root, "mdx-components")) writeFileSync(join(root, "mdx-components.tsx"), MDX_COMPONENTS_TEMPLATE);
 	const entry = readDocsEntry(root);
+	const docsPath = normalizeDocsPath(readDocsPath(root), entry);
 	const configuredContentDir = readDocsContentDir(root);
 	const appDir = getNextAppDir(root);
 	const docsContentDir = configuredContentDir ?? join(appDir, entry);
@@ -1317,6 +1432,7 @@ function withDocs(nextConfig = {}) {
 		entry,
 		appDir,
 		contentDir: docsContentDir,
+		docsPath,
 		enabled: !isStaticExport
 	}]);
 	remarkPlugins.push(["remark-mdx-frontmatter", { name: "metadata" }], "@farming-labs/next/mdx-plugins/remark-heading");
@@ -1403,9 +1519,9 @@ function withDocs(nextConfig = {}) {
 	if (!isStaticExport) {
 		const existingRewrites = nextConfig.rewrites;
 		nextConfig.rewrites = async () => {
-			return mergeDocsMarkdownRewrites(entry, mcp, sitemap, agentFeedback, robots, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
+			return mergeDocsMarkdownRewrites(entry, docsPath, mcp, sitemap, agentFeedback, robots, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
 		};
-		const autoRedirects = buildHiddenFolderRedirects(docsContentRoot, entry);
+		const autoRedirects = buildHiddenFolderRedirects(docsContentRoot, docsPath);
 		if (autoRedirects.length > 0) {
 			const existingRedirects = nextConfig.redirects;
 			nextConfig.redirects = async () => {

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

@@ -3,6 +3,7 @@ interface RemarkMarkdownAlternateOptions {
   entry?: string;
   appDir?: string;
   contentDir?: string;
+  docsPath?: string;
   enabled?: boolean;
 }
 interface MarkdownNode {

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

@@ -7,6 +7,16 @@ function normalizePath(value) {
 function normalizeSegment(value, fallback) {
 	return (value ?? fallback).replace(/^\/+|\/+$/g, "") || fallback;
 }
+function normalizeDocsPath(value, entry) {
+	if (typeof value !== "string") return `/${entry}`;
+	const cleaned = value.trim();
+	if (cleaned === "" || cleaned === "/") return "";
+	return `/${cleaned.replace(/^\/+|\/+$/g, "")}`;
+}
+function joinDocsPath(docsPath, slug) {
+	if (!slug) return docsPath || "/";
+	return docsPath ? `${docsPath}/${slug}` : `/${slug}`;
+}
 function escapeYamlString(value) {
 	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
@@ -27,7 +37,7 @@ function routeFromSourcePath(filePath, options) {
 		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 joinDocsPath(normalizeDocsPath(options.docsPath, entry), slug);
 	}
 	return null;
 }
@@ -41,7 +51,7 @@ function alternateYaml(url) {
 	return [
 		"alternates:",
 		"  types:",
-		`    text/markdown: "${escapeYamlString(toDocsMarkdownUrl(url))}"`
+		`    text/markdown: "${escapeYamlString(url === "/" ? "/docs.md" : toDocsMarkdownUrl(url))}"`
 	].join("\n");
 }
 function remarkMarkdownAlternate(options = {}) {

package/package.json

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