/* app/font_resolve.h — 在 MeowOS/fonts 里找字体文件（进程内记忆化）。 */
#ifndef FONT_RESOLVE_H
#define FONT_RESOLVE_H

/* 递归（深度 ≤ 3）扫 root，返回第一个 .otf/.ttf 的完整路径；没找到返回 NULL。
 * 返回值指向模块内部静态缓冲，调用方不得 free，下次调用前一直有效。
 * 语义：只缓存成功路径；命中时做一次 access() 校验，字库被删即重新扫描；
 * 失败不缓存，用户之后拷入字库仍能立刻找到。 */
const char *font_resolve(const char *root);

/* 丢弃缓存（下次 font_resolve 强制重扫）。书架顶栏「刷新」时调用：
 * 命中路径仍在时不会自动发现「用户新拷入、路序更靠前」的字库，手动刷新给一条显式失效路径。 */
void font_cache_invalidate(void);

#endif /* FONT_RESOLVE_H */