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 构建错误并优化构建性能
2025-12-01 22:28:51 +08:00
parent 189714c727
commit b42a7b4e43
468 changed files with 18301 additions and 9075 deletions
--- a/packages/ecs-engine-bindgen/package.json
+++ b/packages/ecs-engine-bindgen/package.json
@@ -2,25 +2,23 @@
    "name": "@esengine/ecs-engine-bindgen",
    "version": "0.1.0",
    "description": "Bridge layer between ECS Framework and Rust Engine | ECS框架与Rust引擎之间的桥接层",
-    "main": "bin/index.js",
-    "module": "bin/index.js",
-    "types": "bin/index.d.ts",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "type": "module",
    "exports": {
        ".": {
-            "types": "./bin/index.d.ts",
-            "import": "./bin/index.js",
-            "require": "./bin/index.js",
-            "default": "./bin/index.js"
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
        }
    },
    "files": [
-        "bin",
        "dist"
    ],
    "scripts": {
-        "build": "tsc",
-        "build:watch": "tsc --watch",
-        "clean": "rimraf bin dist"
+        "build": "tsup",
+        "build:watch": "tsup --watch",
+        "clean": "rimraf dist"
    },
    "repository": {
        "type": "git",
@@ -36,15 +34,16 @@
    ],
    "author": "ESEngine Team",
    "license": "MIT",
-    "peerDependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/ecs-components": "workspace:*",
-        "@esengine/asset-system": "workspace:*"
-    },
    "optionalDependencies": {
        "es-engine": "file:../engine/pkg"
    },
    "devDependencies": {
+        "@esengine/ecs-framework": "workspace:*",
+        "@esengine/engine-core": "workspace:*",
+        "@esengine/sprite": "workspace:*",
+        "@esengine/camera": "workspace:*",
+        "@esengine/asset-system": "workspace:*",
+        "tsup": "^8.5.1",
        "typescript": "^5.8.0",
        "rimraf": "^5.0.0"
    }
--- a/packages/ecs-engine-bindgen/src/core/SpriteRenderHelper.ts
+++ b/packages/ecs-engine-bindgen/src/core/SpriteRenderHelper.ts
@@ -6,7 +6,7 @@
 import { Entity, Component } from '@esengine/ecs-framework';
 import type { EngineBridge } from './EngineBridge';
 import { RenderBatcher } from './RenderBatcher';
-import { SpriteComponent } from '@esengine/ecs-components';
+import { SpriteComponent } from '@esengine/sprite';
 import type { SpriteRenderData } from '../types';

 /**
@@ -20,6 +20,12 @@ export interface ITransformComponent {
    position: { x: number; y: number; z?: number };
    rotation: number | { x: number; y: number; z: number };
    scale: { x: number; y: number; z?: number };
+    /** 世界位置（由 TransformSystem 计算，考虑父级变换） */
+    worldPosition?: { x: number; y: number; z?: number };
+    /** 世界旋转（由 TransformSystem 计算，考虑父级变换） */
+    worldRotation?: { x: number; y: number; z: number };
+    /** 世界缩放（由 TransformSystem 计算，考虑父级变换） */
+    worldScale?: { x: number; y: number; z?: number };
 }

 /**
--- a/packages/ecs-engine-bindgen/src/index.ts
+++ b/packages/ecs-engine-bindgen/src/index.ts
@@ -5,9 +5,11 @@
 * @packageDocumentation
 */

-export { EngineBridge, EngineBridgeConfig } from './core/EngineBridge';
+export { EngineBridge } from './core/EngineBridge';
+export type { EngineBridgeConfig } from './core/EngineBridge';
 export { RenderBatcher } from './core/RenderBatcher';
-export { SpriteRenderHelper, ITransformComponent } from './core/SpriteRenderHelper';
+export { SpriteRenderHelper } from './core/SpriteRenderHelper';
+export type { ITransformComponent } from './core/SpriteRenderHelper';
 export { EngineRenderSystem, type TransformComponentType, type IRenderDataProvider, type IUIRenderDataProvider, type GizmoDataProviderFn, type HasGizmoProviderFn, type ProviderRenderData } from './systems/EngineRenderSystem';
 export { CameraSystem } from './systems/CameraSystem';
 export * from './types';
--- a/packages/ecs-engine-bindgen/src/systems/CameraSystem.ts
+++ b/packages/ecs-engine-bindgen/src/systems/CameraSystem.ts
@@ -4,7 +4,7 @@
 */

 import { EntitySystem, Matcher, Entity, ECSSystem } from '@esengine/ecs-framework';
