taro-uno-ui 0.9.0-beta → 1.0.0

package/dist/platform/index.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Taro-Uno UI 组件库平台适配工具
+ * 提供跨平台开发的统一接口和适配器
+ */
+import * as Taro from '@tarojs/taro';
+import type { Platform, PlatformInfo, RequestConfig, RequestResponse } from '../types';
+import { PLATFORM_APIS, PLATFORM_FEATURES } from '../constants';
+declare global {
+    interface Window {
+        wx?: any;
+        my?: any;
+        swan?: any;
+        tt?: any;
+        qq?: any;
+        jd?: any;
+    }
+}
+/** 平台适配器接口 */
+export interface PlatformAdapter {
+    /** 获取平台信息 */
+    getPlatformInfo(): PlatformInfo;
+    /** 网络请求 */
+    request<T = any>(config: RequestConfig): Promise<RequestResponse<T>>;
+    /** 存储操作 */
+    storage: {
+        set(key: string, value: any): Promise<void>;
+        get(key: string): Promise<any>;
+        remove(key: string): Promise<void>;
+        clear(): Promise<void>;
+        getInfo(): Promise<{
+            currentSize: number;
+            limitSize: number;
+        }>;
+    };
+    /** 位置服务 */
+    location: {
+        getCurrentPosition(): Promise<Taro.getLocation.SuccessCallbackResult>;
+        openLocation(options: Taro.openLocation.Option): Promise<void>;
+        chooseLocation(): Promise<Taro.chooseLocation.SuccessCallbackResult>;
+    };
+    /** 相机服务 */
+    camera: {
+        takePhoto(options?: any): Promise<any>;
+        chooseImage(options?: Taro.chooseImage.Option): Promise<Taro.chooseImage.SuccessCallbackResult>;
+        chooseVideo(options?: Taro.chooseVideo.Option): Promise<Taro.chooseVideo.SuccessCallbackResult>;
+    };
+    /** 支付服务 */
+    payment: {
+        requestPayment(options: Taro.requestPayment.Option): Promise<void>;
+    };
+    /** 分享服务 */
+    share: {
+        shareAppMessage(options?: any): Promise<void>;
+        shareToTimeline(options?: any): Promise<void>;
+    };
+    /** 生物识别 */
+    biometrics: {
+        checkIsAvailable(): Promise<boolean>;
+        startVerify(options: Taro.startSoterAuthentication.Option): Promise<Taro.startSoterAuthentication.SuccessCallbackResult>;
+    };
+    /** 系统信息 */
+    system: {
+        getSystemInfo(): Promise<Taro.getSystemInfoSync.Result>;
+        getNetworkType(): Promise<Taro.getNetworkType.SuccessCallbackResult>;
+        getBatteryInfo(): Promise<Taro.getBatteryInfo.SuccessCallbackResult>;
+        getScreenBrightness(): Promise<number>;
+        setScreenBrightness(value: number): Promise<void>;
+        keepScreenOn(keepScreenOn: boolean): Promise<void>;
+        vibrate(): Promise<void>;
+    };
+    /** 剪贴板 */
+    clipboard: {
+        set(text: string): Promise<void>;
+        get(): Promise<string>;
+    };
+    /** 扫码 */
+    scan: {
+        scanCode(options?: Taro.scanCode.Option): Promise<Taro.scanCode.SuccessCallbackResult>;
+    };
+    /** 文件操作 */
+    file: {
+        saveFile(options: Taro.saveFile.Option): Promise<Taro.saveFile.SuccessCallbackResult>;
+        getFileInfo(options: Taro.getFileInfo.Option): Promise<Taro.getFileInfo.SuccessCallbackResult>;
+        getSavedFileList(): Promise<Taro.getSavedFileList.SuccessCallbackResult>;
+        removeSavedFile(options: Taro.removeSavedFile.Option): Promise<void>;
+    };
+}
+/** 平台管理器 */
+export declare class PlatformManager {
+    private static instance;
+    private adapter;
+    private platformInfo;
+    private constructor();
+    /** 获取单例实例 */
+    static getInstance(): PlatformManager;
+    /** 检测当前平台 */
+    private detectPlatform;
+    /** 创建平台适配器 */
+    private createAdapter;
+    /** 获取平台适配器 */
+    getAdapter(): PlatformAdapter;
+    /** 获取平台信息 */
+    getPlatformInfo(): PlatformInfo;
+    /** 获取当前平台 */
+    getPlatform(): Platform;
+    /** 判断是否为指定平台 */
+    isPlatform(targetPlatform: Platform): boolean;
+    /** 判断是否为小程序环境 */
+    isMiniProgram(): boolean;
+    /** 判断是否为H5环境 */
+    isH5(): boolean;
+    /** 判断是否为React Native环境 */
+    isRN(): boolean;
+    /** 检查功能支持 */
+    isFeatureSupported(feature: keyof typeof PLATFORM_FEATURES.weapp): boolean;
+    /** 获取平台API映射 */
+    getPlatformAPIs(): typeof PLATFORM_APIS.weapp;
+    /** 获取平台名称 */
+    getPlatformName(): string;
+    /** 重置平台管理器（主要用于测试） */
+    reset(): void;
+}
+/** 创建平台管理器实例 */
+export declare const platformManager: PlatformManager;
+/** 导出平台适配器 */
+export declare const platformAdapter: PlatformAdapter;
+/** 导出平台检测工具 */
+export declare const platformUtils: {
+    getPlatform: () => Platform;
+    getPlatformInfo: () => PlatformInfo;
+    isPlatform: (platform: Platform) => boolean;
+    isMiniProgram: () => boolean;
+    isH5: () => boolean;
+    isRN: () => boolean;
+    isFeatureSupported: (feature: keyof typeof PLATFORM_FEATURES.weapp) => boolean;
+    getPlatformAPIs: () => {
+        request: string;
+        storage: {
+            set: string;
+            get: string;
+            remove: string;
+            clear: string;
+        };
+        location: {
+            get: string;
+            open: string;
+        };
+        camera: {
+            take: string;
+            choose: string;
+        };
+    };
+    getPlatformName: () => string;
+};
+/** 导出快捷方法 */
+export declare const getPlatform: () => Platform, getPlatformInfo: () => PlatformInfo, isPlatform: (platform: Platform) => boolean, isMiniProgram: () => boolean, isH5: () => boolean, isRN: () => boolean, isFeatureSupported: (feature: keyof typeof PLATFORM_FEATURES.weapp) => boolean, getPlatformAPIs: () => {
+    request: string;
+    storage: {
+        set: string;
+        get: string;
+        remove: string;
+        clear: string;
+    };
+    location: {
+        get: string;
+        open: string;
+    };
+    camera: {
+        take: string;
+        choose: string;
+    };
+}, getPlatformName: () => string;

package/dist/providers/AppProvider.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { ThemeConfig, ThemeMode } from '../theme/types';
+import { useTheme } from '../theme/ThemeProvider';
+import type { Platform, PlatformInfo } from '../types';
+interface AppProviderProps {
+    children: ReactNode;
+    /** 默认主题配置 */
+    theme?: ThemeConfig;
+    /** 默认主题模式 */
+    themeMode?: ThemeMode;
+    /** 持久化键名 */
+    themePersistKey?: string;
+    /** 是否跟随系统主题 */
+    followSystemTheme?: boolean;
+    /** 初始化完成回调 */
+    onReady?: () => void;
+}
+interface AppPlatformState {
+    id: Platform | 'unknown';
+    name: string;
+    isMiniProgram: boolean;
+    isH5: boolean;
+    isRN: boolean;
+    info?: PlatformInfo;
+}
+interface AppContextValue {
+    platform: AppPlatformState;
+    theme: ReturnType<typeof useTheme>;
+    isReady: boolean;
+}
+export declare const AppProvider: React.FC<AppProviderProps>;
+export declare const useAppContext: () => AppContextValue;
+export default AppProvider;

package/dist/providers/index.d.ts

@@ -0,0 +1 @@
+export { AppProvider, useAppContext } from './AppProvider';

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,34 @@
+import React, { ReactNode } from 'react';
+import { ThemeConfig, ThemeMode } from './types';
+interface ThemeContextType {
+    theme: ThemeConfig;
+    themeMode: ThemeMode;
+    setThemeMode: (mode: ThemeMode) => void;
+    toggleTheme: () => void;
+    isDark: boolean;
+    setCustomTheme: (theme: Partial<ThemeConfig>) => void;
+    resetTheme: () => void;
+    exportTheme: () => string;
+    importTheme: (themeData: string) => boolean;
+    getThemeValue: (path: string) => any;
+    generateThemeCSS: () => string;
+    isSystemDark: boolean;
+}
+interface ThemeProviderProps {
+    children: ReactNode;
+    defaultTheme?: ThemeConfig;
+    defaultMode?: ThemeMode;
+    persistKey?: string;
+    followSystem?: boolean;
+}
+export declare const ThemeProvider: React.FC<ThemeProviderProps>;
+export declare const useTheme: () => ThemeContextType;
+export declare const useThemeUtils: () => {
+    isDark: boolean;
+    getColor: (colorPath: string) => string;
+    getSpacing: (spacingKey: string) => string;
+    getFontSize: (fontKey: string) => string;
+    getBorderRadius: (radiusKey: string) => string;
+    getShadow: (shadowKey: string) => string;
+};
+export default ThemeProvider;

package/dist/theme/ThemeProvider.types.d.ts

