@esengine/ecs-framework 2.2.20 → 2.3.0

package/bin/ECS/Systems/HierarchySystem.js

@@ -0,0 +1,498 @@
+import { EntitySystem } from './EntitySystem';
+import { Matcher } from '../Utils/Matcher';
+import { HierarchyComponent } from '../Components/HierarchyComponent';
+/**
+ * 层级关系系统 - 管理实体间的父子关系
+ *
+ * 提供层级操作的统一 API，维护层级缓存（depth、activeInHierarchy）。
+ * 所有层级操作应通过此系统进行，而非直接修改 HierarchyComponent。
+ *
+ * @example
+ * ```typescript
+ * const hierarchySystem = scene.getSystem(HierarchySystem);
+ *
+ * // 设置父子关系
+ * hierarchySystem.setParent(child, parent);
+ *
+ * // 查询层级
+ * const parent = hierarchySystem.getParent(entity);
+ * const children = hierarchySystem.getChildren(entity);
+ * const depth = hierarchySystem.getDepth(entity);
+ * ```
+ */
+export class HierarchySystem extends EntitySystem {
+    constructor() {
+        super(Matcher.empty().all(HierarchyComponent));
+        /**
+         * 脏实体集合 - 只有这些实体需要在 process() 中更新缓存
+         * Dirty entity set - only these entities need cache update in process()
+         */
+        this.dirtyEntities = new Set();
+    }
+    /**
+     * 系统优先级，确保在其他系统之前更新层级缓存
+     */
+    get updateOrder() {
+        return -1000;
+    }
+    process(_entities) {
+        // 只更新脏实体，不遍历所有实体 | Only update dirty entities, no full iteration
+        if (this.dirtyEntities.size === 0) {
+            return;
+        }
+        for (const entity of this.dirtyEntities) {
+            // 确保实体仍然有效 | Ensure entity is still valid
+            if (entity.scene) {
+                this.updateHierarchyCache(entity);
+            }
+        }
+        this.dirtyEntities.clear();
+    }
+    /**
+     * 设置实体的父级
+     *
+     * @param child - 子实体
+     * @param parent - 父实体，null 表示移动到根级
+     */
+    setParent(child, parent) {
+        let childHierarchy = child.getComponent(HierarchyComponent);
+        // 如果子实体没有 HierarchyComponent，自动添加
+        if (!childHierarchy) {
+            childHierarchy = new HierarchyComponent();
+            child.addComponent(childHierarchy);
+        }
+        // 检查是否需要变更
+        const currentParentId = childHierarchy.parentId;
+        const newParentId = parent?.id ?? null;
+        if (currentParentId === newParentId) {
+            return;
+        }
+        // 防止循环引用
+        if (parent && this.isAncestorOf(child, parent)) {
+            throw new Error('Cannot set parent: would create circular reference');
+        }
+        // 从旧父级移除
+        if (currentParentId !== null) {
+            const oldParent = this.scene?.findEntityById(currentParentId);
+            if (oldParent) {
+                const oldParentHierarchy = oldParent.getComponent(HierarchyComponent);
+                if (oldParentHierarchy) {
+                    const idx = oldParentHierarchy.childIds.indexOf(child.id);
+                    if (idx !== -1) {
+                        oldParentHierarchy.childIds.splice(idx, 1);
+                    }
+                }
+            }
+        }
+        // 添加到新父级
+        if (parent) {
+            let parentHierarchy = parent.getComponent(HierarchyComponent);
+            if (!parentHierarchy) {
+                parentHierarchy = new HierarchyComponent();
+                parent.addComponent(parentHierarchy);
+            }
+            childHierarchy.parentId = parent.id;
+            parentHierarchy.childIds.push(child.id);
+        }
+        else {
+            childHierarchy.parentId = null;
+        }
+        // 标记缓存脏
+        this.markCacheDirty(child);
+    }
+    /**
+     * 在指定位置插入子实体
+     *
+     * @param parent - 父实体
+     * @param child - 子实体
+     * @param index - 插入位置索引，-1 表示追加到末尾
+     */
+    insertChildAt(parent, child, index) {
+        let childHierarchy = child.getComponent(HierarchyComponent);
+        let parentHierarchy = parent.getComponent(HierarchyComponent);
+        // 自动添加 HierarchyComponent
+        if (!childHierarchy) {
+            childHierarchy = new HierarchyComponent();
+            child.addComponent(childHierarchy);
+        }
+        if (!parentHierarchy) {
+            parentHierarchy = new HierarchyComponent();
+            parent.addComponent(parentHierarchy);
+        }
+        // 防止循环引用
+        if (this.isAncestorOf(child, parent)) {
+            throw new Error('Cannot set parent: would create circular reference');
+        }
+        // 从旧父级移除
+        if (childHierarchy.parentId !== null && childHierarchy.parentId !== parent.id) {
+            const oldParent = this.scene?.findEntityById(childHierarchy.parentId);
+            if (oldParent) {
+                const oldParentHierarchy = oldParent.getComponent(HierarchyComponent);
+                if (oldParentHierarchy) {
+                    const idx = oldParentHierarchy.childIds.indexOf(child.id);
+                    if (idx !== -1) {
+                        oldParentHierarchy.childIds.splice(idx, 1);
+                    }
+                }
+            }
+        }
+        // 设置新父级
+        childHierarchy.parentId = parent.id;
+        // 从当前父级的子列表中移除（如果已存在）
+        const existingIdx = parentHierarchy.childIds.indexOf(child.id);
+        if (existingIdx !== -1) {
+            parentHierarchy.childIds.splice(existingIdx, 1);
+        }
+        // 插入到指定位置
+        if (index < 0 || index >= parentHierarchy.childIds.length) {
+            parentHierarchy.childIds.push(child.id);
+        }
+        else {
+            parentHierarchy.childIds.splice(index, 0, child.id);
+        }
+        // 标记缓存脏
+        this.markCacheDirty(child);
+    }
+    /**
+     * 移除子实体（将其移动到根级）
+     */
+    removeChild(parent, child) {
+        const parentHierarchy = parent.getComponent(HierarchyComponent);
+        const childHierarchy = child.getComponent(HierarchyComponent);
+        if (!parentHierarchy || !childHierarchy) {
+            return false;
+        }
+        if (childHierarchy.parentId !== parent.id) {
+            return false;
+        }
+        const idx = parentHierarchy.childIds.indexOf(child.id);
+        if (idx !== -1) {
+            parentHierarchy.childIds.splice(idx, 1);
+        }
+        childHierarchy.parentId = null;
+        this.markCacheDirty(child);
+        return true;
+    }
+    /**
+     * 移除所有子实体
+     */
+    removeAllChildren(parent) {
+        const parentHierarchy = parent.getComponent(HierarchyComponent);
+        if (!parentHierarchy)
+            return;
+        const childIds = [...parentHierarchy.childIds];
+        for (const childId of childIds) {
+            const child = this.scene?.findEntityById(childId);
+            if (child) {
+                this.removeChild(parent, child);
+            }
+        }
+    }
+    /**
+     * 获取实体的父级
+     */
+    getParent(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy || hierarchy.parentId === null) {
+            return null;
+        }
+        return this.scene?.findEntityById(hierarchy.parentId) ?? null;
+    }
+    /**
+     * 获取实体的子级列表
+     */
+    getChildren(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy)
+            return [];
+        const children = [];
+        for (const childId of hierarchy.childIds) {
+            const child = this.scene?.findEntityById(childId);
+            if (child) {
+                children.push(child);
+            }
+        }
+        return children;
+    }
+    /**
+     * 获取子级数量
+     */
+    getChildCount(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        return hierarchy?.childIds.length ?? 0;
+    }
+    /**
+     * 检查实体是否有子级
+     */
+    hasChildren(entity) {
+        return this.getChildCount(entity) > 0;
+    }
+    /**
+     * 检查 ancestor 是否是 entity 的祖先
+     */
+    isAncestorOf(ancestor, entity) {
+        let current = this.getParent(entity);
+        let depth = 0;
+        while (current && depth < HierarchySystem.MAX_DEPTH) {
+            if (current.id === ancestor.id) {
+                return true;
+            }
+            current = this.getParent(current);
+            depth++;
+        }
+        return false;
+    }
+    /**
+     * 检查 descendant 是否是 entity 的后代
+     */
+    isDescendantOf(descendant, entity) {
+        return this.isAncestorOf(entity, descendant);
+    }
+    /**
+     * 获取根实体
+     */
+    getRoot(entity) {
+        let current = entity;
+        let parent = this.getParent(current);
+        let depth = 0;
+        while (parent && depth < HierarchySystem.MAX_DEPTH) {
+            current = parent;
+            parent = this.getParent(current);
+            depth++;
+        }
+        return current;
+    }
+    /**
+     * 获取实体在层级中的深度
+     */
+    getDepth(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy)
+            return 0;
+        // 如果缓存有效，直接返回
+        if (!hierarchy.bCacheDirty) {
+            return hierarchy.depth;
+        }
+        // 重新计算
+        let depth = 0;
+        let current = this.getParent(entity);
+        while (current && depth < HierarchySystem.MAX_DEPTH) {
+            depth++;
+            current = this.getParent(current);
+        }
+        hierarchy.depth = depth;
+        return depth;
+    }
+    /**
+     * 检查实体在层级中是否激活
+     */
+    isActiveInHierarchy(entity) {
+        if (!entity.active)
+            return false;
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy)
+            return entity.active;
+        // 如果缓存有效，直接返回
+        if (!hierarchy.bCacheDirty) {
+            return hierarchy.bActiveInHierarchy;
+        }
+        // 重新计算
+        const parent = this.getParent(entity);
+        if (!parent) {
+            hierarchy.bActiveInHierarchy = entity.active;
+        }
+        else {
+            hierarchy.bActiveInHierarchy = entity.active && this.isActiveInHierarchy(parent);
+        }
+        return hierarchy.bActiveInHierarchy;
+    }
+    /**
+     * 获取所有根实体（没有父级的实体）
+     */
+    getRootEntities() {
+        const roots = [];
+        for (const entity of this.entities) {
+            const hierarchy = entity.getComponent(HierarchyComponent);
+            if (hierarchy && hierarchy.parentId === null) {
+                roots.push(entity);
+            }
+        }
+        return roots;
+    }
+    /**
+     * 根据名称查找子实体
+     *
+     * @param entity - 父实体
+     * @param name - 子实体名称
+     * @param bRecursive - 是否递归查找
+     */
+    findChild(entity, name, bRecursive = false) {
+        const children = this.getChildren(entity);
+        for (const child of children) {
+            if (child.name === name) {
+                return child;
+            }
+        }
+        if (bRecursive) {
+            for (const child of children) {
+                const found = this.findChild(child, name, true);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * 根据标签查找子实体
+     *
+     * @param entity - 父实体
+     * @param tag - 标签值
+     * @param bRecursive - 是否递归查找
+     */
+    findChildrenByTag(entity, tag, bRecursive = false) {
+        const result = [];
+        const children = this.getChildren(entity);
+        for (const child of children) {
+            if ((child.tag & tag) !== 0) {
+                result.push(child);
+            }
+            if (bRecursive) {
+                result.push(...this.findChildrenByTag(child, tag, true));
+            }
+        }
+        return result;
+    }
+    /**
+     * 遍历所有子级
+     *
+     * @param entity - 父实体
+     * @param callback - 回调函数
+     * @param bRecursive - 是否递归遍历
+     */
+    forEachChild(entity, callback, bRecursive = false) {
+        const children = this.getChildren(entity);
+        for (const child of children) {
+            callback(child);
+            if (bRecursive) {
+                this.forEachChild(child, callback, true);
+            }
+        }
+    }
+    /**
+     * 扁平化层级树（用于虚拟化渲染）
+     *
+     * @param expandedIds - 展开的实体 ID 集合
+     * @returns 扁平化的节点列表
+     */
+    flattenHierarchy(expandedIds) {
+        const result = [];
+        const traverse = (entity, depth) => {
+            const bHasChildren = this.hasChildren(entity);
+            const bIsExpanded = expandedIds.has(entity.id);
+            result.push({
+                entity,
+                depth,
+                bHasChildren,
+                bIsExpanded
+            });
+            if (bHasChildren && bIsExpanded) {
+                for (const child of this.getChildren(entity)) {
+                    traverse(child, depth + 1);
+                }
+            }
+        };
+        for (const root of this.getRootEntities()) {
+            traverse(root, 0);
+        }
+        return result;
+    }
+    /**
+     * 标记缓存为脏，并添加到脏实体集合
+     * Mark cache as dirty and add to dirty entity set
+     */
+    markCacheDirty(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy)
+            return;
+        // 如果已经是脏的，跳过（避免重复递归）
+        // Skip if already dirty (avoid redundant recursion)
+        if (hierarchy.bCacheDirty)
+            return;
+        hierarchy.bCacheDirty = true;
+        this.dirtyEntities.add(entity);
+        // 递归标记所有子级 | Recursively mark all children
+        for (const childId of hierarchy.childIds) {
+            const child = this.scene?.findEntityById(childId);
+            if (child) {
+                this.markCacheDirty(child);
+            }
+        }
+    }
+    /**
+     * 更新层级缓存
+     */
+    updateHierarchyCache(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy)
+            return;
+        // 计算深度
+        hierarchy.depth = this.getDepth(entity);
+        // 计算激活状态
+        hierarchy.bActiveInHierarchy = this.isActiveInHierarchy(entity);
+        // 标记缓存有效
+        hierarchy.bCacheDirty = false;
+    }
+    /**
+     * 当实体被添加到系统时，将其加入脏集合
+     * When entity is added to system, add it to dirty set
+     */
+    onAdded(entity) {
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (hierarchy && hierarchy.bCacheDirty) {
+            this.dirtyEntities.add(entity);
+        }
+    }
+    /**
+     * 当实体被移除时清理层级关系
+     * When entity is removed, clean up hierarchy relationships
+     */
+    onRemoved(entity) {
+        // 从脏集合中移除 | Remove from dirty set
+        this.dirtyEntities.delete(entity);
+        const hierarchy = entity.getComponent(HierarchyComponent);
+        if (!hierarchy)
+            return;
+        // 从父级移除 | Remove from parent
+        if (hierarchy.parentId !== null) {
+            const parent = this.scene?.findEntityById(hierarchy.parentId);
+            if (parent) {
+                const parentHierarchy = parent.getComponent(HierarchyComponent);
+                if (parentHierarchy) {
+                    const idx = parentHierarchy.childIds.indexOf(entity.id);
+                    if (idx !== -1) {
+                        parentHierarchy.childIds.splice(idx, 1);
+                    }
+                }
+            }
+        }
+        // 处理子级：将子级移动到根级
+        // Handle children: move children to root level
+        for (const childId of hierarchy.childIds) {
+            const child = this.scene?.findEntityById(childId);
+            if (child) {
+                const childHierarchy = child.getComponent(HierarchyComponent);
+                if (childHierarchy) {
+                    childHierarchy.parentId = null;
+                    this.markCacheDirty(child);
+                }
+            }
+        }
+    }
+    dispose() {
+        // 清理脏实体集合 | Clear dirty entity set
+        this.dirtyEntities.clear();
+    }
+}
+HierarchySystem.MAX_DEPTH = 32;
+//# sourceMappingURL=HierarchySystem.js.map

