@giszhc/file-utils 0.0.5 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giszhc/file-utils",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "files": [
     "dist",
@@ -24,6 +24,7 @@
   ],
   "homepage": "https://github.com/giszhc/file-utils#readme",
   "dependencies": {
+    "changedpi": "^1.0.4",
     "jszip": "^3.10.1"
   },
   "devDependencies": {
@@ -33,7 +34,8 @@
   "scripts": {
     "dev": "vite",
     "build:types": "tsc -p tsconfig.build.json",
-    "build": "pnpm run build:types && vite build",
+    "build": "vite build && pnpm run build:types",
+    "build:example": "vite build --config vite.example.config.ts",
     "preview": "vite preview"
   }
 }

package/types/convert.d.ts

@@ -48,3 +48,63 @@ export declare function base64ToBlob(base64: string, mimeType?: string): Blob;
  * console.log(file.name); // "hello.txt"
  */
 export declare function blobToFile(blob: Blob, filename: string): File;
+/**
+ * 将 Base64 编码转换为 File 对象
+ *
+ * @param base64 - Base64 编码的字符串（可以包含或不包含 data URL 前缀）
+ * @param filename - 文件名（可选），默认为 'file'
+ * @param mimeType - MIME 类型（可选），如果未指定且 base64 不包含前缀，默认为 'application/octet-stream'
+ * @returns File - 转换后的 File 对象
+ *
+ * @example
+ * // 转换带前缀的 Base64
+ * const base64 = 'data:image/png;base64,iVBORw0KGgoAAAANS...';
+ * const file = base64ToFile(base64, 'image.png');
+ *
+ * @example
+ * // 转换不带前缀的 Base64
+ * const base64 = 'iVBORw0KGgoAAAANS...';
+ * const file = base64ToFile(base64, 'image.png', 'image/png');
+ */
+export declare function base64ToFile(base64: string, filename?: string, mimeType?: string): File;
+/**
+ * 将图片 URL 转换为 Base64 编码
+ * 使用 Canvas 将图片绘制后转换为 Base64
+ *
+ * @param imageUrl - 图片 URL 地址
+ * @param mimeType - 输出的 MIME 类型（可选），默认为 'image/png'
+ * @param quality - 图片质量（可选），范围 0.0 - 1.0，默认为 1.0
+ * @returns Promise<string> - Base64 编码的字符串（包含 data URL 前缀）
+ *
+ * @example
+ * // 转换远程图片
+ * const base64 = await imageUrlToBase64('https://example.com/image.jpg');
+ * console.log(base64); // data:image/png;base64,iVBORw0KGgoAAAANS...
+ *
+ * @example
+ * // 转换为 JPEG 格式，80% 质量
+ * const base64 = await imageUrlToBase64('https://example.com/image.png', 'image/jpeg', 0.8);
+ */
+export declare function imageUrlToBase64(imageUrl: string, mimeType?: string, quality?: number): Promise<string>;
+/**
+ * fileChangedImageDPI 函数用于修改图片的分辨率 DPI
+ *
+ * @param source - 原图片，支持 Base64 字符串或 Blob 对象
+ * @param dpi - 需要设置的分辨率值，默认为 96
+ * @returns Promise<string | Blob> - 返回修改后的 DPI 图片（Base64 字符串或 Blob）
+ *
+ * @example
+ * // 修改 Base64 图片的 DPI
+ * const base64 = 'data:image/png;base64,iVBORw0KGgoAAAANS...';
+ * const newBase64 = fileChangedImageDPI(base64, 300);
+ *
+ * @example
+ * // 修改 Blob 图片的 DPI
+ * const blob = new Blob([imageData], { type: 'image/png' });
+ * const newBlob = await fileChangedImageDPI(blob, 300);
+ *
+ * @example
+ * // 使用默认 DPI (96)
+ * const result = await fileChangedImageDPI(base64);
+ */
+export declare function fileChangedImageDPI(source: string | Blob, dpi?: number): Promise<string | Blob>;

package/types/helpers.d.ts

