agama-project / agama / 23266989132

73%

master: 77%

push

github

refactor(web): start connection form reimplementation

This commit starts the reimplementation of the network connection form
using TanStack Form, replacing the previous ad-hoc form state management
with a structured, library-backed approach.

The form is intentionally minimal in this first iteration, name and
interface fields only, to establish the pattern cleanly before adding
complexity. The full form (IP settings, bond/bridge/VLAN config, etc)
will be built incrementally in subsequent commits.

TanStack Form was chosen for:

  - Declarative field registration with built-in state (dirty, touched,
    errors) per field, without manual useState plumbing
  - Type-safe form values inferred from defaultValues
  - A clean model for handling server errors via onSubmitAsync: the error
    is surfaced in the UI without throwing, keeping the form interactive
    so the user can read the message, adjust, and retry
  - A composable field component model that will allow reusable,
    form-aware widgets to be introduced as the form grows

As patterns emerge across iterations (reusable field components, subform
composition, complex validation), they will be extracted and documented
as part of this reimplementation effort, or as part of the
reimplementation of other forms in the codebase. Whichever comes first.

3249 of 5225 branches covered (62.18%)

Branch coverage included in aggregate %.

37 of 39 new or added lines in 3 files covered. (94.87%)

12734 of 16862 relevant lines covered (75.52%)

74.42 hits per line