wjk-util 0.0.11 → 0.0.12

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){if(null===e||"object"!=typeof e)return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof Array)return e.map(e=>m(e));if(e instanceof Object){const t={};for(let n in e)e.hasOwnProperty(n)&&(t[n]=m(e[n]));return t}return e}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 b(e){return"object"!=typeof e||null===e?[]:Object.keys(e)}function w(e){return"object"!=typeof e||null===e?[]:Object.values(e)}function A(e,t){return"object"==typeof e&&null!==e&&e.hasOwnProperty(t)}function E(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 O(e){return e*(Math.PI/180)}function S(e){return e*(180/Math.PI)}function x(e,t){const n=t.x-e.x,r=t.y-e.y;return Math.sqrt(n*n+r*r)}function L(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 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 P(e,t=!1){try{(t?sessionStorage:localStorage).removeItem(e)}catch(n){console.error("删除存储失败:",n)}}function I(e=!1){try{(e?sessionStorage:localStorage).clear()}catch(t){console.error("清空存储失败:",t)}}function N(){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 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)}console.log(D(1e4,.025,208));export{d as average,y as chunk,j as clamp,I as clearStorage,D as compoundInterest,m as deepClone,O as degreesToRadians,x as distance,C as downloadFile,f as flatten,k as getStorage,e as getType,A 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,b as keys,h as max,v as merge,p as min,S as radiansToDegrees,E as randomInt,P as removeStorage,L as round,M as setStorage,g as sum,l as unique,N as uploadExcelFile,R as uploadImageFile,U as uploadModelFile,w 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,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};

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)}function u(e,t,n){return e*Math.pow(1+t,n)}console.log(u(1e4,.025,208)),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=u,e.deepClone=function e(t){if(null===t||"object"!=typeof t)return t;if(t instanceof Date)return new Date(t.getTime());if(t instanceof Array)return t.map(t=>e(t));if(t instanceof Object){const n={};for(let r in t)t.hasOwnProperty(r)&&(n[r]=e(t[r]));return n}return t},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.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"})});

package/package.json

@@ -1,43 +1,46 @@
-{
-  "name": "wjk-util",
-  "version": "0.0.11",
-  "type": "module",
-  "description": "一个包含常见 JavaScript 函数的实用库",
-  "author": "wjk",
-  "license": "MIT",
-  "repository": {
-    "type": "gitee",
-    "url": "https://gitee.com/wjkfree/wjk-util.git"
-  },
-  "homepage": "https://gitee.com/wjkfree/wjk-util#readme",
-  "keywords": [
-    "utility",
-    "functions",
-    "typescript"
-  ],
-  "files": [
-    "dist",
-    "types"
-  ],
-  "main": "./dist/wjk-util.umd.js",
-  "module": "./dist/wjk-util.es.js",
-  "types": "./types/index.d.ts",
-  "exports": {
-    "types": "./types/index.d.ts",
-    "import": "./dist/wjk-util.es.js",
-    "require": "./dist/wjk-util.umd.js"
-  },
-  "sideEffects": false,
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "patch": "npm version patch",
-    "publish": "npm publish"
-  },
-  "devDependencies": {
-    "terser": "^5.46.0",
-    "typescript": "~5.9.3",
-    "vite": "^7.3.1",
-    "vite-plugin-dts": "^4.5.4"
-  }
-}
+{
+  "name": "wjk-util",
+  "version": "0.0.12",
+  "type": "module",
+  "description": "一个包含常见 JavaScript 函数的实用库",
+  "author": "wjk",
+  "license": "MIT",
+  "repository": {
+    "type": "gitee",
+    "url": "https://gitee.com/wjkfree/wjk-util.git"
+  },
+  "homepage": "https://gitee.com/wjkfree/wjk-util#readme",
+  "keywords": [
+    "utility",
+    "functions",
+    "typescript"
+  ],
+  "files": [
+    "dist",
+    "types"
+  ],
+  "main": "./dist/wjk-util.umd.js",
+  "module": "./dist/wjk-util.es.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    "types": "./types/index.d.ts",
+    "import": "./dist/wjk-util.es.js",
+    "require": "./dist/wjk-util.umd.js"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "patch": "npm version patch",
+    "publish": "npm publish",
+    "docs": "typedoc"
+  },
+  "devDependencies": {
+    "terser": "^5.46.0",
+    "typedoc": "^0.28.17",
+    "typedoc-plugin-markdown": "^4.10.0",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}

package/types/module/array.d.ts

@@ -4,6 +4,7 @@
  * @returns 去重后的数组
  * @example
  * unique([1, 2, 2, 3, 4, 4, 5]) // [1, 2, 3, 4, 5]
