docs: add xceditor api tree and new resource docs

docs/api/XCEditor/Widgets/Widgets.md

@@ -0,0 +1,41 @@
+# Widgets
+
+**命名空间**: `XCEngine::UI::Editor::Widgets`
+
+**类型**: `submodule`
+
+**描述**: 编辑器基础 UI 原语子模块，覆盖集合控件标签分类、通用文本布局、字段行布局与颜色工具。
+
+## 概述
+
+`Widgets` 不是完整控件集合，而是被 `Collections`、`Fields` 和 `Shell` 反复复用的低层工具头文件：
+
+- `UIEditorCollectionPrimitives.h`
+  - 统一描述 scroll/tree/list/property-section/field-row 等标签的分类和布局属性
+- `UIEditorColorUtils.h`
+  - 颜色与视觉辅助函数
+- `UIEditorFieldRowLayout.h`
+  - 字段标签列 / 控件列的基础布局工具
+- `UIEditorTextLayout.h`
+  - 文本高度、顶边与裁剪矩形的内联 helper
+
+这些类型被 `UIEditorTheme.h`、`UIEditorPropertyGrid.h`、`UIEditorShellCompose.h` 等更高层模块直接复用。
+
+## 公开头文件
+
+- `UIEditorCollectionPrimitives.h`
+- `UIEditorColorUtils.h`
+- `UIEditorFieldRowLayout.h`
+- `UIEditorTextLayout.h`
+
+## 当前实现边界
+
+- 当前这里只建立目录索引页，具体头文件页仍需后续逐个补齐。
+- 这一层主要提供纯函数和轻量布局工具，不承担 panel / workspace 级状态管理。
+
+## 相关文档
+
+- [XCEditor](../XCEditor.md)
+- [Collections](../Collections/Collections.md)
+- [Fields](../Fields/Fields.md)
+- [Foundation](../Foundation/Foundation.md)