CLI: Require Next.js 15.3.0 or above

fuma-nama · fuma-nama · commit 7fcf612179c5 · 2025-04-10T18:59:22.000+08:00
diff --git a/.changeset/chubby-spies-appear.md b/.changeset/chubby-spies-appear.md
@@ -0,0 +1,5 @@
+---
+'fumadocs-mdx': minor
+---
+
+Require Next.js 15.3.0 or above
diff --git a/apps/docs/package.json b/apps/docs/package.json
@@ -15,12 +15,12 @@
     "@fumadocs/mdx-remote": "workspace:*",
     "@inkeep/ai-api": "^0.8.0",
     "@oramacloud/client": "^2.1.4",
-    "@radix-ui/react-dialog": "^1.1.6",
-    "@radix-ui/react-hover-card": "^1.1.6",
-    "@radix-ui/react-popover": "^1.1.6",
-    "@radix-ui/react-slot": "^1.1.2",
-    "@radix-ui/react-tooltip": "^1.1.8",
-    "@shikijs/rehype": "^3.2.1",
+    "@radix-ui/react-dialog": "^1.1.7",
+    "@radix-ui/react-hover-card": "^1.1.7",
+    "@radix-ui/react-popover": "^1.1.7",
+    "@radix-ui/react-slot": "^1.2.0",
+    "@radix-ui/react-tooltip": "^1.2.0",
+    "@shikijs/rehype": "^3.2.2",
     "class-variance-authority": "^0.7.1",
     "fumadocs-core": "workspace:*",
     "fumadocs-docgen": "workspace:^",
@@ -30,13 +30,13 @@
     "fumadocs-typescript": "workspace:^",
     "fumadocs-ui": "workspace:*",
     "hast-util-to-jsx-runtime": "^2.3.6",
-    "katex": "^0.16.21",
+    "katex": "^0.16.22",
     "lucide-react": "^0.487.0",
     "mermaid": "^11.6.0",
-    "next": "15.2.4",
+    "next": "15.3.0",
     "next-themes": "^0.4.6",
     "octokit": "^4.1.2",
-    "oxc-transform": "^0.62.0",
+    "oxc-transform": "^0.63.0",
     "phenomenon": "^1.6.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
@@ -48,22 +48,22 @@
     "remark-rehype": "^11.1.2",
     "remark-stringify": "^11.0.0",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.2.1",
+    "shiki": "^3.2.2",
     "tailwind-merge": "^3.2.0",
     "twoslash": "^0.3.1",
     "zod": "^3.24.2"
   },
   "devDependencies": {
     "@fumadocs/cli": "workspace:*",
-    "@next/bundle-analyzer": "15.2.4",
-    "@next/env": "15.2.4",
-    "@next/eslint-plugin-next": "15.2.4",
+    "@next/bundle-analyzer": "15.3.0",
+    "@next/env": "15.3.0",
+    "@next/eslint-plugin-next": "15.3.0",
     "@tailwindcss/postcss": "^4.1.3",
     "@types/hast": "^3.0.4",
     "@types/mdx": "^2.0.13",
     "@types/node": "22.14.0",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "eslint-config-custom": "workspace:*",
     "fast-glob": "^3.3.3",
     "gray-matter": "^4.0.3",
diff --git a/examples/content-collections/package.json b/examples/content-collections/package.json
@@ -11,7 +11,7 @@
     "@fumadocs/content-collections": "workspace:*",
     "fumadocs-core": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "next": "^15.2.4",
+    "next": "^15.3.0",
     "react": "19.1.0",
     "react-dom": "19.1.0"
   },
@@ -21,7 +21,7 @@
     "@content-collections/next": "^0.2.6",
     "@types/mdx": "^2.0.13",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "typescript": "^5.8.3"
   }
 }
diff --git a/examples/i18n/package.json b/examples/i18n/package.json
@@ -13,14 +13,14 @@
     "fumadocs-core": "workspace:*",
     "fumadocs-mdx": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "next": "15.2.4",
+    "next": "15.3.0",
     "react": "19.1.0",
     "react-dom": "19.1.0"
   },
   "devDependencies": {
     "@types/mdx": "^2.0.13",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "typescript": "^5.8.3"
   }
 }
diff --git a/examples/next-mdx/package.json b/examples/next-mdx/package.json
@@ -11,14 +11,14 @@
     "fumadocs-core": "workspace:*",
     "fumadocs-mdx": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "next": "15.2.4",
