@base-web-kits/base-tools-ts 0.9.8 → 0.9.9

package/dist/url/oss/index.d.ts

@@ -0,0 +1,77 @@
+import type { OSSOption, OSSAudioOption, OSSHlsOption, OSSImgOption, OSSVideoOption } from './index.d';
+export * from './index.d';
+/**
+ * oss图片处理
+ * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/img-parameters/?spm=a2c4g.11186623.help-menu-31815.d_0_11_2_1.572824a1a1W5Pf&scm=20140722.H_144582._.OR_help-T_cn~zh-V_1
+ * @param src 原始图片URL
+ * @param option 图片处理选项
+ * @returns 处理后的图片URL（格式: `{src}?x-oss-process=image/xx`）
+ * @example
+ * 缩放: getOSSImg('xx.jpg', { resize: { w: 100, h: 100 } })
+ * 水印: getOSSImg('xx.jpg', { watermark: { text: '水印' } });
+ * 翻转: getOSSImg('xx.jpg', { flip: 1 });
+ * 裁剪: getOSSImg('xx.jpg', { crop: { w: 100, h: 100 } });
+ * 质量: getOSSImg('xx.jpg', { quality: { q: 80 } });
+ * 格式转换: getOSSImg('xx.jpg', { format: 'jpg' });
+ * 获取信息: getOSSImg('xx.jpg', { info: true });
+ * 自适应方向: getOSSImg('xx.jpg', { 'auto-orient': 1 });
+ * 内切圆: getOSSImg('xx.jpg', { circle: { r: 100 } });
+ * 索引切割: getOSSImg('xx.jpg', { indexcrop: { x: 100 } });
+ * 圆角: getOSSImg('xx.jpg', { 'rounded-corners': { r: 10 } });
+ * 模糊: getOSSImg('xx.jpg', { blur: { r: 10, s: 10 } });
+ * 旋转: getOSSImg('xx.jpg', { rotate: 90 });
+ * 渐进显示: getOSSImg('xx.jpg', { interlace: 1 });
+ * 主色调: getOSSImg('xx.jpg', { 'average-hue': true });
+ * 亮度: getOSSImg('xx.jpg', { bright: 10 });
+ * 锐化: getOSSImg('xx.jpg', { sharpen: 100 });
+ * 对比度: getOSSImg('xx.jpg', { contrast: 100 });
+ */
+export declare function getOSSImg(src: string, option: OSSImgOption): string;
+/**
+ * oss视频处理
+ * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/audio-and-video-processing/
+ * @param src 原始视频URL
+ * @param option 视频处理选项
+ * @returns 处理后的URL（格式: `{src}?x-oss-process=video/xx`）
+ * @example
+ * 视频转码: getOSSVideo('xx.mp4', { convert: { format: 'mp4' } })
+ * 转为动图: getOSSVideo('xx.mp4', { animation: { format: 'gif' } })
+ * 雪碧图: getOSSVideo('xx.mp4', { sprite: { format: 'png' } })
+ * 多帧截取: getOSSVideo('xx.mp4', { snapshots: { count: 3 } })
+ * 视频拼接: getOSSVideo('xx.mp4', { concat: { list: 'a.mp4,b.mp4' } })
+ * 信息查询: getOSSVideo('xx.mp4', { info: true })
+ * 组合操作: getOSSVideo('xx.mp4', { convert: { format: 'mp4' }, snapshots: { count: 3 } })
+ */
+export declare function getOSSVideo(src: string, option: OSSVideoOption): string;
+/**
+ * oss音频处理
+ * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/audio-and-video-processing/
+ * @param src 原始音频URL
+ * @param option 音频处理选项
+ * @returns 处理后的URL（格式: `{src}?x-oss-process=audio/xx`）
+ * @example
+ * 音频转码: getOSSAudio('xx.mp3', { 'convert': { format: 'mp3' } })
+ * 音频拼接: getOSSAudio('xx.mp3', { 'concat': { list: 'a.mp3,b.mp3' } })
+ * 信息查询: getOSSAudio('xx.mp3', { 'info': true })
+ */
+export declare function getOSSAudio(src: string, option: OSSAudioOption): string;
+/**
+ * oss直播处理（边转边播 HLS）
+ * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/audio-and-video-processing/
+ * @param src 原始视频URL
+ * @param option HLS 选项（或布尔）
+ * @returns 处理后的URL（格式: `{src}?x-oss-process=hls/xx`）
+ * @example
+ * 生成播放列表: getOSSHls('xx.mp4', { 'm3u8': true })
+ * 配置参数: getOSSHls('xx.mp4', { 'm3u8': { playlist: 1, segtime: 6 } })
+ */
+export declare function getOSSHls(src: string, option: OSSHlsOption): string;
+/**
+ * 构造oss处理地址
+ * @param src 原始地址
+ * @param type oss处理类型,如`image`, `audio`, `video`, `hls`
+ * @param option oss处理选项
+ * @returns 处理后的URL（格式: `{src}?x-oss-process={type}/{segs.join('/')}`）
+ */
+export declare function buildOSSUrl(src: string, type: string, option: OSSOption): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/url/oss/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ts/url/oss/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EAEf,MAAM,WAAW,CAAC;AAEnB,cAAc,WAAW,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,UAE1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,UAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,UAE9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,UAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,UAkBvE"}

