pen-it 1.0.9 → 1.0.10

package/README.md

@@ -11,599 +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
+```
 
-### 类型判断 — `is`
+#### isObject(value)
 
-- **`isArray(value)`** — 判断是否为数组。
+> — 判断是否为对象（不含数组）。
 
-  ```ts
-  isArray([1, 2, 3])  // true
-  ```
+```ts
+isObject({ a: 1 }); // true
+```
 
-- **`isObject(value)`** — 判断是否为对象（不含数组）。
+#### is(val, type)
 
-  ```ts
-  isObject({ a: 1 })  // true
-  ```
+> — 通用类型判断（内部工具）。
+
+```ts
+is([], "Array"); // true
+```
 
-- **`is(val, type)`** — 通用类型判断（内部工具）。
+#### isFunction(val)
 
-  ```ts
-  is([], 'Array')  // true
-  ```
+> — 判断是否为函数。
 
-- **`isFunction(val)`** — 判断是否为函数。
+```ts
+isFunction(() => {}); // true
+```
 
-  ```ts
-  isFunction(() => {})  // true
-  ```
+#### isAsyncFunction(val)
 
-- **`isAsyncFunction(val)`** — 判断是否为异步函数。
+> — 判断是否为异步函数。
 
-  ```ts
-  isAsyncFunction(async () => {})  // true
-  ```
+```ts
+isAsyncFunction(async () => {}); // true
+```
+
+#### isPromise(value)
+
+> — 判断是否为 Promise。
+
+```ts
+isPromise(Promise.resolve()); // true
+```
+
+#### isDate(val)
+
+> — 判断是否为 Date 对象。
+
+```ts
+isDate(new Date()); // true
+```
+
+#### isNumber(val)
+
+> — 判断是否为数字（含 NaN/Infinity）。
+
+```ts
+isNumber(42); // true
+```
 
-- **`isPromise(value)`** — 判断是否为 Promise。
+#### isInt(val)
 
-  ```ts
-  isPromise(Promise.resolve())  // true
-  ```
+> — 判断是否为整数。
 
-- **`isDate(val)`** — 判断是否为 Date 对象。
+```ts
+isInt(42); // true
+```
 
-  ```ts
-  isDate(new Date())  // true
-  ```
+#### isFloat(val)
 
-- **`isNumber(val)`** — 判断是否为数字（含 NaN/Infinity）。
+> — 判断是否为浮点数。
 
-  ```ts
-  isNumber(42)  // true
-  ```
+```ts
+isFloat(3.14); // true
+```
 
-- **`isInt(val)`** — 判断是否为整数。
+#### isString(val)
 
-  ```ts
-  isInt(42)  // true
-  ```
+> — 判断是否为字符串。
 
-- **`isFloat(val)`** — 判断是否为浮点数。
+```ts
+isString("hello"); // true
+```
 
-  ```ts
-  isFloat(3.14)  // true
-  ```
+#### isBoolean(val)
 
-- **`isString(val)`** — 判断是否为字符串。
+> — 判断是否为布尔值。
 
-  ```ts
-  isString('hello')  // true
-  ```
+```ts
+isBoolean(true); // true
+```
 
-- **`isBoolean(val)`** — 判断是否为布尔值。
+#### isSymbol(value)
 
-  ```ts
-  isBoolean(true)  // true
-  ```
+> — 判断是否为 Symbol。
 
-- **`isSymbol(value)`** — 判断是否为 Symbol。
+```ts
+isSymbol(Symbol("foo")); // true
+```
 
-  ```ts
-  isSymbol(Symbol('foo'))  // true
-  ```
+#### isPrimitive(value)
 
-- **`isPrimitive(value)`** — 判断是否为原始类型。
+> — 判断是否为原始类型。
 
-  ```ts
-  isPrimitive(42)  // true
-  ```
+```ts
+isPrimitive(42); // true
+```
 
-- **`isNull(val)`** — 判断是否为 null。
+#### isNull(val)
 
-  ```ts
-  isNull(null)  // true
-  ```
+> — 判断是否为 null。
 
-- **`isDef(val)`** — 判断是否不是 undefined。
+```ts
+isNull(null); // true
+```
 
-  ```ts
-  isDef('hello')  // true
-  ```
+#### isDef(val)
 
-- **`isUnDef(val)`** — 判断是否为 undefined。
+> — 判断是否不是 undefined。
 
-  ```ts
-  isUnDef(undefined)  // true
-  ```
+```ts
+isDef("hello"); // true
+```
 
-- **`isNullOrUnDef(val)`** — 判断是否为 null 或 undefined。
+#### isUnDef(val)
 
-  ```ts
-  isNullOrUnDef(null)  // true
-  ```
+> — 判断是否为 undefined。
 
-- **`isEmpty(value)`** — 判断是否为空（完备版：支持 Date/Map/Set 等）。
+```ts
+isUnDef(undefined); // true
+```
 
-  ```ts
-  isEmpty('')   // true
-  isEmpty([])   // true
-  isEmpty({})   // true
-  ```
+#### isNullOrUnDef(val)
 
-- **`isEmptySv(value)`** — 判断是否为空（简化版）。
+> — 判断是否为 null 或 undefined。
 
-  ```ts
-  isEmptySv([])  // true
-  ```
+```ts
+isNullOrUnDef(null); // true
+```
 
-- **`isEqual(x, y)`** — 深度相等比较（支持 Date/RegExp）。
+#### isEmpty(value)
 
-  ```ts
-  isEqual({ a: 1 }, { a: 1 })  // true
-  ```
+> — 判断是否为空（完备版：支持 Date/Map/Set 等）。
 
-- **`isHexColor(str)`** — 判断是否为十六进制颜色。
+```ts
+isEmpty(""); // true
+isEmpty([]); // true
+isEmpty({}); // true
+```
 
-  ```ts
-  isHexColor('#fff')  // true
-  ```
+#### isEmptySv(value)
 
-- **`isValidEmail(email)`** — 判断是否为有效邮箱。
+> — 判断是否为空（简化版）。
 
-  ```ts
-  isValidEmail('a@b.com')  // true
-  ```
+```ts
+isEmptySv([]); // true
+```
 
-- **`isPC()`** — 判断是否为浏览器环境。
+#### isEqual(x, y)
 
-  ```ts
-  isPC()  // true
-  ```
+> — 深度相等比较（支持 Date/RegExp）。
 
-- **`isWindow(val)`** — 判断是否为 window 对象。
+```ts
+isEqual({ a: 1 }, { a: 1 }); // true
+```
 
-  ```ts
-  isWindow(window)  // true
-  ```
+#### isHexColor(str)
 
-- **`isElement(val)`** — 判断是否为 DOM 元素。
+> — 判断是否为十六进制颜色。
 
-  ```ts
-  isElement(document.body)  // true
-  ```
+```ts
+isHexColor("#fff"); // true
+```
 
-- **`isIOS()`** — 判断设备是否为 iOS。
+#### isValidEmail(email)
 
-  ```ts
-  isIOS()  // true
-  ```
+> — 判断是否为有效邮箱。
+
+```ts
+isValidEmail("a@b.com"); // true
+```
+
+#### isPC()
+
+> — 判断是否为浏览器环境。
+
+```ts
+isPC(); // true
+```
+
+#### isWindow(val)
+
+> — 判断是否为 window 对象。
+
+```ts
+isWindow(window); // true
+```
+
+#### isElement(val)
+
+> — 判断是否为 DOM 元素。
+
+```ts
+isElement(document.body); // true
+```
+
+#### isIOS()
+
+> — 判断设备是否为 iOS。
+
+```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"
-  ```
+> — 完整日期时间（短横线分隔）。
 
-- **`formatYMD(date)`** — 中文年月日。
+```ts
+formatFullReplace(new Date()); // "2026-06-03 14:30:45"
+```
 
-  ```ts
-  formatYMD(new Date())  // "2026年6月3日"
-  ```
+#### formatYMD(date)
 
-- **`formatWeek(date)`** — 星期几。
+> — 中文年月日。
 
-  ```ts
-  formatWeek(new Date())  // "星期三"
-  ```
+```ts
+formatYMD(new Date()); // "2026年6月3日"
+```
+
+#### formatWeek(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"
+```
+
+#### percentCN(value, digit)
+
+> — 百分比格式化。
+
+```ts
+percentCN(0.1234, 2); // "12.34%"
+```
 
