feat(hooks): reactive values + keepDirtyValues for useForm

[colorpulse6]

Roadmap item B / P1 — reactive external values, the one real parity gap the audit + feature-inventory research both flagged (RHF values prop + resetOptions; Formik enableReinitialize).

What

A reactive values option on useForm for forms backed by props/server data:

useForm({ values: serverData, keepDirtyValues: true });

• When values's content changes (deep-compared, so a new-object/same-content render is a no-op), the form re-syncs. It also seeds the initial state (precedence over defaultValues).
• keepDirtyValues: true preserves fields the user is mid-editing while untouched fields sync.

Why it's clean

el-form tracks dirty via a mutation-driven set, so writing values through setFormState doesn't disturb dirty tracking — keepDirtyValues is a per-path "which value wins" merge (setNestedValue, nested-path aware). No dirty-baseline reconciliation needed.

Caveats (documented in the changeset + migration guide)

• values replaces the whole value object (provide the full shape; omitted keys drop) — matches RHF.
• isDirty is measured against the original defaultValues, not the latest synced values (consistent with el-form's existing reset({values})).
• Don't put File/Blob in reactive values — the deep-compare can't distinguish files, so a swap won't re-sync (a pre-existing deepEqual limitation; flagged for a future fix).

Verification

• 7 runtime tests: initial-seed precedence, content-change resync, the deep-compare no-clobber guard, both keepDirtyValues branches, undefined→defined, and nested dirty-field preservation.
• build + hooks (123) + tsd + components (26) + umbrella (6) green; lint clean.
• Independent review: SOUND — adversarially probed no-loop / no-mount-resync / nested-merge / no-regression; the only latent issue (File in deepEqual) is pre-existing and documented.

Design: docs/superpowers/specs/2026-06-09-reactive-values-design.md. Minor changeset (additive). Deferred: full resetOptions surface (keepErrors/keepTouched/…) — YAGNI for v1.

🤖 Generated with Claude Code

[qodo-code-review]

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →