chore(release): publish packages

- wyatt_analysis@2.2.0

.gitignore

@@ -195,4 +195,5 @@ $RECYCLE.BIN/
 # Custom rules (everything added below won't be overriden by 'Generate .gitignore File' if you use 'Update' option)
 
 .idea/
-*.iml
+*.iml
+google-services.json

CHANGELOG.md

@@ -3,6 +3,66 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 2022-07-11
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`wyatt_analysis` - `v2.2.0`](#wyatt_analysis---v220)
+
+---
+
+#### `wyatt_analysis` - `v2.2.0`
+
+ - **FIX**: rename to follow melos versioning and remove redundant rule.
+ - **FEAT**: promote experimental, update analyzer rules and add some linter rules.
+
+
+## 2022-07-10
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`form_bloc_example` - `v1.1.0`](#form_bloc_example---v110)
+ - [`wyatt_form_bloc` - `v0.0.3`](#wyatt_form_bloc---v003)
+ - [`authentication_bloc_example` - `v1.0.1`](#authentication_bloc_example---v101)
+ - [`wyatt_authentication_bloc` - `v0.2.1+1`](#wyatt_authentication_bloc---v0211)
+
+Packages with dependency updates only:
+
+> Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
+
+ - `authentication_bloc_example` - `v1.0.1`
+ - `wyatt_authentication_bloc` - `v0.2.1+1`
+
+---
+
+#### `form_bloc_example` - `v1.1.0`
+
+ - **FEAT**: add list option validator.
+ - **DOCS**: add example app.
+
+#### `wyatt_form_bloc` - `v0.0.3`
+
+ - **FEAT**: add helpers.
+ - **FEAT**: add metadata on inputs.
+ - **FEAT**: update to latest dart version.
+
+
 ## 2022-06-24
 
 ### Changes

packages/wyatt_analysis/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 2.2.0
+
+ - **FIX**: rename to follow melos versioning and remove redundant rule.
+ - **FEAT**: promote experimental, update analyzer rules and add some linter rules.
+
 ## 2.1.0
 
  - **FEAT**: add experimental rules in appropriate file.

packages/wyatt_analysis/lib/analysis_options.2.2.0.yaml

@@ -0,0 +1,206 @@
+# Copyright (C) 2022 WYATT GROUP
+# Please see the AUTHORS file for details.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+analyzer:
+  language:
+    strict-casts: true
+    strict-inference: true
+    strict-raw-types: true
+
+  errors:
+    todo: ignore
+    close_sinks: ignore
+    missing_required_param: error
+    missing_return: error
+
+  exclude:
+    - example/**
+    - lib/l10n/**
+    - lib/generated/**
+    - lib/generated_plugin_registrant.dart
+    - test/.test_coverage.dart
+
+linter:
+  rules:
+    - always_declare_return_types
+    - always_require_non_null_named_parameters
+    - always_put_control_body_on_new_line
+    - always_put_required_named_parameters_first
+    - always_use_package_imports
+    - annotate_overrides
+    - avoid_bool_literals_in_conditional_expressions
+    - avoid_catching_errors
+    - avoid_double_and_int_checks
+    - avoid_dynamic_calls
+    - avoid_empty_else
+    - avoid_equals_and_hash_code_on_mutable_classes
+    - avoid_escaping_inner_quotes
+    - avoid_field_initializers_in_const_classes
+    - avoid_function_literals_in_foreach_calls
+    - avoid_init_to_null
+    - avoid_js_rounded_ints
+    - avoid_null_checks_in_equality_operators
+    - avoid_positional_boolean_parameters
+    - avoid_private_typedef_functions
+    - avoid_redundant_argument_values
+    - avoid_relative_lib_imports
+    - avoid_renaming_method_parameters
+    - avoid_return_types_on_setters
+    - avoid_returning_null
+    - avoid_returning_null_for_future
+    - avoid_returning_null_for_void
+    - avoid_returning_this
+    - avoid_setters_without_getters
+    - avoid_shadowing_type_parameters
+    - avoid_single_cascade_in_expression_statements
+    - avoid_slow_async_io
+    - avoid_type_to_string
+    - avoid_types_as_parameter_names
+    - avoid_types_on_closure_parameters
+    - avoid_unused_constructor_parameters
+    - avoid_void_async
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - cancel_subscriptions
+    - cascade_invocations
+    - cast_nullable_to_non_nullable
+    - comment_references
+    - conditional_uri_does_not_exist
+    - constant_identifier_names
+    - control_flow_in_finally
+    - curly_braces_in_flow_control_structures
+    - depend_on_referenced_packages
+    - deprecated_consistency
+    - directives_ordering
+    - empty_catches
+    - empty_constructor_bodies
+    - empty_statements
+    - eol_at_end_of_file
+    - exhaustive_cases
+    - file_names
+    - flutter_style_todos
+    - hash_and_equals
+    - implementation_imports
+    - iterable_contains_unrelated_type
+    - join_return_with_assignment
+    - leading_newlines_in_multiline_strings
+    - library_names
+    - library_prefixes
+    - library_private_types_in_public_api
+    - lines_longer_than_80_chars
+    - list_remove_unrelated_type
+    - literal_only_boolean_expressions
+    - missing_whitespace_between_adjacent_strings
+    - no_adjacent_strings_in_list
+    - no_default_cases
+    - no_duplicate_case_values
+    - no_leading_underscores_for_local_identifiers
+    - no_runtimeType_toString
+    - non_constant_identifier_names
+    - noop_primitive_operations
+    - null_check_on_nullable_type_parameter
+    - null_closures
+    - one_member_abstracts
+    - only_throw_errors
+    - overridden_fields
+    - package_api_docs
+    - package_names
+    - package_prefixed_library_names
+    - parameter_assignments
+    - prefer_adjacent_string_concatenation
+    - prefer_asserts_in_initializer_lists
+    - prefer_asserts_with_message
+    - prefer_collection_literals
+    - prefer_conditional_assignment
+    - prefer_const_constructors
+    - prefer_const_constructors_in_immutables
+    - prefer_const_declarations
+    - prefer_const_literals_to_create_immutables
+    - prefer_constructors_over_static_methods
+    - prefer_contains
+    - prefer_equal_for_default_values
+    - prefer_expression_function_bodies
+    - prefer_final_fields
+    - prefer_final_in_for_each
+    - prefer_final_locals
+    - prefer_for_elements_to_map_fromIterable
+    - prefer_function_declarations_over_variables
+    - prefer_generic_function_type_aliases
+    - prefer_if_elements_to_conditional_expressions
+    - prefer_if_null_operators
+    - prefer_initializing_formals
+    - prefer_inlined_adds
+    - prefer_int_literals
+    - prefer_interpolation_to_compose_strings
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_is_not_operator
+    - prefer_iterable_whereType
+    - prefer_mixin
+    - prefer_null_aware_operators
+    - prefer_null_aware_method_calls
+    - prefer_single_quotes
+    - prefer_spread_collections
+    - prefer_typing_uninitialized_variables
+    - prefer_void_to_null
+    - provide_deprecation_message
+    - recursive_getters
+    - require_trailing_commas
+    - slash_for_doc_comments
+    - sort_unnamed_constructors_first
+    - test_types_in_equals
+    - throw_in_finally
+    - tighten_type_of_initializing_formals
+    - type_annotate_public_apis
+    - type_init_formals
+    - unawaited_futures
+    - unnecessary_await_in_return
+    - unnecessary_brace_in_string_interps
+    - unnecessary_const
+    - unnecessary_constructor_name
+    - unnecessary_getters_setters
+    - unnecessary_lambdas
+    - unnecessary_late
+    - unnecessary_new
+    - unnecessary_null_aware_assignments
+    - unnecessary_null_checks
+    - unnecessary_null_in_if_null_operators
+    - unnecessary_nullable_for_final_variable_declarations
+    - unnecessary_overrides
+    - unnecessary_parenthesis
+    - unnecessary_raw_strings
+    - unnecessary_statements
+    - unnecessary_string_escapes
+    - unnecessary_string_interpolations
+    - unnecessary_this
+    - unrelated_type_equality_checks
+    - unsafe_html
+    - use_enums
+    - use_function_type_syntax_for_parameters
+    - use_if_null_to_convert_nulls_to_bools
+    - use_is_even_rather_than_modulo
+    - use_late_for_private_fields_and_variables
+    - use_named_constants
+    - use_raw_strings
+    - use_rethrow_when_possible
+    - use_setters_to_change_properties
+    - use_string_buffers
+    - use_super_parameters
+    - use_test_throws_matchers
+    - use_to_and_as_if_applicable
+    - valid_regexps
+    - void_checks

packages/wyatt_analysis/lib/analysis_options.flutter.2.2.0.yaml

@@ -14,9 +14,19 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-include: package:wyatt_analysis/analysis_options.flutter.2.0.0.yaml
+include: package:wyatt_analysis/analysis_options.2.1.1.yaml
 
 linter:
   rules:
-    - use_super_parameters
+    - avoid_print
-    - use_enums
+    - avoid_unnecessary_containers
+    - avoid_web_libraries_in_flutter
+    - no_logic_in_create_state
+    - sized_box_for_whitespace
+    - sized_box_shrink_expand
+    - sort_child_properties_last
+    - use_build_context_synchronously
+    - use_colored_box
+    - use_decorated_box
+    - use_full_hex_values_for_flutter_colors
+    - use_key_in_widget_constructors

packages/wyatt_analysis/lib/analysis_options.flutter.yaml

@@ -14,4 +14,4 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-include: package:wyatt_analysis/analysis_options.flutter.2.0.0.yaml
+include: package:wyatt_analysis/analysis_options.flutter.2.2.0.yaml

packages/wyatt_analysis/lib/analysis_options.yaml

@@ -14,4 +14,4 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-include: package:wyatt_analysis/analysis_options.2.0.0.yaml
+include: package:wyatt_analysis/analysis_options.2.2.0.yaml

packages/wyatt_analysis/pubspec.yaml

@@ -1,7 +1,7 @@
 name: wyatt_analysis
 description: Lint rules for Dart and Flutter used internally at Wyatt and Wyatt Studio.
 repository: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_analysis
-version: 2.1.0
+version: 2.2.0
 
 environment:
   sdk: '>=2.12.0 <3.0.0'

packages/wyatt_authentication_bloc/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.1+1
+
+ - Update a dependency to the latest release.
+
 ## 0.2.1
 
  - **FEAT**: add google, facebook, apple, twitter login.

packages/wyatt_authentication_bloc/example/CHANGELOG.md

@@ -0,0 +1,4 @@
+## 1.0.1
+
+ - Update a dependency to the latest release.
+

packages/wyatt_authentication_bloc/example/android/app/google-services.json

@@ -14,6 +14,14 @@
         }
       },
       "oauth_client": [
+        {
+          "client_id": "136771801992-nps7ic22shstvgdv0c2ojvbkj3dkntum.apps.googleusercontent.com",
+          "client_type": 1,
+          "android_info": {
+            "package_name": "com.example.authentication_bloc_example",
+            "certificate_hash": "5d8790309e13b68c35e5d4d8437c35c6d15e6131"
+          }
+        },
         {
           "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
           "client_type": 3
@@ -77,58 +85,6 @@
           ]
         }
       }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:136771801992:android:d20e0361057e815197203d",
-        "android_client_info": {
-          "package_name": "com.example.example"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "136771801992-n2pq8oqutvrqj58e05hbavvc7n1jdfjb.apps.googleusercontent.com",
-          "client_type": 1,
-          "android_info": {
-            "package_name": "com.example.example",
-            "certificate_hash": "5d8790309e13b68c35e5d4d8437c35c6d15e6131"
-          }
-        },
-        {
-          "client_id": "136771801992-pj9s88ao7d99pnp4ace75nj1abtmoq7e.apps.googleusercontent.com",
-          "client_type": 1,
-          "android_info": {
-            "package_name": "com.example.example",
-            "certificate_hash": "bc8faf31c0b0085dc358b2319684e10c93f42719"
-          }
-        },
-        {
-          "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyAYS14uXupkS158Q5QAFP1864UrUN_yDSk"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "136771801992-e585bm1n9b3lv89t4phrl9u0glsg52ua.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.example.example"
-              }
-            }
-          ]
-        }
-      }
     }
   ],
   "configuration_version": "1"

packages/wyatt_authentication_bloc/example/lib/app/app.dart

@@ -31,23 +31,29 @@ class App extends StatelessWidget {
 
   static FormData getNormalFormData() {
     return const FormData([
-      FormEntry(formFieldName, Name.pure()),
+      FormInput(formFieldName, Name.pure()),
-      FormEntry(formFieldPhone, Phone.pure()),
+      FormInput(formFieldPhone, Phone.pure()),
-      FormEntry(formFieldPro, Boolean.pure()),
+      FormInput(formFieldPro, Boolean.pure()),
-      FormEntry(formFieldConfirmedPassword, ConfirmedPassword.pure(),
+      FormInput(
-          export: false),
+        formFieldConfirmedPassword,
+        ConfirmedPassword.pure(),
+        metadata: FormInputMetadata(export: false),
+      ),
     ]);
   }
 
   static FormData getProFormData() {
     return const FormData([
-      FormEntry(formFieldName, Name.pure()),
+      FormInput(formFieldName, Name.pure()),
-      FormEntry(formFieldPhone, Phone.pure()),
+      FormInput(formFieldPhone, Phone.pure()),
-      FormEntry(formFieldPro, Boolean.pure()),
+      FormInput(formFieldPro, Boolean.pure()),
-      FormEntry(formFieldSiren, Siren.pure()),
+      FormInput(formFieldSiren, Siren.pure()),
-      FormEntry(formFieldIban, Iban.pure()),
+      FormInput(formFieldIban, Iban.pure()),
-      FormEntry(formFieldConfirmedPassword, ConfirmedPassword.pure(),
+      FormInput(
-          export: false),
+        formFieldConfirmedPassword,
+        ConfirmedPassword.pure(),
+        metadata: FormInputMetadata(export: false),
+      ),
     ]);
   }
 
@@ -103,42 +109,42 @@ class App extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    AuthenticationRepositoryInterface _authenticationRepository =
+    AuthenticationRepositoryInterface authenticationRepository =
         AuthenticationRepositoryFirebase();
 
-    AuthenticationCubit _authenticationCubit = AuthenticationCubit(
+    AuthenticationCubit authenticationCubit = AuthenticationCubit(
-      authenticationRepository: _authenticationRepository,
+      authenticationRepository: authenticationRepository,
       onAuthSuccess: onAuthSuccess,
     );
 
-    SignUpCubit _signUpCubit = SignUpCubit(
+    SignUpCubit signUpCubit = SignUpCubit(
-      authenticationRepository: _authenticationRepository,
+      authenticationRepository: authenticationRepository,
-      authenticationCubit: _authenticationCubit,
+      authenticationCubit: authenticationCubit,
       entries: getNormalFormData(),
       onSignUpSuccess: onSignUpSuccess,
     );
 
-    SignInCubit _signInCubit = SignInCubit(
+    SignInCubit signInCubit = SignInCubit(
-      authenticationRepository: _authenticationRepository,
+      authenticationRepository: authenticationRepository,
-      authenticationCubit: _authenticationCubit,
+      authenticationCubit: authenticationCubit,
     );
 
     return MultiRepositoryProvider(
       providers: [
         RepositoryProvider<AuthenticationRepositoryInterface>(
-          create: (context) => _authenticationRepository,
+          create: (context) => authenticationRepository,
         ),
       ],
       child: MultiBlocProvider(
         providers: [
           BlocProvider<AuthenticationCubit>(
-            create: (context) => _authenticationCubit..init(),
+            create: (context) => authenticationCubit..init(),
           ),
           BlocProvider<SignUpCubit>(
-            create: (context) => _signUpCubit,
+            create: (context) => signUpCubit,
           ),
           BlocProvider<SignInCubit>(
-            create: (context) => _signInCubit,
+            create: (context) => signInCubit,
           ),
         ],
         child: const AppView(),

packages/wyatt_authentication_bloc/example/lib/sign_up/widgets/sign_up_form.dart

@@ -37,7 +37,7 @@ class _NameInput extends StatelessWidget {
             labelText: 'name',
             helperText: '',
             errorText:
-                state.data.input(formFieldName).invalid ? 'invalid name' : null,
+                state.data.isNotValid(formFieldName) ? 'invalid name' : null,
           ),
         );
       },
@@ -58,7 +58,7 @@ class _PhoneInput extends StatelessWidget {
           decoration: InputDecoration(
             labelText: 'phone',
             helperText: '',
-            errorText: state.data.input(formFieldPhone).invalid
+            errorText: state.data.isNotValid(formFieldPhone)
                 ? 'invalid phone'
                 : null,
           ),
@@ -81,7 +81,7 @@ class _SirenInput extends StatelessWidget {
           decoration: InputDecoration(
             labelText: 'siren',
             helperText: '',
-            errorText: state.data.input(formFieldSiren).invalid
+            errorText: state.data.isNotValid(formFieldSiren)
                 ? 'invalid SIREN'
                 : null,
           ),
@@ -105,7 +105,7 @@ class _IbanInput extends StatelessWidget {
             labelText: 'iban',
             helperText: '',
             errorText:
-                state.data.input(formFieldIban).invalid ? 'invalid IBAN' : null,
+                state.data.isNotValid(formFieldIban) ? 'invalid IBAN' : null,
           ),
         );
       },
@@ -149,8 +149,7 @@ class _PasswordInput extends StatelessWidget {
                         .read<SignUpCubit>()
                         .state
                         .data
-                        .input(formFieldConfirmedPassword)
+                        .valueOf<String, ValidationError>(formFieldConfirmedPassword),
-                        .value,
                   ),
                 );
           },
@@ -185,7 +184,7 @@ class _ConfirmPasswordInput extends StatelessWidget {
           decoration: InputDecoration(
             labelText: 'confirm password',
             helperText: '',
-            errorText: state.data.input(formFieldConfirmedPassword).invalid
+            errorText: state.data.isNotValid(formFieldConfirmedPassword)
                 ? 'passwords do not match'
                 : null,
           ),
@@ -203,7 +202,7 @@ class _CheckIsProInput extends StatelessWidget {
       trailing: BlocBuilder<SignUpCubit, SignUpState>(
         builder: (context, state) {
           return Checkbox(
-              value: state.data.input<bool>(formFieldPro).value,
+              value: state.data.valueOf<bool, ValidationError>(formFieldPro),
               onChanged: (isPro) {
                 final value =
                     isPro!; // tristate is false, so value can't be null
@@ -297,7 +296,7 @@ class SignUpForm extends StatelessWidget {
               const SizedBox(height: 8),
               BlocBuilder<SignUpCubit, SignUpState>(
                 builder: (context, state) {
-                  if (state.data.input<bool>(formFieldPro).value) {
+                  if (state.data.valueOf<bool, ValidationError>(formFieldPro)) {
                     return Column(children: [
                       _SirenInput(),
                       const SizedBox(height: 8),

packages/wyatt_authentication_bloc/example/pubspec.yaml

@@ -15,7 +15,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # In iOS, build-name is used as CFBundleShortVersionString while build-number used as CFBundleVersion.
 # Read more about iOS versioning at
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
-version: 1.0.0+1
+version: 1.0.1
 
 environment:
   sdk: ">=2.16.2 <3.0.0"
@@ -38,7 +38,7 @@ dependencies:
   wyatt_form_bloc:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_form_bloc-v0.0.2
+      ref: wyatt_form_bloc-v0.0.3
       path: packages/wyatt_form_bloc
 
   # The following adds the Cupertino Icons font to your application.
@@ -55,7 +55,7 @@ dev_dependencies:
   # activated in the `analysis_options.yaml` file located at the root of your
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
-  flutter_lints: ^1.0.0
+  flutter_lints: ^2.0.0
 
 # For information on the generic Dart part of this file, see the
 # following page: https://dart.dev/tools/pub/pubspec

packages/wyatt_authentication_bloc/lib/src/password_reset/cubit/password_reset_cubit.dart

@@ -33,7 +33,7 @@ class PasswordResetCubit extends Cubit<PasswordResetState> {
     emit(
       state.copyWith(
         email: email,
-        status: FormData.validate([email]),
+        status: FormStatus.validate([email]),
       ),
     );
   }

packages/wyatt_authentication_bloc/lib/src/sign_in/cubit/sign_in_cubit.dart

@@ -39,7 +39,7 @@ class SignInCubit extends Cubit<SignInState> {
     emit(
       state.copyWith(
         email: email,
-        status: FormData.validate([email, state.password]),
+        status: FormStatus.validate([email, state.password]),
       ),
     );
   }
@@ -49,7 +49,7 @@ class SignInCubit extends Cubit<SignInState> {
     emit(
       state.copyWith(
         password: password,
-        status: FormData.validate([state.email, password]),
+        status: FormStatus.validate([state.email, password]),
       ),
     );
   }

packages/wyatt_authentication_bloc/lib/src/sign_up/cubit/sign_up_cubit.dart

@@ -44,16 +44,16 @@ class SignUpCubit extends Cubit<SignUpState> {
   void emailChanged(String value) {
     final Email email = Email.dirty(value);
 
-    final List<FormInput<dynamic, ValidationError>> inputsToValidate = [
+    final List<FormInputValidator<dynamic, ValidationError>> toValidate = [
       email,
       state.password,
-      ...state.data.inputs<dynamic>(),
+      ...state.data.validators<dynamic, ValidationError>(),
     ];
 
     emit(
       state.copyWith(
         email: email,
-        status: FormData.validate(inputsToValidate),
+        status: FormStatus.validate(toValidate),
       ),
     );
   }
@@ -61,26 +61,26 @@ class SignUpCubit extends Cubit<SignUpState> {
   void passwordChanged(String value) {
     final Password password = Password.dirty(value);
 
-    final List<FormInput<dynamic, ValidationError>> inputsToValidate = [
+    final List<FormInputValidator<dynamic, ValidationError>> toValidate = [
       state.email,
       password,
-      ...state.data.inputs<dynamic>(),
+      ...state.data.validators<dynamic, ValidationError>(),
     ];
 
     emit(
       state.copyWith(
         password: password,
-        status: FormData.validate(inputsToValidate),
+        status: FormStatus.validate(toValidate),
       ),
     );
   }
 
   // Take from wyatt_form_bloc/wyatt_form_bloc.dart
-  void dataChanged<T>(String field, FormInput dirtyValue) {
+  void dataChanged<T>(String field, FormInputValidator dirtyValue) {
     final _form = state.data.clone();
 
     if (_form.contains(field)) {
-      _form.update(field, dirtyValue);
+      _form.updateValidator(field, dirtyValue);
     } else {
       throw Exception('Form field $field not found');
     }
@@ -88,8 +88,12 @@ class SignUpCubit extends Cubit<SignUpState> {
     emit(
       state.copyWith(
         data: _form,
-        status: FormData.validate(
+        status: FormStatus.validate(
-          [state.email, state.password, ..._form.inputs<dynamic>()],
+          [
+            state.email,
+            state.password,
+            ...state.data.validators<dynamic, ValidationError>(),
+          ],
         ),
       ),
     );
@@ -120,8 +124,12 @@ class SignUpCubit extends Cubit<SignUpState> {
     emit(
       state.copyWith(
         data: _form,
-        status: FormData.validate(
+        status: FormStatus.validate(
-          [state.email, state.password, ..._form.inputs<dynamic>()],
+          [
+            state.email,
+            state.password,
+            ...state.data.validators<dynamic, ValidationError>(),
+          ],
         ),
       ),
     );

packages/wyatt_authentication_bloc/pubspec.yaml

@@ -1,7 +1,7 @@
 name: wyatt_authentication_bloc
 description: Authentication BLoC for Flutter
 repository: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_authentication_bloc
-version: 0.2.1
+version: 0.2.1+1
 
 environment:
   sdk: ">=2.15.1 <3.0.0"
@@ -23,7 +23,7 @@ dependencies:
   wyatt_form_bloc:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_form_bloc-v0.0.2
+      ref: wyatt_form_bloc-v0.0.3
       path: packages/wyatt_form_bloc
     
 
@@ -35,5 +35,5 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.1.0
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis

packages/wyatt_authentication_bloc/test/sign_up/sign_up_cubit_test.dart

@@ -68,9 +68,9 @@ void main() {
         SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ).state,
-        SignUpState(data: FormData.empty()),
+        const SignUpState(data: FormData.empty()),
       );
     });
 
@@ -80,11 +80,11 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
         act: (SignUpCubit cubit) => cubit.emailChanged(invalidEmailString),
         expect: () => <SignUpState>[
-          SignUpState(
+          const SignUpState(
             email: invalidEmail,
             status: FormStatus.invalid,
             data: FormData.empty(),
@@ -97,15 +97,15 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
-        seed: () => SignUpState(
+        seed: () => const SignUpState(
           password: validPassword,
           data: FormData.empty(),
         ),
         act: (SignUpCubit cubit) => cubit.emailChanged(validEmailString),
         expect: () => <SignUpState>[
-          SignUpState(
+          const SignUpState(
             email: validEmail,
             password: validPassword,
             status: FormStatus.valid,
@@ -121,12 +121,12 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
         act: (SignUpCubit cubit) =>
             cubit.passwordChanged(invalidPasswordString),
         expect: () => <SignUpState>[
-          SignUpState(
+          const SignUpState(
             password: invalidPassword,
             status: FormStatus.invalid,
             data: FormData.empty(),
@@ -139,15 +139,15 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
-        seed: () => SignUpState(
+        seed: () => const SignUpState(
           email: validEmail,
           data: FormData.empty(),
         ),
         act: (SignUpCubit cubit) => cubit.passwordChanged(validPasswordString),
         expect: () => <SignUpState>[
-          SignUpState(
+          const SignUpState(
             email: validEmail,
             password: validPassword,
             status: FormStatus.valid,
@@ -163,7 +163,7 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
         act: (SignUpCubit cubit) => cubit.signUpFormSubmitted(),
         expect: () => const <SignUpState>[],
@@ -174,9 +174,9 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
-        seed: () => SignUpState(
+        seed: () => const SignUpState(
           status: FormStatus.valid,
           email: validEmail,
           password: validPassword,
@@ -199,9 +199,9 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
-        seed: () => SignUpState(
+        seed: () => const SignUpState(
           status: FormStatus.valid,
           email: validEmail,
           password: validPassword,
@@ -209,13 +209,13 @@ void main() {
         ),
         act: (SignUpCubit cubit) => cubit.signUpFormSubmitted(),
         expect: () => <SignUpState>[
-          SignUpState(
+          const SignUpState(
             status: FormStatus.submissionInProgress,
             email: validEmail,
             password: validPassword,
             data: FormData.empty(),
           ),
-          SignUpState(
+          const SignUpState(
             status: FormStatus.submissionSuccess,
             email: validEmail,
             password: validPassword,
@@ -238,9 +238,9 @@ void main() {
         build: () => SignUpCubit(
           authenticationRepository: authenticationRepository,
           authenticationCubit: authenticationCubit,
-          entries: FormData.empty(),
+          entries: const FormData.empty(),
         ),
-        seed: () => SignUpState(
+        seed: () => const SignUpState(
           status: FormStatus.valid,
           email: validEmail,
           password: validPassword,
@@ -248,13 +248,13 @@ void main() {
         ),
         act: (SignUpCubit cubit) => cubit.signUpFormSubmitted(),
         expect: () => <SignUpState>[
-          SignUpState(
+          const SignUpState(
             status: FormStatus.submissionInProgress,
             email: validEmail,
             password: validPassword,
             data: FormData.empty(),
           ),
-          SignUpState(
+          const SignUpState(
             status: FormStatus.submissionFailure,
             email: validEmail,
             password: validPassword,

packages/wyatt_authentication_bloc/test/sign_up/sign_up_state_test.dart

@@ -26,10 +26,10 @@ void main() {
   group('SignUpState', () {
     test('supports value comparisons', () {
       expect(
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ),
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ),
       );
@@ -37,10 +37,10 @@ void main() {
 
     test('returns same object when no properties are passed', () {
       expect(
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ).copyWith(),
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ),
       );
@@ -48,10 +48,10 @@ void main() {
 
     test('returns object with updated status when status is passed', () {
       expect(
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ).copyWith(status: FormStatus.pure),
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ),
       );
@@ -59,10 +59,10 @@ void main() {
 
     test('returns object with updated email when email is passed', () {
       expect(
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ).copyWith(email: email),
-        SignUpState(
+        const SignUpState(
           email: email,
           data: FormData.empty(),
         ),
@@ -71,10 +71,10 @@ void main() {
 
     test('returns object with updated password when password is passed', () {
       expect(
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ).copyWith(password: password),
-        SignUpState(
+        const SignUpState(
           password: password,
           data: FormData.empty(),
         ),
@@ -85,12 +85,12 @@ void main() {
         'returns object with updated data'
         ' when data is passed', () {
       expect(
-        SignUpState(
+        const SignUpState(
           data: FormData.empty(),
         ).copyWith(
           data: const FormData(
             [
-              FormEntry(
+              FormInput(
                 'field',
                 Name.pure(),
               ),
@@ -100,7 +100,7 @@ void main() {
         const SignUpState(
           data: FormData(
             [
-              FormEntry(
+              FormInput(
                 'field',
                 Name.pure(),
               ),

packages/wyatt_bloc_helper/pubspec.yaml

@@ -21,5 +21,5 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.1.0
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis

packages/wyatt_cli_toolbox/pubspec.yaml

@@ -10,6 +10,6 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.1.0
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis
 dependencies: {meta: ^1.8.0}

packages/wyatt_crud_bloc/example/android/app/google-services.json

@@ -14,6 +14,14 @@
         }
       },
       "oauth_client": [
+        {
+          "client_id": "136771801992-nps7ic22shstvgdv0c2ojvbkj3dkntum.apps.googleusercontent.com",
+          "client_type": 1,
+          "android_info": {
+            "package_name": "com.example.authentication_bloc_example",
+            "certificate_hash": "5d8790309e13b68c35e5d4d8437c35c6d15e6131"
+          }
+        },
         {
           "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
           "client_type": 3
@@ -77,58 +85,6 @@
           ]
         }
       }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:136771801992:android:d20e0361057e815197203d",
-        "android_client_info": {
-          "package_name": "com.example.example"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "136771801992-n2pq8oqutvrqj58e05hbavvc7n1jdfjb.apps.googleusercontent.com",
-          "client_type": 1,
-          "android_info": {
-            "package_name": "com.example.example",
-            "certificate_hash": "5d8790309e13b68c35e5d4d8437c35c6d15e6131"
-          }
-        },
-        {
-          "client_id": "136771801992-pj9s88ao7d99pnp4ace75nj1abtmoq7e.apps.googleusercontent.com",
-          "client_type": 1,
-          "android_info": {
-            "package_name": "com.example.example",
-            "certificate_hash": "bc8faf31c0b0085dc358b2319684e10c93f42719"
-          }
-        },
-        {
-          "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyAYS14uXupkS158Q5QAFP1864UrUN_yDSk"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "136771801992-ncuib3rbu7p4ro4eo5su4vaudn2u4qrv.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "136771801992-e585bm1n9b3lv89t4phrl9u0glsg52ua.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.example.example"
-              }
-            }
-          ]
-        }
-      }
     }
   ],
   "configuration_version": "1"

packages/wyatt_crud_bloc/example/pubspec.yaml

@@ -49,7 +49,7 @@ dev_dependencies:
   # activated in the `analysis_options.yaml` file located at the root of your
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
-  flutter_lints: ^1.0.0
+  flutter_lints: ^2.0.0
 
 # For information on the generic Dart part of this file, see the
 # following page: https://dart.dev/tools/pub/pubspec

packages/wyatt_crud_bloc/pubspec.yaml

@@ -23,5 +23,5 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.1.0
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis

packages/wyatt_form_bloc/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.0.3
+
+ - **FEAT**: add helpers.
+ - **FEAT**: add metadata on inputs.
+ - **FEAT**: update to latest dart version.
+
 ## 0.0.2
 
  - **FEAT**: add list option validator.

packages/wyatt_form_bloc/README.md

@@ -30,21 +30,22 @@ Form Bloc for Dart & Flutter.
 ## Features
 
 - Form
-    * FormInput: *atom of a form*
+    * FormInputValidator:
         - Store data
         - Validate this data
-    * FormEntry: *shell of this atom*
+    * FormInputMetadata:
-        - Associate a key to an input
+        - Store infos and options about an input.
-        - Configure form attribute (exportation, name...)
+    * FormInput:
-    * FormData: *collection of entries*
+        - Associaite a key, to a validator and metadata.
-        - Contain all entries
+    * FormData: *collection of inputs*
+        - Contain all inputs
         - Basic set operation
 
 - FormDataCubit
     * Data management behind a form.
         - Use entries to pass a FormData object
-        - You can use several pre configured FormInput for validation
+        - You can use several pre configured `FormInputValidator` for validation
-        - You can use updateFormData() to change FormData and validators during runtime (intersection, union, difference or replace)
+        - You can use updateFormData() to change `FormData` during runtime (intersection, union, difference or replace)
 
 - Consistent
     * Every class have same naming convention
@@ -59,4 +60,120 @@ import 'package:wyatt_form_bloc/wyatt_form_bloc.dart';
 
 ## Usage
 
-todo
+Firstly, you have to create your form inputs.
+
+```dart
+static List<FormInput> getNormalEntries() {
+    return const [
+        FormInput(formFieldName, Name.pure()),
+        FormInput(formFieldEmail, Email.pure()),
+        FormInput(formFieldPhone, Phone.pure()),
+        FormInput(formFieldList, ListOption<String>.pure(defaultValue: ['checkbox3'])),
+        FormInput(formFieldRadio, TextString.pure()),
+        FormInput(formFieldPro, Boolean.pure(), metadata: FormInputMetadata<void>(name: 'business')),
+        FormInput(formFieldHidden, Boolean.pure(), metadata: FormInputMetadata<void>(export: false)),
+    ];
+}
+
+static List<FormInput> getBusinessEntries() {
+    const entries = [
+        FormInput(formFieldSiren, Siren.pure()),
+        FormInput(formFieldIban, Iban.pure()),
+    ];
+    return getNormalEntries() + entries;
+}
+
+static FormData getNormalFormData() {
+    return FormData(getNormalEntries());
+}
+
+static FormData getProFormData() {
+    return FormData(getBusinessEntries());
+}
+```
+
+> Let's create functions to enable dynamic changes in runtime.
+
+> When creating metadata with `FormInputMetadata<T>`, `T` is the type of `extra` object.
+
+Then a `FormData` is a collection of inputs. You can `validate`, `contains`, `intersection`, `difference`, `union`, or `clone` this data.
+
+After that, you have to extends `FormDataCubit`.
+
+```dart
+class CustomFormCubit extends FormDataCubit {
+  CustomFormCubit({required FormData inputs}) : super(inputs: inputs);
+
+  @override
+  Future<void> submitForm() {
+    log(state.data.toMap().toString());
+    // Handle all your logic here.
+    emit(...)
+  }
+}
+```
+
+> The submited form is in `state.data` !
+
+Don't forget to create and provide it !
+
+```dart
+FormDataCubit _formCubit = CustomFormCubit(inputs: getNormalFormData());
+
+return BlocProvider(
+    create: (context) => _formCubit,
+    child: const WidgetTree(),
+);
+```
+
+You can now create the first form input !
+
+```dart
+class _EmailInput extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<FormDataCubit, FormDataState>(
+      builder: (context, state) {
+        return TextField(
+          onChanged: (email) => context
+              .read<FormDataCubit>()
+              .dataChanged(formFieldEmail, Email.dirty(email)),
+          keyboardType: TextInputType.emailAddress,
+          decoration: InputDecoration(
+            labelText: 'email',
+            helperText: '',
+            errorText: state.data.isNotValid(formFieldEmail)
+                ? 'invalid email'
+                : null,
+          ),
+        );
+      },
+    );
+  }
+}
+```
+
+Then, you can create the trigger
+
+```dart
+class _SignUpButton extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<FormDataCubit, FormDataState>(
+      buildWhen: (previous, current) => previous.status != current.status,
+      builder: (context, state) {
+        return state.status.isSubmissionInProgress
+            ? const CircularProgressIndicator()
+            : ElevatedButton(
+                onPressed: state.status.isValidated
+                    ? () => context.read<FormDataCubit>().submitForm()
+                    : null,
+                child: const Text('SIGN UP'),
+              );
+      },
+    );
+  }
+}
+```
+
+> With `state.status` you can access the status of the form to check if there is an error or if it's in submission.

packages/wyatt_form_bloc/example/.metadata

@@ -1,10 +1,30 @@
 # This file tracks properties of this Flutter project.
 # Used by Flutter tool to assess capabilities and perform upgrades etc.
 #
-# This file should be version controlled and should not be manually edited.
+# This file should be version controlled.
 
 version:
-  revision: 5464c5bac742001448fe4fc0597be939379f88ea
+  revision: 85684f9300908116a78138ea4c6036c35c9a1236
   channel: stable
 
 project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: 85684f9300908116a78138ea4c6036c35c9a1236
+      base_revision: 85684f9300908116a78138ea4c6036c35c9a1236
+    - platform: web
+      create_revision: 85684f9300908116a78138ea4c6036c35c9a1236
+      base_revision: 85684f9300908116a78138ea4c6036c35c9a1236
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

packages/wyatt_form_bloc/example/CHANGELOG.md

@@ -0,0 +1,5 @@
+## 1.1.0
+
+ - **FEAT**: add list option validator.
+ - **DOCS**: add example app.
+

packages/wyatt_form_bloc/example/lib/app/app.dart

@@ -16,31 +16,37 @@
 
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:form_bloc_example/app/metadata.dart';
 import 'package:form_bloc_example/constants.dart';
 import 'package:form_bloc_example/cubit/custom_form_cubit.dart';
 import 'package:form_bloc_example/sign_up/sign_up_page.dart';
 import 'package:wyatt_form_bloc/wyatt_form_bloc.dart';
 
+const blue = Metadata(category: Category.perso);
+const red = Metadata(category: Category.business);
+
 class App extends StatelessWidget {
   const App({Key? key}) : super(key: key);
 
-  static List<FormEntry> getNormalEntries() {
+  static List<FormInput> getNormalEntries() {
     return const [
-      FormEntry(formFieldName, Name.pure()),
+      FormInput(formFieldName, Name.pure(), metadata: FormInputMetadata<Metadata>(extra: blue)),
-      FormEntry(formFieldEmail, Email.pure()),
+      FormInput(formFieldEmail, Email.pure(), metadata: FormInputMetadata<Metadata>(extra: blue)),
-      FormEntry(formFieldPhone, Phone.pure()),
+      FormInput(formFieldPhone, Phone.pure(), metadata: FormInputMetadata<Metadata>(extra: red)),
-      FormEntry(
+      FormInput(
           formFieldList, ListOption<String>.pure(defaultValue: ['checkbox3'])),
-      FormEntry(formFieldRadio, TextString.pure()),
+      FormInput(formFieldRadio, TextString.pure()),
-      FormEntry(formFieldPro, Boolean.pure(), name: 'business'),
+      FormInput(formFieldPro, Boolean.pure(),
-      FormEntry(formFieldHidden, Boolean.pure(), export: false),
+          metadata: FormInputMetadata<Metadata>(name: 'business')),
+      FormInput(formFieldHidden, Boolean.pure(),
+          metadata: FormInputMetadata<Metadata>(export: false, extra: blue)),
     ];
   }
 
-  static List<FormEntry> getBusinessEntries() {
+  static List<FormInput> getBusinessEntries() {
     const entries = [
-      FormEntry(formFieldSiren, Siren.pure()),
+      FormInput(formFieldSiren, Siren.pure()),
-      FormEntry(formFieldIban, Iban.pure()),
+      FormInput(formFieldIban, Iban.pure()),
     ];
     return getNormalEntries() + entries;
   }
@@ -55,7 +61,7 @@ class App extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    FormDataCubit _formCubit = CustomFormCubit(entries: getNormalFormData());
+    FormDataCubit _formCubit = CustomFormCubit(inputs: getNormalFormData());
 
     return BlocProvider(
       create: (context) => _formCubit,

packages/wyatt_form_bloc/example/lib/app/metadata.dart

@@ -1,3 +1,4 @@
+// ignore_for_file: public_member_api_docs, sort_constructors_first
 // Copyright (C) 2022 WYATT GROUP
 // Please see the AUTHORS file for details.
 //
@@ -14,9 +15,20 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-part of 'custom_form_cubit.dart';
+enum Category {
+  perso,
+  business
+}
 
-@immutable
+class Metadata {
-abstract class CustomFormState {}
+  final Category category;
 
-class CustomFormInitial extends CustomFormState {}
+  const Metadata({
+    required this.category,
+  });
+
+  @override
+  String toString() {
+    return category.toString();
+  }
+}

packages/wyatt_form_bloc/example/lib/cubit/custom_form_cubit.dart

@@ -16,18 +16,15 @@
 
 import 'dart:developer';
 
-import 'package:meta/meta.dart';
 import 'package:wyatt_form_bloc/wyatt_form_bloc.dart';
 
-part 'custom_form_state.dart';
-
 class CustomFormCubit extends FormDataCubit {
-  CustomFormCubit({required FormData entries}) : super(entries: entries);
+  CustomFormCubit({required FormData inputs}) : super(inputs: inputs);
 
   @override
   Future<void> submitForm() {
     log(state.data.toMap().toString());
-    
+
     return Future.value();
   }
 }

packages/wyatt_form_bloc/example/lib/sign_up/widgets/sign_up_form.dart

@@ -19,35 +19,83 @@ import 'dart:developer';
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:form_bloc_example/app/app.dart';
+import 'package:form_bloc_example/app/metadata.dart';
 import 'package:form_bloc_example/constants.dart';
 import 'package:wyatt_form_bloc/wyatt_form_bloc.dart';
 
+class CategoryIndicator extends StatelessWidget {
+  const CategoryIndicator(
+      {Key? key, required this.field, required this.builder})
+      : super(key: key);
+
+  final String field;
+  final Function(BuildContext context, FormDataState state) builder;
+
+  Color computeColor(Metadata meta) {
+    switch (meta.category) {
+      case Category.perso:
+        return Colors.blue;
+      case Category.business:
+        return Colors.red;
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<FormDataCubit, FormDataState>(
+      builder: ((context, state) {
+        final meta = state.data.metadataOf(field).extra as Metadata;
+        final color = computeColor(meta);
+
+        return Row(
+          children: [
+            Container(
+              height: 8,
+              width: 8,
+              decoration: BoxDecoration(
+                color: color,
+                borderRadius: BorderRadius.circular(8),
+              ),
+            ),
+            const SizedBox(width: 20,),
+            SizedBox(
+              width: MediaQuery.of(context).size.width - 45,
+              child: builder(context, state),
+            )
+          ],
+        );
+      }),
+    );
+  }
+}
+
 class _NameInput extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
-    return BlocBuilder<FormDataCubit, FormDataState>(
+    return CategoryIndicator(
-      builder: (context, state) {
+        field: formFieldName,
-        return TextField(
+        builder: (context, state) {
-          onChanged: (name) => context
+          return TextField(
-              .read<FormDataCubit>()
+            onChanged: (name) => context
-              .dataChanged(formFieldName, Name.dirty(name)),
+                .read<FormDataCubit>()
-          keyboardType: TextInputType.name,
+                .dataChanged(formFieldName, Name.dirty(name)),
-          decoration: InputDecoration(
+            keyboardType: TextInputType.name,
-            labelText: 'name',
+            decoration: InputDecoration(
-            helperText: '',
+              labelText: 'name',
-            errorText:
+              helperText: '',
-                state.data.input(formFieldName).invalid ? 'invalid name' : null,
+              errorText:
-          ),
+                  state.data.isNotValid(formFieldName) ? 'invalid name' : null,
-        );
+            ),
-      },
+          );
-    );
+        });
   }
 }
 
 class _EmailInput extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
-    return BlocBuilder<FormDataCubit, FormDataState>(
+    return CategoryIndicator(
+        field: formFieldEmail,
       builder: (context, state) {
         return TextField(
           onChanged: (email) => context
@@ -57,9 +105,8 @@ class _EmailInput extends StatelessWidget {
           decoration: InputDecoration(
             labelText: 'email',
             helperText: '',
-            errorText: state.data.input(formFieldEmail).invalid
+            errorText:
-                ? 'invalid email'
+                state.data.isNotValid(formFieldEmail) ? 'invalid email' : null,
-                : null,
           ),
         );
       },
@@ -70,7 +117,8 @@ class _EmailInput extends StatelessWidget {
 class _PhoneInput extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
-    return BlocBuilder<FormDataCubit, FormDataState>(
+    return CategoryIndicator(
+        field: formFieldPhone,
       builder: (context, state) {
         return TextField(
           onChanged: (phone) => context
@@ -80,9 +128,8 @@ class _PhoneInput extends StatelessWidget {
           decoration: InputDecoration(
             labelText: 'phone',
             helperText: '',
-            errorText: state.data.input(formFieldPhone).invalid
+            errorText:
-                ? 'invalid phone'
+                state.data.isNotValid(formFieldPhone) ? 'invalid phone' : null,
-                : null,
           ),
         );
       },
@@ -93,7 +140,8 @@ class _PhoneInput extends StatelessWidget {
 class _SirenInput extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
-    return BlocBuilder<FormDataCubit, FormDataState>(
+    return CategoryIndicator(
+        field: formFieldName,
       builder: (context, state) {
         return TextField(
           onChanged: (siren) => context
@@ -103,9 +151,8 @@ class _SirenInput extends StatelessWidget {
           decoration: InputDecoration(
             labelText: 'siren',
             helperText: '',
-            errorText: state.data.input(formFieldSiren).invalid
+            errorText:
-                ? 'invalid SIREN'
+                state.data.isNotValid(formFieldSiren) ? 'invalid SIREN' : null,
-                : null,
           ),
         );
       },
@@ -127,7 +174,7 @@ class _IbanInput extends StatelessWidget {
             labelText: 'iban',
             helperText: '',
             errorText:
-                state.data.input(formFieldIban).invalid ? 'invalid IBAN' : null,
+                state.data.isNotValid(formFieldIban) ? 'invalid IBAN' : null,
           ),
         );
       },
@@ -141,7 +188,7 @@ class _CheckListInput extends StatelessWidget {
     return BlocBuilder<FormDataCubit, FormDataState>(
       builder: (context, state) {
         final _input =
-            state.data.input<List<String>>(formFieldList) as ListOption<String>;
+            state.data.validatorOf<ListOption<String>>(formFieldList);
         final _options = _input.value;
 
         return Column(
@@ -192,8 +239,7 @@ class _RadioListInput extends StatelessWidget {
   Widget build(BuildContext context) {
     return BlocBuilder<FormDataCubit, FormDataState>(
       builder: (context, state) {
-        final _input =
+        final _input = state.data.validatorOf<TextString>(formFieldRadio);
-            state.data.input<String>(formFieldRadio) as TextString;
 
         return Column(
           mainAxisSize: MainAxisSize.min,
@@ -249,7 +295,7 @@ class _CheckHiddenInput extends StatelessWidget {
       trailing: BlocBuilder<FormDataCubit, FormDataState>(
         builder: (context, state) {
           return Checkbox(
-              value: state.data.input<bool>(formFieldHidden).value,
+              value: state.data.validatorOf<Boolean>(formFieldHidden).value,
               onChanged: (v) {
                 final value = v!; // state is false, so value can't be null
 
@@ -272,7 +318,7 @@ class _CheckIsProInput extends StatelessWidget {
       trailing: BlocBuilder<FormDataCubit, FormDataState>(
         builder: (context, state) {
           return Checkbox(
-              value: state.data.input<bool>(formFieldPro).value,
+              value: state.data.validatorOf<Boolean>(formFieldPro).value,
               onChanged: (isPro) {
                 final value = isPro!; // state is false, so value can't be null
 
@@ -370,7 +416,7 @@ class SignUpForm extends StatelessWidget {
             const SizedBox(height: 8),
             BlocBuilder<FormDataCubit, FormDataState>(
               builder: (context, state) {
-                if (state.data.input<bool>(formFieldPro).value) {
+                if (state.data.validatorOf<Boolean>(formFieldPro).value) {
                   return Column(children: [
                     _SirenInput(),
                     const SizedBox(height: 8),

packages/wyatt_form_bloc/example/pubspec.yaml

@@ -15,10 +15,10 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # In iOS, build-name is used as CFBundleShortVersionString while build-number used as CFBundleVersion.
 # Read more about iOS versioning at
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
-version: 1.0.0+1
+version: 1.1.0
 
 environment:
-  sdk: ">=2.16.2 <3.0.0"
+  sdk: ">=2.17.2 <3.0.0"
 
 # Dependencies specify other packages that your package needs in order to work.
 # To automatically upgrade your package dependencies to the latest versions
@@ -47,7 +47,7 @@ dev_dependencies:
   # activated in the `analysis_options.yaml` file located at the root of your
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
-  flutter_lints: ^1.0.0
+  flutter_lints: ^2.0.0
 
 # For information on the generic Dart part of this file, see the
 # following page: https://dart.dev/tools/pub/pubspec

packages/wyatt_form_bloc/example/web/index.html

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <!--
+    If you are serving your web app in a path other than the root, change the
+    href value below to reflect the base path you are serving from.
+
+    The path provided below has to start and end with a slash "/" in order for
+    it to work correctly.
+
+    For more details:
+    * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base
+
+    This is a placeholder for base href that will be replaced by the value of
+    the `--base-href` argument provided to `flutter build`.
+  -->
+  <base href="$FLUTTER_BASE_HREF">
+
+  <meta charset="UTF-8">
+  <meta content="IE=Edge" http-equiv="X-UA-Compatible">
+  <meta name="description" content="A new Flutter project.">
+
+  <!-- iOS meta tags & icons -->
+  <meta name="apple-mobile-web-app-capable" content="yes">
+  <meta name="apple-mobile-web-app-status-bar-style" content="black">
+  <meta name="apple-mobile-web-app-title" content="example">
+  <link rel="apple-touch-icon" href="icons/Icon-192.png">
+
+  <!-- Favicon -->
+  <link rel="icon" type="image/png" href="favicon.png"/>
+
+  <title>example</title>
+  <link rel="manifest" href="manifest.json">
+
+  <script>
+    // The value below is injected by flutter build, do not touch.
+    var serviceWorkerVersion = null;
+  </script>
+  <!-- This script adds the flutter initialization JS code -->
+  <script src="flutter.js" defer></script>
+</head>
+<body>
+  <script>
+    window.addEventListener('load', function(ev) {
+      // Download main.dart.js
+      _flutter.loader.loadEntrypoint({
+        serviceWorker: {
+          serviceWorkerVersion: serviceWorkerVersion,
+        }
+      }).then(function(engineInitializer) {
+        return engineInitializer.initializeEngine();
+      }).then(function(appRunner) {
+        return appRunner.runApp();
+      });
+    });
+  </script>
+</body>
+</html>

packages/wyatt_form_bloc/example/web/manifest.json

@@ -0,0 +1,35 @@
+{
+    "name": "example",
+    "short_name": "example",
+    "start_url": ".",
+    "display": "standalone",
+    "background_color": "#0175C2",
+    "theme_color": "#0175C2",
+    "description": "A new Flutter project.",
+    "orientation": "portrait-primary",
+    "prefer_related_applications": false,
+    "icons": [
+        {
+            "src": "icons/Icon-192.png",
+            "sizes": "192x192",
+            "type": "image/png"
+        },
+        {
+            "src": "icons/Icon-512.png",
+            "sizes": "512x512",
+            "type": "image/png"
+        },
+        {
+            "src": "icons/Icon-maskable-192.png",
+            "sizes": "192x192",
+            "type": "image/png",
+            "purpose": "maskable"
+        },
+        {
+            "src": "icons/Icon-maskable-512.png",
+            "sizes": "512x512",
+            "type": "image/png",
+            "purpose": "maskable"
+        }
+    ]
+}

packages/wyatt_form_bloc/lib/src/cubit/form_data_cubit.dart

@@ -17,6 +17,7 @@
 import 'dart:async';
 
 import 'package:bloc/bloc.dart';
+import 'package:equatable/equatable.dart';
 import 'package:meta/meta.dart';
 import 'package:wyatt_form_bloc/src/enums/enums.dart';
 import 'package:wyatt_form_bloc/src/form/form.dart';
@@ -24,19 +25,19 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 part 'form_data_state.dart';
 
 abstract class FormDataCubit extends Cubit<FormDataState> {
-  FormDataCubit({required FormData entries})
+  FormDataCubit({required FormData inputs})
-      : super(FormDataState(data: entries));
+      : super(FormDataState(data: inputs));
 
   /// Change value of a field.
   /// 
   /// Inputs:
   /// - `field`: The key of the field to change.
-  /// - `dirtyValue`: The new value of the field.
+  /// - `dirtyValue`: The new value of the field. (Wrapped in a dirty validator)
-  void dataChanged(String field, FormInput dirtyValue) {
+  void dataChanged(String field, FormInputValidator dirtyValue) {
     final _form = state.data.clone();
 
     if (_form.contains(field)) {
-      _form.update(field, dirtyValue);
+      _form.updateValidator(field, dirtyValue);
     } else {
       throw Exception('Form field $field not found');
     }
@@ -44,7 +45,7 @@ abstract class FormDataCubit extends Cubit<FormDataState> {
     emit(
       state.copyWith(
         data: _form,
-        status: _form.selfValidate(),
+        status: _form.validate(),
       ),
     );
   }
@@ -78,7 +79,7 @@ abstract class FormDataCubit extends Cubit<FormDataState> {
     emit(
       state.copyWith(
         data: _form,
-        status: _form.selfValidate(),
+        status: _form.validate(),
       ),
     );
   }

packages/wyatt_form_bloc/lib/src/cubit/form_data_state.dart

@@ -17,9 +17,14 @@
 part of 'form_data_cubit.dart';
 
 @immutable
-class FormDataState {
+class FormDataState extends Equatable {
+  /// Global status of a form.
   final FormStatus status;
+  
+  /// FormData with all inputs, and associated metadata.
   final FormData data;
+
+  /// Optional error message.
   final String? errorMessage;
 
   const FormDataState({
@@ -41,23 +46,8 @@ class FormDataState {
   }
 
   @override
-  bool operator ==(Object other) {
+  bool? get stringify => true;
-    if (identical(this, other)) return true;
+  
-
-    return other is FormDataState &&
-        other.status == status &&
-        other.data == data &&
-        other.errorMessage == errorMessage;
-  }
-
   @override
-  int get hashCode {
+  List<Object?> get props => [status, data, errorMessage];
-    return status.hashCode ^ data.hashCode ^ errorMessage.hashCode;
-  }
-
-  @override
-  String toString() {
-    return 'FormDataState(status: $status, data: $data, '
-        'errorMessage: $errorMessage)';
-  }
 }

packages/wyatt_form_bloc/lib/src/enums/form_status.dart

@@ -14,6 +14,16 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import 'package:wyatt_form_bloc/src/form/form.dart';
+
+const Set<FormStatus> _validatedFormStatuses = <FormStatus>{
+  FormStatus.valid,
+  FormStatus.submissionInProgress,
+  FormStatus.submissionSuccess,
+  FormStatus.submissionFailure,
+  FormStatus.submissionCanceled,
+};
+
 /// Enum representing the status of a form at any given point in time.
 enum FormStatus {
   /// The form has not been touched.
@@ -35,19 +45,8 @@ enum FormStatus {
   submissionFailure,
 
   /// The form submission has been canceled.
-  submissionCanceled
+  submissionCanceled;
-}
 
-const Set<FormStatus> _validatedFormStatuses = <FormStatus>{
-  FormStatus.valid,
-  FormStatus.submissionInProgress,
-  FormStatus.submissionSuccess,
-  FormStatus.submissionFailure,
-  FormStatus.submissionCanceled,
-};
-
-/// Useful extensions on [FormStatus]
-extension FormStatusX on FormStatus {
   /// Indicates whether the form is untouched.
   bool get isPure => this == FormStatus.pure;
 
@@ -76,4 +75,23 @@ extension FormStatusX on FormStatus {
 
   /// Indicates whether the form submission has been canceled.
   bool get isSubmissionCanceled => this == FormStatus.submissionCanceled;
+
+  /// Validate a list of inputs by processing them in `validate` as validators.
+  static FormStatus validateInputs(List<FormInput> inputs) {
+    return validate(
+      inputs
+          .map<FormInputValidator>((FormInput input) => input.validator)
+          .toList(),
+    );
+  }
+
+  /// Validate a list of validators.
+  static FormStatus validate(List<FormInputValidator> validators) {
+    return validators.every((FormInputValidator validator) => validator.pure)
+        ? FormStatus.pure
+        : validators
+                .any((FormInputValidator validator) => validator.valid == false)
+            ? FormStatus.invalid
+            : FormStatus.valid;
+  }
 }

packages/wyatt_form_bloc/lib/src/form/form.dart

@@ -1,19 +1,25 @@
 // Copyright (C) 2022 WYATT GROUP
 // Please see the AUTHORS file for details.
-// 
+//
 // This program is free software: you can redistribute it and/or modify
 // it under the terms of the GNU General Public License as published by
 // the Free Software Foundation, either version 3 of the License, or
 // any later version.
-// 
+//
 // This program is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 // GNU General Public License for more details.
-// 
+//
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-export 'form_data.dart';
+import 'package:equatable/equatable.dart';
-export 'form_entry.dart';
+import 'package:meta/meta.dart';
-export 'form_input.dart';
+import 'package:wyatt_form_bloc/src/enums/form_input_status.dart';
+import 'package:wyatt_form_bloc/src/enums/form_status.dart';
+
+part 'form_input.dart';
+part 'form_input_metadata.dart';
+part 'form_input_validator.dart';
+part 'form_data.dart';

packages/wyatt_form_bloc/lib/src/form/form_data.dart

@@ -14,133 +14,185 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-import 'package:meta/meta.dart';
+part of 'form.dart';
-import 'package:wyatt_form_bloc/src/enums/enums.dart';
-import 'package:wyatt_form_bloc/src/form/form.dart';
-import 'package:wyatt_form_bloc/src/utils/list_equals.dart';
 
 @immutable
-class FormData {
+class FormData extends Equatable {
-  const FormData(this._entries);
+  final List<FormInput> _inputs;
 
-  FormData.empty() : this(<FormEntry>[]);
+  const FormData(this._inputs);
+  const FormData.empty() : this(const <FormInput>[]);
 
-  final List<FormEntry> _entries;
+  /// Returns all inputs as a list
+  List<FormInput> inputs() => _inputs;
 
-  List<FormEntry> get entries => _entries;
+  /// Returns the input for the associated key
-
+  FormInput inputOf(String key) {
-  List<FormInput<T, ValidationError>> inputs<T>() {
-    return _entries
-        .map((FormEntry entry) => entry.input as FormInput<T, ValidationError>)
-        .toList();
-  }
-
-  static FormStatus validate(List<FormInput> inputs) {
-    return inputs.every((FormInput element) => element.pure)
-        ? FormStatus.pure
-        : inputs.any((FormInput input) => input.valid == false)
-            ? FormStatus.invalid
-            : FormStatus.valid;
-  }
-
-  FormStatus selfValidate() {
-    return validate(inputs<dynamic>());
-  }
-
-  FormInput<T, ValidationError> input<T>(String key) {
     if (contains(key)) {
-      return _entries.firstWhere((FormEntry entry) => entry.key == key).input
+      return _inputs.firstWhere((FormInput input) => input.key == key);
-          as FormInput<T, ValidationError>;
     } else {
       throw Exception('FormInput with key `$key` does not exist in form');
     }
   }
 
-  bool contains(String key) {
+  /// Updates a input (perform a replace at index).
-    return _entries.any((FormEntry entry) => entry.key == key);
+  void updateInput(String key, FormInput input) {
-  }
-
-  FormData intersection(FormData other) {
-    final List<FormEntry> entries = <FormEntry>[];
-
-    for (final FormEntry entry in _entries) {
-      if (other.contains(entry.key)) {
-        entries.add(entry);
-      }
-    }
-
-    return FormData(entries);
-  }
-
-  FormData difference(FormData other) {
-    final List<FormEntry> entries = <FormEntry>[];
-
-    for (final FormEntry otherEntry in other._entries) {
-      if (!contains(otherEntry.key)) {
-        entries.add(otherEntry);
-      }
-    }
-
-    for (final FormEntry entry in _entries) {
-      if (!other.contains(entry.key)) {
-        entries.add(entry);
-      }
-    }
-
-    return FormData(entries);
-  }
-
-  FormData union(FormData other) {
-    final List<FormEntry> entries = <FormEntry>[];
-
-    for (final FormEntry entry in _entries) {
-      entries.add(entry);
-    }
-
-    for (final FormEntry otherEntry in other._entries) {
-      if (!contains(otherEntry.key)) {
-        entries.add(otherEntry);
-      }
-    }
-
-    return FormData(entries);
-  }
-
-  void update(String key, FormInput input) {
     if (contains(key)) {
-      final index = _entries.indexOf(
+      final index = _inputs.indexOf(
-        _entries.firstWhere((FormEntry entry) => entry.key == key),
+        inputOf(key),
       );
-      _entries[index] = _entries[index].copyWith(input: input);
+      _inputs[index] = input;
     }
   }
 
+  /// Returns all associated validators as a list
+  List<FormInputValidator<V, E>> validators<V, E>() {
+    return _inputs
+        .map<FormInputValidator<V, E>>(
+          (FormInput input) => input.validator as FormInputValidator<V, E>,
+        )
+        .toList();
+  }
+
+  /// A [FormInputValidator] represents the value of a single form input field.
+  /// It contains information about the [FormInputStatus], value, as well
+  /// as validation status.
+  T validatorOf<T>(String key) {
+    return inputOf(key).validator as T;
+  }
+
+  /// Updates validator of a given input. (perform copyWith)
+  void updateValidator(String key, FormInputValidator dirtyValue) {
+    if (contains(key)) {
+      final index = _inputs.indexOf(
+        inputOf(key),
+      );
+      _inputs[index] = _inputs[index].copyWith(validator: dirtyValue);
+    }
+  }
+
+  /// Returns a validation error if the [FormInputValidator] is invalid.
+  /// Returns null if the [FormInputValidator] is valid.
+  E? errorOf<V, E>(String key) {
+    return (inputOf(key).validator as FormInputValidator<V, E>).error;
+  }
+
+  /// The value of the associated [FormInputValidator]. For example,
+  /// if you have a FormInputValidator for FirstName, the value could be 'Joe'.
+  V valueOf<V, E>(String key) {
+    return (inputOf(key).validator as FormInputValidator<V, E>).value;
+  }
+
+  /// Returns `true` if the [FormInputValidator] is not valid.
+  /// Same as `E? errorOf<V, E>(String key) != null`
+  bool isNotValid(String key) {
+    return !inputOf(key).validator.valid;
+  }
+
+  /// Returns all associated metadata as a list
+  List<FormInputMetadata<M>> metadata<M>() {
+    return _inputs
+        .map<FormInputMetadata<M>>(
+          (FormInput input) => input.metadata as FormInputMetadata<M>,
+        )
+        .toList();
+  }
+
+  /// Returns the metadata associated. With `M` the type of extra data.
+  FormInputMetadata<M> metadataOf<M>(String key) {
+    return inputOf(key).metadata as FormInputMetadata<M>;
+  }
+
+  /// Updates metadata of a given input. (perform copyWith)
+  void updateMetadata(String key, FormInputMetadata meta) {
+    if (contains(key)) {
+      final index = _inputs.indexOf(
+        inputOf(key),
+      );
+      _inputs[index] = _inputs[index].copyWith(metadata: meta);
+    }
+  }
+
+  /// Validate self inputs.
+  FormStatus validate() {
+    return FormStatus.validateInputs(_inputs);
+  }
+
+  /// Check if this contains an input with the given key.
+  bool contains(String key) {
+    return _inputs.any((FormInput input) => input.key == key);
+  }
+
+  /// Makes an intersection set operation and returns newly created [FormData]
+  FormData intersection(FormData other) {
+    final List<FormInput> inputs = <FormInput>[];
+
+    for (final FormInput i in _inputs) {
+      if (other.contains(i.key)) {
+        inputs.add(i);
+      }
+    }
+
+    return FormData(inputs);
+  }
+
+  /// Makes a difference set operation and returns newly created [FormData]
+  FormData difference(FormData other) {
+    final List<FormInput> inputs = <FormInput>[];
+
+    for (final FormInput i in other._inputs) {
+      if (!contains(i.key)) {
+        inputs.add(i);
+      }
+    }
+
+    for (final FormInput i in _inputs) {
+      if (!other.contains(i.key)) {
+        inputs.add(i);
+      }
+    }
+
+    return FormData(inputs);
+  }
+
+  /// Makes an union set operation and returns newly created [FormData]
+  FormData union(FormData other) {
+    final List<FormInput> inputs = <FormInput>[];
+
+    for (final FormInput i in _inputs) {
+      inputs.add(i);
+    }
+
+    for (final FormInput i in other._inputs) {
+      if (!contains(i.key)) {
+        inputs.add(i);
+      }
+    }
+
+    return FormData(inputs);
+  }
+
+  /// Deeply copy this.
   FormData clone() {
     return FormData(
-      _entries.map((FormEntry entry) => entry.clone()).toList(),
+      _inputs.map((FormInput input) => input.clone()).toList(),
     );
   }
 
+  /// Export this to [Map] format.
   Map<String, dynamic> toMap() {
     final map = <String, dynamic>{};
-    for (final entry in _entries) {
+    for (final input in _inputs) {
-      if (entry.export) {
+      if (input.metadata.export) {
-        map[entry.name] = entry.input.value;
+        map[input.name] = input.validator.value;
       }
     }
     return map;
   }
 
   @override
-  bool operator ==(Object other) {
+  bool? get stringify => true;
-    if (identical(this, other)) return true;
-
-    return other is FormData && listEquals(other._entries, _entries);
-  }
 
   @override
-  int get hashCode => _entries.hashCode;
+  List<Object?> get props => _inputs;
-
-  @override
-  String toString() => 'FormData(entries: $_entries)';
 }

packages/wyatt_form_bloc/lib/src/form/form_entry.dart

@@ -1,79 +0,0 @@
-// Copyright (C) 2022 WYATT GROUP
-// Please see the AUTHORS file for details.
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with this program. If not, see <https://www.gnu.org/licenses/>.
-
-import 'package:meta/meta.dart';
-import 'package:wyatt_form_bloc/src/form/form.dart';
-
-@immutable
-class FormEntry {
-  const FormEntry(this.key, this.input, {this.export = true, String? name})
-      : _field = name ?? key;
-
-  final String key;
-  final FormInput input;
-  final bool export;
-  final String _field;
-
-  String get name => _field;
-
-  FormEntry copyWith({
-    String? key,
-    FormInput? input,
-    bool? export,
-    String? name,
-  }) {
-    return FormEntry(
-      key ?? this.key,
-      input ?? this.input,
-      export: export ?? this.export,
-      name: name,
-    );
-  }
-
-  FormEntry clone() {
-    return FormEntry(
-      key,
-      input,
-      export: export,
-      name: name,
-    );
-  }
-
-  @override
-  bool operator ==(Object other) {
-    if (identical(this, other)) return true;
-
-    return other is FormEntry &&
-        other.key == key &&
-        other.input == input &&
-        other.export == export &&
-        other.name == name;
-  }
-
-  @override
-  int get hashCode {
-    return key.hashCode ^
-        input.hashCode ^
-        export.hashCode ^
-        name.hashCode;
-  }
-
-  @override
-  String toString() {
-    return 'FormEntry(key: $key, input: $input, '
-        'export: $export, name: $name)';
-  }
-}

packages/wyatt_form_bloc/lib/src/form/form_input.dart

@@ -1,3 +1,4 @@
+// ignore_for_file: public_member_api_docs, sort_constructors_first
 // Copyright (C) 2022 WYATT GROUP
 // Please see the AUTHORS file for details.
 //
@@ -14,98 +15,45 @@
 // You should have received a copy of the GNU General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-import 'package:meta/meta.dart';
+part of 'form.dart';
-import 'package:wyatt_form_bloc/src/enums/enums.dart';
 
-/// {@template form_input}
+class FormInput extends Equatable {
-/// A [FormInput] represents the value of a single form input field.
+  final String key;
-/// It contains information about the [FormInputStatus], [value], as well
+  final FormInputValidator validator;
-/// as validation status.
+  final FormInputMetadata metadata;
-///
-/// [FormInput] should be extended to define custom [FormInput] instances.
-///
-/// ```dart
-/// enum FirstNameError { empty }
-/// class FirstName extends FormInput<String, FirstNameError> {
-///   const FirstName.pure({String value = ''}) : super.pure(value);
-///   const FirstName.dirty({String value = ''}) : super.dirty(value);
-///
-///   @override
-///   FirstNameError? validator(String value) {
-///     return value.isEmpty ? FirstNameError.empty : null;
-///   }
-/// }
-/// ```
-/// {@endtemplate}
-@immutable
-abstract class FormInput<T, E> {
-  const FormInput._(this.value, [this.pure = true]);
 
-  /// Constructor which create a `pure` [FormInput] with a given value.
+  String get name => metadata._name ?? key;
-  const FormInput.pure(T value) : this._(value);
 
-  /// Constructor which create a `dirty` [FormInput] with a given value.
+  const FormInput(
-  const FormInput.dirty(T value) : this._(value, false);
+    this.key,
-
+    this.validator, {
-  /// The value of the given [FormInput].
+    // ignore: avoid_redundant_argument_values
-  /// For example, if you have a `FormInput` for `FirstName`,
+    this.metadata = const FormInputMetadata<void>(export: true),
-  /// the value could be 'Joe'.
+  });
-  final T value;
-
-  /// If the [FormInput] is pure (has been touched/modified).
-  /// Typically when the `FormInput` is initially created,
-  /// it is created using the `FormInput.pure` constructor to
-  /// signify that the user has not modified it.
-  ///
-  /// For subsequent changes (in response to user input), the
-  /// `FormInput.dirty` constructor should be used to signify that
-  /// the `FormInput` has been manipulated.
-  final bool pure;
-
-  /// The [FormInputStatus] which can be one of the following:
-  /// * [FormInputStatus.pure]
-  ///   - if the input has not been modified.
-  /// * [FormInputStatus.invalid]
-  ///   - if the input has been modified and validation failed.
-  /// * [FormInputStatus.valid]
-  ///   - if the input has been modified and validation succeeded.
-  FormInputStatus get status => pure
-      ? FormInputStatus.pure
-      : valid
-          ? FormInputStatus.valid
-          : FormInputStatus.invalid;
-
-  /// Returns a validation error if the [FormInput] is invalid.
-  /// Returns `null` if the [FormInput] is valid.
-  E? get error => validator(value);
-
-  /// Whether the [FormInput] value is valid according to the
-  /// overridden `validator`.
-  ///
-  /// Returns `true` if `validator` returns `null` for the
-  /// current [FormInput] value and `false` otherwise.
-  bool get valid => validator(value) == null;
-
-  /// Whether the [FormInput] value is not valid.
-  /// A value is invalid when the overridden `validator`
-  /// returns an error (non-null value).
-  bool get invalid => status == FormInputStatus.invalid;
-
-  /// A function that must return a validation error if the provided
-  /// [value] is invalid and `null` otherwise.
-  E? validator(T value);
 
   @override
-  int get hashCode => value.hashCode ^ pure.hashCode;
+  bool? get stringify => true;
 
   @override
-  bool operator ==(Object other) {
+  List<Object?> get props => [key, validator, metadata];
-    if (other.runtimeType != runtimeType) return false;
+
-    return other is FormInput<T, E> &&
+  FormInput copyWith({
-        other.value == value &&
+    String? key,
-        other.pure == pure;
+    FormInputValidator? validator,
+    FormInputMetadata? metadata,
+  }) {
+    return FormInput(
+      key ?? this.key,
+      validator ?? this.validator,
+      metadata: metadata ?? this.metadata,
+    );
   }
 
-  @override
+  FormInput clone() {
-  String toString() => 'FormInput<$runtimeType>(value: $value, pure: $pure)';
+    return copyWith(
+      key: key,
+      validator: validator,
+      metadata: metadata,
+    );
+  }
 }

packages/wyatt_form_bloc/lib/src/form/form_input_metadata.dart

@@ -0,0 +1,56 @@
+// ignore_for_file: public_member_api_docs, sort_constructors_first
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+part of 'form.dart';
+
+class FormInputMetadata<T> extends Equatable {
+  final bool export;
+  final String? _name;
+  final T? extra;
+
+  const FormInputMetadata({
+    this.export = true,
+    this.extra,
+    String? name,
+  }) : _name = name;
+  
+  @override
+  bool? get stringify => true;
+
+  @override
+  List<Object?> get props => [export, _name, extra];
+
+  FormInputMetadata<T> copyWith({
+    bool? export,
+    String? name,
+    T? extra,
+  }) {
+    return FormInputMetadata<T>(
+      export: export ?? this.export,
+      name: name ?? _name,
+      extra: extra ?? this.extra,
+    );
+  }
+
+  FormInputMetadata<T> clone() {
+    return copyWith(
+      export: export,
+      name: _name,
+      extra: extra,
+    );
+  }
+}

packages/wyatt_form_bloc/lib/src/form/form_input_validator.dart

@@ -0,0 +1,104 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+part of 'form.dart';
+
+/// {@template form_input}
+/// A [FormInputValidator] represents the value of a single form input field.
+/// It contains information about the [FormInputStatus], [value], as well
+/// as validation status.
+///
+/// [FormInputValidator] should be extended to define custom
+/// [FormInputValidator] instances.
+///
+/// ```dart
+/// enum FirstNameError { empty }
+/// class FirstName extends FormInputValidator<String, FirstNameError> {
+///   const FirstName.pure({String value = ''}) : super.pure(value);
+///   const FirstName.dirty({String value = ''}) : super.dirty(value);
+///
+///   @override
+///   FirstNameError? validator(String value) {
+///     return value.isEmpty ? FirstNameError.empty : null;
+///   }
+/// }
+/// ```
+/// {@endtemplate}
+@immutable
+abstract class FormInputValidator<V, E> extends Equatable {
+  const FormInputValidator._(this.value, [this.pure = true]);
+
+  /// Constructor which create a `pure` [FormInputValidator] with a given value.
+  const FormInputValidator.pure(V value) : this._(value);
+
+  /// Constructor which create a `dirty` [FormInputValidator] with a 
+  /// given value.
+  const FormInputValidator.dirty(V value) : this._(value, false);
+
+  /// The value of the given [FormInputValidator].
+  /// For example, if you have a `FormInputValidator` for `FirstName`,
+  /// the value could be 'Joe'.
+  final V value;
+
+  /// If the [FormInputValidator] is pure (has been touched/modified).
+  /// Typically when the `FormInputValidator` is initially created,
+  /// it is created using the `FormInputValidator.pure` constructor to
+  /// signify that the user has not modified it.
+  ///
+  /// For subsequent changes (in response to user input), the
+  /// `FormInputValidator.dirty` constructor should be used to signify that
+  /// the `FormInputValidator` has been manipulated.
+  final bool pure;
+
+  /// The [FormInputStatus] which can be one of the following:
+  /// * [FormInputStatus.pure]
+  ///   - if the input has not been modified.
+  /// * [FormInputStatus.invalid]
+  ///   - if the input has been modified and validation failed.
+  /// * [FormInputStatus.valid]
+  ///   - if the input has been modified and validation succeeded.
+  FormInputStatus get status => pure
+      ? FormInputStatus.pure
+      : valid
+          ? FormInputStatus.valid
+          : FormInputStatus.invalid;
+
+  /// Returns a validation error if the [FormInputValidator] is invalid.
+  /// Returns `null` if the [FormInputValidator] is valid.
+  E? get error => validator(value);
+
+  /// Whether the [FormInputValidator] value is valid according to the
+  /// overridden `validator`.
+  ///
+  /// Returns `true` if `validator` returns `null` for the
+  /// current [FormInputValidator] value and `false` otherwise.
+  bool get valid => validator(value) == null;
+
+  /// Whether the [FormInputValidator] value is not valid.
+  /// A value is invalid when the overridden `validator`
+  /// returns an error (non-null value).
+  bool get invalid => status == FormInputStatus.invalid;
+
+  /// A function that must return a validation error if the provided
+  /// [value] is invalid and `null` otherwise.
+  E? validator(V value);
+
+  @override
+  bool? get stringify => true;
+
+  @override
+  List<Object?> get props => [value, pure];
+}

packages/wyatt_form_bloc/lib/src/utils/list_equals.dart

@@ -1,25 +0,0 @@
-// Copyright (C) 2022 WYATT GROUP
-// Please see the AUTHORS file for details.
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with this program. If not, see <https://www.gnu.org/licenses/>.
-
-bool listEquals<T>(List<T>? a, List<T>? b) {
-  if (a == null) return b == null;
-  if (b == null || a.length != b.length) return false;
-  if (identical(a, b)) return true;
-  for (int index = 0; index < a.length; index += 1) {
-    if (a[index] != b[index]) return false;
-  }
-  return true;
-}

packages/wyatt_form_bloc/lib/src/validators/boolean.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template boolean}
 /// Form input for a bool input
 /// {@endtemplate}
-class Boolean extends FormInput<bool, ValidationError> {
+class Boolean extends FormInputValidator<bool, ValidationError> {
   /// {@macro boolean}
   const Boolean.pure({bool? defaultValue = false})
       : super.pure(defaultValue ?? false);

packages/wyatt_form_bloc/lib/src/validators/confirmed_password.dart

@@ -21,7 +21,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// Form input for a confirmed password input.
 /// {@endtemplate}
 class ConfirmedPassword
-    extends FormInput<String, ValidationError> {
+    extends FormInputValidator<String, ValidationError> {
   /// {@macro confirmed_password}
   const ConfirmedPassword.pure({this.password = ''}) : super.pure('');
 

packages/wyatt_form_bloc/lib/src/validators/email.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template email}
 /// Form input for an email input.
 /// {@endtemplate}
-class Email extends FormInput<String, ValidationError> {
+class Email extends FormInputValidator<String, ValidationError> {
   /// {@macro email}
   const Email.pure() : super.pure('');
 
@@ -28,7 +28,7 @@ class Email extends FormInput<String, ValidationError> {
   const Email.dirty([String value = '']) : super.dirty(value);
 
   static final RegExp _emailRegExp = RegExp(
-    r'^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$',
+    r'[^@ \t\r\n]+@[^@ \t\r\n]+\.[^@ \t\r\n]+',
   );
 
   @override

packages/wyatt_form_bloc/lib/src/validators/iban.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template iban}
 /// Form input for an IBAN input.
 /// {@endtemplate}
-class Iban extends FormInput<String, ValidationError> {
+class Iban extends FormInputValidator<String, ValidationError> {
   /// {@macro iban}
   const Iban.pure() : super.pure('');
 

packages/wyatt_form_bloc/lib/src/validators/list_option.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template list_option}
 /// Form input for a list input
 /// {@endtemplate}
-class ListOption<T> extends FormInput<List<T>, ValidationError> {
+class ListOption<T> extends FormInputValidator<List<T>, ValidationError> {
   /// {@macro list_option}
   const ListOption.pure({List<T>? defaultValue})
       : super.pure(defaultValue ?? const []);

packages/wyatt_form_bloc/lib/src/validators/name.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template name}
 /// Form input for a name input.
 /// {@endtemplate}
-class Name extends FormInput<String, ValidationError> {
+class Name extends FormInputValidator<String, ValidationError> {
   /// {@macro name}
   const Name.pure() : super.pure('');
 

packages/wyatt_form_bloc/lib/src/validators/password.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template password}
 /// Form input for a password input.
 /// {@endtemplate}
-class Password extends FormInput<String, ValidationError> {
+class Password extends FormInputValidator<String, ValidationError> {
   /// {@macro password}
   const Password.pure() : super.pure('');
 

packages/wyatt_form_bloc/lib/src/validators/phone.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template phone}
 /// Form input for a phone input.
 /// {@endtemplate}
-class Phone extends FormInput<String, ValidationError> {
+class Phone extends FormInputValidator<String, ValidationError> {
   /// {@macro phone}
   const Phone.pure() : super.pure('');
 

packages/wyatt_form_bloc/lib/src/validators/siren.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template siren}
 /// Form input for a SIREN input.
 /// {@endtemplate}
-class Siren extends FormInput<String, ValidationError> {
+class Siren extends FormInputValidator<String, ValidationError> {
   /// {@macro siren}
   const Siren.pure() : super.pure('');
 

packages/wyatt_form_bloc/lib/src/validators/text_string.dart

@@ -20,7 +20,7 @@ import 'package:wyatt_form_bloc/src/form/form.dart';
 /// {@template text_string}
 /// Form input for a text input
 /// {@endtemplate}
-class TextString extends FormInput<String, ValidationError> {
+class TextString extends FormInputValidator<String, ValidationError> {
   /// {@macro text_string}
   const TextString.pure() : super.pure('');
 

packages/wyatt_form_bloc/pubspec.yaml

@@ -1,20 +1,21 @@
 name: wyatt_form_bloc
 description: Manage forms in Dart & Flutter with Bloc
 repository: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages/src/branch/master/packages/wyatt_form_bloc
-version: 0.0.2
+version: 0.0.3
 
 environment:
-  sdk: '>=2.16.2 <3.0.0'
+  sdk: '>=2.17.2 <3.0.0'
 
 dependencies:
   bloc: ^8.0.3
+  equatable: ^2.0.3
   meta: ^1.7.0
 
 dev_dependencies:
-  test: ^1.21.0
+  test: ^1.21.4
 
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.1.0
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis

packages/wyatt_http_client/pubspec.yaml

@@ -14,5 +14,5 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.0.1
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis

packages/wyatt_medium_feeds/example/pubspec.yaml

@@ -48,7 +48,7 @@ dev_dependencies:
   # activated in the `analysis_options.yaml` file located at the root of your
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
-  flutter_lints: ^1.0.0
+  flutter_lints: ^2.0.0
 
 # For information on the generic Dart part of this file, see the
 # following page: https://dart.dev/tools/pub/pubspec

packages/wyatt_medium_feeds/pubspec.yaml

@@ -15,5 +15,5 @@ dev_dependencies:
   wyatt_analysis:
     git:
       url: https://git.wyatt-studio.fr/Wyatt-FOSS/wyatt-packages
-      ref: wyatt_analysis-v2.1.0
+      ref: wyatt_analysis-v2.2.0
       path: packages/wyatt_analysis