@cloudcome/utils-core 1.1.1 → 1.2.1

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,
-    })),
-  };
-}