@farming-labs/next 0.1.13 → 0.1.16

package/dist/config.mjs

@@ -1,6 +1,7 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
+import matter from "gray-matter";
 import createMDX from "@next/mdx";
 
 //#region src/config.ts
@@ -73,6 +74,7 @@ export const { GET, POST } = createDocsAPI({
   entry: docsConfig.entry,
   contentDir: docsConfig.contentDir,
   i18n: docsConfig.i18n,
+  changelog: docsConfig.changelog,
   search: docsConfig.search,
   ai: docsConfig.ai,
 });
@@ -93,6 +95,34 @@ export const { GET, POST, DELETE } = createDocsMCPAPI({
   mcp: docsConfig.mcp,
 });
 
+export const revalidate = false;
+`;
+const DOCS_MARKDOWN_ROUTE_TEMPLATE = `\
+${GENERATED_BANNER}
+import docsConfig from "@/docs.config";
+import { createDocsAPI } from "@farming-labs/next/api";
+
+const handlers = createDocsAPI({
+  entry: docsConfig.entry,
+  contentDir: docsConfig.contentDir,
+  i18n: docsConfig.i18n,
+  changelog: docsConfig.changelog,
+  search: docsConfig.search,
+  ai: docsConfig.ai,
+});
+
+export async function GET(
+  request: Request,
+  { params }: { params: Promise<{ slug?: string[] }> },
+) {
+  const { slug = [] } = await params;
+  const url = new URL(request.url);
+  url.searchParams.set("format", "markdown");
+  if (slug.length > 0) url.searchParams.set("path", slug.join("/"));
+  else url.searchParams.delete("path");
+  return handlers.GET(new Request(url, { headers: request.headers }));
+}
+
 export const revalidate = false;
 `;
 const API_REFERENCE_ROUTE_TEMPLATE = `\
