@agions/taroviz 1.11.5 → 2.0.3

package/src/core/utils/index.ts

@@ -1,170 +1,29 @@
-// 事件定义
-export const events = {
-  click: 'click',
-  mousemove: 'mousemove',
-  mouseup: 'mouseup',
-  mousedown: 'mousedown',
-  mouseover: 'mouseover',
-  mouseout: 'mouseout',
-  globalout: 'globalout',
-};
+// Re-export barrel file — all public APIs preserved
+// External import paths remain unchanged
 
-// 导入UUID工具函数
-import * as i18n from './i18n';
-import { uuid, shortId, prefixedId } from './uuid';
-
-// 导入国际化工具
-
-/**
- * 深度合并对象
- * @param target 目标对象
- * @param source 源对象
- * @returns 合并后的对象
- */
-export function deepMerge<T extends Record<string, unknown>>(
-  target: T,
-  source: Partial<Record<string, unknown>>
-): T {
-  const result: Record<string, unknown> = { ...target };
-
-  Object.keys(source).forEach((key) => {
-    if (source[key] instanceof Object && key in target && target[key] instanceof Object) {
-      result[key] = deepMerge(
-        target[key] as Record<string, unknown>,
-        source[key] as Record<string, unknown>
-      );
-    } else {
-      result[key] = source[key];
-    }
-  });
-
-  return result as T;
-}
-
-/**
- * 防抖函数
- * @param fn 需要防抖的函数
- * @param delay 延迟时间（毫秒）
- * @returns 防抖后的函数
- */
-export function debounce<T extends (...args: unknown[]) => unknown>(
-  fn: T,
-  delay: number
-): (...args: Parameters<T>) => void {
-  let timer: ReturnType<typeof setTimeout> | null = null;
-
-  return function (this: unknown, ...args: Parameters<T>): void {
-    if (timer) {
-      clearTimeout(timer);
-    }
-
-    timer = setTimeout(() => {
-      fn.call(this, ...args);
-      timer = null;
-    }, delay);
-  };
-}
-
-/**
- * 节流函数
- * @param fn 需要节流的函数
- * @param interval 间隔时间（毫秒）
- * @returns 节流后的函数
- */
-export function throttle<T extends (...args: unknown[]) => unknown>(
-  fn: T,
-  interval: number
-): (...args: Parameters<T>) => void {
-  let lastTime = 0;
+// 事件常量
+export { events } from './events';
 
-  return function (this: unknown, ...args: Parameters<T>): void {
-    const now = Date.now();
+// 对象合并
+export { deepMerge } from './merge';
 
-    if (now - lastTime >= interval) {
-      fn.call(this, ...args);
-      lastTime = now;
-    }
-  };
-}
+// 格式化与颜色工具
+export { formatNumber, getContrastColor } from './format';
 
-/**
- * 检测当前环境
- * @returns 环境信息
- */
-export function getEnvironment() {
-  const isServer = typeof window === 'undefined';
-  const isClient = !isServer;
+// 检测当前环境（简易版，向后兼容）
+export { getEnvironment } from './runtime';
 
-  // 使用类型断言解决wx和my未定义的问题
-  const win = window as Window & { wx?: unknown; my?: unknown };
-  const isWeapp =
-    typeof win.wx !== 'undefined' &&
-    typeof (win.wx as { getSystemInfoSync?: unknown })?.getSystemInfoSync === 'function';
-  const isAlipay =
-    typeof win.my !== 'undefined' &&
-    typeof (win.my as { getSystemInfoSync?: unknown })?.getSystemInfoSync === 'function';
-  const isWeb = isClient && !isWeapp && !isAlipay;
+// 统一运行时检测
+export { detectRuntime, resetRuntimeCache } from './runtime';
+export type { RuntimeInfo, MiniAppType } from './runtime';
 
-  return {
-    isServer,
-    isClient,
-    isWeapp,
-    isAlipay,
-    isWeb,
-  };
-}
+// UUID工具函数
+export { uuid, shortId, prefixedId } from './uuid';
 
