port over jsdocs

src/types.ts

@@ -79,15 +79,20 @@ export type SingleFieldValidator<
 
 export type FieldValidationOptions<TShouldValidate = boolean> = {
     /**
-     * Whether to run validation after field value is updated. **This will overwrite
-     * the top-level `validateOnChange` if set to `true`.**
+     * Whether to run validation after field value is updated or the field is blurred.
+     * Setting this prop to `false` will cancel any validation set for the field.
+     * Granular configuration of the field validation can be set with the `validationEvent`
+     * prop if set to `true` or not set.
      *
      * @default true
      */
     shouldValidate?: TShouldValidate;
     /**
      * The field events for which validation should occur. *Only applies if
-     * `shouldValidate` is set to `true`.*
+     * `shouldValidate` is set to `true` or not set at all.*
+     *
+     * Not setting this prop or setting this prop to `'all'` will run validation on every field
+     * change or blur event.
      *
      * @default 'all'
      */