/* 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);

/* 书库 → 阅读器（按文件名定位起始页；M18 评审 P1-1 的首选入口）：
 * 打开 dir 后，由阅读器自己的目录册枚举（logic/reader/page_source.c: mr_dir_book_init，
 * 与翻页用的是同一份全量枚举）按 basename 找起始页（先大小写敏感，再大小写不敏感兜底）。
 * 找不到则退回续读记录/首页。这样书库不需要（也不能）从可能被 MR_LIB_SCAN_MAX 截断的
 * 列表里推导下标——目录条目超过 2000 时也不会「点 A 开 B」。name 为 NULL/空则等价续读。 */
void mr_reader_open_dir_at_name(const char *dir, const char *name);

/* 保留旧入口：等价于 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);/* 累计重采样绘页次数（每帧重采样=卡顿） */
int mr_reader_ui_decode_count(void);/* 累计解码次数（查重解抖动/活锁） */
int mr_reader_ui_fit(void);         /* 当前 fit 档（MR_FIT_*） */
int mr_reader_ui_chrome(void);      /* 1=顶栏可见 */
/* 直接切模式（绕过顶栏 tap 的命中时序；测试用，产品路径仍走顶栏动作）。 */
void mr_reader_test_toggle_mode(void);
/* 浏览根（生产=MR_ROOT_DIR）：册间衔接不得越过它。测试可指向合成夹具根。 */
void mr_reader_test_set_root(const char *root);
const char *mr_reader_test_root(void);
#endif

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