ut2 1.5.6 → 1.7.0

package/types/reduce.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 对每个元素调用 `iteratee` 函数，每一次运行 `iteratee` 会将元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。
+ *
+ * 如果没有提供第三个参数值，则集合中的第一个元素将用作初始值。
+ *
+ * `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 {*} [initialValue] 初始值。
+ * @returns {*} 累计值。
+ * @example
+ *
+ * reduce([1,2,3], function(accumulator, current, index){
+ *   return accumulator + current;
+ * }, 0);
+ * // 6
+ *
+ * reduce({a: 1, b: 2, c: 3}, function(accumulator, current, key){
+ *   return accumulator + current;
+ * }, 0);
+ * // 6
+ *
+ */
+declare const reduce: {
+    <T, R>(collection: import("./internals/types").WithNullable<T[]>, iteratee: import("./internals/types").ReduceArrayIterator<T, R>, initialValue: R): R;
+    <R_1>(collection: import("./internals/types").WithNullable<string>, iteratee: import("./internals/types").ReduceStringIterator<R_1>, initialValue: R_1): R_1;
+    <T_1, R_2>(collection: import("./internals/types").WithNullable<ArrayLike<T_1>>, iteratee: import("./internals/types").ReduceArrayLikeIterator<T_1, R_2>, initialValue: R_2): R_2;
+    <T_2 extends object, R_3>(collection: import("./internals/types").WithNullable<T_2>, iteratee: import("./internals/types").ReduceObjectIterator<T_2, R_3>, initialValue: R_3): R_3;
+    <T_3>(collection: import("./internals/types").WithNullable<T_3[]>, iteratee?: import("./internals/types").ReduceArrayIterator<T_3, T_3> | undefined): T_3 | undefined;
+    (collection: import("./internals/types").WithNullable<string>, iteratee?: import("./internals/types").ReduceStringIterator<string> | undefined): string | undefined;
+    <T_4>(collection: import("./internals/types").WithNullable<ArrayLike<T_4>>, iteratee?: import("./internals/types").ReduceArrayLikeIterator<T_4, T_4> | undefined): T_4 | undefined;
+    <T_5 extends object>(collection: import("./internals/types").WithNullable<T_5>, iteratee?: import("./internals/types").ReduceObjectIterator<T_5, T_5[keyof T_5]> | undefined): T_5[keyof T_5] | undefined;
+};
+export default reduce;

package/types/reduceRight.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 对每个元素（从右往左的顺序）调用 `iteratee` 函数，每一次运行 `iteratee` 会将元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。
+ *
+ * 如果没有提供第三个参数值，则集合中的第一个元素将用作初始值。
+ *
+ * `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 {*} [initialValue] 初始值。
+ * @returns {*} 累计值。
+ * @example
+ *
+ * reduceRight([1,2,3], function(accumulator, current, index){
+ *   return accumulator + current;
+ * }, 0);
+ * // 6
+ *
+ * reduceRight({a: 1, b: 2, c: 3}, function(accumulator, current, key){
+ *   return accumulator + current;
+ * }, 0);
+ * // 6
+ *
+ */
+declare const reduceRight: {
+    <T, R>(collection: import("./internals/types").WithNullable<T[]>, iteratee: import("./internals/types").ReduceArrayIterator<T, R>, initialValue: R): R;
+    <R_1>(collection: import("./internals/types").WithNullable<string>, iteratee: import("./internals/types").ReduceStringIterator<R_1>, initialValue: R_1): R_1;
+    <T_1, R_2>(collection: import("./internals/types").WithNullable<ArrayLike<T_1>>, iteratee: import("./internals/types").ReduceArrayLikeIterator<T_1, R_2>, initialValue: R_2): R_2;
+    <T_2 extends object, R_3>(collection: import("./internals/types").WithNullable<T_2>, iteratee: import("./internals/types").ReduceObjectIterator<T_2, R_3>, initialValue: R_3): R_3;
+    <T_3>(collection: import("./internals/types").WithNullable<T_3[]>, iteratee?: import("./internals/types").ReduceArrayIterator<T_3, T_3> | undefined): T_3 | undefined;
+    (collection: import("./internals/types").WithNullable<string>, iteratee?: import("./internals/types").ReduceStringIterator<string> | undefined): string | undefined;
+    <T_4>(collection: import("./internals/types").WithNullable<ArrayLike<T_4>>, iteratee?: import("./internals/types").ReduceArrayLikeIterator<T_4, T_4> | undefined): T_4 | undefined;
+    <T_5 extends object>(collection: import("./internals/types").WithNullable<T_5>, iteratee?: import("./internals/types").ReduceObjectIterator<T_5, T_5[keyof T_5]> | undefined): T_5[keyof T_5] | undefined;
+};
+export default reduceRight;