package/bin/ECS/Systems/HierarchySystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySystem.js","sourceRoot":"","sources":["../../../src/ECS/Systems/HierarchySystem.ts"],"names":[],"mappings":"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"}

package/bin/ECS/Systems/IntervalSystem.d.ts

@@ -0,0 +1,33 @@
+import { EntitySystem } from './EntitySystem';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 间隔系统抽象类
+ * 定义一个按时间间隔处理的抽象类，继承自EntitySystem类
+ * 子类需要实现process方法，用于实现具体的处理逻辑
+ */
+export declare abstract class IntervalSystem extends EntitySystem {
+    /** 累积增量以跟踪间隔 */
+    private acc;
+    /** 更新之间需要等待多长时间 */
+    private readonly interval;
+    /** 时间间隔的余数，用于计算下一次需要等待的时间 */
+    private intervalRemainder;
+    /**
+     * 构造函数，初始化时间间隔
+     * @param interval 时间间隔
+     * @param matcher 实体匹配器
+     */
+    constructor(interval: number, matcher?: Matcher);
+    /**
+     * 判断是否需要进行处理
+     * 如果需要进行处理，则更新累积增量和时间间隔余数，返回true
+     * 否则返回false
+     */
+    protected onCheckProcessing(): boolean;
+    /**
+     * 获取本系统上次处理后的实际delta值
+     * 实际delta值等于时间间隔加上时间间隔余数
+     */
+    protected getIntervalDelta(): number;
+}
+//# sourceMappingURL=IntervalSystem.d.ts.map