+ * @group Array
  */
 export declare function unique<T>(array: T[]): T[];
 /**
@@ -13,6 +14,7 @@ export declare function unique<T>(array: T[]): T[];
  * @returns 扁平化后的数组
  * @example
  * flatten([1, [2, [3, [4, [5]]]]]) // [1, 2, [3, [4, [5]]]]
+ * @group Array
  */
 export declare function flatten<T>(array: (T | T[])[], depth?: number): T[];
 /**
@@ -20,29 +22,42 @@ export declare function flatten<T>(array: (T | T[])[], depth?: number): T[];
  * @param array 待分块数组
  * @param size 每块大小
  * @returns 分块后的二维数组
+ * @example
+ * chunk([1, 2, 3, 4, 5, 6, 7, 8], 3) // [[1, 2, 3], [4, 5, 6], [7, 8]]
+ * @group Array
  */
 export declare function chunk<T>(array: T[], size?: number): T[][];
 /**
  * 获取数组中的最大值
  * @param array 数字数组
  * @returns 最大值
+ * @example
+ * max([1, 2, 3, 4, 5]) // 5
+ * @group Array
  */
 export declare function max(array: number[]): number | undefined;
 /**
  * 获取数组中的最小值
  * @param array 数字数组
  * @returns 最小值
+ * @group Array
  */
 export declare function min(array: number[]): number | undefined;
 /**
  * 数组求和
  * @param array 数字数组
  * @returns 求和结果
+ * @example
+ * sum([1, 2, 3, 4, 5]) // 15
+ * @group Array
  */
 export declare function sum(array: number[]): number;
 /**
  * 数组平均值
  * @param array 数字数组
  * @returns 平均值
+ * @example
+ * average([1, 2, 3, 4, 5]) // 3
+ * @group Array
  */
 export declare function average(array: number[]): number | undefined;

package/types/module/file.d.ts

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

package/types/module/finance.d.ts

@@ -5,5 +5,8 @@
  * @param rate 年利率
  * @param times 复利次数
  * @returns 复利金额
+ * @example
+ * compoundInterest(10000, 0.05, 5) // 12833.03
+ * @group Finance
  */
 export declare function compoundInterest(principal: number, rate: number, times: number): number;

package/types/module/link.d.ts

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

package/types/module/math.d.ts

@@ -3,6 +3,9 @@
  * @param min 最小值
  * @param max 最大值
  * @returns 随机整数
+ * @example
+ * randomInt(1, 10) // 5
+ * @group Math
  */
 export declare function randomInt(min: number, max: number): number;
 /**
@@ -11,18 +14,27 @@ export declare function randomInt(min: number, max: number): number;
  * @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 弧度
+ * @example
+ * degreesToRadians(180) // 3.141592653589793
+ * @group Math
  */
 export declare function degreesToRadians(degrees: number): number;
 /**
  * 将弧度转换为角度
  * @param radians 弧度
  * @returns 角度
+ * @example
+ * radiansToDegrees(Math.PI) // 180
+ * @group Math
  */
 export declare function radiansToDegrees(radians: number): number;
 /**
@@ -30,6 +42,9 @@ export declare function radiansToDegrees(radians: number): number;
  * @param point1 点1 {x, y}
  * @param point2 点2 {x, y}
  * @returns 距离
+ * @example
+ * distance({ x: 0, y: 0 }, { x: 3, y: 4 }) // 5
+ * @group Math
  */
 export declare function distance(point1: {
     x: number;
@@ -43,5 +58,8 @@ export declare function distance(point1: {
  * @param value 数值
  * @param decimals 小数位数
  * @returns 四舍五入后的数值
+ * @example
+ * round(1.2345, 2) // 1.23
+ * @group Math
  */
 export declare function round(value: number, decimals: number): number;

package/types/module/object.d.ts

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

package/types/module/storage.d.ts

@@ -3,6 +3,10 @@
  * @param key 键
  * @param value 值
  * @param isSession 是否使用sessionStorage，默认false
+ * @example
+ * setStorage('token', '123456') // 存储token到localStorage
+ * setStorage('user', { id: 1, name: '张三' }, true) // 存储用户信息到sessionStorage
+ * @group Storage
  */
 export declare function setStorage<T>(key: string, value: T, isSession?: boolean): void;
 /**
@@ -10,16 +14,28 @@ export declare function setStorage<T>(key: string, value: T, isSession?: boolean
  * @param key 键
  * @param isSession 是否使用sessionStorage，默认false
  * @returns 存储的值
+ * @example
+ * getStorage('token') // '123456'
+ * getStorage('user', true) // { id: 1, name: '张三' }
+ * @group Storage
  */
 export declare function getStorage<T>(key: string, isSession?: boolean): T | null;
 /**
  * 删除本地存储
  * @param key 键
  * @param isSession 是否使用sessionStorage，默认false
+ * @example
+ * removeStorage('token') // 删除localStorage中的token
+ * removeStorage('user', true) // 删除sessionStorage中的user
+ * @group Storage
  */
 export declare function removeStorage(key: string, isSession?: boolean): void;
 /**
  * 清空本地存储
  * @param isSession 是否使用sessionStorage，默认false
+ * @example
+ * clearStorage() // 清空localStorage
+ * clearStorage(true) // 清空sessionStorage
+ * @group Storage
  */
 export declare function clearStorage(isSession?: boolean): void;

package/types/module/type.d.ts

@@ -2,59 +2,154 @@
  * 检测变量类型
  * @param value 待检测的值
  * @returns 类型字符串
+ * @example
+ * getType({}) // 'object'
+ * getType([]) // 'array'
+ * getType('') // 'string'
+ * getType(0) // 'number'
+ * getType(true) // 'boolean'
+ * getType(null) // 'null'
+ * getType(undefined) // 'undefined'
+ * @group Type
  */
 export declare function getType(value: unknown): string;
 /**
  * 判断是否为数组
  * @param value 待检测的值
  * @returns
+ * @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
+ * @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
+ * @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
+ * @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
+ * @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
+ * @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
+ * @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
+ * @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
+ * @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
  */
 export declare function isEmpty(value: unknown): boolean;