Appearance
共享类型定义
系统概览
全项目共享类型定义。从 config.ts 拆出的纯类型文件,零运行时代码。包含骨骼覆盖(ADR-061)、 动作模块状态(ADR-116/145)、VMD 图层、场景动作意图(ADR-167)等核心数据结构, 被核心/场景/菜单三大目录广泛引用。
核心职责
types.ts— 集中管理跨模块共享的类型定义。
对外 API(节选)
type BoneOverrideEntry— 单条骨骼覆盖配置(欧拉角 + 权重 + 绝对模式)。type MotionModuleState— 动作模块运行时状态(per-motion)。type MotionPreset— 动作预设 DTO(ADR-145)。type ModelInstance— 模型实例描述(vmdData/vmdName 等)。type VmdLayer— VMD 图层描述。type EnvState— 环境状态容器。type UIState— UI 持久化状态容器。
与其他子系统关系
- barrel re-export:
config.ts→types.ts。 - 被 core/scene/menus 约 38 个模块直接引用。
- ADR-061/116/123/145/167 均在此定义相关类型。
不变量
- 纯类型定义,不含任何运行时代码。
- 通过
config.ts统一导出,调用方无需改 import 路径。