zhiaiwan-utils 1.0.3

package/dist/cjs/verify/isEmpty.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 = isEmpty;
+const isArguments_1 = __importDefault(require("../_internal/isArguments"));
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+/**
+ * 检查 value 是否为空。判定规则：`null` / `undefined`、长度为 0 的数组/字符串/`arguments`、
+ * size 为 0 的 Map / Set、没有自身可枚举属性的对象，均视为空；布尔值与数字等原始值同样视为空。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 为空，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isEmpty(null);      // => true
+ * isEmpty('');        // => true
+ * isEmpty([]);        // => true
+ * isEmpty({});        // => true
+ * isEmpty([1, 2, 3]); // => false
+ * isEmpty({ a: 1 });  // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if ((0, isArrayLike_1.default)(value) &&
+        (Array.isArray(value) || typeof value === 'string' || (0, isArguments_1.default)(value))) {
+        return value.length === 0;
+    }
+    if (value instanceof Map || value instanceof Set) {
+        return value.size === 0;
+    }
+    if (typeof value === 'object') {
+        return Object.keys(value).length === 0;
+    }
+    return true;
+}

package/dist/cjs/verify/isEqual.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 = isEqual;
+const baseIsEqual_1 = __importDefault(require("../_internal/baseIsEqual"));
+/**
+ * 执行深比较，判断两个值是否相等。支持数组、普通对象、`Date`、`RegExp`、`Map`、`Set`、
+ * `ArrayBuffer`、`DataView`、`TypedArray`、包装对象与循环引用；使用 `SameValueZero` 比较原始值。
+ *
+ * @param value - 要比较的值
+ * @param other - 另一个值
+ * @returns 若相等返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isEqual({ a: [1] }, { a: [1] });
+ * // => true
+ *
+ * isEqual(NaN, NaN);
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isEqual(value, other) {
+    return (0, baseIsEqual_1.default)(value, other, new WeakMap());
+}

package/dist/cjs/verify/isEqualWith.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 = isEqualWith;
+const baseIsEqual_1 = __importDefault(require("../_internal/baseIsEqual"));
+/**
+ * 执行深比较，并通过 `customizer` 自定义比较结果。
+ * 当 `customizer` 返回 `undefined` 时，回退到默认深比较逻辑。
+ *
+ * @param value - 要比较的值
+ * @param other - 另一个值
+ * @param customizer - 自定义比较函数
+ * @returns 若相等返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isEqualWith({ a: 1 }, { a: 2 }, (left, right) => {
+ *   if (typeof left === 'number' && typeof right === 'number') {
+ *     return Math.abs(left - right) <= 1;
+ *   }
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isEqualWith(value, other, customizer) {
+    return (0, baseIsEqual_1.default)(value, other, new WeakMap(), { customizer });
+}

package/dist/cjs/verify/isError.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isError;
+/**
+ * 检查 value 是否是 Error、EvalError、RangeError、ReferenceError、SyntaxError、
+ * TypeError 或 URIError 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是错误对象，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isError(new Error());     // => true
+ * isError(new TypeError()); // => true
+ * isError('Error');         // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isError(value) {
+    return Object.prototype.toString.call(value) === '[object Error]' || value instanceof Error;
+}

package/dist/cjs/verify/isFinite.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 = isFinite;
+const isNumber_1 = __importDefault(require("./isNumber"));
+/**
+ * 检查 value 是否为有限数值（非 `NaN`、`Infinity`、`-Infinity`）。
+ *
+ * @param value - 要检查的值
+ * @returns 若 value 为有限数返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isFinite(3);
+ * // => true
+ *
+ * isFinite(Infinity);
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isFinite(value) {
+    return (0, isNumber_1.default)(value) && Number.isFinite(value);
+}

package/dist/cjs/verify/isFunction.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isFunction;
+/**
+ * 检查 value 是否是一个函数。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是函数，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isFunction(() => {}); // => true
+ * isFunction(/abc/);    // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types
+function isFunction(value) {
+    return typeof value === 'function';
+}

package/dist/cjs/verify/isInteger.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isInteger;
+/**
+ * 检查 value 是否是一个整数（仅原始 number，不含 Number 对象）。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是整数，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isInteger(3);    // => true
+ * isInteger(3.14); // => false
+ * isInteger('3');  // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isInteger(value) {
+    return typeof value === 'number' && value === value && value % 1 === 0;
+}

package/dist/cjs/verify/isLength.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 = void 0;
+/**
+ * 检查 value 是否是合法类数组长度（`0` 到 `Number.MAX_SAFE_INTEGER` 的整数）。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是合法长度，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isLength(3);
+ * // => true
+ *
+ * isLength(-1);
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+var isLength_1 = require("../_internal/isLength");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(isLength_1).default; } });

package/dist/cjs/verify/isMap.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isMap;
+/**
+ * 检查 value 是否是一个 Map 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 Map，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isMap(new Map()); // => true
+ * isMap(new Set()); // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isMap(value) {
+    return Object.prototype.toString.call(value) === '[object Map]';
+}

package/dist/cjs/verify/isMatch.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 = isMatch;
+const baseIsMatch_1 = __importDefault(require("../_internal/baseIsMatch"));
+/**
+ * 判断 object 是否包含 source 定义的全部属性值（部分匹配）。
+ * 嵌套对象、`Date`、`RegExp`、`Map`、`Set` 等按值递归匹配。
+ *
+ * @param object - 被检查的对象
+ * @param source - 属性模板
+ * @returns 若匹配返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isMatch({ a: 1, b: 2 }, { b: 2 });
+ * // => true
+ *
+ * isMatch({ a: { x: 1 } }, { a: { x: 1 } });
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isMatch(object, source) {
+    return (0, baseIsMatch_1.default)(object, source);
+}

package/dist/cjs/verify/isMatchWith.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 = isMatchWith;
+const baseIsMatch_1 = __importDefault(require("../_internal/baseIsMatch"));
+/**
+ * 判断 object 是否包含 source 定义的全部属性值，并通过 `customizer` 自定义匹配逻辑。
+ * 当 `customizer` 返回 `undefined` 时，回退到默认匹配逻辑。
+ *
+ * @param object - 被检查的对象
+ * @param source - 属性模板
+ * @param customizer - 自定义匹配函数
+ * @returns 若匹配返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isMatchWith({ a: 1.1 }, { a: 1 }, (left, right) => {
+ *   if (typeof left === 'number' && typeof right === 'number') {
+ *     return Math.floor(left) === right;
+ *   }
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isMatchWith(object, source, customizer) {
+    return (0, baseIsMatch_1.default)(object, source, { customizer });
+}

package/dist/cjs/verify/isNaN.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 = isNaN;
+const isNumber_1 = __importDefault(require("./isNumber"));
+/**
+ * 检查 value 是否为 `NaN`（含 Number 对象包装的 NaN）。
+ *
+ * @param value - 要检查的值
+ * @returns 若 value 为 NaN 返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isNaN(NaN);
+ * // => true
+ *
+ * isNaN('a');
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isNaN(value) {
+    return (0, isNumber_1.default)(value) && value !== +value;
+}

package/dist/cjs/verify/isNative.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isNative;
+const NATIVE_CODE = /\{\s*\[native code\]\s*\}$/;
+/**
+ * 检查 value 是否是原生函数（`toString` 结果为 `[native code]`）。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是原生函数，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isNative(Array.prototype.push);
+ * // => true
+ *
+ * isNative(() => {});
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isNative(value) {
+    return typeof value === 'function' && NATIVE_CODE.test(Function.prototype.toString.call(value));
+}

package/dist/cjs/verify/isNil.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isNil;
+/**
+ * 检查 value 是否是 `null` 或 `undefined`。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 null 或 undefined，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isNil(null);
+ * // => true
+ *
+ * isNil(undefined);
+ * // => true
+ *
+ * isNil('');
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isNil(value) {
+    return value == null;
+}

package/dist/cjs/verify/isNull.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isNull;
+/**
+ * 检查 value 是否是 null。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 null，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isNull(null);   // => true
+ * isNull(void 0); // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isNull(value) {
+    return value === null;
+}

package/dist/cjs/verify/isNumber.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isNumber;
+/**
+ * 检查 value 是否是原始数值或 Number 对象。
+ *
+ * 注意：`NaN` 也会返回 true，与 lodash 行为一致。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是数值，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isNumber(3);      // => true
+ * isNumber(NaN);    // => true
+ * isNumber('3');    // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isNumber(value) {
+    return typeof value === 'number' || Object.prototype.toString.call(value) === '[object Number]';
+}

package/dist/cjs/verify/isObject.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isObject;
+/**
+ * 检查 value 是否为语言意义上的 Object（如数组、函数、对象、正则、`new Number(0)` 等）。
+ * `null` 返回 false。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是对象，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isObject({});        // => true
+ * isObject([1, 2, 3]); // => true
+ * isObject(() => {});  // => true
+ * isObject(null);      // => false
+ * isObject(1);         // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isObject(value) {
+    const type = typeof value;
+    return value != null && (type === 'object' || type === 'function');
+}

package/dist/cjs/verify/isObjectLike.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isObjectLike;
+/**
+ * 检查 value 是否类似对象（`typeof value` 为 `object` 且不为 `null`）。
+ *
+ * @param value - 要检查的值
+ * @returns 若 value 类似对象则返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isObjectLike({});
+ * // => true
+ *
+ * isObjectLike([1, 2, 3]);
+ * // => true
+ *
+ * isObjectLike(null);
+ * // => false
+ *
+ * isObjectLike(() => {});
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isObjectLike(value) {
+    return typeof value === 'object' && value !== null;
+}

package/dist/cjs/verify/isPlainObject.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 = void 0;
+/**
+ * 检查 value 是否是普通对象（由 `{}` 或 `new Object()` 创建，或原型为 null）。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是普通对象，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isPlainObject({ a: 1 });      // => true
+ * isPlainObject(Object.create(null)); // => true
+ * isPlainObject([1, 2, 3]);     // => false
+ * isPlainObject(new Date());    // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+var isPlainObject_1 = require("../_internal/isPlainObject");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(isPlainObject_1).default; } });

package/dist/cjs/verify/isRegExp.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isRegExp;
+/**
+ * 检查 value 是否是一个 RegExp 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是正则对象，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isRegExp(/abc/);   // => true
+ * isRegExp('/abc/'); // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isRegExp(value) {
+    return Object.prototype.toString.call(value) === '[object RegExp]';
+}

package/dist/cjs/verify/isSafeInteger.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 = isSafeInteger;
+const isInteger_1 = __importDefault(require("./isInteger"));
+const MAX_SAFE_INTEGER = 9007199254740991;
+const MIN_SAFE_INTEGER = -9007199254740991;
+/**
+ * 检查 value 是否是安全整数（在 `Number.MIN_SAFE_INTEGER` 与 `Number.MAX_SAFE_INTEGER` 之间）。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是安全整数，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isSafeInteger(3);
+ * // => true
+ *
+ * isSafeInteger(Number.MAX_SAFE_INTEGER + 1);
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isSafeInteger(value) {
+    return (0, isInteger_1.default)(value) && value >= MIN_SAFE_INTEGER && value <= MAX_SAFE_INTEGER;
+}

package/dist/cjs/verify/isSet.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isSet;
+/**
+ * 检查 value 是否是一个 Set 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 Set，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isSet(new Set()); // => true
+ * isSet(new Map()); // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isSet(value) {
+    return Object.prototype.toString.call(value) === '[object Set]';
+}

package/dist/cjs/verify/isString.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isString;
+/**
+ * 检查 value 是否是原始字符串或 String 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是字符串，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isString('abc'); // => true
+ * isString(1);     // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isString(value) {
+    return typeof value === 'string' || Object.prototype.toString.call(value) === '[object String]';
+}

package/dist/cjs/verify/isSymbol.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isSymbol;
+/**
+ * 检查 value 是否是一个 Symbol。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 Symbol，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isSymbol(Symbol.iterator); // => true
+ * isSymbol('abc');           // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+function isSymbol(value) {
+    return typeof value === 'symbol' || Object.prototype.toString.call(value) === '[object Symbol]';
+}