taro-uno-ui 0.9.0-beta → 1.0.0

package/dist/components/form/Switch/Switch.types.d.ts

@@ -0,0 +1,351 @@
+/**
+ * Taro-Uno Switch Component Types
+ * 开关组件类型定义
+ */
+import type { ReactNode, CSSProperties } from 'react';
+import type { ITouchEvent } from '@tarojs/components';
+export type SwitchSize = 'sm' | 'md' | 'lg';
+export type SwitchVariant = 'solid' | 'outline' | 'ghost';
+export type SwitchStatus = 'normal' | 'checked' | 'unchecked' | 'disabled' | 'loading' | 'error';
+export type SwitchColor = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'info' | 'default';
+export type SwitchShape = 'rounded' | 'square';
+export type SwitchLoadingType = 'spinner' | 'dots' | 'pulse';
+export interface SwitchRule {
+    required?: boolean;
+    message?: string;
+    validator?: (_value: boolean) => boolean | string | Promise<boolean | string>;
+}
+export interface SwitchProps {
+    /** 组件值 */
+    value?: boolean;
+    /** 默认值 */
+    defaultValue?: boolean;
+    /** 开关尺寸 */
+    size?: SwitchSize;
+    /** 开关变体 */
+    variant?: SwitchVariant;
+    /** 开关状态 */
+    status?: SwitchStatus;
+    /** 开关颜色 */
+    color?: SwitchColor;
+    /** 开关形状 */
+    shape?: SwitchShape;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 是否加载中 */
+    loading?: boolean;
+    /** 加载类型 */
+    loadingType?: SwitchLoadingType;
+    /** 是否显示加载文本 */
+    loadingText?: string;
+    /** 是否自动获取焦点 */
+    autoFocus?: boolean;
+    /** 是否显示边框 */
+    bordered?: boolean;
+    /** 是否显示标签 */
+    showLabel?: boolean;
+    /** 选中标签文本 */
+    checkedLabel?: string;
+    /** 未选中标签文本 */
+    uncheckedLabel?: string;
+    /** 选中图标 */
+    checkedIcon?: ReactNode;
+    /** 未选中图标 */
+    uncheckedIcon?: ReactNode;
+    /** 辅助文本 */
+    helperText?: string;
+    /** 错误文本 */
+    errorText?: string;
+    /** 是否显示加载遮罩 */
+    showLoadingMask?: boolean;
+    /** 验证规则 */
+    rules?: SwitchRule[];
+    /** 验证触发时机 */
+    validateTrigger?: 'onChange' | 'onBlur' | 'onFocus';
+    /** 是否立即验证 */
+    immediate?: boolean;
+    /** 自定义验证函数 */
+    validator?: (_value: boolean) => boolean | string | Promise<boolean | string>;
+    /** 值变化回调 */
+    onChange?: (_checked: boolean, event: ITouchEvent) => void;
+    /** 聚焦回调 */
+    onFocus?: (_event: ITouchEvent) => void;
+    /** 失焦回调 */
+    onBlur?: (_event: ITouchEvent) => void;
+    /** 点击回调 */
+    onClick?: (_checked: boolean, event: ITouchEvent) => void;
+    /** 加载状态变化回调 */
+    onLoadingChange?: (_loading: boolean) => void;
+    /** 验证回调 */
+    onValidate?: (_result: SwitchValidationResult) => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 容器样式类名 */
+    containerClassName?: string;
+    /** 容器样式 */
+    containerStyle?: CSSProperties;
+    /** 是否块级显示 */
+    block?: boolean;
+    /** 无障碍支持 */
+    accessible?: boolean;
+    /** 无障碍标签 */
+    accessibilityLabel?: string;
+    /** 无障碍角色 */
+    accessibilityRole?: string;
+    /** 无障碍状态 */
+    accessibilityState?: {
+        disabled?: boolean;
+        checked?: boolean;
+        busy?: boolean;
+        required?: boolean;
+        invalid?: boolean;
+    };
+    /** 平台特定属性 */
+    platform?: {
+        weapp?: Record<string, any>;
+        alipay?: Record<string, any>;
+        h5?: Record<string, any>;
+        rn?: Record<string, any>;
+    };
+    /** 其他属性 */
+    [key: string]: any;
+}
+export interface SwitchRef {
+    /** DOM元素引用 */
+    element: HTMLElement | null;
+    /** 获取值 */
+    getValue: () => boolean;
+    /** 设置值 */
+    setValue: (_value: boolean) => void;
+    /** 切换值 */
+    toggle: () => void;
+    /** 聚焦 */
+    focus: () => void;
+    /** 失焦 */
+    blur: () => void;
+    /** 设置禁用状态 */
+    setDisabled: (_disabled: boolean) => void;
+    /** 设置只读状态 */
+    setReadonly: (_readonly: boolean) => void;
+    /** 设置加载状态 */
+    setLoading: (_loading: boolean) => void;
+    /** 设置状态 */
+    setStatus: (_status: SwitchStatus) => void;
+    /** 获取状态 */
+    getStatus: () => SwitchStatus;
+    /** 验证 */
+    validate: () => Promise<SwitchValidationResult>;
+    /** 重置 */
+    reset: () => void;
+    /** 获取验证结果 */
+    getValidationResult: () => SwitchValidationResult | null;
+}
+export interface SwitchValidationResult {
+    /** 是否验证通过 */
+    valid: boolean;
+    /** 错误消息 */
+    message?: string;
+    /** 验证值 */
+    value: boolean;
+}
+export interface SwitchContext {
+    /** 开关实例 */
+    switch: {
+        value: boolean;
+        status: SwitchStatus;
+        disabled: boolean;
+        readonly: boolean;
+        loading: boolean;
+        validationResult: SwitchValidationResult | null;
+    };
+    /** 开关配置 */
+    config: {
+        size: SwitchSize;
+        variant: SwitchVariant;
+        color: SwitchColor;
+        shape: SwitchShape;
+        showLabel: boolean;
+        checkedLabel: string;
+        uncheckedLabel: string;
+        validateTrigger: 'onChange' | 'onBlur' | 'onFocus';
+    };
+    /** 样式配置 */
+    styleConfig: SwitchStyleConfig;
+}
+export interface SwitchStyleConfig {
+    /** 颜色配置 */
+    colors: {
+        /** 主色 */
+        primary: string;
+        /** 次色 */
+        secondary: string;
+        /** 成功色 */
+        success: string;
+        /** 警告色 */
+        warning: string;
+        /** 错误色 */
+        error: string;
+        /** 信息色 */
+        info: string;
+        /** 默认色 */
+        default: string;
+        /** 禁用色 */
+        disabled: string;
+        /** 边框色 */
+        border: string;
+        /** 背景色 */
+        background: string;
+        /** 文本色 */
+        text: string;
+    };
+    /** 尺寸配置 */
+    sizes: {
+        /** 小尺寸 */
+        sm: {
+            width: number;
+            height: number;
+            thumbSize: number;
+            fontSize: number;
+            borderRadius: number;
+        };
+        /** 中尺寸 */
+        md: {
+            width: number;
+            height: number;
+            thumbSize: number;
+            fontSize: number;
+            borderRadius: number;
+        };
+        /** 大尺寸 */
+        lg: {
+            width: number;
+            height: number;
+            thumbSize: number;
+            fontSize: number;
+            borderRadius: number;
+        };
+    };
+    /** 间距配置 */
+    spacing: {
+        /** 内边距 */
+        padding: number;
+        /** 外边距 */
+        margin: number;
+        /** 标签间距 */
+        labelGap: number;
+    };
+    /** 动画配置 */
+    animation: {
+        /** 过渡时间 */
+        duration: string;
+        /** 缓动函数 */
+        easing: string;
+        /** 加载动画 */
+        loading: string;
+    };
+    /** 阴影配置 */
+    shadow: {
+        /** 默认阴影 */
+        default: string;
+        /** 悬停阴影 */
+        hover: string;
+        /** 激活阴影 */
+        active: string;
+        /** 禁用阴影 */
+        disabled: string;
+    };
+}
+export interface SwitchUtils {
+    /** 获取颜色值 */
+    getColor: (_color: SwitchColor, checked: boolean, disabled: boolean) => string;
+    /** 获取尺寸值 */
+    getSize: (_size: SwitchSize) => SwitchStyleConfig['sizes'][keyof SwitchStyleConfig['sizes']];
+    /** 格式化标签文本 */
+    formatLabel: (_label: string, checked: boolean) => string;
+    /** 验证开关值 */
+    validateValue: (_value: boolean, rules?: SwitchRule[]) => Promise<SwitchValidationResult>;
+    /** 获取无障碍状态 */
+    getAccessibilityState: (_props: SwitchProps, status: SwitchStatus) => any;
+}
+export interface SwitchEvents {
+    /** 值变化事件 */
+    onChange: (_checked: boolean, event: ITouchEvent) => void;
+    /** 聚焦事件 */
+    onFocus: (_event: ITouchEvent) => void;
+    /** 失焦事件 */
+    onBlur: (_event: ITouchEvent) => void;
+    /** 点击事件 */
+    onClick: (_checked: boolean, event: ITouchEvent) => void;
+    /** 加载状态变化事件 */
+    onLoadingChange: (_loading: boolean) => void;
+    /** 验证事件 */
+    onValidate: (_result: SwitchValidationResult) => void;
+}
+export interface SwitchGroupProps {
+    /** 开关组值 */
+    value?: Record<string, boolean>;
+    /** 默认值 */
+    defaultValue?: Record<string, boolean>;
+    /** 开关组子项 */
+    children: ReactNode;
+    /** 布局方向 */
+    direction?: 'horizontal' | 'vertical';
+    /** 间距 */
+    spacing?: number;
+    /** 禁用整个组 */
+    disabled?: boolean;
+    /** 只读整个组 */
+    readonly?: boolean;
+    /** 值变化回调 */
+    onChange?: (_values: Record<string, boolean>) => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+export interface SwitchGroupRef {
+    /** 获取所有值 */
+    getValues: () => Record<string, boolean>;
+    /** 设置值 */
+    setValues: (_values: Record<string, boolean>) => void;
+    /** 获取单个值 */
+    getValue: (_name: string) => boolean;
+    /** 设置单个值 */
+    setValue: (_name: string, value: boolean) => void;
+    /** 重置所有值 */
+    reset: () => void;
+    /** 设置禁用状态 */
+    setDisabled: (_disabled: boolean) => void;
+    /** 设置只读状态 */
+    setReadonly: (_readonly: boolean) => void;
+}
+export interface SwitchGroupItemProps {
+    /** 开关名称 */
+    name: string;
+    /** 开关标签 */
+    label: string;
+    /** 开关值 */
+    value?: boolean;
+    /** 默认值 */
+    defaultValue?: boolean;
+    /** 开关尺寸 */
+    size?: SwitchSize;
+    /** 开关颜色 */
+    color?: SwitchColor;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 辅助文本 */
+    helperText?: string;
+    /** 错误文本 */
+    errorText?: string;
+    /** 验证规则 */
+    rules?: SwitchRule[];
+    /** 值变化回调 */
+    onChange?: (_checked: boolean, event: ITouchEvent) => void;
+}

package/dist/components/form/Switch/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Taro-Uno Switch Component
+ * 开关组件，支持多种状态、颜色和验证功能
+ */
+export { Switch } from './Switch';
+export type { SwitchProps, SwitchRef, SwitchSize, SwitchVariant, SwitchStatus, SwitchColor, SwitchShape, SwitchLoadingType, SwitchRule, SwitchValidationResult, SwitchContext, SwitchStyleConfig, SwitchUtils, SwitchEvents, SwitchGroupProps, SwitchGroupRef, SwitchGroupItemProps, } from './Switch.types';
+export { switchStyles } from './Switch.styles';

package/dist/components/form/Textarea/Textarea.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { TextareaProps, TextareaRef } from './Textarea.types';
+/** 文本域组件 */
+export declare const TextareaComponent: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<TextareaRef>>;
+/** 导出文本域组件 */
+export declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<TextareaRef>>;

package/dist/components/form/Textarea/Textarea.styles.d.ts

@@ -0,0 +1,66 @@
+import type { TextareaProps, TextareaSize, TextareaVariant, TextareaStatus, TextareaStyleConfig } from './Textarea.types';
+/** 样式工具类 */
+export declare class TextareaStyles {
+    /** 获取平台前缀 */
+    private static getPlatformPrefix;
+    /** 尺寸映射 */
+    static readonly SIZE_MAP: Record<TextareaSize, {
+        fontSize: number;
+        padding: string;
+        minHeight: number;
+        borderRadius: number;
+        lineHeight: number;
+    }>;
+    /** 变体样式映射 */
+    static readonly VARIANT_STYLES: Record<TextareaVariant, {
+        backgroundColor: string;
+        borderColor: string;
+        borderWidth: number;
+        borderBottomWidth?: number;
+    }>;
+    /** 状态颜色映射 */
+    static readonly STATUS_COLORS: Record<TextareaStatus, {
+        color: string;
+        backgroundColor?: string;
+        borderColor?: string;
+        icon?: string;
+    }>;
+    /** 生成文本域类名 */
+    static getClassName(props: Partial<TextareaProps>): string;
+    /** 生成文本域样式 */
+    static getStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成文本域容器样式 */
+    static getContainerStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成文本域包装器样式 */
+    static getWrapperStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成前缀样式 */
+    static getPrefixStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成后缀样式 */
+    static getSuffixStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成标签样式 */
+    static getLabelStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成辅助文本样式 */
+    static getHelperTextStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成错误文本样式 */
+    static getErrorTextStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成计数器样式 */
+    static getCounterStyle(props: Partial<TextareaProps> & {
+        position?: 'top-right' | 'bottom-right' | 'top-left' | 'bottom-left';
+    }): React.CSSProperties;
+    /** 生成清除按钮样式 */
+    static getClearButtonStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成自动调整高度样式 */
+    static getAutoHeightStyle(props: Partial<TextareaProps>): React.CSSProperties;
+    /** 生成文本域样式配置 */
+    static getStyleConfig(): TextareaStyleConfig;
+    /** 生成CSS变量 */
+    static generateCSSVariables(): string;
+    /** 生成关键帧动画 */
+    static generateKeyframes(): string;
+    /** 调整文本域高度的实用方法 */
+    static adjustTextareaHeight(element: HTMLTextAreaElement, strategy?: 'content' | 'rows' | 'max-rows', rows?: number, minRows?: number, maxRows?: number): void;
+    /** 计算文本域高度 */
+    static calculateTextareaHeight(value: string, fontSize: number, lineHeight: number, padding: string, rows?: number, minRows?: number, maxRows?: number): number;
+}
+/** 导出样式工具 */
+export declare const textareaStyles: typeof TextareaStyles;