@qy_better_lib/core 0.1.3 → 0.1.4

package/lib/utils/echarts.d.ts

@@ -1,12 +1,16 @@
 /**
  * Echarts图表字体、间距自适应
- * @param size
- * @param defalteWidth
- * @returns
+ * @param size 原始尺寸
+ * @param deflate_width 基准宽度，默认1920
+ * @returns 自适应后的尺寸
  */
-export declare function auto_size(size: number, defalteWidth?: number): number;
+export declare function auto_size(size: number, deflate_width?: number): number;
 /**
  * Echarts线性渐变颜色
+ * @param type 渐变类型，'v'为垂直渐变，'h'为水平渐变
+ * @param start_color 起始颜色
+ * @param end_color 结束颜色
+ * @returns 渐变配置对象
  */
 export declare function get_chart_gradient_color(type: 'v' | 'h', start_color: string, end_color: string): {
     type: string;
@@ -19,3 +23,127 @@ export declare function get_chart_gradient_color(type: 'v' | 'h', start_color: s
         color: string;
     }[];
 };
+/**
+ * Echarts图表配置项类型
+ */
+export type EChartsOption = any;
+/**
+ * 初始化Echarts图表
+ * @param container 容器元素或容器ID
+ * @param options 图表配置项
+ * @param renderer 渲染方式，可选 'canvas' 或 'svg'
+ * @returns Echarts实例
+ */
+export declare function init_chart(container: HTMLElement | string, options?: EChartsOption, renderer?: 'canvas' | 'svg'): Promise<any>;
+/**
+ * 销毁Echarts图表
+ * @param chart Echarts实例
+ */
+export declare function destroy_chart(chart: any): void;
+/**
+ * 更新Echarts图表配置
+ * @param chart Echarts实例
+ * @param options 图表配置项
+ */
+export declare function update_chart(chart: any, options: EChartsOption): void;
+/**
+ * 调整Echarts图表大小
+ * @param chart Echarts实例
+ */
+export declare function resize_chart(chart: any): void;
+/**
+ * 为Echarts图表添加响应式处理
+ * @param chart Echarts实例
+ * @param debounce_time 防抖时间，默认200ms
+ */
+export declare function make_chart_responsive(chart: any, debounce_time?: number): (() => void) | undefined;
+/**
+ * 生成Echarts颜色数组
+ * @param count 颜色数量
+ * @param base_colors 基础颜色数组，默认使用ECharts默认颜色
+ * @returns 颜色数组
+ */
+export declare function generate_chart_colors(count: number, base_colors?: string[]): string[];
+/**
+ * 格式化Echarts数据标签
+ * @param value 数值
+ * @param formatter 格式化函数或格式化模板
+ * @returns 格式化后的值
+ */
+export declare function format_chart_label(value: any, formatter?: ((value: any) => string) | string): string;
+/**
+ * 合并Echarts配置项
+ * @param defaultOption 默认配置项
+ * @param customOption 自定义配置项
+ * @returns 合并后的配置项
+ */
+export declare function merge_chart_options(defaultOption: EChartsOption, customOption: EChartsOption): EChartsOption;
+/**
+ * 为Echarts图表添加事件监听器
+ * @param chart Echarts实例
+ * @param eventName 事件名称
+ * @param handler 事件处理函数
+ */
+export declare function add_chart_listener(chart: any, eventName: string, handler: (...args: any[]) => void): void;
+/**
+ * 移除Echarts图表事件监听器
+ * @param chart Echarts实例
+ * @param eventName 事件名称
+ * @param handler 事件处理函数
+ */
+export declare function remove_chart_listener(chart: any, eventName: string, handler: (...args: any[]) => void): void;
+/**
+ * 导出Echarts图表为图片
+ * @param chart Echarts实例
+ * @param options 导出选项
+ * @returns 图片URL
+ */
+export declare function export_chart_image(chart: any, options?: {
+    type?: string;
+    pixel_ratio?: number;
+    background_color?: string;
+    exclude_components?: string[];
+    file_name?: string;
+}): any;
+/**
+ * 检查Echarts是否已加载
+ * @returns 是否已加载
+ */
+export declare function is_echarts_loaded(): boolean;
+/**
+ * 批量调整Echarts图表大小
+ * @param charts 图表实例数组
+ */
+export declare function resize_charts(charts: any[]): void;
+/**
+ * 批量销毁Echarts图表
+ * @param charts 图表实例数组
+ */
+export declare function destroy_charts(charts: any[]): void;
+/**
+ * 数据排序函数
+ * @param data 原始数据数组
+ * @param sort_key 排序字段名
+ * @param order 排序顺序，默认'asc'
+ * @returns 排序后的数据数组
+ */
+export declare function sort_chart_data(data: any[], sort_key: string, order?: 'asc' | 'desc'): any[];
+/**
+ * 数据分组函数
+ * @param data 原始数据数组
+ * @param group_key 分组字段名
+ * @returns 分组后的数据对象
+ */
+export declare function group_chart_data(data: any[], group_key: string): Record<string, any[]>;
+/**
+ * 数据聚合函数
+ * @param data 原始数据数组
+ * @param group_key 分组字段名
+ * @param value_key 数值字段名
+ * @param aggregator 聚合函数，默认求和
+ * @returns 聚合后的数据数组
+ */
+export declare function aggregate_chart_data(data: any[], group_key: string, value_key: string, aggregator?: (values: number[]) => number): {
+    [group_key]: string;
+    [value_key]: number;
+}[];

