zhiaiwan-utils 1.0.3

package/dist/cjs/array/meanBy.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = meanBy;
+const sumBy_1 = __importDefault(require("./sumBy"));
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+/**
+ * 计算 array 中 iteratee 返回值的平均值。
+ *
+ * @param array - 待计算的数组
+ * @param iteratee - 每次迭代调用的函数或简写
+ * @returns 平均值；空数组返回 NaN
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.meanBy([{ n: 4 }, { n: 2 }, { n: 8 }], 'n');
+ * // => 4.666666666666667
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function meanBy(array, iteratee = (0, baseIteratee_1.default)()) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return Number.NaN;
+    }
+    return (0, sumBy_1.default)(array, iteratee) / array.length;
+}

package/dist/cjs/array/min.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 = min;
+const baseExtremum_1 = __importDefault(require("../_internal/baseExtremum"));
+/**
+ * 计算 array 中的最小值。
+ *
+ * @param array - 待计算的数组
+ * @returns 最小值；空数组返回 undefined
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.min([4, 2, 8, 6]);
+ * // => 2
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function min(array) {
+    return (array === null || array === void 0 ? void 0 : array.length) ? (0, baseExtremum_1.default)(array, undefined, false) : undefined;
+}

package/dist/cjs/array/minBy.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 = minBy;
+const baseExtremumBy_1 = __importDefault(require("../_internal/baseExtremumBy"));
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+/**
+ * 返回 iteratee 返回值最小的元素。
+ *
+ * @param collection - 待查找的集合
+ * @param iteratee - 比较依据的函数或简写
+ * @returns 最小值对应的元素
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.minBy([{ n: 1 }, { n: 2 }], 'n');
+ * // => { n: 1 }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function minBy(collection, iteratee = (0, baseIteratee_1.default)()) {
+    return (0, baseExtremumBy_1.default)(collection, iteratee, false);
+}

package/dist/cjs/array/orderBy.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = orderBy;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const compareValues_1 = require("../_internal/compareValues");
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+function iterateCollection(collection, iteratee) {
+    var _a;
+    if (collection == null) {
+        return;
+    }
+    if (typeof collection === 'string') {
+        const chars = [...collection];
+        for (let index = 0; index < chars.length; index++) {
+            iteratee(chars[index], index, collection);
+        }
+        return;
+    }
+    if (Array.isArray(collection)) {
+        for (let index = 0; index < collection.length; index++) {
+            iteratee(collection[index], index, collection);
+        }
+        return;
+    }
+    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++) {
+            iteratee(arrayLike[index], index, collection);
+        }
+        return;
+    }
+    if (typeof collection === 'object') {
+        for (const key of Object.keys(collection)) {
+            iteratee(collection[key], key, collection);
+        }
+    }
+}
+/**
+ * 按 iteratee 与 orders 对 collection 排序并返回新数组。
+ *
+ * @param collection - 待排序的集合
+ * @param iteratees - 排序依据的函数、简写或数组
+ * @param orders - 排序方向 `'asc'` 或 `'desc'`，可为数组
+ * @returns 排序后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.orderBy(
+ *   [{ user: 'fred', age: 48 }, { user: 'barney', age: 34 }],
+ *   ['user', 'age'],
+ *   ['asc', 'desc'],
+ * );
+ * // => [{ user: 'barney', age: 34 }, { user: 'fred', age: 48 }]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function orderBy(collection, iteratees = (0, baseIteratee_1.default)(), orders = 'asc') {
+    if (collection == null) {
+        return [];
+    }
+    const iterateeList = (Array.isArray(iteratees) ? iteratees : [iteratees]).map((item) => (0, baseIteratee_1.default)(item));
+    const orderList = Array.isArray(orders)
+        ? iterateeList.map((_, index) => { var _a; return (_a = orders[index]) !== null && _a !== void 0 ? _a : 'asc'; })
+        : iterateeList.map(() => orders);
+    const mapped = [];
+    let sortIndex = 0;
+    iterateCollection(collection, (value) => {
+        mapped.push({
+            criteria: iterateeList.map((iteratee) => iteratee(value, sortIndex, collection)),
+            index: sortIndex++,
+            value,
+        });
+    });
+    mapped.sort((left, right) => {
+        var _a;
+        for (let index = 0; index < iterateeList.length; index++) {
+            const order = (_a = orderList[index]) !== null && _a !== void 0 ? _a : 'asc';
+            let compared = (0, compareValues_1.compareAsc)(left.criteria[index], right.criteria[index]);
+            if (order === 'desc') {
+                compared = -compared;
+            }
+            if (compared !== 0) {
+                return compared;
+            }
+        }
+        return left.index - right.index;
+    });
+    return mapped.map((item) => item.value);
+}

package/dist/cjs/array/partition.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = partition;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+/**
+ * 根据 predicate 将 collection 拆分为 `[匹配项, 未匹配项]` 两个数组。
+ *
+ * @param collection - 待拆分的集合
+ * @param predicate - 每次迭代调用的断言函数或简写
+ * @returns 二元组 `[truthy, falsy]`
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.partition([1, 2, 3, 4], (n) => n % 2);
+ * // => [[1, 3], [2, 4]]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function partition(collection, predicate = (0, baseIteratee_1.default)()) {
+    var _a;
+    const resolvedPredicate = (0, baseIteratee_1.default)(predicate);
+    const truthy = [];
+    const falsy = [];
+    const append = (value, indexOrKey, coll) => {
+        if (resolvedPredicate(value, indexOrKey, coll)) {
+            truthy.push(value);
+        }
+        else {
+            falsy.push(value);
+        }
+    };
+    if (collection == null) {
+        return [truthy, falsy];
+    }
+    if (typeof collection === 'string') {
+        const chars = [...collection];
+        for (let index = 0; index < chars.length; index++) {
+            append(chars[index], index, collection);
+        }
+        return [truthy, falsy];
+    }
+    if (Array.isArray(collection)) {
+        for (let index = 0; index < collection.length; index++) {
+            append(collection[index], index, collection);
+        }
+        return [truthy, falsy];
+    }
+    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 [truthy, falsy];
+    }
+    if (typeof collection === 'object') {
+        for (const key of Object.keys(collection)) {
+            append(collection[key], key, collection);
+        }
+    }
+    return [truthy, falsy];
+}

package/dist/cjs/array/reduce.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = reduce;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const baseReduce_1 = __importDefault(require("../_internal/baseReduce"));
+/**
+ * 将 collection 累约为单个值。
+ *
+ * @param collection - 待遍历的集合
+ * @param iteratee - 每次迭代调用的函数或简写
+ * @param accumulator - 初始累加值；未提供时使用首个元素
+ * @returns 累加结果
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.reduce([1, 2], (sum, n) => sum + (n as number), 0);
+ * // => 3
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function reduce(collection, iteratee = (0, baseIteratee_1.default)(), accumulator) {
+    const initAccum = arguments.length < 3;
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    return (0, baseReduce_1.default)(collection, resolvedIteratee, accumulator, initAccum, false);
+}

package/dist/cjs/array/reduceRight.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = reduceRight;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const baseReduce_1 = __importDefault(require("../_internal/baseReduce"));
+/**
+ * 从右向左将 collection 累约为单个值。
+ *
+ * @param collection - 待遍历的集合
+ * @param iteratee - 每次迭代调用的函数或简写
+ * @param accumulator - 初始累加值；未提供时使用末尾元素
+ * @returns 累加结果
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.reduceRight([[0, 1], [2, 3], [4, 5]], (flat, other) => flat.concat(other), []);
+ * // => [4, 5, 2, 3, 0, 1]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function reduceRight(collection, iteratee = (0, baseIteratee_1.default)(), accumulator) {
+    const initAccum = arguments.length < 3;
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    return (0, baseReduce_1.default)(collection, resolvedIteratee, accumulator, initAccum, true);
+}

package/dist/cjs/array/some.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = some;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+/**
+ * 检查 collection 中是否存在 predicate 为真值的元素。
+ *
+ * @param collection - 待检查的集合
+ * @param predicate - 每次迭代调用的断言函数或简写
+ * @returns 若存在匹配元素返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.some([null, 0, 1], Boolean);
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function some(collection, predicate = (0, baseIteratee_1.default)()) {
+    var _a;
+    const resolvedPredicate = (0, baseIteratee_1.default)(predicate);
+    if (collection == null) {
+        return false;
+    }
+    if (typeof collection === 'string') {
+        const chars = [...collection];
+        for (let index = 0; index < chars.length; index++) {
+            if (resolvedPredicate(chars[index], index, collection)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    if (Array.isArray(collection)) {
+        for (let index = 0; index < collection.length; index++) {
+            if (resolvedPredicate(collection[index], index, collection)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    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++) {
+            if (resolvedPredicate(arrayLike[index], index, collection)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    if (typeof collection === 'object') {
+        for (const key of Object.keys(collection)) {
+            if (resolvedPredicate(collection[key], key, collection)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}

package/dist/cjs/array/sortBy.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 = sortBy;
+const orderBy_1 = __importDefault(require("./orderBy"));
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+/**
+ * 按 iteratee 升序排序 collection 并返回新数组。
+ *
+ * @param collection - 待排序的集合
+ * @param iteratees - 排序依据的函数、简写或数组
+ * @returns 排序后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.sortBy([{ x: 2 }, { x: 1 }], 'x');
+ * // => [{ x: 1 }, { x: 2 }]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function sortBy(collection, iteratees = (0, baseIteratee_1.default)()) {
+    return (0, orderBy_1.default)(collection, iteratees, 'asc');
+}

package/dist/cjs/array/sum.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 = sum;
+const baseSum_1 = __importDefault(require("../_internal/baseSum"));
+/**
+ * 对 array 中的值求和（使用 `+` 做 Lodash 式数值 coercion）。
+ *
+ * @param array - 待求和的数组
+ * @returns 总和
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.sum([4, 2, 8, 6]);
+ * // => 20
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function sum(array) {
+    return (0, baseSum_1.default)(array);
+}

package/dist/cjs/array/sumBy.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = sumBy;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const baseSum_1 = __importDefault(require("../_internal/baseSum"));
+/**
+ * 对 array 中 iteratee 返回值求和。
+ *
+ * @param array - 待求和的数组
+ * @param iteratee - 每次迭代调用的函数或简写
+ * @returns 总和
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.sumBy([{ n: 4 }, { n: 2 }, { n: 8 }], 'n');
+ * // => 14
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function sumBy(array, iteratee = (0, baseIteratee_1.default)()) {
+    if (array == null) {
+        return 0;
+    }
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    return (0, baseSum_1.default)(array, (value, index, collection) => resolvedIteratee(value, index, collection));
+}

package/dist/cjs/array/take.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = take;
+const toInteger_1 = __importDefault(require("../_internal/toInteger"));
+/**
+ * 从 array 头部截取 n 个元素。
+ *
+ * @param array - 待截取的数组
+ * @param n - 截取数量，默认 1
+ * @returns 截取后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.take([1, 2, 3], 2);
+ * // => [1, 2]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function take(array, n = 1) {
+    if (!(array === null || array === void 0 ? void 0 : array.length)) {
+        return [];
+    }
+    const resolved = n === undefined ? 1 : (0, toInteger_1.default)(n);
+    const end = resolved < 0 ? 0 : resolved;
+    return array.slice(0, end);
+}

package/dist/cjs/array/union.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = union;
+/**
+ * 创建一个按 SameValueZero 去重后的并集数组。
+ *
+ * @param arrays - 一个或多个数组
+ * @returns 去重并集
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.union([2], [1, 2], [2, 3]);
+ * // => [2, 1, 3]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function union(...arrays) {
+    const seen = new Set();
+    const result = [];
+    for (const array of arrays) {
+        if (!Array.isArray(array)) {
+            continue;
+        }
+        for (const value of array) {
+            if (seen.has(value)) {
+                continue;
+            }
+            seen.add(value);
+            result.push(value);
+        }
+    }
+    return result;
+}

package/dist/cjs/array/uniq.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = uniq;
+/**
+ * 使用 SameValueZero 比较对 array 去重，保留首次出现的元素。
+ *
+ * @param array - 待去重的数组
+ * @returns 去重后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.uniq([2, 1, 2]);
+ * // => [2, 1]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function uniq(array) {
+    if (!(array === null || array === void 0 ? void 0 : array.length)) {
+        return [];
+    }
+    const seen = new Set();
+    const result = [];
+    for (const value of array) {
+        if (seen.has(value)) {
+            continue;
+        }
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}

package/dist/cjs/array/uniqBy.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = uniqBy;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+/**
+ * 按 iteratee 返回值对 collection 去重，保留首次出现的元素。
+ *
+ * @param array - 待去重的数组
+ * @param iteratee - 唯一性依据的函数或简写
+ * @returns 去重后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.uniqBy([2.1, 1.2, 2.3], Math.floor);
+ * // => [2.1, 1.2]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function uniqBy(array, iteratee = (0, baseIteratee_1.default)()) {
+    if (!Array.isArray(array)) {
+        return [];
+    }
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    const seen = new Set();
+    const result = [];
+    for (let index = 0; index < array.length; index++) {
+        const value = array[index];
+        const computed = resolvedIteratee(value, index, array);
+        if (seen.has(computed)) {
+            continue;
+        }
+        seen.add(computed);
+        result.push(value);
+    }
+    return result;
+}

package/dist/cjs/array/without.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = without;
+const baseDifference_1 = __importDefault(require("../_internal/baseDifference"));
+const isArrayLikeObject_1 = __importDefault(require("../_internal/isArrayLikeObject"));
+/**
+ * 创建排除指定值后的新数组，使用 SameValueZero 比较。
+ *
+ * @param array - 待处理的数组
+ * @param values - 要排除的值
+ * @returns 过滤后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.without([2, 1, 2, 3], 1, 2);
+ * // => [3]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function without(array, ...values) {
+    if (!(0, isArrayLikeObject_1.default)(array)) {
+        return [];
+    }
+    return (0, baseDifference_1.default)(array, values);
+}

package/dist/cjs/color/getCssVariable.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getCssVariable;
+/**
+ * 读取元素上的 CSS 自定义属性（变量）值。
+ *
+ * @param element - DOM 元素；浏览器环境默认 `document.body`
+ * @param property - CSS 变量名，如 `--primary-color`
+ * @param fallback - 无法读取时的回退值
+ * @returns 变量值或回退值
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.getCssVariable(document.body, '--primary-color', '#3370FF');
+ * // => '#3370FF'
+ * ```
+ *
+ * @since 1.0.0
+ * @category Color
+ */
+function getCssVariable(element, property = '--ed-color-primary', fallback = '#3370FF') {
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+        return fallback;
+    }
+    const target = element !== null && element !== void 0 ? element : document.body;
+    if (!target) {
+        return fallback;
+    }
+    const value = window.getComputedStyle(target).getPropertyValue(property).trim();
+    return value || fallback;
+}