XCEngine/docs/used/Subplan-01_XCUI-Core-Tree-State.md

Subplan 01：XCUI Core Tree / State / Invalidation

目标：

• 搭出 XCUI 的 retained-mode 核心骨架。
• 明确 ElementTree、NodeId、View、ViewModel、dirty flag、rebuild、lifecycle 的最小闭环。

负责人边界：

• 负责 engine/include/XCEngine/UI/ 与 engine/src/UI/Core/ 的核心树模型。
• 不负责具体布局算法。
• 不负责 ImGui 适配绘制。

建议目录：

• engine/include/XCEngine/UI/Core/
• engine/src/UI/Core/
• tests 中对应 XCUI core 测试文件

前置依赖：

• 依赖主线完成 Phase 0 的基础类型和 UI 生命周期边界清理。

现在就可以先做的内容：

• 设计 UIElementId / UIElement / UIContext / UIBuildContext
• 设计 dirty 标记与增量重建规则
• 设计 ViewModel 读写边界和 command 回调入口
• 写最小 tree rebuild 测试

明确不做：

• 不接入 .xcui 文件
• 不接入 editor 面板
• 不写具体 widget 大库

交付物：

• XCUI core 基础类与生命周期定义
• tree rebuild / invalidation / state propagation 单元测试
• 一个最小 demo：代码构建 UI tree 并触发一次增量更新

验收标准：

• 可以构建一棵稳定的 UI tree
• 局部状态变化时只标脏必要节点
• 重建逻辑与布局/渲染解耦
• 其他 subplan 可以基于该模块定义控件树和状态更新