orion-ecs / keen-eye / 20727958385

65%

push

github

feat: Implement core LocalizationPlugin with key-value JSON support

Add a complete localization system for multi-language support:

Core types:
- Locale readonly record struct for language tags (e.g., "en-US", "ja-JP")
- LocalizationConfig for DefaultLocale, MissingKeyBehavior, FallbackOverrides
- ILocalization interface with Get(), Format(), SetLocale()
- IStringSource interface for pluggable translation sources

Implementation:
- LocalizationPlugin as the main entry point
- LocalizationManager (exposed via world.Localization extension)
- JsonStringSource for loading translations from JSON files
- DictionaryStringSource for in-memory translations

UI integration:
- LocalizedText component to mark entities for auto-translation
- LocalizedTextTag for efficient querying
- LocalizedTextSystem to update UIText when locale changes

Features:
- Fallback chain: current locale -> custom override -> language-only -> default
- Format string support with {0}, {1} placeholders
- Configurable missing key behavior (return key, empty, placeholder, throw)
- Thread-safe source management

Closes #632

5689 of 7334 branches covered (77.57%)

Branch coverage included in aggregate %.

36260 of 49153 relevant lines covered (73.77%)

1.06 hits per line