@puresnake/snake-ui 0.0.0-stage → 0.0.2

package/libs/function/index.ts

@@ -0,0 +1,31 @@
+/**
+ * function 基础层桶入口：全量展开供 foundation 聚合为 $snake；
+ * 宿主按需引入单个模块时走 `libs/function/xxx` 子路径。
+ */
+export * from './unit';
+export * from './sleep';
+export * from './guid';
+export * from './getRect';
+export * from './toast';
+export * from './system';
+export * from './route';
+export * from './queryParams';
+export * from './timeFormat';
+export * from './timeFrom';
+export * from './color';
+export * from './deepClone';
+export * from './deepMerge';
+export * from './debounce';
+export * from './throttle';
+export * from './random';
+export * from './randomArray';
+export * from './trim';
+export * from './test';
+export * from './style';
+export * from './format';
+export * from './clipboard';
+export * from './type2icon';
+export * from './emitter';
+export * from './getParent';
+export * from './$parent';
+export * from './styleUtils';

package/libs/function/queryParams.ts

@@ -0,0 +1,73 @@
+/**
+ * URL 查询串工具：queryParams 负责「对象 → 串」拼接（与 uView Pro 的
+ * queryParams 语义一致），getQueryParams 负责「串 → 对象」解析。
+ */
+
+/** 数组参数的序列化格式：indices 下标 / brackets 中括号 / repeat 重复键 / comma 逗号合并 */
+export type QueryArrayFormat = 'indices' | 'brackets' | 'repeat' | 'comma';
+
+const ARRAY_FORMATS = ['indices', 'brackets', 'repeat', 'comma'];
+
+/**
+ * 把对象拼接成 URL 查询串（uview 的 queryParams 兼容实现）。
+ *
+ * - 空值（'' / undefined / null）参数直接跳过；
+ * - 数组按 arrayFormat 序列化，默认 brackets（key[]=v1&key[]=v2）；
+ * - 普通对象 JSON 序列化并 encodeURIComponent；
+ * - 其余值经模板字符串原样输出、不做额外编码，与 uview 行为一致。
+ *
+ * @param data 参数对象
+ * @param isPrefix 是否自动加上 "?"，默认 true
+ * @param arrayFormat 数组格式，默认 brackets
+ */
+export function queryParams(
+    data: Record<string, unknown> = {},
+    isPrefix = true,
+    arrayFormat: QueryArrayFormat = 'brackets'
+): string {
+    const prefix = isPrefix ? '?' : '';
+    const result: string[] = [];
+    const format = (ARRAY_FORMATS as string[]).includes(arrayFormat) ? arrayFormat : 'brackets';
+
+    Object.keys(data).forEach(key => {
+        const value = data[key];
+        // 过滤空参数，与 uview 行为一致
+        if (value === '' || value === undefined || value === null) return;
+
+        if (Array.isArray(value)) {
+            if (format === 'indices') {
+                value.forEach((item, index) => result.push(`${key}[${index}]=${item}`));
+            } else if (format === 'brackets') {
+                value.forEach(item => result.push(`${key}[]=${item}`));
+            } else if (format === 'repeat') {
+                value.forEach(item => result.push(`${key}=${item}`));
+            } else {
+                result.push(`${key}=${value.join(',')}`);
+            }
+            return;
+        }
+
+        if (value !== null && typeof value === 'object') {
+            result.push(`${key}=${encodeURIComponent(JSON.stringify(value))}`);
+            return;
+        }
+
+        result.push(`${key}=${value}`);
+    });
+
+    return prefix + result.join('&');
+}
+
+/**
+ * 解析 url 的 query 串为对象：取第一个 ? 之后、# 之前的部分，
+ * key / value 均做 URL 解码并把 + 还原为空格；参数段内再含 = 时值会被截断。
+ */
+export function getQueryParams(url: string): Record<string, string> {
+    const query = url.split('?')[1]?.split('#')[0] || '';
+    return query.split('&').reduce<Record<string, string>>((result, part) => {
+        if (!part) return result;
+        const [key, value = ''] = part.split('=');
+        result[decodeURIComponent(key.replace(/\+/g, ' '))] = decodeURIComponent(value.replace(/\+/g, ' '));
+        return result;
+    }, {});
+}

package/libs/function/random.ts

