@mudbean/utils 2.0.5

package/CHANGELOG.md

@@ -0,0 +1,170 @@
+# 更新日志
+
+## 2.0.5 (2026-6-11)
+
+- 维护注释信息
+
+## 2.0.4 (2026-6-10)
+
+## 2.0.3 (2026-3-26)
+
+## 2.0.2 (2026-3-24)
+
+- 维护注释信息
+
+## v2.0.1 (2025-12-26)
+
+- 修复类型导出错误
+
+## v2.0.0 (2025-12-24)
+
+## v2.0.0-alpha.0 (2025-6-24)
+
+- 修改了 `debounce` 和 `throttle` 方法的参数类型，该更改可能导致不兼容
+- 修改 `isNode` 校验方式，防止在基于 'chromium' 浏览器插件的后台应用中校验错误
+
+## v1.0.13-beta.5 (2025-9-12)
+
+修复在无法使用 `globalThis.crypto.getRandomValues` 环境下获取随机字符串的长度错误
+
+## v1.0.13-beta.4 (2025-9-12)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.3 (2025-9-12)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.2 (2025-9-11)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.1 (2025-9-11)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.0 (2025-9-7)
+
+for weChatMiniProgram
+
+## v1.0.12 (2025-8-4)
+
+- 移除 `arguments` 在原型上的使用，因为在大多数时候，会编译成严格模式，导致报错
+
+```bash
+    constructor.prototype.arguments = Function.arguments;
+                                               ^
+
+TypeError: 'caller', 'callee', and 'arguments' properties may not be accessed on strict mode functions or the arguments objects for calls to them
+```
+
+## v1.0.11 (2025-8-4)
+
+- 在使用 `createConstructor` 在 webpack 的环境下，发现非标准的函数对象的原型被写了，导致出现了使用函数原型异常的现象。但是为了统一处理，在 `createConstructor` 强制为原型设置原型方法。
+
+## v1.0.10 (2025-7-26)
+
+- 整理文档
+
+## v1.0.10-test.0 (2025-7-24)
+
+- 么事，测试 pnpm 发布
+
+## v1.0.9 (2025-7-19)
+
+- 修复已知问题
+
+## v1.0.8 (2025-7-18)
+
+- 优化了使用 `createConstructor` 的类型声明
+
+## v1.0.7 (2025-7-11)
+
+- 使用 `getRandomString` 时判断是否是浏览器环境，环境判定有误，导致使用 `window.crypto` 使用有误。仙子啊直接使用 `globalThis.crypto` 而非环境判定。
+
+## v1.0.6 (2025-7-9)
+
+- 更新了 `debounce` 和 `throttle` 的回调类型
+
+## v1.0.5 (2025-6-24)
+
+修改 `debounce` 和 `throttle` 的第二参数
+
+## v1.0.13-beta.5 (2025-9-12)
+
+修复在无法使用 `globalThis.crypto.getRandomValues` 环境下获取随机字符串的长度错误
+
+## v1.0.13-beta.4 (2025-9-12)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.3 (2025-9-12)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.2 (2025-9-11)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.1 (2025-9-11)
+
+for weChatMiniProgram
+
+## v1.0.13-beta.0 (2025-9-7)
+
+for weChatMiniProgram
+
+## v1.0.12 (2025-8-4)
+
+- 移除 `arguments` 在原型上的使用，因为在大多数时候，会编译成严格模式，导致报错
+
+```bash
+    constructor.prototype.arguments = Function.arguments;
+                                               ^
+
+TypeError: 'caller', 'callee', and 'arguments' properties may not be accessed on strict mode functions or the arguments objects for calls to them
+```
+
+## v1.0.11 (2025-8-4)
+
+- 在使用 `createConstructor` 在 webpack 的环境下，发现非标准的函数对象的原型被写了，导致出现了使用函数原型异常的现象。但是为了统一处理，在 `createConstructor` 强制为原型设置原型方法。
+
+## v1.0.10 (2025-7-26)
+
+- 整理文档
+
+## v1.0.10-test.0 (2025-7-24)
+
+- 么事，测试 pnpm 发布
+
+## v1.0.9 (2025-7-19)
+
+- 修复已知问题
+
+## v1.0.8 (2025-7-18)
+
+- 优化了使用 `createConstructor` 的类型声明
+
+## v1.0.7 (2025-7-11)
+
+- 使用 `getRandomString` 时判断是否是浏览器环境，环境判定有误，导致使用 `window.crypto` 使用有误。仙子啊直接使用 `globalThis.crypto` 而非环境判定。
+
+## v1.0.6 (2025-7-9)
+
+- 更新了 `debounce` 和 `throttle` 的回调类型
+
+## v1.0.5 (2025-6-24)
+
+修改 `debounce` 和 `throttle` 的第二参数
+
+## v1.0.2 (2025-6-19)
+
+- 移除了 `createConstructor` 这个鸡肋
+
+## v1.0.1 (2025-6-15)
+
+- 文档维护
+
+## v1.0.0 （5 🈷️ 24 日 2025 年）
+
+- 没有说明，莫名其妙的更新

