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

@@ -0,0 +1,62 @@
{
"name": "{{fullName}}",
"version": "1.0.0",
"description": "{{description}}",
"type": "module",
"main": "dist/index.js",
"module": "dist/index.js",
"types": "dist/index.d.ts",
"exports": {
".": {
"types": "./dist/index.d.ts",
"import": "./dist/index.js"
},
"./runtime": {
"types": "./dist/runtime.d.ts",
"import": "./dist/runtime.js"
},
"./editor": {
"types": "./dist/editor/index.d.ts",
"import": "./dist/editor/index.js"
},
"./plugin.json": "./plugin.json"
},
"files": [
"dist",
"plugin.json"
],
"scripts": {
"build": "tsup",
"build:watch": "tsup --watch",
"clean": "rimraf dist",
"type-check": "tsc --noEmit"
},
"peerDependencies": {
"@esengine/ecs-framework": "{{depVersion}}",
"@esengine/ecs-components": "{{depVersion}}",
"@esengine/editor-core": "{{depVersion}}",
"react": "^18.3.1"
},
"peerDependenciesMeta": {
"@esengine/editor-core": {
"optional": true
},
"react": {
"optional": true
}
},
"devDependencies": {
"@esengine/build-config": "{{depVersion}}",
"@types/react": "^18.3.12",
"rimraf": "^5.0.5",
"tsup": "^8.0.0",
"typescript": "^5.8.3"
},
"keywords": [
"ecs",
"esengine",
"plugin"
],
"author": "",
"license": "MIT"
}

View File

@@ -0,0 +1,22 @@
{
"id": "{{fullName}}",
"name": "{{displayName}}",
"version": "1.0.0",
"category": "{{category}}",
"enabledByDefault": true,
"isEnginePlugin": false,
"modules": [
{
"name": "{{pascalName}}Runtime",
"type": "runtime",
"entry": "./src/runtime.ts"
},
{
"name": "{{pascalName}}Editor",
"type": "editor",
"entry": "./src/editor/index.ts"
}
],
"components": [],
"dependencies": []
}

View File

@@ -0,0 +1,49 @@
/**
* {{displayName}} Runtime Module
*
* 运行时模块 - 负责注册组件、服务和系统
*/
import type {
IRuntimeModuleLoader,
IComponentRegistry,
SystemContext
} from '@esengine/ecs-components';
import type { IScene, ServiceContainer } from '@esengine/ecs-framework';
export class {{name}}RuntimeModule implements IRuntimeModuleLoader {
/**
* 注册组件到组件注册表
*/
registerComponents(registry: IComponentRegistry): void {
// registry.register(MyComponent);
}
/**
* 注册服务到服务容器
*/
registerServices?(services: ServiceContainer): void {
// services.registerSingleton(MyService);
}
/**
* 初始化回调
*/
async onInitialize?(): Promise<void> {
// 执行初始化逻辑
}
/**
* 为场景创建系统
*/
createSystems?(scene: IScene, context: SystemContext): void {
// scene.addSystem(new MySystem());
}
/**
* 系统创建完成后的回调,用于连接跨插件依赖
*/
onSystemsCreated?(scene: IScene, context: SystemContext): void {
// 连接跨插件依赖
}
}

View File

@@ -0,0 +1,34 @@
/**
* {{displayName}} Plugin
*
* 插件定义 - 注册编辑器模块Inspector、工具等
*/
import type { IPluginLoader, PluginDescriptor, IEditorModuleLoader } from '@esengine/ecs-components';
import { {{name}}RuntimeModule } from '../{{name}}RuntimeModule';
class {{name}}EditorModule implements IEditorModuleLoader {
registerInspectors(registry: any): void {
// 注册组件 Inspector
// registry.register('MyComponent', MyComponentInspector);
}
}
const descriptor: PluginDescriptor = {
id: '@esengine/{{name}}',
name: '{{displayName}}',
version: '1.0.0',
category: '{{category}}',
enabledByDefault: true,
isEnginePlugin: false,
modules: [
{ name: '{{name}}Runtime', type: 'runtime', entry: './src/runtime.ts' },
{ name: '{{name}}Editor', type: 'editor', entry: './src/editor/index.ts' }
]
};
export const {{name}}Plugin: IPluginLoader = {
descriptor,
runtimeModule: new {{name}}RuntimeModule(),
editorModule: new {{name}}EditorModule()
};

View File

@@ -0,0 +1,13 @@
/**
* @esengine/{{name}} Editor Module
*
* 编辑器模块 - 包含 Inspector、工具等编辑器专用代码
* Editor module - contains Inspector, tools, and other editor-specific code
*
* This module can safely import React and editor-core packages.
*/
export { {{name}}Plugin } from './{{name}}Plugin';
// Inspectors
// export { MyComponentInspector } from './inspectors/MyComponentInspector';

