@pmun/utils 0.3.9 → 0.4.0

package/dist/index.d.ts

@@ -300,6 +300,138 @@ declare function arrayToObject<T>(arr: T[], key: KeysMatching<T, string | number
  * ```
  */
 declare function arrayReplaceNBSP<T extends Record<string, string | number | boolean | object>>(arr: T[], key: string): T[];
+/**
+ * 将嵌套数组扁平化一层
+ * @param array 要扁平化的数组
+ * @returns 扁平化后的新数组
+ * @group Array
+ * @example
+ * ```ts
+ * flatten([1, [2, 3], [4, [5, 6]]]) // [1, 2, 3, 4, [5, 6]]
+ * flatten([[1, 2], [3, 4]]) // [1, 2, 3, 4]
+ * flatten([1, 2, 3]) // [1, 2, 3]（已经是扁平的）
+ * ```
+ */
+declare function flatten<T>(array: (T | T[])[]): T[];
+/**
+ * 递归扁平化数组至指定深度
+ * @param array 要扁平化的数组
+ * @param depth 扁平化深度，默认为 1
+ * @returns 扁平化后的新数组
+ * @group Array
+ * @example
+ * ```ts
+ * flattenDepth([1, [2, [3, [4]]]], 1) // [1, 2, [3, [4]]]
+ * flattenDepth([1, [2, [3, [4]]]], 2) // [1, 2, 3, [4]]
+ * flattenDepth([1, [2, [3, [4]]]], 3) // [1, 2, 3, 4]
+ * ```
+ */
+declare function flattenDepth(array: any[], depth?: number): any[];
+/**
+ * 递归扁平化嵌套数组至完全扁平
+ * @param array 要扁平化的数组
+ * @returns 完全扁平化后的新数组
+ * @group Array
+ * @example
+ * ```ts
+ * flattenDeep([1, [2, [3, [4]]]]) // [1, 2, 3, 4]
+ * flattenDeep([[1, 2], [3, [4, [5]]]]) // [1, 2, 3, 4, 5]
+ * flattenDeep([1, 2, 3]) // [1, 2, 3]
+ * ```
+ */
+declare function flattenDeep(array: any[]): any[];
+/**
+ * 返回第一个数组中不存在于其他数组的元素
+ * @param array 主数组
+ * @param values 要排除的值数组
+ * @returns 差集数组
+ * @group Array
+ * @example
+ * ```ts
+ * difference([1, 2, 3, 4], [2, 4]) // [1, 3]
+ * difference([1, 2, 3], [4, 5]) // [1, 2, 3]
+ * difference(['a', 'b', 'c'], ['b', 'd']) // ['a', 'c']
+ * ```
+ */
+declare function difference<T>(array: T[], ...values: T[][]): T[];
+/**
+ * 返回所有数组的交集（所有数组中都存在的元素）
+ * @param arrays 要比较的数组
+ * @returns 交集数组
+ * @group Array
+ * @example
+ * ```ts
+ * intersection([1, 2, 3], [2, 3, 4], [2, 3, 5]) // [2, 3]
+ * intersection([1, 2], [2, 3], [3, 4]) // []（没有共同元素）
+ * intersection(['a', 'b'], ['b', 'c'], ['b', 'd']) // ['b']
+ * ```
+ */
+declare function intersection<T>(...arrays: T[][]): T[];
+/**
+ * 返回所有数组的并集（去重后的所有元素）
+ * @param arrays 要合并的数组
+ * @returns 并集数组
+ * @group Array
+ * @example
+ * ```ts
+ * union([1, 2], [2, 3], [3, 4]) // [1, 2, 3, 4]
+ * union([1, 1, 2], [2, 3, 3]) // [1, 2, 3]
+ * union(['a', 'b'], ['b', 'c']) // ['a', 'b', 'c']
+ * ```
+ */
+declare function union<T>(...arrays: T[][]): T[];
+/**
+ * 根据迭代函数返回的值进行数组去重
+ * @param array 原始数组
+ * @param iteratee 迭代函数，返回用于比较的值
+ * @returns 去重后的新数组
+ * @group Array
+ * @example
+ * ```ts
+ * const users = [
+ *   { id: 1, name: 'Tom' },
+ *   { id: 2, name: 'Jerry' },
+ *   { id: 1, name: 'Tom2' }
+ * ]
+ * uniqBy(users, user => user.id)
+ * // [{ id: 1, name: 'Tom' }, { id: 2, name: 'Jerry' }]
+ *
+ * uniqBy([2.1, 1.2, 2.3], Math.floor) // [2.1, 1.2]
+ * ```
+ */
+declare function uniqBy<T, K>(array: T[], iteratee: (item: T) => K): T[];
+/**
+ * 根据迭代函数返回的值进行排序
+ * @param array 要排序的数组
+ * @param iteratee 迭代函数或属性名，返回用于排序的值
+ * @param order 排序方向，'asc' 为升序，'desc' 为降序，默认为 'asc'
+ * @returns 排序后的新数组，不会修改原数组
+ * @group Array
+ * @example
+ * ```ts
+ * const users = [
+ *   { name: 'Tom', age: 25 },
+ *   { name: 'Jerry', age: 20 },
+ *   { name: 'Alice', age: 30 }
+ * ]
+ *
+ * // 使用函数
+ * sortBy(users, user => user.age)
+ * // [{ name: 'Jerry', age: 20 }, { name: 'Tom', age: 25 }, { name: 'Alice', age: 30 }]
+ *
+ * // 降序
+ * sortBy(users, user => user.age, 'desc')
+ * // [{ name: 'Alice', age: 30 }, { name: 'Tom', age: 25 }, { name: 'Jerry', age: 20 }]
+ *
+ * // 使用属性名
+ * sortBy(users, 'name')
+ * // [{ name: 'Alice', age: 30 }, { name: 'Jerry', age: 20 }, { name: 'Tom', age: 25 }]
+ *
+ * // 数字数组排序
+ * sortBy([3, 1, 4, 1, 5], x => x) // [1, 1, 3, 4, 5]
+ * ```
+ */
+declare function sortBy<T>(array: T[], iteratee: ((item: T) => any) | keyof T, order?: 'asc' | 'desc'): T[];
 
 /**
  * 表示日期的各种类型，可以是日期对象、日期字符串或时间戳
@@ -632,6 +764,247 @@ declare function formatChatTime(date: DateLike): string;
  * ```
  */
 declare function formatDuration(timestamp: number, format?: string): string | number;
+/**
+ * 日期范围元组类型，包含开始和结束时间戳（毫秒）
+ */
+type DateRange = [number, number];
+/**
+ * 日期快捷键函数类型
+ */
+type DateShortcutFn = () => DateRange;
+/**
+ * 预设快捷键名称
+ */
+type PresetShortcutKey = '今天' | '本周' | '本月' | '本季度' | '本半年' | '本年' | '最近7天' | '最近30天' | '最近3个月' | '最近半年' | '最近一年';
+/**
+ * 日期快捷键配置对象类型
+ * 支持预设快捷键名称和自定义字符串键
+ */
+type DateShortcutsConfig = {
+    [K in PresetShortcutKey]?: DateShortcutFn;
+} & {
+    [key: string]: DateShortcutFn | undefined;
+};
+/**
+ * 日期快捷键配置项类型，可以是预设名称字符串或自定义配置对象
+ * 支持预设快捷键名称（带自动补全）和任意自定义字符串
+ */
+type DateShortcutItem = PresetShortcutKey | (string & {}) | Record<string, PresetShortcutKey | (string & {}) | DateShortcutFn>;
+/**
+ * 获取指定偏移天数的日期
+ * @param offset 偏移天数（负数表示过去，正数表示未来），默认为 0
+ * @returns 日期对象
+ * @group DateRange
+ * @example
+ * ```ts
+ * getDateByOffset() // 今天
+ * getDateByOffset(-1) // 昨天
+ * getDateByOffset(1) // 明天
+ * getDateByOffset(-7) // 7天前
+ * ```
+ */
+declare function getDateByOffset(offset?: number): Date;
+/**
+ * 获取昨天的日期字符串 (YYYY-MM-DD)
+ * @returns 昨天的日期字符串
+ * @group DateRange
+ * @example
+ * ```ts
+ * getYesterdayStr() // "2023-05-14"（假设今天是 2023-05-15）
+ * ```
+ */
+declare function getYesterdayStr(): string;
+/**
+ * 获取今天的日期字符串 (YYYY-MM-DD)
+ * @returns 今天的日期字符串
+ * @group DateRange
+ * @example
+ * ```ts
+ * getTodayStr() // "2023-05-15"
+ * ```
+ */
+declare function getTodayStr(): string;
+/**
+ * 获取今天的开始和结束时间戳
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getTodayRange()
+ * // start: 今天 00:00:00 的时间戳
+ * // end: 今天 23:59:59.999 的时间戳
+ * ```
+ */
+declare function getTodayRange(): DateRange;
+/**
+ * 获取本周的开始和结束时间戳（周一到周日）
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getThisWeekRange()
+ * // start: 本周一 00:00:00 的时间戳
+ * // end: 本周日 23:59:59.999 的时间戳
+ * ```
+ */
+declare function getThisWeekRange(): DateRange;
+/**
+ * 获取本月的开始和结束时间戳
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getThisMonthRange()
+ * // start: 本月1日 00:00:00 的时间戳
+ * // end: 本月最后一天 23:59:59.999 的时间戳
+ * ```
+ */
+declare function getThisMonthRange(): DateRange;
+/**
+ * 获取本季度的开始和结束时间戳
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getThisQuarterRange()
+ * // 如果当前是5月（Q2），则：
+ * // start: 4月1日 00:00:00 的时间戳
+ * // end: 6月30日 23:59:59.999 的时间戳
+ * ```
+ */
+declare function getThisQuarterRange(): DateRange;
+/**
+ * 获取本半年的开始和结束时间戳
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getThisHalfYearRange()
+ * // 如果当前是5月（上半年），则：
+ * // start: 1月1日 00:00:00 的时间戳
+ * // end: 6月30日 23:59:59.999 的时间戳
+ * ```
+ */
+declare function getThisHalfYearRange(): DateRange;
+/**
+ * 获取本年的开始和结束时间戳
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getThisYearRange()
+ * // start: 1月1日 00:00:00 的时间戳
+ * // end: 12月31日 23:59:59.999 的时间戳
+ * ```
+ */
+declare function getThisYearRange(): DateRange;
+/**
+ * 获取最近 N 天的时间范围
+ * @param days 天数
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getLastDaysRange(7)
+ * // start: 7天前 00:00:00 的时间戳
+ * // end: 当前时间戳
+ *
+ * const [start, end] = getLastDaysRange(30)
+ * // start: 30天前 00:00:00 的时间戳
+ * // end: 当前时间戳
+ * ```
+ */
+declare function getLastDaysRange(days: number): DateRange;
+/**
+ * 获取最近 N 周的时间范围
+ * @param weeks 周数
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getLastWeeksRange(2)
+ * // start: 2周前的时间戳
+ * // end: 当前时间戳
+ * ```
+ */
+declare function getLastWeeksRange(weeks: number): DateRange;
+/**
+ * 获取最近 N 个月的时间范围
+ * @param months 月数
+ * @returns 日期范围元组 [开始时间戳, 结束时间戳]
+ * @group DateRange
+ * @example
+ * ```ts
+ * const [start, end] = getLastMonthsRange(3)
+ * // start: 3个月前当天 00:00:00 的时间戳
+ * // end: 当前时间戳
+ *
+ * const [start, end] = getLastMonthsRange(12)
+ * // start: 12个月前当天 00:00:00 的时间戳
+ * // end: 当前时间戳
+ * ```
+ */
+declare function getLastMonthsRange(months: number): DateRange;
+/**
+ * 常用日期范围快捷键配置
+ *
+ * 可直接用于 DateRangePicker 组件的 shortcuts 属性
+ *
+ * @group DateRange
+ * @example
+ * ```ts
+ * // 在 Element Plus 中使用
+ * <el-date-picker
+ *   type="daterange"
+ *   :shortcuts="Object.entries(commonDateShortcuts).map(([text, value]) => ({ text, value }))"
+ * />
+ *
+ * // 获取今天的范围
+ * const [start, end] = commonDateShortcuts['今天']()
+ *
+ * // 获取本月的范围
+ * const [start, end] = commonDateShortcuts['本月']()
+ * ```
+ */
+declare const commonDateShortcuts: DateShortcutsConfig;
+/**
+ * 创建日期范围快捷键配置
+ *
+ * 支持多种输入格式，简化快捷键配置。可以从预设的 commonDateShortcuts 中选择，
+ * 也可以自定义快捷键名称和函数。
+ *
+ * @param config 快捷键配置，支持以下格式：
+ *   - 字符串数组：从 commonDateShortcuts 中选择预设快捷键
+ *   - 对象数组：自定义键名映射到预设或自定义函数
+ *   - 对象：直接传入快捷键配置对象
+ * @returns 快捷键配置对象
+ * @group DateRange
+ * @example
+ * ```ts
+ * // 方式1: 传入字符串数组（从 commonDateShortcuts 中选择）
+ * const shortcuts = createDateShortcuts(['今天', '本周', '本月'])
+ * // => { 今天: getTodayRange, 本周: getThisWeekRange, 本月: getThisMonthRange }
+ *
+ * // 方式2: 传入对象数组（支持自定义键名）
+ * const shortcuts = createDateShortcuts([
+ *   { 今天: '今天' },
+ *   { 这周: '本周' }, // 显示"这周"，实际使用"本周"的逻辑
+ *   { 自定义: () => [Date.now() - 86400000, Date.now()] }
+ * ])
+ *
+ * // 方式3: 直接传入对象（兼容旧方式）
+ * const shortcuts = createDateShortcuts({
+ *   今天: commonDateShortcuts['今天'],
+ *   自定义: () => [Date.now(), Date.now()]
+ * })
+ *
+ * // 在 Vue 组件中使用
+ * const shortcuts = createDateShortcuts(['今天', '本周', '本月', '最近7天'])
+ * // 转换为 Element Plus 格式
+ * const elShortcuts = Object.entries(shortcuts).map(([text, value]) => ({ text, value }))
+ * ```
+ */
+declare function createDateShortcuts(config: DateShortcutItem[] | DateShortcutsConfig): DateShortcutsConfig;
 
 /**
  * @module 类型检查
@@ -1276,6 +1649,60 @@ declare function deepMerge(...objects: Record<string, any>[]): Record<string, an
  * ```
  */
 declare function filterObjectByKeys(originalObject: Record<string, any>, keysArray: string[], keyMapping?: Record<string, string>): Record<string, any>;
+/**
+ * 创建一个新对象，通过函数转换每个键
+ * @param obj 原始对象
+ * @param iteratee 转换函数，接收值、键和对象，返回新的键名
+ * @returns 转换后的新对象
+ * @group Object
+ * @example
+ * ```ts
+ * const obj = { a: 1, b: 2, c: 3 }
+ * mapKeys(obj, (value, key) => key.toUpperCase())
+ * // { A: 1, B: 2, C: 3 }
+ *
+ * mapKeys(obj, (value, key) => `prefix_${key}`)
+ * // { prefix_a: 1, prefix_b: 2, prefix_c: 3 }
+ * ```
+ */
+declare function mapKeys<T extends Record<string, any>>(obj: T, iteratee: (value: T[keyof T], key: string, obj: T) => string): Record<string, T[keyof T]>;
+/**
+ * 创建一个新对象，通过函数转换每个值
+ * @param obj 原始对象
+ * @param iteratee 转换函数，接收值、键和对象，返回新的值
+ * @returns 转换后的新对象
+ * @group Object
+ * @example
+ * ```ts
+ * const obj = { a: 1, b: 2, c: 3 }
+ * mapValues(obj, value => value * 2)
+ * // { a: 2, b: 4, c: 6 }
+ *
+ * const users = { user1: { age: 20 }, user2: { age: 30 } }
+ * mapValues(users, user => user.age)
+ * // { user1: 20, user2: 30 }
+ * ```
+ */
+declare function mapValues<T extends Record<string, any>, R>(obj: T, iteratee: (value: T[keyof T], key: string, obj: T) => R): Record<keyof T, R>;
+/**
+ * 反转对象的键值对，值变成键，键变成值
+ * @param obj 原始对象
+ * @returns 反转后的新对象
+ * @group Object
+ * @example
+ * ```ts
+ * invert({ a: '1', b: '2', c: '3' })
+ * // { '1': 'a', '2': 'b', '3': 'c' }
+ *
+ * invert({ firstName: 'John', lastName: 'Doe' })
+ * // { John: 'firstName', Doe: 'lastName' }
+ *
+ * // 注意：如果有重复的值，后面的键会覆盖前面的
+ * invert({ a: '1', b: '1' })
+ * // { '1': 'b' }
+ * ```
+ */
+declare function invert<T extends Record<string, string | number>>(obj: T): Record<string, string>;
 
 /**
  * 延迟指定的毫秒数
@@ -1297,6 +1724,145 @@ declare function filterObjectByKeys(originalObject: Record<string, any>, keysArr
  * ```
  */
 declare function delay(ms: number): Promise<void>;
+/**
+ * 带超时控制的 Promise
+ *
+ * 如果 Promise 在指定时间内没有完成，则拒绝并抛出超时错误。
+ *
+ * @param {Promise<T>} promise - 要执行的 Promise
+ * @param {number} ms - 超时时间（毫秒）
+ * @param {string} [message] - 超时错误信息，默认为 "Operation timed out"
+ * @returns {Promise<T>} 返回原 Promise 的结果，或在超时时抛出错误
+ * @group Promise
+ * @example
+ * ```ts
+ * // 正常完成
+ * await timeout(fetch('/api/data'), 5000)
+ *
+ * // 超时
+ * try {
+ *   await timeout(delay(3000), 1000)
+ * } catch (error) {
+ *   console.error('超时了')
+ * }
+ *
+ * // 自定义错误信息
+ * await timeout(fetch('/api/data'), 5000, '请求超时')
+ * ```
+ */
+declare function timeout<T>(promise: Promise<T>, ms: number, message?: string): Promise<T>;
+/**
+ * 重试失败的 Promise
+ *
+ * 当 Promise 失败时，会自动重试指定次数，每次重试之间可以设置延迟时间。
+ *
+ * @param {() => Promise<T>} fn - 返回 Promise 的函数
+ * @param {number} retries - 最大重试次数，默认为 3
+ * @param {number} delayMs - 每次重试之间的延迟时间（毫秒），默认为 1000
+ * @returns {Promise<T>} 返回成功的结果，或在所有重试失败后抛出最后一次的错误
+ * @group Promise
+ * @example
+ * ```ts
+ * // 重试失败的请求
+ * const data = await retry(() => fetch('/api/data').then(r => r.json()), 3, 1000)
+ *
+ * // 自定义重试次数和延迟
+ * await retry(
+ *   () => riskyOperation(),
+ *   5,  // 重试5次
+ *   2000  // 每次间隔2秒
+ * )
+ * ```
+ */
+declare function retry<T>(fn: () => Promise<T>, retries?: number, delayMs?: number): Promise<T>;
+/**
+ * 创建一个防抖函数（异步版本）
+ *
+ * 在指定的延迟时间内，如果函数被多次调用，只执行最后一次。
+ * 返回一个 Promise，会在函数实际执行后 resolve。
+ *
+ * @param {(...args: T) => Promise<R> | R} fn - 要防抖的函数
+ * @param {number} wait - 延迟时间（毫秒）
+ * @returns 防抖后的函数
+ * @group Promise
+ * @example
+ * ```ts
+ * const searchAPI = debounce(async (query: string) => {
+ *   const response = await fetch(`/api/search?q=${query}`)
+ *   return response.json()
+ * }, 300)
+ *
+ * // 只有最后一次调用会实际执行
+ * searchAPI('a')
+ * searchAPI('ab')
+ * const result = await searchAPI('abc') // 只有这次会执行
+ * ```
+ */
+declare function debounce<T extends any[], R>(fn: (...args: T) => Promise<R> | R, wait: number): (...args: T) => Promise<R>;
+/**
+ * 创建一个节流函数（异步版本）
+ *
+ * 在指定的时间间隔内，函数最多只执行一次。
+ * 如果在等待期间有新的调用，会在等待结束后立即执行最新的调用。
+ *
+ * @param {(...args: T) => Promise<R> | R} fn - 要节流的函数
+ * @param {number} wait - 时间间隔（毫秒）
+ * @returns 节流后的函数
+ * @group Promise
+ * @example
+ * ```ts
+ * const saveData = throttle(async (data: any) => {
+ *   await fetch('/api/save', {
+ *     method: 'POST',
+ *     body: JSON.stringify(data)
+ *   })
+ * }, 1000)
+ *
+ * // 1秒内多次调用，只执行一次
+ * saveData({ value: 1 })
+ * saveData({ value: 2 })
+ * saveData({ value: 3 }) // 只有第一次和最后一次会执行
+ * ```
+ */
+declare function throttle<T extends any[], R>(fn: (...args: T) => Promise<R> | R, wait: number): (...args: T) => Promise<R> | undefined;
+/**
+ * 并发执行多个 Promise，并限制同时执行的数量
+ *
+ * @param {(() => Promise<T>)[]} tasks - Promise 工厂函数数组
+ * @param {number} limit - 最大并发数，默认为 5
+ * @returns {Promise<T[]>} 返回所有 Promise 的结果数组
+ * @group Promise
+ * @example
+ * ```ts
+ * const urls = ['/api/1', '/api/2', '/api/3', '/api/4', '/api/5']
+ * const tasks = urls.map(url => () => fetch(url).then(r => r.json()))
+ *
+ * // 最多同时执行 2 个请求
+ * const results = await parallel(tasks, 2)
+ * console.log(results)
+ * ```
+ */
+declare function parallel<T>(tasks: (() => Promise<T>)[], limit?: number): Promise<T[]>;
+/**
+ * 顺序执行多个 Promise（一个接一个）
+ *
+ * @param {(() => Promise<T>)[]} tasks - Promise 工厂函数数组
+ * @returns {Promise<T[]>} 返回所有 Promise 的结果数组
+ * @group Promise
+ * @example
+ * ```ts
+ * const tasks = [
+ *   () => fetch('/api/1').then(r => r.json()),
+ *   () => fetch('/api/2').then(r => r.json()),
+ *   () => fetch('/api/3').then(r => r.json()),
+ * ]
+ *
+ * // 按顺序执行，每个完成后才执行下一个
+ * const results = await sequential(tasks)
+ * console.log(results)
+ * ```
+ */
+declare function sequential<T>(tasks: (() => Promise<T>)[]): Promise<T[]>;
 
 /**
  * @module 字符串处理
@@ -1497,6 +2063,72 @@ declare function replaceNBSP(str?: string): string;
  * ```
  */
 declare function parseJsonStr<T = any>(str?: string | null, defaultValue?: T): T | string | Record<string, any>;
+/**
+ * 将字符串分割成单词数组
+ * @param str 要分割的字符串
+ * @returns 单词数组
+ * @group String
+ * @example
+ * ```ts
+ * words('hello world') // ['hello', 'world']
+ * words('helloWorld') // ['hello', 'World']
+ * words('hello-world-foo') // ['hello', 'world', 'foo']
+ * words('hello_world_foo') // ['hello', 'world', 'foo']
+ * words('HelloWorldFoo') // ['Hello', 'World', 'Foo']
+ * words('hello123world') // ['hello', '123', 'world']
+ * ```
+ */
+declare function words(str: string): string[];
+/**
+ * 将字符串转换为蛇形命名（snake_case）
+ * @param str 输入字符串
+ * @returns 蛇形命名的字符串
+ * @group String
+ * @example
+ * ```ts
+ * snakeCase('helloWorld') // 'hello_world'
+ * snakeCase('HelloWorld') // 'hello_world'
+ * snakeCase('hello-world') // 'hello_world'
+ * snakeCase('hello world') // 'hello_world'
+ * snakeCase('HelloWorldFoo') // 'hello_world_foo'
+ * ```
+ */
+declare function snakeCase(str: string): string;
+/**
+ * 将字符串转换为帕斯卡命名（PascalCase）
+ * @param str 输入字符串
+ * @returns 帕斯卡命名的字符串
+ * @group String
+ * @example
+ * ```ts
+ * pascalCase('hello world') // 'HelloWorld'
+ * pascalCase('hello-world') // 'HelloWorld'
+ * pascalCase('hello_world') // 'HelloWorld'
+ * pascalCase('helloWorld') // 'HelloWorld'
+ * pascalCase('HELLO_WORLD') // 'HelloWorld'
+ * ```
+ */
+declare function pascalCase(str: string): string;
+/**
+ * 简单的模板字符串替换
+ * @param template 模板字符串，使用 {{key}} 或 {key} 标记占位符
+ * @param data 数据对象
+ * @returns 替换后的字符串
+ * @group String
+ * @example
+ * ```ts
+ * template('Hello {{name}}!', { name: 'Tom' }) // 'Hello Tom!'
+ * template('Hello {name}, you are {age} years old', { name: 'Tom', age: 25 })
+ * // 'Hello Tom, you are 25 years old'
+ *
+ * // 支持嵌套属性访问
+ * template('Hello {{user.name}}!', { user: { name: 'Tom' } }) // 'Hello Tom!'
+ *
+ * // 未找到的键会保持原样
+ * template('Hello {{name}}!', {}) // 'Hello {{name}}!'
+ * ```
+ */
+declare function template(template: string, data: Record<string, any>): string;
 
 /**
  * 将对象转换为URL查询字符串
@@ -1526,4 +2158,4 @@ declare function parseJsonStr<T = any>(str?: string | null, defaultValue?: T): T
  */
 declare function getQueryStringify(params: Record<string, any> | null | undefined): string;
 
-export { type DateLike, add, addDays, addMonths, addYears, appendUniversalOption, arrayReplaceNBSP, arrayToObject, camelToKebab, capitalize, chunk, clamp, convertToDayjsParam, createDate, deepClone, deepMerge, delay, diff, endOf, ensureRpxUnit, escapeHtml, filterObjectByKeys, first, formatChatTime, formatCurrency, formatDate, formatDuration, formatFullTime, formatHumanReadable, formatNumberWithTenThousand, formatThousands, fromNow, get, getDayOfWeek, getDaysInMonth, getQueryStringify, groupBy, hasOwnProp, isArray, isBoolean, isClass, isDate, isDateInRange, isEmpty, isEmptyObject, isEmptyString, isEqual, isEven, isFunction, isMap, isMillisecondTimestamp, isMobilePhone, isNaN, isNull, isNullOrUndefined, isNumber, isObject, isOdd, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isUndefined, isValidEmail, isValidUrl, kebabToCamel, last, merge, now, objectToQueryString, omit, parseDate, parseJsonStr, percentage, pick, randomInt, randomString, remove, renameTreeNodes, replaceNBSP, round, sample, shuffle, startOf, transformTree, truncate, unique };
+export { type DateLike, type DateRange, type DateShortcutFn, type DateShortcutItem, type DateShortcutsConfig, type PresetShortcutKey, add, addDays, addMonths, addYears, appendUniversalOption, arrayReplaceNBSP, arrayToObject, camelToKebab, capitalize, chunk, clamp, commonDateShortcuts, convertToDayjsParam, createDate, createDateShortcuts, debounce, deepClone, deepMerge, delay, diff, difference, endOf, ensureRpxUnit, escapeHtml, filterObjectByKeys, first, flatten, flattenDeep, flattenDepth, formatChatTime, formatCurrency, formatDate, formatDuration, formatFullTime, formatHumanReadable, formatNumberWithTenThousand, formatThousands, fromNow, get, getDateByOffset, getDayOfWeek, getDaysInMonth, getLastDaysRange, getLastMonthsRange, getLastWeeksRange, getQueryStringify, getThisHalfYearRange, getThisMonthRange, getThisQuarterRange, getThisWeekRange, getThisYearRange, getTodayRange, getTodayStr, getYesterdayStr, groupBy, hasOwnProp, intersection, invert, isArray, isBoolean, isClass, isDate, isDateInRange, isEmpty, isEmptyObject, isEmptyString, isEqual, isEven, isFunction, isMap, isMillisecondTimestamp, isMobilePhone, isNaN, isNull, isNullOrUndefined, isNumber, isObject, isOdd, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isUndefined, isValidEmail, isValidUrl, kebabToCamel, last, mapKeys, mapValues, merge, now, objectToQueryString, omit, parallel, parseDate, parseJsonStr, pascalCase, percentage, pick, randomInt, randomString, remove, renameTreeNodes, replaceNBSP, retry, round, sample, sequential, shuffle, snakeCase, sortBy, startOf, template, throttle, timeout, transformTree, truncate, union, uniqBy, unique, words };