pen-it 1.0.8 → 1.0.10

package/README.md

@@ -11,594 +11,734 @@ pnpm add pen-it
 ## 使用
 
 ```ts
-import { isArray, formatFull, deepClone, unique } from 'pen-it'
+import { isArray, formatFull, deepClone, unique } from "pen-it";
 ```
 
+## API
+
+### 类型判断
+
 ---
 
-## API
+#### isArray(value)
+
+> — 判断是否为数组。
+
+```ts
+isArray([1, 2, 3]); // true
+```
+
+#### isObject(value)
+
+> — 判断是否为对象（不含数组）。
+
+```ts
+isObject({ a: 1 }); // true
+```
+
+#### is(val, type)
+
+> — 通用类型判断（内部工具）。
+
+```ts
+is([], "Array"); // true
+```
+
+#### isFunction(val)
+
+> — 判断是否为函数。
+
+```ts
+isFunction(() => {}); // true
+```
+
+#### isAsyncFunction(val)
+
+> — 判断是否为异步函数。
+
+```ts
+isAsyncFunction(async () => {}); // true
+```
+
+#### isPromise(value)
+
+> — 判断是否为 Promise。
+
+```ts
+isPromise(Promise.resolve()); // true
+```
 
-### 类型判断 — `is`
+#### isDate(val)
 
-- **`isArray(value)`** — 判断是否为数组。
+> — 判断是否为 Date 对象。
 
-  ```ts
-  isArray([1, 2, 3])  // true
-  ```
+```ts
+isDate(new Date()); // true
+```
 
-- **`isObject(value)`** — 判断是否为对象（不含数组）。
+#### isNumber(val)
 
-  ```ts
-  isObject({ a: 1 })  // true
-  ```
+> — 判断是否为数字（含 NaN/Infinity）。
 
-- **`is(val, type)`** — 通用类型判断（内部工具）。
+```ts
+isNumber(42); // true
+```
 
-  ```ts
-  is([], 'Array')  // true
-  ```
+#### isInt(val)
 
-- **`isFunction(val)`** — 判断是否为函数。
+> — 判断是否为整数。
 
-  ```ts
-  isFunction(() => {})  // true
-  ```
+```ts
+isInt(42); // true
+```
 
-- **`isAsyncFunction(val)`** — 判断是否为异步函数。
+#### isFloat(val)
 
-  ```ts
-  isAsyncFunction(async () => {})  // true
-  ```
+> — 判断是否为浮点数。
 
-- **`isPromise(value)`** — 判断是否为 Promise。
+```ts
+isFloat(3.14); // true
+```
 
-  ```ts
-  isPromise(Promise.resolve())  // true
-  ```
+#### isString(val)
 
-- **`isDate(val)`** — 判断是否为 Date 对象。
+> — 判断是否为字符串。
 
-  ```ts
-  isDate(new Date())  // true
-  ```
+```ts
+isString("hello"); // true
+```
 
-- **`isNumber(val)`** — 判断是否为数字（含 NaN/Infinity）。
+#### isBoolean(val)
 
-  ```ts
-  isNumber(42)  // true
-  ```
+> — 判断是否为布尔值。
 
-- **`isInt(val)`** — 判断是否为整数。
+```ts
+isBoolean(true); // true
+```
 
-  ```ts
-  isInt(42)  // true
-  ```
+#### isSymbol(value)
 
-- **`isFloat(val)`** — 判断是否为浮点数。
+> — 判断是否为 Symbol。
 
-  ```ts
-  isFloat(3.14)  // true
-  ```
+```ts
+isSymbol(Symbol("foo")); // true
+```
+
+#### isPrimitive(value)
+
+> — 判断是否为原始类型。
+
+```ts
+isPrimitive(42); // true
+```
+
+#### isNull(val)
+
+> — 判断是否为 null。
+
+```ts
+isNull(null); // true
+```
+
+#### isDef(val)
+
+> — 判断是否不是 undefined。
+
+```ts
+isDef("hello"); // true
+```
 
