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);
}