lyb-js 1.1.4 → 1.1.6

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 (82) hide show
  1. package/README.md +108 -46
  2. package/dist/Base/LibJsGetDataType/index.d.ts +1 -5
  3. package/dist/Base/LibJsGetDataType/index.js +1 -5
  4. package/dist/Base/LibJsPromiseTimeout/index.d.ts +1 -5
  5. package/dist/Base/LibJsPromiseTimeout/index.js +1 -5
  6. package/dist/Browser/LibJsColorConsole/index.d.ts +1 -7
  7. package/dist/Browser/LibJsColorConsole/index.js +1 -7
  8. package/dist/Browser/LibJsIsMobile/index.d.ts +1 -4
  9. package/dist/Browser/LibJsIsMobile/index.js +1 -4
  10. package/dist/Browser/LibJsIsPad/index.d.ts +1 -4
  11. package/dist/Browser/LibJsIsPad/index.js +1 -4
  12. package/dist/Browser/LibJsObjToUrlParams/index.d.ts +1 -4
  13. package/dist/Browser/LibJsObjToUrlParams/index.js +1 -4
  14. package/dist/Browser/LibJsPathParams/index.d.ts +1 -4
  15. package/dist/Browser/LibJsPathParams/index.js +1 -4
  16. package/dist/Browser/LibJsSetTitleIcon/index.d.ts +1 -3
  17. package/dist/Browser/LibJsSetTitleIcon/index.js +1 -3
  18. package/dist/Browser/LibJsTagTitleTip/index.d.ts +1 -3
  19. package/dist/Browser/LibJsTagTitleTip/index.js +1 -3
  20. package/dist/Data/LibJsChunkArray/index.d.ts +1 -4
  21. package/dist/Data/LibJsChunkArray/index.js +1 -4
  22. package/dist/Data/LibJsDeepJSONParse/index.d.ts +1 -4
  23. package/dist/Data/LibJsDeepJSONParse/index.js +1 -4
  24. package/dist/Data/LibJsGroupArrayByKey/index.d.ts +1 -4
  25. package/dist/Data/LibJsGroupArrayByKey/index.js +1 -4
  26. package/dist/Data/LibJsMatchEmail/index.d.ts +1 -4
  27. package/dist/Data/LibJsMatchEmail/index.js +1 -4
  28. package/dist/Data/LibJsShuffleArray/index.d.ts +1 -4
  29. package/dist/Data/LibJsShuffleArray/index.js +1 -4
  30. package/dist/Data/LibJsStepArray/index.d.ts +1 -4
  31. package/dist/Data/LibJsStepArray/index.js +1 -4
  32. package/dist/Data/LibReverseArrayFromIndex/index.d.ts +1 -4
  33. package/dist/Data/LibReverseArrayFromIndex/index.js +1 -4
  34. package/dist/File/LibJsDownloadImageLink/index.d.ts +1 -3
  35. package/dist/File/LibJsDownloadImageLink/index.js +1 -3
  36. package/dist/File/LibJsImageOptimizer/index.d.ts +1 -14
  37. package/dist/File/LibJsImageOptimizer/index.js +1 -14
  38. package/dist/File/LibJsSaveJson/index.d.ts +1 -4
  39. package/dist/File/LibJsSaveJson/index.js +1 -4
  40. package/dist/Formatter/LibJsFormatterByte/index.d.ts +1 -4
  41. package/dist/Formatter/LibJsFormatterByte/index.js +1 -4
  42. package/dist/Formatter/LibJsMaskPhoneNumber/index.d.ts +1 -4
  43. package/dist/Formatter/LibJsMaskPhoneNumber/index.js +1 -4
  44. package/dist/Formatter/LibJsNumComma/index.d.ts +1 -4
  45. package/dist/Formatter/LibJsNumComma/index.js +1 -4
  46. package/dist/Formatter/LibJsNumberUnit/index.d.ts +1 -4
  47. package/dist/Formatter/LibJsNumberUnit/index.js +1 -4
  48. package/dist/Formatter/LibJsSecondsFormatterChinese/index.d.ts +1 -6
  49. package/dist/Formatter/LibJsSecondsFormatterChinese/index.js +1 -6
  50. package/dist/Math/LibJsCalculateExpression/index.d.ts +1 -4
  51. package/dist/Math/LibJsCalculateExpression/index.js +16 -17
  52. package/dist/Math/LibJsConvertAngle/index.d.ts +1 -7
  53. package/dist/Math/LibJsConvertAngle/index.js +1 -7
  54. package/dist/Math/LibJsCoordsAngle/index.d.ts +1 -5
  55. package/dist/Math/LibJsCoordsAngle/index.js +1 -5
  56. package/dist/Math/LibJsCoordsDistance/index.d.ts +1 -5
  57. package/dist/Math/LibJsCoordsDistance/index.js +1 -5
  58. package/dist/Math/LibJsDecimal/index.d.ts +1 -5
  59. package/dist/Math/LibJsDecimal/index.js +1 -5
  60. package/dist/Misc/LibJsRegFormValidate/index.d.ts +1 -16
  61. package/dist/Misc/LibJsRegFormValidate/index.js +1 -16
  62. package/dist/Misc/LibJsRetryRequest/index.d.ts +1 -12
  63. package/dist/Misc/LibJsRetryRequest/index.js +1 -12
  64. package/dist/Misc/LibNumerStepper/index.d.ts +1 -6
  65. package/dist/Misc/LibNumerStepper/index.js +1 -6
  66. package/dist/Random/LibJsProbabilityResult/index.d.ts +1 -5
  67. package/dist/Random/LibJsProbabilityResult/index.js +1 -5
  68. package/dist/Random/LibJsRandom/index.d.ts +1 -4
  69. package/dist/Random/LibJsRandom/index.js +1 -4
  70. package/dist/Random/LibJsRandomColor/index.d.ts +1 -4
  71. package/dist/Random/LibJsRandomColor/index.js +1 -4
  72. package/dist/Random/LibJsUniqueRandomNumbers/index.d.ts +1 -4
  73. package/dist/Random/LibJsUniqueRandomNumbers/index.js +1 -4
  74. package/dist/Time/LibJsSameTimeCheck/index.d.ts +1 -5
  75. package/dist/Time/LibJsSameTimeCheck/index.js +1 -5
  76. package/dist/Time/LibJsTimeAgo/index.d.ts +1 -6
  77. package/dist/Time/LibJsTimeAgo/index.js +1 -6
  78. package/dist/Time/LibJsTimeGreeting/index.d.ts +1 -5
  79. package/dist/Time/LibJsTimeGreeting/index.js +1 -5
  80. package/dist/libJs.d.ts +39 -199
  81. package/dist/libJs.js +39 -199
  82. package/package.json +3 -3
