pen-it 1.0.0

package/README.md

@@ -0,0 +1,200 @@
+# pen-it
+
+> 前端常用工具函数，笔笔记下，随手即用
+
+一个轻量级的前端工具函数库，涵盖类型判断、日期格式化、数字格式化、字符串处理、存储操作、深拷贝、数组操作、Cookie 操作、浏览器 API 等常用场景。
+
+## 安装
+
+```bash
+pnpm add pen-it
+```
+
+## 使用
+
+```ts
+import { isArray, formatFull, deepClone, unique } from 'pen-it'
+```
+
+---
+
+## API
+
+### 类型判断 — `is`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `isArray(value)` | 判断是否为数组 | `isArray([1,2,3]) // true` |
+| `isObject(value)` | 判断是否为对象（不含数组） | `isObject({a:1}) // true` |
+| `is(val, type)` | 通用类型判断（内部工具） | `is([], "Array") // true` |
+| `isFunction(val)` | 判断是否为函数 | `isFunction(()=>{}) // true` |
+| `isAsyncFunction(val)` | 判断是否为异步函数 | `isAsyncFunction(async ()=>{}) // true` |
+| `isPromise(value)` | 判断是否为 Promise | `isPromise(Promise.resolve()) // true` |
+| `isDate(val)` | 判断是否为 Date 对象 | `isDate(new Date()) // true` |
+| `isNumber(val)` | 判断是否为数字（含 NaN/Infinity） | `isNumber(42) // true` |
+| `isInt(val)` | 判断是否为整数 | `isInt(42) // true` |
+| `isFloat(val)` | 判断是否为浮点数 | `isFloat(3.14) // true` |
+| `isString(val)` | 判断是否为字符串 | `isString("hello") // true` |
+| `isBoolean(val)` | 判断是否为布尔值 | `isBoolean(true) // true` |
+| `isSymbol(value)` | 判断是否为 Symbol | `isSymbol(Symbol("foo")) // true` |
+| `isPrimitive(value)` | 判断是否为原始类型 | `isPrimitive(42) // true` |
+| `isNull(val)` | 判断是否为 null | `isNull(null) // true` |
+| `isDef(val)` | 判断是否不是 undefined | `isDef("hello") // true` |
+| `isUnDef(val)` | 判断是否为 undefined | `isUnDef(undefined) // true` |
+| `isNullOrUnDef(val)` | 判断是否为 null 或 undefined | `isNullOrUnDef(null) // true` |
+| `isEmpty(value)` | 判断是否为空（完备版：支持 Date/Map/Set 等） | `isEmpty("") // true` |
+| `isEmptySv(value)` | 判断是否为空（简化版） | `isEmptySv([]) // true` |
+| `isEqual(x, y)` | 深度相等比较（支持 Date/RegExp） | `isEqual({a:1}, {a:1}) // true` |
+| `isHexColor(str)` | 判断是否为十六进制颜色 | `isHexColor("#fff") // true` |
+| `isValidEmail(email)` | 判断是否为有效邮箱 | `isValidEmail("a@b.com") // true` |
+| `isPC()` | 判断是否为浏览器环境 | `isPC() // true` |
+| `isWindow(val)` | 判断是否为 window 对象 | `isWindow(window) // true` |
+| `isElement(val)` | 判断是否为 DOM 元素 | `isElement(document.body) // true` |
+| `isIOS()` | 判断设备是否为 iOS | `isIOS() // true` |
+
+---
+
+### 日期时间格式化 — `format`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `formatFull(date)` | 完整日期时间（斜杠分隔） | `"2026/06/03 14:30:45"` |
+| `formatFullReplace(date)` | 完整日期时间（短横线分隔） | `"2026-06-03 14:30:45"` |
+| `formatYMD(date)` | 中文年月日 | `"2026年6月3日"` |
+| `formatWeek(date)` | 星期几 | `"星期三"` |
+
+---
+
+### 数字与货币格式化 — `format`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `formatRmb(value, options)` | 货币格式化（人民币） | `formatRmb(1234.56, { type: "zh-CN", currency: "CNY" }) // "¥1,234.56"` |
+| `formatNum(value)` | 千位分隔符 | `formatNum(1234567) // "1,234,567"` |
+| `percentCN(value, digit)` | 百分比格式化 | `percentCN(0.1234, 2) // "12.34%"` |
+| `compactEN(value)` | 大数简化（英文缩写） | `compactEN(12345) // "12K"` |
+| `compactCN(value)` | 大数简化（中文缩写） | `compactCN(12345) // "1.2万"` |
+| `signed(value, digit)` | 带正负号显示 | `signed(42, 1) // "+42.0"` |
+
+---
+
+### 字符串处理 — `format`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `maskPhone(phone)` | 手机号脱敏（隐藏中间4位） | `maskPhone("13812345678") // "138****5678"` |
+| `spacePhone(phone)` | 手机号空格分隔 | `spacePhone("13812345678") // "138 1234 5678"` |
+| `capitalize(str)` | 每个单词首字母大写 | `capitalize("hello world") // "Hello World"` |
+| `kebabToCamel(str)` | 短横线转小驼峰 | `kebabToCamel("hello-world") // "helloWorld"` |
+| `camelToKebab(str)` | 驼峰转短横线 | `camelToKebab("helloWorld") // "hello-world"` |
+| `toCamel(str)` | 下划线转驼峰 | `toCamel("hello_world") // "helloWorld"` |
+| `firstUpper(str)` | 首字母大写 | `firstUpper("hello") // "Hello"` |
+| `firstLower(str)` | 首字母小写 | `firstLower("Hello") // "hello"` |
+| `reverse(str)` | 反转字符串 | `reverse("hello") // "olleh"` |
+| `trimAll(str)` | 去除所有空格 | `trimAll(" h e l lo ") // "hello"` |
+| `truncate(str, max, suffix?)` | 超长文本截断 | `truncate("Hello World", 8) // "Hello..."` |
+| `truncateByWords(str, max, suffix?)` | 按字数截断（中文友好） | `truncateByWords("你好世界欢迎你", 4) // "你好世界..."` |
+
+---
+
+### 存储 — `storage`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `localGet<T>(key)` | 获取 localStorage（自动 JSON 解析） | `localGet("user") // { name: "张三" }` |
+| `localSet(key, value)` | 设置 localStorage（自动 JSON 序列化） | `localSet("user", { name: "张三" })` |
+| `localRm(key)` | 移除指定 localStorage | `localRm("user")` |
+| `localClear()` | 清除所有 localStorage | `localClear()` |
+
+---
+
+### 拷贝 — `copy`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `deepClone(obj)` | 递归深拷贝（支持 Date/RegExp/Map/Set/循环引用） | `deepClone({a:1, b:{c:2}})` |
+| `deepCloneWithJSON(obj)` | JSON 深拷贝（仅 JSON 安全类型） | `deepCloneWithJSON({a:1})` |
+| `shallowClone(obj)` | 浅拷贝（仅第一层） | `shallowClone({a:1, b:{c:2}})` |
+
+---
+
+### 数组 — `array`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `unique(arr)` | Set 去重 | `unique([1,2,2,3]) // [1,2,3]` |
+| `uniqueByKey(arr, key)` | 对象数组按 key 去重 | `uniqueByKey([{id:1},{id:1}], "id")` |
+| `sortNumAsc(arr)` | 数值升序 | `sortNumAsc([3,1,2]) // [1,2,3]` |
+| `sortNumDesc(arr)` | 数值降序 | `sortNumDesc([1,3,2]) // [3,2,1]` |
+| `sortByKey(arr, key, order?)` | 按对象属性排序 | `sortByKey([{age:30},{age:20}], "age")` |
+| `toArray(arrayLike)` | 类数组转数组 | `toArray(document.querySelectorAll("div"))` |
+
+---
+
+### Cookie — `cookie`
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `setCookie(name, value, days?)` | 设置 Cookie（默认7天） | `setCookie("token", "abc123", 30)` |
+| `getCookie(name)` | 获取 Cookie | `getCookie("token") // "abc123"` |
+| `delCookie(name)` | 删除 Cookie | `delCookie("token")` |
+
+---
+
+### 浏览器工具 — `browser`
+
+#### URL 参数
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `getUrlParams(url?)` | 获取 URL 参数对象 | `getUrlParams("?a=1&b=2") // {a:"1",b:"2"}` |
+| `getUrlParam(key, url?)` | 获取单个 URL 参数 | `getUrlParam("a") // "1"` |
+| `toQueryString(params)` | 对象转 URL 参数字符串 | `toQueryString({a:1,b:"hello"}) // "a=1&b=hello"` |
+
+#### 剪贴板与文件
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `copyToClipboard(text)` | 复制文本到剪贴板（支持降级） | `await copyToClipboard("Hello")` |
+| `downloadFile(content, filename, mimeType?)` | 下载文件（Blob） | `downloadFile("Hello", "hello.txt")` |
+| `exportJSON(data, filename?)` | 导出 JSON 为文件 | `exportJSON({name:"张三"})` |
+
+#### 页面滚动
+
+| 函数 | 说明 | 示例 |
+|------|------|------|
+| `scrollToTop(behavior?)` | 滚动到顶部（默认平滑） | `scrollToTop()` |
+| `scrollToBottom(behavior?)` | 滚动到底部（默认平滑） | `scrollToBottom()` |
+| `onScroll(callback)` | 监听滚动（rAF 节流），返回清理函数 | `const off = onScroll(y => console.log(y))` |
+
+---
+
+## 项目结构
+
+```
+pen-it/
+├── dist/                   # 构建输出（CJS + ESM + .d.ts）
+├── src/                    # 源码
+│   ├── index.ts            # 统一导出入口
+│   ├── is/                 # 类型判断（28个函数）
+│   ├── format/             # 日期/数字/字符串格式化（22个函数）
+│   ├── storage/            # localStorage 操作（4个函数）
+│   ├── copy/               # 深拷贝/浅拷贝（3个函数）
+│   ├── array/              # 去重/排序/转换（6个函数）
+│   ├── cookie/             # Cookie 操作（3个函数）
+│   └── browser/            # URL参数/剪贴板/文件下载/滚动（9个函数）
+├── tests/                  # 单元测试
+│   ├── is.test.ts
+│   ├── format.test.ts
+│   ├── storage.test.ts
+│   ├── copy.test.ts
+│   ├── array.test.ts
+│   ├── cookie.test.ts
+│   └── browser.test.ts
+├── package.json            # 包配置（入口、脚本、依赖）
+├── tsconfig.json           # TypeScript 编译配置
+├── rolldown.config.js      # 打包配置（Rolldown）
+├── vitest.config.ts        # 测试配置（Vitest）
+├── pnpm-lock.yaml
+└── dist/                   # 构建输出（CJS + ESM + .d.ts）
+```