@@ -0,0 +1,6 @@
+/** 生成 [min, max] 闭区间随机整数；两参大小颠倒时自动交换，默认 [0, 1]。 */
+export function random(min = 0, max = 1): number {
+    const lower = Math.ceil(Math.min(min, max));
+    const upper = Math.floor(Math.max(min, max));
+    return Math.floor(Math.random() * (upper - lower + 1)) + lower;
+}

package/libs/function/randomArray.ts

@@ -0,0 +1,14 @@
+import { random } from './random';
+
+/**
+ * Fisher–Yates 洗牌：返回打乱后的新数组，不改动原数组。
+ * 分布均匀，且无原地副作用。
+ */
+export function randomArray<T>(values: readonly T[]): T[] {
+    const result = [...values];
+    for (let index = result.length - 1; index > 0; index -= 1) {
+        const next = random(0, index);
+        [result[index], result[next]] = [result[next], result[index]];
+    }
+    return result;
+}

package/libs/function/route.ts

@@ -0,0 +1,155 @@
+import { getQueryParams } from './queryParams';
+
+/**
+ * 路由跳转双入口：
+ * - route()：uni 跳转 API 的 Promise 化封装，带别名映射与入参校验；
+ * - navTo()：面向 CMS / 运营链接，识别外链、跨小程序、微信客服三类特殊协议。
+ */
+
+export type RouteType = 'navigateTo' | 'to' | 'redirect' | 'redirectTo' | 'switchTab' | 'tab' | 'reLaunch' | 'navigateBack' | 'back';
+export type RouteParamValue = string | number | boolean | null | undefined;
+export type RouteParams = Record<string, RouteParamValue | readonly RouteParamValue[]>;
+
+/** route() 的跳转配置；type 支持 uni 方法名与短别名（to / redirect / tab / back）。 */
+export interface RouteOptions {
+    type?: RouteType;
+    url?: string;
+    params?: RouteParams;
+    delta?: number;
+    animationType?: string;
+    animationDuration?: number;
+}
+
+type NavigationMethod = 'navigateTo' | 'redirectTo' | 'switchTab' | 'reLaunch' | 'navigateBack';
+
+// 调用方别名 → uni 实际跳转方法
+const routeTypeMap: Record<RouteType, NavigationMethod> = {
+    navigateTo: 'navigateTo',
+    to: 'navigateTo',
+    redirect: 'redirectTo',
+    redirectTo: 'redirectTo',
+    switchTab: 'switchTab',
+    tab: 'switchTab',
+    reLaunch: 'reLaunch',
+    navigateBack: 'navigateBack',
+    back: 'navigateBack'
+};
+
+/**
+ * 往 url 追加查询参数：数组值展开为同名多段，null / undefined 跳过，
+ * 已有 query 用 & 衔接，hash 段原样保留在末尾。
+ */
+function appendQueryParams(url: string, params?: RouteParams): string {
+    if (!params) return url;
+    const entries: string[] = [];
+    Object.entries(params).forEach(([key, rawValue]) => {
+        const values = Array.isArray(rawValue) ? rawValue : [rawValue];
+        values.forEach(value => {
+            if (value === null || value === undefined) return;
+            entries.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+        });
+    });
+    if (!entries.length) return url;
+    const hashIndex = url.indexOf('#');
+    const path = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
+    const hash = hashIndex >= 0 ? url.slice(hashIndex) : '';
+    const separator = path.includes('?') ? (path.endsWith('?') || path.endsWith('&') ? '' : '&') : '?';
+    return `${path}${separator}${entries.join('&')}${hash}`;
+}
+
+function routeError(message: string): Error {
+    return new Error(`[Snake UI] ${message}`);
+}
+
+/**
+ * Promise 化路由跳转：成功 resolve；type 不认识、平台缺 API 或跳转失败均 reject。
+ * navigateBack 只认 delta（取整、至少 1）；switchTab 不追加参数（uni 该 API 不支持 query）；
+ * animationType / animationDuration 仅 navigateTo / redirectTo 透传（App 端生效）。
+ */
+export function route(url: string, params?: RouteParams): Promise<void>;
+export function route(options: RouteOptions): Promise<void>;
+export function route(input: string | RouteOptions, params?: RouteParams): Promise<void> {
+    const options: RouteOptions = typeof input === 'string' ? { url: input, params } : input || {};
+    const requestedType = options.type || 'navigateTo';
+    const method = routeTypeMap[requestedType];
+    if (!method) return Promise.reject(routeError(`Unsupported route type: ${String(requestedType)}.`));
+
+    const platformMethod = (uni as unknown as Record<string, unknown>)[method];
+    if (typeof platformMethod !== 'function') return Promise.reject(routeError(`${method} is unavailable on this platform.`));
+
+    let navigationOptions: Record<string, unknown>;
+    if (method === 'navigateBack') {
+        navigationOptions = { delta: Math.max(1, Math.trunc(Number(options.delta) || 1)) };
+    } else {
+        const url = String(options.url || '').trim();
+        if (!url) return Promise.reject(routeError(`${method} requires a non-empty url.`));
+        navigationOptions = { url: method === 'switchTab' ? url : appendQueryParams(url, options.params) };
+        if (method === 'navigateTo' || method === 'redirectTo') {
+            if (options.animationType !== undefined) navigationOptions.animationType = options.animationType;
+            if (options.animationDuration !== undefined) navigationOptions.animationDuration = options.animationDuration;
+        }
+    }
+
+    return new Promise((resolve, reject) => {
+        (platformMethod as (options: Record<string, unknown>) => void)({
+            ...navigationOptions,
+            success: () => resolve(),
+            fail: (error: { errMsg?: string }) => reject(routeError(error?.errMsg || `${method} failed.`))
+        });
+    });
+}
+
+function parseJsonObject(raw: string | undefined): Record<string, unknown> {
+    if (!raw) return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    } catch {
+        return {};
+    }
+}
+
+/**
+ * CMS / 运营链接跳转：识别三类特殊协议（http 外链、/miniprogram、/serviceChat，
+ * 详见各分支注释）后落到 uni.navigateTo，失败自动降级 switchTab（兼容 tabbar 页）。
+ */
+export function navTo(url?: string): void {
+    if (!url) return;
+    if (/^https?:\/\//i.test(url)) {
+        // H5 外链沿用浏览器跳转，其余平台交由业务方提供 web-view 页面。
+        // #ifdef H5
+        window.location.href = url;
+        // #endif
+        return;
+    }
+
+    // 小程序打开其他小程序：/miniprogram?appId=wx...&path=pages/...&extra={...}
+    // 运行时探测跨小程序 API，避免平台条件编译差异。
+    if (url.includes('/miniprogram')) {
+        if (typeof uni.navigateToMiniProgram !== 'function') return;
+        const query = getQueryParams(url);
+        const appId = query.wxAppId || query.aliAppId || query.appId || '';
+        if (!appId) return;
+        uni.navigateToMiniProgram({
+            appId,
+            path: query.path || '',
+            extraData: parseJsonObject(query.extra),
+            envVersion: (query.envVersion as 'release' | 'develop' | 'trial') || 'release',
+            fail: () => {}
+        });
+        return;
+    }
+
+    // 微信客服：/serviceChat?url=...&corpId=...
+    if (url.includes('/serviceChat')) {
+        if (typeof uni.openCustomerServiceChat !== 'function') return;
+        const query = getQueryParams(url);
+        uni.openCustomerServiceChat({
+            extInfo: { url: query.url || '' },
+            corpId: query.corpId || ''
+        });
+        return;
+    }
+
+    uni.navigateTo({ url, fail: () => uni.switchTab({ url }) });
+}