-- **`isString(val)`** — 判断是否为字符串。
+#### isUnDef(val)
 
-  ```ts
-  isString('hello')  // true
-  ```
+> — 判断是否为 undefined。
 
-- **`isBoolean(val)`** — 判断是否为布尔值。
+```ts
+isUnDef(undefined); // true
+```
 
-  ```ts
-  isBoolean(true)  // true
-  ```
+#### isNullOrUnDef(val)
 
-- **`isSymbol(value)`** — 判断是否为 Symbol。
+> — 判断是否为 null 或 undefined。
 
-  ```ts
-  isSymbol(Symbol('foo'))  // true
-  ```
+```ts
+isNullOrUnDef(null); // true
+```
 
-- **`isPrimitive(value)`** — 判断是否为原始类型。
+#### isEmpty(value)
 
-  ```ts
-  isPrimitive(42)  // true
-  ```
+> — 判断是否为空（完备版：支持 Date/Map/Set 等）。
 
-- **`isNull(val)`** — 判断是否为 null。
+```ts
+isEmpty(""); // true
+isEmpty([]); // true
+isEmpty({}); // true
+```
 
-  ```ts
-  isNull(null)  // true
-  ```
+#### isEmptySv(value)
 
-- **`isDef(val)`** — 判断是否不是 undefined。
+> — 判断是否为空（简化版）。
 
-  ```ts
-  isDef('hello')  // true
-  ```
+```ts
+isEmptySv([]); // true
+```
 
-- **`isUnDef(val)`** — 判断是否为 undefined。
+#### isEqual(x, y)
 
-  ```ts
-  isUnDef(undefined)  // true
-  ```
+> — 深度相等比较（支持 Date/RegExp）。
 
-- **`isNullOrUnDef(val)`** — 判断是否为 null 或 undefined。
+```ts
+isEqual({ a: 1 }, { a: 1 }); // true
+```
 
-  ```ts
-  isNullOrUnDef(null)  // true
-  ```
+#### isHexColor(str)
 
-- **`isEmpty(value)`** — 判断是否为空（完备版：支持 Date/Map/Set 等）。
+> — 判断是否为十六进制颜色。
 
-  ```ts
-  isEmpty('')   // true
-  isEmpty([])   // true
-  isEmpty({})   // true
-  ```
+```ts
+isHexColor("#fff"); // true
+```
 
-- **`isEmptySv(value)`** — 判断是否为空（简化版）。
+#### isValidEmail(email)
 
-  ```ts
-  isEmptySv([])  // true
-  ```
+> — 判断是否为有效邮箱。
 
-- **`isEqual(x, y)`** — 深度相等比较（支持 Date/RegExp）。
+```ts
+isValidEmail("a@b.com"); // true
+```
 
-  ```ts
-  isEqual({ a: 1 }, { a: 1 })  // true
-  ```
+#### isPC()
 
-- **`isHexColor(str)`** — 判断是否为十六进制颜色。
+> — 判断是否为浏览器环境。
 
-  ```ts
-  isHexColor('#fff')  // true
-  ```
+```ts
+isPC(); // true
+```
 
-- **`isValidEmail(email)`** — 判断是否为有效邮箱。
+#### isWindow(val)
 
-  ```ts
-  isValidEmail('a@b.com')  // true
-  ```
+> — 判断是否为 window 对象。
 
-- **`isPC()`** — 判断是否为浏览器环境。
+```ts
+isWindow(window); // true
+```
 
-  ```ts
-  isPC()  // true
-  ```
+#### isElement(val)
 
-- **`isWindow(val)`** — 判断是否为 window 对象。
+> — 判断是否为 DOM 元素。
 
-  ```ts
-  isWindow(window)  // true
-  ```
+```ts
+isElement(document.body); // true
+```
 
-- **`isElement(val)`** — 判断是否为 DOM 元素。
+#### isIOS()
 
