taro-uno-ui 0.9.0 → 1.0.0

package/dist/constants/index.d.ts

@@ -0,0 +1,624 @@
+/**
+ * Taro-Uno UI 组件库常量定义
+ * 包含组件、主题、平台、错误码等常量
+ */
+import type { Platform, Size, Variant, Status, ThemeMode, AnimationType, AnimationDirection } from '../types';
+/** 组件尺寸常量 */
+export declare const COMPONENT_SIZES: Record<Size, string>;
+/** 组件变体常量 */
+export declare const COMPONENT_VARIANTS: Record<Variant, string>;
+/** 组件状态常量 */
+export declare const COMPONENT_STATUSES: Record<Status, string>;
+/** 组件前缀常量 */
+export declare const COMPONENT_PREFIX = "taro-uno";
+/** 组件类名前缀 */
+export declare const CLASS_PREFIX = "tu";
+/** 数据属性前缀 */
+export declare const DATA_PREFIX = "data-tu";
+/** 测试ID前缀 */
+export declare const TEST_ID_PREFIX = "tu-";
+/** 主题模式常量 */
+export declare const THEME_MODES: Record<ThemeMode, string>;
+/** 默认主题颜色 */
+export declare const DEFAULT_THEME_COLORS: {
+    primary: string;
+    secondary: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    background: string;
+    surface: string;
+    text: string;
+    textSecondary: string;
+    border: string;
+    divider: string;
+};
+/** 深色主题颜色 */
+export declare const DARK_THEME_COLORS: {
+    primary: string;
+    secondary: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    background: string;
+    surface: string;
+    text: string;
+    textSecondary: string;
+    border: string;
+    divider: string;
+};
+/** 默认间距配置 */
+export declare const DEFAULT_SPACING: {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    xxl: number;
+};
+/** 默认字体配置 */
+export declare const DEFAULT_TYPOGRAPHY: {
+    fontFamily: string;
+    fontSize: {
+        xs: number;
+        sm: number;
+        base: number;
+        lg: number;
+        xl: number;
+        '2xl': number;
+        '3xl': number;
+        '4xl': number;
+    };
+    fontWeight: {
+        normal: number;
+        medium: number;
+        bold: number;
+    };
+    lineHeight: {
+        tight: number;
+        normal: number;
+        relaxed: number;
+    };
+};
+/** 默认圆角配置 */
+export declare const DEFAULT_RADIUS: {
+    none: number;
+    sm: number;
+    md: number;
+    lg: number;
+    full: number;
+};
+/** 断点配置 */
+export declare const BREAKPOINTS: {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    xxl: number;
+};
+/** 平台名称映射 */
+export declare const PLATFORM_NAMES: Record<Platform, string>;
+/** 平台特性支持 */
+export declare const PLATFORM_FEATURES: Record<Platform, {
+    supportsStorage: boolean;
+    supportsNetwork: boolean;
+    supportsLocation: boolean;
+    supportsCamera: boolean;
+    supportsPayment: boolean;
+    supportsShare: boolean;
+    supportsBiometrics: boolean;
+}>;
+/** 平台API映射 */
+export declare const PLATFORM_APIS: Record<Platform, {
+    request: string;
+    storage: {
+        set: string;
+        get: string;
+        remove: string;
+        clear: string;
+    };
+    location: {
+        get: string;
+        open: string;
+    };
+    camera: {
+        take: string;
+        choose: string;
+    };
+}>;
+/** 动画类型常量 */
+export declare const ANIMATION_TYPES: Record<AnimationType, string>;
+/** 动画方向常量 */
+export declare const ANIMATION_DIRECTIONS: Record<AnimationDirection, string>;
+/** 动画时长配置 */
+export declare const ANIMATION_DURATIONS: {
+    fast: number;
+    normal: number;
+    slow: number;
+    slower: number;
+};
+/** 动画缓动函数 */
+export declare const ANIMATION_EASING: {
+    linear: string;
+    ease: string;
+    easeIn: string;
+    easeOut: string;
+    easeInOut: string;
+    bounce: string;
+};
+/** 事件名称常量 */
+export declare const EVENT_NAMES: {
+    click: string;
+    tap: string;
+    touchStart: string;
+    touchMove: string;
+    touchEnd: string;
+    touchCancel: string;
+    input: string;
+    change: string;
+    focus: string;
+    blur: string;
+    submit: string;
+    reset: string;
+    scroll: string;
+    resize: string;
+    load: string;
+    error: string;
+};
+/** 键盘按键常量 */
+export declare const KEY_CODES: {
+    enter: number;
+    escape: number;
+    space: number;
+    arrowUp: number;
+    arrowDown: number;
+    arrowLeft: number;
+    arrowRight: number;
+    tab: number;
+    backspace: number;
+    delete: number;
+    home: number;
+    end: number;
+    pageUp: number;
+    pageDown: number;
+};
+/** 请求方法常量 */
+export declare const REQUEST_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+/** HTTP状态码常量 */
+export declare const HTTP_STATUS_CODES: {
+    OK: number;
+    CREATED: number;
+    ACCEPTED: number;
+    NO_CONTENT: number;
+    BAD_REQUEST: number;
+    UNAUTHORIZED: number;
+    FORBIDDEN: number;
+    NOT_FOUND: number;
+    METHOD_NOT_ALLOWED: number;
+    CONFLICT: number;
+    UNPROCESSABLE_ENTITY: number;
+    INTERNAL_SERVER_ERROR: number;
+    NOT_IMPLEMENTED: number;
+    BAD_GATEWAY: number;
+    SERVICE_UNAVAILABLE: number;
+    GATEWAY_TIMEOUT: number;
+};
+/** 请求超时时间 */
+export declare const REQUEST_TIMEOUTS: {
+    short: number;
+    normal: number;
+    long: number;
+    veryLong: number;
+};
+/** 内容类型常量 */
+export declare const CONTENT_TYPES: {
+    json: string;
+    form: string;
+    multipart: string;
+    text: string;
+    html: string;
+    xml: string;
+};
+/** 错误码常量 */
+export declare const ERROR_CODES: {
+    UNKNOWN_ERROR: number;
+    INVALID_PARAMS: number;
+    NETWORK_ERROR: number;
+    TIMEOUT_ERROR: number;
+    PERMISSION_DENIED: number;
+    NOT_FOUND: number;
+    INTERNAL_ERROR: number;
+    PLATFORM_NOT_SUPPORTED: number;
+    API_NOT_AVAILABLE: number;
+    VERSION_TOO_LOW: number;
+    COMPONENT_NOT_FOUND: number;
+    INVALID_COMPONENT_CONFIG: number;
+    COMPONENT_RENDER_ERROR: number;
+    THEME_NOT_FOUND: number;
+    INVALID_THEME_CONFIG: number;
+    COLOR_FORMAT_ERROR: number;
+    FORM_VALIDATION_ERROR: number;
+    FIELD_REQUIRED: number;
+    INVALID_FORMAT: number;
+    VALUE_OUT_OF_RANGE: number;
+    STORAGE_QUOTA_EXCEEDED: number;
+    STORAGE_NOT_AVAILABLE: number;
+    STORAGE_KEY_NOT_FOUND: number;
+    REQUEST_FAILED: number;
+    RESPONSE_PARSE_ERROR: number;
+    UPLOAD_FAILED: number;
+    DOWNLOAD_FAILED: number;
+    LOCATION_PERMISSION_DENIED: number;
+    CAMERA_PERMISSION_DENIED: number;
+    STORAGE_PERMISSION_DENIED: number;
+    MICROPHONE_PERMISSION_DENIED: number;
+    USER_NOT_FOUND: number;
+    USER_ALREADY_EXISTS: number;
+    INVALID_CREDENTIALS: number;
+    ACCOUNT_LOCKED: number;
+    INSUFFICIENT_BALANCE: number;
+};
+/** 错误消息映射 */
+export declare const ERROR_MESSAGES: Record<number, string>;
+/** 常用正则表达式 */
+export declare const REGEX_PATTERNS: {
+    email: RegExp;
+    phone: RegExp;
+    idCard: RegExp;
+    url: RegExp;
+    ipAddress: RegExp;
+    port: RegExp;
+    chinese: RegExp;
+    english: RegExp;
+    alphanumeric: RegExp;
+    number: RegExp;
+    integer: RegExp;
+    float: RegExp;
+    strongPassword: RegExp;
+    date: RegExp;
+    time: RegExp;
+    color: RegExp;
+    zipCode: RegExp;
+    licensePlate: RegExp;
+};
+/** 缓存键常量 */
+export declare const CACHE_KEYS: {
+    userInfo: string;
+    userToken: string;
+    userSettings: string;
+    themeMode: string;
+    themeConfig: string;
+    appConfig: string;
+    appSettings: string;
+    lastUpdateTime: string;
+    cacheVersion: string;
+    cacheTimestamp: string;
+};
+/** Z-Index 层级配置 */
+export declare const Z_INDEX: {
+    modal: number;
+    dropdown: number;
+    tooltip: number;
+    notification: number;
+    header: number;
+    sidebar: number;
+    content: number;
+    footer: number;
+    background: number;
+    hidden: number;
+};
+/** 响应式断点配置 */
+export declare const RESPONSIVE_BREAKPOINTS: {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    xxl: number;
+};
+/** 响应式类名前缀 */
+export declare const RESPONSIVE_PREFIXES: {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    xxl: string;
+};
+/** 导出所有常量组 */
+export declare const CONSTANTS: {
+    COMPONENT_SIZES: Record<Size, string>;
+    COMPONENT_VARIANTS: Record<Variant, string>;
+    COMPONENT_STATUSES: Record<Status, string>;
+    COMPONENT_PREFIX: string;
+    CLASS_PREFIX: string;
+    DATA_PREFIX: string;
+    TEST_ID_PREFIX: string;
+    THEME_MODES: Record<ThemeMode, string>;
+    DEFAULT_THEME_COLORS: {
+        primary: string;
+        secondary: string;
+        success: string;
+        warning: string;
+        error: string;
+        info: string;
+        background: string;
+        surface: string;
+        text: string;
+        textSecondary: string;
+        border: string;
+        divider: string;
+    };
+    DARK_THEME_COLORS: {
+        primary: string;
+        secondary: string;
+        success: string;
+        warning: string;
+        error: string;
+        info: string;
+        background: string;
+        surface: string;
+        text: string;
+        textSecondary: string;
+        border: string;
+        divider: string;
+    };
+    DEFAULT_SPACING: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        xxl: number;
+    };
+    DEFAULT_TYPOGRAPHY: {
+        fontFamily: string;
+        fontSize: {
+            xs: number;
+            sm: number;
+            base: number;
+            lg: number;
+            xl: number;
+            '2xl': number;
+            '3xl': number;
+            '4xl': number;
+        };
+        fontWeight: {
+            normal: number;
+            medium: number;
+            bold: number;
+        };
+        lineHeight: {
+            tight: number;
+            normal: number;
+            relaxed: number;
+        };
+    };
+    DEFAULT_RADIUS: {
+        none: number;
+        sm: number;
+        md: number;
+        lg: number;
+        full: number;
+    };
+    BREAKPOINTS: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        xxl: number;
+    };
+    PLATFORM_NAMES: Record<Platform, string>;
+    PLATFORM_FEATURES: Record<Platform, {
+        supportsStorage: boolean;
+        supportsNetwork: boolean;
+        supportsLocation: boolean;
+        supportsCamera: boolean;
+        supportsPayment: boolean;
+        supportsShare: boolean;
+        supportsBiometrics: boolean;
+    }>;
+    PLATFORM_APIS: Record<Platform, {
+        request: string;
+        storage: {
+            set: string;
+            get: string;
+            remove: string;
+            clear: string;
+        };
+        location: {
+            get: string;
+            open: string;
+        };
+        camera: {
+            take: string;
+            choose: string;
+        };
+    }>;
+    ANIMATION_TYPES: Record<AnimationType, string>;
+    ANIMATION_DIRECTIONS: Record<AnimationDirection, string>;
+    ANIMATION_DURATIONS: {
+        fast: number;
+        normal: number;
+        slow: number;
+        slower: number;
+    };
+    ANIMATION_EASING: {
+        linear: string;
+        ease: string;
+        easeIn: string;
+        easeOut: string;
+        easeInOut: string;
+        bounce: string;
+    };
+    EVENT_NAMES: {
+        click: string;
+        tap: string;
+        touchStart: string;
+        touchMove: string;
+        touchEnd: string;
+        touchCancel: string;
+        input: string;
+        change: string;
+        focus: string;
+        blur: string;
+        submit: string;
+        reset: string;
+        scroll: string;
+        resize: string;
+        load: string;
+        error: string;
+    };
+    KEY_CODES: {
+        enter: number;
+        escape: number;
+        space: number;
+        arrowUp: number;
+        arrowDown: number;
+        arrowLeft: number;
+        arrowRight: number;
+        tab: number;
+        backspace: number;
+        delete: number;
+        home: number;
+        end: number;
+        pageUp: number;
+        pageDown: number;
+    };
+    REQUEST_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+    HTTP_STATUS_CODES: {
+        OK: number;
+        CREATED: number;
+        ACCEPTED: number;
+        NO_CONTENT: number;
+        BAD_REQUEST: number;
+        UNAUTHORIZED: number;
+        FORBIDDEN: number;
+        NOT_FOUND: number;
+        METHOD_NOT_ALLOWED: number;
+        CONFLICT: number;
+        UNPROCESSABLE_ENTITY: number;
+        INTERNAL_SERVER_ERROR: number;
+        NOT_IMPLEMENTED: number;
+        BAD_GATEWAY: number;
+        SERVICE_UNAVAILABLE: number;
+        GATEWAY_TIMEOUT: number;
+    };
+    REQUEST_TIMEOUTS: {
+        short: number;
+        normal: number;
+        long: number;
+        veryLong: number;
+    };
+    CONTENT_TYPES: {
+        json: string;
+        form: string;
+        multipart: string;
+        text: string;
+        html: string;
+        xml: string;
+    };
+    ERROR_CODES: {
+        UNKNOWN_ERROR: number;
+        INVALID_PARAMS: number;
+        NETWORK_ERROR: number;
+        TIMEOUT_ERROR: number;
+        PERMISSION_DENIED: number;
+        NOT_FOUND: number;
+        INTERNAL_ERROR: number;
+        PLATFORM_NOT_SUPPORTED: number;
+        API_NOT_AVAILABLE: number;
+        VERSION_TOO_LOW: number;
+        COMPONENT_NOT_FOUND: number;
+        INVALID_COMPONENT_CONFIG: number;
+        COMPONENT_RENDER_ERROR: number;
+        THEME_NOT_FOUND: number;
+        INVALID_THEME_CONFIG: number;
+        COLOR_FORMAT_ERROR: number;
+        FORM_VALIDATION_ERROR: number;
+        FIELD_REQUIRED: number;
+        INVALID_FORMAT: number;
+        VALUE_OUT_OF_RANGE: number;
+        STORAGE_QUOTA_EXCEEDED: number;
+        STORAGE_NOT_AVAILABLE: number;
+        STORAGE_KEY_NOT_FOUND: number;
+        REQUEST_FAILED: number;
+        RESPONSE_PARSE_ERROR: number;
+        UPLOAD_FAILED: number;
+        DOWNLOAD_FAILED: number;
+        LOCATION_PERMISSION_DENIED: number;
+        CAMERA_PERMISSION_DENIED: number;
+        STORAGE_PERMISSION_DENIED: number;
+        MICROPHONE_PERMISSION_DENIED: number;
+        USER_NOT_FOUND: number;
+        USER_ALREADY_EXISTS: number;
+        INVALID_CREDENTIALS: number;
+        ACCOUNT_LOCKED: number;
+        INSUFFICIENT_BALANCE: number;
+    };
+    ERROR_MESSAGES: Record<number, string>;
+    REGEX_PATTERNS: {
+        email: RegExp;
+        phone: RegExp;
+        idCard: RegExp;
+        url: RegExp;
+        ipAddress: RegExp;
+        port: RegExp;
+        chinese: RegExp;
+        english: RegExp;
+        alphanumeric: RegExp;
+        number: RegExp;
+        integer: RegExp;
+        float: RegExp;
+        strongPassword: RegExp;
+        date: RegExp;
+        time: RegExp;
+        color: RegExp;
+        zipCode: RegExp;
+        licensePlate: RegExp;
+    };
+    CACHE_KEYS: {
+        userInfo: string;
+        userToken: string;
+        userSettings: string;
+        themeMode: string;
+        themeConfig: string;
+        appConfig: string;
+        appSettings: string;
+        lastUpdateTime: string;
+        cacheVersion: string;
+        cacheTimestamp: string;
+    };
+    Z_INDEX: {
+        modal: number;
+        dropdown: number;
+        tooltip: number;
+        notification: number;
+        header: number;
+        sidebar: number;
+        content: number;
+        footer: number;
+        background: number;
+        hidden: number;
+    };
+    RESPONSIVE_BREAKPOINTS: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        xxl: number;
+    };
+    RESPONSIVE_PREFIXES: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+};

