React Hook Form Orchestration

Core Rule

Keep cross-field form orchestration in one controller/container layer. Form item components render fields and call explicit handlers; they do not own a distributed form state machine.

Apply This Pattern When

• A field change resets or defaults another field.
• A field change must revalidate another field.
• A watched value triggers an API call, debounced mutation, or quote fetch.
• Validation depends on derived max/min values, token decimals, balances, or quote output.
• A form freezes or loops after typing into a field.
• A component has useWatch/watch plus useEffect plus setValue or trigger.

Required Structure

Follow a feature-module structure that separates orchestration from fields: