npm - @cloudcome/utils-core - Versions diffs - 1.20.0 → 1.20.1 - Mend

@cloudcome/utils-core 1.20.0 → 1.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (58) hide show

package/README.md CHANGED Viewed

@@ -9,15 +9,15 @@
 ## 包列表
-| 名称 | 版本 | 描述 |
-| --- | --- | --- |
-| [@cloudcome/utils-core](./packages/utils-core) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-core.svg)](https://npmjs.com/package/@cloudcome/utils-core) | 核心工具库，与运行环境无关的通用工具 |
+| 名称                                                 | 版本                                                                                                                          | 描述                                          |
+| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
+| [@cloudcome/utils-core](./packages/utils-core)       | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-core.svg)](https://npmjs.com/package/@cloudcome/utils-core)       | 核心工具库，与运行环境无关的通用工具          |
 | [@cloudcome/utils-browser](./packages/utils-browser) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-browser.svg)](https://npmjs.com/package/@cloudcome/utils-browser) | 浏览器端工具（DOM、Canvas、Cookie、剪贴板等） |
-| [@cloudcome/utils-node](./packages/utils-node) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-node.svg)](https://npmjs.com/package/@cloudcome/utils-node) | Node.js 端工具（Base64、加密等） |
-| [@cloudcome/utils-vue](./packages/utils-vue) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-vue.svg)](https://npmjs.com/package/@cloudcome/utils-vue) | Vue 3 工具库（组合式函数、组件、请求等） |
-| [@cloudcome/utils-react](./packages/utils-react) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-react.svg)](https://npmjs.com/package/@cloudcome/utils-react) | React 工具库 |
-| [@cloudcome/utils-uni](./packages/utils-uni) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-uni.svg)](https://npmjs.com/package/@cloudcome/utils-uni) | UniApp 工具库（云函数、数据库、页面等） |
-| [@cloudcome/docs](./packages/docs) | - | VitePress 文档站点 |
+| [@cloudcome/utils-node](./packages/utils-node)       | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-node.svg)](https://npmjs.com/package/@cloudcome/utils-node)       | Node.js 端工具（Base64、加密、JSONL 等）      |
+| [@cloudcome/utils-vue](./packages/utils-vue)         | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-vue.svg)](https://npmjs.com/package/@cloudcome/utils-vue)         | Vue 3 工具库（组合式函数、组件、请求等）      |
+| [@cloudcome/utils-react](./packages/utils-react)     | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-react.svg)](https://npmjs.com/package/@cloudcome/utils-react)     | React 工具库                                  |
+| [@cloudcome/utils-uni](./packages/utils-uni)         | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-uni.svg)](https://npmjs.com/package/@cloudcome/utils-uni)         | UniApp 工具库（云函数、数据库、页面等）       |
+| [@cloudcome/docs](./packages/docs)                   | -                                                                                                                             | VitePress 文档站点                            |
 ## 功能概览
@@ -25,79 +25,80 @@
 核心工具库，提供以下子模块：
-| 子模块 | 导入路径 | 功能 |
-| --- | --- | --- |
-| array | `@cloudcome/utils-core/array` | 数组操作 |
-| async | `@cloudcome/utils-core/async` | 异步工具 |
-| base64 | `@cloudcome/utils-core/base64` | Base64 编解码 |
-| cache | `@cloudcome/utils-core/cache` | 缓存工具 |
-| color | `@cloudcome/utils-core/color` | 颜色转换（RGB/HSL/HSV/HWB/LAB/XYZ）、对比度、亮度、混合 |
-| crypto | `@cloudcome/utils-core/crypto` | 加密（MD5、SHA1、SHA256、SHA512） |
-| date | `@cloudcome/utils-core/date` | 日期解析、格式化、时区、相对时间、周/天计算 |
-| dict | `@cloudcome/utils-core/dict` | 字典/映射工具 |
-| easing | `@cloudcome/utils-core/easing` | 缓动函数 |
-| emitter | `@cloudcome/utils-core/emitter` | 事件发射器 |
-| env | `@cloudcome/utils-core/env` | 环境检测 |
-| error | `@cloudcome/utils-core/error` | 错误处理 |
-| exception | `@cloudcome/utils-core/exception` | 异常处理 |
-| function | `@cloudcome/utils-core/function` | 函数工具 |
-| number | `@cloudcome/utils-core/number` | 数字工具 |
-| object | `@cloudcome/utils-core/object` | 对象遍历、深层 get/set、合并、类型判断 |
-| path | `@cloudcome/utils-core/path` | 路径工具 |
-| promise | `@cloudcome/utils-core/promise` | Promise 工具 |
-| qs | `@cloudcome/utils-core/qs` | 查询字符串解析与序列化 |
-| regexp | `@cloudcome/utils-core/regexp` | 正则表达式工具 |
-| string | `@cloudcome/utils-core/string` | 字符串工具 |
-| time | `@cloudcome/utils-core/time` | 时间单位转换 |
-| timer | `@cloudcome/utils-core/timer` | 定时器工具 |
-| tree | `@cloudcome/utils-core/tree` | 树结构操作 |
-| try | `@cloudcome/utils-core/try` | 安全调用（try-catch 包装，支持同步/异步/柯里化） |
-| type | `@cloudcome/utils-core/type` | 类型判断 |
-| types | `@cloudcome/utils-core/types` | 公共类型定义 |
-| unique | `@cloudcome/utils-core/unique` | 唯一 ID 生成 |
-| url | `@cloudcome/utils-core/url` | URL 解析与构建 |
-| version | `@cloudcome/utils-core/version` | 版本号比较 |
+| 子模块    | 导入路径                          | 功能                                                    |
+| --------- | --------------------------------- | ------------------------------------------------------- |
+| array     | `@cloudcome/utils-core/array`     | 数组操作                                                |
+| async     | `@cloudcome/utils-core/async`     | 异步工具                                                |
+| base64    | `@cloudcome/utils-core/base64`    | Base64 编解码                                           |
+| cache     | `@cloudcome/utils-core/cache`     | 缓存工具                                                |
+| color     | `@cloudcome/utils-core/color`     | 颜色转换（RGB/HSL/HSV/HWB/LAB/XYZ）、对比度、亮度、混合 |
+| crypto    | `@cloudcome/utils-core/crypto`    | 加密（MD5、SHA1、SHA256、SHA512）                       |
+| date      | `@cloudcome/utils-core/date`      | 日期解析、格式化、时区、相对时间、周/天计算             |
+| dict      | `@cloudcome/utils-core/dict`      | 字典/映射工具                                           |
+| easing    | `@cloudcome/utils-core/easing`    | 缓动函数                                                |
+| emitter   | `@cloudcome/utils-core/emitter`   | 事件发射器                                              |
+| env       | `@cloudcome/utils-core/env`       | 环境检测                                                |
+| error     | `@cloudcome/utils-core/error`     | 错误处理                                                |
+| exception | `@cloudcome/utils-core/exception` | 异常处理                                                |
+| function  | `@cloudcome/utils-core/function`  | 函数工具                                                |
+| number    | `@cloudcome/utils-core/number`    | 数字工具                                                |
+| object    | `@cloudcome/utils-core/object`    | 对象遍历、深层 get/set、合并、类型判断                  |
+| path      | `@cloudcome/utils-core/path`      | 路径工具                                                |
+| promise   | `@cloudcome/utils-core/promise`   | Promise 工具                                            |
+| qs        | `@cloudcome/utils-core/qs`        | 查询字符串解析与序列化                                  |
+| regexp    | `@cloudcome/utils-core/regexp`    | 正则表达式工具                                          |
+| string    | `@cloudcome/utils-core/string`    | 字符串工具                                              |
+| time      | `@cloudcome/utils-core/time`      | 时间单位转换                                            |
+| timer     | `@cloudcome/utils-core/timer`     | 定时器工具                                              |
+| tree      | `@cloudcome/utils-core/tree`      | 树结构操作                                              |
+| try       | `@cloudcome/utils-core/try`       | 安全调用（try-catch 包装，支持同步/异步/柯里化）        |
+| type      | `@cloudcome/utils-core/type`      | 类型判断                                                |
+| types     | `@cloudcome/utils-core/types`     | 公共类型定义                                            |
+| unique    | `@cloudcome/utils-core/unique`    | 唯一 ID 生成                                            |
+| url       | `@cloudcome/utils-core/url`       | URL 解析与构建                                          |
+| version   | `@cloudcome/utils-core/version`   | 版本号比较                                              |
 ### @cloudcome/utils-browser
 浏览器端工具库，依赖 `@cloudcome/utils-core`：
-| 子模块 | 导入路径 | 功能 |
-| --- | --- | --- |
-| base64 | `@cloudcome/utils-browser/base64` | 浏览器端 Base64 编解码 |
-| cache | `@cloudcome/utils-browser/cache` | 浏览器缓存（localStorage/sessionStorage） |
-| canvas | `@cloudcome/utils-browser/canvas` | Canvas 操作 |
-| clipboard | `@cloudcome/utils-browser/clipboard` | 剪贴板读写 |
-| cookie | `@cloudcome/utils-browser/cookie` | Cookie 读写 |
-| dom | `@cloudcome/utils-browser/dom` | DOM 操作 |
-| download | `@cloudcome/utils-browser/download` | 文件下载 |
-| image | `@cloudcome/utils-browser/image` | 图片处理 |
-| timer | `@cloudcome/utils-browser/timer` | 浏览器端定时器 |
-| video | `@cloudcome/utils-browser/video` | 视频处理 |
+| 子模块    | 导入路径                             | 功能                                      |
+| --------- | ------------------------------------ | ----------------------------------------- |
+| base64    | `@cloudcome/utils-browser/base64`    | 浏览器端 Base64 编解码                    |
+| cache     | `@cloudcome/utils-browser/cache`     | 浏览器缓存（localStorage/sessionStorage） |
+| canvas    | `@cloudcome/utils-browser/canvas`    | Canvas 操作                               |
+| clipboard | `@cloudcome/utils-browser/clipboard` | 剪贴板读写                                |
+| cookie    | `@cloudcome/utils-browser/cookie`    | Cookie 读写                               |
+| dom       | `@cloudcome/utils-browser/dom`       | DOM 操作                                  |
+| download  | `@cloudcome/utils-browser/download`  | 文件下载                                  |
+| image     | `@cloudcome/utils-browser/image`     | 图片处理                                  |
+| timer     | `@cloudcome/utils-browser/timer`     | 浏览器端定时器                            |
+| video     | `@cloudcome/utils-browser/video`     | 视频处理                                  |
 ### @cloudcome/utils-node
 Node.js 端工具库：
-| 子模块 | 导入路径 | 功能 |
-| --- | --- | --- |
+| 子模块 | 导入路径                       | 功能                     |
+| ------ | ------------------------------ | ------------------------ |
 | base64 | `@cloudcome/utils-node/base64` | Node.js 端 Base64 编解码 |
-| crypto | `@cloudcome/utils-node/crypto` | Node.js 端加密工具 |
+| crypto | `@cloudcome/utils-node/crypto` | Node.js 端加密工具       |
+| jsonl  | `@cloudcome/utils-node/jsonl`  | JSONL 文件读写           |
 ### @cloudcome/utils-vue
 Vue 3 工具库，依赖 `@cloudcome/utils-core` 和 `vue`：
-| 子模块 | 导入路径 | 功能 |
-| --- | --- | --- |
-| async | `@cloudcome/utils-vue/async` | Vue 异步组合式函数 |
-| component | `@cloudcome/utils-vue/component` | 组件工具（生命周期等） |
-| event | `@cloudcome/utils-vue/event` | 事件工具 |
-| request | `@cloudcome/utils-vue/request` | 请求组合式函数（useRequest） |
-| shared | `@cloudcome/utils-vue/shared` | 共享工具 |
-| state | `@cloudcome/utils-vue/state` | 状态管理工具 |
-| time | `@cloudcome/utils-vue/time` | 时间相关组合式函数 |
-| types | `@cloudcome/utils-vue/types` | 类型定义 |
+| 子模块    | 导入路径                         | 功能                         |
+| --------- | -------------------------------- | ---------------------------- |
+| async     | `@cloudcome/utils-vue/async`     | Vue 异步组合式函数           |
+| component | `@cloudcome/utils-vue/component` | 组件工具（生命周期等）       |
+| event     | `@cloudcome/utils-vue/event`     | 事件工具                     |
+| request   | `@cloudcome/utils-vue/request`   | 请求组合式函数（useRequest） |
+| shared    | `@cloudcome/utils-vue/shared`    | 共享工具                     |
+| state     | `@cloudcome/utils-vue/state`     | 状态管理工具                 |
+| time      | `@cloudcome/utils-vue/time`      | 时间相关组合式函数           |
+| types     | `@cloudcome/utils-vue/types`     | 类型定义                     |
 ### @cloudcome/utils-react
@@ -107,13 +108,11 @@ React 工具库。
 UniApp 工具库，依赖 `@cloudcome/utils-core`、`@cloudcome/utils-vue`：
-| 子模块 | 导入路径 | 功能 |
-| --- | --- | --- |
-| app | `@cloudcome/utils-uni/app` | App 相关工具 |
-| client | `@cloudcome/utils-uni/client` | 客户端工具 |
-| cloud | `@cloudcome/utils-uni/cloud` | 云函数工具（调用、错误处理、uni-id 等） |
-| database | `@cloudcome/utils-uni/database` | 数据库操作（CRUD、事务、分页、upsert 等） |
-| page | `@cloudcome/utils-uni/page` | 页面相关工具 |
+| 子模块   | 导入路径                        | 功能                                                 |
+| -------- | ------------------------------- | ---------------------------------------------------- |
+| client   | `@cloudcome/utils-uni/client`   | 客户端工具（App/页面生命周期、消息提示、异步工具等） |
+| cloud    | `@cloudcome/utils-uni/cloud`    | 云函数工具（调用、错误处理、uni-id 等）              |
+| database | `@cloudcome/utils-uni/database` | 数据库操作（CRUD、事务、分页、upsert 等）            |
 ## 开发

package/dist/array.cjs.map CHANGED Viewed

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

package/dist/array.mjs.map CHANGED Viewed

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

package/dist/async.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"async.cjs","names":["#add","#length","#tasks","#stopLength","#startPwr","#running","#run","#addAndRun","#startResolved","#startLength","#startRejected","#startResults","#stopResults","#stopResolved","#stopPwr","#stopRejected"],"sources":["../src/async.ts"],"sourcesContent":["import { fnNoop } from './function';\nimport type { AnyArray } from './types';\n\n/*\n 表示异步任务的类型\n * @template T - 任务返回值的类型\n /\ntype AsyncTask<T> = {\n /* 任务索引 /\n idx: number;\n /* 异步任务函数 /\n afn: () => Promise<T>;\n /* Promise 的解析器对象 /\n pwr?: PromiseWithResolvers<T>;\n};\n\n/\n 异步任务队列的配置选项\n /\nexport type AsyncQueueOptions = {\n /\n 并发限制数，0 表示无限制\n * @default 0\n /\n limit?: number;\n};\n\n/\n 异步任务队列，用于管理和控制异步任务的执行\n * @template T - 任务返回值的类型\n /\nexport class AsyncQueue<T> {\n #tasks: AsyncTask<T>[] = [];\n #length = 0;\n\n /\n 创建一个异步任务队列\n * @param asyncFns - 要执行的异步函数数组\n * @param options - 队列配置选项\n /\n constructor(\n asyncFns: Array<() => Promise<T>>,\n readonly options?: AsyncQueueOptions,\n ) {\n asyncFns.forEach((afn, _idx) => {\n this.#add('push', afn);\n });\n }\n\n get length() {\n return this.#length;\n }\n\n get limit() {\n return this.options?.limit \|\| 0;\n }\n\n #add(\n method: 'unshift' \| 'push',\n afn: () => Promise<T>,\n pwr?: PromiseWithResolvers<T>,\n ) {\n this.#tasks[method]({\n idx: this.#length++,\n afn: afn,\n pwr: pwr,\n });\n }\n\n #addAndRun(method: 'unshift' \| 'push', afn: () => Promise<T>) {\n // 明确终止了\n if (this.#stopLength >= 0) {\n throw new Error('异步队列已被终止，无法添加新的任务');\n }\n\n const pwr = Promise.withResolvers<T>();\n this.#add(method, afn, pwr);\n\n if (this.#startPwr && this.#running === 0) {\n this.#run();\n }\n\n return pwr.promise;\n }\n\n async push(afn: () => Promise<T>) {\n return this.#addAndRun('push', afn);\n }\n\n async unshift(afn: () => Promise<T>) {\n return this.#addAndRun('unshift', afn);\n }\n\n #startResolved = 0;\n #startRejected = 0;\n get startSettled() {\n return this.#startResolved === this.#startLength \|\| this.#startRejected > 0;\n }\n\n #startResults: T[] = [];\n #startPwr: PromiseWithResolvers<T[]> \| null = null;\n #startLength = 0;\n\n /\n 启动队列中的任务执行\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async start(): Promise<T[]> {\n if (this.#startPwr) return this.#startPwr.promise;\n\n // 固化启动时长度，便于判断 start 异步结果\n this.#startLength = this.#length;\n this.#startPwr = Promise.withResolvers<T[]>();\n\n if (this.#startLength === 0) {\n this.#startPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#startPwr.promise;\n }\n\n #running = 0;\n #run() {\n while (this.limit === 0 \|\| this.#running < this.limit) {\n const task = this.#tasks.shift();\n\n // 无任务可执行\n if (!task) break;\n\n this.#running++;\n\n task\n .afn()\n .then((result) => {\n this.#running--;\n task.pwr?.resolve(result);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startResults[task.idx] = result;\n this.#startResolved++;\n }\n\n // 所有启动任务都已执行完毕\n if (this.#startResolved === this.#startLength) {\n this.#startPwr?.resolve(this.#startResults);\n }\n\n this.#stopResults[task.idx] = result;\n this.#stopResolved++;\n\n // 所有停止任务都已执行完毕\n if (this.#stopResolved === this.#stopLength) {\n this.#stopPwr?.resolve(this.#stopResults);\n } else {\n this.#run();\n }\n })\n .catch((reason) => {\n this.#running--;\n task.pwr?.reject(reason);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startRejected++;\n this.#startPwr?.reject(reason);\n }\n\n // 属于停止任务\n if (this.#stopLength > 0) {\n this.#stopRejected++;\n this.#stopPwr?.reject(reason);\n }\n });\n }\n }\n #stopResolved = 0;\n #stopRejected = 0;\n get stopSettled() {\n return this.#stopResolved === this.#stopLength \|\| this.#stopRejected > 0;\n }\n\n #stopLength = -1;\n #stopResults: T[] = [];\n\n #stopPwr?: PromiseWithResolvers<T[]> \| null = null;\n\n /\n 终止队列中的任务执行，终止队列后不再可以追加异步任务\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async stop() {\n if (this.#stopPwr) {\n return this.#stopPwr.promise;\n }\n\n this.#stopLength = this.#length;\n this.#stopPwr = Promise.withResolvers<T[]>();\n\n if (this.#stopLength === 0) {\n this.#stopPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#stopPwr.promise;\n }\n}\n\n/\n 使用给定的并发限制执行异步函数\n \n 此函数的目的是控制一组异步函数的并发执行数量，通过创建一个AsyncQueue实例来管理这些异步函数的执行\n * 它确保在任何给定时间只有最多`limit`数量的异步函数被执行，以避免潜在的性能问题或资源竞争\n \n @param asyncFns 一个包含异步函数的数组，每个异步函数都不需要参数，并返回一个Promise\n * @param limit 并发限制的数量，表示同时执行的异步函数的最大数量，0 表示不限制\n * @returns 返回一个Promise，当所有异步函数都执行完毕后，该Promise将被解析\n /\nexport function asyncLimit<T>(\n asyncFns: Array<() => Promise<T>>,\n limit: number,\n) {\n const aq = new AsyncQueue<T>(asyncFns, { limit });\n return aq.start();\n}\n\n/\n 异步共享函数的配置选项\n /\nexport type AsyncSharedOptions<I extends AnyArray, O> = {\n /\n 是否在调用结束后再执行（只在运行期间有再次调用时才会生效）\n * @type {boolean}\n * @default false\n * @example\n * const sharedFn = asyncShared(fetchData, { trailing: true });\n * // 如果在 fetchData 执行期间多次调用 sharedFn，则会在 fetchData 结束后再次执行\n /\n trailing?: boolean;\n\n /\n 缓存结果的最大有效期（毫秒）\n * @type {number}\n * @example\n * const sharedFn = asyncShared(fetchData, { maxAge: 1000 });\n * // 在 1 秒内调用 sharedFn 会直接返回缓存结果\n /\n maxAge?: number;\n\n /\n 在调用共享函数时触发的回调函数\n * @param inputs - 传递给共享函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onTrigger: (...args) => console.log('Calling with:', args)\n * };\n /\n onTrigger?: (...inputs: I) => unknown;\n\n /\n 在执行异步函数时触发的回调函数\n * @param args - 传递给异步函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onExecute: (...args) => console.log('Executing with:', args)\n * };\n /\n onExecute?: (...args: I) => unknown;\n\n /\n 在异步函数成功执行后触发的回调函数\n * @param output - 异步函数的返回结果\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onSuccess: (result) => console.log('Success:', result)\n * };\n /\n onSuccess?: (output: O) => unknown;\n\n /\n 在异步函数执行失败时触发的回调函数\n * @param error - 异步函数抛出的错误\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onError: (error) => console.error('Error:', error)\n * };\n /\n onError?: (error: unknown) => unknown;\n\n /\n 在异步函数执行完成（无论成功或失败）时触发的回调函数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onFinally: () => console.log('Execution completed')\n * };\n /\n onFinally?: () => unknown;\n};\n\n/\n 创建一个共享执行结果的异步函数\n * @template F - 异步函数类型\n * @param {F} af - 要共享的异步函数\n * @param {AsyncSharedOptions} [options] - 配置选项\n * @returns {F} 返回一个新的异步函数，该函数会共享执行结果\n * @example\n * const fetchData = async (id) => {\n * // 模拟异步操作\n * return await fetch(`/api/data/${id}`);\n * };\n \n const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });\n \n // 多次调用会共享同一个请求\n * const result1 = await sharedFetch(1);\n * const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果\n */\nexport function asyncShared<I extends AnyArray, O>(\n af: (...inputs: I) => Promise<O>,\n options?: AsyncSharedOptions<I, O>,\n) {\n let executedPromise: Promise<O> \| undefined;\n let executing = false;\n let executingInputs: I \| undefined;\n let executedTime = 0;\n\n const _sharedAf = async (_from: 'trigger' \| 'trailing', ...inputs: I) => {\n executingInputs = inputs;\n\n // 如果正在运行，则复用运行结果\n if (executing && executedPromise) {\n return executedPromise;\n }\n\n // 如果已运行结束空闲时，判断是否在等待时间内\n if (executedPromise && Date.now() - executedTime < (options?.maxAge \|\| 0)) {\n return executedPromise;\n }\n\n // 否则直接执行\n executing = true;\n options?.onExecute?.(...executingInputs);\n executedPromise = af(...executingInputs);\n executingInputs = undefined;\n executedPromise\n .then((res) => {\n options?.onSuccess?.(res);\n })\n .catch((err) => {\n options?.onError?.(err);\n })\n .finally(() => {\n executing = false;\n executedTime = Date.now();\n options?.onFinally?.();\n\n // 执行期间多次调用，则重新执行\n if (executingInputs && options?.trailing) {\n _sharedAf('trailing', ...executingInputs);\n }\n });\n\n return executedPromise;\n };\n\n return function sharedAf(...inputs: I): Promise<O> {\n options?.onTrigger?.(...inputs);\n const p = _sharedAf('trigger', ...inputs);\n // 必须捕获错误，否则单测错误边界时会抛错\n p.catch(fnNoop);\n return p;\n };\n}\n\n// const af1 = asyncShared(async () => {\n// return 1;\n// });\n// const n = await af1();\n\n// const af2 = asyncShared(async (a: number) => {\n// return a + 1;\n// });\n// const n2 = await af2(2);\n"],"mappings":"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"}
1	+ {"version":3,"file":"async.cjs","names":["#add","#length","#tasks","#stopLength","#startPwr","#running","#run","#addAndRun","#startResolved","#startLength","#startRejected","#startResults","#stopResults","#stopResolved","#stopPwr","#stopRejected"],"sources":["../src/async.ts"],"sourcesContent":["import { fnNoop } from './function';\nimport type { AnyArray } from './types';\n\n/*\n 表示异步任务的类型\n * @template T - 任务返回值的类型\n /\ntype AsyncTask<T> = {\n /* 任务索引 /\n idx: number;\n /* 异步任务函数 /\n afn: () => Promise<T>;\n /* Promise 的解析器对象 /\n pwr?: PromiseWithResolvers<T>;\n};\n\n/\n 异步任务队列的配置选项\n /\nexport type AsyncQueueOptions = {\n /\n 并发限制数，0 表示无限制\n * @default 0\n /\n limit?: number;\n};\n\n/\n 异步任务队列，用于管理和控制异步任务的执行\n * @template T - 任务返回值的类型\n /\nexport class AsyncQueue<T> {\n #tasks: AsyncTask<T>[] = [];\n #length = 0;\n\n /\n 创建一个异步任务队列\n * @param asyncFns - 要执行的异步函数数组\n * @param options - 队列配置选项\n /\n constructor(\n asyncFns: Array<() => Promise<T>>,\n readonly options?: AsyncQueueOptions,\n ) {\n asyncFns.forEach((afn, _idx) => {\n this.#add('push', afn);\n });\n }\n\n get length() {\n return this.#length;\n }\n\n get limit() {\n return this.options?.limit \|\| 0;\n }\n\n #add(method: 'unshift' \| 'push', afn: () => Promise<T>, pwr?: PromiseWithResolvers<T>) {\n this.#tasks[method]({\n idx: this.#length++,\n afn: afn,\n pwr: pwr,\n });\n }\n\n #addAndRun(method: 'unshift' \| 'push', afn: () => Promise<T>) {\n // 明确终止了\n if (this.#stopLength >= 0) {\n throw new Error('异步队列已被终止，无法添加新的任务');\n }\n\n const pwr = Promise.withResolvers<T>();\n this.#add(method, afn, pwr);\n\n if (this.#startPwr && this.#running === 0) {\n this.#run();\n }\n\n return pwr.promise;\n }\n\n async push(afn: () => Promise<T>) {\n return this.#addAndRun('push', afn);\n }\n\n async unshift(afn: () => Promise<T>) {\n return this.#addAndRun('unshift', afn);\n }\n\n #startResolved = 0;\n #startRejected = 0;\n get startSettled() {\n return this.#startResolved === this.#startLength \|\| this.#startRejected > 0;\n }\n\n #startResults: T[] = [];\n #startPwr: PromiseWithResolvers<T[]> \| null = null;\n #startLength = 0;\n\n /\n 启动队列中的任务执行\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async start(): Promise<T[]> {\n if (this.#startPwr) return this.#startPwr.promise;\n\n // 固化启动时长度，便于判断 start 异步结果\n this.#startLength = this.#length;\n this.#startPwr = Promise.withResolvers<T[]>();\n\n if (this.#startLength === 0) {\n this.#startPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#startPwr.promise;\n }\n\n #running = 0;\n #run() {\n while (this.limit === 0 \|\| this.#running < this.limit) {\n const task = this.#tasks.shift();\n\n // 无任务可执行\n if (!task) break;\n\n this.#running++;\n\n task\n .afn()\n .then((result) => {\n this.#running--;\n task.pwr?.resolve(result);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startResults[task.idx] = result;\n this.#startResolved++;\n }\n\n // 所有启动任务都已执行完毕\n if (this.#startResolved === this.#startLength) {\n this.#startPwr?.resolve(this.#startResults);\n }\n\n this.#stopResults[task.idx] = result;\n this.#stopResolved++;\n\n // 所有停止任务都已执行完毕\n if (this.#stopResolved === this.#stopLength) {\n this.#stopPwr?.resolve(this.#stopResults);\n } else {\n this.#run();\n }\n })\n .catch((reason) => {\n this.#running--;\n task.pwr?.reject(reason);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startRejected++;\n this.#startPwr?.reject(reason);\n }\n\n // 属于停止任务\n if (this.#stopLength > 0) {\n this.#stopRejected++;\n this.#stopPwr?.reject(reason);\n }\n });\n }\n }\n #stopResolved = 0;\n #stopRejected = 0;\n get stopSettled() {\n return this.#stopResolved === this.#stopLength \|\| this.#stopRejected > 0;\n }\n\n #stopLength = -1;\n #stopResults: T[] = [];\n\n #stopPwr?: PromiseWithResolvers<T[]> \| null = null;\n\n /\n 终止队列中的任务执行，终止队列后不再可以追加异步任务\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async stop() {\n if (this.#stopPwr) {\n return this.#stopPwr.promise;\n }\n\n this.#stopLength = this.#length;\n this.#stopPwr = Promise.withResolvers<T[]>();\n\n if (this.#stopLength === 0) {\n this.#stopPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#stopPwr.promise;\n }\n}\n\n/\n 使用给定的并发限制执行异步函数\n \n 此函数的目的是控制一组异步函数的并发执行数量，通过创建一个AsyncQueue实例来管理这些异步函数的执行\n * 它确保在任何给定时间只有最多`limit`数量的异步函数被执行，以避免潜在的性能问题或资源竞争\n \n @param asyncFns 一个包含异步函数的数组，每个异步函数都不需要参数，并返回一个Promise\n * @param limit 并发限制的数量，表示同时执行的异步函数的最大数量，0 表示不限制\n * @returns 返回一个Promise，当所有异步函数都执行完毕后，该Promise将被解析\n /\nexport function asyncLimit<T>(asyncFns: Array<() => Promise<T>>, limit: number) {\n const aq = new AsyncQueue<T>(asyncFns, { limit });\n return aq.start();\n}\n\n/\n 异步共享函数的配置选项\n /\nexport type AsyncSharedOptions<I extends AnyArray, O> = {\n /\n 是否在调用结束后再执行（只在运行期间有再次调用时才会生效）\n * @type {boolean}\n * @default false\n * @example\n * const sharedFn = asyncShared(fetchData, { trailing: true });\n * // 如果在 fetchData 执行期间多次调用 sharedFn，则会在 fetchData 结束后再次执行\n /\n trailing?: boolean;\n\n /\n 缓存结果的最大有效期（毫秒）\n * @type {number}\n * @example\n * const sharedFn = asyncShared(fetchData, { maxAge: 1000 });\n * // 在 1 秒内调用 sharedFn 会直接返回缓存结果\n /\n maxAge?: number;\n\n /\n 在调用共享函数时触发的回调函数\n * @param inputs - 传递给共享函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onTrigger: (...args) => console.log('Calling with:', args)\n * };\n /\n onTrigger?: (...inputs: I) => unknown;\n\n /\n 在执行异步函数时触发的回调函数\n * @param args - 传递给异步函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onExecute: (...args) => console.log('Executing with:', args)\n * };\n /\n onExecute?: (...args: I) => unknown;\n\n /\n 在异步函数成功执行后触发的回调函数\n * @param output - 异步函数的返回结果\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onSuccess: (result) => console.log('Success:', result)\n * };\n /\n onSuccess?: (output: O) => unknown;\n\n /\n 在异步函数执行失败时触发的回调函数\n * @param error - 异步函数抛出的错误\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onError: (error) => console.error('Error:', error)\n * };\n /\n onError?: (error: unknown) => unknown;\n\n /\n 在异步函数执行完成（无论成功或失败）时触发的回调函数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onFinally: () => console.log('Execution completed')\n * };\n /\n onFinally?: () => unknown;\n};\n\n/\n 创建一个共享执行结果的异步函数\n * @template F - 异步函数类型\n * @param {F} af - 要共享的异步函数\n * @param {AsyncSharedOptions} [options] - 配置选项\n * @returns {F} 返回一个新的异步函数，该函数会共享执行结果\n * @example\n * const fetchData = async (id) => {\n * // 模拟异步操作\n * return await fetch(`/api/data/${id}`);\n * };\n \n const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });\n \n // 多次调用会共享同一个请求\n * const result1 = await sharedFetch(1);\n * const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果\n */\nexport function asyncShared<I extends AnyArray, O>(\n af: (...inputs: I) => Promise<O>,\n options?: AsyncSharedOptions<I, O>,\n) {\n let executedPromise: Promise<O> \| undefined;\n let executing = false;\n let executingInputs: I \| undefined;\n let executedTime = 0;\n\n const _sharedAf = async (_from: 'trigger' \| 'trailing', ...inputs: I) => {\n executingInputs = inputs;\n\n // 如果正在运行，则复用运行结果\n if (executing && executedPromise) {\n return executedPromise;\n }\n\n // 如果已运行结束空闲时，判断是否在等待时间内\n if (executedPromise && Date.now() - executedTime < (options?.maxAge \|\| 0)) {\n return executedPromise;\n }\n\n // 否则直接执行\n executing = true;\n options?.onExecute?.(...executingInputs);\n executedPromise = af(...executingInputs);\n executingInputs = undefined;\n executedPromise\n .then((res) => {\n options?.onSuccess?.(res);\n })\n .catch((err) => {\n options?.onError?.(err);\n })\n .finally(() => {\n executing = false;\n executedTime = Date.now();\n options?.onFinally?.();\n\n // 执行期间多次调用，则重新执行\n if (executingInputs && options?.trailing) {\n _sharedAf('trailing', ...executingInputs);\n }\n });\n\n return executedPromise;\n };\n\n return function sharedAf(...inputs: I): Promise<O> {\n options?.onTrigger?.(...inputs);\n const p = _sharedAf('trigger', ...inputs);\n // 必须捕获错误，否则单测错误边界时会抛错\n p.catch(fnNoop);\n return p;\n };\n}\n\n// const af1 = asyncShared(async () => {\n// return 1;\n// });\n// const n = await af1();\n\n// const af2 = asyncShared(async (a: number) => {\n// return a + 1;\n// });\n// const n2 = await af2(2);\n"],"mappings":"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"}