package/bin/ECS/Systems/IntervalSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalSystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/IntervalSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C;;;;GAIG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACrD,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAa;IACxB,mBAAmB;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,6BAA6B;IAC7B,OAAO,CAAC,iBAAiB,CAAa;IAEtC;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAK/C;;;;OAIG;cACgB,iBAAiB,IAAI,OAAO;IAkB/C;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;CAGvC"}

package/bin/ECS/Systems/IntervalSystem.js

@@ -0,0 +1,50 @@
+import { EntitySystem } from './EntitySystem';
+import { Time } from '../../Utils/Time';
+/**
+ * 间隔系统抽象类
+ * 定义一个按时间间隔处理的抽象类，继承自EntitySystem类
+ * 子类需要实现process方法，用于实现具体的处理逻辑
+ */
+export class IntervalSystem extends EntitySystem {
+    /**
+     * 构造函数，初始化时间间隔
+     * @param interval 时间间隔
+     * @param matcher 实体匹配器
+     */
+    constructor(interval, matcher) {
+        super(matcher);
+        /** 累积增量以跟踪间隔 */
+        this.acc = 0;
+        /** 时间间隔的余数，用于计算下一次需要等待的时间 */
+        this.intervalRemainder = 0;
+        this.interval = interval;
+    }
+    /**
+     * 判断是否需要进行处理
+     * 如果需要进行处理，则更新累积增量和时间间隔余数，返回true
+     * 否则返回false
+     */
+    onCheckProcessing() {
+        // 更新累积增量
+        this.acc += Time.deltaTime;
+        // 如果累积增量超过时间间隔，则进行处理
+        if (this.acc >= this.interval) {
+            // 更新时间间隔余数
+            this.intervalRemainder = this.acc - this.interval;
+            // 重置累积增量
+            this.acc = 0;
+            // 返回true，表示需要进行处理
+            return true;
+        }
+        // 返回false，表示不需要进行处理
+        return false;
+    }
+    /**
+     * 获取本系统上次处理后的实际delta值
+     * 实际delta值等于时间间隔加上时间间隔余数
+     */
+    getIntervalDelta() {
+        return this.interval + this.intervalRemainder;
+    }
+}
+//# sourceMappingURL=IntervalSystem.js.map

