@mudbean/utils 2.0.5

package/cjs/createBezier.js

@@ -0,0 +1,135 @@
+'use strict';
+
+/**
+ * @file createBezier.ts
+ * @description 生成贝尔赛曲线
+ * @author Mr.MudBean <Mr.MudBean@outlook.com>
+ * @copyright 2026 ©️ Mr.MudBean
+ * @since 2026-03-26 11:24
+ * @version 2.0.2
+ * @lastModified 2026-06-11 19:07
+ *
+ * ## [贝尔赛曲线](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Reference/Values/easing-function#%E4%B8%89%E6%AC%A1%E8%B4%9D%E5%A1%9E%E5%B0%94%E7%BC%93%E5%8A%A8%E5%87%BD%E6%95%B0)
+ *
+ * 一种通过控制点生成光滑曲线的数学参数曲线，是平滑插值曲线。
+ *
+ * 广泛应用于计算机图像学、字体设计、动画游戏开发、工业设计和医学图像处理。
+ *
+ * 常见的贝尔赛曲线类型有二次和三次，其中三次贝尔赛曲线使用最多。曲线具有端点插值、凸包性。
+ *
+ */
+/**
+ * # 在 JS 中模拟 CSS cubic-bezier(p1x, p1y, p2x, p2y)
+ *
+ * @param p1x - 第一个控制点 X
+ * @param p1y - 第一个控制点 Y
+ * @param p2x - 第二个控制点 X
+ * @param p2y - 第二个控制点 Y
+ * @returns 一个接收时间 t (0-1) 返回进度值 (0-1 或超出) 的函数
+ * @example
+ * ```ts
+ * // --- 使用示例 ---
+ *
+ * // 1. 定义一个类似 CSS 'ease-in-out' 的曲线: cubic-bezier(0.42, 0, 0.58, 1)
+ * const myEaseInOut = createBezier(0.42, 0, 0.58, 1);
+ *
+ * // 2. 定义一个带回弹效果的曲线: cubic-bezier(0.68, -0.55, 0.27, 1.55)
+ * const myElastic = createBezier(0.68, -0.55, 0.27, 1.55);
+ *
+ * // 3. 在 JS 动画循环中使用
+ * let startTime = null;
+ * const duration = 1000; // 1秒
+ * const element = document.getElementById('box');
+ *
+ * function animate(timestamp) {
+ *   if (!startTime) startTime = timestamp;
+ *   const elapsed = timestamp - startTime;
+ *
+ *   // 计算归一化时间 (0 到 1)
+ *   let rawTime = Math.min(elapsed / duration, 1);
+ *
+ *   // 【关键点】将线性时间 rawTime 传入贝塞尔函数，得到非线性进度
+ *   const progress = myElastic(rawTime);
+ *
+ *   // 应用进度 (例如移动距离)
+ *   const distance = 300 * progress;
+ *   element.style.transform = `translateX(${distance}px)`;
+ *
+ *   if (elapsed < duration) {
+ *     requestAnimationFrame(animate);
+ *   }
+ * }
+ *
+ * requestAnimationFrame(animate);
+ * ```
+ */
+function createBezier(p1x, p1y, p2x, p2y) {
+    // 三次贝塞尔曲线公式: B(t) = (1-t)^3 * P0 + 3(1-t)^2*t * P1 + 3(1-t)*t^2 * P2 + t^3 * P3
+    // 这里 P0=(0,0), P3=(1,1)
+    const cx = 3 * p1x;
+    const bx = 3 * (p2x - p1x) - cx;
+    const ax = 1 - cx - bx;
+    const cy = 3 * p1y;
+    const by = 3 * (p2y - p1y) - cy;
+    const ay = 1 - cy - by;
+    // 计算给定 t 的 x 值
+    /**
+     * @param t
+     */
+    function sampleCurveX(t) {
+        return ((ax * t + bx) * t + cx) * t;
+    }
+    /**
+     * ### 计算给定 t 的 y 值
+     * @param t 时间进度
+     */
+    function sampleCurveY(t) {
+        return ((ay * t + by) * t + cy) * t;
+    }
+    /**
+     * ### 核心难点：已知 x (时间)，求 t。因为 x(t) 是单调的，可以用牛顿迭代法求解
+     * @param x 时间进度
+     */
+    function getTForX(x) {
+        let t0, t1, t2, x2, d2;
+        // 初始猜测
+        t2 = x;
+        // 牛顿迭代法 (通常 8 次足够精确)
+        for (let i = 0; i < 8; i++) {
+            x2 = sampleCurveX(t2) - x;
+            if (Math.abs(x2) < 1e-6)
+                return t2;
+            d2 = (3 * ax * t2 + 2 * bx) * t2 + cx;
+            if (Math.abs(d2) < 1e-6)
+                break;
+            t2 = t2 - x2 / d2;
+        }
+        // 如果牛顿法失败，退化为二分法
+        t0 = 0;
+        t1 = 1;
+        t2 = x;
+        while (t0 < t1) {
+            x2 = sampleCurveX(t2);
+            if (Math.abs(x2 - x) < 1e-6)
+                return t2;
+            if (x > x2)
+                t0 = t2;
+            else
+                t1 = t2;
+            t2 = (t1 - t0) * 0.5 + t0;
+        }
+        return t2;
+    }
+    // 返回最终的计算函数
+    return function (t) {
+        // 边界处理：CSS 允许 t < 0 或 t > 1 (产生回弹效果)
+        if (t <= 0)
+            return sampleCurveY(0);
+        if (t >= 1)
+            return sampleCurveY(1);
+        const realT = getTForX(t);
+        return sampleCurveY(realT);
+    };
+}
+
+exports.createBezier = createBezier;

