fix: update docs

Author: juliankoehn

biome.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.2.4/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.3.4/schema.json",
 	"vcs": {
 		"enabled": false,
 		"clientKind": "git",

package.json

@@ -18,10 +18,10 @@
 		"@radix-ui/react-scroll-area": "^1.2.10",
 		"class-variance-authority": "^0.7.1",
 		"clsx": "^2.1.1",
-		"fumadocs-core": "16.0.7",
-		"fumadocs-mdx": "13.0.5",
+		"fumadocs-core": "16.2.3",
+		"fumadocs-mdx": "14.1.0",
 		"fumadocs-typescript": "^4.0.12",
-		"fumadocs-ui": "16.0.7",
+		"fumadocs-ui": "16.2.3",
 		"lucide-react": "^0.552.0",
 		"mermaid": "^11.12.1",
 		"next": "16.0.7",
@@ -30,7 +30,9 @@
 		"react-dom": "^19.2.0",
 		"rehype-stringify": "^10.0.1",
 		"remark": "^15.0.1",
-		"tailwind-merge": "^3.3.1"
+		"shiki": "^3.19.0",
+		"tailwind-merge": "^3.3.1",
+		"zod": "^4.1.13"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.4",

pnpm-lock.yaml

@@ -5,20 +5,35 @@ import {
 	frontmatterSchema,
 	metaSchema,
 } from "fumadocs-mdx/config";
+import jsonSchema from "fumadocs-mdx/plugins/json-schema";
+import lastModified from "fumadocs-mdx/plugins/last-modified";
+import { z } from "zod";
 
 // You can customise Zod schemas for frontmatter and `meta.json` here
 // see https://fumadocs.dev/docs/mdx/collections#define-docs
 export const docs = defineDocs({
 	docs: {
 		schema: frontmatterSchema,
+		postprocess: {
+			includeProcessedMarkdown: true,
+		},
+		async: true,
 	},
 	meta: {
-		schema: metaSchema,
+		schema: metaSchema.extend({
+			description: z.string().optional(),
+		}),
 	},
 });
 
 export default defineConfig({
-	lastModifiedTime: "git",
+	plugins: [
+		jsonSchema({
+			insert: true,
+		}),
+		lastModified(),
+	],
+	// lastModifiedTime: "git",
 	mdxOptions: {
 		rehypePlugins: (v) => [rehypeCode, ...v],
 	},

source.config.ts

@@ -1,12 +1,12 @@
-import { createRelativeLink } from "fumadocs-ui/mdx";
-import type { Metadata } from "next";
-import { notFound } from "next/navigation";
 import {
 	DocsBody,
 	DocsDescription,
 	DocsPage,
 	DocsTitle,
-} from "@/components/layout/page";
+} from "fumadocs-ui/layouts/docs/page";
+import { createRelativeLink } from "fumadocs-ui/mdx";
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
 import { LLMCopyButton, ViewOptions } from "@/components/page-actions";
 import { source } from "@/lib/source";
 import { getMDXComponents } from "@/mdx-components";
@@ -21,10 +21,10 @@ export default async function Page({ params }: Props) {
 
 	if (!page) notFound();
 
-	const MDXContent = page.data.body;
+	const { body: MDXContent, toc, lastModified } = await page.data.load();
 
 	return (
-		<DocsPage toc={page.data.toc} full={page.data.full}>
+		<DocsPage toc={toc}>
 			<DocsTitle>{page.data.title}</DocsTitle>
 			<DocsDescription className="mb-0">
 				{page.data.description}

src/app/[lang]/(docs)/[...slug]/page.tsx

@@ -1,6 +1,6 @@
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import type { ReactNode } from "react";
 import { LegalFooter } from "@/components/LegalFooter";
-import { DocsLayout } from "@/components/layout/docs";
 import { baseOptions } from "@/lib/layout.shared";
 import { source } from "@/lib/source";
 
@@ -18,8 +18,17 @@ export default async function Layout({
 	return (
 		<DocsLayout
 			{...base}
-			tabMode="navbar"
-			nav={{ ...nav, mode: "top" }}
+			//tabMode="top"
+			nav={{
+				...nav,
+				title: (
+					<>
+						<span className="font-medium in-[.uwu]:hidden max-md:hidden">
+							Kopexa
+						</span>
+					</>
+				),
+			}}
 			tree={source.pageTree[lang]}
 		>
 			{children}

src/app/[lang]/(docs)/layout.tsx

@@ -1,26 +1,15 @@
 import "@/app/global.css";
-import { defineI18nUI } from "fumadocs-ui/i18n";
-import { RootProvider } from "fumadocs-ui/provider";
+import { NextProvider } from "fumadocs-core/framework/next";
+import { TreeContextProvider } from "fumadocs-ui/contexts/tree";
 import { Inter } from "next/font/google";
 import { BackgroundPattern } from "@/components/background-pattern";
-import { i18n } from "@/lib/i18n";
+import { source } from "@/lib/source";
+import { Provider } from "./provider";
 
 const inter = Inter({
 	subsets: ["latin"],
 });
 
-const { provider } = defineI18nUI(i18n, {
-	translations: {
-		en: {
-			displayName: "English",
-		},
-		de: {
-			displayName: "German",
-			search: "Suchen...",
-		},
-	},
-});
-
 export default async function Layout({
 	params,
 	children,
@@ -34,20 +23,11 @@ export default async function Layout({
 		<html lang={lang} className={inter.className} suppressHydrationWarning>
 			<body className="flex flex-col min-h-screen" suppressHydrationWarning>
 				<BackgroundPattern />
-				<RootProvider
-					search={{
-						enabled: true,
-						hotKey: [
-							{
-								display: "K",
-								key: "k", // key code, or a function determining whether the key is pressed
-							},
-						],
-					}}
-					i18n={provider(lang)}
-				>
-					{children}
-				</RootProvider>
+				<NextProvider>
+					<TreeContextProvider tree={source.pageTree[lang]}>
+						<Provider lang={lang}>{children}</Provider>
+					</TreeContextProvider>
+				</NextProvider>
 			</body>
 		</html>
 	);

src/app/[lang]/layout.tsx

@@ -0,0 +1,41 @@
+import { defineI18nUI } from "fumadocs-ui/i18n";
+import { RootProvider } from "fumadocs-ui/provider/base";
+import type { ReactNode } from "react";
+import { i18n } from "@/lib/i18n";
+
+const { provider } = defineI18nUI(i18n, {
+	translations: {
+		en: {
+			displayName: "English",
+		},
+		de: {
+			displayName: "German",
+			search: "Suchen...",
+		},
+	},
+});
+
+export function Provider({
+	children,
+	lang,
+}: {
+	children: ReactNode;
+	lang: string;
+}) {
+	return (
+		<RootProvider
+			search={{
+				enabled: true,
+				hotKey: [
+					{
+						display: "K",
+						key: "k", // key code, or a function determining whether the key is pressed
+					},
+				],
+			}}
+			i18n={provider(lang)}
+		>
+			{children}
+		</RootProvider>
+	);
+}

src/app/[lang]/provider.tsx

@@ -7,6 +7,20 @@ export const revalidate = false;
 export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
 	const url = (path: string): string => new URL(path, baseUrl).toString();
 
+	const items = await Promise.all(
+		source.getPages().map(async (page) => {
+			// if (page.data.type === "openapi") return;
+			const { lastModified } = await page.data.load();
+
+			return {
+				url: url(page.url),
+				lastModified: lastModified ? new Date(lastModified) : undefined,
+				changeFrequency: "weekly",
+				priority: 0.5,
+			} as MetadataRoute.Sitemap[number];
+		}),
+	);
+
 	return [
 		{
 			url: url("/"),
@@ -23,16 +37,6 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
 		// 	changeFrequency: "monthly",
 		// 	priority: 0.8,
 		// },
-		...(await Promise.all(
-			source.getPages().map(async (page) => {
-				const lastModified = page.data.lastModified;
-				return {
-					url: url(page.url),
-					lastModified: lastModified ? new Date(lastModified) : undefined,
-					changeFrequency: "weekly",
-					priority: 0.5,
-				} as MetadataRoute.Sitemap[number];
-			}),
-		)),
+		...items.filter((v) => v !== undefined),
 	];
 }