package/bin/ECS/Systems/IntervalSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalSystem.js","sourceRoot":"","sources":["../../../src/ECS/Systems/IntervalSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAgB,cAAe,SAAQ,YAAY;IAQrD;;;;OAIG;IACH,YAAY,QAAgB,EAAE,OAAiB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QAbnB,gBAAgB;QACR,QAAG,GAAW,CAAC,CAAC;QAGxB,6BAA6B;QACrB,sBAAiB,GAAW,CAAC,CAAC;QASlC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACgB,iBAAiB;QAChC,SAAS;QACT,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC;QAE3B,qBAAqB;QACrB,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,WAAW;YACX,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YAClD,SAAS;YACT,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YACb,kBAAkB;YAClB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,oBAAoB;QACpB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACO,gBAAgB;QACtB,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC;IAClD,CAAC;CACJ"}

package/bin/ECS/Systems/PassiveSystem.d.ts

@@ -0,0 +1,17 @@
+import { EntitySystem } from './EntitySystem';
+import { Entity } from '../Entity';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 被动实体系统
+ * 定义一个被动的实体系统，继承自EntitySystem类
+ * 被动的实体系统不会对实体进行任何修改，只会被动地接收实体的变化事件
+ */
+export declare abstract class PassiveSystem extends EntitySystem {
+    constructor(matcher?: Matcher);
+    /**
+     * 不进行任何处理
+     * @param entities 实体数组，未被使用
+     */
+    protected process(_entities: Entity[]): void;
+}
+//# sourceMappingURL=PassiveSystem.d.ts.map