package/dist/array/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Set 去重
+ * @param arr - 数组
+ * @returns 去重后的数组
+ * @example
+ * unique([1, 2, 2, 3])
+ * // => [1, 2, 3]
+ */
+export declare const unique: <T>(arr: T[]) => T[];
+/**
+ * 对象数组按 key 去重
+ * @param arr - 对象数组
+ * @param key - 用于去重判定的键名
+ * @returns 去重后的数组
+ * @example
+ * uniqueByKey([{ id: 1, name: "a" }, { id: 1, name: "b" }], "id")
+ * // => [{ id: 1, name: "a" }]
+ */
+export declare const uniqueByKey: <T extends Record<string, any>>(arr: T[], key: keyof T) => T[];
+/**
+ * 数值升序
+ * @param arr - 数值数组
+ * @returns 升序排序后的新数组
+ * @example
+ * sortNumAsc([3, 1, 2])
+ * // => [1, 2, 3]
+ */
+export declare const sortNumAsc: (arr: number[]) => number[];
+/**
+ * 数值降序
+ * @param arr - 数值数组
+ * @returns 降序排序后的新数组
+ * @example
+ * sortNumDesc([1, 3, 2])
+ * // => [3, 2, 1]
+ */
+export declare const sortNumDesc: (arr: number[]) => number[];
+/**
+ * 按对象属性排序
+ * @param arr - 对象数组
+ * @param key - 用于排序的属性名
+ * @param order - 排序方向，"asc" 升序 / "desc" 降序，默认 "asc"
+ * @returns 排序后的新数组
+ * @example
+ * sortByKey([{ age: 30 }, { age: 20 }], "age", "asc")
+ * // => [{ age: 20 }, { age: 30 }]
+ */
+export declare const sortByKey: <T extends Record<string, any>>(arr: T[], key: keyof T, order?: "asc" | "desc") => T[];
+/**
+ * 类数组转数组
+ * @param arrayLike - 类数组对象（如 NodeList、arguments）
+ * @returns 转换后的数组
+ * @example
+ * toArray(document.querySelectorAll("div"))
+ * // => [div, div, ...]
+ */
+export declare const toArray: <T>(arrayLike: ArrayLike<T>) => T[];