package/lib/utils/echarts.js

@@ -1,31 +1,228 @@
-function r(t, o = 1920) {
-  let e = window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth;
-  if (!e) return t;
-  let n = e / o;
-  return Number((t * n).toFixed(3));
+function auto_size(size, deflate_width = 1920) {
+  let client_width = window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth;
+  if (!client_width) return size;
+  let scale = client_width / deflate_width;
+  return Number((size * scale).toFixed(3));
 }
-function i(t, o, e) {
+function get_chart_gradient_color(type, start_color, end_color) {
   return {
     type: "linear",
     x: 0,
     y: 0,
-    x2: t === "v" ? 0 : 1,
-    y2: t === "v" ? 1 : 0,
+    x2: type === "v" ? 0 : 1,
+    y2: type === "v" ? 1 : 0,
     colorStops: [
       {
         offset: 0,
-        color: o
+        color: start_color
         // 0% 处的颜色
       },
       {
         offset: 1,
-        color: e
+        color: end_color
         // 100% 处的颜色
       }
     ]
   };
 }
+function init_chart(container, options, renderer = "canvas") {
+  const load_echarts = async () => {
+    try {
+      let echarts;
+      if (typeof window !== "undefined" && window.echarts) {
+        echarts = window.echarts;
+      } else {
+        const imported = await import("echarts");
+        echarts = imported.default || imported;
+      }
+      const chart_dom = typeof container === "string" ? document.getElementById(container) : container;
+      if (!chart_dom) {
+        console.error("ECharts DOM容器未找到");
+        return null;
+      }
+      const chart = echarts.init(chart_dom, void 0, {
+        renderer
+      });
+      if (options) {
+        chart.setOption(options);
+      }
+      return chart;
+    } catch (error) {
+      console.error("加载 ECharts 失败:", error);
+      return null;
+    }
+  };
+  return load_echarts();
+}
+function destroy_chart(chart) {
+  if (chart && typeof chart.dispose === "function") {
+    chart.dispose();
+  }
+}
+function update_chart(chart, options) {
+  if (chart && typeof chart.setOption === "function") {
+    chart.setOption(options);
+  }
+}
+function resize_chart(chart) {
+  if (chart && typeof chart.resize === "function") {
+    chart.resize();
+  }
+}
+function make_chart_responsive(chart, debounce_time = 200) {
+  if (!chart) return;
+  let resize_timer;
+  const resize_handler = () => {
+    clearTimeout(resize_timer);
+    resize_timer = setTimeout(() => {
+      resize_chart(chart);
+    }, debounce_time);
+  };
+  window.addEventListener("resize", resize_handler);
+  return () => {
+    window.removeEventListener("resize", resize_handler);
+    clearTimeout(resize_timer);
+  };
+}
+function generate_chart_colors(count, base_colors) {
+  const default_colors = [
+    "#5470c6",
+    "#91cc75",
+    "#fac858",
+    "#ee6666",
+    "#73c0de",
+    "#3ba272",
+    "#fc8452",
+    "#9a60b4",
+    "#ea7ccc",
+    "#67c23a"
+  ];
+  const colors = base_colors || default_colors;
+  const result = [];
+  for (let i = 0; i < count; i++) {
+    result.push(colors[i % colors.length]);
+  }
+  return result;
+}
+function format_chart_label(value, formatter) {
+  if (typeof formatter === "function") {
+    return formatter(value);
+  }
+  if (typeof formatter === "string") {
+    return formatter.replace("{value}", String(value));
+  }
+  return String(value);
+}
+function merge_chart_options(defaultOption, customOption) {
+  return {
+    ...defaultOption,
+    ...customOption,
+    // 特殊处理数组类型的配置
+    series: customOption.series || defaultOption.series,
+    xAxis: customOption.xAxis || defaultOption.xAxis,
+    yAxis: customOption.yAxis || defaultOption.yAxis,
+    legend: customOption.legend || defaultOption.legend,
+    tooltip: customOption.tooltip || defaultOption.tooltip,
+    title: customOption.title || defaultOption.title
+  };
+}
+function add_chart_listener(chart, eventName, handler) {
+  if (chart && typeof chart.on === "function") {
+    chart.on(eventName, handler);
+  }
+}
+function remove_chart_listener(chart, eventName, handler) {
+  if (chart && typeof chart.off === "function") {
+    chart.off(eventName, handler);
+  }
+}
+function export_chart_image(chart, options = {}) {
+  if (!chart || typeof chart.getDataURL !== "function") {
+    return null;
+  }
+  const {
+    type = "png",
+    pixel_ratio = 2,
+    background_color = "#fff",
+    exclude_components = [],
+    file_name = "echarts-image"
+  } = options;
+  const data_url = chart.getDataURL({
+    type,
+    pixelRatio: pixel_ratio,
+    backgroundColor: background_color,
+    excludeComponents: exclude_components
+  });
+  const link = document.createElement("a");
+  link.download = `${file_name}.${type}`;
+  link.href = data_url;
+  link.click();
+  return data_url;
+}
+function is_echarts_loaded() {
+  return typeof window !== "undefined" && typeof window.echarts !== "undefined";
+}
+function resize_charts(charts) {
+  charts.forEach((chart) => {
+    resize_chart(chart);
+  });
+}
+function destroy_charts(charts) {
+  charts.forEach((chart) => {
+    destroy_chart(chart);
+  });
+}
+function sort_chart_data(data, sort_key, order = "asc") {
+  return [...data].sort((a, b) => {
+    const a_value = a[sort_key];
+    const b_value = b[sort_key];
+    if (a_value < b_value) {
+      return order === "asc" ? -1 : 1;
+    }
+    if (a_value > b_value) {
+      return order === "asc" ? 1 : -1;
+    }
+    return 0;
+  });
+}
+function group_chart_data(data, group_key) {
+  return data.reduce((groups, item) => {
+    const key = item[group_key];
+    if (!groups[key]) {
+      groups[key] = [];
+    }
+    groups[key].push(item);
+    return groups;
+  }, {});
+}
+function aggregate_chart_data(data, group_key, value_key, aggregator = (values) => values.reduce((sum, val) => sum + val, 0)) {
+  const groups = group_chart_data(data, group_key);
+  return Object.entries(groups).map(([key, items]) => {
+    const values = items.map((item) => item[value_key]).filter((val) => typeof val === "number");
+    return {
+      [group_key]: key,
+      [value_key]: aggregator(values)
+    };
+  });
+}
 export {
-  r as auto_size,
-  i as get_chart_gradient_color
+  add_chart_listener,
+  aggregate_chart_data,
+  auto_size,
+  destroy_chart,
+  destroy_charts,
+  export_chart_image,
+  format_chart_label,
+  generate_chart_colors,
+  get_chart_gradient_color,
+  group_chart_data,
+  init_chart,
+  is_echarts_loaded,
+  make_chart_responsive,
+  merge_chart_options,
+  remove_chart_listener,
+  resize_chart,
+  resize_charts,
+  sort_chart_data,
+  update_chart
 };

package/lib/utils/file.d.ts

@@ -2,16 +2,92 @@
  * 下载文件
  * @param filePath 文件路径
  */
-export declare function downLoadFile({ path, name }: {
+export declare function download_file({ path, name }: {
     path: string;
     name?: string;
 }): void;
 /**批量下载文件 */
-export declare function downLoadFiles(fileList: any[]): void;
+export declare function download_files(file_list: any[]): void;
 /**
 * 将file转换成base64
 * @param file
 * @param callback
 * @returns
 */
-export declare function toBase64(file: Blob): Promise<string | undefined>;
+export declare function to_base64(file: Blob): Promise<string | undefined>;
+/**
+ * 读取文件内容
+ * @param file 文件对象
+ * @param encoding 编码方式，默认为 UTF-8
+ * @returns 文件内容
+ */
+export declare function read_file(file: Blob, encoding?: string): Promise<string | undefined>;
+/**
+ * 获取文件扩展名
+ * @param file_name 文件名
+ * @returns 文件扩展名
+ */
+export declare function get_file_extension(file_name: string): string;
+/**
+ * 获取不带扩展名的文件名
+ * @param file_name 文件名
+ * @returns 不带扩展名的文件名
+ */
+export declare function get_file_name_without_extension(file_name: string): string;
+/**
+ * 验证文件大小
+ * @param file 文件对象
+ * @param max_size 最大文件大小（字节）
+ * @returns 是否符合大小要求
+ */
+export declare function validate_file_size(file: File, max_size: number): boolean;
+/**
+ * 验证文件类型
+ * @param file 文件对象
+ * @param allowed_types 允许的文件类型数组
+ * @returns 是否符合类型要求
+ */
+export declare function validate_file_type(file: File, allowed_types: string[]): boolean;
+/**
+ * 从 Blob 创建文件
+ * @param blob Blob 对象
+ * @param file_name 文件名
+ * @param mime_type MIME 类型
+ * @returns 文件对象
+ */
+export declare function create_file_from_blob(blob: Blob, file_name: string, mime_type: string): File;
+/**
+ * 下载文本文件
+ * @param content 文件内容
+ * @param file_name 文件名
+ * @param mime_type MIME 类型，默认为 text/plain
+ */
+export declare function download_text_file(content: string, file_name: string, mime_type?: string): void;
+/**
+ * 压缩图片文件
+ * @param file 图片文件
+ * @param max_width 最大宽度
+ * @param max_height 最大高度
+ * @param quality 压缩质量，0-1之间
+ * @returns 压缩后的文件
+ */
+export declare function compress_image(file: File, max_width?: number, max_height?: number, quality?: number): Promise<File | undefined>;
+/**
+ * 获取文件信息
+ * @param file 文件对象
+ * @returns 文件信息对象
+ */
+export declare function get_file_info(file: File): {
+    name: string;
+    size: number;
+    size_text: string;
+    type: string;
+    extension: string;
+    name_without_extension: string;
+};
+/**
+ * 生成唯一的文件名
+ * @param original_name 原始文件名
+ * @returns 唯一的文件名
+ */
+export declare function generate_unique_file_name(original_name: string): string;

package/lib/utils/file.js

@@ -1,21 +1,144 @@
-function a({ path: n, name: e }) {
-  const r = document.createElement("a");
-  r.href = n, r.target = "_blank", e && r.setAttribute("download", e), document.body.appendChild(r), r.click(), document.body.removeChild(r);
+function download_file({ path, name }) {
+  const link = document.createElement("a");
+  link.href = path;
+  link.target = "_blank";
+  name && link.setAttribute("download", name);
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
 }
-function d(n) {
-  n.forEach((e) => {
-    a({ path: e.url, name: e.name });
+function download_files(file_list) {
+  file_list.forEach((file_item) => {
+    download_file({ path: file_item.url, name: file_item.name });
   });
 }
-async function c(n) {
-  if (!n) return;
-  const e = new FileReader();
-  return e.readAsDataURL(n), new Promise((r, t) => {
-    e.onload = (o) => r(o.target?.result), e.onerror = (o) => t(void 0);
+async function to_base64(file) {
+  if (!file) return void 0;
+  const reader = new FileReader();
+  reader.readAsDataURL(file);
+  return new Promise((resolve, reject) => {
+    reader.onload = (event) => {
+      return resolve(event.target?.result);
+    };
+    reader.onerror = (error) => {
+      return reject(void 0);
+    };
   });
 }
+async function read_file(file, encoding = "UTF-8") {
+  if (!file) return void 0;
+  const reader = new FileReader();
+  reader.readAsText(file, encoding);
+  return new Promise((resolve, reject) => {
+    reader.onload = (event) => {
+      return resolve(event.target?.result);
+    };
+    reader.onerror = () => {
+      return reject(void 0);
+    };
+  });
+}
+function get_file_extension(file_name) {
+  if (!file_name) return "";
+  const last_dot_index = file_name.lastIndexOf(".");
+  if (last_dot_index === -1) return "";
+  return file_name.substring(last_dot_index + 1).toLowerCase();
+}
+function get_file_name_without_extension(file_name) {
+  if (!file_name) return "";
+  const last_dot_index = file_name.lastIndexOf(".");
+  if (last_dot_index === -1) return file_name;
+  return file_name.substring(0, last_dot_index);
+}
+function validate_file_size(file, max_size) {
+  return file.size <= max_size;
+}
+function validate_file_type(file, allowed_types) {
+  const file_extension = get_file_extension(file.name);
+  return allowed_types.includes(file_extension);
+}
+function create_file_from_blob(blob, file_name, mime_type) {
+  return new File([blob], file_name, { type: mime_type });
+}
+function download_text_file(content, file_name, mime_type = "text/plain") {
+  const blob = new Blob([content], { type: mime_type });
+  const url = URL.createObjectURL(blob);
+  download_file({ path: url, name: file_name });
+  URL.revokeObjectURL(url);
+}
+async function compress_image(file, max_width = 800, max_height = 800, quality = 0.8) {
+  if (!file.type.startsWith("image/")) return void 0;
+  return new Promise((resolve) => {
+    const canvas = document.createElement("canvas");
+    const ctx = canvas.getContext("2d");
+    const img = new Image();
+    img.onload = () => {
+      let { width, height } = img;
+      if (width > max_width || height > max_height) {
+        const ratio = Math.min(max_width / width, max_height / height);
+        width *= ratio;
+        height *= ratio;
+      }
+      canvas.width = width;
+      canvas.height = height;
+      ctx?.drawImage(img, 0, 0, width, height);
+      canvas.toBlob((blob) => {
+        if (blob) {
+          const compressed_file = new File([blob], file.name, { type: file.type });
+          resolve(compressed_file);
+        } else {
+          resolve(void 0);
+        }
+      }, file.type, quality);
+    };
+    img.src = URL.createObjectURL(file);
+  });
+}
+function get_file_info(file) {
+  const extension = get_file_extension(file.name);
+  const name_without_extension = get_file_name_without_extension(file.name);
+  let size_text = "";
+  if (file.size < 1024) {
+    size_text = `${file.size} B`;
+  } else if (file.size < 1024 * 1024) {
+    size_text = `${(file.size / 1024).toFixed(2)} KB`;
+  } else if (file.size < 1024 * 1024 * 1024) {
+    size_text = `${(file.size / (1024 * 1024)).toFixed(2)} MB`;
+  } else {
+    size_text = `${(file.size / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+  }
+  return {
+    name: file.name,
+    size: file.size,
+    size_text,
+    type: file.type,
+    extension,
+    name_without_extension
+  };
+}
+function generate_unique_file_name(original_name) {
+  const extension = get_file_extension(original_name);
+  const name_without_extension = get_file_name_without_extension(original_name);
+  const timestamp = Date.now();
+  const random_string = Math.random().toString(36).substring(2, 8);
+  if (extension) {
+    return `${name_without_extension}_${timestamp}_${random_string}.${extension}`;
+  } else {
+    return `${name_without_extension}_${timestamp}_${random_string}`;
+  }
+}
 export {
-  a as downLoadFile,
-  d as downLoadFiles,
-  c as toBase64
+  compress_image,
+  create_file_from_blob,
+  download_file,
+  download_files,
+  download_text_file,
+  generate_unique_file_name,
+  get_file_extension,
+  get_file_info,
+  get_file_name_without_extension,
+  read_file,
+  to_base64,
+  validate_file_size,
+  validate_file_type
 };

package/lib/utils/index.d.ts

@@ -7,5 +7,6 @@ export * from './object';
 export * from './dom';
 export * from './file';
 export * from './color';
+export * from './date';
 export * from './share';
 export * from './echarts';