zhiaiwan-utils 1.0.3

package/dist/cjs/_internal/toInteger.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = toInteger;
+const INFINITY = 1 / 0;
+function toFinite(value) {
+    const result = Number(value);
+    if (result === INFINITY || result === -INFINITY) {
+        return result < 0 ? -Number.MAX_VALUE : Number.MAX_VALUE;
+    }
+    return result === result ? result : 0;
+}
+/**
+ * 内部辅助：将值转为整数，语义对齐 convert/toInteger。
+ *
+ * @internal
+ */
+function toInteger(value) {
+    const result = toFinite(value);
+    if (result === 0) {
+        return result;
+    }
+    const remainder = result % 1;
+    return remainder ? result - remainder : result;
+}

package/dist/cjs/_internal/toLength.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = toLength;
+const toInteger_1 = __importDefault(require("./toInteger"));
+const MAX_ARRAY_LENGTH = 4294967295;
+/**
+ * 内部辅助：将值转为合法类数组长度，语义对齐 convert/toLength。
+ *
+ * @internal
+ */
+function toLength(value) {
+    const result = (0, toInteger_1.default)(value);
+    return result < 0 ? 0 : Math.min(result, MAX_ARRAY_LENGTH);
+}

package/dist/cjs/_internal/toPath.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = toPath;
+/**
+ * 内部辅助：将属性路径规范化为字符串键数组。
+ * 支持点号与方括号写法，如 `'a.b[0].c'` → `['a', 'b', '0', 'c']`。
+ *
+ * @internal
+ */
+function toPath(path) {
+    if (Array.isArray(path)) {
+        return path.map(String);
+    }
+    const str = String(path);
+    if (str === '') {
+        return [];
+    }
+    const result = [];
+    // 将 [key] 转为 .key，再按 . 拆分；同时去除引号
+    str
+        .replace(/\[(['"]?)([^\]]*)\1\]/g, '.$2')
+        .split('.')
+        .forEach((seg) => {
+        if (seg !== '') {
+            result.push(seg);
+        }
+    });
+    return result;
+}

package/dist/cjs/_internal/upperFirst.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = upperFirst;
+/**
+ * 首字母大写，对齐 Lodash upperFirst。
+ *
+ * @internal
+ */
+function upperFirst(string) {
+    if (!string) {
+        return string;
+    }
+    return string.charAt(0).toUpperCase() + string.slice(1);
+}

package/dist/cjs/_internal/validateFieldRule.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = validateFieldRule;
+const isArray_1 = __importDefault(require("../verify/isArray"));
+const isBoolean_1 = __importDefault(require("../verify/isBoolean"));
+const isDate_1 = __importDefault(require("../verify/isDate"));
+const isInteger_1 = __importDefault(require("../verify/isInteger"));
+const isNumber_1 = __importDefault(require("../verify/isNumber"));
+const isPlainObject_1 = __importDefault(require("./isPlainObject"));
+const isString_1 = __importDefault(require("../verify/isString"));
+const isEmptyValue_1 = __importDefault(require("./isEmptyValue"));
+const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const URL_PATTERN = /^(https?:\/\/|ftp:\/\/)/i;
+function resolveMessage(value, rule, fallback) {
+    var _a;
+    if (typeof rule.message === 'function') {
+        return rule.message(value, rule);
+    }
+    return (_a = rule.message) !== null && _a !== void 0 ? _a : fallback;
+}
+function checkType(value, type) {
+    switch (type) {
+        case 'string':
+            return (0, isString_1.default)(value);
+        case 'number':
+            return (0, isNumber_1.default)(value);
+        case 'boolean':
+            return (0, isBoolean_1.default)(value);
+        case 'integer':
+            return (0, isInteger_1.default)(value);
+        case 'array':
+            return (0, isArray_1.default)(value);
+        case 'object':
+            return (0, isPlainObject_1.default)(value);
+        case 'email':
+            return (0, isString_1.default)(value) && EMAIL_PATTERN.test(value);
+        case 'url':
+            return (0, isString_1.default)(value) && URL_PATTERN.test(value);
+        case 'date':
+            return (0, isDate_1.default)(value);
+        default:
+            return true;
+    }
+}
+function checkLenMinMax(value, rule) {
+    const { len, min, max, type } = rule;
+    if (len == null && min == null && max == null) {
+        return null;
+    }
+    let size;
+    let numericValue = null;
+    if (type === 'number' || type === 'integer' || (type == null && (0, isNumber_1.default)(value))) {
+        if (!(0, isNumber_1.default)(value)) {
+            return null;
+        }
+        numericValue = value;
+        size = value;
+    }
+    else if ((0, isString_1.default)(value) || (0, isArray_1.default)(value)) {
+        size = value.length;
+    }
+    else {
+        return null;
+    }
+    if (len != null && size !== len) {
+        return resolveMessage(value, rule, `长度须为 ${len}`);
+    }
+    if (min != null) {
+        const actual = numericValue !== null && numericValue !== void 0 ? numericValue : size;
+        if (actual < min) {
+            return resolveMessage(value, rule, `不能小于 ${min}`);
+        }
+    }
+    if (max != null) {
+        const actual = numericValue !== null && numericValue !== void 0 ? numericValue : size;
+        if (actual > max) {
+            return resolveMessage(value, rule, `不能大于 ${max}`);
+        }
+    }
+    return null;
+}
+function resolveValidatorResult(value, rule, result) {
+    if (result === true || result === undefined || result === '') {
+        return null;
+    }
+    if (typeof result === 'string') {
+        return result;
+    }
+    if (result === false) {
+        return resolveMessage(value, rule, '校验失败');
+    }
+    return null;
+}
+function runValidator(ctx, rule) {
+    const raw = rule.validator(ctx);
+    if (raw instanceof Promise) {
+        return raw.then((result) => resolveValidatorResult(ctx.value, rule, result));
+    }
+    return resolveValidatorResult(ctx.value, rule, raw);
+}
+/**
+ * 执行单条字段规则，失败时返回错误文案，通过时返回 null。
+ *
+ * @internal
+ */
+function validateFieldRule(ctx) {
+    const { value, rule } = ctx;
+    const empty = (0, isEmptyValue_1.default)(value);
+    if (rule.required && empty) {
+        return resolveMessage(value, rule, '该字段必填');
+    }
+    if (!rule.required && empty) {
+        if (rule.validator) {
+            return runValidator(ctx, rule);
+        }
+        return null;
+    }
+    if (rule.type && !checkType(value, rule.type)) {
+        return resolveMessage(value, rule, `类型应为 ${rule.type}`);
+    }
+    if (rule.enum && !rule.enum.includes(value)) {
+        return resolveMessage(value, rule, '值不在允许的范围内');
+    }
+    const lenError = checkLenMinMax(value, rule);
+    if (lenError) {
+        return lenError;
+    }
+    if (rule.pattern && !rule.pattern.test(String(value))) {
+        return resolveMessage(value, rule, '格式不正确');
+    }
+    if (rule.validator) {
+        return runValidator(ctx, rule);
+    }
+    return null;
+}

package/dist/cjs/_internal/words.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = words;
+const DEFAULT_WORD_PATTERN = /[A-Z]?[a-z\d]+|[A-Z]+(?![a-z])|\d+/g;
+/**
+ * 拆分字符串为单词数组，对齐 Lodash words 默认 pattern。
+ *
+ * @internal
+ */
+function words(string) {
+    var _a;
+    return (_a = string.match(DEFAULT_WORD_PATTERN)) !== null && _a !== void 0 ? _a : [];
+}

package/dist/cjs/array/chunk.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = chunk;
+const toInteger_1 = __importDefault(require("../_internal/toInteger"));
+/**
+ * 将 array 按指定长度切分为多个子数组。
+ *
+ * @param array - 待切分的数组
+ * @param size - 每个分块的长度，默认 1
+ * @returns 分块后的二维数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.chunk(['a', 'b', 'c', 'd'], 2);
+ * // => [['a', 'b'], ['c', 'd']]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function chunk(array, size = 1) {
+    var _a;
+    const resolvedSize = Math.max((0, toInteger_1.default)(size), 0);
+    const length = (_a = array === null || array === void 0 ? void 0 : array.length) !== null && _a !== void 0 ? _a : 0;
+    if (!length || resolvedSize < 1) {
+        return [];
+    }
+    const result = [];
+    let index = 0;
+    while (index < length) {
+        result.push(array.slice(index, (index += resolvedSize)));
+    }
+    return result;
+}

package/dist/cjs/array/compact.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = compact;
+/**
+ * 移除数组中所有假值（`false`、`null`、`0`、`""`、`undefined`、`NaN`）。
+ *
+ * @param array - 待处理的数组
+ * @returns 过滤后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.compact([0, 1, false, 2, '', 3]);
+ * // => [1, 2, 3]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function compact(array) {
+    var _a;
+    if (array == null) {
+        return [];
+    }
+    const length = (_a = array.length) !== null && _a !== void 0 ? _a : 0;
+    const result = [];
+    const source = array;
+    for (let index = 0; index < length; index++) {
+        const value = source[index];
+        if (value) {
+            result.push(value);
+        }
+    }
+    return result;
+}

package/dist/cjs/array/concat.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = concat;
+/**
+ * 创建一个新数组，按顺序拼接各参数；数组参数会展开一层。
+ *
+ * @param array - 第一个数组或元素
+ * @param values - 后续数组或元素
+ * @returns 拼接后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.concat([1], 2, [3], [[4]]);
+ * // => [1, 2, 3, [4]]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function concat(array, ...values) {
+    const result = [];
+    if (Array.isArray(array)) {
+        result.push(...array);
+    }
+    else if (array !== undefined) {
+        result.push(array);
+    }
+    for (const value of values) {
+        if (Array.isArray(value)) {
+            result.push(...value);
+        }
+        else {
+            result.push(value);
+        }
+    }
+    return result;
+}

package/dist/cjs/array/difference.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = difference;
+const baseDifference_1 = __importDefault(require("../_internal/baseDifference"));
+const isArrayLikeObject_1 = __importDefault(require("../_internal/isArrayLikeObject"));
+function flattenValueArrays(values) {
+    var _a;
+    const result = [];
+    for (const value of values) {
+        if ((0, isArrayLikeObject_1.default)(value)) {
+            const arrayLike = value;
+            const length = (_a = arrayLike.length) !== null && _a !== void 0 ? _a : 0;
+            for (let index = 0; index < length; index++) {
+                result.push(arrayLike[index]);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * 创建按 SameValueZero 排除其余数组元素后的新数组。
+ *
+ * @param array - 待处理的数组
+ * @param values - 要排除的数组（可传多个）
+ * @returns 差集数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.difference([2, 1], [2, 3]);
+ * // => [1]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function difference(array, ...values) {
+    if (!(0, isArrayLikeObject_1.default)(array)) {
+        return [];
+    }
+    return (0, baseDifference_1.default)(array, flattenValueArrays(values));
+}

package/dist/cjs/array/differenceBy.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = differenceBy;
+const baseDifference_1 = __importDefault(require("../_internal/baseDifference"));
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const isArrayLikeObject_1 = __importDefault(require("../_internal/isArrayLikeObject"));
+function flattenValueArrays(values) {
+    var _a;
+    const result = [];
+    for (const value of values) {
+        if ((0, isArrayLikeObject_1.default)(value)) {
+            const arrayLike = value;
+            const length = (_a = arrayLike.length) !== null && _a !== void 0 ? _a : 0;
+            for (let index = 0; index < length; index++) {
+                result.push(arrayLike[index]);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * 类似 difference，但按 iteratee 返回值比较排除项。
+ *
+ * @param array - 待处理的数组
+ * @param values - 要排除的数组（可传多个），最后一项可为 iteratee
+ * @param iteratee - 比较依据的函数或简写
+ * @returns 差集数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.differenceBy([2.1, 1.2], [2.3, 3.4], Math.floor);
+ * // => [1.2]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function differenceBy(array, ...args) {
+    if (!(0, isArrayLikeObject_1.default)(array)) {
+        return [];
+    }
+    let iteratee = (0, baseIteratee_1.default)();
+    let valueGroups = args;
+    const last = valueGroups[valueGroups.length - 1];
+    if (!(0, isArrayLikeObject_1.default)(last)) {
+        iteratee = last;
+        valueGroups = valueGroups.slice(0, -1);
+    }
+    const resolvedIteratee = (0, baseIteratee_1.default)(iteratee);
+    const mapper = (value) => resolvedIteratee(value, 0, array);
+    return (0, baseDifference_1.default)(array, flattenValueArrays(valueGroups), mapper);
+}

package/dist/cjs/array/drop.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 = drop;
+const toInteger_1 = __importDefault(require("../_internal/toInteger"));
+/**
+ * 从 array 头部跳过 n 个元素。
+ *
+ * @param array - 待处理的数组
+ * @param n - 跳过数量，默认 1
+ * @returns 剩余元素组成的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.drop([1, 2, 3], 2);
+ * // => [3]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function drop(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 start = resolved < 0 ? 0 : resolved;
+    return array.slice(start);
+}

package/dist/cjs/array/each.js

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

package/dist/cjs/array/every.js

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

package/dist/cjs/array/filter.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 = filter;
+const baseFilter_1 = __importDefault(require("../_internal/baseFilter"));
+/**
+ * 遍历 collection，返回 predicate 为真值的所有元素组成的新数组。
+ *
+ * @param collection - 待筛选的集合
+ * @param predicate - 每次迭代调用的断言函数或简写
+ * @returns 筛选后的新数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.filter([1, 2, 3, 4], (n) => n % 2 === 0);
+ * // => [2, 4]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function filter(collection, predicate) {
+    return (0, baseFilter_1.default)(collection, predicate);
+}

package/dist/cjs/array/find.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = find;
+const baseFind_1 = require("../_internal/baseFind");
+/**
+ * 返回集合中第一个满足 `predicate` 的元素。
+ *
+ * @param collection - 待查找的集合（数组、对象、字符串或类数组）
+ * @param predicate - 匹配函数，接收 `(value, index|key, collection)`，默认匹配真值
+ * @param fromIndex - 类数组的起始下标
+ * @returns 匹配元素，未找到时返回 `undefined`
+ *
+ * @example
+ * ```ts
+ * const users = [
+ *   { user: 'barney', age: 36, active: true },
+ *   { user: 'fred', age: 40, active: false },
+ * ];
+ *
+ * find(users, ({ age }) => age < 40);
+ * // => { user: 'barney', age: 36, active: true }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Array
+ */
+function find(collection, predicate, fromIndex = 0) {
+    return (0, baseFind_1.baseFind)(collection, predicate, fromIndex, false);
+}

package/dist/cjs/array/findIndex.js

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

package/dist/cjs/array/findLast.js

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