feat: 添加国际化支持，包含文化变更事件、资源提供者和本地化字符串结构

i18n/Aurora.I18N.Abstractions/Aurora.I18N.Abstractions.csproj

@@ -0,0 +1,10 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net9.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <NoWarn>IDE0130</NoWarn>
+  </PropertyGroup>
+
+</Project>

i18n/Aurora.I18N.Abstractions/CultureChangedEventArgs.cs

@@ -0,0 +1,15 @@
+using System.Globalization;
+
+namespace Aurora.I18N;
+
+/// <summary>
+/// 文化变更事件参数
+/// </summary>
+public sealed class CultureChangedEventArgs(CultureInfo oldCulture, CultureInfo newCulture) : EventArgs
+{
+    public CultureInfo OldCulture { get; }
+        = oldCulture ?? throw new ArgumentNullException(nameof(oldCulture));
+
+    public CultureInfo NewCulture { get; }
+        = newCulture ?? throw new ArgumentNullException(nameof(newCulture));
+}

i18n/Aurora.I18N.Abstractions/ICultureProvider.cs

@@ -0,0 +1,24 @@
+using System.Globalization;
+
+namespace Aurora.I18N;
+
+public interface ICultureProvider
+{
+    /// <summary>
+    /// 当前用于数值、日期等格式化的文化
+    /// 通常对应 <see cref="CultureInfo.CurrentCulture"/>
+    /// </summary>
+    CultureInfo CurrentCulture { get; }
+
+    /// <summary>
+    /// 当前用于 UI 文本的文化
+    /// 通常对应 <see cref="CultureInfo.CurrentUICulture"/>
+    /// </summary>
+    CultureInfo CurrentUICulture { get; }
+
+    /// <summary>
+    /// 当当前文化发生变化时触发，用于通知 UI 或其它监听方刷新
+    /// </summary>
+    event EventHandler<CultureChangedEventArgs>? CultureChanged;
+}
+

i18n/Aurora.I18N.Abstractions/IPluralizer.cs

@@ -0,0 +1,6 @@
+namespace Aurora.I18N;
+
+/// <summary>
+/// 关于
+/// </summary>
+public interface IPluralizer;

i18n/Aurora.I18N.Abstractions/IResourceProvider.cs

@@ -0,0 +1,25 @@
+using System.Globalization;
+
+namespace Aurora.I18N;
+
+/// <summary>
+/// 按 key 和文化提供本地化字符串的读取接口
+/// </summary>
+public interface IResourceProvider
+{
+    /// <summary>
+    /// 按键名和文化获取本地化字符串，缺失时返回 null
+    /// </summary>
+    /// <param name="key">资源键名</param>
+    /// <param name="culture">目标文化信息</param>
+    string? GetString(string key, CultureInfo culture);
+
+    /// <summary>
+    /// 获取指定文化下的全部键值对，可选包含父文化
+    /// </summary>
+    /// <param name="culture">目标文化信息</param>
+    /// <param name="includeParentCultures">是否同时包含父文化的资源</param>
+    IEnumerable<KeyValuePair<string, string>> GetAllStrings(
+        CultureInfo culture,
+        bool includeParentCultures);
+}

i18n/Aurora.I18N.Abstractions/ITextLocalizer.cs

@@ -0,0 +1,46 @@
+namespace Aurora.I18N;
+
+/// <summary>
+/// 泛型本地化接口，返回类型化结果并兼容基础本地化访问
+/// </summary>
+/// <typeparam name="T">本地化结果的泛型类型</typeparam>
+public interface ITextLocalizer<out T> : ITextLocalizer { }
+
+
+/// <summary>
+/// 定义文本本地化的统一访问接口，支持通过键名获取格式化后的字符串
+/// </summary>
+public interface ITextLocalizer
+{
+    /// <summary>
+    /// 根据键名获取本地化字符串，未找到时通常返回键名自身
+    /// </summary>
+    /// <param name="key">资源键名</param>
+    string this[string key] { get; }
+
+    /// <summary>
+    /// 根据键名获取可格式化的本地化字符串，并应用提供的格式参数
+    /// </summary>
+    /// <param name="key">资源键名</param>
+    /// <param name="arguments">格式化占位符对应的参数</param>
+    string this[string key, params object[] arguments] { get; }
+
+    /// <summary>
+    /// 返回包含查找状态信息的本地化结果
+    /// </summary>
+    /// <param name="key">资源键名</param>
+    LocalizedString Get(string key);
+
+    /// <summary>
+    /// 返回格式化后的本地化结果，并附带查找状态信息
+    /// </summary>
+    /// <param name="key">资源键名</param>
+    /// <param name="arguments">格式化占位符对应的参数</param>
+    LocalizedString Get(string key, params object[] arguments);
+
+    /// <summary>
+    /// 获取当前文化（可选包含父文化）下的全部本地化字符串
+    /// </summary>
+    /// <param name="includeParentCultures">是否同时包含父文化的资源</param>
+    IEnumerable<LocalizedString> GetAllStrings(bool includeParentCultures);
+}

i18n/Aurora.I18N.Abstractions/LocalizedString.cs

@@ -0,0 +1,40 @@
+namespace Aurora.I18N;
+
+/// <summary>
+/// 表示一个本地化文本项，包含键名、值以及查找状态等信息。
+/// </summary>
+/// <param name="name">资源键名，通常用于回退显示或继续查询</param>
+/// <param name="value">本地化后的字符串，若查找失败则可能为 null</param>
+/// <param name="resourceNotFound">指示是否未找到对应资源</param>
+/// <param name="searchedLocation">记录查找资源时检索过的位置，便于调试</param>
+public readonly struct LocalizedString(
+    string name,
+    string? value,
+    bool resourceNotFound,
+    string? searchedLocation = null)
+{
+    /// <summary>
+    /// 本地化资源的键名
+    /// </summary>
+    public string Name { get; } = name;
+
+    /// <summary>
+    /// 匹配到的本地化文本，若未找到则保持为空
+    /// </summary>
+    public string? Value { get; } = value;
+
+    /// <summary>
+    /// 标记是否未找到对应资源，调用方可据此决定是否回退或记录日志
+    /// </summary>
+    public bool ResourceNotFound { get; } = resourceNotFound;
+
+    /// <summary>
+    /// 描述资源查找的来源或搜索路径，便于排查缺失问题
+    /// </summary>
+    public string? SearchedLocation { get; } = searchedLocation;
+
+    /// <summary>
+    /// 返回本地化值，如果缺失则回退到键名，保证调用方总能得到可显示内容
+    /// </summary>
+    public override string ToString() => Value ?? Name;
+}

i18n/i18n.slnx

@@ -0,0 +1,3 @@
+<Solution>
+  <Project Path="Aurora.I18N.Abstractions/Aurora.I18N.Abstractions.csproj" Id="fef1ac5d-fbd2-456b-a529-ec3996f856c7" />
+</Solution>