-  ```ts
-  isElement(document.body)  // true
-  ```
+> — 判断设备是否为 iOS。
 
-- **`isIOS()`** — 判断设备是否为 iOS。
+```ts
+isIOS(); // true
+```
 
-  ```ts
-  isIOS()  // true
-  ```
+### 时间日期格式化
 
 ---
 
-### 日期时间格式化 — `format`
+#### formatFull(date)
 
-- **`formatFull(date)`** — 完整日期时间（斜杠分隔）。
+> — 完整日期时间（斜杠分隔）。
 
-  ```ts
-  formatFull(new Date())  // "2026/06/03 14:30:45"
-  ```
+```ts
+formatFull(new Date()); // "2026/06/03 14:30:45"
+```
 
-- **`formatFullReplace(date)`** — 完整日期时间（短横线分隔）。
+#### formatFullReplace(date)
 
-  ```ts
-  formatFullReplace(new Date())  // "2026-06-03 14:30:45"
-  ```
+> — 完整日期时间（短横线分隔）。
+
+```ts
+formatFullReplace(new Date()); // "2026-06-03 14:30:45"
+```
+
+#### formatYMD(date)
+
+> — 中文年月日。
+
+```ts
+formatYMD(new Date()); // "2026年6月3日"
+```
 
-- **`formatYMD(date)`** — 中文年月日。
+#### formatWeek(date)
 
-  ```ts
-  formatYMD(new Date())  // "2026年6月3日"
-  ```
+> — 星期几。
 
-- **`formatWeek(date)`** — 星期几。
+```ts
+formatWeek(new Date()); // "星期三"
+```
 
-  ```ts
-  formatWeek(new Date())  // "星期三"
-  ```
+### 数字与货币格式化
 
 ---
 
-### 数字与货币格式化 — `format`
+#### formatRmb(value, options)
+
+> — 货币格式化（人民币）。
+
+```ts
+formatRmb(1234.56, { type: "zh-CN", currency: "CNY" }); // "¥1,234.56"
+```
+
+#### formatNum(value)
 
-- **`formatRmb(value, options)`** — 货币格式化（人民币）。
+> — 千位分隔符。
 
-  ```ts
-  formatRmb(1234.56, { type: 'zh-CN', currency: 'CNY' })  // "¥1,234.56"
-  ```
+```ts
+formatNum(1234567); // "1,234,567"
+```
 
-- **`formatNum(value)`** — 千位分隔符。
+#### percentCN(value, digit)
 
-  ```ts
-  formatNum(1234567)  // "1,234,567"
-  ```
+> — 百分比格式化。
 
-- **`percentCN(value, digit)`** — 百分比格式化。
+```ts
+percentCN(0.1234, 2); // "12.34%"
+```
 
-  ```ts
-  percentCN(0.1234, 2)  // "12.34%"
-  ```
+#### compactEN(value)
 
-- **`compactEN(value)`** — 大数简化（英文缩写）。
+> — 大数简化（英文缩写）。
 
-  ```ts
-  compactEN(12345)  // "12K"
-  ```
+```ts
+compactEN(12345); // "12K"
+```
 
-- **`compactCN(value)`** — 大数简化（中文缩写）。
+#### compactCN(value)
 
-  ```ts
-  compactCN(12345)  // "1.2万"
-  ```
+> — 大数简化（中文缩写）。
 
-- **`signed(value, digit)`** — 带正负号显示。
+```ts
+compactCN(12345); // "1.2万"
+```
 
-  ```ts
-  signed(42, 1)  // "+42.0"
-  ```
+#### signed(value, digit)
+
+> — 带正负号显示。
+
+```ts
+signed(42, 1); // "+42.0"
+```
+
+### 字符串处理
 
 ---
 
-### 字符串处理 — `format`
+#### maskPhone(phone)
 
-- **`maskPhone(phone)`** — 手机号脱敏（隐藏中间4位）。
+> — 手机号脱敏（隐藏中间4位）。
 
