pen-it 1.0.6 → 1.0.8

package/dist/index.cjs

@@ -4,11 +4,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 * 判断一个值是否为数组
 * @param value - 要判断的值
 * @returns 如果是数组返回 true，否则返回 false
-* @example
-* isArray([1, 2, 3])
-* // => true
-* isArray("hello")
-* // => false
 */
 const isArray = (value) => {
 	return Array.isArray(value);
@@ -17,11 +12,6 @@ const isArray = (value) => {
 * 判断一个值是否为对象（但不是数组）
 * @param value - 要判断的值
 * @returns 如果是对象且不是数组返回 true，否则返回 false
-* @example
-* isObject({ a: 1 })
-* // => true
-* isObject([1, 2])
-* // => false
 */
 const isObject = (value) => {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -31,9 +21,6 @@ const isObject = (value) => {
 * @param val - 要判断的数据
 * @param type - 数据类型字符串，如 "Array"、"Function"
 * @returns 如果数据是指定类型返回 true
-* @example
-* is([], "Array")
-* // => true
 */
 const is = (val, type) => {
 	return Object.prototype.toString.call(val) === `[object ${type}]`;
@@ -42,9 +29,6 @@ const is = (val, type) => {
 * 判断一个值是否为函数
 * @param val - 要判断的数据
 * @returns 如果是函数返回 true
-* @example
-* isFunction(() => {})
-* // => true
 */
 const isFunction = (val) => {
 	return is(val, "Function") || !!(val && val.constructor && val.call && val.apply);
@@ -53,9 +37,6 @@ const isFunction = (val) => {
 * 判断一个值是否为 Date 对象
 * @param val - 要判断的数据
 * @returns 如果是 Date 对象返回 true
-* @example
-* isDate(new Date())
-* // => true
 */
 const isDate = (val) => {
 	return is(val, "Date") || !!val && val.constructor === Date;
@@ -64,11 +45,6 @@ const isDate = (val) => {
 * 判断一个值是否为数字（NaN 和 Infinity 也视为数字）
 * @param val - 要判断的数据
 * @returns 如果是数字返回 true
-* @example
-* isNumber(42)
-* // => true
-* isNumber("42")
-* // => false
 */
 const isNumber = (val) => {
 	return Number(val) === val;
@@ -77,11 +53,6 @@ const isNumber = (val) => {
 * 判断一个值是否为整数
 * @param val - 要判断的数据
 * @returns 如果是整数返回 true
-* @example
-* isInt(42)
-* // => true
-* isInt(3.14)
-* // => false
 */
 const isInt = (val) => {
 	return isNumber(val) && Number.isFinite(val) && val % 1 === 0;
@@ -90,11 +61,6 @@ const isInt = (val) => {
 * 判断一个值是否为浮点数（有限小数）
 * @param val - 要判断的数据
 * @returns 如果是浮点数返回 true
-* @example
-* isFloat(3.14)
-* // => true
-* isFloat(42)
-* // => false
 */
 const isFloat = (val) => {
 	return isNumber(val) && Number.isFinite(val) && val % 1 !== 0;
@@ -103,9 +69,6 @@ const isFloat = (val) => {
 * 判断一个值是否为异步函数
 * @param val - 要判断的数据
 * @returns 如果是异步函数返回 true
-* @example
-* isAsyncFunction(async () => {})
-* // => true
 */
 const isAsyncFunction = (val) => {
 	return is(val, "AsyncFunction");
@@ -114,9 +77,6 @@ const isAsyncFunction = (val) => {
 * 判断一个值是否为 Promise
 * @param value - 要判断的数据
 * @returns 如果是 Promise 返回 true
-* @example
-* isPromise(Promise.resolve())
-* // => true
 */
 const isPromise = (value) => {
 	if (!value) return false;
@@ -128,11 +88,6 @@ const isPromise = (value) => {
 * 判断一个值是否为字符串
 * @param val - 要判断的数据
 * @returns 如果是字符串返回 true
-* @example
-* isString("hello")
-* // => true
-* isString(42)
-* // => false
 */
 const isString = (val) => {
 	return is(val, "String") || typeof val === "string" || val instanceof String;
@@ -141,11 +96,6 @@ const isString = (val) => {
 * 判断一个值是否为布尔值
 * @param val - 要判断的数据
 * @returns 如果是布尔值返回 true
-* @example
-* isBoolean(true)
-* // => true
-* isBoolean(1)
-* // => false
 */
 const isBoolean = (val) => {
 	return typeof val === "boolean" || is(val, "Boolean");
@@ -153,9 +103,6 @@ const isBoolean = (val) => {
 /**
 * 判断是否为 PC 端（浏览器环境）
 * @returns 如果在浏览器环境中返回 true
-* @example
-* isPC()
-* // => true（在浏览器中）
 */
 const isPC = () => {
 	return typeof window !== "undefined";
@@ -164,9 +111,6 @@ const isPC = () => {
 * 判断一个值是否为 window 对象
 * @param val - 要判断的数据
 * @returns 如果是 window 对象返回 true
-* @example
-* isWindow(window)
-* // => true（在浏览器中）
 */
 const isWindow = (val) => {
 	return typeof window !== "undefined" && is(val, "Window");
@@ -175,9 +119,6 @@ const isWindow = (val) => {
 * 判断一个值是否为 DOM 元素
 * @param val - 要判断的数据
 * @returns 如果是 DOM 元素返回 true
-* @example
-* isElement(document.body)
-* // => true
 */
 const isElement = (val) => {
 	return isObject(val) && !!val.tagName;
@@ -186,9 +127,6 @@ const isElement = (val) => {
 * 判断一个值是否为 null
 * @param val - 要判断的数据
 * @returns 如果是 null 返回 true
-* @example
-* isNull(null)
-* // => true
 */
 const isNull = (val) => {
 	return val === null;
@@ -197,11 +135,6 @@ const isNull = (val) => {
 * 判断一个值是否为十六进制颜色
 * @param str - 要判断的字符串
 * @returns 如果是有效的十六进制颜色值返回 true
-* @example
-* isHexColor("#fff")
-* // => true
-* isHexColor("#ff0000")
-* // => true
 */
 const isHexColor = (str) => {
 	return /^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(str);
@@ -209,9 +142,6 @@ const isHexColor = (str) => {
 /**
 * 判断设备是否为 iOS
 * @returns 如果是 iOS 设备返回 true
-* @example
-* isIOS()
-* // => true（在 iPhone/iPad 上）
 */
 const isIOS = () => {
 	return /iPad|iPhone|iPod/.test(navigator.userAgent);
@@ -220,9 +150,6 @@ const isIOS = () => {
 * 判断一个值是否为有效的电子邮件
 * @param email - 要判断的字符串
 * @returns 如果是有效的电子邮件地址返回 true
-* @example
-* isValidEmail("test@example.com")
-* // => true
 */
 const isValidEmail = (email) => {
 	return /^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(email);
@@ -231,11 +158,6 @@ const isValidEmail = (email) => {
 * 判断一个值是否已定义（不是 undefined）
 * @param val - 要判断的数据
 * @returns 如果不是 undefined 返回 true
-* @example
-* isDef("hello")
-* // => true
-* isDef(undefined)
-* // => false
 */
 const isDef = (val) => {
 	return typeof val !== "undefined";
@@ -244,9 +166,6 @@ const isDef = (val) => {
 * 判断一个值是否为 undefined
 * @param val - 要判断的数据
 * @returns 如果是 undefined 返回 true
-* @example
-* isUnDef(undefined)
-* // => true
 */
 const isUnDef = (val) => {
 	return typeof val === "undefined";
@@ -255,13 +174,6 @@ const isUnDef = (val) => {
 * 判断一个值是否为 null 或 undefined
 * @param val - 要判断的数据
 * @returns 如果是 null 或 undefined 返回 true
-* @example
-* isNullOrUnDef(null)
-* // => true
-* isNullOrUnDef(undefined)
-* // => true
-* isNullOrUnDef("hello")
-* // => false
 */
 const isNullOrUnDef = (val) => {
 	return isUnDef(val) || isNull(val);
@@ -270,9 +182,6 @@ const isNullOrUnDef = (val) => {
 * 判断一个值是否为 symbol
 * @param value - 要判断的数据
 * @returns 如果是 symbol 返回 true
-* @example
-* isSymbol(Symbol("foo"))
-* // => true
 */
 const isSymbol = (value) => {
 	return !!value && value.constructor === Symbol;
@@ -282,11 +191,6 @@ const isSymbol = (value) => {
 * 原始类型包括：number、string、boolean、symbol、bigint、undefined、null
 * @param value - 要判断的值
 * @returns 如果是原始类型返回 true
-* @example
-* isPrimitive(42)
-* // => true
-* isPrimitive({})
-* // => false
 */
 const isPrimitive = (value) => {
 	return value === void 0 || value === null || typeof value !== "object" && typeof value !== "function";
@@ -296,13 +200,6 @@ const isPrimitive = (value) => {
 * 空值包括：null、undefined、空字符串、空数组、空对象、空 Map/Set、无效 Date
 * @param value - 要判断的数据
 * @returns 如果为空返回 true
-* @example
-* isEmpty("")
-* // => true
-* isEmpty([])
-* // => true
-* isEmpty(0)
-* // => false
 */
 const isEmpty = (value) => {
 	if (value === null || value === void 0) return true;
@@ -320,19 +217,6 @@ const isEmpty = (value) => {
 * 支持：字符串、数组、对象、Map、Set、类型化数组
 * @param value - 要检查的值
 * @returns 如果为空返回 true
-* @example
-* isEmptySv("")
-* // => true
-* isEmptySv(null)
-* // => true
-* isEmptySv([])
-* // => true
-* isEmptySv({})
-* // => true
-* isEmptySv(new Set())
-* // => true
-* isEmptySv(new Map())
-* // => true
 */
 function isEmptySv(value) {
 	if (value === null || value === void 0) return true;
@@ -347,11 +231,6 @@ function isEmptySv(value) {
 * @param x - 要比较的第一个值
 * @param y - 要比较的第二个值
 * @returns 如果值深度相等返回 true
-* @example
-* isEqual({ a: 1 }, { a: 1 })
-* // => true
-* isEqual({ a: 1 }, { a: 2 })
-* // => false
 */
 const isEqual = (x, y) => {
 	if (Object.is(x, y)) return true;
@@ -373,9 +252,6 @@ const isEqual = (x, y) => {
 * 完整日期时间（年/月/日 时分秒）_ 斜杠
 * @param date - Date 对象
 * @returns 格式化后的完整日期时间字符串，如 "2026/06/03 14:30:45"
-* @example
-* formatFull(new Date("2026-06-03T14:30:45"))
-* // => "2026/06/03 14:30:45"
 */
 const formatFull = (date) => {
 	return new Intl.DateTimeFormat("zh-CN", {
@@ -392,9 +268,6 @@ const formatFull = (date) => {
 * 完整日期时间（年-月-日 时分秒）_ 短横线
 * @param date - Date 对象
 * @returns 格式化后的完整日期时间字符串，如 "2026-06-03 14:30:45"
-* @example
-* formatFullReplace(new Date("2026-06-03T14:30:45"))
-* // => "2026-06-03 14:30:45"
 */
 const formatFullReplace = (date) => {
 	return formatFull(date).replace(/\//g, "-");
@@ -403,9 +276,6 @@ const formatFullReplace = (date) => {
 * 中文年月日
 * @param date - Date 对象
 * @returns 格式化后的中文日期字符串，如 "2026年6月3日"
-* @example
-* formatYMD(new Date("2026-06-03"))
-* // => "2026年6月3日"
 */
 const formatYMD = (date) => {
 	return new Intl.DateTimeFormat("zh-CN", {
@@ -418,9 +288,6 @@ const formatYMD = (date) => {
 * 星期几
 * @param date - Date 对象
 * @returns 中文星期字符串，如 "星期三"
-* @example
-* formatWeek(new Date("2026-06-03"))
-* // => "星期三"
 */
 const formatWeek = (date) => {
 	return new Intl.DateTimeFormat("zh-CN", { weekday: "long" }).format(date);
@@ -430,9 +297,6 @@ const formatWeek = (date) => {
 * @param value - 数值
 * @param options - 格式化选项
 * @returns 格式化后的货币字符串
-* @example
-* formatRmb(1234.56, { type: "zh-CN", currency: "CNY" })
-* // => "¥1,234.56"
 */
 const formatRmb = (value, options) => {
 	return new Intl.NumberFormat(options.type, {
@@ -444,9 +308,6 @@ const formatRmb = (value, options) => {
 * 千位分隔符（数字格式化），中文（逗号分隔）
 * @param value - 数值
 * @returns 格式化后的千位分隔数字字符串
-* @example
-* formatNum(1234567)
-* // => "1,234,567"
 */
 const formatNum = (value) => {
 	return new Intl.NumberFormat("zh-CN").format(value);
@@ -456,9 +317,6 @@ const formatNum = (value) => {
 * @param value - 百分比数值
 * @param digit - 保留的小数位数，默认为 0
 * @returns 格式化后的百分比字符串
-* @example
-* percentCN(0.1234, 2)
-* // => "12.34%"
 */
 const percentCN = (value, digit = 0) => {
 	return new Intl.NumberFormat("zh-CN", {
@@ -470,9 +328,6 @@ const percentCN = (value, digit = 0) => {
 * 紧凑计数法（大数简化）_ 英文缩写
 * @param value - 数值
 * @returns 格式化后的紧凑数字字符串（英文缩写）
-* @example
-* compactEN(12345)
-* // => "12K"
 */
 const compactEN = (value) => {
 	return new Intl.NumberFormat("en-US", {
@@ -484,9 +339,6 @@ const compactEN = (value) => {
 * 紧凑计数法（大数简化）_ 中文缩写
 * @param value - 数值
 * @returns 格式化后的紧凑数字字符串（中文缩写）
-* @example
-* compactCN(12345)
-* // => "1.2万"
 */
 const compactCN = (value) => {
 	return new Intl.NumberFormat("zh-CN", {
@@ -499,12 +351,6 @@ const compactCN = (value) => {
 * @param value - 数值
 * @param digit - 保留的小数位数，默认为 0
 * @returns 格式化后的带正负号的数值显示
-* @example
-* signed(42, 1)
-* // => "+42.0"
-* @example
-* signed(-5)
-* // => "-5"
 */
 const signed = (value, digit = 0) => {
 	return new Intl.NumberFormat("en-US", {
@@ -516,9 +362,6 @@ const signed = (value, digit = 0) => {
 * 手机号格式化脱敏 _ 隐藏中间 4 位数
 * @param phone - 手机号码
 * @returns 手机号格式化脱敏后的手机号
-* @example
-* maskPhone("13812345678")
-* // => "138****5678"
 */
 const maskPhone = (phone) => {
 	return phone.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2");
@@ -527,9 +370,6 @@ const maskPhone = (phone) => {
 * 手机号格式化 _ 空格分隔
 * @param phone - 手机号
 * @returns 手机号空格格式化的手机号
-* @example
-* spacePhone("13812345678")
-* // => "138 1234 5678"
 */
 const spacePhone = (phone) => {
 	return phone.replace(/(\d{3})(\d{4})(\d{4})/, "$1 $2 $3");
@@ -538,9 +378,6 @@ const spacePhone = (phone) => {
 * 每个单词首字母大写
 * @param str - 字符串
 * @returns 每个单词首字母大写后的字符串
-* @example
-* capitalize("hello world")
-* // => "Hello World"
 */
 const capitalize = (str) => {
 	return str.replace(/\b\w/g, (char) => char.toUpperCase());
@@ -549,9 +386,6 @@ const capitalize = (str) => {
 * 短横线连接转小驼峰（kebab-case → camelCase）
 * @param str - 字符串
 * @returns 转换后的小驼峰字符串
-* @example
-* kebabToCamel("hello-world")
-* // => "helloWorld"
 */
 const kebabToCamel = (str) => {
 	return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
@@ -560,9 +394,6 @@ const kebabToCamel = (str) => {
 * 大驼峰或小驼峰 _ 转为 ‘-’ 短横线连接
 * @param str - 字符串
 * @returns 大驼峰或小驼峰命名格式化的字符串
-* @example
-* camelToKebab("helloWorld")
-* // => "hello-world"
 */
 const camelToKebab = (str) => {
 	return str.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -573,9 +404,6 @@ const camelToKebab = (str) => {
 * @param maxLength - 截断位置
 * @param suffix - 自定义的替换截断后的内容
 * @returns 超长文本截断后内容
-* @example
-* truncate("Hello World", 8)
-* // => "Hello..."
 */
 const truncate = (str, maxLength, suffix = "...") => {
 	if (str.length <= maxLength) return str;
@@ -587,9 +415,6 @@ const truncate = (str, maxLength, suffix = "...") => {
 * @param maxWords - 截断位置
 * @param suffix - 自定义的替换截断后的内容
 * @returns 超长文本截断后内容
-* @example
-* truncateByWords("你好世界欢迎你", 4)
-* // => "你好世界..."
 */
 const truncateByWords = (str, maxWords, suffix = "...") => {
 	const chars = str.split("");
@@ -600,18 +425,12 @@ const truncateByWords = (str, maxWords, suffix = "...") => {
 * 去除所有空格 _ 前后中间
 * @param str - 内容
 * @returns 去除空格后的内容
-* @example
-* trimAll(" hello  world ")
-* // => "helloworld"
 */
 const trimAll = (str) => str.replace(/\s+/g, "");
 /**
 * 下划线转驼峰（snake_case → camelCase）
 * @param str - 字符串
 * @returns 转换后的驼峰字符串
-* @example
-* toCamel("hello_world")
-* // => "helloWorld"
 */
 const toCamel = (str) => {
 	return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
@@ -620,9 +439,6 @@ const toCamel = (str) => {
 * 首字母大写
 * @param str - 字符串
 * @returns 首字母大写后的字符串
-* @example
-* firstUpper("hello")
-* // => "Hello"
 */
 const firstUpper = (str) => {
 	return str.charAt(0).toUpperCase() + str.slice(1);
@@ -631,9 +447,6 @@ const firstUpper = (str) => {
 * 首字母小写
 * @param str - 字符串
 * @returns 首字母小写后的字符串
-* @example
-* firstLower("Hello")
-* // => "hello"
 */
 const firstLower = (str) => {
 	return str.charAt(0).toLowerCase() + str.slice(1);
@@ -642,9 +455,6 @@ const firstLower = (str) => {
 * 反转字符串
 * @param str - 字符串
 * @returns 反转后的字符串
-* @example
-* reverse("hello")
-* // => "olleh"
 */
 const reverse = (str) => {
 	return str.split("").reverse().join("");
@@ -655,9 +465,6 @@ const reverse = (str) => {
 * 获取 localStorage
 * @param key - 存储键名
 * @returns 解析后的值，解析失败则返回原始字符串，键不存在返回 null
-* @example
-* localGet("user")
-* // => { name: "张三" }
 */
 const localGet = (key) => {
 	const value = localStorage.getItem(key);
@@ -672,8 +479,6 @@ const localGet = (key) => {
 * 设置 localStorage
 * @param key - 存储键名
 * @param value - 存储值（会自动 JSON 序列化）
-* @example
-* localSet("user", { name: "张三" })
 */
 const localSet = (key, value) => {
 	localStorage.setItem(key, JSON.stringify(value));
@@ -681,16 +486,12 @@ const localSet = (key, value) => {
 /**
 * 移除指定 localStorage
 * @param key - 存储键名
-* @example
-* localRm("user")
 */
 const localRm = (key) => {
 	localStorage.removeItem(key);
 };
 /**
 * 清除所有 localStorage
-* @example
-* localClear()
 */
 const localClear = () => {
 	localStorage.clear();
@@ -703,11 +504,6 @@ const localClear = () => {
 * @param obj - 要拷贝的值
 * @param hash - 内部 WeakMap 用于处理循环引用，调用方无需传入
 * @returns 深拷贝后的值
-* @example
-* const obj = { a: 1, b: { c: 2 }, d: new Date() };
-* const cloned = deepClone(obj);
-* // cloned.b !== obj.b
-* // cloned.d !== obj.d
 */
 function deepClone(obj, hash = /* @__PURE__ */ new WeakMap()) {
 	if (obj === null || typeof obj !== "object") return obj;
@@ -751,9 +547,6 @@ function deepClone(obj, hash = /* @__PURE__ */ new WeakMap()) {
 * （不支持函数、undefined、Date、RegExp、Map、Set 等）
 * @param obj - 要拷贝的 JSON 安全值
 * @returns 深拷贝后的值
-* @example
-* deepCloneWithJSON({ a: 1, b: [2, 3] })
-* // => { a: 1, b: [2, 3] }
 */
 function deepCloneWithJSON(obj) {
 	return JSON.parse(JSON.stringify(obj));
@@ -763,10 +556,6 @@ function deepCloneWithJSON(obj) {
 * 仅拷贝第一层属性，嵌套对象仍共享引用
 * @param obj - 要拷贝的对象或数组
 * @returns 浅拷贝后的值
-* @example
-* const obj = { a: 1, b: { c: 2 } };
-* const cloned = shallowClone(obj);
-* // cloned.b === obj.b（共享引用）
 */
 function shallowClone(obj) {
 	if (obj === null || typeof obj !== "object") return obj;
@@ -779,9 +568,6 @@ function shallowClone(obj) {
 * Set 去重
 * @param arr - 数组
 * @returns 去重后的数组
-* @example
-* unique([1, 2, 2, 3])
-* // => [1, 2, 3]
 */
 const unique = (arr) => {
 	return [...new Set(arr)];
@@ -791,9 +577,6 @@ const unique = (arr) => {
 * @param arr - 对象数组
 * @param key - 用于去重判定的键名
 * @returns 去重后的数组
-* @example
-* uniqueByKey([{ id: 1, name: "a" }, { id: 1, name: "b" }], "id")
-* // => [{ id: 1, name: "a" }]
 */
 const uniqueByKey = (arr, key) => {
 	return [...new Map(arr.map((item) => [item[key], item])).values()];
@@ -802,9 +585,6 @@ const uniqueByKey = (arr, key) => {
 * 数值升序
 * @param arr - 数值数组
 * @returns 升序排序后的新数组
-* @example
-* sortNumAsc([3, 1, 2])
-* // => [1, 2, 3]
 */
 const sortNumAsc = (arr) => {
 	return [...arr].sort((a, b) => a - b);
@@ -813,9 +593,6 @@ const sortNumAsc = (arr) => {
 * 数值降序
 * @param arr - 数值数组
 * @returns 降序排序后的新数组
-* @example
-* sortNumDesc([1, 3, 2])
-* // => [3, 2, 1]
 */
 const sortNumDesc = (arr) => {
 	return [...arr].sort((a, b) => b - a);
@@ -826,9 +603,6 @@ const sortNumDesc = (arr) => {
 * @param key - 用于排序的属性名
 * @param order - 排序方向，"asc" 升序 / "desc" 降序，默认 "asc"
 * @returns 排序后的新数组
-* @example
-* sortByKey([{ age: 30 }, { age: 20 }], "age", "asc")
-* // => [{ age: 20 }, { age: 30 }]
 */
 const sortByKey = (arr, key, order = "asc") => {
 	return [...arr].sort((a, b) => order === "asc" ? a[key] - b[key] : b[key] - a[key]);
@@ -837,9 +611,6 @@ const sortByKey = (arr, key, order = "asc") => {
 * 类数组转数组
 * @param arrayLike - 类数组对象（如 NodeList、arguments）
 * @returns 转换后的数组
-* @example
-* toArray(document.querySelectorAll("div"))
-* // => [div, div, ...]
 */
 const toArray = (arrayLike) => {
 	return Array.from(arrayLike);
@@ -848,9 +619,6 @@ const toArray = (arrayLike) => {
 * 合并多个数组
 * @param arrays - 一个或多个数组
 * @returns 合并后的新数组
-* @example
-* mergeArrays([1, 2], [3, 4], [5])
-* // => [1, 2, 3, 4, 5]
 */
 const mergeArrays = (...arrays) => {
 	return [].concat(...arrays);
@@ -860,12 +628,6 @@ const mergeArrays = (...arrays) => {
 * @param arr - 多维数组
 * @param depth - 扁平化深度，默认 1（仅展开一层）。传 Infinity 可完全扁平化为一维
 * @returns 扁平化后的数组
-* @example
-* flatten([1, [2, [3, 4]], 5])
-* // => [1, 2, [3, 4], 5]
-* @example
-* flatten([1, [2, [3, 4]], 5], Infinity)
-* // => [1, 2, 3, 4, 5]
 */
 const flatten = (arr, depth = 1) => {
 	return arr.flat(depth);
@@ -876,9 +638,6 @@ const flatten = (arr, depth = 1) => {
 * @param key - 要匹配的键名
 * @param value - 要匹配的键值
 * @returns 第一个匹配的对象，无匹配则返回 undefined
-* @example
-* arrFind([{ id: 1, name: "a" }, { id: 2, name: "b" }], "id", 2)
-* // => { id: 2, name: "b" }
 */
 const arrFind = (arr, key, value) => {
 	return arr.find((item) => item[key] === value);
@@ -888,9 +647,6 @@ const arrFind = (arr, key, value) => {
 * @param arr - 对象数组
 * @param key - 用于分组的属性名
 * @returns 以属性值为键、对应数组为值的对象
-* @example
-* groupBy([{ type: "fruit", name: "apple" }, { type: "vegetable", name: "carrot" }], "type")
-* // => { fruit: [{ type: "fruit", name: "apple" }], vegetable: [{ type: "vegetable", name: "carrot" }] }
 */
 const groupBy = (arr, key) => {
 	return arr.reduce((acc, item) => {
@@ -904,9 +660,6 @@ const groupBy = (arr, key) => {
 * 移除对象中值为空（null / undefined / 空字符串）的属性
 * @param obj - 待过滤的对象
 * @returns 过滤后的新对象
-* @example
-* filterEmptyValues({ a: 1, b: "", c: null, d: 3 })
-* // => { a: 1, d: 3 }
 */
 const filterEmptyValues = (obj) => {
 	return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== null && v !== void 0 && v !== ""));
@@ -916,9 +669,6 @@ const filterEmptyValues = (obj) => {
 * @param length - 数组长度
 * @param mapFn - 映射函数，接收索引返回元素值，默认为返回索引
 * @returns 生成的数组
-* @example
-* createRange(5)
-* // => [0, 1, 2, 3, 4]
 */
 const createRange = (length, mapFn) => {
 	return Array.from({ length }, (_, i) => mapFn ? mapFn(i) : i);
@@ -930,8 +680,6 @@ const createRange = (length, mapFn) => {
 * @param name - Cookie 名称
 * @param value - Cookie 值
 * @param days - 有效天数，默认 7 天
-* @example
-* setCookie("token", "abc123", 30)
 */
 const setCookie = (name, value, days = 0) => {
 	const expires = /* @__PURE__ */ new Date();
@@ -942,9 +690,6 @@ const setCookie = (name, value, days = 0) => {
 * 获取 Cookie
 * @param name - Cookie 名称
 * @returns Cookie 值，不存在则返回 null
-* @example
-* getCookie("token")
-* // => "abc123"
 */
 const getCookie = (name) => {
 	const match = document.cookie.match(new RegExp("(^| )" + encodeURIComponent(name) + "=([^;]+)"));
@@ -953,8 +698,6 @@ const getCookie = (name) => {
 /**
 * 删除 Cookie
 * @param name - Cookie 名称
-* @example
-* delCookie("token")
 */
 const delCookie = (name) => {
 	setCookie(name, "", -1);
@@ -965,9 +708,6 @@ const delCookie = (name) => {
 * 获取 URL 参数对象
 * @param url - URL 字符串，默认使用当前页面地址
 * @returns 参数键值对对象
-* @example
-* getUrlParams("https://example.com?a=1&b=2")
-* // => { a: "1", b: "2" }
 */
 const getUrlParams = (url) => {
 	const params = {};
@@ -981,9 +721,6 @@ const getUrlParams = (url) => {
 * @param key - 参数名
 * @param url - URL 字符串，默认使用当前页面地址
 * @returns 参数值，不存在则返回 null
-* @example
-* getUrlParam("a", "https://example.com?a=1")
-* // => "1"
 */
 const getUrlParam = (key, url) => {
 	return new URL(url || window.location.href).searchParams.get(key);
@@ -992,9 +729,6 @@ const getUrlParam = (key, url) => {
 * 对象转 URL 参数字符串
 * @param params - 参数键值对对象，值为 null/undefined 的项会被过滤
 * @returns URL 参数字符串（不含 ? 前缀）
-* @example
-* toQueryString({ a: 1, b: "hello", c: null })
-* // => "a=1&b=hello"
 */
 const toQueryString = (params) => {
 	return Object.entries(params).filter(([, v]) => v !== void 0 && v !== null).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&");
@@ -1004,9 +738,6 @@ const toQueryString = (params) => {
 * 优先使用 Clipboard API，失败时降级为 execCommand
 * @param text - 要复制的文本
 * @returns 复制成功返回 true，失败返回 false
-* @example
-* await copyToClipboard("Hello World")
-* // => true
 */
 const copyToClipboard = async (text) => {
 	if (navigator.clipboard) try {
@@ -1030,8 +761,6 @@ const copyToClipboard = async (text) => {
 * @param content - 文件内容
 * @param filename - 文件名
 * @param mimeType - MIME 类型，默认 "text/plain"
-* @example
-* downloadFile("Hello", "hello.txt")
 */
 const downloadFile = (content, filename, mimeType = "text/plain") => {
 	const blob = new Blob([content], { type: mimeType });
@@ -1046,8 +775,6 @@ const downloadFile = (content, filename, mimeType = "text/plain") => {
 * 导出 JSON 为文件
 * @param data - 要导出的数据
 * @param filename - 文件名，默认 "data.json"
-* @example
-* exportJSON({ name: "张三", age: 30 })
 */
 const exportJSON = (data, filename = "data.json") => {
 	downloadFile(JSON.stringify(data, null, 2), filename, "application/json");
@@ -1055,8 +782,6 @@ const exportJSON = (data, filename = "data.json") => {
 /**
 * 滚动到顶部
 * @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
-* @example
-* scrollToTop()
 */
 const scrollToTop = (behavior = "smooth") => {
 	window.scrollTo({
@@ -1067,8 +792,6 @@ const scrollToTop = (behavior = "smooth") => {
 /**
 * 滚动到底部
 * @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
-* @example
-* scrollToBottom()
 */
 const scrollToBottom = (behavior = "smooth") => {
 	window.scrollTo({
@@ -1080,9 +803,6 @@ const scrollToBottom = (behavior = "smooth") => {
 * 监听页面滚动（requestAnimationFrame 节流）
 * @param callback - 滚动回调，接收当前 scrollY 值
 * @returns 清理函数，调用后移除事件监听
-* @example
-* const cleanup = onScroll((y) => console.log(y));
-* cleanup(); // 停止监听
 */
 const onScroll = (callback) => {
 	let ticking = false;
@@ -1105,12 +825,6 @@ const onScroll = (callback) => {
 * @param onLeave - 元素离开可视区域时的回调（可选）
 * @param options - IntersectionObserver 配置项
 * @returns 清理函数，调用后停止观察
-* @example
-* const cleanup = observeIntersection(
-*   document.querySelector(".footer")!,
-*   () => loadMore(10),
-* );
-* cleanup(); // 停止观察
 */
 const observeIntersection = (target, onEnter, onLeave, options) => {
 	const observer = new IntersectionObserver((entries) => {
@@ -1131,10 +845,6 @@ const observeIntersection = (target, onEnter, onLeave, options) => {
 * @param options.leading - 首次调用是否立即执行，默认 false
 * @param options.trailing - 停止调用后是否延迟执行，默认 true
 * @returns 防抖后的函数，附带 cancel 方法
-* @example
-* const fn = debounce((val: string) => console.log(val), 500)
-* fn("a"); fn("b"); fn("c")
-* // => "c"
 */
 const debounce = (fn, delay = 300, { leading = false, trailing = true } = {}) => {
 	let timer = null;
@@ -1171,10 +881,6 @@ const debounce = (fn, delay = 300, { leading = false, trailing = true } = {}) =>
 * @param options.leading - 首次调用是否立即执行，默认 true
 * @param options.trailing - 最后一次调用后是否尾部执行，默认 true
 * @returns 节流后的函数，附带 cancel 方法
-* @example
-* const fn = throttle((val: string) => console.log(val), 500)
-* fn("a"); fn("b"); fn("c")
-* // => "a"，500ms 后输出 "c"
 */
 const throttle = (fn, interval = 300, { leading = true, trailing = true } = {}) => {
 	let timer = null;