@cloudcome/utils-core 1.1.1 → 1.2.0

package/dist/url.mjs

@@ -0,0 +1,37 @@
+function urlParse(url) {
+  let result = null;
+  try {
+    result = new globalThis.URL(url);
+  } catch (e) {
+  }
+  const protocol = (result == null ? void 0 : result.protocol) || "";
+  const host = (result == null ? void 0 : result.host) || "";
+  return {
+    protocol,
+    host,
+    hostname: (result == null ? void 0 : result.hostname) || "",
+    port: (result == null ? void 0 : result.port) || "",
+    pathname: (result == null ? void 0 : result.pathname) || "",
+    search: (result == null ? void 0 : result.search) || "",
+    hash: (result == null ? void 0 : result.hash) || "",
+    username: (result == null ? void 0 : result.username) || "",
+    password: (result == null ? void 0 : result.password) || ""
+  };
+}
+function urlStringify(url) {
+  const { protocol, hostname, port, pathname, search, hash, username, password } = url;
+  return [
+    protocol ? `${protocol}//` : "",
+    username && password ? `${username}:${password}@` : "",
+    hostname,
+    port ? `:${port}` : "",
+    pathname,
+    search,
+    hash
+  ].filter(Boolean).join("");
+}
+export {
+  urlParse,
+  urlStringify
+};
+//# sourceMappingURL=url.mjs.map

