Added #

• 🎯 Dual Localization Method Support: Choose between Flutter's built-in gen-l10n or intl_utils package
• 🤖 Intelligent Auto-Detection: Automatically detects existing localization setup and chooses the appropriate method
• 📝 Auto-Configuration: Automatically creates l10n.yaml or configures pubspec.yaml based on chosen method
• 🔧 Method Selection: New --l10n_method parameter to explicitly choose between gen-l10n and intl_utils
• 💾 Preference Persistence: Saves user's localization method choice in pubspec.yaml for future runs
• ✅ Auto-Approve Option: New --auto_approve flag to automatically approve configuration changes

Enhanced #

• 🧠 Smart Method Detection: Automatically detects:
  • Existing l10n.yaml file → Uses gen-l10n
  • Existing intl_utils dependency or flutter_intl config → Uses intl_utils
  • Saved preference in pubspec.yaml → Uses saved method
  • No setup found → Prompts user to choose (or defaults to intl_utils with --auto_approve)
• 🔄 Flutter gen-l10n Integration: Full support for Flutter's official localization solution
• 📋 Interactive Setup: User-friendly prompts when no existing setup is detected
• 🛡️ Safe Configuration: Asks for permission before modifying project files (unless auto-approved)

Technical Details #

• New Command Options:
  • --l10n_method: Choose between gen-l10n or intl_utils
  • --auto_approve: Automatically approve configuration changes
• Auto-Configuration Features:
  • Creates l10n.yaml with proper paths and class names for gen-l10n
  • Adds intl_utils dependency and flutter_intl config for intl_utils
  • Preserves existing file formatting and comments
• Intelligent Detection Logic: Comprehensive project analysis to determine the best localization method

Usage Examples #

# Auto-detect and configure (interactive)
smart_arb_translator --source_dir lib/l10n --api_key api_key.txt --language_codes es,fr --generate_dart

# Force specific method
smart_arb_translator --source_dir lib/l10n --api_key api_key.txt --language_codes es,fr --generate_dart --l10n_method gen-l10n

# Auto-approve configuration changes
smart_arb_translator --source_dir lib/l10n --api_key api_key.txt --language_codes es,fr --generate_dart --auto_approve

Added #

• 🎉 Initial release of Smart ARB Translator
• ✨ Smart Change Detection: Only translates modified or new content
• 🏗️ Modular Architecture: Refactored into clean, maintainable modules
• 📁 Batch Processing: Recursive directory translation support
• 🔄 Automatic Merging: Seamless l10n directory integration
• 🎯 Manual Translation Override: Support for @x-translations metadata
• 🛠️ Flexible Output: Customizable file naming and directory structure
• 🚨 Robust Error Handling: Detailed feedback and error messages
• 📚 Comprehensive Documentation: Complete README with examples
• 🧪 Programmatic API: Use as a library in your Dart projects

Changed #

• 🔄 Package Name: Renamed from arb_translator to smart_arb_translator
• 🏗️ Architecture: Complete refactor into modular components:
  • TranslationService: Google Translate API integration
  • ArbProcessor: ARB file processing and action management
  • FileOperations: File and directory utilities
  • DirectoryProcessor: Batch directory processing
  • SingleFileProcessor: Individual file processing with change detection
  • ArbTranslatorArgumentParser: Command-line argument handling
  • ConsoleUtils: Console output utilities
• 🎨 CLI Interface: Improved command-line experience
• 📦 Dependencies: Updated to latest package versions

Enhanced #

• 🧠 Intelligence: Smart detection of changes to minimize API calls
• ⚡ Performance: Optimized processing for large projects
• 🔧 Maintainability: Clean separation of concerns
• 📖 Documentation: Comprehensive guides and examples
• 🎯 User Experience: Better error messages and feedback

Technical Details #

• Minimum Dart SDK: 3.0.1
• Dependencies: Updated all dependencies to latest versions
• Architecture: Modular design with clear separation of concerns
• Testing: Foundation for comprehensive test coverage
• Documentation: Complete API documentation and usage examples

Migration from arb_translator #

If you're migrating from the original arb_translator package:

1. Update pubspec.yaml:

   dev_dependencies:
     smart_arb_translator: ^1.0.0  # instead of arb_translator
   

2. Update command usage:

   smart_arb_translator  # instead of pub run arb_translator:translate
   

3. Argument changes:

   • --append-lang-code / --no-append-lang-code (instead of --append_lang_code)
   • All other arguments remain the same

4. New features available:

   • Smart change detection (automatic)
   • Improved error handling
   • Better performance
   • Programmatic API access

Acknowledgments #

• Originally forked from justkawal/arb_translator
• Enhanced with modern architecture and smart features
• Built for the Flutter community

Note: This is the first release of Smart ARB Translator as a standalone package. Future releases will follow semantic versioning with detailed changelogs.