+    "next": "15.3.0",
     "react": "19.1.0",
     "react-dom": "19.1.0"
   },
   "devDependencies": {
     "@types/mdx": "^2.0.13",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "algoliasearch": "4.24.0",
     "typescript": "^5.8.3"
   }
diff --git a/examples/openapi/package.json b/examples/openapi/package.json
@@ -10,22 +10,22 @@
     "types:check": "fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
-    "@scalar/api-client-react": "^1.2.13",
+    "@scalar/api-client-react": "^1.2.15",
     "fumadocs-core": "workspace:*",
     "fumadocs-mdx": "workspace:*",
     "fumadocs-openapi": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "next": "15.2.4",
+    "next": "15.3.0",
     "react": "19.1.0",
     "react-dom": "19.1.0",
-    "shiki": "^3.2.1",
+    "shiki": "^3.2.2",
     "zod": "^3.24.2"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.3",
     "@types/mdx": "^2.0.13",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "postcss": "^8.5.3",
     "rimraf": "^6.0.1",
     "tailwindcss": "^4.1.3",
diff --git a/examples/react-router/package.json b/examples/react-router/package.json
@@ -15,22 +15,22 @@
     "fumadocs-core": "workspace:*",
     "fumadocs-ui": "workspace:*",
     "gray-matter": "^4.0.3",
-    "isbot": "^5.1.17",
+    "isbot": "^5.1.26",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-router": "^7.5.0",
-    "shiki": "^3.2.1"
+    "shiki": "^3.2.2"
   },
   "devDependencies": {
     "@react-router/dev": "^7.5.0",
     "@tailwindcss/vite": "^4.1.3",
     "@types/node": "^22.14.0",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "react-router-devtools": "^1.1.10",
     "tailwindcss": "^4.1.3",
     "typescript": "^5.8.3",
-    "vite": "^6.2.5",
+    "vite": "^6.2.6",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }
diff --git a/examples/remote-mdx/package.json b/examples/remote-mdx/package.json
@@ -12,14 +12,14 @@
     "fast-glob": "^3.3.3",
     "fumadocs-core": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "next": "15.2.4",
+    "next": "15.3.0",
     "react": "19.1.0",
     "react-dom": "19.1.0"
   },
   "devDependencies": {
     "@types/mdx": "^2.0.13",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "typescript": "^5.8.3"
   }
 }
diff --git a/examples/tanstack-start/package.json b/examples/tanstack-start/package.json
@@ -18,16 +18,16 @@
     "gray-matter": "^4.0.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
-    "vinxi": "^0.5.3"
+    "vinxi": "^0.5.4"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.1.3",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "@vitejs/plugin-react": "^4.3.4",
     "tailwindcss": "^4.1.3",
     "typescript": "^5.8.3",
-    "vite": "^6.2.5",
+    "vite": "^6.2.6",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -86,8 +86,8 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.1",
     "@orama/orama": "^3.1.4",
-    "@shikijs/rehype": "^3.2.1",
-    "@shikijs/transformers": "^3.2.1",
+    "@shikijs/rehype": "^3.2.2",
+    "@shikijs/transformers": "^3.2.2",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
     "hast-util-to-jsx-runtime": "^2.3.6",
@@ -97,7 +97,7 @@
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.1",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.2.1",
+    "shiki": "^3.2.2",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
@@ -111,12 +111,12 @@
     "@types/negotiator": "^0.6.3",
     "@types/node": "22.14.0",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "algoliasearch": "4.24.0",
     "eslint-config-custom": "workspace:*",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "^15.2.4",
+    "next": "^15.3.0",
     "react-router": "^7.5.0",
     "remark-mdx": "^3.1.0",
     "remark-rehype": "^11.1.2",
diff --git a/packages/create-app-versions/package.json b/packages/create-app-versions/package.json
@@ -18,22 +18,22 @@
     "@types/mdx": "^2.0.13",
     "@types/node": "22.14.0",
     "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.1",
+    "@types/react-dom": "^19.1.2",
     "@vitejs/plugin-react": "^4.3.4",
     "fast-glob": "^3.3.3",
     "gray-matter": "^4.0.3",
-    "isbot": "^5.1.17",
-    "next": "15.2.4",
+    "isbot": "^5.1.26",
+    "next": "15.3.0",
     "postcss": "^8.5.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-router": "^7.5.0",
     "react-router-devtools": "^1.1.10",
-    "shiki": "^3.2.1",
+    "shiki": "^3.2.2",
     "tailwindcss": "^4.1.3",
     "typescript": "^5.8.3",
