sdk: full-sync M7.0a/b (theme view input gfx 等, 真实功能非FT)

README.md

@@ -56,9 +56,11 @@ cd ../examples/hello
 - **动画基座 `meow_anim` / `meow_anim_tick`**（§12.2）：声明式 tween（linear/ease-out/ease-in-out/overshoot），静态池 ≤16，无动画零开销；只 flush 动画影响区。
 - **滚动物理 `meow_scroll`**（§12.3）：速度采样 + 松手 fling + 边界 clamp/简单回弹 + snap 吸附；给 `meow_list`/`W_LIST`/`W_LISTVIEW` 加惯性滚动。
 - **事件分发形式化**（§6.4）：单一仲裁者——z 序自顶向下命中、命中即消费、down 捕获整个手势、模态层隔离、唯一焦点（点外释放/滚动容器转移）。
+- **视图事件路由**（§A.7，M7.0a）：`meow_view_dispatch_event` 接入 `meow_ui_run`——TAP/KEY/SWIPE/LONG_PRESS 先走视图树 `on_event` 路由，命中即消费（不再落 App `on_*`）；无视图树/未命中回落 App 原生 `on_*` 回调（完全向后兼容）。页内子导航按设计定案 b 标注**废弃**（不实现），页内「子页」用 `meow_view_add_child` 挂 CONTAINER 子视图（组合嵌套）。
 - **ListView 虚拟化**（§5.5）：固定 item 池（视口+2）、多行富 item、段头、空态、完全自绘钩子；App 只提供「总数 + bind」回调，几千/上万行不卡。
 - **ListView 左滑删除**（§5.5）：列表行横向手势 `meow_listview_swipe_begin/move/end` 三级喂入 + 删除/回弹动画；`meow_listview_set_swipe_delete` 绑删除回调，行自绘 `set_item_draw` 配合画右露删除区（主题 `error/onError`）。
 - **圆形图标按钮 `meow_iconbtn_create`**（M7.0a）：圆形命中 + 位图图标（`sb_icons[]`/`MEOW_ICON_*`）+ 实时按压/按住态；供电源菜单/播放控制/锁屏件用。
+- **主题色板导出/注入**（§8.1.5，M7.0a）：`meow_theme_export`/`meow_theme_inject`——「单一权威桥」，导出当前 `style×mode` 解析生效的权威主题（9 角色字段），或注入一份自定义板覆写当前生效主题（`NULL` 恢复内建，覆写随 `meow_theme_reload()` 保留）；供 stateless 绘制原语读单一权威、或 launcher/App 自定义背景/强调/风格。
 - **字符串资源 / i18n**（§13）：`meow_str`/`meow_strf`/`meow_str_set_locale`——内嵌 `zh_cn`/`en_us` 双语表 + TF 卡覆盖表；UI 文案零硬编码，按 locale 取整串。
 - **图标库 `sb_icons`**（§5.8）：30 个 MD3 Material Symbols 位图动作图标（`MEOW_ICON_*`），`meow_topappbar_set_item_icon` 把 TopAppBar 动作项换成位图图标（修复 ⚙↻⌕ 豆腐）。
 - **图片降采样 `meow_img_downscale`**（`include/meow_ui_image.h`）：把解码图降到 ≤maxdim 边长省内存（封面/大图用，如 8.28MB→0.78MB）。

sdk/include/meow_ui_theme.h

@@ -62,6 +62,28 @@ void meow_theme_remove_listener(meow_theme_listener cb);
 /* [D4] 脱机访问两套内置色板（无 settings 文件也可靠）：返回当前解析生效的色板副本。 */
 meow_theme meow_theme_defaults(meow_theme_mode m);
 
+/* ---- §8.1.5 色板导出/注入（单一权威桥，M7.0a）----
+ * 用户在 M7 定案「SDK meow_theme 为唯一权威」：launcher 的 s_ui_theme() 将改为读 SDK 的薄壳，
+ * 不再自持 4 套静态色板。本接口是那个前置（launcher 侧改动不在此批）——
+ *
+ *   meow_theme_export(out)   把当前「style×mode」解析生效的完整权威主题拷给调用方。
+ *                            调用方是 stateless 的绘制原语时（如 launcher s_ui_theme），由此读
+ *                            单一权威，再按它的角色字段（9 色）映射到自己的绘制便利结构，即：
+ *                              surface      → surface
+ *                              surfaceVariant → surface_variant
+ *                              surfaceContainer → surface_container
+ *                              primary      → primary
+ *                              onSurface    → on_surface
+ *                              onSurfaceVariant → on_surface_variant
+ *                              outline      → outline
+ *                              error        → error
+ *                              surfaceTint  → surface_tint
+ *   meow_theme_inject(src)   用一份自定义板覆写当前生效主题（如 launcher 自定义背景/强调/风格），
+ *                            src==NULL 恢复内建（随 settings 解析）。覆写不随 meow_theme_reload() 丢弃
+ *                            （程序化覆写优先于 settings，与 meow_ui_set_style 语义一致）。 */
+void meow_theme_export(meow_theme *out);
+void meow_theme_inject(const meow_theme *src);
+
 /* ---- §8.1 顶级主题风格族（minimal，2026-08-30）----
  * 主题 = 顶级主题风格族（ui.style：MD3/MIUIx）× 明暗（display.theme）。本批只落「状态栏图标集
  * 随 ui.style 换集」的最小闭环：meow_ui_set_style 记录 style（同值忽略）+ 触发 theme_reload/

sdk/meow_ui_input.c

@@ -26,6 +26,7 @@
 #include "meow_ui_sys.h"
 #include "meow_ui_vol.h"
 #include "meow_ui_media.h"
+#include "meow_ui_view.h"   /* M7.0a 缺口#7：把 meow_view_dispatch_event 接入 meow_ui_run */
 
 #include <stdio.h>
 #include <stdlib.h>
