Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

JsonLocalizationRegistryBuilder.LoadFromJson convenience method for loading raw JSON strings directly on the builder without bypassing it
Circular reference detection in LocalizationFormatter — nested ILocalizable cycles now throw LocalizationFormattingException instead of causing a StackOverflowException

Breaking: JsonLocalizationRegistryBuilder is now single-use — calling Build() marks the builder as consumed; subsequent Build() or AddFrom* calls throw InvalidOperationException
DI registration pattern replaced: AddLocalization no longer scans ServiceDescriptor.ImplementationInstance to find an internal configurator; instead, each call registers an individual action wrapper collected via GetServices<> at resolution time, making it resilient to DI container decoration and shimming

LocalizationRegistryConfigurator internal class (replaced by LocalizationRegistryAction)

Recursive/nested localization — when a property value implements ILocalizable, FormatTemplate and BuildFallback now format it through the full resolution chain instead of calling ToString()
Culture propagation through nested ILocalizable formatting

FormatTemplate and BuildFallback converted from internal static to private instance methods (not part of the public API surface)

Additive AddLocalization — multiple calls now accumulate configuration delegates instead of replacing the registry; later templates override earlier ones on a per-key/per-culture basis
AddFromAssemblyTree method for scanning an assembly and all its transitive referenced assemblies with topological ordering (dependencies first, root last)
[LoggerMessage] source-generated logging throughout the library: resource loading, assembly scanning, template override warnings, and resolution chain tracing
Override detection: Warning-level log when a template key is replaced, including source descriptor for diagnostics
source parameter on LoadFromJson for tracking template origin (assembly:Name:Resource, file:path, inline)

Breaking: AddFromAssemblyResources renamed to AddFromAssembly
Breaking: AddFromLoadedAssemblies signature changed from params string[] prefixes to string[] prefixes, params string[] patterns
JsonLocalizationRegistry now accepts an optional ILogger? constructor parameter for diagnostic logging

New Bogoware.Localization.AspNetCore package — per-request culture resolution, automatic JSON response localization, and ProblemDetails support for ASP.NET Core applications
CI/CD publishing for the AspNetCore package alongside the core library

Custom exception hierarchy (LocalizationException, LocalizationConfigurationException, LocalizationSerializationException)
Struct ILocalizable support with Nullable<T> handling
JSON serialization converters for nullable struct localizable types

Initial release of Bogoware.Localization library
FQDN-keyed template system mapping Type.FullName to localized format strings with {PropertyName} placeholders
Culture fallback chain: exact culture → parent culture → invariant culture
Provider resolution chain: self → DI → registry → fallback → default format
JSON-based localization registry with embedded resource support
In-memory localization registry for testing
DI integration via IServiceCollection extension methods
Comprehensive XML documentation