⏳ feat: add opt-in delayError option for setValue

[candymask0712]

to resolve#12992

Issue

useForm({ delayError: 2000 }) is ignored when triggering validation via setValue('field', value, { shouldValidate: true }) — errors are displayed immediately instead of after the configured delay.

As @awwwdev reported, there is currently no way to programmatically change an input value and have delayError take effect for showing error messages.

Cause

The setValue → setFieldValue → trigger() path bypasses shouldRenderByError(), which is the only path that applies the delayError logic. trigger() sets errors directly in _formState.errors and
emits them immediately via _subjects.state.next().

Solution

Added an opt-in delayError: boolean option to SetValueConfig. When setValue is called with { shouldValidate: true, delayError: true }, the option is forwarded to trigger(), which removes the
error from _formState.errors and re-applies it after the form-level delayError duration using the existing shared debounce/timer mechanism (consistent with shouldRenderByError).

Note: api-extractor.md.api.md includes additional formatting updates from upstream code changes that were not yet reflected in the report.

[Copilot]

Pull request overview

Adds an opt-in mechanism for setValue(..., { shouldValidate: true }) to respect the form-level delayError behavior, addressing issue #12992 where validation errors were emitted immediately.

Changes:

• Added delayError boolean to SetValueConfig and propagated it through setValue → setFieldValue → trigger.
• Implemented delayed error emission logic inside trigger() when explicitly enabled.
• Added test coverage for delayed vs immediate error behavior when using setValue validation.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
src/types/form.ts	Extends SetValueConfig with a new opt-in flag for delayed error handling.
src/logic/createFormControl.ts	Forwards the new option into trigger() and applies delayed error scheduling there.
src/__tests__/useForm/formState.test.tsx	Adds regression tests for delayed/immediate/cancelled error display via setValue.
reports/api-extractor.md.api.md	Updates API extractor output for the new SetValueConfig field (plus upstream formatting shift).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[candymask0712]

@bluebill1049
Hello, Bill.
The delayError logic adds ~20 bytes to the bundle, so I bumped the bundlewatch limit from 12.5 kB to 12.6 kB.
Let me know if you'd prefer a different approach.

[bluebill1049]

yea, no worries. we will get this feature out in the following weeks 🙏 thanks for the patient.

[candymask0712]

@bluebill1049 I got it. Thanks for comment!