@esengine/ecs-framework 2.2.20 → 2.3.0

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

@@ -0,0 +1,175 @@
+/**
+ * 性能分析器 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

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