View File

@@ -0,0 +1,14 @@
/**
* @esengine/{{name}}
*
* {{description}}
*
* 主入口 - 导出所有内容(包括编辑器模块)
* Main entry - exports everything (including editor modules)
*/
// Runtime exports (always available)
export * from './runtime';
// Editor exports (only in editor environment)
export { {{name}}Plugin } from './editor';

View File

@@ -0,0 +1,17 @@
/**
* @esengine/{{name}} Runtime Entry Point
*
* 运行时入口 - 仅导出运行时代码,不包含任何编辑器依赖
* Runtime entry - exports only runtime code without any editor dependencies
*
* IMPORTANT: Do not import React or any editor packages here!
*/
// Components
// export { MyComponent } from './components/MyComponent';
// Systems
// export { MySystem } from './systems/MySystem';
// Runtime Module
export { {{name}}RuntimeModule } from './{{name}}RuntimeModule';

View File

@@ -0,0 +1,23 @@
{
"compilerOptions": {
"target": "ES2020",
"module": "ES2020",
"moduleResolution": "bundler",
"lib": ["ES2020", "DOM"],
"outDir": "./dist",
"rootDir": "./src",
"strict": true,
"esModuleInterop": true,
"allowSyntheticDefaultImports": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"declaration": true,
"declarationMap": true,
"jsx": "react-jsx",
"resolveJsonModule": true,
"experimentalDecorators": true,
"emitDecoratorMetadata": true
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist"]
}

View File

@@ -0,0 +1,20 @@
{
"compilerOptions": {
"target": "ES2020",
"module": "ESNext",
"moduleResolution": "bundler",
"lib": ["ES2020", "DOM"],
"strict": true,
"esModuleInterop": true,
"allowSyntheticDefaultImports": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"noEmit": true,
"jsx": "react-jsx",
"resolveJsonModule": true,
"experimentalDecorators": true,
"emitDecoratorMetadata": true
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist"]
}

View File

@@ -0,0 +1,7 @@
import { defineConfig } from 'tsup';
import { pluginPreset } from '@esengine/build-config/presets/tsup';
export default defineConfig({
...pluginPreset(),
tsconfig: 'tsconfig.build.json'
});

View File

@@ -0,0 +1,38 @@
{
"name": "{{fullName}}",
"version": "1.0.0",
"description": "{{description}}",
"type": "module",
"main": "dist/index.js",
"module": "dist/index.js",
"types": "dist/index.d.ts",
"exports": {
".": {
"types": "./dist/index.d.ts",
"import": "./dist/index.js"
}
},
"files": [
"dist"
],
"scripts": {
"build": "tsup",
"build:watch": "tsup --watch",
"clean": "rimraf dist",
"type-check": "tsc --noEmit"
},
"peerDependencies": {
"@esengine/ecs-framework": "{{depVersion}}"
},
"devDependencies": {
"@esengine/build-config": "{{depVersion}}",
"rimraf": "^5.0.5",
"tsup": "^8.0.0",
"typescript": "^5.8.3"
},
"keywords": [
"ecs"
],
"author": "",
"license": "MIT"
}

View File

@@ -0,0 +1,8 @@
/**
* @esengine/{{name}}
*
* {{description}}
*/
// Export your public API here
export {};

View File

@@ -0,0 +1,22 @@
{
"compilerOptions": {
"target": "ES2020",
"module": "ES2020",
"moduleResolution": "bundler",
"lib": ["ES2020", "DOM"],
"outDir": "./dist",
"rootDir": "./src",
"strict": true,
"esModuleInterop": true,
"allowSyntheticDefaultImports": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"declaration": true,
"declarationMap": true,
"resolveJsonModule": true,
"experimentalDecorators": true,
"emitDecoratorMetadata": true
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist"]
}

View File

@@ -0,0 +1,19 @@
{
"compilerOptions": {
"target": "ES2020",
"module": "ESNext",
"moduleResolution": "bundler",
"lib": ["ES2020", "DOM"],
"strict": true,
"esModuleInterop": true,
"allowSyntheticDefaultImports": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"noEmit": true,
"resolveJsonModule": true,
"experimentalDecorators": true,
"emitDecoratorMetadata": true
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist"]
}

View File

@@ -0,0 +1,7 @@
import { defineConfig } from 'tsup';
import { runtimeOnlyPreset } from '@esengine/build-config/presets/tsup';
export default defineConfig({
...runtimeOnlyPreset(),
tsconfig: 'tsconfig.build.json'
});