package/dist/browser/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 获取 URL 参数对象
+ * @param url - URL 字符串，默认使用当前页面地址
+ * @returns 参数键值对对象
+ * @example
+ * getUrlParams("https://example.com?a=1&b=2")
+ * // => { a: "1", b: "2" }
+ */
+export declare const getUrlParams: (url?: string) => Record<string, string>;
+/**
+ * 获取单个 URL 参数
+ * @param key - 参数名
+ * @param url - URL 字符串，默认使用当前页面地址
+ * @returns 参数值，不存在则返回 null
+ * @example
+ * getUrlParam("a", "https://example.com?a=1")
+ * // => "1"
+ */
+export declare const getUrlParam: (key: string, url?: string) => string | null;
+/**
+ * 对象转 URL 参数字符串
+ * @param params - 参数键值对对象，值为 null/undefined 的项会被过滤
+ * @returns URL 参数字符串（不含 ? 前缀）
+ * @example
+ * toQueryString({ a: 1, b: "hello", c: null })
+ * // => "a=1&b=hello"
+ */
+export declare const toQueryString: (params: Record<string, any>) => string;
+/**
+ * 复制文本到剪贴板
+ * 优先使用 Clipboard API，失败时降级为 execCommand
+ * @param text - 要复制的文本
+ * @returns 复制成功返回 true，失败返回 false
+ * @example
+ * await copyToClipboard("Hello World")
+ * // => true
+ */
+export declare const copyToClipboard: (text: string) => Promise<boolean>;
+/**
+ * 下载文件（Blob）
+ * @param content - 文件内容
+ * @param filename - 文件名
+ * @param mimeType - MIME 类型，默认 "text/plain"
+ * @example
+ * downloadFile("Hello", "hello.txt")
+ */
+export declare const downloadFile: (content: string | BlobPart, filename: string, mimeType?: string) => void;
+/**
+ * 导出 JSON 为文件
+ * @param data - 要导出的数据
+ * @param filename - 文件名，默认 "data.json"
+ * @example
+ * exportJSON({ name: "张三", age: 30 })
+ */
+export declare const exportJSON: (data: any, filename?: string) => void;
+/**
+ * 滚动到顶部
+ * @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
+ * @example
+ * scrollToTop()
+ */
+export declare const scrollToTop: (behavior?: ScrollBehavior) => void;
+/**
+ * 滚动到底部
+ * @param behavior - 滚动行为，"smooth" 平滑 / "auto" 瞬间，默认 "smooth"
+ * @example
+ * scrollToBottom()
+ */
+export declare const scrollToBottom: (behavior?: ScrollBehavior) => void;
+/**
+ * 监听页面滚动（requestAnimationFrame 节流）
+ * @param callback - 滚动回调，接收当前 scrollY 值
+ * @returns 清理函数，调用后移除事件监听
+ * @example
+ * const cleanup = onScroll((y) => console.log(y));
+ * cleanup(); // 停止监听
+ */
+export declare const onScroll: (callback: (scrollY: number) => void) => () => void;

