Class QuerySystem

packages/core/src/ECS/Core/QuerySystem.ts:49–1237

 * ```
 */
export class QuerySystem {
    private readonly _logger = createLogger('QuerySystem');
    private _entities: Entity[] = [];
    private _entityIndex: EntityIndex;

    private _version = 0;

    private _queryCache = new Map<string, QueryCacheEntry>();
    private _cacheMaxSize = 1000;
    private _cacheTimeout = 5000;

    private _componentMaskCache = new Map<string, BitMask64Data>();

    private _archetypeSystem: ArchetypeSystem;

    private _queryStats = {
        totalQueries: 0,
        cacheHits: 0,
        indexHits: 0,
        linearScans: 0,
        archetypeHits: 0,
        dirtyChecks: 0
    };

    constructor() {
        this._entityIndex = {
            byTag: new Map(),
            byName: new Map()
        };

        this._archetypeSystem = new ArchetypeSystem();
    }

    /**
     * 设置实体列表并重建索引
     *
     * 当实体集合发生大规模变化时调用此方法。
     * 系统将重新构建所有索引以确保查询性能。
     *
     * @param entities 新的实体列表
     */
    public setEntities(entities: Entity[]): void {
        this._entities = entities;
        this.clearQueryCache();
        this.clearReactiveQueries();
        this.rebuildIndexes();
    }

    /**
     * 添加单个实体到查询系统
     *
     * 将新实体添加到查询系统中，并自动更新相关索引。
     * 为了提高批量添加性能，可以延迟缓存清理。
     *
     * @param entity 要添加的实体
     * @param deferCacheClear 是否延迟缓存清理（用于批量操作）
     */
    public addEntity(entity: Entity, deferCacheClear: boolean = false): void {