package/dist/async.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"async.mjs","names":["#add","#length","#tasks","#stopLength","#startPwr","#running","#run","#addAndRun","#startResolved","#startLength","#startRejected","#startResults","#stopResults","#stopResolved","#stopPwr","#stopRejected"],"sources":["../src/async.ts"],"sourcesContent":["import { fnNoop } from './function';\nimport type { AnyArray } from './types';\n\n/*\n 表示异步任务的类型\n * @template T - 任务返回值的类型\n /\ntype AsyncTask<T> = {\n /* 任务索引 /\n idx: number;\n /* 异步任务函数 /\n afn: () => Promise<T>;\n /* Promise 的解析器对象 /\n pwr?: PromiseWithResolvers<T>;\n};\n\n/\n 异步任务队列的配置选项\n /\nexport type AsyncQueueOptions = {\n /\n 并发限制数，0 表示无限制\n * @default 0\n /\n limit?: number;\n};\n\n/\n 异步任务队列，用于管理和控制异步任务的执行\n * @template T - 任务返回值的类型\n /\nexport class AsyncQueue<T> {\n #tasks: AsyncTask<T>[] = [];\n #length = 0;\n\n /\n 创建一个异步任务队列\n * @param asyncFns - 要执行的异步函数数组\n * @param options - 队列配置选项\n /\n constructor(\n asyncFns: Array<() => Promise<T>>,\n readonly options?: AsyncQueueOptions,\n ) {\n asyncFns.forEach((afn, _idx) => {\n this.#add('push', afn);\n });\n }\n\n get length() {\n return this.#length;\n }\n\n get limit() {\n return this.options?.limit \|\| 0;\n }\n\n #add(\n method: 'unshift' \| 'push',\n afn: () => Promise<T>,\n pwr?: PromiseWithResolvers<T>,\n ) {\n this.#tasks[method]({\n idx: this.#length++,\n afn: afn,\n pwr: pwr,\n });\n }\n\n #addAndRun(method: 'unshift' \| 'push', afn: () => Promise<T>) {\n // 明确终止了\n if (this.#stopLength >= 0) {\n throw new Error('异步队列已被终止，无法添加新的任务');\n }\n\n const pwr = Promise.withResolvers<T>();\n this.#add(method, afn, pwr);\n\n if (this.#startPwr && this.#running === 0) {\n this.#run();\n }\n\n return pwr.promise;\n }\n\n async push(afn: () => Promise<T>) {\n return this.#addAndRun('push', afn);\n }\n\n async unshift(afn: () => Promise<T>) {\n return this.#addAndRun('unshift', afn);\n }\n\n #startResolved = 0;\n #startRejected = 0;\n get startSettled() {\n return this.#startResolved === this.#startLength \|\| this.#startRejected > 0;\n }\n\n #startResults: T[] = [];\n #startPwr: PromiseWithResolvers<T[]> \| null = null;\n #startLength = 0;\n\n /\n 启动队列中的任务执行\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async start(): Promise<T[]> {\n if (this.#startPwr) return this.#startPwr.promise;\n\n // 固化启动时长度，便于判断 start 异步结果\n this.#startLength = this.#length;\n this.#startPwr = Promise.withResolvers<T[]>();\n\n if (this.#startLength === 0) {\n this.#startPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#startPwr.promise;\n }\n\n #running = 0;\n #run() {\n while (this.limit === 0 \|\| this.#running < this.limit) {\n const task = this.#tasks.shift();\n\n // 无任务可执行\n if (!task) break;\n\n this.#running++;\n\n task\n .afn()\n .then((result) => {\n this.#running--;\n task.pwr?.resolve(result);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startResults[task.idx] = result;\n this.#startResolved++;\n }\n\n // 所有启动任务都已执行完毕\n if (this.#startResolved === this.#startLength) {\n this.#startPwr?.resolve(this.#startResults);\n }\n\n this.#stopResults[task.idx] = result;\n this.#stopResolved++;\n\n // 所有停止任务都已执行完毕\n if (this.#stopResolved === this.#stopLength) {\n this.#stopPwr?.resolve(this.#stopResults);\n } else {\n this.#run();\n }\n })\n .catch((reason) => {\n this.#running--;\n task.pwr?.reject(reason);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startRejected++;\n this.#startPwr?.reject(reason);\n }\n\n // 属于停止任务\n if (this.#stopLength > 0) {\n this.#stopRejected++;\n this.#stopPwr?.reject(reason);\n }\n });\n }\n }\n #stopResolved = 0;\n #stopRejected = 0;\n get stopSettled() {\n return this.#stopResolved === this.#stopLength \|\| this.#stopRejected > 0;\n }\n\n #stopLength = -1;\n #stopResults: T[] = [];\n\n #stopPwr?: PromiseWithResolvers<T[]> \| null = null;\n\n /\n 终止队列中的任务执行，终止队列后不再可以追加异步任务\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async stop() {\n if (this.#stopPwr) {\n return this.#stopPwr.promise;\n }\n\n this.#stopLength = this.#length;\n this.#stopPwr = Promise.withResolvers<T[]>();\n\n if (this.#stopLength === 0) {\n this.#stopPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#stopPwr.promise;\n }\n}\n\n/\n 使用给定的并发限制执行异步函数\n \n 此函数的目的是控制一组异步函数的并发执行数量，通过创建一个AsyncQueue实例来管理这些异步函数的执行\n * 它确保在任何给定时间只有最多`limit`数量的异步函数被执行，以避免潜在的性能问题或资源竞争\n \n @param asyncFns 一个包含异步函数的数组，每个异步函数都不需要参数，并返回一个Promise\n * @param limit 并发限制的数量，表示同时执行的异步函数的最大数量，0 表示不限制\n * @returns 返回一个Promise，当所有异步函数都执行完毕后，该Promise将被解析\n /\nexport function asyncLimit<T>(\n asyncFns: Array<() => Promise<T>>,\n limit: number,\n) {\n const aq = new AsyncQueue<T>(asyncFns, { limit });\n return aq.start();\n}\n\n/\n 异步共享函数的配置选项\n /\nexport type AsyncSharedOptions<I extends AnyArray, O> = {\n /\n 是否在调用结束后再执行（只在运行期间有再次调用时才会生效）\n * @type {boolean}\n * @default false\n * @example\n * const sharedFn = asyncShared(fetchData, { trailing: true });\n * // 如果在 fetchData 执行期间多次调用 sharedFn，则会在 fetchData 结束后再次执行\n /\n trailing?: boolean;\n\n /\n 缓存结果的最大有效期（毫秒）\n * @type {number}\n * @example\n * const sharedFn = asyncShared(fetchData, { maxAge: 1000 });\n * // 在 1 秒内调用 sharedFn 会直接返回缓存结果\n /\n maxAge?: number;\n\n /\n 在调用共享函数时触发的回调函数\n * @param inputs - 传递给共享函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onTrigger: (...args) => console.log('Calling with:', args)\n * };\n /\n onTrigger?: (...inputs: I) => unknown;\n\n /\n 在执行异步函数时触发的回调函数\n * @param args - 传递给异步函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onExecute: (...args) => console.log('Executing with:', args)\n * };\n /\n onExecute?: (...args: I) => unknown;\n\n /\n 在异步函数成功执行后触发的回调函数\n * @param output - 异步函数的返回结果\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onSuccess: (result) => console.log('Success:', result)\n * };\n /\n onSuccess?: (output: O) => unknown;\n\n /\n 在异步函数执行失败时触发的回调函数\n * @param error - 异步函数抛出的错误\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onError: (error) => console.error('Error:', error)\n * };\n /\n onError?: (error: unknown) => unknown;\n\n /\n 在异步函数执行完成（无论成功或失败）时触发的回调函数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onFinally: () => console.log('Execution completed')\n * };\n /\n onFinally?: () => unknown;\n};\n\n/\n 创建一个共享执行结果的异步函数\n * @template F - 异步函数类型\n * @param {F} af - 要共享的异步函数\n * @param {AsyncSharedOptions} [options] - 配置选项\n * @returns {F} 返回一个新的异步函数，该函数会共享执行结果\n * @example\n * const fetchData = async (id) => {\n * // 模拟异步操作\n * return await fetch(`/api/data/${id}`);\n * };\n \n const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });\n \n // 多次调用会共享同一个请求\n * const result1 = await sharedFetch(1);\n * const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果\n */\nexport function asyncShared<I extends AnyArray, O>(\n af: (...inputs: I) => Promise<O>,\n options?: AsyncSharedOptions<I, O>,\n) {\n let executedPromise: Promise<O> \| undefined;\n let executing = false;\n let executingInputs: I \| undefined;\n let executedTime = 0;\n\n const _sharedAf = async (_from: 'trigger' \| 'trailing', ...inputs: I) => {\n executingInputs = inputs;\n\n // 如果正在运行，则复用运行结果\n if (executing && executedPromise) {\n return executedPromise;\n }\n\n // 如果已运行结束空闲时，判断是否在等待时间内\n if (executedPromise && Date.now() - executedTime < (options?.maxAge \|\| 0)) {\n return executedPromise;\n }\n\n // 否则直接执行\n executing = true;\n options?.onExecute?.(...executingInputs);\n executedPromise = af(...executingInputs);\n executingInputs = undefined;\n executedPromise\n .then((res) => {\n options?.onSuccess?.(res);\n })\n .catch((err) => {\n options?.onError?.(err);\n })\n .finally(() => {\n executing = false;\n executedTime = Date.now();\n options?.onFinally?.();\n\n // 执行期间多次调用，则重新执行\n if (executingInputs && options?.trailing) {\n _sharedAf('trailing', ...executingInputs);\n }\n });\n\n return executedPromise;\n };\n\n return function sharedAf(...inputs: I): Promise<O> {\n options?.onTrigger?.(...inputs);\n const p = _sharedAf('trigger', ...inputs);\n // 必须捕获错误，否则单测错误边界时会抛错\n p.catch(fnNoop);\n return p;\n };\n}\n\n// const af1 = asyncShared(async () => {\n// return 1;\n// });\n// const n = await af1();\n\n// const af2 = asyncShared(async (a: number) => {\n// return a + 1;\n// });\n// const n2 = await af2(2);\n"],"mappings":"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"}
1	+ {"version":3,"file":"async.mjs","names":["#add","#length","#tasks","#stopLength","#startPwr","#running","#run","#addAndRun","#startResolved","#startLength","#startRejected","#startResults","#stopResults","#stopResolved","#stopPwr","#stopRejected"],"sources":["../src/async.ts"],"sourcesContent":["import { fnNoop } from './function';\nimport type { AnyArray } from './types';\n\n/*\n 表示异步任务的类型\n * @template T - 任务返回值的类型\n /\ntype AsyncTask<T> = {\n /* 任务索引 /\n idx: number;\n /* 异步任务函数 /\n afn: () => Promise<T>;\n /* Promise 的解析器对象 /\n pwr?: PromiseWithResolvers<T>;\n};\n\n/\n 异步任务队列的配置选项\n /\nexport type AsyncQueueOptions = {\n /\n 并发限制数，0 表示无限制\n * @default 0\n /\n limit?: number;\n};\n\n/\n 异步任务队列，用于管理和控制异步任务的执行\n * @template T - 任务返回值的类型\n /\nexport class AsyncQueue<T> {\n #tasks: AsyncTask<T>[] = [];\n #length = 0;\n\n /\n 创建一个异步任务队列\n * @param asyncFns - 要执行的异步函数数组\n * @param options - 队列配置选项\n /\n constructor(\n asyncFns: Array<() => Promise<T>>,\n readonly options?: AsyncQueueOptions,\n ) {\n asyncFns.forEach((afn, _idx) => {\n this.#add('push', afn);\n });\n }\n\n get length() {\n return this.#length;\n }\n\n get limit() {\n return this.options?.limit \|\| 0;\n }\n\n #add(method: 'unshift' \| 'push', afn: () => Promise<T>, pwr?: PromiseWithResolvers<T>) {\n this.#tasks[method]({\n idx: this.#length++,\n afn: afn,\n pwr: pwr,\n });\n }\n\n #addAndRun(method: 'unshift' \| 'push', afn: () => Promise<T>) {\n // 明确终止了\n if (this.#stopLength >= 0) {\n throw new Error('异步队列已被终止，无法添加新的任务');\n }\n\n const pwr = Promise.withResolvers<T>();\n this.#add(method, afn, pwr);\n\n if (this.#startPwr && this.#running === 0) {\n this.#run();\n }\n\n return pwr.promise;\n }\n\n async push(afn: () => Promise<T>) {\n return this.#addAndRun('push', afn);\n }\n\n async unshift(afn: () => Promise<T>) {\n return this.#addAndRun('unshift', afn);\n }\n\n #startResolved = 0;\n #startRejected = 0;\n get startSettled() {\n return this.#startResolved === this.#startLength \|\| this.#startRejected > 0;\n }\n\n #startResults: T[] = [];\n #startPwr: PromiseWithResolvers<T[]> \| null = null;\n #startLength = 0;\n\n /\n 启动队列中的任务执行\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async start(): Promise<T[]> {\n if (this.#startPwr) return this.#startPwr.promise;\n\n // 固化启动时长度，便于判断 start 异步结果\n this.#startLength = this.#length;\n this.#startPwr = Promise.withResolvers<T[]>();\n\n if (this.#startLength === 0) {\n this.#startPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#startPwr.promise;\n }\n\n #running = 0;\n #run() {\n while (this.limit === 0 \|\| this.#running < this.limit) {\n const task = this.#tasks.shift();\n\n // 无任务可执行\n if (!task) break;\n\n this.#running++;\n\n task\n .afn()\n .then((result) => {\n this.#running--;\n task.pwr?.resolve(result);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startResults[task.idx] = result;\n this.#startResolved++;\n }\n\n // 所有启动任务都已执行完毕\n if (this.#startResolved === this.#startLength) {\n this.#startPwr?.resolve(this.#startResults);\n }\n\n this.#stopResults[task.idx] = result;\n this.#stopResolved++;\n\n // 所有停止任务都已执行完毕\n if (this.#stopResolved === this.#stopLength) {\n this.#stopPwr?.resolve(this.#stopResults);\n } else {\n this.#run();\n }\n })\n .catch((reason) => {\n this.#running--;\n task.pwr?.reject(reason);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startRejected++;\n this.#startPwr?.reject(reason);\n }\n\n // 属于停止任务\n if (this.#stopLength > 0) {\n this.#stopRejected++;\n this.#stopPwr?.reject(reason);\n }\n });\n }\n }\n #stopResolved = 0;\n #stopRejected = 0;\n get stopSettled() {\n return this.#stopResolved === this.#stopLength \|\| this.#stopRejected > 0;\n }\n\n #stopLength = -1;\n #stopResults: T[] = [];\n\n #stopPwr?: PromiseWithResolvers<T[]> \| null = null;\n\n /\n 终止队列中的任务执行，终止队列后不再可以追加异步任务\n * @returns 返回一个 Promise，在所有启动任务完成后解析为结果数组\n /\n async stop() {\n if (this.#stopPwr) {\n return this.#stopPwr.promise;\n }\n\n this.#stopLength = this.#length;\n this.#stopPwr = Promise.withResolvers<T[]>();\n\n if (this.#stopLength === 0) {\n this.#stopPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#stopPwr.promise;\n }\n}\n\n/\n 使用给定的并发限制执行异步函数\n \n 此函数的目的是控制一组异步函数的并发执行数量，通过创建一个AsyncQueue实例来管理这些异步函数的执行\n * 它确保在任何给定时间只有最多`limit`数量的异步函数被执行，以避免潜在的性能问题或资源竞争\n \n @param asyncFns 一个包含异步函数的数组，每个异步函数都不需要参数，并返回一个Promise\n * @param limit 并发限制的数量，表示同时执行的异步函数的最大数量，0 表示不限制\n * @returns 返回一个Promise，当所有异步函数都执行完毕后，该Promise将被解析\n /\nexport function asyncLimit<T>(asyncFns: Array<() => Promise<T>>, limit: number) {\n const aq = new AsyncQueue<T>(asyncFns, { limit });\n return aq.start();\n}\n\n/\n 异步共享函数的配置选项\n /\nexport type AsyncSharedOptions<I extends AnyArray, O> = {\n /\n 是否在调用结束后再执行（只在运行期间有再次调用时才会生效）\n * @type {boolean}\n * @default false\n * @example\n * const sharedFn = asyncShared(fetchData, { trailing: true });\n * // 如果在 fetchData 执行期间多次调用 sharedFn，则会在 fetchData 结束后再次执行\n /\n trailing?: boolean;\n\n /\n 缓存结果的最大有效期（毫秒）\n * @type {number}\n * @example\n * const sharedFn = asyncShared(fetchData, { maxAge: 1000 });\n * // 在 1 秒内调用 sharedFn 会直接返回缓存结果\n /\n maxAge?: number;\n\n /\n 在调用共享函数时触发的回调函数\n * @param inputs - 传递给共享函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onTrigger: (...args) => console.log('Calling with:', args)\n * };\n /\n onTrigger?: (...inputs: I) => unknown;\n\n /\n 在执行异步函数时触发的回调函数\n * @param args - 传递给异步函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onExecute: (...args) => console.log('Executing with:', args)\n * };\n /\n onExecute?: (...args: I) => unknown;\n\n /\n 在异步函数成功执行后触发的回调函数\n * @param output - 异步函数的返回结果\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onSuccess: (result) => console.log('Success:', result)\n * };\n /\n onSuccess?: (output: O) => unknown;\n\n /\n 在异步函数执行失败时触发的回调函数\n * @param error - 异步函数抛出的错误\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onError: (error) => console.error('Error:', error)\n * };\n /\n onError?: (error: unknown) => unknown;\n\n /\n 在异步函数执行完成（无论成功或失败）时触发的回调函数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onFinally: () => console.log('Execution completed')\n * };\n /\n onFinally?: () => unknown;\n};\n\n/\n 创建一个共享执行结果的异步函数\n * @template F - 异步函数类型\n * @param {F} af - 要共享的异步函数\n * @param {AsyncSharedOptions} [options] - 配置选项\n * @returns {F} 返回一个新的异步函数，该函数会共享执行结果\n * @example\n * const fetchData = async (id) => {\n * // 模拟异步操作\n * return await fetch(`/api/data/${id}`);\n * };\n \n const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });\n \n // 多次调用会共享同一个请求\n * const result1 = await sharedFetch(1);\n * const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果\n */\nexport function asyncShared<I extends AnyArray, O>(\n af: (...inputs: I) => Promise<O>,\n options?: AsyncSharedOptions<I, O>,\n) {\n let executedPromise: Promise<O> \| undefined;\n let executing = false;\n let executingInputs: I \| undefined;\n let executedTime = 0;\n\n const _sharedAf = async (_from: 'trigger' \| 'trailing', ...inputs: I) => {\n executingInputs = inputs;\n\n // 如果正在运行，则复用运行结果\n if (executing && executedPromise) {\n return executedPromise;\n }\n\n // 如果已运行结束空闲时，判断是否在等待时间内\n if (executedPromise && Date.now() - executedTime < (options?.maxAge \|\| 0)) {\n return executedPromise;\n }\n\n // 否则直接执行\n executing = true;\n options?.onExecute?.(...executingInputs);\n executedPromise = af(...executingInputs);\n executingInputs = undefined;\n executedPromise\n .then((res) => {\n options?.onSuccess?.(res);\n })\n .catch((err) => {\n options?.onError?.(err);\n })\n .finally(() => {\n executing = false;\n executedTime = Date.now();\n options?.onFinally?.();\n\n // 执行期间多次调用，则重新执行\n if (executingInputs && options?.trailing) {\n _sharedAf('trailing', ...executingInputs);\n }\n });\n\n return executedPromise;\n };\n\n return function sharedAf(...inputs: I): Promise<O> {\n options?.onTrigger?.(...inputs);\n const p = _sharedAf('trigger', ...inputs);\n // 必须捕获错误，否则单测错误边界时会抛错\n p.catch(fnNoop);\n return p;\n };\n}\n\n// const af1 = asyncShared(async () => {\n// return 1;\n// });\n// const n = await af1();\n\n// const af2 = asyncShared(async (a: number) => {\n// return a + 1;\n// });\n// const n2 = await af2(2);\n"],"mappings":"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"}

