/*
 * meow_ui_log.h — SDK 应用日志（§9，统一日志 API，M2.51 最小可用版）。
 *
 * 原 meow_ui.h 拆分的一部分（log 模块）。app 只需一行 meow_log()；SDK 管「写哪/怎么写/过滤/降级/上限」。
 */
#ifndef MEOW_UI_LOG_H
#define MEOW_UI_LOG_H

#ifdef __cplusplus
extern "C" {
#endif

/* ============================================================ */
/* §9 应用日志（统一日志 API，M2.51 最小可用版） */
/* ============================================================ */
/* app 只需一行 meow_log()；SDK 管「写哪/怎么写/过滤/降级/上限」：
 *   - 路径：<MEOW_LOG_DIR>/<启动时间>_<pid>.log（MEOW_LOG_DIR 已含包名分层 logs/<包名>）
 *     （目录不存在 mkdir -p，按 app 分目录），每次启动=新文件，同一次启动内 O_APPEND 追加；
 *   - 级别过滤：lvl < meow_log_get_level() 丢弃；默认 MEOW_LOG_INFO；
 *   - 格式：<monotonic_ms> [<app_id>] <LEVEL> message\n；
 *   - 上限：单文件 ≥2MB 自动开新文件追加 _<n>；每 App 总量 ≥50MB 按期删最旧，防撑爆卡；
 *   - 无卡/写失败降级 stderr，不阻塞 app 不崩；线程安全。
 * 注意：MEOW_LOG_APP 由 launcher 注入；未注入时默认 app_id="app"。 */
typedef enum { MEOW_LOG_DEBUG=0, MEOW_LOG_INFO, MEOW_LOG_WARN, MEOW_LOG_ERROR } meow_log_level;
void meow_log(meow_log_level lvl, const char *fmt, ...);   /* app 一行调用，写到按 app 分离日志 */
void meow_log_set_level(meow_log_level lvl);               /* 可选：app 设本 app 级别；默认 MEOW_LOG_INFO */
meow_log_level meow_log_get_level(void);

#ifdef __cplusplus
}
#endif
#endif /* MEOW_UI_LOG_H */