ut2 1.13.0 → 1.15.0

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 (138) hide show
  1. package/README.md +3 -2
  2. package/dist/ut2.js +142 -34
  3. package/dist/ut2.js.map +1 -1
  4. package/dist/ut2.min.js +1 -1
  5. package/dist/ut2.min.js.map +1 -1
  6. package/es/findKey.js +1 -1
  7. package/es/guard.js +19 -0
  8. package/es/index.js +4 -1
  9. package/es/internals/helpers.js +1 -1
  10. package/es/mergeObject.js +17 -0
  11. package/es/retry.js +43 -0
  12. package/es/tryit.js +1 -1
  13. package/lib/findKey.js +3 -3
  14. package/lib/guard.js +21 -0
  15. package/lib/index.js +8 -2
  16. package/lib/internals/helpers.js +1 -1
  17. package/lib/mergeObject.js +19 -0
  18. package/lib/retry.js +45 -0
  19. package/lib/tryit.js +2 -2
  20. package/package.json +4 -2
  21. package/types/after.d.ts +0 -1
  22. package/types/allKeys.d.ts +0 -1
  23. package/types/allKeysIn.d.ts +0 -1
  24. package/types/before.d.ts +0 -1
  25. package/types/camelCase.d.ts +1 -2
  26. package/types/capitalize.d.ts +0 -1
  27. package/types/castArray.d.ts +0 -1
  28. package/types/ceil.d.ts +1 -2
  29. package/types/chunk.d.ts +0 -1
  30. package/types/compact.d.ts +1 -2
  31. package/types/constant.d.ts +0 -1
  32. package/types/debounce.d.ts +0 -1
  33. package/types/delay.d.ts +0 -1
  34. package/types/difference.d.ts +0 -1
  35. package/types/eq.d.ts +1 -2
  36. package/types/escape.d.ts +1 -2
  37. package/types/escapeRegExp.d.ts +1 -2
  38. package/types/filter.d.ts +0 -1
  39. package/types/floor.d.ts +1 -2
  40. package/types/fromPairs.d.ts +2 -1
  41. package/types/groupBy.d.ts +0 -1
  42. package/types/guard.d.ts +22 -0
  43. package/types/identity.d.ts +0 -1
  44. package/types/inRange.d.ts +0 -1
  45. package/types/index.d.ts +4 -1
  46. package/types/internals/helpers.d.ts +2 -6
  47. package/types/internals/native.d.ts +6 -12
  48. package/types/internals/root.d.ts +2 -3
  49. package/types/internals/types.d.ts +4 -0
  50. package/types/intersection.d.ts +0 -1
  51. package/types/invert.d.ts +1 -2
  52. package/types/isArguments.d.ts +0 -1
  53. package/types/isArray.d.ts +0 -1
  54. package/types/isArrayBuffer.d.ts +0 -1
  55. package/types/isArrayLike.d.ts +0 -1
  56. package/types/isArrayLikeObject.d.ts +0 -1
  57. package/types/isBigInt.d.ts +0 -1
  58. package/types/isBlob.d.ts +2 -3
  59. package/types/isBoolean.d.ts +0 -1
  60. package/types/isBuffer.d.ts +0 -1
  61. package/types/isDataView.d.ts +0 -1
  62. package/types/isDate.d.ts +0 -1
  63. package/types/isElement.d.ts +0 -1
  64. package/types/isEmpty.d.ts +0 -1
  65. package/types/isEqual.d.ts +0 -1
  66. package/types/isError.d.ts +0 -1
  67. package/types/isFile.d.ts +1 -2
  68. package/types/isFinite.d.ts +0 -1
  69. package/types/isFunction.d.ts +0 -1
  70. package/types/isInteger.d.ts +0 -1
  71. package/types/isLength.d.ts +1 -2
  72. package/types/isMap.d.ts +0 -1
  73. package/types/isMatch.d.ts +0 -1
  74. package/types/isNaN.d.ts +0 -1
  75. package/types/isNil.d.ts +0 -1
  76. package/types/isNull.d.ts +0 -1
  77. package/types/isNumber.d.ts +0 -1
  78. package/types/isObject.d.ts +1 -2
  79. package/types/isObjectLike.d.ts +0 -1
  80. package/types/isPlainObject.d.ts +0 -1
  81. package/types/isPromiseLike.d.ts +0 -1
  82. package/types/isRegExp.d.ts +0 -1
  83. package/types/isSafeInteger.d.ts +0 -1
  84. package/types/isSet.d.ts +0 -1
  85. package/types/isString.d.ts +0 -1
  86. package/types/isSymbol.d.ts +0 -1
  87. package/types/isTypedArray.d.ts +1 -2
  88. package/types/isUndefined.d.ts +0 -1
  89. package/types/isWeakMap.d.ts +0 -1
  90. package/types/isWeakSet.d.ts +0 -1
  91. package/types/isWindow.d.ts +0 -1
  92. package/types/kebabCase.d.ts +1 -2
  93. package/types/keys.d.ts +0 -1
  94. package/types/keysIn.d.ts +0 -1
  95. package/types/lowerCase.d.ts +0 -1
  96. package/types/map.d.ts +0 -1
  97. package/types/merge.d.ts +0 -1
  98. package/types/mergeObject.d.ts +41 -0
  99. package/types/min.d.ts +0 -1
  100. package/types/move.d.ts +1 -2
  101. package/types/negate.d.ts +0 -1
  102. package/types/noop.d.ts +0 -1
  103. package/types/nth.d.ts +0 -1
  104. package/types/nthArg.d.ts +0 -1
  105. package/types/omit.d.ts +0 -1
  106. package/types/omitBy.d.ts +1 -2
  107. package/types/once.d.ts +0 -1
  108. package/types/orderBy.d.ts +1 -1
  109. package/types/partition.d.ts +2 -3
  110. package/types/pascalCase.d.ts +1 -2
  111. package/types/pick.d.ts +0 -1
  112. package/types/pickBy.d.ts +1 -2
  113. package/types/random.d.ts +0 -1
  114. package/types/randomInt.d.ts +0 -1
  115. package/types/retry.d.ts +31 -0
  116. package/types/round.d.ts +1 -2
  117. package/types/shuffle.d.ts +0 -1
  118. package/types/sleep.d.ts +0 -1
  119. package/types/snakeCase.d.ts +1 -2
  120. package/types/throttle.d.ts +0 -1
  121. package/types/toFinite.d.ts +0 -1
  122. package/types/toInteger.d.ts +0 -1
  123. package/types/toLength.d.ts +1 -2
  124. package/types/toNumber.d.ts +0 -1
  125. package/types/toSafeInteger.d.ts +0 -1
  126. package/types/toString.d.ts +0 -1
  127. package/types/tryit.d.ts +1 -2
  128. package/types/unescape.d.ts +0 -1
  129. package/types/union.d.ts +0 -1
  130. package/types/uniq.d.ts +0 -1
  131. package/types/uniqueId.d.ts +0 -1
  132. package/types/unzip.d.ts +0 -1
  133. package/types/upperCase.d.ts +0 -1
  134. package/types/words.d.ts +1 -2
  135. package/types/xor.d.ts +0 -1
  136. package/types/zip.d.ts +0 -1
  137. package/es/node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js +0 -62
  138. package/lib/node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.18.0_tslib@2.6.3_typescript@5.5.2/node_modules/tslib/tslib.es6.js +0 -66
