@agions/taroviz 1.11.1 → 2.0.3

package/src/core/utils/common.ts

@@ -1,3 +1,15 @@
+/**
+ * Environment detection utilities
+ *
+ * Backward-compatible re-exports that delegate to the unified detectRuntime()
+ * in ./runtime.ts. New code should import detectRuntime() directly.
+ */
+
+import { detectRuntime as _detectRuntime } from './runtime';
+
+export { detectRuntime, resetRuntimeCache } from './runtime';
+export type { RuntimeInfo, MiniAppType } from './runtime';
+
 /**
  * 获取DOM元素
  * @param selector 选择器或DOM元素
@@ -21,14 +33,12 @@ export const isBrowser = typeof window !== 'undefined' && typeof document !== 'u
  * @returns 是否为NodeJS环境
  */
 export const isNode = (() => {
-  // 更可靠的环境检测：检查是否是真正的 Node.js 环境
-  // 而不是打包后的代码（如 webpack 定义的 process.env）
   try {
     return (
       typeof process !== 'undefined' &&
-      process.versions &&
-      process.versions.node &&
-      Object.prototype.toString.call(globalThis.process) === '[object process]'
+      (process as any).versions &&
+      (process as any).versions.node &&
+      Object.prototype.toString.call((globalThis as any).process) === '[object process]'
     );
   } catch {
     return false;
@@ -40,32 +50,13 @@ export const isNode = (() => {
  * @returns 是否为React Native环境
  */
 export const isReactNative =
-  typeof navigator !== 'undefined' && navigator.product === 'ReactNative';
+  typeof navigator !== 'undefined' && (navigator as any).product === 'ReactNative';
 
 /**
  * 是否为小程序环境
+ *
+ * Delegates to detectRuntime() for unified detection.
+ * Cached internally — repeated calls are cheap.
  * @returns 是否为小程序环境
  */
-export const isMiniApp = (): boolean => {
-  // 使用类型断言来安全地检查全局变量
-  const globalObj =
-    typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : {};
-
-  if (typeof (globalObj as any).wx !== 'undefined') {
-    return true;
-  }
-  if (typeof (globalObj as any).my !== 'undefined') {
-    return true;
-  }
-  if (typeof (globalObj as any).swan !== 'undefined') {
-    return true;
-  }
-  if (typeof (globalObj as any).tt !== 'undefined') {
-    return true;
-  }
-  if (typeof (globalObj as any).jd !== 'undefined') {
-    return true;
-  }
-
-  return false;
-};
+export const isMiniApp = (): boolean => _detectRuntime().isMiniApp;

package/src/core/utils/deepClone.ts

@@ -0,0 +1,114 @@
+/**
+ * Hand-written deep clone utility for ECharts option objects.
+ * Handles all JS types, circular references, and preserves function references.
+ */
+export function deepClone<T>(value: T, seen?: WeakMap<object, unknown>): T {
+  // primitives, null, undefined
+  if (value === null || value === undefined) return value;
+  if (typeof value !== 'object' && typeof value !== 'function') return value;
+  // preserve function references
+  if (typeof value === 'function') return value;
+
+  // circular reference handling
+  if (!seen) seen = new WeakMap();
+  if (seen.has(value as object)) return seen.get(value as object) as T;
+
+  // Date
+  if (value instanceof Date) {
+    const d = new Date(value.getTime());
+    seen.set(value as object, d);
+    return d as unknown as T;
+  }
+
+  // RegExp
+  if (value instanceof RegExp) {
+    const r = new RegExp(value.source, value.flags);
+    seen.set(value as object, r);
+    return r as unknown as T;
+  }
+
+  // Map
+  if (value instanceof Map) {
+    const m = new Map();
+    seen.set(value as object, m);
+    value.forEach((v, k) => {
+      m.set(deepClone(k, seen), deepClone(v, seen));
+    });
+    return m as unknown as T;
+  }
+
+  // Set
+  if (value instanceof Set) {
+    const s = new Set();
+    seen.set(value as object, s);
+    value.forEach((v) => {
+      s.add(deepClone(v, seen));
+    });
+    return s as unknown as T;
+  }
+
+  // Array
+  if (Array.isArray(value)) {
+    const arr: unknown[] = [];
+    seen.set(value as object, arr);
+    for (let i = 0; i < value.length; i++) {
+      arr[i] = deepClone(value[i], seen);
+    }
+    return arr as unknown as T;
+  }
+
+  // Plain object
+  const clone = {} as Record<string, unknown>;
+  seen.set(value as object, clone);
+  for (const key of Object.keys(value as object)) {
+    clone[key] = deepClone((value as Record<string, unknown>)[key], seen);
+  }
+  return clone as T;
+}
+
+/**
+ * Deep merge source into target. Returns a new object.
+ * Arrays are replaced, not merged. Objects are merged recursively.
+ */
+export function deepMerge<T extends Record<string, unknown>, U extends Record<string, unknown>>(
+  target: T,
+  source: U
+): T & U {
+  const result: Record<string, unknown> = {};
+
+  // Copy all target keys
+  for (const key of Object.keys(target)) {
+    result[key] = deepClone(target[key]);
+  }
+
+  // Merge source keys
+  for (const key of Object.keys(source)) {
+    const tVal = result[key];
+    const sVal = source[key];
+
+    if (
+      tVal !== null &&
+      tVal !== undefined &&
+      sVal !== null &&
+      sVal !== undefined &&
+      typeof tVal === 'object' &&
+      typeof sVal === 'object' &&
+      !Array.isArray(tVal) &&
+      !Array.isArray(sVal) &&
+      !(tVal instanceof Date) &&
+      !(tVal instanceof RegExp) &&
+      !(tVal instanceof Map) &&
+      !(tVal instanceof Set) &&
+      !(sVal instanceof Date) &&
+      !(sVal instanceof RegExp) &&
+      !(sVal instanceof Map) &&
+      !(sVal instanceof Set)
+    ) {
+      result[key] = deepMerge(tVal as Record<string, unknown>, sVal as Record<string, unknown>);
+    } else {
+      result[key] = deepClone(sVal);
+    }
+  }
+
+  return result as T & U;
+}

package/src/core/utils/download.ts

@@ -0,0 +1,128 @@
+/**
+ * 公共下载工具函数
+ * 统一 chartDownloadUtils.ts 和 ExportUtils.ts 中的重复逻辑
+ */
+
+// 定时器追踪，防止泄漏
+const timers: ReturnType<typeof setTimeout>[] = [];
+
+/**
+ * 清除所有追踪的定时器
+ */
+export function clearAllTimers(): void {
+  timers.forEach(clearTimeout);
+  timers.length = 0;
+}
+
+/**
+ * 生成默认文件名
+ * @param prefix 文件名前缀
+ * @returns 带时间戳的文件名
+ */
+export function generateFilename(prefix: string = 'chart'): string {
+  const timestamp = new Date().toISOString().slice(0, 19).replace(/[:-]/g, '');
+  return `${prefix}_${timestamp}`;
+}
+
+/**
+ * 生成带格式的文件名
+ * @param name 文件名
+ * @param format 文件格式
+ * @returns 格式化的文件名
+ */
+export function generateFormattedFilename(name: string, format: string): string {
+  const timestamp = new Date().toISOString().slice(0, 10);
+  const sanitizedName = name.replace(/[^a-zA-Z0-9\u4e00-\u9fa5]/g, '_');
+  return `${sanitizedName}_${timestamp}.${format}`;
+}
+
+/**
+ * 触发浏览器下载的通用函数
+ * @param href 下载链接
+ * @param filename 文件名
+ * @param cleanup 可选的清理回调（如 revokeObjectURL）
+ */
+function triggerDownload(href: string, filename: string, cleanup?: () => void): void {
+  if (typeof document === 'undefined') return;
+  const link = document.createElement('a');
+  link.href = href;
+  link.download = filename;
+  link.style.display = 'none';
+  document.body.appendChild(link);
+  link.click();
+  const timerId = setTimeout(() => {
+    if (link.parentNode) document.body.removeChild(link);
+    cleanup?.();
+    // Auto-remove from timers array
+    const idx = timers.indexOf(timerId);
+    if (idx !== -1) timers.splice(idx, 1);
+  }, 100);
+  timers.push(timerId);
+}
+
+/**
+ * 下载 Blob 对象
+ * @param blob Blob 数据
+ * @param filename 文件名
+ */
+export function downloadBlob(blob: Blob, filename: string): void {
+  const url = URL.createObjectURL(blob);
+  triggerDownload(url, filename, () => URL.revokeObjectURL(url));
+}
+
+/**
+ * 下载数据 URL
+ * @param dataUrl 数据 URL
+ * @param filename 文件名
+ */
+export function downloadDataUrl(dataUrl: string, filename: string): void {
+  triggerDownload(dataUrl, filename);
+}
+
+/**
+ * 下载文件（支持 string | Blob）
+ * @param data 数据（string 或 Blob）
+ * @param filename 文件名
+ * @param mimeType MIME 类型（仅当 data 为 string 时使用）
+ */
+export function downloadFile(data: string | Blob, filename: string, _mimeType?: string): void {
+  const blob =
+    typeof data === 'string' ? new Blob([data], { type: _mimeType || 'text/plain' }) : data;
+  downloadBlob(blob, filename);
+}
+
+/**
+ * DataURL 转 Blob
+ * @param dataUrl 数据 URL
+ * @returns Blob 对象
+ */
+export function dataURLToBlob(dataUrl: string): Blob {
+  const arr = dataUrl.split(',');
+  const mimeMatch = arr[0].match(/:(.*?);/);
+  const mime = mimeMatch ? mimeMatch[1] : 'image/png';
+  const bstr = atob(arr[1]);
+  const n = bstr.length;
+  const u8arr = new Uint8Array(n);
+  for (let i = 0; i < n; i++) {
+    u8arr[i] = bstr.charCodeAt(i);
+  }
+  return new Blob([u8arr], { type: mime });
+}
+
+/**
+ * CSV 转 Blob
+ * @param csv CSV 字符串
+ * @returns Blob 对象
+ */
+export function csvToBlob(csv: string): Blob {
+  return new Blob([csv], { type: 'text/csv;charset=utf-8;' });
+}
+
+/**
+ * JSON 转 Blob
+ * @param json JSON 字符串
+ * @returns Blob 对象
+ */
+export function jsonToBlob(json: string): Blob {
+  return new Blob([json], { type: 'application/json;charset=utf-8;' });
+}