package/cjs/getRandomNumber.js

@@ -0,0 +1,70 @@
+'use strict';
+
+var is = require('@mudbean/is');
+
+/**
+ * 获取随机数
+ */
+/**
+ * # 获取一个随机的整数类型
+ *
+ * 您可以传入两个参数并获取它们之间的任意数字，返回值<span style="color:#ff0;">*会包含端值*</span>
+ *
+ * 如果只传递一个参数，则如果提供的值为负数，则得到一个小于（或大于）该数字的整数
+ *
+ * @param   max 较大值 ，不允许为`NaN`
+ * @param   min 较小值，不允许为 `NaN`
+ * @returns  任意的整数
+ */
+function getRandomInt(max = 1, min = 0) {
+    //  判断是否为 NaN 或 不是数字
+    if (!isFinite(max) ||
+        !isFinite(min) ||
+        is.isNaN(max) ||
+        is.isNaN(min) ||
+        !is.isNumber(max) ||
+        !is.isNumber(min)) {
+        throw new TypeError('getRandomInt: max or min is NaN or is not a number');
+    }
+    /**  获取最小值  */
+    let _min = Math.ceil(Number(min)), 
+    /**  获取最大值  */
+    _max = Math.floor(Number(max));
+    //  两值相等时，直接返回最大值
+    if (_max === _min)
+        return _max;
+    //  两值交换
+    if (_min > _max)
+        [_max, _min] = [_min, _max];
+    return Math.round(Math.random() * (_max - _min) + _min);
+}
+/**
+ * # 获取任意的浮点数
+ *
+ * 您可以传入两个参数并获取它们之间的任意数字
+ *
+ * 如果只传入一个参数，则如果提供的值为负数，则获取小于（或大于）该数字的浮点数
+ *
+ * @param   max 较大数，缺省值为 1
+ * @param min 较小值，缺省值为 0
+ * @returns  任意的浮点数
+ */
+function getRandomFloat(max = 1, min = 0) {
+    //  判断是否为 NaN 或 不是数字
+    if (!isFinite(max) ||
+        !isFinite(min) ||
+        is.isNaN(max) ||
+        is.isNaN(min) ||
+        !is.isNumber(max) ||
+        !is.isNumber(min)) {
+        throw new TypeError('getRandomInt: max or min is NaN or is not a number');
+    }
+    if (max == min)
+        max++;
+    if (min > max)
+        [max, min] = [min, max];
+    return Math.random() * (max - min) + min;
+}
+
+exports.getRandomFloat = getRandomFloat;
+exports.getRandomInt = getRandomInt;

package/cjs/getRandomString.js

