Skip to main content

Function: wrapWithSchemaLite()

wrapWithSchemaLite<TData>(schemaLite, setError, onSubmit): (data) => void | Promise<void>

Defined in: packages/react/src/SchemaLiteSubmit.ts:46

Wraps a form onSubmit handler with schemaLite client-side validation.

Runs schemaLite.safeParse(normalizeFormValues(data)) before calling the original handler. On failure, maps each validation issue to the corresponding RHF field via setError. On success, delegates to onSubmit unchanged.

Used by optimization-level codegen output to perform fast per-field validation with a trimmed schema that omits cross-field refinements.

Type Parameters​

TData​

TData extends Record<string, unknown>

Parameters​

schemaLite​

$ZodType

The stripped Zod schema produced by walkSchema at optimization level 1+.

setError​

UseFormSetError<TData>

RHF's setError function from useFormContext.

onSubmit​

(data) => void | Promise<void>

The original submit handler to call on successful validation.

Returns​

A wrapped submit handler with the same signature as onSubmit.

(data) => void | Promise<void>

Use When​

  • You are using a codegen output with validationLevel: 1 or higher (schema-lite mode)
  • You need to map server validation errors back to form fields via RHF's setError

Avoid When​

  • You are using the default zodResolver path (no validationLevel) — validation is handled by RHF's resolver and this wrapper is redundant
  • Your schema has cross-field refinements in the lite schema — the lite schema intentionally strips root-level refinements, so cross-field rules are NOT checked

Pitfalls​

  • NEVER pass the full schema as schemaLite — it defeats the optimization and adds double-validation overhead; only pass the schema produced by walkSchema's result.schemaLite field
  • NEVER use this with schemas that have root-level .superRefine() — root refinements are stripped from schemaLite by design and will not run through this wrapper