@@ -126,6 +156,14 @@ const ApiReferenceLayout = createNextApiReferenceLayout(docsConfig);
 
 export default ApiReferenceLayout;
 `;
+const CHANGELOG_SOURCE_LAYOUT_TEMPLATE = `\
+${GENERATED_BANNER}
+import { notFound } from "next/navigation";
+
+export default function HiddenChangelogSourceLayout() {
+  notFound();
+}
+`;
 const FILE_EXTS = [
 	"tsx",
 	"ts",
@@ -174,6 +212,7 @@ function createDocsWorkspaceAliases() {
 		"@farming-labs/docs/server": "./packages/docs/src/server.ts",
 		"@farming-labs/next": "./packages/next/src/index.ts",
 		"@farming-labs/next/api": "./packages/next/src/api.ts",
+		"@farming-labs/next/changelog": "./packages/next/src/changelog.tsx",
 		"@farming-labs/next/client-callbacks": "./packages/next/src/client-callbacks.tsx",
 		"@farming-labs/next/layout": "./packages/next/src/layout.tsx",
 		"@farming-labs/next/mdx-plugins/rehype-code": "./packages/next/src/mdx-plugins/rehype-code.ts",
@@ -216,8 +255,8 @@ function readDocsContentDir(root) {
 		const configPath = join(root, `docs.config.${ext}`);
 		if (!existsSync(configPath)) continue;
 		try {
-			const match = readFileSync(configPath, "utf-8").match(/contentDir\s*:\s*["']([^"']+)["']/);
-			if (match?.[1]) return match[1];
+			const contentDir = readTopLevelStringProperty(readFileSync(configPath, "utf-8"), "contentDir");
+			if (contentDir) return contentDir;
 		} catch {}
 	}
 }
@@ -284,6 +323,223 @@ function readApiReferenceConfig(root) {
 		routeRoot: "api"
 	};
 }
+function readChangelogConfig(root) {
+	for (const ext of FILE_EXTS) {
+		const configPath = join(root, `docs.config.${ext}`);
+		if (!existsSync(configPath)) continue;
+		try {
+			const content = readFileSync(configPath, "utf-8");
+			if (content.match(/changelog\s*:\s*false/)) return {
+				enabled: false,
+				path: "changelog",
+				contentDir: "changelog"
+			};
+			if (content.match(/changelog\s*:\s*true/)) return {
+				enabled: true,
+				path: "changelog",
+				contentDir: "changelog"
+			};
+			const block = extractObjectLiteral(content, "changelog");
+			if (!block) continue;
+			const enabledMatch = block.match(/enabled\s*:\s*(true|false)/);
+			const pathMatch = block.match(/path\s*:\s*["']([^"']+)["']/);
+			const contentDirMatch = block.match(/contentDir\s*:\s*["']([^"']+)["']/);
+			return {
+				enabled: enabledMatch ? enabledMatch[1] !== "false" : true,
+				path: pathMatch?.[1]?.replace(/^\/+|\/+$/g, "") || "changelog",
+				contentDir: contentDirMatch?.[1]?.replace(/\/+$/, "") || "changelog"
+			};
+		} catch {
+			return {
+				enabled: false,
+				path: "changelog",
+				contentDir: "changelog"
+			};
+		}
+	}
+	return {
+		enabled: false,
+		path: "changelog",
+		contentDir: "changelog"
+	};
+}
+function resolveDocsContentDir(root, appDir, entry) {
+	const configuredContentDir = readDocsContentDir(root);
+	if (!configuredContentDir) return join(root, appDir, entry);
+	return isAbsolute(configuredContentDir) ? configuredContentDir : join(root, configuredContentDir);
+}
+function resolveChangelogContentDir(root, appDir, entry, changelogContentDir) {
+	if (isAbsolute(changelogContentDir)) return changelogContentDir;
+	return join(resolveDocsContentDir(root, appDir, entry), changelogContentDir);
+}
+function findChangelogSourceEntries(changelogDir) {
+	if (!existsSync(changelogDir)) return [];
+	const entries = [];
+	for (const name of readdirSync(changelogDir).sort()) {
+		if (!/^\d{4}-\d{2}-\d{2}$/.test(name)) continue;
+		const entryDir = join(changelogDir, name);
+		try {
+			if (!statSync(entryDir).isDirectory()) continue;
+		} catch {
+			continue;
+		}
+		const sourceFile = ["page.mdx", "page.md"].map((fileName) => join(entryDir, fileName)).find((value) => existsSync(value));
+		if (!sourceFile) continue;
+		let metadata = {};
+		try {
+			metadata = matter(readFileSync(sourceFile, "utf-8")).data;
+		} catch {
+			metadata = {};
+		}
+		entries.push({
+			slug: name,
+			date: name,
+			sourceFile,
+			metadata
+		});
+	}
+	return entries.sort((left, right) => right.date.localeCompare(left.date));
+}
+function extractRootObjectLiteral(content) {
+	const candidateIndexes = [content.search(/\bdefineDocs\s*\(/), content.search(/\bexport\s+default\b/)].filter((value) => value !== -1);
+	for (const startIndex of candidateIndexes) {
+		const braceStart = content.indexOf("{", startIndex);
+		if (braceStart === -1) continue;
+		let depth = 0;
+		let inString = null;
+		let escaped = false;
+		for (let index = braceStart; index < content.length; index += 1) {
+			const char = content[index];
+			if (inString) {
+				if (escaped) {
+					escaped = false;
+					continue;
+				}
+				if (char === "\\") {
+					escaped = true;
+					continue;
+				}
+				if (char === inString) inString = null;
+				continue;
+			}
+			if (char === "\"" || char === "'" || char === "`") {
+				inString = char;
+				continue;
+			}
+			if (char === "{") {
+				depth += 1;
+				continue;
+			}
+			if (char !== "}") continue;
+			depth -= 1;
+			if (depth === 0) return content.slice(braceStart + 1, index);
+		}
+	}
+}
+function readTopLevelStringProperty(content, key) {
+	const block = extractRootObjectLiteral(content);
+	if (!block) return void 0;
+	let objectDepth = 0;
+	let arrayDepth = 0;
+	let parenDepth = 0;
+	let inString = null;
+	let inLineComment = false;
+	let inBlockComment = false;
+	let escaped = false;
+	for (let index = 0; index < block.length; index += 1) {
+		const char = block[index];
+		const next = block[index + 1];
+		if (inLineComment) {
+			if (char === "\n") inLineComment = false;
+			continue;
+		}
+		if (inBlockComment) {
+			if (char === "*" && next === "/") {
+				inBlockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (inString) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === inString) inString = null;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			inLineComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			inBlockComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			inString = char;
+			continue;
+		}
+		if (char === "{") {
+			objectDepth += 1;
+			continue;
+		}
+		if (char === "}") {
+			objectDepth = Math.max(0, objectDepth - 1);
+			continue;
+		}
+		if (char === "[") {
+			arrayDepth += 1;
+			continue;
+		}
+		if (char === "]") {
+			arrayDepth = Math.max(0, arrayDepth - 1);
+			continue;
+		}
+		if (char === "(") {
+			parenDepth += 1;
+			continue;
+		}
+		if (char === ")") {
+			parenDepth = Math.max(0, parenDepth - 1);
+			continue;
+		}
+		if (objectDepth !== 0 || arrayDepth !== 0 || parenDepth !== 0) continue;
+		if (!block.startsWith(key, index)) continue;
+		const before = block[index - 1] ?? "";
+		const after = block[index + key.length] ?? "";
+		if (/[A-Za-z0-9_$]/.test(before) || /[A-Za-z0-9_$]/.test(after)) continue;
+		let cursor = index + key.length;
+		while (/\s/.test(block[cursor] ?? "")) cursor += 1;
+		if (block[cursor] !== ":") continue;
+		cursor += 1;
+		while (/\s/.test(block[cursor] ?? "")) cursor += 1;
+		const quote = block[cursor];
+		if (quote !== "\"" && quote !== "'") continue;
+		cursor += 1;
+		let value = "";
+		for (; cursor < block.length; cursor += 1) {
+			const valueChar = block[cursor];
+			if (valueChar === "\\") {
+				const escapedChar = block[cursor + 1];
+				if (escapedChar) {
+					value += escapedChar;
+					cursor += 1;
+				}
+				continue;
+			}
+			if (valueChar === quote) return value;
+			value += valueChar;
+		}
+		return;
+	}
+}
 function extractObjectLiteral(content, key) {
 	const keyIndex = content.search(new RegExp(`${key}\\s*:\\s*\\{`));
 	if (keyIndex === -1) return void 0;
@@ -301,6 +557,84 @@ function extractObjectLiteral(content, key) {
 		if (depth === 0) return content.slice(braceStart + 1, index);
 	}
 }