@@ -0,0 +1,143 @@
+'use strict';
+
+var is = require('@mudbean/is');
+var createConstructor = require('./object/createConstructor.js');
+var getRandomNumber = require('./getRandomNumber.js');
+
+/**
+ * 获取随机字符串
+ */
+/**
+ * # 获取简单的随机字符串
+ *
+ * ```ts
+ * type RandomStringOptions = {
+ *     length?: number; // 字符串长度
+ *     chars?: string;  // 包含英文字符
+ *     includeNumbers?: boolean; // 包含数字
+ *     includeUppercaseLetters?: boolean; // 包含大写字符
+ *     includeSpecial?: boolean; // 包含特殊字符
+ *     type?: 'string' | 'uuid'; // 生成类型
+ * }
+ * ```
+ *
+ * @param  options - 字符串生成参数
+ * @returns  - 随机字符串
+ * @example
+ * ```ts
+ * import { getRandomString } from '@mudbean/utils';
+ *
+ * // 获取简单的随机字符串
+ * // 'abcdefg'
+ * getRandomString(7);
+ *
+ * // 获取随机的字符串
+ * getRandomString({
+ *    length: 7,
+ * })
+ * ```
+ */
+function getRandomString(options) {
+    //   验证输入参数
+    if (
+    // 参数类型错误
+    (!is.isPlainObject(options) && !is.isNumber(options)) ||
+        // 参数为 NaN
+        (is.isNumber(options) && is.isNaN(options)) ||
+        // 参数为数字时为无穷大
+        (is.isNumber(options) && !isFinite(options)) ||
+        // 参数为数字时为非整数
+        (is.isNumber(options) && !Number.isInteger(options)) ||
+        // 参数为数字时为负数
+        (is.isNumber(options) && Number.isInteger(options) && options < 1) ||
+        // 参数为数值然而却小于 1
+        (is.isNumber(options) && options < 1) ||
+        // 参数为对象但是 length 属性非数值
+        (is.isPlainObject(options) &&
+            (!is.isNumber(options.length) ||
+                options.length < 1 ||
+                !Number.isInteger(options.length))))
+        throw new TypeError('参数类型错误 ❌ (getRandomString)');
+    const initOptions = {
+        length: 32,
+        chars: 'abcdefghijklmnopqrstuvwxyz',
+        chars2: '0123456789',
+        chars3: '!@#$%^&*()_+~`|}{[]:;?><,./-=',
+        type: 'string',
+        includeUppercaseLetters: false,
+        includeNumbers: false,
+        includeSpecial: false,
+    };
+    /// 生成 UUID
+    if (initOptions.type === 'uuid')
+        return crypto.randomUUID();
+    // 验证输入参数
+    if (is.isNumber(options) && Number.isInteger(options) && options > 0)
+        createConstructor.ObjectAssign(initOptions, { length: options });
+    if (is.isPlainObject(options)) {
+        createConstructor.ObjectAssign(initOptions, options);
+        initOptions.length = initOptions.length < 1 ? 32 : initOptions.length;
+    }
+    /**  生成随机字符串  */
+    const templateCharsArr = initOptions.chars.split('');
+    // 添加大写字母
+    if (initOptions.includeUppercaseLetters)
+        interleaveString(templateCharsArr, initOptions.chars.toUpperCase());
+    // 添加数字
+    if (initOptions.includeNumbers)
+        interleaveString(templateCharsArr, initOptions.chars2);
+    // 添加特殊字符
+    if (initOptions.includeSpecial)
+        interleaveString(templateCharsArr, initOptions.chars3);
+    /** 结果字符串 */
+    let result = '';
+    /** 混淆后的字符串 */
+    const str = templateCharsArr.join('');
+    /** 混淆后字符长度 */
+    const strLen = str.length;
+    if (globalThis && globalThis.crypto && globalThis.crypto.getRandomValues) {
+        // 使用密码学安全的随机数生成器
+        const bytes = globalThis.crypto.getRandomValues(new Uint8Array(initOptions.length));
+        /**  获取最后的 chars 数据  */
+        // 循环遍历
+        bytes.forEach(byte => (result += str[byte % strLen]));
+    }
+    else {
+        for (let i = 0; i < initOptions.length; i++)
+            result += str[getRandomNumber.getRandomInt(strLen - 1)];
+    }
+    /**
+     * # 字符串交叉函数
+     *
+     * 非线形串交叉，对相交叉
+     *
+     * @param  str1 - 字符串1
+     * @param  str2 - 字符串2
+     * @returns - 交叉后的字符串
+     * @example
+     *
+     * ```ts
+     * interleaveString('abc', '123') // 'a1b2c3'
+     * ```
+     */
+    function interleaveString(str1, str2) {
+        const str1Length = str1.length, str2Length = str2.length;
+        const maxLength = Math.max(str1Length, str2Length);
+        for (let i = 0; i < maxLength; i++) {
+            if (i < str1Length && !is.isUndefined(str2[i])) {
+                str1[i] += str2[i];
+            }
+            else if (i < str2Length) {
+                str1[i] = str2[i];
+            }
+        }
+    }
+    /// 结果字符串不包含字符
+    if (!/[a-zA-Z]/.test(result))
+        return String.fromCharCode(getRandomNumber.getRandomInt(97, 122)).concat(result.slice(1));
+    while (!/^[a-zA-Z]$/.test(result[0]))
+        result = result.slice(1) + result[0];
+    return result;
+}
+
+exports.getRandomString = getRandomString;