@@ -1,10 +1,7 @@
1
1
  /** @description 数组元素整体步数移动
2
2
  * @param arr 移动的数组
3
3
  * @param step 负数为向后移动,正数为向前移动
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * const moved = libJsStepArray([1, 2, 3, 4, 5], 2);
7
- * console.log(moved); //[4, 5, 1, 2, 3]
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsStepArray-数组偏移
8
5
  */
9
6
  export const libJsStepArray = (arr, step) => {
10
7
  const length = arr.length;
@@ -1,9 +1,6 @@
1
1
  /** @description 翻转指定索引后面的数组
2
2
  * @param arr 数组
3
3
  * @param index 开始索引
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
7
- * // [1, 2, 5, 4, 3]
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibReverseArrayFromIndex-数组定位翻转
8
5
  */
9
6
  export declare const libReverseArrayFromIndex: <T>(arr: T[], index: number) => T[];
@@ -1,10 +1,7 @@
1
1
  /** @description 翻转指定索引后面的数组
2
2
  * @param arr 数组
3
3
  * @param index 开始索引
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
7
- * // [1, 2, 5, 4, 3]
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibReverseArrayFromIndex-数组定位翻转
8
5
  */
9
6
  export const libReverseArrayFromIndex = (arr, index) => {
10
7
  if (index < 0 || index >= arr.length) {
@@ -1,8 +1,6 @@
1
1
  /** @description 将链接图片下载到本地
2
2
  * @param link 图片链接
3
3
  * @param name 图片名称
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libJsDownloadImageLink("https://example.com/image.jpg", "图片.jpg");
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsDownloadImageLink-图片下载
7
5
  */
8
6
  export declare const libJsDownloadImageLink: (link: string, name: string) => void;
@@ -1,9 +1,7 @@
1
1
  /** @description 将链接图片下载到本地
2
2
  * @param link 图片链接
3
3
  * @param name 图片名称
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libJsDownloadImageLink("https://example.com/image.jpg", "图片.jpg");
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsDownloadImageLink-图片下载
7
5
  */
8
6
  export const libJsDownloadImageLink = (link, name) => {
9
7
  fetch(link)
@@ -14,19 +14,6 @@ export type LibJsImageOptimizerOptionsParams = {
14
14
  };
15
15
  /** @description 图片压缩,支持png压缩,保留透明背景
16
16
  * @param obj 压缩参数
17
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
18
- * @example
19
- * libJsImageOptimizerOptionsParams({
20
- * file: myFile,
21
- * ratio: 0.8,
22
- * width: 800,
23
- * maxSize: 1024,
24
- * success: (formData, file, url) => {
25
- * console.log('压缩成功', formData, file, url);
26
- * },
27
- * fail: (error) => {
28
- * console.error('压缩失败', error);
29
- * }
30
- * });
17
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsImageOptimizer-图片压缩
31
18
  */
32
19
  export declare const libJsImageOptimizer: (obj: LibJsImageOptimizerOptionsParams) => void;
@@ -1,19 +1,6 @@
1
1
  /** @description 图片压缩,支持png压缩,保留透明背景
2
2
  * @param obj 压缩参数
3
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
4
- * @example
5
- * libJsImageOptimizerOptionsParams({
6
- * file: myFile,
7
- * ratio: 0.8,
8
- * width: 800,
9
- * maxSize: 1024,
10
- * success: (formData, file, url) => {
11
- * console.log('压缩成功', formData, file, url);
12
- * },
13
- * fail: (error) => {
14
- * console.error('压缩失败', error);
15
- * }
16
- * });
3
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsImageOptimizer-图片压缩
17
4
  */
18
5
  export const libJsImageOptimizer = (obj) => {
19
6
  const canvas = document.createElement("canvas");
@@ -2,9 +2,6 @@
2
2
  * @description 保存文件到本地
3
3
  * @param name 文件名
4
4
  * @param data 要保存的数据
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
8
- * libJsSaveJson("example.txt", "Hellow World!");
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsSaveJson-保存文件
9
6
  */
10
7
  export declare const libJsSaveJson: (name: string, data: BlobPart) => void;
@@ -2,10 +2,7 @@
2
2
  * @description 保存文件到本地
3
3
  * @param name 文件名
4
4
  * @param data 要保存的数据
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
8
- * libJsSaveJson("example.txt", "Hellow World!");
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsSaveJson-保存文件
9
6
  */
10
7
  export const libJsSaveJson = (name, data) => {
11
8
  const urlObject = window.URL || window.webkitURL;
@@ -2,9 +2,6 @@
2
2
  * @description 格式化字节大小
3
3
  * @param bytes 字节数
4
4
  * @returns ['大小', '单位', '大小及单位']
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * const [size, unit, formatted] = libJsFormatterByte(2048);
8
- * console.log(size, unit, formatted); //2.00 KB 2.00 KB
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsFormatterByte-字节格式化
9
6
  */
10
7
  export declare const libJsFormatterByte: (bytes: number) => (string | number)[];
@@ -2,10 +2,7 @@
2
2
  * @description 格式化字节大小
3
3
  * @param bytes 字节数
4
4
  * @returns ['大小', '单位', '大小及单位']
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * const [size, unit, formatted] = libJsFormatterByte(2048);
8
- * console.log(size, unit, formatted); //2.00 KB 2.00 KB
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsFormatterByte-字节格式化
9
6
  */
10
7
  export const libJsFormatterByte = (bytes) => {
11
8
  if (bytes <= 0)
@@ -1,9 +1,6 @@
1
1
  /**
2
2
  * @description 隐藏手机号码中间的四位数字
3
3
  * @param mobile 需要处理的手机号码
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * const masked = libJsMaskPhoneNumber("13812345678");
7
- * console.log(masked); //138****5678
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsMaskPhoneNumber-隐藏手机号码
8
5
  */
9
6
  export declare const libJsMaskPhoneNumber: (mobile: number | string) => string;
@@ -1,10 +1,7 @@
1
1
  /**
2
2
  * @description 隐藏手机号码中间的四位数字
3
3
  * @param mobile 需要处理的手机号码
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * const masked = libJsMaskPhoneNumber("13812345678");
7
- * console.log(masked); //138****5678
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsMaskPhoneNumber-隐藏手机号码
8
5
  */
9
6
  export const libJsMaskPhoneNumber = (mobile) => {
10
7
  const m = mobile.toString();
@@ -2,9 +2,6 @@
2
2
  * @description 数字每三位添加逗号
3
3
  * @param num 需要格式化的数字
4
4
  * @param reserve 保留小数位数
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * const formatted = libJsNumComma(1234567.89);
8
- * console.log(formatted); //1,234,567.89
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsNumComma-数字逗号
9
6
  */
10
7
  export declare const libJsNumComma: (num: number, reserve?: number) => string;
@@ -2,10 +2,7 @@
2
2
  * @description 数字每三位添加逗号
3
3
  * @param num 需要格式化的数字
4
4
  * @param reserve 保留小数位数
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * const formatted = libJsNumComma(1234567.89);
8
- * console.log(formatted); //1,234,567.89
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsNumComma-数字逗号
9
6
  */
10
7
  export const libJsNumComma = (num, reserve = 2) => {
11
8
  const str = num.toFixed(reserve).toString();
@@ -5,9 +5,6 @@ export interface LibJsNumberUnitParams {
5
5
  * @param num 数字
6
6
  * @param units 单位组,key为单位,value为格式化阈值
7
7
  * @returns [数字, 单位]
8
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
9
- * @example
10
- * const [value, unit] = libJsNumberUnit(1500, { K: 1000, M: 1000000 });
11
- * console.log(value, unit); //1.50 K
8
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsNumberUnit-数字单位
12
9
  */
13
10
  export declare const libJsNumberUnit: (num: number, units: LibJsNumberUnitParams) => string[];
@@ -3,10 +3,7 @@ import Decimal from "decimal.js";
3
3
  * @param num 数字
4
4
  * @param units 单位组,key为单位,value为格式化阈值
5
5
  * @returns [数字, 单位]
6
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
7
- * @example
8
- * const [value, unit] = libJsNumberUnit(1500, { K: 1000, M: 1000000 });
9
- * console.log(value, unit); //1.50 K
6
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsNumberUnit-数字单位
10
7
  */
11
8
  export const libJsNumberUnit = (num, units) => {
12
9
  const decimalValue = new Decimal(num);
@@ -2,11 +2,6 @@
2
2
  * @description 将秒数格式化为中文时间描述,支持扩展到年
3
3
  * @param seconds 秒数
4
4
  * @returns 格式化后的中文时间
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * libJsSecondsFormatterChinese(100000); //"1天3小时46分40秒"
8
- * libJsSecondsFormatterChinese(31536000); //"1年"
9
- * libJsSecondsFormatterChinese(3600); //"1小时"
10
- * libJsSecondsFormatterChinese(90); //"1分30秒"
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsSecondsFormatterChinese-中文时间
11
6
  */
12
7
  export declare const libJsSecondsFormatterChinese: (seconds: number) => string;
@@ -5,12 +5,7 @@ dayjs.extend(duration);
5
5
  * @description 将秒数格式化为中文时间描述,支持扩展到年
6
6
  * @param seconds 秒数
7
7
  * @returns 格式化后的中文时间
8
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
9
- * @example
10
- * libJsSecondsFormatterChinese(100000); //"1天3小时46分40秒"
11
- * libJsSecondsFormatterChinese(31536000); //"1年"
12
- * libJsSecondsFormatterChinese(3600); //"1小时"
13
- * libJsSecondsFormatterChinese(90); //"1分30秒"
8
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsSecondsFormatterChinese-中文时间
14
9
  */
15
10
  export const libJsSecondsFormatterChinese = (seconds) => {
16
11
  const duration = dayjs.duration(seconds, "seconds");
@@ -2,9 +2,6 @@
2
2
  * @param expression 表达式字符串
3
3
  * @param point 小数点精度
4
4
  * @returns 计算结果
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * const result = libJsCalculateExpression("(1+2)-(3*4)/5");
8
- * console.log(result); //0.6
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsCalculateExpression-表达式字符串
9
6
  */
10
7
  export declare const libJsCalculateExpression: (expression: string, point?: number) => number;
@@ -1,16 +1,13 @@
1
- import Decimal from 'decimal.js';
1
+ import Decimal from "decimal.js";
2
2
  /** @description 计算表达式字符串
3
3
  * @param expression 表达式字符串
4
4
  * @param point 小数点精度
5
5
  * @returns 计算结果
6
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
7
- * @example
8
- * const result = libJsCalculateExpression("(1+2)-(3*4)/5");
9
- * console.log(result); //0.6
6
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsCalculateExpression-表达式字符串
10
7
  */
11
8
  export const libJsCalculateExpression = (expression, point = 2) => {
12
9
  //清除所有空格
13
- expression = expression.replace(/\s+/g, '');
10
+ expression = expression.replace(/\s+/g, "");
14
11
  //支持的运算符和优先级
15
12
  const operators = {
16
13
  "+": 1,
@@ -21,7 +18,7 @@ export const libJsCalculateExpression = (expression, point = 2) => {
21
18
  //支持的小数点精度
22
19
  const toDecimal = (value) => new Decimal(value);
23
20
  //判断字符是否是运算符
24
- const isOperator = (char) => ['+', '-', '*', '/'].includes(char);
21
+ const isOperator = (char) => ["+", "-", "*", "/"].includes(char);
25
22
  //判断字符是否是数字(包括小数点)
26
23
  const isNumber = (char) => /[0-9.]/.test(char);
27
24
  //解析表达式并计算
@@ -32,7 +29,7 @@ export const libJsCalculateExpression = (expression, point = 2) => {
32
29
  while (i < expression.length) {
33
30
  const char = expression[i];
34
31
  if (isNumber(char)) {
35
- let numStr = '';
32
+ let numStr = "";
36
33
  //处理多位数字(支持小数)
37
34
  while (i < expression.length && isNumber(expression[i])) {
38
35
  numStr += expression[i];
@@ -40,13 +37,14 @@ export const libJsCalculateExpression = (expression, point = 2) => {
40
37
  }
41
38
  outputQueue.push(toDecimal(numStr));
42
39
  }
43
- else if (char === '(') {
40
+ else if (char === "(") {
44
41
  operatorStack.push(char);
45
42
  i++;
46
43
  }
47
- else if (char === ')') {
44
+ else if (char === ")") {
48
45
  //处理右括号,直到遇到左括号
49
- while (operatorStack.length > 0 && operatorStack[operatorStack.length - 1] !== '(') {
46
+ while (operatorStack.length > 0 &&
47
+ operatorStack[operatorStack.length - 1] !== "(") {
50
48
  outputQueue.push(operatorStack.pop());
51
49
  }
52
50
  operatorStack.pop(); //弹出左括号
@@ -54,7 +52,8 @@ export const libJsCalculateExpression = (expression, point = 2) => {
54
52
  }
55
53
  else if (isOperator(char)) {
56
54
  //运算符
57
- while (operatorStack.length > 0 && operators[operatorStack[operatorStack.length - 1]] >= operators[char]) {
55
+ while (operatorStack.length > 0 &&
56
+ operators[operatorStack[operatorStack.length - 1]] >= operators[char]) {
58
57
  outputQueue.push(operatorStack.pop());
59
58
  }
60
59
  operatorStack.push(char);
@@ -71,20 +70,20 @@ export const libJsCalculateExpression = (expression, point = 2) => {
71
70
  //执行运算
72
71
  const calcStack = [];
73
72
  for (let token of outputQueue) {
74
- if (typeof token === 'string') {
73
+ if (typeof token === "string") {
75
74
  const b = calcStack.pop();
76
75
  const a = calcStack.pop();
77
76
  switch (token) {
78
- case '+':
77
+ case "+":
79
78
  calcStack.push(a.add(b));
80
79
  break;
81
- case '-':
80
+ case "-":
82
81
  calcStack.push(a.sub(b));
83
82
  break;
84
- case '*':
83
+ case "*":
85
84
  calcStack.push(a.mul(b));
86
85
  break;
87
- case '/':
86
+ case "/":
88
87
  if (b.eq(0))
89
88
  throw new Error("除数不能为零");
90
89
  calcStack.push(a.div(b));
@@ -2,12 +2,6 @@
2
2
  * @description 角度和弧度互相转换
3
3
  * @param value 角度值或弧度值
4
4
  * @param type 角度类型或弧度类型
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * //角度转弧度
8
- * libJsConvertAngle(90, "rad"); //返回 1.5708... (π/2)
9
- *
10
- * //弧度转角度
11
- * libJsConvertAngle(Math.PI, "deg"); //返回 180
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsConvertAngle-角弧度互转
12
6
  */
13
7
  export declare const libJsConvertAngle: (value: number, type: "rad" | "deg") => number;
@@ -2,13 +2,7 @@
2
2
  * @description 角度和弧度互相转换
3
3
  * @param value 角度值或弧度值
4
4
  * @param type 角度类型或弧度类型
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * //角度转弧度
8
- * libJsConvertAngle(90, "rad"); //返回 1.5708... (π/2)
9
- *
10
- * //弧度转角度
11
- * libJsConvertAngle(Math.PI, "deg"); //返回 180
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsConvertAngle-角弧度互转
12
6
  */
13
7
  export const libJsConvertAngle = (value, type) => {
14
8
  if (type === "rad") {
@@ -1,11 +1,7 @@
1
1
  /** @description 计算两点角度
2
2
  * @param coord1 起点坐标
3
3
  * @param coord2 终点坐标
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libJsCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 0 }); //0
7
- * libJsCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 1 }); //45
8
- * libJsCoordsAngle({ x: 0, y: 0 }, { x: 0, y: 1 }); //90
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsCoordsAngle-两点角度
9
5
  */
10
6
  export declare const libJsCoordsAngle: (coord1: {
11
7
  x: number;
@@ -1,11 +1,7 @@
1
1
  /** @description 计算两点角度
2
2
  * @param coord1 起点坐标
3
3
  * @param coord2 终点坐标
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libJsCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 0 }); //0
7
- * libJsCoordsAngle({ x: 0, y: 0 }, { x: 1, y: 1 }); //45
8
- * libJsCoordsAngle({ x: 0, y: 0 }, { x: 0, y: 1 }); //90
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsCoordsAngle-两点角度
9
5
  */
10
6
  export const libJsCoordsAngle = (coord1, coord2) => {
11
7
  //计算相对于第一个坐标的水平和垂直距离
@@ -1,11 +1,7 @@
1
1
  /** @description 计算两点距离
2
2
  * @param coord1 起点坐标
3
3
  * @param coord2 终点坐标
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libJsCoordsDistance({ x: 0, y: 0 }, { x: 3, y: 4 }); //5
7
- * libJsCoordsDistance({ x: 1, y: 1 }, { x: 4, y: 5 }); //5
8
- * libJsCoordsDistance({ x: 0, y: 0 }, { x: 0, y: 0 }); //0
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsCoordsDistance-两点距离
9
5
  */
10
6
  export declare const libJsCoordsDistance: (coord1: {
11
7
  x: number;
@@ -1,11 +1,7 @@
1
1
  /** @description 计算两点距离
2
2
  * @param coord1 起点坐标
3
3
  * @param coord2 终点坐标
4
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
5
- * @example
6
- * libJsCoordsDistance({ x: 0, y: 0 }, { x: 3, y: 4 }); //5
7
- * libJsCoordsDistance({ x: 1, y: 1 }, { x: 4, y: 5 }); //5
8
- * libJsCoordsDistance({ x: 0, y: 0 }, { x: 0, y: 0 }); //0
4
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsCoordsDistance-两点距离
9
5
  */
10
6
  export const libJsCoordsDistance = (coord1, coord2) => {
11
7
  //计算两个坐标之间的水平和垂直距离
@@ -2,10 +2,6 @@
2
2
  * @param num1 第一个数
3
3
  * @param num2 第二个数
4
4
  * @param operator 运算符,支持加减乘除
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * libJsDecimal(10, 3, "+"); //13
8
- * libJsDecimal(10, 3, "-"); //7
9
- * libJsDecimal(10, 3, "/", 2); //3.33
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsDecimal-高精度计算
10
6
  */
11
7
  export declare const libJsDecimal: (num1: number, num2: number, operator: "+" | "-" | "*" | "/", point?: number) => number;
@@ -3,11 +3,7 @@ import { Decimal } from "decimal.js";
3
3
  * @param num1 第一个数
4
4
  * @param num2 第二个数
5
5
  * @param operator 运算符,支持加减乘除
6
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
7
- * @example
8
- * libJsDecimal(10, 3, "+"); //13
9
- * libJsDecimal(10, 3, "-"); //7
10
- * libJsDecimal(10, 3, "/", 2); //3.33
6
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsDecimal-高精度计算
11
7
  */
12
8
  export const libJsDecimal = (num1, num2, operator, point = 2) => {
13
9
  const calc = {
@@ -8,22 +8,7 @@ export type ValidationResult = {
8
8
  * @param form 表单数据对象
9
9
  * @param rules 验证规则数组
10
10
  * @returns 验证结果数组,包含未通过验证的项
11
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
12
- * @example
13
- * const form = { username: "john", email: "john@example.com" };
14
- * const rules = [
15
- * { key: "username", verify: /^[a-zA-Z0-9]{3,}$/, msg: "用户名不合法", name: "用户名" },
16
- * { key: "email", verify: /^\S+@\S+\.\S+$/, msg: "邮箱格式不正确", name: "邮箱" },
17
- * ];
18
- * libJsRegFormValidate(form, rules);
19
- * //返回结果: []
20
- *
21
- * const invalidForm = { username: "jo", email: "invalid-email" };
22
- * libJsRegFormValidate(invalidForm, rules);
23
- * //返回结果: [
24
- * // { key: "username", msg: "用户名不合法", name: "用户名" },
25
- * // { key: "email", msg: "邮箱格式不正确", name: "邮箱" }
26
- * //]
11
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsRegFormValidate-表单验证
27
12
  */
28
13
  export declare const libJsRegFormValidate: (form: Record<string, any>, rules: Array<{
29
14
  key: string;
@@ -3,22 +3,7 @@
3
3
  * @param form 表单数据对象
4
4
  * @param rules 验证规则数组
5
5
  * @returns 验证结果数组,包含未通过验证的项
6
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
7
- * @example
8
- * const form = { username: "john", email: "john@example.com" };
9
- * const rules = [
10
- * { key: "username", verify: /^[a-zA-Z0-9]{3,}$/, msg: "用户名不合法", name: "用户名" },
11
- * { key: "email", verify: /^\S+@\S+\.\S+$/, msg: "邮箱格式不正确", name: "邮箱" },
12
- * ];
13
- * libJsRegFormValidate(form, rules);
14
- * //返回结果: []
15
- *
16
- * const invalidForm = { username: "jo", email: "invalid-email" };
17
- * libJsRegFormValidate(invalidForm, rules);
18
- * //返回结果: [
19
- * // { key: "username", msg: "用户名不合法", name: "用户名" },
20
- * // { key: "email", msg: "邮箱格式不正确", name: "邮箱" }
21
- * //]
6
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsRegFormValidate-表单验证
22
7
  */
23
8
  export const libJsRegFormValidate = (form, rules) => {
24
9
  return rules.reduce((result, rule) => {
@@ -3,18 +3,7 @@
3
3
  * @param maxRetries 最大重试次数
4
4
  * @param retryDelay 重试间隔时间
5
5
  * @param params 请求参数
6
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
7
- * @example
8
- * const requestFn = (params: { url: string }) => fetch(params.url).then(res => res.json());
9
- * const params = { url: "https://api.example.com/data" };
10
- * libJsRetryRequest({
11
- * promiseFn: requestFn,
12
- * params,
13
- * maxRetries: 5,
14
- * retryDelay: 1000
15
- * })
16
- * .then(data => console.log(data))
17
- * .catch(err => console.error(err));
6
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsRetryRequest-请求重连
18
7
  */
19
8
  export declare const libJsRetryRequest: <T>({ promiseFn, maxRetries, retryDelay, params, }: {
20
9
  promiseFn: (params?: any) => Promise<T>;
@@ -3,18 +3,7 @@
3
3
  * @param maxRetries 最大重试次数
4
4
  * @param retryDelay 重试间隔时间
5
5
  * @param params 请求参数
6
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
7
- * @example
8
- * const requestFn = (params: { url: string }) => fetch(params.url).then(res => res.json());
9
- * const params = { url: "https://api.example.com/data" };
10
- * libJsRetryRequest({
11
- * promiseFn: requestFn,
12
- * params,
13
- * maxRetries: 5,
14
- * retryDelay: 1000
15
- * })
16
- * .then(data => console.log(data))
17
- * .catch(err => console.error(err));
6
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsRetryRequest-请求重连
18
7
  */
19
8
  export const libJsRetryRequest = ({ promiseFn, maxRetries = 3, retryDelay = 2000, params = undefined, }) => {
20
9
  return new Promise((resolve, reject) => {
@@ -1,10 +1,5 @@
1
1
  /** @description 数字步进器
2
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
3
- * @example
4
- * const stepper = new libNumerStepper(10, (index) => console.log(index));
5
- * stepper.down("add"); // 索引加1
6
- * stepper.updateIndex(5); // 更新索引为5
7
- * stepper.down("sub"); // 索引减1
2
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibNumerStepper-数字步进器
8
3
  */
9
4
  export declare class libNumerStepper {
10
5
  /** 数字变动时触发 */
@@ -1,10 +1,5 @@
1
1
  /** @description 数字步进器
2
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
3
- * @example
4
- * const stepper = new libNumerStepper(10, (index) => console.log(index));
5
- * stepper.down("add"); // 索引加1
6
- * stepper.updateIndex(5); // 更新索引为5
7
- * stepper.down("sub"); // 索引减1
2
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibNumerStepper-数字步进器
8
3
  */
9
4
  export class libNumerStepper {
10
5
  /** 数字变动时触发 */
@@ -1,9 +1,5 @@
1
1
  /** @description 百分比概率结果
2
2
  * @param probability 触发概率,百分比,0-100
3
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
4
- * @example
5
- * libJsProbabilityResult(50); //50% 概率为 true
6
- * libJsProbabilityResult(80); //80% 概率为 true
7
- * libJsProbabilityResult(100); //100% 概率为 true
3
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsProbabilityResult-概率触发
8
4
  */
9
5
  export declare const libJsProbabilityResult: (probability: number) => boolean;
@@ -1,9 +1,5 @@
1
1
  /** @description 百分比概率结果
2
2
  * @param probability 触发概率,百分比,0-100
3
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
4
- * @example
5
- * libJsProbabilityResult(50); //50% 概率为 true
6
- * libJsProbabilityResult(80); //80% 概率为 true
7
- * libJsProbabilityResult(100); //100% 概率为 true
3
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsProbabilityResult-概率触发
8
4
  */
9
5
  export const libJsProbabilityResult = (probability) => Math.random() * 100 < probability;
@@ -2,9 +2,6 @@
2
2
  * @param min 最小值
3
3
  * @param max 最大值
4
4
  * @param num 保留小数位数
5
- * @link 了解更多:https://www.npmjs.com/package/lyb-js
6
- * @example
7
- * libJsRandom(1, 10); //1 到 10 之间的随机整数
8
- * libJsRandom(1, 10, 2); //1 到 10 之间保留两位小数的随机数
5
+ * @link 使用方法:https://www.npmjs.com/package/lyb-js#LibJsRandom-随机数
9
6
  */
10
7
  export declare const libJsRandom: (min: number, max: number, num?: number) => number;