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

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 内维护子栈）---- */
-int  meow_view_sub_push(meow_view *v, meow_view *sub);   /* 预留；返回 0（未实现于本批） */
-meow_view *meow_view_sub_pop(meow_view *v);              /* 预留；返回 NULL（未实现于本批） */
+/* ---- 页内子导航（预留扩展位 a，**标注废弃**）----
+ * 设计定案 b（§F.2）：不做页内子导航栈，只做子视图容器嵌套；顶层页切仍走 activity 栈。
+ * 故本组为**不实现、不供依赖**的桩（返回 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);