package/cjs/index.js

@@ -0,0 +1,40 @@
+'use strict';
+
+var className = require('./className.js');
+var createConstructor = require('./object/createConstructor.js');
+var getRandomNumber = require('./getRandomNumber.js');
+var getRandomString = require('./getRandomString.js');
+var performance = require('./performance.js');
+var escapeRegExp = require('./regexp/escapeRegExp.js');
+var autoEscapedRegExp = require('./regexp/autoEscapedRegExp.js');
+var isNode = require('./isNode.js');
+var index = require('./array/index.js');
+var sleep = require('./sleep.js');
+var createBezier = require('./createBezier.js');
+var difference = require('./array/difference.js');
+var intersection = require('./array/intersection.js');
+var symmetricDifference = require('./array/symmetricDifference.js');
+var union = require('./array/union.js');
+
+
+
+exports.toLowerCamelCase = className.toLowerCamelCase;
+exports.toSplitCase = className.toSplitCase;
+exports.ObjectAssign = createConstructor.ObjectAssign;
+exports.createConstructor = createConstructor.createConstructor;
+exports.getRandomFloat = getRandomNumber.getRandomFloat;
+exports.getRandomInt = getRandomNumber.getRandomInt;
+exports.getRandomString = getRandomString.getRandomString;
+exports.debounce = performance.debounce;
+exports.throttle = performance.throttle;
+exports.escapeRegExp = escapeRegExp.escapeRegExp;
+exports.autoEscapedRegExp = autoEscapedRegExp.autoEscapedRegExp;
+exports.isBrowser = isNode.isBrowser;
+exports.isNode = isNode.isNode;
+exports.enArr = index.enArr;
+exports.sleep = sleep.sleep;
+exports.createBezier = createBezier.createBezier;
+exports.difference = difference.difference;
+exports.intersection = intersection.intersection;
+exports.symmetricDifference = symmetricDifference.symmetricDifference;
+exports.union = union.union;

package/cjs/isNode.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var is = require('@mudbean/is');
+
+/**
+ * # 判断当前环境是否为 node 环境
+ */
+function isNode() {
+    return !is.isUndefined((globalThis &&
+        globalThis.process &&
+        globalThis.process.versions &&
+        globalThis.process.versions.node) ||
+        undefined);
+}
+/**
+ * # 是否为浏览器环境
+ */
+function isBrowser() {
+    return !isNode();
+}
+
+exports.isBrowser = isBrowser;
+exports.isNode = isNode;

package/cjs/object/createConstructor.js

