a-js-tools 2.0.1 → 2.0.3

package/{es/src/isNode.d.ts → isNode.d.ts}

@@ -1,12 +1,8 @@
 /**
- *
  * 判断当前环境是否为 node 环境
- *
  */
 export declare function isNode(): boolean;
 /**
- *
  * 是否为浏览器环境
- *
  */
 export declare function isBrowser(): boolean;

package/{es/isNode.js → isNode.es.js}

@@ -1,9 +1,7 @@
 import { isUndefined } from 'a-type-of-js';
 
 /**
- *
  * 判断当前环境是否为 node 环境
- *
  */
 function isNode() {
     return !isUndefined((globalThis &&
@@ -13,9 +11,7 @@ function isNode() {
         undefined);
 }
 /**
- *
  * 是否为浏览器环境
- *
  */
 function isBrowser() {
     return !isNode();

package/{cjs/object/createConstructor.js → object/createConstructor.cjs.js}

@@ -1,8 +1,7 @@
 'use strict';
 
 /**
- *
- * 构建一个 Constructor 构造函数
+ * # 构建一个 Constructor 构造函数
  *
  * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
  *
@@ -12,7 +11,7 @@
  *
  * @param constructor - 传入一个构造函数
  * @returns 返回传入的构造函数
- *
+ * @example
  * ```ts
  * import { createConstructor } from "a-js-tools";
  *
@@ -33,9 +32,7 @@
  * const tomConstructor = createConstructor(_tom);
  *
  * const b = new tomConstructor(); // 这时就不会显示错误
- *
  * ```
- *
  */
 function createConstructor(constructor) {
     constructor.prototype.apply = Function.apply;

package/{es/src/object → object}/createConstructor.d.ts

@@ -1,15 +1,11 @@
 /**
- *
  * 构建构建的构建函数
- *
- *
  */
 export interface CreateConstructor<T, Args extends unknown[] = unknown[]> {
     new (...args: Args): T;
 }
 /**
- *
- * 构建一个 Constructor 构造函数
+ * # 构建一个 Constructor 构造函数
  *
  * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
  *
@@ -19,7 +15,7 @@ export interface CreateConstructor<T, Args extends unknown[] = unknown[]> {
  *
  * @param constructor - 传入一个构造函数
  * @returns 返回传入的构造函数
- *
+ * @example
  * ```ts
  * import { createConstructor } from "a-js-tools";
  *
@@ -40,9 +36,7 @@ export interface CreateConstructor<T, Args extends unknown[] = unknown[]> {
  * const tomConstructor = createConstructor(_tom);
  *
  * const b = new tomConstructor(); // 这时就不会显示错误
- *
  * ```
- *
  */
 export declare function createConstructor<T, Args extends unknown[] = unknown[]>(constructor: (...argumentList: Args) => T): CreateConstructor<T, Args>;
 /** 对象的 assign 用法 */

package/{es/object/createConstructor.js → object/createConstructor.es.js}

@@ -1,6 +1,5 @@
 /**
- *
- * 构建一个 Constructor 构造函数
+ * # 构建一个 Constructor 构造函数
  *
  * 接收一个构造函数，然后返回 TS 能识别的构造函数自身
  *
@@ -10,7 +9,7 @@
  *
  * @param constructor - 传入一个构造函数
  * @returns 返回传入的构造函数
- *
+ * @example
  * ```ts
  * import { createConstructor } from "a-js-tools";
  *
@@ -31,9 +30,7 @@
  * const tomConstructor = createConstructor(_tom);
  *
  * const b = new tomConstructor(); // 这时就不会显示错误
- *
  * ```
- *
  */
 function createConstructor(constructor) {
     constructor.prototype.apply = Function.apply;

package/package.json

@@ -1,18 +1,18 @@
 {
   "type": "module",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "name": "a-js-tools",
   "license": "MIT",
   "dependencies": {
-    "a-type-of-js": "^2.0.0"
+    "a-type-of-js": "^2.0.1"
   },
   "main": "cjs/index.js",
   "module": "es/index.js",
-  "types": "es/src/index.d.ts",
+  "types": "es/types/index.d.ts",
   "author": {
     "name": "泥豆君",
     "email": "Mr.MudBean@outlook.com",
-    "url": "https://earthnut.dev"
+    "url": "https://lmssee.com"
   },
   "description": "一点点 🤏  js 函数",
   "sideEffects": false,
@@ -20,71 +20,102 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "es",
-    "cjs",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "array",
+    "className.cjs.js",
+    "className.d.ts",
+    "className.es.js",
+    "createBezier.cjs.js",
+    "createBezier.d.ts",
+    "createBezier.es.js",
+    "getRandomNumber.cjs.js",
+    "getRandomNumber.d.ts",
+    "getRandomNumber.es.js",
+    "getRandomString.cjs.js",
+    "getRandomString.d.ts",
+    "getRandomString.es.js",
+    "index.cjs.js",
+    "index.es.js",
+    "index.d.ts",
+    "isNode.cjs.js",
+    "isNode.d.ts",
+    "isNode.es.js",
+    "object",
+    "performance.cjs.js",
+    "performance.d.ts",
+    "performance.es.js",
+    "regexp",
+    "sleep.cjs.js",
+    "sleep.d.ts",
+    "sleep.es.js"
   ],
   "exports": {
     ".": {
-      "import": "./es/index.js",
-      "default": "./es/index.js",
-      "require": "./cjs/index.js",
-      "types": "./es/src/index.d.ts"
+      "import": "./index.es.js",
+      "default": "./index.es.js",
+      "require": "./index.es.js",
+      "types": "./index.d.ts"
     },
     "./array": {
-      "default": "./es/array/index.js",
-      "import": "./es/array/index.js",
-      "require": "./cjs/array/index.js",
-      "types": "./es/src/array/index.d.ts"
+      "default": "./array/index.es.js",
+      "import": "./array/index.es.js",
+      "require": "./array/index.cjs.js",
+      "types": "./array/index.d.ts"
     },
     "./className": {
-      "default": "./es/className.js",
-      "import": "./es/className.js",
-      "require": "./cjs/className.js",
-      "types": "./es/src/className.d.ts"
+      "default": "./className.es.js",
+      "import": "./className.es.js",
+      "require": "./className.cjs.js",
+      "types": "./className.d.ts"
+    },
+    "./createBezier": {
+      "default": "./createBezier.es.js",
+      "import": "./createBezier.es.js",
+      "require": "./createBezier.cjs.js",
+      "types": "./createBezier.d.ts"
     },
     "./getRandomNumber": {
-      "default": "./es/getRandomNumber.js",
-      "import": "./es/getRandomNumber.js",
-      "require": "./cjs/getRandomNumber.js",
-      "types": "./es/src/getRandomNumber.d.ts"
+      "default": "./getRandomNumber.es.js",
+      "import": "./getRandomNumber.es.js",
+      "require": "./getRandomNumber.cjs.js",
+      "types": "./getRandomNumber.d.ts"
     },
     "./getRandomString": {
-      "default": "./es/getRandomString.js",
-      "import": "./es/getRandomString.js",
-      "require": "./cjs/getRandomString.js",
-      "types": "./es/src/getRandomString.d.ts"
+      "default": "./getRandomString.es.js",
+      "import": "./getRandomString.es.js",
+      "require": "./getRandomString.cjs.js",
+      "types": "./getRandomString.d.ts"
     },
     "./isNode": {
-      "default": "./es/isNode.js",
-      "import": "./es/isNode.js",
-      "require": "./cjs/isNode.js",
-      "types": "./es/src/isNode.d.ts"
+      "default": "./isNode.es.js",
+      "import": "./isNode.es.js",
+      "require": "./isNode.cjs.js",
+      "types": "./isNode.d.ts"
     },
     "./object": {
-      "default": "./es/object/index.js",
-      "import": "./es/object/index.js",
-      "require": "./cjs/object/index.js",
-      "types": "./es/src/object/index.d.ts"
+      "default": "./object/index.es.js",
+      "import": "./object/index.es.js",
+      "require": "./object/index.cjs.js",
+      "types": "./object/index.d.ts"
     },
     "./performance": {
-      "default": "./es/performance.js",
-      "import": "./es/performance.js",
-      "require": "./cjs/performance.js",
-      "types": "./es/src/performance.d.ts"
+      "default": "./performance.es.js",
+      "import": "./performance.es.js",
+      "require": "./performance.cjs.js",
+      "types": "./performance.d.ts"
     },
     "./regexp": {
-      "default": "./es/regexp/index.js",
-      "import": "./es/regexp/index.js",
-      "require": "./cjs/regexp/index.js",
-      "types": "./es/src/regexp/index.d.ts"
+      "default": "./regexp/index.es.js",
+      "import": "./regexp/index.es.js",
+      "require": "./regexp/index.cjs.js",
+      "types": "./regexp/index.d.ts"
     },
     "./sleep": {
-      "default": "./es/sleep.js",
-      "import": "./es/sleep.js",
-      "require": "./cjs/sleep.js",
-      "types": "./es/src/sleep.d.ts"
+      "default": "./sleep.es.js",
+      "import": "./sleep.es.js",
+      "require": "./sleep.cjs.js",
+      "types": "./sleep.d.ts"
     }
   },
   "repository": {
@@ -93,11 +124,9 @@
   },
   "keywords": [
     "a-js-tools",
-    "Mr.MudBean",
-    "earthnut",
-    "js tools"
+    "js 工具"
   ],
-  "homepage": "https://earthnut.dev/npm/a-js-tools",
+  "homepage": "https://lmssee.com/npm/a-js-tools",
   "bugs": {
     "url": "https://github.com/MrMudBean/a-js-tools/issues",
     "email": "Mr.MudBean@outlook.com"

package/{cjs/performance.js → performance.cjs.js}

@@ -1,18 +1,11 @@
 'use strict';
 
 var aTypeOfJs = require('a-type-of-js');
-var isFunction = require('a-type-of-js/isFunction');
-var isNumber = require('a-type-of-js/isNumber');
 
 /**
  * 防抖和节流
- *
- * @packageDocumentation
- * @module @a-js-tools/performance
- * @license MIT
  */
 /**
- *
  * 防抖
  *
  * @param   callback 回调函数
@@ -23,16 +16,15 @@ var isNumber = require('a-type-of-js/isNumber');
  * ```ts
  * const debounce = (callback: Function, delay = 300) => {
  *   let timer: any = null
- *   return (...args: any[]) => {
- *     clearTimeout(timer)
- *   }
- * }
  *
+ *   return (...args: any[]) => clearTimeout(timer)
+ * }
+ * ```
  */
 function debounce(callback, options = 200) {
-    if (!isFunction.isFunction(callback))
+    if (!aTypeOfJs.isFunction(callback))
         throw new TypeError('callback must be a function');
-    if (isNumber.isNumber(options))
+    if (aTypeOfJs.isNumber(options))
         options = {
             delay: options,
             this: null,
@@ -68,16 +60,16 @@ function debounce(callback, options = 200) {
     return result;
 }
 /**
- *   节流
+ * 节流
  *
  * @param callback   回调函数
  * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this
  * @returns   返回的闭包函数
  */
 function throttle(callback, options = 200) {
-    if (!isFunction.isFunction(callback))
+    if (!aTypeOfJs.isFunction(callback))
         throw new TypeError('callback must be a function');
-    if (isNumber.isNumber(options))
+    if (aTypeOfJs.isNumber(options))
         options = {
             delay: options,
             this: null,

package/{es/src/performance.d.ts → performance.d.ts}

@@ -1,15 +1,6 @@
-/**
- * 防抖和节流
- *
- * @packageDocumentation
- * @module @a-js-tools/performance
- * @license MIT
- */
 type Callback = (...args: any[]) => void;
 /**
- *
  * 节流和防抖返回值类型
- *
  */
 export interface DebounceAndThrottleReturnType<F extends Callback> {
     (...args: Parameters<F>): void;
@@ -21,7 +12,6 @@ export type debounce_throttle_options = {
     this?: null | unknown;
 } | number;
 /**
- *
  * 防抖
  *
  * @param   callback 回调函数
@@ -32,15 +22,14 @@ export type debounce_throttle_options = {
  * ```ts
  * const debounce = (callback: Function, delay = 300) => {
  *   let timer: any = null
- *   return (...args: any[]) => {
- *     clearTimeout(timer)
- *   }
- * }
  *
+ *   return (...args: any[]) => clearTimeout(timer)
+ * }
+ * ```
  */
 export declare function debounce<F extends Callback>(callback: F, options?: debounce_throttle_options): DebounceAndThrottleReturnType<F>;
 /**
- *   节流
+ * 节流
  *
  * @param callback   回调函数
  * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this

package/{es/performance.js → performance.es.js}

@@ -1,16 +1,9 @@
-import { isUndefined, isNull } from 'a-type-of-js';
-import { isFunction } from 'a-type-of-js/isFunction';
-import { isNumber } from 'a-type-of-js/isNumber';
+import { isFunction, isNumber, isUndefined, isNull } from 'a-type-of-js';
 
 /**
  * 防抖和节流
- *
- * @packageDocumentation
- * @module @a-js-tools/performance
- * @license MIT
  */
 /**
- *
  * 防抖
  *
  * @param   callback 回调函数
@@ -21,11 +14,10 @@ import { isNumber } from 'a-type-of-js/isNumber';
  * ```ts
  * const debounce = (callback: Function, delay = 300) => {
  *   let timer: any = null
- *   return (...args: any[]) => {
- *     clearTimeout(timer)
- *   }
- * }
  *
+ *   return (...args: any[]) => clearTimeout(timer)
+ * }
+ * ```
  */
 function debounce(callback, options = 200) {
     if (!isFunction(callback))
@@ -66,7 +58,7 @@ function debounce(callback, options = 200) {
     return result;
 }
 /**
- *   节流
+ * 节流
  *
  * @param callback   回调函数
  * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this

package/{cjs/regexp/autoEscapedRegExp.js → regexp/autoEscapedRegExp.cjs.js}

@@ -1,12 +1,11 @@
 'use strict';
 
 var aTypeOfJs = require('a-type-of-js');
-var escapeRegExp = require('./escapeRegExp.js');
-var parse = require('./parse.js');
+var escapeRegExp = require('./escapeRegExp.cjs.js');
+var parse = require('./parse.cjs.js');
 
 /**
- *
- * ##  适用于简单的文本字符串自动转化为简单模式正则表达式
+ * ## 适用于简单的文本字符串自动转化为简单模式正则表达式
  *
  * *若字符串包含且需保留字符类、组、反向引用、量词等时，该方法可能不适用*
  *
@@ -14,7 +13,6 @@ var parse = require('./parse.js');
  * @param options 转化选项。 为文本字符串时，默认为正则表达式的标志，还可指定是否匹配开头或结尾
  * @returns 正则表达式
  * @example
- *
  * ```ts
  * import { autoEscapedRegExp } from 'a-regexp';
  *
@@ -30,9 +28,7 @@ var parse = require('./parse.js');
  * 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))

package/{es/src/regexp → regexp}/autoEscapedRegExp.d.ts

@@ -1,7 +1,6 @@
 import { autoEscapedRegExpOptions } from './types';
 /**
- *
- * ##  适用于简单的文本字符串自动转化为简单模式正则表达式
+ * ## 适用于简单的文本字符串自动转化为简单模式正则表达式
  *
  * *若字符串包含且需保留字符类、组、反向引用、量词等时，该方法可能不适用*
  *
@@ -9,7 +8,6 @@ import { autoEscapedRegExpOptions } from './types';
  * @param options 转化选项。 为文本字符串时，默认为正则表达式的标志，还可指定是否匹配开头或结尾
  * @returns 正则表达式
  * @example
- *
  * ```ts
  * import { autoEscapedRegExp } from 'a-regexp';
  *
@@ -25,8 +23,6 @@ import { autoEscapedRegExpOptions } from './types';
  * 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\]\$/
- *
  * ```
- *
  */
 export declare function autoEscapedRegExp(pattern: string, options?: string | autoEscapedRegExpOptions): RegExp;

package/{es/regexp/autoEscapedRegExp.js → regexp/autoEscapedRegExp.es.js}

@@ -1,10 +1,9 @@
 import { isString, isUndefined } from 'a-type-of-js';
-import { escapeRegExp } from './escapeRegExp.js';
-import { parse } from './parse.js';
+import { escapeRegExp } from './escapeRegExp.es.js';
+import { parse } from './parse.es.js';
 
 /**
- *
- * ##  适用于简单的文本字符串自动转化为简单模式正则表达式
+ * ## 适用于简单的文本字符串自动转化为简单模式正则表达式
  *
  * *若字符串包含且需保留字符类、组、反向引用、量词等时，该方法可能不适用*
  *
@@ -12,7 +11,6 @@ import { parse } from './parse.js';
  * @param options 转化选项。 为文本字符串时，默认为正则表达式的标志，还可指定是否匹配开头或结尾
  * @returns 正则表达式
  * @example
- *
  * ```ts
  * import { autoEscapedRegExp } from 'a-regexp';
  *
@@ -28,9 +26,7 @@ import { parse } from './parse.js';
  * 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))

package/regexp/escapeRegExp.cjs.js

@@ -0,0 +1,22 @@
+'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/regexp/escapeRegExp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * # 将一个字符串转化为符合正则要求的字符串
+ *
+ * @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\\$'
+ * ```
+ */
+export declare function escapeRegExp(str: string): string;

package/regexp/escapeRegExp.es.js

@@ -0,0 +1,20 @@
+/**
+ * # 将一个字符串转化为符合正则要求的字符串
+ *
+ * @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/{cjs/regexp/parse.js → regexp/parse.cjs.js}

@@ -3,9 +3,7 @@
 var aTypeOfJs = require('a-type-of-js');
 
 /**
- *
  * 解析 options
- *
  */
 function parse(options) {
     // 处理 options

package/{es/src/regexp → regexp}/parse.d.ts

@@ -1,7 +1,5 @@
 import { autoEscapedRegExpOptions } from './types';
 /**
- *
  * 解析 options
- *
  */
 export declare function parse(options: string | autoEscapedRegExpOptions): autoEscapedRegExpOptions;

package/{es/regexp/parse.js → regexp/parse.es.js}

@@ -1,9 +1,7 @@
 import { isString, isNull } from 'a-type-of-js';
 
 /**
- *
  * 解析 options
- *
  */
 function parse(options) {
     // 处理 options

package/{es/src/regexp → regexp}/types.d.ts

@@ -1,14 +1,9 @@
 export interface autoEscapedRegExpOptions {
     /**
-     *
-     *
-     *
      */
     flags?: string;
     /**
-     *
      * 匹配开头
-     *
      */
     start?: boolean;
     end?: boolean;