flutter_clean_mvvm_toolkit library
Flutter Clean MVVM Toolkit
A comprehensive Flutter toolkit for implementing Clean Architecture with MVVM pattern. Provides foundational components for building scalable and maintainable Flutter applications.
Features
- Clean Architecture base components (Entity, UseCase, StreamUseCase)
- Error Handling system (ErrorItem, ErrorCode, ErrorLevelEnum)
- MVVM ViewModels base classes for CRUD operations
- Form Management with type-safe state handling
- Operation Results for success/failure tracking
Usage
import 'package:flutter_clean_mvvm_toolkit/flutter_clean_mvvm_toolkit.dart';
Classes
-
CrudViewModel<
T extends Entity> - ViewModel para operaciones CRUD sobre entidades.
- DataUtils
- Clase de utilidades para manejar conversiones de tipos dinámicos.
-
DefaultEntityForm<
T extends Entity, VM extends EntityFormViewModel< T> > - Widget base abstracto para formularios de entidades.
- DefaultFormViewModel
- Mixin class que provee funcionalidad básica para formularios
- Entity
- Clase base abstracta para todas las entidades del dominio.
-
EntityFormViewModel<
T extends Entity> - ViewModel abstracto para formularios de entidades.
- ErrorItem
- Un modelo que representa un error estructurado en el dominio de la aplicación.
- FormValidators
- Clase de utilidad para validaciones comunes de formularios que retornan String?.
- Model
- Clase base para todos los modelos de datos.
- NoParams
- Clase para casos de uso que no requieren parámetros.
- OperationFailure
- Clase de conveniencia para errores (mantenida por compatibilidad).
-
OperationResult<
T> - Representa el resultado de una operación en la capa de presentación.
- OperationSuccess
- Clase de conveniencia para mensajes de éxito (mantenida por compatibilidad).
-
StreamUseCase<
Type, Params> - Clase abstracta base para Casos de Uso que retornan un Stream.
-
UseCase<
Type, Params> - Clase abstracta base para Casos de Uso que retornan un Future.
- Validators
- Clase de utilidad para validaciones avanzadas que retornan ErrorItem.
Enums
- ErrorCode
- ErrorLevelEnum
- Nivel de severidad de un error, determinando cómo debe ser manejado en la UI o lógica.
- FormType
- Enum que define los tipos de operación de formularios
Mixins
- OperationResultMixin
- Mixin para gestionar y notificar resultados de operaciones en los ViewModels.
Extensions
- ErrorLevelEnumExtension on ErrorLevelEnum
- Extensión para obtener propiedades útiles del ErrorLevelEnum.
Constants
- defaultErrorItem → const ErrorItem
- Instancia por defecto de ErrorItem que representa un error genérico desconocido.