package/dist/url/param/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 获取url的查询参数值
+ * - 采用纯JS解析，因为小程序不支持URLSearchParams
+ * @param key 参数名
+ * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
+ * @returns 解码后的参数值 (若不存在|"null"|"undefined"，则返回 null)
+ * @example
+ * const q = getUrlParam('q', 'https://a.com/?q=%E6%B5%8B%E8%AF%95'); // "测试"
+ * const a = getUrlParam('a', 'a=1'); // "1"
+ * const list = getUrlParam('list', 'list=[1,2]'); // "[1,2]"
+ * const list = getUrlParam('list', 'list=null'); // null
+ * const list = getUrlParam('list', 'list=undefined'); // null
+ */
+export declare function getUrlParam(key: string, url: string): string | null;
+/**
+ * 获取url的查询参数值,并转为number类型
+ * @param key 参数名
+ * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
+ * @returns 解码后的参数值 (若不存在|"非数字字符串"，则返回 null)
+ * @example
+ * const a = getUrlNumber('a', 'https://a.com/?a=1'); // 1
+ * const a = getUrlNumber('a', 'a=1'); // 1
+ * const a = getUrlNumber('a', 'a=1.2'); // 1.2
+ * const a = getUrlNumber('a', 'a=abc'); // null
+ */
+export declare function getUrlNumber(key: string, url: string): number | null;
+/**
+ * 获取url的所有查询参数值
+ * - 采用纯JS解析，因为小程序不支持URLSearchParams
+ * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
+ * @returns 解码后的键值对象（无参数返回空对象; "null"|"undefined"的参数会被忽略）
+ * @example
+ * const params = getUrlParamAll('a=1&b=2'); // { a: "1", b: "2" }
+ * const params = getUrlParamAll('https://a.com/?a=1&b=2'); // { a: "1", b: "2" }
+ * const params = getUrlParamAll('a=1&b=null'); // { a: "1" }
+ * const params = getUrlParamAll('a=1&b=undefined'); // { a: "1" }
+ */
+export declare function getUrlParamAll(url: string): Record<string, string>;
+/**
+ * 将对象参数拼接到 URL
+ * - 采用纯JS拼接，因为小程序不支持URLSearchParams
+ * @param url 基础地址
+ * @param param 将要追加的参数对象；`null/undefined` 值会被忽略，Object 会使用 `JSON.stringify`
+ * @returns 拼接后的完整 URL（保留原有哈希片段）
+ * @example
+ * const url = appendUrlParam('https://a.com', { q: '测试', list: [1, 2], a: null, b: undefined }); // 'https://a.com/?q=%E6%B5%8B%E8%AF%95&list=[1,2]'
+ */
+export declare function appendUrlParam(url: string, param: Record<string, unknown>): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/url/param/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ts/url/param/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,iBAqBnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,iBAMpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,0BAuBzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAkBzE"}

package/dist/url/qn/index.d.ts

