feat(fairygui): FairyGUI 完整集成 (#314)

* feat(fairygui): FairyGUI ECS 集成核心架构

实现 FairyGUI 的 ECS 原生集成,完全替代旧 UI 系统:

核心类:
- GObject: UI 对象基类,支持变换、可见性、关联、齿轮
- GComponent: 容器组件,管理子对象和控制器
- GRoot: 根容器,管理焦点、弹窗、输入分发
- GGroup: 组容器,支持水平/垂直布局

抽象层:
- DisplayObject: 显示对象基类
- EventDispatcher: 事件分发
- Timer: 计时器
- Stage: 舞台,管理输入和缩放

布局系统:
- Relations: 约束关联管理
- RelationItem: 24 种关联类型

基础设施:
- Controller: 状态控制器
- Transition: 过渡动画
- ScrollPane: 滚动面板
- UIPackage: 包管理
- ByteBuffer: 二进制解析

* refactor(ui): 删除旧 UI 系统,使用 FairyGUI 替代

* feat(fairygui): 实现 UI 控件

- 添加显示类:Image、TextField、Graph
- 添加基础控件:GImage、GTextField、GGraph
- 添加交互控件:GButton、GProgressBar、GSlider
- 更新 IRenderCollector 支持 Graph 渲染
- 扩展 Controller 添加 selectedPageId
- 添加 STATE_CHANGED 事件类型

* feat(fairygui): 现代化架构重构

- 增强 EventDispatcher 支持类型安全、优先级和传播控制
- 添加 PropertyBinding 响应式属性绑定系统
- 添加 ServiceContainer 依赖注入容器
- 添加 UIConfig 全局配置系统
- 添加 UIObjectFactory 对象工厂
- 实现 RenderBridge 渲染桥接层
- 实现 Canvas2DBackend 作为默认渲染后端
- 扩展 IRenderCollector 支持更多图元类型

* feat(fairygui): 九宫格渲染和资源加载修复

- 修复 FGUIUpdateSystem 支持路径和 GUID 两种加载方式
- 修复 GTextInput 同时设置 _displayObject 和 _textField
- 实现九宫格渲染展开为 9 个子图元
- 添加 sourceWidth/sourceHeight 用于九宫格计算
- 添加 DOMTextRenderer 文本渲染层(临时方案)

* fix(fairygui): 修复 GGraph 颜色读取

* feat(fairygui): 虚拟节点 Inspector 和文本渲染支持

* fix(fairygui): 编辑器状态刷新和遗留引用修复

- 修复切换 FGUI 包后组件列表未刷新问题
- 修复切换组件后 viewport 未清理旧内容问题
- 修复虚拟节点在包加载后未刷新问题
- 重构为事件驱动架构,移除轮询机制
- 修复 @esengine/ui 遗留引用,统一使用 @esengine/fairygui

* fix: 移除 tsconfig 中的 @esengine/ui 引用
This commit is contained in:
YHH
2025-12-22 10:52:54 +08:00
committed by GitHub
parent 96b5403d14
commit a1e1189f9d
237 changed files with 30983 additions and 23563 deletions

167
pnpm-lock.yaml generated
View File

@@ -592,6 +592,12 @@ importers:
'@esengine/engine-core':
specifier: workspace:*
version: link:../engine-core
'@esengine/fairygui':
specifier: workspace:*
version: link:../fairygui
'@esengine/fairygui-editor':
specifier: workspace:*
version: link:../fairygui-editor
'@esengine/material-editor':
specifier: workspace:*
version: link:../material-editor
@@ -634,12 +640,6 @@ importers:
'@esengine/tilemap-editor':
specifier: workspace:*
version: link:../tilemap-editor
'@esengine/ui':
specifier: workspace:*
version: link:../ui
'@esengine/ui-editor':
specifier: workspace:*
version: link:../ui-editor
'@monaco-editor/react':
specifier: ^4.7.0
version: 4.7.0(monaco-editor@0.55.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
@@ -871,9 +871,9 @@ importers:
'@esengine/engine-core':
specifier: workspace:*
version: link:../engine-core
'@esengine/ui':
'@esengine/fairygui':
specifier: workspace:*
version: link:../ui
version: link:../fairygui
'@types/react':
specifier: ^18.3.12
version: 18.3.27
@@ -936,6 +936,80 @@ importers:
specifier: ^5.3.3
version: 5.9.3
packages/fairygui:
dependencies:
'@esengine/asset-system':
specifier: workspace:*
version: link:../asset-system
'@esengine/ecs-framework-math':
specifier: workspace:*
version: link:../math
devDependencies:
'@esengine/build-config':
specifier: workspace:*
version: link:../build-config
'@esengine/ecs-engine-bindgen':
specifier: workspace:*
version: link:../ecs-engine-bindgen
'@esengine/ecs-framework':
specifier: workspace:*
version: link:../core
'@esengine/engine-core':
specifier: workspace:*
version: link:../engine-core
'@esengine/material-system':
specifier: workspace:*
version: link:../material-system
rimraf:
specifier: ^5.0.5
version: 5.0.10
tsup:
specifier: ^8.0.0
version: 8.5.1(@microsoft/api-extractor@7.55.1(@types/node@20.19.25))(@swc/core@1.15.3)(jiti@2.6.1)(postcss@8.5.6)(typescript@5.9.3)(yaml@2.8.1)
typescript:
specifier: ^5.3.3
version: 5.9.3
packages/fairygui-editor:
dependencies:
'@esengine/fairygui':
specifier: workspace:*
version: link:../fairygui
devDependencies:
'@esengine/asset-system':
specifier: workspace:*
version: link:../asset-system
'@esengine/build-config':
specifier: workspace:*
version: link:../build-config
'@esengine/ecs-framework':
specifier: workspace:*
version: link:../core
'@esengine/editor-core':
specifier: workspace:*
version: link:../editor-core
'@esengine/engine-core':
specifier: workspace:*
version: link:../engine-core
'@types/react':
specifier: ^18.3.12
version: 18.3.27
lucide-react:
specifier: ^0.545.0
version: 0.545.0(react@18.3.1)
react:
specifier: ^18.3.1
version: 18.3.1
rimraf:
specifier: ^5.0.5
version: 5.0.10
tsup:
specifier: ^8.0.0
version: 8.5.1(@microsoft/api-extractor@7.55.1(@types/node@20.19.25))(@swc/core@1.15.3)(jiti@2.6.1)(postcss@8.5.6)(typescript@5.9.3)(yaml@2.8.1)
typescript:
specifier: ^5.3.3
version: 5.9.3
packages/material-editor:
dependencies:
'@esengine/material-system':
@@ -1394,6 +1468,9 @@ importers:
'@esengine/engine-core':
specifier: workspace:*
version: link:../engine-core
'@esengine/fairygui':
specifier: workspace:*
version: link:../fairygui
'@esengine/particle':
specifier: workspace:*
version: link:../particle
@@ -1406,9 +1483,6 @@ importers:
'@esengine/tilemap':
specifier: workspace:*
version: link:../tilemap
'@esengine/ui':
specifier: workspace:*
version: link:../ui
devDependencies:
'@esengine/build-config':
specifier: workspace:*
@@ -1608,77 +1682,6 @@ importers:
specifier: ^5.0.8
version: 5.0.8(@types/react@18.3.27)(react@18.3.1)(use-sync-external-store@1.6.0(react@18.3.1))
packages/ui:
dependencies:
'@esengine/asset-system':
specifier: workspace:*
version: link:../asset-system
devDependencies:
'@esengine/build-config':
specifier: workspace:*
version: link:../build-config
'@esengine/ecs-engine-bindgen':
specifier: workspace:*
version: link:../ecs-engine-bindgen
'@esengine/ecs-framework':
specifier: workspace:*
version: link:../core
'@esengine/engine-core':
specifier: workspace:*
version: link:../engine-core
'@esengine/material-system':
specifier: workspace:*
version: link:../material-system
rimraf:
specifier: ^5.0.5
version: 5.0.10
tsup:
specifier: ^8.0.0
version: 8.5.1(@microsoft/api-extractor@7.55.1(@types/node@20.19.25))(@swc/core@1.15.3)(jiti@2.6.1)(postcss@8.5.6)(typescript@5.9.3)(yaml@2.8.1)
typescript:
specifier: ^5.3.3
version: 5.9.3
packages/ui-editor:
dependencies:
'@esengine/ui':
specifier: workspace:*
version: link:../ui
devDependencies:
'@esengine/build-config':
specifier: workspace:*
version: link:../build-config
'@esengine/ecs-framework':
specifier: workspace:*
version: link:../core
'@esengine/editor-core':
specifier: workspace:*
version: link:../editor-core
'@esengine/editor-runtime':
specifier: workspace:*
version: link:../editor-runtime
'@esengine/material-system':
specifier: workspace:*
version: link:../material-system
'@types/react':
specifier: ^18.3.12
version: 18.3.27
lucide-react:
specifier: ^0.545.0
version: 0.545.0(react@18.3.1)
react:
specifier: ^18.3.1
version: 18.3.1
rimraf:
specifier: ^5.0.5
version: 5.0.10
tsup:
specifier: ^8.0.0
version: 8.5.1(@microsoft/api-extractor@7.55.1(@types/node@20.19.25))(@swc/core@1.15.3)(jiti@2.6.1)(postcss@8.5.6)(typescript@5.9.3)(yaml@2.8.1)
typescript:
specifier: ^5.3.3
version: 5.9.3
packages/worker-generator:
dependencies:
chalk: