#pragma once

#include <QtCore/QByteArray>
#include <QtCore/QString>
#include <QtCore/QStringList>
#include <QtCore/QVector>

/*
 * MID 层公共定义：设备配置、匹配条件、HID 报文常量等都集中于此。
 * 高密注释放在每个结构/函数附近，方便教学时直接引用。
 */

/* HID 报文 ID：用于区分 NKRO、Consumer、Vendor */
enum Mid_Enum_ReportId : quint8
{
    Mid_Enum_ReportId_None = 0x00,
    Mid_Enum_ReportId_Nkro = 0x01,
    Mid_Enum_ReportId_Consumer = 0x03,
    Mid_Enum_ReportId_Vendor = 0x04
};

/* 默认 VID/PID：教学用固件的 USB 身份 */
const quint16 MID_CONST_VENDOR_ID_DEFAULT = 0x1209;
const quint16 MID_CONST_PRODUCT_ID_DEFAULT = 0x0001;

/* 上位机配置：允许 UI 快速切换 VID/PID */
struct Mid_Struct_DeviceConfig
{
    quint16 VendorId = MID_CONST_VENDOR_ID_DEFAULT;
    quint16 ProductId = MID_CONST_PRODUCT_ID_DEFAULT;
};

/* 匹配条件：Win32 SetupAPI + HidP_Caps 的输入结构 */
struct Mid_Struct_DeviceMatch
{
    quint16 VendorId = 0;
    quint16 ProductId = 0;
    quint16 UsagePage = 0;
    quint16 Usage = 0;
    QString Name;
};

/* 统一的“原始包”封装：记录来源端口与字节内容 */
struct Mid_Struct_RawPacket
{
    bool IsValid = false;
    QByteArray ByteArray;
    QString PortName;
};

/* Vendor 状态：逻辑层解析后的结果（Modifier + Usage 列表） */
struct Mid_Struct_VendorState
{
    bool IsValid = false;
    quint8 Modifier = 0;
    QByteArray UsageBitmap;
    QVector<quint16> UsageList;
    QStringList UsageTextList;
};

const quint16 MID_CONST_USAGE_PAGE_NKRO = 0x0001;
const quint16 MID_CONST_USAGE_NKRO = 0x0006;
const quint16 MID_CONST_USAGE_PAGE_CONSUMER = 0x000C;
const quint16 MID_CONST_USAGE_CONSUMER = 0x0001;
const quint16 MID_CONST_USAGE_PAGE_VENDOR = 0xFF00;
const quint16 MID_CONST_USAGE_VENDOR = 0x0002;
const int MID_CONST_KEYBOARD_USAGE_MAX = 0x00E7;
const int MID_CONST_USAGE_BITMAP_SIZE = 29;
const int MID_CONST_PACKET_SIZE_NKRO = 31;
const int MID_CONST_PACKET_SIZE_VENDOR = 31;
const int MID_CONST_PACKET_SIZE_CONSUMER = 3;

/* 设备匹配函数：针对 NKRO / Consumer / Vendor */
Mid_Struct_DeviceMatch Mid_Func_GetNkroMatch(const Mid_Struct_DeviceConfig& DeviceConfig);
Mid_Struct_DeviceMatch Mid_Func_GetConsumerMatch(const Mid_Struct_DeviceConfig& DeviceConfig);
Mid_Struct_DeviceMatch Mid_Func_GetVendorMatch(const Mid_Struct_DeviceConfig& DeviceConfig);
/* HID 接口枚举 & 辅助文本转换 */
bool Mid_Func_FindHidInterface(
    const Mid_Struct_DeviceMatch& Match,
    QString* p_DevicePath,
    quint16* p_InputLength,
    quint16* p_OutputLength);
QString Mid_Func_GetHexText(const QByteArray& ByteArray);
QString Mid_Func_GetModifierText(quint8 Modifier);
QString Mid_Func_GetKeyboardUsageText(quint16 Usage);
QString Mid_Func_GetConsumerUsageText(quint16 Usage);