@tanwan/utils 1.1.0 → 1.2.0

package/dist/validateIdCard.d.ts

@@ -0,0 +1,16 @@
+//#region src/business/validateIdCard/index.d.ts
+/**
+* 校验身份证号码格式（含校验位算法）
+*
+* @param idCard - 18 位身份证号
+* @returns 是否为合法身份证号
+*
+* @example
+* ```ts
+* import validateIdCard from '@tanwan/utils/validateIdCard'
+* validateIdCard('110101199001011234')  // true（示例号，实际需按算法校验）
+* ```
+*/
+declare function validateIdCard(idCard: string): boolean;
+//#endregion
+export { validateIdCard as default };

package/dist/validateIdCard.js

@@ -0,0 +1,62 @@
+//#region src/business/validateIdCard/index.ts
+/**
+* 校验身份证号码格式（含校验位算法）
+*
+* @param idCard - 18 位身份证号
+* @returns 是否为合法身份证号
+*
+* @example
+* ```ts
+* import validateIdCard from '@tanwan/utils/validateIdCard'
+* validateIdCard('110101199001011234')  // true（示例号，实际需按算法校验）
+* ```
+*/
+function validateIdCard(idCard) {
+	if (!/^\d{17}[\dXx]$/.test(idCard)) return false;
+	const provinceCode = idCard.substring(0, 2);
+	if (Number.parseInt(provinceCode) < 11 || Number.parseInt(provinceCode) > 82) return false;
+	const birth = idCard.substring(6, 14);
+	const year = Number.parseInt(birth.substring(0, 4));
+	const month = Number.parseInt(birth.substring(4, 6));
+	const day = Number.parseInt(birth.substring(6, 8));
+	if (year < 1900 || year > 2100) return false;
+	if (month < 1 || month > 12) return false;
+	if (day < 1 || day > 31) return false;
+	const weights = [
+		7,
+		9,
+		10,
+		5,
+		8,
+		4,
+		2,
+		1,
+		6,
+		3,
+		7,
+		9,
+		10,
+		5,
+		8,
+		4,
+		2
+	];
+	const checkCodes = [
+		"1",
+		"0",
+		"X",
+		"9",
+		"8",
+		"7",
+		"6",
+		"5",
+		"4",
+		"3",
+		"2"
+	];
+	let sum = 0;
+	for (let i = 0; i < 17; i++) sum += Number.parseInt(idCard[i]) * weights[i];
+	return checkCodes[sum % 11] === idCard[17].toUpperCase();
+}
+//#endregion
+export { validateIdCard as default };

package/dist/validatePhone.cjs

@@ -0,0 +1,19 @@
+//#region src/business/validatePhone/index.ts
+/**
+* 校验手机号格式
+*
+* @param phone - 待校验的手机号
+* @returns 是否为合法手机号
+*
+* @example
+* ```ts
+* import validatePhone from '@tanwan/utils/validatePhone'
+* validatePhone('18812345678')  // true
+* validatePhone('12345678901')  // false
+* ```
+*/
+function validatePhone(phone) {
+	return /^1[3-9]\d{9}$/.test(phone);
+}
+//#endregion
+module.exports = validatePhone;

package/dist/validatePhone.d.cts

@@ -0,0 +1,16 @@
+//#region src/business/validatePhone/index.d.ts
+/**
+* 校验手机号格式
+*
+* @param phone - 待校验的手机号
+* @returns 是否为合法手机号
+*
+* @example
+* ```ts
+* import validatePhone from '@tanwan/utils/validatePhone'
+* validatePhone('18812345678')  // true
+* validatePhone('12345678901')  // false
+* ```
+*/
+declare function validatePhone(phone: string): boolean;
+export = validatePhone;

package/dist/validatePhone.d.ts

