@nano-lib/util 1.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 @nanofe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/constant/index.d.ts

@@ -0,0 +1,8 @@
+declare const dateFormats: readonly [readonly ["date", "YYYY-MM-DD"], readonly ["daterange", "YYYY-MM-DD"], readonly ["datetime", "YYYY-MM-DD HH:mm:ss"], readonly ["datetimerange", "YYYY-MM-DD HH:mm:ss"], readonly ["month", "YYYY-MM"], readonly ["monthrange", "YYYY-MM"], readonly ["year", "YYYY"], readonly ["yearrange", "YYYY"], readonly ["time", "HH:mm:ss"]];
+export type DateFormat = (typeof dateFormats)[number][1];
+export declare const DATE_VALUE_FORMAT: Map<string, DateFormat>;
+export declare const IMAGE_TYPE: string[];
+export declare const MEDIA_TYPE: string[];
+export declare const DOC_TYPE: string[];
+export declare const FILE_TYPE: string[];
+export {};

package/lib/index.d.ts

@@ -0,0 +1,93 @@
+import { default as scrollTo } from './utils/scroll';
+import { debounce, creatCancelTask, downloadFile, getGenderByIdNumber, getBirthdayByIdNumber, trimArray } from './utils/common';
+import { uuid, randomNum } from './utils/random';
+import { phoneToAsterisk, idNumberToAsterisk, firstLetterToUpperCase, firstLetterToLowerCase } from './utils/string';
+import { parseTime, getTimeDistance, getDayRange } from './utils/date';
+import { addClass, removeClass, hasClass, toggleClass, noContextmenu, useRafThrottle } from './utils/element';
+import { encodeURIToParams, paramsToQueryString, queryStringToParams, errorCodeToString, YNToString, HNToString, valueToLabel, chargeToLabel, cascaderToLabel, multipleSelectToLabel } from './utils/to';
+import { validHttp, validExternal, validString, validNumberStr, validEmptyObject, validURL, validPassword, validEmail, validIdNumber, validPhone, validTel } from './utils/valid';
+export declare const constants: {
+    DATE_VALUE_FORMAT: Map<string, "YYYY-MM-DD HH:mm:ss" | "YYYY-MM-DD" | "YYYY-MM" | "YYYY" | "HH:mm:ss">;
+    IMAGE_TYPE: string[];
+    MEDIA_TYPE: string[];
+    DOC_TYPE: string[];
+    FILE_TYPE: string[];
+};
+export declare const commonUtil: {
+    NOOP: () => void;
+    debounce: typeof debounce;
+    creatCancelTask: typeof creatCancelTask;
+    downloadFile: typeof downloadFile;
+    trimArray: typeof trimArray;
+    getFullUrl: (relativeUrl: string, domain?: string) => string;
+    getArrayFullUrl: (relativeUrls: string | string[], domain?: string) => string[];
+    getGenderByIdNumber: typeof getGenderByIdNumber;
+    getBirthdayByIdNumber: typeof getBirthdayByIdNumber;
+};
+export declare const toUtil: {
+    encodeURIToParams: typeof encodeURIToParams;
+    paramsToQueryString: typeof paramsToQueryString;
+    queryStringToParams: typeof queryStringToParams;
+    errorCodeToString: typeof errorCodeToString;
+    YNToString: typeof YNToString;
+    HNToString: typeof HNToString;
+    valueToLabel: typeof valueToLabel;
+    chargeToLabel: typeof chargeToLabel;
+    cascaderToLabel: typeof cascaderToLabel;
+    multipleSelectToLabel: typeof multipleSelectToLabel;
+};
+export declare const validUtil: {
+    validHttp: typeof validHttp;
+    validExternal: typeof validExternal;
+    validString: typeof validString;
+    validNumberStr: typeof validNumberStr;
+    validEmptyObject: typeof validEmptyObject;
+    validURL: typeof validURL;
+    validPassword: typeof validPassword;
+    validEmail: typeof validEmail;
+    validIdNumber: typeof validIdNumber;
+    validPhone: typeof validPhone;
+    validTel: typeof validTel;
+};
+export declare const elementUtil: {
+    scrollTo: typeof scrollTo;
+    addClass: typeof addClass;
+    removeClass: typeof removeClass;
+    hasClass: typeof hasClass;
+    toggleClass: typeof toggleClass;
+    noContextmenu: typeof noContextmenu;
+    useRafThrottle: typeof useRafThrottle;
+};
+export declare const cacheUtil: {
+    local: {
+        set(key: string, value: string): void;
+        get(key: string): string | null;
+        setJSON(key: string, jsonValue: import('./types').AnyObj): void;
+        getJSON(key: string): import('./types').AnyObj | null;
+        remove(key: string): void;
+        clear(): void;
+    };
+    session: {
+        set(key: string, value: string): void;
+        get(key: string): string | null;
+        setJSON(key: string, jsonValue: import('./types').AnyObj): void;
+        getJSON(key: string): import('./types').AnyObj | null;
+        remove(key: string): void;
+        clear(): void;
+    };
+};
+export declare const randomUtil: {
+    uuid: typeof uuid;
+    randomNum: typeof randomNum;
+};
+export declare const stringUtil: {
+    phoneToAsterisk: typeof phoneToAsterisk;
+    idNumberToAsterisk: typeof idNumberToAsterisk;
+    firstLetterToUpperCase: typeof firstLetterToUpperCase;
+    firstLetterToLowerCase: typeof firstLetterToLowerCase;
+};
+export declare const dateUtil: {
+    parseTime: typeof parseTime;
+    getTimeDistance: typeof getTimeDistance;
+    getDayRange: typeof getDayRange;
+};