package/dist/cache.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cache.cjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import { type DateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/*\n 缓存选项\n /\nexport type CacheOptions = {\n /\n 缓存的最大时长（毫秒），为 0 时表示永久缓存\n /\n maxAge?: number;\n\n /\n 缓存的过期时间（时间戳、日期字符串、日期对象等）\n * 优先级比 maxAge 更高\n /\n expiredAt?: DateValue;\n};\n\n/\n 缓存项\n * @template T 缓存数据的类型\n /\nexport type Cached<T> = {\n /\n 缓存项的唯一标识\n /\n id: string;\n /\n 缓存的数据\n /\n data: T;\n /\n 缓存项的创建时间（时间戳）\n /\n createdAt: number;\n /\n 缓存项的过期时间（时间戳）\n /\n expiredAt: number;\n};\n\nexport type Cache<T> = {\n get(id: string): MaybePromise<Cached<T> \| null>;\n\n set(id: string, data: T, options?: CacheOptions): MaybePromise<void>;\n\n del(id: string): MaybePromise<void>;\n};\n\n/\n 缓存抽象类\n * @template T 缓存数据的类型\n /\nexport class AbstractCache<T> implements Cache<T> {\n isExpired(cached: Cached<T>) {\n return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n }\n\n normalizeCached(id: string, data: T, options?: CacheOptions): Cached<T> {\n const { expiredAt = 0, maxAge = 0 } = options \|\| {};\n const now = Date.now();\n return {\n id,\n data,\n createdAt: now,\n expiredAt: expiredAt\n ? dateParse(expiredAt).getTime()\n : maxAge > 0\n ? now + maxAge\n : 0,\n };\n }\n\n /\n 获取缓存项\n * @param id 缓存项的唯一标识\n * @returns 返回缓存项或 null\n /\n get(_id: string): MaybePromise<Cached<T> \| null> {\n return null;\n }\n\n /\n 设置缓存项\n * @param id 缓存项的唯一标识\n * @param data 要缓存的数据\n * @param options 缓存选项\n /\n set(_id: string, _data: T, _options?: CacheOptions): MaybePromise<void> {\n //\n }\n\n /\n 删除缓存项\n * @param id 缓存项的唯一标识\n /\n del(_id: string): MaybePromise<void> {\n //\n }\n\n /\n 清空缓存\n /\n clear(): MaybePromise<void> {\n //\n }\n}\n\n/\n 内存缓存实现类\n * @template T 缓存数据的类型\n /\nexport class MemoryCache<T> extends AbstractCache<T> {\n private cache: Map<string, Cached<T>> = new Map();\n\n get(id: string) {\n const cached = this.cache.get(id);\n\n if (!cached) return null;\n\n if (this.isExpired(cached)) {\n this.del(id);\n return null;\n }\n\n return cached;\n }\n\n set(id: string, data: T, options?: CacheOptions) {\n this.cache.set(id, this.normalizeCached(id, data, options));\n }\n\n del(id: string) {\n this.cache.delete(id);\n }\n\n clear() {\n this.cache.clear();\n }\n}\n\n/\n 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n return new MemoryCache<T>();\n}\n"],"mappings":";;;;;;;AAsDA,IAAa,gBAAb,MAAkD;CAChD,UAAU,QAAmB;EAC3B,OAAO,OAAO,YAAY,KAAK,KAAK,KAAK,GAAG,OAAO;;CAGrD,gBAAgB,IAAY,MAAS,SAAmC;EACtE,MAAM,EAAE,YAAY,GAAG,SAAS,MAAM,WAAW,EAAE;EACnD,MAAM,MAAM,KAAK,KAAK;EACtB,OAAO;GACL;GACA;GACA,WAAW;GACX,WAAW,~~YACP~~,aAAA,UAAU,UAAU,CAAC,SAAS,~~GAC9B~~,SAAS,~~IACP~~,MAAM,~~SACN~~;~~GACP~~;;;;;;;CAQH,IAAI,KAA6C;EAC/C,OAAO;;;;;;;;CAST,IAAI,KAAa,OAAU,UAA6C;;;;;CAQxE,IAAI,KAAiC;;;;CAOrC,QAA4B;;;;;;AAS9B,IAAa,cAAb,cAAoC,cAAiB;CACnD,wBAAwC,IAAI,KAAK;CAEjD,IAAI,IAAY;EACd,MAAM,SAAS,KAAK,MAAM,IAAI,GAAG;EAEjC,IAAI,CAAC,QAAQ,OAAO;EAEpB,IAAI,KAAK,UAAU,OAAO,EAAE;GAC1B,KAAK,IAAI,GAAG;GACZ,OAAO;;EAGT,OAAO;;CAGT,IAAI,IAAY,MAAS,SAAwB;EAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,QAAQ,CAAC;;CAG7D,IAAI,IAAY;EACd,KAAK,MAAM,OAAO,GAAG;;CAGvB,QAAQ;EACN,KAAK,MAAM,OAAO;;;;;;;;AAStB,SAAgB,iBAAoB;CAClC,OAAO,IAAI,aAAgB"}
1	+ {"version":3,"file":"cache.cjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import { type DateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/*\n 缓存选项\n /\nexport type CacheOptions = {\n /\n 缓存的最大时长（毫秒），为 0 时表示永久缓存\n /\n maxAge?: number;\n\n /\n 缓存的过期时间（时间戳、日期字符串、日期对象等）\n * 优先级比 maxAge 更高\n /\n expiredAt?: DateValue;\n};\n\n/\n 缓存项\n * @template T 缓存数据的类型\n /\nexport type Cached<T> = {\n /\n 缓存项的唯一标识\n /\n id: string;\n /\n 缓存的数据\n /\n data: T;\n /\n 缓存项的创建时间（时间戳）\n /\n createdAt: number;\n /\n 缓存项的过期时间（时间戳）\n /\n expiredAt: number;\n};\n\nexport type Cache<T> = {\n get(id: string): MaybePromise<Cached<T> \| null>;\n\n set(id: string, data: T, options?: CacheOptions): MaybePromise<void>;\n\n del(id: string): MaybePromise<void>;\n};\n\n/\n 缓存抽象类\n * @template T 缓存数据的类型\n /\nexport class AbstractCache<T> implements Cache<T> {\n isExpired(cached: Cached<T>) {\n return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n }\n\n normalizeCached(id: string, data: T, options?: CacheOptions): Cached<T> {\n const { expiredAt = 0, maxAge = 0 } = options \|\| {};\n const now = Date.now();\n return {\n id,\n data,\n createdAt: now,\n expiredAt: expiredAt ? dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0,\n };\n }\n\n /\n 获取缓存项\n * @param id 缓存项的唯一标识\n * @returns 返回缓存项或 null\n /\n get(_id: string): MaybePromise<Cached<T> \| null> {\n return null;\n }\n\n /\n 设置缓存项\n * @param id 缓存项的唯一标识\n * @param data 要缓存的数据\n * @param options 缓存选项\n /\n set(_id: string, _data: T, _options?: CacheOptions): MaybePromise<void> {\n //\n }\n\n /\n 删除缓存项\n * @param id 缓存项的唯一标识\n /\n del(_id: string): MaybePromise<void> {\n //\n }\n\n /\n 清空缓存\n /\n clear(): MaybePromise<void> {\n //\n }\n}\n\n/\n 内存缓存实现类\n * @template T 缓存数据的类型\n /\nexport class MemoryCache<T> extends AbstractCache<T> {\n private cache: Map<string, Cached<T>> = new Map();\n\n get(id: string) {\n const cached = this.cache.get(id);\n\n if (!cached) return null;\n\n if (this.isExpired(cached)) {\n this.del(id);\n return null;\n }\n\n return cached;\n }\n\n set(id: string, data: T, options?: CacheOptions) {\n this.cache.set(id, this.normalizeCached(id, data, options));\n }\n\n del(id: string) {\n this.cache.delete(id);\n }\n\n clear() {\n this.cache.clear();\n }\n}\n\n/\n 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n return new MemoryCache<T>();\n}\n"],"mappings":";;;;;;;AAsDA,IAAa,gBAAb,MAAkD;CAChD,UAAU,QAAmB;EAC3B,OAAO,OAAO,YAAY,KAAK,KAAK,KAAK,GAAG,OAAO;;CAGrD,gBAAgB,IAAY,MAAS,SAAmC;EACtE,MAAM,EAAE,YAAY,GAAG,SAAS,MAAM,WAAW,EAAE;EACnD,MAAM,MAAM,KAAK,KAAK;EACtB,OAAO;GACL;GACA;GACA,WAAW;GACX,WAAW,YAAY,aAAA,UAAU,UAAU,CAAC,SAAS,GAAG,SAAS,IAAI,MAAM,SAAS;GACrF;;;;;;;CAQH,IAAI,KAA6C;EAC/C,OAAO;;;;;;;;CAST,IAAI,KAAa,OAAU,UAA6C;;;;;CAQxE,IAAI,KAAiC;;;;CAOrC,QAA4B;;;;;;AAS9B,IAAa,cAAb,cAAoC,cAAiB;CACnD,wBAAwC,IAAI,KAAK;CAEjD,IAAI,IAAY;EACd,MAAM,SAAS,KAAK,MAAM,IAAI,GAAG;EAEjC,IAAI,CAAC,QAAQ,OAAO;EAEpB,IAAI,KAAK,UAAU,OAAO,EAAE;GAC1B,KAAK,IAAI,GAAG;GACZ,OAAO;;EAGT,OAAO;;CAGT,IAAI,IAAY,MAAS,SAAwB;EAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,QAAQ,CAAC;;CAG7D,IAAI,IAAY;EACd,KAAK,MAAM,OAAO,GAAG;;CAGvB,QAAQ;EACN,KAAK,MAAM,OAAO;;;;;;;;AAStB,SAAgB,iBAAoB;CAClC,OAAO,IAAI,aAAgB"}

package/dist/cache.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cache.mjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import { type DateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/*\n 缓存选项\n /\nexport type CacheOptions = {\n /\n 缓存的最大时长（毫秒），为 0 时表示永久缓存\n /\n maxAge?: number;\n\n /\n 缓存的过期时间（时间戳、日期字符串、日期对象等）\n * 优先级比 maxAge 更高\n /\n expiredAt?: DateValue;\n};\n\n/\n 缓存项\n * @template T 缓存数据的类型\n /\nexport type Cached<T> = {\n /\n 缓存项的唯一标识\n /\n id: string;\n /\n 缓存的数据\n /\n data: T;\n /\n 缓存项的创建时间（时间戳）\n /\n createdAt: number;\n /\n 缓存项的过期时间（时间戳）\n /\n expiredAt: number;\n};\n\nexport type Cache<T> = {\n get(id: string): MaybePromise<Cached<T> \| null>;\n\n set(id: string, data: T, options?: CacheOptions): MaybePromise<void>;\n\n del(id: string): MaybePromise<void>;\n};\n\n/\n 缓存抽象类\n * @template T 缓存数据的类型\n /\nexport class AbstractCache<T> implements Cache<T> {\n isExpired(cached: Cached<T>) {\n return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n }\n\n normalizeCached(id: string, data: T, options?: CacheOptions): Cached<T> {\n const { expiredAt = 0, maxAge = 0 } = options \|\| {};\n const now = Date.now();\n return {\n id,\n data,\n createdAt: now,\n expiredAt: expiredAt\n ? dateParse(expiredAt).getTime()\n : maxAge > 0\n ? now + maxAge\n : 0,\n };\n }\n\n /\n 获取缓存项\n * @param id 缓存项的唯一标识\n * @returns 返回缓存项或 null\n /\n get(_id: string): MaybePromise<Cached<T> \| null> {\n return null;\n }\n\n /\n 设置缓存项\n * @param id 缓存项的唯一标识\n * @param data 要缓存的数据\n * @param options 缓存选项\n /\n set(_id: string, _data: T, _options?: CacheOptions): MaybePromise<void> {\n //\n }\n\n /\n 删除缓存项\n * @param id 缓存项的唯一标识\n /\n del(_id: string): MaybePromise<void> {\n //\n }\n\n /\n 清空缓存\n /\n clear(): MaybePromise<void> {\n //\n }\n}\n\n/\n 内存缓存实现类\n * @template T 缓存数据的类型\n /\nexport class MemoryCache<T> extends AbstractCache<T> {\n private cache: Map<string, Cached<T>> = new Map();\n\n get(id: string) {\n const cached = this.cache.get(id);\n\n if (!cached) return null;\n\n if (this.isExpired(cached)) {\n this.del(id);\n return null;\n }\n\n return cached;\n }\n\n set(id: string, data: T, options?: CacheOptions) {\n this.cache.set(id, this.normalizeCached(id, data, options));\n }\n\n del(id: string) {\n this.cache.delete(id);\n }\n\n clear() {\n this.cache.clear();\n }\n}\n\n/\n 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n return new MemoryCache<T>();\n}\n"],"mappings":";;;;;;AAsDA,IAAa,gBAAb,MAAkD;CAChD,UAAU,QAAmB;EAC3B,OAAO,OAAO,YAAY,KAAK,KAAK,KAAK,GAAG,OAAO;;CAGrD,gBAAgB,IAAY,MAAS,SAAmC;EACtE,MAAM,EAAE,YAAY,GAAG,SAAS,MAAM,WAAW,EAAE;EACnD,MAAM,MAAM,KAAK,KAAK;EACtB,OAAO;GACL;GACA;GACA,WAAW;GACX,WAAW,~~YACP~~,UAAU,UAAU,CAAC,SAAS,~~GAC9B~~,SAAS,~~IACP~~,MAAM,~~SACN~~;~~GACP~~;;;;;;;CAQH,IAAI,KAA6C;EAC/C,OAAO;;;;;;;;CAST,IAAI,KAAa,OAAU,UAA6C;;;;;CAQxE,IAAI,KAAiC;;;;CAOrC,QAA4B;;;;;;AAS9B,IAAa,cAAb,cAAoC,cAAiB;CACnD,wBAAwC,IAAI,KAAK;CAEjD,IAAI,IAAY;EACd,MAAM,SAAS,KAAK,MAAM,IAAI,GAAG;EAEjC,IAAI,CAAC,QAAQ,OAAO;EAEpB,IAAI,KAAK,UAAU,OAAO,EAAE;GAC1B,KAAK,IAAI,GAAG;GACZ,OAAO;;EAGT,OAAO;;CAGT,IAAI,IAAY,MAAS,SAAwB;EAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,QAAQ,CAAC;;CAG7D,IAAI,IAAY;EACd,KAAK,MAAM,OAAO,GAAG;;CAGvB,QAAQ;EACN,KAAK,MAAM,OAAO;;;;;;;;AAStB,SAAgB,iBAAoB;CAClC,OAAO,IAAI,aAAgB"}
1	+ {"version":3,"file":"cache.mjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import { type DateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/*\n 缓存选项\n /\nexport type CacheOptions = {\n /\n 缓存的最大时长（毫秒），为 0 时表示永久缓存\n /\n maxAge?: number;\n\n /\n 缓存的过期时间（时间戳、日期字符串、日期对象等）\n * 优先级比 maxAge 更高\n /\n expiredAt?: DateValue;\n};\n\n/\n 缓存项\n * @template T 缓存数据的类型\n /\nexport type Cached<T> = {\n /\n 缓存项的唯一标识\n /\n id: string;\n /\n 缓存的数据\n /\n data: T;\n /\n 缓存项的创建时间（时间戳）\n /\n createdAt: number;\n /\n 缓存项的过期时间（时间戳）\n /\n expiredAt: number;\n};\n\nexport type Cache<T> = {\n get(id: string): MaybePromise<Cached<T> \| null>;\n\n set(id: string, data: T, options?: CacheOptions): MaybePromise<void>;\n\n del(id: string): MaybePromise<void>;\n};\n\n/\n 缓存抽象类\n * @template T 缓存数据的类型\n /\nexport class AbstractCache<T> implements Cache<T> {\n isExpired(cached: Cached<T>) {\n return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n }\n\n normalizeCached(id: string, data: T, options?: CacheOptions): Cached<T> {\n const { expiredAt = 0, maxAge = 0 } = options \|\| {};\n const now = Date.now();\n return {\n id,\n data,\n createdAt: now,\n expiredAt: expiredAt ? dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0,\n };\n }\n\n /\n 获取缓存项\n * @param id 缓存项的唯一标识\n * @returns 返回缓存项或 null\n /\n get(_id: string): MaybePromise<Cached<T> \| null> {\n return null;\n }\n\n /\n 设置缓存项\n * @param id 缓存项的唯一标识\n * @param data 要缓存的数据\n * @param options 缓存选项\n /\n set(_id: string, _data: T, _options?: CacheOptions): MaybePromise<void> {\n //\n }\n\n /\n 删除缓存项\n * @param id 缓存项的唯一标识\n /\n del(_id: string): MaybePromise<void> {\n //\n }\n\n /\n 清空缓存\n /\n clear(): MaybePromise<void> {\n //\n }\n}\n\n/\n 内存缓存实现类\n * @template T 缓存数据的类型\n /\nexport class MemoryCache<T> extends AbstractCache<T> {\n private cache: Map<string, Cached<T>> = new Map();\n\n get(id: string) {\n const cached = this.cache.get(id);\n\n if (!cached) return null;\n\n if (this.isExpired(cached)) {\n this.del(id);\n return null;\n }\n\n return cached;\n }\n\n set(id: string, data: T, options?: CacheOptions) {\n this.cache.set(id, this.normalizeCached(id, data, options));\n }\n\n del(id: string) {\n this.cache.delete(id);\n }\n\n clear() {\n this.cache.clear();\n }\n}\n\n/\n 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n return new MemoryCache<T>();\n}\n"],"mappings":";;;;;;AAsDA,IAAa,gBAAb,MAAkD;CAChD,UAAU,QAAmB;EAC3B,OAAO,OAAO,YAAY,KAAK,KAAK,KAAK,GAAG,OAAO;;CAGrD,gBAAgB,IAAY,MAAS,SAAmC;EACtE,MAAM,EAAE,YAAY,GAAG,SAAS,MAAM,WAAW,EAAE;EACnD,MAAM,MAAM,KAAK,KAAK;EACtB,OAAO;GACL;GACA;GACA,WAAW;GACX,WAAW,YAAY,UAAU,UAAU,CAAC,SAAS,GAAG,SAAS,IAAI,MAAM,SAAS;GACrF;;;;;;;CAQH,IAAI,KAA6C;EAC/C,OAAO;;;;;;;;CAST,IAAI,KAAa,OAAU,UAA6C;;;;;CAQxE,IAAI,KAAiC;;;;CAOrC,QAA4B;;;;;;AAS9B,IAAa,cAAb,cAAoC,cAAiB;CACnD,wBAAwC,IAAI,KAAK;CAEjD,IAAI,IAAY;EACd,MAAM,SAAS,KAAK,MAAM,IAAI,GAAG;EAEjC,IAAI,CAAC,QAAQ,OAAO;EAEpB,IAAI,KAAK,UAAU,OAAO,EAAE;GAC1B,KAAK,IAAI,GAAG;GACZ,OAAO;;EAGT,OAAO;;CAGT,IAAI,IAAY,MAAS,SAAwB;EAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,QAAQ,CAAC;;CAG7D,IAAI,IAAY;EACd,KAAK,MAAM,OAAO,GAAG;;CAGvB,QAAQ;EACN,KAAK,MAAM,OAAO;;;;;;;;AAStB,SAAgB,iBAAoB;CAClC,OAAO,IAAI,aAAgB"}