package/bin/ECS/Systems/PassiveSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassiveSystem.d.ts","sourceRoot":"","sources":["../../../src/ECS/Systems/PassiveSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C;;;;GAIG;AACH,8BAAsB,aAAc,SAAQ,YAAY;gBAExC,OAAO,CAAC,EAAE,OAAO;IAI7B;;;OAGG;cACgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;CAGxD"}

package/bin/ECS/Systems/PassiveSystem.js

@@ -0,0 +1,19 @@
+import { EntitySystem } from './EntitySystem';
+/**
+ * 被动实体系统
+ * 定义一个被动的实体系统，继承自EntitySystem类
+ * 被动的实体系统不会对实体进行任何修改，只会被动地接收实体的变化事件
+ */
+export class PassiveSystem extends EntitySystem {
+    constructor(matcher) {
+        super(matcher);
+    }
+    /**
+     * 不进行任何处理
+     * @param entities 实体数组，未被使用
+     */
+    process(_entities) {
+        // 被动系统不进行任何处理
+    }
+}
+//# sourceMappingURL=PassiveSystem.js.map

package/bin/ECS/Systems/PassiveSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassiveSystem.js","sourceRoot":"","sources":["../../../src/ECS/Systems/PassiveSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;GAIG;AACH,MAAM,OAAgB,aAAc,SAAQ,YAAY;IAEpD,YAAY,OAAiB;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACgB,OAAO,CAAC,SAAmB;QAC1C,cAAc;IAClB,CAAC;CACJ"}

package/bin/ECS/Systems/ProcessingSystem.d.ts

@@ -0,0 +1,21 @@
+import { EntitySystem } from './EntitySystem';
+import { Entity } from '../Entity';
+import { Matcher } from '../Utils/Matcher';
+/**
+ * 处理系统抽象类
+ * 定义一个处理实体的抽象类，继承自EntitySystem类
+ * 子类需要实现processSystem方法，用于实现具体的处理逻辑
+ */
+export declare abstract class ProcessingSystem extends EntitySystem {
+    constructor(matcher?: Matcher);
+    /**
+     * 处理实体，每帧调用processSystem方法进行处理
+     * @param entities 实体数组，未被使用
+     */
+    protected process(_entities: Entity[]): void;
+    /**
+     * 处理实体的具体方法，由子类实现
+     */
+    abstract processSystem(): void;
+}
+//# sourceMappingURL=ProcessingSystem.d.ts.map