全屏滑条统一路径+对比色(112/115) + 字体索引+查列表+丢失降级(113) + 文档刷新(114) + svcd CLI文档+mips-repo拆bins/mpk(116)

patch_v2/sdk/meow_ui.h

@@ -333,6 +333,41 @@ int  meow_notify_has_active(void);             /* 1=尚有活动通知，0=无 *
 const char *meow_notify_urgency_str(meow_notify_urgency u);
 const char *meow_notify_category_str(meow_notify_category cat);
 
+/* ============================================================ */
+/* §5.7 应用可读 TF 卡字体列表（M2.58：字体索引 / 查列表 / 丢失降级默认） */
+/* ============================================================ */
+/* 系统字体管理器的面向应用接口（规格 §5.7.1/§5.7.2）：
+ *   - 权威列表 = launcher 扫描 MeowOS/fonts/<family>/<weight>/ 后落盘的持久文件
+ *     MeowOS/config/fonts/index（CSV：family,weight,path,label,tier,glyph_count）。
+ *     app 只经本接口读该列表（不直接拼路径、不依赖 launcher 内存数组）。
+ *   - 渲染仍走 env MEOW_FONT_PNG/MEOW_FONT_IDX（launcher 注入的「当前生效字体」，
+ *     选中字体那一套）；本节的 get_available_count/enumerate 只负责「列有哪些库」，
+ *     select_by_id 负责「app 会话内固定用哪套」。两路明确。
+ *   - 无卡 / 无 index → 仅 1 项板载默认（family=default）。 */
+#ifndef MEOW_FONT_INFO_DEFINED
+#define MEOW_FONT_INFO_DEFINED
+typedef struct meow_font_info {
+    char family[64];       /* family slug = MeowOS/fonts/<family>/ 一级目录名 */
+    char name[64];         /* 显示名（index 无单列 → 回退 family） */
+    char weight[32];       /* weight slug（regular|bold|…，缺省 regular） */
+    char tier[8];          /* 档位 common|gbk|full（info 用） */
+    int  glyph_count;      /* font.json glyph_count（info 用） */
+    char label[128];       /* index 显示名（含字重 + 尺寸标记） */
+    int  size_list[16];    /* 原生字号表（index 无 → 空） */
+    int  size_count;       /* 有效字号数 */
+    int  bit_depth;        /* 4|8（index 无 → 0） */
+    char path_png[320];    /* 卡根相对 MeowOS/fonts/<family>/<weight>/font.png */
+} meow_font_info;
+#endif
+
+/* 可用字库数（含默认；无卡 → 1）。 */
+int  meow_font_get_available_count(void);
+/* 按序号取：idx=0=默认行（family=default）；越界返回 0。 */
+int  meow_font_enumerate(int idx, meow_font_info *out);
+/* 选该套为 app 会话默认字体：id=0 跟随系统默认（font.file，经 env）；id>0 固定用该套。
+ * 该套字库缺失 → 降级默认（不丢请求）+ WARN（meow_log→app 日志）。成功 0，越界负值。 */
+int  meow_font_select_by_id(int id);
+
 /* ============================================================ */
 /* §10 字体分层 / 大字库（M2.5x：基座声明 + font 域已实现按档装载） */
 /* ============================================================ */