@@ -29,27 +29,21 @@ export declare const globalThisExisted: false | typeof globalThis;
29
29
  export declare const globalExisted: false | typeof globalThis;
30
30
  export declare const selfExisted: false | (Window & typeof globalThis);
31
31
  /**
32
- * 最大安全整数。
33
- *
34
- * @static
32
+ * @summary 最大安全整数。
35
33
  * @since 1.0.0
36
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER MAX_SAFE_INTEGER}
34
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER | MAX_SAFE_INTEGER}
37
35
  */
38
36
  export declare const MAX_SAFE_INTEGER: number;
39
37
  /**
40
- * 最小安全整数。
41
- *
42
- * @static
38
+ * @summary 最小安全整数。
43
39
  * @since 1.0.0
44
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MIN_SAFE_INTEGER MIN_SAFE_INTEGER}
40
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MIN_SAFE_INTEGER | MIN_SAFE_INTEGER}
45
41
  */
46
42
  export declare const MIN_SAFE_INTEGER: number;
47
43
  /**
48
- * 最大数组长度 `Math.pow(2,32) - 1`。
49
- *
50
- * @static
44
+ * @summary 最大数组长度 `Math.pow(2,32) - 1`。
51
45
  * @since 1.0.0
52
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/length length}
46
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/length | length}
53
47
  */
