using BaseGames.Core.Events;
using UnityEngine;

namespace BaseGames.Quest
{
    /// <summary>
    /// 任务事件频道注册表 SO（架构 22_QuestChallengeModule §4.1）。
    /// 将 QuestManager 的 10+ 个分散事件频道字段集中到一个可复用的 ScriptableObject 中，
    /// 便于多场景共享同一套频道配置，同时减少 QuestManager Inspector 的视觉复杂度。
    ///
    /// 使用方式：
    ///   1. 创建一个 QuestEventChannelRegistry 资产（菜单：BaseGames/Quest/EventChannelRegistry）。
    ///   2. 在资产中将现有各 EventChannelSO 拖入对应字段。
    ///   3. 将资产引用填入 QuestManager 的 "事件频道注册表" 字段。
    ///   4. QuestManager 的独立频道字段将自动隐藏（通过注册表覆盖）。
    /// </summary>
    [CreateAssetMenu(menuName = "BaseGames/Quest/EventChannelRegistry", fileName = "QuestEventChannelRegistry")]
    public class QuestEventChannelRegistry : ScriptableObject
    {
        [Header("输入频道（QuestManager 监听）")]
        [Tooltip("EVT_EnemyDied：payload = enemyId（string）。敌人死亡时由战斗系统广播，驱动击败类目标进度。")]
        public StringEventChannelSO          onEnemyDied;
        [Tooltip("EVT_CollectiblePickup：payload = itemId（string）。拾取物品时广播，驱动收集类目标进度。")]
        public StringEventChannelSO          onCollectiblePickup;
        [Tooltip("EVT_SceneLoaded：payload = sceneName（string）。场景切换完成时广播，驱动到达类目标进度。")]
        public StringEventChannelSO          onSceneLoaded;
        [Tooltip("EVT_NpcDialogueCompleted：payload = npcId（string）。DialogueManager 播完一段对话后广播，驱动对话类目标进度。")]
        public StringEventChannelSO          onNpcDialogueCompleted;
        [Tooltip("EVT_SkillUsed：payload = AbilityType.ToString()（string）。玩家使用技能时广播，驱动技能使用类目标进度。")]
        public StringEventChannelSO          onSkillUsed;
        [Tooltip("EVT_AreaReached：payload = markerTag（string）。TriggerZone 在玩家进入时广播，驱动区域到达类目标进度。")]
        public StringEventChannelSO          onAreaReached;

        [Header("广播频道（QuestManager 广播）")]
        [Tooltip("EVT_QuestStarted：payload = questId。AcceptQuest 成功后广播。")]
        public StringEventChannelSO                  onQuestStarted;
        [Tooltip("EVT_QuestCompleted：payload = questId。CompleteQuest 成功后广播。")]
        public StringEventChannelSO                  onQuestCompleted;
        [Tooltip("EVT_QuestFailed：payload = questId。失败条件触发后广播。")]
        public StringEventChannelSO                  onQuestFailed;
        [Tooltip("EVT_QuestAbandoned：payload = questId。玩家放弃任务时广播。")]
        public StringEventChannelSO                  onQuestAbandoned;
        [Tooltip("EVT_QuestPaused：payload = questId。PauseQuest 成功后广播。")]
        public StringEventChannelSO                  onQuestPaused;
        [Tooltip("EVT_QuestResumed：payload = questId。ResumeQuest 成功后广播。")]
        public StringEventChannelSO                  onQuestResumed;
        [Tooltip("EVT_QuestReadyToComplete：payload = questId。目标全部达成时广播一次（去重）。")]
        public StringEventChannelSO                  onQuestReadyToComplete;
        [Tooltip("EVT_QuestObjectiveUpdated：目标进度变化时广播（强类型 QuestObjectiveEvent）。")]
        public QuestObjectiveEventChannelSO           onObjectiveUpdated;
        [Tooltip("EVT_QuestObjectiveBatchUpdated：同帧内多目标聚合后广播一次（避免 HUD 同帧多次重绘）。")]
        public QuestObjectiveBatchEventChannelSO      onObjectiveBatchUpdated;
        [Tooltip("EVT_NpcAffinityChanged：NPC 好感度变化（强类型 NpcAffinityEvent）。")]
        public NpcAffinityEventChannelSO             onNpcAffinityChanged;
        [Tooltip("EVT_DialogueKeyUnlocked：payload = unlockDialogueKey，供 NPC 台词系统监听。")]
        public StringEventChannelSO                  onDialogueKeyUnlocked;
        [Tooltip("EVT_DialogueChoiceSelected：玩家选择对话选项时广播（payload = \"sequenceId/choiceIndex\"）。\n" +
                 "供 QA 埋点、成就系统、或数据分析监听，以还原玩家的对话选择路径。")]
        public StringEventChannelSO                  onDialogueChoiceSelected;
    }
}