@esengine/ecs-framework 2.0.3

package/bin/Utils/Extensions/TypeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeUtils.d.ts","sourceRoot":"","sources":["../../../src/Utils/Extensions/TypeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;IAClB;;;;OAIG;WACW,OAAO,CAAC,GAAG,EAAE,GAAG;CAGjC"}

package/bin/Utils/Extensions/TypeUtils.js

@@ -0,0 +1,15 @@
+/**
+ * 类型工具类
+ * 提供类型相关的实用方法
+ */
+export class TypeUtils {
+    /**
+     * 获取对象的类型
+     * @param obj 对象
+     * @returns 对象的构造函数
+     */
+    static getType(obj) {
+        return obj.constructor;
+    }
+}
+//# sourceMappingURL=TypeUtils.js.map

package/bin/Utils/Extensions/TypeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeUtils.js","sourceRoot":"","sources":["../../../src/Utils/Extensions/TypeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAS;IAClB;;;;OAIG;IACI,MAAM,CAAC,OAAO,CAAC,GAAQ;QAC1B,OAAO,GAAG,CAAC,WAAW,CAAC;IAC3B,CAAC;CACJ"}

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

@@ -0,0 +1,4 @@
+export { TypeUtils } from './TypeUtils';
+export { NumberExtension } from './NumberExtension';
+export { EdgeExt } from './EdgeExt';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Utils/Extensions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/bin/Utils/Extensions/index.js

@@ -0,0 +1,5 @@
+// 扩展工具类导出
+export { TypeUtils } from './TypeUtils';
+export { NumberExtension } from './NumberExtension';
+export { EdgeExt } from './EdgeExt';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Utils/Extensions/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/bin/Utils/GlobalManager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 全局管理器的基类。所有全局管理器都应该从此类继承。
+ */
+export declare class GlobalManager {
+    /**
+     * 表示管理器是否启用
+     */
+    _enabled: boolean;
+    /**
+     * 获取或设置管理器是否启用
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    /**
+     * 设置管理器是否启用
+     * @param isEnabled 如果为true，则启用管理器；否则禁用管理器
+     */
+    setEnabled(isEnabled: boolean): void;
+    /**
+     * 在启用管理器时调用的回调方法
+     */
+    protected onEnabled(): void;
+    /**
+     * 在禁用管理器时调用的回调方法
+     */
+    protected onDisabled(): void;
+    /**
+     * 更新管理器状态的方法
+     */
+    update(): void;
+}
+//# sourceMappingURL=GlobalManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalManager.d.ts","sourceRoot":"","sources":["../../src/Utils/GlobalManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACtB;;OAEG;IACI,QAAQ,EAAE,OAAO,CAAS;IAEjC;;OAEG;IACH,IAAW,OAAO,IAIQ,OAAO,CAFhC;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAEhC;IAED;;;OAGG;IACI,UAAU,CAAC,SAAS,EAAE,OAAO;IAapC;;OAEG;IACH,SAAS,CAAC,SAAS;IAGnB;;OAEG;IACH,SAAS,CAAC,UAAU;IAGpB;;OAEG;IACI,MAAM;CAEhB"}

package/bin/Utils/GlobalManager.js

@@ -0,0 +1,53 @@
+/**
+ * 全局管理器的基类。所有全局管理器都应该从此类继承。
+ */
+export class GlobalManager {
+    constructor() {
+        /**
+         * 表示管理器是否启用
+         */
+        this._enabled = false;
+    }
+    /**
+     * 获取或设置管理器是否启用
+     */
+    get enabled() {
+        return this._enabled;
+    }
+    set enabled(value) {
+        this.setEnabled(value);
+    }
+    /**
+     * 设置管理器是否启用
+     * @param isEnabled 如果为true，则启用管理器；否则禁用管理器
+     */
+    setEnabled(isEnabled) {
+        if (this._enabled != isEnabled) {
+            this._enabled = isEnabled;
+            if (this._enabled) {
+                // 如果启用了管理器，则调用onEnabled方法
+                this.onEnabled();
+            }
+            else {
+                // 如果禁用了管理器，则调用onDisabled方法
+                this.onDisabled();
+            }
+        }
+    }
+    /**
+     * 在启用管理器时调用的回调方法
+     */
+    onEnabled() {
+    }
+    /**
+     * 在禁用管理器时调用的回调方法
+     */
+    onDisabled() {
+    }
+    /**
+     * 更新管理器状态的方法
+     */
+    update() {
+    }
+}
+//# sourceMappingURL=GlobalManager.js.map