@@ -140,7 +141,7 @@ static int meow_input_jack_debounce(void)
 }
 
 /* ---- §10.5 叠加让位：通知中心叠加会话期输入排空（播放中 App 不被 SIGSTOP 的配套）----
- * 媒体播放中的 App 前台唤起通知中心时 launcher 不冻结 App（保 PCM 供流，App 播放线程同进程），
+ * 媒体播放中的 App 前台唤起通知中心时 launcher 不冻结 App（保 PCM 供流，ncm 播放线程同进程），
  * App 输入线程仍在读同一批 evdev 设备（每 fd 各收一份事件副本，与 launcher 互不剥夺）——若不
  * 抑制，面板上的一次点击会被 App 再消费一次（如面板媒体卡片「暂停」与 App 同坐标控件双重触发）。
  * 故标记存在期：排空本进程 fd 队列并丢弃、EVIOCGKEY 位图静默对齐（不产生边沿语义，系统键动作
@@ -714,8 +715,14 @@ void meow_ui_run(const meow_ui_events *ev)
                 /* §6.1 触摸分流：③ 系统全局(IME/状态栏…已在上面消费) → ② App 全局控件
                  * （命中返回 1=消费，否则落到 ① active Activity 页面控件）。 */
                 if (meow_ui_global_hit(e.a, e.b)) continue;
+                /* M7.0a 缺口#7：meow_view 事件路由（§A.7）——有活动页 view 子树且其 on_event
+                 * 命中即消费（不再落 App on_tap）；无 view 树/未命中返回 0 → 回落 on_tap 原路径。 */
+                if (meow_view_dispatch_event(MEOW_EV_TAP, e.a, e.b)) continue;
                 if (g_events_set && g_events.on_tap) g_events.on_tap(e.a, e.b);
             } else if (e.type == MEOW_EV_KEY) {
+                /* M7.0a 缺口#7：先进 view 路由，命中即消费；否则回落 App on_key（语义不变——
+                 * 音量/媒体系统键已在输入线程消化，这里只决定 App/页面是否收到语义事件）。 */
+                if (meow_view_dispatch_event(MEOW_EV_KEY, e.a, e.b)) continue;
                 if (g_events_set && g_events.on_key) g_events.on_key(e.a, e.b);
             } else if (e.type == MEOW_EV_SWIPE) {
                 if (in_startup) continue;   /* 启动残留被当左缘滑动：丢弃，防进入即返回 */
@@ -725,6 +732,9 @@ void meow_ui_run(const meow_ui_events *ev)
                 /* 拼音 IME 候选栏横滑翻页（英文模式 handle_event 返回 0 → 沿用既有行为）。 */
                 if (meow_ime_active() && meow_ime_handle_event(&e)) continue;
                 meow_ui_gesture_end();   /* §6.4：抬手（滑动）边沿，释放手势捕获 */
+                /* M7.0a 缺口#7：view 路由先于 App 窗口的 on_swipe 与默认返回手势——页 view
+                 * 可消费滑动（页内返回/翻页/横幅）；命中即跳过下面对 on_swipe/默认退出的分发。 */
+                if (meow_view_dispatch_event(MEOW_EV_SWIPE, e.a, e.b)) continue;
                 /* A-0 全局左缘返回（方案A）：
                  *   - APP 注册 on_swipe → APP 接管，自行决定（meow_ui_request_exit / 页内返回）；
                  *   - APP 未注册 on_swipe 且非全屏（sb_active）→ SDK 默认退出 app（返回=退出）；
@@ -783,6 +793,8 @@ void meow_ui_run(const meow_ui_events *ev)
                 /* 拼音 IME 打开：长按退格清空字段（英文模式 handle_event 返回 0 → 走既有长按回调）。 */
                 if (meow_ime_active() && meow_ime_handle_event(&e)) continue;
                 meow_ui_gesture_end();   /* §6.4：长按已触发，其抬手不再 TAP/SWIPE——顺手释放捕获 */
+                /* M7.0a 缺口#7：view 路由先于 §6.3 通用长按回调（页 view 可消费长按）。 */
+                if (meow_view_dispatch_event(MEOW_EV_LONG_PRESS, e.a, e.b)) continue;
                 if (g_long_press_cb) g_long_press_cb(e.a, e.b);
             }
         }