+function toImportPath(fromFile, toFile) {
+	const relativePath = relative(dirname(fromFile), toFile).replaceAll("\\", "/");
+	return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+}
+function buildInlineChangelogEntriesSource(root, pagePath, entryPath, routePath, entries) {
+	const imports = [];
+	const records = [];
+	entries.forEach((entry, index) => {
+		const importName = `ChangelogEntry${index + 1}`;
+		imports.push(`import ${importName} from "${toImportPath(pagePath, entry.sourceFile)}";`);
+		records.push(`  {
+    slug: ${JSON.stringify(entry.slug)},
+    date: ${JSON.stringify(entry.date)},
+    url: ${JSON.stringify(`/${entryPath}/${routePath}/${entry.slug}`)},
+    sourcePath: ${JSON.stringify(relative(root, entry.sourceFile).replaceAll("\\", "/"))},
+    Component: ${importName},
+    metadata: ${JSON.stringify(entry.metadata)},
+  }`);
+	});
+	return {
+		importsSource: `import type { GeneratedChangelogEntry } from "@farming-labs/next/changelog";
+${imports.join("\n")}`.trimEnd(),
+		entriesSource: `export const changelogEntries: GeneratedChangelogEntry[] = [
+${records.join(",\n")}
+];
+`
+	};
+}
+function buildChangelogIndexPageSource(root, pagePath, entryPath, routePath, entries) {
+	const { importsSource, entriesSource } = buildInlineChangelogEntriesSource(root, pagePath, entryPath, routePath, entries);
+	return `\
+${GENERATED_BANNER}
+import docsConfig from "@/docs.config";
+${importsSource}
+import {
+  createNextChangelogIndexMetadata,
+  createNextChangelogIndexPage,
+} from "@farming-labs/next/changelog";
+
+${entriesSource}
+
+export const metadata = createNextChangelogIndexMetadata(docsConfig);
+
+const ChangelogPage = createNextChangelogIndexPage(docsConfig, changelogEntries);
+
+export default ChangelogPage;
+`;
+}
+function buildChangelogEntryPageSource(root, pagePath, entryPath, routePath, entries) {
+	const { importsSource, entriesSource } = buildInlineChangelogEntriesSource(root, pagePath, entryPath, routePath, entries);
+	return `\
+${GENERATED_BANNER}
+import docsConfig from "@/docs.config";
+${importsSource}
+import {
+  createNextChangelogEntryMetadata,
+  createNextChangelogEntryPage,
+  createNextChangelogStaticParams,
+} from "@farming-labs/next/changelog";
+
+${entriesSource}
+
+export const generateStaticParams = createNextChangelogStaticParams(changelogEntries);
+export const generateMetadata = createNextChangelogEntryMetadata(docsConfig, changelogEntries);
+
+const ChangelogEntryPage = createNextChangelogEntryPage(docsConfig, changelogEntries);
+
+export default ChangelogEntryPage;
+`;
+}
+function resolveManagedChangelogSourceLayoutPath(root, appDir, entry, changelogContentDir) {
+	if (isAbsolute(changelogContentDir)) return void 0;
+	const appRoot = join(root, appDir);
+	const contentRoot = resolveChangelogContentDir(root, appDir, entry, changelogContentDir);
+	const relativePath = relative(appRoot, contentRoot);
+	if (relativePath.startsWith("..") || isAbsolute(relativePath)) return void 0;
+	return join(contentRoot, "layout.tsx");
+}
 function removeManagedFile(filePath) {
 	if (isManagedGeneratedFile(filePath)) rmSync(filePath, { force: true });
 }
