wjk-util 0.0.12 → 0.1.0

package/dist/wjk-util.es.js

@@ -1 +1 @@
-function e(e){return Object.prototype.toString.call(e).slice(8,-1).toLowerCase()}function t(e){return Array.isArray(e)}function n(t){return"object"===e(t)}function r(e){return"function"==typeof e}function o(e){return"string"==typeof e}function c(e){return"number"==typeof e&&!isNaN(e)}function i(e){return"boolean"==typeof e}function u(e){return null===e}function a(e){return void 0===e}function s(e){return!(!u(e)&&!a(e))||(o(e)||t(e)?0===e.length:!!n(e)&&0===Object.keys(e).length)}function l(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return[...new Set(e)]}function f(e,t=1){if(!Array.isArray(e))throw new Error("参数必须是数组");return t<=0?e.slice():e.reduce((e,n)=>e.concat(Array.isArray(n)?f(n,t-1):[n]),[])}function y(e,t=1){if(!Array.isArray(e))throw new Error("参数必须是数组");if(t<=0)return[];const n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}function h(e){if(Array.isArray(e)&&0!==e.length)return Math.max(...e)}function p(e){if(Array.isArray(e)&&0!==e.length)return Math.min(...e)}function g(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return e.reduce((e,t)=>e+t,0)}function d(e){if(Array.isArray(e)&&0!==e.length)return g(e)/e.length}function m(e,t=/* @__PURE__ */new WeakMap){if(null===e||"object"!=typeof e)return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof HTMLElement)return e.cloneNode(!0);if(t.has(e))return t.get(e);if(Array.isArray(e)){const n=[];return t.set(e,n),e.forEach((e,r)=>{n[r]=m(e,t)}),n}const n={};return t.set(e,n),Object.keys(e).forEach(r=>{n[r]=m(e[r],t)}),n}function v(...e){const t={};return e.forEach(e=>{e&&"object"==typeof e&&Object.keys(e).forEach(n=>{const r=n;void 0!==e[r]&&(t[r]=e[r])})}),t}function E(e){return"object"!=typeof e||null===e?[]:Object.keys(e)}function b(e){return"object"!=typeof e||null===e?[]:Object.values(e)}function w(e,t){return"object"==typeof e&&null!==e&&e.hasOwnProperty(t)}function A(e,t){return Math.floor(Math.random()*(t-e+1))+e}function j(e,t,n){return Math.min(Math.max(e,t),n)}function x(e){return e*(Math.PI/180)}function M(e){return e*(180/Math.PI)}function L(e,t){const n=t.x-e.x,r=t.y-e.y;return Math.sqrt(n*n+r*r)}function S(e,t){return Number(Math.round(parseFloat(e+"e"+t))+"e-"+t)}function O(e,t,n=!1){try{(n?sessionStorage:localStorage).setItem(e,JSON.stringify(t))}catch(r){console.error("存储失败:",r)}}function k(e,t=!1){try{const n=(t?sessionStorage:localStorage).getItem(e);return n?JSON.parse(n):null}catch(n){return console.error("获取存储失败:",n),null}}function N(e,t=!1){try{(t?sessionStorage:localStorage).removeItem(e)}catch(n){console.error("删除存储失败:",n)}}function P(e=!1){try{(e?sessionStorage:localStorage).clear()}catch(t){console.error("清空存储失败:",t)}}function R(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".xls,.xlsx,.xlsm",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("Excel文件上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})}function I(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".jpg,.png,.jpeg,.gif",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("图片上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})}function U(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".gltf,.glb",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("模型上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})}function C(e,t,n="application/vnd.ms-excel;charset=utf-8"){const r=document.createElement("a");r.download=t,r.style.display="none";const o=new Blob([e],{type:n});r.href=URL.createObjectURL(o),document.body.appendChild(r),r.click(),document.body.removeChild(r),URL.revokeObjectURL(r.href)}function D(e,t,n){return e*Math.pow(1+t,n)}export{d as average,y as chunk,j as clamp,P as clearStorage,D as compoundInterest,m as deepClone,x as degreesToRadians,L as distance,C as downloadFile,f as flatten,k as getStorage,e as getType,w as hasKey,t as isArray,i as isBoolean,s as isEmpty,r as isFunction,u as isNull,c as isNumber,n as isObject,o as isString,a as isUndefined,E as keys,h as max,v as merge,p as min,M as radiansToDegrees,A as randomInt,N as removeStorage,S as round,O as setStorage,g as sum,l as unique,R as uploadExcelFile,I as uploadImageFile,U as uploadModelFile,b as values};
+function e(e){return Object.prototype.toString.call(e).slice(8,-1).toLowerCase()}function t(e){return Array.isArray(e)}function n(t){return"object"===e(t)}function r(e){return"function"==typeof e}function o(e){return"string"==typeof e}function c(e){return"number"==typeof e&&!isNaN(e)}function i(e){return"boolean"==typeof e}function u(e){return null===e}function a(e){return void 0===e}function s(e){return!(!u(e)&&!a(e))||(o(e)||t(e)?0===e.length:!!n(e)&&0===Object.keys(e).length)}function l(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return[...new Set(e)]}function f(e,t=1){if(!Array.isArray(e))throw new Error("参数必须是数组");return t<=0?e.slice():e.reduce((e,n)=>e.concat(Array.isArray(n)?f(n,t-1):[n]),[])}function y(e,t=1){if(!Array.isArray(e))throw new Error("参数必须是数组");if(t<=0)return[];const n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}function h(e){if(Array.isArray(e)&&0!==e.length)return Math.max(...e)}function p(e){if(Array.isArray(e)&&0!==e.length)return Math.min(...e)}function g(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return e.reduce((e,t)=>e+t,0)}function d(e){if(Array.isArray(e)&&0!==e.length)return g(e)/e.length}function m(e,t=/* @__PURE__ */new WeakMap){if(null===e||"object"!=typeof e)return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof HTMLElement)return e.cloneNode(!0);if(t.has(e))return t.get(e);if(Array.isArray(e)){const n=[];return t.set(e,n),e.forEach((e,r)=>{n[r]=m(e,t)}),n}const n={};return t.set(e,n),Object.keys(e).forEach(r=>{n[r]=m(e[r],t)}),n}function v(...e){const t={};return e.forEach(e=>{e&&"object"==typeof e&&Object.keys(e).forEach(n=>{const r=n;void 0!==e[r]&&(t[r]=e[r])})}),t}function E(e){return"object"!=typeof e||null===e?[]:Object.keys(e)}function b(e){return"object"!=typeof e||null===e?[]:Object.values(e)}function w(e,t){return"object"==typeof e&&null!==e&&e.hasOwnProperty(t)}function A(e,t){return Math.floor(Math.random()*(t-e+1))+e}function j(e){return e*(Math.PI/180)}function x(e){return e*(180/Math.PI)}function L(e,t){const n=t.x-e.x,r=t.y-e.y;return Math.sqrt(n*n+r*r)}function S(e,t){return Number(Math.round(parseFloat(e+"e"+t))+"e-"+t)}function M(e,t,n=!1){try{(n?sessionStorage:localStorage).setItem(e,JSON.stringify(t))}catch(r){console.error("存储失败:",r)}}function O(e,t=!1){try{const n=(t?sessionStorage:localStorage).getItem(e);return n?JSON.parse(n):null}catch(n){return console.error("获取存储失败:",n),null}}function k(e,t=!1){try{(t?sessionStorage:localStorage).removeItem(e)}catch(n){console.error("删除存储失败:",n)}}function N(e=!1){try{(e?sessionStorage:localStorage).clear()}catch(t){console.error("清空存储失败:",t)}}function P(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".xls,.xlsx,.xlsm",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("Excel文件上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})}function R(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".jpg,.png,.jpeg,.gif",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("图片上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})}function I(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".gltf,.glb",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("模型上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})}function U(e,t,n="application/vnd.ms-excel;charset=utf-8"){const r=document.createElement("a");r.download=t,r.style.display="none";const o=new Blob([e],{type:n});r.href=URL.createObjectURL(o),document.body.appendChild(r),r.click(),document.body.removeChild(r),URL.revokeObjectURL(r.href)}function C(e,t,n){return e*Math.pow(1+t,n)}export{d as average,y as chunk,N as clearStorage,C as compoundInterest,m as deepClone,j as degreesToRadians,L as distance,U as downloadFile,f as flatten,O as getStorage,e as getType,w as hasKey,t as isArray,i as isBoolean,s as isEmpty,r as isFunction,u as isNull,c as isNumber,n as isObject,o as isString,a as isUndefined,E as keys,h as max,v as merge,p as min,x as radiansToDegrees,A as randomInt,k as removeStorage,S as round,M as setStorage,g as sum,l as unique,P as uploadExcelFile,R as uploadImageFile,I as uploadModelFile,b as values};

package/dist/wjk-util.umd.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).WJKUtil={})}(this,function(e){"use strict";function t(e){return Object.prototype.toString.call(e).slice(8,-1).toLowerCase()}function n(e){return Array.isArray(e)}function r(e){return"object"===t(e)}function o(e){return"string"==typeof e}function c(e){return null===e}function i(e){return void 0===e}function a(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return e.reduce((e,t)=>e+t,0)}e.average=function(e){if(Array.isArray(e)&&0!==e.length)return a(e)/e.length},e.chunk=function(e,t=1){if(!Array.isArray(e))throw new Error("参数必须是数组");if(t<=0)return[];const n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n},e.clamp=function(e,t,n){return Math.min(Math.max(e,t),n)},e.clearStorage=function(e=!1){try{(e?sessionStorage:localStorage).clear()}catch(t){console.error("清空存储失败:",t)}},e.compoundInterest=function(e,t,n){return e*Math.pow(1+t,n)},e.deepClone=function e(t,n=new WeakMap){if(null===t||"object"!=typeof t)return t;if(t instanceof Date)return new Date(t.getTime());if(t instanceof RegExp)return new RegExp(t.source,t.flags);if(t instanceof HTMLElement)return t.cloneNode(!0);if(n.has(t))return n.get(t);if(Array.isArray(t)){const r=[];return n.set(t,r),t.forEach((t,o)=>{r[o]=e(t,n)}),r}const r={};return n.set(t,r),Object.keys(t).forEach(o=>{r[o]=e(t[o],n)}),r},e.degreesToRadians=function(e){return e*(Math.PI/180)},e.distance=function(e,t){const n=t.x-e.x,r=t.y-e.y;return Math.sqrt(n*n+r*r)},e.downloadFile=function(e,t,n="application/vnd.ms-excel;charset=utf-8"){const r=document.createElement("a");r.download=t,r.style.display="none";const o=new Blob([e],{type:n});r.href=URL.createObjectURL(o),document.body.appendChild(r),r.click(),document.body.removeChild(r),URL.revokeObjectURL(r.href)},e.flatten=function e(t,n=1){if(!Array.isArray(t))throw new Error("参数必须是数组");return n<=0?t.slice():t.reduce((t,r)=>t.concat(Array.isArray(r)?e(r,n-1):[r]),[])},e.getStorage=function(e,t=!1){try{const n=(t?sessionStorage:localStorage).getItem(e);return n?JSON.parse(n):null}catch(n){return console.error("获取存储失败:",n),null}},e.getType=t,e.hasKey=function(e,t){return"object"==typeof e&&null!==e&&e.hasOwnProperty(t)},e.isArray=n,e.isBoolean=function(e){return"boolean"==typeof e},e.isEmpty=function(e){return!(!c(e)&&!i(e))||(o(e)||n(e)?0===e.length:!!r(e)&&0===Object.keys(e).length)},e.isFunction=function(e){return"function"==typeof e},e.isNull=c,e.isNumber=function(e){return"number"==typeof e&&!isNaN(e)},e.isObject=r,e.isString=o,e.isUndefined=i,e.keys=function(e){return"object"!=typeof e||null===e?[]:Object.keys(e)},e.max=function(e){if(Array.isArray(e)&&0!==e.length)return Math.max(...e)},e.merge=function(...e){const t={};return e.forEach(e=>{e&&"object"==typeof e&&Object.keys(e).forEach(n=>{const r=n;void 0!==e[r]&&(t[r]=e[r])})}),t},e.min=function(e){if(Array.isArray(e)&&0!==e.length)return Math.min(...e)},e.radiansToDegrees=function(e){return e*(180/Math.PI)},e.randomInt=function(e,t){return Math.floor(Math.random()*(t-e+1))+e},e.removeStorage=function(e,t=!1){try{(t?sessionStorage:localStorage).removeItem(e)}catch(n){console.error("删除存储失败:",n)}},e.round=function(e,t){return Number(Math.round(parseFloat(e+"e"+t))+"e-"+t)},e.setStorage=function(e,t,n=!1){try{(n?sessionStorage:localStorage).setItem(e,JSON.stringify(t))}catch(r){console.error("存储失败:",r)}},e.sum=a,e.unique=function(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return[...new Set(e)]},e.uploadExcelFile=function(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".xls,.xlsx,.xlsm",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("Excel文件上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})},e.uploadImageFile=function(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".jpg,.png,.jpeg,.gif",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("图片上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})},e.uploadModelFile=function(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".gltf,.glb",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("模型上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})},e.values=function(e){return"object"!=typeof e||null===e?[]:Object.values(e)},Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).WJKUtil={})}(this,function(e){"use strict";function t(e){return Object.prototype.toString.call(e).slice(8,-1).toLowerCase()}function n(e){return Array.isArray(e)}function r(e){return"object"===t(e)}function o(e){return"string"==typeof e}function c(e){return null===e}function i(e){return void 0===e}function a(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return e.reduce((e,t)=>e+t,0)}e.average=function(e){if(Array.isArray(e)&&0!==e.length)return a(e)/e.length},e.chunk=function(e,t=1){if(!Array.isArray(e))throw new Error("参数必须是数组");if(t<=0)return[];const n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n},e.clearStorage=function(e=!1){try{(e?sessionStorage:localStorage).clear()}catch(t){console.error("清空存储失败:",t)}},e.compoundInterest=function(e,t,n){return e*Math.pow(1+t,n)},e.deepClone=function e(t,n=new WeakMap){if(null===t||"object"!=typeof t)return t;if(t instanceof Date)return new Date(t.getTime());if(t instanceof RegExp)return new RegExp(t.source,t.flags);if(t instanceof HTMLElement)return t.cloneNode(!0);if(n.has(t))return n.get(t);if(Array.isArray(t)){const r=[];return n.set(t,r),t.forEach((t,o)=>{r[o]=e(t,n)}),r}const r={};return n.set(t,r),Object.keys(t).forEach(o=>{r[o]=e(t[o],n)}),r},e.degreesToRadians=function(e){return e*(Math.PI/180)},e.distance=function(e,t){const n=t.x-e.x,r=t.y-e.y;return Math.sqrt(n*n+r*r)},e.downloadFile=function(e,t,n="application/vnd.ms-excel;charset=utf-8"){const r=document.createElement("a");r.download=t,r.style.display="none";const o=new Blob([e],{type:n});r.href=URL.createObjectURL(o),document.body.appendChild(r),r.click(),document.body.removeChild(r),URL.revokeObjectURL(r.href)},e.flatten=function e(t,n=1){if(!Array.isArray(t))throw new Error("参数必须是数组");return n<=0?t.slice():t.reduce((t,r)=>t.concat(Array.isArray(r)?e(r,n-1):[r]),[])},e.getStorage=function(e,t=!1){try{const n=(t?sessionStorage:localStorage).getItem(e);return n?JSON.parse(n):null}catch(n){return console.error("获取存储失败:",n),null}},e.getType=t,e.hasKey=function(e,t){return"object"==typeof e&&null!==e&&e.hasOwnProperty(t)},e.isArray=n,e.isBoolean=function(e){return"boolean"==typeof e},e.isEmpty=function(e){return!(!c(e)&&!i(e))||(o(e)||n(e)?0===e.length:!!r(e)&&0===Object.keys(e).length)},e.isFunction=function(e){return"function"==typeof e},e.isNull=c,e.isNumber=function(e){return"number"==typeof e&&!isNaN(e)},e.isObject=r,e.isString=o,e.isUndefined=i,e.keys=function(e){return"object"!=typeof e||null===e?[]:Object.keys(e)},e.max=function(e){if(Array.isArray(e)&&0!==e.length)return Math.max(...e)},e.merge=function(...e){const t={};return e.forEach(e=>{e&&"object"==typeof e&&Object.keys(e).forEach(n=>{const r=n;void 0!==e[r]&&(t[r]=e[r])})}),t},e.min=function(e){if(Array.isArray(e)&&0!==e.length)return Math.min(...e)},e.radiansToDegrees=function(e){return e*(180/Math.PI)},e.randomInt=function(e,t){return Math.floor(Math.random()*(t-e+1))+e},e.removeStorage=function(e,t=!1){try{(t?sessionStorage:localStorage).removeItem(e)}catch(n){console.error("删除存储失败:",n)}},e.round=function(e,t){return Number(Math.round(parseFloat(e+"e"+t))+"e-"+t)},e.setStorage=function(e,t,n=!1){try{(n?sessionStorage:localStorage).setItem(e,JSON.stringify(t))}catch(r){console.error("存储失败:",r)}},e.sum=a,e.unique=function(e){if(!Array.isArray(e))throw new Error("参数必须是数组");return[...new Set(e)]},e.uploadExcelFile=function(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".xls,.xlsx,.xlsm",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("Excel文件上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})},e.uploadImageFile=function(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".jpg,.png,.jpeg,.gif",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("图片上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})},e.uploadModelFile=function(){return new Promise(e=>{const t=document.createElement("input");t.type="file",t.accept=".gltf,.glb",t.click(),t.addEventListener("change",function n(r){const o=r.target,c=o.files?.[0];if(c){const n=c.name.split("."),r=n[n.length-1];t.accept.includes(r)?e(c):(console.error("模型上传格式错误"),e(void 0))}else e(void 0);t.removeEventListener("change",n)})})},e.values=function(e){return"object"!=typeof e||null===e?[]:Object.values(e)},Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wjk-util",
-  "version": "0.0.12",
+  "version": "0.1.0",
   "type": "module",
   "description": "一个包含常见 JavaScript 函数的实用库",
   "author": "wjk",

package/types/module/array.d.ts

@@ -1,7 +1,7 @@
 /**
  * 数组去重
- * @param array 待去重数组
- * @returns 去重后的数组
+ * @param {array} array 待去重数组
+ * @returns {array} 去重后的数组
  * @example
  * unique([1, 2, 2, 3, 4, 4, 5]) // [1, 2, 3, 4, 5]
  * @group Array
@@ -9,9 +9,9 @@
 export declare function unique<T>(array: T[]): T[];
 /**
  * 数组扁平化
- * @param array 待扁平化数组
- * @param depth 扁平化深度，默认为1
- * @returns 扁平化后的数组
+ * @param {array} array 待扁平化数组
+ * @param {number} depth 扁平化深度，默认为1
+ * @returns {array} 扁平化后的数组
  * @example
  * flatten([1, [2, [3, [4, [5]]]]]) // [1, 2, [3, [4, [5]]]]
  * @group Array
@@ -19,9 +19,9 @@ export declare function unique<T>(array: T[]): T[];
 export declare function flatten<T>(array: (T | T[])[], depth?: number): T[];
 /**
  * 数组分块
- * @param array 待分块数组
- * @param size 每块大小
- * @returns 分块后的二维数组
+ * @param {array} array 待分块数组
+ * @param {number} size 每块大小
+ * @returns {array} 分块后的二维数组
  * @example
  * chunk([1, 2, 3, 4, 5, 6, 7, 8], 3) // [[1, 2, 3], [4, 5, 6], [7, 8]]
  * @group Array
@@ -29,8 +29,8 @@ export declare function flatten<T>(array: (T | T[])[], depth?: number): T[];
 export declare function chunk<T>(array: T[], size?: number): T[][];
 /**
  * 获取数组中的最大值
- * @param array 数字数组
- * @returns 最大值
+ * @param {array} array 数字数组
+ * @returns {number} 最大值
  * @example
  * max([1, 2, 3, 4, 5]) // 5
  * @group Array
@@ -38,15 +38,17 @@ export declare function chunk<T>(array: T[], size?: number): T[][];
 export declare function max(array: number[]): number | undefined;
 /**
  * 获取数组中的最小值
- * @param array 数字数组
- * @returns 最小值
+ * @param {array} array 数字数组
+ * @returns {number} 最小值
+ * @example
+ * min([1, 2, 3, 4, 5]) // 1
  * @group Array
  */
 export declare function min(array: number[]): number | undefined;
 /**
  * 数组求和
- * @param array 数字数组
- * @returns 求和结果
+ * @param {array} array 数字数组
+ * @returns {number} 求和结果
  * @example
  * sum([1, 2, 3, 4, 5]) // 15
  * @group Array
@@ -54,8 +56,8 @@ export declare function min(array: number[]): number | undefined;
 export declare function sum(array: number[]): number;
 /**
  * 数组平均值
- * @param array 数字数组
- * @returns 平均值
+ * @param {array} array 数字数组
+ * @returns {number} 平均值
  * @example
  * average([1, 2, 3, 4, 5]) // 3
  * @group Array

package/types/module/file.d.ts

@@ -1,6 +1,6 @@
 /**
  * 上传Excel文件
- * @returns 上传的Excel文件对象
+ * @returns {Promise<File | undefined>} 上传的Excel文件对象
  * @example
  * uploadExcelFile().then(file => {
  *   if (file) {
@@ -14,7 +14,7 @@
 export declare function uploadExcelFile(): Promise<File | undefined>;
 /**
  * 上传图片文件
- * @returns 上传的图片文件对象
+ * @returns {Promise<File | undefined>} 上传的图片文件对象
  * @example
  * uploadImageFile().then(file => {
  *   if (file) {
@@ -28,7 +28,7 @@ export declare function uploadExcelFile(): Promise<File | undefined>;
 export declare function uploadImageFile(): Promise<File | undefined>;
 /**
  * 上传模型文件
- * @returns 上传的模型文件对象
+ * @returns {Promise<File | undefined>} 上传的模型文件对象
  * @example
  * uploadModelFile().then(file => {
  *   if (file) {
@@ -42,9 +42,9 @@ export declare function uploadImageFile(): Promise<File | undefined>;
 export declare function uploadModelFile(): Promise<File | undefined>;
 /**
  * 下载文件
- * @param data 文件数据
- * @param name 文件名
- * @param mimeType 文件MIME类型，默认为Excel文件类型
+ * @param {string | Blob | ArrayBuffer} data 文件数据
+ * @param {string} name 文件名
+ * @param {string} mimeType 文件MIME类型，默认为Excel文件类型
  * @example
  * downloadFile('文件内容', 'example.xlsx');
  * @group File

package/types/module/finance.d.ts

@@ -1,10 +1,10 @@
 /**
  * 复利计算
  * 复利公式：A = P * (1 + r)^n
- * @param principal 本金
- * @param rate 年利率
- * @param times 复利次数
- * @returns 复利金额
+ * @param {number} principal 本金
+ * @param {number} rate 年利率
+ * @param {number} times 复利次数
+ * @returns {number} 复利金额
  * @example
  * compoundInterest(10000, 0.05, 5) // 12833.03
  * @group Finance

package/types/module/link.d.ts

@@ -1,7 +1,7 @@
 /**
  * 将 URL 参数转换为 JSON 对象
- * @param url 包含参数的 URL 字符串
- * @returns 转换后的 JSON 对象
+ * @param {string} url 包含参数的 URL 字符串
+ * @returns {Record<string, string>} 转换后的 JSON 对象
  * @example
  * paramToJson('https://example.com?name=John&age=30') // { name: 'John', age: '30' }
  * @group Link
@@ -9,8 +9,8 @@
 export declare function paramToJson(url: string): Record<string, string>;
 /**
  * 将 JSON 对象转换为 URL 参数字符串
- * @param json JSON 对象
- * @returns 转换后的 URL 参数字符串
+ * @param {Record<string, any>} json JSON 对象
+ * @returns {string} 转换后的 URL 参数字符串
  * @example
  * jsonToParam({ name: 'John', age: 30 }) // 'name=John&age=30'
  * @group Link

package/types/module/math.d.ts

@@ -1,28 +1,17 @@
 /**
  * 生成范围内的随机整数
- * @param min 最小值
- * @param max 最大值
- * @returns 随机整数
+ * @param {number} min 最小值
+ * @param {number} max 最大值
+ * @returns {number} 随机整数
  * @example
  * randomInt(1, 10) // 5
  * @group Math
  */
 export declare function randomInt(min: number, max: number): number;
-/**
- * 限制数值在指定范围内
- * @param value 数值
- * @param min 最小值
- * @param max 最大值
- * @returns 限制后的数值
- * @example
- * clamp(5, 1, 10) // 5
- * @group Math
- */
-export declare function clamp(value: number, min: number, max: number): number;
 /**
  * 将角度转换为弧度
- * @param degrees 角度
- * @returns 弧度
+ * @param {number} degrees 角度
+ * @returns {number} 弧度
  * @example
  * degreesToRadians(180) // 3.141592653589793
  * @group Math
@@ -30,8 +19,8 @@ export declare function clamp(value: number, min: number, max: number): number;
 export declare function degreesToRadians(degrees: number): number;
 /**
  * 将弧度转换为角度
- * @param radians 弧度
- * @returns 角度
+ * @param {number} radians 弧度
+ * @returns {number} 角度
  * @example
  * radiansToDegrees(Math.PI) // 180
  * @group Math
@@ -39,9 +28,9 @@ export declare function degreesToRadians(degrees: number): number;
 export declare function radiansToDegrees(radians: number): number;
 /**
  * 计算两点间距离
- * @param point1 点1 {x, y}
- * @param point2 点2 {x, y}
- * @returns 距离
+ * @param {object} point1 点1 {x, y}
+ * @param {object} point2 点2 {x, y}
+ * @returns {number} 距离
  * @example
  * distance({ x: 0, y: 0 }, { x: 3, y: 4 }) // 5
  * @group Math
@@ -55,9 +44,9 @@ export declare function distance(point1: {
 }): number;
 /**
  * 四舍五入到指定小数位
- * @param value 数值
- * @param decimals 小数位数
- * @returns 四舍五入后的数值
+ * @param {number} value 数值
+ * @param {number} decimals 小数位数
+ * @returns {number} 四舍五入后的数值
  * @example
  * round(1.2345, 2) // 1.23
  * @group Math

package/types/module/object.d.ts

@@ -1,8 +1,8 @@
 /**
  * 深拷贝对象
- * @param obj - 需要深拷贝的对象
- * @param hash - 用于处理循环引用的哈希表
- * @returns 深拷贝后的对象
+ * @param {object} obj - 需要深拷贝的对象
+ * @param {WeakMap<object, any>} hash - 用于处理循环引用的哈希表
+ * @returns {object} 深拷贝后的对象
  * @example
  * deepClone({ a: 1, b: { c: 2 } }) // { a: 1, b: { c: 2 } }
  * @group Object
@@ -10,7 +10,7 @@
 export declare function deepClone<T>(obj: T, hash?: WeakMap<object, any>): T;
 /**
  * 合并对象
- * @param objects 待合并的对象
+ * @param {...object} objects 待合并的对象
  * @returns 合并后的对象
  * @example
  * merge({ a: 1, b: 2 }, { b: 3, c: 4 }) // { a: 1, b: 3, c: 4 }
@@ -19,8 +19,8 @@ export declare function deepClone<T>(obj: T, hash?: WeakMap<object, any>): T;
 export declare function merge<T extends Record<string, any>>(...objects: Partial<T>[]): T;
 /**
  * 获取对象的所有键
- * @param obj 对象
- * @returns 键数组
+ * @param {object} obj 对象
+ * @returns {Array<string>} 键数组
  * @example
  * keys({ a: 1, b: 2 }) // ['a', 'b']
  * @group Object
@@ -28,8 +28,8 @@ export declare function merge<T extends Record<string, any>>(...objects: Partial
 export declare function keys<T extends Record<string, any>>(obj: T): (keyof T)[];
 /**
  * 获取对象的所有值
- * @param obj 对象
- * @returns 值数组
+ * @param {object} obj 对象
+ * @returns {Array<T[keyof T]>} 值数组
  * @example
  * values({ a: 1, b: 2 }) // [1, 2]
  * @group Object
@@ -37,9 +37,9 @@ export declare function keys<T extends Record<string, any>>(obj: T): (keyof T)[]
 export declare function values<T extends Record<string, any>>(obj: T): T[keyof T][];
 /**
  * 检查对象是否包含某个键
- * @param obj 对象
- * @param key 键名
- * @returns 是否包含该键
+ * @param {object} obj 对象
+ * @param {PropertyKey} key 键名
+ * @returns {boolean} 是否包含该键
  * @example
  * hasKey({ a: 1, b: 2 }, 'a') // true
  * @group Object

package/types/module/storage.d.ts

@@ -1,8 +1,8 @@
 /**
  * 设置本地存储
- * @param key 键
- * @param value 值
- * @param isSession 是否使用sessionStorage，默认false
+ * @param {string} key 键
+ * @param {T} value 值
+ * @param {boolean} isSession 是否使用sessionStorage，默认false
  * @example
  * setStorage('token', '123456') // 存储token到localStorage
  * setStorage('user', { id: 1, name: '张三' }, true) // 存储用户信息到sessionStorage
@@ -11,9 +11,9 @@
 export declare function setStorage<T>(key: string, value: T, isSession?: boolean): void;
 /**
  * 获取本地存储
- * @param key 键
- * @param isSession 是否使用sessionStorage，默认false
- * @returns 存储的值
+ * @param {string} key 键
+ * @param {boolean} isSession 是否使用sessionStorage，默认false
+ * @returns {T | null} 存储的值
  * @example
  * getStorage('token') // '123456'
  * getStorage('user', true) // { id: 1, name: '张三' }
@@ -22,8 +22,8 @@ export declare function setStorage<T>(key: string, value: T, isSession?: boolean
 export declare function getStorage<T>(key: string, isSession?: boolean): T | null;
 /**
  * 删除本地存储
- * @param key 键
- * @param isSession 是否使用sessionStorage，默认false
+ * @param {string} key 键
+ * @param {boolean} isSession 是否使用sessionStorage，默认false
  * @example
  * removeStorage('token') // 删除localStorage中的token
  * removeStorage('user', true) // 删除sessionStorage中的user
@@ -32,7 +32,7 @@ export declare function getStorage<T>(key: string, isSession?: boolean): T | nul
 export declare function removeStorage(key: string, isSession?: boolean): void;
 /**
  * 清空本地存储
- * @param isSession 是否使用sessionStorage，默认false
+ * @param {boolean} isSession 是否使用sessionStorage，默认false
  * @example
  * clearStorage() // 清空localStorage
  * clearStorage(true) // 清空sessionStorage

package/types/module/type.d.ts

@@ -1,7 +1,7 @@
 /**
  * 检测变量类型
- * @param value 待检测的值
- * @returns 类型字符串
+ * @param {unknown} value 待检测的值
+ * @returns {string} 类型字符串
  * @example
  * getType({}) // 'object'
  * getType([]) // 'array'
@@ -15,140 +15,96 @@
 export declare function getType(value: unknown): string;
 /**
  * 判断是否为数组
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为数组
  * @example
  * isArray([]) // true
- * isArray([1, 2, 3]) // true
- * isArray({}) // false
- * isArray('') // false
- * isArray(0) // false
- * isArray(true) // false
- * isArray(null) // false
  * isArray(undefined) // false
  * @group Type
  */
 export declare function isArray(value: unknown): value is unknown[];
 /**
  * 判断是否为对象
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为对象
  * @example
  * isObject({}) // true
  * isObject({ a: 1, b: 2 }) // true
- * isObject([]) // false
- * isObject('') // false
- * isObject(0) // false
- * isObject(true) // false
- * isObject(null) // false
  * isObject(undefined) // false
  * @group Type
  */
 export declare function isObject(value: unknown): value is Record<string, unknown>;
 /**
  * 判断是否为函数
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为函数
  * @example
  * isFunction(() => {}) // true
  * isFunction(function () {}) // true
  * isFunction(class {}) // true
  * isFunction({}) // false
- * isFunction([]) // false
- * isFunction('') // false
- * isFunction(0) // false
- * isFunction(true) // false
- * isFunction(null) // false
- * isFunction(undefined) // false
  * @group Type
  */
 export declare function isFunction(value: unknown): value is Function;
 /**
  * 判断是否为字符串
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为字符串
  * @example
- * isString('') // true
  * isString('hello') // true
  * isString(0) // false
- * isString(true) // false
- * isString(null) // false
- * isString(undefined) // false
  * @group Type
  */
 export declare function isString(value: unknown): value is string;
 /**
  * 判断是否为数字
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为数字
  * @example
  * isNumber(0) // true
  * isNumber(123) // true
- * isNumber(-123) // true
- * isNumber(123.456) // true
- * isNumber(-123.456) // true
  * isNumber('123') // false
- * isNumber('123.456') // false
- * isNumber(true) // false
- * isNumber(null) // false
- * isNumber(undefined) // false
  * @group Type
  */
 export declare function isNumber(value: unknown): value is number;
 /**
  * 判断是否为布尔值
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为布尔值
  * @example
  * isBoolean(true) // true
  * isBoolean(false) // true
- * isBoolean(0) // false
  * isBoolean(1) // false
- * isBoolean('true') // false
- * isBoolean('false') // false
- * isBoolean(null) // false
- * isBoolean(undefined) // false
  * @group Type
  */
 export declare function isBoolean(value: unknown): value is boolean;
 /**
  * 判断是否为null
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为null
  * @example
  * isNull(null) // true
  * isNull(undefined) // false
- * isNull('') // false
- * isNull(0) // false
- * isNull(true) // false
  * @group Type
  */
 export declare function isNull(value: unknown): value is null;
 /**
  * 判断是否为undefined
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为undefined
  * @example
  * isUndefined(undefined) // true
  * isUndefined(null) // false
  * isUndefined('') // false
- * isUndefined(0) // false
- * isUndefined(true) // false
  * @group Type
  */
 export declare function isUndefined(value: unknown): value is undefined;
 /**
  * 判断是否为空(null, undefined, 空字符串, 空数组, 空对象)
- * @param value 待检测的值
- * @returns
+ * @param {unknown} value 待检测的值
+ * @returns {boolean} 是否为空
  * @example
  * isEmpty(null) // true
- * isEmpty(undefined) // true
- * isEmpty('') // true
- * isEmpty([]) // true
- * isEmpty({}) // true
- * isEmpty('hello') // false
- * isEmpty([1, 2, 3]) // false
  * isEmpty({ a: 1, b: 2 }) // false
  * @group Type
  */