a-js-tools 1.0.12 → 1.0.13-beta.1

package/src/object/createConstructor.mjs

@@ -1,49 +0,0 @@
-/**
- *
- * 构建一个 Constructor 构造函数
- *
- * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
- *
- * 函数本身并没有执行任何逻辑，仅是简单的返回了实参自身
- *
- * 而经过该函数的包装，构造函数成了能够被 TS 识别为可用 new 实例的构造函数
- *
- * @param constructor - 传入一个构造函数
- * @returns 返回传入的构造函数
- *
- * ```ts
- * import { createConstructor } from "a-js-tools";
- *
- * 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;
-}
-
-export { createConstructor };

package/src/performance.cjs

@@ -1,116 +0,0 @@
-'use strict';
-
-var aTypeOfJs = require('a-type-of-js');
-
-/**
- * 防抖和节流
- *
- * @packageDocumentation
- * @module @a-js-tools/performance
- * @license MIT
- */
-/**
- *
- * 防抖
- *
- * @param   callback 回调函数
- * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
- * @returns   返回的闭包函数
- * @example
- *
- * ```ts
- * const debounce = (callback: Function, delay = 300) => {
- *   let timer: any = null
- *   return (...args: any[]) => {
- *     clearTimeout(timer)
- *   }
- * }
- *
- */
-function debounce(callback, options = 200) {
-    if (!aTypeOfJs.isFunction(callback))
-        throw new TypeError('callback must be a function');
-    if (aTypeOfJs.isNumber(options))
-        options = {
-            delay: options,
-            this: null,
-        };
-    if (aTypeOfJs.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 {
-                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   返回的闭包函数
- */
-function throttle(callback, options = 200) {
-    if (!aTypeOfJs.isFunction(callback))
-        throw new TypeError('callback must be a function');
-    if (aTypeOfJs.isNumber(options))
-        options = {
-            delay: options,
-            this: null,
-        };
-    if (aTypeOfJs.isUndefined(options.delay) ||
-        !isFinite(options.delay) ||
-        options.delay < 0)
-        // 强制转换非数值
-        options.delay = 200;
-    /**  延迟控制插销   */
-    let inThrottle = false;
-    /**  延迟控制   */
-    let timeoutId = null;
-    const throttled = (...args) => {
-        if (inThrottle)
-            return;
-        try {
-            Reflect.apply(callback, options?.this ?? null, args);
-        }
-        catch (error) {
-            console.error('Throttle 执行回调抛出问题', error);
-        }
-        inThrottle = true;
-        if (!aTypeOfJs.isNull(timeoutId))
-            clearTimeout(timeoutId);
-        timeoutId = setTimeout(() => {
-            inThrottle = false;
-            timeoutId = null;
-        }, Math.max(options?.delay ?? 5, 5));
-    };
-    throttled.cancel = () => {
-        if (!aTypeOfJs.isNull(timeoutId))
-            clearTimeout(timeoutId);
-        inThrottle = false;
-        timeoutId = null;
-    };
-    return throttled;
-}
-
-exports.debounce = debounce;
-exports.throttle = throttle;

package/src/performance.mjs

@@ -1,113 +0,0 @@
-import { isFunction, isNumber, isUndefined, isNull } from 'a-type-of-js';
-
-/**
- * 防抖和节流
- *
- * @packageDocumentation
- * @module @a-js-tools/performance
- * @license MIT
- */
-/**
- *
- * 防抖
- *
- * @param   callback 回调函数
- * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
- * @returns   返回的闭包函数
- * @example
- *
- * ```ts
- * const debounce = (callback: Function, delay = 300) => {
- *   let timer: any = null
- *   return (...args: any[]) => {
- *     clearTimeout(timer)
- *   }
- * }
- *
- */
-function debounce(callback, options = 200) {
-    if (!isFunction(callback))
-        throw new TypeError('callback must be a function');
-    if (isNumber(options))
-        options = {
-            delay: options,
-            this: null,
-        };
-    if (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 {
-                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   返回的闭包函数
- */
-function throttle(callback, options = 200) {
-    if (!isFunction(callback))
-        throw new TypeError('callback must be a function');
-    if (isNumber(options))
-        options = {
-            delay: options,
-            this: null,
-        };
-    if (isUndefined(options.delay) ||
-        !isFinite(options.delay) ||
-        options.delay < 0)
-        // 强制转换非数值
-        options.delay = 200;
-    /**  延迟控制插销   */
-    let inThrottle = false;
-    /**  延迟控制   */
-    let timeoutId = null;
-    const throttled = (...args) => {
-        if (inThrottle)
-            return;
-        try {
-            Reflect.apply(callback, options?.this ?? null, args);
-        }
-        catch (error) {
-            console.error('Throttle 执行回调抛出问题', error);
-        }
-        inThrottle = true;
-        if (!isNull(timeoutId))
-            clearTimeout(timeoutId);
-        timeoutId = setTimeout(() => {
-            inThrottle = false;
-            timeoutId = null;
-        }, Math.max(options?.delay ?? 5, 5));
-    };
-    throttled.cancel = () => {
-        if (!isNull(timeoutId))
-            clearTimeout(timeoutId);
-        inThrottle = false;
-        timeoutId = null;
-    };
-    return throttled;
-}
-
-export { debounce, throttle };

package/src/regexp/autoEscapedRegExp.cjs

@@ -1,48 +0,0 @@
-'use strict';
-
-var aTypeOfJs = require('a-type-of-js');
-var escapeRegExp = require('./escapeRegExp.cjs');
-var parse = require('./parse.cjs');
-
-/**
- *
- * ##  适用于简单的文本字符串自动转化为简单模式正则表达式
- *
- * *若字符串包含且需保留字符类、组、反向引用、量词等时，该方法可能不适用*
- *
- * @param pattern 待转化的文本字符串
- * @param options 转化选项。 为文本字符串时，默认为正则表达式的标志，还可指定是否匹配开头或结尾
- * @returns 正则表达式
- * @example
- *
- * ```ts
- * import { autoEscapedRegExp } from 'a-regexp';
- *
- * 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 (!aTypeOfJs.isString(pattern))
-        throw new TypeError('pattern must be a 字符串');
-    pattern = escapeRegExp.escapeRegExp(pattern);
-    /** 简单转化  */
-    if (aTypeOfJs.isUndefined(options))
-        return new RegExp(pattern);
-    options = parse.parse(options);
-    return new RegExp(`${options.start ? '^' : ''}${pattern}${options.end ? '$' : ''}`, options.flags);
-}
-
-exports.autoEscapedRegExp = autoEscapedRegExp;

package/src/regexp/autoEscapedRegExp.mjs

@@ -1,46 +0,0 @@
-import { isString, isUndefined } from 'a-type-of-js';
-import { escapeRegExp } from './escapeRegExp.mjs';
-import { parse } from './parse.mjs';
-
-/**
- *
- * ##  适用于简单的文本字符串自动转化为简单模式正则表达式
- *
- * *若字符串包含且需保留字符类、组、反向引用、量词等时，该方法可能不适用*
- *
- * @param pattern 待转化的文本字符串
- * @param options 转化选项。 为文本字符串时，默认为正则表达式的标志，还可指定是否匹配开头或结尾
- * @returns 正则表达式
- * @example
- *
- * ```ts
- * import { autoEscapedRegExp } from 'a-regexp';
- *
- * 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 (!isString(pattern))
-        throw new TypeError('pattern must be a 字符串');
-    pattern = escapeRegExp(pattern);
-    /** 简单转化  */
-    if (isUndefined(options))
-        return new RegExp(pattern);
-    options = parse(options);
-    return new RegExp(`${options.start ? '^' : ''}${pattern}${options.end ? '$' : ''}`, options.flags);
-}
-
-export { autoEscapedRegExp };

package/src/regexp/escapeRegExp.cjs

@@ -1,24 +0,0 @@
-'use strict';
-
-/**
- *
- * 将一个字符串转化为符合正则要求的字符串
- *
- * @param str 需要转义的字符串
- * @requires escapeRegExp 转化后字符串
- * @example
- *
- * ```ts
- *  import { escapeRegExp  } from 'a-js-tools';
- *
- *  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;

package/src/regexp/escapeRegExp.mjs

@@ -1,22 +0,0 @@
-/**
- *
- * 将一个字符串转化为符合正则要求的字符串
- *
- * @param str 需要转义的字符串
- * @requires escapeRegExp 转化后字符串
- * @example
- *
- * ```ts
- *  import { escapeRegExp  } from 'a-js-tools';
- *
- *  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, '\\$&');
-}
-
-export { escapeRegExp };

package/src/regexp/parse.cjs

@@ -1,32 +0,0 @@
-'use strict';
-
-var aTypeOfJs = require('a-type-of-js');
-
-/**
- *
- * 解析 options
- *
- */
-function parse(options) {
-    // 处理 options
-    if (aTypeOfJs.isString(options)) {
-        options = {
-            flags: options,
-        };
-    }
-    // 处理 flags
-    if (!aTypeOfJs.isString(options.flags))
-        options.flags = '';
-    else {
-        // 需求是保留字符串中的某一部分，使用
-        const regexp = /[migsuy]/g;
-        const matchResult = options.flags.match(regexp);
-        if (aTypeOfJs.isNull(matchResult))
-            options.flags = '';
-        else
-            options.flags = [...new Set(matchResult)].join('');
-    }
-    return options;
-}
-
-exports.parse = parse;

package/src/regexp/parse.mjs

@@ -1,30 +0,0 @@
-import { isString, isNull } from 'a-type-of-js';
-
-/**
- *
- * 解析 options
- *
- */
-function parse(options) {
-    // 处理 options
-    if (isString(options)) {
-        options = {
-            flags: options,
-        };
-    }
-    // 处理 flags
-    if (!isString(options.flags))
-        options.flags = '';
-    else {
-        // 需求是保留字符串中的某一部分，使用
-        const regexp = /[migsuy]/g;
-        const matchResult = options.flags.match(regexp);
-        if (isNull(matchResult))
-            options.flags = '';
-        else
-            options.flags = [...new Set(matchResult)].join('');
-    }
-    return options;
-}
-
-export { parse };

package/src/sleep.cjs

@@ -1,38 +0,0 @@
-'use strict';
-
-var aTypeOfJs = require('a-type-of-js');
-
-/**
- *
- * ## 线程休息
- *
- * 但从调用到执行完毕总是与期望的时间并不相吻合，除非执行是线型的（也不保证时间的严格性）
- *
- * - 宏任务：整体代码、setTimeout、DOM 事件回调、requestAnimationFrame、setImmediate、setInterval、I/O操作、UI渲染等
- * - 微任务：Promise的then/catch/finally、process.nextTick（Node.js）、MutationObserver、queueMicrotask（显示添加微任务）等
- *
- * <span style="color:#ff0;">*Node.js中的process.nextTick优先级高于其他微任务*</span>
- *
- * @param delay 睡觉时长（机器时间，毫秒为单位）
- * @returns 🈳
- * @example
- *
- * ```ts
- * import { sleep } from 'a-js-tools';
- *
- * console.log(Date.now()); // 1748058118471
- * await sleep(1000);
- * console.log(Date.now()); // 1748058119473
- *
- * ```
- *
- */
-async function sleep(delay = 1000) {
-    if (!isFinite(delay) || delay < 0)
-        throw new TypeError('delay 应该是一个正常的数值');
-    if (aTypeOfJs.isZero(delay))
-        return Promise.resolve();
-    return new Promise(resolve => setTimeout(resolve, delay));
-}
-
-exports.sleep = sleep;

package/src/sleep.mjs

@@ -1,36 +0,0 @@
-import { isZero } from 'a-type-of-js';
-
-/**
- *
- * ## 线程休息
- *
- * 但从调用到执行完毕总是与期望的时间并不相吻合，除非执行是线型的（也不保证时间的严格性）
- *
- * - 宏任务：整体代码、setTimeout、DOM 事件回调、requestAnimationFrame、setImmediate、setInterval、I/O操作、UI渲染等
- * - 微任务：Promise的then/catch/finally、process.nextTick（Node.js）、MutationObserver、queueMicrotask（显示添加微任务）等
- *
- * <span style="color:#ff0;">*Node.js中的process.nextTick优先级高于其他微任务*</span>
- *
- * @param delay 睡觉时长（机器时间，毫秒为单位）
- * @returns 🈳
- * @example
- *
- * ```ts
- * import { sleep } from 'a-js-tools';
- *
- * console.log(Date.now()); // 1748058118471
- * await sleep(1000);
- * console.log(Date.now()); // 1748058119473
- *
- * ```
- *
- */
-async function sleep(delay = 1000) {
-    if (!isFinite(delay) || delay < 0)
-        throw new TypeError('delay 应该是一个正常的数值');
-    if (isZero(delay))
-        return Promise.resolve();
-    return new Promise(resolve => setTimeout(resolve, delay));
-}
-
-export { sleep };