package/LICENSE

@@ -0,0 +1,15 @@
+# MIT License
+
+Copyright (c) <2024> <Mr.MudBean>
+    
+Permission to use, copy, modify, and/or distribute this software for any  
+purpose with or without fee is hereby granted, provided that the above  
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES  
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF  
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR  
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES  
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN  
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF  
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @mudbean/utils
+
+[![version](<https://img.shields.io/npm/v/@mudbean/utils.svg?logo=npm&logoColor=rgb(0,0,0)&label=版本号&labelColor=rgb(73,73,228)&color=rgb(0,0,0)>)](https://www.npmjs.com/package/@mudbean/utils) [![issues 提交](<https://img.shields.io/badge/issues-提交-rgb(255,0,63)?logo=github>)](https://github.com/MrMudBean/utils/issues)
+一个纯函数的工具
+
+mudbean
+
+## 安装
+
+```sh
+npm install --save @mudbean/utils
+
+# pnpm
+pnpm add --save @mudbean/utils
+
+# yarn
+yarn add @mudbean/utils
+```
+
+## 纯函数
+
+- `autoEscapedRegExp` 生成简单的正则表达式
+- `createBezier` 构建简单的贝尔赛曲线
+- `debounce` 防抖函数
+- `escapeRegExp` 转义字符串为简单的正则表达式
+- `getRandomFloat` 获取随机的浮点数
+- `getRandomInt` 获取随机的整数
+- `getRandomString` 获取随机字符串
+- `isBrowser` 是否为浏览器环境
+- `isNode` 是否为 Node 环境
+- `sleep` 你的线程太累了，让它丫的睡一会吧
+- `throttle` 节流函数
+
+## class 名称转化
+
+- `toLowerCamelCase` 转化为小驼峰
+- `toSplitCase` 转化为连接符分隔
+
+## 数组相关
+
+- `intersection` 方法，计算两个数组的交集（两个数组共有的元素）
+- `union` 方法，计算两个数组的并集（两个数组合并在一起并去重）
+- `difference` 方法，计算两个数组的差集（以第一个数组为基准）
+- `symmetricDifference` 方法，计算两个数组的对称差集（在两个数组都不共有的元素）
+- `enArr` 对象，包含上面的方法
+
+## 状态
+
+此软件包是 `@mudbean` 生态系统的一部分。
+它使用严格的 TypeScript 编写，并通过 Rollup 构建进行验证。
+虽然单元测试较少，但 API 稳定，并在生产环境中大量使用。

package/cjs/array/difference.js

@@ -0,0 +1,48 @@
+'use strict';
+
+var is = require('@mudbean/is');
+
+/**
+ *  ## 求给出的两个数组的差值（A - B）
+ *
+ * @param a  - 第一个数组
+ * @param b - 第二个数组
+ * @throws {TypeError} 当两个参数有一个不是
+ * @description 当两个参数有一个不是数组时将抛出
+ * @returns 返回第一个参数相对第二个参数的差值
+ * @example
+ * ```ts
+ * import { difference} from '@mudbean/utils';
+ *
+ * const log = console.log;
+ *
+ * log(difference([], [1, 2, 3])); // []
+ *
+ * log([1, 2, 3], []); //[1, 2, 3]
+ *
+ * log([1, 2, 3, 4, 5, 6, 7], [1, 2, 3, 4, 5]); //[6, 7]
+ *
+ * // 将抛出 TypeError
+ * log(difference([1, 2, 3], 'a'));
+ * log(difference([1, 2, 3], 1));
+ * log(difference([1, 2, 3], undefined));
+ * log(difference([1, 2, 3], null));
+ * log(difference([1, 2, 3],  true));
+ * ```
+ */
+function difference(a, b) {
+    if (!is.isArray(a) || !is.isArray(b)) {
+        throw new TypeError('参数需为数组');
+    }
+    if (is.isEmptyArray(a) || is.isEmptyArray(b)) {
+        return a;
+    }
+    /**  获取两个数组中长度较小的  */
+    // 参数有顺序要求
+    // const [shorter, longer] = a.length > b.length ? [b, a] : [a, b];
+    // const shorterSet = new Set(shorter);
+    const bSet = new Set(b);
+    return a.filter(i => !bSet.has(i));
+}
+
+exports.difference = difference;

package/cjs/array/index.js

@@ -0,0 +1,133 @@
+'use strict';
+
+var intersection = require('./intersection.js');
+var union = require('./union.js');
+var difference = require('./difference.js');
+var symmetricDifference = require('./symmetricDifference.js');
+
+/**
+ * # 数组的一些方法
+ *
+ * - `union` 两个数组的并集（排除共有项）
+ * - `intersection` 两个数组的交集（共有项）
+ * - `difference` 两个数组的差集 （A - B）
+ * - `symmetricDifference`  对称差集 （ A △ B）
+ */
+const enArr = {
+    /**
+     * ## 数组的并集
+     *  <span style="color:#f36;">请注意，参数有不为数组时直接抛出 TypeError</span>
+     * @param arrays  - 多个数组
+     * @returns 联合后的数组
+     * @example
+     *
+     * ```ts
+     * import { union } from '@mudbean/utils';
+     *
+     * const log = console.log;
+     *
+     * // []
+     * log(union());
+     *
+     * // [1, 2, 3]
+     * log(union([1, 2, 3]));
+     *
+     * //  TypeError
+     * log(union([1, 2, 3], 'i'));
+     * log(union([1, 2, 3], undefined));
+     * log(union([1, 2, 3], null));
+     * log(union([1, 2, 3], 4));
+     * log(union([1, 2, 3], {}));
+     * log(union([1, 2, 3], false));
+     *
+     * // [1, 2, 3, 4, 6]
+     * log(union([1, 2, 3], [2, 4, 6]));
+     *
+     * // [1, 2, 3, 4, 6]
+     * log(union([1, 2, 3], [2, 4, 6], [1, 2, 3]));
+     *
+     * // [1, 2, 3, 4, 6]
+     * log(union([1, 2, 3], [2, 4, 6], [1, 2, 3], [1, 2, 3]));
+     * ```
+     */
+    union: union.union,
+    /**
+     * ## 两个数组的交集
+     *
+     * @param a 数组 1️⃣
+     * @param b 数组 2️⃣
+     * @returns 返回两个数组的交集
+     * @example
+     * ```ts
+     * import { intersection } from '@mudbean/utils';
+     *
+     * const log = console.log;
+     *
+     * log(intersection([1, 2, 3, 4], [2, 3])); // [2, 3]
+     * log(intersection([1, 3, 5, 7], [2, 3, 4])); // [3]
+     * ```
+     */
+    intersection: intersection.intersection,
+    /**
+     * ## 求给出的两个数组的差值（A - B）
+     *
+     * @param a  - 第一个数组
+     * @param b - 第二个数组
+     * @throws {TypeError} 当两个参数有一个不是
+     * @description 当两个参数有一个不是数组时将抛出
+     * @returns 返回第一个参数相对第二个参数的差值
+     * @example
+     * ```ts
+     * import { difference} from '@mudbean/utils';
+     *
+     * const log = console.log;
+     *
+     * log(difference([], [1, 2, 3])); // []
+     *
+     * log([1, 2, 3], []); //[1, 2, 3]
+     *
+     * log([1, 2, 3, 4, 5, 6, 7], [1, 2, 3, 4, 5]); //[6, 7]
+     *
+     * // 将抛出 TypeError
+     * log(difference([1, 2, 3], 'a'));
+     * log(difference([1, 2, 3], 1));
+     * log(difference([1, 2, 3], undefined));
+     * log(difference([1, 2, 3], null));
+     * log(difference([1, 2, 3],  true));
+     * ```
+     */
+    difference: difference.difference,
+    /**
+     * ## 对称差集 （ A △ B）
+     *
+     * @param a  - 数组 a
+     * @param b  - 数组 b
+     * @returns - 返回一个全新的数组
+     * @example
+     * ```ts
+     * import { symmetricDifference } from '@mudbean/utils';
+     *
+     * const log = console.log;
+     *
+     * log(symmetricDifference([1, 2], [2, 3])); // [1, 3]
+     *
+     * log(symmetricDifference([1, 2, 3], [1, 2, 4])); // [3, 4]
+     *
+     * log(symmetricDifference([1, 2, 3], [1, 2, 3])); // []
+     *
+     * /// TypeError
+     * log(symmetricDifference(1, []));
+     * log(symmetricDifference(undefined, []));
+     * log(symmetricDifference(null, []));
+     * log(symmetricDifference('a', []));
+     * log(symmetricDifference(true, []));
+     * ```
+     */
+    symmetricDifference: symmetricDifference.symmetricDifference,
+};
+
+exports.intersection = intersection.intersection;
+exports.union = union.union;
+exports.difference = difference.difference;
+exports.symmetricDifference = symmetricDifference.symmetricDifference;
+exports.enArr = enArr;

package/cjs/array/intersection.js

@@ -0,0 +1,40 @@
+'use strict';
+
+var is = require('@mudbean/is');
+
+/**
+ * # 两个数组的交集
+ *
+ * @param a 数组 1️⃣
+ * @param b 数组 2️⃣
+ * @returns 返回两个数组的交集
+ * @example
+ * ```ts
+ * import { intersection } from '@mudbean/utils';
+ *
+ * const log = console.log;
+ *
+ * log(intersection([1, 2, 3, 4], [2, 3])); // [2, 3]
+ * log(intersection([1, 3, 5, 7], [2, 3, 4])); // [3]
+ * ```
+ */
+function intersection(a, b) {
+    if (!is.isArray(a) || !is.isArray(b)) {
+        throw new TypeError('参数必须是数组类型数据');
+    }
+    // 任意数组为空，则返回空数组
+    if (is.isEmptyArray(a) || is.isEmptyArray(b)) {
+        return [];
+    }
+    /**
+     * 在实际运算中， new Set() 的 开销为 O(n) ,filter 的开销也为 O(n)
+     *
+     * 但是以较短的数组创建 Set ，可以节省内存开销
+     */
+    const [shorter, longer] = a.length <= b.length ? [a, b] : [b, a];
+    // 提前创建工具 Set
+    const shortSet = new Set(shorter);
+    return longer.filter(item => shortSet.has(item));
+}
+
+exports.intersection = intersection;

package/cjs/array/symmetricDifference.js

@@ -0,0 +1,45 @@
+'use strict';
+
+var is = require('@mudbean/is');
+var difference = require('./difference.js');
+
+/**
+ * # 对称差集 （ A △ B）
+ *
+ * @param a  - 数组 a
+ * @param b  - 数组 b
+ * @returns - 返回一个全新的数组
+ * @example
+ * ```ts
+ * import { symmetricDifference } from '@mudbean/utils';
+ *
+ * const log = console.log;
+ *
+ * log(symmetricDifference([1, 2], [2, 3])); // [1, 3]
+ *
+ * log(symmetricDifference([1, 2, 3], [1, 2, 4])); // [3, 4]
+ *
+ * log(symmetricDifference([1, 2, 3], [1, 2, 3])); // []
+ *
+ * /// TypeError
+ * log(symmetricDifference(1, []));
+ * log(symmetricDifference(undefined, []));
+ * log(symmetricDifference(null, []));
+ * log(symmetricDifference('a', []));
+ * log(symmetricDifference(true, []));
+ * ```
+ */
+function symmetricDifference(a, b) {
+    if (!is.isArray(a) || !is.isArray(b)) {
+        throw new TypeError('参数必须是数组');
+    }
+    if (is.isEmptyArray(a)) {
+        return [...b];
+    }
+    if (is.isEmptyArray(b)) {
+        return [...a];
+    }
+    return [...difference.difference(a, b), ...difference.difference(b, a)];
+}
+
+exports.symmetricDifference = symmetricDifference;

package/cjs/array/union.js

@@ -0,0 +1,62 @@
+'use strict';
+
+var is = require('@mudbean/is');
+
+/**
+ * # 数组的并集
+ *
+ *  <span style="color:#f36;">请注意，参数有不为数组时直接抛出 TypeError</span>
+ * @param arrays  - 多个数组
+ * @returns 联合后的数组
+ * @example
+ *
+ * ```ts
+ * import { union } from '@mudbean/is';
+ *
+ * const log = console.log;
+ *
+ * // []
+ * log(union());
+ *
+ * // [1, 2, 3]
+ * log(union([1, 2, 3]));
+ *
+ * //  TypeError
+ * log(union([1, 2, 3], 'i'));
+ * log(union([1, 2, 3], undefined));
+ * log(union([1, 2, 3], null));
+ * log(union([1, 2, 3], 4));
+ * log(union([1, 2, 3], {}));
+ * log(union([1, 2, 3], false));
+ *
+ * // [1, 2, 3, 4, 6]
+ * log(union([1, 2, 3], [2, 4, 6]));
+ *
+ * // [1, 2, 3, 4, 6]
+ * log(union([1, 2, 3], [2, 4, 6], [1, 2, 3]));
+ *
+ * // [1, 2, 3, 4, 6]
+ * log(union([1, 2, 3], [2, 4, 6], [1, 2, 3], [1, 2, 3]));
+ * ```
+ *
+ */
+function union(...arrays) {
+    if (is.isEmptyArray(arrays)) {
+        return [];
+    }
+    if (arrays.some(i => !is.isArray(i))) {
+        throw new TypeError('参数必须都是数组形式的元素');
+    }
+    if (arrays.length === 1) {
+        return [...arrays[0]];
+    }
+    const resultSet = new Set();
+    for (const array of arrays) {
+        for (const item of array) {
+            resultSet.add(item);
+        }
+    }
+    return Array.from(resultSet);
+}
+
+exports.union = union;

package/cjs/className.js

@@ -0,0 +1,55 @@
+'use strict';
+
+/**
+ * 驼峰命名与连字符命名法的互换
+ */
+/**
+ * # 连字符连接转化为小/大驼峰命名法
+ *
+ * @param str    待转化文本
+ * @param dividingType   连字符，缺省值为 "-"
+ * @param initial 是否转换第一个字符。默认值为 false （小驼峰类型）
+ * @returns 驼峰命名法字符串（e.g. “helloWorld”）
+ */
+function toLowerCamelCase(
+/**  待转化文本  */
+str, 
+/**  连字符，缺省值为 "-"  */
+dividingType = '-', 
+/** 是否转换第一个字符。默认值为 false （小驼峰类型） */
+initial = false) {
+    let result = str;
+    /**
+     * 匹配规则
+     *
+     * - 匹配到分隔符，将分隔符后面的字符转化为大写
+     */
+    const template = /[\\]|[\^]|[?]|[-]|[.]|[(]|[)]|[|]|[[]\[\]]|[{]|[}]|[+]|[*]|[$]/;
+    /**
+     *  转化首字符
+     * @param _str
+     * @param _dividingType
+     */
+    const toTransform = (_str, _dividingType) => _str.replace(new RegExp(`${template.test(_dividingType) ? `\\${_dividingType}` : _dividingType}([a-zA-Z])`, 'g'), (match, p1) => p1.toUpperCase());
+    // 多分隔符转化
+    dividingType
+        .split('')
+        .forEach((item) => (result = toTransform(result, item)));
+    return initial
+        ? result.replace(/^./, (match) => match.toUpperCase())
+        : result;
+}
+/**
+ * # 驼峰命名法转化为连字符连接
+ *
+ * @param str          待转化文本
+ * @param dividingType       分割符
+ * @returns 分割符转化的文本 (e.g. 'hello-world')
+ */
+function toSplitCase(str, dividingType = '-') {
+    const result = str.replace(/[A-Z]/g, (match) => dividingType.concat(match.toLowerCase()));
+    return result.startsWith(dividingType) ? result.substring(1) : result;
+}
+
+exports.toLowerCamelCase = toLowerCamelCase;
+exports.toSplitCase = toSplitCase;