@agions/taroviz 1.11.1 → 2.0.3

package/src/core/utils/runtime.ts

@@ -0,0 +1,190 @@
+/**
+ * Unified runtime detection for TaroViz
+ *
+ * Consolidates environment detection logic that was previously duplicated
+ * between core/utils/common.ts and adapters/index.ts.
+ */
+
+/** Mini-app platform subtypes */
+export type MiniAppType =
+  | 'weapp'
+  | 'alipay'
+  | 'swan'
+  | 'tt'
+  | 'qq'
+  | 'jd'
+  | 'dd'
+  | 'kwai'
+  | 'qywx'
+  | 'lark';
+
+/** Unified runtime information */
+export interface RuntimeInfo {
+  platform: 'browser' | 'node' | 'miniapp' | 'react-native' | 'unknown';
+  miniAppType?: MiniAppType;
+  isBrowser: boolean;
+  isNode: boolean;
+  isMiniApp: boolean;
+  isReactNative: boolean;
+}
+
+/** Cached runtime result — detection only runs once */
+let cachedRuntime: RuntimeInfo | null = null;
+
+/**
+ * Reset the cached runtime info (useful for testing).
+ */
+export function resetRuntimeCache(): void {
+  cachedRuntime = null;
+}
+
+function makeResult(
+  platform: RuntimeInfo['platform'],
+  opts: Partial<Pick<RuntimeInfo, 'miniAppType'>> = {}
+): RuntimeInfo {
+  const isMiniApp = platform === 'miniapp';
+  const result: RuntimeInfo = {
+    platform,
+    isBrowser: platform === 'browser',
+    isNode: platform === 'node',
+    isMiniApp,
+    isReactNative: platform === 'react-native',
+  };
+  if (opts.miniAppType) {
+    result.miniAppType = opts.miniAppType;
+  }
+  cachedRuntime = result;
+  return result;
+}
+
+/** Safe access to global mini-app objects */
+function getGlobalObj(): Record<string, unknown> {
+  if (typeof window !== 'undefined') return window as unknown as Record<string, unknown>;
+  if (typeof globalThis !== 'undefined') return globalThis as unknown as Record<string, unknown>;
+  return {};
+}
+
+function hasGetSystemInfoSync(key: string): boolean {
+  const g = getGlobalObj();
+  const obj = g[key];
+  return (
+    typeof obj !== 'undefined' &&
+    typeof (obj as Record<string, unknown>)?.getSystemInfoSync === 'function'
+  );
+}
+
+/**
+ * Detect the current runtime environment.
+ *
+ * Combines detection logic from:
+ * - src/core/utils/common.ts (isBrowser, isNode, isReactNative, isMiniApp)
+ * - src/adapters/index.ts (detectPlatform with getSystemInfoSync checks)
+ *
+ * Results are cached after the first call.
+ */
+export function detectRuntime(): RuntimeInfo {
+  if (cachedRuntime) return cachedRuntime;
+
+  const g = getGlobalObj();
+
+  // --- Mini-app detection (order matters: more specific checks first) ---
+
+  // Enterprise WeChat must be checked before regular WeChat
+  const wx = g['wx'] as Record<string, unknown> | undefined;
+  if (typeof wx !== 'undefined' && wx?.qy) {
+    return makeResult('miniapp', { miniAppType: 'qywx' });
+  }
+
+  if (hasGetSystemInfoSync('wx')) {
+    return makeResult('miniapp', { miniAppType: 'weapp' });
+  }
+
+  if (hasGetSystemInfoSync('my')) {
+    return makeResult('miniapp', { miniAppType: 'alipay' });
+  }
+
+  if (hasGetSystemInfoSync('swan')) {
+    return makeResult('miniapp', { miniAppType: 'swan' });
+  }
+
+  if (hasGetSystemInfoSync('tt')) {
+    // Lark (Feishu) runs on the TT runtime but with appName === 'lark'
+    const ttObj = g['tt'] as Record<string, unknown> | undefined;
+    const env = ttObj?.env as Record<string, unknown> | undefined;
+    const isLark = env?.appName === 'lark';
+    return makeResult('miniapp', { miniAppType: isLark ? 'lark' : 'tt' });
+  }
+
+  if (hasGetSystemInfoSync('qq')) {
+    return makeResult('miniapp', { miniAppType: 'qq' });
+  }
+
+  if (hasGetSystemInfoSync('jd')) {
+    return makeResult('miniapp', { miniAppType: 'jd' });
+  }
+
+  if (hasGetSystemInfoSync('dd')) {
+    return makeResult('miniapp', { miniAppType: 'dd' });
+  }
+
+  // Kwai / Kuaishou: presence of ks global
+  if (typeof g['ks'] !== 'undefined') {
+    return makeResult('miniapp', { miniAppType: 'kwai' });
+  }
+
+  // --- Browser detection ---
+  if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+    return makeResult('browser');
+  }
+
+  // --- Node.js detection ---
+  try {
+    const proc = (globalThis as Record<string, unknown>).process as
+      | Record<string, unknown>
+      | undefined;
+    if (
+      typeof proc !== 'undefined' &&
+      proc.versions &&
+      (proc.versions as Record<string, unknown>).node &&
+      Object.prototype.toString.call(proc) === '[object process]'
+    ) {
+      return makeResult('node');
+    }
+  } catch {
+    // ignore
+  }
+
+  // --- React Native detection ---
+  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+    return makeResult('react-native');
+  }
+
+  return makeResult('unknown');
+}
+
+/**
+ * 检测当前环境（简易版，向后兼容）
+ * @returns 环境信息
+ */
+export function getEnvironment() {
+  const isServer = typeof window === 'undefined';
+  const isClient = !isServer;
+
+  // 使用类型断言解决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;
+
+  return {
+    isServer,
+    isClient,
+    isWeapp,
+    isAlipay,
+    isWeb,
+  };
+}