-- **`formatNum(value)`** — 千位分隔符。
+#### compactEN(value)
 
-  ```ts
-  formatNum(1234567)  // "1,234,567"
-  ```
+> — 大数简化（英文缩写）。
 
-- **`percentCN(value, digit)`** — 百分比格式化。
+```ts
+compactEN(12345); // "12K"
+```
 
-  ```ts
-  percentCN(0.1234, 2)  // "12.34%"
-  ```
+#### compactCN(value)
 
-- **`compactEN(value)`** — 大数简化（英文缩写）。
+> — 大数简化（中文缩写）。
 
-  ```ts
-  compactEN(12345)  // "12K"
-  ```
+```ts
+compactCN(12345); // "1.2万"
+```
 
-- **`compactCN(value)`** — 大数简化（中文缩写）。
+#### signed(value, digit)
 
-  ```ts
-  compactCN(12345)  // "1.2万"
-  ```
+> — 带正负号显示。
 
-- **`signed(value, digit)`** — 带正负号显示。
+```ts
+signed(42, 1); // "+42.0"
+```
 
-  ```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"
+```
+
+#### toCamel(str)
+
+> — 下划线转驼峰。
+
+```ts
+toCamel("hello_world"); // "helloWorld"
+```
+
+#### firstUpper(str)
+
+> — 首字母大写。
 
-- **`firstLower(str)`** — 首字母小写。
+```ts
+firstUpper("hello"); // "Hello"
+```
 
-  ```ts
-  firstLower('Hello')  // "hello"
-  ```
+#### firstLower(str)
 
-- **`reverse(str)`** — 反转字符串。
+> — 首字母小写。
 
-  ```ts
-  reverse('hello')  // "olleh"
-  ```
+```ts
+firstLower("Hello"); // "hello"
+```
 
-- **`trimAll(str)`** — 去除所有空格。
+#### reverse(str)
 
-  ```ts
-  trimAll(' h e l lo ')  // "hello"
-  ```
+> — 反转字符串。
 
-- **`truncate(str, max, suffix?)`** — 超长文本截断。
+```ts
+reverse("hello"); // "olleh"
+```
 
-  ```ts
-  truncate('Hello World', 8)  // "Hello..."
-  ```
+#### trimAll(str)
 
-- **`truncateByWords(str, max, suffix?)`** — 按字数截断（中文友好）。
+> — 去除所有空格。
 
-  ```ts
-  truncateByWords('你好世界欢迎你', 4)  // "你好世界..."
-  ```
+```ts
+trimAll(" h e l lo "); // "hello"
+```
+
+#### truncate(str, max, suffix?)
+
+> — 超长文本截断。
+
+```ts
+truncate("Hello World", 8); // "Hello..."
+```
+
+#### truncateByWords(str, max, suffix?)
+
+> — 按字数截断（中文友好）。
+
+```ts
+truncateByWords("你好世界欢迎你", 4); // "你好世界..."
+```
+
+### 存储
 
 ---
 
-### 存储 — `storage`
+#### localGet<T>(key)
 
-- **`localGet<T>(key)`** — 获取 localStorage（自动 JSON 解析）。
+> — 获取 localStorage（自动 JSON 解析）。
 
-  ```ts
-  localGet('user')  // { name: '张三' }
-  ```
+```ts
+localGet("user"); // { name: '张三' }
+```
 
-- **`localSet(key, value)`** — 设置 localStorage（自动 JSON 序列化）。
+#### localSet(key, value)
 
-  ```ts
-  localSet('user', { name: '张三' })
-  ```
+> — 设置 localStorage（自动 JSON 序列化）。
 
-- **`localRm(key)`** — 移除指定 localStorage。
+```ts
+localSet("user", { name: "张三" });
+```
 
-  ```ts
-  localRm('user')
-  ```
+#### localRm(key)
 
-- **`localClear()`** — 清除所有 localStorage。
+> — 移除指定 localStorage。
 
-  ```ts
-  localClear()
-  ```
+```ts
+localRm("user");
+```
+
+#### localClear()
+
+> — 清除所有 localStorage。
+
+```ts
+localClear();
+```
+
+### 拷贝
 
 ---
 
-### 拷贝 — `copy`
+#### deepClone(obj)
+
+> — 递归深拷贝（支持 Date/RegExp/Map/Set/循环引用）。
+
+```ts
+deepClone({ a: 1, b: { c: 2 } });
+```
+
+#### deepCloneWithJSON(obj)
+
+> — JSON 深拷贝（仅 JSON 安全类型）。
+
+```ts
+deepCloneWithJSON({ a: 1 });
+```
 
-- **`deepClone(obj)`** — 递归深拷贝（支持 Date/RegExp/Map/Set/循环引用）。
+#### structClone(obj, options?)
 
-  ```ts
-  deepClone({ a: 1, b: { c: 2 } })
-  ```
+> — structuredClone 深拷贝（不支持函数/Symbol）。
+
+```ts
+structClone({ a: 1, b: { c: 2 } });
+```
 
-- **`deepCloneWithJSON(obj)`** — JSON 深拷贝（仅 JSON 安全类型）。
+#### shallowClone(obj)
 
-  ```ts
-  deepCloneWithJSON({ a: 1 })
-  ```
+> — 浅拷贝（仅第一层）。
 
-- **`shallowClone(obj)`** — 浅拷贝（仅第一层）。
+```ts
+shallowClone({ a: 1, b: { c: 2 } });
+```
 
-  ```ts
-  shallowClone({ a: 1, b: { c: 2 } })
-  ```
+### 数组
 
 ---
 
-### 数组 — `array`
+#### unique(arr)
+
+> — Set 去重。
 
-- **`unique(arr)`** — Set 去重。
+```ts
+unique([1, 2, 2, 3]); // [1, 2, 3]
+```
+
+#### uniqueByKey(arr, key)
+
+> — 对象数组按 key 去重。
+
+```ts
+uniqueByKey([{ id: 1 }, { id: 1 }], "id");
+```
 
-  ```ts
-  unique([1, 2, 2, 3])  // [1, 2, 3]
-  ```
+#### sortNumAsc(arr)
 
-- **`uniqueByKey(arr, key)`** — 对象数组按 key 去重。
+> — 数值升序。
 
-  ```ts
-  uniqueByKey([{ id: 1 }, { id: 1 }], 'id')
-  ```
+```ts
+sortNumAsc([3, 1, 2]); // [1, 2, 3]
+```
 
-- **`sortNumAsc(arr)`** — 数值升序。
+#### sortNumDesc(arr)
 
-  ```ts
-  sortNumAsc([3, 1, 2])  // [1, 2, 3]
-  ```
+> — 数值降序。
 
-- **`sortNumDesc(arr)`** — 数值降序。
+```ts
+sortNumDesc([1, 3, 2]); // [3, 2, 1]
+```
 
-  ```ts
-  sortNumDesc([1, 3, 2])  // [3, 2, 1]
-  ```
+#### sortByKey(arr, key, order?)
 
-- **`sortByKey(arr, key, order?)`** — 按对象属性排序。
+> — 按对象属性排序。
 
-  ```ts
-  sortByKey([{ age: 30 }, { age: 20 }], 'age')
-  ```
+```ts
+sortByKey([{ age: 30 }, { age: 20 }], "age");
+```
 
-- **`toArray(arrayLike)`** — 类数组转数组。
+#### toArray(arrayLike)
 
-  ```ts
-  toArray(document.querySelectorAll('div'))
-  ```
+> — 类数组转数组。
 
-- **`mergeArrays(...arrays)`** — 合并多个数组。
+```ts
+toArray(document.querySelectorAll("div"));
+```
 
-  ```ts
-  mergeArrays([1, 2], [3, 4], [5])  // [1, 2, 3, 4, 5]
-  ```
+#### mergeArrays(...arrays)
 
