zhiaiwan-utils 1.0.3

package/dist/cjs/util/random.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = random;
+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;
+}
+function baseRandom(lower, upper) {
+    return lower + Math.floor(Math.random() * (upper - lower + 1));
+}
+/**
+ * 生成 [lower, upper] 范围内的随机数。
+ *
+ * @param lower - 下界，默认 0
+ * @param upper - 上界，默认 1
+ * @param floating - 是否返回浮点数
+ * @returns 随机数
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.random(0, 5);
+ * // => 0 到 5 的整数
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function random(lower = 0, upper, floating) {
+    let resolvedLower = lower;
+    let resolvedUpper = upper;
+    let resolvedFloating = floating;
+    if (typeof resolvedUpper === 'boolean' && resolvedFloating === undefined) {
+        resolvedFloating = resolvedUpper;
+        resolvedUpper = undefined;
+    }
+    else if (typeof resolvedLower === 'boolean' && resolvedFloating === undefined) {
+        resolvedFloating = resolvedLower;
+        resolvedLower = 0;
+        resolvedUpper = 1;
+    }
+    if (resolvedLower === undefined && resolvedUpper === undefined) {
+        resolvedLower = 0;
+        resolvedUpper = 1;
+    }
+    else {
+        resolvedLower = toFinite(resolvedLower);
+        if (resolvedUpper === undefined) {
+            resolvedUpper = resolvedLower;
+            resolvedLower = 0;
+        }
+        else {
+            resolvedUpper = toFinite(resolvedUpper);
+        }
+    }
+    let lowerBound = resolvedLower;
+    let upperBound = resolvedUpper;
+    if (lowerBound > upperBound) {
+        const temp = lowerBound;
+        lowerBound = upperBound;
+        upperBound = temp;
+    }
+    if (resolvedFloating || lowerBound % 1 || upperBound % 1) {
+        const rand = Math.random();
+        return Math.min(lowerBound +
+            rand * (upperBound - lowerBound + Number.parseFloat(`1e-${String(rand).length - 1}`)), upperBound);
+    }
+    return baseRandom(lowerBound, upperBound);
+}

package/dist/cjs/util/range.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = range;
+const baseRange_1 = __importDefault(require("../_internal/baseRange"));
+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;
+}
+/**
+ * 创建从 start 到 end（不含）按 step 递增的数字数组。
+ *
+ * @param start - 起始值；仅传一个参数时表示 end，start 置 0
+ * @param end - 结束值（不含）
+ * @param step - 步长，默认 1 或 -1
+ * @returns 数字数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.range(4);
+ * // => [0, 1, 2, 3]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function range(start, end, step) {
+    let resolvedStart = toFinite(start);
+    let resolvedEnd = end;
+    let resolvedStep = step;
+    if (resolvedEnd === undefined) {
+        resolvedEnd = resolvedStart;
+        resolvedStart = 0;
+    }
+    else {
+        resolvedEnd = toFinite(resolvedEnd);
+    }
+    resolvedStep =
+        resolvedStep === undefined ? (resolvedStart < resolvedEnd ? 1 : -1) : toFinite(resolvedStep);
+    return (0, baseRange_1.default)(resolvedStart, resolvedEnd, resolvedStep, false);
+}

package/dist/cjs/util/size.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = size;
+const isArrayLike_1 = __importDefault(require("../_internal/isArrayLike"));
+/**
+ * 返回 collection 的长度；Map / Set 返回 size，对象返回自有可枚举键数量。
+ *
+ * @param collection - 待检查的集合
+ * @returns 集合长度
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.size([1, 2, 3]);
+ * // => 3
+ *
+ * zhiaiwanUtils.size({ a: 1, b: 2 });
+ * // => 2
+ *
+ * zhiaiwanUtils.size('abc');
+ * // => 3
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function size(collection) {
+    var _a;
+    if (collection == null) {
+        return 0;
+    }
+    if (typeof collection === 'string' || Array.isArray(collection)) {
+        return collection.length;
+    }
+    if ((0, isArrayLike_1.default)(collection)) {
+        return (_a = collection.length) !== null && _a !== void 0 ? _a : 0;
+    }
+    if (collection instanceof Map || collection instanceof Set) {
+        return collection.size;
+    }
+    if (typeof collection === 'object') {
+        return Object.keys(collection).length;
+    }
+    return 0;
+}

package/dist/cjs/util/sleep.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = sleep;
+/**
+ * 返回一个在 ms 毫秒后 resolve 的 Promise，用于异步等待。
+ *
+ * @param ms - 等待毫秒数
+ * @returns Promise
+ *
+ * @example
+ * ```ts
+ * await sleep(1000);
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}

package/dist/cjs/util/times.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 = times;
+const toInteger_1 = __importDefault(require("../_internal/toInteger"));
+const identity_1 = __importDefault(require("../_internal/identity"));
+const MAX_SAFE_INTEGER = 9007199254740991;
+const MAX_ARRAY_LENGTH = 4294967295;
+/**
+ * 调用 iteratee n 次并收集结果。
+ *
+ * @param n - 调用次数
+ * @param iteratee - 每次调用函数，接收 index
+ * @returns 结果数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.times(3, String);
+ * // => ['0', '1', '2']
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function times(n, iteratee = identity_1.default) {
+    const resolved = (0, toInteger_1.default)(n);
+    if (resolved < 1 || resolved > MAX_SAFE_INTEGER) {
+        return [];
+    }
+    const length = Math.min(resolved, MAX_ARRAY_LENGTH);
+    const result = new Array(length);
+    for (let index = 0; index < length; index++) {
+        result[index] = iteratee(index);
+    }
+    for (let index = MAX_ARRAY_LENGTH; index < resolved; index++) {
+        iteratee(index);
+    }
+    return result;
+}

package/dist/cjs/util/uniqueId.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = uniqueId;
+let idCounter = 0;
+/**
+ * 生成递增的唯一 ID 字符串，可选前缀 prefix。
+ *
+ * @param prefix - 可选前缀，null/undefined 视为空字符串
+ * @returns 唯一 ID 字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.uniqueId();
+ * // => '1'
+ *
+ * zhiaiwanUtils.uniqueId('contact_');
+ * // => 'contact_2'
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function uniqueId(prefix) {
+    const id = ++idCounter;
+    return `${prefix == null ? '' : String(prefix)}${id}`;
+}

package/dist/cjs/util/validateFields.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = validateFields;
+const validateFieldRule_1 = __importDefault(require("../_internal/validateFieldRule"));
+const toPath_1 = __importDefault(require("../_internal/toPath"));
+function getValueByPath(object, path) {
+    const keys = (0, toPath_1.default)(path);
+    let current = object;
+    for (const key of keys) {
+        if (current == null) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function normalizeRules(rule) {
+    return Array.isArray(rule) ? rule : [rule];
+}
+function buildResult(fieldErrors) {
+    const errorFields = Object.keys(fieldErrors);
+    if (errorFields.length === 0) {
+        return { valid: true, errors: {} };
+    }
+    const field = errorFields[0];
+    return {
+        valid: false,
+        errors: fieldErrors,
+        firstError: { field, message: fieldErrors[field][0] },
+    };
+}
+function collectFieldErrors(cells) {
+    const fieldErrors = {};
+    for (const cell of cells) {
+        if (cell.messages.length > 0) {
+            fieldErrors[cell.field] = cell.messages;
+        }
+    }
+    return fieldErrors;
+}
+/**
+ * 按规则对象校验表单/数据对象。rules 的 key 为字段路径（与 `get` 相同的路径写法），
+ * value 为单条规则或规则数组。自定义 `validator` 返回 `true` / `void` 表示通过，
+ * 返回 `false` 或非空字符串表示失败。
+ *
+ * @param values - 待校验的数据对象
+ * @param rules - 字段路径到规则的映射
+ * @param options - 可选配置
+ * @returns 校验结果；存在异步 validator 时返回 Promise
+ *
+ * @example
+ * ```ts
+ * validateFields(
+ *   { user: { name: '' }, password: 'abc', confirmPassword: '456' },
+ *   {
+ *     'user.name': { required: true, message: '请输入姓名' },
+ *     confirmPassword: {
+ *       validator: ({ value, values }) => {
+ *         if (value !== values.password) return '两次密码不一致';
+ *       },
+ *     },
+ *   },
+ * );
+ * // => { valid: false, errors: { 'user.name': ['请输入姓名'], ... } }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Util
+ */
+function validateFields(values, rules, options) {
+    var _a;
+    const data = values !== null && values !== void 0 ? values : {};
+    const fields = (_a = options === null || options === void 0 ? void 0 : options.fields) !== null && _a !== void 0 ? _a : Object.keys(rules);
+    const cells = [];
+    for (const field of fields) {
+        const fieldRules = rules[field];
+        if (!fieldRules) {
+            continue;
+        }
+        const value = getValueByPath(data, field);
+        const cell = { field, messages: [], promises: [] };
+        for (const rule of normalizeRules(fieldRules)) {
+            const ctx = { value, values: data, field, rule };
+            const outcome = (0, validateFieldRule_1.default)(ctx);
+            if (outcome instanceof Promise) {
+                cell.promises.push(outcome.then((error) => {
+                    if (error) {
+                        cell.messages.push(error);
+                    }
+                }));
+            }
+            else if (outcome) {
+                cell.messages.push(outcome);
+            }
+        }
+        cells.push(cell);
+    }
+    const asyncTasks = cells.flatMap((cell) => cell.promises);
+    if (asyncTasks.length > 0) {
+        return Promise.all(asyncTasks).then(() => buildResult(collectFieldErrors(cells)));
+    }
+    return buildResult(collectFieldErrors(cells));
+}

