@esengine/ecs-framework 2.3.0 → 2.3.1

package/bin/Utils/Profiler/ProfilerSDK.d.ts

@@ -1,175 +0,0 @@
-/**
- * 性能分析器 SDK
- *
- * 提供统一的性能分析接口，支持：
- * - 手动采样标记
- * - 自动作用域测量
- * - 调用层级追踪
- * - 计数器和仪表
- */
-import { ProfileCategory, ProfileFrame, SampleHandle, ProfilerConfig, CallGraphNode, ProfileReport } from './ProfilerTypes';
-/**
- * 性能分析器 SDK
- */
-export declare class ProfilerSDK {
-    private static instance;
-    private config;
-    private currentFrame;
-    private frameHistory;
-    private frameNumber;
-    private activeSamples;
-    private sampleStack;
-    private counters;
-    private callGraph;
-    private gcCount;
-    private previousHeapSize;
-    private longTasks;
-    private performanceObserver;
-    private constructor();
-    /**
-     * 获取单例实例
-     */
-    static getInstance(config?: Partial<ProfilerConfig>): ProfilerSDK;
-    /**
-     * 重置实例（测试用）
-     */
-    static resetInstance(): void;
-    /**
-     * 开始采样
-     */
-    static beginSample(name: string, category?: ProfileCategory): SampleHandle | null;
-    /**
-     * 结束采样
-     */
-    static endSample(handle: SampleHandle | null): void;
-    /**
-     * 测量同步函数执行时间
-     */
-    static measure<T>(name: string, fn: () => T, category?: ProfileCategory): T;
-    /**
-     * 测量异步函数执行时间
-     */
-    static measureAsync<T>(name: string, fn: () => Promise<T>, category?: ProfileCategory): Promise<T>;
-    /**
-     * 开始帧
-     */
-    static beginFrame(): void;
-    /**
-     * 结束帧
-     */
-    static endFrame(): void;
-    /**
-     * 递增计数器
-     */
-    static incrementCounter(name: string, value?: number, category?: ProfileCategory): void;
-    /**
-     * 设置仪表值
-     */
-    static setGauge(name: string, value: number, category?: ProfileCategory): void;
-    /**
-     * 启用/禁用分析器
-     */
-    static setEnabled(enabled: boolean): void;
-    /**
-     * 检查是否启用
-     */
-    static isEnabled(): boolean;
-    /**
-     * 获取当前帧数据
-     */
-    static getCurrentFrame(): ProfileFrame | null;
-    /**
-     * 获取帧历史
-     */
-    static getFrameHistory(): ProfileFrame[];
-    /**
-     * 获取分析报告
-     */
-    static getReport(frameCount?: number): ProfileReport;
-    /**
-     * 重置数据
-     */
-    static reset(): void;
-    /**
-     * 开始采样
-     */
-    beginSample(name: string, category?: ProfileCategory): SampleHandle | null;
-    /**
-     * 结束采样
-     */
-    endSample(handle: SampleHandle): void;
-    /**
-     * 测量同步函数
-     */
-    measure<T>(name: string, fn: () => T, category?: ProfileCategory): T;
-    /**
-     * 测量异步函数
-     */
-    measureAsync<T>(name: string, fn: () => Promise<T>, category?: ProfileCategory): Promise<T>;
-    /**
-     * 开始帧
-     */
-    beginFrame(): void;
-    /**
-     * 结束帧
-     */
-    endFrame(): void;
-    /**
-     * 递增计数器
-     */
-    incrementCounter(name: string, value?: number, category?: ProfileCategory): void;
-    /**
-     * 设置仪表值
-     */
-    setGauge(name: string, value: number, category?: ProfileCategory): void;
-    /**
-     * 设置启用状态
-     */
-    setEnabled(enabled: boolean): void;
-    /**
-     * 重置数据
-     */
-    reset(): void;
-    /**
-     * 生成分析报告
-     */
-    generateReport(frameCount?: number): ProfileReport;
-    /**
-     * 从帧历史构建调用图
-     * 注意：totalTime 存储的是平均耗时（总耗时/调用次数），而不是累计总耗时
-     */
-    private buildCallGraphFromFrames;
-    /**
-     * 获取调用图数据
-     */
-    getCallGraph(): Map<string, CallGraphNode>;
-    /**
-     * 获取特定函数的调用关系
-     */
-    getFunctionCallInfo(name: string): {
-        callers: Array<{
-            name: string;
-            count: number;
-            totalTime: number;
-        }>;
-        callees: Array<{
-            name: string;
-            count: number;
-            totalTime: number;
-        }>;
-    } | null;
-    /**
-     * 释放资源
-     */
-    dispose(): void;
-    private captureMemory;
-    private resetFrameCounters;
-    private calculateSampleStats;
-    private calculateCategoryStats;
-    private updateCallGraph;
-    private aggregateSampleStats;
-    private aggregateCategoryStats;
-    private setupLongTaskObserver;
-    private createEmptyReport;
-}
-//# sourceMappingURL=ProfilerSDK.d.ts.map

package/bin/Utils/Profiler/ProfilerSDK.d.ts.map

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