Doc: no values param in onFormSubmit callback if not return in resolver

[wflixu]

Describe the bug

In the Form documentation, I discovered that for submitHandler's args to include values, the resolver needs to return values - something I only learned by reading the source code. This important information should be noted in the documentation.

const resolver = ({ values }) => {
  const errors = {};
  console.log('resolver:', values);
  return {
    errors,
   // must return it if I want values arg in submit event handler
    values
  };

};

const onFormSubmit = ({ valid, states, values }) => {
  if (valid) {
    //  Here, I need to use the values from values to submit the form.
    console.log('submit:', values);
  }
};

Pull Request Link

No response

Reason for not contributing a PR

• Lack of time
• Unsure how to implement the fix/feature
• Difficulty understanding the codebase
• Other

Other Reason

I couldn’t find where the code is located in the documentation.

Reproducer

https://stackblitz.com/edit/gxphrkc5?file=src%2FApp.vue

Environment

In a normal macOS Chrome browser

Vue version

3.5.13

PrimeVue version

4.2.5

Node version

v20.18.1

Browser(s)

macOS 15.2， chrome 131.0.6778.205 (arm64)

Steps to reproduce the behavior

1. Enter a piece of text in the input field
2. click submit button.

Expected behavior

It would be great if this subtle point could be reflected in the documentation.

[ZyphenVisuals]

Additionally, in the Forms documentation for Resolvers, the custom resolver does not do this. Excerpt:

else if (schema === 'Custom') {
        resolver.value = ({ values }) => {
            const errors = {};

            if (!values.username) {
                errors.username = [{ message: 'Username is required.' }];
            }

            return {
                errors
            };
        };
    }

This caused a lot of confusion for me as well.