/**
 ****************************************************************************************************
 * @file        ui_files.h
 * @author      HiFi Player Project
 * @version     V1.0
 * @date        2026-01-01
 * @brief       文件管理器界面接口
 *
 * 按键：K0 返回上级目录（根目录时回主界面） / K1 上一项 / K2 下一项 / K3 打开
 ****************************************************************************************************
 */

#ifndef __UI_FILES_H
#define __UI_FILES_H

#include <stdbool.h>
#include <stdint.h>

#include "lvgl.h"

#ifdef __cplusplus
extern "C" {
#endif

/** 创建文件管理器界面（只创建，不显示） */
void ui_files_create(void);

/** 显示界面：每次进入都从 SD 卡根目录开始浏览 */
void ui_files_show(void);

/** 周期刷新（按键高亮） */
void ui_files_tick(void);

/** 处理功能键（K1/K2/K3）；K0 由 ui.c 统一处理 */
void ui_files_handle_key(uint8_t key);

/** 仅触发按键高亮（不做动作） */
void ui_files_flash(int key);

/**
 * @brief  K0 短按时由 ui.c 先询问本界面能否“就地返回”
 * @retval true  已返回上一级目录（ui.c 不再回主界面）
 *         false 已在根目录，交给 ui.c 回主界面
 */
bool ui_files_back(void);

#ifdef __cplusplus
}
#endif

#endif /* __UI_FILES_H */