package/dist/cjs/verify/index.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isElement = exports.isObjectLike = exports.isArrayLike = exports.isMatchWith = exports.isMatch = exports.isFinite = exports.isNaN = exports.isEqualWith = exports.isEqual = exports.isError = exports.isWeakSet = exports.isWeakMap = exports.isSet = exports.isMap = exports.isEmpty = exports.isLength = exports.isSafeInteger = exports.isInteger = exports.isSymbol = exports.isRegExp = exports.isDate = exports.isNil = exports.isNull = exports.isUndefined = exports.isPlainObject = exports.isObject = exports.isNative = exports.isFunction = exports.isBuffer = exports.isTypedArray = exports.isArrayBuffer = exports.isArguments = exports.isArray = exports.isBoolean = exports.isNumber = exports.isString = void 0;
+var isString_1 = require("./isString");
+Object.defineProperty(exports, "isString", { enumerable: true, get: function () { return __importDefault(isString_1).default; } });
+var isNumber_1 = require("./isNumber");
+Object.defineProperty(exports, "isNumber", { enumerable: true, get: function () { return __importDefault(isNumber_1).default; } });
+var isBoolean_1 = require("./isBoolean");
+Object.defineProperty(exports, "isBoolean", { enumerable: true, get: function () { return __importDefault(isBoolean_1).default; } });
+var isArray_1 = require("./isArray");
+Object.defineProperty(exports, "isArray", { enumerable: true, get: function () { return __importDefault(isArray_1).default; } });
+var isArguments_1 = require("./isArguments");
+Object.defineProperty(exports, "isArguments", { enumerable: true, get: function () { return __importDefault(isArguments_1).default; } });
+var isArrayBuffer_1 = require("./isArrayBuffer");
+Object.defineProperty(exports, "isArrayBuffer", { enumerable: true, get: function () { return __importDefault(isArrayBuffer_1).default; } });
+var isTypedArray_1 = require("./isTypedArray");
+Object.defineProperty(exports, "isTypedArray", { enumerable: true, get: function () { return __importDefault(isTypedArray_1).default; } });
+var isBuffer_1 = require("./isBuffer");
+Object.defineProperty(exports, "isBuffer", { enumerable: true, get: function () { return __importDefault(isBuffer_1).default; } });
+var isFunction_1 = require("./isFunction");
+Object.defineProperty(exports, "isFunction", { enumerable: true, get: function () { return __importDefault(isFunction_1).default; } });
+var isNative_1 = require("./isNative");
+Object.defineProperty(exports, "isNative", { enumerable: true, get: function () { return __importDefault(isNative_1).default; } });
+var isObject_1 = require("./isObject");
+Object.defineProperty(exports, "isObject", { enumerable: true, get: function () { return __importDefault(isObject_1).default; } });
+var isPlainObject_1 = require("./isPlainObject");
+Object.defineProperty(exports, "isPlainObject", { enumerable: true, get: function () { return __importDefault(isPlainObject_1).default; } });
+var isUndefined_1 = require("./isUndefined");
+Object.defineProperty(exports, "isUndefined", { enumerable: true, get: function () { return __importDefault(isUndefined_1).default; } });
+var isNull_1 = require("./isNull");
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return __importDefault(isNull_1).default; } });
+var isNil_1 = require("./isNil");
+Object.defineProperty(exports, "isNil", { enumerable: true, get: function () { return __importDefault(isNil_1).default; } });
+var isDate_1 = require("./isDate");
+Object.defineProperty(exports, "isDate", { enumerable: true, get: function () { return __importDefault(isDate_1).default; } });
+var isRegExp_1 = require("./isRegExp");
+Object.defineProperty(exports, "isRegExp", { enumerable: true, get: function () { return __importDefault(isRegExp_1).default; } });
+var isSymbol_1 = require("./isSymbol");
+Object.defineProperty(exports, "isSymbol", { enumerable: true, get: function () { return __importDefault(isSymbol_1).default; } });
+var isInteger_1 = require("./isInteger");
+Object.defineProperty(exports, "isInteger", { enumerable: true, get: function () { return __importDefault(isInteger_1).default; } });
+var isSafeInteger_1 = require("./isSafeInteger");
+Object.defineProperty(exports, "isSafeInteger", { enumerable: true, get: function () { return __importDefault(isSafeInteger_1).default; } });
+var isLength_1 = require("./isLength");
+Object.defineProperty(exports, "isLength", { enumerable: true, get: function () { return __importDefault(isLength_1).default; } });
+var isEmpty_1 = require("./isEmpty");
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return __importDefault(isEmpty_1).default; } });
+var isMap_1 = require("./isMap");
+Object.defineProperty(exports, "isMap", { enumerable: true, get: function () { return __importDefault(isMap_1).default; } });
+var isSet_1 = require("./isSet");
+Object.defineProperty(exports, "isSet", { enumerable: true, get: function () { return __importDefault(isSet_1).default; } });
+var isWeakMap_1 = require("./isWeakMap");
+Object.defineProperty(exports, "isWeakMap", { enumerable: true, get: function () { return __importDefault(isWeakMap_1).default; } });
+var isWeakSet_1 = require("./isWeakSet");
+Object.defineProperty(exports, "isWeakSet", { enumerable: true, get: function () { return __importDefault(isWeakSet_1).default; } });
+var isError_1 = require("./isError");
+Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return __importDefault(isError_1).default; } });
+var isEqual_1 = require("./isEqual");
+Object.defineProperty(exports, "isEqual", { enumerable: true, get: function () { return __importDefault(isEqual_1).default; } });
+var isEqualWith_1 = require("./isEqualWith");
+Object.defineProperty(exports, "isEqualWith", { enumerable: true, get: function () { return __importDefault(isEqualWith_1).default; } });
+var isNaN_1 = require("./isNaN");
+Object.defineProperty(exports, "isNaN", { enumerable: true, get: function () { return __importDefault(isNaN_1).default; } });
+var isFinite_1 = require("./isFinite");
+Object.defineProperty(exports, "isFinite", { enumerable: true, get: function () { return __importDefault(isFinite_1).default; } });
+var isMatch_1 = require("./isMatch");
+Object.defineProperty(exports, "isMatch", { enumerable: true, get: function () { return __importDefault(isMatch_1).default; } });
+var isMatchWith_1 = require("./isMatchWith");
+Object.defineProperty(exports, "isMatchWith", { enumerable: true, get: function () { return __importDefault(isMatchWith_1).default; } });
+var isArrayLike_1 = require("./isArrayLike");
+Object.defineProperty(exports, "isArrayLike", { enumerable: true, get: function () { return __importDefault(isArrayLike_1).default; } });
+var isObjectLike_1 = require("./isObjectLike");
+Object.defineProperty(exports, "isObjectLike", { enumerable: true, get: function () { return __importDefault(isObjectLike_1).default; } });
+var isElement_1 = require("./isElement");
+Object.defineProperty(exports, "isElement", { enumerable: true, get: function () { return __importDefault(isElement_1).default; } });