package/dist/url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.mjs","sources":["../src/url.ts"],"sourcesContent":["/**\n * 表示解析后的 URL 组件。\n */\nexport type TURLMeta = {\n  /**\n   * 协议部分，包含冒号，例如 \"https:\"。\n   */\n  protocol: string;\n  /**\n   * 主机部分，包括主机名和端口。\n   */\n  host: string;\n  /**\n   * 主机名部分。\n   */\n  hostname: string;\n  /**\n   * 端口部分。\n   */\n  port: string;\n  /**\n   * 路径部分。\n   */\n  pathname: string;\n  /**\n   * 查询字符串部分。\n   */\n  search: string;\n  /**\n   * 哈希部分。\n   */\n  hash: string;\n  /**\n   * 用户名部分。\n   */\n  username: string;\n  /**\n   * 密码部分。\n   */\n  password: string;\n};\n\n/**\n * 解析 URL 字符串为组件对象。\n * @param url - 需要解析的 URL 字符串。\n * @returns 包含解析后 URL 组件的对象。\n */\nexport function urlParse(url: string): TURLMeta {\n  let result: URL | null = null;\n\n  try {\n    // 添加 globalThis 是便于对接外部环境 URL 的自行实现\n    // 例如在 uni-app、微信小程序等运行环境。\n    result = new globalThis.URL(url);\n  } catch (e) {\n    // ignore\n  }\n\n  const protocol = result?.protocol || '';\n  const host = result?.host || '';\n\n  return {\n    protocol,\n    host,\n    hostname: result?.hostname || '',\n    port: result?.port || '',\n    pathname: result?.pathname || '',\n    search: result?.search || '',\n    hash: result?.hash || '',\n    username: result?.username || '',\n    password: result?.password || '',\n  };\n}\n\n/**\n * 将 URLInfo 对象转换回 URL 字符串。\n * @param url - 需要转换的 URLInfo 对象。\n * @returns 转换后的 URL 字符串。\n */\nexport function urlStringify(url: TURLMeta) {\n  const { protocol, hostname, port, pathname, search, hash, username, password } = url;\n  return [\n    protocol ? `${protocol}//` : '',\n    username && password ? `${username}:${password}@` : '',\n    hostname,\n    port ? `:${port}` : '',\n    pathname,\n    search,\n    hash,\n  ]\n    .filter(Boolean)\n    .join('');\n}\n"],"names":[],"mappings":"AA+CO,SAAS,SAAS,KAAuB;AAC9C,MAAI,SAAqB;AAErB,MAAA;AAGO,aAAA,IAAI,WAAW,IAAI,GAAG;AAAA,WACxB,GAAG;AAAA,EAAA;AAIN,QAAA,YAAW,iCAAQ,aAAY;AAC/B,QAAA,QAAO,iCAAQ,SAAQ;AAEtB,SAAA;AAAA,IACL;AAAA,IACA;AAAA,IACA,WAAU,iCAAQ,aAAY;AAAA,IAC9B,OAAM,iCAAQ,SAAQ;AAAA,IACtB,WAAU,iCAAQ,aAAY;AAAA,IAC9B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,OAAM,iCAAQ,SAAQ;AAAA,IACtB,WAAU,iCAAQ,aAAY;AAAA,IAC9B,WAAU,iCAAQ,aAAY;AAAA,EAChC;AACF;AAOO,SAAS,aAAa,KAAe;AACpC,QAAA,EAAE,UAAU,UAAU,MAAM,UAAU,QAAQ,MAAM,UAAU,SAAA,IAAa;AAC1E,SAAA;AAAA,IACL,WAAW,GAAG,QAAQ,OAAO;AAAA,IAC7B,YAAY,WAAW,GAAG,QAAQ,IAAI,QAAQ,MAAM;AAAA,IACpD;AAAA,IACA,OAAO,IAAI,IAAI,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,EAEC,EAAA,OAAO,OAAO,EACd,KAAK,EAAE;AACZ;"}

package/dist/version.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const type = require("./type.cjs");
+function internal_numerical(n) {
+  return Number.isNaN(n) || type.isUndefined(n) ? 0 : n;
+}
+function versionParse(version) {
+  const [major, minor, patch] = version.split(".").map(Number);
+  return {
+    major: internal_numerical(major),
+    minor: internal_numerical(minor),
+    patch: internal_numerical(patch)
+  };
+}
+function versionCompare(version1, version2) {
+  const vo1 = versionParse(version1);
+  const vo2 = versionParse(version2);
+  const order = ["major", "minor", "patch"];
+  for (const key of order) {
+    const n1 = vo1[key];
+    const n2 = vo2[key];
+    if (n1 > n2) {
+      return 1;
+    }
+    if (n1 < n2) {
+      return -1;
+    }
+  }
+  return 0;
+}
+exports.versionCompare = versionCompare;
+exports.versionParse = versionParse;
+//# sourceMappingURL=version.cjs.map

package/dist/version.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["import { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type TVersionObject = {\n  /**\n   * 主版本号，当有不兼容的API修改时递增\n   */\n  major: number;\n  /**\n   * 次版本号，当有向下兼容的功能新增时递增\n   */\n  minor: number;\n  /**\n   * 修订号，当有向下兼容的问题修正时递增\n   */\n  patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param n - 要转换的数字\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(n?: number) {\n  return Number.isNaN(n) || isUndefined(n) ? 0 : n;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): TVersionObject {\n  const [major, minor, patch] = version.split('.').map(Number);\n  return {\n    major: internal_numerical(major),\n    minor: internal_numerical(minor),\n    patch: internal_numerical(patch),\n  };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n  const vo1 = versionParse(version1);\n  const vo2 = versionParse(version2);\n  const order: (keyof TVersionObject)[] = ['major', 'minor', 'patch'];\n\n  for (const key of order) {\n    const n1 = vo1[key];\n    const n2 = vo2[key];\n\n    if (n1 > n2) {\n      return 1;\n    }\n\n    if (n1 < n2) {\n      return -1;\n    }\n  }\n\n  return 0;\n}\n"],"names":["isUndefined"],"mappings":";;;AAyBA,SAAS,mBAAmB,GAAY;AACtC,SAAO,OAAO,MAAM,CAAC,KAAKA,KAAAA,YAAY,CAAC,IAAI,IAAI;AACjD;AAQO,SAAS,aAAa,SAAiC;AACtD,QAAA,CAAC,OAAO,OAAO,KAAK,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI,MAAM;AACpD,SAAA;AAAA,IACL,OAAO,mBAAmB,KAAK;AAAA,IAC/B,OAAO,mBAAmB,KAAK;AAAA,IAC/B,OAAO,mBAAmB,KAAK;AAAA,EACjC;AACF;AASgB,SAAA,eAAe,UAAkB,UAA0B;AACnE,QAAA,MAAM,aAAa,QAAQ;AAC3B,QAAA,MAAM,aAAa,QAAQ;AACjC,QAAM,QAAkC,CAAC,SAAS,SAAS,OAAO;AAElE,aAAW,OAAO,OAAO;AACjB,UAAA,KAAK,IAAI,GAAG;AACZ,UAAA,KAAK,IAAI,GAAG;AAElB,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAGT,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAAA,EACT;AAGK,SAAA;AACT;;;"}

package/dist/version.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 表示包含主版本号、次版本号和修订号的对象
+ */
+export type TVersionObject = {
+    /**
+     * 主版本号，当有不兼容的API修改时递增
+     */
+    major: number;
+    /**
+     * 次版本号，当有向下兼容的功能新增时递增
+     */
+    minor: number;
+    /**
+     * 修订号，当有向下兼容的问题修正时递增
+     */
+    patch: number;
+};
+/**
+ * 将语义化版本号字符串解析为VersionObject对象
+ * @param version - 要解析的版本号字符串 (例如 "1.2.3")
+ * @returns 包含主版本号、次版本号和修订号的对象
+ * @throws 如果版本号字符串格式无效将抛出错误
+ */
+export declare function versionParse(version: string): TVersionObject;
+/**
+ * 比较两个语义化版本号字符串
+ * @param version1 - 要比较的第一个版本号字符串
+ * @param version2 - 要比较的第二个版本号字符串
+ * @returns 如果version1较大返回1，version2较大返回-1，相等返回0
+ * @throws 如果任一版本号字符串格式无效将抛出错误
+ */
+export declare function versionCompare(version1: string, version2: string): number;

package/dist/version.mjs

@@ -0,0 +1,33 @@
+import { isUndefined } from "./type.mjs";
+function internal_numerical(n) {
+  return Number.isNaN(n) || isUndefined(n) ? 0 : n;
+}
+function versionParse(version) {
+  const [major, minor, patch] = version.split(".").map(Number);
+  return {
+    major: internal_numerical(major),
+    minor: internal_numerical(minor),
+    patch: internal_numerical(patch)
+  };
+}
+function versionCompare(version1, version2) {
+  const vo1 = versionParse(version1);
+  const vo2 = versionParse(version2);
+  const order = ["major", "minor", "patch"];
+  for (const key of order) {
+    const n1 = vo1[key];
+    const n2 = vo2[key];
+    if (n1 > n2) {
+      return 1;
+    }
+    if (n1 < n2) {
+      return -1;
+    }
+  }
+  return 0;
+}
+export {
+  versionCompare,
+  versionParse
+};
+//# sourceMappingURL=version.mjs.map

package/dist/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","sources":["../src/version.ts"],"sourcesContent":["import { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type TVersionObject = {\n  /**\n   * 主版本号，当有不兼容的API修改时递增\n   */\n  major: number;\n  /**\n   * 次版本号，当有向下兼容的功能新增时递增\n   */\n  minor: number;\n  /**\n   * 修订号，当有向下兼容的问题修正时递增\n   */\n  patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param n - 要转换的数字\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(n?: number) {\n  return Number.isNaN(n) || isUndefined(n) ? 0 : n;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): TVersionObject {\n  const [major, minor, patch] = version.split('.').map(Number);\n  return {\n    major: internal_numerical(major),\n    minor: internal_numerical(minor),\n    patch: internal_numerical(patch),\n  };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n  const vo1 = versionParse(version1);\n  const vo2 = versionParse(version2);\n  const order: (keyof TVersionObject)[] = ['major', 'minor', 'patch'];\n\n  for (const key of order) {\n    const n1 = vo1[key];\n    const n2 = vo2[key];\n\n    if (n1 > n2) {\n      return 1;\n    }\n\n    if (n1 < n2) {\n      return -1;\n    }\n  }\n\n  return 0;\n}\n"],"names":[],"mappings":";AAyBA,SAAS,mBAAmB,GAAY;AACtC,SAAO,OAAO,MAAM,CAAC,KAAK,YAAY,CAAC,IAAI,IAAI;AACjD;AAQO,SAAS,aAAa,SAAiC;AACtD,QAAA,CAAC,OAAO,OAAO,KAAK,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI,MAAM;AACpD,SAAA;AAAA,IACL,OAAO,mBAAmB,KAAK;AAAA,IAC/B,OAAO,mBAAmB,KAAK;AAAA,IAC/B,OAAO,mBAAmB,KAAK;AAAA,EACjC;AACF;AASgB,SAAA,eAAe,UAAkB,UAA0B;AACnE,QAAA,MAAM,aAAa,QAAQ;AAC3B,QAAA,MAAM,aAAa,QAAQ;AACjC,QAAM,QAAkC,CAAC,SAAS,SAAS,OAAO;AAElE,aAAW,OAAO,OAAO;AACjB,UAAA,KAAK,IAAI,GAAG;AACZ,UAAA,KAAK,IAAI,GAAG;AAElB,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAGT,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAAA,EACT;AAGK,SAAA;AACT;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-core",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "cloudcome core utils",
   "engines": {
     "node": ">=22"
@@ -262,7 +262,13 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "repository": "https://github.com/cloudcome/utils",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloudcome/utils.git"
+  },
   "keywords": [
     "utils",
     "cloudcome",

package/CHANGELOG.md

@@ -1,52 +0,0 @@
-# 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/src/array.ts

@@ -1,312 +0,0 @@
-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,
-    })),
-  };
-}