@bestime/utils_base 1.0.5 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,5 @@
1
+ /**
2
+ * 纯JS工具库 => jUtilsBase
3
+ * @update 2024-06-12 15:01:25
4
+ */
5
+ !function(n,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((n="undefined"!=typeof globalThis?globalThis:n||self).jUtilsBase={})}(this,function(n){"use strict";var t=["A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"],o="Array",u="Object",c="String",I="Number",m=void 0,L="false",q="true",V=Object.prototype.toString,e=encodeURI,a=decodeURIComponent;function h(n){return null===n||n===m}function f(n){return h(n)?"":String(n)}function l(n){return V.call(n).slice(8,-1)}function d(n){return l(n)===o}function s(n){return l(n)===u}function v(n){return l(n)===c}function p(n,t){var r;try{r=JSON.parse(n)}catch(e){r=t}return r}function g(n){return n=s(n)||s(n=p(n))?n:{}}function y(n){return h(n)||""===n}function _(n){return"function"==typeof n}function A(n){var r=[];function a(n,t){null!=n&&""!==n&&(t=null==(t=_(t)?t():t)?"":t,r[r.length]=e(n)+"="+e(t))}return function i(n,t){var r,e;if(n)switch(l(t)){case o:for(r=0;r<t.length;r++)i(n+"["+("object"==typeof t[r]&&t[r]?r:"")+"]",t[r]);break;case u:for(e in t)i(n+"["+e+"]",t[e]);break;default:a(n,t)}else switch(l(t)){case c:case u:for(e in t)i(e,t[e]);break;case o:for(r=0;r<t.length;r++)a(t[r].name,t[r].value)}}("",n),r.join("&")}function b(n){return n=d(n)||d(n=p(n))?n:[]}function w(n){return n=Number(n),Math.abs(n)===Math.abs(Infinity)||isNaN(n)?0:n}var D=[m,m];function B(n){if(n==m)return D;var e,a=n;return n.replace(/^\[(.*?)\](.*)?/,function(n,t,r){return a=t,e=r,""}),[a,e]}function K(n){return""===n||/^\d+$/.test(n)}function r(n){var o={},u=!1,e="";return(n=h(n)?"":n).replace(/([^=&?/#]*?)=([^=&?/#]*)/g,function(n,t,i){var r;r=a(i),i=null==r?m:L!==r&&(q===r||p(r,r)),e=a(t),u=!1,""!==e&&(e.replace(/(.*?)(\[.*)/,function(n,t,r){var e=B(r);u=!0,K(e[0])?o[t]=b(o[t]):o[t]=g(o[t]),function a(n,t,r){var t=B(t),e=t[0];K(e)?(e=w(e),t[1]==m?n.push(r):(/^\[[\D]+\]/.test(t[1])?n[e]=g(n[e]):n[e]=b(n[e]),a(n[e],t[1],r))):t[1]==m?n[e]=r:(/^\[[\D]+\]/.test(t[1])?n[e]=g(n[e]):n[e]=b(n[e]),a(n[e],t[1],r))}(o[t],r,i)}),u||(o[e]=i))}),o}var i="[\\s\\uFEFF\\xA0]+";function E(n,t){var r=l(n),e=(r===I&&(n=String(n),r=c),"");if(r!==c)return"";switch(t){case 1:e="^"+i;break;case-1:e=i+"$";break;case"*":e=i;break;default:e="^"+i+"|"+i+"$"}return n.replace(new RegExp(e,"g"),"")}function S(n){switch(l(n)){case o:for(var t=[],r=0;r<n.length;r++)t.push(S(n[r]));break;case u:for(var e in t={},n)t[e]=S(n[e]);break;case"Function":function a(){n.apply(this,arguments)}for(var i in n.prototype)a.prototype[i]=n.prototype[i];t=a;break;default:t=n}return t}function U(n,t){var r=!1;return r=d(n)&&t.array&&0===n.length||s(n)&&t.kvPair&&function(n){var t,r=!0;for(t in n)if(t!==m){r=!1;break}return r}(n)||v(n)&&t.string&&""===n||h(n)?!0:r}function k(n,t,r){var e;r=null==r?60:r,n()?t():(clearTimeout(e),setTimeout(function(){k(n,t,r)},r))}k["async"]=function(t,r){return new Promise(function(n){k(t,n,r)})};var Z={id:"id",children:"children"};function G(n){var t=!1;return"boolean"==typeof n||d(n)||null==n||""===n||(n=Number(n),t=!isNaN(n)&&Infinity!=Math.abs(n)),t}function R(n,t){return h(n)?t:n}function W(n,t){var r="";if((n=f(n)).length*t<1<<28)for(;1==(1&t)&&(r+=n),0!=(t>>>=1);)n+=n;return r}function z(n,t,r,e){return(n=f(n)).length>(t>>=0)?n:(t-=n.length,r.length<t&&(r+=W(r,t/r.length)),-1===e?r.slice(0,t)+n:n+r.slice(0,t))}function x(n,t,r){return z(n,t,r,1)}function T(n,t){return""!==n?n.split(t):[]}function C(n,r,t){var e,a,i=h(t)?"children":t;return function o(n){if(n)for(var t=0;t<n.length;t++){if(a=r(n[t])){e=n[t];break}if(o(n[t][i]),a)break}}(n),e}function P(n,t,r){r=!1===r?0:1;return n=Math.random()*(t-n+r)+n,r?Math.floor(n):n}function F(){return t[P(0,t.length-1)][0]}var N={};function H(n,t){}function J(n,t,r,e){if(n="【"+n+"】",r&&y(t))throw"字段"+n+"不能为空";if(l(t)!==e)switch(e){case"String":t=String(t);break;case"Number":if(!G(t))throw"字段"+n+"必须为数字";t=Number(t)}return t}var Q={number:function(n,t){return J(n,t,!(2<arguments.length&&arguments[2]!==undefined)||arguments[2],"Number")},string:function(n,t){return J(n,t,2<arguments.length&&arguments[2]!==undefined&&arguments[2],"String")}};function O(n){return Array.from(new Set(n))}var X=function(n,t){return Number(n)-Number(t)},Y=0,$={};function nn(n,t){var r=[],e=[];return n.forEach(function(n){n=t[n],$[n]||($[n]={id:++Y,label:n});n=$[n];r.push(n.id),e.push(n.label)}),{id:r.join("_"),label:e.join("→")}}function tn(n,t){return n===m||t===m?m:(t-n)/n}function M(n,t){var r,e={},a=-1;for(r in n)a++,e[r]=t(n[r],r,a);return e}function rn(n){return n.map(function(n,t){return{value:n,index:t}})}function j(n,t){return 0===n||h(n)?0:0===t||h(t)?1:n/t}function en(n,r,e){var a=[];return n.forEach(function(t){r.some(function(n){return e(n,t)})||a.push(t)}),r.forEach(function(t){n.some(function(n){return e(n,t)})||a.some(function(n){return e(n,t)})||a.push(t)}),a}var an="sys-row-avg";function on(n,t){var u={},r=t.colField;if(!h(r)&&n.length){var a=t.cellSummary;if(n.forEach(function(n){var t=n[r];u[t]=u[t]||{data:[],summary:0,_collect:[]},u[t].data.push(n),a&&(n=n[a.numerator[0]],u[t].summary+=n,u[t]._collect.push(n))}),!h(a)){var e,i,o;for(e in u)!function(n){var t=u[n],r=1,e=a.denominator;if(e)switch(e[1]){case"length":r=t.data.map(function(n){return n[e[0]]}).length;break;case"uniqLength":r=O(t.data.map(function(n){return n[e[0]]})).length}switch(a.numerator[1]){case"sum":h(t.summary)||(t.summary=t.summary/r);break;case"length":t.summary=t._collect.length/r;break;case"uniqLength":t.summary=O(t._collect).length/r}}(e);o=i=0,M(u,function(n){i++;n=h(n.summary)?0:n.summary;o+=n}),u[an]={data:[],summary:o/i,_collect:[]},t.colCustom&&M(t.colCustom,function(n,t){var r=c(n.numerator),n=n.denominator?c(n.denominator):1;u[t]={data:[],summary:j(r,n),_collect:[]}})}}return u;function c(i){var o=0,n=Object.keys(u).filter(function(n){var t=[an].includes(n),n="*"===i[1]||i[1].includes(n);return!t&&n});return d(i[1])&&n.sort(function(n,t){return i[1].indexOf(n)-i[1].indexOf(t)}),n.forEach(function(n,t){var r,e,n=u[n],a=0;h(i[2])||"value"===i[2]?a=h(n.summary)?0:n.summary:"length"===i[2]?(r=i[3])&&(a=n.data.map(function(n){return n[r]}).length):"uniqLength"===i[2]&&(e=i[3])&&(a=O(n.data.map(function(n){return n[e]})).length),"sum"===i[0]?o+=a:"max"===i[0]?o=Math.max(o,a):"diff"===i[0]&&(0===t?o=a:o-=a)}),o}}function un(n,u){var t={},c=0;!function l(n,t,r){for(var e=0;e<t.length;e++){var a=t[e],i=function(n,t){var r=[];return d(n)?n.forEach(function(n){r.push(t[n])}):r.push(t[n]),r.join("→")}(u.path[c].field,a);n[i]=n[i]||{uidPath:r.concat(i),uid:i,data:[],child:{}},n[i].data.push(a)}if(c<u.path.length-1)for(var o in c++,n)l(n[o].child,n[o].data,n[o].uidPath)}(t,n,[]);var n=function s(n,t,r,e){var a,i=[];for(a in n){var o=t===r,u=s(n[a].child,t,r+1,e);i.push({uidPath:n[a].uidPath,uid:n[a].uid,data:n[a].data,_columnRiseRatio:{},_columnTotal:{},_columnProportion:{},_columns:on(n[a].data,e),isLeaf:o,children:u})}return i}(t,c,0,u),e=(!function a(n,t){var r;n.sort(null==(r=u.path[t])?void 0:r.sort),n.forEach(function(n){a(n.children,t+1)})}(n,0),!function i(n){n.forEach(function(n){var r={};M(n._columns,function(n,t){n=h(n.summary)?0:n.summary;r[t]=r[t]||0,r[t]+=n}),n._columnTotal=r,i(n.children)})}(n),{}),f=(n.forEach(function(r){M(r._columns,function(n,t){e[t]=e[t]||0,e[t]+=r._columnTotal[t]})}),[]);return u.colCustom&&M(u.colCustom,function(n,t){n.riseRatio||f.push(t)}),function r(n){var i={},o={};n.forEach(function(n,a){M(n._columns,function(n,t){var r,e;f.includes(t)||(0<a?h(r=n.summary)?o[t]=m:(e=null!=(e=i[t])?e:0,o[t]=j(r-e,e)):o[t]=void 0,i[t]=n.summary)}),n._columnRiseRatio=o,r(n.children)})}(n),function o(n,e){n.forEach(function(n,t){var r={};M(n._columns,function(n,t){r[t]=j(n.summary,e[t])}),n._columnProportion=r,o(n.children,n._columnTotal)})}(n,e),{data:n,total:e}}var cn=[[1e4,"万"],[1e8,"亿"]];n.Polling=function(){function n(n){this._timer=void 0,this._timer_info=void 0,this._stamp=0,this._passStamp=0,this._option=void 0,this._option=Object.assign({timeout:6e3,interval:1e3,handler:H},n),this._next=this._next.bind(this),this._doOnce=this._doOnce.bind(this),this.done=this.done.bind(this)}var t=n.prototype;return t._next=function(){return clearInterval(this._timer),this._passStamp=+new Date-this._stamp,this._timer=setTimeout(this._doOnce,this._option.interval),this},t._doOnce=function(){if(this._passStamp>=this._option.timeout)return this._option.onMessage&&this._option.onMessage(0),this.done(),this;this._option.handler(this._next,this.done)},t.start=function(){var n,t=this;this._stamp=+new Date,this.done(),this._doOnce();return this._option.onMessage&&(clearInterval(this._timer_info),this._timer_info=setInterval(function(){n=+new Date-t._stamp,0===(n=Math.max(t._option.timeout-n,0))&&t.done(),t._option.onMessage(n)},100)),this},t.done=function(){return clearTimeout(this._timer),clearTimeout(this._timer_info),this},t.dispose=function(){return this.done(),this},n}(),n._Array=b,n._Boolean=function(n){return!0===n||"true"===n||"1"===n||1===n},n._KvPair=g,n._Number=w,n._String=f,n.arrayRowToColumn=function(n,a){var t,r=[],i=(n.forEach(function(n){n=String(n[a.colField]);r.includes(n)||r.push(n)}),r.sort(null!=(c=a.colSort)?c:X),{}),s=(n.forEach(function(t){var n=nn(a.uniqueRowId,t),r={},e=(a.uniqueRowId.forEach(function(n){r[n]=t[n]}),i[n.id]=i[n.id]||{value:r,name:n.label,data:{}},a.colCreate(t[a.colField]).field);i[n.id].data[e]=i[n.id].data[e]||[],i[n.id].data[e].push(t)}),[]);for(t in i)s.push({name:i[t].name,value:i[t].value,data:i[t].data,summary:{}});var o,u,e,c=r.map(function(n){var t=a.colCreate(n);return{value:n,label:t.label,field:t.field}}),h={};return a.summaryConfig&&(a.summaryConfig.row&&(o=s,u=a.summaryConfig.row,e=a.summaryConfig.averageField,o.forEach(function(c){var f=u[c.name];if(f){var l,n,s=0,h=0;for(n in c.data)!function(n){h++;var t,r=[],e=0,a=[],i=[],o=(c.data[n].forEach(function(n){r.push(n[f.count.field]);var t=w(n[f.value.field]);switch(f.value.mode){case"uniqLength":a.push(n[f.value.field]),a=O(a),e=a.length;break;case"sum":case"avg":e+=t}0!==t&&i.push(t)}),0);switch(f.count.mode){case"length":o=r.length;break;case"uniqLength":o=O(r).length;break;case"notZeroValue":o=i.length}var u=e;"avg"===f.value.mode&&(u=e/o),s+=u,c.summary[n]={value:u,proportion:0,riseRatio:l?tn(null==(t=c.summary[l])?void 0:t.value,u):void 0},l=n}(n);c.summary[e]={value:s/h,riseRatio:m,proportion:0}}}),o.forEach(function(n){var t=u[n.name];if(t){var r=o.find(function(n){return n.name===t.proportionBaseField});if(t.proportionBaseField&&r)for(var e in n.summary)n.summary[e].proportion=n.summary[e].value/r.summary[e].value}}),s=o),a.summaryConfig.column&&(h=function(f,l,s){var n,h={},d={},t=function(a){d[a]={},h[a]={};var n,i=l[a],t=(f.forEach(function(e){for(var n in e.data)!function(n){h[a][n]=h[a][n]||{data:[],sum:0};var t=[],r=0;switch(e.data[n].forEach(function(n){switch(t.push(n[i.field]),i.mode){case"uniqLength":t=O(t);break;case"avg":case"sum":r+=n[i.field];break;case"notZeroLength":0!==w(n[i.field])&&r++}}),i.mode){case"uniqLength":t=O(t);break;case"avg":r/=e.data[n].length}h[a][n].data=h[a][n].data.concat(t),h[a][n].sum+=r}(n)}),void 0);for(n in h[a]){var r,e=0;switch(i.mode){case"avg":e=h[a][n].sum/f.length;break;case"uniqLength":e=h[a][n].data.length;break;case"notZeroLength":case"sum":e=h[a][n].sum}d[a][n]={value:e,proportion:0,riseRatio:t?tn(null==(r=d[a][t])?void 0:r.value,e):void 0},t=n}var o,u=0,c=0;for(o in d[a])u+=d[a][o].value,c++;d[a][s]={value:u/c,riseRatio:m,proportion:0}};for(n in l)t(n);return d}(s,a.summaryConfig.column,a.summaryConfig.averageField))),{columns:c,data:s,colSummary:h,getExtRow:function(t,n,r){var e,a=s.find(function(n){return n.name===t}),i={};if(!a){var o=n,u=r,c=h[t],f={};if(c)for(var l in c)f[l]=u(c[l][o]);return f}for(e in a.summary)i[e]=r(a.summary[e][n]);return i}}},n.changeIndex=function(n,t,r){return n<0?t:((t=(t+r)%(n+=1))<0&&(t+=n),-0===t?0:t)},n.cloneEasy=S,n.dataPage=function(n,t,r){if(r<1)throw"页码必须大于0";var e=(r-1)*t,a=e+t;return{current:r,total:n.length,size:t,pages:Math.ceil(n.length/t),data:S(n.slice(e,a))}},n.deepFindItem=C,n.deepFindTreePath=function(n,t,r){r=Object.assign(Z,r);for(var e=[],a=S(n),i=new Set,o=r["children"];a.length;){var u=a[0];if(i.has(u))e.pop(),a.shift();else if(i.add(u),u[o]&&a.unshift.apply(a,u[o]),e.push(u),t(u))return e}return undefined},n.defaultValue=R,n.defineEventBus=function(a){if(N[a])throw'"'+a+'" Has already been registered!';return N[a]=N[a]||[],{on:function(n){N[a].push(n)},emit:function(){for(var n=arguments.length,t=new Array(n),r=0;r<n;r++)t[r]=arguments[r];for(var e=0;e<N[a].length;e++)N[a][e].apply(m,t)},off:function(n){if(!n)throw"the hander of off is required!";for(var t=0;t<N[a].length;t++)N[a][t]===n&&N[a].splice(t--,1)},dispose:function(){for(var n=0;n<N[a].length;n++)N[a].splice(n--,1);delete N[a]}}},n.fieldCheck=Q,n.filterWithMove=function(n,t){for(var r=[],e=0;e<n.length;e++){var a=n[e];t(a,e,n)&&(r.push(a),n.splice(e--,1))}return r},n.flatTree=function(n,e){var a=[];return e=R(e,"children"),function i(n){if(d(n))for(var t,r=0;r<n.length;r++)t=n[r],a.push(t),i(t[e])}(n),a},n.floorFixed=function(n,t,r){var e=(n=T(n=E(w(n)),"."))[1]||"";return e.length<t&&(e=x(e,t,"0"),r&&(e=e.replace(/0+$/,""))),t<1||!e?n[0]:n[0]+"."+e.substring(0,t)},n.forEach=function(n,t){for(var r=0;r<n.length;r++)t(n[r],r,n)},n.forEachKvPair=M,n.forEachTree=function(n,a,i){i=i||"children",function o(n,t){for(var r=0;r<n.length;r++){var e=S(t);a(n[r],e),d(n[r][i])&&(e.push(n[r]),o(n[r][i],e))}}(n,[])},n.getRandom=P,n.getRatio=j,n.getSortIndex=function(n,r){var t=rn(n),e=rn(n);return e.sort(function(n,t){return r(n.value,t.value)}),t.map(function(t){return e.findIndex(function(n){return t.index===n.index})})},n.getType=l,n.isArray=d,n.isEmpty=y,n.isFunction=_,n.isFuzzyMatch=function(n,t,r){var e=!0;return(n=E(n,"*"))&&(n=T(n,"").join(".*"),e=new RegExp(n,f(r)).test(t)),e},n.isKvPair=s,n.isLikeNumber=G,n.isNull=h,n.isString=v,n.listGroup=function(n,t){var l=un(n,t);function i(n,t,r,e,a){var i=C(l.data,function(n){return 0===en(n.uidPath,t,function(n,t){return n===t}).length}),o=R(a,"");if(i)try{switch(n){case"_columnRiseRatio":case"_columnTotal":case"_columnProportion":var u=i[n][r];return h(u)?o:e(u);default:var c=i[n][r].summary;return h(c)?o:e(c,i[n][r].data)}}catch(f){return o}return o}function o(n,t,r,e){return i("_columns",n,t,r,e)}function u(n,t,r,e){return i("_columnProportion",n,t,r,e)}return{data:l.data,getCellValue:o,getCellVerticalRiseRatio:function(n,t,r,e){return i("_columnRiseRatio",n,t,r,e)},getCellVerticalTotal:function(n,t,r,e){var a;return"*"===n?h(a=l.total[t])?R(e,""):r(a):i("_columnTotal",n,t,r,e)},getCellVerticalProportion:u,getRowCellValue:function(t,n,r,e){var a={};return n.forEach(function(n){a[n.id]=o(t,n.field,r,e)}),a},getRowVerticalProportion:function(t,n,r,e){var a={};return n.forEach(function(n){a[n.id]=u(t,n.field,r,e)}),a},getOriginGroupData:function(t,n){var r=C(l.data,function(n){return 0===en(n.uidPath,t,function(n,t){return n===t}).length});return r&&null!=(r=null==(n=r._columns[n])?void 0:n.data)?r:[]},getOriginAllData:function(){return n}}},n.mapKvPair=function(n,t){var r,e={};for(r in n)e[r]=t(S(n[r]),r);return e},n.mapTree=function(n,a,i,o){o=o||"children";var t=[];return function u(n,t){for(var r=0;r<n.length;r++){var e=i(n[r]);h(e)||(t[r]=S(e),n[r][o]&&(t[r][a]=[],u(n[r][o],t[r][a])))}}(n,t),t},n.mixInZeroWidthUnicode=function(n){return T(n,"").join("‎")},n.padEnd=x,n.padStart=function(n,t,r){return z(n,t,r,-1)},n.param=A,n.parseQuery=r,n.randomColor=function(){return"rgba("+P(0,255,!0)+","+P(0,255,!0)+","+P(0,255,!0)+",1)"},n.repeatString=W,n.roundFixed=function(n,t,r){n=w(n);var e,a=Math.pow(10,t),n=f(Math.round(n*a)/a);return 0<t&&(e=(a=T(n,"."))[0],(a=a[1]||"").length<t&&(a=x(a,t,"0"),n=(a=r?a.replace(/0+$/,""):a)?e+"."+a:e)),n},n.shake=function(n,t){return t=Object.assign({string:!0,array:!0,kvPair:!0},t),function a(n,t){if(s(n))for(var r in n){var e=n[r];(d(e)||s(e))&&a(e,t),U(e,t)&&delete n[r]}}(n=S(n),t),n},n.shortNumber=function(n,t,r){for(var e=h(r)?cn:r,a=(e.sort(function(n,t){return t[0]-n[0]}),n),i="",o=0;o<e.length;o++){var u=e[o],c=n/u[0];if(1<=c){a=c,i=u[1];break}}return{value:a,fmtValue:t(a),unit:i}},n.sortWithIndex=function(n,t){for(var r=[],e=0;e<n.length;e++)r[e]=n[t[e]];return r},n.spanTable=function(n,i){var u=S(n),c={};function r(a,i){var o=0;u.forEach(function(n,t){n.$rowSpan=null!=(e=n.$rowSpan)?e:{};var r,e=n[a];c[a]=null!=(r=c[a])?r:0,1<c[a]?(n.$rowSpan[a]=0,c[a]--):(r=function(n,t,r,e){var a=1;for(n++;n<e.length;n++){var i=e[n][t];if(i!==r&&!y(i))break;a++}return a}(t,a,e,u),void 0!==i&&(e=function(n,t,r){for(var e=0;0<=t&&!(0<(e=n[t].$rowSpan[r]));t--);return e}(u,t,i),0<o?e<=o+r?(r=e-o,o=0):o+=r:r<e?o=r:r=e),c[a]=r,n.$rowSpan[a]=c[a])})}return i.forEach(function(n,t){r(n,i[t-1])}),u.forEach(function(e){e.$colSpan={},e.$colField={};var a=0;i.forEach(function(n,t){var r=e[n];1<a?(e.$colSpan[t]=0,e.$colField[n]=0,a--):(a=function(n,t,r,e){var a=1;for(n++;n<e.length;n++){var i=E(r[e[n]]);if(i!==t&&!y(i))break;a++}return a}(t,r,e,i),e.$colSpan[t]=a,e.$colField[n]=a)})}),u},n.split=T,n.thousands=function(n,a,i){return a=a||3,i=i||",",(v(n)?n:f(n)).replace(/([^.]*)?(\.)?(.*)?/,function(n,t,r,e){return f(t).replace(new RegExp("(.(?=(.{"+a+"})+$))","g"),"$1"+i)+f(r)+f(e)})},n.tree=function(n,t){for(var r=(t=g(t)).id||"id",e=t.pid||"pid",a=t.children||"children",i=0;i<n.length;i++){var o,u=n[i];(o=C(n,function(n){return null!=n[r]&&n[r]!=u[r]&&n[r]===u[e]},a))&&(o[a]=b(o[a]),o[a].push(u),n.splice(i--,1))}return n},n.trim=E,n.union=function(){for(var n=arguments.length,t=new Array(n),r=0;r<n;r++)t[r]=arguments[r];var e=new Set(t);return Array.from(e)},n.urlToGet=function(n,t){n=f(n);var i=s(t)?t:r(t),t=r(n=n.replace(/({{)(.*?)(}})/g,function(n,t,r,e){r=E(r);var a=i[r];return delete i[r],a})),t=A(i=Object.assign(t,i));return n=t?(n=n.replace(/\?.*/,""))+"?"+t:n},n.uuid=function(n){n=w(n);for(var t="",r=0;r<13;r++)t+=P(1,9);return n=(new Date).getTime()*P(1,100),x(F()+Number(t).toString(32)+n.toString(32),20,F()+F()+F())},n.variableHasValue=k});
@@ -20,15 +20,6 @@ declare function getType(data: any): string;
20
20
  */
21
21
  declare function isArray(arg: any): arg is any[];
22
22
 
23
- /**
24
- * 判断数据是否为对象
25
- * @param data - 判断的值
26
- * @returns 真假值
27
- */
28
- declare function isKvPair(data: any): boolean;
29
-
30
- declare function isString(data: any): data is string;
31
-
32
23
  /**
33
24
  * 递归将所有属性改为可选
34
25
  */
@@ -38,7 +29,17 @@ type BTDeepPartial<T = any> = {
38
29
  /**
39
30
  * 键值对格式的数据
40
31
  * */
41
- type IKvPair = Record<string, any>;
32
+ type TKvPair = Record<string | number | symbol, any>;
33
+ type TValueOf<T> = T[keyof T];
34
+
35
+ /**
36
+ * 判断数据是否为对象
37
+ * @param data - 判断的值
38
+ * @returns 真假值
39
+ */
40
+ declare function isKvPair(arg: any): arg is TKvPair;
41
+
42
+ declare function isString(data: any): data is string;
42
43
 
43
44
  /**
44
45
  * 强制转换数据为键值对数据,如果是json字符串,会尝试解析,如果失败,则返回一个空Map
@@ -57,7 +58,7 @@ type IKvPair = Record<string, any>;
57
58
  * const data3 = _KvPair({name: 'a'})
58
59
  * ```
59
60
  */
60
- declare function _KvPair(data: any): IKvPair;
61
+ declare function _KvPair(data: any): TKvPair;
61
62
 
62
63
  /**
63
64
  * 判断是否为空[null, undefined, '']
@@ -78,37 +79,48 @@ declare function isFunction(data: any): boolean;
78
79
  * @param data - 需要转化的数据
79
80
  * @returns 转换后的字符串
80
81
  */
81
- declare function param(data: Record<string | number, any>): string;
82
+ declare function param(data: TKvPair): string;
82
83
 
83
84
  /**
84
85
  * 为url链接拼接参数
85
- * @param url - url地址
86
+ * @param url - url地址。可带查询参数由 ”{{包裹}}”
86
87
  * @param searchString - 查询参数
87
- * @returns 拼接后的url地址
88
+ * @returns string 拼接后的url地址
89
+ * @example
90
+ * ```js
91
+ * urlToGet('/parent_{{ pid }}/info/{{ uid }}/detail?c=5&', {
92
+ * name: '张三',
93
+ * skill: [1, 2, 3, 4, 5]
94
+ * })
95
+ * urlToGet('1111111111', 'a=0&b=2')
96
+ * urlToGet('2222222222', 'a=0&b=2')
97
+ * urlToGet('333333333?c=5&', 'a=0&b=2')
98
+ * ```
99
+ *
88
100
  */
89
- declare function urlToGet(url: string, searchString: string | Record<string, any>): string;
101
+ declare function urlToGet(url: string, data: string | TKvPair): string;
90
102
 
91
103
  /**
92
- * 移除空字符串
104
+ * 移除空字符串。不清空 "\u200e"
93
105
  * @param data - 需要处理的数据
94
106
  * @param pos - 移除位置。默认:两侧,1:左侧,-1右侧,* 所有
95
107
  * @returns 字符串
96
108
  */
97
109
  declare function trim(data: any, pos?: 1 | -1 | '*'): string;
98
110
 
99
- declare function clean<
100
- T extends
101
- | any[]
102
- | {
103
- [key: string]: any;
104
- [key: number]: any;
105
- }
106
- >(data: T, removeEmptyStr?: boolean, removeEmptyObject?: boolean): T;
107
-
108
111
  type TargetData = Record<string, any> | any[];
109
112
  interface Options {
113
+ /**
114
+ * 是否移除空字符串。默认true
115
+ */
110
116
  string?: Boolean;
117
+ /**
118
+ * 是否移除空数组。默认true
119
+ */
111
120
  array?: Boolean;
121
+ /**
122
+ * 是否移除空键值对。默认true
123
+ */
112
124
  kvPair?: Boolean;
113
125
  }
114
126
  /**
@@ -180,7 +192,29 @@ declare function deepFindTreePath(
180
192
  */
181
193
  declare function _Number(data: any): number;
182
194
 
183
- declare function isNull(data: any): boolean;
195
+ type TNull = undefined | null | '';
196
+ declare function isNull(data: any): data is TNull;
197
+
198
+ /**
199
+ *
200
+ * @param value 看起来是否像一个数字
201
+ * @example
202
+ * ```
203
+ * isLickNumber(1) => true
204
+ * isLickNumber('2.36884') => true
205
+ * isLickNumber(1/0) => false
206
+ * isLickNumber(0/0) => false
207
+ * isLickNumber('') => false
208
+ * isLickNumber() => false
209
+ * isLickNumber(null) => false
210
+ * isLickNumber(true) => false
211
+ * isLickNumber(false) => false
212
+ * isLickNumber([]) => false
213
+ * isLickNumber(function () {}) => false
214
+ * ```
215
+ * @returns
216
+ */
217
+ declare function isLikeNumber(value: any): boolean;
184
218
 
185
219
  /**
186
220
  * 默认值处理函数
@@ -354,10 +388,10 @@ declare function cloneEasy<T extends [] | Record<any, any> | Function>(data: T):
354
388
  * @param childKeyFrom - 原始数据的孩子键
355
389
  * @returns 转变后的新数据
356
390
  */
357
- declare function main<T extends IKvPair, K extends IKvPair, C extends keyof T>(
391
+ declare function main<T extends TKvPair, K extends TKvPair, C extends keyof T>(
358
392
  data: K[],
359
393
  childKeyTo: C,
360
- handle: (data: K) => Omit<T, C>,
394
+ handle: (data: K) => Omit<T, C> | undefined,
361
395
  childKeyFrom?: keyof K
362
396
  ): T[];
363
397
 
@@ -404,9 +438,9 @@ declare function defineEventBus<T extends EventHander>(
404
438
  * @param handle - 迭代方法。这里不用返回子节点
405
439
  * @param childKey - 子节点字段。默认值:children
406
440
  */
407
- declare function forEachTree<T extends IKvPair>(
441
+ declare function forEachTree<T extends TKvPair>(
408
442
  data: T[],
409
- handle: (data: T) => void,
443
+ handle: (data: T, parents: T[]) => void,
410
444
  childKey?: keyof T
411
445
  ): void;
412
446
 
@@ -422,26 +456,9 @@ declare function randomColor(): string;
422
456
 
423
457
  type VoidFunc = () => void;
424
458
  interface PollingOption {
425
- /**
426
- * 多少毫秒一次
427
- */
428
459
  interval: number;
429
- /**
430
- * 过期时间。不填则永不过期
431
- */
432
- timeout?: number;
433
- /**
434
- *
435
- * @param remainTime 剩余时间回调(需要设置了timeout大于0)
436
- * @returns
437
- */
460
+ timeout: number;
438
461
  onMessage?: (remainTime: number) => void;
439
- /**
440
- *
441
- * @param next 继续轮询
442
- * @param done 完成并停止
443
- * @returns
444
- */
445
462
  handler: (next: VoidFunc, done: VoidFunc) => void;
446
463
  }
447
464
  /**
@@ -474,14 +491,13 @@ declare class Polling {
474
491
  private _timer;
475
492
  private _timer_info;
476
493
  private _stamp;
477
- private _isMount;
478
494
  private _passStamp;
479
495
  private _option;
480
496
  constructor(setting: Partial<PollingOption>);
481
497
  private _next;
482
498
  private _doOnce;
483
499
  /** 开始 */
484
- start(): this | undefined;
500
+ start(): this;
485
501
  /** 完成 */
486
502
  done(): this;
487
503
  /** 销毁 */
@@ -509,10 +525,339 @@ declare function dataPage<T>(
509
525
 
510
526
  /**
511
527
  * 解析序列化字符参数为Map格式数据
512
- * @param str - url 查询参数。默认为window.location.href
528
+ * @param str - url 查询参数
513
529
  * @returns 键值对
514
530
  */
515
- declare function parseQuery(str?: string): IKvPair;
531
+ declare function parseQuery(str?: string): TKvPair;
532
+
533
+ declare const fieldCheck: {
534
+ /**
535
+ * 验证传入的数据是否是数字
536
+ * @param title - 标题
537
+ * @param value - 值
538
+ * @param required - 是否必填
539
+ * @returns
540
+ */
541
+ number(title: string, value: any, required?: boolean): number;
542
+ /**
543
+ * 验证传入的数据是否是字符串
544
+ * @param title - 标题
545
+ * @param value - 值
546
+ * @param required - 是否必填
547
+ * @returns
548
+ */
549
+ string(title: string, value: any, required?: boolean): string;
550
+ };
551
+
552
+ interface ISummary {
553
+ /** 值 */
554
+ value: number;
555
+ /** 增长率 */
556
+ riseRatio?: number;
557
+ /** 比重 */
558
+ proportion: number;
559
+ }
560
+ interface IARTResultItem<T> {
561
+ name: string;
562
+ value: T;
563
+ data: Record<string, T[]>;
564
+ summary: Record<string, ISummary>;
565
+ }
566
+ type TArrayRowToColumnColumnSort = (a: string, b: string) => number;
567
+ /**
568
+ * 数字中某个字段由 行转列
569
+ * @param originData - 原始数组
570
+ * @param options - 配置项
571
+ * @returns 转换后的数据
572
+ */
573
+ declare function arrayRowToColumn<T extends Record<string, any>>(
574
+ originData: T[],
575
+ options: {
576
+ /** 唯一行的ID生成器 */
577
+ uniqueRowId: Array<keyof T>;
578
+ /** 将此字段转为列 */
579
+ colField: keyof T;
580
+ /** 列的排序方法 */
581
+ colSort?: TArrayRowToColumnColumnSort;
582
+ /** 生成列信息 */
583
+ colCreate: (key: string) => {
584
+ label: string;
585
+ field: string;
586
+ };
587
+ summaryConfig?: IConfig;
588
+ }
589
+ ): {
590
+ columns: {
591
+ value: string;
592
+ label: string;
593
+ field: string;
594
+ }[];
595
+ data: IARTResultItem<T>[];
596
+ colSummary: Record<string, Record<string, ISummary>>;
597
+ getExtRow: <T_1 extends keyof ISummary>(
598
+ groupName: string,
599
+ field: T_1,
600
+ formatter: (data: ISummary[T_1]) => string
601
+ ) => Record<string, string>;
602
+ };
603
+ type TArrayRowToColumnCalculateRow = {
604
+ proportionBaseField?: string;
605
+ count: {
606
+ field: string;
607
+ mode: 'length' | 'uniqLength' | 'notZeroValue';
608
+ };
609
+ value: {
610
+ field: string;
611
+ mode: 'sum' | 'uniqLength' | 'avg';
612
+ };
613
+ };
614
+ interface IConfig {
615
+ averageField: string;
616
+ row?: Record<string, TArrayRowToColumnCalculateRow>;
617
+ column?: TColSumaryConfig;
618
+ }
619
+ type TColSumaryConfig = Record<
620
+ string,
621
+ {
622
+ field: string;
623
+ mode: 'uniqLength' | 'avg' | 'notZeroLength' | 'sum';
624
+ }
625
+ >;
626
+
627
+ type ISpanTableItem<T extends TKvPair> = T & {
628
+ $rowSpan: Record<string, number>;
629
+ $colSpan: Record<number, number>;
630
+ $colField: Record<string | number, number>;
631
+ };
632
+ /**
633
+ * 合并单元格。不改变原数组
634
+ * @param data - 一维数组
635
+ * @param fields - 合并的字段
636
+ * @returns 合并后的数据。会在每一项中添加两个字段 "$rowSpan" "$colSpan" "$colField"
637
+ */
638
+ declare function spanTable<T extends TKvPair>(data: T[], fields: string[]): ISpanTableItem<T>[];
639
+
640
+ /**
641
+ * 正则千分位转换,支持小数(任意字符串按位数相隔)
642
+ *
643
+ * @param data 需要转换的字符
644
+ * @param len 按多少位分隔一次,默认3
645
+ * @param symbol 千分位替换符号,默认逗号
646
+ */
647
+ declare function thousands(data: number | string, len?: number, symbol?: string): string;
648
+
649
+ /**
650
+ * 键值对的map实现方法
651
+ * @param data - 元数据
652
+ * @param handler - 自定义处理函数
653
+ * @returns
654
+ */
655
+ declare function mapKvPair<T extends TKvPair, U>(
656
+ data: T,
657
+ handler: (data: TValueOf<T>, key: string) => U
658
+ ): Record<string | number | symbol, U>;
659
+
660
+ /**
661
+ * 模糊搜索,例如 a4 可匹配 a3645
662
+ * @param search - 输入的值,如果为空,则表示无筛选条件,直接返回true
663
+ * @param data - 源数据的值
664
+ * @param regFlags - 与 RegExp 第二个参数相同,指定是否全局、区分大小写等
665
+ * @return
666
+ */
667
+ declare function isFuzzyMatch(search: string, data: string, regFlags?: string): boolean;
668
+
669
+ /**
670
+ * 向字符串中添加零宽字符。(暂时用于排除同名表格单元格合并)
671
+ * @param data - 需要处理的数据
672
+ * @returns
673
+ */
674
+ declare function mixInZeroWidthUnicode(data: string): string;
675
+
676
+ /**
677
+ * 键值对的forEach实现方法
678
+ * @param data - 元数据
679
+ * @param handler - 自定义处理函数
680
+ * @returns
681
+ */
682
+ declare function forEachKvPair<T extends TKvPair, U>(
683
+ data: T,
684
+ handler: (data: TValueOf<T>, key: string, index: number) => U
685
+ ): Record<string | number | symbol, U>;
686
+
687
+ /**
688
+ * 获取排序后的索引列表。如 [2,1,3] 排序为 [1,2,3] 索引为 [1,0,2]
689
+ *
690
+ * @param data - 原始数据
691
+ * @param sortHandler 排序处理函数,与原生排序使用方式一致
692
+ * @returns 索引列表
693
+ *
694
+ */
695
+ declare function getSortIndex<T>(data: T[], sortHandler: (a: T, b: T) => number): number[];
696
+
697
+ /**
698
+ * 按索引顺序对数组进行排序
699
+ * @param data 需要排序的数据
700
+ * @param index 索引列表
701
+ * @returns 新数据
702
+ */
703
+ declare function sortWithIndex<T>(data: T[], index: ReturnType<typeof getSortIndex>): T[];
704
+
705
+ type TListGroupKey<T extends TKvPair> = {
706
+ field: string | string[];
707
+ sort?: (a: TInnerGroupListItem<T>, b: TInnerGroupListItem<T>) => number;
708
+ };
709
+ type TGetValueField = string;
710
+ interface ICellSummary {
711
+ denominator?: [string, 'length' | 'uniqLength'];
712
+ /**
713
+ * sum 求和
714
+ * length 长度
715
+ * uniqLength 去重长度
716
+ */
717
+ numerator: [string, 'sum' | 'length' | 'uniqLength'];
718
+ }
719
+ type TColCustomWay = {
720
+ /** 计算方式 */
721
+ 0: 'sum' | 'max' | 'diff';
722
+ /** 参与计算的列(就是被转为列的那些值) */
723
+ 1: string[] | '*';
724
+ /** 获取值的方式 */
725
+ 2?: 'value' | 'length' | 'uniqLength';
726
+ /** 原始数据中的字段 */
727
+ 3?: string;
728
+ };
729
+ interface IListGroupOption<T extends TKvPair> {
730
+ /**
731
+ * 按字段值组装树形结构数据
732
+ */
733
+ path: TListGroupKey<T>[];
734
+ /**
735
+ * 将此字段转为列,并做一些基础统计
736
+ */
737
+ colField?: keyof T;
738
+ /**
739
+ * 组装后数据的计算方法
740
+ */
741
+ cellSummary?: ICellSummary;
742
+ /**
743
+ * 自定义列。分子➗分母
744
+ */
745
+ colCustom?: Record<
746
+ string,
747
+ {
748
+ numerator: TColCustomWay;
749
+ denominator?: TColCustomWay;
750
+ riseRatio?: boolean;
751
+ }
752
+ >;
753
+ }
754
+ interface TInnerColumnsSummaryItem<T> extends TKvPair {
755
+ data: T[];
756
+ summary: number | undefined;
757
+ _collect: any[];
758
+ }
759
+ type TInnerGroupListItem<T extends TKvPair> = {
760
+ uid: string;
761
+ uidPath: string[];
762
+ data: T[];
763
+ _columns: Record<string, TInnerColumnsSummaryItem<T>>;
764
+ _columnRiseRatio: Record<string, number | undefined>;
765
+ _columnTotal: Record<string, number>;
766
+ _columnProportion: Record<string, number>;
767
+ isLeaf: boolean;
768
+ children: TInnerGroupListItem<T>[];
769
+ };
770
+ declare function listGroup<T extends TKvPair>(
771
+ data: T[],
772
+ options: IListGroupOption<T>
773
+ ): {
774
+ /** 树形分组数据 */
775
+ data: TInnerGroupListItem<T>[];
776
+ /** 获取单元格:值 */
777
+ getCellValue: (
778
+ uidPath: string[],
779
+ field: TGetValueField,
780
+ formatter: (value: number, list: T[]) => string,
781
+ defaultData?: string
782
+ ) => string;
783
+ /** 获取单元格:纵向增长率 */
784
+ getCellVerticalRiseRatio: (
785
+ uidPath: string[],
786
+ field: TGetValueField,
787
+ formatter: (value: number) => string,
788
+ defaultData?: string
789
+ ) => string;
790
+ /** 获取单元格:纵向累计 */
791
+ getCellVerticalTotal: (
792
+ uidPath: string[] | '*',
793
+ field: TGetValueField,
794
+ formatter: (value: number) => string,
795
+ defaultData?: string
796
+ ) => string;
797
+ /** 获取单元格:纵向比重 */
798
+ getCellVerticalProportion: (
799
+ uidPath: string[],
800
+ field: TGetValueField,
801
+ formatter: (value: number) => string,
802
+ defaultData?: string
803
+ ) => string;
804
+ /** 获取一行:值 */
805
+ getRowCellValue: (
806
+ uidPath: string[],
807
+ fieldList: {
808
+ id: string;
809
+ field: TGetValueField;
810
+ }[],
811
+ formatter: (value: number) => string,
812
+ defaultData?: string
813
+ ) => Record<string, string>;
814
+ /** 获取一行:纵向比重 */
815
+ getRowVerticalProportion: (
816
+ uidPath: string[],
817
+ fieldList: {
818
+ id: string;
819
+ field: TGetValueField;
820
+ }[],
821
+ formatter: (value: number) => string,
822
+ defaultData?: string
823
+ ) => Record<string, string>;
824
+ /** 获取一个分组的所有原始数据,用于使用者自行计算 */
825
+ getOriginGroupData: (uidPath: string[], field: TGetValueField) => T[];
826
+ getOriginAllData: () => T[];
827
+ };
828
+
829
+ declare function union<T extends TKvPair>(...args: T[]): T[];
830
+
831
+ declare function getRatio(value: number | undefined, base: number | undefined): number;
832
+
833
+ /**
834
+ * 筛选并从原始数组移除符合条件的数据
835
+ * @param data - 原始数据
836
+ * @param predicate - 迭代回调
837
+ * @returns 筛选的结果
838
+ */
839
+ declare function filterWithMove<T, S extends T>(
840
+ data: T[],
841
+ predicate: (value: T, index: number, array: T[]) => value is S
842
+ ): S[];
843
+
844
+ type TUnits = [number, string];
845
+ /**
846
+ * 数字格式化为简称
847
+ * @param data - 数字
848
+ * @param formatter - 格式化数字(不包括单位)
849
+ * @param units - 格式化规则,可自定义
850
+ * @returns 数字简写
851
+ */
852
+ declare function export_default(
853
+ data: number,
854
+ formatter: (data: number) => string,
855
+ units?: TUnits[]
856
+ ): {
857
+ value: number;
858
+ fmtValue: string;
859
+ unit: string;
860
+ };
516
861
 
517
862
  declare global {
518
863
  /**
@@ -521,32 +866,43 @@ declare global {
521
866
  namespace jUtilsBase {
522
867
  export {
523
868
  Polling,
869
+ TArrayRowToColumnCalculateRow,
524
870
  _Array,
525
871
  _Boolean,
526
872
  _KvPair,
527
873
  _Number,
528
874
  _String,
875
+ arrayRowToColumn,
529
876
  changeIndex,
530
- clean,
531
877
  cloneEasy,
532
878
  dataPage,
533
879
  deepFindItem,
534
880
  deepFindTreePath,
535
881
  defaultValue,
536
882
  defineEventBus,
883
+ fieldCheck,
884
+ filterWithMove,
537
885
  flatTree,
538
886
  floorFixed,
539
887
  forEach,
888
+ forEachKvPair,
540
889
  forEachTree,
541
890
  getRandom,
891
+ getRatio,
892
+ getSortIndex,
542
893
  getType,
543
894
  isArray,
544
895
  isEmpty,
545
896
  isFunction,
897
+ isFuzzyMatch,
546
898
  isKvPair,
899
+ isLikeNumber,
547
900
  isNull,
548
901
  isString,
902
+ listGroup,
903
+ mapKvPair,
549
904
  main as mapTree,
905
+ mixInZeroWidthUnicode,
550
906
  padEnd,
551
907
  padStart,
552
908
  param,
@@ -555,9 +911,14 @@ declare global {
555
911
  repeatString,
556
912
  roundFixed,
557
913
  shake,
914
+ export_default as shortNumber,
915
+ sortWithIndex,
916
+ spanTable,
558
917
  split,
918
+ thousands,
559
919
  flatArrayToTree as tree,
560
920
  trim,
921
+ union,
561
922
  urlToGet,
562
923
  uuid,
563
924
  variableHasValue
package/package.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "@bestime/utils_base",
3
- "version": "1.0.5",
4
- "main": "./dist/jUtilsBase.umd.min.cjs",
5
- "module": "./dist/jUtilsBase.esm.min.mjs",
6
- "types": "./dist/jUtilsBase.esm.d.ts",
3
+ "version": "1.0.7",
4
+ "main": "./dist/jUtilsBase/esm/index.min.mjs",
5
+ "module": "./dist/jUtilsBase/esm/index.min.mjs",
6
+ "typings": "./dist/jUtilsBase/esm/index.min.d.ts",
7
7
  "description": "个人常用工具库",
8
8
  "type": "module",
9
9
  "files": [
@@ -48,5 +48,8 @@
48
48
  "homepage": "https://github.com/bestime/tool",
49
49
  "publishConfig": {
50
50
  "access": "public"
51
+ },
52
+ "dependencies": {
53
+ "lodash-es": "^4.17.21"
51
54
  }
52
55
  }