dire_di_flutter 2.4.2

A Spring-like dependency injection framework for Dart with code generation for Flutter compatibility.

2.4.2

• Bug Fix Interface DI: bug fixing for implementaiton injection

2.4.1

• Easier to get Dire Container: Added static to get DireContainer via mixin

2.4.0

🚀 Major Flutter Integration Improvements

New Simplified Initialization API

• Callback Support: DiCore.initialize() now accepts an optional callback for dependency registration
• One-Line Setup: await DiCore.initialize((container) => container.registerGeneratedDependencies())
• Cleaner Main Function: Simplified Flutter app initialization pattern

Enhanced Mixin Names for Better Readability

• DiCore: Renamed from DireDiMixin for concise, clear naming
• DiMixin: Renamed from DI for better descriptiveness of auto-generated convenience properties
• Consistent Naming: All class names now follow Di* pattern for better recognition

Improved Flutter Widget Integration

• Better Error Messages: Enhanced get<T>() error messages with clear solutions
• Async Patterns: Comprehensive documentation for proper async initialization in widgets
• Loading State Handling: Best practices for managing loading states in Flutter widgets

Comprehensive Documentation & Examples

• Flutter Convenience Example: New detailed example showing all usage patterns
• Best Practices Guide: Clear DO/DON'T guidelines for Flutter integration
• Error Resolution: Solutions for common Flutter widget mounting exceptions

File Structure Improvements

• Builder Renaming: mirrors_free_builder.dart → dire_di_builder.dart for clarity
• Class Renaming: MirrorsFreeAggregatingBuilder → DireDiAggregatingBuilder
• Consistent Naming: All generator files now follow consistent naming patterns

🔧 Technical Improvements

• Fixed Flutter widget mounting exceptions during async DI initialization
• Enhanced container lifecycle management for Flutter apps
• Improved error handling for synchronous dependency access
• Better type safety in callback functions

📖 Migration Guide

Before (v2.3.1):

void main() async {
  await DireDiMixin.initialize();
  final container = DireContainer();
  await container.scan();
  container.registerGeneratedDependencies();
  runApp(MyApp());
}

class _MyState extends State<MyWidget> with DireDiMixin, DI {
  // ...
}

After (v2.4.0):

void main() async {
  await DiCore.initialize((container) => container.registerGeneratedDependencies());
  runApp(MyApp());
}

class _MyState extends State<MyWidget> with DiCore, DiMixin {
  // ...
}

2.3.1

🎯 Improved Developer Experience

• Concise Mixin Name: Renamed DireDiConvenienceMixin to simply DI for better readability
• Cleaner Syntax: Use with DireDiMixin, DI instead of the longer mixin name
• Better Documentation: Updated all examples and error messages to use the shorter name

2.3.0

🎉 New Flutter Integration

• DireDiMixin: New mixin for easy Flutter StatefulWidget integration
• Automatic Container Management: No need to manually create DireContainer instances
• Sync and Async API: get<T>() for immediate access, getAsync<T>() for auto-initialization
• Global Container: Single container instance shared across all widgets
• Type Safety: Full generic type support with compile-time checking
• Flutter Optimized: Designed specifically for StatefulWidget states

� Auto-Generated Convenience Properties

• DI Mixin: Auto-generated mixin with direct property access
• Zero Boilerplate: Direct userService access instead of get<UserService>()
• IDE Integration: Full auto-completion and refactoring support
• Type Safety: Compile-time checking for all generated properties
• Async Variants: Both userService and userServiceAsync for each component
• Clean UI Code: Eliminates DI syntax completely from widget code

�📱 Flutter Developer Experience

• Zero Boilerplate: Add with DireDiMixin, DI and access dependencies directly
• Convenient Methods: has<T>(), getAll<T>(), register<T>(), hasAsync<T>()
• Qualifier Support: Named instances via get<T>('name') and getAsync<T>('name')
• Error Handling: Graceful handling of uninitialized containers
• Testing Support: DireDiMixin.reset() for test isolation

2.2.0

🎉 Major Features

• Consolidated Code Generation: New @DireDiEntryPoint annotation allows consolidating all DI registrations into a single file
• Multi-File Support: Components can now be spread across multiple files and automatically discovered
• Single Registration Call: registerGeneratedDependencies() only needs to be called once from the entry point
• Aggregating Builder: New builder scans entire project and generates consolidated registration code
• Improved Developer Experience: No more managing multiple .dire_di.dart files

🚀 Mobile Platform Support

• Mirrors-Free by Default: Main dire_di_generator is now mirrors-free and mobile compatible
• Flutter/Android/iOS Compatible: Generated code runs on all Flutter platforms without restrictions
• Build-Time Only Dependencies: Code analysis happens only during build, not at runtime
• Single Builder: Eliminated builder conflicts - only one active builder by default

🔧 Technical Improvements

• Renamed Builders: Main builder is now dire_di_generator (was di_mirrors_free_generator)
• Conflict Resolution: Fixed "Potential outputs must be unique" error by making legacy builders opt-in only
• Added MirrorsFreeAggregatingBuilder for mobile platform compatibility
• Enhanced import path resolution for better generated code
• Improved dependency ordering in generated registrations
• Better error handling and logging during code generation

🚨 Breaking Changes

• Builder Names: Main builder renamed from di_mirrors_free_generator to dire_di_generator
• Auto-Apply: Legacy di_generator is now opt-in only (auto_apply: none)
• Default Behavior: Package now uses mirrors-free generation by default

📚 Documentation

• Updated examples to demonstrate multi-file usage
• Added comprehensive documentation for @DireDiEntryPoint
• Improved README with new usage patterns
• Added explanation of mirrors-free approach for mobile platforms
• Added explanation of mirrors-free approach for mobile platforms

🚀 Migration Guide

Before (multiple files):

// Each file had its own .dire_di.dart
import 'service1.dire_di.dart';
import 'service2.dire_di.dart';

container.registerGeneratedDependencies(); // Multiple calls needed

After (consolidated):

@DireDiEntryPoint()
class AppModule {}

import 'app_module.dire_di.dart';
container.registerGeneratedDependencies(); // Single call!

📱 Mobile Platform Notes

This package now fully supports Android/iOS through mirrors-free code generation. The dart:mirrors dependency only exists during build time for legacy builders. The default di_mirrors_free_generator produces code that runs without any mirrors dependency on mobile platforms.

---

1.0.0

• Spring-like dependency injection for Dart
• Auto-wiring with @Autowired annotation
• Component annotations: @Service, @Repository, @Component, @Controller
• Configuration support with @Configuration and @Bean
• Qualifier support for disambiguation
• Singleton and Prototype scopes
• Profile-based conditional registration
• Property and class-based conditionals
• Automatic component scanning using dart:mirrors
• Field injection support
• Constructor injection support
• Circular dependency detection
• Bean lifecycle management