package/dist/cookie/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 设置 Cookie
+ * @param name - Cookie 名称
+ * @param value - Cookie 值
+ * @param days - 有效天数，默认 7 天
+ * @example
+ * setCookie("token", "abc123", 30)
+ */
+export declare const setCookie: (name: string, value: string, days?: number) => void;
+/**
+ * 获取 Cookie
+ * @param name - Cookie 名称
+ * @returns Cookie 值，不存在则返回 null
+ * @example
+ * getCookie("token")
+ * // => "abc123"
+ */
+export declare const getCookie: (name: string) => string | null;
+/**
+ * 删除 Cookie
+ * @param name - Cookie 名称
+ * @example
+ * delCookie("token")
+ */
+export declare const delCookie: (name: string) => void;

package/dist/copy/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 递归深拷贝
+ * 支持 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
+ */
+export declare function deepClone<T>(obj: T, hash?: WeakMap<any, any>): T;
+/**
+ * JSON 深拷贝
+ * 使用 JSON 序列化与反序列化实现，仅支持 JSON 安全的数据类型
+ * （不支持函数、undefined、Date、RegExp、Map、Set 等）
+ * @param obj - 要拷贝的 JSON 安全值
+ * @returns 深拷贝后的值
+ * @example
+ * deepCloneWithJSON({ a: 1, b: [2, 3] })
+ * // => { a: 1, b: [2, 3] }
+ */
+export declare function deepCloneWithJSON<T>(obj: T): T;
+/**
+ * 浅拷贝
+ * 仅拷贝第一层属性，嵌套对象仍共享引用
+ * @param obj - 要拷贝的对象或数组
+ * @returns 浅拷贝后的值
+ * @example
+ * const obj = { a: 1, b: { c: 2 } };
+ * const cloned = shallowClone(obj);
+ * // cloned.b === obj.b（共享引用）
+ */
+export declare function shallowClone<T>(obj: T): T;