sdk/meow_ui_theme.c

@@ -37,6 +37,12 @@ static char g_background[64] = "";                 /* display.background（black
 static meow_theme_listener g_listeners[8];
 static int g_nlisteners = 0;
 
+/* §8.1.5 色板注入：一份自定义板覆写当前生效主题（src==NULL 恢复内建）。
+ * 覆写优先于 settings 解析（随 meow_theme_reload() 重读 settings 后仍生效，与 meow_ui_set_style
+ * 的「程序化覆写不清 settings」语义一致）。 */
+static meow_theme g_inject;
+static int        g_inject_set = 0;
+
 /* ---- 读 /usr/data/meow/settings.conf 的 key=value（兼容 "key = value" 带空格形式）----
  * 与 launcher meow_settings_import 同款解析：按 '=' 切分，key/value 各自去首尾空白，
  * 精确匹配 key（避免 display.theme 误匹配 display.theme_mode）。返回 0=命中，-1=未命中。 */
@@ -295,6 +301,7 @@ static void broadcast(void)
 /* 当前「style×mode」主题：style=0/1（MD3/MIUIX），dark=0(light)/1(dark)。 */
 static const meow_theme *theme_current(int style, int dark)
 {
+    if (g_inject_set) return &g_inject;   /* §8.1.5 注入板优先 */
     if (style < MEOW_STYLE_MD3) style = MEOW_STYLE_MD3;
     if (style > MEOW_STYLE_MIUIX) style = MEOW_STYLE_MIUIX;
     return &g_theme[style][dark ? 1 : 0];
@@ -339,6 +346,26 @@ meow_theme meow_theme_defaults(meow_theme_mode m)
     return g_theme[MEOW_STYLE_MD3][resolve_mode(m) == MEOW_THEME_DARK ? 1 : 0];
 }
 
+/* ---- §8.1.5 色板导出/注入（单一权威桥）----
+ * 导出：把当前「style×mode」解析生效的完整权威主题拷给调用方（不取指针以防调用方误改内部表）。
+ * 注入：用一份自定义板覆写当前生效主题；NULL 恢复内建。二者都触发 load（g_loaded==0 时先读
+ * settings.conf），使宿主无 settings 文件（单测/脱机）也可靠。 */
+void meow_theme_export(meow_theme *out)
+{
+    if (!out) return;
+    const meow_theme *t = meow_theme_get();   /* 解析 g_mode（AUTO→明/暗）+ g_style + 背景覆写 */
+    *out = *t;
+}
+
+void meow_theme_inject(const meow_theme *src)
+{
+    if (!g_loaded) { load_settings(); g_loaded = 1; }
+    if (!src) { g_inject_set = 0; broadcast(); return; }
+    g_inject = *src;
+    g_inject_set = 1;
+    broadcast();   /* 通知 App/状态栏/控件下一帧用新注入板重绘 */
+}
+
 /* ---- §8.1.2 顶级主题风格族（minimal）----
  * meow_ui_style() 返回当前 ui.style（读取走 load_settings，随 meow_theme_reload() 重读，
  * 故 launcher 改 settings.conf 后经 sb_sdk_refresh→theme_reload 即跟手）。

sdk/meow_ui_view.c

@@ -156,6 +156,10 @@ int meow_view_add_child(meow_view *parent, meow_view *child)
     if (parent->nchildren >= MEOW_VIEW_MAX_CHILD) return -1;
     parent->children[parent->nchildren++] = child;
     child->parent = parent;
+    /* 递归修正（§A.4「子视图随父进出」）：父已进入时挂上的子视图**立即**进入
+     * （on_enter 不遗漏、参与事件分发）。页在 push/pop 时仍由 view_enter/view_leave 递归驱动，
+     * 此处只补「运行期动态挂子」的间隙（hello 目录嵌套实为 create 后 page_push 前 add，不受影响）。 */
+    if (parent->state & MEOW_VIEW_STATE_ENTERED) view_enter(child);
     return 0;
 }
 
@@ -218,11 +222,15 @@ void meow_view_page_replace(int id)
     g_top_view = next ? next : cur;
 }
 