package/dist/cjs/verify/isArguments.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 是否是 `arguments` 对象。
+ *
+ * @param value - 要检查的值
+ * @returns 如果 value 是 arguments 对象，返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * (function () {
+ *   return zhiaiwanUtils.isArguments(arguments);
+ * })();
+ * // => true
+ * ```
+ *
+ * @since 1.0.0
+ * @category Verify
+ */
+var isArguments_1 = require("../_internal/isArguments");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(isArguments_1).default; } });

package/dist/cjs/verify/isArray.js

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

package/dist/cjs/verify/isArrayBuffer.js

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

package/dist/cjs/verify/isArrayLike.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 = isArrayLike;
+const isArrayLike_1 = __importDefault(require("../_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
+ */
+function isArrayLike(value) {
+    return (0, isArrayLike_1.default)(value);
+}

package/dist/cjs/verify/isBoolean.js

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

package/dist/cjs/verify/isBuffer.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isBuffer;
+/**
+ * 检查 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
+ */
+function isBuffer(value) {
+    const bufferCtor = globalThis.Buffer;
+    return typeof bufferCtor !== 'undefined' && bufferCtor.isBuffer(value);
+}

package/dist/cjs/verify/isDate.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isDate;
+/**
+ * 检查 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
+ */
+function isDate(value) {
+    return Object.prototype.toString.call(value) === '[object Date]';
+}

package/dist/cjs/verify/isElement.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 = isElement;
+const isObjectLike_1 = __importDefault(require("./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
+ */
+function isElement(value) {
+    return (0, isObjectLike_1.default)(value) && value.nodeType === 1;
+}