-import { CameraComponent } from '@esengine/ecs-components';
+import { CameraComponent } from '@esengine/camera';
 import type { EngineBridge } from '../core/EngineBridge';

@ECSSystem('Camera', { updateOrder: -100 })
--- a/packages/ecs-engine-bindgen/src/systems/EngineRenderSystem.ts
+++ b/packages/ecs-engine-bindgen/src/systems/EngineRenderSystem.ts
@@ -4,7 +4,9 @@
 */

 import { EntitySystem, Matcher, Entity, ComponentType, ECSSystem, Component, Core } from '@esengine/ecs-framework';
-import { SpriteComponent, CameraComponent, TransformComponent } from '@esengine/ecs-components';
+import { TransformComponent } from '@esengine/engine-core';
+import { SpriteComponent } from '@esengine/sprite';
+import { CameraComponent } from '@esengine/camera';
 import type { EngineBridge } from '../core/EngineBridge';
 import { RenderBatcher } from '../core/RenderBatcher';
 import type { SpriteRenderData } from '../types';
@@ -269,10 +271,12 @@ export class EngineRenderSystem extends EntitySystem {
                }
            }

-            // Handle rotation as number or Vector3 (use z for 2D)
-            const rotation = typeof transform.rotation === 'number'
-                ? transform.rotation
-                : transform.rotation.z;
+            // 使用世界变换（由 TransformSystem 计算，考虑父级变换），回退到本地变换
+            const pos = transform.worldPosition ?? transform.position;
+            const scl = transform.worldScale ?? transform.scale;
+            const rot = transform.worldRotation
+                ? transform.worldRotation.z
+                : (typeof transform.rotation === 'number' ? transform.rotation : transform.rotation.z);

            // Convert hex color string to packed RGBA | 将十六进制颜色字符串转换为打包的RGBA
            const color = this.hexToPackedColor(sprite.color, sprite.alpha);
@@ -286,14 +290,14 @@ export class EngineRenderSystem extends EntitySystem {
                textureId = this.bridge.getOrLoadTextureByPath(sprite.texture);
            }

-            // Pass actual display dimensions (sprite size * transform scale)
-            // 传递实际显示尺寸（sprite尺寸 * 变换缩放）
+            // Pass actual display dimensions (sprite size * world transform scale)
+            // 传递实际显示尺寸（sprite尺寸 * 世界变换缩放）
            const renderData: SpriteRenderData = {
-                x: transform.position.x,
-                y: transform.position.y,
-                rotation,
-                scaleX: sprite.width * transform.scale.x,
-                scaleY: sprite.height * transform.scale.y,
+                x: pos.x,
+                y: pos.y,
+                rotation: rot,
+                scaleX: sprite.width * scl.x,
+                scaleY: sprite.height * scl.y,
                originX: sprite.anchorX,
                originY: sprite.anchorY,
                textureId,
--- a/packages/ecs-engine-bindgen/tsconfig.build.json
+++ b/packages/ecs-engine-bindgen/tsconfig.build.json
@@ -0,0 +1,10 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "composite": false,
+        "declaration": true,
+        "declarationMap": true,
+        "outDir": "./dist"
+    },
+    "exclude": ["node_modules", "dist", "bin", "**/*.test.ts"]
+}
--- a/packages/ecs-engine-bindgen/tsconfig.json
+++ b/packages/ecs-engine-bindgen/tsconfig.json
@@ -1,22 +1,9 @@
 {
+    "extends": "../../tsconfig.base.json",
    "compilerOptions": {
-        "target": "ES2020",
-        "module": "ES2020",
-        "lib": ["ES2020", "DOM"],
-        "declaration": true,
-        "declarationMap": true,
-        "sourceMap": true,
-        "outDir": "./bin",
-        "rootDir": "./src",
-        "strict": true,
        "composite": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "moduleResolution": "node",
-        "resolveJsonModule": true,
-        "experimentalDecorators": true,
-        "emitDecoratorMetadata": true
+        "outDir": "./dist",
+        "rootDir": "./src"
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules", "bin", "dist"]
--- a/packages/ecs-engine-bindgen/tsup.config.ts
+++ b/packages/ecs-engine-bindgen/tsup.config.ts
@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup';
+import { runtimeOnlyPreset } from '../build-config/src/presets/plugin-tsup';
+
+export default defineConfig({
+    ...runtimeOnlyPreset({
+        external: ['es-engine']
+    }),
+    tsconfig: 'tsconfig.build.json'
+});