# Foundation

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

**类型**: `submodule`

**描述**: 编辑器基础设施子模块，覆盖命令注册、命令派发、快捷键管理以及主题度量解析入口。

## 概述

`Foundation` 负责把 shell 壳层的静态配置转换成运行时可执行的命令与快捷键系统。按当前头文件分工：

- `UIEditorCommandRegistry.h`
  - 声明命令描述、workspace 命令描述和注册表校验规则
- `UIEditorCommandDispatcher.h`
  - 把命令 id 分发到 workspace controller 或 host command handler
- `UIEditorShortcutManager.h`
  - 在 `UIShortcutRegistry` 之上管理绑定、校验冲突并执行调度
- `UIEditorTheme.h`
  - 汇总 Collections / Fields / Shell 各控件的 metrics 与 palette 解析入口

`new_editor/app/Application.cpp` 当前会构造 `UIEditorWorkspaceController`，再通过 `BuildEditorShellShortcutManager(...)` 接入这一层。

## 公开头文件

- `UIEditorCommandDispatcher.h`
- `UIEditorCommandRegistry.h`
- `UIEditorShortcutManager.h`
- `UIEditorTheme.h`

## 当前实现边界

- 当前这里只建立目录索引页，具体头文件页仍需后续补齐。
- 该模块不直接渲染 UI，而是为 `Shell` 与各控件模块提供命令、快捷键、主题和度量解析能力。

## 相关文档

- [XCEditor](../XCEditor.md)
- [Shell](../Shell/Shell.md)
- [Widgets](../Widgets/Widgets.md)