-  ```ts
-  maskPhone('13812345678')  // "138****5678"
-  ```
+```ts
+maskPhone("13812345678"); // "138****5678"
+```
 
-- **`spacePhone(phone)`** — 手机号空格分隔。
+#### spacePhone(phone)
 
-  ```ts
-  spacePhone('13812345678')  // "138 1234 5678"
-  ```
+> — 手机号空格分隔。
 
-- **`capitalize(str)`** — 每个单词首字母大写。
+```ts
+spacePhone("13812345678"); // "138 1234 5678"
+```
 
-  ```ts
-  capitalize('hello world')  // "Hello World"
-  ```
+#### capitalize(str)
 
-- **`kebabToCamel(str)`** — 短横线转小驼峰。
+> — 每个单词首字母大写。
 
-  ```ts
-  kebabToCamel('hello-world')  // "helloWorld"
-  ```
+```ts
+capitalize("hello world"); // "Hello World"
+```
 
-- **`camelToKebab(str)`** — 驼峰转短横线。
+#### kebabToCamel(str)
 
-  ```ts
-  camelToKebab('helloWorld')  // "hello-world"
-  ```
+> — 短横线转小驼峰。
 
-- **`toCamel(str)`** — 下划线转驼峰。
+```ts
+kebabToCamel("hello-world"); // "helloWorld"
+```
 
-  ```ts
-  toCamel('hello_world')  // "helloWorld"
-  ```
+#### camelToKebab(str)
 
-- **`firstUpper(str)`** — 首字母大写。
+> — 驼峰转短横线。
 
-  ```ts
-  firstUpper('hello')  // "Hello"
-  ```
+```ts
+camelToKebab("helloWorld"); // "hello-world"
+```
 
-- **`firstLower(str)`** — 首字母小写。
+#### toCamel(str)
 
-  ```ts
-  firstLower('Hello')  // "hello"
-  ```
+> — 下划线转驼峰。
 
-- **`reverse(str)`** — 反转字符串。
+```ts
+toCamel("hello_world"); // "helloWorld"
+```
+
+#### firstUpper(str)
+
+> — 首字母大写。
+
+```ts
+firstUpper("hello"); // "Hello"
+```
+
+#### firstLower(str)
 
-  ```ts
-  reverse('hello')  // "olleh"
-  ```
+> — 首字母小写。
 
-- **`trimAll(str)`** — 去除所有空格。
+```ts
+firstLower("Hello"); // "hello"
+```
+
+#### reverse(str)
+
+> — 反转字符串。
 
-  ```ts
-  trimAll(' h e l lo ')  // "hello"
-  ```
+```ts
+reverse("hello"); // "olleh"
+```
 
-- **`truncate(str, max, suffix?)`** — 超长文本截断。
+#### trimAll(str)
 
-  ```ts
-  truncate('Hello World', 8)  // "Hello..."
-  ```
+> — 去除所有空格。
 
-- **`truncateByWords(str, max, suffix?)`** — 按字数截断（中文友好）。
+```ts
+trimAll(" h e l lo "); // "hello"
+```
 
-  ```ts
-  truncateByWords('你好世界欢迎你', 4)  // "你好世界..."
-  ```
+#### truncate(str, max, suffix?)
+
+> — 超长文本截断。
+
+```ts
+truncate("Hello World", 8); // "Hello..."
+```
+
+#### truncateByWords(str, max, suffix?)
+
+> — 按字数截断（中文友好）。
+
+```ts
+truncateByWords("你好世界欢迎你", 4); // "你好世界..."
+```
+
+### 存储
 
 ---
 
-### 存储 — `storage`
+#### localGet<T>(key)
+
+> — 获取 localStorage（自动 JSON 解析）。
+
+```ts
+localGet("user"); // { name: '张三' }
+```
+
+#### localSet(key, value)
 
-- **`localGet<T>(key)`** — 获取 localStorage（自动 JSON 解析）。
+> — 设置 localStorage（自动 JSON 序列化）。
 