package/bin/Utils/GlobalManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalManager.js","sourceRoot":"","sources":["../../src/Utils/GlobalManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAa;IAA1B;QACI;;WAEG;QACI,aAAQ,GAAY,KAAK,CAAC;IA+CrC,CAAC;IA7CG;;OAEG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAW,OAAO,CAAC,KAAc;QAC7B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,SAAkB;QAChC,IAAI,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,0BAA0B;gBAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,2BAA2B;gBAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACO,SAAS;IACnB,CAAC;IAED;;OAEG;IACO,UAAU;IACpB,CAAC;IAED;;OAEG;IACI,MAAM;IACb,CAAC;CACJ"}

package/bin/Utils/PerformanceMonitor.d.ts

@@ -0,0 +1,211 @@
+/**
+ * 性能监控数据
+ */
+export interface PerformanceData {
+    /** 系统名称 */
+    name: string;
+    /** 执行时间（毫秒） */
+    executionTime: number;
+    /** 处理的实体数量 */
+    entityCount: number;
+    /** 平均每个实体的处理时间 */
+    averageTimePerEntity: number;
+    /** 最后更新时间戳 */
+    lastUpdateTime: number;
+    /** 内存使用量（字节） */
+    memoryUsage?: number;
+    /** CPU使用率（百分比） */
+    cpuUsage?: number;
+}
+/**
+ * 性能统计信息
+ */
+export interface PerformanceStats {
+    /** 总执行时间 */
+    totalTime: number;
+    /** 平均执行时间 */
+    averageTime: number;
+    /** 最小执行时间 */
+    minTime: number;
+    /** 最大执行时间 */
+    maxTime: number;
+    /** 执行次数 */
+    executionCount: number;
+    /** 最近的执行时间列表 */
+    recentTimes: number[];
+    /** 标准差 */
+    standardDeviation: number;
+    /** 95百分位数 */
+    percentile95: number;
+    /** 99百分位数 */
+    percentile99: number;
+}
+/**
+ * 性能警告类型
+ */
+export declare enum PerformanceWarningType {
+    HIGH_EXECUTION_TIME = "high_execution_time",
+    HIGH_MEMORY_USAGE = "high_memory_usage",
+    HIGH_CPU_USAGE = "high_cpu_usage",
+    FREQUENT_GC = "frequent_gc",
+    LOW_FPS = "low_fps",
+    HIGH_ENTITY_COUNT = "high_entity_count"
+}
+/**
+ * 性能警告
+ */
+export interface PerformanceWarning {
+    type: PerformanceWarningType;
+    systemName: string;
+    message: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    timestamp: number;
+    value: number;
+    threshold: number;
+    suggestion?: string;
+}
+/**
+ * 性能阈值配置
+ */
+export interface PerformanceThresholds {
+    /** 执行时间阈值（毫秒） */
+    executionTime: {
+        warning: number;
+        critical: number;
+    };
+    /** 内存使用阈值（MB） */
+    memoryUsage: {
+        warning: number;
+        critical: number;
+    };
+    /** CPU使用率阈值（百分比） */
+    cpuUsage: {
+        warning: number;
+        critical: number;
+    };
+    /** FPS阈值 */
+    fps: {
+        warning: number;
+        critical: number;
+    };
+    /** 实体数量阈值 */
+    entityCount: {
+        warning: number;
+        critical: number;
+    };
+}
+/**
+ * 高性能监控器
+ * 用于监控ECS系统的性能表现，提供详细的分析和优化建议
+ */
+export declare class PerformanceMonitor {
+    private static _instance;
+    private _systemData;
+    private _systemStats;
+    private _warnings;
+    private _isEnabled;
+    private _maxRecentSamples;
+    private _maxWarnings;
+    private _thresholds;
+    private _fpsHistory;
+    private _lastFrameTime;
+    private _frameCount;
+    private _fpsUpdateInterval;
+    private _lastFpsUpdate;
+    private _currentFps;
+    private _memoryCheckInterval;
+    private _lastMemoryCheck;
+    private _memoryHistory;
+    private _gcCount;
+    private _lastGcCheck;
+    private _gcCheckInterval;
+    /**
+     * 获取单例实例
+     */
+    static get instance(): PerformanceMonitor;
+    private constructor();
+    /**
+     * 启用性能监控
+     */
+    enable(): void;
+    /**
+     * 禁用性能监控
+     */
+    disable(): void;
+    /**
+     * 检查是否启用了性能监控
+     */
+    get isEnabled(): boolean;
+    /**
+     * 开始监控系统性能
+     * @param systemName 系统名称
+     * @returns 开始时间戳
+     */
+    startMonitoring(systemName: string): number;
+    /**
+     * 结束监控并记录性能数据
+     * @param systemName 系统名称
+     * @param startTime 开始时间戳
+     * @param entityCount 处理的实体数量
+     */
+    endMonitoring(systemName: string, startTime: number, entityCount?: number): void;
+    /**
+     * 更新系统统计信息
+     * @param systemName 系统名称
+     * @param executionTime 执行时间
+     */
+    private updateStats;
+    /**
+     * 计算高级统计信息
+     * @param stats 统计信息对象
+     */
+    private calculateAdvancedStats;
+    /**
+     * 获取系统的当前性能数据
+     * @param systemName 系统名称
+     * @returns 性能数据或undefined
+     */
+    getSystemData(systemName: string): PerformanceData | undefined;
+    /**
+     * 获取系统的统计信息
+     * @param systemName 系统名称
+     * @returns 统计信息或undefined
+     */
+    getSystemStats(systemName: string): PerformanceStats | undefined;
+    /**
+     * 获取所有系统的性能数据
+     * @returns 所有系统的性能数据
+     */
+    getAllSystemData(): Map<string, PerformanceData>;
+    /**
+     * 获取所有系统的统计信息
+     * @returns 所有系统的统计信息
+     */
+    getAllSystemStats(): Map<string, PerformanceStats>;
+    /**
+     * 获取性能报告
+     * @returns 格式化的性能报告字符串
+     */
+    getPerformanceReport(): string;
+    /**
+     * 重置所有性能数据
+     */
+    reset(): void;
+    /**
+     * 重置指定系统的性能数据
+     * @param systemName 系统名称
+     */
+    resetSystem(systemName: string): void;
+    /**
+     * 获取性能警告
+     * @param thresholdMs 警告阈值（毫秒）
+     * @returns 超过阈值的系统列表
+     */
+    getPerformanceWarnings(thresholdMs?: number): string[];
+    /**
+     * 设置最大保留样本数
+     * @param maxSamples 最大样本数
+     */
+    setMaxRecentSamples(maxSamples: number): void;
+}
+//# sourceMappingURL=PerformanceMonitor.d.ts.map

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

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