@@ -0,0 +1,17 @@
+//#region src/business/validatePhone/index.d.ts
+/**
+* 校验手机号格式
+*
+* @param phone - 待校验的手机号
+* @returns 是否为合法手机号
+*
+* @example
+* ```ts
+* import validatePhone from '@tanwan/utils/validatePhone'
+* validatePhone('18812345678')  // true
+* validatePhone('12345678901')  // false
+* ```
+*/
+declare function validatePhone(phone: string): boolean;
+//#endregion
+export { validatePhone as default };

package/dist/validatePhone.js

@@ -0,0 +1,19 @@
+//#region src/business/validatePhone/index.ts
+/**
+* 校验手机号格式
+*
+* @param phone - 待校验的手机号
+* @returns 是否为合法手机号
+*
+* @example
+* ```ts
+* import validatePhone from '@tanwan/utils/validatePhone'
+* validatePhone('18812345678')  // true
+* validatePhone('12345678901')  // false
+* ```
+*/
+function validatePhone(phone) {
+	return /^1[3-9]\d{9}$/.test(phone);
+}
+//#endregion
+export { validatePhone as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanwan/utils",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "前端纯JS工具函数库",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -10,7 +10,8 @@
   "jsdelivr": "./dist/index.iife.js",
   "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "license": "MIT",
   "exports": {
@@ -18,113 +19,369 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./array/chunk": {
-      "import": "./dist/array/chunk.js",
-      "require": "./dist/array/chunk.cjs"
+    "./addClass": {
+      "import": "./dist/addClass.js",
+      "require": "./dist/addClass.cjs"
     },
-    "./array/flatten": {
-      "import": "./dist/array/flatten.js",
-      "require": "./dist/array/flatten.cjs"
+    "./camelCase": {
+      "import": "./dist/camelCase.js",
+      "require": "./dist/camelCase.cjs"
     },
-    "./array/groupBy": {
-      "import": "./dist/array/groupBy.js",
-      "require": "./dist/array/groupBy.cjs"
+    "./capitalize": {
+      "import": "./dist/capitalize.js",
+      "require": "./dist/capitalize.cjs"
     },
-    "./array/range": {
-      "import": "./dist/array/range.js",
-      "require": "./dist/array/range.cjs"
+    "./chunk": {
+      "import": "./dist/chunk.js",
+      "require": "./dist/chunk.cjs"
     },
-    "./array/shuffle": {
-      "import": "./dist/array/shuffle.js",
-      "require": "./dist/array/shuffle.cjs"
+    "./clamp": {
+      "import": "./dist/clamp.js",
+      "require": "./dist/clamp.cjs"
     },
-    "./array/unique": {
-      "import": "./dist/array/unique.js",
-      "require": "./dist/array/unique.cjs"
+    "./convertCurrencyToChinese": {
+      "import": "./dist/convertCurrencyToChinese.js",
+      "require": "./dist/convertCurrencyToChinese.cjs"
     },
-    "./base/deepClone": {
-      "import": "./dist/base/deepClone.js",
-      "require": "./dist/base/deepClone.cjs"
+    "./copyToClipboard": {
+      "import": "./dist/copyToClipboard.js",
+      "require": "./dist/copyToClipboard.cjs"
     },
-    "./base/isArray": {
-      "import": "./dist/base/isArray.js",
-      "require": "./dist/base/isArray.cjs"
+    "./createElement": {
+      "import": "./dist/createElement.js",
+      "require": "./dist/createElement.cjs"
     },
-    "./base/isEmpty": {
-      "import": "./dist/base/isEmpty.js",
-      "require": "./dist/base/isEmpty.cjs"
+    "./debounce": {
+      "import": "./dist/debounce.js",
+      "require": "./dist/debounce.cjs"
     },
-    "./base/isObject": {
-      "import": "./dist/base/isObject.js",
-      "require": "./dist/base/isObject.cjs"
+    "./debounceSubmit": {
+      "import": "./dist/debounceSubmit.js",
+      "require": "./dist/debounceSubmit.cjs"
     },
-    "./base/isString": {
-      "import": "./dist/base/isString.js",
-      "require": "./dist/base/isString.cjs"
+    "./decodeBase64": {
+      "import": "./dist/decodeBase64.js",
+      "require": "./dist/decodeBase64.cjs"
     },
-    "./date/formatDate": {
-      "import": "./dist/date/formatDate.js",
-      "require": "./dist/date/formatDate.cjs"
+    "./deepClone": {
+      "import": "./dist/deepClone.js",
+      "require": "./dist/deepClone.cjs"
     },
-    "./date/getRelativeTime": {
-      "import": "./dist/date/getRelativeTime.js",
-      "require": "./dist/date/getRelativeTime.cjs"
+    "./deepMerge": {
+      "import": "./dist/deepMerge.js",
+      "require": "./dist/deepMerge.cjs"
     },
-    "./function/debounce": {
-      "import": "./dist/function/debounce.js",
-      "require": "./dist/function/debounce.cjs"
+    "./delay": {
+      "import": "./dist/delay.js",
+      "require": "./dist/delay.cjs"
     },
-    "./function/delay": {
-      "import": "./dist/function/delay.js",
-      "require": "./dist/function/delay.cjs"
+    "./difference": {
+      "import": "./dist/difference.js",
+      "require": "./dist/difference.cjs"
     },
-    "./function/throttle": {
-      "import": "./dist/function/throttle.js",
-      "require": "./dist/function/throttle.cjs"
+    "./downloadFile": {
+      "import": "./dist/downloadFile.js",
+      "require": "./dist/downloadFile.cjs"
     },
-    "./number/clamp": {
-      "import": "./dist/number/clamp.js",
-      "require": "./dist/number/clamp.cjs"
+    "./encodeBase64": {
+      "import": "./dist/encodeBase64.js",
+      "require": "./dist/encodeBase64.cjs"
     },
-    "./number/formatThousands": {
-      "import": "./dist/number/formatThousands.js",
-      "require": "./dist/number/formatThousands.cjs"
+    "./flatten": {
+      "import": "./dist/flatten.js",
+      "require": "./dist/flatten.cjs"
     },
-    "./number/randomInt": {
-      "import": "./dist/number/randomInt.js",
-      "require": "./dist/number/randomInt.cjs"
+    "./formatBankCard": {
+      "import": "./dist/formatBankCard.js",
+      "require": "./dist/formatBankCard.cjs"
     },
-    "./object/omit": {
-      "import": "./dist/object/omit.js",
-      "require": "./dist/object/omit.cjs"
+    "./formatCurrency": {
+      "import": "./dist/formatCurrency.js",
+      "require": "./dist/formatCurrency.cjs"
     },
-    "./object/pick": {
-      "import": "./dist/object/pick.js",
-      "require": "./dist/object/pick.cjs"
+    "./formatDate": {
+      "import": "./dist/formatDate.js",
+      "require": "./dist/formatDate.cjs"
     },
-    "./string/camelCase": {
-      "import": "./dist/string/camelCase.js",
-      "require": "./dist/string/camelCase.cjs"
+    "./formatFileSize": {
+      "import": "./dist/formatFileSize.js",
+      "require": "./dist/formatFileSize.cjs"
     },
-    "./string/capitalize": {
-      "import": "./dist/string/capitalize.js",
-      "require": "./dist/string/capitalize.cjs"
+    "./formatIdCard": {
+      "import": "./dist/formatIdCard.js",
+      "require": "./dist/formatIdCard.cjs"
     },
-    "./string/kebabCase": {
-      "import": "./dist/string/kebabCase.js",
-      "require": "./dist/string/kebabCase.cjs"
+    "./formatPhone": {
+      "import": "./dist/formatPhone.js",
+      "require": "./dist/formatPhone.cjs"
     },
-    "./string/uuid": {
-      "import": "./dist/string/uuid.js",
-      "require": "./dist/string/uuid.cjs"
+    "./formatThousands": {
+      "import": "./dist/formatThousands.js",
+      "require": "./dist/formatThousands.cjs"
     },
-    "./url/parseQueryString": {
-      "import": "./dist/url/parseQueryString.js",
-      "require": "./dist/url/parseQueryString.cjs"
+    "./generateCode": {
+      "import": "./dist/generateCode.js",
+      "require": "./dist/generateCode.cjs"
     },
-    "./url/stringifyQueryString": {
-      "import": "./dist/url/stringifyQueryString.js",
-      "require": "./dist/url/stringifyQueryString.cjs"
+    "./getAge": {
+      "import": "./dist/getAge.js",
+      "require": "./dist/getAge.cjs"
+    },
+    "./getByPath": {
+      "import": "./dist/getByPath.js",
+      "require": "./dist/getByPath.cjs"
+    },
+    "./getCssVar": {
+      "import": "./dist/getCssVar.js",
+      "require": "./dist/getCssVar.cjs"
+    },
+    "./getRelativeTime": {
+      "import": "./dist/getRelativeTime.js",
+      "require": "./dist/getRelativeTime.cjs"
+    },
+    "./getScrollTop": {
+      "import": "./dist/getScrollTop.js",
+      "require": "./dist/getScrollTop.cjs"
+    },
+    "./getStorage": {
+      "import": "./dist/getStorage.js",
+      "require": "./dist/getStorage.cjs"
+    },
+    "./getStyle": {
+      "import": "./dist/getStyle.js",
+      "require": "./dist/getStyle.cjs"
+    },
+    "./getTextWidth": {
+      "import": "./dist/getTextWidth.js",
+      "require": "./dist/getTextWidth.cjs"
+    },
+    "./groupBy": {
+      "import": "./dist/groupBy.js",
+      "require": "./dist/groupBy.cjs"
+    },
+    "./hasClass": {
+      "import": "./dist/hasClass.js",
+      "require": "./dist/hasClass.cjs"
+    },
+    "./insertAfter": {
+      "import": "./dist/insertAfter.js",
+      "require": "./dist/insertAfter.cjs"
+    },
+    "./intersection": {
+      "import": "./dist/intersection.js",
+      "require": "./dist/intersection.cjs"
+    },
+    "./invert": {
+      "import": "./dist/invert.js",
+      "require": "./dist/invert.cjs"
+    },
+    "./isArray": {
+      "import": "./dist/isArray.js",
+      "require": "./dist/isArray.cjs"
+    },
+    "./isBrowser": {
+      "import": "./dist/isBrowser.js",
+      "require": "./dist/isBrowser.cjs"
+    },
+    "./isDate": {
+      "import": "./dist/isDate.js",
+      "require": "./dist/isDate.cjs"
+    },
+    "./isEmpty": {
+      "import": "./dist/isEmpty.js",
+      "require": "./dist/isEmpty.cjs"
+    },
+    "./isFunction": {
+      "import": "./dist/isFunction.js",
+      "require": "./dist/isFunction.cjs"
+    },
+    "./isInViewport": {
+      "import": "./dist/isInViewport.js",
+      "require": "./dist/isInViewport.cjs"
+    },
+    "./isNil": {
+      "import": "./dist/isNil.js",
+      "require": "./dist/isNil.cjs"
+    },
+    "./isNumber": {
+      "import": "./dist/isNumber.js",
+      "require": "./dist/isNumber.cjs"
+    },
+    "./isObject": {
+      "import": "./dist/isObject.js",
+      "require": "./dist/isObject.cjs"
+    },
+    "./isPrimitive": {
+      "import": "./dist/isPrimitive.js",
+      "require": "./dist/isPrimitive.cjs"
+    },
+    "./isPromise": {
+      "import": "./dist/isPromise.js",
+      "require": "./dist/isPromise.cjs"
+    },
+    "./isString": {
+      "import": "./dist/isString.js",
+      "require": "./dist/isString.cjs"
+    },
+    "./joinUrl": {
+      "import": "./dist/joinUrl.js",
+      "require": "./dist/joinUrl.cjs"
+    },
+    "./kebabCase": {
+      "import": "./dist/kebabCase.js",
+      "require": "./dist/kebabCase.cjs"
+    },
+    "./lazyLoadImages": {
+      "import": "./dist/lazyLoadImages.js",
+      "require": "./dist/lazyLoadImages.cjs"
+    },
+    "./listToTree": {
+      "import": "./dist/listToTree.js",
+      "require": "./dist/listToTree.cjs"
+    },
+    "./mapValues": {
+      "import": "./dist/mapValues.js",
+      "require": "./dist/mapValues.cjs"
+    },
+    "./maskString": {
+      "import": "./dist/maskString.js",
+      "require": "./dist/maskString.cjs"
+    },
+    "./memoize": {
+      "import": "./dist/memoize.js",
+      "require": "./dist/memoize.cjs"
+    },
+    "./off": {
+      "import": "./dist/off.js",
+      "require": "./dist/off.cjs"
+    },
+    "./omit": {
+      "import": "./dist/omit.js",
+      "require": "./dist/omit.cjs"
+    },
+    "./on": {
+      "import": "./dist/on.js",
+      "require": "./dist/on.cjs"
+    },
+    "./once": {
+      "import": "./dist/once.js",
+      "require": "./dist/once.cjs"
+    },
+    "./parseQueryString": {
+      "import": "./dist/parseQueryString.js",
+      "require": "./dist/parseQueryString.cjs"
+    },
+    "./pascalCase": {
+      "import": "./dist/pascalCase.js",
+      "require": "./dist/pascalCase.cjs"
+    },
+    "./pick": {
+      "import": "./dist/pick.js",
+      "require": "./dist/pick.cjs"
+    },
+    "./randomInt": {
+      "import": "./dist/randomInt.js",
+      "require": "./dist/randomInt.cjs"
+    },
+    "./range": {
+      "import": "./dist/range.js",
+      "require": "./dist/range.cjs"
+    },
+    "./removeClass": {
+      "import": "./dist/removeClass.js",
+      "require": "./dist/removeClass.cjs"
+    },
+    "./removeElement": {
+      "import": "./dist/removeElement.js",
+      "require": "./dist/removeElement.cjs"
+    },
+    "./removeStorage": {
+      "import": "./dist/removeStorage.js",
+      "require": "./dist/removeStorage.cjs"
+    },
+    "./retry": {
+      "import": "./dist/retry.js",
+      "require": "./dist/retry.cjs"
+    },
+    "./sample": {
+      "import": "./dist/sample.js",
+      "require": "./dist/sample.cjs"
+    },
+    "./scrollToElement": {
+      "import": "./dist/scrollToElement.js",
+      "require": "./dist/scrollToElement.cjs"
+    },
+    "./setCssVar": {
+      "import": "./dist/setCssVar.js",
+      "require": "./dist/setCssVar.cjs"
+    },
+    "./setStorage": {
+      "import": "./dist/setStorage.js",
+      "require": "./dist/setStorage.cjs"
+    },
+    "./setStyle": {
+      "import": "./dist/setStyle.js",
+      "require": "./dist/setStyle.cjs"
+    },
+    "./shuffle": {
+      "import": "./dist/shuffle.js",
+      "require": "./dist/shuffle.cjs"
+    },
+    "./snakeCase": {
+      "import": "./dist/snakeCase.js",
+      "require": "./dist/snakeCase.cjs"
+    },
+    "./sortBy": {
+      "import": "./dist/sortBy.js",
+      "require": "./dist/sortBy.cjs"
+    },
+    "./stringifyQueryString": {
+      "import": "./dist/stringifyQueryString.js",
+      "require": "./dist/stringifyQueryString.cjs"
+    },
+    "./throttle": {
+      "import": "./dist/throttle.js",
+      "require": "./dist/throttle.cjs"
+    },
+    "./toggleClass": {
+      "import": "./dist/toggleClass.js",
+      "require": "./dist/toggleClass.cjs"
+    },
+    "./treeFind": {
+      "import": "./dist/treeFind.js",
+      "require": "./dist/treeFind.cjs"
+    },
+    "./treeToList": {
+      "import": "./dist/treeToList.js",
+      "require": "./dist/treeToList.cjs"
+    },
+    "./truncate": {
+      "import": "./dist/truncate.js",
+      "require": "./dist/truncate.cjs"
+    },
+    "./uniqBy": {
+      "import": "./dist/uniqBy.js",
+      "require": "./dist/uniqBy.cjs"
+    },
+    "./unique": {
+      "import": "./dist/unique.js",
+      "require": "./dist/unique.cjs"
+    },
+    "./uuid": {
+      "import": "./dist/uuid.js",
+      "require": "./dist/uuid.cjs"
+    },
+    "./validateEmail": {
+      "import": "./dist/validateEmail.js",
+      "require": "./dist/validateEmail.cjs"
+    },
+    "./validateIdCard": {
+      "import": "./dist/validateIdCard.js",
+      "require": "./dist/validateIdCard.cjs"
+    },
+    "./validatePhone": {
+      "import": "./dist/validatePhone.js",
+      "require": "./dist/validatePhone.cjs"
     },
     "./package.json": "./package.json"
   },

package/dist/array/chunk.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk.d.cts","names":[],"sources":["../../src/array/chunk/index.ts"],"mappings":";;;;;;;;;;iBASwB,KAAA,GAAA,CAAS,GAAA,EAAK,CAAA,IAAK,IAAA,WAAe,CAAA;AAAA"}

package/dist/array/chunk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk.d.ts","names":[],"sources":["../../src/array/chunk/index.ts"],"mappings":";;;;;;;;;;iBASwB,KAAA,GAAA,CAAS,GAAA,EAAK,CAAA,IAAK,IAAA,WAAe,CAAA"}

package/dist/array/chunk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk.js","names":[],"sources":["../../src/array/chunk/index.ts"],"sourcesContent":["/**\n * 数组分块\n * @example\n * ```ts\n * import chunk from '@tanwan/utils/chunk'\n * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]\n * chunk(['a', 'b', 'c'], 1) // [['a'], ['b'], ['c']]\n * ```\n */\nexport default function chunk<T>(arr: T[], size: number): T[][] {\n  const result: T[][] = [];\n  for (let i = 0; i < arr.length; i += size) {\n    result.push(arr.slice(i, i + size));\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;AASA,SAAwB,MAAS,KAAU,MAAqB;CAC9D,MAAM,SAAgB,EAAE;AACxB,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK,KACnC,QAAO,KAAK,IAAI,MAAM,GAAG,IAAI,KAAK,CAAC;AAErC,QAAO"}

package/dist/array/flatten.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flatten.d.cts","names":[],"sources":["../../src/array/flatten/index.ts"],"mappings":";;;;;;;;;;iBASwB,OAAA,GAAA,CAAW,GAAA,aAAgB,KAAA,YAA2B,CAAA;AAAA"}

package/dist/array/flatten.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flatten.d.ts","names":[],"sources":["../../src/array/flatten/index.ts"],"mappings":";;;;;;;;;;iBASwB,OAAA,GAAA,CAAW,GAAA,aAAgB,KAAA,YAA2B,CAAA"}

package/dist/array/flatten.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flatten.js","names":[],"sources":["../../src/array/flatten/index.ts"],"sourcesContent":["/**\n * 数组扁平化\n * @example\n * ```ts\n * import flatten from '@tanwan/utils/flatten'\n * flatten([1, [2, [3, 4]]]) // [1, 2, 3, 4]\n * flatten([1, [2, 3]], 1) // [1, 2, 3]\n * ```\n */\nexport default function flatten<T>(arr: unknown[], depth: number = Infinity): T[] {\n  if (depth === 0) return arr as T[];\n  const result: T[] = [];\n  for (const item of arr) {\n    if (Array.isArray(item) && depth > 0) {\n      result.push(...flatten<T>(item, depth - 1));\n    } else {\n      result.push(item as T);\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;AASA,SAAwB,QAAW,KAAgB,QAAgB,UAAe;AAChF,KAAI,UAAU,EAAG,QAAO;CACxB,MAAM,SAAc,EAAE;AACtB,MAAK,MAAM,QAAQ,IACjB,KAAI,MAAM,QAAQ,KAAK,IAAI,QAAQ,EACjC,QAAO,KAAK,GAAG,QAAW,MAAM,QAAQ,EAAE,CAAC;KAE3C,QAAO,KAAK,KAAU;AAG1B,QAAO"}

package/dist/array/groupBy.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"groupBy.d.cts","names":[],"sources":["../../src/array/groupBy/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;iBAuBwB,OAAA,GAAA,CAAW,GAAA,EAAK,CAAA,IAAK,QAAA,QAAgB,CAAA,KAAM,IAAA,EAAM,CAAA,wBAAyB,MAAA,SAAe,CAAA;AAAA"}

package/dist/array/groupBy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"groupBy.d.ts","names":[],"sources":["../../src/array/groupBy/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;iBAuBwB,OAAA,GAAA,CAAW,GAAA,EAAK,CAAA,IAAK,QAAA,QAAgB,CAAA,KAAM,IAAA,EAAM,CAAA,wBAAyB,MAAA,SAAe,CAAA"}

package/dist/array/groupBy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"groupBy.js","names":[],"sources":["../../src/array/groupBy/index.ts"],"sourcesContent":["/**\n * 根据指定的 key 或迭代函数对数组进行分组\n *\n * @param arr - 待分组的数组\n * @param iteratee - 分组依据：可以是属性名或返回分组 key 的函数\n * @returns 分组后的对象\n *\n * @example\n * ```ts\n * import groupBy from '@tanwan/utils/groupBy'\n * // 按属性名分组\n * groupBy([{ type: 'a', val: 1 }, { type: 'b', val: 2 }, { type: 'a', val: 3 }], 'type')\n * // { a: [{ type: 'a', val: 1 }, { type: 'a', val: 3 }], b: [{ type: 'b', val: 2 }] }\n *\n * // 按函数分组\n * groupBy([1.2, 2.3, 3.4], Math.floor)\n * // { 1: [1.2], 2: [2.3], 3: [3.4] }\n *\n * // 按条件分组\n * groupBy([1, 2, 3, 4, 5], (n) => (n % 2 === 0 ? 'even' : 'odd'))\n * // { even: [2, 4], odd: [1, 3, 5] }\n * ```\n */\nexport default function groupBy<T>(arr: T[], iteratee: keyof T | ((item: T) => string | number)): Record<string, T[]> {\n  const result: Record<string, T[]> = {};\n\n  const getKey = typeof iteratee === 'function' ? iteratee : (item: T) => String(item[iteratee]);\n\n  for (const item of arr) {\n    const key = String(getKey(item));\n    if (!result[key]) {\n      result[key] = [];\n    }\n    result[key].push(item);\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAwB,QAAW,KAAU,UAAyE;CACpH,MAAM,SAA8B,EAAE;CAEtC,MAAM,SAAS,OAAO,aAAa,aAAa,YAAY,SAAY,OAAO,KAAK,UAAU;AAE9F,MAAK,MAAM,QAAQ,KAAK;EACtB,MAAM,MAAM,OAAO,OAAO,KAAK,CAAC;AAChC,MAAI,CAAC,OAAO,KACV,QAAO,OAAO,EAAE;AAElB,SAAO,KAAK,KAAK,KAAK;;AAGxB,QAAO"}