namespace BaseGames.Localization
{
    /// <summary>
    /// 本地化资源路径 / Addressable 地址的唯一真相源。
    ///
    /// 运行时与编辑器工具的所有路径、地址都必须经此类构造，禁止再硬编码
    /// "Assets/_Game/Data/Localization" 或 "Localization/{lang}/{table}" 字符串。
    ///
    /// 设计要点：
    /// - 纯静态、无 UnityEditor 依赖，放运行时 asmdef（<c>BaseGames.Localization</c>），
    ///   使运行时加载（<see cref="LocalizationManager"/>）与编辑器工具共用同一套路径逻辑。
    /// - 物理 JSON 路径（<see cref="AssetPath"/>）供编辑器直读 / 写盘；
    ///   Addressable 地址（<see cref="Address"/>）供运行时 <c>AssetLoader</c> 加载。
    /// </summary>
    public static class LocalizationPaths
    {
        /// <summary>本地化 JSON 数据根目录（项目资产相对路径）。</summary>
        public const string DataRoot = "Assets/_Game/Data/Localization";

        /// <summary>CSV 导入导出目录（供 Excel 往返）。</summary>
        public const string ExportRoot = "Assets/_Game/Localization/Export";

        /// <summary>指定语言的子目录，如 <c>Assets/_Game/Data/Localization/English</c>。</summary>
        public static string LanguageFolder(Language language) => $"{DataRoot}/{language}";

        /// <summary>指定语言 + 表的 JSON 资产路径。</summary>
        public static string AssetPath(Language language, string table)
            => $"{DataRoot}/{language}/{table}.json";

        /// <summary>
        /// 指定语言 + 表的 Addressable 地址（运行时加载用）。
        /// 必须与 <see cref="AssetPath"/> 指向的文件注册的地址一致。
        /// </summary>
        public static string Address(Language language, string table)
            => $"Localization/{language}/{table}";

        /// <summary>指定表的 CSV 导出路径。</summary>
        public static string CsvPath(string table) => $"{ExportRoot}/{table}.csv";
    }
}