@@ -0,0 +1,59 @@
+'use strict';
+
+/**
+ * # 构建一个 Constructor 构造函数
+ *
+ * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
+ *
+ * 函数本身并没有执行任何逻辑，仅是简单的返回了实参自身
+ *
+ * 而经过该函数的包装，构造函数成了能够被 TS 识别为可用 new 实例的构造函数
+ *
+ * @param constructor - 传入一个构造函数
+ * @returns 返回传入的构造函数
+ * @example
+ * ```ts
+ * import { createConstructor } from "@mudbean/utils";
+ *
+ * type Tom = {
+ *   a: number
+ * }
+ *
+ * function _Tom (this: TomType): Tom {
+ *    this.a = 1;
+ *
+ *    return this;
+ * }
+ *
+ * // 逻辑上没有错，但是会造成 ts 显示
+ * // 其目标缺少构造签名的 "new" 表达式隐式具有 "any" 类型。ts(7009)
+ * const a = new _Tom();
+ *
+ * const tomConstructor = createConstructor(_tom);
+ *
+ * const b = new tomConstructor(); // 这时就不会显示错误
+ * ```
+ */
+function createConstructor(constructor) {
+    constructor.prototype.apply = Function.apply;
+    constructor.prototype.bind = Function.bind;
+    constructor.prototype.call = Function.call;
+    constructor.prototype.length = Function.length;
+    // constructor.prototype.arguments = Function.arguments;
+    constructor.prototype.name = Function.name;
+    constructor.prototype.toString = Function.toString;
+    return constructor;
+}
+/**
+ * # 对象的 assign 用法
+ * @param target
+ * @param bar
+ */
+function ObjectAssign(target, bar) {
+    const keys = Object.keys(bar);
+    keys.forEach(key => (target[key] = bar[key]));
+    return target;
+}
+
+exports.ObjectAssign = ObjectAssign;
+exports.createConstructor = createConstructor;

package/cjs/performance.js

@@ -0,0 +1,138 @@
+'use strict';
+
+var is = require('@mudbean/is');
+
+/**
+ * 防抖和节流
+ */
+/**
+ * # 防抖
+ *
+ * @param   callback 回调函数
+ * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
+ * @returns   返回的闭包函数
+ * @example
+ *
+ * ```ts
+ * import { debounce } from '@mudbean/utils';
+ *
+ * const debounce = (callback: Function, delay = 300) => {
+ *   let timer: any = null
+ *
+ *   return (...args: any[]) => clearTimeout(timer)
+ * }
+ *
+ * debounce(); // 未执行
+ * debounce(); // 未执行
+ * debounce(); // 未执行
+ * debounce(); // 执行
+ * ```
+ */
+function debounce(callback, options = 200) {
+    if (!is.isFunction(callback))
+        throw new TypeError('callback must be a function');
+    if (is.isNumber(options))
+        options = {
+            delay: options,
+            this: null,
+        };
+    if (is.isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
+        // 强制转换非数值
+        options.delay = 200;
+    /**  定时器返回的 id  */
+    let timeoutId;
+    const clear = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+        }
+    };
+    const result = (...args) => {
+        clear();
+        timeoutId = setTimeout(() => {
+            try {
+                const _this = options && options.this ? options.this : null;
+                // 由于 Reflect.apply 并不能在 ES5 中使用，所以我们并不能保证能执行成功
+                callback.apply(_this, args);
+                // Reflect.apply(callback, options?.this ?? null, args);
+            }
+            catch (error) {
+                console.log('Debounce callback throw an error', error);
+            }
+        }, Math.max(options.delay || 5, 5));
+    };
+    result.cancel = () => clear();
+    return result;
+}
+/**
+ * # 节流
+ *
+ * @param callback   回调函数
+ * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this
+ * @returns   返回的闭包函数
+ * @example
+ *
+ * ```ts
+ * import { throttle , sleep } form "@mudbean/utils";
+ *
+ * const a_throttle_fn = throttle(()=> {
+ *    console.log("hello");
+ * }, 1200);
+ *
+ * a_throttle_fn(); // 正常打印
+ * a_throttle_fn(); // 跳过打印
+ * await sleep(1200);   // 等待 1200ms
+ * a_throttle_fn(); // 正常打印
+ * a_throttle_fn(); // 跳过打印
+ * ```
+ */
+function throttle(callback, options = 200) {
+    if (!is.isFunction(callback))
+        throw new TypeError('callback must be a function');
+    if (is.isNumber(options))
+        options = {
+            delay: options,
+            this: null,
+        };
+    if (is.isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
+        // 强制转换非数值
+        options.delay = 200;
+    /**  延迟控制插销   */
+    let inThrottle = false;
+    /**  延迟控制   */
+    let timeoutId = null;
+    const delay = options && options.delay ? options.delay : 5;
+    const throttled = (...args) => {
+        if (inThrottle)
+            return;
+        try {
+            const _this = options && options.this ? options.this : null;
+            callback.apply(_this, args);
+        }
+        catch (error) {
+            console.error('Throttle 执行回调抛出问题', error);
+        }
+        inThrottle = true;
+        if (!is.isNull(timeoutId))
+            clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+            inThrottle = false;
+            timeoutId = null;
+        }, Math.max(delay, 5));
+    };
+    throttled.cancel = () => {
+        if (!is.isNull(timeoutId)) {
+            clearTimeout(timeoutId);
+        }
+        inThrottle = false;
+        timeoutId = null;
+    };
+    return throttled;
+}
+
+exports.debounce = debounce;
+exports.throttle = throttle;