package/lib/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const I=(t,e,n,r)=>(t/=r/2,t<1?n/2*t*t+e:(t--,-n/2*(t*(t-2)-1)+e)),A=window.requestAnimationFrame||window.webkitRequestAnimationFrame||window.mozRequestAnimationFrame||window.msRequestAnimationFrame||(t=>window.setTimeout(t,1e3/60));function $(t,e){if(e){document.querySelector(e).scrollTop=t;return}document.documentElement.scrollTop=t,document.body.parentNode.scrollTop=t,document.body.scrollTop=t}function M(t){return t?document.querySelector(t).scrollTop:document.documentElement.scrollTop||document.body.parentNode.scrollTop||document.body.scrollTop}function D(t){const{target:e,to:n=0,duration:r=500,callback:o}=t??{},s=M(e),i=n-s,c=20;let a=0;const u=function(){a+=c;const l=I(a,s,i,r);$(l,e),a<r?A(u):o&&o()};u()}function E(t){return/^(http(s)?:\/\/)/.test(t)}function O(t){return/^(https?:|mailto:|tel:)/.test(t)}function R(t){return Object.prototype.toString.call(t)==="[object String]"}function x(t){return/^[+-]?(0|([1-9]\d*))(\.\d+)?$/g.test(t)}function U(t){return!Object.keys(t).length}function C(t){return/^(https?|ftp):\/\/([a-zA-Z0-9.-]+(:[a-zA-Z0-9.&%$-]+)*@)*((25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9][0-9]?)(\.(25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}|([a-zA-Z0-9-]+\.)*[a-zA-Z0-9-]+\.(com|edu|gov|int|mil|net|org|biz|arpa|info|name|pro|aero|coop|museum|[a-zA-Z]{2}))(:[0-9]+)*(\/($|[a-zA-Z0-9.,?'\\+&%$#=~_-]+))*$/.test(t)}function v(t,e=8){return new RegExp(`^S*(?=S{${e}},})(?=S*d)(?=S*[A-Z])(?=S*[a-z])(?=S*[!@#$%^&*?])S*$`).test(t)}function P(t){return/^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/.test(t)}function g(t){return/^\d{6}((((((19|20)\d{2})(0[13-9]|1[012])(0[1-9]|[12]\d|30))|(((19|20)\d{2})(0[13578]|1[02])31)|((19|20)\d{2})02(0[1-9]|1\d|2[0-8])|((((19|20)([13579][26]|[2468][048]|0[48]))|(2000))0229))\d{3})|((((\d{2})(0[13-9]|1[012])(0[1-9]|[12]\d|30))|((\d{2})(0[13578]|1[02])31)|((\d{2})02(0[1-9]|1\d|2[0-8]))|(([13579][26]|[2468][048]|0[048])0229))\d{2}))(\d|X|x)$/.test(t)}function H(t){return/^0\d{2,3}-?\d{7,8}$/.test(t)}function N(t){return/^1[3-9]\d{9}$/.test(t)}const d=()=>{};function z(t,e){let n=null;return function(...r){n!==null&&clearTimeout(n),n=setTimeout(()=>{t.apply(this,r),n=null},e)}}function F(t){if(!g(t))throw new Error("Please provide a valid ID number!");const e=t.length,n=e===15?t[e-1]:t[e-2];return parseInt(n)%2===1?"1":"2"}function L(t){if(!g(t))throw new Error("Please provide a valid ID number!");return t.substring(6,10)+"-"+t.substring(10,12)+"-"+t.substring(12,14)}const h=(t,e="")=>{e||(e=globalThis.location.origin);const n=new RegExp(/^http(s)?:\/\//),r=new RegExp(/^((?:[a-z]+:)?\/\/|data:image\/)(.*)/i);return n.test(t)||r.test(t)?t:e+t},q=(t,e="")=>{typeof t=="string"&&(t=t===""?[]:t.split(","));for(const n in t)t[n]=h(t[n],e);return t};function Z(t){let e=d;return(...n)=>new Promise((r,o)=>{e(),e=()=>{r=o=d},t(...n).then(s=>r(s),s=>o(s))})}function j(t,e){const n=document.createElement("a");n.download=e,n.href=t,n.click()}function S(t){const e=[];for(let n=0;n<t.length;n++)t[n]&&e.push(t[n]);return e}function k(t,e){switch(arguments.length){case 1:return parseInt((Math.random()*t+1).toString(),10);case 2:return parseInt((Math.random()*(e-t+1)+t).toString(),10);default:return 0}}function J(){let t="";const e=[];for(let n=0;n<=15;n++)e[n]=n.toString(16);for(let n=1;n<=36;n++)n===9||n===14||n===19||n===24?t+="-":n===15?t+=4:n===20?t+=e[Math.random()*4|8]:t+=e[Math.random()*16|0];return t}function _(t){return t?t.replace(/(\d{3})\d{4}(\d{4})/,"$1****$2"):""}function B(t,e,n){if(e??(e=4),n??(n=4),t){const r=t.length;return t.substring(0,e)+"*".repeat(r-e-n)+t.substring(r-n)}return""}function G(t){return t.replace(/( |^)[a-z]/g,e=>e.toUpperCase())}function Q(t){return t.replace(/( |^)[A-Z]/g,e=>e.toLowerCase())}function f(t,e){if(!t)return"-";t.toString().length===10&&(t=+t*1e3),e??(e="YYYY-MM-DD HH:mm:ss");const n=new Date(t),r=(i,c,a=" ")=>{if(i.length>=c)return i;const u=c-i.length;let l=Math.ceil(u/a.length);for(;l>>=1;)a+=a,l===1&&(a+=a);return a.slice(0,u)+i};let o;const s={"Y+":n.getFullYear().toString(),"M+":(n.getMonth()+1).toString(),"D+":n.getDate().toString(),"H+":n.getHours().toString(),"m+":n.getMinutes().toString(),"s+":n.getSeconds().toString()};for(const i in s)o=new RegExp("("+i+")").exec(e),o&&(e=e.replace(o[1],o[1].length==1?s[i]:r(s[i],o[1].length,"0")));return e}function X(t,e){`${t}`.length===10?t=parseInt(t+"")*1e3:t=+t;const n=new Date(t),o=(Date.now()-Number(n))/1e3;return o<30?"刚刚":o<3600?`${Math.ceil(o/60)}分钟前`:o<3600*24?`${Math.ceil(o/3600)}小时前`:o<3600*24*2?"1天前":e?f(t,e):`${n.getMonth()+1}月${n.getDate()}日${n.getHours()}时${n.getMinutes()}分`}function K(t){const e=t||new Date,n=new Date(e),r=new Date(e);return n.setHours(0,0,0),r.setHours(23,59,59),{dateRange:[f(n),f(r)],timestampRange:[n.getTime(),r.getTime()]}}const V={set(t,e){sessionStorage&&t&&e&&sessionStorage.setItem(t,e)},get(t){return!sessionStorage||!t?null:sessionStorage.getItem(t)},setJSON(t,e){e&&this.set(t,JSON.stringify(e))},getJSON(t){const e=this.get(t);return e?JSON.parse(e):null},remove(t){sessionStorage.removeItem(t)},clear(){sessionStorage.clear()}},W={set(t,e){localStorage&&t&&e&&localStorage.setItem(t,e)},get(t){return!localStorage||!t?null:localStorage.getItem(t)},setJSON(t,e){e&&this.set(t,JSON.stringify(e))},getJSON(t){const e=this.get(t);return e?JSON.parse(e):null},remove(t){localStorage.removeItem(t)},clear(){localStorage.clear()}};function tt(t,e){if(!t||!e)return;let n=t.className;const r=n.indexOf(e);r===-1?n+=`${e}`:n=n.substring(0,r)+n.substring(r+e.length),t.className=n}function p(t,e){return t.className.match(new RegExp("(?:\\s|^)"+e+"(?:\\s|$)"))}function et(t,e){p(t,e)||(t.className+=` ${e}`)}function nt(t,e){if(p(t,e)){const n=new RegExp("(?:\\s|^)"+e+"(?:\\s|$)");t.className=t.className.replace(n," ")}}function rt(t){let e=!1;return function(...n){e||(e=!0,window.requestAnimationFrame(()=>{t.apply(this,n),e=!1}))}}function ot(t){t&&(t.oncontextmenu=()=>!1)}function st(t){switch(t){case 400:return"请求失败！请您稍后重试";case 401:return"认证失败，无法访问系统资源";case 403:return"当前操作没有权限！";case 404:return"你所访问的资源不存在！";case 405:return"请求方式错误！请您稍后重试";case 408:return"请求超时！请您稍后重试";case 500:return"服务异常！";case 502:return"网关错误！";case 503:return"服务不可用！";case 504:return"网关超时！";default:return"系统未知错误，请反馈给管理员"}}function ct(t){switch(t){case"1":return"是";case"0":return"否";default:return"未填写"}}function it(t){switch(t){case"1":return"有";case"0":return"无";default:return"未填写"}}function at(t,e){const n=t.find(r=>r.value===e);return n?n.label:""}function ut(t,e,n){const r=[],o=e.split(","),s=n.split(",");return Array.from(new Set(o)).forEach(c=>{const a=t.find(u=>u.value===c);a&&s.forEach(u=>{var m;const l=(m=a.children)==null?void 0:m.find(y=>y.value===u);l&&r.push(l)})}),r.map(c=>c.label).join()}function w(t,e,n){var s;if(!e)return"";const r=e.split(","),o=n.find(i=>i.value===r[t]);return o?((s=o.children)!=null&&s.length&&w(t+1,e,o.children),o.label):""}function lt(t,e,n){if(!t)return"";const r=t.split(","),o=[],s=r.length-1,i=r.findIndex(c=>c===n);if(i!==-1){const c=r[s]===n;r.splice(c?0:i,c?s:1)}return r.forEach(c=>{const a=e.find(u=>u.value===c);a&&o.push(a)}),o.map(c=>c.label).join()}function ft(t){let e="";for(const n of Object.keys(t)){const r=t[n],o=`${encodeURIComponent(n)}=`;if(r!==null&&typeof r<"u")if(typeof r=="object"){for(const s of Object.keys(r))if(r[s]!==null&&typeof r[s]<"u"){const i=`${n}[${s}]`,c=`${encodeURIComponent(i)}=`;e+=`${c+encodeURIComponent(r[s])}&`}}else e+=`${o+encodeURIComponent(r)}&`}return e}function dt(t){return t?S(Object.keys(t).map(e=>t[e]===void 0?"":`${encodeURIComponent(e)}=${encodeURIComponent(t[e])}`)).join("&"):""}function gt(t){const e=decodeURIComponent(t.split("?")[1]).replace(/\+/g," ");if(!e)return{};const n={};return e.split("&").forEach(o=>{const s=o.indexOf("=");if(s!==-1){const i=o.substring(0,s),c=o.substring(s+1,o.length);n[i]=c}}),n}const pt=[["date","YYYY-MM-DD"],["daterange","YYYY-MM-DD"],["datetime","YYYY-MM-DD HH:mm:ss"],["datetimerange","YYYY-MM-DD HH:mm:ss"],["month","YYYY-MM"],["monthrange","YYYY-MM"],["year","YYYY"],["yearrange","YYYY"],["time","HH:mm:ss"]],mt=new Map(pt),Y=["jpg","jpeg","png","bmp","gif"],b=["mp3","mp4","webm","ogg","3gp"],T=["doc","docx","xls","xlsx","ppt","txt","pdf","zip"],ht=[...Y,...b,...T],St={DATE_VALUE_FORMAT:mt,IMAGE_TYPE:Y,MEDIA_TYPE:b,DOC_TYPE:T,FILE_TYPE:ht},wt={NOOP:d,debounce:z,creatCancelTask:Z,downloadFile:j,trimArray:S,getFullUrl:h,getArrayFullUrl:q,getGenderByIdNumber:F,getBirthdayByIdNumber:L},Yt={encodeURIToParams:ft,paramsToQueryString:dt,queryStringToParams:gt,errorCodeToString:st,YNToString:ct,HNToString:it,valueToLabel:at,chargeToLabel:ut,cascaderToLabel:w,multipleSelectToLabel:lt},bt={validHttp:E,validExternal:O,validString:R,validNumberStr:x,validEmptyObject:U,validURL:C,validPassword:v,validEmail:P,validIdNumber:g,validPhone:N,validTel:H},Tt={scrollTo:D,addClass:et,removeClass:nt,hasClass:p,toggleClass:tt,noContextmenu:ot,useRafThrottle:rt},yt={local:W,session:V},It={uuid:J,randomNum:k},At={phoneToAsterisk:_,idNumberToAsterisk:B,firstLetterToUpperCase:G,firstLetterToLowerCase:Q},$t={parseTime:f,getTimeDistance:X,getDayRange:K};exports.cacheUtil=yt;exports.commonUtil=wt;exports.constants=St;exports.dateUtil=$t;exports.elementUtil=Tt;exports.randomUtil=It;exports.stringUtil=At;exports.toUtil=Yt;exports.validUtil=bt;

package/lib/index.mjs

@@ -0,0 +1,416 @@
+const I = (t, e, n, r) => (t /= r / 2, t < 1 ? n / 2 * t * t + e : (t--, -n / 2 * (t * (t - 2) - 1) + e)), A = window.requestAnimationFrame || window.webkitRequestAnimationFrame || window.mozRequestAnimationFrame || window.msRequestAnimationFrame || ((t) => window.setTimeout(t, 16.666666666666668));
+function $(t, e) {
+  if (e) {
+    document.querySelector(e).scrollTop = t;
+    return;
+  }
+  document.documentElement.scrollTop = t, document.body.parentNode.scrollTop = t, document.body.scrollTop = t;
+}
+function M(t) {
+  return t ? document.querySelector(t).scrollTop : document.documentElement.scrollTop || document.body.parentNode.scrollTop || document.body.scrollTop;
+}
+function D(t) {
+  const { target: e, to: n = 0, duration: r = 500, callback: o } = t ?? {}, s = M(e), i = n - s, c = 20;
+  let a = 0;
+  const u = function() {
+    a += c;
+    const l = I(a, s, i, r);
+    $(l, e), a < r ? A(u) : o && o();
+  };
+  u();
+}
+function E(t) {
+  return /^(http(s)?:\/\/)/.test(t);
+}
+function x(t) {
+  return /^(https?:|mailto:|tel:)/.test(t);
+}
+function O(t) {
+  return Object.prototype.toString.call(t) === "[object String]";
+}
+function R(t) {
+  return /^[+-]?(0|([1-9]\d*))(\.\d+)?$/g.test(t);
+}
+function C(t) {
+  return !Object.keys(t).length;
+}
+function v(t) {
+  return /^(https?|ftp):\/\/([a-zA-Z0-9.-]+(:[a-zA-Z0-9.&%$-]+)*@)*((25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9][0-9]?)(\.(25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}|([a-zA-Z0-9-]+\.)*[a-zA-Z0-9-]+\.(com|edu|gov|int|mil|net|org|biz|arpa|info|name|pro|aero|coop|museum|[a-zA-Z]{2}))(:[0-9]+)*(\/($|[a-zA-Z0-9.,?'\\+&%$#=~_-]+))*$/.test(t);
+}
+function H(t, e = 8) {
+  return new RegExp(`^S*(?=S{${e}},})(?=S*d)(?=S*[A-Z])(?=S*[a-z])(?=S*[!@#$%^&*?])S*$`).test(t);
+}
+function N(t) {
+  return /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/.test(t);
+}
+function d(t) {
+  return /^\d{6}((((((19|20)\d{2})(0[13-9]|1[012])(0[1-9]|[12]\d|30))|(((19|20)\d{2})(0[13578]|1[02])31)|((19|20)\d{2})02(0[1-9]|1\d|2[0-8])|((((19|20)([13579][26]|[2468][048]|0[48]))|(2000))0229))\d{3})|((((\d{2})(0[13-9]|1[012])(0[1-9]|[12]\d|30))|((\d{2})(0[13578]|1[02])31)|((\d{2})02(0[1-9]|1\d|2[0-8]))|(([13579][26]|[2468][048]|0[048])0229))\d{2}))(\d|X|x)$/.test(t);
+}
+function P(t) {
+  return /^0\d{2,3}-?\d{7,8}$/.test(t);
+}
+function z(t) {
+  return /^1[3-9]\d{9}$/.test(t);
+}
+const g = () => {
+};
+function U(t, e) {
+  let n = null;
+  return function(...r) {
+    n !== null && clearTimeout(n), n = setTimeout(() => {
+      t.apply(this, r), n = null;
+    }, e);
+  };
+}
+function F(t) {
+  if (!d(t))
+    throw new Error("Please provide a valid ID number!");
+  const e = t.length, n = e === 15 ? t[e - 1] : t[e - 2];
+  return parseInt(n) % 2 === 1 ? "1" : "2";
+}
+function L(t) {
+  if (!d(t))
+    throw new Error("Please provide a valid ID number!");
+  return t.substring(6, 10) + "-" + t.substring(10, 12) + "-" + t.substring(12, 14);
+}
+const h = (t, e = "") => {
+  e || (e = globalThis.location.origin);
+  const n = new RegExp(/^http(s)?:\/\//), r = new RegExp(/^((?:[a-z]+:)?\/\/|data:image\/)(.*)/i);
+  return n.test(t) || r.test(t) ? t : e + t;
+}, q = (t, e = "") => {
+  typeof t == "string" && (t = t === "" ? [] : t.split(","));
+  for (const n in t)
+    t[n] = h(t[n], e);
+  return t;
+};
+function Z(t) {
+  let e = g;
+  return (...n) => new Promise((r, o) => {
+    e(), e = () => {
+      r = o = g;
+    }, t(...n).then(
+      (s) => r(s),
+      (s) => o(s)
+    );
+  });
+}
+function j(t, e) {
+  const n = document.createElement("a");
+  n.download = e, n.href = t, n.click();
+}
+function S(t) {
+  const e = [];
+  for (let n = 0; n < t.length; n++)
+    t[n] && e.push(t[n]);
+  return e;
+}
+function k(t, e) {
+  switch (arguments.length) {
+    case 1:
+      return parseInt((Math.random() * t + 1).toString(), 10);
+    case 2:
+      return parseInt((Math.random() * (e - t + 1) + t).toString(), 10);
+    default:
+      return 0;
+  }
+}
+function J() {
+  let t = "";
+  const e = [];
+  for (let n = 0; n <= 15; n++)
+    e[n] = n.toString(16);
+  for (let n = 1; n <= 36; n++)
+    n === 9 || n === 14 || n === 19 || n === 24 ? t += "-" : n === 15 ? t += 4 : n === 20 ? t += e[Math.random() * 4 | 8] : t += e[Math.random() * 16 | 0];
+  return t;
+}
+function _(t) {
+  return t ? t.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2") : "";
+}
+function B(t, e, n) {
+  if (e ?? (e = 4), n ?? (n = 4), t) {
+    const r = t.length;
+    return t.substring(0, e) + "*".repeat(r - e - n) + t.substring(r - n);
+  }
+  return "";
+}
+function G(t) {
+  return t.replace(/( |^)[a-z]/g, (e) => e.toUpperCase());
+}
+function Q(t) {
+  return t.replace(/( |^)[A-Z]/g, (e) => e.toLowerCase());
+}
+function f(t, e) {
+  if (!t) return "-";
+  t.toString().length === 10 && (t = +t * 1e3), e ?? (e = "YYYY-MM-DD HH:mm:ss");
+  const n = new Date(t), r = (i, c, a = " ") => {
+    if (i.length >= c) return i;
+    const u = c - i.length;
+    let l = Math.ceil(u / a.length);
+    for (; l >>= 1; )
+      a += a, l === 1 && (a += a);
+    return a.slice(0, u) + i;
+  };
+  let o;
+  const s = {
+    "Y+": n.getFullYear().toString(),
+    "M+": (n.getMonth() + 1).toString(),
+    "D+": n.getDate().toString(),
+    "H+": n.getHours().toString(),
+    "m+": n.getMinutes().toString(),
+    "s+": n.getSeconds().toString()
+  };
+  for (const i in s)
+    o = new RegExp("(" + i + ")").exec(e), o && (e = e.replace(o[1], o[1].length == 1 ? s[i] : r(s[i], o[1].length, "0")));
+  return e;
+}
+function X(t, e) {
+  `${t}`.length === 10 ? t = parseInt(t + "") * 1e3 : t = +t;
+  const n = new Date(t), o = (Date.now() - Number(n)) / 1e3;
+  return o < 30 ? "刚刚" : o < 3600 ? `${Math.ceil(o / 60)}分钟前` : o < 3600 * 24 ? `${Math.ceil(o / 3600)}小时前` : o < 3600 * 24 * 2 ? "1天前" : e ? f(t, e) : `${n.getMonth() + 1}月${n.getDate()}日${n.getHours()}时${n.getMinutes()}分`;
+}
+function K(t) {
+  const e = t || /* @__PURE__ */ new Date(), n = new Date(e), r = new Date(e);
+  return n.setHours(0, 0, 0), r.setHours(23, 59, 59), {
+    dateRange: [f(n), f(r)],
+    timestampRange: [n.getTime(), r.getTime()]
+  };
+}
+const V = {
+  set(t, e) {
+    sessionStorage && t && e && sessionStorage.setItem(t, e);
+  },
+  get(t) {
+    return !sessionStorage || !t ? null : sessionStorage.getItem(t);
+  },
+  setJSON(t, e) {
+    e && this.set(t, JSON.stringify(e));
+  },
+  getJSON(t) {
+    const e = this.get(t);
+    return e ? JSON.parse(e) : null;
+  },
+  remove(t) {
+    sessionStorage.removeItem(t);
+  },
+  clear() {
+    sessionStorage.clear();
+  }
+}, W = {
+  set(t, e) {
+    localStorage && t && e && localStorage.setItem(t, e);
+  },
+  get(t) {
+    return !localStorage || !t ? null : localStorage.getItem(t);
+  },
+  setJSON(t, e) {
+    e && this.set(t, JSON.stringify(e));
+  },
+  getJSON(t) {
+    const e = this.get(t);
+    return e ? JSON.parse(e) : null;
+  },
+  remove(t) {
+    localStorage.removeItem(t);
+  },
+  clear() {
+    localStorage.clear();
+  }
+};
+function tt(t, e) {
+  if (!t || !e)
+    return;
+  let n = t.className;
+  const r = n.indexOf(e);
+  r === -1 ? n += `${e}` : n = n.substring(0, r) + n.substring(r + e.length), t.className = n;
+}
+function p(t, e) {
+  return t.className.match(new RegExp("(?:\\s|^)" + e + "(?:\\s|$)"));
+}
+function et(t, e) {
+  p(t, e) || (t.className += ` ${e}`);
+}
+function nt(t, e) {
+  if (p(t, e)) {
+    const n = new RegExp("(?:\\s|^)" + e + "(?:\\s|$)");
+    t.className = t.className.replace(n, " ");
+  }
+}
+function rt(t) {
+  let e = !1;
+  return function(...n) {
+    e || (e = !0, window.requestAnimationFrame(() => {
+      t.apply(this, n), e = !1;
+    }));
+  };
+}
+function ot(t) {
+  t && (t.oncontextmenu = () => !1);
+}
+function st(t) {
+  switch (t) {
+    case 400:
+      return "请求失败！请您稍后重试";
+    case 401:
+      return "认证失败，无法访问系统资源";
+    case 403:
+      return "当前操作没有权限！";
+    case 404:
+      return "你所访问的资源不存在！";
+    case 405:
+      return "请求方式错误！请您稍后重试";
+    case 408:
+      return "请求超时！请您稍后重试";
+    case 500:
+      return "服务异常！";
+    case 502:
+      return "网关错误！";
+    case 503:
+      return "服务不可用！";
+    case 504:
+      return "网关超时！";
+    default:
+      return "系统未知错误，请反馈给管理员";
+  }
+}
+function ct(t) {
+  switch (t) {
+    case "1":
+      return "是";
+    case "0":
+      return "否";
+    default:
+      return "未填写";
+  }
+}
+function it(t) {
+  switch (t) {
+    case "1":
+      return "有";
+    case "0":
+      return "无";
+    default:
+      return "未填写";
+  }
+}
+function at(t, e) {
+  const n = t.find((r) => r.value === e);
+  return n ? n.label : "";
+}
+function ut(t, e, n) {
+  const r = [], o = e.split(","), s = n.split(",");
+  return Array.from(new Set(o)).forEach((c) => {
+    const a = t.find((u) => u.value === c);
+    a && s.forEach((u) => {
+      var m;
+      const l = (m = a.children) == null ? void 0 : m.find((y) => y.value === u);
+      l && r.push(l);
+    });
+  }), r.map((c) => c.label).join();
+}
+function w(t, e, n) {
+  var s;
+  if (!e) return "";
+  const r = e.split(","), o = n.find((i) => i.value === r[t]);
+  return o ? ((s = o.children) != null && s.length && w(t + 1, e, o.children), o.label) : "";
+}
+function lt(t, e, n) {
+  if (!t) return "";
+  const r = t.split(","), o = [], s = r.length - 1, i = r.findIndex((c) => c === n);
+  if (i !== -1) {
+    const c = r[s] === n;
+    r.splice(c ? 0 : i, c ? s : 1);
+  }
+  return r.forEach((c) => {
+    const a = e.find((u) => u.value === c);
+    a && o.push(a);
+  }), o.map((c) => c.label).join();
+}
+function ft(t) {
+  let e = "";
+  for (const n of Object.keys(t)) {
+    const r = t[n], o = `${encodeURIComponent(n)}=`;
+    if (r !== null && typeof r < "u")
+      if (typeof r == "object") {
+        for (const s of Object.keys(r))
+          if (r[s] !== null && typeof r[s] < "u") {
+            const i = `${n}[${s}]`, c = `${encodeURIComponent(i)}=`;
+            e += `${c + encodeURIComponent(r[s])}&`;
+          }
+      } else
+        e += `${o + encodeURIComponent(r)}&`;
+  }
+  return e;
+}
+function gt(t) {
+  return t ? S(
+    Object.keys(t).map((e) => t[e] === void 0 ? "" : `${encodeURIComponent(e)}=${encodeURIComponent(t[e])}`)
+  ).join("&") : "";
+}
+function dt(t) {
+  const e = decodeURIComponent(t.split("?")[1]).replace(/\+/g, " ");
+  if (!e)
+    return {};
+  const n = {};
+  return e.split("&").forEach((o) => {
+    const s = o.indexOf("=");
+    if (s !== -1) {
+      const i = o.substring(0, s), c = o.substring(s + 1, o.length);
+      n[i] = c;
+    }
+  }), n;
+}
+const pt = [
+  ["date", "YYYY-MM-DD"],
+  ["daterange", "YYYY-MM-DD"],
+  ["datetime", "YYYY-MM-DD HH:mm:ss"],
+  ["datetimerange", "YYYY-MM-DD HH:mm:ss"],
+  ["month", "YYYY-MM"],
+  ["monthrange", "YYYY-MM"],
+  ["year", "YYYY"],
+  ["yearrange", "YYYY"],
+  ["time", "HH:mm:ss"]
+], mt = new Map(pt), Y = ["jpg", "jpeg", "png", "bmp", "gif"], T = ["mp3", "mp4", "webm", "ogg", "3gp"], b = ["doc", "docx", "xls", "xlsx", "ppt", "txt", "pdf", "zip"], ht = [...Y, ...T, ...b], St = { DATE_VALUE_FORMAT: mt, IMAGE_TYPE: Y, MEDIA_TYPE: T, DOC_TYPE: b, FILE_TYPE: ht }, wt = {
+  NOOP: g,
+  debounce: U,
+  creatCancelTask: Z,
+  downloadFile: j,
+  trimArray: S,
+  getFullUrl: h,
+  getArrayFullUrl: q,
+  getGenderByIdNumber: F,
+  getBirthdayByIdNumber: L
+}, Yt = {
+  encodeURIToParams: ft,
+  paramsToQueryString: gt,
+  queryStringToParams: dt,
+  errorCodeToString: st,
+  YNToString: ct,
+  HNToString: it,
+  valueToLabel: at,
+  chargeToLabel: ut,
+  cascaderToLabel: w,
+  multipleSelectToLabel: lt
+}, Tt = {
+  validHttp: E,
+  validExternal: x,
+  validString: O,
+  validNumberStr: R,
+  validEmptyObject: C,
+  validURL: v,
+  validPassword: H,
+  validEmail: N,
+  validIdNumber: d,
+  validPhone: z,
+  validTel: P
+}, bt = { scrollTo: D, addClass: et, removeClass: nt, hasClass: p, toggleClass: tt, noContextmenu: ot, useRafThrottle: rt }, yt = { local: W, session: V }, It = { uuid: J, randomNum: k }, At = { phoneToAsterisk: _, idNumberToAsterisk: B, firstLetterToUpperCase: G, firstLetterToLowerCase: Q }, $t = { parseTime: f, getTimeDistance: X, getDayRange: K };
+export {
+  yt as cacheUtil,
+  wt as commonUtil,
+  St as constants,
+  $t as dateUtil,
+  bt as elementUtil,
+  It as randomUtil,
+  At as stringUtil,
+  Yt as toUtil,
+  Tt as validUtil
+};

package/lib/types/index.d.ts

@@ -0,0 +1,23 @@
+export type Fn<T = any, R = T> = {
+    (...arg: T[]): R;
+};
+export type PromiseFn<T = any, R = T> = {
+    (...arg: T[]): Promise<R>;
+};
+export type AnyObj<T = any> = {
+    [key: string]: T;
+};
+export type Nullable<T> = T | null;
+export type Writable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+export type TimeoutHandle = ReturnType<typeof setTimeout>;
+export type IntervalHandle = ReturnType<typeof setInterval>;
+export type OptionType = {
+    value: string | number;
+    label: string;
+};
+export type CategoryType = {
+    id?: string | number;
+    children?: CategoryType[];
+} & OptionType;

package/lib/utils/cache.d.ts

@@ -0,0 +1,17 @@
+import { AnyObj } from '../types';
+export declare const session: {
+    set(key: string, value: string): void;
+    get(key: string): string | null;
+    setJSON(key: string, jsonValue: AnyObj): void;
+    getJSON(key: string): AnyObj | null;
+    remove(key: string): void;
+    clear(): void;
+};
+export declare const local: {
+    set(key: string, value: string): void;
+    get(key: string): string | null;
+    setJSON(key: string, jsonValue: AnyObj): void;
+    getJSON(key: string): AnyObj | null;
+    remove(key: string): void;
+    clear(): void;
+};

package/lib/utils/common.d.ts

@@ -0,0 +1,22 @@
+import { PromiseFn } from '../types';
+export declare const NOOP: () => void;
+export declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Gets the gender of the person from the given ID number.
+ * @param idNumber the ID number
+ * @returns the gender of the person, '1' for male, '2' for female
+ * @throws error if the given ID number is invalid
+ */
+export declare function getGenderByIdNumber(idNumber: string): "1" | "2";
+/**
+ * Gets the birthday of the person from the given ID number.
+ * @param idNumber the ID number
+ * @returns the birthday of the person in the format 'YYYY-MM-DD'
+ * @throws error if the given ID number is invalid
+ */
+export declare function getBirthdayByIdNumber(idNumber: string): string;
+export declare const getFullUrl: (relativeUrl: string, domain?: string) => string;
+export declare const getArrayFullUrl: (relativeUrls: string | string[], domain?: string) => string[];
+export declare function creatCancelTask(asyncTask: PromiseFn): (...args: any[]) => Promise<unknown>;
+export declare function downloadFile(url: string, name: string): void;
+export declare function trimArray<T>(actual: Array<T>): Array<T>;

package/lib/utils/date.d.ts

@@ -0,0 +1,6 @@
+export declare function parseTime(dateTime?: string | number | Date | null, format?: string): string;
+export declare function getTimeDistance(time: number, option: string): string;
+export declare function getDayRange(date?: string | number | Date): {
+    dateRange: [string, string];
+    timestampRange: [number, number];
+};

package/lib/utils/element.d.ts

@@ -0,0 +1,6 @@
+export declare function toggleClass(element: Element, className: string): void;
+export declare function hasClass(ele: Element, cls: string): RegExpMatchArray | null;
+export declare function addClass(ele: Element, cls: string): void;
+export declare function removeClass(ele: Element, cls: string): void;
+export declare function useRafThrottle(fn: Function): (...args: any[]) => void;
+export declare function noContextmenu(ele: HTMLElement): void;

package/lib/utils/random.d.ts

@@ -0,0 +1,2 @@
+export declare function randomNum(min: number, max: number): number;
+export declare function uuid(): string;

package/lib/utils/scroll.d.ts

@@ -0,0 +1,6 @@
+export default function scrollTo(options?: {
+    target?: string;
+    to?: number;
+    duration?: number;
+    callback?: Function;
+}): void;

package/lib/utils/string.d.ts

@@ -0,0 +1,4 @@
+export declare function phoneToAsterisk(phone?: string): string;
+export declare function idNumberToAsterisk(idNumber?: string, startLength?: number, endLength?: number): string;
+export declare function firstLetterToUpperCase(str: string): string;
+export declare function firstLetterToLowerCase(str: string): string;

package/lib/utils/to.d.ts

@@ -0,0 +1,11 @@
+import { AnyObj, CategoryType } from '../types';
+export declare function errorCodeToString(code: number): string;
+export declare function YNToString(value?: string | null): "是" | "否" | "未填写";
+export declare function HNToString(value?: string | null): "未填写" | "有" | "无";
+export declare function valueToLabel(data: CategoryType[], value?: string): string;
+export declare function chargeToLabel(data: CategoryType[], type: string, charge: string): string;
+export declare function cascaderToLabel(index: number, value: string | undefined, data: CategoryType[]): string;
+export declare function multipleSelectToLabel(value: string | undefined, data: CategoryType[], str?: string): string;
+export declare function encodeURIToParams(params: AnyObj): string;
+export declare function paramsToQueryString(json: AnyObj): string;
+export declare function queryStringToParams(url: string): AnyObj;

package/lib/utils/valid.d.ts

@@ -0,0 +1,18 @@
+import { AnyObj } from '../types';
+export declare function validHttp(http: string): boolean;
+export declare function validExternal(str: string): boolean;
+export declare function validString(str: string): boolean;
+export declare function validNumberStr(str: string): boolean;
+export declare function validEmptyObject(object: AnyObj): boolean;
+export declare function validURL(url: string): boolean;
+/**
+ * Validate the password strength
+ * @param {string} password The password to be validated
+ * @param {number} [minLength=8] The minimum length of the password，The default value is 8
+ * @returns {boolean} Whether the password is valid
+ */
+export declare function validPassword(password: string, minLength?: number): boolean;
+export declare function validEmail(email: string): boolean;
+export declare function validIdNumber(idNumber: string): boolean;
+export declare function validTel(tel: string): boolean;
+export declare function validPhone(phone: string): boolean;

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@nano-lib/util",
+  "version": "1.0.5",
+  "description": "Custom utility functions for the nano library",
+  "author": "kevin chen",
+  "license": "MIT",
+  "main": "lib/index.js",
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs",
+      "require": "./lib/index.js"
+    }
+  },
+  "files": [
+    "package.json",
+    "README.md",
+    "LICENSE",
+    "lib"
+  ],
+  "scripts": {
+    "lib": "rimraf lib && vite build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.17",
+    "@typescript-eslint/eslint-plugin": "^8.29.0",
+    "@typescript-eslint/parser": "^8.29.0",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.2",
+    "vite": "^6.0.5",
+    "vite-plugin-dts": "^4.5.3"
+  },
+  "packageManager": "pnpm@9.1.3",
+  "keywords": [
+    "nano-lib"
+  ]
+}