@farming-labs/theme 0.1.69 → 0.1.71

package/dist/docs-api.mjs

@@ -3,7 +3,7 @@ import { getNextAppDir } from "./get-app-dir.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { emitDocsAnalyticsEvent, normalizeDocsRelated, performDocsSearch, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveSearchRequestConfig } from "@farming-labs/docs";
+import { emitDocsAnalyticsEvent, normalizeDocsRelated, performDocsSearch, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
@@ -660,6 +660,45 @@ function resolveAgentMdxContent(content, audience) {
 function stripMdx(content) {
 	return content.replace(/^(import|export)\s.*$/gm, "").replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/```[\s\S]*?```/g, "").replace(/`([^`]+)`/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
 }
+function resolveDocsSearchPageSource(dir) {
+	return ["page.mdx", "page.md"].map((fileName) => path.join(dir, fileName)).find((candidate) => fs.existsSync(candidate));
+}
+function hasVisibleDescendantDocsSearchPage(dir) {
+	let entries;
+	try {
+		entries = fs.readdirSync(dir);
+	} catch {
+		return false;
+	}
+	for (const name of entries.sort()) {
+		const full = path.join(dir, name);
+		try {
+			if (!fs.statSync(full).isDirectory()) continue;
+		} catch {
+			continue;
+		}
+		const pageSource = resolveDocsSearchPageSource(full);
+		if (pageSource) try {
+			const data = matter(fs.readFileSync(pageSource, "utf-8")).data;
+			const hiddenFolderIndex = resolvePageSidebarFolderIndexBehavior(data.sidebar) === "hidden";
+			if (data.hidden !== true && !hiddenFolderIndex) return true;
+		} catch {
+			return true;
+		}
+		if (hasVisibleDescendantDocsSearchPage(full)) return true;
+	}
+	return false;
+}
+function isHiddenFolderIndexPageDir(dir) {
+	const pageSource = resolveDocsSearchPageSource(dir);
+	if (!pageSource) return false;
+	try {
+		const data = matter(fs.readFileSync(pageSource, "utf-8")).data;
+		return resolvePageSidebarFolderIndexBehavior(data.sidebar) === "hidden" && hasVisibleDescendantDocsSearchPage(dir);
+	} catch {
+		return false;
+	}
+}
 function scanDocsDir(docsDir, entry, locale, excludedDirs = []) {
 	const indexes = [];
 	function isExcluded(dir) {
@@ -672,27 +711,29 @@ function scanDocsDir(docsDir, entry, locale, excludedDirs = []) {
 	function scan(dir, slugParts) {
 		if (!fs.existsSync(dir)) return;
 		if (isExcluded(dir)) return;
-		const pagePath = path.join(dir, "page.mdx");
-		if (fs.existsSync(pagePath)) try {
-			const raw = fs.readFileSync(pagePath, "utf-8");
+		const pageSource = resolveDocsSearchPageSource(dir);
+		if (pageSource) try {
+			const raw = fs.readFileSync(pageSource, "utf-8");
 			const { data } = matter(raw);
-			const title = data.title || slugParts[slugParts.length - 1]?.replace(/-/g, " ") || "Documentation";
-			const description = data.description;
-			const { content: fileContent } = matter(raw);
-			const rawContent = resolveAgentMdxContent(fileContent, "human");
-			const agentRawContent = resolveAgentMdxContent(fileContent, "agent");
-			const content = stripMdx(rawContent);
-			const url = withLangInUrl(slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`, locale);
-			indexes.push({
-				title,
-				description,
-				relatedInput: data.related,
-				content,
-				rawContent,
-				agentFallbackRawContent: agentRawContent !== rawContent ? agentRawContent : void 0,
-				url,
-				locale
-			});
+			if (resolvePageSidebarFolderIndexBehavior(data.sidebar) === "hidden" && hasVisibleDescendantDocsSearchPage(dir)) {} else {
+				const title = data.title || slugParts[slugParts.length - 1]?.replace(/-/g, " ") || "Documentation";
+				const description = data.description;
+				const { content: fileContent } = matter(raw);
+				const rawContent = resolveAgentMdxContent(fileContent, "human");
+				const agentRawContent = resolveAgentMdxContent(fileContent, "agent");
+				const content = stripMdx(rawContent);
+				const url = withLangInUrl(slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`, locale);
+				indexes.push({
+					title,
+					description,
+					relatedInput: data.related,
+					content,
+					rawContent,
+					agentFallbackRawContent: agentRawContent !== rawContent ? agentRawContent : void 0,
+					url,
+					locale
+				});
+			}
 		} catch {}
 		let entries;
 		try {
@@ -1249,11 +1290,14 @@ function createDocsAPI(options) {
 		return sources;
 	}
 	async function getMarkdownDocument(ctx, requestedPath) {
+		const normalizedRequest = normalizeRequestedMarkdownPath(ctx.entryPath, requestedPath);
+		const normalizedEntry = `/${normalizePathSegment(ctx.entryPath)}`;
+		const relativeSlug = normalizedRequest === normalizedEntry ? "" : normalizedRequest.slice(normalizedEntry.length).replace(/^\/+/, "");
+		for (const docsDir of ctx.docsDirs) if (isHiddenFolderIndexPageDir(relativeSlug ? path.join(docsDir, ...relativeSlug.split("/")) : docsDir)) return null;
 		for (const source of getMarkdownSources(ctx)) {
 			const page = findDocsMcpPage(ctx.entryPath, await source.getPages(), requestedPath);
 			if (page) return renderMarkdownDocument(page);
 		}
-		const normalizedRequest = normalizeRequestedMarkdownPath(ctx.entryPath, requestedPath);
 		const fallbackPage = getIndexes(ctx).find((page) => normalizeUrlPath(page.url) === normalizedRequest);
 		if (fallbackPage) return renderMarkdownDocument(fallbackPage);
 		for (const page of getIndexes(ctx)) if (normalizePathSegment(page.url.replace(/^\/+/, "").replace(`${ctx.entryPath}/`, "")) === normalizePathSegment(requestedPath.replace(/^\/+/, "").replace(/\.md$/i, ""))) return renderMarkdownDocument(page);

package/dist/docs-layout.mjs

@@ -152,7 +152,7 @@ function buildTree(config, ctx, flat = false) {
 	const excludedDirs = getExcludedDocsDirs(config, ctx);
 	if (fs.existsSync(path.join(docsDir, "page.mdx"))) {
 		const data = readFrontmatter(path.join(docsDir, "page.mdx"));
-		rootChildren.push({
+		if (data.hidden !== true) rootChildren.push({
 			type: "page",
 			name: data.title ?? "Documentation",
 			url: `/${ctx.entryPath}`,
@@ -170,7 +170,21 @@ function buildTree(config, ctx, flat = false) {
 		const url = `/${ctx.entryPath}/${slug.join("/")}`;
 		const icon = resolveIcon(data.icon, icons);
 		const displayName = data.title ?? name.replace(/-/g, " ");
-		if (hasChildPages(full, excludedDirs)) {
+		const hasChildren = hasChildPages(full, excludedDirs);
+		if (data.hidden === true) {
+			if (!hasChildren) return null;
+			return {
+				type: "folder",
+				name: displayName,
+				icon,
+				children: scanDir(full, slug, slugOrder),
+				...flat ? {
+					collapsible: false,
+					defaultOpen: true
+				} : {}
+			};
+		}
+		if (hasChildren) {
 			const folderChildren = scanDir(full, slug, slugOrder);
 			return {
 				type: "folder",

package/dist/tanstack-layout.d.mts

@@ -14,7 +14,7 @@ interface FolderNode {
   name: string;
   icon?: ReactNode;
   index?: PageNode;
-  folderIndexBehavior?: "link" | "toggle";
+  folderIndexBehavior?: "link" | "toggle" | "hidden";
   children: (PageNode | FolderNode)[];
   collapsible?: boolean;
   defaultOpen?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.69",
+  "version": "0.1.71",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -139,7 +139,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.69"
+    "@farming-labs/docs": "0.1.71"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",