#pragma once

#include <types/base/types.h>
#include <string>
#include <vector>

namespace extra2d {

/**
 * @brief 插件信息结构
 */
struct PluginInfo {
    std::string name;           // 插件名称
    std::string version;        // 版本号
    std::string author;         // 作者
    std::string description;    // 描述
    std::vector<std::string> dependencies;  // 依赖的插件名称列表
};

/**
 * @brief 插件接口 - 基于事件总线
 *
 * 插件是动态加载的扩展组件，可以在运行时加载/卸载
 * 插件通过事件总线与其他组件通信，零直接依赖
 *
 * 设计理念：
 * - 插件可以在运行时动态加载（动态库）或静态链接
 * - 插件之间可以声明依赖关系
 * - 插件通过事件总线发送和接收消息
 */
class IPlugin {
public:
    virtual ~IPlugin() = default;

    /**
     * @brief 获取插件信息
     * @return 插件信息结构
     */
    virtual const PluginInfo& getInfo() const = 0;

    /**
     * @brief 加载插件
     *
     * 在此注册事件监听器
     * 返回 false 表示加载失败
     *
     * @return 加载是否成功
     */
    virtual bool load() { return true; }

    /**
     * @brief 卸载插件
     *
     * 在此执行清理工作
     * 事件监听器会自动注销（RAII）
     */
    virtual void unload() {}

    /**
     * @brief 获取依赖的插件列表
     * @return 依赖的插件名称列表
     */
    virtual std::vector<std::string> getDependencies() const {
        return getInfo().dependencies;
    }
};

} // namespace extra2d

// ============================================================================
// 插件导出宏（用于动态库插件）
// ============================================================================

#ifdef _WIN32
    #define EXTRA2D_PLUGIN_EXPORT extern "C" __declspec(dllexport)
#else
    #define EXTRA2D_PLUGIN_EXPORT extern "C" __attribute__((visibility("default")))
#endif

/**
 * @brief 定义插件导出接口
 *
 * 在插件动态库中使用：
 * EXTRA2D_DEFINE_PLUGIN(MyPluginClass)
 */
#define EXTRA2D_DEFINE_PLUGIN(PluginClass) \
    EXTRA2D_PLUGIN_EXPORT extra2d::IPlugin* extra2d_create_plugin() { \
        return new PluginClass(); \
    } \
    EXTRA2D_PLUGIN_EXPORT void extra2d_destroy_plugin(extra2d::IPlugin* plugin) { \
        delete plugin; \
    }