package/dist/hooks/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 自定义Hooks统一导出文件
+ * 提供所有自定义hooks的统一访问入口
+ */
+export * from './useToggle';
+export * from './useCounter';
+export * from './useStorage';
+export * from './useStateManagement';
+export * from './useAsync';
+export { useClickHandler, useLongPress, useDrag, useKeyboard, useEventDelegate } from './useEventHandling';
+export { useMounted, useLifecycle, useOnce, useConditionalEffect, useAsyncEffect, useTimer, useDelay, useNetworkState, usePageVisibility, useWindowSize, useScrollPosition, } from './useLifecycle';
+export * from './useRequest';
+export * from './useMutation';
+export * from './useClickOutside';
+export * from './useEventListener';
+export * from './useDebounce';
+export * from './useDeepCompareEffect';
+export * from './usePrevious';
+export * from './useMediaQuery';
+export * from './usePerformance';
+export * from './usePerformanceMonitor';
+export * from './usePlatform';
+export * from './useStyle';
+export * from './useTheme';
+export * from './useVirtualScroll';
+export * from './types';
+export type { UseRequestOptions, UseRequestResult } from './useRequest';
+export type { UseMutationResult } from './useMutation';

package/dist/hooks/types.d.ts

@@ -0,0 +1,7 @@
+export type HookAsyncState<T> = {
+    data: T | undefined;
+    error: Error | undefined;
+    loading: boolean;
+};
+export type Mutation<T> = (updater: T | ((prev: T | undefined) => T)) => void;
+export type QueryKey = string | readonly unknown[];

