/* ui/reader/reader.h — 阅读页给 app.c 的事件接缝（跟手拖动/平移）。
 *
 * app.c 只做最小路由：ACT_READER 时的 on_touch_down/move 转给这里（镜像 library 分支）。
 * 其余入口（on_tap / view on_event / mr_reader_open_dir）仍走 tuku_internal.h 的既有声明。
 */
#ifndef TUKU_UI_READER_READER_H
#define TUKU_UI_READER_READER_H

#ifdef __cplusplus
extern "C" {
#endif

void reader_on_touch_down(int x, int y);
void reader_on_touch_move(int x, int y);

/* 书库 → 阅读器（文件管理器模式用）：按目录内图片自然序从 start_index 开始。
 *   - start_index >= 册页数：钳到末页；其它负数按 0 处理；
 *   - start_index == MR_READER_START_RESUME(-1)：沿用该册续读记录（= mr_reader_open_dir）。
 * 显式下标优先于续读记录：用户在列表里点了某张图，就不该被上次的页码带走。 */
#define MR_READER_START_RESUME (-1)
void mr_reader_open_dir_at(const char *dir, int start_index);
/* 保留旧入口：等价于 mr_reader_open_dir_at(dir, MR_READER_START_RESUME)。 */
void mr_reader_open_dir(const char *dir);

#ifdef MR_READER_HOST_TEST
/* 宿主集成测试专用：只读观察本页状态（不参与产品逻辑）。 */
int mr_reader_ui_mode(void);        /* MR_MODE_PAGED / MR_MODE_WEBTOON */
int mr_reader_ui_page(void);        /* 当前页（条漫=视口顶端所在页） */
int mr_reader_ui_count(void);       /* 当前册页数 */
int mr_reader_ui_jump_open(void);   /* 1=跳页滑块已展开 */
int mr_reader_ui_jump_pending(void);/* 1=跳页目标等待解码 */
long mr_reader_ui_resident_kb(void);/* 驻留页图字节（KB） */
int mr_reader_ui_failed_pages(void);/* 解码失败/超预算被跳过的页数 */
int mr_reader_ui_blit_draws(void);  /* 累计原生 blit 绘页次数（热路径应为纯 blit） */
int mr_reader_ui_scaled_draws(void);/* 累计重采样绘页次数（每帧重采样=卡顿） */
#endif

#ifdef __cplusplus
}
#endif
#endif /* TUKU_UI_READER_READER_H */