-  ```ts
-  localGet('user')  // { name: '张三' }
-  ```
+```ts
+localSet("user", { name: "张三" });
+```
 
-- **`localSet(key, value)`** — 设置 localStorage（自动 JSON 序列化）。
+#### localRm(key)
 
-  ```ts
-  localSet('user', { name: '张三' })
-  ```
+> — 移除指定 localStorage。
+
+```ts
+localRm("user");
+```
 
-- **`localRm(key)`** — 移除指定 localStorage。
+#### localClear()
 
-  ```ts
-  localRm('user')
-  ```
+> — 清除所有 localStorage。
 
-- **`localClear()`** — 清除所有 localStorage。
+```ts
+localClear();
+```
 
-  ```ts
-  localClear()
-  ```
+### 拷贝
 
 ---
 
-### 拷贝 — `copy`
+#### deepClone(obj)
+
+> — 递归深拷贝（支持 Date/RegExp/Map/Set/循环引用）。
 
-- **`deepClone(obj)`** — 递归深拷贝（支持 Date/RegExp/Map/Set/循环引用）。
+```ts
+deepClone({ a: 1, b: { c: 2 } });
+```
+
+#### deepCloneWithJSON(obj)
+
+> — JSON 深拷贝（仅 JSON 安全类型）。
 
-  ```ts
-  deepClone({ a: 1, b: { c: 2 } })
-  ```
+```ts
+deepCloneWithJSON({ a: 1 });
+```
 
-- **`deepCloneWithJSON(obj)`** — JSON 深拷贝（仅 JSON 安全类型）。
+#### structClone(obj, options?)
 
-  ```ts
-  deepCloneWithJSON({ a: 1 })
-  ```
+> — structuredClone 深拷贝（不支持函数/Symbol）。
 
-- **`shallowClone(obj)`** — 浅拷贝（仅第一层）。
+```ts
+structClone({ a: 1, b: { c: 2 } });
+```
 
-  ```ts
-  shallowClone({ a: 1, b: { c: 2 } })
-  ```
+#### shallowClone(obj)
+
+> — 浅拷贝（仅第一层）。
+
+```ts
+shallowClone({ a: 1, b: { c: 2 } });
+```
+
+### 数组
 
 ---
 
-### 数组 — `array`
+#### unique(arr)
 
-- **`unique(arr)`** — Set 去重。
+> — Set 去重。
 
-  ```ts
-  unique([1, 2, 2, 3])  // [1, 2, 3]
-  ```
+```ts
+unique([1, 2, 2, 3]); // [1, 2, 3]
+```
 
-- **`uniqueByKey(arr, key)`** — 对象数组按 key 去重。
+#### uniqueByKey(arr, key)
 
-  ```ts
-  uniqueByKey([{ id: 1 }, { id: 1 }], 'id')
-  ```
+> — 对象数组按 key 去重。
 
-- **`sortNumAsc(arr)`** — 数值升序。
+```ts
+uniqueByKey([{ id: 1 }, { id: 1 }], "id");
+```
 
-  ```ts
-  sortNumAsc([3, 1, 2])  // [1, 2, 3]
-  ```
+#### sortNumAsc(arr)
 
-- **`sortNumDesc(arr)`** — 数值降序。
+> — 数值升序。
 
-  ```ts
-  sortNumDesc([1, 3, 2])  // [3, 2, 1]
-  ```
+```ts
+sortNumAsc([3, 1, 2]); // [1, 2, 3]
+```
 
-- **`sortByKey(arr, key, order?)`** — 按对象属性排序。
+#### sortNumDesc(arr)
 
-  ```ts
-  sortByKey([{ age: 30 }, { age: 20 }], 'age')
-  ```
+> — 数值降序。
 
-- **`toArray(arrayLike)`** — 类数组转数组。
+```ts
+sortNumDesc([1, 3, 2]); // [3, 2, 1]
+```
 
