@esengine/ecs-framework 2.1.28 → 2.1.30

package/bin/Utils/Pool/PoolManager.d.ts

@@ -0,0 +1,91 @@
+import { IPoolable, PoolStats } from './IPoolable';
+import { Pool } from './Pool';
+/**
+ * 池管理器
+ * 统一管理所有对象池
+ */
+export declare class PoolManager {
+    private static instance;
+    private pools;
+    private autoCompactInterval;
+    private lastCompactTime;
+    static getInstance(): PoolManager;
+    /**
+     * 注册池
+     * @param name 池名称
+     * @param pool 池实例
+     */
+    registerPool<T extends IPoolable>(name: string, pool: Pool<T>): void;
+    /**
+     * 获取池
+     * @param name 池名称
+     * @returns 池实例
+     */
+    getPool<T extends IPoolable>(name: string): Pool<T> | null;
+    /**
+     * 更新池管理器（应在游戏循环中调用）
+     */
+    update(): void;
+    /**
+     * 创建或获取标准池
+     * @param name 池名称
+     * @param createFn 创建函数
+     * @param maxSize 最大大小
+     * @param estimatedObjectSize 估算对象大小
+     * @returns 池实例
+     */
+    createPool<T extends IPoolable>(name: string, createFn: () => T, maxSize?: number, estimatedObjectSize?: number): Pool<T>;
+    /**
+     * 移除池
+     * @param name 池名称
+     * @returns 是否成功移除
+     */
+    removePool(name: string): boolean;
+    /**
+     * 获取所有池名称
+     * @returns 池名称数组
+     */
+    getPoolNames(): string[];
+    /**
+     * 获取池数量
+     * @returns 池数量
+     */
+    getPoolCount(): number;
+    /**
+     * 压缩所有池
+     */
+    compactAllPools(): void;
+    /**
+     * 清空所有池
+     */
+    clearAllPools(): void;
+    /**
+     * 获取所有池的统计信息
+     * @returns 统计信息映射
+     */
+    getAllStats(): Map<string, PoolStats>;
+    /**
+     * 获取总体统计信息
+     * @returns 总体统计信息
+     */
+    getGlobalStats(): PoolStats;
+    /**
+     * 获取格式化的统计信息字符串
+     * @returns 格式化字符串
+     */
+    getStatsString(): string;
+    /**
+     * 设置自动压缩间隔
+     * @param intervalMs 间隔毫秒数
+     */
+    setAutoCompactInterval(intervalMs: number): void;
+    /**
+     * 预填充所有池
+     */
+    prewarmAllPools(): void;
+    /**
+     * 重置池管理器
+     */
+    reset(): void;
+}
+//# sourceMappingURL=PoolManager.d.ts.map

package/bin/Utils/Pool/PoolManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolManager.d.ts","sourceRoot":"","sources":["../../../src/Utils/Pool/PoolManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,eAAe,CAAK;WAEd,WAAW,IAAI,WAAW;IAOxC;;;;OAIG;IACI,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3E;;;;OAIG;IACI,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAIjE;;OAEG;IACI,MAAM,IAAI,IAAI;IASrB;;;;;;;OAOG;IACI,UAAU,CAAC,CAAC,SAAS,SAAS,EACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,CAAC,EACjB,OAAO,GAAE,MAAY,EACrB,mBAAmB,GAAE,MAAa,GACnC,IAAI,CAAC,CAAC,CAAC;IAYV;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUxC;;;OAGG;IACI,YAAY,IAAI,MAAM,EAAE;IAI/B;;;OAGG;IACI,YAAY,IAAI,MAAM;IAI7B;;OAEG;IACI,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,aAAa,IAAI,IAAI;IAM5B;;;OAGG;IACI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAU5C;;;OAGG;IACI,cAAc,IAAI,SAAS;IA+BlC;;;OAGG;IACI,cAAc,IAAI,MAAM;IA0B/B;;;OAGG;IACI,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvD;;OAEG;IACI,eAAe,IAAI,IAAI;IAQ9B;;OAEG;IACI,KAAK,IAAI,IAAI;CAKvB"}

package/bin/Utils/Pool/PoolManager.js

