/* 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，RGB565：2 字节/像素） */
int mr_reader_ui_failed_pages(void);/* 解码失败（坏图）页数 */
int mr_reader_ui_skipped_pages(void);/* 被内存预算跳过（可重试）的页数 */
/* 注入 /proc/meminfo 读数（kB）；-1 = 恢复真实读取。用于确定性验证内存门控与放宽档。 */
void mr_reader_ui_test_set_mem(long free_kb, long avail_kb);
/* 峰值模型自检：用产品代码里的同一个模型算预估峰值（kB），供宿主测试与 --wrap malloc
 * 实测对照。0=探测失败。 */
long long mr_reader_ui_decode_peak_kb(const char *path, int step, int box_w, int box_h);
/* M32：同一次取页里的 565 落槽暂存（kB，= 2×tw×th）；与 decode_peak 分开报，便于
 * 「解码峰值」与「落槽暂存」各自对照实测。 */
long long mr_reader_ui_decode_convert_kb(const char *path, int step, int box_w, int box_h);
long mr_reader_ui_peak_cap_kb(void);     /* 常态峰值上限（kB） */
long mr_reader_ui_peak_budget_kb(void);  /* 当前 MemFree 下的实际预算（kB） */
long mr_reader_ui_resident_cap_kb(void); /* 常驻上限（kB；含在途结果） */
/* ---- M32 RGB565 页槽预算口径 ---- */
long mr_reader_ui_pending_kb(void);      /* 已解码、还没落槽的在途结果字节（KB） */
long mr_reader_ui_page_px_cap(void);     /* 单页缓存像素上限（旧 RGBA 3MB 的同几何口径） */
long mr_reader_ui_slot_kb(int idx);      /* 指定槽内页图的常驻字节（KB，565）；0=不在槽内 */
/* 翻页命中/未命中（观测口，用于验证「命中率不退化」）：目标页已在槽 = 预取生效。 */
int mr_reader_ui_flip_hits(void);
int mr_reader_ui_flip_misses(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 */