-  ```ts
-  toArray(document.querySelectorAll('div'))
-  ```
+#### sortByKey(arr, key, order?)
 
-- **`mergeArrays(...arrays)`** — 合并多个数组。
+> — 按对象属性排序。
 
-  ```ts
-  mergeArrays([1, 2], [3, 4], [5])  // [1, 2, 3, 4, 5]
-  ```
+```ts
+sortByKey([{ age: 30 }, { age: 20 }], "age");
+```
 
-- **`flatten(arr, depth?)`** — 多维数组扁平化到指定层级（默认 1 层，传 `Infinity` 完全展开）。
+#### toArray(arrayLike)
 
-  ```ts
-  flatten([1, [2, [3, 4]], 5])          // [1, 2, [3, 4], 5]
-  flatten([1, [2, [3, 4]], 5], Infinity) // [1, 2, 3, 4, 5]
-  ```
+> — 类数组转数组。
 
-- **`arrFind(arr, key, value)`** — 对象数组中按 key-value 查找第一个匹配项。
+```ts
+toArray(document.querySelectorAll("div"));
+```
 
-  ```ts
-  arrFind([{ id: 1 }, { id: 2 }], 'id', 2)  // { id: 2 }
-  ```
+#### mergeArrays(...arrays)
 
-- **`groupBy(arr, key)`** — 对象数组按指定属性分组。
+> — 合并多个数组。
+
+```ts
+mergeArrays([1, 2], [3, 4], [5]); // [1, 2, 3, 4, 5]
+```
 
-  ```ts
-  groupBy([{ type: 'fruit' }, { type: 'vegetable' }], 'type')
-  // => { fruit: [...], vegetable: [...] }
-  ```
+#### flatten(arr, depth?)
 
-- **`filterEmptyValues(obj)`** — 移除对象中值为空（null / undefined / 空字符串）的属性。
+> — 多维数组扁平化到指定层级（默认 1 层，传 `Infinity` 完全展开）。
 
-  ```ts
-  filterEmptyValues({ a: 1, b: '', c: null })  // { a: 1 }
-  ```
+```ts
+flatten([1, [2, [3, 4]], 5]); // [1, 2, [3, 4], 5]
+flatten([1, [2, [3, 4]], 5], Infinity); // [1, 2, 3, 4, 5]
+```
 
-- **`createRange(length, mapFn?)`** — 快速生成范围数组。
+#### arrFind(arr, key, value)
 
-  ```ts
-  createRange(5)  // [0, 1, 2, 3, 4]
-  createRange(3, (i) => i * 2)  // [0, 2, 4]
-  ```
+> — 对象数组中按 key-value 查找第一个匹配项。
 
----
+```ts
+arrFind([{ id: 1 }, { id: 2 }], "id", 2); // { id: 2 }
+```
 
-### Cookie — `cookie`
+#### groupBy(arr, key)
 
-- **`setCookie(name, value, days?)`** — 设置 Cookie（默认7天）。
+> — 对象数组按指定属性分组。
+
+```ts
+groupBy([{ type: "fruit" }, { type: "vegetable" }], "type");
+// => { fruit: [...], vegetable: [...] }
+```
 
-  ```ts
-  setCookie('token', 'abc123', 30)
-  ```
+#### filterEmptyValues(obj)
 
-- **`getCookie(name)`** — 获取 Cookie。
+> — 移除对象中值为空（null / undefined / 空字符串）的属性。
 
-  ```ts
-  getCookie('token')  // "abc123"
-  ```
+```ts
+filterEmptyValues({ a: 1, b: "", c: null }); // { a: 1 }
+```
 
-- **`delCookie(name)`** — 删除 Cookie。
+#### createRange(length, mapFn?)
 
-  ```ts
-  delCookie('token')
-  ```
+> — 快速生成范围数组。
+
+```ts
+createRange(5); // [0, 1, 2, 3, 4]
+createRange(3, (i) => i * 2); // [0, 2, 4]
+```
+
+### Cookie
 
 ---
 