@@ -342,6 +676,37 @@ function normalizeRoutePath(route) {
 	const normalized = `/${route}`.replace(/\/+/g, "/");
 	return normalized !== "/" ? normalized.replace(/\/+$/, "") : "/api/docs/mcp";
 }
+function buildDocsMarkdownRewrites(entry) {
+	const normalizedEntry = entry.replace(/^\/+|\/+$/g, "") || "docs";
+	return [{
+		source: `/${normalizedEntry}.md`,
+		destination: "/api/docs/markdown"
+	}, {
+		source: `/${normalizedEntry}/:slug*.md`,
+		destination: "/api/docs/markdown/:slug*"
+	}];
+}
+function dedupeRewrites(rewrites) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const rewrite of rewrites) {
+		const key = `${rewrite.source}=>${rewrite.destination}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		result.push(rewrite);
+	}
+	return result;
+}
+function mergeDocsMarkdownRewrites(entry, result) {
+	const docsMarkdownRewrites = buildDocsMarkdownRewrites(entry);
+	if (!result) return [...docsMarkdownRewrites];
+	if (Array.isArray(result)) return dedupeRewrites([...docsMarkdownRewrites, ...result]);
+	return {
+		beforeFiles: dedupeRewrites([...docsMarkdownRewrites, ...result.beforeFiles ?? []]),
+		afterFiles: result.afterFiles ?? [],
+		fallback: result.fallback ?? []
+	};
+}
 function withDocs(nextConfig = {}) {
 	const root = process.cwd();
 	const workspaceRoot = findDocsWorkspaceRoot(root);
@@ -363,6 +728,11 @@ function withDocs(nextConfig = {}) {
 		mkdirSync(docsApiRouteDir, { recursive: true });
 		writeFileSync(join(docsApiRouteDir, "route.ts"), DOCS_API_ROUTE_TEMPLATE);
 	}
+	const docsMarkdownRouteDir = join(root, appDir, "api", "docs", "markdown", "[[...slug]]");
+	if (!isStaticExport && (!hasFile(docsMarkdownRouteDir, "route") || isManagedGeneratedFile(join(docsMarkdownRouteDir, "route.ts")))) {
+		mkdirSync(docsMarkdownRouteDir, { recursive: true });
+		writeFileSync(join(docsMarkdownRouteDir, "route.ts"), DOCS_MARKDOWN_ROUTE_TEMPLATE);
+	}
 	const mcp = readMcpConfig(root);
 	const docsMcpRouteDir = join(root, appDir, "api", "docs", "mcp");
 	if (mcp.enabled && mcp.route === "/api/docs/mcp" && !isStaticExport && !hasFile(docsMcpRouteDir, "route")) {
@@ -398,6 +768,43 @@ function withDocs(nextConfig = {}) {
 			}
 		}
 	}
+	const changelog = readChangelogConfig(root);
+	if (changelog.enabled) {
+		const changelogBaseDir = join(root, appDir, entry, ...changelog.path.split("/"));
+		const changelogEntryDir = join(changelogBaseDir, "[slug]");
+		const changelogIndexPath = join(changelogBaseDir, "page.tsx");
+		const changelogEntryPath = join(changelogEntryDir, "page.tsx");
+		const changelogSourceDir = resolveChangelogContentDir(root, appDir, entry, changelog.contentDir);
+		const changelogUsesSourcePagesAsDetails = !isAbsolute(changelog.contentDir) && changelog.contentDir === changelog.path;
+		const changelogEntries = findChangelogSourceEntries(changelogSourceDir);
+		const changelogSourceLayoutPath = resolveManagedChangelogSourceLayoutPath(root, appDir, entry, changelog.contentDir);
+		const legacyChangelogBaseDirs = new Set([join(root, appDir, ...changelog.path.split("/")), ...isAbsolute(changelog.contentDir) ? [] : [join(root, appDir, ...changelog.contentDir.split("/"))]]);
+		for (const legacyChangelogBaseDir of legacyChangelogBaseDirs) {
+			if (legacyChangelogBaseDir === changelogBaseDir) continue;
+			removeManagedFile(join(legacyChangelogBaseDir, "[slug]", "page.tsx"));
+			removeManagedFile(join(legacyChangelogBaseDir, "page.tsx"));
+			removeManagedFile(join(legacyChangelogBaseDir, "__changelog.generated.tsx"));
+		}
+		mkdirSync(changelogBaseDir, { recursive: true });
+		removeManagedFile(join(changelogBaseDir, "__changelog.generated.tsx"));
+		if (!hasFile(changelogBaseDir, "page") || isManagedGeneratedFile(changelogIndexPath)) writeFileSync(changelogIndexPath, buildChangelogIndexPageSource(root, changelogIndexPath, entry, changelog.path, changelogEntries));
+		if (changelogUsesSourcePagesAsDetails) {
+			removeManagedFile(changelogEntryPath);
+			if (changelogSourceLayoutPath) removeManagedFile(changelogSourceLayoutPath);
+		} else {
+			if (!hasFile(changelogEntryDir, "page") || isManagedGeneratedFile(changelogEntryPath)) {
+				mkdirSync(changelogEntryDir, { recursive: true });
+				writeFileSync(changelogEntryPath, buildChangelogEntryPageSource(root, changelogEntryPath, entry, changelog.path, changelogEntries));
+			}
+			if (changelogSourceLayoutPath) {
+				const changelogSourceLayoutDir = dirname(changelogSourceLayoutPath);
+				if (!hasFile(changelogSourceLayoutDir, "layout") || isManagedGeneratedFile(changelogSourceLayoutPath)) {
+					mkdirSync(changelogSourceLayoutDir, { recursive: true });
+					writeFileSync(changelogSourceLayoutPath, CHANGELOG_SOURCE_LAYOUT_TEMPLATE);
+				}
+			}
+		}
+	}
 	const ogEndpoint = readOgEndpoint(root);
 	const remarkPlugins = ["remark-gfm", "remark-frontmatter"];
 	if (ogEndpoint) remarkPlugins.push(["@farming-labs/next/mdx-plugins/remark-og", { endpoint: ogEndpoint }]);
@@ -450,6 +857,17 @@ function withDocs(nextConfig = {}) {
 		const resolvedConfig = userWebpack ? userWebpack(config, options) : config;
 		resolvedConfig.resolve ??= {};
 		resolvedConfig.resolve.alias ??= {};
+		if (workspaceRoot) Object.assign(resolvedConfig.resolve.alias, {
+			"@farming-labs/docs$": join(workspaceRoot, "packages", "docs", "dist", "index.mjs"),
+			"@farming-labs/docs/server": join(workspaceRoot, "packages", "docs", "dist", "server.mjs"),
+			"@farming-labs/next$": join(workspaceRoot, "packages", "next", "dist", "index.mjs"),
+			"@farming-labs/next/api": join(workspaceRoot, "packages", "next", "dist", "api.mjs"),
+			"@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/theme$": join(workspaceRoot, "packages", "fumadocs", "dist", "index.mjs"),
+			"@farming-labs/theme/api": join(workspaceRoot, "packages", "fumadocs", "dist", "docs-api.mjs")
+		});
 		resolvedConfig.resolve.alias[INTERNAL_DOCS_CONFIG_ALIAS] = docsConfigAbsolutePath;
 		resolvedConfig.resolve.alias["fumadocs-openapi"] = FUMADOCS_OPENAPI_PACKAGE_ALIAS;
 		resolvedConfig.resolve.alias["fumadocs-openapi/ui"] = FUMADOCS_OPENAPI_UI_ALIAS;
@@ -465,9 +883,17 @@ function withDocs(nextConfig = {}) {
 	};
 	const existingTracingIncludes = nextConfig.outputFileTracingIncludes ?? {};
 	const docsTraceGlob = docsContentDir.replace(/\\/g, "/").replace(/^\.?\//, "") + "/**/*";
+	if (!isStaticExport) {
+		const existingRewrites = nextConfig.rewrites;
+		nextConfig.rewrites = async () => {
+			return mergeDocsMarkdownRewrites(entry, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
+		};
+	}
 	nextConfig.outputFileTracingIncludes = {
 		...existingTracingIncludes,
 		"/api/docs": [...new Set([...existingTracingIncludes["/api/docs"] ?? [], docsTraceGlob])],
+		"/api/docs/markdown": [...new Set([...existingTracingIncludes["/api/docs/markdown"] ?? [], docsTraceGlob])],
+		"/api/docs/markdown/[[...slug]]": [...new Set([...existingTracingIncludes["/api/docs/markdown/[[...slug]]"] ?? [], docsTraceGlob])],
 		"/api/docs/mcp": [...new Set([...existingTracingIncludes["/api/docs/mcp"] ?? [], docsTraceGlob])]
 	};
 	return withMDX(nextConfig);

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner } from "./api-reference.mjs";
 import { createDocsAPI, createDocsMCPAPI } from "./api.mjs";
+import { GeneratedChangelogEntry, createNextChangelogEntryMetadata, createNextChangelogEntryPage, createNextChangelogIndexMetadata, createNextChangelogIndexPage, createNextChangelogStaticParams } from "./changelog.mjs";
 import { withDocs } from "./config.mjs";
-export { buildNextOpenApiDocument, createDocsAPI, createDocsMCPAPI, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };
+export { type GeneratedChangelogEntry, buildNextOpenApiDocument, createDocsAPI, createDocsMCPAPI, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, createNextChangelogEntryMetadata, createNextChangelogEntryPage, createNextChangelogIndexMetadata, createNextChangelogIndexPage, createNextChangelogStaticParams, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };

package/dist/index.mjs

@@ -1,5 +1,6 @@
 import { withDocs } from "./config.mjs";
 import { createDocsAPI, createDocsMCPAPI } from "./api.mjs";
 import { buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner } from "./api-reference.mjs";
+import { createNextChangelogEntryMetadata, createNextChangelogEntryPage, createNextChangelogIndexMetadata, createNextChangelogIndexPage, createNextChangelogStaticParams } from "./changelog.mjs";
 
-export { buildNextOpenApiDocument, createDocsAPI, createDocsMCPAPI, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };
+export { buildNextOpenApiDocument, createDocsAPI, createDocsMCPAPI, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, createNextChangelogEntryMetadata, createNextChangelogEntryPage, createNextChangelogIndexMetadata, createNextChangelogIndexPage, createNextChangelogStaticParams, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withDocs, withNextApiReferenceBanner };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -34,6 +34,11 @@
       "import": "./dist/api.mjs",
       "default": "./dist/api.mjs"
     },
+    "./changelog": {
+      "types": "./dist/changelog.d.mts",
+      "import": "./dist/changelog.mjs",
+      "default": "./dist/changelog.mjs"
+    },
     "./client-callbacks": {
       "types": "./dist/client-callbacks.d.mts",
       "import": "./dist/client-callbacks.mjs",
@@ -78,6 +83,7 @@
     "fumadocs-openapi": "^10.7.0",
     "fumadocs-core": "^16.6.1",
     "fumadocs-ui": "^16.6.1",
+    "gray-matter": "^4.0.3",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.1",
     "remark-mdx-frontmatter": "^5.0.0"
@@ -89,8 +95,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.13",
-    "@farming-labs/theme": "0.1.13"
+    "@farming-labs/docs": "0.1.16",
+    "@farming-labs/theme": "0.1.16"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",