-    "vinxi": "^0.5.3",
-    "vite": "^6.2.5",
+    "vinxi": "^0.5.4",
+    "vite": "^6.2.6",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }
diff --git a/packages/doc-gen/package.json b/packages/doc-gen/package.json
@@ -40,7 +40,7 @@
     "estree-util-to-js": "^2.0.0",
     "estree-util-value-to-estree": "^3.3.3",
     "npm-to-yarn": "^3.0.1",
-    "oxc-transform": "^0.62.0",
+    "oxc-transform": "^0.63.0",
     "unist-util-visit": "^5.0.0",
     "zod": "^3.24.2"
   },
diff --git a/packages/mdx/package.json b/packages/mdx/package.json
@@ -71,16 +71,16 @@
     "eslint-config-custom": "workspace:*",
     "fumadocs-core": "workspace:*",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.2.4",
+    "next": "^15.3.0",
     "tsconfig": "workspace:*",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "webpack": "^5.99.1"
+    "webpack": "^5.99.5"
   },
   "peerDependencies": {
     "@fumadocs/mdx-remote": "^1.2.0",
     "fumadocs-core": "^14.0.0 || ^15.0.0",
-    "next": "14.x.x || 15.x.x"
+    "next": "^15.3.0"
   },
   "peerDependenciesMeta": {
     "@fumadocs/mdx-remote": {
diff --git a/packages/mdx/src/map/generate.ts b/packages/mdx/src/map/generate.ts
@@ -8,7 +8,7 @@ import type { DocCollection, MetaCollection } from '@/config';
 import { validate } from '@/utils/schema';
 import { fileCache } from '@/map/file-cache';
 import matter from 'gray-matter';
-import type { RuntimeFile } from '@/runtime';
+import type { AsyncRuntimeFile } from '@/runtime/types';
 
 async function readFileWithCache(file: string): Promise<string> {
   const cached = fileCache.read<string>('read-file', file);
@@ -116,7 +116,7 @@ export async function generateJS(
         info: file,
         data: parsed.data,
         content: parsed.content,
-      } satisfies RuntimeFile);
+      } satisfies AsyncRuntimeFile);
     });
 
     return Promise.all(entries);
diff --git a/packages/mdx/src/next/create.ts b/packages/mdx/src/next/create.ts
@@ -41,22 +41,19 @@ export function createMDX({
 
     return {
       ...nextConfig,
-      experimental: {
-        ...nextConfig.experimental,
-        turbo: {
-          ...nextConfig.experimental?.turbo,
-          rules: {
-            ...nextConfig.experimental?.turbo?.rules,
-            // @ts-expect-error -- safe types
-            '*.{md,mdx}': {
-              loaders: [
-                {
-                  loader: 'fumadocs-mdx/loader-mdx',
-                  options: mdxLoaderOptions,
-                },
-              ],
-              as: '*.js',
-            },
+      turbopack: {
+        ...nextConfig?.turbopack,
+        rules: {
+          ...nextConfig?.turbopack?.rules,
+          // @ts-expect-error -- safe
+          '*.{md,mdx}': {
+            loaders: [
+              {
+                loader: 'fumadocs-mdx/loader-mdx',
+                options: mdxLoaderOptions,
+              },
+            ],
+            as: '*.js',
           },
         },
       },
diff --git a/packages/mdx/src/runtime/async.ts b/packages/mdx/src/runtime/async.ts
@@ -45,6 +45,7 @@ export const _runtimeAsync: RuntimeAsync = {
       return {
         ...data,
         _file: file,
+        content,
         async load() {
           const compiler = await init;
           const out = await compiler.compile({
diff --git a/packages/mdx/src/runtime/index.ts b/packages/mdx/src/runtime/index.ts
@@ -7,8 +7,6 @@ import { type BaseCollectionEntry } from '@/config';
 import type { VirtualFile } from 'fumadocs-core/source';
 import type { Runtime } from '@/runtime/types';
 
-export type { RuntimeFile } from '@/runtime/types';
-
 export const _runtime: Runtime = {
   doc(files) {
     return files.map((file) => {
diff --git a/packages/mdx/src/runtime/types.ts b/packages/mdx/src/runtime/types.ts
diff --git a/packages/openapi/package.json b/packages/openapi/package.json
diff --git a/packages/twoslash/package.json b/packages/twoslash/package.json
diff --git a/packages/typescript/package.json b/packages/typescript/package.json
diff --git a/packages/ui/package.json b/packages/ui/package.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'fumadocs-mdx': minor
 +---
++
 +Require Next.js 15.3.0 or above