namespace AlicizaX.UI
{
    /// <summary>
    /// RecyclerView 适配器接口，负责提供数据和绑定视图
    /// </summary>
    public interface IAdapter
    {
        /// <summary>
        /// 获取列表项总数（包括循环或分组后的虚拟数量）
        /// </summary>
        /// <returns>列表项总数</returns>
        int GetItemCount();

        /// <summary>
        /// 获取实际数据项数量（不包括循环或分组的虚拟数量）
        /// </summary>
        /// <returns>实际数据项数量</returns>
        int GetRealCount();

        /// <summary>
        /// 获取指定索引位置的视图名称，用于视图类型区分
        /// </summary>
        /// <param name="index">列表项索引</param>
        /// <returns>视图名称</returns>
        string GetViewName(int index);

        /// <summary>
        /// 绑定视图持有者与数据
        /// </summary>
        /// <param name="viewHolder">视图持有者</param>
        /// <param name="index">数据索引</param>
        void OnBindViewHolder(ViewHolder viewHolder, int index);

        /// <summary>
        /// 通知数据已更改，触发视图刷新
        /// </summary>
        void NotifyDataChanged();
    }
}