-### 浏览器工具 — `browser`
+#### setCookie(name, value, days?)
 
-#### URL 参数
+> — 设置 Cookie（默认7天）。
 
-- **`getUrlParams(url?)`** — 获取 URL 参数对象。
+```ts
+setCookie("token", "abc123", 30);
+```
 
-  ```ts
-  getUrlParams('?a=1&b=2')  // { a: '1', b: '2' }
-  ```
+#### getCookie(name)
 
-- **`getUrlParam(key, url?)`** — 获取单个 URL 参数。
+> — 获取 Cookie。
 
-  ```ts
-  getUrlParam('a')  // "1"
-  ```
+```ts
+getCookie("token"); // "abc123"
+```
 
-- **`toQueryString(params)`** — 对象转 URL 参数字符串。
+#### delCookie(name)
 
-  ```ts
-  toQueryString({ a: 1, b: 'hello' })  // "a=1&b=hello"
-  ```
+> — 删除 Cookie。
 
-#### 剪贴板与文件
+```ts
+delCookie("token");
+```
 
-- **`copyToClipboard(text)`** — 复制文本到剪贴板（支持降级）。
+### 浏览器
 
-  ```ts
-  await copyToClipboard('Hello')
-  ```
+---
 
-- **`downloadFile(content, filename, mimeType?)`** — 下载文件（Blob）。
+#### getUrlParams(url?)
 
-  ```ts
-  downloadFile('Hello', 'hello.txt')
-  ```
+> — 获取 URL 参数对象。
 
-- **`exportJSON(data, filename?)`** — 导出 JSON 为文件。
+```ts
+getUrlParams("?a=1&b=2"); // { a: '1', b: '2' }
+```
 
-  ```ts
-  exportJSON({ name: '张三' })
-  ```
+#### getUrlParam(key, url?)
 
-#### 页面滚动
+> — 获取单个 URL 参数。
 
-- **`scrollToTop(behavior?)`** — 滚动到顶部（默认平滑）。
+```ts
+getUrlParam("a"); // "1"
+```
 
-  ```ts
-  scrollToTop()
-  ```
+#### toQueryString(params)
 
-- **`scrollToBottom(behavior?)`** — 滚动到底部（默认平滑）。
+> — 对象转 URL 参数字符串。
 
-  ```ts
-  scrollToBottom()
-  ```
+```ts
+toQueryString({ a: 1, b: "hello" }); // "a=1&b=hello"
+```
 
-- **`onScroll(callback)`** — 监听滚动（rAF 节流），返回清理函数。
+#### copyToClipboard(text)
 
-  ```ts
-  const off = onScroll(y => console.log(y))
-  ```
+> — 复制文本到剪贴板（支持降级）。
 
-#### 可视区域检测
+```ts
+await copyToClipboard("Hello");
+```
 
-- **`observeIntersection(target, onEnter, onLeave?, options?)`** — 监听元素进入/离开可视区域，返回清理函数。
+#### downloadFile(content, filename, mimeType?)
 
-  ```ts
-  const cleanup = observeIntersection(
-    document.querySelector('.footer')!,
-    () => loadMore(10),
-  );
-  ```
+> — 下载文件（Blob）。
 
----
+```ts
+downloadFile("Hello", "hello.txt");
+```
 
-### 防抖与节流 — `control`
+#### exportJSON(data, filename?)
 
-- **`debounce(fn, delay?, options?)`** — 防抖，停止调用 delay 毫秒后才执行。
+> — 导出 JSON 为文件。
 
-  ```ts
-  const fn = debounce((val: string) => console.log(val), 500)
-  fn('a'); fn('b'); fn('c')
-  // => 'c'
-  ```
+```ts
+exportJSON({ name: "张三" });
+```
 
-- **`throttle(fn, interval?, options?)`** — 节流，固定间隔内最多执行一次。
+#### scrollToTop(behavior?)
 
