@wyfex/iutils 0.25.0 → 0.30.0

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>Array.isArray(e),t=e=>e==null,n=e=>!t(e)&&typeof e==`object`&&typeof e.length==`number`&&typeof e!=`function`,r=e=>typeof e==`boolean`,i=e=>r(e)||e===`true`||e===`false`,a=n=>t(n)?!1:s(n)?n.trim().length>0:o(n)?!0:e(n)?n.length>0:l(n)?Object.keys(n).length>0:!1,o=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),s=e=>Object.prototype.toString.call(e)===`[object String]`,c=e=>o(e)||s(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),l=e=>Object.prototype.toString.call(e)===`[object Object]`,u=t=>!e(t)||t.length===0?!1:t.every(e=>l(e)),d=(t,n,r=`children`)=>{if(!e(t))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...t];let o=(t,n)=>{for(let a of n){if(a[i]===t)return a;let n=a[r];if(e(n)){let e=o(t,n);if(e)return e}}};return e(a)?a.map(e=>o(e,t)).filter(Boolean):o(a,t)},f=(t,n)=>{if(!e(t))throw TypeError(`array 必须是一个数组`);let[r,i]=Object.entries(n)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...t];let a=e=>t.findIndex(t=>t[r]===e);return e(i)?i.map(a):a(i)},p=(t,n,r)=>{if(!e(t))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效的键值对，格式示例：{ id: 1 }`),[...t];let o=t.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...t];let s=[...t],c=e(r)?r:[r];return s.splice(o+1,0,...c),s},m=(t,n,r=1)=>{if(!e(t))throw TypeError(`array must be an array`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...t];let o=t.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...t];let s=o+1;if(s>=t.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...t];let c=[...t];return c.splice(s,r),c},h=()=>{let e=()=>Math.floor(Math.random()*255);return`rgb(${e()}, ${e()}, ${e()})`},g=(e=1)=>{let t=()=>Math.floor(Math.random()*255);return`rgba(${t()}, ${t()}, ${t()}, ${e})`},_=(e,t=300,n=!1)=>{let r=null,i,a=function(...a){return r&&clearTimeout(r),n&&!r&&(i=e.apply(this,a)),r=setTimeout(()=>{n||e.apply(this,a),r=null},t),i};return a.cancel=()=>{r&&=(clearTimeout(r),null)},a.flush=()=>(a.cancel(),i),a.isPending=()=>r!==null,a},v=e=>l(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},y=t=>{if(!l(t))return{};let n={...t};for(let t in n){let r=n[t];if(t.includes(`,`)&&e(r)){let e=t.split(`,`),i=r;e.forEach((e,t)=>{n[e]=i[t]}),delete n[t]}}return n},b=(t,n)=>{if(!l(t))return{};let r=e(n)?n:[n],i={...t};return r.forEach(e=>{delete i[e]}),i},x=(t,n=`_`)=>{if(t==null)return t;if(e(t))return t.map(e=>x(e,n)).filter(e=>typeof e==`string`?!e.startsWith(n):typeof e==`number`?!String(e).startsWith(n):!0);if(typeof t!=`object`||t instanceof Date||t instanceof RegExp)return t;let r={};for(let e in t)if(Object.prototype.hasOwnProperty.call(t,e)){let i=t[e];e.startsWith(n)||(r[e]=x(i,n))}return r},S=(e,t=[])=>{if(!l(e))return e;let n={...e};return t.forEach(e=>{if(!Object.prototype.hasOwnProperty.call(n,e))return;let t=n[e];if(typeof t==`string`){n[e]=t.split(`,`).map(e=>e.trim()).filter(Boolean);return}n[e]=t==null?[]:[t]}),n},C=(t,n=[])=>{if(!l(t))return t;let r={...t};return Object.keys(r).forEach(t=>{let i=r[t];n.includes(t)&&e(i)&&(r[t]=i.join(`,`))}),r},w=e=>e===`null`||e===`undefined`||e===``?null:e===`true`?!0:e===`false`?!1:typeof e==`string`&&/^-?(0|[1-9]\d*)(\.\d+)?$/.test(e)?Number(e):e;exports.cleanObjectEmptyValues=v,exports.debounce=_,exports.expandCommaKeyObject=y,exports.findBy=d,exports.findIndexBy=f,exports.insertAfter=p,exports.isArray=e,exports.isArrayLike=n,exports.isBoolean=r,exports.isBooleanLike=i,exports.isEffectiveData=a,exports.isNil=t,exports.isNumber=o,exports.isNumberLike=c,exports.isObject=l,exports.isObjectArray=u,exports.isString=s,exports.omitObjectProps=b,exports.omitStartWithKeys=x,exports.parseStringFieldsToArray=S,exports.parseValue=w,exports.randomRgb=h,exports.randomRgba=g,exports.removeAfter=m,exports.stringifyArrayFields=C;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t={})=>{let{mode:n=`level`,idKey:r=`id`,parentIdKey:i=`parentId`,levelKey:a=`level`,childrenKey:o=`children`}=t;if(!Array.isArray(e)||e.length===0)return[];let s=e.map(e=>({...e})),c=[];if(n===`level`){let e=new Map;return s.forEach(t=>{let n=t[a];if(typeof n!=`number`)return;if(n===0){c.push(t),e.set(n,t);return}let r=e.get(n-1);r&&(r[o]||=[],r[o].push(t),e.set(n,t))}),c}if(n===`parentId`){let e=new Map;return s.forEach(t=>e.set(t[r],t)),s.forEach(t=>{let n=t[i];if(n==null||n===0){c.push(t);return}let r=e.get(n);r&&(r[o]||=[],r[o].push(t))}),c}return c},t=e=>Array.isArray(e),n=e=>e==null,r=e=>!n(e)&&typeof e==`object`&&typeof e.length==`number`&&typeof e!=`function`,i=e=>typeof e==`boolean`,a=e=>i(e)||e===`true`||e===`false`,o=e=>n(e)?!1:c(e)?e.trim().length>0:s(e)?!0:t(e)?e.length>0:u(e)?Object.keys(e).length>0:!1,s=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),c=e=>Object.prototype.toString.call(e)===`[object String]`,l=e=>s(e)||c(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),u=e=>Object.prototype.toString.call(e)===`[object Object]`,d=e=>!t(e)||e.length===0?!1:e.every(e=>u(e)),f=e=>c(e)||s(e)||i(e)||n(e),p=(e,n)=>{if(!d(e))throw TypeError(`array 必须是一个对象数组`);let{key:r,value:i,childrenKey:a=`children`}=n;if(!r){console.error(`findBy：key 不能为空`);return}let o=e=>f(e)?String(e):e,s=(e,t)=>{let n=o(e);for(let i of t){if(o(i[r])===n)return i;let t=i[a];if(d(t)){let n=s(e,t);if(n)return n}}};return t(i)?i.map(t=>s(t,e)).filter(Boolean):s(i,e)},m=(e,n)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[r,i]=Object.entries(n)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=t=>e.findIndex(e=>e[r]===t);return t(i)?i.map(a):a(i)},h=(e,t={})=>{let{childrenKey:n=`children`,keepChildren:r=!1}=t,i=[],a=e=>{let t={...e},o=t[n]||[];r||delete t[n],i.push(t),Array.isArray(o)&&o.length&&o.forEach(e=>a(e))};return e.forEach(e=>a(e)),i},g=(e,n,r)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效的键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=[...e],c=t(r)?r:[r];return s.splice(o+1,0,...c),s},_=(e,n,r=1)=>{if(!t(e))throw TypeError(`array must be an array`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=o+1;if(s>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let c=[...e];return c.splice(s,r),c},v=()=>{let e=()=>Math.floor(Math.random()*255);return`rgb(${e()}, ${e()}, ${e()})`},y=(e=1)=>{let t=()=>Math.floor(Math.random()*255);return`rgba(${t()}, ${t()}, ${t()}, ${e})`},b=(e,t=`{y}-{m}-{d} {h}:{i}:{s}`,n=!0)=>{if(e==null||e===``)return null;let r;if(e instanceof Date)r=e;else{let i;if(typeof e==`string`){let a=e.trim();if(/^\d+$/.test(a))i=parseInt(a,10);else{let e=a.replace(/-/g,`/`);return r=new Date(e),isNaN(r.getTime())?null:x(r,t,n)}}else i=e;i.toString().length===10&&(i*=1e3),r=new Date(i)}return isNaN(r.getTime())?null:x(r,t,n)};function x(e,t,n){let r=e.getFullYear(),i=e.getMonth()+1,a=e.getDate(),o=e.getHours(),s=e.getMinutes(),c=e.getSeconds(),l=e.getDay(),u={y:r.toString(),m:n?i.toString().padStart(2,`0`):i.toString(),d:n?a.toString().padStart(2,`0`):a.toString(),h:n?o.toString().padStart(2,`0`):o.toString(),i:n?s.toString().padStart(2,`0`):s.toString(),s:n?c.toString().padStart(2,`0`):c.toString(),a:[`日`,`一`,`二`,`三`,`四`,`五`,`六`][l]};return t.replace(/{([ymdhisa])}/g,(e,t)=>u[t])}var S=(e,t=300,n=!1)=>{let r=null,i,a=function(...a){return r&&clearTimeout(r),n&&!r&&(i=e.apply(this,a)),r=setTimeout(()=>{n||e.apply(this,a),r=null},t),i};return a.cancel=()=>{r&&=(clearTimeout(r),null)},a.flush=()=>(a.cancel(),i),a.isPending=()=>r!==null,a},C=e=>e==null||Number.isNaN(e)?``:String(e).trim().replace(/^(-?\d+)(\.\d+)?$/,(e,t,n=``)=>t.replace(/\B(?=(\d{3})+(?!\d))/g,`,`)+n),w=e=>u(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},T=e=>{if(!u(e))return{};let n={...e};for(let e in n){let r=n[e];if(e.includes(`,`)&&t(r)){let t=e.split(`,`),i=r;t.forEach((e,t)=>{n[e]=i[t]}),delete n[e]}}return n},E=(e,n)=>{if(!u(e))return{};let r=t(n)?n:[n],i={...e};return r.forEach(e=>{delete i[e]}),i},D=(e,n=`_`)=>{if(e==null)return e;if(t(e))return e.map(e=>D(e,n)).filter(e=>typeof e==`string`?!e.startsWith(n):typeof e==`number`?!String(e).startsWith(n):!0);if(typeof e!=`object`||e instanceof Date||e instanceof RegExp)return e;let r={};for(let t in e)if(Object.prototype.hasOwnProperty.call(e,t)){let i=e[t];t.startsWith(n)||(r[t]=D(i,n))}return r},O=(e,t=[])=>{if(!u(e))return e;let n={...e};return t.forEach(e=>{if(!Object.prototype.hasOwnProperty.call(n,e))return;let t=n[e];if(typeof t==`string`){n[e]=t.split(`,`).map(e=>e.trim()).filter(Boolean);return}n[e]=t==null?[]:[t]}),n},k=(e,n=[])=>{if(!u(e))return e;let r={...e};return Object.keys(r).forEach(e=>{let i=r[e];n.includes(e)&&t(i)&&(r[e]=i.join(`,`))}),r},A=e=>e===`null`||e===`undefined`||e===``?null:e===`true`?!0:e===`false`?!1:typeof e==`string`&&/^-?(0|[1-9]\d*)(\.\d+)?$/.test(e)?Number(e):e;exports.buildTree=e,exports.cleanObjectEmptyValues=w,exports.debounce=S,exports.expandCommaKeyObject=T,exports.findBy=p,exports.findIndexBy=m,exports.flatTree=h,exports.formatThousand=C,exports.formatTime=b,exports.insertAfter=g,exports.isArray=t,exports.isArrayLike=r,exports.isBoolean=i,exports.isBooleanLike=a,exports.isEffectiveData=o,exports.isNil=n,exports.isNumber=s,exports.isNumberLike=l,exports.isObject=u,exports.isObjectArray=d,exports.isPrimitive=f,exports.isString=c,exports.omitObjectProps=E,exports.omitStartWithKeys=D,exports.parseStringFieldsToArray=O,exports.parseValue=A,exports.randomRgb=v,exports.randomRgba=y,exports.removeAfter=_,exports.stringifyArrayFields=k;

package/dist/index.iife.js

@@ -1 +1 @@
-var WyfeX_IUtils=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=e=>Array.isArray(e),n=e=>e==null,r=e=>!n(e)&&typeof e==`object`&&typeof e.length==`number`&&typeof e!=`function`,i=e=>typeof e==`boolean`,a=e=>i(e)||e===`true`||e===`false`,o=e=>n(e)?!1:c(e)?e.trim().length>0:s(e)?!0:t(e)?e.length>0:u(e)?Object.keys(e).length>0:!1,s=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),c=e=>Object.prototype.toString.call(e)===`[object String]`,l=e=>s(e)||c(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),u=e=>Object.prototype.toString.call(e)===`[object Object]`,d=e=>!t(e)||e.length===0?!1:e.every(e=>u(e)),f=(e,n,r=`children`)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let o=(e,n)=>{for(let a of n){if(a[i]===e)return a;let n=a[r];if(t(n)){let t=o(e,n);if(t)return t}}};return t(a)?a.map(t=>o(t,e)).filter(Boolean):o(a,e)},p=(e,n)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[r,i]=Object.entries(n)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=t=>e.findIndex(e=>e[r]===t);return t(i)?i.map(a):a(i)},m=(e,n,r)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效的键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=[...e],c=t(r)?r:[r];return s.splice(o+1,0,...c),s},h=(e,n,r=1)=>{if(!t(e))throw TypeError(`array must be an array`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=o+1;if(s>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let c=[...e];return c.splice(s,r),c},g=()=>{let e=()=>Math.floor(Math.random()*255);return`rgb(${e()}, ${e()}, ${e()})`},_=(e=1)=>{let t=()=>Math.floor(Math.random()*255);return`rgba(${t()}, ${t()}, ${t()}, ${e})`},v=(e,t=300,n=!1)=>{let r=null,i,a=function(...a){return r&&clearTimeout(r),n&&!r&&(i=e.apply(this,a)),r=setTimeout(()=>{n||e.apply(this,a),r=null},t),i};return a.cancel=()=>{r&&=(clearTimeout(r),null)},a.flush=()=>(a.cancel(),i),a.isPending=()=>r!==null,a},y=e=>u(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},b=e=>{if(!u(e))return{};let n={...e};for(let e in n){let r=n[e];if(e.includes(`,`)&&t(r)){let t=e.split(`,`),i=r;t.forEach((e,t)=>{n[e]=i[t]}),delete n[e]}}return n},x=(e,n)=>{if(!u(e))return{};let r=t(n)?n:[n],i={...e};return r.forEach(e=>{delete i[e]}),i},S=(e,n=`_`)=>{if(e==null)return e;if(t(e))return e.map(e=>S(e,n)).filter(e=>typeof e==`string`?!e.startsWith(n):typeof e==`number`?!String(e).startsWith(n):!0);if(typeof e!=`object`||e instanceof Date||e instanceof RegExp)return e;let r={};for(let t in e)if(Object.prototype.hasOwnProperty.call(e,t)){let i=e[t];t.startsWith(n)||(r[t]=S(i,n))}return r};return e.cleanObjectEmptyValues=y,e.debounce=v,e.expandCommaKeyObject=b,e.findBy=f,e.findIndexBy=p,e.insertAfter=m,e.isArray=t,e.isArrayLike=r,e.isBoolean=i,e.isBooleanLike=a,e.isEffectiveData=o,e.isNil=n,e.isNumber=s,e.isNumberLike=l,e.isObject=u,e.isObjectArray=d,e.isString=c,e.omitObjectProps=x,e.omitStartWithKeys=S,e.parseStringFieldsToArray=(e,t=[])=>{if(!u(e))return e;let n={...e};return t.forEach(e=>{if(!Object.prototype.hasOwnProperty.call(n,e))return;let t=n[e];if(typeof t==`string`){n[e]=t.split(`,`).map(e=>e.trim()).filter(Boolean);return}n[e]=t==null?[]:[t]}),n},e.parseValue=e=>e===`null`||e===`undefined`||e===``?null:e===`true`?!0:e===`false`?!1:typeof e==`string`&&/^-?(0|[1-9]\d*)(\.\d+)?$/.test(e)?Number(e):e,e.randomRgb=g,e.randomRgba=_,e.removeAfter=h,e.stringifyArrayFields=(e,n=[])=>{if(!u(e))return e;let r={...e};return Object.keys(r).forEach(e=>{let i=r[e];n.includes(e)&&t(i)&&(r[e]=i.join(`,`))}),r},e})({});
+var WyfeX_IUtils=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=(e,t={})=>{let{mode:n=`level`,idKey:r=`id`,parentIdKey:i=`parentId`,levelKey:a=`level`,childrenKey:o=`children`}=t;if(!Array.isArray(e)||e.length===0)return[];let s=e.map(e=>({...e})),c=[];if(n===`level`){let e=new Map;return s.forEach(t=>{let n=t[a];if(typeof n!=`number`)return;if(n===0){c.push(t),e.set(n,t);return}let r=e.get(n-1);r&&(r[o]||=[],r[o].push(t),e.set(n,t))}),c}if(n===`parentId`){let e=new Map;return s.forEach(t=>e.set(t[r],t)),s.forEach(t=>{let n=t[i];if(n==null||n===0){c.push(t);return}let r=e.get(n);r&&(r[o]||=[],r[o].push(t))}),c}return c},n=e=>Array.isArray(e),r=e=>e==null,i=e=>!r(e)&&typeof e==`object`&&typeof e.length==`number`&&typeof e!=`function`,a=e=>typeof e==`boolean`,o=e=>a(e)||e===`true`||e===`false`,s=e=>r(e)?!1:l(e)?e.trim().length>0:c(e)?!0:n(e)?e.length>0:d(e)?Object.keys(e).length>0:!1,c=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),l=e=>Object.prototype.toString.call(e)===`[object String]`,u=e=>c(e)||l(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),d=e=>Object.prototype.toString.call(e)===`[object Object]`,f=e=>!n(e)||e.length===0?!1:e.every(e=>d(e)),p=e=>l(e)||c(e)||a(e)||r(e),m=(e,t)=>{if(!f(e))throw TypeError(`array 必须是一个对象数组`);let{key:r,value:i,childrenKey:a=`children`}=t;if(!r){console.error(`findBy：key 不能为空`);return}let o=e=>p(e)?String(e):e,s=(e,t)=>{let n=o(e);for(let i of t){if(o(i[r])===n)return i;let t=i[a];if(f(t)){let n=s(e,t);if(n)return n}}};return n(i)?i.map(t=>s(t,e)).filter(Boolean):s(i,e)},h=(e,t)=>{if(!n(e))throw TypeError(`array 必须是一个数组`);let[r,i]=Object.entries(t)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=t=>e.findIndex(e=>e[r]===t);return n(i)?i.map(a):a(i)},g=(e,t={})=>{let{childrenKey:n=`children`,keepChildren:r=!1}=t,i=[],a=e=>{let t={...e},o=t[n]||[];r||delete t[n],i.push(t),Array.isArray(o)&&o.length&&o.forEach(e=>a(e))};return e.forEach(e=>a(e)),i},_=(e,t,r)=>{if(!n(e))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(t)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效的键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=[...e],c=n(r)?r:[r];return s.splice(o+1,0,...c),s},v=(e,t,r=1)=>{if(!n(e))throw TypeError(`array must be an array`);let[i,a]=Object.entries(t)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=o+1;if(s>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let c=[...e];return c.splice(s,r),c},y=()=>{let e=()=>Math.floor(Math.random()*255);return`rgb(${e()}, ${e()}, ${e()})`},b=(e=1)=>{let t=()=>Math.floor(Math.random()*255);return`rgba(${t()}, ${t()}, ${t()}, ${e})`},x=(e,t=`{y}-{m}-{d} {h}:{i}:{s}`,n=!0)=>{if(e==null||e===``)return null;let r;if(e instanceof Date)r=e;else{let i;if(typeof e==`string`){let a=e.trim();if(/^\d+$/.test(a))i=parseInt(a,10);else{let e=a.replace(/-/g,`/`);return r=new Date(e),isNaN(r.getTime())?null:S(r,t,n)}}else i=e;i.toString().length===10&&(i*=1e3),r=new Date(i)}return isNaN(r.getTime())?null:S(r,t,n)};function S(e,t,n){let r=e.getFullYear(),i=e.getMonth()+1,a=e.getDate(),o=e.getHours(),s=e.getMinutes(),c=e.getSeconds(),l=e.getDay(),u={y:r.toString(),m:n?i.toString().padStart(2,`0`):i.toString(),d:n?a.toString().padStart(2,`0`):a.toString(),h:n?o.toString().padStart(2,`0`):o.toString(),i:n?s.toString().padStart(2,`0`):s.toString(),s:n?c.toString().padStart(2,`0`):c.toString(),a:[`日`,`一`,`二`,`三`,`四`,`五`,`六`][l]};return t.replace(/{([ymdhisa])}/g,(e,t)=>u[t])}var C=(e,t=300,n=!1)=>{let r=null,i,a=function(...a){return r&&clearTimeout(r),n&&!r&&(i=e.apply(this,a)),r=setTimeout(()=>{n||e.apply(this,a),r=null},t),i};return a.cancel=()=>{r&&=(clearTimeout(r),null)},a.flush=()=>(a.cancel(),i),a.isPending=()=>r!==null,a},w=e=>e==null||Number.isNaN(e)?``:String(e).trim().replace(/^(-?\d+)(\.\d+)?$/,(e,t,n=``)=>t.replace(/\B(?=(\d{3})+(?!\d))/g,`,`)+n),T=e=>d(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},E=e=>{if(!d(e))return{};let t={...e};for(let e in t){let r=t[e];if(e.includes(`,`)&&n(r)){let n=e.split(`,`),i=r;n.forEach((e,n)=>{t[e]=i[n]}),delete t[e]}}return t},D=(e,t)=>{if(!d(e))return{};let r=n(t)?t:[t],i={...e};return r.forEach(e=>{delete i[e]}),i},O=(e,t=`_`)=>{if(e==null)return e;if(n(e))return e.map(e=>O(e,t)).filter(e=>typeof e==`string`?!e.startsWith(t):typeof e==`number`?!String(e).startsWith(t):!0);if(typeof e!=`object`||e instanceof Date||e instanceof RegExp)return e;let r={};for(let n in e)if(Object.prototype.hasOwnProperty.call(e,n)){let i=e[n];n.startsWith(t)||(r[n]=O(i,t))}return r};return e.buildTree=t,e.cleanObjectEmptyValues=T,e.debounce=C,e.expandCommaKeyObject=E,e.findBy=m,e.findIndexBy=h,e.flatTree=g,e.formatThousand=w,e.formatTime=x,e.insertAfter=_,e.isArray=n,e.isArrayLike=i,e.isBoolean=a,e.isBooleanLike=o,e.isEffectiveData=s,e.isNil=r,e.isNumber=c,e.isNumberLike=u,e.isObject=d,e.isObjectArray=f,e.isPrimitive=p,e.isString=l,e.omitObjectProps=D,e.omitStartWithKeys=O,e.parseStringFieldsToArray=(e,t=[])=>{if(!d(e))return e;let n={...e};return t.forEach(e=>{if(!Object.prototype.hasOwnProperty.call(n,e))return;let t=n[e];if(typeof t==`string`){n[e]=t.split(`,`).map(e=>e.trim()).filter(Boolean);return}n[e]=t==null?[]:[t]}),n},e.parseValue=e=>e===`null`||e===`undefined`||e===``?null:e===`true`?!0:e===`false`?!1:typeof e==`string`&&/^-?(0|[1-9]\d*)(\.\d+)?$/.test(e)?Number(e):e,e.randomRgb=y,e.randomRgba=b,e.removeAfter=v,e.stringifyArrayFields=(e,t=[])=>{if(!d(e))return e;let r={...e};return Object.keys(r).forEach(e=>{let i=r[e];t.includes(e)&&n(i)&&(r[e]=i.join(`,`))}),r},e})({});

package/dist/index.js

@@ -1 +1 @@
-var e=e=>Array.isArray(e),t=e=>e==null,n=e=>!t(e)&&typeof e==`object`&&typeof e.length==`number`&&typeof e!=`function`,r=e=>typeof e==`boolean`,i=e=>r(e)||e===`true`||e===`false`,a=n=>t(n)?!1:s(n)?n.trim().length>0:o(n)?!0:e(n)?n.length>0:l(n)?Object.keys(n).length>0:!1,o=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),s=e=>Object.prototype.toString.call(e)===`[object String]`,c=e=>o(e)||s(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),l=e=>Object.prototype.toString.call(e)===`[object Object]`,u=t=>!e(t)||t.length===0?!1:t.every(e=>l(e)),d=(t,n,r=`children`)=>{if(!e(t))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...t];let o=(t,n)=>{for(let a of n){if(a[i]===t)return a;let n=a[r];if(e(n)){let e=o(t,n);if(e)return e}}};return e(a)?a.map(e=>o(e,t)).filter(Boolean):o(a,t)},f=(t,n)=>{if(!e(t))throw TypeError(`array 必须是一个数组`);let[r,i]=Object.entries(n)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...t];let a=e=>t.findIndex(t=>t[r]===e);return e(i)?i.map(a):a(i)},p=(t,n,r)=>{if(!e(t))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效的键值对，格式示例：{ id: 1 }`),[...t];let o=t.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...t];let s=[...t],c=e(r)?r:[r];return s.splice(o+1,0,...c),s},m=(t,n,r=1)=>{if(!e(t))throw TypeError(`array must be an array`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...t];let o=t.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...t];let s=o+1;if(s>=t.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...t];let c=[...t];return c.splice(s,r),c},h=()=>{let e=()=>Math.floor(Math.random()*255);return`rgb(${e()}, ${e()}, ${e()})`},g=(e=1)=>{let t=()=>Math.floor(Math.random()*255);return`rgba(${t()}, ${t()}, ${t()}, ${e})`},_=(e,t=300,n=!1)=>{let r=null,i,a=function(...a){return r&&clearTimeout(r),n&&!r&&(i=e.apply(this,a)),r=setTimeout(()=>{n||e.apply(this,a),r=null},t),i};return a.cancel=()=>{r&&=(clearTimeout(r),null)},a.flush=()=>(a.cancel(),i),a.isPending=()=>r!==null,a},v=e=>l(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},y=t=>{if(!l(t))return{};let n={...t};for(let t in n){let r=n[t];if(t.includes(`,`)&&e(r)){let e=t.split(`,`),i=r;e.forEach((e,t)=>{n[e]=i[t]}),delete n[t]}}return n},b=(t,n)=>{if(!l(t))return{};let r=e(n)?n:[n],i={...t};return r.forEach(e=>{delete i[e]}),i},x=(t,n=`_`)=>{if(t==null)return t;if(e(t))return t.map(e=>x(e,n)).filter(e=>typeof e==`string`?!e.startsWith(n):typeof e==`number`?!String(e).startsWith(n):!0);if(typeof t!=`object`||t instanceof Date||t instanceof RegExp)return t;let r={};for(let e in t)if(Object.prototype.hasOwnProperty.call(t,e)){let i=t[e];e.startsWith(n)||(r[e]=x(i,n))}return r},S=(e,t=[])=>{if(!l(e))return e;let n={...e};return t.forEach(e=>{if(!Object.prototype.hasOwnProperty.call(n,e))return;let t=n[e];if(typeof t==`string`){n[e]=t.split(`,`).map(e=>e.trim()).filter(Boolean);return}n[e]=t==null?[]:[t]}),n},C=(t,n=[])=>{if(!l(t))return t;let r={...t};return Object.keys(r).forEach(t=>{let i=r[t];n.includes(t)&&e(i)&&(r[t]=i.join(`,`))}),r},w=e=>e===`null`||e===`undefined`||e===``?null:e===`true`?!0:e===`false`?!1:typeof e==`string`&&/^-?(0|[1-9]\d*)(\.\d+)?$/.test(e)?Number(e):e;export{v as cleanObjectEmptyValues,_ as debounce,y as expandCommaKeyObject,d as findBy,f as findIndexBy,p as insertAfter,e as isArray,n as isArrayLike,r as isBoolean,i as isBooleanLike,a as isEffectiveData,t as isNil,o as isNumber,c as isNumberLike,l as isObject,u as isObjectArray,s as isString,b as omitObjectProps,x as omitStartWithKeys,S as parseStringFieldsToArray,w as parseValue,h as randomRgb,g as randomRgba,m as removeAfter,C as stringifyArrayFields};
+var e=(e,t={})=>{let{mode:n=`level`,idKey:r=`id`,parentIdKey:i=`parentId`,levelKey:a=`level`,childrenKey:o=`children`}=t;if(!Array.isArray(e)||e.length===0)return[];let s=e.map(e=>({...e})),c=[];if(n===`level`){let e=new Map;return s.forEach(t=>{let n=t[a];if(typeof n!=`number`)return;if(n===0){c.push(t),e.set(n,t);return}let r=e.get(n-1);r&&(r[o]||=[],r[o].push(t),e.set(n,t))}),c}if(n===`parentId`){let e=new Map;return s.forEach(t=>e.set(t[r],t)),s.forEach(t=>{let n=t[i];if(n==null||n===0){c.push(t);return}let r=e.get(n);r&&(r[o]||=[],r[o].push(t))}),c}return c},t=e=>Array.isArray(e),n=e=>e==null,r=e=>!n(e)&&typeof e==`object`&&typeof e.length==`number`&&typeof e!=`function`,i=e=>typeof e==`boolean`,a=e=>i(e)||e===`true`||e===`false`,o=e=>n(e)?!1:c(e)?e.trim().length>0:s(e)?!0:t(e)?e.length>0:u(e)?Object.keys(e).length>0:!1,s=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),c=e=>Object.prototype.toString.call(e)===`[object String]`,l=e=>s(e)||c(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),u=e=>Object.prototype.toString.call(e)===`[object Object]`,d=e=>!t(e)||e.length===0?!1:e.every(e=>u(e)),f=e=>c(e)||s(e)||i(e)||n(e),p=(e,n)=>{if(!d(e))throw TypeError(`array 必须是一个对象数组`);let{key:r,value:i,childrenKey:a=`children`}=n;if(!r){console.error(`findBy：key 不能为空`);return}let o=e=>f(e)?String(e):e,s=(e,t)=>{let n=o(e);for(let i of t){if(o(i[r])===n)return i;let t=i[a];if(d(t)){let n=s(e,t);if(n)return n}}};return t(i)?i.map(t=>s(t,e)).filter(Boolean):s(i,e)},m=(e,n)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[r,i]=Object.entries(n)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=t=>e.findIndex(e=>e[r]===t);return t(i)?i.map(a):a(i)},h=(e,t={})=>{let{childrenKey:n=`children`,keepChildren:r=!1}=t,i=[],a=e=>{let t={...e},o=t[n]||[];r||delete t[n],i.push(t),Array.isArray(o)&&o.length&&o.forEach(e=>a(e))};return e.forEach(e=>a(e)),i},g=(e,n,r)=>{if(!t(e))throw TypeError(`array 必须是一个数组`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效的键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=[...e],c=t(r)?r:[r];return s.splice(o+1,0,...c),s},_=(e,n,r=1)=>{if(!t(e))throw TypeError(`array must be an array`);let[i,a]=Object.entries(n)[0]??[];if(!i||a===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let o=e.findIndex(e=>e[i]===a);if(o===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let s=o+1;if(s>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let c=[...e];return c.splice(s,r),c},v=()=>{let e=()=>Math.floor(Math.random()*255);return`rgb(${e()}, ${e()}, ${e()})`},y=(e=1)=>{let t=()=>Math.floor(Math.random()*255);return`rgba(${t()}, ${t()}, ${t()}, ${e})`},b=(e,t=`{y}-{m}-{d} {h}:{i}:{s}`,n=!0)=>{if(e==null||e===``)return null;let r;if(e instanceof Date)r=e;else{let i;if(typeof e==`string`){let a=e.trim();if(/^\d+$/.test(a))i=parseInt(a,10);else{let e=a.replace(/-/g,`/`);return r=new Date(e),isNaN(r.getTime())?null:x(r,t,n)}}else i=e;i.toString().length===10&&(i*=1e3),r=new Date(i)}return isNaN(r.getTime())?null:x(r,t,n)};function x(e,t,n){let r=e.getFullYear(),i=e.getMonth()+1,a=e.getDate(),o=e.getHours(),s=e.getMinutes(),c=e.getSeconds(),l=e.getDay(),u={y:r.toString(),m:n?i.toString().padStart(2,`0`):i.toString(),d:n?a.toString().padStart(2,`0`):a.toString(),h:n?o.toString().padStart(2,`0`):o.toString(),i:n?s.toString().padStart(2,`0`):s.toString(),s:n?c.toString().padStart(2,`0`):c.toString(),a:[`日`,`一`,`二`,`三`,`四`,`五`,`六`][l]};return t.replace(/{([ymdhisa])}/g,(e,t)=>u[t])}var S=(e,t=300,n=!1)=>{let r=null,i,a=function(...a){return r&&clearTimeout(r),n&&!r&&(i=e.apply(this,a)),r=setTimeout(()=>{n||e.apply(this,a),r=null},t),i};return a.cancel=()=>{r&&=(clearTimeout(r),null)},a.flush=()=>(a.cancel(),i),a.isPending=()=>r!==null,a},C=e=>e==null||Number.isNaN(e)?``:String(e).trim().replace(/^(-?\d+)(\.\d+)?$/,(e,t,n=``)=>t.replace(/\B(?=(\d{3})+(?!\d))/g,`,`)+n),w=e=>u(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},T=e=>{if(!u(e))return{};let n={...e};for(let e in n){let r=n[e];if(e.includes(`,`)&&t(r)){let t=e.split(`,`),i=r;t.forEach((e,t)=>{n[e]=i[t]}),delete n[e]}}return n},E=(e,n)=>{if(!u(e))return{};let r=t(n)?n:[n],i={...e};return r.forEach(e=>{delete i[e]}),i},D=(e,n=`_`)=>{if(e==null)return e;if(t(e))return e.map(e=>D(e,n)).filter(e=>typeof e==`string`?!e.startsWith(n):typeof e==`number`?!String(e).startsWith(n):!0);if(typeof e!=`object`||e instanceof Date||e instanceof RegExp)return e;let r={};for(let t in e)if(Object.prototype.hasOwnProperty.call(e,t)){let i=e[t];t.startsWith(n)||(r[t]=D(i,n))}return r},O=(e,t=[])=>{if(!u(e))return e;let n={...e};return t.forEach(e=>{if(!Object.prototype.hasOwnProperty.call(n,e))return;let t=n[e];if(typeof t==`string`){n[e]=t.split(`,`).map(e=>e.trim()).filter(Boolean);return}n[e]=t==null?[]:[t]}),n},k=(e,n=[])=>{if(!u(e))return e;let r={...e};return Object.keys(r).forEach(e=>{let i=r[e];n.includes(e)&&t(i)&&(r[e]=i.join(`,`))}),r},A=e=>e===`null`||e===`undefined`||e===``?null:e===`true`?!0:e===`false`?!1:typeof e==`string`&&/^-?(0|[1-9]\d*)(\.\d+)?$/.test(e)?Number(e):e;export{e as buildTree,w as cleanObjectEmptyValues,S as debounce,T as expandCommaKeyObject,p as findBy,m as findIndexBy,h as flatTree,C as formatThousand,b as formatTime,g as insertAfter,t as isArray,r as isArrayLike,i as isBoolean,a as isBooleanLike,o as isEffectiveData,n as isNil,s as isNumber,l as isNumberLike,u as isObject,d as isObjectArray,f as isPrimitive,c as isString,E as omitObjectProps,D as omitStartWithKeys,O as parseStringFieldsToArray,A as parseValue,v as randomRgb,y as randomRgba,_ as removeAfter,k as stringifyArrayFields};

package/dist/types/index.d.ts

@@ -1,6 +1,8 @@
 export * from './modules/array';
 export * from './modules/color';
+export * from './modules/date';
 export * from './modules/function';
+export * from './modules/number';
 export * from './modules/object';
 export * from './modules/parse';
 export * from './modules/type';

package/dist/types/modules/array/buildTree.d.ts

@@ -0,0 +1,7 @@
+export declare const buildTree: <T extends Record<string, any>>(data: T[], options?: {
+    mode?: "parentId" | "level";
+    idKey?: string;
+    parentIdKey?: string;
+    levelKey?: string;
+    childrenKey?: string;
+}) => T[];

package/dist/types/modules/array/findBy.d.ts

@@ -1,3 +1,5 @@
-export declare const findBy: <T extends Record<string, unknown> & {
-    children?: T[];
-}>(array: unknown, target: Partial<T>, childrenKey?: string) => T | T[] | undefined;
+export declare const findBy: <T extends Record<string, any>>(array: unknown, options: {
+    key: keyof T;
+    value: T[keyof T] | T[keyof T][];
+    childrenKey?: keyof T;
+}) => T | T[] | undefined;

package/dist/types/modules/array/flatTree.d.ts

@@ -0,0 +1,4 @@
+export declare const flatTree: <T extends Record<string, any>>(tree: T[], options?: {
+    childrenKey?: string;
+    keepChildren?: boolean;
+}) => T[];

package/dist/types/modules/array/index.d.ts

@@ -1,4 +1,6 @@
+export * from './buildTree';
 export * from './findBy';
 export * from './findIndexBy';
+export * from './flatTree';
 export * from './insertAfter';
 export * from './removeAfter';

package/dist/types/modules/date/formatTime.d.ts

@@ -0,0 +1 @@
+export declare const formatTime: (time: string | number | Date | null | undefined, format?: string, padZero?: boolean) => string | null;

package/dist/types/modules/date/index.d.ts

@@ -0,0 +1 @@
+export * from './formatTime';

package/dist/types/modules/number/formatThousand.d.ts

@@ -0,0 +1 @@
+export declare const formatThousand: (num: unknown) => string;

package/dist/types/modules/number/index.d.ts

@@ -0,0 +1 @@
+export * from './formatThousand';

package/dist/types/modules/type/index.d.ts

@@ -8,4 +8,5 @@ export * from './isNumber';
 export * from './isNumberLike';
 export * from './isObject';
 export * from './isObjectArray';
+export * from './isPrimitive';
 export * from './isString';

package/dist/types/modules/type/isPrimitive.d.ts

@@ -0,0 +1 @@
+export declare const isPrimitive: (v: unknown) => v is string | number | boolean | null | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wyfex/iutils",
-  "version": "0.25.0",
+  "version": "0.30.0",
   "description": "万有前端 X 体系下基于 Vite8 + TypeScript6 构建的 iUtils 工具库",
   "homepage": "https://wyfe.top/idocs/iutils",
   "type": "module",