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:
@@ -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');
|
||||
|
||||
/**
|
||||
* 属性装饰器 - 声明组件属性的编辑器元数据
|
||||
|
||||
@@ -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();
|
||||
|
||||
@@ -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) {
|
||||
|
||||
Reference in New Issue
Block a user