-- **`flatten(arr, depth?)`** — 多维数组扁平化到指定层级（默认 1 层，传 `Infinity` 完全展开）。
+> — 合并多个数组。
 
-  ```ts
-  flatten([1, [2, [3, 4]], 5])          // [1, 2, [3, 4], 5]
-  flatten([1, [2, [3, 4]], 5], Infinity) // [1, 2, 3, 4, 5]
-  ```
+```ts
+mergeArrays([1, 2], [3, 4], [5]); // [1, 2, 3, 4, 5]
+```
 
-- **`arrFind(arr, key, value)`** — 对象数组中按 key-value 查找第一个匹配项。
+#### flatten(arr, depth?)
 
-  ```ts
-  arrFind([{ id: 1 }, { id: 2 }], 'id', 2)  // { id: 2 }
-  ```
+> — 多维数组扁平化到指定层级（默认 1 层，传 `Infinity` 完全展开）。
 
-- **`groupBy(arr, key)`** — 对象数组按指定属性分组。
+```ts
+flatten([1, [2, [3, 4]], 5]); // [1, 2, [3, 4], 5]
+flatten([1, [2, [3, 4]], 5], Infinity); // [1, 2, 3, 4, 5]
+```
 
-  ```ts
-  groupBy([{ type: 'fruit' }, { type: 'vegetable' }], 'type')
-  // => { fruit: [...], vegetable: [...] }
-  ```
+#### arrFind(arr, key, value)
 
-- **`filterEmptyValues(obj)`** — 移除对象中值为空（null / undefined / 空字符串）的属性。
+> — 对象数组中按 key-value 查找第一个匹配项。
 
-  ```ts
-  filterEmptyValues({ a: 1, b: '', c: null })  // { a: 1 }
-  ```
+```ts
+arrFind([{ id: 1 }, { id: 2 }], "id", 2); // { id: 2 }
+```
 
-- **`createRange(length, mapFn?)`** — 快速生成范围数组。
+#### groupBy(arr, key)
 
-  ```ts
-  createRange(5)  // [0, 1, 2, 3, 4]
-  createRange(3, (i) => i * 2)  // [0, 2, 4]
-  ```
+> — 对象数组按指定属性分组。
 
----
+```ts
+groupBy([{ type: "fruit" }, { type: "vegetable" }], "type");
+// => { fruit: [...], vegetable: [...] }
+```
 
-### Cookie — `cookie`
+#### filterEmptyValues(obj)
 
-- **`setCookie(name, value, days?)`** — 设置 Cookie（默认7天）。
+> — 移除对象中值为空（null / undefined / 空字符串）的属性。
 
-  ```ts
-  setCookie('token', 'abc123', 30)
-  ```
+```ts
+filterEmptyValues({ a: 1, b: "", c: null }); // { a: 1 }
+```
 
-- **`getCookie(name)`** — 获取 Cookie。
+#### createRange(length, mapFn?)
 
-  ```ts
-  getCookie('token')  // "abc123"
-  ```
+> — 快速生成范围数组。
 
-- **`delCookie(name)`** — 删除 Cookie。
+```ts
+createRange(5); // [0, 1, 2, 3, 4]
+createRange(3, (i) => i * 2); // [0, 2, 4]
+```
 
-  ```ts
-  delCookie('token')
-  ```
+### 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();
+```
 
-### v1.0.9
+#### onScroll(callback)
 
-- **构建优化** — rolldown 开启 `minify: true`压缩 JS/CJS（注释/空白移除 + 变量名缩短）
-- **类型声明优化** — 移除 `.d.ts` 中冗余的 JSDoc 注释
+> — 监听滚动（rAF 节流），返回清理函数。
+
+```ts
+const off = onScroll((y) => console.log(y));
+```
 
-### v1.0.7 & v1.0.8
+#### 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'
+```

package/dist/copy/index.d.ts

@@ -1,3 +1,4 @@
 export declare function deepClone<T>(obj: T, hash?: WeakMap<any, any>): T;
 export declare function deepCloneWithJSON<T>(obj: T): T;