package/cjs/regexp/autoEscapedRegExp.js

@@ -0,0 +1,44 @@
+'use strict';
+
+var is = require('@mudbean/is');
+var escapeRegExp = require('./escapeRegExp.js');
+var parse = require('./parse.js');
+
+/**
+ * # 适用于简单的文本字符串自动转化为简单模式正则表达式
+ *
+ * *若字符串包含且需保留字符类、组、反向引用、量词等时，该方法可能不适用*
+ *
+ * @param pattern 待转化的文本字符串
+ * @param options 转化选项。 为文本字符串时，默认为正则表达式的标志，还可指定是否匹配开头或结尾
+ * @returns 正则表达式
+ * @example
+ * ```ts
+ * import { autoEscapedRegExp } from '@mudbean/utils';
+ *
+ * autoEscapedRegExp('abc'); // => /abc/
+ * autoEscapedRegExp('abc', 'gim'); // => /abc/gim
+ * autoEscapedRegExp('abc',  { flags: 'g', start: true }); // => /^abc/g
+ * autoEscapedRegExp('abc',  { flags: 'g', end: true }); // => /abc$/g
+ * autoEscapedRegExp('abc',  { start: true, end: true }); // => /^abc$/
+ *
+ * // 转化特殊字符类、组、反向引用、量词等
+ * // 无法保留匹配规则
+ * autoEscapedRegExp('a-zA-Z0-9'); // => /a-zA-Z0-9/
+ * autoEscapedRegExp('a-zA-Z0-9', 'g'); // => /a-zA-Z0-9/g
+ * autoEscapedRegExp('[a-zA-Z0-9]'); // => /\[a-zA-Z0-9\]/
+ * autoEscapedRegExp('^[a-zA-Z0-9]+$'); // => /\^\[a-zA-Z0-9\]\$/
+ * ```
+ */
+function autoEscapedRegExp(pattern, options) {
+    if (!is.isString(pattern))
+        throw new TypeError('pattern must be a 字符串');
+    pattern = escapeRegExp.escapeRegExp(pattern);
+    /** 简单转化  */
+    if (is.isUndefined(options))
+        return new RegExp(pattern);
+    options = parse.parse(options);
+    return new RegExp(`${options.start ? '^' : ''}${pattern}${options.end ? '$' : ''}`, options.flags);
+}
+
+exports.autoEscapedRegExp = autoEscapedRegExp;

package/cjs/regexp/escapeRegExp.js

@@ -0,0 +1,22 @@
+'use strict';
+
+/**
+ * # 将一个字符串转化为符合正则要求的字符串
+ *
+ * @param str 需要转义的字符串
+ * @requires escapeRegExp 转化后字符串
+ * @example
+ * ```ts
+ * import { escapeRegExp  } from '@mudbean/utils';
+ *
+ * escapeRegExp('a.b.c'); // 'a\\.b\\.c'
+ * escapeRegExp('a\\.b\\.c'); // 'a\\\\.b\\\\.c'
+ * escapeRegExp('[a-z]'); // '\\[a-z\\]'
+ * escapeRegExp('^abc$'); // '\\^abc\\$'
+ * ```
+ */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+exports.escapeRegExp = escapeRegExp;