Feature/editor optimization (#251)

* refactor: 编辑器/运行时架构拆分与构建系统升级

* feat(core): 层级系统重构与UI变换矩阵修复

* refactor: 移除 ecs-components 聚合包并修复跨包组件查找问题

* fix(physics): 修复跨包组件类引用问题

* feat: 统一运行时架构与浏览器运行支持

* feat(asset): 实现浏览器运行时资产加载系统

* fix: 修复文档、CodeQL安全问题和CI类型检查错误

* fix: 修复文档、CodeQL安全问题和CI类型检查错误

* fix: 修复文档、CodeQL安全问题、CI类型检查和测试错误

* test: 补齐核心模块测试用例,修复CI构建配置

* fix: 修复测试用例中的类型错误和断言问题

* fix: 修复 turbo build:npm 任务的依赖顺序问题

* fix: 修复 CI 构建错误并优化构建性能
This commit is contained in:
YHH
2025-12-01 22:28:51 +08:00
committed by GitHub
parent 189714c727
commit b42a7b4e43
468 changed files with 18301 additions and 9075 deletions

View File

@@ -1,54 +1,31 @@
/**
* Physics 2D Runtime Module
* 2D 物理运行时模块
*
* 提供确定性 2D 物理模拟功能
*/
import type { IScene, ServiceContainer } from '@esengine/ecs-framework';
import { ComponentRegistry } from '@esengine/ecs-framework';
import type { IRuntimeModuleLoader, SystemContext } from '@esengine/ecs-components';
import type { IRuntimeModule, IPlugin, PluginDescriptor, SystemContext } from '@esengine/engine-core';
import * as RAPIER from '@dimforge/rapier2d-compat';
// Components
import { Rigidbody2DComponent } from './components/Rigidbody2DComponent';
import { BoxCollider2DComponent } from './components/BoxCollider2DComponent';
import { CircleCollider2DComponent } from './components/CircleCollider2DComponent';
import { CapsuleCollider2DComponent } from './components/CapsuleCollider2DComponent';
import { PolygonCollider2DComponent } from './components/PolygonCollider2DComponent';
// Systems
import { Physics2DSystem } from './systems/Physics2DSystem';
// Services
import { Physics2DService } from './services/Physics2DService';
/**
* Physics 2D Runtime Module
* 2D 物理运行时模块
*
* 实现 IRuntimeModuleLoader 接口,提供:
* - 物理组件注册
* - 物理系统创建
* - Rapier2D 初始化
*/
export class PhysicsRuntimeModule implements IRuntimeModuleLoader {
export interface PhysicsSystemContext extends SystemContext {
physicsSystem?: Physics2DSystem;
physics2DWorld?: any;
physicsConfig?: any;
}
class PhysicsRuntimeModule implements IRuntimeModule {
private _rapierModule: typeof RAPIER | null = null;
private _physicsSystem: Physics2DSystem | null = null;
/**
* 初始化模块
* 异步初始化 Rapier2D WASM 模块
*/
async onInitialize(): Promise<void> {
// 初始化 Rapier2D WASM
await RAPIER.init();
this._rapierModule = RAPIER;
}
/**
* 注册组件
*/
registerComponents(registry: typeof ComponentRegistry): void {
registry.register(Rigidbody2DComponent);
registry.register(BoxCollider2DComponent);
@@ -57,61 +34,56 @@ export class PhysicsRuntimeModule implements IRuntimeModuleLoader {
registry.register(PolygonCollider2DComponent);
}
/**
* 注册服务
*/
registerServices?(services: ServiceContainer): void {
// 注册物理服务
registerServices(services: ServiceContainer): void {
services.registerSingleton(Physics2DService);
}
/**
* 创建系统
*/
createSystems(scene: IScene, context: SystemContext): void {
// 创建物理系统
const physicsContext = context as PhysicsSystemContext;
const physicsSystem = new Physics2DSystem({
physics: context.physicsConfig,
updateOrder: -1000 // 在其他系统之前运行
physics: physicsContext.physicsConfig,
updateOrder: -1000
});
scene.addSystem(physicsSystem);
this._physicsSystem = physicsSystem;
// 如果 Rapier 已加载,初始化物理系统
if (this._rapierModule) {
physicsSystem.initializeWithRapier(this._rapierModule);
}
// 导出到上下文供其他系统使用
context.physicsSystem = physicsSystem;
context.physics2DWorld = physicsSystem.world;
physicsContext.physicsSystem = physicsSystem;
physicsContext.physics2DWorld = physicsSystem.world;
}
/**
* 销毁模块
*/
onDestroy(): void {
this._physicsSystem = null;
this._rapierModule = null;
}
/**
* 获取 Rapier 模块
*/
getRapierModule(): typeof RAPIER | null {
return this._rapierModule;
}
/**
* 获取物理系统
*/
getPhysicsSystem(): Physics2DSystem | null {
return this._physicsSystem;
}
}
/**
* 默认导出模块实例
*/
export default new PhysicsRuntimeModule();
const descriptor: PluginDescriptor = {
id: '@esengine/physics-rapier2d',
name: 'Physics 2D',
version: '1.0.0',
description: 'Deterministic 2D physics with Rapier2D',
category: 'physics',
enabledByDefault: true,
isEnginePlugin: true
};
export const PhysicsPlugin: IPlugin = {
descriptor,
runtimeModule: new PhysicsRuntimeModule()
};
export { PhysicsRuntimeModule };