package/libs/function/sleep.ts

@@ -0,0 +1,7 @@
+/**
+ * 延时等待：把 setTimeout 包成 Promise，用 `await sleep(ms)` 让逻辑按节奏暂停。
+ * @param delay 等待时长，单位 ms，默认 0
+ */
+export function sleep(delay = 0): Promise<void> {
+    return new Promise(resolve => setTimeout(resolve, delay));
+}

package/libs/function/style.ts

@@ -0,0 +1,58 @@
+import type { CSSProperties } from 'vue';
+
+/**
+ * 样式值归一化与串化。与 styleUtils 的分工：这里不过滤无效值，
+ * 需要 'null' / 'undefined' 字符串清洗的合并场景用 styleUtils.mergeStyles。
+ */
+
+/** 可归一为样式声明集合的输入：声明字符串、样式对象（含 CSSProperties）或其数组。 */
+export type StyleSource = string | CSSProperties | Record<string, unknown> | StyleSource[] | null | undefined;
+
+/** 驼峰 / 空格 / 下划线分隔转短横线小写（CSS 属性名风格）。 */
+export function kebabCase(value: string): string {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+
+/**
+ * 样式输入归一化：target='object'（默认）统一返回样式对象，声明串按 ; 与首个 : 拆解；
+ * target='string' 统一返回样式串（非字符串输入经 toStyle 转换）。
+ */
+export function addStyle(style: StyleSource, target: 'object' | 'string' = 'object'): Record<string, string> | string {
+    if (target === 'string') return typeof style === 'string' ? style : toStyle(style);
+    if (Array.isArray(style)) return toStyle(style);
+    if (typeof style !== 'string') {
+        if (!style) return {};
+        return Object.fromEntries(Object.entries(style).map(([key, value]) => [key, String(value)]));
+    }
+    return style.split(';').reduce<Record<string, string>>((result, declaration) => {
+        const separator = declaration.indexOf(':');
+        if (separator < 0) return result;
+        const key = declaration.slice(0, separator).trim();
+        const value = declaration.slice(separator + 1).trim();
+        if (key && value) result[key] = value;
+        return result;
+    }, {});
+}
+
+/**
+ * 合并多份样式输入为一条 `k:v;k:v` 串：键统一短横线小写，
+ * 后出现的同键覆盖先出现的（Map 去重），null / 空串值跳过。
+ */
+export function toStyle(...styles: Array<StyleSource>): string {
+    // 兼容旧用法：单个数组整体传入时（如 [object, string]）解构展开
+    if (styles.length === 1 && Array.isArray(styles[0])) {
+        styles = (styles[0] as StyleSource[]).slice();
+    }
+    const declarations = new Map<string, string>();
+    styles.forEach(style => {
+        const source = typeof style === 'string' ? (addStyle(style) as Record<string, string>) : style;
+        if (!source) return;
+        Object.entries(source).forEach(([key, value]) => {
+            if (value != null && value !== '') declarations.set(kebabCase(key), String(value));
+        });
+    });
+    return Array.from(declarations, ([key, value]) => `${key}:${value}`).join(';');
+}

package/libs/function/styleUtils.ts

@@ -0,0 +1,83 @@
+import type { CSSProperties } from 'vue';
+import { trim } from './trim';
+import { test } from './test';
+
+/**
+ * 样式合并的「清洗」版：合并前过滤 'null' / 'undefined' 字符串等无效值，
+ * 适合拼接来源不可控的样式（如接口下发的 customStyle）；基础归一化见 style.ts。
+ */
+
+/** 过滤空值与 'null' / 'undefined' 字符串，这类脏值常见于接口透传。 */
+function isValidValue(value: unknown): boolean {
+    if (test.isEmpty(value)) return false;
+    if (typeof value === 'string') {
+        const trimmed = trim(value).toLowerCase();
+        return trimmed !== 'null' && trimmed !== 'undefined' && trimmed !== '';
+    }
+    return true;
+}
+
+/** 将 CSS 字符串解析为驼峰键对象。 */
+function cssStrToObj(str: string): Record<string, string> {
+    const result: Record<string, string> = {};
+    if (!isValidValue(str)) return result;
+    const declarations = trim(String(str)).split(';');
+    declarations.forEach(decl => {
+        const [prop, ...values] = decl.split(':').map(segment => segment.trim());
+        const value = values.join(':');
+        if (prop && value) {
+            const camelProp = prop.replace(/-([a-z])/g, (_match, letter: string) => letter.toUpperCase());
+            result[camelProp] = value;
+        }
+    });
+    return result;
+}
+
+/** 将驼峰键对象转换为 CSS 字符串。 */
+function cssObjToStr(obj: CSSProperties): string {
+    if (!isValidValue(obj) || typeof obj !== 'object') return '';
+    return (
+        Object.entries(obj)
+            .map(([key, value]) => {
+                if (!isValidValue(value)) return '';
+                // 驼峰转短横线
+                const kebab = key.replace(/([A-Z])/g, '-$1').toLowerCase();
+                return `${kebab}: ${value}`;
+            })
+            .filter(Boolean)
+            .join('; ') + ';'
+    );
+}
+
+/**
+ * 合并多个 CSS 输入（对象或字符串），返回一个 CSS 对象，后参数覆盖先参数。
+ */
+export function mergeStyles(...args: (object | string)[]): CSSProperties {
+    const result = {} as Record<string, any>;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // 保持历史语义：遇到无效来源立即停止，后续样式不会再参与合并，而不是简单跳过该项。
+        if (!isValidValue(arg)) return result as CSSProperties;
+        if (typeof arg === 'string') {
+            Object.assign(result, cssStrToObj(arg));
+        } else if (test.object(arg)) {
+            const cleanedObj: Record<string, any> = {};
+            Object.keys(arg).forEach(key => {
+                const value = (arg as Record<string, any>)[key];
+                if (isValidValue(value)) {
+                    cleanedObj[key] = value;
+                }
+            });
+            Object.assign(result, cleanedObj);
+        }
+    }
+    return result as CSSProperties;
+}
+
+/**
+ * 合并多个 CSS 输入并返回 CSS 字符串。
+ */
+export function mergeCssStrings(...args: (object | string)[]): string {
+    const obj = mergeStyles(...args);
+    return cssObjToStr(obj);
+}

