feat(forms): add field arrays, wizard flow, and disabled/readOnly controls

[RtlZeroMemory]

Summary

• add useFieldArray with append, remove, and move
• add multi-step wizard support with step-gated navigation
• add form-level disabled/readOnly with per-field overrides
• update forms docs and exports/types

Tests

• added 44 deterministic form tests across:
  • form.fieldArray.test.ts
  • form.wizard.test.ts
  • form.disabled.test.ts
• npm run lint
• npm run build
• npm run typecheck
• node scripts/run-tests.mjs

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a5f12e9b43

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Track array length changes when computing dirty state

computeArrayFieldDirty only compares indices up to currentValue.length, so shrinking an array with an unchanged prefix (for example ['a','b'] to ['a']) yields all-false dirty flags. Since computeIsDirty only looks for any true, the form can report isDirty === false even though values changed, which breaks unsaved-change detection for array fields.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Validate against latest step before advancing wizard

nextStep validates using the render-time currentStep/state.values snapshot, but the state update increments from prev.currentStep. If nextStep (or wizard-mode handleSubmit) is called twice before rerender, both validations run for the old step while both increments apply, so the wizard can skip intermediate-step validation gates.

Useful? React with 👍 / 👎.

[RtlZeroMemory]

Addressed the two review findings in 3e37107:

• fixed array dirty tracking when array length changes (including shrink cases)
• fixed wizard step-gate race so repeated nextStep / wizard-mode handleSubmit calls before rerender cannot skip intermediate validation
• added regression tests for both behaviors

Validation rerun:

• npm run lint
• npm run build
• npm run typecheck
• node scripts/run-tests.mjs

All passing.