package/dist/format/index.d.ts

@@ -0,0 +1,211 @@
+/**
+ * 完整日期时间（年/月/日 时分秒）_ 斜杠
+ * @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"
+ */
+export declare const formatFull: (date: Date) => string;
+/**
+ * 完整日期时间（年-月-日 时分秒）_ 短横线
+ * @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"
+ */
+export declare const formatFullReplace: (date: Date) => string;
+/**
+ * 中文年月日
+ * @param date - Date 对象
+ * @returns 格式化后的中文日期字符串，如 "2026年6月3日"
+ * @example
+ * formatYMD(new Date("2026-06-03"))
+ * // => "2026年6月3日"
+ */
+export declare const formatYMD: (date: Date) => string;
+/**
+ * 星期几
+ * @param date - Date 对象
+ * @returns 中文星期字符串，如 "星期三"
+ * @example
+ * formatWeek(new Date("2026-06-03"))
+ * // => "星期三"
+ */
+export declare const formatWeek: (date: Date) => string;
+/**
+ * 货币格式化
+ * @param value - 数值
+ * @param options - 格式化选项
+ * @returns 格式化后的货币字符串
+ * @example
+ * formatRmb(1234.56, { type: "zh-CN", currency: "CNY" })
+ * // => "¥1,234.56"
+ */
+export declare const formatRmb: (value: number, options: {
+    type: "zh-CN";
+    currency: "CNY";
+}) => string;
+/**
+ * 千位分隔符（数字格式化），中文（逗号分隔）
+ * @param value - 数值
+ * @returns 格式化后的千位分隔数字字符串
+ * @example
+ * formatNum(1234567)
+ * // => "1,234,567"
+ */
+export declare const formatNum: (value: number) => string;
+/**
+ * 百分比格式化
+ * @param value - 百分比数值
+ * @param digit - 保留的小数位数，默认为 0
+ * @returns 格式化后的百分比字符串
+ * @example
+ * percentCN(0.1234, 2)
+ * // => "12.34%"
+ */
+export declare const percentCN: (value: number, digit?: number) => string;
+/**
+ * 紧凑计数法（大数简化）_ 英文缩写
+ * @param value - 数值
+ * @returns 格式化后的紧凑数字字符串（英文缩写）
+ * @example
+ * compactEN(12345)
+ * // => "12K"
+ */
+export declare const compactEN: (value: number) => string;
+/**
+ * 紧凑计数法（大数简化）_ 中文缩写
+ * @param value - 数值
+ * @returns 格式化后的紧凑数字字符串（中文缩写）
+ * @example
+ * compactCN(12345)
+ * // => "1.2万"
+ */
+export declare const compactCN: (value: number) => string;
+/**
+ * 带符号的正负数显示
+ * @param value - 数值
+ * @param digit - 保留的小数位数，默认为 0
+ * @returns 格式化后的带正负号的数值显示
+ * @example
+ * signed(42, 1)
+ * // => "+42.0"
+ * @example
+ * signed(-5)
+ * // => "-5"
+ */
+export declare const signed: (value: number, digit?: number) => string;
+/**
+ * 手机号格式化脱敏 _ 隐藏中间 4 位数
+ * @param phone - 手机号码
+ * @returns 手机号格式化脱敏后的手机号
+ * @example
+ * maskPhone("13812345678")
+ * // => "138****5678"
+ */
+export declare const maskPhone: (phone: string) => string;
+/**
+ * 手机号格式化 _ 空格分隔
+ * @param phone - 手机号
+ * @returns 手机号空格格式化的手机号
+ * @example
+ * spacePhone("13812345678")
+ * // => "138 1234 5678"
+ */
+export declare const spacePhone: (phone: string) => string;
+/**
+ * 每个单词首字母大写
+ * @param str - 字符串
+ * @returns 每个单词首字母大写后的字符串
+ * @example
+ * capitalize("hello world")
+ * // => "Hello World"
+ */
+export declare const capitalize: (str: string) => string;
+/**
+ * 短横线连接转小驼峰（kebab-case → camelCase）
+ * @param str - 字符串
+ * @returns 转换后的小驼峰字符串
+ * @example
+ * kebabToCamel("hello-world")
+ * // => "helloWorld"
+ */
+export declare const kebabToCamel: (str: string) => string;
+/**
+ * 大驼峰或小驼峰 _ 转为 ‘-’ 短横线连接
+ * @param str - 字符串
+ * @returns 大驼峰或小驼峰命名格式化的字符串
+ * @example
+ * camelToKebab("helloWorld")
+ * // => "hello-world"
+ */
+export declare const camelToKebab: (str: string) => string;
+/**
+ * 超长文本截断
+ * @param str - 内容
+ * @param maxLength - 截断位置
+ * @param suffix - 自定义的替换截断后的内容
+ * @returns 超长文本截断后内容
+ * @example
+ * truncate("Hello World", 8)
+ * // => "Hello..."
+ */
+export declare const truncate: (str: string, maxLength: number, suffix?: string) => string;
+/**
+ * 按字数截断（中文友好）
+ * @param str - 内容
+ * @param maxWords - 截断位置
+ * @param suffix - 自定义的替换截断后的内容
+ * @returns 超长文本截断后内容
+ * @example
+ * truncateByWords("你好世界欢迎你", 4)
+ * // => "你好世界..."
+ */
+export declare const truncateByWords: (str: string, maxWords: number, suffix?: string) => string;
+/**
+ * 去除所有空格 _ 前后中间
+ * @param str - 内容
+ * @returns 去除空格后的内容
+ * @example
+ * trimAll(" hello  world ")
+ * // => "helloworld"
+ */
+export declare const trimAll: (str: string) => string;
+/**
+ * 下划线转驼峰（snake_case → camelCase）
+ * @param str - 字符串
+ * @returns 转换后的驼峰字符串
+ * @example
+ * toCamel("hello_world")
+ * // => "helloWorld"
+ */
+export declare const toCamel: (str: string) => string;
+/**
+ * 首字母大写
+ * @param str - 字符串
+ * @returns 首字母大写后的字符串
+ * @example
+ * firstUpper("hello")
+ * // => "Hello"
+ */
+export declare const firstUpper: (str: string) => string;
+/**
+ * 首字母小写
+ * @param str - 字符串
+ * @returns 首字母小写后的字符串
+ * @example
+ * firstLower("Hello")
+ * // => "hello"
+ */
+export declare const firstLower: (str: string) => string;
+/**
+ * 反转字符串
+ * @param str - 字符串
+ * @returns 反转后的字符串
+ * @example
+ * reverse("hello")
+ * // => "olleh"
+ */
+export declare const reverse: (str: string) => string;