package/src/core/utils/setOptionUtils.ts

@@ -0,0 +1,59 @@
+/**
+ * ECharts setOption 优化工具
+ * 提供带性能优化的 setOption 调用
+ */
+
+import type { EChartsOption } from 'echarts';
+
+/**
+ * 优化后的 setOption 调用
+ * @param chartInstance ECharts 实例
+ * @param option 图表配置
+ * @param notMerge 是否不合并配置，默认 false
+ * @param lazyUpdate 是否延迟更新，默认 true（提升性能）
+ */
+export function setOptionWithOptimization(
+  chartInstance:
+    | { setOption: (option: EChartsOption, notMerge?: boolean, lazyUpdate?: boolean) => void }
+    | null
+    | undefined,
+  option: EChartsOption,
+  notMerge = false,
+  lazyUpdate = true
+): void {
+  if (!chartInstance?.setOption) return;
+
+  // 使用 lazyUpdate = true 减少重绘次数，提升动画性能
+  chartInstance.setOption(option, notMerge, lazyUpdate);
+}
+
+/**
+ * 批量 setOption 调用（用于动画等场景）
+ * 合并多次 setOption 调用，减少重绘
+ */
+export function batchSetOption(
+  chartInstance:
+    | { setOption: (option: EChartsOption, notMerge?: boolean, lazyUpdate?: boolean) => void }
+    | null
+    | undefined,
+  options: EChartsOption[],
+  notMerge = false
+): void {
+  if (!chartInstance?.setOption || options.length === 0) return;
+
+  // 合并所有配置
+  const mergedOption = options.reduce((acc, opt) => {
+    if (!acc) return opt;
+    // 安全合并 series
+    const accSeries = Array.isArray(acc.series) ? acc.series : [];
+    const optSeries = Array.isArray(opt.series) ? opt.series : [];
+    return {
+      ...acc,
+      ...opt,
+      series: [...accSeries, ...optSeries],
+    };
+  }, {} as EChartsOption);
+
+  // 一次性调用，使用 lazyUpdate
+  chartInstance.setOption(mergedOption, notMerge, true);
+}

package/src/core/version.ts

@@ -0,0 +1,14 @@
+/**
+ * TaroViz 版本信息
+ * 统一版本定义，避免多处重复
+ */
+
+/** 主版本号 */
+export const VERSION = '1.11.4';
+
+/** 版本信息 */
+export const versionInfo = {
+  version: VERSION,
+  name: 'taroviz',
+  description: '基于 Taro 和 ECharts 的多端图表组件库',
+} as const;