@@ -0,0 +1,58 @@
+import type { QnImgOption } from './index.d';
+export * from './index.d';
+/**
+ * qn图片处理
+ * 参考官方文档: https://developer.qiniu.com/kodo/8623/dev-the-picture-style
+ * @param src 原始图片URL
+ * @param option 图片处理选项
+ * @returns 处理后的图片URL（格式: `{src}?imageView2/...|imageMogr2/...|watermark/...|imageslim|imageInfo`）
+ * @example
+ * 缩略: getQnImg('xx.jpg', { imageView2: { mode: 2, w: 100, h: 100 } })
+ * 高级缩放: getQnImg('xx.jpg', { thumbnail: '!50p' })
+ * 裁剪: getQnImg('xx.jpg', { crop: '100x100' })
+ * 旋转: getQnImg('xx.jpg', { rotate: 90 })
+ * 自适应方向: getQnImg('xx.jpg', { 'auto-orient': true })
+ * 格式转换: getQnImg('xx.jpg', { format: 'webp' })
+ * 质量: getQnImg('xx.jpg', { q: 80 })
+ * 渐进显示: getQnImg('xx.jpg', { interlace: 1 })
+ * 背景色填充: getQnImg('xx.jpg', { background: 'white' })
+ * 模糊: getQnImg('xx.jpg', { blur: { r: 10, s: 10 } })
+ * GIF颜色控制: getQnImg('xx.jpg', { colors: 64 })
+ * 图片瘦身: getQnImg('xx.jpg', { imageslim: true })
+ * 图片信息: getQnImg('xx.jpg', { imageInfo: true })
+ * 图片水印: getQnImg('xx.jpg', { watermark: { type: 'image', image: 'http://example.com/logo.png' } })
+ * 文字水印: getQnImg('xx.jpg', { watermark: { type: 'text', text: '水印', fontsize: 18 } })
+ */
+export declare function getQnImg(src: string, option: QnImgOption): string;
+/**
+ * qn视频处理
+ * 参考官方文档: https://developer.qiniu.com/kodo/12654/video-process
+ * @param src 原始视频URL
+ * @param option 视频处理选项（支持 avthumb、vframe）
+ * @returns 处理后的URL（格式: `{src}?avthumb/...|vframe/...`）
+ * @example
+ * 视频转码: getQnVideo('xx.mp4', { avthumb: { format: 'mp4', s: '1280x720', vcodec: 'libx264', vb: '1.25m' } })
+ * 截帧: getQnVideo('xx.mp4', { vframe: { format: 'jpg', offset: 3, w: 480, h: 360 } })
+ */
+export declare function getQnVideo(src: string, option: import('.').QnVideoOption): string;
+/**
+ * qn音频处理
+ * 参考官方文档: https://developer.qiniu.com/kodo/12654/video-process
+ * @param src 原始音频URL
+ * @param option 音频处理选项（通过 avthumb 转码）
+ * @returns 处理后的URL（格式: `{src}?avthumb/...`）
+ * @example
+ * 音频转码: getQnAudio('xx.aac', { avthumb: { format: 'mp3', ab: '128k', ar: 44100, acodec: 'libmp3lame' } })
+ */
+export declare function getQnAudio(src: string, option: import('.').QnAudioOption): string;
+/**
+ * qn实时转码（HLS 边转边播）
+ * 参考官方文档: https://developer.qiniu.com/kodo/12654/video-process、实时转码
+ * @param src 原始视频URL
+ * @param option HLS 选项
+ * @returns 处理后的URL（格式: `{src}?avcvt/{level}/format/m3u8/...`）
+ * @example
+ * 720P HLS: getQnHls('xx.mp4', { level: 3, format: 'm3u8', segtime: 6 })
+ */
+export declare function getQnHls(src: string, option: import('.').QnHlsOption): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/url/qn/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ts/url/qn/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAwD,MAAM,WAAW,CAAC;AAEnG,cAAc,WAAW,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,UAsBxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,aAAa,UAUxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,aAAa,UAQxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,WAAW,UAOpE"}

package/dist/validator/index.d.ts

