Documentation #

• Parameter Syntax Fix: Corrected all documentation examples to use :param syntax instead of {param} syntax
• JSON Examples: Fixed translation file examples to show proper parameter placeholders
• Consistency: Ensured all examples use the correct :name, :count, :min, :max syntax

Features #

• Enhanced Pluralization: Improved ICU MessageFormat pluralization logic to properly handle zero, singular, and plural cases
• Zero Case Support: Added support for zero-count pluralization (e.g., "no apples" when count = 0)
• Example Updates: Updated translation files and example app to demonstrate proper pluralization

Technical Details #

• Fixed critical documentation error where parameter interpolation syntax was incorrectly shown
• Enhanced pluralization handler to support "zero | singular | plural" format
• Updated example app slider to start from 0 to demonstrate zero case
• All examples now correctly demonstrate the :param syntax used by the package

Documentation #

• README Improvements: Fixed broken JSON examples in translation file documentation
• Content Cleanup: Removed duplicate Performance section and improved formatting
• Example Corrections: Fixed incomplete code blocks and improved readability

Technical Details #

• Cleaned up README.md with proper JSON formatting
• Removed duplicate content sections
• Improved documentation structure and consistency

Changed #

• Code Formatting: Applied consistent Dart code formatting across all source files
• Documentation: Updated inline documentation and comments for better readability

Technical Details #

• Ran dart format on entire codebase for consistent styling
• Improved code documentation and formatting
• Maintained all existing functionality while improving code quality

Fixed #

• Package Description: Shortened description to meet pub.flutter-io.cn requirements (60-180 characters)
• Deprecated API Usage: Replaced deprecated ui.window.locales with WidgetsBinding.instance.platformDispatcher.locales
• Static Analysis: Fixed lint warnings for deprecated member usage
• Pub Points: Improved package score from 140 to target 160 points

Technical Details #

• Updated locale detection to use modern Flutter APIs
• Improved package metadata for better pub.flutter-io.cn presentation
• Maintained backward compatibility while fixing deprecation warnings

Fixed #

• Supported Locales Parameter: Fixed supportedLocales parameter in initialize() method to properly configure allowed locales
• Localization Delegate: Fixed FlutterLocaleMasterDelegate.isSupported() to use configured supported locales instead of auto-detected ones
• Locale Validation: Resolved warnings about unsupported locales in MaterialApp integration
• Example App: Updated example app to properly use supported locales configuration

Technical Details #

• Delegate now respects the supportedLocales parameter passed to initialize()
• Fixed locale validation warnings when using Arabic and other RTL locales
• Improved integration with Flutter's localization system

Added #

• Multi-file Translation Support: Organize translations with multiple JSON files per locale
• Namespace-based Organization: Automatic namespace detection from file names
• Locale-specific General Files: Use locale code as filename for default namespace (e.g., en.json, ar.json)
• Field Translation Support: Dedicated fields.json files with .field() extension method
• Validation Message Support: Dedicated validation.json files for form validation
• Automatic Text Direction Switching: Framework-level RTL/LTR handling based on locale
• Asset-based Translation Loading: Load translations from Flutter assets with preloading
• Reactive Locale Management: LocaleController with ChangeNotifier for automatic UI updates
• Custom Widgets: TranslatedText, TranslatedRichText, LocaleConsumer, LocalizationProvider
• BuildContext Extensions: Convenient translation methods (tr, plural, field, isRTL, locale)
• String Extensions: Context-free translation access using FlutterLocaleMaster.instance
• Pluralization Support: Built-in plural forms with count parameter and ICU MessageFormat
• Parameter Replacement: Dynamic text substitution with named placeholders
• Flutter Integration: Custom LocalizationsDelegate for MaterialApp integration
• Service Layer Architecture: Modular design with interfaces for all core services
• Translation Caching: In-memory caching with concurrent loading for optimal performance
• Comprehensive Testing: Unit and widget tests for all major components (28 tests)
• Example Application: Complete demo with English, French, and Arabic support

Technical Details #

• Dependencies: flutter_localizations (Flutter SDK)
• Flutter SDK: >=1.17.0
• Dart SDK: >=3.8.1
• Platform Support: iOS, Android, Web, Desktop
• Architecture: Clean architecture with services, providers, controllers, widgets, and extensions
• File Structure: lang/{locale}/{namespace}.json (e.g., lang/en/en.json, lang/en/fields.json)
• Namespace Support: Automatic namespace resolution from filename
• RTL Languages: Full support for Arabic, Hebrew, Persian, Urdu, and other RTL scripts

• Initial release with basic localization functionality.