@@ -0,0 +1,197 @@
+import { Pool } from './Pool';
+/**
+ * 池管理器
+ * 统一管理所有对象池
+ */
+export class PoolManager {
+    constructor() {
+        this.pools = new Map();
+        this.autoCompactInterval = 60000; // 60秒
+        this.lastCompactTime = 0;
+    }
+    static getInstance() {
+        if (!PoolManager.instance) {
+            PoolManager.instance = new PoolManager();
+        }
+        return PoolManager.instance;
+    }
+    /**
+     * 注册池
+     * @param name 池名称
+     * @param pool 池实例
+     */
+    registerPool(name, pool) {
+        this.pools.set(name, pool);
+    }
+    /**
+     * 获取池
+     * @param name 池名称
+     * @returns 池实例
+     */
+    getPool(name) {
+        return this.pools.get(name) || null;
+    }
+    /**
+     * 更新池管理器（应在游戏循环中调用）
+     */
+    update() {
+        const now = Date.now();
+        if (now - this.lastCompactTime > this.autoCompactInterval) {
+            this.compactAllPools();
+            this.lastCompactTime = now;
+        }
+    }
+    /**
+     * 创建或获取标准池
+     * @param name 池名称
+     * @param createFn 创建函数
+     * @param maxSize 最大大小
+     * @param estimatedObjectSize 估算对象大小
+     * @returns 池实例
+     */
+    createPool(name, createFn, maxSize = 100, estimatedObjectSize = 1024) {
+        let pool = this.pools.get(name);
+        if (!pool) {
+            pool = new Pool(createFn, maxSize, estimatedObjectSize);
+            this.pools.set(name, pool);
+        }
+        return pool;
+    }
+    /**
+     * 移除池
+     * @param name 池名称
+     * @returns 是否成功移除
+     */
+    removePool(name) {
+        const pool = this.pools.get(name);
+        if (pool) {
+            pool.clear();
+            this.pools.delete(name);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 获取所有池名称
+     * @returns 池名称数组
+     */
+    getPoolNames() {
+        return Array.from(this.pools.keys());
+    }
+    /**
+     * 获取池数量
+     * @returns 池数量
+     */
+    getPoolCount() {
+        return this.pools.size;
+    }
+    /**
+     * 压缩所有池
+     */
+    compactAllPools() {
+        for (const pool of this.pools.values()) {
+            pool.compact();
+        }
+    }
+    /**
+     * 清空所有池
+     */
+    clearAllPools() {
+        for (const pool of this.pools.values()) {
+            pool.clear();
+        }
+    }
+    /**
+     * 获取所有池的统计信息
+     * @returns 统计信息映射
+     */
+    getAllStats() {
+        const stats = new Map();
+        for (const [name, pool] of this.pools) {
+            stats.set(name, pool.getStats());
+        }
+        return stats;
+    }
+    /**
+     * 获取总体统计信息
+     * @returns 总体统计信息
+     */
+    getGlobalStats() {
+        let totalSize = 0;
+        let totalMaxSize = 0;
+        let totalCreated = 0;
+        let totalObtained = 0;
+        let totalReleased = 0;
+        let totalMemoryUsage = 0;
+        for (const pool of this.pools.values()) {
+            const stats = pool.getStats();
+            totalSize += stats.size;
+            totalMaxSize += stats.maxSize;
+            totalCreated += stats.totalCreated;
+            totalObtained += stats.totalObtained;
+            totalReleased += stats.totalReleased;
+            totalMemoryUsage += stats.estimatedMemoryUsage;
+        }
+        const hitRate = totalObtained === 0 ? 0 : (totalObtained - totalCreated) / totalObtained;
+        return {
+            size: totalSize,
+            maxSize: totalMaxSize,
+            totalCreated,
+            totalObtained,
+            totalReleased,
+            hitRate,
+            estimatedMemoryUsage: totalMemoryUsage
+        };
+    }
+    /**
+     * 获取格式化的统计信息字符串
+     * @returns 格式化字符串
+     */
+    getStatsString() {
+        const lines = ['=== Pool Manager Statistics ===', ''];
+        if (this.pools.size === 0) {
+            lines.push('No pools registered');
+            return lines.join('\n');
+        }
+        const globalStats = this.getGlobalStats();
+        lines.push(`Total Pools: ${this.pools.size}`);
+        lines.push(`Global Hit Rate: ${(globalStats.hitRate * 100).toFixed(1)}%`);
+        lines.push(`Global Memory Usage: ${(globalStats.estimatedMemoryUsage / 1024).toFixed(1)} KB`);
+        lines.push('');
+        for (const [name, pool] of this.pools) {
+            const stats = pool.getStats();
+            lines.push(`${name}:`);
+            lines.push(`  Size: ${stats.size}/${stats.maxSize}`);
+            lines.push(`  Hit Rate: ${(stats.hitRate * 100).toFixed(1)}%`);
+            lines.push(`  Memory: ${(stats.estimatedMemoryUsage / 1024).toFixed(1)} KB`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 设置自动压缩间隔
+     * @param intervalMs 间隔毫秒数
+     */
+    setAutoCompactInterval(intervalMs) {
+        this.autoCompactInterval = intervalMs;
+    }
+    /**
+     * 预填充所有池
+     */
+    prewarmAllPools() {
+        for (const pool of this.pools.values()) {
+            const stats = pool.getStats();
+            const prewarmCount = Math.floor(stats.maxSize * 0.2); // 预填充20%
+            pool.prewarm(prewarmCount);
+        }
+    }
+    /**
+     * 重置池管理器
+     */
+    reset() {
+        this.clearAllPools();
+        this.pools.clear();
+        this.lastCompactTime = 0;
+    }
+}
+//# sourceMappingURL=PoolManager.js.map

package/bin/Utils/Pool/PoolManager.js.map

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

package/bin/Utils/Pool/index.d.ts

@@ -0,0 +1,4 @@
+export * from './IPoolable';
+export * from './Pool';
+export * from './PoolManager';
+//# sourceMappingURL=index.d.ts.map

package/bin/Utils/Pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Utils/Pool/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}

package/bin/Utils/Pool/index.js

@@ -0,0 +1,4 @@
+export * from './IPoolable';
+export * from './Pool';
+export * from './PoolManager';
+//# sourceMappingURL=index.js.map

package/bin/Utils/Pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Utils/Pool/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}

package/bin/Utils/Time.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 时间管理工具类
+ * 提供游戏时间相关的功能，包括帧时间、总时间、时间缩放等
+ */
+export declare class Time {
+    /**
+     * 上一帧到当前帧的时间间隔（秒）
+     */
+    static deltaTime: number;
+    /**
+     * 未缩放的帧时间间隔（秒）
+     */
+    static unscaledDeltaTime: number;
+    /**
+     * 游戏开始以来的总时间（秒）
+     */
+    static totalTime: number;
+    /**
+     * 未缩放的总时间（秒）
+     */
+    static unscaledTotalTime: number;
+    /**
+     * 时间缩放比例
+     */
+    static timeScale: number;
+    /**
+     * 当前帧数
+     */
+    static frameCount: number;
+    /**
+     * 使用外部引擎提供的deltaTime更新时间信息
+     * @param deltaTime 外部引擎提供的帧时间间隔（秒）
+     */
+    static update(deltaTime: number): void;
+    /**
+     * 场景改变时重置时间
+     */
+    static sceneChanged(): void;
+    /**
+     * 检查指定的时间间隔是否已经过去
+     * @param interval 时间间隔（秒）
+     * @param lastTime 上次检查的时间
+     * @returns 是否已经过去指定时间
+     */
+    static checkEvery(interval: number, lastTime: number): boolean;
+}
+//# sourceMappingURL=Time.d.ts.map

package/bin/Utils/Time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../src/Utils/Time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,IAAI;IACb;;OAEG;IACH,OAAc,SAAS,EAAE,MAAM,CAAK;IAEpC;;OAEG;IACH,OAAc,iBAAiB,EAAE,MAAM,CAAK;IAE5C;;OAEG;IACH,OAAc,SAAS,EAAE,MAAM,CAAK;IAEpC;;OAEG;IACH,OAAc,iBAAiB,EAAE,MAAM,CAAK;IAE5C;;OAEG;IACH,OAAc,SAAS,EAAE,MAAM,CAAK;IAEpC;;OAEG;IACH,OAAc,UAAU,EAAE,MAAM,CAAK;IAErC;;;OAGG;WACW,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAa7C;;OAEG;WACW,YAAY,IAAI,IAAI;IAQlC;;;;;OAKG;WACW,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxE"}

package/bin/Utils/Time.js

@@ -0,0 +1,64 @@
+/**
+ * 时间管理工具类
+ * 提供游戏时间相关的功能，包括帧时间、总时间、时间缩放等
+ */
+export class Time {
+    /**
+     * 使用外部引擎提供的deltaTime更新时间信息
+     * @param deltaTime 外部引擎提供的帧时间间隔（秒）
+     */
+    static update(deltaTime) {
+        // 设置未缩放的帧时间
+        this.unscaledDeltaTime = deltaTime;
+        this.deltaTime = deltaTime * this.timeScale;
+        // 更新总时间
+        this.unscaledTotalTime += this.unscaledDeltaTime;
+        this.totalTime += this.deltaTime;
+        // 更新帧数
+        this.frameCount++;
+    }
+    /**
+     * 场景改变时重置时间
+     */
+    static sceneChanged() {
+        this.frameCount = 0;
+        this.totalTime = 0;
+        this.unscaledTotalTime = 0;
+        this.deltaTime = 0;
+        this.unscaledDeltaTime = 0;
+    }
+    /**
+     * 检查指定的时间间隔是否已经过去
+     * @param interval 时间间隔（秒）
+     * @param lastTime 上次检查的时间
+     * @returns 是否已经过去指定时间
+     */
+    static checkEvery(interval, lastTime) {
+        return this.totalTime - lastTime >= interval;
+    }
+}
+/**
+ * 上一帧到当前帧的时间间隔（秒）
+ */
+Time.deltaTime = 0;
+/**
+ * 未缩放的帧时间间隔（秒）
+ */
+Time.unscaledDeltaTime = 0;
+/**
+ * 游戏开始以来的总时间（秒）
+ */
+Time.totalTime = 0;
+/**
+ * 未缩放的总时间（秒）
+ */
+Time.unscaledTotalTime = 0;
+/**
+ * 时间缩放比例
+ */
+Time.timeScale = 1;
+/**
+ * 当前帧数
+ */
+Time.frameCount = 0;
+//# sourceMappingURL=Time.js.map

package/bin/Utils/Time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.js","sourceRoot":"","sources":["../../src/Utils/Time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,IAAI;IA+Bb;;;OAGG;IACI,MAAM,CAAC,MAAM,CAAC,SAAiB;QAClC,YAAY;QACZ,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAE5C,QAAQ;QACR,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,iBAAiB,CAAC;QACjD,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;QAEjC,OAAO;QACP,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,YAAY;QACtB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,UAAU,CAAC,QAAgB,EAAE,QAAgB;QACvD,OAAO,IAAI,CAAC,SAAS,GAAG,QAAQ,IAAI,QAAQ,CAAC;IACjD,CAAC;;AAlED;;GAEG;AACW,cAAS,GAAW,CAAC,CAAC;AAEpC;;GAEG;AACW,sBAAiB,GAAW,CAAC,CAAC;AAE5C;;GAEG;AACW,cAAS,GAAW,CAAC,CAAC;AAEpC;;GAEG;AACW,sBAAiB,GAAW,CAAC,CAAC;AAE5C;;GAEG;AACW,cAAS,GAAW,CAAC,CAAC;AAEpC;;GAEG;AACW,eAAU,GAAW,CAAC,CAAC"}

package/bin/Utils/Timers/ITimer.d.ts

@@ -0,0 +1,16 @@
+export interface ITimer<TContext = unknown> {
+    context: TContext;
+    /**
+     * 调用stop以停止此计时器再次运行。这对非重复计时器没有影响。
+     */
+    stop(): void;
+    /**
+     * 将计时器的运行时间重置为0
+     */
+    reset(): void;
+    /**
+     * 返回投向T的上下文，作为方便
+     */
+    getContext<T>(): T;
+}
+//# sourceMappingURL=ITimer.d.ts.map

package/bin/Utils/Timers/ITimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITimer.d.ts","sourceRoot":"","sources":["../../../src/Utils/Timers/ITimer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM,CAAC,QAAQ,GAAG,OAAO;IACtC,OAAO,EAAE,QAAQ,CAAC;IAElB;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC;CACtB"}

package/bin/Utils/Timers/ITimer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ITimer.js.map

package/bin/Utils/Timers/ITimer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITimer.js","sourceRoot":"","sources":["../../../src/Utils/Timers/ITimer.ts"],"names":[],"mappings":""}

package/bin/Utils/Timers/Timer.d.ts

@@ -0,0 +1,30 @@
+import { ITimer } from './ITimer';
+/**
+ * 私有类隐藏ITimer的实现
+ */
+export declare class Timer<TContext = unknown> implements ITimer<TContext> {
+    context: TContext;
+    _timeInSeconds: number;
+    _repeats: boolean;
+    _onTime: (timer: ITimer<TContext>) => void;
+    _isDone: boolean;
+    _elapsedTime: number;
+    getContext<T>(): T;
+    /**
+     * 定时器是否已完成
+     */
+    get isDone(): boolean;
+    /**
+     * 定时器已运行的时间
+     */
+    get elapsedTime(): number;
+    reset(): void;
+    stop(): void;
+    tick(): boolean;
+    initialize(timeInsSeconds: number, repeats: boolean, context: TContext, onTime: (timer: ITimer<TContext>) => void): void;
+    /**
+     * 空出对象引用，以便在js需要时GC可以清理它们的引用
+     */
+    unload(): void;
+}
+//# sourceMappingURL=Timer.d.ts.map

package/bin/Utils/Timers/Timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timer.d.ts","sourceRoot":"","sources":["../../../src/Utils/Timers/Timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;GAEG;AACH,qBAAa,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAE,YAAW,MAAM,CAAC,QAAQ,CAAC;IACvD,OAAO,EAAG,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAK;IAC3B,QAAQ,EAAE,OAAO,CAAS;IAC1B,OAAO,EAAG,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAS;IACzB,YAAY,EAAE,MAAM,CAAK;IAEzB,UAAU,CAAC,CAAC,KAAK,CAAC;IAIzB;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAEM,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,IAAI;IAeJ,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAG,IAAI;IAOtH;;OAEG;IACI,MAAM;CAIhB"}

package/bin/Utils/Timers/Timer.js

@@ -0,0 +1,58 @@
+import { Time } from '../Time';
+/**
+ * 私有类隐藏ITimer的实现
+ */
+export class Timer {
+    constructor() {
+        this._timeInSeconds = 0;
+        this._repeats = false;
+        this._isDone = false;
+        this._elapsedTime = 0;
+    }
+    getContext() {
+        return this.context;
+    }
+    /**
+     * 定时器是否已完成
+     */
+    get isDone() {
+        return this._isDone;
+    }
+    /**
+     * 定时器已运行的时间
+     */
+    get elapsedTime() {
+        return this._elapsedTime;
+    }
+    reset() {
+        this._elapsedTime = 0;
+    }
+    stop() {
+        this._isDone = true;
+    }
+    tick() {
+        // 如果stop在tick之前被调用，那么isDone将为true，我们不应该再做任何事情
+        if (!this._isDone && this._elapsedTime > this._timeInSeconds) {
+            this._elapsedTime -= this._timeInSeconds;
+            this._onTime(this);
+            if (!this._isDone && !this._repeats)
+                this._isDone = true;
+        }
+        this._elapsedTime += Time.deltaTime;
+        return this._isDone;
+    }
+    initialize(timeInsSeconds, repeats, context, onTime) {
+        this._timeInSeconds = timeInsSeconds;
+        this._repeats = repeats;
+        this.context = context;
+        this._onTime = onTime.bind(context);
+    }
+    /**
+     * 空出对象引用，以便在js需要时GC可以清理它们的引用
+     */
+    unload() {
+        this.context = null;
+        this._onTime = null;
+    }
+}
+//# sourceMappingURL=Timer.js.map

package/bin/Utils/Timers/Timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timer.js","sourceRoot":"","sources":["../../../src/Utils/Timers/Timer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,KAAK;IAAlB;QAEW,mBAAc,GAAW,CAAC,CAAC;QAC3B,aAAQ,GAAY,KAAK,CAAC;QAE1B,YAAO,GAAY,KAAK,CAAC;QACzB,iBAAY,GAAW,CAAC,CAAC;IAyDpC,CAAC;IAvDU,UAAU;QACb,OAAO,IAAI,CAAC,OAAuB,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEM,IAAI;QACP,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAEM,IAAI;QACP,8CAA8C;QAC9C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,EAAC,CAAC;YAC1D,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,cAAc,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAEnB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,CAAC;QAEpC,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAEM,UAAU,CAAC,cAAsB,EAAE,OAAgB,EAAE,OAAiB,EAAE,MAAuC;QAClH,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,MAAM;QACT,IAAI,CAAC,OAAO,GAAG,IAA2B,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAK,CAAC;IACzB,CAAC;CACJ"}

package/bin/Utils/Timers/TimerManager.d.ts

@@ -0,0 +1,19 @@
+import { GlobalManager } from '../GlobalManager';
+import { Timer } from './Timer';
+import { ITimer } from './ITimer';
+/**
+ * 允许动作的延迟和重复执行
+ */
+export declare class TimerManager extends GlobalManager {
+    _timers: Array<Timer<unknown>>;
+    update(): void;
+    /**
+     * 调度一个一次性或重复的计时器，该计时器将调用已传递的动作
+     * @param timeInSeconds
+     * @param repeats
+     * @param context
+     * @param onTime
+     */
+    schedule<TContext = unknown>(timeInSeconds: number, repeats: boolean, context: TContext, onTime: (timer: ITimer<TContext>) => void): Timer<TContext>;
+}
+//# sourceMappingURL=TimerManager.d.ts.map

package/bin/Utils/Timers/TimerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimerManager.d.ts","sourceRoot":"","sources":["../../../src/Utils/Timers/TimerManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;IACpC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAM;IAE3B,MAAM;IAStB;;;;;;OAMG;IACI,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAG,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;CAO5J"}

package/bin/Utils/Timers/TimerManager.js

@@ -0,0 +1,33 @@
+import { GlobalManager } from '../GlobalManager';
+import { Timer } from './Timer';
+/**
+ * 允许动作的延迟和重复执行
+ */
+export class TimerManager extends GlobalManager {
+    constructor() {
+        super(...arguments);
+        this._timers = [];
+    }
+    update() {
+        for (let i = this._timers.length - 1; i >= 0; i--) {
+            if (this._timers[i].tick()) {
+                this._timers[i].unload();
+                this._timers.splice(i, 1);
+            }
+        }
+    }
+    /**
+     * 调度一个一次性或重复的计时器，该计时器将调用已传递的动作
+     * @param timeInSeconds
+     * @param repeats
+     * @param context
+     * @param onTime
+     */
+    schedule(timeInSeconds, repeats, context, onTime) {
+        let timer = new Timer();
+        timer.initialize(timeInSeconds, repeats, context, onTime);
+        this._timers.push(timer);
+        return timer;
+    }
+}
+//# sourceMappingURL=TimerManager.js.map

package/bin/Utils/Timers/TimerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimerManager.js","sourceRoot":"","sources":["../../../src/Utils/Timers/TimerManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IAA/C;;QACW,YAAO,GAA0B,EAAE,CAAC;IAyB/C,CAAC;IAvBmB,MAAM;QAClB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAG,EAAC,CAAC;YAChD,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAC,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAqB,aAAqB,EAAE,OAAgB,EAAE,OAAiB,EAAE,MAAuC;QACnI,IAAI,KAAK,GAAG,IAAI,KAAK,EAAY,CAAC;QAClC,KAAK,CAAC,UAAU,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAuB,CAAC,CAAC;QAE3C,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ"}

package/bin/Utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './Extensions';
+export * from './Pool';
+export * from './Emitter';
+export * from './GlobalManager';
+export * from './PerformanceMonitor';
+export { Time } from './Time';
+export * from './Debug';
+export * from './Logger';
+//# sourceMappingURL=index.d.ts.map

package/bin/Utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/bin/Utils/index.js

@@ -0,0 +1,9 @@
+export * from './Extensions';
+export * from './Pool';
+export * from './Emitter';
+export * from './GlobalManager';
+export * from './PerformanceMonitor';
+export { Time } from './Time';
+export * from './Debug';
+export * from './Logger';
+//# sourceMappingURL=index.js.map

package/bin/Utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}