@@ -0,0 +1,296 @@
+/**
+ * 纯字母（不含空格与符号）。
+ * @param s 字符串
+ * @returns 是否为字母
+ * @example
+ * isLetter('abc') // true
+ * isLetter('123') // false
+ * isLetter('abc123') // false
+ */
+export declare function isLetter(s: string): boolean;
+/**
+ * 纯中文（不含空格与符号）。
+ * @param s 字符串
+ * @returns 是否为纯中文
+ * @example
+ * isChinese('你好') // true
+ */
+export declare function isChinese(s: string): boolean;
+/**
+ * 纯数字（非负整数,不含空格与符号）。
+ * @param s 字符串
+ * @returns 是否为数字
+ * @example
+ * isDigits('12') // true
+ * isDigits('1.2') // false
+ * isDigits('-12') // false
+ * isDigits('a12') // false
+ */
+export declare function isDigits(s: string): boolean;
+/**
+ * 数字字符串格式校验
+ * @param value   待验证值（字符串或数字）
+ * @param options 可选项
+ * @param options.negative 是否允许负数，默认 false
+ * @param options.decimal 小数位数，默认 2（0 表示必须整数）
+ * @param options.thousands 是否允许千分位逗号，默认 false
+ * @param options.leadZero 是否允许整数部分出现多余前导0 (默认false, 即禁止'007'，但允许'0.50')
+ * @example
+ * isNumeric('123.45'); // true
+ * isNumeric('123.45', { decimal: 0 }); // false
+ * isNumeric('-1,234.5', { negative: true, thousands: true }); // true
+ * isNumeric('0123', { leadZero: true }); // true（现在允许）
+ * isNumeric('0123'); // false（默认禁止）
+ * isNumeric('0.50'); // true（始终允许）
+ * isNumeric('.5'); // false（整数部分不能省）
+ * isNumeric('123.'); // false（小数部分不能省）
+ */
+export declare function isNumeric(value: string | number, options?: {
+    negative?: boolean;
+    decimal?: number;
+    thousands?: boolean;
+    leadZero?: boolean;
+}): boolean;
+/**
+ * 是否为中国大陆手机号（11 位，以 1 开头，第二位 3-9）。
+ * @param s 待校验的号码
+ * @returns 是否为合法手机号
+ * @example
+ * isMobilePhone('13800138000') // true
+ * isMobilePhone('12800138000') // false
+ */
+export declare function isMobilePhone(s: string): boolean;
+/**
+ * 是否为中国大陆座机号（区号-号码，可选分机）。
+ * 格式：`0AA-BBBBBBBB(-EXT)`，其中区号 2-3 位、号码 7-8 位、分机 1-6 位。
+ * @param s 待校验的号码
+ * @returns 是否为合法座机号
+ * @example
+ * isLandline('010-88888888') // true
+ * isLandline('0371-12345678-123') // true
+ */
+export declare function isLandline(s: string): boolean;
+/**
+ * 联系电话：是否为中国大陆“手机号或座机号”。
+ * @param s 待校验的号码
+ * @returns 是否为合法的手机号或座机号
+ * @example
+ * isPhone('13800138000') // true
+ * isPhone('010-88888888') // true
+ */
+export declare function isPhone(s: string): boolean;
+/**
+ * 校验邮箱地址（基于 RFC 5322 的常用子集）。
+ * @param s 待校验的邮箱字符串
+ * @returns 是否为合法邮箱
+ * @example
+ * isEmail('user@example.com') // true
+ * isEmail('invalid@') // false
+ */
+export declare function isEmail(s: string): boolean;
+/**
+ * 中文姓名（允许中间点 `·`），长度 2-20。
+ * @param s 姓名
+ * @returns 是否为合法中文姓名
+ * @example
+ * isChineseName('张三') // true
+ * isChineseName('阿·娜') // true
+ */
+export declare function isChineseName(s: string): boolean;
+/**
+ * 身份证校验（支持中国大陆严格校验；台湾/香港/澳门做格式校验）。
+ * 规则：
+ * - 中国大陆（严格）：18 位校验位 + 出生日期合法性；兼容 15 位旧号（日期校验）；
+ * - 台湾（格式）：`^[A-Z][12]\d{8}$`（首字母 + 性别位 1/2 + 8 位数字）；不含校验位算法；
+ * - 香港（格式）：`^[A-Z]{1,2}\d{6}\(?[0-9A]\)?$`（1-2 字母 + 6 位数字 + 校验位，可带括号）；
+ * - 澳门（格式）：常见为 `^[157]\d{6}\(?\d\)?$`（类别位 1/5/7 + 7 位数字 + 校验位，可带括号）。
+ * @param code 身份证号码
+ * @returns 是否为合法身份证号
+ * @example
+ * isIdentityCard('11010519491231002X') // true（大陆）
+ * isIdentityCard('A123456789') // true（台湾格式）
+ * isIdentityCard('A123456(3)') // true（香港格式）
+ * isIdentityCard('1234567(8)') // true（澳门格式）
+ */
+export declare function isIdentityCard(code: string): boolean;
+/**
+ * 护照号码校验（宽松通用格式，适合单输入框无法确认国家的场景）。
+ * 说明：各国护照格式差异较大，此函数提供常见模式的格式校验；不做校验位算法。
+ * 包含：
+ * - 中国护照常见：`E/G` 开头 + 8 位数字；`D/P/S` 开头 + 7 位数字；
+ * - 台湾护照常见：首字母 + 8 位数字；
+ * - 通用兜底：6-9 位的字母数字组合；移除输入中的空格与 `-` 后再校验。
+ * @param s 护照号码
+ * @returns 是否匹配常见护照格式
+ * @example
+ * isPassport('E12345678') // true
+ * isPassport('P1234567') // true
+ * isPassport('A12345678') // true（台湾常见）
+ * isPassport('AB-1234567') // true（移除分隔符后匹配）
+ */
+export declare function isPassport(s: string): boolean;
+/**
+ * 港澳通行证（回乡证）号码校验。
+ * 说明：常见为 `H/M` 开头 + 8~10 位数字；自动移除输入中的空格与 `-`。
+ * @param s 证件号
+ * @returns 是否为港澳通行证格式
+ * @example
+ * isHKMOPermit('H12345678') // true
+ * isHKMOPermit('M1234567890') // true
+ */
+export declare function isHKMOPermit(s: string): boolean;
+/**
+ * 台湾居民来往大陆通行证（台胞证）号码校验。
+ * 说明：常见为 8 位纯数字；或首字母 + 8 位数字；部分场景存在 10 位数字。
+ * @param s 证件号
+ * @returns 是否为台胞证格式
+ * @example
+ * isTaiwanPermit('12345678') // true
+ * isTaiwanPermit('T12345678') // true
+ * isTaiwanPermit('1234567890') // true
+ */
+export declare function isTaiwanPermit(s: string): boolean;
+/**
+ * 军官证号码校验：字母数字组合，长度 7-18。
+ * @param s 证件号
+ * @returns 是否为军官证宽松格式
+ * @example
+ * isOfficerIdLoose('JX1234567') // true
+ */
+export declare function isOfficerId(s: string): boolean;
+/**
+ * 士兵证号码校验：字母数字组合，长度 7-18。
+ * @param s 证件号
+ * @returns 是否为士兵证格式
+ * @example
+ * isSoldierId('SB12345678') // true
+ */
+export declare function isSoldierId(s: string): boolean;
+/**
+ * 中国军证（军官证/士兵证）组合校验。
+ * @param s 证件号
+ * @returns 是否为军官证或士兵证格式
+ * @example
+ * isCnMilitaryId('JX1234567') // true
+ */
+export declare function isMilitaryId(s: string): boolean;
+/**
+ * 银行卡号校验（Luhn 校验）。
+ * 说明：移除空格与 `-` 后进行 Luhn 校验；长度通常为 12-19 位。
+ * @param s 银行卡号
+ * @returns 是否通过 Luhn 校验
+ * @example
+ * isBankCard('6222 0201 2345 6789') // true
+ */
+export declare function isBankCard(s: string): boolean;
+/**
+ * 中国车牌号校验（含普通与新能源）。
+ * @param s 车牌号码
+ * @returns 是否为合法中国车牌
+ * @example
+ * isLicensePlate('京A12345') // true
+ * isLicensePlate('沪A12345D') // 新能源（末位 D/F）
+ * isLicensePlate('粤BDF12345') // 新能源（第三位 D/F）
+ */
+export declare function isLicensePlate(s: string): boolean;
+/**
+ * 校验统一社会信用代码（中国税号常用：18 位，含校验位）。
+ * 规则：
+ * - 字符集：数字与大写字母（不含 I/O/Z/S/V），即 `[0-9A-HJ-NPQRTUWXY]`；
+ * - 前 17 位参与加权求和，最后一位为校验码（取值 0-9 或 大写字母）。
+ * @param code 税号/统一社会信用代码
+ * @returns 是否为合法税号
+ * @example
+ * isTaxID('91350100M000100Y43') // true/false 取决于校验位
+ */
+export declare function isTaxID(code: string): boolean;
+/**
+ * 判断字符串是否为合法 JSON 文本。
+ * 说明：传入字符串时尝试 `JSON.parse`；传入对象/数组则视为合法。
+ * @param input 待判定的值或字符串
+ * @returns 是否为合法 JSON
+ * @example
+ * isJSON('{"a":1}') // true
+ * isJSON('[1,2]') // true
+ * isJSON('abc') // false
+ */
+export declare function isJSON(input: unknown): boolean;
+/**
+ * HEX 颜色值（支持 `#RGB`、`#RRGGBB`、`#RRGGBBAA`）。
+ * @param s 颜色字符串
+ * @returns 是否为合法 HEX 颜色
+ * @example
+ * isHexColor('#fff') // true
+ * isHexColor('#00ff00') // true
+ * isHexColor('#11223344') // true
+ */
+export declare function isHexColor(s: string): boolean;
+/**
+ * 校验 URL（要求含协议，支持 http/https/ftp）。
+ * @param s 待校验的地址
+ * @returns 是否为合法 URL
+ * @example
+ * isURL('https://example.com/path?a=1') // true
+ * isURL('example.com') // false（缺少协议）
+ */
+export declare function isURL(s: string): boolean;
+/**
+ * 判断是否为合法 IPv6 地址（支持压缩表示与 IPv4 映射）。
+ * 规则：
+ * - 由 8 组 1~4 位十六进制数组成，允许一次 `::` 压缩；
+ * - 允许最后一组使用 IPv4 映射（如 `::ffff:192.168.0.1`）。
+ * @param s IP 字符串
+ * @returns 是否为合法 IPv6
+ * @example
+ * isIPv6('2001:0db8:85a3:0000:0000:8a2e:0370:7334') // true
+ * isIPv6('2001:db8::8a2e:370:7334') // true
+ * isIPv6('2001:::370:7334') // false
+ */
+export declare function isIPv6(s: string): boolean;
+/**
+ * 校验 IP（支持 IPv4 与 IPv6）。
+ * @param s IP 字符串
+ * @param version 指定版本：传 `4` 仅校验 IPv4，传 `6` 仅校验 IPv6；缺省同时校验两者
+ * @returns 是否为合法 IP
+ * @example
+ * isIP('127.0.0.1') // true
+ * isIP('::1') // true
+ * isIP('127.0.0.1', 6) // false
+ */
+export declare function isIP(s: string, version?: 4 | 6 | '4' | '6'): boolean;
+/**
+ * 校验 CIDR IP 段（支持 IPv4/IPv6），形如 `IP/前缀长度`。
+ * @param s CIDR 字符串，如 `192.168.0.0/24`、`2001:db8::/32`
+ * @returns 是否为合法 CIDR
+ * @example
+ * isIPRange('10.0.0.0/8') // true
+ * isIPRange('2001:db8::/129') // false
+ */
+export declare function isIPRange(s: string): boolean;
+/**
+ * 端口号校验（0 ~ 65535，整数）。
+ * @param s 端口（字符串或数字）
+ * @returns 是否为合法端口范围
+ * @example
+ * isPortNumber(80) // true
+ * isPortNumber('65535') // true
+ * isPortNumber(70000) // false
+ */
+export declare function isPortNumber(s: string | number): boolean;
+/**
+ * 纬度校验（-90 ~ 90）。
+ * @param s 纬度值（字符串或数字）
+ * @returns 是否为合法纬度
+ * @example
+ * isLatitude('31.2304') // true
+ */
+export declare function isLatitude(s: string | number): boolean;
+/**
+ * 经度校验（-180 ~ 180）。
+ * @param s 经度值（字符串或数字）
+ * @returns 是否为合法经度
+ * @example
+ * isLongitude('121.4737') // true
+ */
+export declare function isLongitude(s: string | number): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/validator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,WAEjC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,WAGlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,WAEjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,OAAO,CAkBT;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,WAGtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,WAGnC;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,WAEhC;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,WAMhC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,WAGtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,WA8C1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,WAUnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,WAMrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,WASvC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,WAMpC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,WAMpC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,WAErC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,WAiBnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,WASvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,WAcnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,WAapC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,WAGnC;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,WAS9B;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAmCzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,WAI1D;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,WAclC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,WAG9C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,WAG5C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,WAG7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-web-kits/base-tools-ts",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "sideEffects": false,
   "description": "Independent TS utilities package built from src/ts.",
   "keywords": [