feat: add field and form states

Author: mdeandrea-mrmilu

lib/src/form_builder.dart

@@ -102,16 +102,29 @@ typedef FormBuilderFields
     = Map<String, FormBuilderFieldState<FormBuilderField<dynamic>, dynamic>>;
 
 class FormBuilderState extends State<FormBuilder> {
-  final _formKey = GlobalKey<FormState>();
+  final GlobalKey<FormState> _formKey = GlobalKey<FormState>();
+  final FormBuilderFields _fields = {};
+  final Map<String, dynamic> _instantValue = {};
+  final Map<String, dynamic> _savedValue = {};
+  // Because dart type system will not accept ValueTransformer<dynamic>
+  final Map<String, Function> _transformers = {};
 
   bool get enabled => widget.enabled;
 
-  final FormBuilderFields _fields = {};
+  /// Verify if all fields on form are valid
+  bool get isValid => fields.values.every((field) => field.isValid);
+
+  /// Verify if some field on form are dirty
+  bool get isDirty => fields.values.any((field) => field.isDirty);
+
+  /// Verify if some field on form are touched
+  bool get isTouched => fields.values.any((field) => field.isTouched);
 
-  //because dart type system will not accept ValueTransformer<dynamic>
-  final _transformers = <String, Function>{};
-  final _instantValue = <String, dynamic>{};
-  final _savedValue = <String, dynamic>{};
+  /// Get initialValue
+  Map<String, dynamic> get initialValue => widget.initialValue;
+
+  /// Get all fields of form
+  FormBuilderFields get fields => _fields;
 
   Map<String, dynamic> get instantValue =>
       Map<String, dynamic>.unmodifiable(_instantValue.map((key, value) =>
@@ -122,11 +135,6 @@ class FormBuilderState extends State<FormBuilder> {
       Map<String, dynamic>.unmodifiable(_savedValue.map((key, value) =>
           MapEntry(key, _transformers[key]?.call(value) ?? value)));
 
-  /// Returns values after saving
-  Map<String, dynamic> get initialValue => widget.initialValue;
-
-  FormBuilderFields get fields => _fields;
-
   dynamic transformValue<T>(String name, T? v) {
     final t = _transformers[name];
     return t != null ? t.call(v) : v;
@@ -150,9 +158,6 @@ class FormBuilderState extends State<FormBuilder> {
     widget.onChanged?.call();
   }
 
-  bool get isValid =>
-      fields.values.where((element) => !element.isValid).isEmpty;
-
   void removeInternalFieldValue(
     String name, {
     required bool isSetState,
@@ -282,22 +287,15 @@ class FormBuilderState extends State<FormBuilder> {
     );
   }
 
+  /// Reset form to `initialValue`
   void reset() {
-    _formKey.currentState!.reset();
-    for (var field in _fields.entries) {
-      try {
-        field.value.didChange(getRawValue(field.key));
-      } catch (e, st) {
-        log(
-          'Error when resetting field: ${field.key}',
-          error: e,
-          stackTrace: st,
-          level: 2000,
-        );
-      }
-    }
+    _formKey.currentState?.reset();
   }
 
+  /// Update fields values of form.
+  /// Useful when need update all values at once, after init.
+  ///
+  /// To load all values at once on init, use `initialValue` property
   void patchValue(Map<String, dynamic> val) {
     val.forEach((key, dynamic value) {
       _fields[key]?.didChange(value);

lib/src/form_builder_field.dart

@@ -74,6 +74,7 @@ class FormBuilderFieldState<F extends FormBuilderField<T>, T>
   String? _customErrorText;
   FormBuilderState? _formBuilderState;
   bool _touched = false;
+  bool _dirty = false;
   late FocusNode effectiveFocusNode;
   FocusAttachment? focusAttachment;
 
@@ -105,6 +106,8 @@ class FormBuilderFieldState<F extends FormBuilderField<T>, T>
 
   bool get enabled => widget.enabled && (_formBuilderState?.enabled ?? true);
   bool get _readOnly => !(_formBuilderState?.widget.skipDisabled ?? false);
+  bool get isDirty => _dirty;
+  bool get isTouched => _touched;
 
   InputDecoration get decoration => widget.decoration.copyWith(
         errorText: widget.enabled || _readOnly
@@ -173,6 +176,7 @@ class FormBuilderFieldState<F extends FormBuilderField<T>, T>
 
   void _informFormForFieldChange() {
     if (_formBuilderState != null) {
+      _dirty = true;
       if (enabled || _readOnly) {
         _formBuilderState!.setInternalFieldValue<T>(
           widget.name,
@@ -212,7 +216,8 @@ class FormBuilderFieldState<F extends FormBuilderField<T>, T>
   @override
   void reset() {
     super.reset();
-    setValue(initialValue);
+    didChange(initialValue);
+    _dirty = false;
     if (_customErrorText != null) {
       setState(() => _customErrorText = null);
     }