+export declare function structClone<T>(obj: T, options?: StructuredSerializeOptions): T;
 export declare function shallowClone<T>(obj: T): T;

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=e=>Array.isArray(e),t=e=>typeof e==`object`&&!!e&&!Array.isArray(e),n=(e,t)=>Object.prototype.toString.call(e)===`[object ${t}]`,r=e=>n(e,`Function`)||!!(e&&e.constructor&&e.call&&e.apply),i=e=>n(e,`Date`)||!!e&&e.constructor===Date,a=e=>Number(e)===e,o=e=>a(e)&&Number.isFinite(e)&&e%1==0,s=e=>a(e)&&Number.isFinite(e)&&e%1!=0,c=e=>n(e,`AsyncFunction`),l=e=>!(!e||!e.then||!r(e.then)),u=e=>n(e,`String`)||typeof e==`string`||e instanceof String,d=e=>typeof e==`boolean`||n(e,`Boolean`),f=()=>typeof window<`u`,p=e=>typeof window<`u`&&n(e,`Window`),m=e=>t(e)&&!!e.tagName,h=e=>e===null,ee=e=>/^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(e),te=()=>/iPad|iPhone|iPod/.test(navigator.userAgent),ne=e=>/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(e),re=e=>e!==void 0,g=e=>e===void 0,_=e=>g(e)||h(e),v=e=>!!e&&e.constructor===Symbol,y=e=>e==null||typeof e!=`object`&&typeof e!=`function`,b=e=>{if(e==null)return!0;if(i(e))return isNaN(e.getTime());if(r(e)||v(e)||a(e))return!1;let t=e.length;if(a(t))return t===0;let n=e.size;return a(n)?n===0:Object.keys(e).length===0};function x(e){return e==null?!0:typeof e==`string`||Array.isArray(e)?e.length===0:e instanceof Map||e instanceof Set?e.size===0:ArrayBuffer.isView(e)?e.byteLength===0:typeof e==`object`?Object.keys(e).length===0:!1}const S=(e,t)=>{if(Object.is(e,t))return!0;if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();if(e instanceof RegExp&&t instanceof RegExp)return e.toString()===t.toString();if(typeof e!=`object`||!e||typeof t!=`object`||!t)return!1;let n=Reflect.ownKeys(e),r=Reflect.ownKeys(t);if(n.length!==r.length)return!1;for(let r=0;r<n.length;r++)if(!Reflect.has(t,n[r])||!S(e[n[r]],t[n[r]]))return!1;return!0},C=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1}).format(e),w=e=>C(e).replace(/\//g,`-`),T=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`long`,day:`numeric`}).format(e),E=e=>new Intl.DateTimeFormat(`zh-CN`,{weekday:`long`}).format(e),D=(e,t)=>new Intl.NumberFormat(t.type,{style:`currency`,currency:t.currency}).format(e),O=e=>new Intl.NumberFormat(`zh-CN`).format(e),k=(e,t=0)=>new Intl.NumberFormat(`zh-CN`,{style:`percent`,minimumFractionDigits:t}).format(e),A=e=>new Intl.NumberFormat(`en-US`,{notation:`compact`,compactDisplay:`short`}).format(e),j=e=>new Intl.NumberFormat(`zh-CN`,{notation:`compact`,compactDisplay:`short`}).format(e),M=(e,t=0)=>new Intl.NumberFormat(`en-US`,{signDisplay:`always`,minimumFractionDigits:t}).format(e),N=e=>e.replace(/(\d{3})\d{4}(\d{4})/,`$1****$2`),P=e=>e.replace(/(\d{3})(\d{4})(\d{4})/,`$1 $2 $3`),F=e=>e.replace(/\b\w/g,e=>e.toUpperCase()),I=e=>e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase()),L=e=>e.replace(/([A-Z])/g,`-$1`).toLowerCase(),R=(e,t,n=`...`)=>e.length<=t?e:e.substring(0,t-n.length)+n,z=(e,t,n=`...`)=>{let r=e.split(``);return r.length<=t?e:r.slice(0,t).join(``)+n},B=e=>e.replace(/\s+/g,``),V=e=>e.replace(/_([a-z])/g,(e,t)=>t.toUpperCase()),H=e=>e.charAt(0).toUpperCase()+e.slice(1),U=e=>e.charAt(0).toLowerCase()+e.slice(1),W=e=>e.split(``).reverse().join(``),G=e=>{let t=localStorage.getItem(e);if(t===null)return null;try{return JSON.parse(t)}catch{return t}},K=(e,t)=>{localStorage.setItem(e,JSON.stringify(t))},q=e=>{localStorage.removeItem(e)},J=()=>{localStorage.clear()};function Y(e,t=new WeakMap){if(typeof e!=`object`||!e)return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof Map){let n=new Map;return t.set(e,n),e.forEach((e,r)=>{n.set(r,Y(e,t))}),n}if(e instanceof Set){let n=new Set;return t.set(e,n),e.forEach(e=>{n.add(Y(e,t))}),n}if(Array.isArray(e)){let n=[];return t.set(e,n),e.forEach((e,r)=>{n[r]=Y(e,t)}),n}let n={};return t.set(e,n),Object.keys(e).forEach(r=>{n[r]=Y(e[r],t)}),n}function X(e){return JSON.parse(JSON.stringify(e))}function ie(e){return typeof e!=`object`||!e?e:Array.isArray(e)?[...e]:{...e}}const ae=e=>[...new Set(e)],oe=(e,t)=>[...new Map(e.map(e=>[e[t],e])).values()],se=e=>[...e].sort((e,t)=>e-t),ce=e=>[...e].sort((e,t)=>t-e),le=(e,t,n=`asc`)=>[...e].sort((e,r)=>n===`asc`?e[t]-r[t]:r[t]-e[t]),ue=e=>Array.from(e),de=(...e)=>[].concat(...e),fe=(e,t=1)=>e.flat(t),pe=(e,t,n)=>e.find(e=>e[t]===n),me=(e,t)=>e.reduce((e,n)=>{let r=String(n[t]);return e[r]||(e[r]=[]),e[r].push(n),e},{}),he=e=>Object.fromEntries(Object.entries(e).filter(([,e])=>e!=null&&e!==``)),ge=(e,t)=>Array.from({length:e},(e,n)=>t?t(n):n),Z=(e,t,n=0)=>{let r=new Date;r.setDate(r.getDate()+n),document.cookie=`${encodeURIComponent(e)}=${encodeURIComponent(t)}; expires=${r.toUTCString()}; path=/`},_e=e=>{let t=document.cookie.match(RegExp(`(^| )`+encodeURIComponent(e)+`=([^;]+)`));return t?decodeURIComponent(t[2]):null},ve=e=>{Z(e,``,-1)},ye=e=>{let t={};return new URL(e||window.location.href).searchParams.forEach((e,n)=>{t[n]=e}),t},be=(e,t)=>new URL(t||window.location.href).searchParams.get(e),xe=e=>Object.entries(e).filter(([,e])=>e!=null).map(([e,t])=>`${encodeURIComponent(e)}=${encodeURIComponent(t)}`).join(`&`),Q=async e=>{if(navigator.clipboard)try{return await navigator.clipboard.writeText(e),!0}catch{return!1}let t=document.createElement(`textarea`);t.value=e,t.style.position=`fixed`,t.style.opacity=`0`,document.body.appendChild(t),t.select();let n=document.execCommand(`copy`);return document.body.removeChild(t),n},$=(e,t,n=`text/plain`)=>{let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,a.click(),URL.revokeObjectURL(i)},Se=(e,t=`data.json`)=>{$(JSON.stringify(e,null,2),t,`application/json`)},Ce=(e=`smooth`)=>{window.scrollTo({top:0,behavior:e})},we=(e=`smooth`)=>{window.scrollTo({top:document.documentElement.scrollHeight,behavior:e})},Te=e=>{let t=!1,n=()=>{t||=(requestAnimationFrame(()=>{e(window.scrollY),t=!1}),!0)};return window.addEventListener(`scroll`,n),()=>window.removeEventListener(`scroll`,n)},Ee=(e,t,n,r)=>{let i=new IntersectionObserver(e=>{e.forEach(e=>{e.isIntersecting?t(e):n&&n(e)})},r);return i.observe(e),()=>i.disconnect()},De=(e,t=300,{leading:n=!1,trailing:r=!0}={})=>{let i=null,a=null,o=r,s=(...s)=>{a=s,i===null?n&&(e(...s),o=!1):(clearTimeout(i),o=r),i=setTimeout(()=>{o&&a&&e(...a),i=a=null,o=r},t)};return s.cancel=()=>{i&&=(clearTimeout(i),a=null),o=r},s},Oe=(e,t=300,{leading:n=!0,trailing:r=!0}={})=>{let i=null,a=0,o=null,s=(...s)=>{let c=Date.now();!a&&!n&&(a=c);let l=t-(c-a);o=s,l<=0?(i&&=(clearTimeout(i),null),e(...s),a=c,o=null):r&&!i&&(i=setTimeout(()=>{i=null,a=n?Date.now():0,o&&e(...o),o=null},l))};return s.cancel=()=>{i&&=(clearTimeout(i),o=null)},s};exports.arrFind=pe,exports.camelToKebab=L,exports.capitalize=F,exports.compactCN=j,exports.compactEN=A,exports.copyToClipboard=Q,exports.createRange=ge,exports.debounce=De,exports.deepClone=Y,exports.deepCloneWithJSON=X,exports.delCookie=ve,exports.downloadFile=$,exports.exportJSON=Se,exports.filterEmptyValues=he,exports.firstLower=U,exports.firstUpper=H,exports.flatten=fe,exports.formatFull=C,exports.formatFullReplace=w,exports.formatNum=O,exports.formatRmb=D,exports.formatWeek=E,exports.formatYMD=T,exports.getCookie=_e,exports.getUrlParam=be,exports.getUrlParams=ye,exports.groupBy=me,exports.is=n,exports.isArray=e,exports.isAsyncFunction=c,exports.isBoolean=d,exports.isDate=i,exports.isDef=re,exports.isElement=m,exports.isEmpty=b,exports.isEmptySv=x,exports.isEqual=S,exports.isFloat=s,exports.isFunction=r,exports.isHexColor=ee,exports.isIOS=te,exports.isInt=o,exports.isNull=h,exports.isNullOrUnDef=_,exports.isNumber=a,exports.isObject=t,exports.isPC=f,exports.isPrimitive=y,exports.isPromise=l,exports.isString=u,exports.isSymbol=v,exports.isUnDef=g,exports.isValidEmail=ne,exports.isWindow=p,exports.kebabToCamel=I,exports.localClear=J,exports.localGet=G,exports.localRm=q,exports.localSet=K,exports.maskPhone=N,exports.mergeArrays=de,exports.observeIntersection=Ee,exports.onScroll=Te,exports.percentCN=k,exports.reverse=W,exports.scrollToBottom=we,exports.scrollToTop=Ce,exports.setCookie=Z,exports.shallowClone=ie,exports.signed=M,exports.sortByKey=le,exports.sortNumAsc=se,exports.sortNumDesc=ce,exports.spacePhone=P,exports.throttle=Oe,exports.toArray=ue,exports.toCamel=V,exports.toQueryString=xe,exports.trimAll=B,exports.truncate=R,exports.truncateByWords=z,exports.unique=ae,exports.uniqueByKey=oe;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=e=>Array.isArray(e),t=e=>typeof e==`object`&&!!e&&!Array.isArray(e),n=(e,t)=>Object.prototype.toString.call(e)===`[object ${t}]`,r=e=>n(e,`Function`)||!!(e&&e.constructor&&e.call&&e.apply),i=e=>n(e,`Date`)||!!e&&e.constructor===Date,a=e=>Number(e)===e,o=e=>a(e)&&Number.isFinite(e)&&e%1==0,s=e=>a(e)&&Number.isFinite(e)&&e%1!=0,c=e=>n(e,`AsyncFunction`),l=e=>!(!e||!e.then||!r(e.then)),u=e=>n(e,`String`)||typeof e==`string`||e instanceof String,d=e=>typeof e==`boolean`||n(e,`Boolean`),f=()=>typeof window<`u`,p=e=>typeof window<`u`&&n(e,`Window`),m=e=>t(e)&&!!e.tagName,h=e=>e===null,ee=e=>/^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(e),te=()=>/iPad|iPhone|iPod/.test(navigator.userAgent),ne=e=>/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(e),re=e=>e!==void 0,g=e=>e===void 0,_=e=>g(e)||h(e),v=e=>!!e&&e.constructor===Symbol,y=e=>e==null||typeof e!=`object`&&typeof e!=`function`,b=e=>{if(e==null)return!0;if(i(e))return isNaN(e.getTime());if(r(e)||v(e)||a(e))return!1;let t=e.length;if(a(t))return t===0;let n=e.size;return a(n)?n===0:Object.keys(e).length===0};function x(e){return e==null?!0:typeof e==`string`||Array.isArray(e)?e.length===0:e instanceof Map||e instanceof Set?e.size===0:ArrayBuffer.isView(e)?e.byteLength===0:typeof e==`object`?Object.keys(e).length===0:!1}const S=(e,t)=>{if(Object.is(e,t))return!0;if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();if(e instanceof RegExp&&t instanceof RegExp)return e.toString()===t.toString();if(typeof e!=`object`||!e||typeof t!=`object`||!t)return!1;let n=Reflect.ownKeys(e),r=Reflect.ownKeys(t);if(n.length!==r.length)return!1;for(let r=0;r<n.length;r++)if(!Reflect.has(t,n[r])||!S(e[n[r]],t[n[r]]))return!1;return!0},C=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1}).format(e),w=e=>C(e).replace(/\//g,`-`),T=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`long`,day:`numeric`}).format(e),E=e=>new Intl.DateTimeFormat(`zh-CN`,{weekday:`long`}).format(e),D=(e,t)=>new Intl.NumberFormat(t.type,{style:`currency`,currency:t.currency}).format(e),O=e=>new Intl.NumberFormat(`zh-CN`).format(e),k=(e,t=0)=>new Intl.NumberFormat(`zh-CN`,{style:`percent`,minimumFractionDigits:t}).format(e),A=e=>new Intl.NumberFormat(`en-US`,{notation:`compact`,compactDisplay:`short`}).format(e),j=e=>new Intl.NumberFormat(`zh-CN`,{notation:`compact`,compactDisplay:`short`}).format(e),M=(e,t=0)=>new Intl.NumberFormat(`en-US`,{signDisplay:`always`,minimumFractionDigits:t}).format(e),N=e=>e.replace(/(\d{3})\d{4}(\d{4})/,`$1****$2`),P=e=>e.replace(/(\d{3})(\d{4})(\d{4})/,`$1 $2 $3`),F=e=>e.replace(/\b\w/g,e=>e.toUpperCase()),I=e=>e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase()),L=e=>e.replace(/([A-Z])/g,`-$1`).toLowerCase(),R=(e,t,n=`...`)=>e.length<=t?e:e.substring(0,t-n.length)+n,z=(e,t,n=`...`)=>{let r=e.split(``);return r.length<=t?e:r.slice(0,t).join(``)+n},B=e=>e.replace(/\s+/g,``),V=e=>e.replace(/_([a-z])/g,(e,t)=>t.toUpperCase()),H=e=>e.charAt(0).toUpperCase()+e.slice(1),U=e=>e.charAt(0).toLowerCase()+e.slice(1),W=e=>e.split(``).reverse().join(``),G=e=>{let t=localStorage.getItem(e);if(t===null)return null;try{return JSON.parse(t)}catch{return t}},K=(e,t)=>{localStorage.setItem(e,JSON.stringify(t))},q=e=>{localStorage.removeItem(e)},J=()=>{localStorage.clear()};function Y(e,t=new WeakMap){if(typeof e!=`object`||!e)return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof Map){let n=new Map;return t.set(e,n),e.forEach((e,r)=>{n.set(r,Y(e,t))}),n}if(e instanceof Set){let n=new Set;return t.set(e,n),e.forEach(e=>{n.add(Y(e,t))}),n}if(Array.isArray(e)){let n=[];return t.set(e,n),e.forEach((e,r)=>{n[r]=Y(e,t)}),n}let n={};return t.set(e,n),Object.keys(e).forEach(r=>{n[r]=Y(e[r],t)}),n}function X(e){return JSON.parse(JSON.stringify(e))}function ie(e,t){return structuredClone(e,t)}function ae(e){return typeof e!=`object`||!e?e:Array.isArray(e)?[...e]:{...e}}const oe=e=>[...new Set(e)],se=(e,t)=>[...new Map(e.map(e=>[e[t],e])).values()],ce=e=>[...e].sort((e,t)=>e-t),le=e=>[...e].sort((e,t)=>t-e),ue=(e,t,n=`asc`)=>[...e].sort((e,r)=>n===`asc`?e[t]-r[t]:r[t]-e[t]),de=e=>Array.from(e),fe=(...e)=>[].concat(...e),pe=(e,t=1)=>e.flat(t),me=(e,t,n)=>e.find(e=>e[t]===n),he=(e,t)=>e.reduce((e,n)=>{let r=String(n[t]);return e[r]||(e[r]=[]),e[r].push(n),e},{}),ge=e=>Object.fromEntries(Object.entries(e).filter(([,e])=>e!=null&&e!==``)),_e=(e,t)=>Array.from({length:e},(e,n)=>t?t(n):n),Z=(e,t,n=0)=>{let r=new Date;r.setDate(r.getDate()+n),document.cookie=`${encodeURIComponent(e)}=${encodeURIComponent(t)}; expires=${r.toUTCString()}; path=/`},ve=e=>{let t=document.cookie.match(RegExp(`(^| )`+encodeURIComponent(e)+`=([^;]+)`));return t?decodeURIComponent(t[2]):null},ye=e=>{Z(e,``,-1)},be=e=>{let t={};return new URL(e||window.location.href).searchParams.forEach((e,n)=>{t[n]=e}),t},xe=(e,t)=>new URL(t||window.location.href).searchParams.get(e),Q=e=>Object.entries(e).filter(([,e])=>e!=null).map(([e,t])=>`${encodeURIComponent(e)}=${encodeURIComponent(t)}`).join(`&`),Se=async e=>{if(navigator.clipboard)try{return await navigator.clipboard.writeText(e),!0}catch{return!1}let t=document.createElement(`textarea`);t.value=e,t.style.position=`fixed`,t.style.opacity=`0`,document.body.appendChild(t),t.select();let n=document.execCommand(`copy`);return document.body.removeChild(t),n},$=(e,t,n=`text/plain`)=>{let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,a.click(),URL.revokeObjectURL(i)},Ce=(e,t=`data.json`)=>{$(JSON.stringify(e,null,2),t,`application/json`)},we=(e=`smooth`)=>{window.scrollTo({top:0,behavior:e})},Te=(e=`smooth`)=>{window.scrollTo({top:document.documentElement.scrollHeight,behavior:e})},Ee=e=>{let t=!1,n=()=>{t||=(requestAnimationFrame(()=>{e(window.scrollY),t=!1}),!0)};return window.addEventListener(`scroll`,n),()=>window.removeEventListener(`scroll`,n)},De=(e,t,n,r)=>{let i=new IntersectionObserver(e=>{e.forEach(e=>{e.isIntersecting?t(e):n&&n(e)})},r);return i.observe(e),()=>i.disconnect()},Oe=(e,t=300,{leading:n=!1,trailing:r=!0}={})=>{let i=null,a=null,o=r,s=(...s)=>{a=s,i===null?n&&(e(...s),o=!1):(clearTimeout(i),o=r),i=setTimeout(()=>{o&&a&&e(...a),i=a=null,o=r},t)};return s.cancel=()=>{i&&=(clearTimeout(i),a=null),o=r},s},ke=(e,t=300,{leading:n=!0,trailing:r=!0}={})=>{let i=null,a=0,o=null,s=(...s)=>{let c=Date.now();!a&&!n&&(a=c);let l=t-(c-a);o=s,l<=0?(i&&=(clearTimeout(i),null),e(...s),a=c,o=null):r&&!i&&(i=setTimeout(()=>{i=null,a=n?Date.now():0,o&&e(...o),o=null},l))};return s.cancel=()=>{i&&=(clearTimeout(i),o=null)},s};exports.arrFind=me,exports.camelToKebab=L,exports.capitalize=F,exports.compactCN=j,exports.compactEN=A,exports.copyToClipboard=Se,exports.createRange=_e,exports.debounce=Oe,exports.deepClone=Y,exports.deepCloneWithJSON=X,exports.delCookie=ye,exports.downloadFile=$,exports.exportJSON=Ce,exports.filterEmptyValues=ge,exports.firstLower=U,exports.firstUpper=H,exports.flatten=pe,exports.formatFull=C,exports.formatFullReplace=w,exports.formatNum=O,exports.formatRmb=D,exports.formatWeek=E,exports.formatYMD=T,exports.getCookie=ve,exports.getUrlParam=xe,exports.getUrlParams=be,exports.groupBy=he,exports.is=n,exports.isArray=e,exports.isAsyncFunction=c,exports.isBoolean=d,exports.isDate=i,exports.isDef=re,exports.isElement=m,exports.isEmpty=b,exports.isEmptySv=x,exports.isEqual=S,exports.isFloat=s,exports.isFunction=r,exports.isHexColor=ee,exports.isIOS=te,exports.isInt=o,exports.isNull=h,exports.isNullOrUnDef=_,exports.isNumber=a,exports.isObject=t,exports.isPC=f,exports.isPrimitive=y,exports.isPromise=l,exports.isString=u,exports.isSymbol=v,exports.isUnDef=g,exports.isValidEmail=ne,exports.isWindow=p,exports.kebabToCamel=I,exports.localClear=J,exports.localGet=G,exports.localRm=q,exports.localSet=K,exports.maskPhone=N,exports.mergeArrays=fe,exports.observeIntersection=De,exports.onScroll=Ee,exports.percentCN=k,exports.reverse=W,exports.scrollToBottom=Te,exports.scrollToTop=we,exports.setCookie=Z,exports.shallowClone=ae,exports.signed=M,exports.sortByKey=ue,exports.sortNumAsc=ce,exports.sortNumDesc=le,exports.spacePhone=P,exports.structClone=ie,exports.throttle=ke,exports.toArray=de,exports.toCamel=V,exports.toQueryString=Q,exports.trimAll=B,exports.truncate=R,exports.truncateByWords=z,exports.unique=oe,exports.uniqueByKey=se;

package/dist/index.js

@@ -1 +1 @@
-const e=e=>Array.isArray(e),t=e=>typeof e==`object`&&!!e&&!Array.isArray(e),n=(e,t)=>Object.prototype.toString.call(e)===`[object ${t}]`,r=e=>n(e,`Function`)||!!(e&&e.constructor&&e.call&&e.apply),i=e=>n(e,`Date`)||!!e&&e.constructor===Date,a=e=>Number(e)===e,o=e=>a(e)&&Number.isFinite(e)&&e%1==0,s=e=>a(e)&&Number.isFinite(e)&&e%1!=0,c=e=>n(e,`AsyncFunction`),l=e=>!(!e||!e.then||!r(e.then)),u=e=>n(e,`String`)||typeof e==`string`||e instanceof String,d=e=>typeof e==`boolean`||n(e,`Boolean`),f=()=>typeof window<`u`,p=e=>typeof window<`u`&&n(e,`Window`),m=e=>t(e)&&!!e.tagName,h=e=>e===null,ee=e=>/^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(e),te=()=>/iPad|iPhone|iPod/.test(navigator.userAgent),ne=e=>/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(e),re=e=>e!==void 0,g=e=>e===void 0,_=e=>g(e)||h(e),v=e=>!!e&&e.constructor===Symbol,y=e=>e==null||typeof e!=`object`&&typeof e!=`function`,b=e=>{if(e==null)return!0;if(i(e))return isNaN(e.getTime());if(r(e)||v(e)||a(e))return!1;let t=e.length;if(a(t))return t===0;let n=e.size;return a(n)?n===0:Object.keys(e).length===0};function x(e){return e==null?!0:typeof e==`string`||Array.isArray(e)?e.length===0:e instanceof Map||e instanceof Set?e.size===0:ArrayBuffer.isView(e)?e.byteLength===0:typeof e==`object`?Object.keys(e).length===0:!1}const S=(e,t)=>{if(Object.is(e,t))return!0;if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();if(e instanceof RegExp&&t instanceof RegExp)return e.toString()===t.toString();if(typeof e!=`object`||!e||typeof t!=`object`||!t)return!1;let n=Reflect.ownKeys(e),r=Reflect.ownKeys(t);if(n.length!==r.length)return!1;for(let r=0;r<n.length;r++)if(!Reflect.has(t,n[r])||!S(e[n[r]],t[n[r]]))return!1;return!0},C=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1}).format(e),w=e=>C(e).replace(/\//g,`-`),T=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`long`,day:`numeric`}).format(e),E=e=>new Intl.DateTimeFormat(`zh-CN`,{weekday:`long`}).format(e),D=(e,t)=>new Intl.NumberFormat(t.type,{style:`currency`,currency:t.currency}).format(e),O=e=>new Intl.NumberFormat(`zh-CN`).format(e),k=(e,t=0)=>new Intl.NumberFormat(`zh-CN`,{style:`percent`,minimumFractionDigits:t}).format(e),A=e=>new Intl.NumberFormat(`en-US`,{notation:`compact`,compactDisplay:`short`}).format(e),j=e=>new Intl.NumberFormat(`zh-CN`,{notation:`compact`,compactDisplay:`short`}).format(e),M=(e,t=0)=>new Intl.NumberFormat(`en-US`,{signDisplay:`always`,minimumFractionDigits:t}).format(e),N=e=>e.replace(/(\d{3})\d{4}(\d{4})/,`$1****$2`),P=e=>e.replace(/(\d{3})(\d{4})(\d{4})/,`$1 $2 $3`),F=e=>e.replace(/\b\w/g,e=>e.toUpperCase()),I=e=>e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase()),L=e=>e.replace(/([A-Z])/g,`-$1`).toLowerCase(),R=(e,t,n=`...`)=>e.length<=t?e:e.substring(0,t-n.length)+n,z=(e,t,n=`...`)=>{let r=e.split(``);return r.length<=t?e:r.slice(0,t).join(``)+n},B=e=>e.replace(/\s+/g,``),V=e=>e.replace(/_([a-z])/g,(e,t)=>t.toUpperCase()),H=e=>e.charAt(0).toUpperCase()+e.slice(1),U=e=>e.charAt(0).toLowerCase()+e.slice(1),W=e=>e.split(``).reverse().join(``),G=e=>{let t=localStorage.getItem(e);if(t===null)return null;try{return JSON.parse(t)}catch{return t}},K=(e,t)=>{localStorage.setItem(e,JSON.stringify(t))},q=e=>{localStorage.removeItem(e)},J=()=>{localStorage.clear()};function Y(e,t=new WeakMap){if(typeof e!=`object`||!e)return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof Map){let n=new Map;return t.set(e,n),e.forEach((e,r)=>{n.set(r,Y(e,t))}),n}if(e instanceof Set){let n=new Set;return t.set(e,n),e.forEach(e=>{n.add(Y(e,t))}),n}if(Array.isArray(e)){let n=[];return t.set(e,n),e.forEach((e,r)=>{n[r]=Y(e,t)}),n}let n={};return t.set(e,n),Object.keys(e).forEach(r=>{n[r]=Y(e[r],t)}),n}function X(e){return JSON.parse(JSON.stringify(e))}function ie(e){return typeof e!=`object`||!e?e:Array.isArray(e)?[...e]:{...e}}const ae=e=>[...new Set(e)],oe=(e,t)=>[...new Map(e.map(e=>[e[t],e])).values()],se=e=>[...e].sort((e,t)=>e-t),ce=e=>[...e].sort((e,t)=>t-e),le=(e,t,n=`asc`)=>[...e].sort((e,r)=>n===`asc`?e[t]-r[t]:r[t]-e[t]),ue=e=>Array.from(e),de=(...e)=>[].concat(...e),fe=(e,t=1)=>e.flat(t),pe=(e,t,n)=>e.find(e=>e[t]===n),me=(e,t)=>e.reduce((e,n)=>{let r=String(n[t]);return e[r]||(e[r]=[]),e[r].push(n),e},{}),he=e=>Object.fromEntries(Object.entries(e).filter(([,e])=>e!=null&&e!==``)),ge=(e,t)=>Array.from({length:e},(e,n)=>t?t(n):n),Z=(e,t,n=0)=>{let r=new Date;r.setDate(r.getDate()+n),document.cookie=`${encodeURIComponent(e)}=${encodeURIComponent(t)}; expires=${r.toUTCString()}; path=/`},_e=e=>{let t=document.cookie.match(RegExp(`(^| )`+encodeURIComponent(e)+`=([^;]+)`));return t?decodeURIComponent(t[2]):null},ve=e=>{Z(e,``,-1)},ye=e=>{let t={};return new URL(e||window.location.href).searchParams.forEach((e,n)=>{t[n]=e}),t},be=(e,t)=>new URL(t||window.location.href).searchParams.get(e),xe=e=>Object.entries(e).filter(([,e])=>e!=null).map(([e,t])=>`${encodeURIComponent(e)}=${encodeURIComponent(t)}`).join(`&`),Q=async e=>{if(navigator.clipboard)try{return await navigator.clipboard.writeText(e),!0}catch{return!1}let t=document.createElement(`textarea`);t.value=e,t.style.position=`fixed`,t.style.opacity=`0`,document.body.appendChild(t),t.select();let n=document.execCommand(`copy`);return document.body.removeChild(t),n},$=(e,t,n=`text/plain`)=>{let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,a.click(),URL.revokeObjectURL(i)},Se=(e,t=`data.json`)=>{$(JSON.stringify(e,null,2),t,`application/json`)},Ce=(e=`smooth`)=>{window.scrollTo({top:0,behavior:e})},we=(e=`smooth`)=>{window.scrollTo({top:document.documentElement.scrollHeight,behavior:e})},Te=e=>{let t=!1,n=()=>{t||=(requestAnimationFrame(()=>{e(window.scrollY),t=!1}),!0)};return window.addEventListener(`scroll`,n),()=>window.removeEventListener(`scroll`,n)},Ee=(e,t,n,r)=>{let i=new IntersectionObserver(e=>{e.forEach(e=>{e.isIntersecting?t(e):n&&n(e)})},r);return i.observe(e),()=>i.disconnect()},De=(e,t=300,{leading:n=!1,trailing:r=!0}={})=>{let i=null,a=null,o=r,s=(...s)=>{a=s,i===null?n&&(e(...s),o=!1):(clearTimeout(i),o=r),i=setTimeout(()=>{o&&a&&e(...a),i=a=null,o=r},t)};return s.cancel=()=>{i&&=(clearTimeout(i),a=null),o=r},s},Oe=(e,t=300,{leading:n=!0,trailing:r=!0}={})=>{let i=null,a=0,o=null,s=(...s)=>{let c=Date.now();!a&&!n&&(a=c);let l=t-(c-a);o=s,l<=0?(i&&=(clearTimeout(i),null),e(...s),a=c,o=null):r&&!i&&(i=setTimeout(()=>{i=null,a=n?Date.now():0,o&&e(...o),o=null},l))};return s.cancel=()=>{i&&=(clearTimeout(i),o=null)},s};export{pe as arrFind,L as camelToKebab,F as capitalize,j as compactCN,A as compactEN,Q as copyToClipboard,ge as createRange,De as debounce,Y as deepClone,X as deepCloneWithJSON,ve as delCookie,$ as downloadFile,Se as exportJSON,he as filterEmptyValues,U as firstLower,H as firstUpper,fe as flatten,C as formatFull,w as formatFullReplace,O as formatNum,D as formatRmb,E as formatWeek,T as formatYMD,_e as getCookie,be as getUrlParam,ye as getUrlParams,me as groupBy,n as is,e as isArray,c as isAsyncFunction,d as isBoolean,i as isDate,re as isDef,m as isElement,b as isEmpty,x as isEmptySv,S as isEqual,s as isFloat,r as isFunction,ee as isHexColor,te as isIOS,o as isInt,h as isNull,_ as isNullOrUnDef,a as isNumber,t as isObject,f as isPC,y as isPrimitive,l as isPromise,u as isString,v as isSymbol,g as isUnDef,ne as isValidEmail,p as isWindow,I as kebabToCamel,J as localClear,G as localGet,q as localRm,K as localSet,N as maskPhone,de as mergeArrays,Ee as observeIntersection,Te as onScroll,k as percentCN,W as reverse,we as scrollToBottom,Ce as scrollToTop,Z as setCookie,ie as shallowClone,M as signed,le as sortByKey,se as sortNumAsc,ce as sortNumDesc,P as spacePhone,Oe as throttle,ue as toArray,V as toCamel,xe as toQueryString,B as trimAll,R as truncate,z as truncateByWords,ae as unique,oe as uniqueByKey};
+const e=e=>Array.isArray(e),t=e=>typeof e==`object`&&!!e&&!Array.isArray(e),n=(e,t)=>Object.prototype.toString.call(e)===`[object ${t}]`,r=e=>n(e,`Function`)||!!(e&&e.constructor&&e.call&&e.apply),i=e=>n(e,`Date`)||!!e&&e.constructor===Date,a=e=>Number(e)===e,o=e=>a(e)&&Number.isFinite(e)&&e%1==0,s=e=>a(e)&&Number.isFinite(e)&&e%1!=0,c=e=>n(e,`AsyncFunction`),l=e=>!(!e||!e.then||!r(e.then)),u=e=>n(e,`String`)||typeof e==`string`||e instanceof String,d=e=>typeof e==`boolean`||n(e,`Boolean`),f=()=>typeof window<`u`,p=e=>typeof window<`u`&&n(e,`Window`),m=e=>t(e)&&!!e.tagName,h=e=>e===null,ee=e=>/^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(e),te=()=>/iPad|iPhone|iPod/.test(navigator.userAgent),ne=e=>/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(e),re=e=>e!==void 0,g=e=>e===void 0,_=e=>g(e)||h(e),v=e=>!!e&&e.constructor===Symbol,y=e=>e==null||typeof e!=`object`&&typeof e!=`function`,b=e=>{if(e==null)return!0;if(i(e))return isNaN(e.getTime());if(r(e)||v(e)||a(e))return!1;let t=e.length;if(a(t))return t===0;let n=e.size;return a(n)?n===0:Object.keys(e).length===0};function x(e){return e==null?!0:typeof e==`string`||Array.isArray(e)?e.length===0:e instanceof Map||e instanceof Set?e.size===0:ArrayBuffer.isView(e)?e.byteLength===0:typeof e==`object`?Object.keys(e).length===0:!1}const S=(e,t)=>{if(Object.is(e,t))return!0;if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();if(e instanceof RegExp&&t instanceof RegExp)return e.toString()===t.toString();if(typeof e!=`object`||!e||typeof t!=`object`||!t)return!1;let n=Reflect.ownKeys(e),r=Reflect.ownKeys(t);if(n.length!==r.length)return!1;for(let r=0;r<n.length;r++)if(!Reflect.has(t,n[r])||!S(e[n[r]],t[n[r]]))return!1;return!0},C=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1}).format(e),w=e=>C(e).replace(/\//g,`-`),T=e=>new Intl.DateTimeFormat(`zh-CN`,{year:`numeric`,month:`long`,day:`numeric`}).format(e),E=e=>new Intl.DateTimeFormat(`zh-CN`,{weekday:`long`}).format(e),D=(e,t)=>new Intl.NumberFormat(t.type,{style:`currency`,currency:t.currency}).format(e),O=e=>new Intl.NumberFormat(`zh-CN`).format(e),k=(e,t=0)=>new Intl.NumberFormat(`zh-CN`,{style:`percent`,minimumFractionDigits:t}).format(e),A=e=>new Intl.NumberFormat(`en-US`,{notation:`compact`,compactDisplay:`short`}).format(e),j=e=>new Intl.NumberFormat(`zh-CN`,{notation:`compact`,compactDisplay:`short`}).format(e),M=(e,t=0)=>new Intl.NumberFormat(`en-US`,{signDisplay:`always`,minimumFractionDigits:t}).format(e),N=e=>e.replace(/(\d{3})\d{4}(\d{4})/,`$1****$2`),P=e=>e.replace(/(\d{3})(\d{4})(\d{4})/,`$1 $2 $3`),F=e=>e.replace(/\b\w/g,e=>e.toUpperCase()),I=e=>e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase()),L=e=>e.replace(/([A-Z])/g,`-$1`).toLowerCase(),R=(e,t,n=`...`)=>e.length<=t?e:e.substring(0,t-n.length)+n,z=(e,t,n=`...`)=>{let r=e.split(``);return r.length<=t?e:r.slice(0,t).join(``)+n},B=e=>e.replace(/\s+/g,``),V=e=>e.replace(/_([a-z])/g,(e,t)=>t.toUpperCase()),H=e=>e.charAt(0).toUpperCase()+e.slice(1),U=e=>e.charAt(0).toLowerCase()+e.slice(1),W=e=>e.split(``).reverse().join(``),G=e=>{let t=localStorage.getItem(e);if(t===null)return null;try{return JSON.parse(t)}catch{return t}},K=(e,t)=>{localStorage.setItem(e,JSON.stringify(t))},q=e=>{localStorage.removeItem(e)},J=()=>{localStorage.clear()};function Y(e,t=new WeakMap){if(typeof e!=`object`||!e)return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof Map){let n=new Map;return t.set(e,n),e.forEach((e,r)=>{n.set(r,Y(e,t))}),n}if(e instanceof Set){let n=new Set;return t.set(e,n),e.forEach(e=>{n.add(Y(e,t))}),n}if(Array.isArray(e)){let n=[];return t.set(e,n),e.forEach((e,r)=>{n[r]=Y(e,t)}),n}let n={};return t.set(e,n),Object.keys(e).forEach(r=>{n[r]=Y(e[r],t)}),n}function X(e){return JSON.parse(JSON.stringify(e))}function ie(e,t){return structuredClone(e,t)}function ae(e){return typeof e!=`object`||!e?e:Array.isArray(e)?[...e]:{...e}}const oe=e=>[...new Set(e)],se=(e,t)=>[...new Map(e.map(e=>[e[t],e])).values()],ce=e=>[...e].sort((e,t)=>e-t),le=e=>[...e].sort((e,t)=>t-e),ue=(e,t,n=`asc`)=>[...e].sort((e,r)=>n===`asc`?e[t]-r[t]:r[t]-e[t]),de=e=>Array.from(e),fe=(...e)=>[].concat(...e),pe=(e,t=1)=>e.flat(t),me=(e,t,n)=>e.find(e=>e[t]===n),he=(e,t)=>e.reduce((e,n)=>{let r=String(n[t]);return e[r]||(e[r]=[]),e[r].push(n),e},{}),ge=e=>Object.fromEntries(Object.entries(e).filter(([,e])=>e!=null&&e!==``)),_e=(e,t)=>Array.from({length:e},(e,n)=>t?t(n):n),Z=(e,t,n=0)=>{let r=new Date;r.setDate(r.getDate()+n),document.cookie=`${encodeURIComponent(e)}=${encodeURIComponent(t)}; expires=${r.toUTCString()}; path=/`},ve=e=>{let t=document.cookie.match(RegExp(`(^| )`+encodeURIComponent(e)+`=([^;]+)`));return t?decodeURIComponent(t[2]):null},ye=e=>{Z(e,``,-1)},be=e=>{let t={};return new URL(e||window.location.href).searchParams.forEach((e,n)=>{t[n]=e}),t},xe=(e,t)=>new URL(t||window.location.href).searchParams.get(e),Q=e=>Object.entries(e).filter(([,e])=>e!=null).map(([e,t])=>`${encodeURIComponent(e)}=${encodeURIComponent(t)}`).join(`&`),Se=async e=>{if(navigator.clipboard)try{return await navigator.clipboard.writeText(e),!0}catch{return!1}let t=document.createElement(`textarea`);t.value=e,t.style.position=`fixed`,t.style.opacity=`0`,document.body.appendChild(t),t.select();let n=document.execCommand(`copy`);return document.body.removeChild(t),n},$=(e,t,n=`text/plain`)=>{let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,a.click(),URL.revokeObjectURL(i)},Ce=(e,t=`data.json`)=>{$(JSON.stringify(e,null,2),t,`application/json`)},we=(e=`smooth`)=>{window.scrollTo({top:0,behavior:e})},Te=(e=`smooth`)=>{window.scrollTo({top:document.documentElement.scrollHeight,behavior:e})},Ee=e=>{let t=!1,n=()=>{t||=(requestAnimationFrame(()=>{e(window.scrollY),t=!1}),!0)};return window.addEventListener(`scroll`,n),()=>window.removeEventListener(`scroll`,n)},De=(e,t,n,r)=>{let i=new IntersectionObserver(e=>{e.forEach(e=>{e.isIntersecting?t(e):n&&n(e)})},r);return i.observe(e),()=>i.disconnect()},Oe=(e,t=300,{leading:n=!1,trailing:r=!0}={})=>{let i=null,a=null,o=r,s=(...s)=>{a=s,i===null?n&&(e(...s),o=!1):(clearTimeout(i),o=r),i=setTimeout(()=>{o&&a&&e(...a),i=a=null,o=r},t)};return s.cancel=()=>{i&&=(clearTimeout(i),a=null),o=r},s},ke=(e,t=300,{leading:n=!0,trailing:r=!0}={})=>{let i=null,a=0,o=null,s=(...s)=>{let c=Date.now();!a&&!n&&(a=c);let l=t-(c-a);o=s,l<=0?(i&&=(clearTimeout(i),null),e(...s),a=c,o=null):r&&!i&&(i=setTimeout(()=>{i=null,a=n?Date.now():0,o&&e(...o),o=null},l))};return s.cancel=()=>{i&&=(clearTimeout(i),o=null)},s};export{me as arrFind,L as camelToKebab,F as capitalize,j as compactCN,A as compactEN,Se as copyToClipboard,_e as createRange,Oe as debounce,Y as deepClone,X as deepCloneWithJSON,ye as delCookie,$ as downloadFile,Ce as exportJSON,ge as filterEmptyValues,U as firstLower,H as firstUpper,pe as flatten,C as formatFull,w as formatFullReplace,O as formatNum,D as formatRmb,E as formatWeek,T as formatYMD,ve as getCookie,xe as getUrlParam,be as getUrlParams,he as groupBy,n as is,e as isArray,c as isAsyncFunction,d as isBoolean,i as isDate,re as isDef,m as isElement,b as isEmpty,x as isEmptySv,S as isEqual,s as isFloat,r as isFunction,ee as isHexColor,te as isIOS,o as isInt,h as isNull,_ as isNullOrUnDef,a as isNumber,t as isObject,f as isPC,y as isPrimitive,l as isPromise,u as isString,v as isSymbol,g as isUnDef,ne as isValidEmail,p as isWindow,I as kebabToCamel,J as localClear,G as localGet,q as localRm,K as localSet,N as maskPhone,fe as mergeArrays,De as observeIntersection,Ee as onScroll,k as percentCN,W as reverse,Te as scrollToBottom,we as scrollToTop,Z as setCookie,ae as shallowClone,M as signed,ue as sortByKey,ce as sortNumAsc,le as sortNumDesc,P as spacePhone,ie as structClone,ke as throttle,de as toArray,V as toCamel,Q as toQueryString,B as trimAll,R as truncate,z as truncateByWords,oe as unique,se as uniqueByKey};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pen-it",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "用笔锚定记忆中的前端常用工具函数，一个轻量级的前端实用程序库，支持类型检查、日期/数字格式化、字符串操作、数据存储、深度克隆、数组操作、Cookie 以及浏览器 API",
   "type": "module",
   "main": "dist/index.cjs",