remove the verb 'is' from generic validators

Author: ArturAssisComp

example/lib/forms_with_validate_granularlly.dart

@@ -180,8 +180,8 @@ class _BodyState extends State<_Body> {
                       child: Text('Invalid option 2'),
                     ),
                   ]).toList(),
-                  validator: V.required(V.isInList(validBloodTypeOptions,
-                      isInListMsg: (_, List<String> v) =>
+                  validator: V.required(V.inList(validBloodTypeOptions,
+                      inListMsg: (_, List<String> v) =>
                           'The option must be one of: ${v.join(', ')}.')),
                   onChanged: (String? value) {
                     setState(() {

lib/src/form_builder_validators.dart

@@ -3480,7 +3480,7 @@ final class Validators {
           maxInclusive: rightInclusive);
 
   // Generic type validators
-  /// {@template validator_is_in_list}
+  /// {@template validator_in_list}
   /// Creates a validator function that verifies if a given input is in `values`.
   ///
   /// ## Type Parameters
@@ -3490,7 +3490,7 @@ final class Validators {
   /// ## Parameters
   /// - `values` (`List<T>`): A non-empty list of valid values to check against. The input
   ///   will be validated against these values.
-  /// - `isInListMsg` (`String Function(T input, List<T> values)?`): Optional callback
+  /// - `inListMsg` (`String Function(T input, List<T> values)?`): Optional callback
   ///   function that generates a custom error message when validation fails. The function
   ///   receives the invalid input and the list of valid values as parameters. If not provided,
   ///   defaults to the localized error text from FormBuilderLocalizations.
@@ -3507,7 +3507,7 @@ final class Validators {
   /// ## Examples
   /// ```dart
   /// // Creating a validator with a custom error message generator
-  /// final countryValidator = isInList(
+  /// final countryValidator = Validators.inList(
   ///   ['USA', 'Canada', 'Mexico'],
   ///   isInListMsg: (input, values) =>
   ///     'Country $input is not in allowed list: ${values.join(", ")}',
@@ -3518,11 +3518,11 @@ final class Validators {
   /// final valid = countryValidator('USA');     // Returns null (valid)
   /// ```
   /// {@endtemplate}
-  static Validator<T> isInList<T extends Object?>(
+  static Validator<T> inList<T extends Object?>(
     List<T> values, {
-    String Function(T input, List<T> values)? isInListMsg,
+    String Function(T input, List<T> values)? inListMsg,
   }) =>
-      val.isInList(values, isInListMsg: isInListMsg);
+      val.inList(values, inListMsg: inListMsg);
 
   /// {@template validator_is_true}
   /// Creates a validator function that checks if a given input represents a `true`

lib/src/validators/generic_type_validators.dart

@@ -1,10 +1,10 @@
 import '../../localization/l10n.dart';
 import 'constants.dart';
 
-/// {@macro validator_is_in_list}
-Validator<T> isInList<T extends Object?>(
+/// {@macro validator_in_list}
+Validator<T> inList<T extends Object?>(
   List<T> values, {
-  String Function(T input, List<T> values)? isInListMsg,
+  String Function(T input, List<T> values)? inListMsg,
 }) {
   if (values.isEmpty) {
     throw ArgumentError.value(
@@ -14,7 +14,7 @@ Validator<T> isInList<T extends Object?>(
   return (T input) {
     return setOfValues.contains(input)
         ? null
-        : isInListMsg?.call(input, values) ??
+        : inListMsg?.call(input, values) ??
             FormBuilderLocalizations.current.containsElementErrorText;
   };
 }
@@ -39,7 +39,7 @@ Validator<T> isTrue<T extends Object>(
   };
 }
 
-/// {@macro validator_is_false}
+/// {@macro validator_false}
 Validator<T> isFalse<T extends Object>(
     {String Function(T input)? isFalseMsg,
     bool caseSensitive = false,

test/src/validators/generic_type_validators/is_in_list_validator_test.dart

@@ -6,22 +6,22 @@ void main() {
   group('Validator: isInList', () {
     group('Validations with default error message', () {
       test('Should return null when int 0 is provided', () {
-        final Validator<int> validator = isInList(<int>[0]);
+        final Validator<int> validator = inList(<int>[0]);
 
         expect(validator(0), isNull);
         expect(validator(2),
             equals(FormBuilderLocalizations.current.containsElementErrorText));
       });
       test('Should return null when int 0 or String "2" is provided', () {
-        final Validator<Object> validator = isInList(<Object>[0, '2']);
+        final Validator<Object> validator = inList(<Object>[0, '2']);
 
         expect(validator(0), isNull);
         expect(validator('2'), isNull);
         expect(validator(2),
             equals(FormBuilderLocalizations.current.containsElementErrorText));
       });
       test('Should return null when int 0, int 2, or null is provided', () {
-        final Validator<Object?> validator = isInList(<Object?>[0, 2, null]);
+        final Validator<Object?> validator = inList(<Object?>[0, 2, null]);
 
         expect(validator(0), isNull);
         expect(validator(2), isNull);
@@ -32,22 +32,22 @@ void main() {
     });
 
     test('Should throw ArgumentError when list input is empty', () {
-      expect(() => isInList(<Object>[]), throwsArgumentError);
+      expect(() => inList(<Object>[]), throwsArgumentError);
     });
 
     test('Should return custom error message when invalid input is provided',
         () {
       const String customMessage = 'custom message';
       final Validator<int> validator =
-          isInList(<int>[1, 2, 3], isInListMsg: (_, __) => customMessage);
+          inList(<int>[1, 2, 3], inListMsg: (_, __) => customMessage);
 
       expect(validator(4), equals(customMessage));
     });
 
     test('should remain immutable when input elements change', () {
       final List<Object> elements = <Object>[12, 15, 'hi'];
 
-      final Validator<Object> v = isInList(elements);
+      final Validator<Object> v = inList(elements);
 
       expect(v(12), isNull);
       expect(v(15), isNull);