rxtutils 1.1.2-beta.9 → 1.1.4-beta.1

package/{dist/es → es}/cache/index.mjs

@@ -1,7 +1,7 @@
 import { __awaiter, __generator, __assign } from 'tslib';
 import moment from 'moment';
 import { IndexedDBStorage } from './indexDB.mjs';
-import defaultEquals from '../defaultEquals.mjs';
+import defaultEquals from '../_utils/defaultEquals.mjs';
 
 /** 存储类型映射表 */
 var StorageMap = {
@@ -14,8 +14,16 @@ var StorageMap = {
  * @template Data 缓存数据类型
  */
 var Cache = /** @class */ (function () {
+    /**
+     * 构造函数
+     * @param cacheType 存储类型
+     * @param cacheKey 缓存键名
+     * @param cacheTime 缓存时间（秒）
+     * @param indexDBName IndexedDB 数据库名称，默认值为 '__apiCacheDatabase__'
+     * @param cacheKeyEquals 缓存键比较函数，默认使用 defaultEquals
+     */
     function Cache(cacheType, cacheKey, cacheTime, indexDBName, cacheKeyEquals) {
-        if (indexDBName === void 0) { indexDBName = '__apiCacheDatabase__'; }
+        if (indexDBName === void 0) { indexDBName = "__apiCacheDatabase__"; }
         if (cacheKeyEquals === void 0) { cacheKeyEquals = defaultEquals; }
         /** 内存中的缓存数组 */
         this.cache = [];
@@ -26,10 +34,10 @@ var Cache = /** @class */ (function () {
             indexDBName: indexDBName,
             cacheKeyEquals: cacheKeyEquals,
         };
-        if (cacheType === 'indexedDB') {
-            this.storage = new IndexedDBStorage(indexDBName, 'cacheStore');
+        if (cacheType === "indexedDB") {
+            this.storage = new IndexedDBStorage(indexDBName, "cacheStore");
         }
-        else if (typeof cacheType === 'string') {
+        else if (typeof cacheType === "string") {
             this.storage = StorageMap[cacheType];
         }
         this._init();
@@ -51,15 +59,15 @@ var Cache = /** @class */ (function () {
                         _d = (_c = JSON).parse;
                         return [4 /*yield*/, this.storage.getItem(cacheKey)];
                     case 1:
-                        _b.cache = _d.apply(_c, [(_e.sent()) || '[]']);
+                        _b.cache = _d.apply(_c, [(_e.sent()) || "[]"]);
                         return [3 /*break*/, 3];
                     case 2:
                         if (this.storage instanceof Storage) {
                             this.storage = StorageMap[cacheType];
                             if (this.storage) {
-                                if (typeof cacheKey === 'string') {
+                                if (typeof cacheKey === "string") {
                                     try {
-                                        this.cache = JSON.parse(this.storage.getItem(cacheKey) || '[]');
+                                        this.cache = JSON.parse(this.storage.getItem(cacheKey) || "[]");
                                     }
                                     catch (e) {
                                         this.cache = [];
@@ -76,7 +84,8 @@ var Cache = /** @class */ (function () {
                 }
             });
         });
-    }; /**
+    };
+    /**
      * 过滤掉已过期的缓存项
      * 通过比较当前时间和过期时间，移除过期的缓存项
      * @private
@@ -86,18 +95,20 @@ var Cache = /** @class */ (function () {
             return moment(item.expireTime).isAfter(moment());
         });
         this.cache = newCache;
-    }; /**
+    };
+    /**
      * 将当前缓存数据保存到存储中
      * 如果设置了缓存键名且存储实例存在，则将缓存数据序列化后保存
      * @private
      */
     Cache.prototype._saveToStorage = function () {
         if (this.storage) {
-            if (typeof this.cacheOptions.cacheKey === 'string') {
+            if (typeof this.cacheOptions.cacheKey === "string") {
                 this.storage.setItem(this.cacheOptions.cacheKey, JSON.stringify(this.cache));
             }
         }
-    }; /**
+    };
+    /**
      * 设置缓存数据
      * @param params 缓存的参数
      * @param data 要缓存的数据
@@ -114,10 +125,11 @@ var Cache = /** @class */ (function () {
         this.cache.push({
             params: params,
             data: data,
-            expireTime: moment().add(cacheTime, 'seconds').toJSON(),
+            expireTime: moment().add(cacheTime, "seconds").toJSON(),
         });
         this._saveToStorage();
-    }; /**
+    };
+    /**
      * 获取缓存数据
      * @param params 查询参数
      * @returns 如果找到有效的缓存数据则返回数据，否则返回 null
@@ -138,7 +150,8 @@ var Cache = /** @class */ (function () {
             }
         }
         return null;
-    }; /**
+    };
+    /**
      * 清空所有缓存数据
      * 清空内存中的缓存数组并同步到存储中
      */

package/es/cache/indexDB.d.ts

@@ -0,0 +1,52 @@
+/**
+ * IndexedDB 存储类
+ * 提供了对 IndexedDB 数据库操作的简单封装
+ */
+declare class IndexedDBStorage {
+    /** 数据库名称 */
+    private dbName;
+    /** 存储对象名称 */
+    private storeName;
+    /** 数据库连接实例 */
+    private db;
+    /**
+     * 构造函数
+     * @param dbName 数据库名称
+     * @param storeName 存储对象名称
+     */
+    constructor(dbName: string, storeName: string);
+    /**
+     * 打开数据库连接
+     * 如果数据库不存在则创建新的数据库和存储对象
+     * @private
+     * @returns Promise<IDBDatabase> 数据库连接实例
+     */
+    private _open;
+    /**
+     * 获取存储对象
+     * @param mode 事务模式，默认为只读模式
+     * - readonly: 只读模式
+     * - readwrite: 读写模式
+     * @private
+     * @returns Promise<IDBObjectStore> 存储对象实例
+     */
+    private _getStore;
+    /**
+     * 设置键值对
+     * @param key 键名
+     * @param value 要存储的值
+     * @returns Promise<void> 存储操作的结果
+     * @throws 当存储操作失败时抛出错误
+     */
+    setItem<T>(key: string, value: T): Promise<void>;
+    /**
+     * 获取键对应的值
+     * @param key 要获取的键名
+     * @returns Promise<T> 返回存储的值，如果不存在则返回 undefined
+     * @throws 当获取操作失败时抛出错误
+     * @template T 存储值的类型，默认为 any
+     */
+    getItem<T = any>(key: string): Promise<T>;
+}
+
+export { IndexedDBStorage };

package/es/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useCombineControlValue } from './useCombineControlValue.js';

package/es/hooks/index.mjs

@@ -0,0 +1 @@
+export { useCombineControlValue } from './useCombineControlValue.mjs';

package/es/hooks/useCombineControlValue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @param param props 组件属性
+ * @param param valueKey 组件值的key，默认value, undefined 被认为是有值，只有当 key 不存在时，转换为非受控模式
+ * @param param defaultValue 默认值
+ * @param param onChange 值改变时的回调
+ * @returns value: 组件应该采用的值，onChange：值改变时的回调，处理非受控值与向父组件传递值的逻辑
+ */
+declare const useCombineControlValue: <V>({ props, valueKey, defaultValue, onChange }: {
+    props: Record<string, any>;
+    valueKey?: string;
+    defaultValue?: V;
+    onChange?: (val: V) => void;
+}) => {
+    value: any;
+    onChange: (nextVal: V) => void;
+};
+
+export { useCombineControlValue };

package/es/hooks/useCombineControlValue.mjs

@@ -0,0 +1,30 @@
+import { useState, useCallback, useMemo } from 'react';
+
+/**
+ * @param param props 组件属性
+ * @param param valueKey 组件值的key，默认value, undefined 被认为是有值，只有当 key 不存在时，转换为非受控模式
+ * @param param defaultValue 默认值
+ * @param param onChange 值改变时的回调
+ * @returns value: 组件应该采用的值，onChange：值改变时的回调，处理非受控值与向父组件传递值的逻辑
+ */
+var useCombineControlValue = function (_a) {
+    var props = _a.props, _b = _a.valueKey, valueKey = _b === void 0 ? 'value' : _b, defaultValue = _a.defaultValue, onChange = _a.onChange;
+    var _c = props, _d = valueKey, value = _c[_d];
+    var hasValue = props.hasOwnProperty(valueKey);
+    var _e = useState(value !== null && value !== void 0 ? value : defaultValue), internalValue = _e[0], setInternalValue = _e[1];
+    var handleChange = useCallback(function (nextVal) {
+        setInternalValue(nextVal);
+        onChange === null || onChange === void 0 ? void 0 : onChange(nextVal);
+    }, [onChange]);
+    var finalValue = useMemo(function () {
+        if (hasValue)
+            return value;
+        return internalValue;
+    }, [hasValue, internalValue, value]);
+    return {
+        value: finalValue,
+        onChange: handleChange
+    };
+};
+
+export { useCombineControlValue };

package/es/index.d.ts

@@ -0,0 +1,7 @@
+export { default as Cache, ICache, ICacheOptions, StorageMap, StorageType } from './cache/index.js';
+export { ErrorHandlerReturnType, Options, RequestOptions, default as createBaseRequest } from './request/index.js';
+export { createStoreGetter, createStoreGetterMemo } from './store/createGetter/index.js';
+export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './store/createStateStore/index.js';
+export { BaseValidator } from './validator/validator.js';
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './validator/decorators.js';
+export { default as RequestError, RequestErrorType } from './request/error.js';

package/es/request/error.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 请求错误类型
+ * - server: 服务端业务错误
+ * - http: HTTP 网络错误
+ */
+type RequestErrorType = 'server' | 'http';
+/**
+ * 请求错误类
+ * 用于统一处理请求过程中的各种错误
+ *
+ * @template Data 错误数据类型
+ * @extends Error
+ */
+declare class RequestError<Data = any> extends Error {
+    /** 错误码 */
+    code: string;
+    /** 错误类型 */
+    type: RequestErrorType;
+    /** 错误相关的数据 */
+    data?: Data;
+    /**
+     * 构造函数
+     * @param message 错误消息
+     * @param type 错误类型
+     * @param data 错误相关的数据
+     */
+    constructor(message: string, type: RequestErrorType, data?: Data);
+}
+
+export { RequestError as default };
+export type { RequestErrorType };

package/es/request/index.d.ts

@@ -0,0 +1,140 @@
+import { AxiosResponse, Method, AxiosRequestConfig } from 'axios';
+import { StorageType } from '../cache/index.js';
+export { default as RequestError, RequestErrorType } from './error.js';
+
+/**
+ * 错误处理器返回类型
+ * @template D 响应数据类型
+ */
+type ErrorHandlerReturnType<D> = {
+    /** 替换响应数据 */
+    replaceResData?: D;
+    /**
+     * 是否抛出错误
+     * - true: 强制抛出错误
+     * - false: 不抛出错误
+     * - 'default': 使用默认错误处理逻辑
+     */
+    throwError?: boolean | "default";
+};
+/**
+ * 请求配置选项接口
+ * @template Params 请求参数类型
+ * @template Data 响应数据类型
+ */
+interface Options<Params = any, Data = any> {
+    /** 请求基础URL，默认为空字符串 */
+    baseURL?: string;
+    /**
+     * 是否抛出错误
+     * @default true
+     */
+    throwError?: boolean;
+    /**
+     * 默认的消息展示函数
+     * @default window.alert
+     */
+    defaultMessageShower?: (message: string) => void;
+    /**
+     * 是否启用缓存功能
+     * @default false
+     */
+    enableCache?: boolean;
+    /**
+     * 缓存键比较函数
+     * @default defaultEquals 使用 JSON.stringify 进行比较
+     */
+    cacheKeyEquals?: (prev: Params, next: Params) => boolean;
+    /**
+     * 是否将响应数据存入缓存
+     * @default false
+     */
+    cacheData?: boolean;
+    /**
+     * 缓存时间（秒）
+     * @default 60
+     */
+    cacheTime?: number;
+    /**
+     * 缓存数据的存储类型
+     * - localStorage: 使用浏览器本地存储，数据永久保存
+     * - sessionStorage: 使用会话存储，关闭浏览器后清除
+     * - indexedDB: 使用 IndexedDB 数据库存储
+     * - 不填则仅在内存中缓存，页面刷新后清除
+     */
+    cacheDataInStorage?: StorageType;
+    /**
+     * 缓存数据的键名
+     * @default `${method}:${baseURL}${url}` 默认使用请求方法、基础URL和请求路径组合
+     */
+    cacheDataKey?: string;
+    /**
+     * IndexedDB 数据库名称
+     * @default '__apiCacheDatabase__'
+     */
+    indexDBName?: string;
+    /**
+     * 错误码在响应数据中的路径
+     * @default 'code'
+     */
+    errorCodePath?: string;
+    /**
+     * 错误码映射表
+     * 可以配置错误码对应的错误信息或处理函数
+     * @default {} 空对象，使用默认处理函数
+     */
+    errorCodeMap?: Record<string, string | ((code: string, data: Data, res: AxiosResponse<Data>, requestParam: RequestOptions<Params>) => ErrorHandlerReturnType<Data> | void)>;
+    /**
+     * 默认错误码处理函数
+     * 当错误码不在 errorCodeMap 中时调用
+     */
+    defaultErrorCodeHandler?: (code: string, data: Data, res: AxiosResponse<Data>) => Promise<ErrorHandlerReturnType<Data> | void>;
+    /**
+     * 成功状态的错误码列表
+     * @default ['0', '200']
+     */
+    successCodes?: string[];
+    /**
+     * HTTP 错误码映射表
+     * 可以配置 HTTP 状态码对应的错误信息或处理函数
+     * @default {} 空对象，使用默认处理函数
+     */
+    httpErrorCodeMap?: Record<string, string | ((code: number, res: AxiosResponse<Data>, requestParam: RequestOptions<Params>) => Promise<ErrorHandlerReturnType<Data> | void>)>;
+    /**
+     * 默认 HTTP 错误码处理函数
+     * 当 HTTP 状态码不在 httpErrorCodeMap 中时调用
+     */
+    defaultHttpErrorCodeHandler?: (code: number, error: any) => Promise<ErrorHandlerReturnType<Data> | void>;
+    /**
+     * 其他错误处理函数
+     * 处理非 HTTP 错误和非业务错误码的错误
+     */
+    otherErrorHandler?: (error: any) => Promise<ErrorHandlerReturnType<Data> | void>;
+    axiosOptions?: Omit<AxiosRequestConfig<Params>, "method" | "url" | "params" | "data">;
+}
+/**
+ * 请求参数接口
+ * @template Param 请求参数类型
+ */
+interface RequestOptions<Param> {
+    /** HTTP 请求方法 */
+    method: Method;
+    /** 请求URL */
+    url: string;
+    /** POST/PUT 等请求的数据 */
+    data?: Param;
+    /** URL 查询参数 */
+    params?: Param;
+}
+/**
+ * 创建基础请求实例
+ * @param baseOptions 基础配置选项
+ * @returns 请求创建函数
+ */
+declare function createBaseRequest(baseOptions?: Options): <Param, Data extends Record<any, any>>(requestOptions: RequestOptions<Param>, createOptions?: Omit<Options<Param, Data>, "baseURL">) => {
+    (requestParam?: Omit<RequestOptions<Param>, "url" | "method">, options?: Omit<Options<Param, Data>, "baseURL" | "cacheDataKey" | "cacheDataInStorage" | "cacheKeyEquals">): Promise<Data>;
+    clearCache(): void;
+};
+
+export { createBaseRequest as default };
+export type { ErrorHandlerReturnType, Options, RequestOptions };

package/{dist/es → es}/request/index.mjs

@@ -1,8 +1,8 @@
 import { __assign, __awaiter, __generator } from 'tslib';
 import axios from 'axios';
-import { at } from 'lodash';
+import at from 'lodash-es/at';
 import { _defaultErrorCodeHandler, _defaultHttpErrorCodeHandler, _defaultOtherErrorCodeHandler } from './defaultHandlers.mjs';
-import defaultEquals from '../defaultEquals.mjs';
+import defaultEquals from '../_utils/defaultEquals.mjs';
 import Cache from '../cache/index.mjs';
 import RequestError from './error.mjs';
 

package/es/store/createGetter/index.d.ts

@@ -0,0 +1,30 @@
+import createStateStore from '../createStateStore/index.js';
+
+type StoreGetter<S = any> = {
+    [K in string]: (store: S) => any;
+};
+type GetterNameMap<G extends StoreGetter<any>> = {
+    [K in keyof G]: string;
+};
+type ReducedData<G extends StoreGetter<any>, M extends GetterNameMap<G>> = {
+    [K in keyof M as M[K]]: G[K extends keyof G ? K : never] extends (store: any) => infer R ? R : never;
+};
+/**
+ * 创建 store getter
+ * @param store store实例
+ * @param getters getter函数
+ * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
+ * @returns getter object
+ */
+declare const createStoreGetter: <S, G extends StoreGetter<S>, M extends GetterNameMap<G>>(store: ReturnType<typeof createStateStore<S>>, getters: G, getterNameMaps: M) => ReducedData<G, M>;
+/**
+ *
+ * @param store store实例
+ * @param getters getter函数
+ * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
+ * @returns getter memo hook
+ */
+declare const createStoreGetterMemo: <S, G extends StoreGetter<S>, M extends GetterNameMap<G>>(store: ReturnType<typeof createStateStore<S>>, getters: G, getterNameMaps: M) => () => ReducedData<G, M>;
+
+export { createStoreGetter, createStoreGetterMemo };
+export type { GetterNameMap, ReducedData, StoreGetter };

package/es/store/createStateStore/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 状态初始化设置器类型
+ * 用于延迟初始化状态的函数类型
+ */
+type IHookStateInitialSetter<S> = () => S;
+/**
+ * 状态初始化动作类型
+ * 可以是直接的状态值或初始化设置器
+ */
+type IHookStateInitAction<S> = S | IHookStateInitialSetter<S>;
+/**
+ * 状态设置器类型
+ * 可以是接收前一个状态的函数或无参数的函数
+ */
+type IHookStateSetter<S> = ((prevState: S) => S) | (() => S);
+/**
+ * 状态设置动作类型
+ * 可以是直接的状态值或状态设置器
+ */
+type IHookStateSetAction<S> = S | IHookStateSetter<S>;
+/**
+ * 可解析的状态类型
+ * 包含所有可能的状态值或状态设置函数
+ */
+type IHookStateResolvable<S> = S | IHookStateInitialSetter<S> | IHookStateSetter<S>;
+/**
+ * 创建状态存储
+ * 提供一个简单的状态管理解决方案，支持组件间状态共享
+ *
+ * @template S 状态类型
+ * @param initialState 初始状态值或初始化函数
+ * @returns 包含状态操作方法的对象
+ */
+declare function createStateStore<S>(initialState?: S): {
+    use: () => [S, (state: IHookStateSetAction<S>) => void];
+    get: () => S;
+    set: (state: IHookStateSetAction<S>) => void;
+    watch: (callback: (state: S) => S | void) => () => void;
+};
+
+export { createStateStore as default };
+export type { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter };

package/es/store/index.d.ts

@@ -0,0 +1,2 @@
+export { GetterNameMap, ReducedData, StoreGetter, createStoreGetter, createStoreGetterMemo } from './createGetter/index.js';
+export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './createStateStore/index.js';

package/es/store/index.mjs

@@ -0,0 +1,2 @@
+export { createStoreGetter, createStoreGetterMemo } from './createGetter/index.mjs';
+export { default as createStateStore } from './createStateStore/index.mjs';

package/es/validator/decorators.d.ts

@@ -0,0 +1,159 @@
+import { BaseValidator } from './validator.js';
+
+/**
+ * 验证器装饰器模块
+ * 提供一系列用于数据验证的装饰器，可用于类属性的验证规则定义
+ * 这些装饰器基于 BaseValidator 的 decoratorCreator 方法创建
+ */
+
+/**
+ * 必填项验证装饰器
+ * 验证值是否存在且不在指定的无效值列表中
+ *
+ * @param noneVals 被视为无效的值数组，默认为 [undefined]
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @(VRequired()('用户名不能为空'))
+ *   username?: string;
+ * }
+ */
+declare function VRequired(noneVals?: any[]): (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 字符串类型验证装饰器
+ * 验证值是否为字符串类型
+ *
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @VString('用户名必须为字符串')
+ *   username?: string;
+ * }
+ */
+declare const VString: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 数字类型验证装饰器
+ * 验证值是否为数字类型
+ *
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @VNumber('年龄必须为数字')
+ *   age?: number;
+ * }
+ */
+declare const VNumber: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 数组类型验证装饰器
+ * 验证值是否为数组类型
+ *
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @VArray('标签必须为数组')
+ *   tags?: string[];
+ * }
+ */
+declare const VArray: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 布尔类型验证装饰器
+ * 验证值是否为布尔类型
+ *
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @VBoolean('状态必须为布尔值')
+ *   active?: boolean;
+ * }
+ */
+declare const VBoolean: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 最小值验证装饰器
+ * 验证数字是否大于或等于指定的最小值
+ *
+ * @param min 最小值
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @(VMin(18)('年龄必须大于或等于18岁'))
+ *   age?: number;
+ * }
+ */
+declare const VMin: (min: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 最大值验证装饰器
+ * 验证数字是否小于或等于指定的最大值
+ *
+ * @param max 最大值
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @(VMax(120)('年龄必须小于或等于120岁'))
+ *   age?: number;
+ * }
+ */
+declare const VMax: (max: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 最小长度验证装饰器
+ * 验证字符串或数组的长度是否大于或等于指定的最小长度
+ *
+ * @param minLen 最小长度
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @(VMinLength(6)('密码长度不能少于6位'))
+ *   password?: string;
+ * }
+ */
+declare const VMinLength: (minLen: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 最大长度验证装饰器
+ * 验证字符串或数组的长度是否小于或等于指定的最大长度
+ *
+ * @param maxLen 最大长度
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @(VMaxLength(20)('用户名长度不能超过20位'))
+ *   username?: string;
+ * }
+ */
+declare const VMaxLength: (maxLen: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 邮箱格式验证装饰器
+ * 验证字符串是否符合邮箱格式
+ *
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @VEmail('邮箱格式不正确')
+ *   email?: string;
+ * }
+ */
+declare const VEmail: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+/**
+ * 正则表达式验证装饰器
+ * 验证字符串是否匹配指定的正则表达式模式
+ *
+ * @param pattern 正则表达式
+ * @returns 装饰器工厂函数，可接收自定义错误消息
+ *
+ * @example
+ * class User extends BaseValidator {
+ *   @(VPattern(/^1[3-9]\d{9}$/)('手机号格式不正确'))
+ *   phone?: string;
+ * }
+ */
+declare const VPattern: (pattern: RegExp) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString };

package/es/validator/index.d.ts

@@ -0,0 +1,2 @@
+export { BaseValidator } from './validator.js';
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './decorators.js';

package/es/validator/index.mjs

@@ -0,0 +1,2 @@
+export { BaseValidator } from './validator.mjs';
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './decorators.mjs';