Skip to main content

Function: createOptimizers()

createOptimizers(custom?): Record<string, FormOptimizer[]>

Defined in: packages/core/src/optimizers/index.ts:78

Create an optimizer registry by merging custom optimizers with builtins. Custom optimizers for a type replace the entire chain for that type.

Parameters​

custom?​

Record<string, FormOptimizer[]> = {}

Custom optimizer chains keyed by Zod def.type. Each entry replaces the entire built-in chain for that type.

Returns​

Record<string, FormOptimizer[]>

A merged optimizer registry combining built-in and custom chains, ready to pass via walkSchema options.

Remarks​

Creates an optimizer registry by merging custom optimizers with built-in L1/L2 chains. L1 stores per-field zodSchema for decomposed validation. L2 generates native HTML validation rules (minLength, pattern, etc.). Custom optimizers for a type REPLACE the entire chain — they don't append.

Use When​

  • You want per-field validation instead of whole-form validation
  • You need native HTML validation attributes (required, minLength, pattern)

Avoid When​

  • You only need whole-schema validation — omit the optimization option entirely

Pitfalls​

  • NEVER mutate builtinOptimizers — it's a module singleton. Always use createOptimizers(custom)
  • NEVER assume custom optimizers append — they REPLACE the entire chain for that type