-/**
- * 格式化数值
- * @param value 要格式化的数值
- * @param digits 小数位数
- * @param options 配置选项
- * @returns 格式化后的字符串
- */
-export function formatNumber(
-  value: number,
-  digits: number = 2,
-  options: {
-    useGrouping?: boolean;
-    locale?: string;
-  } = {}
-): string {
-  const { useGrouping = true, locale = 'zh-CN' } = options;
-
-  return new Intl.NumberFormat(locale, {
-    minimumFractionDigits: digits,
-    maximumFractionDigits: digits,
-    useGrouping,
-  }).format(value);
-}
-
-/**
- * 获取颜色的对比色
- * @param color 十六进制颜色值
- * @returns 对比色
- */
-export function getContrastColor(color: string): string {
-  // 移除#前缀
-  const hex = color.replace('#', '');
-
-  // 转换为RGB
-  const r = parseInt(hex.substring(0, 2), 16);
-  const g = parseInt(hex.substring(2, 4), 16);
-  const b = parseInt(hex.substring(4, 6), 16);
-
-  // 计算亮度
-  const brightness = (r * 299 + g * 587 + b * 114) / 1000;
-
-  // 根据亮度返回黑色或白色
-  return brightness > 128 ? '#000000' : '#FFFFFF';
-}
-
-// 导出UUID工具函数
-export { uuid, shortId, prefixedId };
-
-// 导出国际化工具
+// 国际化工具
+import * as i18n from './i18n';
 export { i18n };
 
-// 性能优化工具
+// 性能优化工具（含 debounce, throttle, DebounceManager 等）
 export * from './performanceUtils';
 export { DebounceManager } from './performanceUtils';

package/src/core/utils/merge.ts

@@ -0,0 +1,25 @@
+/**
+ * 深度合并对象
+ * @param target 目标对象
+ * @param source 源对象
+ * @returns 合并后的对象
+ */
+export function deepMerge<T extends Record<string, unknown>>(
+  target: T,
+  source: Partial<Record<string, unknown>>
+): T {
+  const result: Record<string, unknown> = { ...target };
+
+  Object.keys(source).forEach((key) => {
+    if (source[key] instanceof Object && key in target && target[key] instanceof Object) {
+      result[key] = deepMerge(
+        target[key] as Record<string, unknown>,
+        source[key] as Record<string, unknown>
+      );
+    } else {
+      result[key] = source[key];
+    }
+  });
+
+  return result as T;
+}

package/src/core/utils/performance/PerformanceAnalyzer.ts

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
 /**
  * TaroViz 性能分析工具核心实现
  */
