taro-uno-ui 0.9.0 → 1.0.0

package/dist/types/utils.d.ts

@@ -0,0 +1,190 @@
+/**
+ * 通用工具类型定义
+ * 提供类型安全的工具函数和类型守卫
+ */
+import * as React from 'react';
+/** 可选类型 */
+export type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** 必选类型 */
+export type RequiredFields<T, K extends keyof T> = T & Required<Pick<T, K>>;
+/** 深度可选类型 */
+export type DeepOptional<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepOptional<T[P]> : T[P];
+};
+/** 深度必选类型 */
+export type DeepRequired<T> = {
+    [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : T[P];
+};
+/** 深度只读类型 */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/** 深度可写类型 */
+export type DeepWriteable<T> = {
+    -readonly [P in keyof T]: T[P] extends object ? DeepWriteable<T[P]> : T[P];
+};
+/** 递归排除类型 */
+export type RecursiveExclude<T, E> = T extends object ? {
+    [P in keyof T as T[P] extends E ? never : P]: RecursiveExclude<T[P], E>;
+} : T;
+/** 递归选择类型 */
+export type RecursivePick<T, K extends string> = T extends object ? {
+    [P in keyof T as P extends K ? P : never]: RecursivePick<T[P], K>;
+} : T;
+/** 提取Promise返回类型 */
+export type PromiseType<T> = T extends Promise<infer U> ? U : never;
+/** 提取函数参数类型 */
+export type FunctionArgs<T> = T extends (...args: infer A) => any ? A : never;
+/** 提取函数返回类型 */
+export type FunctionReturn<T> = T extends (...args: any) => infer R ? R : never;
+/** 提取React组件Props类型 */
+export type ComponentProps<T> = T extends React.ComponentType<infer P> ? P : never;
+/** 提取React组件Ref类型 */
+export type ComponentRef<T> = T extends React.Ref<infer R> ? R : never;
+/** 过滤掉undefined和null的类型 */
+export type NonNullable<T> = T extends null | undefined ? never : T;
+/** 过滤掉falsy值的类型 */
+export type Truthy<T> = T extends false | 0 | '' | null | undefined ? never : T;
+/** 首字母大写 */
+export type Capitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Uppercase<First>}${Rest}` : S;
+/** 首字母小写 */
+export type Uncapitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S;
+/** 转换为连字符格式 */
+export type KebabCase<S> = S extends `${infer First}${infer Rest}` ? Rest extends Uncapitalize<Rest> ? `${Lowercase<First>}${KebabCase<Rest>}` : `${Lowercase<First>}-${KebabCase<Rest>}` : S;
+/** 转换为驼峰格式 */
+export type CamelCase<S> = S extends `${infer First}-${infer Rest}` ? `${First}${Capitalize<CamelCase<Rest>>}` : S;
+/** 合并两个对象类型 */
+export type Merge<T, U> = Omit<T, keyof U> & U;
+/** 深度合并两个对象类型 */
+export type DeepMerge<T, U> = T extends object ? U extends object ? {
+    [K in keyof T | keyof U]: K extends keyof T ? K extends keyof U ? DeepMerge<T[K], U[K]> : T[K] : K extends keyof U ? U[K] : never;
+} : T : U;
+/** 选择对象中的部分属性 */
+export type PickPartial<T, K extends keyof T> = Pick<T, K> & Partial<T>;
+/** 选择对象中的必选属性 */
+export type PickRequired<T, K extends keyof T> = Pick<T, K> & Required<Pick<T, K>>;
+/** 数组元素类型 */
+export type ArrayElement<T> = T extends readonly (infer U)[] ? U : never;
+/** 过滤数组中的特定类型 */
+export type FilterArray<T, U> = T extends [infer First, ...infer Rest] ? First extends U ? [First, ...FilterArray<Rest, U>] : FilterArray<Rest, U> : [];
+/** 可选参数函数类型 */
+export type OptionalArgs<T extends (...args: any) => any> = (...args: Partial<FunctionArgs<T>> & []) => FunctionReturn<T>;
+/** 柯里化函数类型 */
+export type Curried<T> = T extends (...args: infer A) => infer R ? A extends [infer First, ...infer Rest] ? (arg: First) => Curried<(...args: Rest) => R> : R : never;
+/** 防抖函数类型 */
+export type Debounced<T extends (...args: any) => any> = {
+    (...args: Parameters<T>): ReturnType<T> | undefined;
+    cancel: () => void;
+    flush: () => ReturnType<T> | undefined;
+};
+/** 节流函数类型 */
+export type Throttled<T extends (...args: any) => any> = {
+    (...args: Parameters<T>): ReturnType<T> | undefined;
+    cancel: () => void;
+};
+/** 类型守卫：检查是否为字符串 */
+export declare function isString(value: unknown): value is string;
+/** 类型守卫：检查是否为数字 */
+export declare function isNumber(value: unknown): value is number;
+/** 类型守卫：检查是否为布尔值 */
+export declare function isBoolean(value: unknown): value is boolean;
+/** 类型守卫：检查是否为数组 */
+export declare function isArray<T>(value: unknown): value is T[];
+/** 类型守卫：检查是否为对象 */
+export declare function isObject<T extends object>(value: unknown): value is T;
+/** 类型守卫：检查是否为函数 */
+export declare function isFunction<T extends (...args: any) => any>(value: unknown): value is T;
+/** 类型守卫：检查是否为Promise */
+export declare function isPromise<T>(value: unknown): value is Promise<T>;
+/** 类型守卫：检查是否为React元素 */
+export declare function isReactElement(value: unknown): value is React.ReactElement;
+/** 类型守卫：检查是否为React组件 */
+export declare function isReactComponent<T extends React.ComponentType<any>>(value: unknown): value is T;
+/** 类型守卫：检查是否为undefined */
+export declare function isUndefined(value: unknown): value is undefined;
+/** 类型守卫：检查是否为null */
+export declare function isNull(value: unknown): value is null;
+/** 类型守卫：检查是否为空值 */
+export declare function isEmpty(value: unknown): value is null | undefined | '' | 0 | false;
+/** 类型守卫：检查是否为非空值 */
+export declare function isNotEmpty<T>(value: T | null | undefined): value is T;
+/** 验证结果类型 */
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+/** 验证函数类型 */
+export type Validator<T> = (value: unknown) => ValidationResult<T>;
+/** 创建验证器 */
+export declare function createValidator<T>(validate: (value: unknown) => value is T, errorMessage?: string): Validator<T>;
+/** 通用事件处理器类型 */
+export type EventHandler<T = any> = (event: T) => void;
+/** 阻止默认行为的事件处理器 */
+export type PreventDefaultHandler<T = any> = (event: T) => void;
+/** 停止传播的事件处理器 */
+export type StopPropagationHandler<T = any> = (event: T) => void;
+/** 创建阻止默认行为的事件处理器 */
+export declare function createPreventDefaultHandler<T extends {
+    preventDefault: () => void;
+}>(handler: EventHandler<T>): PreventDefaultHandler<T>;
+/** 创建停止传播的事件处理器 */
+export declare function createStopPropagationHandler<T extends {
+    stopPropagation: () => void;
+}>(handler: EventHandler<T>): StopPropagationHandler<T>;
+/** CSS属性类型 */
+export type CSSProperties = React.CSSProperties;
+/** 样式对象类型 */
+export type StyleObject = CSSProperties;
+/** 类名类型 */
+export type ClassName = string | string[] | {
+    [key: string]: boolean;
+} | undefined;
+/** 合并类名 */
+export declare function classNames(...classes: ClassName[]): string;
+/** 合并样式对象 */
+export declare function mergeStyles(...styles: (StyleObject | undefined)[]): StyleObject;
+/** 异步状态类型 */
+export type AsyncState<T> = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'success';
+    data: T;
+} | {
+    status: 'error';
+    error: string;
+};
+/** 异步操作类型 */
+export type AsyncOperation<T> = Promise<T> & {
+    cancel: () => void;
+};
+/** 创建可取消的Promise */
+export declare function createCancellablePromise<T>(promise: Promise<T>): AsyncOperation<T>;
+/** 通用键值对类型 */
+export type KeyValuePair<K = string, V = any> = [K, V];
+/** 通用记录类型 */
+export type RecordType<K extends string, V> = Record<K, V>;
+/** 通用映射类型 */
+export type MapType<K, V> = Map<K, V>;
+/** 通用集合类型 */
+export type SetType<T> = Set<T>;
+/** 类型安全的Object.keys */
+export declare function keys<T extends object>(obj: T): (keyof T)[];
+/** 类型安全的Object.values */
+export declare function values<T extends object>(obj: T): T[keyof T][];
+/** 类型安全的Object.entries */
+export declare function entries<T extends object>(obj: T): [keyof T, T[keyof T]][];
+/** 类型安全的Object.fromEntries */
+export declare function fromEntries<K extends string, V>(entries: [K, V][]): Record<K, V>;
+/** 推断数组元素类型 */
+export type InferArray<T> = T extends (infer U)[] ? U : never;
+/** 推断Promise返回类型 */
+export type InferPromise<T> = T extends Promise<infer U> ? U : never;
+/** 推断函数参数类型 */
+export type InferArgs<T> = T extends (...args: infer A) => any ? A : never;
+/** 推断函数返回类型 */
+export type InferReturn<T> = T extends (...args: any) => infer R ? R : never;

package/dist/utils/abort-controller.d.ts

@@ -0,0 +1,19 @@
+interface AbortSignal {
+    aborted: boolean;
+    onabort?: () => void;
+}
+export interface CompatibleAbortController {
+    signal: AbortSignal;
+    abort: () => void;
+}
+/**
+ * 创建兼容的 AbortController
+ * 在支持原生 AbortController 的环境中使用原生实现
+ * 在小程序等环境中使用模拟实现
+ */
+export declare function createAbortController(): CompatibleAbortController;
+/**
+ * 判断是否支持原生 AbortController
+ */
+export declare function isAbortControllerSupported(): boolean;
+export {};

package/dist/utils/cache.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 简单的数据缓存工具
+ */
+interface CacheOptions {
+    ttl?: number;
+    retries?: number;
+}
+declare class DataCache {
+    private cache;
+    /**
+     * 获取缓存数据或执行获取函数
+     */
+    fetch<T>(key: string, fetcher: () => Promise<T>, options?: CacheOptions): Promise<T>;
+    /**
+     * 使缓存失效
+     */
+    invalidate(key: string): void;
+    /**
+     * 清空所有缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存大小
+     */
+    size(): number;
+}
+export declare const dataFetcher: DataCache;
+export {};

package/dist/utils/createNamespace.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 创建BEM类名工具函数
+ * @param namespace 命名空间
+ * @returns BEM工具函数
+ */
+export declare const createNamespace: (namespace: string) => {
+    bem: (name?: string, modifiers?: string[]) => string;
+    namespace: string;
+};

package/dist/utils/environment.d.ts

@@ -0,0 +1,26 @@
+import type { Platform } from '../types';
+/**
+ * Detect whether code executes in a browser-like environment.
+ */
+export declare const isBrowserEnvironment: () => boolean;
+/**
+ * Detect whether Taro runtime is available (mini-program / native bridge).
+ */
+export declare const isTaroEnvironment: () => boolean;
+/**
+ * Resolve the current platform in a resilient manner.
+ */
+export declare const resolvePlatform: () => Platform | "unknown";
+/**
+ * Safe local storage wrapper guarding non-browser runtimes and incomplete localStorage implementations.
+ */
+export declare const safeLocalStorage: {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+};
+/**
+ * Guarded matchMedia helper for SSR / mini-program runtimes.
+ */
+export declare const safeMatchMedia: (query: string) => MediaQueryList | null;

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 简单的错误处理工具
+ */
+export declare enum ErrorType {
+    NETWORK = "NETWORK",
+    VALIDATION = "VALIDATION",
+    AUTHORIZATION = "AUTHORIZATION",
+    SERVER = "SERVER",
+    UNKNOWN = "UNKNOWN"
+}
+export declare enum ErrorSeverity {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+export interface AppError extends Error {
+    type: ErrorType;
+    severity: ErrorSeverity;
+    code?: string;
+    details?: unknown;
+}
+declare class ErrorHandler {
+    private static instance;
+    private constructor();
+    static getInstance(): ErrorHandler;
+    createError(message: string, type?: ErrorType, severity?: ErrorSeverity, code?: string, details?: unknown): AppError;
+    createNetworkError(message: string, code?: string): AppError;
+    createValidationError(message: string, code?: string): AppError;
+    createAuthorizationError(message: string, code?: string): AppError;
+    createServerError(message: string, code?: string): AppError;
+    handleError(error: Error | AppError): void;
+    private isAppError;
+}
+export declare const ErrorHandlingManager: typeof ErrorHandler;
+export declare const errorHandler: ErrorHandler;
+export {};

package/dist/utils/errorLogger.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 错误日志记录工具
+ * 提供统一的错误记录和上报功能
+ */
+interface ErrorLog {
+    timestamp: string;
+    message: string;
+    stack?: string | undefined;
+    componentStack?: string | null | undefined;
+    type: 'error' | 'warning' | 'info';
+    userAgent?: string | undefined;
+    url?: string | undefined;
+    userId?: string | undefined;
+}
+declare class ErrorLogger {
+    private logs;
+    private maxLogs;
+    /**
+     * 记录错误
+     * @param error 错误对象
+     * @param errorInfo React错误信息
+     * @param type 日志类型
+     */
+    log(error: Error, errorInfo?: React.ErrorInfo, type?: ErrorLog['type']): void;
+    /**
+     * 记录普通消息
+     * @param message 消息内容
+     * @param type 日志类型
+     */
+    logMessage(message: string, type?: ErrorLog['type']): void;
+    /**
+     * 添加日志到本地存储
+     * @param log 日志对象
+     */
+    private addLog;
+    /**
+     * 保存日志到本地存储
+     */
+    private saveToLocalStorage;
+    /**
+     * 从本地存储加载日志
+     */
+    private loadFromLocalStorage;
+    /**
+     * 上报错误到服务器
+     * @param log 日志对象
+     */
+    private reportToServer;
+    /**
+     * 获取用户ID（如果有）
+     */
+    private getUserId;
+    /**
+     * 获取所有日志
+     */
+    getLogs(): ErrorLog[];
+    /**
+     * 清除所有日志
+     */
+    clearLogs(): void;
+    /**
+     * 初始化错误日志记录器
+     */
+    init(): void;
+}
+declare const errorLogger: ErrorLogger;
+export declare const logError: (error: Error, errorInfo?: React.ErrorInfo) => void;
+export declare const logWarning: (message: string) => void;
+export declare const logInfo: (message: string) => void;
+export declare const getErrorLogs: () => ErrorLog[];
+export declare const clearErrorLogs: () => void;
+export default errorLogger;

package/dist/utils/formatUtils.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 格式化工具函数库
+ * 提供通用的格式化逻辑，包括日期、时间、货币、数字等格式化
+ */
+interface DateFormatOptions {
+    format?: string;
+    locale?: string;
+    timezone?: string;
+}
+/** 日期时间格式化工具类 */
+export declare class DateTimeFormatUtils {
+    /** 格式化日期 */
+    static formatDate(date: Date | string | number, options?: DateFormatOptions): string;
+    /** 相对时间格式化 */
+    static formatRelativeTime(date: Date | string | number, locale?: string): string;
+    /** 获取时间段描述 */
+    static getTimeOfDay(hours: number): string;
+    /** 格式化时间段 */
+    static formatTimeRange(start: Date | string, end: Date | string): string;
+    /** 获取星期几 */
+    static getWeekday(date: Date | string | number, locale?: string): string;
+    /** 检查是否为今天 */
+    static isToday(date: Date | string | number): boolean;
+    /** 检查是否为昨天 */
+    static isYesterday(date: Date | string | number): boolean;
+    /** 检查是否为明天 */
+    static isTomorrow(date: Date | string | number): boolean;
+}
+interface NumberFormatOptions {
+    locale?: string;
+    style?: 'decimal' | 'currency' | 'percent' | 'unit';
+    currency?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    minimumIntegerDigits?: number;
+    useGrouping?: boolean;
+}
+/** 数字格式化工具类 */
+export declare class NumberFormatUtils {
+    /** 格式化数字 */
+    static formatNumber(num: number, options?: NumberFormatOptions): string;
+    /** 格式化货币 */
+    static formatCurrency(amount: number, currency?: string, locale?: string): string;
+    /** 格式化百分比 */
+    static formatPercent(value: number, decimals?: number, locale?: string): string;
+    /** 格式化文件大小 */
+    static formatFileSize(bytes: number, decimals?: number, locale?: string): string;
+    /** 格式化数字缩写 */
+    static formatNumberAbbreviation(num: number, decimals?: number, locale?: string): string;
+    /** 格式化序数 */
+    static formatOrdinal(num: number, locale?: string): string;
+    /** 格式化科学计数法 */
+    static formatScientific(num: number, precision?: number): string;
+    /** 格式化罗马数字 */
+    static formatRoman(num: number): string;
+}
+/** 字符串格式化工具类 */
+export declare class StringFormatUtils {
+    /** 首字母大写 */
+    static capitalize(str: string): string;
+    /** 驼峰命名转下划线命名 */
+    static camelToSnake(str: string): string;
+    /** 下划线命名转驼峰命名 */
+    static snakeToCamel(str: string): string;
+    /** 中划线命名转驼峰命名 */
+    static kebabToCamel(str: string): string;
+    /** 驼峰命名转中划线命名 */
+    static camelToKebab(str: string): string;
+    /** 格式化手机号 */
+    static formatPhone(phone: string, separator?: string): string;
+    /** 格式化身份证号 */
+    static formatIdCard(idCard: string): string;
+    /** 格式化银行卡号 */
+    static formatBankCard(cardNumber: string, separator?: string): string;
+    /** 截断字符串 */
+    static truncate(str: string, length: number, suffix?: string): string;
+    /** 高亮关键词 */
+    static highlightKeywords(text: string, keywords: string[], highlightClass?: string): string;
+    /** 移除HTML标签 */
+    static stripHtml(html: string): string;
+    /** 转义HTML特殊字符 */
+    static escapeHtml(text: string): string;
+    /** 反转义HTML特殊字符 */
+    static unescapeHtml(html: string): string;
+    /** 生成UUID */
+    static generateUUID(): string;
+    /** 格式化模板字符串 */
+    static template(template: string, data: Record<string, any>, delimiter?: string): string;
+}
+export declare const dateTimeFormat: typeof DateTimeFormatUtils;
+export declare const numberFormat: typeof NumberFormatUtils;
+export declare const stringFormat: typeof StringFormatUtils;
+export {};

package/dist/utils/http/error-codes.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 统一错误码规范
+ * 提供完整的错误码定义和错误信息映射
+ */
+/** 错误码类型 */
+export declare enum ErrorCode {
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    CANCEL_ERROR = "CANCEL_ERROR",
+    INVALID_URL = "INVALID_URL",
+    INSECURE_URL = "INSECURE_URL",
+    HTTP_400 = "HTTP_400",
+    HTTP_401 = "HTTP_401",
+    HTTP_403 = "HTTP_403",
+    HTTP_404 = "HTTP_404",
+    HTTP_405 = "HTTP_405",
+    HTTP_408 = "HTTP_408",
+    HTTP_409 = "HTTP_409",
+    HTTP_410 = "HTTP_410",
+    HTTP_422 = "HTTP_422",
+    HTTP_429 = "HTTP_429",
+    HTTP_500 = "HTTP_500",
+    HTTP_501 = "HTTP_501",
+    HTTP_502 = "HTTP_502",
+    HTTP_503 = "HTTP_503",
+    HTTP_504 = "HTTP_504",
+    HTTP_505 = "HTTP_505",
+    BUSINESS_ERROR = "BUSINESS_ERROR",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    DATA_NOT_FOUND = "DATA_NOT_FOUND",
+    DATA_CONFLICT = "DATA_CONFLICT",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    USER_NOT_LOGGED_IN = "USER_NOT_LOGGED_IN",
+    USER_SESSION_EXPIRED = "USER_SESSION_EXPIRED",
+    USER_TOKEN_INVALID = "USER_TOKEN_INVALID",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    SYSTEM_ERROR = "SYSTEM_ERROR",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    DATABASE_ERROR = "DATABASE_ERROR",
+    CACHE_ERROR = "CACHE_ERROR",
+    SECURITY_ERROR = "SECURITY_ERROR",
+    XSS_ATTACK = "XSS_ATTACK",
+    CSRF_ATTACK = "CSRF_ATTACK",
+    SQL_INJECTION = "SQL_INJECTION",
+    INVALID_SIGNATURE = "INVALID_SIGNATURE",
+    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    UNEXPECTED_ERROR = "UNEXPECTED_ERROR",
+    NOT_SUPPORTED = "NOT_SUPPORTED",
+    FEATURE_DISABLED = "FEATURE_DISABLED"
+}
+/** 错误信息映射 */
+export declare const ERROR_MESSAGES: Record<ErrorCode, string>;
+/** 错误严重程度 */
+export declare enum ErrorSeverity {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+/** 错误严重程度映射 */
+export declare const ERROR_SEVERITY: Record<ErrorCode, ErrorSeverity>;
+/** 错误码工具函数 */
+export declare const ErrorCodeUtils: {
+    /**
+     * 根据HTTP状态码获取对应的错误码
+     */
+    fromHttpStatus(statusCode: number): ErrorCode;
+    /**
+     * 获取错误信息
+     */
+    getErrorMessage(code: ErrorCode, customMessage?: string): string;
+    /**
+     * 获取错误严重程度
+     */
+    getSeverity(code: ErrorCode): ErrorSeverity;
+    /**
+     * 检查错误是否为网络错误
+     */
+    isNetworkError(code: ErrorCode): boolean;
+    /**
+     * 检查错误是否为认证错误
+     */
+    isAuthError(code: ErrorCode): boolean;
+    /**
+     * 检查错误是否为系统错误
+     */
+    isSystemError(code: ErrorCode): boolean;
+    /**
+     * 检查错误是否为业务错误
+     */
+    isBusinessError(code: ErrorCode): boolean;
+};
+declare const _default: {
+    ErrorCode: typeof ErrorCode;
+    ERROR_MESSAGES: Record<ErrorCode, string>;
+    ErrorSeverity: typeof ErrorSeverity;
+    ERROR_SEVERITY: Record<ErrorCode, ErrorSeverity>;
+    ErrorCodeUtils: {
+        /**
+         * 根据HTTP状态码获取对应的错误码
+         */
+        fromHttpStatus(statusCode: number): ErrorCode;
+        /**
+         * 获取错误信息
+         */
+        getErrorMessage(code: ErrorCode, customMessage?: string): string;
+        /**
+         * 获取错误严重程度
+         */
+        getSeverity(code: ErrorCode): ErrorSeverity;
+        /**
+         * 检查错误是否为网络错误
+         */
+        isNetworkError(code: ErrorCode): boolean;
+        /**
+         * 检查错误是否为认证错误
+         */
+        isAuthError(code: ErrorCode): boolean;
+        /**
+         * 检查错误是否为系统错误
+         */
+        isSystemError(code: ErrorCode): boolean;
+        /**
+         * 检查错误是否为业务错误
+         */
+        isBusinessError(code: ErrorCode): boolean;
+    };
+};
+export default _default;

package/dist/utils/http/http-client.d.ts

@@ -0,0 +1,53 @@
+import { IRequestAdapter } from './types';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export interface RequestOptions {
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    data?: any;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+    baseUrl?: string;
+}
+export interface HttpClientConfig {
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    adapter?: IRequestAdapter;
+}
+interface RequestConfig {
+    method: HttpMethod;
+    url: string;
+    headers: Record<string, string>;
+    data?: any;
+}
+interface ResponseData {
+    status: number;
+    ok: boolean;
+    headers: Headers | Record<string, string>;
+    data: any;
+}
+type RequestInterceptor = (_config: RequestConfig) => RequestConfig;
+type ResponseInterceptor = (_response: ResponseData) => ResponseData;
+export declare class HttpClient {
+    private baseUrl;
+    private defaultHeaders;
+    private errorManager;
+    private security;
+    private requestInterceptors;
+    private responseInterceptors;
+    private adapter;
+    constructor(config?: HttpClientConfig);
+    private getDefaultAdapter;
+    addRequestInterceptor(interceptor: RequestInterceptor): void;
+    addResponseInterceptor(interceptor: ResponseInterceptor): void;
+    request<T>(url: string, options?: RequestOptions): Promise<T>;
+    get<T>(url: string, options?: Omit<RequestOptions, 'method' | 'data'>): Promise<T>;
+    post<T>(url: string, data?: any, options?: Omit<RequestOptions, 'method' | 'data'>): Promise<T>;
+    put<T>(url: string, data?: any, options?: Omit<RequestOptions, 'method' | 'data'>): Promise<T>;
+    patch<T>(url: string, data?: any, options?: Omit<RequestOptions, 'method' | 'data'>): Promise<T>;
+    delete<T>(url: string, options?: Omit<RequestOptions, 'method' | 'data'>): Promise<T>;
+    private buildUrl;
+}
+export declare const httpClient: HttpClient;
+export default HttpClient;