@lytjs/devtools 4.0.5 → 4.1.0

package/dist/types/perf-collector.d.ts

@@ -0,0 +1,328 @@
+/**
+ * Lyt.js DevTools - 性能指标收集器
+ *
+ * 收集和存储各类性能指标，包括：
+ * - FCP (First Contentful Paint)
+ * - INP (Interaction to Next Paint)
+ * - 组件渲染时间
+ * - 更新频率
+ * - 内存使用（代理对象计数）
+ *
+ * 使用环形缓冲区存储指标，防止内存泄漏。
+ * 纯原生零依赖实现。
+ */
+/** FCP 指标 */
+export interface FCPMetric {
+    /** 指标名称 */
+    type: 'fcp';
+    /** FCP 时间戳 (ms, 相对于 performance.timeOrigin) */
+    value: number;
+    /** 记录时间 */
+    timestamp: number;
+}
+/** INP 指标 */
+export interface INPMetric {
+    /** 指标名称 */
+    type: 'inp';
+    /** 事件处理耗时 (ms) */
+    value: number;
+    /** 事件名称 */
+    eventName: string;
+    /** 来源组件名称 */
+    componentName?: string;
+    /** 记录时间 */
+    timestamp: number;
+}
+/** 组件渲染指标 */
+export interface RenderMetric {
+    /** 指标名称 */
+    type: 'render';
+    /** 渲染耗时 (ms) */
+    value: number;
+    /** 组件名称 */
+    componentName: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 渲染阶段: mount | update | unmount */
+    phase: 'mount' | 'update' | 'unmount';
+    /** 记录时间 */
+    timestamp: number;
+}
+/** 更新频率指标 */
+export interface UpdateFrequencyMetric {
+    /** 指标名称 */
+    type: 'update-frequency';
+    /** 组件名称 */
+    componentName: string;
+    /** 时间窗口内更新次数 */
+    count: number;
+    /** 时间窗口大小 (ms) */
+    windowMs: number;
+    /** 记录时间 */
+    timestamp: number;
+}
+/** 内存使用指标 */
+export interface MemoryMetric {
+    /** 指标名称 */
+    type: 'memory';
+    /** 代理对象数量 */
+    proxyCount: number;
+    /** 响应式状态对象数量 */
+    reactiveCount: number;
+    /** 记录时间 */
+    timestamp: number;
+}
+/** 自定义计时标记 */
+export interface CustomMarkMetric {
+    /** 指标名称 */
+    type: 'custom';
+    /** 标记名称 */
+    name: string;
+    /** 耗时 (ms) */
+    value: number;
+    /** 记录时间 */
+    timestamp: number;
+}
+/** FPS 指标 */
+export interface FPSMetric {
+    /** 指标名称 */
+    type: 'fps';
+    /** 当前 FPS */
+    value: number;
+    /** 记录时间 */
+    timestamp: number;
+}
+/** 所有指标联合类型 */
+export type Metric = FCPMetric | INPMetric | RenderMetric | UpdateFrequencyMetric | MemoryMetric | CustomMarkMetric | FPSMetric;
+/** 性能报告 */
+export interface PerformanceReport {
+    /** 报告生成时间 */
+    generatedAt: number;
+    /** FCP 指标（最新值） */
+    fcp: FCPMetric | null;
+    /** INP 指标统计 */
+    inp: {
+        /** 平均值 */
+        avg: number;
+        /** 最大值 */
+        max: number;
+        /** 最小值 */
+        min: number;
+        /** 样本数 */
+        count: number;
+    };
+    /** 组件渲染统计（按组件名分组） */
+    renderStats: {
+        /** 组件名称 */
+        componentName: string;
+        /** 渲染次数 */
+        renderCount: number;
+        /** 平均渲染时间 (ms) */
+        avgRenderTime: number;
+        /** 最大渲染时间 (ms) */
+        maxRenderTime: number;
+        /** 总渲染时间 (ms) */
+        totalRenderTime: number;
+    }[];
+    /** 更新频率统计 */
+    updateFrequencyStats: {
+        /** 组件名称 */
+        componentName: string;
+        /** 平均更新频率 (次/秒) */
+        avgFrequency: number;
+    }[];
+    /** 内存使用（最新值） */
+    memory: MemoryMetric | null;
+    /** FPS 统计 */
+    fps: {
+        /** 平均 FPS */
+        avg: number;
+        /** 最低 FPS */
+        min: number;
+        /** 样本数 */
+        count: number;
+    };
+    /** 自定义标记统计 */
+    customMarks: {
+        /** 标记名称 */
+        name: string;
+        /** 平均耗时 (ms) */
+        avg: number;
+        /** 最大耗时 (ms) */
+        max: number;
+        /** 样本数 */
+        count: number;
+    }[];
+}
+/**
+ * 性能指标收集器
+ *
+ * 收集、存储和报告各类性能指标。
+ * 使用环形缓冲区限制内存使用。
+ */
+export declare class PerformanceCollector {
+    /** FCP 指标缓冲区 */
+    private fcpBuffer;
+    /** INP 指标缓冲区 */
+    private inpBuffer;
+    /** 组件渲染指标缓冲区 */
+    private renderBuffer;
+    /** 更新频率指标缓冲区 */
+    private updateFrequencyBuffer;
+    /** 内存使用指标缓冲区 */
+    private memoryBuffer;
+    /** 自定义标记缓冲区 */
+    private customMarkBuffer;
+    /** FPS 指标缓冲区 */
+    private fpsBuffer;
+    /** 自定义标记起始时间映射 */
+    private pendingMarks;
+    /** 组件更新计数（用于计算更新频率） */
+    private componentUpdateCounts;
+    /** FPS 监控状态 */
+    private fpsState;
+    /** 是否正在录制 */
+    private _isRecording;
+    /** 缓冲区容量 */
+    private readonly bufferSize;
+    constructor(bufferSize?: number);
+    /**
+     * 记录 FCP 指标
+     *
+     * @param value - FCP 时间 (ms)，如果未提供则尝试从 Performance API 获取
+     */
+    recordFCP(value?: number): void;
+    /**
+     * 记录 INP 指标
+     *
+     * @param duration - 事件处理耗时 (ms)
+     * @param eventName - 事件名称
+     * @param componentName - 来源组件名称（可选）
+     */
+    recordINP(duration: number, eventName: string, componentName?: string): void;
+    /**
+     * 记录组件渲染
+     *
+     * @param componentName - 组件名称
+     * @param duration - 渲染耗时 (ms)
+     * @param phase - 渲染阶段
+     * @param componentId - 组件 ID（可选）
+     */
+    recordRender(componentName: string, duration: number, phase?: 'mount' | 'update' | 'unmount', componentId?: string): void;
+    /**
+     * 追踪组件更新
+     *
+     * @param componentName - 组件名称
+     */
+    private trackComponentUpdate;
+    /**
+     * 记录内存使用
+     *
+     * @param proxyCount - 代理对象数量
+     * @param reactiveCount - 响应式状态对象数量
+     */
+    recordMemory(proxyCount: number, reactiveCount: number): void;
+    /**
+     * 开始一个自定义计时标记
+     *
+     * @param name - 标记名称
+     */
+    startMark(name: string): void;
+    /**
+     * 结束一个自定义计时标记并记录结果
+     *
+     * @param name - 标记名称
+     * @returns 耗时 (ms)，如果标记不存在则返回 -1
+     */
+    endMark(name: string): number;
+    /**
+     * 开始 FPS 监控
+     */
+    startFPSMonitor(): void;
+    /**
+     * 停止 FPS 监控
+     */
+    stopFPSMonitor(): void;
+    /**
+     * 是否正在监控 FPS
+     */
+    isFPSMonitoring(): boolean;
+    /**
+     * 开始录制
+     */
+    startRecording(): void;
+    /**
+     * 停止录制
+     */
+    stopRecording(): void;
+    /**
+     * 是否正在录制
+     */
+    isRecording(): boolean;
+    /**
+     * 获取所有收集的指标
+     *
+     * @returns 所有指标数组
+     */
+    getMetrics(): Metric[];
+    /**
+     * 获取指定类型的指标
+     *
+     * @param type - 指标类型
+     * @returns 指标数组
+     */
+    getMetricsByType<T extends Metric['type']>(type: T): Extract<Metric, {
+        type: T;
+    }>[];
+    /**
+     * 获取最新 FPS 值
+     *
+     * @returns 最新 FPS 值，如果没有则返回 0
+     */
+    getCurrentFPS(): number;
+    /**
+     * 获取组件渲染排名（按平均渲染时间降序）
+     *
+     * @returns 排序后的组件渲染统计
+     */
+    getRenderRankings(): {
+        componentName: string;
+        renderCount: number;
+        avgRenderTime: number;
+        maxRenderTime: number;
+        totalRenderTime: number;
+    }[];
+    /**
+     * 获取总代理对象计数（最新值）
+     *
+     * @returns 代理对象计数，如果没有数据则返回 0
+     */
+    getProxyCount(): number;
+    /**
+     * 获取慢渲染列表（渲染时间 > 16ms）
+     *
+     * @returns 慢渲染指标数组
+     */
+    getSlowRenders(): RenderMetric[];
+    /**
+     * 生成性能摘要报告
+     *
+     * @returns 性能报告
+     */
+    getReport(): PerformanceReport;
+    /**
+     * 导出所有收集的指标为 JSON 字符串
+     *
+     * @returns JSON 字符串
+     */
+    exportJSON(): string;
+    /**
+     * 清除所有收集的指标
+     */
+    clear(): void;
+    /**
+     * 销毁收集器，停止所有监控
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=perf-collector.d.ts.map

package/dist/types/perf-collector.d.ts.map

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

package/dist/types/perf-panel.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Lyt.js DevTools 性能面板
+ *
+ * 增强版性能面板，集成 PerformanceCollector 和 ComponentProfiler，
+ * 提供实时 FPS、组件渲染排名、更新频率、代理对象计数等监控能力。
+ *
+ * 纯原生零依赖实现。
+ */
+import { PerformanceCollector, type PerformanceReport } from './perf-collector';
+import { ComponentProfiler, type ProfileResult } from './component-profiler';
+/** 性能条目（保持向后兼容） */
+export interface PerfEntry {
+    /** 组件名称 */
+    name: string;
+    /** 渲染次数 */
+    renders: number;
+    /** 总耗时 (ms) */
+    totalTime: number;
+    /** 平均耗时 (ms) */
+    avgTime: number;
+    /** 最大耗时 (ms) */
+    maxTime: number;
+    /** 最近一次耗时 (ms) */
+    lastTime: number;
+}
+/** 增强面板配置 */
+export interface EnhancedPerfPanelConfig {
+    /** 是否自动开始 FPS 监控 */
+    autoStartFPS?: boolean;
+    /** FPS 更新间隔 (ms) */
+    fpsUpdateInterval?: number;
+}
+/**
+ * 增强版性能面板
+ *
+ * 在原有 PerfPanel 基础上，集成 PerformanceCollector 和 ComponentProfiler，
+ * 提供更全面的性能监控能力。
+ */
+export declare class PerfPanel {
+    private container;
+    private entries;
+    /** 性能指标收集器 */
+    private collector;
+    /** 组件分析器 */
+    private profiler;
+    /** 是否正在录制 */
+    private isRecording;
+    /** FPS 更新定时器 */
+    private fpsUpdateTimer;
+    /** FPS 更新间隔 */
+    private fpsUpdateInterval;
+    /** 配置 */
+    private config;
+    constructor(container: HTMLElement, config?: EnhancedPerfPanelConfig);
+    /**
+     * 记录一次组件渲染
+     *
+     * @param componentName - 组件名称
+     * @param duration - 渲染耗时（毫秒）
+     */
+    recordRender(componentName: string, duration: number): void;
+    /**
+     * 获取所有性能统计（按总耗时降序排列）
+     *
+     * @returns 排序后的性能条目数组
+     */
+    getStats(): PerfEntry[];
+    /**
+     * 获取指定组件的性能数据
+     *
+     * @param componentName - 组件名称
+     * @returns 性能条目，如果不存在则返回 null
+     */
+    getEntry(componentName: string): PerfEntry | null;
+    /**
+     * 获取总渲染次数
+     *
+     * @returns 所有组件的总渲染次数
+     */
+    getTotalRenders(): number;
+    /**
+     * 获取总耗时
+     *
+     * @returns 所有组件的总耗时（毫秒）
+     */
+    getTotalTime(): number;
+    /**
+     * 清除所有性能数据
+     */
+    clear(): void;
+    /**
+     * 获取当前 FPS
+     *
+     * @returns 当前 FPS 值
+     */
+    getCurrentFPS(): number;
+    /**
+     * 开始 FPS 监控
+     */
+    startFPSMonitor(): void;
+    /**
+     * 停止 FPS 监控
+     */
+    stopFPSMonitor(): void;
+    /**
+     * 是否正在监控 FPS
+     */
+    isFPSMonitoring(): boolean;
+    /**
+     * 获取组件渲染时间排名（最慢优先）
+     *
+     * @returns 排序后的渲染统计数组
+     */
+    getRenderRankings(): {
+        componentName: string;
+        renderCount: number;
+        avgRenderTime: number;
+        maxRenderTime: number;
+        totalRenderTime: number;
+    }[];
+    /**
+     * 获取组件更新频率统计
+     *
+     * @returns 更新频率统计数组
+     */
+    getUpdateFrequencyStats(): {
+        componentName: string;
+        avgFrequency: number;
+    }[];
+    /**
+     * 记录代理对象计数
+     *
+     * @param proxyCount - 代理对象数量
+     * @param reactiveCount - 响应式状态对象数量
+     */
+    recordProxyCount(proxyCount: number, reactiveCount: number): void;
+    /**
+     * 获取当前代理对象计数
+     *
+     * @returns 代理对象数量
+     */
+    getProxyCount(): number;
+    /**
+     * 开始录制
+     */
+    startRecording(): void;
+    /**
+     * 停止录制
+     */
+    stopRecording(): void;
+    /**
+     * 是否正在录制
+     */
+    isRecordingActive(): boolean;
+    /**
+     * 导出收集的数据为 JSON 字符串
+     *
+     * @returns JSON 字符串
+     */
+    exportJSON(): string;
+    /**
+     * 获取性能报告
+     *
+     * @returns 性能报告
+     */
+    getReport(): PerformanceReport;
+    /**
+     * 开始分析指定组件
+     *
+     * @param componentName - 组件名称
+     * @returns 是否成功开始
+     */
+    startProfile(componentName: string): boolean;
+    /**
+     * 停止分析指定组件
+     *
+     * @param componentName - 组件名称
+     * @returns 分析结果
+     */
+    stopProfile(componentName: string): ProfileResult | null;
+    /**
+     * 获取组件分析快照
+     *
+     * @param componentName - 组件名称
+     * @returns 分析快照
+     */
+    getProfileSnapshot(componentName: string): ProfileResult | null;
+    /**
+     * 获取慢渲染列表
+     *
+     * @returns 慢渲染的 PerfEntry 数组
+     */
+    getSlowRenders(): PerfEntry[];
+    /**
+     * 获取性能收集器实例
+     */
+    getCollector(): PerformanceCollector;
+    /**
+     * 获取组件分析器实例
+     */
+    getProfiler(): ComponentProfiler;
+    /**
+     * 渲染增强版性能面板 UI
+     */
+    private render;
+    /**
+     * 创建统计卡片
+     */
+    private createStatCard;
+    /**
+     * 获取录制按钮样式
+     */
+    private getRecordButtonStyle;
+    /**
+     * 根据耗时返回颜色样式
+     */
+    private getPerfColor;
+    /**
+     * 启动 FPS 更新循环
+     */
+    private startFPSUpdateLoop;
+    /**
+     * 停止 FPS 更新循环
+     */
+    private stopFPSUpdateLoop;
+    /**
+     * 销毁面板，清理 DOM 和资源
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=perf-panel.d.ts.map

package/dist/types/perf-panel.d.ts.map

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