package/dist/hooks/useAsync.d.ts

@@ -0,0 +1,17 @@
+export interface UseAsyncOptions<T> {
+    immediate?: boolean;
+    deps?: unknown[];
+    onSuccess?: (data: T) => void;
+    onError?: (error: Error) => void;
+    keepPreviousData?: boolean;
+}
+export interface UseAsyncResult<T> {
+    data: T | undefined;
+    error: Error | undefined;
+    loading: boolean;
+    execute: () => Promise<T | undefined>;
+    cancel: () => void;
+    setData: (updater: T | ((prev: T | undefined) => T)) => void;
+}
+export declare function useAsync<T>(fn: () => Promise<T>, options?: UseAsyncOptions<T>): UseAsyncResult<T>;
+export default useAsync;

package/dist/hooks/useClickOutside.d.ts

@@ -0,0 +1,19 @@
+/**
+ * useClickOutside Hook
+ * Detect clicks outside of a specific element
+ *
+ * @example
+ * ```typescript
+ * const ref = useClickOutside<HTMLDivElement>(() => {
+ *   console.log('Clicked outside!');
+ *   setIsOpen(false);
+ * });
+ *
+ * return <div ref={ref}>Content</div>;
+ * ```
+ */
+import { RefObject } from 'react';
+/**
+ * Hook for detecting clicks outside an element
+ */
+export declare function useClickOutside<T extends HTMLElement = HTMLElement>(handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): RefObject<T | null>;