@@ -86,6 +86,22 @@ export declare function omitKeys<T extends Record<string, any>>(obj: T, keys: (k
  * generateUUID(true) // "550e8400e29b41d4a716446655440000" (无横杠)
  */
 export declare function generateUUID(removeHyphens?: boolean): string;
+/**
+ * 过滤对象中的空值
+ * 移除值为空字符串、null 或 undefined 的属性
+ *
+ * @param data - 需要过滤的对象
+ * @returns Record<string, any> - 过滤后的新对象
+ *
+ * @example
+ * const data = { a: 1, b: '', c: null, d: undefined, e: 'test' };
+ * const filtered = filterEmptyValue(data); // { a: 1, e: 'test' }
+ *
+ * @example
+ * const params = { name: 'John', age: null, email: '' };
+ * const validParams = filterEmptyValue(params); // { name: 'John' }
+ */
+export declare function filterEmptyValue(data: Record<string, any>): Record<string, any>;
 /**
  * 数组求和
  *
@@ -138,3 +154,118 @@ export declare function maskString(str: string, start?: number, end?: number, ma
  * formatPhone('13900139000', '#') // "139####9000"
  */
 export declare function formatPhone(phone: string, maskChar?: string): string;
+/**
+ * arrayStringFormatNumber 函数用于将字符串数组转换为数值数组
+ *
+ * @param arrayList - 字符串数组
+ * @returns number[] - 返回格式化后的数值数组
+ *
+ * @example
+ * // 将字符串数字数组转换为数值数组
+ * const result = arrayStringFormatNumber(["0", "1", "2", "3", "4"]);
+ * console.log(result); // [0, 1, 2, 3, 4]
+ *
+ * @description
+ * 此方法将传入的字符串数组格式化为数值数组，并返回新的数组
+ */
+export declare function arrayStringFormatNumber(arrayList: string[]): number[];
+/**
+ * arrayCustomSort 函数用于根据给定的 id 顺序对数据列表进行排序。
+ *
+ * @param ids - 包含 id 的数组，定义排序的顺序。
+ * @param dataList - 需要排序的数据列表。
+ * @param cbA - 一个回调函数，用于从数据列表的每个元素中提取 id，用于排序。
+ * @param cbB - 一个回调函数，用于从数据列表的每个元素中提取 id，用于排序。
+ * @returns void - 直接修改原数组，不返回值
+ *
+ * @example
+ * ```typescript
+ * const ids = ['id1', 'id2', 'id3'];
+ * const dataList = [
+ *   { id: 'id3', name: 'Layer 3' },
+ *   { id: 'id1', name: 'Layer 1' },
+ *   { id: 'id2', name: 'Layer 2' }
+ * ];
+ * arrayCustomSort(ids, dataList, item => item.id, item => item.id);
+ * // dataList 将被排序为 [
+ * //   { id: 'id1', name: 'Layer 1' },
+ * //   { id: 'id2', name: 'Layer 2' },
+ * //   { id: 'id3', name: 'Layer 3' }
+ * // ]
+ * ```
+ *
+ * @description
+ * cbA 和 cbB 允许对数据列表中的不同类型项进行单独的处理。
+ */
+export declare function arrayCustomSort(ids: string[], dataList: any[], cbA: (item: any) => any, cbB: (item: any) => any): void;
+/**
+ * jsonConvertTreeList 函数实现了把扁平的数据数组，按照父子节点的关系转换为树形结构。
+ *
+ * @param dataList - 输入的扁平数据数组，其中每个元素是一个对象，至少包含 id 和 pid 两个属性，表示自身的 ID 和其父节点的 ID。
+ * @returns any[] - 返回构建好的树形结构数组，其中每个节点包含 id，pid 和 children (如果有的话) 三个属性，children 属性是一个数组，里面包含其所有子节点。
+ *
+ * @example
+ * ```typescript
+ * const flatData = [
+ *   { id: 1, pid: null, name: '根节点' },
+ *   { id: 2, pid: 1, name: '子节点 1' },
+ *   { id: 3, pid: 1, name: '子节点 2' },
+ *   { id: 4, pid: 2, name: '孙节点 1' }
+ * ];
+ * const tree = jsonConvertTreeList(flatData);
+ * // 返回树形结构：[
+ * //   {
+ * //     id: 1,
+ * //     pid: null,
+ * //     name: '根节点',
+ * //     children: [
+ * //       {
+ * //         id: 2,
+ * //         pid: 1,
+ * //         name: '子节点 1',
+ * //         children: [{ id: 4, pid: 2, name: '孙节点 1' }]
+ * //       },
+ * //       { id: 3, pid: 1, name: '子节点 2', children: [] }
+ * //     ]
+ * //   }
+ * // ]
+ * ```
+ *
+ * @description
+ * 函数首先定义了一个递归的函数 buildChildren，用于构建指定节点的所有子节点。然后通过 filter 方法找出所有的根节点，对每个根节点调用 buildChildren 函数构建其子树。
+ * 最后返回包含所有子树的数组。
+ */
+export declare function jsonConvertTreeList(dataList: any[]): any[];
+/**
+ * jsonConvertGeneralList 函数是将嵌套的树形结构转换回扁平的数据数组。也可选择是否删除 children 属性。
+ *
+ * @param treeList - 输入的树形结构数组。
+ * @param delChildrenField - 可选，是否要删除每个节点的 children 字段，默认为 false，即默认不删除。
+ * @returns any[] - 返回扁平的数据数组。
+ *
+ * @example
+ * ```typescript
+ * const tree = [
+ *   {
+ *     id: 1,
+ *     pid: null,
+ *     name: '根节点',
+ *     children: [
+ *       { id: 2, pid: 1, name: '子节点 1', children: [] },
+ *       { id: 3, pid: 1, name: '子节点 2', children: [] }
+ *     ]
+ *   }
+ * ];
+ * const flat = jsonConvertGeneralList(tree);
+ * // 返回扁平数组：[
+ * //   { id: 1, pid: null, name: '根节点', children: [...] },
+ * //   { id: 2, pid: 1, name: '子节点 1', children: [] },
+ * //   { id: 3, pid: 1, name: '子节点 2', children: [] }
+ * // ]
+ * ```
+ *
+ * @description
+ * 函数首先定义了一个递归的函数 loop，用于处理每个节点和其子节点。然后对输入的树根节点调用 loop 函数。
+ * 如果设置了 delChildrenField 为 true，函数还会删除每个节点的 children 字段。
+ */
+export declare function jsonConvertGeneralList(treeList: any[], delChildrenField?: boolean): any[];

package/types/index.d.ts

@@ -5,63 +5,13 @@
  * 支持 Tree Shaking，按需引入
  */
 export type { ReadFileType, CompressOptions, DownloadOptions, CopyOptions, IFileInfo, IValidationResult, IFileValidationOptions } from './types';
-export { readFile, readTxtFile, readCsvFile, readJsonFile } from './read';
-export { downloadFile, downloadBlob, downloadBase64, downloadMultiple } from './download';
-export { fileToBase64, base64ToBlob, blobToFile } from './convert';
-export { fileListToZip, downloadFileListAsZip } from './compress';
-export { copyToClipboard, pasteFromClipboard } from './copy';
-export { generateTxtFile, generateCsvFile, generateJsonFile } from './generate';
-export { checkFileType, checkFileSize, isImage, getImageDimensions, validateFile, formatFileSize } from './validators';
-export { getFileExtension, getFileNameWithoutExtension, getFileInfo } from './utils';
-export { deepClone, numberFixed, parseUrlParams, objectToFormData, omitKeys, generateUUID, arraySum, formatAmount, maskString, formatPhone } from './helpers';
-export { VerifyUtils, type IVerifyResult, type IVerifyMessages } from './verify';
-import { readFile, readTxtFile, readCsvFile, readJsonFile } from './read';
-import { downloadFile, downloadBlob, downloadBase64, downloadMultiple } from './download';
-import { fileToBase64, base64ToBlob, blobToFile } from './convert';
-import { copyToClipboard, pasteFromClipboard } from './copy';
-import { generateTxtFile, generateCsvFile, generateJsonFile } from './generate';
-import { checkFileType, checkFileSize, isImage, getImageDimensions, validateFile, formatFileSize } from './validators';
-import { getFileExtension, getFileNameWithoutExtension, getFileInfo } from './utils';
-import { deepClone, parseUrlParams, objectToFormData, omitKeys, generateUUID, arraySum, formatAmount, maskString, formatPhone } from './helpers';
-import { VerifyUtils } from './verify';
-declare const _default: {
-    readFile: typeof readFile;
-    readTxtFile: typeof readTxtFile;
-    readCsvFile: typeof readCsvFile;
-    readJsonFile: typeof readJsonFile;
-    downloadFile: typeof downloadFile;
-    downloadBlob: typeof downloadBlob;
-    downloadBase64: typeof downloadBase64;
-    downloadMultiple: typeof downloadMultiple;
-    fileToBase64: typeof fileToBase64;
-    base64ToBlob: typeof base64ToBlob;
-    blobToFile: typeof blobToFile;
-    fileListToZip: (fileList: File[], filename: string) => Promise<File>;
-    downloadFileListAsZip: (fileList: File[], filename: string) => Promise<void>;
-    copyToClipboard: typeof copyToClipboard;
-    pasteFromClipboard: typeof pasteFromClipboard;
-    generateTxtFile: typeof generateTxtFile;
-    generateCsvFile: typeof generateCsvFile;
-    generateJsonFile: typeof generateJsonFile;
-    checkFileType: typeof checkFileType;
-    checkFileSize: typeof checkFileSize;
-    isImage: typeof isImage;
-    getImageDimensions: typeof getImageDimensions;
-    validateFile: typeof validateFile;
-    formatFileSize: typeof formatFileSize;
-    getFileExtension: typeof getFileExtension;
-    getFileNameWithoutExtension: typeof getFileNameWithoutExtension;
-    getFileInfo: typeof getFileInfo;
-    deepClone: typeof deepClone;
-    numberFixed: (number: number, fractionDigits?: number) => number;
-    parseUrlParams: typeof parseUrlParams;
-    objectToFormData: typeof objectToFormData;
-    omitKeys: typeof omitKeys;
-    generateUUID: typeof generateUUID;
-    arraySum: typeof arraySum;
-    formatAmount: typeof formatAmount;
-    maskString: typeof maskString;
-    formatPhone: typeof formatPhone;
-    VerifyUtils: typeof VerifyUtils;
-};
-export default _default;
+export * from './read';
+export * from './download';
+export * from './convert';
+export * from './compress';
+export * from './copy';
+export * from './generate';
+export * from './validators';
+export * from './utils';
+export * from './helpers';
+export * from './verify';

package/types/utils.d.ts

@@ -3,33 +3,33 @@
  */
 import type { IFileInfo } from './types';
 /**
- * 获取文件扩展名（后缀）
+ * 获取文件扩展名（后缀，不含点号）
  *
  * @param file - File 对象或文件名
- * @returns string - 文件扩展名（包含点号，如 '.jpg'）
+ * @returns string - 文件扩展名（不含点号，如 'jpg'）
  *
  * @example
  * const file = new File(['content'], 'test.txt', { type: 'text/plain' });
- * const ext = getFileExtension(file); // ".txt"
+ * const ext = getFileNameSuffix(file); // "txt"
  *
  * @example
- * const ext = getFileExtension('image.png'); // ".png"
+ * const ext = getFileNameSuffix('image.png'); // "png"
  */
-export declare function getFileExtension(file: File | string): string;
+export declare function getFileNameSuffix(file: File | string): string;
 /**
- * 获取文件名（不含扩展名）
+ * 获取文件名（前缀，不含扩展名）
  *
  * @param file - File 对象或文件名
  * @returns string - 不含扩展名的文件名
  *
  * @example
  * const file = new File(['content'], 'test.txt', { type: 'text/plain' });
- * const name = getFileNameWithoutExtension(file); // "test"
+ * const name = getFileNamePrefix(file); // "test"
  *
  * @example
- * const name = getFileNameWithoutExtension('archive.tar.gz'); // "archive.tar"
+ * const name = getFileNamePrefix('archive.tar.gz'); // "archive.tar"
  */
-export declare function getFileNameWithoutExtension(file: File | string): string;
+export declare function getFileNamePrefix(file: File | string): string;
 /**
  * 获取文件信息
  *