package/types/some.d.ts

@@ -0,0 +1,6 @@
+import { ArrayIterator, ArrayLikeIterator, ObjectIterator, StringIterator, WithNullable } from './internals/types';
+declare function some<T>(collection: WithNullable<T[]>, predicate?: ArrayIterator<T, any>): boolean;
+declare function some(collection: WithNullable<string>, predicate?: StringIterator<any>): boolean;
+declare function some<T>(collection: WithNullable<ArrayLike<T>>, predicate?: ArrayLikeIterator<T, any>): boolean;
+declare function some<T extends object>(collection: WithNullable<T>, predicate?: ObjectIterator<T, any>): boolean;
+export default some;

package/types/union.d.ts

@@ -1,3 +1,4 @@
+import { IterateeParam } from './internals/types';
 /**
  * 创建一个按顺序排列的唯一值的数组（并集）。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。与 [`uniq`](#.uniq) 相似。
  *
@@ -29,5 +30,5 @@
  * union([-0, 0], [-0], undefined, true); // [-0, 0]
  *
  */
-declare function union<T, F extends (value: T) => any, K extends keyof T>(array: T[], other?: T[], iteratee?: F | K, strickCheck?: boolean): T[];
+declare function union<T>(array: T[], other?: T[], iteratee?: IterateeParam<T>, strickCheck?: boolean): T[];
 export default union;

package/types/uniq.d.ts

@@ -1,3 +1,4 @@
+import { IterateeParam } from './internals/types';
 /**
  * 创建一个去重后的数组副本。只有第一次出现的元素才会被保留。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
@@ -28,5 +29,5 @@
  * uniq([-0, 0], undefined, true); // [-0, 0]
  *
  */
-declare function uniq<T, F extends (value: T) => any, K extends keyof T>(array: T[], iteratee?: F | K, strickCheck?: boolean): T[];
+declare function uniq<T>(array: T[], iteratee?: IterateeParam<T>, strickCheck?: boolean): T[];
 export default uniq;

package/types/xor.d.ts

@@ -1,3 +1,4 @@
+import { IterateeParam } from './internals/types';
 /**
  * 创建一个唯一值的数组（并集-交集），该数组包含 2 个数组参数中不相同的元素。如果传入迭代函数，会调用数组的每个元素以产生唯一性计算的标准。
  *
@@ -10,7 +11,7 @@
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
- * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
+ * @param {Function | string} [iteratee={@link https://caijf.github.io/ut2/module-Util.html#.identity | identity}] 迭代函数，调用每个元素。
  * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
  * @returns {Array} 过滤值后的新数组。
  * @example
@@ -29,5 +30,5 @@
  * xor([-0, 0],[0], undefined, true); // [-0]
  *
  */
-declare function xor<T, F extends (value: T) => any, K extends keyof T>(array: T[], other?: T[], iteratee?: F | K, strickCheck?: boolean): T[];
+declare function xor<T>(array: T[], other?: T[], iteratee?: IterateeParam<T>, strickCheck?: boolean): T[];
 export default xor;