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.