@@ -0,0 +1,21 @@
+import type { ThemeConfig, ThemeMode } from './types';
+import type { ReactNode } from 'react';
+export interface ThemeContextType {
+    theme: ThemeConfig;
+    themeMode: ThemeMode;
+    setThemeMode: (_mode: ThemeMode) => void;
+    toggleTheme: () => void;
+    isDark: boolean;
+    setCustomTheme: (_theme: Partial<ThemeConfig>) => void;
+    resetTheme: () => void;
+    exportTheme: () => string;
+    importTheme: (_themeData: string) => boolean;
+}
+export interface ThemeProviderProps {
+    children: ReactNode;
+    defaultTheme?: ThemeConfig;
+    defaultMode?: ThemeMode;
+    persistKey?: string;
+}
+export declare const ThemeProvider: React.FC<ThemeProviderProps>;
+export declare const useTheme: () => ThemeContextType;

package/dist/theme/animations.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 动画和过渡效果系统
+ * 提供统一的动画效果、过渡和微交互
+ */
+import React from 'react';
+interface AnimationContextType {
+    config: {
+        duration: {
+            fast: number;
+            normal: number;
+            slow: number;
+        };
+        easing: {
+            easeIn: string;
+            easeOut: string;
+            easeInOut: string;
+            bounce: string;
+            elastic: string;
+        };
+        reduceMotion: boolean;
+    };
+    controls: {
+        setReduceMotion: (enabled: boolean) => void;
+        isAnimationEnabled: () => boolean;
+    };
+    presets: {
+        fadeIn: (element: HTMLElement, duration?: number) => void;
+        fadeOut: (element: HTMLElement, duration?: number) => void;
+        slideInUp: (element: HTMLElement, duration?: number) => void;
+        slideInDown: (element: HTMLElement, duration?: number) => void;
+        slideInLeft: (element: HTMLElement, duration?: number) => void;
+        slideInRight: (element: HTMLElement, duration?: number) => void;
+        scaleIn: (element: HTMLElement, duration?: number) => void;
+        scaleOut: (element: HTMLElement, duration?: number) => void;
+        bounceIn: (element: HTMLElement, duration?: number) => void;
+        shake: (element: HTMLElement, duration?: number) => void;
+        pulse: (element: HTMLElement, duration?: number) => void;
+    };
+    transitions: {
+        fade: (element: HTMLElement, callback?: () => void) => void;
+        slide: (element: HTMLElement, direction: 'up' | 'down' | 'left' | 'right', callback?: () => void) => void;
+        scale: (element: HTMLElement, callback?: () => void) => void;
+    };
+    microInteractions: {
+        hover: (element: HTMLElement, callback: () => void) => () => void;
+        press: (element: HTMLElement, callback: () => void) => () => void;
+        ripple: (element: HTMLElement, event: React.MouseEvent) => void;
+    };
+    custom: {
+        create: (name: string, keyframes: Keyframe[], options?: KeyframeAnimationOptions) => void;
+        play: (element: HTMLElement, name: string, options?: KeyframeAnimationOptions) => Animation | null;
+    };
+}
+declare const defaultAnimationConfig: {
+    duration: {
+        fast: number;
+        normal: number;
+        slow: number;
+    };
+    easing: {
+        easeIn: string;
+        easeOut: string;
+        easeInOut: string;
+        bounce: string;
+        elastic: string;
+    };
+    reduceMotion: boolean;
+};
+interface AnimationProviderProps {
+    children: React.ReactNode;
+    config?: Partial<typeof defaultAnimationConfig>;
+}
+export declare const AnimationProvider: React.FC<AnimationProviderProps>;
+export declare const useAnimation: () => AnimationContextType;
+export declare const withAnimation: <P extends object>(WrappedComponent: React.ComponentType<P>) => (props: P) => import("react/jsx-runtime").JSX.Element;
+interface RippleProps {
+    className?: string;
+    children: React.ReactNode;
+    disabled?: boolean;
+}
+export declare const Ripple: React.FC<RippleProps>;
+export declare const AnimationUtils: {
+    isAnimationSupported: () => boolean;
+    waitForAnimation: (element: HTMLElement, animationName: string) => Promise<void>;
+    animateMultiple: (elements: HTMLElement[], animationName: string, options?: KeyframeAnimationOptions) => Animation[];
+    animateSequence: (element: HTMLElement, animations: Array<{
+        name: string;
+        options?: KeyframeAnimationOptions;
+    }>) => Promise<void>;
+    createEasingFunction: (points: Array<{
+        x: number;
+        y: number;
+    }>) => string;
+    generateCSSAnimation: (name: string, keyframes: Keyframe[]) => string;
+};
+export default AnimationProvider;

package/dist/theme/defaults.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 默认主题配置
+ */
+import { ThemeConfig } from './types';
+export declare const defaultTheme: ThemeConfig;
+export declare const darkTheme: ThemeConfig;