zhiaiwan-utils 1.0.3

package/dist/cjs/array/findLastIndex.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = findLastIndex;
+const baseFind_1 = require("../_internal/baseFind");
+/**
+ * 从右往左返回数组中最后一个满足 `predicate` 的下标。
+ *
+ * @param array - 待查找的数组或类数组
+ * @param predicate - 匹配函数，接收 `(value, index, array)`，默认匹配真值
+ * @param fromIndex - 起始下标
+ * @returns 匹配下标，未找到时返回 `-1`
+ *
+ * @example
+ * ```ts
+ * findLastIndex([1, 2, 3, 4], (n) => n % 2 === 1);
+ * // => 2
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function findLastIndex(array, predicate, fromIndex) {
+    return (0, baseFind_1.baseFindIndex)(array, predicate, fromIndex, true);
+}

package/dist/cjs/array/flatten.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = flatten;
+const baseFlatten_1 = __importDefault(require("../_internal/baseFlatten"));
+/**
+ * 将 array 展平一层。
+ *
+ * @param array - 待展平的数组
+ * @returns 展平后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.flatten([1, [2, [3, [4]], 5]]);
+ * // => [1, 2, [3, [4]], 5]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function flatten(array) {
+    var _a;
+    const length = array == null ? 0 : (_a = array.length) !== null && _a !== void 0 ? _a : 0;
+    return length ? (0, baseFlatten_1.default)(array, 1) : [];
+}

package/dist/cjs/array/flattenDeep.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = flattenDeep;
+const baseFlatten_1 = __importDefault(require("../_internal/baseFlatten"));
+const INFINITY = 1 / 0;
+/**
+ * 递归展平 array 的所有嵌套层级。
+ *
+ * @param array - 待展平的数组
+ * @returns 完全展平后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.flattenDeep([1, [2, [3, [4]], 5]]);
+ * // => [1, 2, 3, 4, 5]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function flattenDeep(array) {
+    var _a;
+    const length = array == null ? 0 : (_a = array.length) !== null && _a !== void 0 ? _a : 0;
+    return length ? (0, baseFlatten_1.default)(array, INFINITY) : [];
+}

package/dist/cjs/array/forEach.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = forEach;
+const baseForEach_1 = __importDefault(require("../_internal/baseForEach"));
+/**
+ * 遍历集合元素；iteratee 返回 `false` 时立即停止。
+ *
+ * @param collection - 待遍历的集合（数组、对象、字符串或类数组）
+ * @param iteratee - 每次迭代调用的函数，接收 `(value, index|key, collection)`
+ * @returns 原集合
+ *
+ * @example
+ * ```ts
+ * forEach([1, 2, 3], (n) => {
+ *   if (n === 2) return false;
+ *   console.log(n);
+ * });
+ * // 输出 1
+ *
+ * forEach({ a: 1, b: 2 }, (value, key) => console.log(key, value));
+ * // => { a: 1, b: 2 }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function forEach(collection, iteratee) {
+    return (0, baseForEach_1.default)(collection, iteratee, false);
+}

package/dist/cjs/array/forEachRight.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = forEachRight;
+const baseForEach_1 = __importDefault(require("../_internal/baseForEach"));
+/**
+ * 从右向左遍历集合元素；iteratee 返回 `false` 时立即停止。
+ *
+ * @param collection - 待遍历的集合（数组、对象、字符串或类数组）
+ * @param iteratee - 每次迭代调用的函数，接收 `(value, index|key, collection)`
+ * @returns 原集合
+ *
+ * @example
+ * ```ts
+ * forEachRight([1, 2, 3], (n) => console.log(n));
+ * // 输出 3, 2, 1
+ *
+ * forEachRight({ a: 1, b: 2 }, (value, key) => console.log(key, value));
+ * // 输出 b 2, a 1
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function forEachRight(collection, iteratee) {
+    return (0, baseForEach_1.default)(collection, iteratee, true);
+}

package/dist/cjs/array/groupBy.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = groupBy;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+/**
+ * 根据 iteratee 返回值对 collection 分组，返回键为分组值、值为元素数组的对象。
+ *
+ * @param collection - 待分组的集合
+ * @param iteratee - 分组依据的函数或简写
+ * @returns 分组结果
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.groupBy([6.1, 4.2, 6.3], Math.floor);
+ * // => { '4': [4.2], '6': [6.1, 6.3] }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function groupBy(collection, iteratee = (0, baseIteratee_1.default)()) {
+    var _a;
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    const result = {};
+    const append = (value, indexOrKey, coll) => {
+        const key = resolvedIteratee(value, indexOrKey, coll);
+        const buckets = result;
+        if (!Object.prototype.hasOwnProperty.call(buckets, key)) {
+            buckets[key] = [];
+        }
+        buckets[key].push(value);
+    };
+    if (collection == null) {
+        return result;
+    }
+    if (typeof collection === 'string') {
+        const chars = [...collection];
+        for (let index = 0; index < chars.length; index++) {
+            append(chars[index], index, collection);
+        }
+        return result;
+    }
+    if (Array.isArray(collection)) {
+        for (let index = 0; index < collection.length; index++) {
+            append(collection[index], index, collection);
+        }
+        return result;
+    }
+    if ((0, isArrayLike_1.default)(collection)) {
+        const arrayLike = collection;
+        const length = (_a = arrayLike.length) !== null && _a !== void 0 ? _a : 0;
+        for (let index = 0; index < length; index++) {
+            append(arrayLike[index], index, collection);
+        }
+        return result;
+    }
+    if (typeof collection === 'object') {
+        for (const key of Object.keys(collection)) {
+            append(collection[key], key, collection);
+        }
+    }
+    return result;
+}

package/dist/cjs/array/head.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = head;
+/**
+ * 获取 array 的第一个元素。
+ *
+ * @param array - 待查询的数组
+ * @returns 第一个元素
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.head([1, 2, 3]);
+ * // => 1
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function head(array) {
+    return (array === null || array === void 0 ? void 0 : array.length) ? array[0] : undefined;
+}

package/dist/cjs/array/includes.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = includes;
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+const baseCollectionKeys_1 = require("../_internal/baseCollectionKeys");
+function resolveFromIndex(fromIndex, length) {
+    return fromIndex < 0 ? Math.max(length + fromIndex, 0) : fromIndex;
+}
+function includesInArrayLike(collection, value, fromIndex) {
+    var _a;
+    const length = (_a = collection.length) !== null && _a !== void 0 ? _a : 0;
+    const start = resolveFromIndex(fromIndex, length);
+    for (let index = start; index < length; index++) {
+        if (Object.is(collection[index], value)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 检查 collection 是否包含 value；数组与字符串支持 fromIndex。
+ *
+ * @param collection - 待检查的集合
+ * @param value - 要查找的值
+ * @param fromIndex - 数组或字符串的起始下标
+ * @returns 若包含返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.includes([1, 2, 3], 2);
+ * // => true
+ *
+ * zhiaiwanUtils.includes({ a: 1, b: 2 }, 2);
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function includes(collection, value, fromIndex = 0) {
+    if (collection == null) {
+        return false;
+    }
+    if (typeof collection === 'string') {
+        return includesInArrayLike(collection, value, fromIndex);
+    }
+    if (Array.isArray(collection)) {
+        return includesInArrayLike(collection, value, fromIndex);
+    }
+    if ((0, isArrayLike_1.default)(collection)) {
+        return includesInArrayLike(collection, value, fromIndex);
+    }
+    if (typeof collection === 'object') {
+        return (0, baseCollectionKeys_1.baseValues)(collection).some((item) => Object.is(item, value));
+    }
+    return false;
+}

package/dist/cjs/array/index.js

@@ -0,0 +1,92 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mean = exports.max = exports.min = exports.drop = exports.take = exports.last = exports.head = exports.without = exports.differenceBy = exports.difference = exports.chunk = exports.keyBy = exports.uniq = exports.flattenDeep = exports.flatten = exports.compact = exports.reduceRight = exports.reduce = exports.every = exports.partition = exports.meanBy = exports.sumBy = exports.sum = exports.some = exports.sortBy = exports.minBy = exports.maxBy = exports.intersection = exports.includes = exports.concat = exports.uniqBy = exports.orderBy = exports.groupBy = exports.union = exports.map = exports.filter = exports.findLastIndex = exports.findIndex = exports.findLast = exports.find = exports.each = exports.forEachRight = exports.forEach = void 0;
+var forEach_1 = require("./forEach");
+Object.defineProperty(exports, "forEach", { enumerable: true, get: function () { return __importDefault(forEach_1).default; } });
+var forEachRight_1 = require("./forEachRight");
+Object.defineProperty(exports, "forEachRight", { enumerable: true, get: function () { return __importDefault(forEachRight_1).default; } });
+var each_1 = require("./each");
+Object.defineProperty(exports, "each", { enumerable: true, get: function () { return __importDefault(each_1).default; } });
+var find_1 = require("./find");
+Object.defineProperty(exports, "find", { enumerable: true, get: function () { return __importDefault(find_1).default; } });
+var findLast_1 = require("./findLast");
+Object.defineProperty(exports, "findLast", { enumerable: true, get: function () { return __importDefault(findLast_1).default; } });
+var findIndex_1 = require("./findIndex");
+Object.defineProperty(exports, "findIndex", { enumerable: true, get: function () { return __importDefault(findIndex_1).default; } });
+var findLastIndex_1 = require("./findLastIndex");
+Object.defineProperty(exports, "findLastIndex", { enumerable: true, get: function () { return __importDefault(findLastIndex_1).default; } });
+var filter_1 = require("./filter");
+Object.defineProperty(exports, "filter", { enumerable: true, get: function () { return __importDefault(filter_1).default; } });
+var map_1 = require("./map");
+Object.defineProperty(exports, "map", { enumerable: true, get: function () { return __importDefault(map_1).default; } });
+var union_1 = require("./union");
+Object.defineProperty(exports, "union", { enumerable: true, get: function () { return __importDefault(union_1).default; } });
+var groupBy_1 = require("./groupBy");
+Object.defineProperty(exports, "groupBy", { enumerable: true, get: function () { return __importDefault(groupBy_1).default; } });
+var orderBy_1 = require("./orderBy");
+Object.defineProperty(exports, "orderBy", { enumerable: true, get: function () { return __importDefault(orderBy_1).default; } });
+var uniqBy_1 = require("./uniqBy");
+Object.defineProperty(exports, "uniqBy", { enumerable: true, get: function () { return __importDefault(uniqBy_1).default; } });
+var concat_1 = require("./concat");
+Object.defineProperty(exports, "concat", { enumerable: true, get: function () { return __importDefault(concat_1).default; } });
+var includes_1 = require("./includes");
+Object.defineProperty(exports, "includes", { enumerable: true, get: function () { return __importDefault(includes_1).default; } });
+var intersection_1 = require("./intersection");
+Object.defineProperty(exports, "intersection", { enumerable: true, get: function () { return __importDefault(intersection_1).default; } });
+var maxBy_1 = require("./maxBy");
+Object.defineProperty(exports, "maxBy", { enumerable: true, get: function () { return __importDefault(maxBy_1).default; } });
+var minBy_1 = require("./minBy");
+Object.defineProperty(exports, "minBy", { enumerable: true, get: function () { return __importDefault(minBy_1).default; } });
+var sortBy_1 = require("./sortBy");
+Object.defineProperty(exports, "sortBy", { enumerable: true, get: function () { return __importDefault(sortBy_1).default; } });
+var some_1 = require("./some");
+Object.defineProperty(exports, "some", { enumerable: true, get: function () { return __importDefault(some_1).default; } });
+var sum_1 = require("./sum");
+Object.defineProperty(exports, "sum", { enumerable: true, get: function () { return __importDefault(sum_1).default; } });
+var sumBy_1 = require("./sumBy");
+Object.defineProperty(exports, "sumBy", { enumerable: true, get: function () { return __importDefault(sumBy_1).default; } });
+var meanBy_1 = require("./meanBy");
+Object.defineProperty(exports, "meanBy", { enumerable: true, get: function () { return __importDefault(meanBy_1).default; } });
+var partition_1 = require("./partition");
+Object.defineProperty(exports, "partition", { enumerable: true, get: function () { return __importDefault(partition_1).default; } });
+var every_1 = require("./every");
+Object.defineProperty(exports, "every", { enumerable: true, get: function () { return __importDefault(every_1).default; } });
+var reduce_1 = require("./reduce");
+Object.defineProperty(exports, "reduce", { enumerable: true, get: function () { return __importDefault(reduce_1).default; } });
+var reduceRight_1 = require("./reduceRight");
+Object.defineProperty(exports, "reduceRight", { enumerable: true, get: function () { return __importDefault(reduceRight_1).default; } });
+var compact_1 = require("./compact");
+Object.defineProperty(exports, "compact", { enumerable: true, get: function () { return __importDefault(compact_1).default; } });
+var flatten_1 = require("./flatten");
+Object.defineProperty(exports, "flatten", { enumerable: true, get: function () { return __importDefault(flatten_1).default; } });
+var flattenDeep_1 = require("./flattenDeep");
+Object.defineProperty(exports, "flattenDeep", { enumerable: true, get: function () { return __importDefault(flattenDeep_1).default; } });
+var uniq_1 = require("./uniq");
+Object.defineProperty(exports, "uniq", { enumerable: true, get: function () { return __importDefault(uniq_1).default; } });
+var keyBy_1 = require("./keyBy");
+Object.defineProperty(exports, "keyBy", { enumerable: true, get: function () { return __importDefault(keyBy_1).default; } });
+var chunk_1 = require("./chunk");
+Object.defineProperty(exports, "chunk", { enumerable: true, get: function () { return __importDefault(chunk_1).default; } });
+var difference_1 = require("./difference");
+Object.defineProperty(exports, "difference", { enumerable: true, get: function () { return __importDefault(difference_1).default; } });
+var differenceBy_1 = require("./differenceBy");
+Object.defineProperty(exports, "differenceBy", { enumerable: true, get: function () { return __importDefault(differenceBy_1).default; } });
+var without_1 = require("./without");
+Object.defineProperty(exports, "without", { enumerable: true, get: function () { return __importDefault(without_1).default; } });
+var head_1 = require("./head");
+Object.defineProperty(exports, "head", { enumerable: true, get: function () { return __importDefault(head_1).default; } });
+var last_1 = require("./last");
+Object.defineProperty(exports, "last", { enumerable: true, get: function () { return __importDefault(last_1).default; } });
+var take_1 = require("./take");
+Object.defineProperty(exports, "take", { enumerable: true, get: function () { return __importDefault(take_1).default; } });
+var drop_1 = require("./drop");
+Object.defineProperty(exports, "drop", { enumerable: true, get: function () { return __importDefault(drop_1).default; } });
+var min_1 = require("./min");
+Object.defineProperty(exports, "min", { enumerable: true, get: function () { return __importDefault(min_1).default; } });
+var max_1 = require("./max");
+Object.defineProperty(exports, "max", { enumerable: true, get: function () { return __importDefault(max_1).default; } });
+var mean_1 = require("./mean");
+Object.defineProperty(exports, "mean", { enumerable: true, get: function () { return __importDefault(mean_1).default; } });

package/dist/cjs/array/intersection.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = intersection;
+function arrayIncludes(array, value) {
+    for (const item of array) {
+        if (Object.is(item, value)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 创建各数组按 SameValueZero 取交集后的新数组，保留首次出现顺序。
+ *
+ * @param arrays - 一个或多个数组
+ * @returns 交集数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.intersection([2, 1], [2, 3]);
+ * // => [2]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function intersection(...arrays) {
+    if (!arrays.length) {
+        return [];
+    }
+    const first = arrays[0];
+    if (!Array.isArray(first)) {
+        return [];
+    }
+    const rest = arrays.slice(1).filter(Array.isArray);
+    if (!rest.length) {
+        return [...first];
+    }
+    const seen = new Set();
+    const result = [];
+    for (const value of first) {
+        if (seen.has(value)) {
+            continue;
+        }
+        if (rest.every((array) => arrayIncludes(array, value))) {
+            result.push(value);
+            seen.add(value);
+        }
+    }
+    return result;
+}

package/dist/cjs/array/keyBy.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = keyBy;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+/**
+ * 根据 iteratee 返回值将 collection 转为键值对象，同键保留最后一个元素。
+ *
+ * @param collection - 待转换的集合
+ * @param iteratee - 生成键名的函数或简写
+ * @returns 键值映射对象
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.keyBy(
+ *   [
+ *     { dir: 'left', code: 97 },
+ *     { dir: 'right', code: 100 },
+ *   ],
+ *   'dir',
+ * );
+ * // => { left: { dir: 'left', code: 97 }, right: { dir: 'right', code: 100 } }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function keyBy(collection, iteratee = (0, baseIteratee_1.default)()) {
+    var _a;
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    const result = {};
+    const assign = (value, indexOrKey, coll) => {
+        const key = resolvedIteratee(value, indexOrKey, coll);
+        const buckets = result;
+        if (key === '__proto__') {
+            Object.defineProperty(buckets, key, {
+                configurable: true,
+                enumerable: true,
+                value,
+                writable: true,
+            });
+            return;
+        }
+        buckets[key] = value;
+    };
+    if (collection == null) {
+        return result;
+    }
+    if (typeof collection === 'string') {
+        const chars = [...collection];
+        for (let index = 0; index < chars.length; index++) {
+            assign(chars[index], index, collection);
+        }
+        return result;
+    }
+    if (Array.isArray(collection)) {
+        for (let index = 0; index < collection.length; index++) {
+            assign(collection[index], index, collection);
+        }
+        return result;
+    }
+    if ((0, isArrayLike_1.default)(collection)) {
+        const arrayLike = collection;
+        const length = (_a = arrayLike.length) !== null && _a !== void 0 ? _a : 0;
+        for (let index = 0; index < length; index++) {
+            assign(arrayLike[index], index, collection);
+        }
+        return result;
+    }
+    if (typeof collection === 'object') {
+        for (const key of Object.keys(collection)) {
+            assign(collection[key], key, collection);
+        }
+    }
+    return result;
+}

package/dist/cjs/array/last.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = last;
+/**
+ * 获取 array 的最后一个元素。
+ *
+ * @param array - 待查询的数组
+ * @returns 最后一个元素
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.last([1, 2, 3]);
+ * // => 3
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function last(array) {
+    var _a;
+    const length = (_a = array === null || array === void 0 ? void 0 : array.length) !== null && _a !== void 0 ? _a : 0;
+    return length ? array[length - 1] : undefined;
+}

package/dist/cjs/array/map.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = map;
+const baseMap_1 = __importDefault(require("../_internal/baseMap"));
+/**
+ * 遍历 collection，对每个元素执行 iteratee 并返回结果组成的新数组。
+ *
+ * @param collection - 待映射的集合
+ * @param iteratee - 每次迭代调用的函数或简写
+ * @returns 映射后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.map([1, 2, 3], (n) => n * 2);
+ * // => [2, 4, 6]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function map(collection, iteratee) {
+    return (0, baseMap_1.default)(collection, iteratee);
+}

package/dist/cjs/array/max.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = max;
+const baseExtremum_1 = __importDefault(require("../_internal/baseExtremum"));
+/**
+ * 计算 array 中的最大值。
+ *
+ * @param array - 待计算的数组
+ * @returns 最大值；空数组返回 undefined
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.max([4, 2, 8, 6]);
+ * // => 8
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function max(array) {
+    return (array === null || array === void 0 ? void 0 : array.length) ? (0, baseExtremum_1.default)(array, undefined, true) : undefined;
+}

package/dist/cjs/array/maxBy.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = maxBy;
+const baseExtremumBy_1 = __importDefault(require("../_internal/baseExtremumBy"));
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+/**
+ * 返回 iteratee 返回值最大的元素。
+ *
+ * @param collection - 待查找的集合
+ * @param iteratee - 比较依据的函数或简写
+ * @returns 最大值对应的元素
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.maxBy([{ n: 1 }, { n: 2 }], 'n');
+ * // => { n: 2 }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function maxBy(collection, iteratee = (0, baseIteratee_1.default)()) {
+    return (0, baseExtremumBy_1.default)(collection, iteratee, true);
+}

package/dist/cjs/array/mean.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = mean;
+const baseSum_1 = __importDefault(require("../_internal/baseSum"));
+/**
+ * 计算 array 数值的平均值。
+ *
+ * @param array - 待计算的数组
+ * @returns 平均值；空数组返回 NaN
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.mean([4, 2, 8, 6]);
+ * // => 5
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function mean(array) {
+    var _a;
+    const length = (_a = array === null || array === void 0 ? void 0 : array.length) !== null && _a !== void 0 ? _a : 0;
+    return length ? (0, baseSum_1.default)(array) / length : Number.NaN;
+}