@@ -169,7 +170,7 @@ export class PerformanceAnalyzer {
 
     this.isMonitoring = true;
     this.startTime = Date.now();
-    this.lastFrameTime = performance.now();
+    this.lastFrameTime = typeof performance !== 'undefined' ? performance.now() : Date.now();
 
     // 启动采样定时器
     if (this.config.sampleInterval && this.config.realTime) {
@@ -231,6 +232,7 @@ export class PerformanceAnalyzer {
    * 开始帧率监控
    */
   private startFrameRateMonitoring(): void {
+    if (typeof requestAnimationFrame === 'undefined' || typeof performance === 'undefined') return;
     const updateFrameRate = () => {
       if (!this.isMonitoring) {
         return;

package/src/core/utils/performance/hooks.ts

@@ -0,0 +1,7 @@
+/**
+ * 性能优化 Hooks
+ * 提供动画、缩放等性能相关的 hooks
+ */
+
+export { useAnimation } from './useAnimation';
+export { useDataZoom } from './useDataZoom';

package/src/core/utils/performance/index.ts

@@ -11,3 +11,5 @@ export { PerformanceAnalyzer } from './PerformanceAnalyzer';
 // 导出默认实例
 import { PerformanceAnalyzer } from './PerformanceAnalyzer';
 export const performanceAnalyzer = PerformanceAnalyzer.getInstance();
+
+export * from './hooks';

package/src/{hooks → core/utils/performance}/useAnimation.ts

@@ -1,9 +1,10 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
 /**
  * useAnimation - 图表动画控制 Hook
  * 提供图表动画的播放、暂停、控制等功能
  */
 import { useState, useCallback, useRef, useEffect, useMemo } from 'react';
-import type { ChartInstance } from './types';
+import type { ChartInstance } from '../../../hooks/types';
 
 /**
  * 动画状态
@@ -47,11 +48,11 @@ export interface UseAnimationReturn {
   /** 停止动画并重置 */
   stop: () => void;
   /** 跳转到指定帧 */
-  seekTo: (frame: number) => void;
+  seekTo: (_frame: number) => void;
   /** 跳转到指定进度 */
-  seekToProgress: (progress: number) => void;
+  seekToProgress: (_progress: number) => void;
   /** 设置播放速度 */
-  setPlaybackSpeed: (speed: number) => void;
+  setPlaybackSpeed: (_speed: number) => void;
   /** 播放速度 */
   playbackSpeed: number;
 }
@@ -248,7 +249,7 @@ export function useAnimation(
       anim.currentFrame = clampedFrame;
       setFrame(clampedFrame);
 
-      const progress = clampedFrame / currentTotalFrames;
+      const _progress = clampedFrame / currentTotalFrames;
       try {
         if (chart.setOption) {
           chart.setOption({}, false, true);

package/src/{hooks → core/utils/performance}/useDataZoom.ts

@@ -4,7 +4,7 @@
  */
 import { useRef, useCallback, useEffect, useMemo } from 'react';
 import type { RefObject } from 'react';
-import type { ChartInstance, DataZoomType, ZoomRange, EventHandler } from './types';
+import type { ChartInstance, DataZoomType, ZoomRange, EventHandler } from '../../../hooks/types';
 
 // ============================================================================
 // Hook 实现
@@ -310,7 +310,12 @@ export function useDataZoom(
 // 类型导出
 // ============================================================================
 
-export type { UseDataZoomOptions, UseDataZoomReturn, DataZoomType, ZoomRange } from './types';
+export type {
+  UseDataZoomOptions,
+  UseDataZoomReturn,
+  DataZoomType,
+  ZoomRange,
+} from '../../../hooks/types';
 
 // ============================================================================
 // 导出

package/src/{hooks → core/utils/performance}/usePerformance.ts

@@ -3,16 +3,11 @@
  * 提供实时性能指标监控和报告功能
  */
 import { useState, useEffect, useCallback, useRef } from 'react';
-import {
-  PerformanceAnalyzer,
-  PerformanceMetricType,
-  PerformanceMetric,
-} from '../core/utils/performance';
 
 /**
  * 性能监控配置
  */
-export interface UsePerformanceOptions {
+export interface UseFpsMonitorOptions {
   /** 是否启用监控 */
   enabled?: boolean;
   /** 采样间隔 (ms) */
@@ -47,10 +42,20 @@ export interface PerformanceState {
   isMonitoring: boolean;
 }
 
+/**
+ * 性能报告条目
+ */
+export interface PerformanceReportEntry {
+  type: string;
+  value: number;
+  unit: string;
+  timestamp: number;
+}
+
 /**
  * 性能监控返回值
  */
-export interface UsePerformanceReturn {
+export interface UseFpsMonitorReturn {
   /** 性能状态 */
   state: PerformanceState;
   /** 开始监控 */
@@ -60,7 +65,7 @@ export interface UsePerformanceReturn {
   /** 重置统计数据 */
   reset: () => void;
   /** 获取性能报告 */
-  getReport: () => PerformanceMetric[];
+  getReport: () => PerformanceReportEntry[];
   /** FPS 告警回调 */
   onFpsWarning?: (fps: number) => void;
 }
@@ -70,7 +75,13 @@ export interface UsePerformanceReturn {
  * @param options 配置选项
  * @returns 性能监控接口
  */
-export function usePerformance(options: UsePerformanceOptions = {}): UsePerformanceReturn {
+/** @deprecated Use `UseFpsMonitorOptions` instead */
+export type UsePerformanceOptions = UseFpsMonitorOptions;
+
+/** @deprecated Use `UseFpsMonitorReturn` instead */
+export type UsePerformanceReturn = UseFpsMonitorReturn;
+
+export function useFpsMonitor(options: UseFpsMonitorOptions = {}): UseFpsMonitorReturn {
   const {
     enabled = true,
     sampleInterval = 1000,
@@ -81,7 +92,6 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
   } = options;
 
   // Refs
-  const analyzerRef = useRef<PerformanceAnalyzer | null>(null);
   const fpsHistoryRef = useRef<number[]>([]);
   const animationFrameRef = useRef<number | null>(null);
   const lastFrameTimeRef = useRef<number>(0);
@@ -89,6 +99,7 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
     frames: 0,
     lastTime: 0,
   });
+  const reportHistoryRef = useRef<PerformanceReportEntry[]>([]);
 
   // State
   const [state, setState] = useState<PerformanceState>({
@@ -154,6 +165,14 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
         fpsHistory: [...history],
       }));
 
+      // 记录性能报告
+      reportHistoryRef.current.push({
+        type: 'fps',
+        value: fps,
+        unit: 'fps',
+        timestamp: now,
+      });
+
       // 重置计数器
       fpsAccumulatorRef.current.frames = 0;
       fpsAccumulatorRef.current.lastTime = now;
@@ -172,27 +191,17 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
     // Prevent starting multiple RAF loops
     if (animationFrameRef.current !== null) return;
 
-    // 初始化分析器
-    if (!analyzerRef.current) {
-      analyzerRef.current = PerformanceAnalyzer.getInstance({
-        enabled: true,
-        sampleInterval,
-        autoStart: false,
-      });
-    }
-
-    analyzerRef.current.start();
-
     // 重置 FPS 计算
     fpsAccumulatorRef.current = { frames: 0, lastTime: performance.now() };
     lastFrameTimeRef.current = performance.now();
     fpsHistoryRef.current = [];
+    reportHistoryRef.current = [];
 
     // 开始 FPS 监控循环
     animationFrameRef.current = requestAnimationFrame(updateFps);
 
     setState((prev) => ({ ...prev, isMonitoring: true }));
-  }, [enabled, sampleInterval, updateFps]);
+  }, [enabled, updateFps]);
 
   /**
    * 停止监控
@@ -204,9 +213,6 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
       animationFrameRef.current = null;
     }
 
-    // 停止分析器
-    analyzerRef.current?.stop();
-
     setState((prev) => ({ ...prev, isMonitoring: false }));
   }, []);
 
@@ -214,8 +220,8 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
    * 重置统计数据
    */
   const reset = useCallback(() => {
-    PerformanceAnalyzer.resetInstance();
     fpsHistoryRef.current = [];
+    reportHistoryRef.current = [];
     setState((prev) => ({
       ...prev,
       fps: 60,
@@ -230,17 +236,8 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
   /**
    * 获取性能报告
    */
-  const getReport = useCallback((): PerformanceMetric[] => {
-    if (!analyzerRef.current) return [];
-
-    try {
-      const report =
-        analyzerRef.current.getMetricsByType?.('renderTime' as PerformanceMetricType) ?? [];
-      if (!report || report.length === 0) return [];
-      return report;
-    } catch {
-      return [];
-    }
+  const getReport = useCallback((): PerformanceReportEntry[] => {
+    return reportHistoryRef.current.slice(-100); // 返回最近 100 条记录
   }, []);
 
   // 自动启动
@@ -264,10 +261,10 @@ export function usePerformance(options: UsePerformanceOptions = {}): UsePerforma
 }
 
 /**
- * 轻量级 FPS 监控 Hook
+ * 轻量级 FPS 计数器 Hook
  * 用于实时显示图表 FPS
  */
-export function useFpsMonitor(): number {
+export function useFpsCounter(): number {
   const [fps, setFps] = useState(60);
   const frameCountRef = useRef(0);
   const lastTimeRef = useRef(performance.now());
@@ -297,3 +294,6 @@ export function useFpsMonitor(): number {
 
   return fps;
 }
+
+/** @deprecated Use `useFpsMonitor` instead */
+export const usePerformance = useFpsMonitor;

package/src/{hooks → core/utils/performance}/usePerformanceHooks.ts

@@ -11,16 +11,16 @@ import { useCallback, useRef, useEffect, useState } from 'react';
  * @param delay 延迟时间 (ms)
  * @returns 防抖后的回调（包含 cancel 方法）
  */
-export function useDebounce<T extends (...args: unknown[]) => unknown>(
+export function useDebounce<T extends (..._args: unknown[]) => unknown>(
   callback: T,
   delay: number
 ): {
-  (...args: Parameters<T>): void;
+  (..._args: Parameters<T>): void;
   cancel: () => void;
   flush: () => void;
 } {
   const callbackRef = useRef(callback);
-  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const _timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   // 更新 callback 引用
   useEffect(() => {
@@ -30,22 +30,22 @@ export function useDebounce<T extends (...args: unknown[]) => unknown>(
   // 清理定时器
   useEffect(() => {
     return () => {
-      if (timeoutRef.current) {
-        clearTimeout(timeoutRef.current);
-        timeoutRef.current = null;
+      if (_timeoutRef.current) {
+        clearTimeout(_timeoutRef.current);
+        _timeoutRef.current = null;
       }
     };
   }, []);
 
   const debouncedCallback = useCallback(
-    (...args: Parameters<T>) => {
-      if (timeoutRef.current) {
-        clearTimeout(timeoutRef.current);
+    (..._args: Parameters<T>) => {
+      if (_timeoutRef.current) {
+        clearTimeout(_timeoutRef.current);
       }
 
-      timeoutRef.current = setTimeout(() => {
-        callbackRef.current(...args);
-        timeoutRef.current = null;
+      _timeoutRef.current = setTimeout(() => {
+        callbackRef.current(..._args);
+        _timeoutRef.current = null;
       }, delay);
     },
     [delay]
@@ -53,19 +53,19 @@ export function useDebounce<T extends (...args: unknown[]) => unknown>(
 
   // 添加 cancel 方法
   const cancel = useCallback(() => {
-    if (timeoutRef.current) {
-      clearTimeout(timeoutRef.current);
-      timeoutRef.current = null;
+    if (_timeoutRef.current) {
+      clearTimeout(_timeoutRef.current);
+      _timeoutRef.current = null;
     }
   }, []);
 
   // 添加 flush 方法
-  const flush = useCallback((...args: Parameters<T>) => {
-    if (timeoutRef.current) {
-      clearTimeout(timeoutRef.current);
-      timeoutRef.current = null;
+  const flush = useCallback((..._args: Parameters<T>) => {
+    if (_timeoutRef.current) {
+      clearTimeout(_timeoutRef.current);
+      _timeoutRef.current = null;
     }
-    callbackRef.current(...args);
+    callbackRef.current(..._args);
   }, []);
 
   // 将 cancel 和 flush 附加到回调函数上
@@ -81,17 +81,17 @@ export function useDebounce<T extends (...args: unknown[]) => unknown>(
  * @param options 节流选项
  * @returns 节流后的回调
  */
-export function useThrottle<T extends (...args: unknown[]) => unknown>(
+export function useThrottle<T extends (..._args: unknown[]) => unknown>(
   callback: T,
   limit: number,
   options?: {
     leading?: boolean;
     trailing?: boolean;
   }
-): (...args: Parameters<T>) => void {
+): (..._args: Parameters<T>) => void {
   const callbackRef = useRef(callback);
   const lastCallTimeRef = useRef<number>(0);
-  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const _timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const lastArgsRef = useRef<Parameters<T> | null>(null);
   const lastThisRef = useRef<unknown>(null);
 
@@ -105,36 +105,36 @@ export function useThrottle<T extends (...args: unknown[]) => unknown>(
   // 清理
   useEffect(() => {
     return () => {
-      if (timeoutRef.current) {
-        clearTimeout(timeoutRef.current);
-        timeoutRef.current = null;
+      if (_timeoutRef.current) {
+        clearTimeout(_timeoutRef.current);
+        _timeoutRef.current = null;
       }
     };
   }, []);
 
   const throttledCallback = useCallback(
-    (...args: Parameters<T>) => {
+    (..._args: Parameters<T>) => {
       const now = Date.now();
       const elapsed = now - lastCallTimeRef.current;
 
       // 保存调用上下文和参数
-      lastArgsRef.current = args;
-      lastThisRef.current = args.length > 0 ? args[0] : null;
+      lastArgsRef.current = _args;
+      lastThisRef.current = _args.length > 0 ? _args[0] : null;
 
       if (elapsed >= limit) {
         // 超过限制，立即执行
-        if (timeoutRef.current) {
-          clearTimeout(timeoutRef.current);
-          timeoutRef.current = null;
+        if (_timeoutRef.current) {
+          clearTimeout(_timeoutRef.current);
+          _timeoutRef.current = null;
         }
         lastCallTimeRef.current = now;
-        callbackRef.current(...args);
+        callbackRef.current(..._args);
         lastArgsRef.current = null;
         lastThisRef.current = null;
-      } else if (trailing && !timeoutRef.current) {
+      } else if (trailing && !_timeoutRef.current) {
         // 在节流窗口结束时执行最后一次调用
-        timeoutRef.current = setTimeout(() => {
-          timeoutRef.current = null;
+        _timeoutRef.current = setTimeout(() => {
+          _timeoutRef.current = null;
           lastCallTimeRef.current = Date.now();
           if (lastArgsRef.current && lastThisRef.current !== null) {
             callbackRef.current(...lastArgsRef.current);
@@ -154,7 +154,7 @@ export function useThrottle<T extends (...args: unknown[]) => unknown>(
  * 请求动画帧 Hook
  * 用于优化动画性能
  */
-export function useAnimationFrame(callback: (time: number) => void, enabled = true): void {
+export function useAnimationFrame(callback: (_time: number) => void, enabled = true): void {
   const callbackRef = useRef(callback);
   const animationFrameRef = useRef<number | null>(null);
 
@@ -172,8 +172,8 @@ export function useAnimationFrame(callback: (time: number) => void, enabled = tr
       return;
     }
 
-    const loop = (time: number) => {
-      callbackRef.current(time);
+    const loop = (_time: number) => {
+      callbackRef.current(_time);
       animationFrameRef.current = requestAnimationFrame(loop);
     };