@vlian/framework 1.0.0

package/dist/utils/performance.cjs

@@ -0,0 +1,371 @@
+/**
+ * 性能指标单位常量
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get PERFORMANCE_METRIC_UNITS () {
+        return PERFORMANCE_METRIC_UNITS;
+    },
+    get PERFORMANCE_METRIC_UNIT_MAP () {
+        return PERFORMANCE_METRIC_UNIT_MAP;
+    },
+    get PerformanceMonitor () {
+        return PerformanceMonitor;
+    },
+    get convertMetricsToWithUnits () {
+        return convertMetricsToWithUnits;
+    }
+});
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+const PERFORMANCE_METRIC_UNITS = {
+    /**
+   * 毫秒单位
+   */ ms: 'ms',
+    /**
+   * 无单位（分数）
+   */ none: ''
+};
+let PerformanceMonitor = class PerformanceMonitor {
+    /**
+   * 初始化 Web Vitals 收集
+   */ initWebVitals() {
+        // 采样检查移到每次上报时进行，而不是初始化时
+        // 这样可以确保监控功能始终初始化，只是选择性上报
+        // 首次内容绘制 (FCP)
+        this.observePaint('first-contentful-paint', (entry)=>{
+            if (Math.random() <= this.config.sampleRate) {
+                this.metrics.fcp = Math.round(entry.startTime);
+                this.reportInternal();
+            }
+        });
+        // 最大内容绘制 (LCP)
+        this.observeLCP();
+        // 首次输入延迟 (FID)
+        this.observeFID();
+        // 累积布局偏移 (CLS)
+        this.observeCLS();
+        // 可交互时间 (TTI) - 需要计算（延迟到页面加载完成后）
+        if (typeof window !== 'undefined' && document.readyState === 'complete') {
+            this.calculateTTI();
+        } else if (typeof window !== 'undefined') {
+            window.addEventListener('load', ()=>{
+                // 使用 requestIdleCallback 在空闲时计算
+                if (typeof requestIdleCallback !== 'undefined') {
+                    requestIdleCallback(()=>{
+                        this.calculateTTI();
+                    }, {
+                        timeout: 2000
+                    });
+                } else {
+                    setTimeout(()=>{
+                        this.calculateTTI();
+                    }, 1000);
+                }
+            });
+        }
+    }
+    /**
+   * 观察 Paint 指标
+   */ observePaint(name, callback) {
+        if (typeof PerformanceObserver === 'undefined') {
+            return;
+        }
+        try {
+            const observer = new PerformanceObserver((list)=>{
+                for (const entry of list.getEntries()){
+                    if (entry.name === name) {
+                        callback(entry);
+                        observer.disconnect();
+                    }
+                }
+            });
+            observer.observe({
+                entryTypes: [
+                    'paint'
+                ]
+            });
+            this.observers.push(observer);
+        } catch (e) {
+        // PerformanceObserver 不支持或已断开
+        }
+    }
+    /**
+   * 观察 LCP
+   */ observeLCP() {
+        if (typeof PerformanceObserver === 'undefined') {
+            return;
+        }
+        try {
+            const observer = new PerformanceObserver((list)=>{
+                const entries = list.getEntries();
+                const lastEntry = entries[entries.length - 1];
+                const lcpValue = Math.round(lastEntry.renderTime || lastEntry.loadTime || lastEntry.startTime);
+                // 采样检查和异常值检查
+                if (Math.random() <= this.config.sampleRate && lcpValue > 0 && lcpValue < 60000) {
+                    this.metrics.lcp = lcpValue;
+                    this.reportInternal();
+                }
+            });
+            observer.observe({
+                entryTypes: [
+                    'largest-contentful-paint'
+                ]
+            });
+            this.observers.push(observer);
+        } catch (e) {
+        // PerformanceObserver 不支持
+        }
+    }
+    /**
+   * 观察 FID
+   */ observeFID() {
+        if (typeof PerformanceObserver === 'undefined') {
+            return;
+        }
+        try {
+            const observer = new PerformanceObserver((list)=>{
+                for (const entry of list.getEntries()){
+                    const fidEntry = entry;
+                    const fidValue = Math.round(fidEntry.processingStart - fidEntry.startTime);
+                    // 采样检查和异常值检查
+                    if (Math.random() <= this.config.sampleRate && fidValue >= 0 && fidValue < 10000) {
+                        this.metrics.fid = fidValue;
+                        this.reportInternal();
+                    }
+                    observer.disconnect();
+                }
+            });
+            observer.observe({
+                entryTypes: [
+                    'first-input'
+                ]
+            });
+            this.observers.push(observer);
+        } catch (e) {
+        // PerformanceObserver 不支持
+        }
+    }
+    /**
+   * 观察 CLS
+   */ observeCLS() {
+        if (typeof PerformanceObserver === 'undefined') {
+            return;
+        }
+        let clsValue = 0;
+        let clsEntries = [];
+        try {
+            const observer = new PerformanceObserver((list)=>{
+                for (const entry of list.getEntries()){
+                    if (!entry.hadRecentInput) {
+                        const firstSessionEntry = clsEntries[0];
+                        const lastSessionEntry = clsEntries[clsEntries.length - 1];
+                        if (!firstSessionEntry || entry.startTime - lastSessionEntry.startTime < 1000 || entry.startTime - firstSessionEntry.startTime > 5000) {
+                            clsEntries = [
+                                entry
+                            ];
+                            clsValue = entry.value;
+                        } else {
+                            clsEntries.push(entry);
+                            clsValue += entry.value;
+                        }
+                        const roundedValue = Math.round(clsValue * 1000) / 1000;
+                        // 采样检查和异常值检查
+                        if (Math.random() <= this.config.sampleRate && roundedValue >= 0 && roundedValue < 1) {
+                            this.metrics.cls = roundedValue;
+                            this.reportInternal();
+                        }
+                    }
+                }
+            });
+            observer.observe({
+                entryTypes: [
+                    'layout-shift'
+                ]
+            });
+            this.observers.push(observer);
+        } catch (e) {
+        // PerformanceObserver 不支持
+        }
+    }
+    /**
+   * 计算 TTI
+   */ calculateTTI() {
+        if (typeof window === 'undefined' || !window.performance) {
+            return;
+        }
+        try {
+            const navigation = performance.getEntriesByType('navigation')[0];
+            if (navigation) {
+                const ttiValue = Math.round(navigation.domInteractive - navigation.fetchStart);
+                // 采样检查和异常值检查
+                if (Math.random() <= this.config.sampleRate && ttiValue > 0 && ttiValue < 60000) {
+                    this.metrics.tti = ttiValue;
+                    this.reportInternal();
+                }
+            }
+        } catch (e) {
+        // 忽略错误
+        }
+    }
+    /**
+   * 内部上报性能指标（自动上报当前指标）
+   */ reportInternal() {
+        if (this.config.onReport) {
+            // 创建指标的副本，避免外部修改影响内部状态
+            const metricsCopy = {};
+            if (this.metrics.fcp !== undefined) metricsCopy.fcp = this.metrics.fcp;
+            if (this.metrics.lcp !== undefined) metricsCopy.lcp = this.metrics.lcp;
+            if (this.metrics.fid !== undefined) metricsCopy.fid = this.metrics.fid;
+            if (this.metrics.cls !== undefined) metricsCopy.cls = this.metrics.cls;
+            if (this.metrics.tti !== undefined) metricsCopy.tti = this.metrics.tti;
+            if (this.metrics.tbt !== undefined) metricsCopy.tbt = this.metrics.tbt;
+            if (this.metrics.si !== undefined) metricsCopy.si = this.metrics.si;
+            this.config.onReport(metricsCopy);
+        }
+    }
+    /**
+   * 获取当前性能指标
+   */ getMetrics() {
+        return {
+            ...this.metrics
+        };
+    }
+    /**
+   * 手动记录自定义指标
+   */ recordMetric(name, value) {
+        this.metrics[name] = value;
+        this.reportInternal();
+    }
+    /**
+   * 清理观察者
+   */ disconnect() {
+        this.observers.forEach((observer)=>observer.disconnect());
+        this.observers = [];
+        // 停止聚合定时器
+        if (this.aggregationTimer) {
+            clearInterval(this.aggregationTimer);
+            this.aggregationTimer = undefined;
+        }
+        // 停止自动上报定时器
+        if (this.autoReportTimer) {
+            clearInterval(this.autoReportTimer);
+            this.autoReportTimer = undefined;
+        }
+    }
+    /**
+   * 启动性能指标聚合
+   */ startAggregation() {
+        this.aggregationTimer = setInterval(()=>{
+            this.aggregateMetrics();
+        }, this.config.aggregationWindow);
+    }
+    /**
+   * 聚合性能指标
+   */ aggregateMetrics() {
+        // 计算平均值、最大值、最小值等统计信息
+        // 这里简化实现，实际可以根据需要扩展
+        this.aggregatedMetrics = {
+            ...this.metrics
+        };
+    }
+    /**
+   * 获取聚合后的性能指标
+   */ getAggregatedMetrics() {
+        return {
+            ...this.aggregatedMetrics
+        };
+    }
+    /**
+   * 启动自动上报
+   */ startAutoReport() {
+        this.autoReportTimer = setInterval(()=>{
+            const metrics = this.config.enableAggregation ? this.getAggregatedMetrics() : this.getMetrics();
+            this.config.onReport(metrics);
+        }, this.config.autoReportInterval);
+    }
+    /**
+   * 手动上报性能指标
+   */ report(metrics) {
+        const metricsToReport = metrics || this.getMetrics();
+        this.config.onReport(metricsToReport);
+    }
+    constructor(config = {}){
+        _define_property(this, "config", void 0);
+        _define_property(this, "metrics", {});
+        _define_property(this, "observers", []);
+        _define_property(this, "aggregatedMetrics", {});
+        _define_property(this, "aggregationTimer", void 0);
+        _define_property(this, "autoReportTimer", void 0);
+        this.config = {
+            collectWebVitals: config.collectWebVitals ?? true,
+            onReport: config.onReport ?? (()=>{}),
+            sampleRate: config.sampleRate ?? 1.0,
+            enableAggregation: config.enableAggregation ?? false,
+            aggregationWindow: config.aggregationWindow ?? 60000,
+            autoReport: config.autoReport ?? false,
+            autoReportInterval: config.autoReportInterval ?? 300000
+        };
+        if (this.config.collectWebVitals && typeof window !== 'undefined') {
+            this.initWebVitals();
+        }
+        // 启动性能指标聚合
+        if (this.config.enableAggregation) {
+            this.startAggregation();
+        }
+        // 启动自动上报
+        if (this.config.autoReport) {
+            this.startAutoReport();
+        }
+    }
+};
+const PERFORMANCE_METRIC_UNIT_MAP = {
+    // Web Vitals 指标
+    fcp: PERFORMANCE_METRIC_UNITS.ms,
+    lcp: PERFORMANCE_METRIC_UNITS.ms,
+    fid: PERFORMANCE_METRIC_UNITS.ms,
+    cls: PERFORMANCE_METRIC_UNITS.none,
+    tti: PERFORMANCE_METRIC_UNITS.ms,
+    tbt: PERFORMANCE_METRIC_UNITS.ms,
+    si: PERFORMANCE_METRIC_UNITS.ms,
+    // 启动性能指标
+    serviceInitDuration: PERFORMANCE_METRIC_UNITS.ms,
+    initializationDuration: PERFORMANCE_METRIC_UNITS.ms,
+    firstRenderDuration: PERFORMANCE_METRIC_UNITS.ms,
+    totalStartupDuration: PERFORMANCE_METRIC_UNITS.ms
+};
+function convertMetricsToWithUnits(metrics) {
+    const result = {};
+    for (const [key, value] of Object.entries(metrics)){
+        if (value !== undefined && value !== null && typeof value === 'number') {
+            // 从映射中获取单位，如果没有映射则默认为毫秒
+            const unit = PERFORMANCE_METRIC_UNIT_MAP[key] || PERFORMANCE_METRIC_UNITS.ms;
+            result[key] = {
+                value,
+                unit
+            };
+        }
+    }
+    return result;
+}
+
+//# sourceMappingURL=performance.js.map

