entityfy_generator 2.1.0

entityfy_generator: ^2.1.0 copied to clipboard

Summary #

This minor release introduces fake data generation capabilities and copyWith method generation, along with enhanced code generation features and improved package metadata for better developer experience.

Added #

• 🧪 Fake Data Generation: New support for generateFakeList parameter to create static mock data methods within Entity classes
• 🔄 CopyWith Methods: Automatic generation of copyWith() methods for both Entity and UI Model classes
• 📊 Testing Support: Static fakeList(count: int) methods for creating realistic test data with configurable count
• 🔧 Enhanced Generator Logic: Extended generator to handle three boolean configuration flags simultaneously

Improved #

• 📝 Enhanced Documentation: Comprehensive examples showcasing fake data generation and copyWith usage
• 📦 Package Metadata: Updated description and metadata for better discoverability on pub.flutter-io.cn
• 🎯 Code Generation Quality: Improved generated code structure and organization
• 🛡️ Type Safety: Enhanced type handling for complex nested structures in copyWith methods
• 📚 Example Showcase: Updated example project with comprehensive fake data demonstrations

Summary #

This patch release focuses on stability improvements, enhanced type safety, and better code generation quality. Includes performance optimizations and bug fixes that improve the overall developer experience when working with the Entityfy generator.

Fixed #

• 🐛 Null Safety Enhancement: Improved nullable type handling in generated mapper methods
• 🔧 Code Generation Optimization: Enhanced performance of the build process for large projects
• 📝 Better Error Messages: More descriptive error messages during code generation failures
• 🎯 Type Casting Precision: Refined automatic type casting for complex nested structures

Improved #

• ⚡ Build Performance: Faster code generation with optimized AST analysis
• 🛡️ Validation Logic: Enhanced validation of input model structures
• 📚 Documentation: Updated inline documentation for generated methods
• 🧹 Code Quality: Cleaner generated code with improved formatting and organization

Added #

• 🎯 Dual Model Generation: Complete support for generating both Entity classes and UI Model classes from a single annotation
• 📝 Comprehensive Class Generation: Auto-generates complete classes with constructors, fromJson(), and toJson() methods
• 🔄 Bidirectional Mapping: Support for both toEntity() and toUiModel() mapper extensions
• ⚙️ Flexible Configuration: New @Entityfy annotation with boolean flags for generateEntity and generateUiModel
• 🏗️ Combined Generator Architecture: Unified code generation in a single file with .entityfy.g.dart extension
• 🔍 Smart Naming Convention: Automatic class naming (CustomerModel → CustomerEntity + CustomerUiModel)
• 📊 Enhanced Type Conversion: Intelligent type mapping for nested models, lists, and complex data structures
• 🛡️ Type Safety: Full compile-time type checking and validation

Features #

• Sequential generation of Entity classes, UI Model classes, and their respective mappers
• Support for DateTime serialization with ISO8601 format
• Proper nullable type handling throughout the generation process
• Enhanced List type support with element type casting
• Deep nested model support with automatic toEntity() and toUiModel() calls
• Comprehensive constructor parameter analysis and mapping

Breaking Changes #

• Replaced multiple individual annotations with unified @Entityfy annotation
• Changed file extension from individual generators to combined .entityfy.g.dart
• Updated API to use boolean flags instead of separate annotation classes

Added #

• Nested Model Support: Automatic conversion of nested models annotated with @EntityMapper by calling their toEntity() methods
• List Support: Complete handling of List<T> where T is an annotated model, automatically applying .map((e) => e.toEntity()).toList()
• Smart Type Detection: Intelligent differentiation between primitive types, nested models, and lists for appropriate conversion strategies
• Constructor Analysis: Deep examination of entity constructor parameters to ensure correct field mapping

Features #

• Generates clean, readable code with organized extension methods
• Build-time code generation with zero runtime dependencies
• Type-safe mapping with compile-time verification
• Support for complex nested data structures

Changed #

• Updated dependencies in pubspec.yaml, aligning with the latest versions of source_gen, build, and analyzer
• Refactored mapper_generator.dart to utilize updated element classes, enhancing compatibility with the new API structure

• Initial version.