54
48
  export declare const MAX_ARRAY_LENGTH = 4294967295;
55
49
  export declare const bigIntTag = "[object BigInt]";
@@ -1,14 +1,13 @@
1
1
  /**
2
- * 全局对象。
2
+ * @summary 全局对象。
3
3
  *
4
4
  * 不同的 JavaScript 环境都可以获取到对应的全局对象:
5
5
  * 1. Web 中等同于 `globalThis` / `window` / `self` / `frames` (兼容旧浏览器)
6
6
  * 2. Node.js 中等同于 `globalThis` / `global` (兼容低版本 Node.js)
7
7
  * 3. Web Workers 中等同于 `self`
8
8
  *
9
- * @static
10
9
  * @since 1.10.0
11
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/globalThis globalThis}
10
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/globalThis | globalThis}
12
11
  */
13
12
  declare const root: typeof globalThis;
14
13
  export default root;
@@ -1,4 +1,8 @@
1
1
  export type FunctionAny = (...args: any[]) => any;
2
+ export type SyncFn<P extends any[], R> = (...args: P) => R;
3
+ export type AsyncFn<P extends any[], R> = (...args: P) => Promise<R>;
4
+ export type SingleSyncFn<R> = () => R;
5
+ export type SingleAsyncFn<R> = () => Promise<R>;
2
6
  /**
3
7
  * 工具辅助类型
4
8
  */
@@ -6,7 +6,6 @@ import { IterateeParam } from './internals/types';
6
6
  *
7
7
  * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
8
8
  *
9
- * @static
10
9
  * @alias module:Array.intersection
11
10
  * @since 1.0.0
12
11
  * @param {Array} array 要检查的数组。
package/types/invert.d.ts CHANGED
@@ -2,10 +2,9 @@ import { ObjectPredicate, PropertyName, WithNullable } from './internals/types';
2
2
  /**
3
3
  * 创建一个对象,该对象由 `object` 自身可枚举属性(包含 `Symbol` 属性)和值反转组成。
4
4
  *
5
- * @static
6
5
  * @alias module:Object.invert
7
6
  * @since 1.8.0
8
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
7
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy | Truthy}
9
8
  * @param {Object} object 来源对象。
10
9
  * @param {Function} [predicate] 调用每一个属性的函数,返回 `Truthy` 表示要反转,否则不反转。
11
10
  * @returns {Object} 新对象。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `arguments` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isArguments
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `Array` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isArray
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `ArrayBuffer` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isArrayBuffer
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 如果一个值不是函数并且其 `value.length` 是大于或等于 `0` 且小于或等于 `Number.MAX_SAFE_INTEGER` 的整数,则该值被视为类数组。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isArrayLike
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
@@ -5,7 +5,6 @@ type ArrayLikeObject = Array<any> | {
5
5
  /**
6
6
  * 检查值是否为类数组对象。
7
7
  *
8
- * @static
9
8
  * @alias module:Language.isArrayLikeObject
10
9
  * @since 1.0.0
11
10
  * @param {*} value 要检查的值
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 bigint 类型或对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isBigInt
6
5
  * @since 1.8.0
7
6
  * @param {*} value 要检查的值。
package/types/isBlob.d.ts CHANGED
@@ -3,11 +3,10 @@
3
3
  *
4
4
  * 浏览器环境的 `Blob` 或 `File` 对象,或其他继承自 `Blob` 的实例,都将返回 `true`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isBlob
8
7
  * @since 1.0.0
9
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/Blob Blob}
10
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File File}
8
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/Blob | Blob}
9
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File | File}
11
10
  * @param {*} value 要检查的值。
12
11
  * @returns {boolean} 如果值为 `Blob` 对象,返回 `true`,否则返回 `false`。
13
12
  * @example
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为布尔类型或对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isBoolean
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 非 Node.js 环境,始终返回 `false`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isBuffer
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `DataView` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isDataView
6
5
  * @since 1.2.0
7
6
  * @param {*} value 要检查的值。
package/types/isDate.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `Date` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isDate
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否可能为 `DOM` 元素。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isElement
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -5,7 +5,6 @@
5
5
  *
6
6
  * 非上述类型值,都将被认为是空的。
7
7
  *
8
- * @static
9
8
  * @alias module:Language.isEmpty
10
9
  * @since 1.0.0
11
10
  * @param {*} value 要检查的值。
@@ -10,7 +10,6 @@ import isEqualDeep from './internals/isEqualDeep';
10
10
  * 2. `typeof` 不同类型,如 `1` `Object(1)`
11
11
  * 3. 无效日期对象,如 `new Date('')` `new Date('abc')`
12
12
  *
13
- * @static
14
13
  * @alias module:Language.isEqual
15
14
  * @since 1.3.0
16
15
  * @param {*} value 要比较的值。
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 继承自 `Error` 的对象,如 `EvalError` `RangeError` `ReferenceError` `SyntaxError` `TypeError` `URIError` `AggregateError`,都将返回 `true`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isError
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
package/types/isFile.d.ts CHANGED
@@ -3,10 +3,9 @@
3
3
  *
4
4
  * 浏览器环境的 `File` 对象,或其他继承自 `File` 的实例,都将返回 `true`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isFile
8
7
  * @since 1.11.0
9
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File File}
8
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File | File}
10
9
  * @param {*} value 要检查的值。
11
10
  * @returns {boolean} 如果值为 `File` 对象,返回 `true`,否则返回 `false`。
12
11
  * @example
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 同 `Number.isFinite`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isFinite
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
@@ -4,7 +4,6 @@ import { FunctionAny } from './internals/types';
4
4
  *
5
5
  * `Function` `AsyncFunction` `GeneratorFunction` `Proxy` 都将返回 `true`。
6
6
  *
7
- * @static
8
7
  * @alias module:Language.isFunction
9
8
  * @since 1.0.0
10
9
  * @param {*} value 要检查的值。
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 同 `Number.isInteger`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isInteger
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * 检查值是否为有效的类数组长度。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isLength
6
5
  * @since 1.0.0
7
- * @see {@link https://tc39.es/ecma262/#sec-tolength ToLength}
6
+ * @see {@link https://tc39.es/ecma262/#sec-tolength | ToLength}
8
7
  * @param {*} value 要检查的值。
9
8
  * @returns {boolean} 如果值为有效的类数组长度,返回 `true`,否则返回 `false`。
10
9
  * @example
package/types/isMap.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `Map` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isMap
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -10,7 +10,6 @@ type Customizer = (objValue: any, srcValue: any, key?: number | string | symbol,
10
10
  * 2. `typeof` 不同类型,如 `1` `Object(1)`
11
11
  * 3. 无效日期对象,如 `new Date('')` `new Date('abc')`
12
12
  *
13
- * @static
14
13
  * @alias module:Language.isMatch
15
14
  * @since 1.4.0
16
15
  * @requires module:Language.isEqual
package/types/isNaN.d.ts CHANGED
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 和 `Number.isNaN` 区别是 `new Number(NaN)` 也被认为是 `NaN`。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isNaN
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
package/types/isNil.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `undefined` 或 `null`。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isNil
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
package/types/isNull.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `null`。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isNull
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * `Infinity` `-Infinity` `NaN` 都归类为数字。如果要排除,请使用 `isFinite` 方法。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isNumber
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
@@ -2,10 +2,9 @@ import { FunctionAny } from './internals/types';
2
2
  /**
3
3
  * 检查值是否为对象。(例如,数组、函数、对象、正则表达式、new Number(0) 和 new String(''))。
4
4
  *
5
- * @static
6
5
  * @alias module:Language.isObject
7
6
  * @since 1.0.0
8
- * @see {@link https://tc39.es/ecma262/#sec-ecmascript-language-types language type}
7
+ * @see {@link https://tc39.es/ecma262/#sec-ecmascript-language-types | language type}
9
8
  * @param {*} value 要检查的值。
10
9
  * @returns {boolean} 如果值为对象,返回 `true`,否则返回 `false`。
11
10
  * @example
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 如果一个值不为 `null` 并且 `typeof` 结果为 `object`,则该值是类对象。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isObjectLike
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为普通对象,即由 `Object` 构造函数创建或 `[[Prototype]]` 为 `null` 的对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isPlainObject
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 如果一个对象包含 `then` 方法,它就是类似 `Promise` 对象。
5
5
  *
6
- * @static
7
6
  * @alias module:Language.isPromiseLike
8
7
  * @since 1.0.0
9
8
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `RegExp` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isRegExp
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值
@@ -5,7 +5,6 @@
5
5
  *
6
6
  * 如果一个整数是一个 `IEEE-754` 双精度数字,它不是四舍五入的不安全整数的结果,那么它就是安全的。安全整数范围为 `-(2^53 - 1)` 到 `2^53 - 1` 之间的整数,包含 `-(2^53 - 1)` 和 `2^53 - 1`。
7
7
  *
8
- * @static
9
8
  * @alias module:Language.isSafeInteger
10
9
  * @since 1.0.0
11
10
  * @param {*} value 要检查的值。
package/types/isSet.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `Set` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isSet
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为字符串类型或对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isString
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `Symbol` 类型或对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isSymbol
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * 检查值是否为类型化数组。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isTypedArray
6
5
  * @since 1.0.0
7
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Typed_arrays Typed_arrays}
6
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Typed_arrays | Typed_arrays}
8
7
  * @param {*} value 要检查的值。
9
8
  * @returns {boolean} 如果值为类型化数组,返回 `true`,否则返回 `false`。
10
9
  * @example
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `undefined`。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isUndefined
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `WeakMap` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isWeakMap
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `WeakSet` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isWeakSet
6
5
  * @since 1.0.0
7
6
  * @param {*} value 要检查的值。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 检查值是否为 `Window` 对象。
3
3
  *
4
- * @static
5
4
  * @alias module:Language.isWindow
6
5
  * @since 1.10.0
7
6
  * @param {*} value 要检查的值。
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * 转换字符串为连接符小写。
3
3
  *
4
- * @static
5
4
  * @alias module:String.kebabCase
6
5
  * @since 1.0.0
7
- * @see {@link https://en.wikipedia.org/wiki/Letter_case#Special_case_styles kebab case}
6
+ * @see {@link https://en.wikipedia.org/wiki/Letter_case#Special_case_styles | kebab case}
8
7
  * @param {string} string 要转换的字符串。
9
8
  * @param {RegExp | string} [pattern] 拆分词组的匹配模式。
10
9
  * @returns {string} 转换后的字符串。
package/types/keys.d.ts CHANGED
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 同 `Object.keys`。
5
5
  *
6
- * @static
7
6
  * @alias module:Object.keys
8
7
  * @since 1.7.0
9
8
  * @param {Object} object 要查询的对象。
package/types/keysIn.d.ts CHANGED
@@ -3,7 +3,6 @@
3
3
  *
4
4
  * 同 `key...in`。
5
5
  *
6
- * @static
7
6
  * @alias module:Object.keysIn
8
7
  * @since 1.1.0
9
8
  * @param {Object} object 要查询的对象。
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 转换字符串为空格分隔的小写单词。
3
3
  *
4
- * @static
5
4
  * @alias module:String.lowerCase
6
5
  * @since 1.0.0
7
6
  * @param {string} string 要转换的字符串。
package/types/map.d.ts CHANGED
@@ -10,7 +10,6 @@ interface Map {
10
10
  *
11
11
  * `iteratee` 调用时会传入三个参数 `value` `index|key` `collection`。
12
12
  *
13
- * @static
14
13
  * @alias module:Collection.map
15
14
  * @since 1.7.0
16
15
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
package/types/merge.d.ts CHANGED
@@ -9,7 +9,6 @@ type Customizer = (objValue: any, srcValue: any, key: string | symbol, object: a
9
9
  *
10
10
  * 如果需要合并继承的属性,第四个参数传入 {@link https://caijf.github.io/ut2/module-Object.html#.allKeysIn allKeysIn} 方法, `merge(object, source, undefined, allKeysIn)`。
11
11
  *
12
- * @static
13
12
  * @alias module:Object.merge
14
13
  * @since 1.0.0
15
14
  * @param {Object | Array} object 目标对象。
@@ -0,0 +1,41 @@
1
+ interface MergeObject {
2
+ <T1, T2>(t1: T1, t2: T2): T1 & T2;
3
+ <T1, T2, T3>(t1: T1, t2: T2, t3: T3): T1 & T2 & T3;
4
+ <T1, T2, T3, T4>(t1: T1, t2: T2, t3: T3, t4: T4): T1 & T2 & T3 & T4;
5
+ <T1, T2, T3, T4, T5>(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5): T1 & T2 & T3 & T4 & T5;
6
+ <T1, T2, T3, T4, T5, T6>(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5, t6: T6): T1 & T2 & T3 & T4 & T5 & T6;
7
+ <T1, T2, T3, T4, T5, T6, T7>(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5, t6: T6, t7: T7): T1 & T2 & T3 & T4 & T5 & T6 & T7;
8
+ <T1, T2, T3, T4, T5, T6, T7, T8>(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5, t6: T6, t7: T7, t8: T8): T1 & T2 & T3 & T4 & T5 & T6 & T7 & T8;
9
+ <T1, T2, T3, T4, T5, T6, T7, T8, T9>(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5, t6: T6, t7: T7, t8: T8, t9: T9): T1 & T2 & T3 & T4 & T5 & T6 & T7 & T8 & T9;
10
+ <T1, T2, T3, T4, T5, T6, T7, T8, T9, T10>(t1: T1, t2: T2, t3: T3, t4: T4, t5: T5, t6: T6, t7: T7, t8: T8, t9: T9, t10: T10): T1 & T2 & T3 & T4 & T5 & T6 & T7 & T8 & T9 & T10;
11
+ <T1, T2, T>(t1: T1, t2: T2, ...args: T[]): T1 & T2 & T;
12
+ }
13
+ /**
14
+ * 递归合并 `source` 来源对象自身的可枚举属性(包含 `Symbol` 属性)到 `object` 目标对象。
15
+ *
16
+ * 与 `merge` 方法的区别:
17
+ *
18
+ * 1. 不合并数组,如果只传入 `2` 个参数,同 `merge(obj, src, merge.NOT_MERGE_ARRAYS)`
19
+ * 2. 不支持自定义赋值函数和获取对象键,但支持多个来源对象参数
20
+ *
21
+ * @alias module:Object.mergeObject
22
+ * @since 1.15.0
23
+ * @param {Object | Array} object 目标对象。
24
+ * @param {...object} args 展开的来源对象。
25
+ * @returns 目标对象。
26
+ * @example
27
+ *
28
+ * mergeObject({c: 3}, {e: 5}); // { c: 3, e: 5 }
29
+ * mergeObject({ a: 1 }, { a: undefined, b: undefined }); // { a: 1, b: undefined }
30
+ * mergeObject({ a: 1 }, { a: undefined, b: undefined }, {c:'x'}); // { a: 1, b: undefined, c: 'x' }
31
+ *
32
+ * const source = {
33
+ * a: [{b: 2}, {d: 4}]
34
+ * }
35
+ * const otherSource = {
36
+ * a: [{c: 3},{e: 5}]
37
+ * }
38
+ * mergeObject({}, source, otherSource); // { a: [{c: 3}, {e: 5}] }
39
+ */
40
+ declare const mergeObject: MergeObject;
41
+ export default mergeObject;
package/types/min.d.ts CHANGED
@@ -4,7 +4,6 @@ import { ExtremumFunction } from './internals/types';
4
4
  *
5
5
  * `iteratee` 调用时会传入三个参数 `value` `index` `array`。
6
6
  *
7
- * @static
8
7
  * @alias module:Math.min
9
8
  * @since 1.0.0
10
9
  * @param {Array} array 要迭代的数组。
package/types/move.d.ts CHANGED
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * 将数组 `from` 位置的元素移至 `to` 位置,返回处理后的原数组。
3
3
  *
4
- * @static
5
4
  * @alias module:Array.move
6
5
  * @since 1.10.0
7
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/splice splice}
6
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | splice}
8
7
  * @param {Array} array 要处理的数组。
9
8
  * @param {number} from 要移动的元素索引。
10
9
  * @param {number} to 要移动目标位置的元素索引。
package/types/negate.d.ts CHANGED
@@ -2,7 +2,6 @@ import { FunctionAny } from './internals/types';
2
2
  /**
3
3
  * 创建一个断言函数结果取反的函数。
4
4
  *
5
- * @static
6
5
  * @alias module:Function.negate
7
6
  * @since 1.0.0
8
7
  * @param {function} predicate 需要对结果取反的函数。
package/types/noop.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 空函数,返回 `undefined`。
3
3
  *
4
- * @static
5
4
  * @alias module:Util.noop
6
5
  * @since 1.0.0
7
6
  * @example
package/types/nth.d.ts CHANGED
@@ -7,7 +7,6 @@ interface Nth {
7
7
  *
8
8
  * 同 `Array.prototype.at` 方法。
9
9
  *
10
- * @static
11
10
  * @alias module:Array.nth
12
11
  * @since 1.0.0
13
12
  * @param {ArrayLike} array 要查询的类数组。
package/types/nthArg.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 创建一个函数,该函数返回第 `n` 个参数。如果 `n` 为负数,则返回从结尾开始的第 `n` 个参数。
3
3
  *
4
- * @static
5
4
  * @alias module:Util.nthArg
6
5
  * @since 1.0.0
7
6
  * @param {number} [n=0] 要返回参数的索引值。默认 `0`。
package/types/omit.d.ts CHANGED
@@ -2,7 +2,6 @@ import { Many, WithNullable } from './internals/types';
2
2
  /**
3
3
  * 创建一个对象,该对象由忽略属性之外的 `object` 自身和继承的可枚举属性组成。与 [`pick`](#.pick) 相反。
4
4
  *
5
- * @static
6
5
  * @alias module:Object.omit
7
6
  * @since 1.0.0
8
7
  * @param {Object} object 来源对象。