l10n_languages

• 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 LanguagesLocaleMapper.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., "inglés", in Spanish for ENG code) and sentence case. They are now unified and provided in sentence case only (e.g., "Inglés", in Spanish for ENG 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.

DOCUMENTATION

• Improved documentation in README.

CHORE

• The Dart SDK was bumped to v3.9.2.

CHORE

• The Dart SDK was bumped to v3.8.1.

NEW FEATURES

• Add formatter callback for custom translation logic.

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.
• Fixed typos in the README.

• Initial release.