rtcpts 0.0.35 → 0.0.37

package/dist/utils/helper/regex.d.ts

@@ -0,0 +1,265 @@
+/**
+ * 正则验证工具函数
+ */
+/**
+ * 将正则验证函数转换为 Quasar 表单验证规则
+ * @param validatorFn 验证函数，返回 boolean
+ * @param errorMessage 错误提示信息（可以是字符串或返回字符串的函数）
+ * @returns Quasar 表单验证函数
+ * @example
+ * const phoneRule = createFormRule(isPhone, (t) => t('messages.formRules.phoneInvalid'));
+ * // 在表单中使用: :rules="[phoneRule]"
+ */
+export declare function createFormRule(validatorFn: (value: string) => boolean, errorMessage: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 验证手机号（中国大陆）
+ * 支持 13x, 14x, 15x, 16x, 17x, 18x, 19x 开头的 11 位手机号
+ * @param phone 手机号字符串
+ * @returns 是否为有效手机号
+ * @example
+ * isPhone('13812345678') // true
+ * isPhone('12345678901') // false
+ */
+export declare function isPhone(phone: string): boolean;
+/**
+ * 验证邮箱地址
+ * @param email 邮箱字符串
+ * @returns 是否为有效邮箱
+ * @example
+ * isEmail('test@example.com') // true
+ * isEmail('test@example') // false
+ */
+export declare function isEmail(email: string): boolean;
+/**
+ * 验证身份证号（15位或18位）
+ * @param idCard 身份证号字符串
+ * @returns 是否为有效身份证号
+ * @example
+ * isIdCard('320123199001011234') // true
+ * isIdCard('320123900101123') // true (15位)
+ * isIdCard('123456') // false
+ */
+export declare function isIdCard(idCard: string): boolean;
+/**
+ * 验证银行卡号（16-19位）
+ * @param card 银行卡号字符串
+ * @returns 是否为有效银行卡号
+ * @example
+ * isBankCard('6222021234567890123') // true
+ * isBankCard('123456') // false
+ */
+export declare function isBankCard(card: string): boolean;
+/**
+ * 验证车牌号（新能源+普通）
+ * @param carNumber 车牌号字符串
+ * @returns 是否为有效车牌号
+ * @example
+ * isCarNumber('京A12345') // true
+ * isCarNumber('京AD12345') // true (新能源)
+ * isCarNumber('ABC123') // false
+ */
+export declare function isCarNumber(carNumber: string): boolean;
+/**
+ * 验证 URL 地址
+ * @param url URL字符串
+ * @returns 是否为有效URL
+ * @example
+ * isUrl('https://www.example.com') // true
+ * isUrl('http://example.com/path') // true
+ * isUrl('www.example.com') // false
+ */
+export declare function isUrl(url: string): boolean;
+/**
+ * 验证 IP 地址（IPv4）
+ * @param ip IP地址字符串
+ * @returns 是否为有效IP地址
+ * @example
+ * isIP('192.168.1.1') // true
+ * isIP('256.1.1.1') // false
+ */
+export declare function isIP(ip: string): boolean;
+/**
+ * 验证是否为纯中文
+ * @param str 字符串
+ * @returns 是否为纯中文
+ * @example
+ * isChinese('中文测试') // true
+ * isChinese('中文test') // false
+ */
+export declare function isChinese(str: string): boolean;
+/**
+ * 验证是否包含中文
+ * @param str 字符串
+ * @returns 是否包含中文
+ * @example
+ * hasChinese('中文test') // true
+ * hasChinese('test123') // false
+ */
+export declare function hasChinese(str: string): boolean;
+/**
+ * 验证是否为纯数字
+ * @param str 字符串
+ * @returns 是否为纯数字
+ * @example
+ * isNumber('123456') // true
+ * isNumber('123.456') // false
+ */
+export declare function isNumber(str: string): boolean;
+/**
+ * 验证是否为数字（包含小数）
+ * @param str 字符串
+ * @returns 是否为数字
+ * @example
+ * isNumeric('123.456') // true
+ * isNumeric('123') // true
+ * isNumeric('abc') // false
+ */
+export declare function isNumeric(str: string): boolean;
+/**
+ * 验证是否为正整数
+ * @param str 字符串
+ * @returns 是否为正整数
+ * @example
+ * isPositiveInteger('123') // true
+ * isPositiveInteger('0') // false
+ * isPositiveInteger('-123') // false
+ */
+export declare function isPositiveInteger(str: string): boolean;
+/**
+ * 验证是否为非负整数（正整数 + 0）
+ * @param str 字符串
+ * @returns 是否为非负整数
+ * @example
+ * isNonNegativeInteger('123') // true
+ * isNonNegativeInteger('0') // true
+ * isNonNegativeInteger('-123') // false
+ */
+export declare function isNonNegativeInteger(str: string): boolean;
+/**
+ * 验证是否为 QQ 号（5-11位数字）
+ * @param qq QQ号字符串
+ * @returns 是否为有效QQ号
+ * @example
+ * isQQ('123456789') // true
+ * isQQ('123') // false
+ */
+export declare function isQQ(qq: string): boolean;
+/**
+ * 验证是否为微信号（6-20位，字母开头，可包含字母数字下划线减号）
+ * @param wechat 微信号字符串
+ * @returns 是否为有效微信号
+ * @example
+ * isWechat('test_123') // true
+ * isWechat('123test') // false (不能数字开头)
+ */
+export declare function isWechat(wechat: string): boolean;
+/**
+ * 验证是否为邮政编码（中国）
+ * @param postcode 邮政编码字符串
+ * @returns 是否为有效邮政编码
+ * @example
+ * isPostcode('100000') // true
+ * isPostcode('12345') // false
+ */
+export declare function isPostcode(postcode: string): boolean;
+/**
+ * 验证强密码（至少8位，包含大小写字母、数字、特殊字符）
+ * @param password 密码字符串
+ * @returns 是否为强密码
+ * @example
+ * isStrongPassword('Abc123!@#') // true
+ * isStrongPassword('abc123') // false
+ */
+export declare function isStrongPassword(password: string): boolean;
+/**
+ * 验证中等强度密码（至少6位，包含字母和数字）
+ * @param password 密码字符串
+ * @returns 是否为中等强度密码
+ * @example
+ * isMediumPassword('abc123') // true
+ * isMediumPassword('123456') // false
+ */
+export declare function isMediumPassword(password: string): boolean;
+/**
+ * 验证 MAC 地址
+ * @param mac MAC地址字符串
+ * @returns 是否为有效MAC地址
+ * @example
+ * isMac('00:11:22:33:44:55') // true
+ * isMac('00-11-22-33-44-55') // true
+ * isMac('001122334455') // false
+ */
+export declare function isMac(mac: string): boolean;
+/**
+ * 验证端口号（1-65535）
+ * @param port 端口号字符串
+ * @returns 是否为有效端口号
+ * @example
+ * isPort('8080') // true
+ * isPort('65536') // false
+ */
+export declare function isPort(port: string): boolean;
+/**
+ * 验证 IPv6 地址
+ * @param ip IPv6地址字符串
+ * @returns 是否为有效IPv6地址
+ * @example
+ * isIPv6('2001:0db8:85a3:0000:0000:8a2e:0370:7334') // true
+ * isIPv6('192.168.1.1') // false
+ */
+export declare function isIPv6(ip: string): boolean;
+/**
+ * 验证十六进制颜色值
+ * @param color 颜色值字符串
+ * @returns 是否为有效十六进制颜色值
+ * @example
+ * isHexColor('#fff') // true
+ * isHexColor('#ffffff') // true
+ * isHexColor('fff') // false
+ */
+export declare function isHexColor(color: string): boolean;
+/**
+ * 创建手机号表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ * @example
+ * // 在组件中使用
+ * :rules="[jqTool.regex.phoneRule((t) => t('messages.formRules.phoneInvalid'))]"
+ */
+export declare function phoneRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 创建邮箱表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ */
+export declare function emailRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 创建身份证号表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ */
+export declare function idCardRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 创建银行卡号表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ */
+export declare function bankCardRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 创建车牌号表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ */
+export declare function carNumberRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 创建 URL 表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ */
+export declare function urlRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;
+/**
+ * 创建 IP 地址表单验证规则
+ * @param errorMessage 错误提示信息
+ * @returns Quasar 表单验证函数
+ */
+export declare function ipRule(errorMessage?: string | ((t?: any) => string)): (val?: any) => true | string;

package/dist/utils/helper/string.d.ts

@@ -0,0 +1,248 @@
+/**
+ * 字符串处理工具函数
+ */
+/**
+ * 手机号脱敏
+ * @param phone 手机号
+ * @returns 脱敏后的手机号，格式：138****5678
+ * @example
+ * phoneDesensitize('13812345678') // '138****5678'
+ */
+export declare function phoneDesensitize(phone: string): string;
+/**
+ * 身份证号脱敏
+ * @param idCard 身份证号
+ * @returns 脱敏后的身份证号，格式：320***********1234
+ * @example
+ * idCardDesensitize('320123199001011234') // '320***********1234'
+ */
+export declare function idCardDesensitize(idCard: string): string;
+/**
+ * 姓名脱敏
+ * @param name 姓名
+ * @returns 脱敏后的姓名，格式：张** 或 欧阳**
+ * @example
+ * nameDesensitize('张三') // '张*'
+ * nameDesensitize('欧阳锋') // '欧阳*'
+ * nameDesensitize('司马懿') // '司马*'
+ */
+export declare function nameDesensitize(name: string): string;
+/**
+ * 银行卡号脱敏
+ * @param card 银行卡号
+ * @returns 脱敏后的银行卡号，格式：6222 **** **** 1234
+ * @example
+ * bankCardDesensitize('6222021234567890123') // '6222 **** **** 0123'
+ */
+export declare function bankCardDesensitize(card: string): string;
+/**
+ * 邮箱脱敏
+ * @param email 邮箱地址
+ * @returns 脱敏后的邮箱，格式：t***@example.com
+ * @example
+ * emailDesensitize('test@example.com') // 't***@example.com'
+ */
+export declare function emailDesensitize(email: string): string;
+/**
+ * 地址脱敏
+ * @param address 地址
+ * @param keepLength 保留前面多少个字符，默认 6
+ * @returns 脱敏后的地址
+ * @example
+ * addressDesensitize('北京市朝阳区xxx街道xxx号') // '北京市朝阳区***'
+ */
+export declare function addressDesensitize(address: string, keepLength?: number): string;
+/**
+ * 首字母大写
+ * @param str 字符串
+ * @returns 首字母大写的字符串
+ * @example
+ * capitalize('hello') // 'Hello'
+ */
+export declare function capitalize(str: string): string;
+/**
+ * 每个单词首字母大写
+ * @param str 字符串
+ * @returns 每个单词首字母大写的字符串
+ * @example
+ * capitalizeWords('hello world') // 'Hello World'
+ */
+export declare function capitalizeWords(str: string): string;
+/**
+ * 下划线转驼峰
+ * @param str 下划线字符串
+ * @returns 驼峰格式字符串
+ * @example
+ * toCamelCase('user_name') // 'userName'
+ * toCamelCase('user_name_list') // 'userNameList'
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * 驼峰转下划线
+ * @param str 驼峰字符串
+ * @returns 下划线格式字符串
+ * @example
+ * toUnderlineCase('userName') // 'user_name'
+ * toUnderlineCase('userNameList') // 'user_name_list'
+ */
+export declare function toUnderlineCase(str: string): string;
+/**
+ * 驼峰转中划线
+ * @param str 驼峰字符串
+ * @returns 中划线格式字符串
+ * @example
+ * toKebabCase('userName') // 'user-name'
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * 千分位格式化数字
+ * @param num 数字或数字字符串
+ * @returns 千分位格式的字符串
+ * @example
+ * formatNumber(1234567) // '1,234,567'
+ * formatNumber(1234567.89) // '1,234,567.89'
+ */
+export declare function formatNumber(num: number | string): string;
+/**
+ * 金额格式化
+ * @param amount 金额
+ * @param options 配置选项
+ * @returns 格式化后的金额字符串
+ * @example
+ * formatMoney(1234.56) // '¥1,234.56'
+ * formatMoney(1234.56, { currency: '$', decimals: 2 }) // '$1,234.56'
+ * formatMoney(1234, { decimals: 0 }) // '¥1,234'
+ */
+export declare function formatMoney(amount: number | string, options?: {
+    currency?: string;
+    decimals?: number;
+    thousandsSeparator?: string;
+    decimalSeparator?: string;
+}): string;
+/**
+ * 格式化文件大小
+ * @param bytes 字节数
+ * @param decimals 保留小数位数，默认 2
+ * @returns 格式化后的文件大小字符串
+ * @example
+ * formatFileSize(1024) // '1.00 KB'
+ * formatFileSize(1234567) // '1.18 MB'
+ */
+export declare function formatFileSize(bytes: number, decimals?: number): string;
+/**
+ * 格式化银行卡号（添加空格）
+ * @param card 银行卡号
+ * @returns 格式化后的银行卡号，每 4 位一个空格
+ * @example
+ * formatBankCard('6222021234567890') // '6222 0212 3456 7890'
+ */
+export declare function formatBankCard(card: string): string;
+/**
+ * 格式化手机号（添加空格）
+ * @param phone 手机号
+ * @returns 格式化后的手机号，格式：138 1234 5678
+ * @example
+ * formatPhone('13812345678') // '138 1234 5678'
+ */
+export declare function formatPhone(phone: string): string;
+/**
+ * 生成随机字符串
+ * @param length 字符串长度
+ * @param type 字符类型：'alpha' | 'number' | 'alphanumeric'
+ * @returns 随机字符串
+ * @example
+ * randomString(8) // 'aB3dE9fG'
+ * randomString(6, 'alpha') // 'aBcDeF'
+ * randomString(6, 'number') // '123456'
+ */
+export declare function randomString(length?: number, type?: 'alpha' | 'number' | 'alphanumeric'): string;
+/**
+ * 生成唯一 ID（基于时间戳和随机数）
+ * @param prefix 前缀
+ * @returns 唯一 ID
+ * @example
+ * generateUUID() // '1704067200000_a3b2c1'
+ * generateUUID('user') // 'user_1704067200000_a3b2c1'
+ */
+export declare function generateUUID(prefix?: string): string;
+/**
+ * 截断字符串
+ * @param str 字符串
+ * @param maxLength 最大长度
+ * @param suffix 后缀，默认 '...'
+ * @returns 截断后的字符串
+ * @example
+ * truncate('这是一个很长的字符串', 5) // '这是一个很...'
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * 移除字符串中的 HTML 标签
+ * @param html HTML 字符串
+ * @returns 纯文本字符串
+ * @example
+ * removeHtmlTags('<p>Hello <strong>World</strong></p>') // 'Hello World'
+ */
+export declare function removeHtmlTags(html: string): string;
+/**
+ * 转义 HTML 特殊字符
+ * @param html HTML 字符串
+ * @returns 转义后的字符串
+ * @example
+ * escapeHtml('<div>Hello & "World"</div>') // '&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;'
+ */
+export declare function escapeHtml(html: string): string;
+/**
+ * 反转义 HTML 特殊字符
+ * @param html 转义后的 HTML 字符串
+ * @returns 原始字符串
+ * @example
+ * unescapeHtml('&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;') // '<div>Hello & "World"</div>'
+ */
+export declare function unescapeHtml(html: string): string;
+/**
+ * 判断字符串是否为空（null、undefined、空字符串、仅空格）
+ * @param str 字符串
+ * @returns 是否为空
+ * @example
+ * isEmpty('') // true
+ * isEmpty('  ') // true
+ * isEmpty('hello') // false
+ */
+export declare function isEmpty(str: string | null | undefined): boolean;
+/**
+ * 反转字符串
+ * @param str 字符串
+ * @returns 反转后的字符串
+ * @example
+ * reverse('hello') // 'olleh'
+ */
+export declare function reverse(str: string): string;
+/**
+ * 重复字符串
+ * @param str 字符串
+ * @param count 重复次数
+ * @returns 重复后的字符串
+ * @example
+ * repeat('ab', 3) // 'ababab'
+ */
+export declare function repeat(str: string, count: number): string;
+/**
+ * 补齐字符串（左侧）
+ * @param str 字符串
+ * @param length 目标长度
+ * @param char 填充字符，默认空格
+ * @returns 补齐后的字符串
+ * @example
+ * padStart('5', 3, '0') // '005'
+ */
+export declare function padStart(str: string, length: number, char?: string): string;
+/**
+ * 补齐字符串（右侧）
+ * @param str 字符串
+ * @param length 目标长度
+ * @param char 填充字符，默认空格
+ * @returns 补齐后的字符串
+ * @example
+ * padEnd('5', 3, '0') // '500'
+ */
+export declare function padEnd(str: string, length: number, char?: string): string;