[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6NTT0B679FZ0MJ2T6KDMGSD":3,"skill-same:01M6NTT0B679FZ0MJ2T6KDMGSD":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":14,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":51,"ownerDescription":52,"updatedAt":53,"install":54,"resources":67},"01M6NTT0B679FZ0MJ2T6KDMGSD","form-validation",null,"React Hook Form + Zod integration, multi-step forms, optimistic validation, server-side error mapping, and file upload patterns.","rubicanjr\u002FFinCognis","rubicanjr","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F234912519?v=4","01M6NT156NND8J474G34SB3923","Rubi","01M6NT15B70RWXE1N3YV0BZY8A",0,"MIT","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fform-validation\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"validation","form validation","form","integration","server","zod","patterns","forms","upload","server-side","mapping","file","error","multi","hook","react hook form","react","2026-11-10 10:12:30",false,"---\nname: form-validation\ndescription: React Hook Form + Zod integration, multi-step forms, optimistic validation, server-side error mapping, and file upload patterns.\n---\n\n# Form Validation\n\nReact Hook Form + Zod patterns for robust, accessible forms.\n\n## React Hook Form + Zod Setup\n\n```typescript\n\u002F\u002F Install: npm install react-hook-form zod @hookform\u002Fresolvers\n\nimport { useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform\u002Fresolvers\u002Fzod'\nimport { z } from 'zod'\n\n\u002F\u002F 1. Define schema\nconst TaskSchema = z.object({\n  title:       z.string().min(1, 'Title is required').max(200),\n  description: z.string().max(2000).optional(),\n  priority:    z.enum(['low', 'medium', 'high']),\n  dueDate:     z.string().date('Invalid date').optional(),\n})\n\ntype TaskFormData = z.infer\u003Ctypeof TaskSchema>\n\n\u002F\u002F 2. Use in component\nexport function TaskForm({ onSubmit }: { onSubmit: (data: TaskFormData) => Promise\u003Cvoid> }) {\n  const {\n    register,\n    handleSubmit,\n    formState: { errors, isSubmitting, isDirty },\n    setError,\n    reset,\n  } = useForm\u003CTaskFormData>({\n    resolver: zodResolver(TaskSchema),\n    defaultValues: { priority: 'medium' },\n  })\n\n  const submit = handleSubmit(async (data) => {\n    try {\n      await onSubmit(data)\n      reset()\n    } catch (err) {\n      \u002F\u002F Map server errors to fields (see Server-Side Error Mapping)\n      setError('title', { message: 'A task with this title already exists' })\n    }\n  })\n\n  return (\n    \u003Cform onSubmit={submit} noValidate>\n      \u003Cdiv>\n        \u003Clabel htmlFor=\"title\">Title *\u003C\u002Flabel>\n        \u003Cinput\n          id=\"title\"\n          {...register('title')}\n          aria-invalid={!!errors.title}\n          aria-describedby={errors.title ? 'title-error' : undefined}\n        \u002F>\n        {errors.title && (\n          \u003Cp id=\"title-error\" role=\"alert\" className=\"text-red-600 text-sm\">\n            {errors.title.message}\n          \u003C\u002Fp>\n        )}\n      \u003C\u002Fdiv>\n\n      \u003Cbutton type=\"submit\" disabled={isSubmitting || !isDirty}>\n        {isSubmitting ? 'Saving...' : 'Save Task'}\n      \u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Form Schema Definition with Zod\n\n```typescript\nimport { z } from 'zod'\n\n\u002F\u002F Common field patterns\nconst emailField = z.string().email('Invalid email address').toLowerCase()\nconst passwordField = z.string()\n  .min(8, 'At least 8 characters')\n  .regex(\u002F[A-Z]\u002F, 'Must contain uppercase letter')\n  .regex(\u002F[0-9]\u002F, 'Must contain a number')\n\nconst urlField = z.string().url('Must be a valid URL').optional().or(z.literal(''))\n\nconst phoneField = z.string()\n  .regex(\u002F^\\+?[1-9]\\d{1,14}$\u002F, 'Invalid phone number')\n  .optional()\n\n\u002F\u002F Cross-field validation (refine)\nconst PasswordChangeSchema = z\n  .object({\n    password:        passwordField,\n    confirmPassword: z.string(),\n  })\n  .refine(data => data.password === data.confirmPassword, {\n    message: 'Passwords do not match',\n    path: ['confirmPassword'],   \u002F\u002F error attached to confirmPassword field\n  })\n\n\u002F\u002F Conditional fields (superRefine)\nconst EventSchema = z\n  .object({\n    type:      z.enum(['online', 'in-person']),\n    url:       z.string().url().optional(),\n    address:   z.string().optional(),\n  })\n  .superRefine((data, ctx) => {\n    if (data.type === 'online' && !data.url) {\n      ctx.addIssue({ code: 'custom', message: 'URL required for online events', path: ['url'] })\n    }\n    if (data.type === 'in-person' && !data.address) {\n      ctx.addIssue({ code: 'custom', message: 'Address required', path: ['address'] })\n    }\n  })\n```\n\n## Multi-Step Form State Management\n\n```typescript\nimport { useState } from 'react'\nimport { useForm, FormProvider } from 'react-hook-form'\nimport { zodResolver } from '@hookform\u002Fresolvers\u002Fzod'\n\nconst steps = ['Personal', 'Details', 'Review'] as const\ntype Step = (typeof steps)[number]\n\n\u002F\u002F Each step has its own schema\nconst Step1Schema = z.object({ name: z.string().min(1), email: emailField })\nconst Step2Schema = z.object({ company: z.string().min(1), role: z.string().min(1) })\nconst FullSchema = Step1Schema.merge(Step2Schema)\n\ntype FormData = z.infer\u003Ctypeof FullSchema>\n\nexport function MultiStepForm() {\n  const [currentStep, setCurrentStep] = useState(0)\n\n  const methods = useForm\u003CFormData>({\n    resolver: zodResolver(FullSchema),\n    mode: 'onTouched',\n  })\n\n  const stepSchemas = [Step1Schema, Step2Schema]\n\n  const next = async () => {\n    \u002F\u002F Validate only current step's fields\n    const fieldsToValidate = Object.keys(stepSchemas[currentStep].shape) as (keyof FormData)[]\n    const valid = await methods.trigger(fieldsToValidate)\n    if (valid) setCurrentStep(s => s + 1)\n  }\n\n  const submit = methods.handleSubmit(async (data) => {\n    await createUser(data)\n  })\n\n  return (\n    \u003CFormProvider {...methods}>\n      {\u002F* Progress indicator *\u002F}\n      \u003Cnav aria-label=\"Form steps\">\n        {steps.map((step, i) => (\n          \u003Cspan key={step} aria-current={i === currentStep ? 'step' : undefined}>\n            {step}\n          \u003C\u002Fspan>\n        ))}\n      \u003C\u002Fnav>\n\n      \u003Cform onSubmit={submit}>\n        {currentStep === 0 && \u003CStep1Fields \u002F>}\n        {currentStep === 1 && \u003CStep2Fields \u002F>}\n        {currentStep === 2 && \u003CReviewStep \u002F>}\n\n        \u003Cdiv className=\"flex gap-2\">\n          {currentStep > 0 && (\n            \u003Cbutton type=\"button\" onClick={() => setCurrentStep(s => s - 1)}>Back\u003C\u002Fbutton>\n          )}\n          {currentStep \u003C steps.length - 1 ? (\n            \u003Cbutton type=\"button\" onClick={next}>Next\u003C\u002Fbutton>\n          ) : (\n            \u003Cbutton type=\"submit\">Submit\u003C\u002Fbutton>\n          )}\n        \u003C\u002Fdiv>\n      \u003C\u002Fform>\n    \u003C\u002FFormProvider>\n  )\n}\n```\n\n## Server-Side Validation Error Mapping\n\n```typescript\nimport { useForm } from 'react-hook-form'\n\n\u002F\u002F API returns: { errors: { field: string[] } }\ninterface ApiError {\n  errors?: Record\u003Cstring, string[]>\n  message?: string\n}\n\nexport function RegistrationForm() {\n  const { register, handleSubmit, setError, formState: { errors } } = useForm\u003CFormData>()\n\n  const submit = handleSubmit(async (data) => {\n    try {\n      await registerUser(data)\n    } catch (err) {\n      const apiError = err as ApiError\n\n      if (apiError.errors) {\n        \u002F\u002F Map each server field error to react-hook-form\n        Object.entries(apiError.errors).forEach(([field, messages]) => {\n          setError(field as keyof FormData, {\n            type: 'server',\n            message: messages[0],\n          })\n        })\n      } else {\n        \u002F\u002F Non-field error — show at form root\n        setError('root', { message: apiError.message ?? 'Registration failed' })\n      }\n    }\n  })\n\n  return (\n    \u003Cform onSubmit={submit}>\n      {errors.root && \u003Cdiv role=\"alert\" className=\"text-red-600\">{errors.root.message}\u003C\u002Fdiv>}\n      {\u002F* fields *\u002F}\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Optimistic Validation (Real-time Feedback)\n\n```typescript\nimport { useForm } from 'react-hook-form'\nimport { useCallback } from 'react'\nimport { useDebouncedCallback } from 'use-debounce'\n\nexport function UsernameField() {\n  const { register, setError, clearErrors, formState: { errors } } = useForm()\n\n  const checkUsername = useDebouncedCallback(async (username: string) => {\n    if (username.length \u003C 3) return\n    try {\n      const available = await fetch(`\u002Fapi\u002Fcheck-username?u=${username}`)\n        .then(r => r.json())\n        .then(d => d.available)\n\n      if (!available) {\n        setError('username', { message: `\"${username}\" is already taken` })\n      } else {\n        clearErrors('username')\n      }\n    } catch {\n      \u002F\u002F network error — don't block the form\n    }\n  }, 400)\n\n  return (\n    \u003Cdiv>\n      \u003Cinput\n        {...register('username', { onChange: (e) => checkUsername(e.target.value) })}\n        aria-invalid={!!errors.username}\n      \u002F>\n      {errors.username && \u003Cp role=\"alert\">{errors.username.message}\u003C\u002Fp>}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## File Upload with Preview\n\n```typescript\nimport { useForm, Controller } from 'react-hook-form'\nimport { useState, useCallback } from 'react'\n\nconst UploadSchema = z.object({\n  avatar: z\n    .instanceof(File)\n    .refine(f => f.size \u003C 5 * 1024 * 1024, 'Max 5 MB')\n    .refine(f => ['image\u002Fjpeg', 'image\u002Fpng', 'image\u002Fwebp'].includes(f.type), 'JPEG, PNG or WebP only'),\n})\n\nexport function AvatarUpload() {\n  const { control, handleSubmit } = useForm\u003Cz.infer\u003Ctypeof UploadSchema>>({\n    resolver: zodResolver(UploadSchema),\n  })\n  const [preview, setPreview] = useState\u003Cstring | null>(null)\n\n  return (\n    \u003Cform onSubmit={handleSubmit(async ({ avatar }) => {\n      const fd = new FormData()\n      fd.append('avatar', avatar)\n      await fetch('\u002Fapi\u002Favatar', { method: 'POST', body: fd })\n    })}>\n      \u003CController\n        name=\"avatar\"\n        control={control}\n        render={({ field, fieldState }) => (\n          \u003Cdiv>\n            \u003Cinput\n              type=\"file\"\n              accept=\"image\u002Fjpeg,image\u002Fpng,image\u002Fwebp\"\n              onChange={e => {\n                const file = e.target.files?.[0]\n                if (!file) return\n                field.onChange(file)\n                setPreview(URL.createObjectURL(file))\n              }}\n            \u002F>\n            {preview && \u003Cimg src={preview} alt=\"Avatar preview\" className=\"size-24 rounded-full object-cover\" \u002F>}\n            {fieldState.error && \u003Cp role=\"alert\">{fieldState.error.message}\u003C\u002Fp>}\n          \u003C\u002Fdiv>\n        )}\n      \u002F>\n      \u003Cbutton type=\"submit\">Upload\u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Dynamic Form Fields (Arrays, Conditional)\n\n```typescript\nimport { useForm, useFieldArray, useWatch } from 'react-hook-form'\n\nconst LinksSchema = z.object({\n  links: z.array(z.object({\n    url:   z.string().url('Invalid URL'),\n    label: z.string().min(1),\n  })).min(1),\n  hasExpiry: z.boolean(),\n  expiryDate: z.string().optional(),\n}).superRefine((data, ctx) => {\n  if (data.hasExpiry && !data.expiryDate) {\n    ctx.addIssue({ code: 'custom', message: 'Expiry date required', path: ['expiryDate'] })\n  }\n})\n\nexport function LinksForm() {\n  const { register, control, handleSubmit, formState: { errors } } = useForm({\n    resolver: zodResolver(LinksSchema),\n    defaultValues: { links: [{ url: '', label: '' }], hasExpiry: false },\n  })\n\n  const { fields, append, remove } = useFieldArray({ control, name: 'links' })\n  const hasExpiry = useWatch({ control, name: 'hasExpiry' })\n\n  return (\n    \u003Cform onSubmit={handleSubmit(console.log)}>\n      {fields.map((field, i) => (\n        \u003Cdiv key={field.id} className=\"flex gap-2\">\n          \u003Cinput {...register(`links.${i}.url`)} placeholder=\"https:\u002F\u002F...\" \u002F>\n          \u003Cinput {...register(`links.${i}.label`)} placeholder=\"Label\" \u002F>\n          \u003Cbutton type=\"button\" onClick={() => remove(i)} disabled={fields.length === 1}>\n            Remove\n          \u003C\u002Fbutton>\n          {errors.links?.[i]?.url && \u003Cp>{errors.links[i].url.message}\u003C\u002Fp>}\n        \u003C\u002Fdiv>\n      ))}\n      \u003Cbutton type=\"button\" onClick={() => append({ url: '', label: '' })}>Add Link\u003C\u002Fbutton>\n\n      {\u002F* Conditional field *\u002F}\n      \u003Clabel>\n        \u003Cinput type=\"checkbox\" {...register('hasExpiry')} \u002F> Set expiry date\n      \u003C\u002Flabel>\n      {hasExpiry && \u003Cinput type=\"date\" {...register('expiryDate')} \u002F>}\n\n      \u003Cbutton type=\"submit\">Save\u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Form Submission States\n\n```typescript\ntype FormStatus = 'idle' | 'submitting' | 'success' | 'error'\n\nexport function ContactForm() {\n  const [status, setStatus] = useState\u003CFormStatus>('idle')\n  const { register, handleSubmit, reset } = useForm()\n\n  const submit = handleSubmit(async (data) => {\n    setStatus('submitting')\n    try {\n      await sendMessage(data)\n      setStatus('success')\n      reset()\n      setTimeout(() => setStatus('idle'), 3000)\n    } catch {\n      setStatus('error')\n    }\n  })\n\n  return (\n    \u003Cform onSubmit={submit}>\n      {\u002F* fields *\u002F}\n      {status === 'success' && (\n        \u003Cdiv role=\"status\" className=\"text-green-600\">Message sent!\u003C\u002Fdiv>\n      )}\n      {status === 'error' && (\n        \u003Cdiv role=\"alert\" className=\"text-red-600\">Failed to send. Try again.\u003C\u002Fdiv>\n      )}\n      \u003Cbutton type=\"submit\" disabled={status === 'submitting'}>\n        {status === 'submitting' ? 'Sending...' : 'Send'}\n      \u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n","# Form Validation\n\nReact Hook Form + Zod patterns for robust, accessible forms.\n\n## React Hook Form + Zod Setup\n\n```typescript\n\u002F\u002F Install: npm install react-hook-form zod @hookform\u002Fresolvers\n\nimport { useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform\u002Fresolvers\u002Fzod'\nimport { z } from 'zod'\n\n\u002F\u002F 1. Define schema\nconst TaskSchema = z.object({\n  title:       z.string().min(1, 'Title is required').max(200),\n  description: z.string().max(2000).optional(),\n  priority:    z.enum(['low', 'medium', 'high']),\n  dueDate:     z.string().date('Invalid date').optional(),\n})\n\ntype TaskFormData = z.infer\u003Ctypeof TaskSchema>\n\n\u002F\u002F 2. Use in component\nexport function TaskForm({ onSubmit }: { onSubmit: (data: TaskFormData) => Promise\u003Cvoid> }) {\n  const {\n    register,\n    handleSubmit,\n    formState: { errors, isSubmitting, isDirty },\n    setError,\n    reset,\n  } = useForm\u003CTaskFormData>({\n    resolver: zodResolver(TaskSchema),\n    defaultValues: { priority: 'medium' },\n  })\n\n  const submit = handleSubmit(async (data) => {\n    try {\n      await onSubmit(data)\n      reset()\n    } catch (err) {\n      \u002F\u002F Map server errors to fields (see Server-Side Error Mapping)\n      setError('title', { message: 'A task with this title already exists' })\n    }\n  })\n\n  return (\n    \u003Cform onSubmit={submit} noValidate>\n      \u003Cdiv>\n        \u003Clabel htmlFor=\"title\">Title *\u003C\u002Flabel>\n        \u003Cinput\n          id=\"title\"\n          {...register('title')}\n          aria-invalid={!!errors.title}\n          aria-describedby={errors.title ? 'title-error' : undefined}\n        \u002F>\n        {errors.title && (\n          \u003Cp id=\"title-error\" role=\"alert\" className=\"text-red-600 text-sm\">\n            {errors.title.message}\n          \u003C\u002Fp>\n        )}\n      \u003C\u002Fdiv>\n\n      \u003Cbutton type=\"submit\" disabled={isSubmitting || !isDirty}>\n        {isSubmitting ? 'Saving...' : 'Save Task'}\n      \u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Form Schema Definition with Zod\n\n```typescript\nimport { z } from 'zod'\n\n\u002F\u002F Common field patterns\nconst emailField = z.string().email('Invalid email address').toLowerCase()\nconst passwordField = z.string()\n  .min(8, 'At least 8 characters')\n  .regex(\u002F[A-Z]\u002F, 'Must contain uppercase letter')\n  .regex(\u002F[0-9]\u002F, 'Must contain a number')\n\nconst urlField = z.string().url('Must be a valid URL').optional().or(z.literal(''))\n\nconst phoneField = z.string()\n  .regex(\u002F^\\+?[1-9]\\d{1,14}$\u002F, 'Invalid phone number')\n  .optional()\n\n\u002F\u002F Cross-field validation (refine)\nconst PasswordChangeSchema = z\n  .object({\n    password:        passwordField,\n    confirmPassword: z.string(),\n  })\n  .refine(data => data.password === data.confirmPassword, {\n    message: 'Passwords do not match',\n    path: ['confirmPassword'],   \u002F\u002F error attached to confirmPassword field\n  })\n\n\u002F\u002F Conditional fields (superRefine)\nconst EventSchema = z\n  .object({\n    type:      z.enum(['online', 'in-person']),\n    url:       z.string().url().optional(),\n    address:   z.string().optional(),\n  })\n  .superRefine((data, ctx) => {\n    if (data.type === 'online' && !data.url) {\n      ctx.addIssue({ code: 'custom', message: 'URL required for online events', path: ['url'] })\n    }\n    if (data.type === 'in-person' && !data.address) {\n      ctx.addIssue({ code: 'custom', message: 'Address required', path: ['address'] })\n    }\n  })\n```\n\n## Multi-Step Form State Management\n\n```typescript\nimport { useState } from 'react'\nimport { useForm, FormProvider } from 'react-hook-form'\nimport { zodResolver } from '@hookform\u002Fresolvers\u002Fzod'\n\nconst steps = ['Personal', 'Details', 'Review'] as const\ntype Step = (typeof steps)[number]\n\n\u002F\u002F Each step has its own schema\nconst Step1Schema = z.object({ name: z.string().min(1), email: emailField })\nconst Step2Schema = z.object({ company: z.string().min(1), role: z.string().min(1) })\nconst FullSchema = Step1Schema.merge(Step2Schema)\n\ntype FormData = z.infer\u003Ctypeof FullSchema>\n\nexport function MultiStepForm() {\n  const [currentStep, setCurrentStep] = useState(0)\n\n  const methods = useForm\u003CFormData>({\n    resolver: zodResolver(FullSchema),\n    mode: 'onTouched',\n  })\n\n  const stepSchemas = [Step1Schema, Step2Schema]\n\n  const next = async () => {\n    \u002F\u002F Validate only current step's fields\n    const fieldsToValidate = Object.keys(stepSchemas[currentStep].shape) as (keyof FormData)[]\n    const valid = await methods.trigger(fieldsToValidate)\n    if (valid) setCurrentStep(s => s + 1)\n  }\n\n  const submit = methods.handleSubmit(async (data) => {\n    await createUser(data)\n  })\n\n  return (\n    \u003CFormProvider {...methods}>\n      {\u002F* Progress indicator *\u002F}\n      \u003Cnav aria-label=\"Form steps\">\n        {steps.map((step, i) => (\n          \u003Cspan key={step} aria-current={i === currentStep ? 'step' : undefined}>\n            {step}\n          \u003C\u002Fspan>\n        ))}\n      \u003C\u002Fnav>\n\n      \u003Cform onSubmit={submit}>\n        {currentStep === 0 && \u003CStep1Fields \u002F>}\n        {currentStep === 1 && \u003CStep2Fields \u002F>}\n        {currentStep === 2 && \u003CReviewStep \u002F>}\n\n        \u003Cdiv className=\"flex gap-2\">\n          {currentStep > 0 && (\n            \u003Cbutton type=\"button\" onClick={() => setCurrentStep(s => s - 1)}>Back\u003C\u002Fbutton>\n          )}\n          {currentStep \u003C steps.length - 1 ? (\n            \u003Cbutton type=\"button\" onClick={next}>Next\u003C\u002Fbutton>\n          ) : (\n            \u003Cbutton type=\"submit\">Submit\u003C\u002Fbutton>\n          )}\n        \u003C\u002Fdiv>\n      \u003C\u002Fform>\n    \u003C\u002FFormProvider>\n  )\n}\n```\n\n## Server-Side Validation Error Mapping\n\n```typescript\nimport { useForm } from 'react-hook-form'\n\n\u002F\u002F API returns: { errors: { field: string[] } }\ninterface ApiError {\n  errors?: Record\u003Cstring, string[]>\n  message?: string\n}\n\nexport function RegistrationForm() {\n  const { register, handleSubmit, setError, formState: { errors } } = useForm\u003CFormData>()\n\n  const submit = handleSubmit(async (data) => {\n    try {\n      await registerUser(data)\n    } catch (err) {\n      const apiError = err as ApiError\n\n      if (apiError.errors) {\n        \u002F\u002F Map each server field error to react-hook-form\n        Object.entries(apiError.errors).forEach(([field, messages]) => {\n          setError(field as keyof FormData, {\n            type: 'server',\n            message: messages[0],\n          })\n        })\n      } else {\n        \u002F\u002F Non-field error — show at form root\n        setError('root', { message: apiError.message ?? 'Registration failed' })\n      }\n    }\n  })\n\n  return (\n    \u003Cform onSubmit={submit}>\n      {errors.root && \u003Cdiv role=\"alert\" className=\"text-red-600\">{errors.root.message}\u003C\u002Fdiv>}\n      {\u002F* fields *\u002F}\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Optimistic Validation (Real-time Feedback)\n\n```typescript\nimport { useForm } from 'react-hook-form'\nimport { useCallback } from 'react'\nimport { useDebouncedCallback } from 'use-debounce'\n\nexport function UsernameField() {\n  const { register, setError, clearErrors, formState: { errors } } = useForm()\n\n  const checkUsername = useDebouncedCallback(async (username: string) => {\n    if (username.length \u003C 3) return\n    try {\n      const available = await fetch(`\u002Fapi\u002Fcheck-username?u=${username}`)\n        .then(r => r.json())\n        .then(d => d.available)\n\n      if (!available) {\n        setError('username', { message: `\"${username}\" is already taken` })\n      } else {\n        clearErrors('username')\n      }\n    } catch {\n      \u002F\u002F network error — don't block the form\n    }\n  }, 400)\n\n  return (\n    \u003Cdiv>\n      \u003Cinput\n        {...register('username', { onChange: (e) => checkUsername(e.target.value) })}\n        aria-invalid={!!errors.username}\n      \u002F>\n      {errors.username && \u003Cp role=\"alert\">{errors.username.message}\u003C\u002Fp>}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## File Upload with Preview\n\n```typescript\nimport { useForm, Controller } from 'react-hook-form'\nimport { useState, useCallback } from 'react'\n\nconst UploadSchema = z.object({\n  avatar: z\n    .instanceof(File)\n    .refine(f => f.size \u003C 5 * 1024 * 1024, 'Max 5 MB')\n    .refine(f => ['image\u002Fjpeg', 'image\u002Fpng', 'image\u002Fwebp'].includes(f.type), 'JPEG, PNG or WebP only'),\n})\n\nexport function AvatarUpload() {\n  const { control, handleSubmit } = useForm\u003Cz.infer\u003Ctypeof UploadSchema>>({\n    resolver: zodResolver(UploadSchema),\n  })\n  const [preview, setPreview] = useState\u003Cstring | null>(null)\n\n  return (\n    \u003Cform onSubmit={handleSubmit(async ({ avatar }) => {\n      const fd = new FormData()\n      fd.append('avatar', avatar)\n      await fetch('\u002Fapi\u002Favatar', { method: 'POST', body: fd })\n    })}>\n      \u003CController\n        name=\"avatar\"\n        control={control}\n        render={({ field, fieldState }) => (\n          \u003Cdiv>\n            \u003Cinput\n              type=\"file\"\n              accept=\"image\u002Fjpeg,image\u002Fpng,image\u002Fwebp\"\n              onChange={e => {\n                const file = e.target.files?.[0]\n                if (!file) return\n                field.onChange(file)\n                setPreview(URL.createObjectURL(file))\n              }}\n            \u002F>\n            {preview && \u003Cimg src={preview} alt=\"Avatar preview\" className=\"size-24 rounded-full object-cover\" \u002F>}\n            {fieldState.error && \u003Cp role=\"alert\">{fieldState.error.message}\u003C\u002Fp>}\n          \u003C\u002Fdiv>\n        )}\n      \u002F>\n      \u003Cbutton type=\"submit\">Upload\u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Dynamic Form Fields (Arrays, Conditional)\n\n```typescript\nimport { useForm, useFieldArray, useWatch } from 'react-hook-form'\n\nconst LinksSchema = z.object({\n  links: z.array(z.object({\n    url:   z.string().url('Invalid URL'),\n    label: z.string().min(1),\n  })).min(1),\n  hasExpiry: z.boolean(),\n  expiryDate: z.string().optional(),\n}).superRefine((data, ctx) => {\n  if (data.hasExpiry && !data.expiryDate) {\n    ctx.addIssue({ code: 'custom', message: 'Expiry date required', path: ['expiryDate'] })\n  }\n})\n\nexport function LinksForm() {\n  const { register, control, handleSubmit, formState: { errors } } = useForm({\n    resolver: zodResolver(LinksSchema),\n    defaultValues: { links: [{ url: '', label: '' }], hasExpiry: false },\n  })\n\n  const { fields, append, remove } = useFieldArray({ control, name: 'links' })\n  const hasExpiry = useWatch({ control, name: 'hasExpiry' })\n\n  return (\n    \u003Cform onSubmit={handleSubmit(console.log)}>\n      {fields.map((field, i) => (\n        \u003Cdiv key={field.id} className=\"flex gap-2\">\n          \u003Cinput {...register(`links.${i}.url`)} placeholder=\"https:\u002F\u002F...\" \u002F>\n          \u003Cinput {...register(`links.${i}.label`)} placeholder=\"Label\" \u002F>\n          \u003Cbutton type=\"button\" onClick={() => remove(i)} disabled={fields.length === 1}>\n            Remove\n          \u003C\u002Fbutton>\n          {errors.links?.[i]?.url && \u003Cp>{errors.links[i].url.message}\u003C\u002Fp>}\n        \u003C\u002Fdiv>\n      ))}\n      \u003Cbutton type=\"button\" onClick={() => append({ url: '', label: '' })}>Add Link\u003C\u002Fbutton>\n\n      {\u002F* Conditional field *\u002F}\n      \u003Clabel>\n        \u003Cinput type=\"checkbox\" {...register('hasExpiry')} \u002F> Set expiry date\n      \u003C\u002Flabel>\n      {hasExpiry && \u003Cinput type=\"date\" {...register('expiryDate')} \u002F>}\n\n      \u003Cbutton type=\"submit\">Save\u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Form Submission States\n\n```typescript\ntype FormStatus = 'idle' | 'submitting' | 'success' | 'error'\n\nexport function ContactForm() {\n  const [status, setStatus] = useState\u003CFormStatus>('idle')\n  const { register, handleSubmit, reset } = useForm()\n\n  const submit = handleSubmit(async (data) => {\n    setStatus('submitting')\n    try {\n      await sendMessage(data)\n      setStatus('success')\n      reset()\n      setTimeout(() => setStatus('idle'), 3000)\n    } catch {\n      setStatus('error')\n    }\n  })\n\n  return (\n    \u003Cform onSubmit={submit}>\n      {\u002F* fields *\u002F}\n      {status === 'success' && (\n        \u003Cdiv role=\"status\" className=\"text-green-600\">Message sent!\u003C\u002Fdiv>\n      )}\n      {status === 'error' && (\n        \u003Cdiv role=\"alert\" className=\"text-red-600\">Failed to send. Try again.\u003C\u002Fdiv>\n      )}\n      \u003Cbutton type=\"submit\" disabled={status === 'submitting'}>\n        {status === 'submitting' ? 'Sending...' : 'Send'}\n      \u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n",{"name":5,"description":7},"main","70e1c350500ee750987420bbae48837afa906b7e","skills\u002Fform-validation","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis","https:\u002F\u002Fgithub.com\u002Frubicanjr","linktr.ee\u002Ffinanskodu","Industrial Engineer & CIO @FinansKodu. Architecting AI-driven financial agents and autonomous workflows. 🏗️ Building systems, not just prompts.","2026-06-09 13:50:15",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add rubicanjr\u002FFinCognis --skill form-validation",{"tool":60,"command":61},"bunx","bunx skills add rubicanjr\u002FFinCognis --skill form-validation",{"tool":63,"command":64},"pnpm","pnpm dlx skills add rubicanjr\u002FFinCognis --skill form-validation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fform-validation\u002FSKILL.md",true,[],[69,88,97,116,144,163],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":78,"publishedAt":41},"01M6NWS9DAXJTADT4T5MB49X8W","workflow-router","Goal-based workflow orchestration - routes tasks to specialist agents based on user goals","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow-router\u002FSKILL.md",[75],{"categoryNo":76,"categoryName":77,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[79,80,81,82,83,84,85,86,87],"workflow router","workflow","router","orchestration","goals","goal","user","workflow orchestration","tasks",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":41},"01M6NWS3RETSC0SHP16HP66E14","wiring","Wiring Verification","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwiring\u002FSKILL.md",[],[90,95,96],"verification","false",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":106,"publishedAt":41},"01M6NWS0XW9CVQZBDA1EGW0TWC","websocket-patterns","Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwebsocket-patterns\u002Fskill.md",[103],{"categoryNo":104,"categoryName":105,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",[107,30,108,109,110,111,112,113,114,115],"websocket","websocket patterns","design","protocol","management","message","strategies","binary","connection",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":124,"publishedAt":41},"01M6NWRDQDX9ZNETAWRRMQWV52","visual-verdict","Screenshot comparison QA for frontend development. Takes a screenshot of the current implementation, scores it across multiple visual dimensions, and returns a structured PASS\u002FREVISE\u002FFAIL verdict with concrete fixes. Use when implementing UI from a design reference or verifying visual correctness.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvisual-verdict\u002FSKILL.md",[122,123],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":76,"categoryName":77,"taxonomyType":21,"taxonomyTypeDesc":22},[125,126,127,128,129,130,131,132,133,134,135,136,137,109,138,139,140,141,142,143],"visual","verdict","visual verdict","ui","across","revise","comparison","correctness","implementing","for","fixes","dimensions","frontend","development","qa","screenshot","returns","use","frontend development",{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":148,"categories":149,"keywords":150,"publishedAt":41},"01M6NWR8HSNRS7MNDK2J02QYMN","verification-loop","Comprehensive verification system covering build, types, lint, tests, security, and diff review before a PR.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[151,152,95,153,154,155,156,157,158,159,160,161,162],"verification loop","loop","lint","review","security","pr","system","diff","build","tests","diff review","types",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":41},"01M6NWR4HHSFR0VR5EXFRWA747","vector-db-patterns","Embedding strategies, ANN algorithms, hybrid search, RAG chunking strategies, and reranking for semantic search and retrieval.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvector-db-patterns\u002Fskill.md",[],[170,171,172,173,30,174,175,176,177,113,178,179,180,181,182,134,183,184],"vector db patterns","vector db","db","vector","semantic search","search","embedding strategies","algorithms","chunking","semantic","retrieval","embedding","Hybrid Search","hybrid","rag"]