package/dist/utils/performance.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/performance.ts"],"sourcesContent":["/**\n * 性能指标单位常量\n */\nexport const PERFORMANCE_METRIC_UNITS = {\n  /**\n   * 毫秒单位\n   */\n  ms: 'ms',\n  /**\n   * 无单位（分数）\n   */\n  none: '',\n} as const;\n\n/**\n * 性能指标单位类型\n */\nexport type PerformanceMetricUnit = typeof PERFORMANCE_METRIC_UNITS[keyof typeof PERFORMANCE_METRIC_UNITS];\n\n/**\n * 带单位的性能指标值\n */\nexport interface PerformanceMetricValue {\n  /**\n   * 指标值\n   */\n  value: number;\n  /**\n   * 单位\n   */\n  unit: PerformanceMetricUnit;\n}\n\n/**\n * 性能指标类型\n */\nexport interface PerformanceMetrics {\n  /**\n   * First Contentful Paint (首次内容绘制)\n   * 单位：毫秒（ms）\n   */\n  fcp?: number;\n  /**\n   * Largest Contentful Paint (最大内容绘制)\n   * 单位：毫秒（ms）\n   */\n  lcp?: number;\n  /**\n   * First Input Delay (首次输入延迟)\n   * 单位：毫秒（ms）\n   */\n  fid?: number;\n  /**\n   * Cumulative Layout Shift (累积布局偏移)\n   * 单位：无（分数）\n   */\n  cls?: number;\n  /**\n   * Time to Interactive (可交互时间)\n   * 单位：毫秒（ms）\n   */\n  tti?: number;\n  /**\n   * Total Blocking Time (总阻塞时间)\n   * 单位：毫秒（ms）\n   */\n  tbt?: number;\n  /**\n   * Speed Index (速度指数)\n   * 单位：毫秒（ms）\n   */\n  si?: number;\n}\n\n/**\n * 性能监控配置\n */\nexport interface PerformanceMonitorConfig {\n  /**\n   * 是否自动收集 Web Vitals\n   */\n  collectWebVitals?: boolean;\n  /**\n   * 性能指标上报回调\n   */\n  onReport?: (metrics: PerformanceMetrics) => void;\n  /**\n   * 采样率 (0-1)\n   */\n  sampleRate?: number;\n  /**\n   * 是否启用性能指标聚合\n   */\n  enableAggregation?: boolean;\n  /**\n   * 性能指标聚合窗口大小（毫秒）\n   */\n  aggregationWindow?: number;\n  /**\n   * 是否自动上报性能指标\n   */\n  autoReport?: boolean;\n  /**\n   * 自动上报间隔（毫秒）\n   */\n  autoReportInterval?: number;\n}\n\n/**\n * 性能监控类\n */\nexport class PerformanceMonitor {\n  private config: Required<PerformanceMonitorConfig>;\n  private metrics: PerformanceMetrics = {};\n  private observers: PerformanceObserver[] = [];\n  private aggregatedMetrics: PerformanceMetrics = {};\n  private aggregationTimer?: ReturnType<typeof setInterval>;\n  private autoReportTimer?: ReturnType<typeof setInterval>;\n\n  constructor(config: PerformanceMonitorConfig = {}) {\n    this.config = {\n      collectWebVitals: config.collectWebVitals ?? true,\n      onReport: config.onReport ?? (() => {}),\n      sampleRate: config.sampleRate ?? 1.0,\n      enableAggregation: config.enableAggregation ?? false,\n      aggregationWindow: config.aggregationWindow ?? 60000, // 1分钟\n      autoReport: config.autoReport ?? false,\n      autoReportInterval: config.autoReportInterval ?? 300000, // 5分钟\n    };\n\n    if (this.config.collectWebVitals && typeof window !== 'undefined') {\n      this.initWebVitals();\n    }\n\n    // 启动性能指标聚合\n    if (this.config.enableAggregation) {\n      this.startAggregation();\n    }\n\n    // 启动自动上报\n    if (this.config.autoReport) {\n      this.startAutoReport();\n    }\n  }\n\n  /**\n   * 初始化 Web Vitals 收集\n   */\n  private initWebVitals(): void {\n    // 采样检查移到每次上报时进行，而不是初始化时\n    // 这样可以确保监控功能始终初始化，只是选择性上报\n\n    // 首次内容绘制 (FCP)\n    this.observePaint('first-contentful-paint', (entry) => {\n      if (Math.random() <= this.config.sampleRate) {\n        this.metrics.fcp = Math.round(entry.startTime);\n        this.reportInternal();\n      }\n    });\n\n    // 最大内容绘制 (LCP)\n    this.observeLCP();\n\n    // 首次输入延迟 (FID)\n    this.observeFID();\n\n    // 累积布局偏移 (CLS)\n    this.observeCLS();\n\n    // 可交互时间 (TTI) - 需要计算（延迟到页面加载完成后）\n    if (typeof window !== 'undefined' && document.readyState === 'complete') {\n      this.calculateTTI();\n    } else if (typeof window !== 'undefined') {\n      window.addEventListener('load', () => {\n        // 使用 requestIdleCallback 在空闲时计算\n        if (typeof requestIdleCallback !== 'undefined') {\n          requestIdleCallback(() => {\n            this.calculateTTI();\n          }, { timeout: 2000 });\n        } else {\n          setTimeout(() => {\n            this.calculateTTI();\n          }, 1000);\n        }\n      });\n    }\n  }\n\n  /**\n   * 观察 Paint 指标\n   */\n  private observePaint(name: string, callback: (entry: PerformanceEntry) => void): void {\n    if (typeof PerformanceObserver === 'undefined') {\n      return;\n    }\n\n    try {\n      const observer = new PerformanceObserver((list) => {\n        for (const entry of list.getEntries()) {\n          if (entry.name === name) {\n            callback(entry);\n            observer.disconnect();\n          }\n        }\n      });\n      observer.observe({ entryTypes: ['paint'] });\n      this.observers.push(observer);\n    } catch (e) {\n      // PerformanceObserver 不支持或已断开\n    }\n  }\n\n  /**\n   * 观察 LCP\n   */\n  private observeLCP(): void {\n    if (typeof PerformanceObserver === 'undefined') {\n      return;\n    }\n\n    try {\n      const observer = new PerformanceObserver((list) => {\n        const entries = list.getEntries();\n        const lastEntry = entries[entries.length - 1] as PerformanceEntry & { renderTime?: number; loadTime?: number };\n        const lcpValue = Math.round((lastEntry.renderTime || lastEntry.loadTime || lastEntry.startTime));\n        \n        // 采样检查和异常值检查\n        if (Math.random() <= this.config.sampleRate && lcpValue > 0 && lcpValue < 60000) {\n          this.metrics.lcp = lcpValue;\n          this.reportInternal();\n        }\n      });\n      observer.observe({ entryTypes: ['largest-contentful-paint'] });\n      this.observers.push(observer);\n    } catch (e) {\n      // PerformanceObserver 不支持\n    }\n  }\n\n  /**\n   * 观察 FID\n   */\n  private observeFID(): void {\n    if (typeof PerformanceObserver === 'undefined') {\n      return;\n    }\n\n    try {\n      const observer = new PerformanceObserver((list) => {\n        for (const entry of list.getEntries()) {\n          const fidEntry = entry as PerformanceEventTiming;\n          const fidValue = Math.round(fidEntry.processingStart - fidEntry.startTime);\n          \n          // 采样检查和异常值检查\n          if (Math.random() <= this.config.sampleRate && fidValue >= 0 && fidValue < 10000) {\n            this.metrics.fid = fidValue;\n            this.reportInternal();\n          }\n          observer.disconnect();\n        }\n      });\n      observer.observe({ entryTypes: ['first-input'] });\n      this.observers.push(observer);\n    } catch (e) {\n      // PerformanceObserver 不支持\n    }\n  }\n\n  /**\n   * 观察 CLS\n   */\n  private observeCLS(): void {\n    if (typeof PerformanceObserver === 'undefined') {\n      return;\n    }\n\n    let clsValue = 0;\n    let clsEntries: PerformanceEntry[] = [];\n\n    try {\n      const observer = new PerformanceObserver((list) => {\n        for (const entry of list.getEntries()) {\n          if (!(entry as any).hadRecentInput) {\n            const firstSessionEntry = clsEntries[0];\n            const lastSessionEntry = clsEntries[clsEntries.length - 1];\n\n            if (\n              !firstSessionEntry ||\n              entry.startTime - lastSessionEntry.startTime < 1000 ||\n              entry.startTime - firstSessionEntry.startTime > 5000\n            ) {\n              clsEntries = [entry];\n              clsValue = (entry as any).value;\n            } else {\n              clsEntries.push(entry);\n              clsValue += (entry as any).value;\n            }\n\n            const roundedValue = Math.round(clsValue * 1000) / 1000;\n            // 采样检查和异常值检查\n            if (Math.random() <= this.config.sampleRate && roundedValue >= 0 && roundedValue < 1) {\n              this.metrics.cls = roundedValue;\n              this.reportInternal();\n            }\n          }\n        }\n      });\n      observer.observe({ entryTypes: ['layout-shift'] });\n      this.observers.push(observer);\n    } catch (e) {\n      // PerformanceObserver 不支持\n    }\n  }\n\n  /**\n   * 计算 TTI\n   */\n  private calculateTTI(): void {\n    if (typeof window === 'undefined' || !window.performance) {\n      return;\n    }\n\n    try {\n      const navigation = performance.getEntriesByType('navigation')[0] as PerformanceNavigationTiming;\n      if (navigation) {\n        const ttiValue = Math.round(navigation.domInteractive - navigation.fetchStart);\n        // 采样检查和异常值检查\n        if (Math.random() <= this.config.sampleRate && ttiValue > 0 && ttiValue < 60000) {\n          this.metrics.tti = ttiValue;\n          this.reportInternal();\n        }\n      }\n    } catch (e) {\n      // 忽略错误\n    }\n  }\n\n  /**\n   * 内部上报性能指标（自动上报当前指标）\n   */\n  private reportInternal(): void {\n    if (this.config.onReport) {\n      // 创建指标的副本，避免外部修改影响内部状态\n      const metricsCopy: PerformanceMetrics = {};\n      if (this.metrics.fcp !== undefined) metricsCopy.fcp = this.metrics.fcp;\n      if (this.metrics.lcp !== undefined) metricsCopy.lcp = this.metrics.lcp;\n      if (this.metrics.fid !== undefined) metricsCopy.fid = this.metrics.fid;\n      if (this.metrics.cls !== undefined) metricsCopy.cls = this.metrics.cls;\n      if (this.metrics.tti !== undefined) metricsCopy.tti = this.metrics.tti;\n      if (this.metrics.tbt !== undefined) metricsCopy.tbt = this.metrics.tbt;\n      if (this.metrics.si !== undefined) metricsCopy.si = this.metrics.si;\n      \n      this.config.onReport(metricsCopy);\n    }\n  }\n\n  /**\n   * 获取当前性能指标\n   */\n  getMetrics(): PerformanceMetrics {\n    return { ...this.metrics };\n  }\n\n  /**\n   * 手动记录自定义指标\n   */\n  recordMetric(name: string, value: number): void {\n    (this.metrics as Record<string, number>)[name] = value;\n    this.reportInternal();\n  }\n\n  /**\n   * 清理观察者\n   */\n  disconnect(): void {\n    this.observers.forEach((observer) => observer.disconnect());\n    this.observers = [];\n\n    // 停止聚合定时器\n    if (this.aggregationTimer) {\n      clearInterval(this.aggregationTimer);\n      this.aggregationTimer = undefined;\n    }\n\n    // 停止自动上报定时器\n    if (this.autoReportTimer) {\n      clearInterval(this.autoReportTimer);\n      this.autoReportTimer = undefined;\n    }\n  }\n\n  /**\n   * 启动性能指标聚合\n   */\n  private startAggregation(): void {\n    this.aggregationTimer = setInterval(() => {\n      this.aggregateMetrics();\n    }, this.config.aggregationWindow);\n  }\n\n  /**\n   * 聚合性能指标\n   */\n  private aggregateMetrics(): void {\n    // 计算平均值、最大值、最小值等统计信息\n    // 这里简化实现，实际可以根据需要扩展\n    this.aggregatedMetrics = { ...this.metrics };\n  }\n\n  /**\n   * 获取聚合后的性能指标\n   */\n  getAggregatedMetrics(): PerformanceMetrics {\n    return { ...this.aggregatedMetrics };\n  }\n\n  /**\n   * 启动自动上报\n   */\n  private startAutoReport(): void {\n    this.autoReportTimer = setInterval(() => {\n      const metrics = this.config.enableAggregation \n        ? this.getAggregatedMetrics() \n        : this.getMetrics();\n      this.config.onReport(metrics);\n    }, this.config.autoReportInterval);\n  }\n\n  /**\n   * 手动上报性能指标\n   */\n  report(metrics?: PerformanceMetrics): void {\n    const metricsToReport = metrics || this.getMetrics();\n    this.config.onReport(metricsToReport);\n  }\n}\n\n/**\n * 带单位的性能指标类型\n */\nexport interface PerformanceMetricsWithUnits {\n  /**\n   * First Contentful Paint (首次内容绘制)\n   * 单位：毫秒（ms）\n   */\n  fcp?: PerformanceMetricValue;\n  /**\n   * Largest Contentful Paint (最大内容绘制)\n   * 单位：毫秒（ms）\n   */\n  lcp?: PerformanceMetricValue;\n  /**\n   * First Input Delay (首次输入延迟)\n   * 单位：毫秒（ms）\n   */\n  fid?: PerformanceMetricValue;\n  /**\n   * Cumulative Layout Shift (累积布局偏移)\n   * 单位：无（分数）\n   */\n  cls?: PerformanceMetricValue;\n  /**\n   * Time to Interactive (可交互时间)\n   * 单位：毫秒（ms）\n   */\n  tti?: PerformanceMetricValue;\n  /**\n   * Total Blocking Time (总阻塞时间)\n   * 单位：毫秒（ms）\n   */\n  tbt?: PerformanceMetricValue;\n  /**\n   * Speed Index (速度指数)\n   * 单位：毫秒（ms）\n   */\n  si?: PerformanceMetricValue;\n  /**\n   * 服务初始化耗时\n   * 单位：毫秒（ms）\n   */\n  serviceInitDuration?: PerformanceMetricValue;\n  /**\n   * 初始化耗时\n   * 单位：毫秒（ms）\n   */\n  initializationDuration?: PerformanceMetricValue;\n  /**\n   * 首次渲染耗时\n   * 单位：毫秒（ms）\n   */\n  firstRenderDuration?: PerformanceMetricValue;\n  /**\n   * 总启动耗时\n   * 单位：毫秒（ms）\n   */\n  totalStartupDuration?: PerformanceMetricValue;\n}\n\n/**\n * 性能指标单位映射（包含所有可能的指标键）\n */\nexport const PERFORMANCE_METRIC_UNIT_MAP: Record<string, PerformanceMetricUnit> = {\n  // Web Vitals 指标\n  fcp: PERFORMANCE_METRIC_UNITS.ms,\n  lcp: PERFORMANCE_METRIC_UNITS.ms,\n  fid: PERFORMANCE_METRIC_UNITS.ms,\n  cls: PERFORMANCE_METRIC_UNITS.none,\n  tti: PERFORMANCE_METRIC_UNITS.ms,\n  tbt: PERFORMANCE_METRIC_UNITS.ms,\n  si: PERFORMANCE_METRIC_UNITS.ms,\n  // 启动性能指标\n  serviceInitDuration: PERFORMANCE_METRIC_UNITS.ms,\n  initializationDuration: PERFORMANCE_METRIC_UNITS.ms,\n  firstRenderDuration: PERFORMANCE_METRIC_UNITS.ms,\n  totalStartupDuration: PERFORMANCE_METRIC_UNITS.ms,\n};\n\n/**\n * 将性能指标转换为带单位的格式\n * \n * @param metrics - 性能指标对象（可能包含 Web Vitals 和启动性能指标）\n * @returns 带单位的性能指标对象\n */\nexport function convertMetricsToWithUnits(metrics: PerformanceMetrics | Record<string, number>): PerformanceMetricsWithUnits {\n  const result: PerformanceMetricsWithUnits = {};\n  \n  for (const [key, value] of Object.entries(metrics)) {\n    if (value !== undefined && value !== null && typeof value === 'number') {\n      // 从映射中获取单位，如果没有映射则默认为毫秒\n      const unit = PERFORMANCE_METRIC_UNIT_MAP[key] || PERFORMANCE_METRIC_UNITS.ms;\n      (result as Record<string, PerformanceMetricValue>)[key] = {\n        value,\n        unit,\n      };\n    }\n  }\n  \n  return result;\n}\n\n/**\n * 性能事件时间接口\n */\ninterface PerformanceEventTiming extends PerformanceEntry {\n  processingStart: number;\n}\n"],"names":["PERFORMANCE_METRIC_UNITS","PERFORMANCE_METRIC_UNIT_MAP","PerformanceMonitor","convertMetricsToWithUnits","ms","none","initWebVitals","observePaint","entry","Math","random","config","sampleRate","metrics","fcp","round","startTime","reportInternal","observeLCP","observeFID","observeCLS","window","document","readyState","calculateTTI","addEventListener","requestIdleCallback","timeout","setTimeout","name","callback","PerformanceObserver","observer","list","getEntries","disconnect","observe","entryTypes","observers","push","e","entries","lastEntry","length","lcpValue","renderTime","loadTime","lcp","fidEntry","fidValue","processingStart","fid","clsValue","clsEntries","hadRecentInput","firstSessionEntry","lastSessionEntry","value","roundedValue","cls","performance","navigation","getEntriesByType","ttiValue","domInteractive","fetchStart","tti","onReport","metricsCopy","undefined","tbt","si","getMetrics","recordMetric","forEach","aggregationTimer","clearInterval","autoReportTimer","startAggregation","setInterval","aggregateMetrics","aggregationWindow","aggregatedMetrics","getAggregatedMetrics","startAutoReport","enableAggregation","autoReportInterval","report","metricsToReport","collectWebVitals","autoReport","serviceInitDuration","initializationDuration","firstRenderDuration","totalStartupDuration","result","key","Object","unit"],"mappings":"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"}

package/dist/utils/performance.d.ts

@@ -0,0 +1,247 @@
+/**
+ * 性能指标单位常量
+ */
+export declare const PERFORMANCE_METRIC_UNITS: {
+    /**
+     * 毫秒单位
+     */
+    readonly ms: "ms";
+    /**
+     * 无单位（分数）
+     */
+    readonly none: "";
+};
+/**
+ * 性能指标单位类型
+ */
+export type PerformanceMetricUnit = typeof PERFORMANCE_METRIC_UNITS[keyof typeof PERFORMANCE_METRIC_UNITS];
+/**
+ * 带单位的性能指标值
+ */
+export interface PerformanceMetricValue {
+    /**
+     * 指标值
+     */
+    value: number;
+    /**
+     * 单位
+     */
+    unit: PerformanceMetricUnit;
+}
+/**
+ * 性能指标类型
+ */
+export interface PerformanceMetrics {
+    /**
+     * First Contentful Paint (首次内容绘制)
+     * 单位：毫秒（ms）
+     */
+    fcp?: number;
+    /**
+     * Largest Contentful Paint (最大内容绘制)
+     * 单位：毫秒（ms）
+     */
+    lcp?: number;
+    /**
+     * First Input Delay (首次输入延迟)
+     * 单位：毫秒（ms）
+     */
+    fid?: number;
+    /**
+     * Cumulative Layout Shift (累积布局偏移)
+     * 单位：无（分数）
+     */
+    cls?: number;
+    /**
+     * Time to Interactive (可交互时间)
+     * 单位：毫秒（ms）
+     */
+    tti?: number;
+    /**
+     * Total Blocking Time (总阻塞时间)
+     * 单位：毫秒（ms）
+     */
+    tbt?: number;
+    /**
+     * Speed Index (速度指数)
+     * 单位：毫秒（ms）
+     */
+    si?: number;
+}
+/**
+ * 性能监控配置
+ */
+export interface PerformanceMonitorConfig {
+    /**
+     * 是否自动收集 Web Vitals
+     */
+    collectWebVitals?: boolean;
+    /**
+     * 性能指标上报回调
+     */
+    onReport?: (metrics: PerformanceMetrics) => void;
+    /**
+     * 采样率 (0-1)
+     */
+    sampleRate?: number;
+    /**
+     * 是否启用性能指标聚合
+     */
+    enableAggregation?: boolean;
+    /**
+     * 性能指标聚合窗口大小（毫秒）
+     */
+    aggregationWindow?: number;
+    /**
+     * 是否自动上报性能指标
+     */
+    autoReport?: boolean;
+    /**
+     * 自动上报间隔（毫秒）
+     */
+    autoReportInterval?: number;
+}
+/**
+ * 性能监控类
+ */
+export declare class PerformanceMonitor {
+    private config;
+    private metrics;
+    private observers;
+    private aggregatedMetrics;
+    private aggregationTimer?;
+    private autoReportTimer?;
+    constructor(config?: PerformanceMonitorConfig);
+    /**
+     * 初始化 Web Vitals 收集
+     */
+    private initWebVitals;
+    /**
+     * 观察 Paint 指标
+     */
+    private observePaint;
+    /**
+     * 观察 LCP
+     */
+    private observeLCP;
+    /**
+     * 观察 FID
+     */
+    private observeFID;
+    /**
+     * 观察 CLS
+     */
+    private observeCLS;
+    /**
+     * 计算 TTI
+     */
+    private calculateTTI;
+    /**
+     * 内部上报性能指标（自动上报当前指标）
+     */
+    private reportInternal;
+    /**
+     * 获取当前性能指标
+     */
+    getMetrics(): PerformanceMetrics;
+    /**
+     * 手动记录自定义指标
+     */
+    recordMetric(name: string, value: number): void;
+    /**
+     * 清理观察者
+     */
+    disconnect(): void;
+    /**
+     * 启动性能指标聚合
+     */
+    private startAggregation;
+    /**
+     * 聚合性能指标
+     */
+    private aggregateMetrics;
+    /**
+     * 获取聚合后的性能指标
+     */
+    getAggregatedMetrics(): PerformanceMetrics;
+    /**
+     * 启动自动上报
+     */
+    private startAutoReport;
+    /**
+     * 手动上报性能指标
+     */
+    report(metrics?: PerformanceMetrics): void;
+}
+/**
+ * 带单位的性能指标类型
+ */
+export interface PerformanceMetricsWithUnits {
+    /**
+     * First Contentful Paint (首次内容绘制)
+     * 单位：毫秒（ms）
+     */
+    fcp?: PerformanceMetricValue;
+    /**
+     * Largest Contentful Paint (最大内容绘制)
+     * 单位：毫秒（ms）
+     */
+    lcp?: PerformanceMetricValue;
+    /**
+     * First Input Delay (首次输入延迟)
+     * 单位：毫秒（ms）
+     */
+    fid?: PerformanceMetricValue;
+    /**
+     * Cumulative Layout Shift (累积布局偏移)
+     * 单位：无（分数）
+     */
+    cls?: PerformanceMetricValue;
+    /**
+     * Time to Interactive (可交互时间)
+     * 单位：毫秒（ms）
+     */
+    tti?: PerformanceMetricValue;
+    /**
+     * Total Blocking Time (总阻塞时间)
+     * 单位：毫秒（ms）
+     */
+    tbt?: PerformanceMetricValue;
+    /**
+     * Speed Index (速度指数)
+     * 单位：毫秒（ms）
+     */
+    si?: PerformanceMetricValue;
+    /**
+     * 服务初始化耗时
+     * 单位：毫秒（ms）
+     */
+    serviceInitDuration?: PerformanceMetricValue;
+    /**
+     * 初始化耗时
+     * 单位：毫秒（ms）
+     */
+    initializationDuration?: PerformanceMetricValue;
+    /**
+     * 首次渲染耗时
+     * 单位：毫秒（ms）
+     */
+    firstRenderDuration?: PerformanceMetricValue;
+    /**
+     * 总启动耗时
+     * 单位：毫秒（ms）
+     */
+    totalStartupDuration?: PerformanceMetricValue;
+}
+/**
+ * 性能指标单位映射（包含所有可能的指标键）
+ */
+export declare const PERFORMANCE_METRIC_UNIT_MAP: Record<string, PerformanceMetricUnit>;
+/**
+ * 将性能指标转换为带单位的格式
+ *
+ * @param metrics - 性能指标对象（可能包含 Web Vitals 和启动性能指标）
+ * @returns 带单位的性能指标对象
+ */
+export declare function convertMetricsToWithUnits(metrics: PerformanceMetrics | Record<string, number>): PerformanceMetricsWithUnits;
+//# sourceMappingURL=performance.d.ts.map

package/dist/utils/performance.d.ts.map

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