feat(ui): upgrade Form with validation wrapper

[bntvllnt]

Summary

• upgrade Form from a presentational wrapper into a react-hook-form-powered validation shell with schema/resolver support
• add accessible field wiring helpers (FormField, FormControl, FormDescription, FormMessage, useFormField) and export them for consumers
• add docs, stories, tests, and visual coverage for validation, pending submit state, and accessible error messaging

Validation

• pnpm -F @vllnt/ui exec vitest run src/components/form/form.test.tsx
• pnpm -F @vllnt/ui exec tsx scripts/verify-stories.ts
• pnpm -F @vllnt/ui exec playwright test -c playwright-ct.config.ts src/components/form/form.visual.tsx
• pnpm -F @vllnt/ui build

Closes #47

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
storybook	Ready	Preview, Comment	Apr 25, 2026 7:28pm
ui.vllnt.ai	Ready	Preview, Comment	Apr 25, 2026 7:28pm

[bntvllnt]

Status: ready for final human review.

Blockers: none.

Validation summary:

• ✅ pnpm install --frozen-lockfile
• ✅ pnpm -F @vllnt/ui exec vitest run src/components/form/form.test.tsx
• ✅ pnpm -F @vllnt/ui exec tsx scripts/verify-stories.ts
• ✅ pnpm -F @vllnt/ui build
• ✅ pnpm --dir apps/registry build
• ✅ pnpm -F @vllnt/ui exec playwright test -c playwright-ct.config.ts src/components/form/form.visual.tsx
• ✅ gh pr checks 147 (Vercel Preview Comments, storybook, ui.vllnt.ai all passing)

Claude review result:

• No blocking findings on the live diff vs feat/storybook.
• Non-blocking warns only: TS as escape hatches in form.tsx, always-instantiated useForm when a form instance is provided, auto-disable-on-submit behavior/documentation drift, and dependency/peer-dependency follow-up questions for RHF/Zod.

Codex review result:

• Unavailable for this run: codex CLI is installed, but OPENAI_API_KEY is unset, so no Codex review could be executed.

Action for bntvllnt:

• Review PR feat(ui): upgrade Form with validation wrapper #147 at current head eadcbbf and merge if the non-blocking follow-up notes are acceptable. No further auto-fix is queued from this pass.