Feature/runtime cdn and plugin loader (#240)

* feat(ui): 完善 UI 布局系统和编辑器可视化工具

* refactor: 移除 ModuleRegistry,统一使用 PluginManager 插件系统

* fix: 修复 CodeQL 警告并提升测试覆盖率

* refactor: 分离运行时入口点,解决 runtime bundle 包含 React 的问题

* fix(ci): 添加 editor-core 和 editor-runtime 到 CI 依赖构建步骤

* docs: 完善 ServiceContainer 文档,新增 Symbol.for 模式和 @InjectProperty 说明

* fix(ci): 修复 type-check 失败问题

* fix(ci): 修复类型检查失败问题

* fix(ci): 修复类型检查失败问题

* fix(ci): behavior-tree 构建添加 @tauri-apps 外部依赖

* fix(ci): behavior-tree 添加 @tauri-apps/plugin-fs 类型依赖

* fix(ci): platform-web 添加缺失的 behavior-tree 依赖

* fix(lint): 移除正则表达式中不必要的转义字符
This commit is contained in:
YHH
2025-11-27 20:42:46 +08:00
committed by GitHub
parent 71869b1a58
commit 107439d70c
367 changed files with 10661 additions and 12473 deletions

View File

@@ -146,7 +146,9 @@ export type PropertyOptions =
| AssetPropertyOptions
| AnimationClipsPropertyOptions;
export const PROPERTY_METADATA = Symbol('property:metadata');
// 使用 Symbol.for 创建全局 Symbol确保跨包共享元数据
// Use Symbol.for to create a global Symbol to ensure metadata sharing across packages
export const PROPERTY_METADATA = Symbol.for('@esengine/property:metadata');
/**
* 属性装饰器 - 声明组件属性的编辑器元数据

View File

@@ -284,6 +284,11 @@ export abstract class EntitySystem implements ISystemBase, IService {
const querySystem = this.scene.querySystem;
let currentEntities: readonly Entity[] = [];
// matchNothing 条件返回空数组(用于只需要生命周期方法的系统)
if (this._matcher.isNothing()) {
return [];
}
// 空条件返回所有实体
if (this._matcher.isEmpty()) {
currentEntities = querySystem.getAllEntities();

View File

@@ -11,6 +11,7 @@ export interface QueryCondition {
tag?: number; // 按标签查询
name?: string; // 按名称查询
component?: ComponentType; // 单组件查询
matchNothing?: boolean; // 不匹配任何实体
}
/**
@@ -107,6 +108,34 @@ export class Matcher {
return new Matcher();
}
/**
* 创建不匹配任何实体的匹配器
* 用于只需要 onBegin/onEnd 生命周期方法但不需要处理实体的系统
*
* @example
* ```typescript
* // 创建一个只在帧开始时执行的系统
* class FrameBeginSystem extends EntitySystem {
* constructor() {
* super(Matcher.nothing());
* }
*
* protected onBegin(): void {
* // 每帧开始时执行
* }
*
* protected process(entities: readonly Entity[]): void {
* // 永远不会被调用,因为没有实体匹配
* }
* }
* ```
*/
public static nothing(): Matcher {
const matcher = new Matcher();
matcher.condition.matchNothing = true;
return matcher;
}
/**
* 必须包含所有指定组件
* @param types 组件类型
@@ -211,12 +240,14 @@ export class Matcher {
none: [...this.condition.none],
...(this.condition.tag !== undefined && { tag: this.condition.tag }),
...(this.condition.name !== undefined && { name: this.condition.name }),
...(this.condition.component !== undefined && { component: this.condition.component })
...(this.condition.component !== undefined && { component: this.condition.component }),
...(this.condition.matchNothing && { matchNothing: true })
};
}
/**
* 检查是否为空条件
* 注意matchNothing 不算空条件,因为它是明确的"不匹配任何实体"语义
*/
public isEmpty(): boolean {
return this.condition.all.length === 0 &&
@@ -224,7 +255,15 @@ export class Matcher {
this.condition.none.length === 0 &&
this.condition.tag === undefined &&
this.condition.name === undefined &&
this.condition.component === undefined;
this.condition.component === undefined &&
!this.condition.matchNothing;
}
/**
* 检查是否为"不匹配任何实体"的匹配器
*/
public isNothing(): boolean {
return this.condition.matchNothing === true;
}
/**
@@ -237,6 +276,7 @@ export class Matcher {
delete this.condition.tag;
delete this.condition.name;
delete this.condition.component;
delete this.condition.matchNothing;
return this;
}
@@ -257,6 +297,9 @@ export class Matcher {
if (this.condition.component !== undefined) {
cloned.condition.component = this.condition.component;
}
if (this.condition.matchNothing) {
cloned.condition.matchNothing = true;
}
return cloned;
}
@@ -264,6 +307,10 @@ export class Matcher {
* 字符串表示
*/
public toString(): string {
if (this.condition.matchNothing) {
return 'Matcher[nothing]';
}
const parts: string[] = [];
if (this.condition.all.length > 0) {