pen-it 1.0.0

package/dist/index.js

@@ -0,0 +1,1022 @@
+//#region src/is/index.ts
+/**
+* 判断一个值是否为数组
+* @param value - 要判断的值
+* @returns 如果是数组返回 true，否则返回 false
+* @example
+* isArray([1, 2, 3])
+* // => true
+* isArray("hello")
+* // => false
+*/
+const isArray = (value) => {
+	return Array.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);
+};
+/**
+* 判断数据类型（内部工具函数）
+* @param val - 要判断的数据
+* @param type - 数据类型字符串，如 "Array"、"Function"
+* @returns 如果数据是指定类型返回 true
+* @example
+* is([], "Array")
+* // => true
+*/
+const is = (val, type) => {
+	return Object.prototype.toString.call(val) === `[object ${type}]`;
+};
+/**
+* 判断一个值是否为函数
+* @param val - 要判断的数据
+* @returns 如果是函数返回 true
+* @example
+* isFunction(() => {})
+* // => true
+*/
+const isFunction = (val) => {
+	return is(val, "Function") || !!(val && val.constructor && val.call && val.apply);
+};
+/**
+* 判断一个值是否为 Date 对象
+* @param val - 要判断的数据
+* @returns 如果是 Date 对象返回 true
+* @example
+* isDate(new Date())
+* // => true
+*/
+const isDate = (val) => {
+	return is(val, "Date") || !!val && val.constructor === Date;
+};
+/**
+* 判断一个值是否为数字（NaN 和 Infinity 也视为数字）
+* @param val - 要判断的数据
+* @returns 如果是数字返回 true
+* @example
+* isNumber(42)
+* // => true
+* isNumber("42")
+* // => false
+*/
+const isNumber = (val) => {
+	return Number(val) === 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;
+};
+/**
+* 判断一个值是否为浮点数（有限小数）
+* @param val - 要判断的数据
+* @returns 如果是浮点数返回 true
+* @example
+* isFloat(3.14)
+* // => true
+* isFloat(42)
+* // => false
+*/
+const isFloat = (val) => {
+	return isNumber(val) && Number.isFinite(val) && val % 1 !== 0;
+};
+/**
+* 判断一个值是否为异步函数
+* @param val - 要判断的数据
+* @returns 如果是异步函数返回 true
+* @example
+* isAsyncFunction(async () => {})
+* // => true
+*/
+const isAsyncFunction = (val) => {
+	return is(val, "AsyncFunction");
+};
+/**
+* 判断一个值是否为 Promise
+* @param value - 要判断的数据
+* @returns 如果是 Promise 返回 true
+* @example
+* isPromise(Promise.resolve())
+* // => true
+*/
+const isPromise = (value) => {
+	if (!value) return false;
+	if (!value.then) return false;
+	if (!isFunction(value.then)) return false;
+	return true;
+};
+/**
+* 判断一个值是否为字符串
+* @param val - 要判断的数据
+* @returns 如果是字符串返回 true
+* @example
+* isString("hello")
+* // => true
+* isString(42)
+* // => false
+*/
+const isString = (val) => {
+	return is(val, "String") || typeof val === "string" || val instanceof String;
+};
+/**
+* 判断一个值是否为布尔值
+* @param val - 要判断的数据
+* @returns 如果是布尔值返回 true
+* @example
+* isBoolean(true)
+* // => true
+* isBoolean(1)
+* // => false
+*/
+const isBoolean = (val) => {
+	return typeof val === "boolean" || is(val, "Boolean");
+};
+/**
+* 判断是否为 PC 端（浏览器环境）
+* @returns 如果在浏览器环境中返回 true
+* @example
+* isPC()
+* // => true（在浏览器中）
+*/
+const isPC = () => {
+	return typeof window !== "undefined";
+};
+/**
+* 判断一个值是否为 window 对象
+* @param val - 要判断的数据
+* @returns 如果是 window 对象返回 true
+* @example
+* isWindow(window)
+* // => true（在浏览器中）
+*/
+const isWindow = (val) => {
+	return typeof window !== "undefined" && is(val, "Window");
+};
+/**
+* 判断一个值是否为 DOM 元素
+* @param val - 要判断的数据
+* @returns 如果是 DOM 元素返回 true
+* @example
+* isElement(document.body)
+* // => true
+*/
+const isElement = (val) => {
+	return isObject(val) && !!val.tagName;
+};
+/**
+* 判断一个值是否为 null
+* @param val - 要判断的数据
+* @returns 如果是 null 返回 true
+* @example
+* isNull(null)
+* // => true
+*/
+const isNull = (val) => {
+	return val === null;
+};
+/**
+* 判断一个值是否为十六进制颜色
+* @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);
+};
+/**
+* 判断设备是否为 iOS
+* @returns 如果是 iOS 设备返回 true
+* @example
+* isIOS()
+* // => true（在 iPhone/iPad 上）
+*/
+const isIOS = () => {
+	return /iPad|iPhone|iPod/.test(navigator.userAgent);
+};
+/**
+* 判断一个值是否为有效的电子邮件
+* @param email - 要判断的字符串
+* @returns 如果是有效的电子邮件地址返回 true
+* @example
+* isValidEmail("test@example.com")
+* // => true
+*/
+const isValidEmail = (email) => {
+	return /^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(email);
+};
+/**
+* 判断一个值是否已定义（不是 undefined）
+* @param val - 要判断的数据
+* @returns 如果不是 undefined 返回 true
+* @example
+* isDef("hello")
+* // => true
+* isDef(undefined)
+* // => false
+*/
+const isDef = (val) => {
+	return typeof val !== "undefined";
+};
+/**
+* 判断一个值是否为 undefined
+* @param val - 要判断的数据
+* @returns 如果是 undefined 返回 true
+* @example
+* isUnDef(undefined)
+* // => true
+*/
+const isUnDef = (val) => {
+	return typeof val === "undefined";
+};
+/**
+* 判断一个值是否为 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);
+};
+/**
+* 判断一个值是否为 symbol
+* @param value - 要判断的数据
+* @returns 如果是 symbol 返回 true
+* @example
+* isSymbol(Symbol("foo"))
+* // => true
+*/
+const isSymbol = (value) => {
+	return !!value && value.constructor === Symbol;
+};
+/**
+* 判断一个值是否为原始类型
+* 原始类型包括：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";
+};
+/**
+* 判断一个值是否为空
+* 空值包括：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;
+	if (isDate(value)) return isNaN(value.getTime());
+	if (isFunction(value) || isSymbol(value)) return false;
+	if (isNumber(value)) return false;
+	const length = value.length;
+	if (isNumber(length)) return length === 0;
+	const size = value.size;
+	if (isNumber(size)) return size === 0;
+	return Object.keys(value).length === 0;
+};
+/**
+* 判断一个值是否为空（简化版）
+* 支持：字符串、数组、对象、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;
+	if (typeof value === "string" || Array.isArray(value)) return value.length === 0;
+	if (value instanceof Map || value instanceof Set) return value.size === 0;
+	if (ArrayBuffer.isView(value)) return value.byteLength === 0;
+	if (typeof value === "object") return Object.keys(value).length === 0;
+	return false;
+}
+/**
+* 判断两个值是否深度相等
+* @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;
+	if (x instanceof Date && y instanceof Date) return x.getTime() === y.getTime();
+	if (x instanceof RegExp && y instanceof RegExp) return x.toString() === y.toString();
+	if (typeof x !== "object" || x === null || typeof y !== "object" || y === null) return false;
+	const keysX = Reflect.ownKeys(x);
+	const keysY = Reflect.ownKeys(y);
+	if (keysX.length !== keysY.length) return false;
+	for (let i = 0; i < keysX.length; i++) {
+		if (!Reflect.has(y, keysX[i])) return false;
+		if (!isEqual(x[keysX[i]], y[keysX[i]])) return false;
+	}
+	return true;
+};
+//#endregion
+//#region src/format/index.ts
+/**
+* 完整日期时间（年/月/日 时分秒）_ 斜杠
+* @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", {
+		year: "numeric",
+		month: "2-digit",
+		day: "2-digit",
+		hour: "2-digit",
+		minute: "2-digit",
+		second: "2-digit",
+		hour12: false
+	}).format(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, "-");
+};
+/**
+* 中文年月日
+* @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", {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	}).format(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);
+};
+/**
+* 货币格式化
+* @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, {
+		style: "currency",
+		currency: options.currency
+	}).format(value);
+};
+/**
+* 千位分隔符（数字格式化），中文（逗号分隔）
+* @param value - 数值
+* @returns 格式化后的千位分隔数字字符串
+* @example
+* formatNum(1234567)
+* // => "1,234,567"
+*/
+const formatNum = (value) => {
+	return new Intl.NumberFormat("zh-CN").format(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", {
+		style: "percent",
+		minimumFractionDigits: digit
+	}).format(value);
+};
+/**
+* 紧凑计数法（大数简化）_ 英文缩写
+* @param value - 数值
+* @returns 格式化后的紧凑数字字符串（英文缩写）
+* @example
+* compactEN(12345)
+* // => "12K"
+*/
+const compactEN = (value) => {
+	return new Intl.NumberFormat("en-US", {
+		notation: "compact",
+		compactDisplay: "short"
+	}).format(value);
+};
+/**
+* 紧凑计数法（大数简化）_ 中文缩写
+* @param value - 数值
+* @returns 格式化后的紧凑数字字符串（中文缩写）
+* @example
+* compactCN(12345)
+* // => "1.2万"
+*/
+const compactCN = (value) => {
+	return new Intl.NumberFormat("zh-CN", {
+		notation: "compact",
+		compactDisplay: "short"
+	}).format(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", {
+		signDisplay: "always",
+		minimumFractionDigits: digit
+	}).format(value);
+};
+/**
+* 手机号格式化脱敏 _ 隐藏中间 4 位数
+* @param phone - 手机号码
+* @returns 手机号格式化脱敏后的手机号
+* @example
+* maskPhone("13812345678")
+* // => "138****5678"
+*/
+const maskPhone = (phone) => {
+	return phone.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2");
+};
+/**
+* 手机号格式化 _ 空格分隔
+* @param phone - 手机号
+* @returns 手机号空格格式化的手机号
+* @example
+* spacePhone("13812345678")
+* // => "138 1234 5678"
+*/
+const spacePhone = (phone) => {
+	return phone.replace(/(\d{3})(\d{4})(\d{4})/, "$1 $2 $3");
+};
+/**
+* 每个单词首字母大写
+* @param str - 字符串
+* @returns 每个单词首字母大写后的字符串
+* @example
+* capitalize("hello world")
+* // => "Hello World"
+*/
+const capitalize = (str) => {
+	return str.replace(/\b\w/g, (char) => char.toUpperCase());
+};
+/**
+* 短横线连接转小驼峰（kebab-case → camelCase）
+* @param str - 字符串
+* @returns 转换后的小驼峰字符串
+* @example
+* kebabToCamel("hello-world")
+* // => "helloWorld"
+*/
+const kebabToCamel = (str) => {
+	return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+};
+/**
+* 大驼峰或小驼峰 _ 转为 ‘-’ 短横线连接
+* @param str - 字符串
+* @returns 大驼峰或小驼峰命名格式化的字符串
+* @example
+* camelToKebab("helloWorld")
+* // => "hello-world"
+*/
+const camelToKebab = (str) => {
+	return str.replace(/([A-Z])/g, "-$1").toLowerCase();
+};
+/**
+* 超长文本截断
+* @param str - 内容
+* @param maxLength - 截断位置
+* @param suffix - 自定义的替换截断后的内容
+* @returns 超长文本截断后内容
+* @example
+* truncate("Hello World", 8)
+* // => "Hello..."
+*/
+const truncate = (str, maxLength, suffix = "...") => {
+	if (str.length <= maxLength) return str;
+	return str.substring(0, maxLength - suffix.length) + suffix;
+};
+/**
+* 按字数截断（中文友好）
+* @param str - 内容
+* @param maxWords - 截断位置
+* @param suffix - 自定义的替换截断后的内容
+* @returns 超长文本截断后内容
+* @example
+* truncateByWords("你好世界欢迎你", 4)
+* // => "你好世界..."
+*/
+const truncateByWords = (str, maxWords, suffix = "...") => {
+	const chars = str.split("");
+	if (chars.length <= maxWords) return str;
+	return chars.slice(0, maxWords).join("") + 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());
+};
+/**
+* 首字母大写
+* @param str - 字符串
+* @returns 首字母大写后的字符串
+* @example
+* firstUpper("hello")
+* // => "Hello"
+*/
+const firstUpper = (str) => {
+	return str.charAt(0).toUpperCase() + str.slice(1);
+};
+/**
+* 首字母小写
+* @param str - 字符串
+* @returns 首字母小写后的字符串
+* @example
+* firstLower("Hello")
+* // => "hello"
+*/
+const firstLower = (str) => {
+	return str.charAt(0).toLowerCase() + str.slice(1);
+};
+/**
+* 反转字符串
+* @param str - 字符串
+* @returns 反转后的字符串
+* @example
+* reverse("hello")
+* // => "olleh"
+*/
+const reverse = (str) => {
+	return str.split("").reverse().join("");
+};
+//#endregion
+//#region src/storage/index.ts
+/**
+* 获取 localStorage
+* @param key - 存储键名
+* @returns 解析后的值，解析失败则返回原始字符串，键不存在返回 null
+* @example
+* localGet("user")
+* // => { name: "张三" }
+*/
+const localGet = (key) => {
+	const value = localStorage.getItem(key);
+	if (value === null) return null;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return value;
+	}
+};
+/**
+* 设置 localStorage
+* @param key - 存储键名
+* @param value - 存储值（会自动 JSON 序列化）
+* @example
+* localSet("user", { name: "张三" })
+*/
+const localSet = (key, value) => {
+	localStorage.setItem(key, JSON.stringify(value));
+};
+/**
+* 移除指定 localStorage
+* @param key - 存储键名
+* @example
+* localRm("user")
+*/
+const localRm = (key) => {
+	localStorage.removeItem(key);
+};
+/**
+* 清除所有 localStorage
+* @example
+* localClear()
+*/
+const localClear = () => {
+	localStorage.clear();
+};
+//#endregion
+//#region src/copy/index.ts
+/**
+* 递归深拷贝
+* 支持 Date、RegExp、Map、Set、Array、Object 以及循环引用
+* @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;
+	if (hash.has(obj)) return hash.get(obj);
+	if (obj instanceof Date) return new Date(obj.getTime());
+	if (obj instanceof RegExp) return new RegExp(obj.source, obj.flags);
+	if (obj instanceof Map) {
+		const clone = /* @__PURE__ */ new Map();
+		hash.set(obj, clone);
+		obj.forEach((value, key) => {
+			clone.set(key, deepClone(value, hash));
+		});
+		return clone;
+	}
+	if (obj instanceof Set) {
+		const clone = /* @__PURE__ */ new Set();
+		hash.set(obj, clone);
+		obj.forEach((value) => {
+			clone.add(deepClone(value, hash));
+		});
+		return clone;
+	}
+	if (Array.isArray(obj)) {
+		const clone = [];
+		hash.set(obj, clone);
+		obj.forEach((item, index) => {
+			clone[index] = deepClone(item, hash);
+		});
+		return clone;
+	}
+	const clone = {};
+	hash.set(obj, clone);
+	Object.keys(obj).forEach((key) => {
+		clone[key] = deepClone(obj[key], hash);
+	});
+	return clone;
+}
+/**
+* JSON 深拷贝
+* 使用 JSON 序列化与反序列化实现，仅支持 JSON 安全的数据类型
+* （不支持函数、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));
+}
+/**
+* 浅拷贝
+* 仅拷贝第一层属性，嵌套对象仍共享引用
+* @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;
+	if (Array.isArray(obj)) return [...obj];
+	return { ...obj };
+}
+//#endregion
+//#region src/array/index.ts
+/**
+* Set 去重
+* @param arr - 数组
+* @returns 去重后的数组
+* @example
+* unique([1, 2, 2, 3])
+* // => [1, 2, 3]
+*/
+const unique = (arr) => {
+	return [...new Set(arr)];
+};
+/**
+* 对象数组按 key 去重
+* @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()];
+};
+/**
+* 数值升序
+* @param arr - 数值数组
+* @returns 升序排序后的新数组
+* @example
+* sortNumAsc([3, 1, 2])
+* // => [1, 2, 3]
+*/
+const sortNumAsc = (arr) => {
+	return [...arr].sort((a, b) => a - b);
+};
+/**
+* 数值降序
+* @param arr - 数值数组
+* @returns 降序排序后的新数组
+* @example
+* sortNumDesc([1, 3, 2])
+* // => [3, 2, 1]
+*/
+const sortNumDesc = (arr) => {
+	return [...arr].sort((a, b) => b - a);
+};
+/**
+* 按对象属性排序
+* @param 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]);
+};
+/**
+* 类数组转数组
+* @param arrayLike - 类数组对象（如 NodeList、arguments）
+* @returns 转换后的数组
+* @example
+* toArray(document.querySelectorAll("div"))
+* // => [div, div, ...]
+*/
+const toArray = (arrayLike) => {
+	return Array.from(arrayLike);
+};
+//#endregion
+//#region src/cookie/index.ts
+/**
+* 设置 Cookie
+* @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();
+	expires.setDate(expires.getDate() + days);
+	document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; expires=${expires.toUTCString()}; path=/`;
+};
+/**
+* 获取 Cookie
+* @param name - Cookie 名称
+* @returns Cookie 值，不存在则返回 null
+* @example
+* getCookie("token")
+* // => "abc123"
+*/
+const getCookie = (name) => {
+	const match = document.cookie.match(new RegExp("(^| )" + encodeURIComponent(name) + "=([^;]+)"));
+	return match ? decodeURIComponent(match[2]) : null;
+};
+/**
+* 删除 Cookie
+* @param name - Cookie 名称
+* @example
+* delCookie("token")
+*/
+const delCookie = (name) => {
+	setCookie(name, "", -1);
+};
+//#endregion
+//#region src/browser/index.ts
+/**
+* 获取 URL 参数对象
+* @param url - URL 字符串，默认使用当前页面地址
+* @returns 参数键值对对象
+* @example
+* getUrlParams("https://example.com?a=1&b=2")
+* // => { a: "1", b: "2" }
+*/
+const getUrlParams = (url) => {
+	const params = {};
+	new URL(url || window.location.href).searchParams.forEach((val, key) => {
+		params[key] = val;
+	});
+	return params;
+};
+/**
+* 获取单个 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);
+};
+/**
+* 对象转 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("&");
+};
+/**
+* 复制文本到剪贴板
+* 优先使用 Clipboard API，失败时降级为 execCommand
+* @param text - 要复制的文本
+* @returns 复制成功返回 true，失败返回 false
+* @example
+* await copyToClipboard("Hello World")
+* // => true
+*/
+const copyToClipboard = async (text) => {
+	if (navigator.clipboard) try {
+		await navigator.clipboard.writeText(text);
+		return true;
+	} catch {
+		return false;
+	}
+	const textarea = document.createElement("textarea");
+	textarea.value = text;
+	textarea.style.position = "fixed";
+	textarea.style.opacity = "0";
+	document.body.appendChild(textarea);
+	textarea.select();
+	const result = document.execCommand("copy");
+	document.body.removeChild(textarea);
+	return result;
+};
+/**
+* 下载文件（Blob）
+* @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 });
+	const url = URL.createObjectURL(blob);
+	const a = document.createElement("a");
+	a.href = url;
+	a.download = filename;
+	a.click();
+	URL.revokeObjectURL(url);
+};
+/**
+* 导出 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");
+};
+/**
+* 滚动到顶部
+* @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
+* @example
+* scrollToTop()
+*/
+const scrollToTop = (behavior = "smooth") => {
+	window.scrollTo({
+		top: 0,
+		behavior
+	});
+};
+/**
+* 滚动到底部
+* @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
+* @example
+* scrollToBottom()
+*/
+const scrollToBottom = (behavior = "smooth") => {
+	window.scrollTo({
+		top: document.documentElement.scrollHeight,
+		behavior
+	});
+};
+/**
+* 监听页面滚动（requestAnimationFrame 节流）
+* @param callback - 滚动回调，接收当前 scrollY 值
+* @returns 清理函数，调用后移除事件监听
+* @example
+* const cleanup = onScroll((y) => console.log(y));
+* cleanup(); // 停止监听
+*/
+const onScroll = (callback) => {
+	let ticking = false;
+	const handler = () => {
+		if (!ticking) {
+			requestAnimationFrame(() => {
+				callback(window.scrollY);
+				ticking = false;
+			});
+			ticking = true;
+		}
+	};
+	window.addEventListener("scroll", handler);
+	return () => window.removeEventListener("scroll", handler);
+};
+//#endregion
+export { camelToKebab, capitalize, compactCN, compactEN, copyToClipboard, deepClone, deepCloneWithJSON, delCookie, downloadFile, exportJSON, firstLower, firstUpper, formatFull, formatFullReplace, formatNum, formatRmb, formatWeek, formatYMD, getCookie, getUrlParam, getUrlParams, is, isArray, isAsyncFunction, isBoolean, isDate, isDef, isElement, isEmpty, isEmptySv, isEqual, isFloat, isFunction, isHexColor, isIOS, isInt, isNull, isNullOrUnDef, isNumber, isObject, isPC, isPrimitive, isPromise, isString, isSymbol, isUnDef, isValidEmail, isWindow, kebabToCamel, localClear, localGet, localRm, localSet, maskPhone, onScroll, percentCN, reverse, scrollToBottom, scrollToTop, setCookie, shallowClone, signed, sortByKey, sortNumAsc, sortNumDesc, spacePhone, toArray, toCamel, toQueryString, trimAll, truncate, truncateByWords, unique, uniqueByKey };