@farming-labs/next 0.1.70 → 0.1.72

package/dist/config.mjs

@@ -87,6 +87,7 @@ export const { GET, POST } = createDocsAPI({
   mcp: docsConfig.mcp,
   search: docsConfig.search,
   analytics: docsConfig.analytics,
+  observability: docsConfig.observability,
   ai: docsConfig.ai,
 });
 
@@ -104,6 +105,7 @@ export const { GET, POST, DELETE } = createDocsMCPAPI({
   ordering: docsConfig.ordering,
   search: docsConfig.search,
   analytics: docsConfig.analytics,
+  observability: docsConfig.observability,
   mcp: docsConfig.mcp,
 });
 
@@ -860,6 +862,106 @@ function dedupeRewrites(rewrites) {
 	}
 	return result;
 }
+function dedupeRedirects(redirects) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const redirect of redirects) {
+		const key = redirect.source;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		result.push(redirect);
+	}
+	return result;
+}
+function resolveDocsPageSourceFile(dir) {
+	return ["page.mdx", "page.md"].map((fileName) => join(dir, fileName)).find((candidate) => existsSync(candidate));
+}
+function readDocsPageFrontmatter(filePath) {
+	try {
+		return matter(readFileSync(filePath, "utf-8")).data;
+	} catch {
+		return {};
+	}
+}
+function resolveDocsPageOrder(dir) {
+	const pageSource = resolveDocsPageSourceFile(dir);
+	if (!pageSource) return Number.POSITIVE_INFINITY;
+	const data = readDocsPageFrontmatter(pageSource);
+	return typeof data.order === "number" ? data.order : Number.POSITIVE_INFINITY;
+}
+function resolveDocsPageFolderIndexBehavior(data) {
+	const sidebar = data.sidebar;
+	if (!sidebar || typeof sidebar !== "object") return void 0;
+	const value = sidebar.folderIndexBehavior;
+	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
+}
+function listSortedDocsChildDirectories(dir) {
+	let entries;
+	try {
+		entries = readdirSync(dir);
+	} catch {
+		return [];
+	}
+	return entries.map((name) => ({
+		name,
+		fullPath: join(dir, name)
+	})).filter(({ fullPath }) => {
+		try {
+			return statSync(fullPath).isDirectory();
+		} catch {
+			return false;
+		}
+	}).sort((left, right) => {
+		const leftOrder = resolveDocsPageOrder(left.fullPath);
+		const rightOrder = resolveDocsPageOrder(right.fullPath);
+		if (leftOrder !== rightOrder) return leftOrder - rightOrder;
+		return left.name.localeCompare(right.name);
+	}).map(({ name }) => name);
+}
+function findFirstVisibleDocsChildSlug(dir, slugParts) {
+	for (const name of listSortedDocsChildDirectories(dir)) {
+		const childDir = join(dir, name);
+		const childSlugParts = [...slugParts, name];
+		const pageSource = resolveDocsPageSourceFile(childDir);
+		if (!pageSource) {
+			const descendant = findFirstVisibleDocsChildSlug(childDir, childSlugParts);
+			if (descendant) return descendant;
+			continue;
+		}
+		const data = readDocsPageFrontmatter(pageSource);
+		const folderIndexBehavior = resolveDocsPageFolderIndexBehavior(data);
+		if (data.hidden === true || folderIndexBehavior === "hidden") {
+			const descendant = findFirstVisibleDocsChildSlug(childDir, childSlugParts);
+			if (descendant) return descendant;
+			continue;
+		}
+		return childSlugParts;
+	}
+}
+function buildHiddenFolderRedirects(docsDir, entry) {
+	const redirects = [];
+	function scan(dir, slugParts) {
+		if (!existsSync(dir)) return;
+		const pageSource = resolveDocsPageSourceFile(dir);
+		if (pageSource) {
+			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}`;
+					redirects.push({
+						source,
+						destination,
+						permanent: false
+					});
+				}
+			}
+		}
+		for (const name of listSortedDocsChildDirectories(dir)) scan(join(dir, name), [...slugParts, name]);
+	}
+	scan(docsDir, []);
+	return dedupeRedirects(redirects);
+}
 function mergeDocsMarkdownRewrites(entry, mcp, agentFeedback, result) {
 	const autoRewrites = [
 		...buildAgentSpecRewrites(),
@@ -880,6 +982,9 @@ function mergeDocsMarkdownRewrites(entry, mcp, agentFeedback, result) {
 		fallback: result.fallback ?? []
 	};
 }
+function mergeDocsRedirects(autoRedirects, redirects) {
+	return dedupeRedirects([...redirects ?? [], ...autoRedirects]);
+}
 function withDocs(nextConfig = {}) {
 	const root = process.cwd();
 	const workspaceRoot = findDocsWorkspaceRoot(root);
@@ -1053,11 +1158,19 @@ function withDocs(nextConfig = {}) {
 	const existingTracingIncludes = nextConfig.outputFileTracingIncludes ?? {};
 	const docsTraceGlob = docsContentDir.replace(/\\/g, "/").replace(/^\.?\//, "") + "/**/*";
 	const skillTraceFile = "skill.md";
+	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);
 		};
+		const autoRedirects = buildHiddenFolderRedirects(docsContentRoot, entry);
+		if (autoRedirects.length > 0) {
+			const existingRedirects = nextConfig.redirects;
+			nextConfig.redirects = async () => {
+				return mergeDocsRedirects(autoRedirects, typeof existingRedirects === "function" ? await existingRedirects() : existingRedirects);
+			};
+		}
 	}
 	nextConfig.outputFileTracingIncludes = {
 		...existingTracingIncludes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "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.70",
-    "@farming-labs/theme": "0.1.70"
+    "@farming-labs/theme": "0.1.72",
+    "@farming-labs/docs": "0.1.72"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",