# XCEditor

**命名空间**: `XCEngine::UI::Editor`

**类型**: `module-root`

**描述**: `XCEditor` public API 的根目录入口，对齐 `new_editor/include/XCEditor` 的模块结构，描述新编辑器壳层、交互层与控件库。

## 概述

`docs/api/XCEditor` 是当前与 `new_editor/include/XCEditor/**` 并行的 canonical 文档根树。它覆盖的是新编辑器公开头文件，而不是旧版 `editor/src/**` 的 source-backed API。

按 `new_editor/app/Application.cpp` 当前真实调用链，新编辑器壳层大致由下面几部分组成：

1. `Shell`
   - 组合 panel registry、workspace model、workspace session 与 shell interaction
2. `Foundation`
   - 提供 command registry、dispatcher、shortcut manager 与 theme/metrics 解析
3. `Collections` / `Fields` / `Widgets`
   - 提供树、列表、滚动、属性面板以及文本/配色/布局等底层 UI 原语

## 子目录

- [Collections](Collections/Collections.md)
- [Fields](Fields/Fields.md)
- [Foundation](Foundation/Foundation.md)
- [Shell](Shell/Shell.md)
- [Widgets](Widgets/Widgets.md)

## 与旧编辑器文档的边界

- `docs/api/XCEngine/Editor/**`
  - 仍然描述旧版 `editor/src/**` source-backed API
- `docs/api/XCEditor/**`
  - 描述 `new_editor/include/XCEditor/**` 的 public headers

这两棵树都属于当前 API 文档，但来源代码树不同，不能混写。

## 相关文档

- [API 总索引](../main.md)
- [XCEngine/Editor](../XCEngine/Editor/Editor.md)
- [API 文档重构状态](../_meta/rebuild-status.md)