package/libs/function/system.ts

@@ -0,0 +1,14 @@
+/** 获取系统信息：每次实时读取，不做缓存（窗口尺寸、主题等可能变化）。 */
+export function getSystemInfo(): UniApp.GetSystemInfoResult {
+    return uni.getSystemInfoSync();
+}
+
+/** sys 是 getSystemInfo 的短别名。 */
+export function sys(): UniApp.GetSystemInfoResult {
+    return getSystemInfo();
+}
+
+/** 当前操作系统平台（统一小写，如 'ios' / 'android' / 'devtools'）。 */
+export function os(): string {
+    return String(sys().platform || '').toLowerCase();
+}

package/libs/function/test.ts

@@ -0,0 +1,202 @@
+/**
+ * 常用校验套件，便于组件移植直接引用。
+ * snake 原有校验器语义保持不变：number 为 Number.isFinite 版、object 为纯对象判定、
+ * empty 对 null/''/空数组/空对象返回 true。
+ */
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+    if (!value || Object.prototype.toString.call(value) !== '[object Object]') return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === null || prototype === Object.prototype;
+}
+
+/** 验证电子邮箱格式。 */
+function email(value: unknown): boolean {
+    return /[\w!#$%&'*+/=?^_`{|}~-]+(?:\.[\w!#$%&'*+/=?^_`{|}~-]+)*@(?:[\w](?:[\w-]*[\w])?\.)+[\w](?:[\w-]*[\w])?/.test(
+        String(value)
+    );
+}
+
+/** 验证手机号格式（大陆 1[3-9] 段）。 */
+function mobile(value: unknown): boolean {
+    return /^1[3-9]\d{9}$/.test(String(value));
+}
+
+/** 验证 URL 格式。 */
+function url(value: unknown): boolean {
+    return /^http(s)?:\/\/([\w-]+\.)+[\w-]+(\/[\w-./?%&=]*)?/.test(String(value));
+}
+
+/** 验证可被 Date 解析的日期格式。 */
+function date(value: unknown): boolean {
+    return !/Invalid|NaN/.test(new Date(String(value)).toString());
+}
+
+/** 验证 ISO 类型的日期格式（yyyy/mm/dd 或 yyyy-mm-dd）。 */
+function dateISO(value: unknown): boolean {
+    return /^\d{4}[/-](0?[1-9]|1[012])[/-](0?[1-9]|[12][0-9]|3[01])$/.test(String(value));
+}
+
+/** 验证十进制数字（snake 语义：Number.isFinite，非正则）。 */
+function number(value: unknown): boolean {
+    return value !== '' && Number.isFinite(Number(value));
+}
+
+/** 验证纯整数。 */
+function digits(value: unknown): boolean {
+    return /^\d+$/.test(String(value));
+}
+
+/** 验证身份证号码。 */
+function idCard(value: unknown): boolean {
+    return /^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}([0-9]|X)$/.test(String(value));
+}
+
+/** 验证车牌号（含新能源 8 位与传统能源 7 位）。 */
+function carNo(value: unknown): boolean {
+    const input = String(value);
+    // 新能源车牌
+    const xreg =
+        /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}(([0-9]{5}[DF]$)|([DF][A-HJ-NP-Z0-9][0-9]{4}$))/;
+    // 旧车牌
+    const creg =
+        /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}[A-HJ-NP-Z0-9]{4}[A-HJ-NP-Z0-9挂学警港澳]{1}$/;
+    if (input.length === 7) return creg.test(input);
+    if (input.length === 8) return xreg.test(input);
+    return false;
+}
+
+/** 验证金额（最多 2 位小数，支持千分位）。 */
+function amount(value: unknown): boolean {
+    return /^[1-9]\d*(,\d{3})*(\.\d{1,2})?$|^0\.\d{1,2}$/.test(String(value));
+}
+
+/** 验证纯中文。 */
+function chinese(value: unknown): boolean {
+    return /^[一-龥]+$/gi.test(String(value));
+}
+
+/** 验证纯字母。 */
+function letter(value: unknown): boolean {
+    return /^[a-zA-Z]*$/.test(String(value));
+}
+
+/** 验证字母或数字。 */
+function enOrNum(value: unknown): boolean {
+    return /^[0-9a-zA-Z]*$/g.test(String(value));
+}
+
+/** 验证是否包含某个值。 */
+function contains(value: unknown, param: string): boolean {
+    return String(value).indexOf(param) >= 0;
+}
+
+/** 验证数值范围 [min, max]。 */
+function range(value: number, param: [number, number]): boolean {
+    return value >= param[0] && value <= param[1];
+}
+
+/** 验证字符串长度范围 [min, max]。 */
+function rangeLength(value: string, param: [number, number]): boolean {
+    return value.length >= param[0] && value.length <= param[1];
+}
+
+/** 验证固定电话。 */
+function landline(value: unknown): boolean {
+    return /^\d{3,4}-\d{7,8}(-\d{3,4})?$/.test(String(value));
+}
+
+/** 判断是否为空（snake 语义：null/undefined/''/空数组/空对象）。 */
+function empty(value: unknown): boolean {
+    return (
+        value == null ||
+        value === '' ||
+        (Array.isArray(value) && value.length === 0) ||
+        (isPlainObject(value) && Object.keys(value).length === 0)
+    );
+}
+
+/** 验证 JSON 字符串。 */
+function jsonString(value: unknown): boolean {
+    if (typeof value !== 'string') return false;
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed === 'object' && parsed !== null;
+    } catch {
+        return false;
+    }
+}
+
+/** 验证短信验证码（默认 6 位数字）。 */
+function code(value: unknown, len = 6): boolean {
+    return new RegExp(`^\\d{${len}}$`).test(String(value));
+}
+
+/** 判断是否函数。 */
+function func(value: unknown): value is (...args: unknown[]) => unknown {
+    return typeof value === 'function';
+}
+
+/** 判断是否 Promise 形对象。 */
+function promise(value: unknown): boolean {
+    return (
+        !!value &&
+        typeof value === 'object' &&
+        func((value as { then?: unknown }).then) &&
+        func((value as { catch?: unknown }).catch)
+    );
+}
+
+/** 判断是否图片格式地址。 */
+function image(value: unknown): boolean {
+    return /\.(jpeg|jpg|gif|png|svg|webp|jfif|bmp|dpg)/i.test(String(value).split('?')[0]);
+}
+
+/** 判断是否视频格式地址。 */
+function video(value: unknown): boolean {
+    return /\.(mp4|mpg|mpeg|dat|asf|avi|rm|rmvb|mov|wmv|flv|mkv|m3u8)/i.test(String(value).split('?')[0]);
+}
+
+/** 判断是否正则对象。 */
+function regExp(value: unknown): value is RegExp {
+    return !!value && Object.prototype.toString.call(value) === '[object RegExp]';
+}
+
+/** 验证字符串类型。 */
+function string(value: unknown): value is string {
+    return typeof value === 'string';
+}
+
+export const test = {
+    email,
+    mobile,
+    url,
+    date,
+    dateISO,
+    number,
+    digits,
+    idCard,
+    carNo,
+    amount,
+    chinese,
+    letter,
+    enOrNum,
+    contains,
+    range,
+    rangeLength,
+    empty,
+    isEmpty: empty,
+    jsonString,
+    landline,
+    object: isPlainObject,
+    array: Array.isArray,
+    code,
+    func,
+    promise,
+    video,
+    image,
+    regExp,
+    string
+};
+
+export type TestSuite = typeof test;