l10n_countries

• refactor(ci): update deploy permissions and steps for gh pages

• Changed permissions for contents to read.
• Added environment name for GitHub Pages deployment.
• Updated deployment steps to use actions/upload-pages-artifact and actions/deploy-pages.

• chore(deps): update flutter sdk version to ^3.44.5

• Updated the flutter sdk version in pubspec.yaml for the example app.
• Updated sdk version in tools/pubspec.yaml to ^3.12.2.

TEST

• Integrated dartdoc_test validation for code samples in documentation comments.

DOCUMENTATION

• Fixed the CountriesLocaleMapper.localize example code snippet to instantiate the mapper.

DOCUMENTATION

Docs only, no code changes:

• Added FOSSA status badge to the README.

DOCUMENTATION

Docs only, no code changes:

• Improved CHANGELOG for clarity.
• Added LLM agent instructions to the README.

🎉 Third anniversary and new major release!

NEW FEATURES

• L10N values are now provided in sentence case!
• Tree-shakable via dart define flags.
• Optimized memory usage with lazy locale initialization - translations are now loaded on-demand instead of all at once.
• Reduced initial memory footprint by ~90% - only requested locales are instantiated.
• Added availableLocales getter to query all supported locales without materializing them.
• Single-use design: Mapper instances automatically free memory after localize() is called and cannot be reused. This ensures optimal memory efficiency - create a new instance if you need to localize again.

BREAKING CHANGES

• Single-use design: Mapper instances automatically free memory after localize() is called and cannot be reused. This ensures optimal memory efficiency - create a new instance if you need to localize again.

Previously, localized strings were provided in mixed lowercase (e.g., "islas Malvinas", in Spanish for FLK code) and sentence case. They are now unified and provided in sentence case only (e.g., "Islas Malvinas", in Spanish for FLK code) to preserve capitalization context for proper nouns and ensure immediate compatibility with independent UI labels.

Justification: Capitalization is context-sensitive and cannot be reliably reconstructed from lowercase source strings. By providing values in sentence case, we ensure high-fidelity data for headers and labels. This was also part of discussion in the past.

Migration:

• If you use these values as standalone labels, no action is required (you can also remove your formatter callback, if not needed).
• If you require mid-sentence (inline) text, use the formatter callback to strictly adapt the casing, rather than relying on direct string manipulation.

final localized = mapper.localize(
  isoCodes,
  mainLocale: locale,
  formatter: (_, l10n) => l10n.toLowerCase(), // <-- e.g., inline usage
);

CHORE

• The Dart SDK was bumped to v3.10.4.
• Updated Indonesian country translations.

CHORE

• Lower Dart SDK constraint from ^3.9.2 to ^3.9.0
• Enable and fix 10 new Dart Code Metrics rules (from the 1.32.0: October Update)

FIX

• Corrected Slovak country name for CIV to "Pobrežie Slonoviny".

DOCUMENTATION

• Improved documentation in README.

CHORE

• The Dart SDK was bumped to v3.9.2.

FIX

• Corrected Welsh official country name for Curaçao.
• Corrected Korean localization for British Indian Ocean Territory, Dominica, Mongolia, Wallis and Futuna and South Georgia.

CHORE

• The Dart SDK was bumped to v3.8.1.
• Update German and English translations.

NEW FEATURES

• Add formatter callback for custom translation logic.
• Add official country translations for the Indonesian language.

CHORE

• The Dart SDK was bumped to v3.8.0.
• Code has been formatted with the new Dart formatter.

DOCUMENTATION

• Improved documentation in README.

🎉 First stable release!

DOCUMENTATION

• Improved documentation and example.
• Removed duplicated localization.
• Fixed typos in the README.

• Initial release.