namespace BaseGames.Localization
{
    /// <summary>
    /// 本地化表名常量。
    /// 所有调用 <see cref="ILocalizationService.Get"/> 或 <see cref="LocalizationManager.Get"/> 时
    /// 必须引用此类的常量，禁止直接硬编码表名字符串。
    ///
    /// 新增表时：在此追加常量，并用「BaseGames / Localization / 表格编辑器」新建同名表
    /// （自动在 Assets/_Game/Data/Localization/{Language}/ 下创建 JSON 并注册 Addressables）。
    /// </summary>
    public static class LocalizationTable
    {
        /// <summary>通用 UI 文本（按钮、标题、菜单、HUD、提示等）。</summary>
        public const string UI        = "UI";

        /// <summary>NPC 对话行与对话选项文本。</summary>
        public const string Dialogue  = "Dialogue";

        /// <summary>任务名称与描述文本。</summary>
        public const string Quest     = "Quest";

        /// <summary>法术名称与描述文本。</summary>
        public const string Spells    = "Spells";

        /// <summary>角色名称（NPC、玩家角色等）。</summary>
        public const string Character = "Character";

        /// <summary>物品名称与描述（护符、收集品等）。</summary>
        public const string Items     = "Items";

        /// <summary>技能名称与描述。</summary>
        public const string Skills    = "Skills";

        /// <summary>教程与上下文提示文本。</summary>
        public const string Tutorial  = "Tutorial";

        /// <summary>所有已定义的表名数组，供预热和审计遍历使用。</summary>
        public static readonly string[] All = { UI, Dialogue, Quest, Spells, Character, Items, Skills, Tutorial };
    }
}