@cloudcome/utils-core 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [1.1.1](https://github.com/cloudcome/utils/compare/@cloudcome/utils-core@1.1.0...@cloudcome/utils-core@1.1.1) (2025-08-30)
+
+**Note:** Version bump only for package @cloudcome/utils-core
+
+# 1.1.0 (2025-08-27)
+
+### Bug Fixes
+
+* **utils-core:** 修复 asyncShared 函数的错误处理和类型定义问题 ([27264d2](https://github.com/cloudcome/utils/commit/27264d2b8dc154ca83f0c2becd95ef44c12ec1a6))
+* **utils-core:** 修复 pathRelativize 函数对相对路径的处理 ([f632c9b](https://github.com/cloudcome/utils/commit/f632c9b56e22914958ded53238caf2db9e2c73a8))
+* **utils-core:** 修复 qsParse 函数查询字符串解析问题 ([ce273f9](https://github.com/cloudcome/utils/commit/ce273f9a252a506402858bfa3ab72185fae805d4))
+* **utils-core:** 修正 numberAbbr 函数的计算逻辑 ([b8483c7](https://github.com/cloudcome/utils/commit/b8483c73218894f3b1eec939f59377f2d9049422))
+
+### Features
+
+* **array:** 添加数组差异对比功能 ([35acf91](https://github.com/cloudcome/utils/commit/35acf916a10fa1395633faccac67b7f70e575f2b))
+* **array:** 添加数组差异比较功能 ([4dc5fa7](https://github.com/cloudcome/utils/commit/4dc5fa7a9d5c9e264a2ebb5144bcd9a08656cbed))
+* **async:** 为 asyncShared 函数添加回调事件支持 ([af6737f](https://github.com/cloudcome/utils/commit/af6737fbf0e59f694f229fd566fb0e30f9d9c9b1))
+* **async:** 添加 asyncShared 函数实现异步函数结果共享 ([5883200](https://github.com/cloudcome/utils/commit/588320034e07fec03f0bdd16a521d9a3c65013fb))
+* **cache:** 为缓存添加清除功能并优化测试用例 ([653805e](https://github.com/cloudcome/utils/commit/653805e79965c0c27202b282ac46f486444900fc))
+* **core:** 添加枚举定义和工厂函数 ([6a56ab8](https://github.com/cloudcome/utils/commit/6a56ab874412bad5cf18234d59778756b53c7903))
+* **date:** 优化时区转换逻辑并添加新功能 ([1852c73](https://github.com/cloudcome/utils/commit/1852c731f80e6c2a4ff524e9638349bbc1235c9e))
+* **date:** 增加时区相关功能并优化日期解析 ([993ccfe](https://github.com/cloudcome/utils/commit/993ccfe67fb2979ee9ca6c5c998af6ceca4cf9cd))
+* **number:** 增强 numberFixed 函数功能并优化相关测试 ([c94a9ff](https://github.com/cloudcome/utils/commit/c94a9ff97bc2b95a98356d66f6e1d211e0333cf9))
+* **number:** 添加数字格式化功能并优化相关测试 ([1b23e94](https://github.com/cloudcome/utils/commit/1b23e94f28772168481cff36ce8287a7986da90f))
+* **path:** 添加路径相对化处理函数 ([aaac0a0](https://github.com/cloudcome/utils/commit/aaac0a0b765b4c6cebd7eaa6c6c676fa46b9eb61))
+* **time:** 增强时间转换功能并添加新方法 ([dfaf38f](https://github.com/cloudcome/utils/commit/dfaf38f9c41daa58754ec391f5070e016189e2cc))
+* **time:** 添加时间字符串转换函数并重命名时间处理函数 ([4a08954](https://github.com/cloudcome/utils/commit/4a08954b278874a0d7c84167da0a727f18548d60))
+* **time:** 添加时间格式化相关工具函数 ([2efb2d6](https://github.com/cloudcome/utils/commit/2efb2d6a92b5df0efd6be197d511aefe5e4cd553))
+* **types:** 添加 DeepPartial 类型 ([2d551c5](https://github.com/cloudcome/utils/commit/2d551c5745310ea37f8bd6fe169918d99e3fde12))
+* **tz:** 重构 TZDate 类并添加时区转换功能 ([434e985](https://github.com/cloudcome/utils/commit/434e985141aa2fbd34c9da1048bb21cd50f9268e))
+* **unique:** 增加生成唯一字符串功能 ([287f384](https://github.com/cloudcome/utils/commit/287f384406ea710885b1a68da66ef3dfdddae7f2))
+* **utils-core:** 为 TzDate 类添加 getTimezoneOrder 方法 ([23bbaac](https://github.com/cloudcome/utils/commit/23bbaac597222dad99830048712b6c50b9db4f29))
+* **utils-core:** 优化 arrayDiff 函数返回值结构 ([0fc18c0](https://github.com/cloudcome/utils/commit/0fc18c0ef72145f348de7085c69b09d73d75b58c))
+* **utils-core:** 优化数字工具函数并添加文件大小缩写功能 ([082e070](https://github.com/cloudcome/utils/commit/082e070216bcd74c12d9a2667d6829355c07dcb1))
+* **utils-core:** 实现时区相关工具类 TZDate ([22ec027](https://github.com/cloudcome/utils/commit/22ec02770966cf3f6a4758da711d8489fdbcfb20))
+* **utils-core:** 新增 base64、error、time 和 unique模块 ([ce90232](https://github.com/cloudcome/utils/commit/ce90232ba0dac56346384b8d6f1f608ee3a3b4b7))
+* **utils-core:** 新增错误处理相关工具函数 ([3a9b64a](https://github.com/cloudcome/utils/commit/3a9b64a304c9c055fe60eaf4a97449487110bc9b))
+* **utils-core:** 添加 base64 转换为 Blob 的函数 ([f046578](https://github.com/cloudcome/utils/commit/f0465780b6ce7941449a209188a0a8a9b119ceb8))
+* **utils-core:** 添加 createMinDelayPromise 函数并编写相关测试 ([a436462](https://github.com/cloudcome/utils/commit/a43646286949a35e51db56e647e2a44c9a1a3b84))
+* **utils-core:** 添加 enum 模块并更新相关配置 ([15b5971](https://github.com/cloudcome/utils/commit/15b597149184802a87622d247356e9a5d6731de5))
+* **utils-core:** 添加 stringify 函数并优化类型检查 ([4298f04](https://github.com/cloudcome/utils/commit/4298f04665ff0eae9265305334f2d1c2ed38e59b))
+* **utils-core:** 添加 uniqueBigInt函数并实现相关测试 ([ae37704](https://github.com/cloudcome/utils/commit/ae377042199b75dd9e971d7231767209b1607352))
+* **utils-core:** 添加数组移动函数并优化数组操作 ([461165b](https://github.com/cloudcome/utils/commit/461165b0f7d12395408f3ea92cf5a1d5a4591c19))
+* **utils-core:** 添加自定义异常构建函数 ([1b46a3b](https://github.com/cloudcome/utils/commit/1b46a3b0ec3300c69c954049f03c4acd0f75c09d))
+* **utils-core:** 重构 AsyncQueue 类 ([8fc8b7b](https://github.com/cloudcome/utils/commit/8fc8b7b7771ca53bad96409ff2a8a714f918b4d5))
+* **utils-core:** 重构 qsParse 和 qsStringify 函数 ([9335a3d](https://github.com/cloudcome/utils/commit/9335a3dfa0b5ba501b520b46f2d087fb77114319))

package/LICENSE

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

package/package.json

@@ -1 +1,279 @@
-{"name":"@cloudcome/utils-core","version":"1.1.0","description":"cloudcome core utils","engines":{"node":">=22"},"engineStrict":true,"sideEffects":false,"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json","./array":{"types":"./dist/array.d.ts","import":"./dist/array.mjs","require":"./dist/array.cjs"},"./async":{"types":"./dist/async.d.ts","import":"./dist/async.mjs","require":"./dist/async.cjs"},"./base64":{"types":"./dist/base64.d.ts","import":"./dist/base64.mjs","require":"./dist/base64.cjs"},"./cache":{"types":"./dist/cache.d.ts","import":"./dist/cache.mjs","require":"./dist/cache.cjs"},"./color":{"types":"./dist/color.d.ts","import":"./dist/color.mjs","require":"./dist/color.cjs"},"./crypto":{"types":"./dist/crypto.d.ts","import":"./dist/crypto.mjs","require":"./dist/crypto.cjs"},"./date":{"types":"./dist/date.d.ts","import":"./dist/date.mjs","require":"./dist/date.cjs"},"./dict":{"types":"./dist/dict.d.ts","import":"./dist/dict.mjs","require":"./dist/dict.cjs"},"./easing":{"types":"./dist/easing.d.ts","import":"./dist/easing.mjs","require":"./dist/easing.cjs"},"./emitter":{"types":"./dist/emitter.d.ts","import":"./dist/emitter.mjs","require":"./dist/emitter.cjs"},"./enum":{"types":"./dist/enum.d.ts","import":"./dist/enum.mjs","require":"./dist/enum.cjs"},"./env":{"types":"./dist/env.d.ts","import":"./dist/env.mjs","require":"./dist/env.cjs"},"./error":{"types":"./dist/error.d.ts","import":"./dist/error.mjs","require":"./dist/error.cjs"},"./exception":{"types":"./dist/exception.d.ts","import":"./dist/exception.mjs","require":"./dist/exception.cjs"},"./fn":{"types":"./dist/fn.d.ts","import":"./dist/fn.mjs","require":"./dist/fn.cjs"},"./number":{"types":"./dist/number.d.ts","import":"./dist/number.mjs","require":"./dist/number.cjs"},"./object":{"types":"./dist/object.d.ts","import":"./dist/object.mjs","require":"./dist/object.cjs"},"./path":{"types":"./dist/path.d.ts","import":"./dist/path.mjs","require":"./dist/path.cjs"},"./promise":{"types":"./dist/promise.d.ts","import":"./dist/promise.mjs","require":"./dist/promise.cjs"},"./qs":{"types":"./dist/qs.d.ts","import":"./dist/qs.mjs","require":"./dist/qs.cjs"},"./regexp":{"types":"./dist/regexp.d.ts","import":"./dist/regexp.mjs","require":"./dist/regexp.cjs"},"./string":{"types":"./dist/string.d.ts","import":"./dist/string.mjs","require":"./dist/string.cjs"},"./time":{"types":"./dist/time.d.ts","import":"./dist/time.mjs","require":"./dist/time.cjs"},"./timer":{"types":"./dist/timer.d.ts","import":"./dist/timer.mjs","require":"./dist/timer.cjs"},"./tree":{"types":"./dist/tree.d.ts","import":"./dist/tree.mjs","require":"./dist/tree.cjs"},"./type":{"types":"./dist/type.d.ts","import":"./dist/type.mjs","require":"./dist/type.cjs"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.mjs","require":"./dist/types.cjs"},"./unique":{"types":"./dist/unique.d.ts","import":"./dist/unique.mjs","require":"./dist/unique.cjs"},"./url":{"types":"./dist/url.d.ts","import":"./dist/url.mjs","require":"./dist/url.cjs"},"./version":{"types":"./dist/version.d.ts","import":"./dist/version.mjs","require":"./dist/version.cjs"}},"typesVersions":{"*":{"array":["./dist/array.d.ts"],"async":["./dist/async.d.ts"],"base64":["./dist/base64.d.ts"],"cache":["./dist/cache.d.ts"],"color":["./dist/color.d.ts"],"crypto":["./dist/crypto.d.ts"],"date":["./dist/date.d.ts"],"dict":["./dist/dict.d.ts"],"easing":["./dist/easing.d.ts"],"emitter":["./dist/emitter.d.ts"],"enum":["./dist/enum.d.ts"],"env":["./dist/env.d.ts"],"error":["./dist/error.d.ts"],"exception":["./dist/exception.d.ts"],"fn":["./dist/fn.d.ts"],"number":["./dist/number.d.ts"],"object":["./dist/object.d.ts"],"path":["./dist/path.d.ts"],"promise":["./dist/promise.d.ts"],"qs":["./dist/qs.d.ts"],"regexp":["./dist/regexp.d.ts"],"string":["./dist/string.d.ts"],"time":["./dist/time.d.ts"],"timer":["./dist/timer.d.ts"],"tree":["./dist/tree.d.ts"],"type":["./dist/type.d.ts"],"types":["./dist/types.d.ts"],"unique":["./dist/unique.d.ts"],"url":["./dist/url.d.ts"],"version":["./dist/version.d.ts"]}},"main":"./dist/index.cjs","module":"./dist/index.mjs","types":"./dist/index.d.ts","files":["dist"],"repository":{"url":"https://github.com/cloudcome/utils","directory":"packages/utils-core"}}
+{
+  "name": "@cloudcome/utils-core",
+  "version": "1.1.1",
+  "description": "cloudcome core utils",
+  "engines": {
+    "node": ">=22"
+  },
+  "engineStrict": true,
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json",
+    "./array": {
+      "types": "./dist/array.d.ts",
+      "import": "./dist/array.mjs",
+      "require": "./dist/array.cjs"
+    },
+    "./async": {
+      "types": "./dist/async.d.ts",
+      "import": "./dist/async.mjs",
+      "require": "./dist/async.cjs"
+    },
+    "./base64": {
+      "types": "./dist/base64.d.ts",
+      "import": "./dist/base64.mjs",
+      "require": "./dist/base64.cjs"
+    },
+    "./cache": {
+      "types": "./dist/cache.d.ts",
+      "import": "./dist/cache.mjs",
+      "require": "./dist/cache.cjs"
+    },
+    "./color": {
+      "types": "./dist/color.d.ts",
+      "import": "./dist/color.mjs",
+      "require": "./dist/color.cjs"
+    },
+    "./crypto": {
+      "types": "./dist/crypto.d.ts",
+      "import": "./dist/crypto.mjs",
+      "require": "./dist/crypto.cjs"
+    },
+    "./date": {
+      "types": "./dist/date.d.ts",
+      "import": "./dist/date.mjs",
+      "require": "./dist/date.cjs"
+    },
+    "./dict": {
+      "types": "./dist/dict.d.ts",
+      "import": "./dist/dict.mjs",
+      "require": "./dist/dict.cjs"
+    },
+    "./easing": {
+      "types": "./dist/easing.d.ts",
+      "import": "./dist/easing.mjs",
+      "require": "./dist/easing.cjs"
+    },
+    "./emitter": {
+      "types": "./dist/emitter.d.ts",
+      "import": "./dist/emitter.mjs",
+      "require": "./dist/emitter.cjs"
+    },
+    "./enum": {
+      "types": "./dist/enum.d.ts",
+      "import": "./dist/enum.mjs",
+      "require": "./dist/enum.cjs"
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": "./dist/env.mjs",
+      "require": "./dist/env.cjs"
+    },
+    "./error": {
+      "types": "./dist/error.d.ts",
+      "import": "./dist/error.mjs",
+      "require": "./dist/error.cjs"
+    },
+    "./exception": {
+      "types": "./dist/exception.d.ts",
+      "import": "./dist/exception.mjs",
+      "require": "./dist/exception.cjs"
+    },
+    "./fn": {
+      "types": "./dist/fn.d.ts",
+      "import": "./dist/fn.mjs",
+      "require": "./dist/fn.cjs"
+    },
+    "./number": {
+      "types": "./dist/number.d.ts",
+      "import": "./dist/number.mjs",
+      "require": "./dist/number.cjs"
+    },
+    "./object": {
+      "types": "./dist/object.d.ts",
+      "import": "./dist/object.mjs",
+      "require": "./dist/object.cjs"
+    },
+    "./path": {
+      "types": "./dist/path.d.ts",
+      "import": "./dist/path.mjs",
+      "require": "./dist/path.cjs"
+    },
+    "./promise": {
+      "types": "./dist/promise.d.ts",
+      "import": "./dist/promise.mjs",
+      "require": "./dist/promise.cjs"
+    },
+    "./qs": {
+      "types": "./dist/qs.d.ts",
+      "import": "./dist/qs.mjs",
+      "require": "./dist/qs.cjs"
+    },
+    "./regexp": {
+      "types": "./dist/regexp.d.ts",
+      "import": "./dist/regexp.mjs",
+      "require": "./dist/regexp.cjs"
+    },
+    "./string": {
+      "types": "./dist/string.d.ts",
+      "import": "./dist/string.mjs",
+      "require": "./dist/string.cjs"
+    },
+    "./time": {
+      "types": "./dist/time.d.ts",
+      "import": "./dist/time.mjs",
+      "require": "./dist/time.cjs"
+    },
+    "./timer": {
+      "types": "./dist/timer.d.ts",
+      "import": "./dist/timer.mjs",
+      "require": "./dist/timer.cjs"
+    },
+    "./tree": {
+      "types": "./dist/tree.d.ts",
+      "import": "./dist/tree.mjs",
+      "require": "./dist/tree.cjs"
+    },
+    "./type": {
+      "types": "./dist/type.d.ts",
+      "import": "./dist/type.mjs",
+      "require": "./dist/type.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./unique": {
+      "types": "./dist/unique.d.ts",
+      "import": "./dist/unique.mjs",
+      "require": "./dist/unique.cjs"
+    },
+    "./url": {
+      "types": "./dist/url.d.ts",
+      "import": "./dist/url.mjs",
+      "require": "./dist/url.cjs"
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "import": "./dist/version.mjs",
+      "require": "./dist/version.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "array": [
+        "./dist/array.d.ts"
+      ],
+      "async": [
+        "./dist/async.d.ts"
+      ],
+      "base64": [
+        "./dist/base64.d.ts"
+      ],
+      "cache": [
+        "./dist/cache.d.ts"
+      ],
+      "color": [
+        "./dist/color.d.ts"
+      ],
+      "crypto": [
+        "./dist/crypto.d.ts"
+      ],
+      "date": [
+        "./dist/date.d.ts"
+      ],
+      "dict": [
+        "./dist/dict.d.ts"
+      ],
+      "easing": [
+        "./dist/easing.d.ts"
+      ],
+      "emitter": [
+        "./dist/emitter.d.ts"
+      ],
+      "enum": [
+        "./dist/enum.d.ts"
+      ],
+      "env": [
+        "./dist/env.d.ts"
+      ],
+      "error": [
+        "./dist/error.d.ts"
+      ],
+      "exception": [
+        "./dist/exception.d.ts"
+      ],
+      "fn": [
+        "./dist/fn.d.ts"
+      ],
+      "number": [
+        "./dist/number.d.ts"
+      ],
+      "object": [
+        "./dist/object.d.ts"
+      ],
+      "path": [
+        "./dist/path.d.ts"
+      ],
+      "promise": [
+        "./dist/promise.d.ts"
+      ],
+      "qs": [
+        "./dist/qs.d.ts"
+      ],
+      "regexp": [
+        "./dist/regexp.d.ts"
+      ],
+      "string": [
+        "./dist/string.d.ts"
+      ],
+      "time": [
+        "./dist/time.d.ts"
+      ],
+      "timer": [
+        "./dist/timer.d.ts"
+      ],
+      "tree": [
+        "./dist/tree.d.ts"
+      ],
+      "type": [
+        "./dist/type.d.ts"
+      ],
+      "types": [
+        "./dist/types.d.ts"
+      ],
+      "unique": [
+        "./dist/unique.d.ts"
+      ],
+      "url": [
+        "./dist/url.d.ts"
+      ],
+      "version": [
+        "./dist/version.d.ts"
+      ]
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "repository": "https://github.com/cloudcome/utils",
+  "keywords": [
+    "utils",
+    "cloudcome",
+    "utils-core",
+    "utils-vue",
+    "utils-react",
+    "utils-uni",
+    "utils-node",
+    "utils-browser"
+  ],
+  "homepage": "https://github.com/cloudcome/utils",
+  "license": "MIT",
+  "author": "云淡然 <hi@ydr.me> (https://ydr.me/)"
+}

package/src/array.ts

@@ -0,0 +1,312 @@
+import { isArray, isObject } from './type';
+import type { MaybePromise } from './types';
+
+/**
+ * 检查给定的值是否为类数组对象。
+ *
+ * 类数组对象是指具有 `length` 属性且 `length` 属性为非负数的对象。
+ *
+ * @param unknown - 要检查的值。
+ * @returns 如果值是类数组对象，则返回 `true`，否则返回 `false`。
+ */
+export function isArrayLike(unknown: unknown) {
+  if (isArray(unknown)) return true;
+
+  if (isObject(unknown)) {
+    const arrayLike = unknown as { length: unknown };
+    return typeof arrayLike.length === 'number' && arrayLike.length >= 0;
+  }
+
+  return false;
+}
+
+/**
+ * 从数组中选择指定索引的元素。
+ *
+ * @param array - 要从中选择元素的数组。
+ * @param indexes - 要选择的元素的索引数组。
+ * @returns 包含指定索引元素的新数组。
+ */
+export function arrayPick<T>(array: T[], indexes: number[]) {
+  const indexes2 = [...indexes];
+  return array.filter((_, i) => {
+    const index = indexes2.indexOf(i);
+    if (index === -1) return false;
+    indexes2.splice(index, 1);
+    return true;
+  });
+}
+
+/**
+ * 从数组中排除指定索引的元素。
+ *
+ * @param array - 要从中排除元素的数组。
+ * @param indexes - 要排除的元素的索引数组。
+ * @returns 包含排除指定索引元素后的新数组。
+ */
+export function arrayOmit<T>(array: T[], indexes: number[]) {
+  const indexes2 = [...indexes];
+  return array.filter((_, i) => {
+    const index = indexes2.indexOf(i);
+    if (index === -1) return true;
+    indexes2.splice(index, 1);
+    return false;
+  });
+}
+
+/**
+ * 遍历数组中的每个元素，并对每个元素执行提供的回调函数。
+ *
+ * @param array - 要遍历的数组。
+ * @param iterator - 对每个元素执行的回调函数。如果回调函数返回 `false`，则提前终止遍历。
+ * @param reverse - 是否以相反的顺序遍历数组。默认为 `false`。
+ * @returns 无返回值。
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3];
+ * arrayEach(arr, (item, index) => {
+ *   console.log(item, index);
+ *   if (index === 1) return false; // 提前终止遍历
+ * });
+ * ```
+ */
+export function arrayEach<T>(array: T[], iterator: (item: T, index: number) => false | unknown, reverse = false) {
+  const _array = [...array];
+  const length = array.length;
+
+  if (reverse) {
+    for (let i = length - 1; i >= 0; i--) {
+      if (iterator(_array[i], i) === false) {
+        break;
+      }
+    }
+  } else {
+    for (let i = 0; i < length; i++) {
+      if (iterator(_array[i], i) === false) {
+        break;
+      }
+    }
+  }
+}
+
+/**
+ * 异步遍历数组中的每个元素，并对每个元素执行提供的回调函数。
+ *
+ * @param array - 要遍历的数组。
+ * @param iterator - 对每个元素执行的异步回调函数。如果回调函数返回 `false`，则提前终止遍历。
+ * @param reverse - 是否以相反的顺序遍历数组。默认为 `false`。
+ * @returns 无返回值。
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3];
+ * await arrayEachAsync(arr, async (item, index) => {
+ *   await someAsyncOperation(item);
+ *   if (index === 1) return false; // 提前终止遍历
+ * });
+ * ```
+ */
+export async function arrayEachAsync<T>(
+  array: T[],
+  iterator: (item: T, index: number) => MaybePromise<false | unknown>,
+  reverse = false,
+) {
+  const _array = [...array];
+  const length = array.length;
+
+  if (reverse) {
+    for (let i = length - 1; i >= 0; i--) {
+      if ((await iterator(_array[i], i)) === false) {
+        break;
+      }
+    }
+  } else {
+    for (let i = 0; i < length; i++) {
+      if ((await iterator(_array[i], i)) === false) {
+        break;
+      }
+    }
+  }
+}
+
+/**
+ * 将数组中的元素移动到指定位置。
+ *
+ * @param array - 要移动元素的数组。
+ * @param from - 要移动的元素的起始位置。
+ * @param to - 要移动的元素的目标位置。
+ * @returns 新的数组，其中包含移动后的元素。
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, 3, 4, 5];
+ * const newArr = arrayMove(arr, 1, 3);
+ * // 返回 [1, 3, 4, 2, 5]
+ * ```
+ */
+export function arrayMove<T>(array: T[], from: number, to: number) {
+  const array2 = [...array];
+
+  if (from < 0 || from >= array2.length || to < 0 || to >= array2.length) {
+    return array2;
+  }
+
+  const item = array2[from];
+
+  array2.splice(from, 1);
+  array2.splice(to, 0, item);
+
+  return array2;
+}
+
+/**
+ * 比较两个数组的差异，返回包含删除、新增和相同元素信息的对象
+ *
+ * @template T - 数组元素的类型
+ * @param {T[]} refArray - 参考数组（原始数组）
+ * @param {T[]} curArray - 当前数组（比较数组）
+ * @returns {ArrayDiffs<T>} 包含差异信息的对象
+ *
+ * @example
+ * ```typescript
+ * const ref = [1, 2, 3];
+ * const cur = [2, 3, 4];
+ * const diff = arrayDiff(ref, cur);
+ * // 返回结果:
+ * // {
+ * //   deletes: [{refIndexes: [0], refValue: 1}],
+ * //   adds: [{curIndexes: [2], curValue: 4}],
+ * //   equals: [
+ * //     {refIndexes: [1], curIndexes: [0], refValue: 2, curValue: 2},
+ * //     {refIndexes: [2], curIndexes: [1], refValue: 3, curValue: 3}
+ * //   ]
+ * // }
+ * ```
+ */
+export type ArrayDiffs<T> = {
+  /**
+   * 被删除的元素列表
+   * @type {Array}
+   * @property {number[]} refIndexes - 元素在参考数组中的所有索引位置
+   * @property {T} refValue - 被删除的元素值
+   */
+  deletes: {
+    /**
+     * 元素在参考数组中的所有索引位置
+     * @type {number[]}
+     */
+    refIndexes: number[];
+    /**
+     * 被删除的元素值
+     * @type {T}
+     */
+    refValue: T;
+  }[];
+
+  /**
+   * 新增的元素列表
+   * @type {Array}
+   * @property {number[]} curIndexes - 元素在当前数组中的所有索引位置
+   * @property {T} curValue - 新增的元素值
+   */
+  adds: {
+    /**
+     * 元素在当前数组中的所有索引位置
+     * @type {number[]}
+     */
+    curIndexes: number[];
+    /**
+     * 新增的元素值
+     * @type {T}
+     */
+    curValue: T;
+  }[];
+
+  /**
+   * 相同的元素列表
+   * @type {Array}
+   * @property {number[]} refIndexes - 元素在参考数组中的所有索引位置
+   * @property {number[]} curIndexes - 元素在当前数组中的所有索引位置
+   * @property {T} refValue - 参考数组中的元素值
+   * @property {T} curValue - 当前数组中的元素值
+   */
+  equals: {
+    /**
+     * 元素在参考数组中的所有索引位置
+     * @type {number[]}
+     */
+    refIndexes: number[];
+    /**
+     * 元素在当前数组中的所有索引位置
+     * @type {number[]}
+     */
+    curIndexes: number[];
+    /**
+     * 参考数组中的元素值
+     * @type {T}
+     */
+    refValue: T;
+    /**
+     * 当前数组中的元素值
+     * @type {T}
+     */
+    curValue: T;
+  }[];
+};
+
+export function arrayDiff<T>(refArray: T[], curArray: T[]): ArrayDiffs<T> {
+  const buildMap = (arr: T[]) => {
+    const map = new Map<T, number[]>();
+
+    arr.forEach((item, index) => {
+      const indexes = map.get(item) || [];
+      indexes.push(index);
+      map.set(item, indexes);
+    });
+
+    return map;
+  };
+  const map1 = buildMap(refArray);
+  const map2 = buildMap(curArray);
+  const deletes = new Set<T>();
+  const adds = new Set<T>();
+  const equals = new Set<T>();
+
+  for (const key of map1.keys()) {
+    if (map2.has(key)) {
+      equals.add(key);
+    } else {
+      deletes.add(key);
+    }
+  }
+
+  for (const key of map2.keys()) {
+    if (!map1.has(key)) {
+      adds.add(key);
+    }
+  }
+
+  return {
+    deletes: [...deletes].map((it) => ({
+      // biome-ignore lint/style/noNonNullAssertion: <explanation>
+      refIndexes: map1.get(it)!,
+      refValue: it,
+    })),
+
+    adds: [...adds].map((it) => ({
+      // biome-ignore lint/style/noNonNullAssertion: <explanation>
+      curIndexes: map2.get(it)!,
+      curValue: it,
+    })),
+
+    equals: [...equals].map((it) => ({
+      // biome-ignore lint/style/noNonNullAssertion: <explanation>
+      refIndexes: map1.get(it)!,
+      // biome-ignore lint/style/noNonNullAssertion: <explanation>
+      curIndexes: map2.get(it)!,
+      refValue: it,
+      curValue: it,
+    })),
+  };
+}