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/sprite-editor/src/index.ts
+++ b/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;