/* logic/logic.h — 业务层接口（纯 C，不依赖 meow_ui.h / meow_view）。
 *
 * 分层契约（SDK_VIEW_FRAMEWORK_DESIGN.md §B.1）：
 *   ① UI→业务 = 纯函数命令 + getter（logic_* / notify_* 返回业务态，业务不回调 UI）；
 *   ② 业务→UI = 可选 push 监听器（logic_listener_fn + logic_set_listener）；
 *   ③ view 的 ctx = 视图控制器（biz-UI 绑定点）。
 * 本头只声明数据类型与函数原型，不含任何 meow_ui.h / meow_ui_view.h 依赖——
 * logic/state.c 因此保持纯 C；logic/notify.c 仅因要用 SDK 通知 API 而 include meow_ui.h。
 */
#ifndef HELLO_LOGIC_H
#define HELLO_LOGIC_H

/* 监听器事件类型（业务态变化 → 通知 UI） */
#define LOGIC_EV_TAPS 1   /* taps 计数变化 */
#define LOGIC_EV_SECS 2   /* secs 秒计数变化 */

typedef void (*logic_listener_fn)(int ev, void *ctx);   /* ctx = 监听器注册时给的视图控制器 */

/* ---- 计数业务态（logic/state.c）---- */
int  logic_taps_get(void);        /* 返回累计 taps */
void logic_taps_bump(void);       /* taps++，并触发监听器（若已注册） */
int  logic_secs_get(void);        /* 返回过去秒数 */
void logic_secs_add(int n);       /* secs += n，并触发监听器（若已注册） */
void logic_set_listener(logic_listener_fn cb, void *ctx);   /* 注册业务→UI 推送监听器（可 NULL 注销） */

/* ---- 通知业务（logic/notify.c）---- */
void notif_send(int which);       /* 按索引发一条通知（数据/超时/优先级在业务层定） */
void notif_cancel(void);          /* 取消最近一条发送的通知 */

#endif /* HELLO_LOGIC_H */