doc: Update to Fumadocs 14 / Next 15

README.md

@@ -671,8 +671,8 @@ import { coordinatesCache } from './searchParams'
 import { Server } from './server'
 import { Client } from './client'
 
-export default function Page({ searchParams }) {
-  coordinatesCache.parse(searchParams)
+export default async function Page({ searchParams }) {
+  await coordinatesCache.parse(searchParams)
   return (
     <>
       <Server />

errors/NUQS-500.md

@@ -25,7 +25,8 @@ Run the `parse` method and feed it the page's `searchParams`:
 import {
   createSearchParamsCache,
   parseAsInteger,
-  parseAsString
+  parseAsString,
+  type SearchParams
 } from 'nuqs/server'
 
 const cache = createSearchParamsCache({
@@ -36,10 +37,10 @@ const cache = createSearchParamsCache({
 export default function Page({
   searchParams
 }: {
-  searchParams: Record<string, string | string[] | undefined>
+  searchParams: Promise<SearchParams>
 }) {
   // ⚠️ Don't forget to call `parse` here:
-  const { q: query } = cache.parse(searchParams)
+  const { q: query } = await cache.parse(searchParams)
   return (
     <div>
       <h1>Search Results for {query}</h1>

package.json

@@ -26,12 +26,15 @@
     "commitlint": "^19.5.0",
     "husky": "^9.1.6",
     "prettier": "3.3.3",
-    "semantic-release": "^24.1.2",
-    "sherif": "^1.0.0",
-    "turbo": "^2.1.3",
+    "semantic-release": "^24.2.0",
+    "sherif": "^1.0.1",
+    "turbo": "^2.2.3",
     "typescript": "^5.6.3"
   },
-  "packageManager": "pnpm@9.12.1+sha256.91452fdfa46234ae447d46d5c4fc4e7e0a7058f90495c4b6f77f8beebbb154e3",
+  "packageManager": "pnpm@9.13.0+sha512.beb9e2a803db336c10c9af682b58ad7181ca0fbd0d4119f2b33d5f2582e96d6c0d93c85b23869295b765170fbdaa92890c0da6ada457415039769edf3c959efe",
+  "resolutions": {
+    "@headlessui/react": "2.2.0"
+  },
   "prettier": {
     "arrowParens": "avoid",
     "semi": false,

packages/docs/content/docs/server-side.mdx

@@ -45,7 +45,7 @@ type PageProps = {
 export default async function Page({ searchParams }: PageProps) {
   // ⚠️ Don't forget to call `parse` here.
   // You can access type-safe values from the returned object:
-  const { q: query } = searchParamsCache.parse(await searchParams)
+  const { q: query } = await searchParamsCache.parse(searchParams)
   return (
     <div>
       <h1>Search Results for {query}</h1>
@@ -87,7 +87,7 @@ import { Server } from './server'
 import { Client } from './client'
 
 export default async function Page({ searchParams }) {
-  coordinatesCache.parse(await searchParams)
+  await coordinatesCache.parse(searchParams)
   return (
     <>
       <Server />

packages/docs/content/docs/troubleshooting.mdx

@@ -18,7 +18,7 @@ This limitation doesn't apply to the app router.
 
 ### Different parsers on the same key
 
-Hooks are synced together on a per-key bassis, so if you use different parsers
+Hooks are synced together on a per-key basis, so if you use different parsers
 on the same key, the last state update will be propagated to all other hooks
 using that key. It can lead to unexpected states like this:
 

packages/docs/next.config.mjs

@@ -7,16 +7,13 @@ const withFumadocsMDX = createMDX()
 
 /** @type {import('next').NextConfig} */
 const config = {
-  experimental: {
-    instrumentationHook: true,
-    outputFileTracingIncludes: {
-      '/playground/pagination': [
-        './src/app/playground/(demos)/pagination/searchParams.ts',
-        './src/app/playground/(demos)/pagination/page.tsx',
-        './src/app/playground/(demos)/pagination/pagination-controls.server.tsx',
-        './src/app/playground/(demos)/pagination/pagination-controls.client.tsx'
-      ]
-    }
+  outputFileTracingIncludes: {
+    '/playground/pagination': [
+      './src/app/playground/(demos)/pagination/searchParams.ts',
+      './src/app/playground/(demos)/pagination/page.tsx',
+      './src/app/playground/(demos)/pagination/pagination-controls.server.tsx',
+      './src/app/playground/(demos)/pagination/pagination-controls.client.tsx'
+    ]
   },
   reactStrictMode: true,
   redirects: async () => {

packages/docs/package.json

@@ -14,14 +14,14 @@
     "directory": "packages/docs"
   },
   "scripts": {
-    "dev": "next dev",
+    "dev": "next dev --turbo",
     "build": "next build",
     "start": "next start",
     "postinstall": "fumadocs-mdx"
   },
   "dependencies": {
-    "@faker-js/faker": "^9.0.3",
-    "@headlessui/react": "^2.1.9",
+    "@faker-js/faker": "^9.2.0",
+    "@headlessui/react": "2.2.0",
     "@headlessui/tailwindcss": "^0.2.1",
     "@icons-pack/react-simple-icons": "^10.1.0",
     "@radix-ui/react-checkbox": "^1.1.2",
@@ -33,43 +33,43 @@
     "@radix-ui/react-switch": "^1.1.1",
     "@radix-ui/react-toggle": "^1.1.0",
     "@radix-ui/react-toggle-group": "^1.1.0",
-    "@sentry/nextjs": "^8.33.1",
+    "@sentry/nextjs": "^8.38.0",
     "@tailwindcss/container-queries": "^0.1.1",
-    "@tremor/react": "^3.18.3",
+    "@tremor/react": "^3.18.4",
     "cheerio": "1.0.0-rc.12",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.1",
     "dayjs": "^1.11.13",
-    "fumadocs-core": "^13.4.10",
-    "fumadocs-mdx": "^10.0.2",
-    "fumadocs-ui": "^13.4.10",
-    "lucide-react": "^0.451.0",
-    "next": "14.2.15",
+    "fumadocs-core": "^14.4.0",
+    "fumadocs-mdx": "^11.1.1",
+    "fumadocs-ui": "^14.4.0",
+    "lucide-react": "^0.456.0",
+    "next": "15.0.3",
     "nuqs": "workspace:*",
     "pretty-bytes": "^6.1.1",
     "react": "catalog:react19rc",
     "react-dom": "catalog:react19rc",
-    "recharts": "^2.12.7",
+    "recharts": "^2.13.3",
     "remark-smartypants": "^3.0.2",
     "res": "workspace:*",
     "semver": "^7.6.3",
     "server-only": "^0.0.1",
-    "tailwind-merge": "^2.5.3",
-    "tailwindcss": "^3.4.13",
+    "tailwind-merge": "^2.5.4",
+    "tailwindcss": "^3.4.14",
     "tailwindcss-animate": "^1.0.7",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@shikijs/transformers": "^1.22.0",
+    "@shikijs/transformers": "^1.22.2",
     "@types/mdx": "^2.0.13",
-    "@types/react": "^18.3.11",
-    "@types/react-dom": "^18.3.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
     "@types/semver": "^7.5.8",
     "autoprefixer": "^10.4.20",
     "hast-util-to-jsx-runtime": "^2.3.2",
-    "postcss": "^8.4.47",
+    "postcss": "^8.4.49",
     "prettier-plugin-tailwindcss": "^0.6.8",
-    "shiki": "^1.22.0",
+    "shiki": "^1.22.2",
     "typescript": "^5.6.3"
   },
   "postcss": {

packages/docs/src/app/(pages)/_landing/demo.tsx

@@ -33,46 +33,38 @@ export async function LandingDemo() {
 
 function LookAtTheURL() {
   return (
-    <svg
-      version="1.1"
-      xmlns="http://www.w3.org/2000/svg"
-      viewBox="0 0 270.7398884431316 71.55654506560859"
-      className="pointer-events-none absolute -top-20 left-0 right-0 mx-auto w-64 select-none opacity-0 transition-opacity peer-data-[interacted=true]:opacity-100 sm:left-16 sm:right-auto sm:mx-0 xl:-left-72 xl:-top-6 xl:mx-0"
-      // width="541.4797768862632"
-      // height="143.11309013121718"
-    >
-      <text
-        x="84.43988539137376"
-        y="33.319640699669435"
-        fontFamily="Virgil, Segoe UI Emoji"
-        fontSize="20px"
-        fill="currentColor"
-        direction="ltr"
-        dominantBaseline="text-before-edge"
+    <>
+      <svg
+        xmlns="http://www.w3.org/2000/svg"
+        viewBox="0 0 315 72"
+        className="pointer-events-none absolute -top-20 left-0 right-0 mx-auto w-64 select-none opacity-0 transition-opacity peer-data-[interacted=true]:opacity-100 sm:left-16 sm:right-auto sm:mx-0 xl:-left-72 xl:-top-6 xl:mx-0"
       >
-        Look at the URL!
-      </text>
-      <g strokeLinecap="round" className="opacity-50">
-        <path
-          d="M72 50c-3 2-11 10-18 11s-17 1-23-3c-6-3-10-8-14-16-3-8-6-27-7-32m62 40c-3 2-11 10-18 11s-17 1-23-3c-6-3-10-8-14-16-3-8-6-27-7-32"
-          stroke="currentColor"
-          strokeWidth="1"
-          fill="none"
-          strokeDasharray="3 4"
-        />
-        <path
-          d="m18 24-8-14m8 14-8-14"
+        <g
+          // Arrow
+          strokeLinecap="round"
+          className="opacity-50"
           stroke="currentColor"
           strokeWidth="1"
           fill="none"
-        />
-        <path
-          d="m7 26 3-16M7 26l3-16"
-          stroke="currentColor"
-          strokeWidth="1"
-          fill="none"
-        />
-      </g>
-    </svg>
+        >
+          <path
+            d="M72 50c-3 2-11 10-18 11s-17 1-23-3c-6-3-10-8-14-16-3-8-6-27-7-32m62 40c-3 2-11 10-18 11s-17 1-23-3c-6-3-10-8-14-16-3-8-6-27-7-32"
+            strokeDasharray="3 4"
+          />
+          <path d="m18 24-8-14m8 14-8-14" />
+          <path d="m7 26 3-16M7 26l3-16" />
+        </g>
+        <g
+          // Text
+          fill="currentColor"
+        >
+          <path d="M92.0004 52.8517C88.734 52.7597 82.1643 54.5445 81.7051 49.7045C82.2244 45.0641 85.4917 40.8334 85.6709 36.2531C88.7787 33.3884 87.7595 39.0805 86.774 40.928C86.3567 43.8113 83.3661 47.1269 84.7779 49.8577C88.4384 52.2298 94.423 47.6524 96.833 52.0638C96.4027 54.4093 93.547 52.441 92.0004 52.8517ZM117.319 42.4251C121.456 41.3467 128.248 46.2608 124.393 50.3041C121.381 53.8324 112.228 53.7254 112.285 48.5752C112.701 44.9113 113.309 44.1938 117.319 42.4251ZM114.78 49.2536C116.64 52.6099 123.789 50.5272 123.106 46.7586C120.459 43.0037 114.448 44.5458 114.78 49.2536ZM130.242 48.991C128.75 45.9256 129.87 52.7896 127.642 52.8254C125.068 52.6705 126.33 49.5625 127.064 48.3081C127.085 44.1724 126.515 39.6086 127.09 35.7016C130.43 36.2969 128.554 41.9138 129.428 44.1847C133.999 42.5861 138.029 37.796 143.216 38.6956C144.149 40.8298 139.015 40.5746 137.674 42.0836C136.19 43.8113 132.218 44.4222 131.896 46.7323C132.456 49.3266 134.917 50.1748 136.755 50.6193C137.976 53.5907 133.902 53.8457 132.723 51.562C131.662 50.9593 130.985 49.9078 130.242 48.991ZM163.276 48.9647C161.393 52.672 154.431 55.1847 153.112 49.7001C152.747 44.9879 159.247 40.9377 162.934 43.817C165.425 46.0797 166.257 50.3012 169.763 51.7749C168.103 55.5856 164.612 50.4709 163.276 48.9647ZM155.292 48.9647C157.156 53.2225 163.043 47.4569 161.7 44.7888C158.889 44.7212 155.907 46.0123 155.292 48.9647ZM202.362 51.7224C201.897 47.9314 203.726 45.2453 198.948 47.0737C196.851 49.0364 195.457 44.9335 198.496 44.2086C203.112 44.0097 202.146 43.8417 202.021 39.2734C204.898 37.5277 203.55 42.607 205.015 43.0817C207.081 43.0775 211.41 41.1662 211.844 43.9221C209.755 45.2156 206.69 44.7017 204.516 45.9181C203.452 48.3021 207.19 52.0507 203.702 53.0356C202.901 52.9748 202.697 52.2594 202.362 51.7224Z" />
+          <path d="M219.387 46.4958C216.243 47.5337 215.763 51.6177 213.136 52.9829C210.232 51.3014 213.086 47.2739 211.981 44.526C212.728 42.4511 210.406 37.8319 212.664 37.0409C215.072 39.9266 213.619 44.6874 214.476 47.8352C216.245 45.9692 219.923 41.2182 222.04 45.3927C222.971 47.7964 224.237 50.837 223.616 53.298C220.569 53.1977 221.485 47.6717 219.387 46.4958ZM224.801 49.7525C225.362 44.9719 231.592 39.1128 235.884 43.528C238.895 48.1222 231.048 51.5073 228.084 47.9403C224.979 51.1567 230.798 55.1352 234.098 53.8496C236.583 53.8398 239.758 51.8355 241.925 53.2193C241.666 56.1568 237.044 55.1351 234.939 56.0557C230.704 57.0988 224.571 54.8558 224.801 49.7525ZM228.846 46.522C230.481 47.0176 234.393 47.5295 233.941 44.9462C232.085 43.4403 229.932 44.9215 228.846 46.522ZM252.201 44.6134C252.839 42.613 252.13 38.5144 254.854 38.1526C257.128 40.4324 253.211 43.793 254.778 46.6577C255.164 50.6854 260.015 51.0103 261.672 47.6776C263.699 45.0722 266.022 41.6893 264.954 38.3015C267.499 35.7948 267.86 43.4427 266.214 45.075C263.98 49.0668 262.226 52.6309 256.97 52.7465C253.412 51.9424 252.051 47.8824 252.201 44.6134ZM268.252 46.6534C269.466 42.3169 266.531 32.8108 271.562 34.1782C275.729 36.0535 281.706 35.8095 284.378 40.3501C284.708 43.8413 280.066 44.8347 277.734 45.3139C279.385 47.767 284.776 49.3113 283.196 52.7728C280.366 51.6928 278.636 48.4618 275.816 46.9948C274.088 46.0576 270.254 42.9116 273.426 41.5057C275.735 42.5861 279.933 43.8114 281.542 41.0592C280.222 38.4011 276.188 37.7704 273.426 37.356C268.585 36.5019 272.258 40.924 270.747 43.6593C269.543 46.7024 272.066 49.3584 271.089 52.1424C267.718 55.093 268.533 48.1864 268.252 46.6534ZM295.491 52.8516C292.225 52.7596 285.655 54.5443 285.196 49.7044C285.716 45.0639 288.983 40.8333 289.162 36.253C292.27 33.3883 291.251 39.0804 290.265 40.9279C289.848 43.8111 286.857 47.1267 288.269 49.8575C291.929 52.2297 297.914 47.6523 300.324 52.0637C299.899 54.4127 297.027 52.4369 295.491 52.8516ZM305.094 30.6326C308.022 31.6789 305.307 35.9247 305.54 39.5097C305.401 43.1228 304.726 44.2941 305.139 47.8173C305.612 49.2803 304.085 50.8044 302.791 48.328C302.864 46.011 303.7 35.6977 305.094 30.6326Z" />
+          <path d="M304.078 53.2732C304.762 53.2732 305.316 52.7405 305.316 52.0834C305.316 51.4263 304.762 50.8936 304.078 50.8936C303.395 50.8936 302.841 51.4263 302.841 52.0834C302.841 52.7405 303.395 53.2732 304.078 53.2732Z" />
+          <path d="M174.385 51.97C173.92 48.1789 175.749 45.4927 170.971 47.3212C168.874 49.284 167.479 45.181 170.519 44.4561C175.134 44.2572 174.169 44.0891 174.044 39.5207C176.921 37.775 175.573 42.8544 177.038 43.3291C179.104 43.3249 183.433 41.4136 183.867 44.1695C181.778 45.4631 178.713 44.9492 176.539 46.1656C175.475 48.5497 179.213 52.2983 175.725 53.2832C174.924 53.2225 174.72 52.507 174.385 51.97Z" />
+          <path d="M102.575 42.4747C106.713 41.3963 113.504 46.3105 109.649 50.354C106.638 53.8824 97.4838 53.7753 97.5413 48.625C97.9569 44.961 98.5655 44.2435 102.575 42.4747ZM100.036 49.3034C101.896 52.6598 109.046 50.5771 108.362 46.8083C105.716 43.0534 99.7041 44.5955 100.036 49.3034Z" />
+        </g>
+      </svg>
+    </>
   )
 }

packages/docs/src/app/(pages)/_landing/footer.tsx

@@ -38,17 +38,25 @@ export default function Component() {
             <h3 className="text-xl font-semibold">Quick Links</h3>
             <ul className="space-y-2">
               <li>
-                <Link href="/docs" className="hover:underline">
+                <Link href="/docs" className="hover:underline" prefetch={false}>
                   Documentation
                 </Link>
               </li>
               <li>
-                <Link href="/playground" className="hover:underline">
+                <Link
+                  href="/playground"
+                  className="hover:underline"
+                  prefetch={false}
+                >
                   Playground
                 </Link>
               </li>
               <li>
-                <Link href="/stats" className="hover:underline">
+                <Link
+                  href="/stats"
+                  className="hover:underline"
+                  prefetch={false}
+                >
                   Project Stats
                 </Link>
               </li>
@@ -58,31 +66,31 @@ export default function Component() {
             <h3 className="text-xl font-semibold">Social</h3>
             <ul className="space-y-1">
               <li>
-                <Link
+                <a
                   href="https://github.com/47ng/nuqs"
                   className="inline-flex items-center gap-1 hover:underline"
                 >
                   <SiGithub role="presentation" className="mr-2 size-5" />
                   <span>GitHub</span>
-                </Link>
+                </a>
               </li>
               <li>
-                <Link
+                <a
                   href="https://www.youtube.com/@47ng-dev"
                   className="inline-flex items-center gap-1 hover:underline"
                 >
                   <SiYoutube role="presentation" className="mr-2 size-5" />
                   <span>YouTube</span>
-                </Link>
+                </a>
               </li>
               <li>
-                <Link
+                <a
                   href="https://bsky.app/profile/nuqs.47ng.com"
                   className="inline-flex items-center gap-1 hover:underline"
                 >
                   <SiBluesky role="presentation" className="mr-2 size-5" />
                   <span>Bluesky</span>
-                </Link>
+                </a>
               </li>
             </ul>
           </div>

packages/docs/src/app/(pages)/_landing/hero.tsx

@@ -7,7 +7,7 @@ import { LandingDemo } from './demo'
 
 export function HeroSection() {
   return (
-    <section className="container relative flex flex-col justify-center gap-8 xl:h-[calc(100vh-4rem)] xl:flex-row">
+    <section className="container relative mb-12 grid grid-cols-1 items-center justify-center gap-8 xl:h-[max(650px,min(800px,calc(75vh)))] xl:grid-cols-2 xl:flex-row">
       <aside className="my-16 flex flex-col items-center self-center xl:my-24 xl:-mr-10 xl:ml-10 xl:flex-1 xl:items-start">
         <h1 className="text-6xl md:text-8xl">
           <NuqsWordmark />
@@ -45,11 +45,11 @@ export function HeroSection() {
           </a>
         </nav>
       </aside>
-      <aside className="relative my-4 xl:my-8 xl:flex-1">
+      <aside className="relative my-4 xl:my-auto xl:flex-1 xl:pt-4">
         <LandingDemo />
       </aside>
       <div
-        className="absolute bottom-2 left-0 right-0 hidden h-12 items-center justify-center xl:flex"
+        className="absolute -bottom-12 left-0 right-0 hidden h-12 items-center justify-center xl:flex"
         aria-hidden
       >
         <ChevronDown />

packages/docs/src/app/(pages)/blog/[slug]/page.tsx

@@ -60,8 +60,8 @@ export default async function Page(props: {
 export async function generateMetadata(props: {
   params: Promise<{ slug: string }>
 }): Promise<Metadata> {
-  const params = await props.params
-  const page = blog.getPage([params.slug])
+  const { slug } = await props.params
+  const page = blog.getPage([slug])
 
   if (!page) notFound()
 
@@ -74,7 +74,7 @@ export async function generateMetadata(props: {
   }
 }
 
-export function generateStaticParams(): { slug: string }[] {
+export async function generateStaticParams(): Promise<{ slug: string }[]> {
   return blog.getPages().map(page => ({
     slug: page.slugs[0]
   }))

packages/docs/src/app/(pages)/layout.tsx

@@ -1,5 +1,5 @@
 import { getSharedLayoutProps } from '@/src/components/shared-layout'
-import { HomeLayout } from 'fumadocs-ui/home-layout'
+import { HomeLayout } from 'fumadocs-ui/layouts/home'
 
 export default function PageLayout({
   children