@wyfex/iutils 0.15.0

package/README.md

@@ -0,0 +1,18 @@
+# wyfex-iutils
+
+万有前端体系下基于 Vite8 + TypeScript6 构建的 iUtils 工具库
+
+## 文档地址 
+> https://wyfe.top/idoc/iutils
+
+## npm下载(支持pnpm/yarn/cnpm/npm)
+```shell
+$ pnpm i @wyfex/iutils
+```
+
+## 版本号规则
++ 仅升级组件库依赖（升级vite、typescript其一或全部），修改第1位。eg：1.x.x；
++ 仅新增工具函数，修改第2位。eg：x.6.x；
++ 仅修复、优化现有工具函数，修改第3位。eg：x.x.1；
++ 以上3项都有变更或部分有变更则按照对应变更修改对应版本号位置；
++ 当对第1、2项有变更且上个版本第3位不为0时，需将第3位置为0。

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>Array.isArray(e),t=(t,n,r,i=`find`)=>{if(!e(t))return;let a=e=>i===`find`?t.find(t=>t[n]===e)??void 0:t.findIndex(t=>t[n]===e);return e(r)?r.map(a):a(r)},n=(t,n,r)=>{if(!e(t))return[...t];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},r=(e,t,n=1)=>{let[r,i]=Object.entries(t)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=e.findIndex(e=>e[r]===i);if(a===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let o=a+1;if(o>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let s=[...e];return s.splice(o,n),s},i=e=>Object.prototype.toString.call(e)===`[object Object]`,a=e=>i(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},o=t=>{if(!i(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},s=(t,n)=>{if(!i(t))return{};let r=e(n)?n:[n],a={...t};return r.forEach(e=>{delete a[e]}),a},c=(e,t=[])=>{if(!i(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},l=(t,n=[])=>{if(!i(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},u=e=>typeof e==`boolean`,d=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),f=e=>Object.prototype.toString.call(e)===`[object String]`,p=e=>d(e)||f(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),m=t=>!e(t)||t.length===0?!1:t.every(e=>i(e));exports.cleanObjectEmptyValues=a,exports.expandCommaKeyObject=o,exports.findByKey=t,exports.insertItemsAfterTarget=n,exports.isArray=e,exports.isBoolean=u,exports.isNumber=d,exports.isNumberLike=p,exports.isObject=i,exports.isObjectArray=m,exports.isString=f,exports.omitObjectProps=s,exports.parseStringFieldsToArray=c,exports.removeItemsAfterTarget=r,exports.stringifyArrayFields=l;

package/dist/index.iife.js

@@ -0,0 +1 @@
+var WyfeIutils=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=e=>Array.isArray(e),n=(e,n,r,i=`find`)=>{if(!t(e))return;let a=t=>i===`find`?e.find(e=>e[n]===t)??void 0:e.findIndex(e=>e[n]===t);return t(r)?r.map(a):a(r)},r=(e,n,r)=>{if(!t(e))return[...e];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},i=(e,t,n=1)=>{let[r,i]=Object.entries(t)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=e.findIndex(e=>e[r]===i);if(a===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let o=a+1;if(o>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let s=[...e];return s.splice(o,n),s},a=e=>Object.prototype.toString.call(e)===`[object Object]`,o=e=>a(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},s=e=>{if(!a(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},c=(e,n)=>{if(!a(e))return{};let r=t(n)?n:[n],i={...e};return r.forEach(e=>{delete i[e]}),i},l=(e,t=[])=>{if(!a(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},u=(e,n=[])=>{if(!a(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},d=e=>typeof e==`boolean`,f=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),p=e=>Object.prototype.toString.call(e)===`[object String]`;return e.cleanObjectEmptyValues=o,e.expandCommaKeyObject=s,e.findByKey=n,e.insertItemsAfterTarget=r,e.isArray=t,e.isBoolean=d,e.isNumber=f,e.isNumberLike=e=>f(e)||p(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),e.isObject=a,e.isObjectArray=e=>!t(e)||e.length===0?!1:e.every(e=>a(e)),e.isString=p,e.omitObjectProps=c,e.parseStringFieldsToArray=l,e.removeItemsAfterTarget=i,e.stringifyArrayFields=u,e})({});

package/dist/index.js

@@ -0,0 +1 @@
+var e=e=>Array.isArray(e),t=(t,n,r,i=`find`)=>{if(!e(t))return;let a=e=>i===`find`?t.find(t=>t[n]===e)??void 0:t.findIndex(t=>t[n]===e);return e(r)?r.map(a):a(r)},n=(t,n,r)=>{if(!e(t))return[...t];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},r=(e,t,n=1)=>{let[r,i]=Object.entries(t)[0]??[];if(!r||i===void 0)return console.error(`target 必须传入有效键值对，格式示例：{ id: 1 }`),[...e];let a=e.findIndex(e=>e[r]===i);if(a===-1)return console.error(`在数组中未找到匹配的目标元素`),[...e];let o=a+1;if(o>=e.length)return console.error(`目标元素已是数组最后一项，无后续数据可删除`),[...e];let s=[...e];return s.splice(o,n),s},i=e=>Object.prototype.toString.call(e)===`[object Object]`,a=e=>i(e)?Object.fromEntries(Object.entries(e).filter(([e,t])=>t!=null)):{},o=t=>{if(!i(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},s=(t,n)=>{if(!i(t))return{};let r=e(n)?n:[n],a={...t};return r.forEach(e=>{delete a[e]}),a},c=(e,t=[])=>{if(!i(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},l=(t,n=[])=>{if(!i(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},u=e=>typeof e==`boolean`,d=e=>Object.prototype.toString.call(e)===`[object Number]`&&Number.isFinite(e),f=e=>Object.prototype.toString.call(e)===`[object String]`,p=e=>d(e)||f(e)&&e.trim()!==``&&!Number.isNaN(Number(e)),m=t=>!e(t)||t.length===0?!1:t.every(e=>i(e));export{a as cleanObjectEmptyValues,o as expandCommaKeyObject,t as findByKey,n as insertItemsAfterTarget,e as isArray,u as isBoolean,d as isNumber,p as isNumberLike,i as isObject,m as isObjectArray,f as isString,s as omitObjectProps,c as parseStringFieldsToArray,r as removeItemsAfterTarget,l as stringifyArrayFields};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './modules/array';
+export * from './modules/object';
+export * from './modules/type';

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

@@ -0,0 +1 @@
+export declare const findByKey: <T = Record<string, unknown>>(array: T[], targetKey: keyof T, value: T[keyof T] | T[keyof T][], type?: "find" | "findIndex") => T | number | (T | number)[] | undefined;

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

@@ -0,0 +1,3 @@
+export * from './findByKey';
+export * from './insertItemsAfterTarget';
+export * from './removeItemsAfterTarget ';

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

@@ -0,0 +1 @@
+export declare const insertItemsAfterTarget: <T extends Record<string, unknown>>(array: T[], target: Partial<T>, newData: T | T[]) => T[];

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

@@ -0,0 +1 @@
+export declare const removeItemsAfterTarget: <T extends Record<string, unknown>>(array: T[], target: Partial<T>, deleteCount?: number) => T[];

package/dist/types/modules/object/cleanObjectEmptyValues.d.ts

@@ -0,0 +1 @@
+export declare const cleanObjectEmptyValues: <T extends Record<string, unknown>>(obj: T) => Partial<T>;

package/dist/types/modules/object/expandCommaKeyObject.d.ts

@@ -0,0 +1 @@
+export declare const expandCommaKeyObject: (obj: Record<string, unknown>) => Record<string, unknown>;

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

@@ -0,0 +1,5 @@
+export * from './cleanObjectEmptyValues';
+export * from './expandCommaKeyObject';
+export * from './omitObjectProps';
+export * from './parseStringFieldsToArray';
+export * from './stringifyArrayFields';

package/dist/types/modules/object/omitObjectProps.d.ts

@@ -0,0 +1 @@
+export declare const omitObjectProps: <T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K | K[]) => Omit<T, K>;

package/dist/types/modules/object/parseStringFieldsToArray.d.ts

@@ -0,0 +1 @@
+export declare const parseStringFieldsToArray: (obj: Record<string, unknown>, fields?: string[]) => Record<string, unknown>;

package/dist/types/modules/object/stringifyArrayFields.d.ts

@@ -0,0 +1 @@
+export declare const stringifyArrayFields: (obj: Record<string, unknown>, includes?: string[]) => Record<string, unknown>;

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

@@ -0,0 +1,7 @@
+export * from './isArray';
+export * from './isBoolean';
+export * from './isNumber';
+export * from './isNumberLike';
+export * from './isObject';
+export * from './isObjectArray';
+export * from './isString';

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

@@ -0,0 +1 @@
+export declare const isArray: (v: unknown) => v is any[];

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

@@ -0,0 +1 @@
+export declare const isBoolean: (v: unknown) => v is boolean;

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

@@ -0,0 +1 @@
+export declare const isNumber: (v: unknown) => v is number;

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

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

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

@@ -0,0 +1 @@
+export declare const isObject: (v: unknown) => v is Record<string, any>;

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

@@ -0,0 +1 @@
+export declare const isObjectArray: (v: unknown) => v is Record<string, any>[];

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

@@ -0,0 +1 @@
+export declare const isString: (v: unknown) => v is string;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@wyfex/iutils",
+  "version": "0.15.0",
+  "description": "万有前端体系下基于 Vite8 + TypeScript6 构建的 iUtils 工具库",
+  "homepage": "https://wyfe.top/idoc/iutils",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "gen:exports": "node scripts/gen-exports.js",
+    "dev": "pnpm gen:exports && vite",
+    "build": "pnpm gen:exports && vite build && tsc",
+    "tgz": "pnpm build && pnpm pack"
+  },
+  "keywords": [
+    "万有前端",
+    "万有前端·iUtils",
+    "wyfex",
+    "wyfex-iutils"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Symbol(王独秀) <963569210@qq.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.9.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.13"
+  }
+}