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

View File

@@ -9,6 +9,7 @@
import { useEffect, useRef } from 'react';
import { Core, HierarchyComponent, PrefabInstanceComponent } from '@esengine/ecs-framework';
import type { MessageHub, EntityStoreService, SceneManagerService } from '@esengine/editor-core';
import { VirtualNodeRegistry } from '@esengine/editor-core';
import { useHierarchyStore } from '../stores/HierarchyStore';
import { useInspectorStore } from '../stores/InspectorStore';
import { getProfilerService } from '../services/getService';
@@ -285,6 +286,7 @@ export function useStoreSubscriptions({
setRemoteEntityTarget,
setAssetFileTarget,
setExtensionTarget,
setVirtualNodeTarget,
clearTarget,
updateRemoteEntityDetails,
incrementComponentVersion,
@@ -306,6 +308,9 @@ export function useStoreSubscriptions({
// 实体选择处理 | Handle entity selection
const handleEntitySelection = (data: { entity: any | null }) => {
// Clear virtual node selection when selecting an entity
// 选择实体时清除虚拟节点选择
VirtualNodeRegistry.clearSelectedVirtualNode();
if (data.entity) {
setEntityTarget(data.entity);
} else {
@@ -336,6 +341,18 @@ export function useStoreSubscriptions({
setExtensionTarget(data.data as Record<string, unknown>);
};
// 虚拟节点选择处理 | Handle virtual node selection
const handleVirtualNodeSelection = (data: {
parentEntityId: number;
virtualNodeId: string;
virtualNode: any;
}) => {
// Update VirtualNodeRegistry for Gizmo highlighting
// 更新 VirtualNodeRegistry 用于 Gizmo 高亮
VirtualNodeRegistry.setSelectedVirtualNode(data.parentEntityId, data.virtualNodeId);
setVirtualNodeTarget(data.parentEntityId, data.virtualNodeId, data.virtualNode);
};
// 资产文件选择处理 | Handle asset file selection
const handleAssetFileSelection = async (data: { fileInfo: AssetFileInfo }) => {
const fileInfo = data.fileInfo;
@@ -382,6 +399,7 @@ export function useStoreSubscriptions({
const unsubSceneRestored = messageHub.subscribe('scene:restored', handleSceneRestored);
const unsubRemoteSelect = messageHub.subscribe('remote-entity:selected', handleRemoteEntitySelection);
const unsubNodeSelect = messageHub.subscribe('behavior-tree:node-selected', handleExtensionSelection);
const unsubVirtualNodeSelect = messageHub.subscribe('virtual-node:selected', handleVirtualNodeSelection);
const unsubAssetFileSelect = messageHub.subscribe('asset-file:selected', handleAssetFileSelection);
const unsubComponentAdded = messageHub.subscribe('component:added', incrementComponentVersion);
const unsubComponentRemoved = messageHub.subscribe('component:removed', incrementComponentVersion);
@@ -394,6 +412,7 @@ export function useStoreSubscriptions({
unsubSceneRestored();
unsubRemoteSelect();
unsubNodeSelect();
unsubVirtualNodeSelect();
unsubAssetFileSelect();
unsubComponentAdded();
unsubComponentRemoved();