@farming-labs/theme 0.1.13 → 0.1.16

package/dist/docs-api.d.mts

@@ -1,4 +1,4 @@
-import { DocsI18nConfig, DocsMcpConfig, DocsSearchConfig, OrderingItem } from "@farming-labs/docs";
+import { ChangelogConfig, DocsI18nConfig, DocsMcpConfig, DocsSearchConfig, OrderingItem } from "@farming-labs/docs";
 
 //#region src/docs-api.d.ts
 interface AIProviderConfig {
@@ -31,6 +31,8 @@ interface DocsAPIOptions {
   entry?: string;
   /** Override the docs content directory when it does not live in app/<entry>. */
   contentDir?: string;
+  /** Changelog configuration. */
+  changelog?: boolean | ChangelogConfig;
   /** Search language (default: "english") */
   language?: string;
   /** AI chat configuration */

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 { performDocsSearch, resolveDocsI18n, resolveDocsLocale, resolveSearchRequestConfig } from "@farming-labs/docs";
+import { performDocsSearch, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveSearchRequestConfig } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
@@ -278,10 +278,18 @@ function stripMdx(raw) {
 	const { content } = matter(raw);
 	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 scanDocsDir(docsDir, entry, locale) {
+function scanDocsDir(docsDir, entry, locale, excludedDirs = []) {
 	const indexes = [];
+	function isExcluded(dir) {
+		const resolved = path.resolve(dir);
+		return excludedDirs.some((excluded) => {
+			const relative = path.relative(excluded, resolved);
+			return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+		});
+	}
 	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");
@@ -316,6 +324,82 @@ function scanDocsDir(docsDir, entry, locale) {
 	scan(docsDir, []);
 	return indexes;
 }
+function scanChangelogDir(changelogDir, entryPath, changelogPath, locale) {
+	if (!fs.existsSync(changelogDir)) return [];
+	const indexes = [];
+	let entries;
+	try {
+		entries = fs.readdirSync(changelogDir).sort().reverse();
+	} catch {
+		return indexes;
+	}
+	for (const name of entries) {
+		if (!/^\d{4}-\d{2}-\d{2}$/.test(name)) continue;
+		const entryDir = path.join(changelogDir, name);
+		let isDirectory = false;
+		try {
+			isDirectory = fs.existsSync(entryDir) && fs.statSync(entryDir).isDirectory();
+		} catch {
+			continue;
+		}
+		if (!isDirectory) continue;
+		const pagePath = path.join(entryDir, "page.mdx");
+		if (!fs.existsSync(pagePath)) continue;
+		try {
+			const raw = fs.readFileSync(pagePath, "utf-8");
+			const { data, content: rawContent } = matter(raw);
+			if (data.draft === true) continue;
+			const title = data.title || name.replace(/-/g, " ");
+			const description = data.description;
+			const content = stripMdx(raw);
+			const url = withLangInUrl(`/${entryPath}/${changelogPath}/${name}`, locale);
+			const tags = Array.isArray(data.tags) ? data.tags.filter((value) => typeof value === "string") : void 0;
+			indexes.push({
+				title,
+				description,
+				content,
+				rawContent,
+				url,
+				locale,
+				type: "changelog",
+				version: typeof data.version === "string" ? data.version : void 0,
+				tags
+			});
+		} catch {}
+	}
+	return indexes;
+}
+function normalizePathSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizeUrlPath(value) {
+	const normalized = value.replace(/\/+/g, "/");
+	if (normalized === "/") return normalized;
+	return normalized.replace(/\/+$/, "");
+}
+function normalizeRequestedMarkdownPath(entry, requestedPath) {
+	const trimmed = requestedPath.trim().replace(/\.md$/i, "");
+	if (!trimmed) return `/${entry}`;
+	const normalized = normalizeUrlPath(trimmed.startsWith("/") ? trimmed : `/${trimmed}`);
+	const normalizedEntry = `/${normalizePathSegment(entry)}`;
+	if (normalized === normalizedEntry || normalized.startsWith(`${normalizedEntry}/`)) return normalized;
+	const slug = normalizePathSegment(trimmed);
+	return slug ? normalizeUrlPath(`${normalizedEntry}/${slug}`) : normalizedEntry;
+}
+function findDocsMcpPage(entry, pages, requestedPath) {
+	const normalizedRequest = normalizeRequestedMarkdownPath(entry, requestedPath);
+	for (const page of pages) if (normalizeUrlPath(page.url) === normalizedRequest) return page;
+	const normalizedSlug = normalizePathSegment(requestedPath.replace(/^\//, "").replace(/\.md$/i, ""));
+	for (const page of pages) if (normalizePathSegment(page.slug) === normalizedSlug) return page;
+	return null;
+}
+function renderMarkdownDocument(page) {
+	if ("agentRawContent" in page && page.agentRawContent !== void 0) return page.agentRawContent;
+	const lines = [`# ${page.title}`, `URL: ${page.url}`];
+	if (page.description) lines.push(`Description: ${page.description}`);
+	lines.push("", page.rawContent ?? page.content);
+	return lines.join("\n");
+}
 const DEFAULT_SYSTEM_PROMPT = `You are a helpful documentation assistant. Answer questions based on the provided documentation context. Be concise and accurate. If the answer is not in the context, say so honestly. Use markdown formatting for code examples and links.`;
 function resolveModelAndProvider(aiConfig, requestedModelId) {
 	const raw = aiConfig.model;
@@ -463,6 +547,7 @@ function createDocsAPI(options) {
 	const entry = options?.entry ?? readEntry(root);
 	const appDir = getNextAppDir(root);
 	const contentDir = options?.contentDir ?? path.join(appDir, entry);
+	const changelogConfig = resolveChangelogConfig(options?.changelog);
 	const i18n = resolveDocsI18n(options?.i18n ?? readI18nConfig(root));
 	const aiConfig = options?.ai ?? readAIConfig(root);
 	const searchConfig = options?.search;
@@ -498,32 +583,78 @@ function createDocsAPI(options) {
 		} catch {}
 		return i18n.defaultLocale;
 	}
+	function resolveChangelogDirCandidates(docsDirs) {
+		if (!changelogConfig.enabled) return [];
+		if (path.isAbsolute(changelogConfig.contentDir)) return [changelogConfig.contentDir];
+		return docsDirs.map((docsDir) => path.join(docsDir, changelogConfig.contentDir));
+	}
+	function isWithinDir(candidate, target) {
+		const relative = path.relative(target, candidate);
+		return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+	}
 	function resolveContextFromRequest(request) {
-		if (!i18n) return {
-			entryPath: entry,
-			docsDirs: resolveDocsDirCandidates()
-		};
+		if (!i18n) {
+			const docsDirs = resolveDocsDirCandidates();
+			return {
+				entryPath: entry,
+				docsDirs,
+				changelogDirs: resolveChangelogDirCandidates(docsDirs)
+			};
+		}
 		const locale = resolveLocaleFromRequest(request) ?? i18n.defaultLocale;
+		const docsDirs = resolveDocsDirCandidates(locale);
 		return {
 			entryPath: entry,
 			locale,
-			docsDirs: resolveDocsDirCandidates(locale)
+			docsDirs,
+			changelogDirs: resolveChangelogDirCandidates(docsDirs)
 		};
 	}
 	const indexesByLocale = /* @__PURE__ */ new Map();
 	const llmsCacheByLocale = /* @__PURE__ */ new Map();
+	const markdownSourcesByLocale = /* @__PURE__ */ new Map();
 	function getIndexes(ctx) {
 		const key = ctx.locale ?? "__default__";
 		const cached = indexesByLocale.get(key);
 		if (cached) return cached;
 		let next = [];
 		for (const docsDir of ctx.docsDirs) {
-			next = scanDocsDir(docsDir, ctx.entryPath, ctx.locale);
-			if (next.length > 0) break;
+			const excludedDirs = ctx.changelogDirs.filter((dir) => isWithinDir(dir, docsDir));
+			const docsPages = scanDocsDir(docsDir, ctx.entryPath, ctx.locale, excludedDirs);
+			if (docsPages.length === 0) continue;
+			next = docsPages;
+			break;
+		}
+		if (changelogConfig.enabled) {
+			const changelogPages = ctx.changelogDirs.flatMap((dir) => scanChangelogDir(dir, ctx.entryPath, changelogConfig.path, ctx.locale));
+			next = [...next, ...changelogPages];
 		}
 		indexesByLocale.set(key, next);
 		return next;
 	}
+	function getMarkdownSources(ctx) {
+		const key = ctx.locale ?? "__default__";
+		const cached = markdownSourcesByLocale.get(key);
+		if (cached) return cached;
+		const sources = ctx.docsDirs.map((docsDir) => createFilesystemDocsMcpSource({
+			rootDir: root,
+			entry: ctx.entryPath,
+			contentDir: docsDir
+		}));
+		markdownSourcesByLocale.set(key, sources);
+		return sources;
+	}
+	async function getMarkdownDocument(ctx, requestedPath) {
+		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);
+		return null;
+	}
 	function getLlmsContent(ctx) {
 		const key = ctx.locale ?? "__default__";
 		const cached = llmsCacheByLocale.get(key);
@@ -541,6 +672,21 @@ function createDocsAPI(options) {
 			const ctx = resolveContextFromRequest(request);
 			const url = new URL(request.url);
 			const format = url.searchParams.get("format");
+			if (format === "markdown") {
+				const document = await getMarkdownDocument(ctx, url.searchParams.get("path")?.trim() ?? "");
+				if (!document) return new Response("Not Found", {
+					status: 404,
+					headers: {
+						"Content-Type": "text/plain; charset=utf-8",
+						"X-Robots-Tag": "noindex"
+					}
+				});
+				return new Response(document, { headers: {
+					"Content-Type": "text/markdown; charset=utf-8",
+					"Cache-Control": "public, max-age=0, s-maxage=3600",
+					"X-Robots-Tag": "noindex"
+				} });
+			}
 			if (format === "llms") return new Response(getLlmsContent(ctx).llmsTxt, { headers: {
 				"Content-Type": "text/plain; charset=utf-8",
 				"Cache-Control": "public, max-age=3600"

package/dist/docs-layout.mjs

@@ -10,7 +10,7 @@ import path from "node:path";
 import matter from "gray-matter";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { Suspense } from "react";
-import { buildPageOpenGraph, buildPageTwitter } from "@farming-labs/docs";
+import { buildPageOpenGraph, buildPageTwitter, resolveChangelogConfig } from "@farming-labs/docs";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-layout.tsx
@@ -33,10 +33,19 @@ function readFrontmatter(filePath) {
 	}
 }
 /** Check if a directory has any subdirectories that contain page.mdx. */
-function hasChildPages(dir) {
+function isWithinDir(candidate, target) {
+	const relative = path.relative(target, candidate);
+	return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+function isExcludedDir(dir, excludedDirs) {
+	const resolved = path.resolve(dir);
+	return excludedDirs.some((excluded) => isWithinDir(resolved, excluded));
+}
+function hasChildPages(dir, excludedDirs) {
 	if (!fs.existsSync(dir)) return false;
 	for (const name of fs.readdirSync(dir)) {
 		const full = path.join(dir, name);
+		if (isExcludedDir(full, excludedDirs)) continue;
 		if (fs.statSync(full).isDirectory() && fs.existsSync(path.join(full, "page.mdx"))) return true;
 	}
 	return false;
@@ -76,11 +85,70 @@ function resolveDocsLocaleContext(config, locale) {
 		docsDir: resolveContentDir(resolvedLocale)
 	};
 }
+function getExcludedDocsDirs(config, ctx) {
+	const changelog = resolveChangelogConfig(config.changelog);
+	if (!changelog.enabled) return [];
+	const dir = path.isAbsolute(changelog.contentDir) ? changelog.contentDir : path.join(ctx.docsDir, changelog.contentDir);
+	return [path.resolve(dir)];
+}
+function readChangelogTreeEntries(config, ctx) {
+	const changelog = resolveChangelogConfig(config.changelog);
+	if (!changelog.enabled) return [];
+	const changelogDir = path.isAbsolute(changelog.contentDir) ? changelog.contentDir : path.join(ctx.docsDir, changelog.contentDir);
+	if (!fs.existsSync(changelogDir)) return [];
+	const entries = [];
+	for (const name of fs.readdirSync(changelogDir)) {
+		if (!/^\d{4}-\d{2}-\d{2}$/.test(name)) continue;
+		const entryDir = path.join(changelogDir, name);
+		if (!fs.existsSync(entryDir) || !fs.statSync(entryDir).isDirectory()) continue;
+		const pagePath = path.join(entryDir, "page.mdx");
+		if (!fs.existsSync(pagePath)) continue;
+		const data = readFrontmatter(pagePath);
+		if (data.draft === true) continue;
+		entries.push({
+			slug: name,
+			date: name,
+			title: data.title ?? name.replace(/-/g, " "),
+			pinned: data.pinned === true
+		});
+	}
+	return entries.sort((left, right) => {
+		if (left.pinned !== right.pinned) return left.pinned ? -1 : 1;
+		return right.date.localeCompare(left.date);
+	});
+}
+function buildChangelogTree(config, ctx, flat = false) {
+	const changelog = resolveChangelogConfig(config.changelog);
+	if (!changelog.enabled) return null;
+	const entries = readChangelogTreeEntries(config, ctx);
+	if (entries.length === 0) return null;
+	const url = `/${ctx.entryPath}/${changelog.path}`;
+	const children = entries.map((entry) => ({
+		type: "page",
+		name: entry.title,
+		url: `${url}/${entry.slug}`
+	}));
+	return {
+		type: "folder",
+		name: changelog.title,
+		index: {
+			type: "page",
+			name: changelog.title,
+			url
+		},
+		children,
+		...flat ? {
+			collapsible: false,
+			defaultOpen: true
+		} : {}
+	};
+}
 function buildTree(config, ctx, flat = false) {
 	const docsDir = ctx.docsDir;
 	const icons = config.icons;
 	const ordering = config.ordering;
 	const rootChildren = [];
+	const excludedDirs = getExcludedDocsDirs(config, ctx);
 	if (fs.existsSync(path.join(docsDir, "page.mdx"))) {
 		const data = readFrontmatter(path.join(docsDir, "page.mdx"));
 		rootChildren.push({
@@ -92,6 +160,7 @@ function buildTree(config, ctx, flat = false) {
 	}
 	function buildNode(dir, name, baseSlug, slugOrder) {
 		const full = path.join(dir, name);
+		if (isExcludedDir(full, excludedDirs)) return null;
 		if (!fs.statSync(full).isDirectory()) return null;
 		const pagePath = path.join(full, "page.mdx");
 		if (!fs.existsSync(pagePath)) return null;
@@ -100,7 +169,7 @@ 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)) {
+		if (hasChildPages(full, excludedDirs)) {
 			const folderChildren = scanDir(full, slug, slugOrder);
 			return {
 				type: "folder",
@@ -135,10 +204,12 @@ function buildTree(config, ctx, flat = false) {
 			for (const item of slugOrder) slugMap.set(item.slug, item);
 			for (const item of slugOrder) {
 				if (!entries.includes(item.slug)) continue;
+				if (isExcludedDir(path.join(dir, item.slug), excludedDirs)) continue;
 				const node = buildNode(dir, item.slug, baseSlug, item.children);
 				if (node) nodes.push(node);
 			}
 			for (const name of entries) {
+				if (isExcludedDir(path.join(dir, name), excludedDirs)) continue;
 				if (slugMap.has(name)) continue;
 				const node = buildNode(dir, name, baseSlug);
 				if (node) nodes.push(node);
@@ -149,6 +220,7 @@ function buildTree(config, ctx, flat = false) {
 			const nodes = [];
 			for (const name of entries) {
 				const full = path.join(dir, name);
+				if (isExcludedDir(full, excludedDirs)) continue;
 				if (!fs.statSync(full).isDirectory()) continue;
 				const pagePath = path.join(full, "page.mdx");
 				if (!fs.existsSync(pagePath)) continue;
@@ -168,6 +240,7 @@ function buildTree(config, ctx, flat = false) {
 		}
 		const nodes = [];
 		for (const name of entries) {
+			if (isExcludedDir(path.join(dir, name), excludedDirs)) continue;
 			const node = buildNode(dir, name, baseSlug);
 			if (node) nodes.push(node);
 		}
@@ -175,6 +248,14 @@ function buildTree(config, ctx, flat = false) {
 	}
 	const rootSlugOrder = Array.isArray(ordering) ? ordering : void 0;
 	rootChildren.push(...scanDir(docsDir, [], rootSlugOrder));
+	const changelogTree = buildChangelogTree(config, ctx, flat);
+	if (changelogTree) {
+		if (rootChildren.length > 0) rootChildren.push({
+			type: "separator",
+			name: "Updates"
+		});
+		rootChildren.push(changelogTree);
+	}
 	return {
 		name: "Docs",
 		children: rootChildren
@@ -186,6 +267,7 @@ function localizeTreeUrls(tree, locale) {
 			...node,
 			url: withLangInUrl(node.url, locale)
 		};
+		if (node.type === "separator") return node;
 		return {
 			...node,
 			index: node.index ? {
@@ -204,9 +286,10 @@ function localizeTreeUrls(tree, locale) {
 * Scan all page.mdx files under the docs entry directory and build
 * a map of URL pathname → formatted last-modified date string.
 */
-function buildLastModifiedMap(ctx) {
+function buildLastModifiedMap(config, ctx) {
 	const docsDir = ctx.docsDir;
 	const map = {};
+	const excludedDirs = getExcludedDocsDirs(config, ctx);
 	function formatDate(date) {
 		return date.toLocaleDateString("en-US", {
 			year: "numeric",
@@ -216,6 +299,7 @@ function buildLastModifiedMap(ctx) {
 	}
 	function scan(dir, slugParts) {
 		if (!fs.existsSync(dir)) return;
+		if (isExcludedDir(dir, excludedDirs)) return;
 		const pagePath = path.join(dir, "page.mdx");
 		if (fs.existsSync(pagePath)) {
 			const url = slugParts.length === 0 ? `/${ctx.entryPath}` : `/${ctx.entryPath}/${slugParts.join("/")}`;
@@ -233,11 +317,13 @@ function buildLastModifiedMap(ctx) {
 * Scan all page.mdx files and build a map of URL pathname → description
 * from the frontmatter `description` field.
 */
-function buildDescriptionMap(ctx) {
+function buildDescriptionMap(config, ctx) {
 	const docsDir = ctx.docsDir;
 	const map = {};
+	const excludedDirs = getExcludedDocsDirs(config, ctx);
 	function scan(dir, slugParts) {
 		if (!fs.existsSync(dir)) return;
+		if (isExcludedDir(dir, excludedDirs)) return;
 		const pagePath = path.join(dir, "page.mdx");
 		if (fs.existsSync(pagePath)) {
 			const desc = readFrontmatter(pagePath).description;
@@ -446,6 +532,8 @@ function createDocsLayout(config, options) {
 	const i18n = resolveDocsI18nConfig(getDocsI18n(config));
 	const activeLocale = localeContext.locale ?? i18n?.defaultLocale;
 	const docsApiUrl = withLangInUrl("/api/docs", activeLocale);
+	const changelogConfig = resolveChangelogConfig(config.changelog);
+	const changelogBasePath = changelogConfig.enabled ? `/${localeContext.entryPath}/${changelogConfig.path}` : void 0;
 	const navTitle = config.nav?.title ?? "Docs";
 	const navUrl = withLangInUrl(config.nav?.url ?? `/${localeContext.entryPath}`, activeLocale);
 	const themeSwitch = resolveThemeSwitch(config.themeToggle);
@@ -498,8 +586,8 @@ function createDocsLayout(config, options) {
 		aiModels = rawModelConfig.models ?? aiModels;
 		aiDefaultModelId = rawModelConfig.defaultModel ?? rawModelConfig.models?.[0]?.id ?? aiDefaultModelId;
 	}
-	const lastModifiedMap = buildLastModifiedMap(localeContext);
-	const descriptionMap = buildDescriptionMap(localeContext);
+	const lastModifiedMap = buildLastModifiedMap(config, localeContext);
+	const descriptionMap = buildDescriptionMap(config, localeContext);
 	return function DocsLayoutWrapper({ children }) {
 		const tree = buildTree(config, localeContext, !!sidebarFlat);
 		const localizedTree = i18n ? localizeTreeUrls(tree, activeLocale) : tree;
@@ -577,6 +665,7 @@ function createDocsLayout(config, options) {
 							tocEnabled,
 							tocStyle,
 							breadcrumbEnabled,
+							changelogBasePath,
 							entry: localeContext.entryPath,
 							locale: activeLocale,
 							copyMarkdown: copyMarkdownEnabled,

package/dist/docs-page-client.d.mts

@@ -13,6 +13,7 @@ interface DocsPageClientProps {
   tocEnabled: boolean;
   tocStyle?: "default" | "directional";
   breadcrumbEnabled?: boolean;
+  changelogBasePath?: string;
   /** The docs entry folder name (e.g. "docs") — used to strip from breadcrumb */
   entry?: string;
   /** Active locale (used for llms.txt links) */
@@ -62,6 +63,7 @@ declare function DocsPageClient({
   tocEnabled,
   tocStyle,
   breadcrumbEnabled,
+  changelogBasePath,
   entry,
   locale,
   copyMarkdown,

package/dist/docs-page-client.mjs

@@ -158,16 +158,21 @@ function TitleDecorations({ description, belowTitle }) {
 	if (!description && !belowTitle) return null;
 	return /* @__PURE__ */ jsxs(Fragment, { children: [description, belowTitle] });
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, children }) {
+function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
+	const [browserPath, setBrowserPath] = useState(null);
 	const pathname = usePathname();
 	const activeLocale = resolveClientLocale(useWindowSearchParams(), locale);
 	const llmsLangParam = activeLocale ? `&lang=${encodeURIComponent(activeLocale)}` : "";
 	const pageDescription = description ?? descriptionMap?.[pathname.replace(/\/$/, "") || "/"];
+	const normalizedPath = (browserPath ?? pathname).replace(/\/$/, "") || "/";
+	const isChangelogRoute = !!(changelogBasePath && (normalizedPath === changelogBasePath || normalizedPath.startsWith(`${changelogBasePath}/`)));
+	const effectiveTocEnabled = isChangelogRoute ? false : tocEnabled;
+	const effectiveBreadcrumbEnabled = isChangelogRoute ? false : breadcrumbEnabled;
 	useEffect(() => {
-		if (!tocEnabled) return;
+		if (!effectiveTocEnabled) return;
 		const timer = requestAnimationFrame(() => {
 			const container = document.getElementById("nd-page");
 			if (!container) return;
@@ -179,7 +184,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			})));
 		});
 		return () => cancelAnimationFrame(timer);
-	}, [tocEnabled, pathname]);
+	}, [effectiveTocEnabled, pathname]);
 	useEffect(() => {
 		if (!activeLocale) return;
 		const timer = requestAnimationFrame(() => {
@@ -193,6 +198,19 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		children,
 		pathname
 	]);
+	useEffect(() => {
+		setBrowserPath(window.location.pathname);
+	}, [pathname]);
+	useEffect(() => {
+		const root = document.documentElement;
+		if (isChangelogRoute) {
+			root.dataset.fdRouteKind = "changelog";
+			return () => {
+				if (root.dataset.fdRouteKind === "changelog") delete root.dataset.fdRouteKind;
+			};
+		}
+		if (root.dataset.fdRouteKind === "changelog") delete root.dataset.fdRouteKind;
+	}, [isChangelogRoute]);
 	useEffect(() => {
 		let frame = 0;
 		let timeout = 0;
@@ -220,15 +238,14 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			clearTimeout(timeout);
 		};
 	}, [pathname, children]);
-	const showActions = copyMarkdown || openDocs;
+	const showActions = !isChangelogRoute && (copyMarkdown || openDocs);
 	const showActionsBelowTitle = showActions && pageActionsPosition === "below-title";
 	const showActionsAboveTitle = showActions && pageActionsPosition === "above-title";
 	const githubFileUrl = editOnGithubUrl ?? (githubUrl ? buildGithubFileUrl(githubUrl, githubBranch, pathname, entry, activeLocale, githubDirectory, contentDir) : void 0);
-	const normalizedPath = pathname.replace(/\/$/, "") || "/";
-	const lastModified = lastUpdatedEnabled ? lastModifiedProp ?? lastModifiedMap?.[normalizedPath] : void 0;
+	const lastModified = !isChangelogRoute && lastUpdatedEnabled ? lastModifiedProp ?? lastModifiedMap?.[normalizedPath] : void 0;
 	const showLastUpdatedBelowTitle = !!lastModified && lastUpdatedPosition === "below-title";
 	const showLastUpdatedInFooter = !!lastModified && lastUpdatedPosition === "footer";
-	const showFooter = !!githubFileUrl || showLastUpdatedInFooter || llmsTxtEnabled;
+	const showFooter = !isChangelogRoute && (!!githubFileUrl || showLastUpdatedInFooter || llmsTxtEnabled);
 	const titleDescription = pageDescription ? /* @__PURE__ */ jsx("p", {
 		className: "fd-page-description",
 		children: pageDescription
@@ -283,18 +300,20 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		belowTitle: belowTitleBlock
 	}), titlePortalHost) : null;
 	return /* @__PURE__ */ jsxs(DocsPage, {
+		full: false,
 		toc,
 		tableOfContent: {
-			enabled: tocEnabled,
+			enabled: effectiveTocEnabled,
 			style: fdTocStyle
 		},
 		tableOfContentPopover: {
-			enabled: tocEnabled,
+			enabled: effectiveTocEnabled,
 			style: fdTocStyle
 		},
 		breadcrumb: { enabled: false },
+		footer: { enabled: !isChangelogRoute },
 		children: [
-			breadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
+			effectiveBreadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
 				pathname,
 				entry,
 				locale: activeLocale
@@ -324,7 +343,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 						children: decoratedChildren
 					}),
 					titleDecorationsPortal,
-					feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
+					!isChangelogRoute && feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
 						pathname: normalizedPath,
 						entry,
 						locale: activeLocale,

package/dist/index.d.mts

@@ -12,8 +12,8 @@ import { PageActions } from "./page-actions.mjs";
 import { withLangInUrl } from "./i18n.mjs";
 import { HoverLink, HoverLinkProps } from "./hover-link.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import { AIConfig, BreadcrumbConfig, CopyMarkdownConfig, DocsConfig, DocsFeedbackData, DocsFeedbackValue, DocsMetadata, DocsNav, DocsTheme, FeedbackConfig, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
+import { AIConfig, BreadcrumbConfig, ChangelogConfig, ChangelogFrontmatter, CopyMarkdownConfig, DocsConfig, DocsFeedbackData, DocsFeedbackValue, DocsMetadata, DocsNav, DocsTheme, FeedbackConfig, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
 import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
-export { type AIConfig, type BreadcrumbConfig, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };
+export { type AIConfig, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };

package/package.json

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