fixes for next 16

AGENTS.md

@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

next.config.mjs

@@ -1,10 +1,11 @@
 /** @type {import('next').NextConfig} */
 
 import createMDX from "@next/mdx";
-import rehypeUnwrapImages from 'rehype-unwrap-images'
-import remarkFrontmatter from 'remark-frontmatter'
-import remarkGfm from 'remark-gfm'
-import { remarkVersionSubstitution } from './scripts/remark-version-substitution.mjs'
+import { fileURLToPath } from 'node:url'
+
+const remarkVersionSubstitutionPath = fileURLToPath(
+  new URL('./scripts/remark-version-substitution.mjs', import.meta.url)
+)
 
 const nextConfig = {
   pageExtensions: ['js', 'jsx', 'md', 'mdx', 'ts', 'tsx'],
@@ -29,6 +30,18 @@ const nextConfig = {
     });
     return config;
   },
+  turbopack: {
+    rules: {
+      '*.yaml': {
+        loaders: ['yaml-loader'],
+        as: '*.js',
+      },
+      '*.yml': {
+        loaders: ['yaml-loader'],
+        as: '*.js',
+      },
+    },
+  },
   images: {
     remotePatterns: [
       {
@@ -42,8 +55,9 @@ const nextConfig = {
 
 const withMDX = createMDX({
   options: {
-    remarkPlugins: [remarkFrontmatter, remarkGfm, remarkVersionSubstitution],
-    rehypePlugins: [rehypeUnwrapImages],
+    // Turbopack requires serializable options: plugins as name/path strings
+    remarkPlugins: ['remark-frontmatter', 'remark-gfm', remarkVersionSubstitutionPath],
+    rehypePlugins: ['rehype-unwrap-images'],
   },
 })
 

package.json

@@ -21,8 +21,8 @@
     "@heroicons/react": "^2.2.0",
     "@mdx-js/loader": "^3.1.1",
     "@mdx-js/react": "^3.1.1",
-    "@next/mdx": "^15.5.4",
-    "@next/third-parties": "^15.5.4",
+    "@next/mdx": "^16.3.0",
+    "@next/third-parties": "^16.3.0",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-separator": "^1.1.7",
     "@radix-ui/react-slot": "^1.2.3",