-  ```ts
-  const fn = throttle((val: string) => console.log(val), 500)
-  fn('a'); fn('b'); fn('c')
-  // => 'a'，500ms 后输出 'c'
-  ```
+> — 滚动到顶部（默认平滑）。
 
----
+```ts
+scrollToTop();
+```
+
+#### scrollToBottom(behavior?)
+
+> — 滚动到底部（默认平滑）。
+
+```ts
+scrollToBottom();
+```
+
+#### onScroll(callback)
 
-## 更新日志
+> — 监听滚动（rAF 节流），返回清理函数。
+
+```ts
+const off = onScroll((y) => console.log(y));
+```
 
-### v1.0.7
+#### observeIntersection(target, onEnter, onLeave?, options?)
 
-- **体积优化** — 移除JSDoc `@example` 示例注释（共 294 行），减少包体积
-- **文档** — README 底部新增更新日志模块
+> — 监听元素进入/离开可视区域，返回清理函数。
 
-### v1.0.6
+```ts
+const cleanup = observeIntersection(document.querySelector(".footer")!, () =>
+  loadMore(10),
+);
+```
 
-- **数组模块** — 新增 `mergeArrays` 数组合并、`flatten` 数组扁平化（支持任意层级）、`arrFind` 数组项查询、`groupBy` JSON 数组分组、`filterEmptyValues` 对象移除空值属性、`createRange` 快速生成范围数组
-- **浏览器模块** — 新增 `observeIntersection` 可视区域检测（基于 IntersectionObserver）
+### 防抖与节流
 
-### v1.0.5
+---
 
-- **控制模块** — 新增 `debounce` 防抖与 `throttle` 节流
+#### debounce(fn, delay?, options?)
 
-### v1.0.4
+> — 防抖，停止调用 delay 毫秒后才执行。
 
-- 初始版本，包含以下模块：
-  - **类型判断** — `isArray` `isObject` `is` `isFunction` `isAsyncFunction` `isPromise` `isDate` `isNumber` `isInt` `isFloat` `isString` `isBoolean` `isSymbol` `isPrimitive` `isNull` `isDef` `isUnDef` `isNullOrUnDef` `isEmpty` `isEmptySv` `isEqual` `isHexColor` `isValidEmail` `isPC` `isWindow` `isElement` `isIOS` 共 27 个函数
-  - **格式化** — 日期时间（`formatFull` `formatFullReplace` `formatYMD` `formatWeek`）、数字货币（`formatRmb` `formatNum` `percentCN` `compactEN` `compactCN` `signed`）、字符串（`maskPhone` `spacePhone` `capitalize` `kebabToCamel` `camelToKebab` `toCamel` `firstUpper` `firstLower` `reverse` `trimAll` `truncate` `truncateByWords`）共 22 个函数
-  - **存储** — `localGet` `localSet` `localRm` `localClear` 共 4 个函数
-  - **拷贝** — `deepClone` `deepCloneWithJSON` `shallowClone` 共 3 个函数
-  - **数组** — `unique` `uniqueByKey` `sortNumAsc` `sortNumDesc` `sortByKey` `toArray` 共 6 个函数
-  - **Cookie** — `setCookie` `getCookie` `delCookie` 共 3 个函数
-  - **浏览器** — `getUrlParams` `getUrlParam` `toQueryString` `copyToClipboard` `downloadFile` `exportJSON` `scrollToTop` `scrollToBottom` `onScroll` 共 9 个函数
+```ts
+const fn = debounce((val: string) => console.log(val), 500);
+fn("a");
+fn("b");
+fn("c");
+// => 'c'
+```
+
+#### throttle(fn, interval?, options?)
+
+> — 节流，固定间隔内最多执行一次。
+
+```ts
+const fn = throttle((val: string) => console.log(val), 500);
+fn("a");
+fn("b");
+fn("c");
+// => 'a'，500ms 后输出 'c'
+```