feat: support React Router v8 (react-router as peer dependency, drop react-router-dom)

.changeset/react-router-v8-support.md

@@ -0,0 +1,5 @@
+---
+"@lambdacurry/forms": minor
+---
+
+Support React Router v8. `react-router` is now a peer dependency (`^7.0.0 || ^8.0.0`) instead of a bundled dependency, so consumers always share a single router instance with the library, and the unused `react-router-dom` dependency/peer was dropped (that package no longer exists in React Router v8).

AGENTS.md

@@ -81,4 +81,4 @@ Quick checklist
 - Forms: Zod schemas, proper messages, `fetcher.Form`, show `FormMessage` errors.
 - Tests: per-story decorators, semantic queries, three-phase play tests; run `yarn test`.
 - Monorepo: no cross-package relative imports; verify `exports`, TS `paths`, Turbo outputs.
-- Consumer integration: For React Router v7 setup help, reference `docs/consumer-setup-guide.md` for Vite SSR configuration (ssr.noExternal, optimizeDeps).
+- Consumer integration: For React Router v7/v8 setup help, reference `docs/consumer-setup-guide.md` for Vite SSR configuration (ssr.noExternal, optimizeDeps).

README.md

@@ -66,9 +66,11 @@ const MyTable = () => {
 - Full accessibility support (WCAG 2.1 AA)
 - Comprehensive test coverage
 
-## React Router v7 Integration
+## React Router v7 / v8 Integration
 
-When using `@lambdacurry/forms` with `remix-hook-form` in a React Router v7 application, you need to configure Vite to bundle these packages together to share the router context. Without this, you may encounter the error:
+`react-router` (v7 or v8) and `remix-hook-form` are peer dependencies: install them in your application so every package shares the single router instance your app provides.
+
+When using `@lambdacurry/forms` with `remix-hook-form` in a React Router v7 or v8 application, you need to configure Vite to bundle these packages together to share the router context. Without this, you may encounter the error:
 
 ```
 Error: useHref() may be used only in the context of a <Router> component.

docs/consumer-setup-guide.md

@@ -1,10 +1,12 @@
 # Consumer Setup Guide
 
-This guide covers how to integrate `@lambdacurry/forms` with React Router v7 applications using remix-hook-form.
+This guide covers how to integrate `@lambdacurry/forms` with React Router v7 or v8 applications using remix-hook-form.
 
-## React Router v7 Vite Configuration
+`react-router` (`^7 || ^8`) and `remix-hook-form` are peer dependencies of `@lambdacurry/forms`; install them in your application. The package no longer references `react-router-dom`, which was removed in React Router v8.
 
-When using `@lambdacurry/forms` with `remix-hook-form` in a React Router v7 application, you must configure Vite to bundle these packages together. Without this configuration, forms that render conditionally (e.g., triggered by a button click) will fail with:
+## React Router Vite Configuration
+
+When using `@lambdacurry/forms` with `remix-hook-form` in a React Router v7 or v8 application, you must configure Vite to bundle these packages together. Without this configuration, forms that render conditionally (e.g., triggered by a button click) will fail with:
 
 ```
 Error: useHref() may be used only in the context of a <Router> component.

packages/components/package.json

@@ -42,8 +42,7 @@
   },
   "peerDependencies": {
     "react": "^19.0.0",
-    "react-router": "^7.0.0",
-    "react-router-dom": "^7.0.0",
+    "react-router": "^7.0.0 || ^8.0.0",
     "remix-hook-form": "7.1.0",
     "zod": "^3.24.1 || ^4.0.0"
   },
@@ -76,8 +75,6 @@
     "next-themes": "^0.4.4",
     "react-day-picker": "^9.7.0",
     "react-hook-form": "^7.53.1",
-    "react-router": "^7.6.3",
-    "react-router-dom": "^7.6.3",
     "remix-hook-form": "7.1.0",
     "sonner": "^1.7.1",
     "tailwind-merge": "^2.5.5",
@@ -94,6 +91,7 @@
     "autoprefixer": "^10.4.20",
     "glob": "^11.0.0",
     "react": "^19.0.0",
+    "react-router": "^7.6.3",
     "tailwindcss": "^4.0.0",
     "typescript": "^5.7.2",
     "vite": "^6.2.2",

packages/components/vite.config.ts

@@ -62,7 +62,6 @@ export default defineConfig({
         '@radix-ui/react-switch',
         '@radix-ui/react-tooltip',
         'react-router',
-        'react-router-dom',
         '@react-router/node',
         'class-variance-authority',
         'clsx',

yarn.lock

@@ -1754,7 +1754,6 @@ __metadata:
     react-day-picker: "npm:^9.7.0"
     react-hook-form: "npm:^7.53.1"
     react-router: "npm:^7.6.3"
-    react-router-dom: "npm:^7.6.3"
     remix-hook-form: "npm:7.1.0"
     sonner: "npm:^1.7.1"
     tailwind-merge: "npm:^2.5.5"
@@ -1767,8 +1766,7 @@ __metadata:
     zod: "npm:^3.24.1"
   peerDependencies:
     react: ^19.0.0
-    react-router: ^7.0.0
-    react-router-dom: ^7.0.0
+    react-router: ^7.0.0 || ^8.0.0
     remix-hook-form: 7.1.0
     zod: ^3.24.1 || ^4.0.0
   languageName: unknown
@@ -10410,7 +10408,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-router-dom@npm:^7.6.2, react-router-dom@npm:^7.6.3":
+"react-router-dom@npm:^7.6.2":
   version: 7.9.1
   resolution: "react-router-dom@npm:7.9.1"
   dependencies: