ut2 1.9.3 → 1.9.4

package/types/randomInt.d.ts

@@ -1,13 +1,13 @@
 /**
  * 产生一个包含 `lower` 与 `upper` 之间的随机整数。
  *
- * 如果参数非整数 `lower=Math.ceil(lower)` `upper=Math.floor(upper)` 。如果 `lower` 大于 `upper` 会自动交换参数。
+ * 如果参数非整数 `lower=Math.ceil(lower)` `upper=Math.floor(upper)`。如果 `lower` 大于 `upper` 会自动交换参数。
  *
  * @static
  * @alias module:Number.randomInt
  * @since 1.0.0
- * @param {number} [lower=0] 下限，默认 0 。
- * @param {number} [upper=1] 上限，默认 1 。
+ * @param {number} [lower=0] 下限。默认 `0`。
+ * @param {number} [upper=1] 上限。默认 `1`。
  * @returns {number} 随机整数。
  * @example
  *

package/types/range.d.ts

@@ -6,14 +6,14 @@ interface Range {
 /**
  * 创建一个升序或降序的数字数组。
  *
- * 如果省略 `start` 默认为 0 。
+ * 如果省略 `start` 默认为 `0`。
  *
  * @function
  * @alias module:Util.range
  * @since 1.6.0
- * @param {number} [start=0] 开始值。
+ * @param {number} [start=0] 开始值。默认 `0`。
  * @param {number} end 结束值。
- * @param {number} [step] 要增加或减少的值。如果值为 `0` ，将视为无效参数。如果 `start` 在 `end` 之前，默认为 1 ，否则默认为 -1。
+ * @param {number} [step] 要增加或减少的值。如果值为 `0`，将视为无效参数。如果 `start` 在 `end` 之前。默认为 `1`，否则默认为 `-1`。
  * @return {number[]} 从开始值（包含）到结束值（不包含）逐步递增或递减的数字数组。
  * @example
  *

package/types/reduce.d.ts

@@ -3,13 +3,13 @@
  *
  * 如果没有提供第三个参数值，则集合中的第一个元素将用作初始值。
  *
- * `iteratee` 调用时会传入四个参数 `accumulator` `value` `index|key` `collection` 。
+ * `iteratee` 调用时会传入四个参数 `accumulator` `value` `index|key` `collection`。
  *
  * @function
  * @alias module:Collection.reduce
  * @since 1.7.0
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
- * @param {Function} [iteratee=identity] 每次迭代调用的函数。
+ * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @param {*} [initialValue] 初始值。
  * @returns {*} 累计值。
  * @example

package/types/reduceRight.d.ts

@@ -3,13 +3,13 @@
  *
  * 如果没有提供第三个参数值，则集合中的第一个元素将用作初始值。
  *
- * `iteratee` 调用时会传入四个参数 `accumulator` `value` `index|key` `collection` 。
+ * `iteratee` 调用时会传入四个参数 `accumulator` `value` `index|key` `collection`。
  *
  * @function
  * @alias module:Collection.reduceRight
  * @since 1.7.0
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
- * @param {Function} [iteratee=identity] 每次迭代调用的函数。
+ * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @param {*} [initialValue] 初始值。
  * @returns {*} 累计值。
  * @example

package/types/round.d.ts

@@ -1,5 +1,5 @@
 /**
- * 根据精度四舍五入 `number` 。
+ * 根据精度四舍五入 `number`。
  *
  * 注：精度可以理解为保留几位小数。
  *
@@ -8,7 +8,7 @@
  * @since 1.0.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/round#小数舍入 小数舍入}
  * @param {number} number 要四舍五入的值。
- * @param {number} [precision=0] 四舍五入的精度。
+ * @param {number} [precision=0] 四舍五入的精度。默认 `0`。
  * @returns {number} 四舍五入的值。
  * @example
  *

package/types/sleep.d.ts

@@ -4,7 +4,7 @@
  * @static
  * @alias module:Util.sleep
  * @since 1.0.0
- * @param {number} [ms=1000] 等待时间，单位毫秒。
+ * @param {number} [ms=1000] 等待时间，单位毫秒。默认 `1000`。
  * @returns {Promise<void>} 异步对象。
  * @example
  *

package/types/some.d.ts

@@ -6,16 +6,16 @@ interface Some {
     <T extends object>(collection: WithNullable<T>, predicate?: ObjectIterator<T, any>): boolean;
 }
 /**
- * 迭代集合中的元素执行 `predicate` 函数，如果任一元素通过 `predicate` 返回真值，则停止迭代并返回 `true` ，否则返回 `false` 。
+ * 迭代集合中的元素执行 `predicate` 函数，如果任一元素通过 `predicate` 返回真值，则停止迭代并返回 `true`，否则返回 `false`。
  *
- * `predicate` 调用时会传入三个参数 `value` `index|key` `collection` 。
+ * `predicate` 调用时会传入三个参数 `value` `index|key` `collection`。
  *
  * @function
  * @alias module:Collection.some
  * @since 1.7.0
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
- * @param {function} [predicate=identity] 每次迭代调用的函数。
- * @returns {boolean} 如果任一元素通过 `predicate` 测试，则返回 `true` ，否则返回 `false` 。
+ * @param {function} [predicate=identity] 每次迭代调用的函数。默认 `identity`。
+ * @returns {boolean} 如果任一元素通过 `predicate` 测试，则返回 `true`，否则返回 `false`。
  * @example
  *
  * const arr = [1, 2, 3, 4, 5, 6];

package/types/throttle.d.ts

@@ -11,8 +11,8 @@ import { FunctionAny } from './internals/types';
  * @alias module:Function.throttle
  * @since 1.0.0
  * @param {Function} func 要节流的函数。
- * @param {number} [wait=0] 需要节流的毫秒数。
- * @param {boolean} [immediate=true] 是否在节流开始前调用。
+ * @param {number} [wait=0] 需要节流的毫秒数。默认 `0`。
+ * @param {boolean} [immediate=true] 是否在节流开始前调用。默认 `true`。
  * @returns 节流函数。
  * @example
  *

package/types/times.d.ts

@@ -5,13 +5,13 @@ interface Times {
 /**
  * 调用 `iteratee` `n` 次，每次调用返回的结果存入到数组中。
  *
- * `iteratee` 调用传入一个参数 `index` 。
+ * `iteratee` 调用传入一个参数 `index`。
  *
  * @function
  * @alias module:Util.times
  * @since 1.0.0
  * @param {number} n 调用 `iteratee` 的次数。
- * @param {Function} [iteratee=identity] 每次迭代调用的函数。
+ * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {Array} 调用结果的数组。
  * @example
  *

package/types/toInteger.d.ts

@@ -1,7 +1,7 @@
 /**
  * 转换 `value` 为一个整数。
  *
- * 注意: 这个方法基于 [ToIntegerOrInfinity](https://tc39.es/ecma262/#sec-tointegerorinfinity) ，区别在于 `-0` 会返回 `-0` 。
+ * 注意: 这个方法基于 [ToIntegerOrInfinity](https://tc39.es/ecma262/#sec-tointegerorinfinity) ，区别在于 `-0` 会返回 `-0`。
  *
  * @static
  * @alias module:Util.toInteger

package/types/toString.d.ts

@@ -1,5 +1,5 @@
 /**
- * 转换 `value` 为字符串。`null` 和 `undefined` 将返回空字符串。`-0` 将被转换为 `"-0"` 。
+ * 转换 `value` 为字符串。`null` 和 `undefined` 将返回空字符串。`-0` 将被转换为 `"-0"`。
  *
  * @static
  * @alias module:Util.toString

package/types/union.d.ts

@@ -2,7 +2,7 @@ import { IterateeParam } from './internals/types';
 /**
  * 创建一个按顺序排列的唯一值的数组（并集）。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。与 [`uniq`](#.uniq) 相似。
  *
- * `iteratee` 调用时会传入一个参数 `value` 。
+ * `iteratee` 调用时会传入一个参数 `value`。
  *
  * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
  *
@@ -12,7 +12,7 @@ import { IterateeParam } from './internals/types';
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
  * @param {Function | string | number | Symbol} [iteratee] 迭代函数，调用每个元素。
- * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`。默认 `false`。
  * @returns {Array} 新的联合数组。
  * @example
  *

package/types/uniq.d.ts

@@ -2,7 +2,7 @@ import { IterateeParam } from './internals/types';
 /**
  * 创建一个去重后的数组副本。只有第一次出现的元素才会被保留。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
- * `iteratee` 调用时会传入一个参数 `value` 。
+ * `iteratee` 调用时会传入一个参数 `value`。
  *
  * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
  *
@@ -11,7 +11,7 @@ import { IterateeParam } from './internals/types';
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Function | string | number | Symbol} [iteratee] 迭代函数，调用每个元素。
- * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`。默认 `false`。
  * @returns {Array} 去重后的新数组。
  * @example
  *

package/types/uniqueId.d.ts

@@ -1,10 +1,10 @@
 /**
- * 生成唯一ID。如果提供了 `prefix` ，会被添加到ID前缀上。
+ * 生成唯一ID。如果提供了 `prefix`，会被添加到ID前缀上。
  *
  * @static
  * @alias module:Util.uniqueId
  * @since 1.0.0
- * @param {string} [prefix] 要添加到ID前缀的值，默认 `"_" + 2个随机生成的字符`。
+ * @param {string} [prefix] 要添加到ID前缀的值。默认 `"_" + 2个随机生成的字符`。
  * @returns {string} 唯一ID。
  * @example
  *

package/types/words.d.ts

@@ -6,7 +6,7 @@
  * @since 1.0.0
  * @see {@link https://zh.wikipedia.org/wiki/ASCII ASCII}
  * @param {string} string 要拆分的字符串。
- * @param {RegExp | string} [pattern=/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g] 匹配模式。
+ * @param {RegExp | string} [pattern=/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g] 匹配模式。默认 `/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g`。
  * @returns {string[]} 拆分后的数组。
  * @example
  *

package/types/xor.d.ts

@@ -2,7 +2,7 @@ import { IterateeParam } from './internals/types';
 /**
  * 创建一个唯一值的数组（并集-交集），该数组包含两个数组参数中不相同的元素。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
- * `iteratee` 调用时会传入一个参数 `value` 。
+ * `iteratee` 调用时会传入一个参数 `value`。
  *
  * 默认使用了 [`SameValueZero`](https://tc39.es/ecma262/#sec-samevaluezero) 做等值比较。如果 `strictCheck=true` 将使用 [`SameValue`](https://tc39.es/ecma262/#sec-samevalue) 做等值比较。
  *
@@ -11,8 +11,8 @@ import { IterateeParam } from './internals/types';
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
- * @param {Function | string | number | Symbol} [iteratee={@link https://caijf.github.io/ut2/module-Util.html#.identity identity}] 迭代函数，调用每个元素。
- * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
+ * @param {Function | string | number | Symbol} [iteratee=identity] 迭代函数，调用每个元素。默认 `identity`。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`。默认 `false`。
  * @returns {Array} 过滤值后的新数组。
  * @example
  *