package/bin/Utils/PerformanceMonitor.js

@@ -0,0 +1,270 @@
+/**
+ * 性能警告类型
+ */
+export var PerformanceWarningType;
+(function (PerformanceWarningType) {
+    PerformanceWarningType["HIGH_EXECUTION_TIME"] = "high_execution_time";
+    PerformanceWarningType["HIGH_MEMORY_USAGE"] = "high_memory_usage";
+    PerformanceWarningType["HIGH_CPU_USAGE"] = "high_cpu_usage";
+    PerformanceWarningType["FREQUENT_GC"] = "frequent_gc";
+    PerformanceWarningType["LOW_FPS"] = "low_fps";
+    PerformanceWarningType["HIGH_ENTITY_COUNT"] = "high_entity_count";
+})(PerformanceWarningType || (PerformanceWarningType = {}));
+/**
+ * 高性能监控器
+ * 用于监控ECS系统的性能表现，提供详细的分析和优化建议
+ */
+export class PerformanceMonitor {
+    /**
+     * 获取单例实例
+     */
+    static get instance() {
+        if (!PerformanceMonitor._instance) {
+            PerformanceMonitor._instance = new PerformanceMonitor();
+        }
+        return PerformanceMonitor._instance;
+    }
+    constructor() {
+        this._systemData = new Map();
+        this._systemStats = new Map();
+        this._warnings = [];
+        this._isEnabled = false;
+        this._maxRecentSamples = 60; // 保留最近60帧的数据
+        this._maxWarnings = 100; // 最大警告数量
+        // 性能阈值配置
+        this._thresholds = {
+            executionTime: { warning: 16.67, critical: 33.33 }, // 60fps和30fps对应的帧时间
+            memoryUsage: { warning: 100, critical: 200 }, // MB
+            cpuUsage: { warning: 70, critical: 90 }, // 百分比
+            fps: { warning: 45, critical: 30 },
+            entityCount: { warning: 1000, critical: 5000 }
+        };
+        // FPS监控
+        this._fpsHistory = [];
+        this._lastFrameTime = 0;
+        this._frameCount = 0;
+        this._fpsUpdateInterval = 1000; // 1秒更新一次FPS
+        this._lastFpsUpdate = 0;
+        this._currentFps = 60;
+        // 内存监控
+        this._memoryCheckInterval = 5000; // 5秒检查一次内存
+        this._lastMemoryCheck = 0;
+        this._memoryHistory = [];
+        // GC监控
+        this._gcCount = 0;
+        this._lastGcCheck = 0;
+        this._gcCheckInterval = 1000;
+    }
+    /**
+     * 启用性能监控
+     */
+    enable() {
+        this._isEnabled = true;
+    }
+    /**
+     * 禁用性能监控
+     */
+    disable() {
+        this._isEnabled = false;
+    }
+    /**
+     * 检查是否启用了性能监控
+     */
+    get isEnabled() {
+        return this._isEnabled;
+    }
+    /**
+     * 开始监控系统性能
+     * @param systemName 系统名称
+     * @returns 开始时间戳
+     */
+    startMonitoring(systemName) {
+        if (!this._isEnabled) {
+            return 0;
+        }
+        return performance.now();
+    }
+    /**
+     * 结束监控并记录性能数据
+     * @param systemName 系统名称
+     * @param startTime 开始时间戳
+     * @param entityCount 处理的实体数量
+     */
+    endMonitoring(systemName, startTime, entityCount = 0) {
+        if (!this._isEnabled || startTime === 0) {
+            return;
+        }
+        const endTime = performance.now();
+        const executionTime = endTime - startTime;
+        const averageTimePerEntity = entityCount > 0 ? executionTime / entityCount : 0;
+        // 更新当前性能数据
+        const data = {
+            name: systemName,
+            executionTime,
+            entityCount,
+            averageTimePerEntity,
+            lastUpdateTime: endTime
+        };
+        this._systemData.set(systemName, data);
+        // 更新统计信息
+        this.updateStats(systemName, executionTime);
+    }
+    /**
+     * 更新系统统计信息
+     * @param systemName 系统名称
+     * @param executionTime 执行时间
+     */
+    updateStats(systemName, executionTime) {
+        let stats = this._systemStats.get(systemName);
+        if (!stats) {
+            stats = {
+                totalTime: 0,
+                averageTime: 0,
+                minTime: Number.MAX_VALUE,
+                maxTime: 0,
+                executionCount: 0,
+                recentTimes: [],
+                standardDeviation: 0,
+                percentile95: 0,
+                percentile99: 0
+            };
+            this._systemStats.set(systemName, stats);
+        }
+        // 更新基本统计
+        stats.totalTime += executionTime;
+        stats.executionCount++;
+        stats.averageTime = stats.totalTime / stats.executionCount;
+        stats.minTime = Math.min(stats.minTime, executionTime);
+        stats.maxTime = Math.max(stats.maxTime, executionTime);
+        // 更新最近时间列表
+        stats.recentTimes.push(executionTime);
+        if (stats.recentTimes.length > this._maxRecentSamples) {
+            stats.recentTimes.shift();
+        }
+        // 计算高级统计信息
+        this.calculateAdvancedStats(stats);
+    }
+    /**
+     * 计算高级统计信息
+     * @param stats 统计信息对象
+     */
+    calculateAdvancedStats(stats) {
+        if (stats.recentTimes.length === 0)
+            return;
+        // 计算标准差
+        const mean = stats.recentTimes.reduce((a, b) => a + b, 0) / stats.recentTimes.length;
+        const variance = stats.recentTimes.reduce((acc, time) => acc + Math.pow(time - mean, 2), 0) / stats.recentTimes.length;
+        stats.standardDeviation = Math.sqrt(variance);
+        // 计算百分位数
+        const sortedTimes = [...stats.recentTimes].sort((a, b) => a - b);
+        const len = sortedTimes.length;
+        stats.percentile95 = sortedTimes[Math.floor(len * 0.95)] || 0;
+        stats.percentile99 = sortedTimes[Math.floor(len * 0.99)] || 0;
+    }
+    /**
+     * 获取系统的当前性能数据
+     * @param systemName 系统名称
+     * @returns 性能数据或undefined
+     */
+    getSystemData(systemName) {
+        return this._systemData.get(systemName);
+    }
+    /**
+     * 获取系统的统计信息
+     * @param systemName 系统名称
+     * @returns 统计信息或undefined
+     */
+    getSystemStats(systemName) {
+        return this._systemStats.get(systemName);
+    }
+    /**
+     * 获取所有系统的性能数据
+     * @returns 所有系统的性能数据
+     */
+    getAllSystemData() {
+        return new Map(this._systemData);
+    }
+    /**
+     * 获取所有系统的统计信息
+     * @returns 所有系统的统计信息
+     */
+    getAllSystemStats() {
+        return new Map(this._systemStats);
+    }
+    /**
+     * 获取性能报告
+     * @returns 格式化的性能报告字符串
+     */
+    getPerformanceReport() {
+        if (!this._isEnabled) {
+            return "Performance monitoring is disabled.";
+        }
+        const lines = [];
+        lines.push("=== ECS Performance Report ===");
+        lines.push("");
+        // 按平均执行时间排序
+        const sortedSystems = Array.from(this._systemStats.entries())
+            .sort((a, b) => b[1].averageTime - a[1].averageTime);
+        for (const [systemName, stats] of sortedSystems) {
+            const data = this._systemData.get(systemName);
+            lines.push(`System: ${systemName}`);
+            lines.push(`  Current: ${data === null || data === void 0 ? void 0 : data.executionTime.toFixed(2)}ms (${data === null || data === void 0 ? void 0 : data.entityCount} entities)`);
+            lines.push(`  Average: ${stats.averageTime.toFixed(2)}ms`);
+            lines.push(`  Min/Max: ${stats.minTime.toFixed(2)}ms / ${stats.maxTime.toFixed(2)}ms`);
+            lines.push(`  Total: ${stats.totalTime.toFixed(2)}ms (${stats.executionCount} calls)`);
+            if ((data === null || data === void 0 ? void 0 : data.averageTimePerEntity) && data.averageTimePerEntity > 0) {
+                lines.push(`  Per Entity: ${data.averageTimePerEntity.toFixed(4)}ms`);
+            }
+            lines.push("");
+        }
+        // 总体统计
+        const totalCurrentTime = Array.from(this._systemData.values())
+            .reduce((sum, data) => sum + data.executionTime, 0);
+        lines.push(`Total Frame Time: ${totalCurrentTime.toFixed(2)}ms`);
+        lines.push(`Systems Count: ${this._systemData.size}`);
+        return lines.join('\n');
+    }
+    /**
+     * 重置所有性能数据
+     */
+    reset() {
+        this._systemData.clear();
+        this._systemStats.clear();
+    }
+    /**
+     * 重置指定系统的性能数据
+     * @param systemName 系统名称
+     */
+    resetSystem(systemName) {
+        this._systemData.delete(systemName);
+        this._systemStats.delete(systemName);
+    }
+    /**
+     * 获取性能警告
+     * @param thresholdMs 警告阈值（毫秒）
+     * @returns 超过阈值的系统列表
+     */
+    getPerformanceWarnings(thresholdMs = 16.67) {
+        const warnings = [];
+        for (const [systemName, data] of this._systemData.entries()) {
+            if (data.executionTime > thresholdMs) {
+                warnings.push(`${systemName}: ${data.executionTime.toFixed(2)}ms (>${thresholdMs}ms)`);
+            }
+        }
+        return warnings;
+    }
+    /**
+     * 设置最大保留样本数
+     * @param maxSamples 最大样本数
+     */
+    setMaxRecentSamples(maxSamples) {
+        this._maxRecentSamples = maxSamples;
+        // 裁剪现有数据
+        for (const stats of this._systemStats.values()) {
+            while (stats.recentTimes.length > maxSamples) {
+                stats.recentTimes.shift();
+            }
+        }
+    }
+}
+//# sourceMappingURL=PerformanceMonitor.js.map

package/bin/Utils/PerformanceMonitor.js.map

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