typed_form_fields library
A type-safe, universal form field wrapper with zero dependencies and high performance.
This library provides generic TypedFieldWrapper<T> for any data type with built-in validation, debouncing, and performance optimizations. Uses TypedFormProvider for clean, dependency-free form state management with BLoC internally for maximum performance.
Classes
- ArabicValidatorLocalizations
- Arabic implementation of ValidatorLocalizations.
-
ChainValidator<
T> - A validator that chains multiple validators with conditional logic.
-
CompositeValidator<
T> - A composite validator that combines multiple validators and runs them in sequence. It stops at the first validation error encountered.
-
ConditionalCase<
T> - A case for the SwitchValidator.
- DefaultFieldRegistry
- Default implementation of FieldRegistry
- DefaultFieldTracking
- Default implementation of FieldTracking
- DefaultSubmissionHandling
- Default implementation of FormSubmissionService
- DefaultValidationCoordination
- Default implementation of ValidationCoordination
- EnglishValidatorLocalizations
- English implementation of ValidatorLocalizations.
- FieldRegistry
- Service responsible for managing form fields and their operations. This service encapsulates all field-related functionality and provides a clean interface for field management operations.
- FieldTracking
- Service responsible for managing touched field state.
-
FormFieldDefinition<
T> - FrenchValidatorLocalizations
- French implementation of ValidatorLocalizations.
- GermanValidatorLocalizations
- German implementation of ValidatorLocalizations.
- SpanishValidatorLocalizations
- Spanish implementation of ValidatorLocalizations.
- StateCalculation
- Service responsible for computing form state changes and validation
- SubmissionHandling
- Interface for managing form submission operations
- SubmissionHandlingResult
- Result of form submission operation
- SubmissionHandlingState
- State of form submission
-
SwitchValidator<
T> - A validator that applies different validation rules based on multiple conditions.
- TypedCheckbox
- A pre-built checkbox widget that integrates with typed form validation.
- TypedCommonValidators
- A collection of commonly used validators with built-in localization support.
-
TypedConditionalValidator<
T> - A validator that applies validation rules conditionally based on predicates.
- TypedConditionalValidators
- Common conditional validators with built-in logic.
-
TypedCrossFieldValidator<
T> - A validator that validates a field based on the values of other fields.
- TypedCrossFieldValidators
- Common cross-field validators with built-in localization support.
- TypedDatePicker
- A pre-built date picker widget that integrates with typed form validation.
-
TypedDropdown<
T> - A pre-built dropdown widget that integrates with typed form validation.
-
TypedFieldWrapper<
T> - A high-performance universal wrapper widget that provides form validation integration for any type of form field widget. This widget extracts the common pattern used across all form fields for state management, validation, and error handling with optimized rebuilds and listener support.
- TypedFormBuilder
- A widget that rebuilds when the form state changes.
- TypedFormController
- Form cubit with type-safe state access
- TypedFormListener
- A widget that listens to form state changes without rebuilding.
- TypedFormProvider
- A widget that provides form state management to its descendants.
- TypedFormState
- TypedSlider
- A pre-built slider widget that integrates with typed form validation.
- TypedSwitch
- A pre-built switch widget that integrates with typed form validation.
- TypedTextField
- A pre-built text input widget that integrates with typed form validation.
- TypedTimePicker
- A pre-built time picker widget that integrates with typed form validation.
- ValidationCoordination
- Interface for orchestrating form validation operations
- ValidationCoordinationResult
- Result of validation orchestration
- ValidationDebounce
- Service responsible for debounced form validation
-
Validator<
T> - Base validator interface with generic type support
- ValidatorLocalizations
- Abstract class that defines the interface for validator localizations.
- ValidatorLocalizationsDelegate
- A LocalizationsDelegate for ValidatorLocalizations.
Enums
- FormSubmissionResult
- Result of form submission
- ValidationStrategy
- Enum representing the available form validation strategies
Extensions
-
FormFieldDefinitionPatterns
on FormFieldDefinition<
T> - Adds pattern-matching-related methods to FormFieldDefinition.
- TypedFormProviderExtension on BuildContext
- Extension methods for easier form access.
- TypedFormStatePatterns on TypedFormState
- Adds pattern-matching-related methods to TypedFormState.
Exceptions / Errors
- FormFieldError
- Custom error class for form field errors with helpful suggestions and debug information.