feat: SSR/Next Server Actions Support

.github/workflows/ci.yml

@@ -31,7 +31,7 @@ jobs:
           version: 8
       - uses: actions/setup-node@v3
         with:
-          node-version: 18.15.0
+          node-version: 18.19.0
           registry-url: https://registry.npmjs.org/
           cache: 'pnpm'
       - name: Install dependencies

.github/workflows/pr.yml

@@ -19,7 +19,7 @@ jobs:
           version: 8
       - uses: actions/setup-node@v3
         with:
-          node-version: 18.15.0
+          node-version: 18.19.0
           cache: 'pnpm'
       - name: Install dependencies
         run: pnpm --prefer-offline install --no-frozen-lockfile
@@ -45,7 +45,7 @@ jobs:
           version: 7
       - uses: actions/setup-node@v3
         with:
-          node-version: 16.14.2
+          node-version: 18.19.0
           cache: 'pnpm'
       - name: Install dependencies
         run: pnpm --prefer-offline install --no-frozen-lockfile
@@ -64,7 +64,7 @@ jobs:
           version: 7
       - uses: actions/setup-node@v3
         with:
-          node-version: 16.14.2
+          node-version: 18.19.0
           cache: 'pnpm'
       - name: Install dependencies
         run: pnpm --prefer-offline install --no-frozen-lockfile
@@ -83,7 +83,7 @@ jobs:
           version: 7
       - uses: actions/setup-node@v3
         with:
-          node-version: 16.14.2
+          node-version: 18.19.0
           cache: 'pnpm'
       - name: Install dependencies
         run: pnpm --prefer-offline install --no-frozen-lockfile
@@ -102,7 +102,7 @@ jobs:
           version: 7
       - uses: actions/setup-node@v3
         with:
-          node-version: 16.14.2
+          node-version: 18.19.0
           cache: 'pnpm'
       - name: Install dependencies
         run: pnpm --prefer-offline install --no-frozen-lockfile

.gitignore

@@ -45,3 +45,4 @@ dist
 .idea
 
 nx-cloud.env
+.nx

examples/react/next-server-actions/.eslintrc.js

@@ -0,0 +1,7 @@
+module.exports = {
+  extends: 'next/core-web-vitals',
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+    project: ['./tsconfig.json'],
+  },
+}

examples/react/next-server-actions/.gitignore

@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

examples/react/next-server-actions/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.

examples/react/next-server-actions/next.config.js

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {}
+
+module.exports = nextConfig

examples/react/next-server-actions/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@tanstack/form-example-react-next-server-actions",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "test:types": "tsc --noEmit",
+    "test:eslint": "next lint"
+  },
+  "dependencies": {
+    "react": "^18",
+    "react-dom": "^18",
+    "next": "14.0.4",
+    "@tanstack/react-form": "^0.11.0"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "^20",
+    "@types/react": "18.2.35",
+    "@types/react-dom": "^18.2.14",
+    "eslint": "^8",
+    "eslint-config-next": "14.0.4"
+  }
+}

examples/react/next-server-actions/src/app/action.ts

@@ -0,0 +1,7 @@
+'use server'
+
+import { formFactory } from './shared-code'
+
+export default async function someAction(prev: unknown, formData: FormData) {
+  return await formFactory.validateFormData(formData)
+}

examples/react/next-server-actions/src/app/client-component.tsx

@@ -0,0 +1,68 @@
+/// <reference types="../../node_modules/@types/react-dom/experimental" />
+'use client'
+
+import { useFormState } from 'react-dom'
+import someAction from './action'
+import { formFactory } from './shared-code'
+import { useTransform, mergeForm, type FormApi } from '@tanstack/react-form'
+
+export const ClientComp = () => {
+  const [state, action] = useFormState(someAction, formFactory.initialFormState)
+
+  const form = formFactory.useForm({
+    transform: useTransform(
+      (baseForm: FormApi<any, any>) => mergeForm(baseForm, state),
+      [state],
+    ),
+  })
+
+  const formErrors = form.useStore((formState) => formState.errors)
+
+  return (
+    <form.Provider>
+      <form action={action as never} onSubmit={() => form.handleSubmit()}>
+        {formErrors.map((error) => (
+          <p key={error as string}>{error}</p>
+        ))}
+
+        <form.Field
+          name="age"
+          validators={{
+            onChange: ({ value }) =>
+              value < 8
+                ? 'Client validation: You must be at least 8'
+                : undefined,
+          }}
+        >
+          {(field) => {
+            return (
+              <div>
+                <input
+                  name="age"
+                  type="number"
+                  value={field.state.value}
+                  onChange={(e) => field.handleChange(e.target.valueAsNumber)}
+                />
+                {field.state.meta.errors.map((error) => (
+                  <p key={error as string}>{error}</p>
+                ))}
+              </div>
+            )
+          }}
+        </form.Field>
+        <form.Subscribe
+          selector={(formState) => [
+            formState.canSubmit,
+            formState.isSubmitting,
+          ]}
+        >
+          {([canSubmit, isSubmitting]) => (
+            <button type="submit" disabled={!canSubmit}>
+              {isSubmitting ? '...' : 'Submit'}
+            </button>
+          )}
+        </form.Subscribe>
+      </form>
+    </form.Provider>
+  )
+}

examples/react/next-server-actions/src/app/layout.tsx

@@ -0,0 +1,18 @@
+import type { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Create Next App',
+  description: 'Generated by create next app',
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}

examples/react/next-server-actions/src/app/page.tsx

@@ -0,0 +1,9 @@
+import { ClientComp } from './client-component'
+
+export default function Home() {
+  return (
+    <>
+      <ClientComp />
+    </>
+  )
+}

examples/react/next-server-actions/src/app/shared-code.ts

@@ -0,0 +1,13 @@
+import { createFormFactory } from '@tanstack/react-form'
+
+export const formFactory = createFormFactory({
+  defaultValues: {
+    firstName: '',
+    age: 0,
+  },
+  onServerValidate({ value }) {
+    if (value.age < 12) {
+      return 'Server validation: You must be at least 12 to sign up'
+    }
+  },
+})

examples/react/next-server-actions/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

examples/react/simple/tsconfig.json

@@ -3,6 +3,7 @@
     "jsx": "react",
     "noEmit": true,
     "strict": true,
+    "esModuleInterop": true,
     "lib": ["DOM", "DOM.Iterable", "ES2020"]
   }
 }

examples/react/valibot/tsconfig.json

@@ -3,6 +3,7 @@
     "jsx": "react",
     "noEmit": true,
     "strict": true,
+    "esModuleInterop": true,
     "lib": ["DOM", "DOM.Iterable", "ES2020"]
   }
 }

examples/react/yup/tsconfig.json

@@ -3,6 +3,7 @@
     "jsx": "react",
     "noEmit": true,
     "strict": true,
+    "esModuleInterop": true,
     "lib": ["DOM", "DOM.Iterable", "ES2020"]
   }
 }

examples/react/zod/tsconfig.json

@@ -3,6 +3,7 @@
     "jsx": "react",
     "noEmit": true,
     "strict": true,
+    "esModuleInterop": true,
     "lib": ["DOM", "DOM.Iterable", "ES2020"]
   }
 }