-/* ---- 页内子导航（预留扩展位 a 桩：本批不实现，仅返回占位）---- */
+/* ---- 页内子导航（预留扩展位 a，**标注废弃**）----
+ * 设计定案 b（SDK_VIEW_FRAMEWORK_DESIGN.md §F.2：只做子视图容器嵌套，顶层页切仍走 activity
+ * 栈，不做页内子导航栈）：本函数对为「将来 a」预留的桩，**不实现、不供依赖**——调用方不得
+ * 认为会建立/弹出子导航。页内「子页」请用 meow_view_add_child 挂 CONTAINER 子视图（组合嵌套），
+ * 或以 activity 栈驱动页切换（page_push/pop/replace）。保留符号仅为未来 a 的占位。 */
 int meow_view_sub_push(meow_view *v, meow_view *sub)
 {
     (void)v; (void)sub;
-    return 0;   /* 预留：将来在 ACTIVITY view 内维护子栈 */
+    return 0;   /* 预留：将来在 ACTIVITY view 内维护子栈（见设计定案 b，不实现） */
 }
 meow_view *meow_view_sub_pop(meow_view *v)
 {

sdk/meow_ui_view.h

@@ -82,12 +82,17 @@ void meow_view_page_replace(int id);           /* 旧top on_leave + 新页 on_en
 
 /* 入口：把语义事件注入当前活动页 view 子树路由——先发子视图（按 z 降序），命中即消费，
  * 再落本 view 的 on_event（其内做该 view 的 widget 命中）。返回 1=已消费（§A.7）。
- * 未接线于 meow_ui_run（App 可在 on_tap/on_swipe 等回调里改用它实现 SDK 原生路由）。 */
+ * 已接线于 meow_ui_run（M7.0a）：在 §6.4 分流之上，TAP/KEY/SWIPE/LONG_PRESS 先经本路由，
+ * 命中即消费（不再落 App 的 on_* 回调）；返回 0 时回落 on_* 原路径（无 view 树 / 未命中 →
+ * 完全向后兼容）。App 也可在自持事件循环里直接调用本函数实现 SDK 原生路由。 */
 int  meow_view_dispatch_event(int ev, int a, int b);
 
-/* ---- 页内子导航（预留扩展位 a；本批为空实现/桩，仅在 ACTIVITY view 内维护子栈）---- */
+/* ---- 页内子导航（预留扩展位 a，**标注废弃**）----
-int  meow_view_sub_push(meow_view *v, meow_view *sub);   /* 预留；返回 0（未实现于本批） */
+ * 设计定案 b（§F.2）：不做页内子导航栈，只做子视图容器嵌套；顶层页切仍走 activity 栈。
-meow_view *meow_view_sub_pop(meow_view *v);              /* 预留；返回 NULL（未实现于本批） */
+ * 故本组为**不实现、不供依赖**的桩（返回 0/NULL）；页内子页请用 meow_view_add_child 挂
+ * CONTAINER 子视图，或以 page_push/pop/replace 走 activity 栈。保留符号仅作将来 a 的占位。 */
+int  meow_view_sub_push(meow_view *v, meow_view *sub);   /* 废弃（不实现）；返回 0 */
+meow_view *meow_view_sub_pop(meow_view *v);              /* 废弃（不实现）；返回 NULL */
 
 /* ---- 坐标：view 相对父内容原点的累计（父坐标链求和 → 屏幕绝对坐标）---- */
 int meow_view_screen_x(const meow_view *v);

sdk/test_umbrella.c

@@ -58,14 +58,16 @@ static void umbrella_smoke(void)
     (void)&meow_ui_text_center; (void)&meow_ui_time_ms; (void)&meow_ui_effective_rate;
     /* 图片层（§4） */
     (void)&meow_img_load_file; (void)&meow_ui_img_cover; (void)&meow_img_w;
-    /* 主题（§8） */
+    /* 主题（§8 + §8.1.5 色板导出/注入） */
     (void)&meow_theme_get; (void)&meow_theme_defaults; (void)&meow_ui_set_style;
+    (void)&meow_theme_export; (void)&meow_theme_inject;
     /* 输入法（§5.1） */
     (void)&meow_ui_text_input; (void)&meow_ime_text; (void)&meow_ime_composition;
     /* 控件层（§5/§5.8/§5.8.6/§5.5） */
     (void)&meow_btn_create; (void)&meow_widget_custom_create; (void)&meow_row_create;
     (void)&meow_topappbar_hit; (void)&meow_listview_create; (void)&meow_list_tap_at;
     (void)&meow_widget_set_opts; (void)&meow_widget_state; (void)&meow_progress_set;
+    (void)&meow_iconbtn_create;   /* M7.0a 缺口#2 */
     /* 输入层/生命周期（§6）+ 长按（§6.3） */
     (void)&meow_ui_run; (void)&meow_ui_swipe_hint; (void)&meow_ui_set_long_press_cb;
     /* Activity 栈（§6.1） */