zhiaiwan-utils 1.0.3

package/dist/esm/verify/isArrayLike.js

@@ -0,0 +1,25 @@
+import isArrayLikeInternal from '../_internal/isArrayLike';
+/**
+ * 检查 value 是否为类数组（含 `length` 且非函数）。
+ *
+ * @param value - 要检查的值
+ * @returns 若为类数组返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isArrayLike([1, 2, 3]);
+ * // => true
+ *
+ * isArrayLike('abc');
+ * // => true
+ *
+ * isArrayLike({ length: 0 });
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+export default function isArrayLike(value) {
+    return isArrayLikeInternal(value);
+}

package/dist/esm/verify/isBoolean.js

@@ -0,0 +1,18 @@
+/**
+ * 检查 value 是否是原始 boolean 或 Boolean 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是布尔值，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isBoolean(false); // => true
+ * isBoolean(null);  // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+export default function isBoolean(value) {
+    return value === true || value === false || Object.prototype.toString.call(value) === '[object Boolean]';
+}

package/dist/esm/verify/isBuffer.js

@@ -0,0 +1,20 @@
+/**
+ * 检查 value 是否是 Node.js `Buffer` 对象；非 Node 环境恒为 false。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 Buffer，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * // Node.js 环境
+ * isBuffer(Buffer.from('abc'));
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+export default function isBuffer(value) {
+    const bufferCtor = globalThis.Buffer;
+    return typeof bufferCtor !== 'undefined' && bufferCtor.isBuffer(value);
+}

package/dist/esm/verify/isDate.js

@@ -0,0 +1,18 @@
+/**
+ * 检查 value 是否是一个 Date 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 Date 对象，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isDate(new Date()); // => true
+ * isDate('2026-01-01'); // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+export default function isDate(value) {
+    return Object.prototype.toString.call(value) === '[object Date]';
+}

package/dist/esm/verify/isElement.js

@@ -0,0 +1,20 @@
+import isObjectLike from './isObjectLike';
+/**
+ * 检查 value 是否是 DOM Element 节点（`nodeType === 1`）。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 DOM 元素，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * // 浏览器环境
+ * isElement(document.body);
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+export default function isElement(value) {
+    return isObjectLike(value) && value.nodeType === 1;
+}

package/dist/esm/verify/isEmpty.js

@@ -0,0 +1,38 @@
+import isArguments from '../_internal/isArguments';
+import isArrayLike from '../_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
+ */
+export default function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if (isArrayLike(value) &&
+        (Array.isArray(value) || typeof value === 'string' || isArguments(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/esm/verify/isEqual.js

@@ -0,0 +1,24 @@
+import baseIsEqual from '../_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
+ */
+export default function isEqual(value, other) {
+    return baseIsEqual(value, other, new WeakMap());
+}

package/dist/esm/verify/isEqualWith.js

@@ -0,0 +1,25 @@
+import baseIsEqual from '../_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
+ */
+export default function isEqualWith(value, other, customizer) {
+    return baseIsEqual(value, other, new WeakMap(), { customizer });
+}

package/dist/esm/verify/isError.js

@@ -0,0 +1,20 @@
+/**
+ * 检查 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
+ */
+export default function isError(value) {
+    return Object.prototype.toString.call(value) === '[object Error]' || value instanceof Error;
+}

package/dist/esm/verify/isFinite.js

@@ -0,0 +1,22 @@
+import isNumber from './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
+ */
+export default function isFinite(value) {
+    return isNumber(value) && Number.isFinite(value);
+}

package/dist/esm/verify/isFunction.js

@@ -0,0 +1,19 @@
+/**
+ * 检查 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
+export default function isFunction(value) {
+    return typeof value === 'function';
+}

package/dist/esm/verify/isInteger.js

@@ -0,0 +1,19 @@
+/**
+ * 检查 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
+ */
+export default function isInteger(value) {
+    return typeof value === 'number' && value === value && value % 1 === 0;
+}

package/dist/esm/verify/isLength.js

@@ -0,0 +1,19 @@
+/**
+ * 检查 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
+ */
+export { default } from '../_internal/isLength';

package/dist/esm/verify/isMap.js

@@ -0,0 +1,18 @@
+/**
+ * 检查 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
+ */
+export default function isMap(value) {
+    return Object.prototype.toString.call(value) === '[object Map]';
+}

package/dist/esm/verify/isMatch.js

@@ -0,0 +1,24 @@
+import baseIsMatch from '../_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
+ */
+export default function isMatch(object, source) {
+    return baseIsMatch(object, source);
+}

package/dist/esm/verify/isMatchWith.js

@@ -0,0 +1,25 @@
+import baseIsMatch from '../_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
+ */
+export default function isMatchWith(object, source, customizer) {
+    return baseIsMatch(object, source, { customizer });
+}

package/dist/esm/verify/isNaN.js

@@ -0,0 +1,22 @@
+import isNumber from './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
+ */
+export default function isNaN(value) {
+    return isNumber(value) && value !== +value;
+}

package/dist/esm/verify/isNative.js

@@ -0,0 +1,22 @@
+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
+ */
+export default function isNative(value) {
+    return typeof value === 'function' && NATIVE_CODE.test(Function.prototype.toString.call(value));
+}

package/dist/esm/verify/isNil.js

@@ -0,0 +1,24 @@
+/**
+ * 检查 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
+ */
+export default function isNil(value) {
+    return value == null;
+}

package/dist/esm/verify/isNull.js

@@ -0,0 +1,18 @@
+/**
+ * 检查 value 是否是 null。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 null，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * isNull(null);   // => true
+ * isNull(void 0); // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+export default function isNull(value) {
+    return value === null;
+}

package/dist/esm/verify/isNumber.js

@@ -0,0 +1,21 @@
+/**
+ * 检查 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
+ */
+export default function isNumber(value) {
+    return typeof value === 'number' || Object.prototype.toString.call(value) === '[object Number]';
+}

package/dist/esm/verify/isObject.js

@@ -0,0 +1,23 @@
+/**
+ * 检查 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
+ */
+export default function isObject(value) {
+    const type = typeof value;
+    return value != null && (type === 'object' || type === 'function');
+}

package/dist/esm/verify/isObjectLike.js

@@ -0,0 +1,27 @@
+/**
+ * 检查 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
+ */
+export default function isObjectLike(value) {
+    return typeof value === 'object' && value !== null;
+}

package/dist/esm/verify/isPlainObject.js

@@ -0,0 +1,18 @@
+/**
+ * 检查 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
+ */
+export { default } from '../_internal/isPlainObject';

package/dist/esm/verify/isRegExp.js

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

package/dist/esm/verify/isSafeInteger.js

@@ -0,0 +1,24 @@
+import isInteger from './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
+ */
+export default function isSafeInteger(value) {
+    return isInteger(value) && value >= MIN_SAFE_INTEGER && value <= MAX_SAFE_INTEGER;
+}

package/dist/esm/verify/isSet.js

@@ -0,0 +1,18 @@
+/**
+ * 检查 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
+ */
+export default function isSet(value) {
+    return Object.prototype.toString.call(value) === '[object Set]';
+}

package/dist/esm/verify/isString.js

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

package/dist/esm/verify/isSymbol.js

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