util-helpers 5.1.2 → 5.2.0

package/esm/VERSION.js

@@ -1,4 +1,4 @@
-var VERSION = "5.1.2";
+var VERSION = "5.2.0";
 var VERSION$1 = VERSION;
 
 export { VERSION$1 as default };

package/esm/getFileType.js

@@ -4,8 +4,8 @@ import { isUploadFile } from './utils/file.util.js';
 
 var config = {
     image: 'image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp',
-    audio: 'audio/*,.mp3,.wav',
-    video: 'video/*,.mp4,.webm,.ogg,.ogv,.ogm',
+    audio: 'audio/*,.mp3,.wav,.aac,.flac',
+    video: 'video/*,.mp4,.webm,.ogg',
     pdf: 'application/pdf,.pdf',
     word: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document,.doc,.docx',
     excel: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel,.xls,.xlsx'

package/esm/getMimeType.js

@@ -0,0 +1,43 @@
+import { isString, nth } from 'ut2';
+import { nativeUndefined } from './utils/native.js';
+
+var mimeTypes = [
+    ['text/plain', ['txt']],
+    ['text/css', ['css']],
+    ['text/html', ['htm', 'html']],
+    ['text/javascript', ['js', 'mjs']],
+    ['text/csv', ['csv']],
+    ['text/markdown', ['md', 'markdown']],
+    ['image/gif', ['gif']],
+    ['image/jpeg', ['jpg', 'jpeg', 'jfif', 'pjpeg', 'pjp']],
+    ['image/png', ['png']],
+    ['image/svg+xml', ['svg']],
+    ['image/webp', ['webp']],
+    ['image/apng', ['apng']],
+    ['image/avif', ['avif']],
+    ['image/bmp', ['bmp']],
+    ['image/x-icon', ['ico', 'cur']],
+    ['image/tiff', ['tif', 'tiff']],
+    ['application/xml', ['xml']],
+    ['application/zip', ['zip']],
+    ['application/pdf', ['pdf']],
+    ['application/json', ['json']],
+    ['application/yaml', ['yaml', 'yml']],
+    ['application/vnd.openxmlformats-officedocument.wordprocessingml.document', ['doc', 'docx']],
+    ['application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', ['xls', 'xlsx']],
+    ['audio/mp3', ['mp3']],
+    ['audio/wav', ['wav']],
+    ['audio/aac', ['aac']],
+    ['audio/flac', ['flac']],
+    ['video/mp4', ['mp4']],
+    ['video/ogg', ['ogg']],
+    ['video/webm', ['webm']],
+    ['video/quicktime', ['mov']]
+];
+function getMimeType(fileName) {
+    var _a;
+    var ext = isString(fileName) ? nth(fileName.split('.'), -1) : '';
+    return ext ? (_a = mimeTypes.find(function (item) { return item[1].includes(ext); })) === null || _a === void 0 ? void 0 : _a[0] : nativeUndefined;
+}
+
+export { getMimeType as default };

package/esm/index.js

@@ -48,6 +48,7 @@ export { default as download } from './download.js';
 export { default as getFileBlob } from './getFileBlob.js';
 export { default as getFileType } from './getFileType.js';
 export { default as getImageInfo } from './getImageInfo.js';
+export { default as getMimeType } from './getMimeType.js';
 export { default as loadImage } from './loadImage.js';
 export { default as loadImageWithBlob } from './loadImageWithBlob.js';
 export { default as loadScript } from './loadScript.js';

package/lib/VERSION.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var VERSION = "5.1.2";
+var VERSION = "5.2.0";
 var VERSION$1 = VERSION;
 
 module.exports = VERSION$1;

package/lib/getFileType.js

@@ -6,8 +6,8 @@ var file_util = require('./utils/file.util.js');
 
 var config = {
     image: 'image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp',
-    audio: 'audio/*,.mp3,.wav',
-    video: 'video/*,.mp4,.webm,.ogg,.ogv,.ogm',
+    audio: 'audio/*,.mp3,.wav,.aac,.flac',
+    video: 'video/*,.mp4,.webm,.ogg',
     pdf: 'application/pdf,.pdf',
     word: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document,.doc,.docx',
     excel: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel,.xls,.xlsx'

package/lib/getMimeType.js

@@ -0,0 +1,45 @@
+'use strict';
+
+var ut2 = require('ut2');
+var native = require('./utils/native.js');
+
+var mimeTypes = [
+    ['text/plain', ['txt']],
+    ['text/css', ['css']],
+    ['text/html', ['htm', 'html']],
+    ['text/javascript', ['js', 'mjs']],
+    ['text/csv', ['csv']],
+    ['text/markdown', ['md', 'markdown']],
+    ['image/gif', ['gif']],
+    ['image/jpeg', ['jpg', 'jpeg', 'jfif', 'pjpeg', 'pjp']],
+    ['image/png', ['png']],
+    ['image/svg+xml', ['svg']],
+    ['image/webp', ['webp']],
+    ['image/apng', ['apng']],
+    ['image/avif', ['avif']],
+    ['image/bmp', ['bmp']],
+    ['image/x-icon', ['ico', 'cur']],
+    ['image/tiff', ['tif', 'tiff']],
+    ['application/xml', ['xml']],
+    ['application/zip', ['zip']],
+    ['application/pdf', ['pdf']],
+    ['application/json', ['json']],
+    ['application/yaml', ['yaml', 'yml']],
+    ['application/vnd.openxmlformats-officedocument.wordprocessingml.document', ['doc', 'docx']],
+    ['application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', ['xls', 'xlsx']],
+    ['audio/mp3', ['mp3']],
+    ['audio/wav', ['wav']],
+    ['audio/aac', ['aac']],
+    ['audio/flac', ['flac']],
+    ['video/mp4', ['mp4']],
+    ['video/ogg', ['ogg']],
+    ['video/webm', ['webm']],
+    ['video/quicktime', ['mov']]
+];
+function getMimeType(fileName) {
+    var _a;
+    var ext = ut2.isString(fileName) ? ut2.nth(fileName.split('.'), -1) : '';
+    return ext ? (_a = mimeTypes.find(function (item) { return item[1].includes(ext); })) === null || _a === void 0 ? void 0 : _a[0] : native.nativeUndefined;
+}
+
+module.exports = getMimeType;

package/lib/index.js

@@ -50,6 +50,7 @@ var download = require('./download.js');
 var getFileBlob = require('./getFileBlob.js');
 var getFileType = require('./getFileType.js');
 var getImageInfo = require('./getImageInfo.js');
+var getMimeType = require('./getMimeType.js');
 var loadImage = require('./loadImage.js');
 var loadImageWithBlob = require('./loadImageWithBlob.js');
 var loadScript = require('./loadScript.js');
@@ -118,6 +119,7 @@ exports.download = download;
 exports.getFileBlob = getFileBlob;
 exports.getFileType = getFileType;
 exports.getImageInfo = getImageInfo;
+exports.getMimeType = getMimeType;
 exports.loadImage = loadImage;
 exports.loadImageWithBlob = loadImageWithBlob;
 exports.loadScript = loadScript;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "5.1.2",
+  "version": "5.2.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -51,36 +51,36 @@
   },
   "homepage": "https://doly-dev.github.io/util-helpers/index.html",
   "devDependencies": {
-    "@babel/core": "^7.24.7",
-    "@babel/preset-env": "^7.24.7",
-    "@babel/preset-typescript": "^7.24.7",
+    "@babel/core": "^7.25.8",
+    "@babel/preset-env": "^7.25.8",
+    "@babel/preset-typescript": "^7.25.7",
     "@commitlint/cli": "^17.8.1",
     "@commitlint/config-conventional": "^17.8.1",
     "@commitlint/cz-commitlint": "^17.8.1",
     "@rollup/plugin-commonjs": "^25.0.8",
-    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-replace": "^5.0.7",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.1.6",
-    "@types/jest": "^29.5.12",
-    "@typescript-eslint/eslint-plugin": "^7.16.0",
-    "@typescript-eslint/parser": "^7.16.0",
+    "@types/jest": "^29.5.13",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
     "babel-jest": "^29.7.0",
     "babel-plugin-minify-replace": "^0.5.0",
-    "commitizen": "^4.3.0",
+    "commitizen": "^4.3.1",
     "cross-env": "^7.0.3",
     "docdash": "^2.0.2",
-    "eslint": "^8.57.0",
-    "husky": "^9.0.11",
+    "eslint": "^8.57.1",
+    "husky": "^9.1.6",
     "inquirer": "^8.2.6",
     "jest": "^29.7.0",
     "jest-canvas-mock": "^2.5.2",
     "jest-environment-jsdom": "^29.7.0",
-    "jsdoc": "^4.0.3",
+    "jsdoc": "^4.0.4",
     "lint-staged": "^13.3.0",
-    "prettier": "^3.3.2",
-    "rollup": "^4.18.1",
-    "typescript": "^5.5.3"
+    "prettier": "^3.3.3",
+    "rollup": "^4.24.0",
+    "typescript": "^5.6.3"
   },
   "lint-staged": {
     "**/*.ts": "eslint",
@@ -92,9 +92,9 @@
     }
   },
   "dependencies": {
-    "cache2": "^3.0.0",
-    "tslib": "^2.6.3",
-    "ut2": "^1.11.0"
+    "cache2": "^3.1.1",
+    "tslib": "^2.8.0",
+    "ut2": "^1.13.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"

package/types/AsyncMemo.d.ts

@@ -8,7 +8,7 @@ import { Cache, CacheOptions } from 'cache2';
  * 3. 每个实例都有独立的缓存空间。相互之间隔离，缓存灵活配置，更多配置请查阅 [`cache2`](https://www.npmjs.com/package/cache2)。
  *
  * @class
- * @see {@link https://www.npmjs.com/package/cache2 cache2}
+ * @see {@link https://www.npmjs.com/package/cache2 | cache2}
  * @param {Object} [options] 缓存配置项，更多配置项可参考 [`cache2`](https://www.npmjs.com/package/cache2)
  * @param {number} [options.max] 最大缓存数量
  * @param {'replaced' | 'limited'} [options.maxStrategy] 缓存策略
@@ -36,7 +36,7 @@ declare class AsyncMemo<DataType = any> {
      * @param {string} [key] 缓存键，如果没有该值将直接执行异步方法。
      * @param {Object} [options] 配置项
      * @param {number} [options.ttl] 数据存活时间
-     * @param {boolean} [options.persisted=true] 数据持久化，如果存在缓存数据，直接返回缓存数据，不再执行异步方法。<br/>即使不开启该配置，不影响在异步执行成功后缓存数据。
+     * @param {boolean} [options.persisted=true] 数据持久化，默认`true`。如果存在缓存数据，直接返回缓存数据，不再执行异步方法。<br/>即使不开启该配置，不影响在异步执行成功后缓存数据。
      * @returns {Promise<*>} 异步结果
      */
     run(asyncFn: (...args: any[]) => Promise<DataType>, key?: string, options?: {

package/types/BlobUrl.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Blob 对象 URL 记录。
+ *
+ * 便于管理项目中上传文件通过 `URL.createObjectURL` 生成的对象URL。
+ *
+ * 特点：
+ * 1. 避免重复创建，相同的 `Blob` 对象只会生成一个 URL 字符串
+ * 2. 当清除缓存时，自动释放内存
+ *
+ * @class
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/URL/createObjectURL_static | URL：createObjectURL()}
+ * @example
+ * const blobUrl = new BlobUrl();
+ *
+ */
+declare class BlobUrl {
+    protected cache: Map<Blob, string>;
+    constructor();
+    /**
+     * 同 `URL.createObjectURL` 方法，创建一个对象 URL 字符串。
+     *
+     * 生成时内部会记录一个缓存，相同的 `Blob` 对象最多只会产生一个 URL 字符串。
+     *
+     * @param {Blob} obj 用于创建 URL 的 File、Blob 对象。
+     * @returns 一个包含对象 URL 的字符串，可用于引用指定源 object 的内容。
+     */
+    createObjectURL(obj: Blob): string | undefined;
+    /**
+     * 同 `URL.revokeObjectURL` 方法，释放对象 URL 。
+     *
+     * @param {string} url 通过调用 `createObjectURL()` 方法创建的对象 URL 的字符串。
+     */
+    revokeObjectURL(url: string): void;
+    /**
+     * 清理缓存。
+     *
+     * 迭代调用 `URL.revokeObjectURL` 来释放内存。
+     */
+    clear(): void;
+}
+export default BlobUrl;

package/types/ajax.d.ts

@@ -19,7 +19,7 @@ type AjaxOptions = {
     onLoadEnd?: XMLHttpRequestListener;
 };
 /**
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest XMLHttpRequest}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest | XMLHttpRequest}
  * @typedef {Object} AjaxOptions ajax 配置项
  * @property {string} [method="get"] 创建请求时使用的方法
  * @property {boolean} [async=true] 是否异步执行操作
@@ -47,7 +47,7 @@ type AjaxOptions = {
  * @static
  * @alias module:Other.ajax
  * @since 4.16.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest XMLHttpRequest}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest | XMLHttpRequest}
  * @param {string} url 地址
  * @param {AjaxOptions} [options] 配置项
  * @returns {Promise<object>} XHR 事件对象

package/types/bytesToSize.d.ts

@@ -10,8 +10,8 @@ type BytesToSizeOptions = {
  * @since 3.8.0
  * @param {number} bytes 字节大小
  * @param {Object} [options] 配置项
- * @param {string} [options.spaceMark=' '] 间隔字符
- * @param {number} [options.precision=2] 精度
+ * @param {string} [options.spaceMark=' '] 间隔字符，默认`' '`
+ * @param {number} [options.precision=2] 精度，默认`2`
  * @returns {string} 存储单位值
  * @example
  *

package/types/calculateCursorPosition.d.ts

@@ -9,15 +9,15 @@ type CalculateCursorPositionOptions = {
  * @static
  * @alias module:Other.calculateCursorPosition
  * @since 4.6.0
- * @see {@link https://2950v9.csb.app/ h5示例}
- * @see {@link https://33ccy9.csb.app/ react示例}
+ * @see {@link https://2950v9.csb.app/ | h5示例}
+ * @see {@link https://33ccy9.csb.app/ | react示例}
  * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
  * @param {string} prevCtrlValue 上一个格式化后的值
  * @param {string} rawValue 当前输入原值
  * @param {string} ctrlValue 当前格式化后的值
  * @param {Object} [options] 配置项
- * @param {string|string[]} [options.placeholderChar=' '] 占位符
- * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字，意味着 ctrlValue 需要去掉非数字。
+ * @param {string|string[]} [options.placeholderChar=' '] 占位符，默认`' '`
+ * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认`/\D/g` 去掉非数字，意味着 ctrlValue 需要去掉非数字。
  * @param {'mobile'|'bankCard'} [options.type] 格式化类型，内置手机号码和银行卡号特殊处理
  * @returns {number} 格式化后的光标位置
  */

package/types/checkFileType.d.ts

@@ -5,8 +5,8 @@ import { UploadFile } from './utils/file.util';
  * @static
  * @alias module:Other.checkFileType
  * @since 5.1.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input/file#唯一文件类型说明符 唯一文件类型说明符}
- * @see {@link https://www.iana.org/assignments/media-types/media-types.xhtml Media Types}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input/file#唯一文件类型说明符 | 唯一文件类型说明符}
+ * @see {@link https://www.iana.org/assignments/media-types/media-types.xhtml | Media Types}
  * @param {File} file 文件对象。支持 antd `UploadFile` 对象。
  * @param {string} [accept] 文件类型说明符。
  * @returns {boolean} 如果 `file` 符合 `accept` 返回 `true`， 否则返回 `false`。

package/types/compressImage.d.ts

@@ -37,19 +37,19 @@ interface CompressImage {
  * @function
  * @alias module:Other.compressImage
  * @since 4.20.0
- * @see {@link https://sytpwg.csb.app/ 在线示例}
+ * @see {@link https://sytpwg.csb.app/ | 在线示例}
  * @param {string | Blob} img 图片地址或 blob 对象
  * @param {Object} [options] 配置项
  * @param {number} [options.width] 自定义图片宽度，默认图片自身宽度
  * @param {number} [options.height] 自定义图片高度，默认图片自身高度
  * @param {number} [options.rotate] 旋转
- * @param {Array | function} [options.offset=[0, 0]] x,y轴偏移值
- * @param {string} [options.background=#fff] 背景颜色
+ * @param {Array | function} [options.offset=[0, 0]] x,y轴偏移值，默认`[0, 0]`
+ * @param {string} [options.background=#fff] 背景颜色，默认`#fff`
  * @param {number | function} [options.canvasWidth] 画布宽度，默认图片宽度
  * @param {number | function} [options.canvasHeight] 画布高度，默认图片高度
- * @param {'blob' | 'dataURL'} [options.format='blob'] 导出格式
- * @param {string} [options.type='image/jpeg'] 图片类型
- * @param {number} [options.quality=0.8] 图片质量
+ * @param {'blob' | 'dataURL'} [options.format='blob'] 导出格式，默认`blob`
+ * @param {string} [options.type='image/jpeg'] 图片类型，默认`image/jpeg`
+ * @param {number} [options.quality=0.8] 图片质量，默认`0.8`
  * @param {function} [options.beforeCompress] 图片加载完成，画布创建之前调用
  * @param {function} [options.beforeDraw] 图片载入画布之前调用
  * @param {function} [options.afterDraw] 图片载入画布之后调用
@@ -60,6 +60,7 @@ interface CompressImage {
  * // 默认返回压缩后的 blob 对象
  * compressImage(file).then(blob=>{
  *    // do something
+ *    // 转为文件对象 new File([blob], file.name, { type: file.type })
  * });
  *
  * // 设置返回格式 data url

package/types/dataURLToBlob.d.ts

@@ -4,7 +4,7 @@
  * @static
  * @alias module:Processor.dataURLToBlob
  * @since 4.1.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64 Base64}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64 | Base64}
  * @param {string} data data: 协议的URL
  * @returns {Blob} Blob 对象
  * @example

package/types/download.d.ts

@@ -35,12 +35,14 @@ type DownloadOptions = {
  *
  * <em style="font-weight: bold;">注意：微信浏览器不支持H5下载文件。</em>
  *
+ * <em>响应头中有 "Content-Disposition" 字段，客户端获取不到？</em> 请参考查阅 [Access-Control-Expose-Headers](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers) 。
+ *
  * @static
  * @alias module:Other.download
  * @since 4.16.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers Access-Control-Expose-Headers}
- * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展 MIME}
- * @see {@link https://9ykc9s.csb.app/ 在线示例}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers | Access-Control-Expose-Headers}
+ * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展 | MIME}
+ * @see {@link https://9ykc9s.csb.app/ | 在线示例}
  * @param {string|Blob|ArrayBuffer|TypedArray} data 字符串、blob数据或url地址
  * @param {string|DownloadOptions} [options] 文件名称 或 配置项
  * @returns {Promise<void>}

package/types/fileReader.d.ts

@@ -16,10 +16,10 @@ interface FileReader {
  *
  * @function
  * @alias module:Processor.fileReader
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader FileReader}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader | FileReader}
  * @since 4.16.0
  * @param {Blob} blob Blob 或 File 对象
- * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] 读取类型
+ * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] 读取类型，默认`dataURL`。可选 `arrayBuffer`  `binaryString` `dataURL` `text` 。
  * @returns {Promise<string|ArrayBuffer>} 文件内容
  * @example
  * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组

package/types/filterTree.d.ts

@@ -9,8 +9,8 @@ type NodeAssign = 'spread' | 'self';
  * @since 4.15.0
  * @param {Object[]} tree 树结构数据
  * @param {function} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 `Truthy` ，结果将包含该节点
- * @param {string} [childrenField='children'] 子级字段名
- * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+ * @param {string} [childrenField='children'] 子级字段名，默认`children`
+ * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式，默认`spread`。`spread`表示使用展开运算符创建新值，`self`-表示使用自身对象。
  * @returns {Object[]}
  * @example
  * const menus = [{ id: '1', name: '首页', code: 'trade', pid: null }, { id: '2', name: '交易管理', code: 'trade', pid: null, children: [{ id: '3', name: '交易查询', code: 'trade-1', pid: '2', children: [{ id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' }]}]}, { id: '5', name: '权限管理', code: 'authorization', pid: null, children: [{ id: '6', name: '角色管理', code: 'authorization-1', pid: '5' }, { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }]}];

package/types/findTreeNode.d.ts

@@ -6,7 +6,7 @@
  * @since 4.14.0
  * @param {Object[]} tree 树结构数据
  * @param {function} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 `Truthy` ，将返回该节点
- * @param {string} [childrenField='children'] 子级字段名
+ * @param {string} [childrenField='children'] 子级字段名，默认`children`
  * @returns {Object|undefined}
  * @example
  * const menus = [{ id: '1', name: '首页', code: 'trade', pid: null }, { id: '2', name: '交易管理', code: 'trade', pid: null, children: [{ id: '3', name: '交易查询', code: 'trade-1', pid: '2', children: [{ id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' }]}]}, { id: '5', name: '权限管理', code: 'authorization', pid: null, children: [{ id: '6', name: '角色管理', code: 'authorization-1', pid: '5' }, { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }]}];

package/types/findTreeNodes.d.ts

@@ -6,7 +6,7 @@
  * @since 4.15.0
  * @param {Object[]} tree 树结构数据
  * @param {function} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，返回结果将包含该节点
- * @param {string} [childrenField='children'] 子级字段名
+ * @param {string} [childrenField='children'] 子级字段名，默认`children`
  * @returns {Object[]}
  * @example
  * const menus = [{ id: '1', name: '首页', code: 'trade', pid: null }, { id: '2', name: '交易管理', code: 'trade', pid: null, children: [{ id: '3', name: '交易查询', code: 'trade-1', pid: '2', children: [{ id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' }]}]}, { id: '5', name: '权限管理', code: 'authorization', pid: null, children: [{ id: '6', name: '角色管理', code: 'authorization-1', pid: '5' }, { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }]}];

package/types/findTreeSelect.d.ts

@@ -6,7 +6,7 @@
  * @since 4.14.0
  * @param {Object[]} tree 树结构数据
  * @param {function} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy 将返回包含该节点的所有父级节点
- * @param {string} [childrenField='children'] 子级字段名
+ * @param {string} [childrenField='children'] 子级字段名，默认`children`
  * @returns {Object[]}
  * @example
  * const menus = [{ id: '1', name: '首页', code: 'trade', pid: null }, { id: '2', name: '交易管理', code: 'trade', pid: null, children: [{ id: '3', name: '交易查询', code: 'trade-1', pid: '2', children: [{ id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' }]}]}, { id: '5', name: '权限管理', code: 'authorization', pid: null, children: [{ id: '6', name: '角色管理', code: 'authorization-1', pid: '5' }, { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }]}];

package/types/formatBankCard.d.ts

@@ -10,8 +10,8 @@ type Options = {
  * @since 1.1.0
  * @param {string} bankCardNo 要处理的字符串
  * @param {Object} [options] 配置项
- * @param {string} [options.spaceMark=' '] 间隔字符
- * @param {number} [options.length=4] 间隔长度
+ * @param {string} [options.spaceMark=' '] 间隔字符，默认`' '`
+ * @param {number} [options.length=4] 间隔长度，默认`4`
  * @returns {string} 格式化的银行卡号
  * @example
  *

package/types/formatMobile.d.ts

@@ -9,7 +9,7 @@ type Options = {
  * @since 4.5.0
  * @param {string} mobileNo 手机号码
  * @param {Object} [options] 配置项
- * @param {string} [options.spaceMark=' '] 间隔字符
+ * @param {string} [options.spaceMark=' '] 间隔字符，默认`' '`
  * @returns {string} 格式化后的手机号码
  * @example
  *

package/types/formatMoney.d.ts

@@ -13,11 +13,11 @@ type Options = {
  * @since 1.1.0
  * @param {string | number} num 需转换金额 (最大：9007199254740991 最小： -9007199254740991)
  * @param {Object} [options] 金额格式化配置
- * @param {number} [options.precision=2] 保留位数 （最高：10位）
+ * @param {number} [options.precision=2] 保留位数，默认`2`。最高`10`。
  * @param {string} [options.symbol] 货币符号
- * @param {string} [options.thousand=","] 千分位符号
- * @param {string} [options.decimal="."] 小数位符号
- * @param {boolean} [options.strict=ture] 严格模式。开启后，只支持非空字符串和数字格式化，其他类型值如`null` `undefined` `true` `false`等将返回空字符串。
+ * @param {string} [options.thousand=","] 千分位符号， 默认`,`
+ * @param {string} [options.decimal="."] 小数位符号，默认`.`
+ * @param {boolean} [options.strict=ture] 严格模式，默认`true`。开启后，只支持非空字符串和数字格式化，其他类型值如`null` `undefined` `true` `false`等将返回空字符串。
  * @returns {string} 格式化的金额
  * @example
  *

package/types/gcd.d.ts

@@ -12,7 +12,7 @@
  * @static
  * @alias module:Math.gcd
  * @since 4.20.0
- * @see {@link https://baike.baidu.com/item/最大公约数 最大公约数}
+ * @see {@link https://baike.baidu.com/item/最大公约数 | 最大公约数}
  * @param {...(number|string)} nums 两个或多个整数。
  * @returns {number} 最大公约数。
  * @example

package/types/getFileType.d.ts

@@ -1,6 +1,6 @@
 import { UploadFile } from './utils/file.util';
 /**
- * 获取文件类型
+ * 获取文件类型。
  *
  * @static
  * @alias module:Other.getFileType

package/types/getMimeType.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 获取常用的 MIME 类型。
+ *
+ * 通过文件名后缀查找对于的 MIME 类型。
+ *
+ * @alias module:Other.getMimeType
+ * @since 5.2.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/MIME_types | MIME 类型（IANA 媒体类型）}
+ * @see {@link https://www.iana.org/assignments/media-types/media-types.xhtml | Media Types}
+ * @param {string} fileName 文件名。
+ * @returns 如果找到，返回 MIME 类型字符串，否则返回 `undefined`。
+ * @example
+ * getMimeType('xxx.png'); // 'image/png'
+ * getMimeType('xxx.jpg'); // 'image/jpeg'
+ * getMimeType('xxx.mp3'); // 'audio/mp3'
+ * getMimeType('xxx.mp4'); // 'video/mp4'
+ * getMimeType('xxx.pdf'); // 'application/pdf'
+ * getMimeType('xxx.zip'); // 'application/zip'
+ * getMimeType('xxx.doc'); // 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+ *
+ * // 不常用或未知类型
+ * getMimeTye('xxx.ci'); // undefined
+ */
+declare function getMimeType(fileName: string): string | undefined;
+export default getMimeType;

package/types/index.d.ts

@@ -50,8 +50,8 @@ export { default as transformObjectValue } from './transformObjectValue';
  *
  * @module Math
  * @since 3.1.0
- * @see {@link https://github.com/camsong/blog/issues/9 JavaScript 浮点数陷阱及解法}
- * @see {@link https://2zbuy.csb.app/ JS浮点数计算测试}
+ * @see {@link https://github.com/camsong/blog/issues/9 | JavaScript 浮点数陷阱及解法}
+ * @see {@link https://2zbuy.csb.app/ | JS浮点数计算测试}
  * @example
  * // 从 4.12.0 版本开始，规范了有效数值。（注意：4.12.3 对有效数值重新定义）
  * // 有效数值即能通过 Number(value) 转为数字，且不能为 NaN 。
@@ -105,6 +105,7 @@ export { default as download } from './download';
 export { default as getFileBlob } from './getFileBlob';
 export { default as getFileType } from './getFileType';
 export { default as getImageInfo } from './getImageInfo';
+export { default as getMimeType } from './getMimeType';
 export { default as loadImage } from './loadImage';
 export { default as loadImageWithBlob } from './loadImageWithBlob';
 export { default as loadScript } from './loadScript';

package/types/isBankCard.d.ts

@@ -8,11 +8,11 @@ type Options = {
  * @static
  * @alias module:Validator.isBankCard
  * @since 1.1.0
- * @see {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html 常用银行账号位数参考}
+ * @see {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html | 常用银行账号位数参考}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
- * @param {boolean} [options.loose=false] 宽松模式，8-30位数字
- * @param {boolean} [options.luhn=false] 使用 Luhn 算法校验校验码
+ * @param {boolean} [options.loose=false] 宽松模式，默认`false`。正常模式10-21位数字（个人账户），宽松模式8-30位数字（企业账户）。
+ * @param {boolean} [options.luhn=false] 使用 Luhn 算法校验校验码，默认`false`
  * @returns {boolean} 值是否为银行卡号
  * @example
  *

package/types/isBusinessLicense.d.ts

@@ -7,10 +7,10 @@ type Options = {
  * @static
  * @alias module:Validator.isBusinessLicense
  * @since 3.5.0
- * @see {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html GS15—2006 工商行政管理市场主体注册号编制规则}
+ * @see {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html | GS15—2006 工商行政管理市场主体注册号编制规则}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
- * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。
+ * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，默认`true`。如果为false，不校验校验位。
  * @returns {boolean} 值是否为营业执照号
  * @example
  *