pen-it 1.0.6 → 1.0.8

package/dist/index.js

@@ -3,11 +3,6 @@
 * 判断一个值是否为数组
 * @param value - 要判断的值
 * @returns 如果是数组返回 true，否则返回 false
-* @example
-* isArray([1, 2, 3])
-* // => true
-* isArray("hello")
-* // => false
 */
 const isArray = (value) => {
 	return Array.isArray(value);
@@ -16,11 +11,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);
@@ -30,9 +20,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}]`;
@@ -41,9 +28,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);
@@ -52,9 +36,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;
@@ -63,11 +44,6 @@ const isDate = (val) => {
 * 判断一个值是否为数字（NaN 和 Infinity 也视为数字）
 * @param val - 要判断的数据
 * @returns 如果是数字返回 true
-* @example
-* isNumber(42)
-* // => true
-* isNumber("42")
-* // => false
 */
 const isNumber = (val) => {
 	return Number(val) === val;
@@ -76,11 +52,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;
@@ -89,11 +60,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;
@@ -102,9 +68,6 @@ const isFloat = (val) => {
 * 判断一个值是否为异步函数
 * @param val - 要判断的数据
 * @returns 如果是异步函数返回 true
-* @example
-* isAsyncFunction(async () => {})
-* // => true
 */
 const isAsyncFunction = (val) => {
 	return is(val, "AsyncFunction");
@@ -113,9 +76,6 @@ const isAsyncFunction = (val) => {
 * 判断一个值是否为 Promise
 * @param value - 要判断的数据
 * @returns 如果是 Promise 返回 true
-* @example
-* isPromise(Promise.resolve())
-* // => true
 */
 const isPromise = (value) => {
 	if (!value) return false;
@@ -127,11 +87,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;
@@ -140,11 +95,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");
@@ -152,9 +102,6 @@ const isBoolean = (val) => {
 /**
 * 判断是否为 PC 端（浏览器环境）
 * @returns 如果在浏览器环境中返回 true
-* @example
-* isPC()
-* // => true（在浏览器中）
 */
 const isPC = () => {
 	return typeof window !== "undefined";
@@ -163,9 +110,6 @@ const isPC = () => {
 * 判断一个值是否为 window 对象
 * @param val - 要判断的数据
 * @returns 如果是 window 对象返回 true
-* @example
-* isWindow(window)
-* // => true（在浏览器中）
 */
 const isWindow = (val) => {
 	return typeof window !== "undefined" && is(val, "Window");
@@ -174,9 +118,6 @@ const isWindow = (val) => {
 * 判断一个值是否为 DOM 元素
 * @param val - 要判断的数据
 * @returns 如果是 DOM 元素返回 true
-* @example
-* isElement(document.body)
-* // => true
 */
 const isElement = (val) => {
 	return isObject(val) && !!val.tagName;
@@ -185,9 +126,6 @@ const isElement = (val) => {
 * 判断一个值是否为 null
 * @param val - 要判断的数据
 * @returns 如果是 null 返回 true
-* @example
-* isNull(null)
-* // => true
 */
 const isNull = (val) => {
 	return val === null;
@@ -196,11 +134,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);
@@ -208,9 +141,6 @@ const isHexColor = (str) => {
 /**
 * 判断设备是否为 iOS
 * @returns 如果是 iOS 设备返回 true
-* @example
-* isIOS()
-* // => true（在 iPhone/iPad 上）
 */
 const isIOS = () => {
 	return /iPad|iPhone|iPod/.test(navigator.userAgent);
@@ -219,9 +149,6 @@ const isIOS = () => {
 * 判断一个值是否为有效的电子邮件
 * @param email - 要判断的字符串
 * @returns 如果是有效的电子邮件地址返回 true
-* @example
-* isValidEmail("test@example.com")
-* // => true
 */
 const isValidEmail = (email) => {
 	return /^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(email);
@@ -230,11 +157,6 @@ const isValidEmail = (email) => {
 * 判断一个值是否已定义（不是 undefined）
 * @param val - 要判断的数据
 * @returns 如果不是 undefined 返回 true
-* @example
-* isDef("hello")
-* // => true
-* isDef(undefined)
-* // => false
 */
 const isDef = (val) => {
 	return typeof val !== "undefined";
@@ -243,9 +165,6 @@ const isDef = (val) => {
 * 判断一个值是否为 undefined
 * @param val - 要判断的数据
 * @returns 如果是 undefined 返回 true
-* @example
-* isUnDef(undefined)
-* // => true
 */
 const isUnDef = (val) => {
 	return typeof val === "undefined";
@@ -254,13 +173,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);
@@ -269,9 +181,6 @@ const isNullOrUnDef = (val) => {
 * 判断一个值是否为 symbol
 * @param value - 要判断的数据
 * @returns 如果是 symbol 返回 true
-* @example
-* isSymbol(Symbol("foo"))
-* // => true
 */
 const isSymbol = (value) => {
 	return !!value && value.constructor === Symbol;
@@ -281,11 +190,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";
@@ -295,13 +199,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;
@@ -319,19 +216,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;
@@ -346,11 +230,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;
@@ -372,9 +251,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", {
@@ -391,9 +267,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, "-");
@@ -402,9 +275,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", {
@@ -417,9 +287,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);
@@ -429,9 +296,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, {
@@ -443,9 +307,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);
@@ -455,9 +316,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", {
@@ -469,9 +327,6 @@ const percentCN = (value, digit = 0) => {
 * 紧凑计数法（大数简化）_ 英文缩写
 * @param value - 数值
 * @returns 格式化后的紧凑数字字符串（英文缩写）
-* @example
-* compactEN(12345)
-* // => "12K"
 */
 const compactEN = (value) => {
 	return new Intl.NumberFormat("en-US", {
@@ -483,9 +338,6 @@ const compactEN = (value) => {
 * 紧凑计数法（大数简化）_ 中文缩写
 * @param value - 数值
 * @returns 格式化后的紧凑数字字符串（中文缩写）
-* @example
-* compactCN(12345)
-* // => "1.2万"
 */
 const compactCN = (value) => {
 	return new Intl.NumberFormat("zh-CN", {
@@ -498,12 +350,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", {
@@ -515,9 +361,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");
@@ -526,9 +369,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");
@@ -537,9 +377,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());
@@ -548,9 +385,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());
@@ -559,9 +393,6 @@ const kebabToCamel = (str) => {
 * 大驼峰或小驼峰 _ 转为 ‘-’ 短横线连接
 * @param str - 字符串
 * @returns 大驼峰或小驼峰命名格式化的字符串
-* @example
-* camelToKebab("helloWorld")
-* // => "hello-world"
 */
 const camelToKebab = (str) => {
 	return str.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -572,9 +403,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;
@@ -586,9 +414,6 @@ const truncate = (str, maxLength, suffix = "...") => {
 * @param maxWords - 截断位置
 * @param suffix - 自定义的替换截断后的内容
 * @returns 超长文本截断后内容
-* @example
-* truncateByWords("你好世界欢迎你", 4)
-* // => "你好世界..."
 */
 const truncateByWords = (str, maxWords, suffix = "...") => {
 	const chars = str.split("");
@@ -599,18 +424,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());
@@ -619,9 +438,6 @@ const toCamel = (str) => {
 * 首字母大写
 * @param str - 字符串
 * @returns 首字母大写后的字符串
-* @example
-* firstUpper("hello")
-* // => "Hello"
 */
 const firstUpper = (str) => {
 	return str.charAt(0).toUpperCase() + str.slice(1);
@@ -630,9 +446,6 @@ const firstUpper = (str) => {
 * 首字母小写
 * @param str - 字符串
 * @returns 首字母小写后的字符串
-* @example
-* firstLower("Hello")
-* // => "hello"
 */
 const firstLower = (str) => {
 	return str.charAt(0).toLowerCase() + str.slice(1);
@@ -641,9 +454,6 @@ const firstLower = (str) => {
 * 反转字符串
 * @param str - 字符串
 * @returns 反转后的字符串
-* @example
-* reverse("hello")
-* // => "olleh"
 */
 const reverse = (str) => {
 	return str.split("").reverse().join("");
@@ -654,9 +464,6 @@ const reverse = (str) => {
 * 获取 localStorage
 * @param key - 存储键名
 * @returns 解析后的值，解析失败则返回原始字符串，键不存在返回 null
-* @example
-* localGet("user")
-* // => { name: "张三" }
 */
 const localGet = (key) => {
 	const value = localStorage.getItem(key);
@@ -671,8 +478,6 @@ const localGet = (key) => {
 * 设置 localStorage
 * @param key - 存储键名
 * @param value - 存储值（会自动 JSON 序列化）
-* @example
-* localSet("user", { name: "张三" })
 */
 const localSet = (key, value) => {
 	localStorage.setItem(key, JSON.stringify(value));
@@ -680,16 +485,12 @@ const localSet = (key, value) => {
 /**
 * 移除指定 localStorage
 * @param key - 存储键名
-* @example
-* localRm("user")
 */
 const localRm = (key) => {
 	localStorage.removeItem(key);
 };
 /**
 * 清除所有 localStorage
-* @example
-* localClear()
 */
 const localClear = () => {
 	localStorage.clear();
@@ -702,11 +503,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;
@@ -750,9 +546,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));
@@ -762,10 +555,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;
@@ -778,9 +567,6 @@ function shallowClone(obj) {
 * Set 去重
 * @param arr - 数组
 * @returns 去重后的数组
-* @example
-* unique([1, 2, 2, 3])
-* // => [1, 2, 3]
 */
 const unique = (arr) => {
 	return [...new Set(arr)];
@@ -790,9 +576,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()];
@@ -801,9 +584,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);
@@ -812,9 +592,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);
@@ -825,9 +602,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]);
@@ -836,9 +610,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);
@@ -847,9 +618,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);
@@ -859,12 +627,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);
@@ -875,9 +637,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);
@@ -887,9 +646,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) => {
@@ -903,9 +659,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 !== ""));
@@ -915,9 +668,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);
@@ -929,8 +679,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();
@@ -941,9 +689,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) + "=([^;]+)"));
@@ -952,8 +697,6 @@ const getCookie = (name) => {
 /**
 * 删除 Cookie
 * @param name - Cookie 名称
-* @example
-* delCookie("token")
 */
 const delCookie = (name) => {
 	setCookie(name, "", -1);
@@ -964,9 +707,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 = {};
@@ -980,9 +720,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);
@@ -991,9 +728,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("&");
@@ -1003,9 +737,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 {
@@ -1029,8 +760,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 });
@@ -1045,8 +774,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");
@@ -1054,8 +781,6 @@ const exportJSON = (data, filename = "data.json") => {
 /**
 * 滚动到顶部
 * @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
-* @example
-* scrollToTop()
 */
 const scrollToTop = (behavior = "smooth") => {
 	window.scrollTo({
@@ -1066,8 +791,6 @@ const scrollToTop = (behavior = "smooth") => {
 /**
 * 滚动到底部
 * @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
-* @example
-* scrollToBottom()
 */
 const scrollToBottom = (behavior = "smooth") => {
 	window.scrollTo({
@@ -1079,9 +802,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;
@@ -1104,12 +824,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) => {
@@ -1130,10 +844,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;
@@ -1170,10 +880,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;