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 构建错误并优化构建性能

packages/sprite-editor/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "@esengine/sprite-editor",
+    "version": "1.0.0",
+    "description": "Editor components for sprite system",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "build:watch": "tsup --watch",
+        "type-check": "tsc --noEmit",
+        "clean": "rimraf dist"
+    },
+    "devDependencies": {
+        "@esengine/ecs-framework": "workspace:*",
+        "@esengine/engine-core": "workspace:*",
+        "@esengine/sprite": "workspace:*",
+        "@esengine/editor-core": "workspace:*",
+        "@esengine/build-config": "workspace:*",
+        "react": "^18.3.1",
+        "@types/react": "^18.2.0",
+        "rimraf": "^5.0.5",
+        "tsup": "^8.0.0",
+        "typescript": "^5.3.3"
+    },
+    "keywords": [
+        "ecs",
+        "sprite",
+        "editor",
+        "animation"
+    ],
+    "author": "yhh",
+    "license": "MIT"
+}

packages/sprite-editor/src/index.ts

@@ -0,0 +1,147 @@
+/**
+ * @esengine/sprite-editor
+ *
+ * Editor support for @esengine/sprite - inspectors, field editors, and entity templates
+ * 精灵编辑器支持 - 检视器、字段编辑器和实体模板
+ */
+
+import type { Entity, ServiceContainer } from '@esengine/ecs-framework';
+import { Core } from '@esengine/ecs-framework';
+import type {
+    IEditorModuleLoader,
+    EntityCreationTemplate
+} from '@esengine/editor-core';
+import {
+    EntityStoreService,
+    MessageHub,
+    ComponentRegistry
+} from '@esengine/editor-core';
+import { TransformComponent } from '@esengine/engine-core';
+
+// Runtime imports from @esengine/sprite
+import {
+    SpriteComponent,
+    SpriteAnimatorComponent
+} from '@esengine/sprite';
+
+/**
+ * 精灵编辑器模块
+ * Sprite Editor Module
+ */
+export class SpriteEditorModule implements IEditorModuleLoader {
+    async install(services: ServiceContainer): Promise<void> {
+        // 注册 Sprite 组件到编辑器组件注册表 | Register Sprite components to editor component registry
+        const componentRegistry = services.resolve(ComponentRegistry);
+        if (componentRegistry) {
+            const spriteComponents = [
+                {
+                    name: 'Sprite',
+                    type: SpriteComponent,
+                    category: 'components.category.rendering',
+                    description: '2D sprite rendering component',
+                    icon: 'Image'
+                },
+                {
+                    name: 'SpriteAnimator',
+                    type: SpriteAnimatorComponent,
+                    category: 'components.category.rendering',
+                    description: 'Sprite frame animation component',
+                    icon: 'Film'
+                },
+            ];
+
+            for (const comp of spriteComponents) {
+                componentRegistry.register({
+                    name: comp.name,
+                    type: comp.type,
+                    category: comp.category,
+                    description: comp.description,
+                    icon: comp.icon
+                });
+            }
+        }
+    }
+
+    async uninstall(): Promise<void> {
+        // Nothing to cleanup
+    }
+
+    getEntityCreationTemplates(): EntityCreationTemplate[] {
+        return [
+            // Sprite Entity
+            {
+                id: 'create-sprite',
+                label: 'Sprite',
+                icon: 'Image',
+                category: 'rendering',
+                order: 100,
+                create: (): number => {
+                    return this.createSpriteEntity('Sprite');
+                }
+            },
+
+            // Animated Sprite Entity
+            {
+                id: 'create-animated-sprite',
+                label: 'Animated Sprite',
+                icon: 'Film',
+                category: 'rendering',
+                order: 101,
+                create: (): number => {
+                    return this.createSpriteEntity('AnimatedSprite', (entity) => {
+                        const animator = new SpriteAnimatorComponent();
+                        animator.autoPlay = true;
+                        entity.addComponent(animator);
+                    });
+                }
+            },
+        ];
+    }
+
+    /**
+     * 创建 Sprite 实体的辅助方法
+     * Helper method to create Sprite entity
+     */
+    private createSpriteEntity(baseName: string, configure?: (entity: Entity) => void): number {
+        const scene = Core.scene;
+        if (!scene) {
+            throw new Error('Scene not available');
+        }
+
+        const entityStore = Core.services.resolve(EntityStoreService);
+        const messageHub = Core.services.resolve(MessageHub);
+
+        if (!entityStore || !messageHub) {
+            throw new Error('EntityStoreService or MessageHub not available');
+        }
+
+        const existingCount = entityStore.getAllEntities()
+            .filter((e: Entity) => e.name.startsWith(baseName)).length;
+        const entityName = existingCount > 0 ? `${baseName} ${existingCount + 1}` : baseName;
+
+        const entity = scene.createEntity(entityName);
+
+        // Add Transform component
+        const transform = new TransformComponent();
+        entity.addComponent(transform);
+
+        // Add Sprite component
+        const sprite = new SpriteComponent();
+        entity.addComponent(sprite);
+
+        if (configure) {
+            configure(entity);
+        }
+
+        entityStore.addEntity(entity);
+        messageHub.publish('entity:added', { entity });
+        messageHub.publish('scene:modified', {});
+        entityStore.selectEntity(entity);
+
+        return entity.id;
+    }
+}
+
+export const spriteEditorModule = new SpriteEditorModule();
+
+export default spriteEditorModule;

packages/sprite-editor/tsconfig.build.json

@@ -0,0 +1,13 @@
+{
+    "extends": "../../tsconfig.base.json",
+    "compilerOptions": {
+        "composite": false,
+        "declaration": true,
+        "declarationMap": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "jsx": "react-jsx"
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}

packages/sprite-editor/tsconfig.json

@@ -0,0 +1,16 @@
+{
+    "extends": "../../tsconfig.base.json",
+    "compilerOptions": {
+        "composite": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "jsx": "react-jsx"
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "dist"],
+    "references": [
+        { "path": "../core" },
+        { "path": "../sprite" },
+        { "path": "../editor-core" }
+    ]
+}

packages/sprite-editor/tsup.config.ts

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