taro-uno-ui 0.9.0 → 1.0.0

package/dist/components/basic/Icon/Icon.types.d.ts

@@ -0,0 +1,199 @@
+import type { ReactNode, SVGAttributes } from 'react';
+/** 图标类型 */
+export type IconType = 'svg' | 'image' | 'font' | 'custom';
+/** 图标来源 */
+export type IconSource = string | ReactNode | {
+    viewBox?: string;
+    path?: string;
+    paths?: string[];
+    d?: string;
+};
+/** 图标尺寸 */
+export type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl';
+/** 图标颜色 */
+export type IconColor = string;
+/** 图标旋转角度 */
+export type IconRotation = 0 | 45 | 90 | 135 | 180 | 225 | 270 | 315;
+/** 图标状态 */
+export type IconStatus = 'normal' | 'active' | 'disabled' | 'loading';
+/** 图标主题 */
+export type IconTheme = 'outlined' | 'filled' | 'two-tone' | 'colored';
+/** 图标原生属性类型 */
+export type IconNativeProps = SVGAttributes<SVGElement>;
+/** 图标组件属性接口 */
+export interface IconProps extends Omit<IconNativeProps, 'size' | 'color'> {
+    /** 图标源 */
+    source: IconSource;
+    /** 图标类型 */
+    type?: IconType;
+    /** 图标尺寸 */
+    size?: IconSize | number;
+    /** 图标颜色 */
+    color?: IconColor;
+    /** 图标旋转角度 */
+    rotate?: IconRotation;
+    /** 图标状态 */
+    status?: IconStatus;
+    /** 图标主题 */
+    theme?: IconTheme;
+    /** 是否可点击 */
+    clickable?: boolean;
+    /** 是否显示加载状态 */
+    loading?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 点击事件处理函数 */
+    onClick?: (_event: React.MouseEvent) => void;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 图标库前缀 */
+    prefix?: string;
+    /** 图标库后缀 */
+    suffix?: string;
+    /** 是否启用动画 */
+    animated?: boolean;
+    /** 动画持续时间 */
+    animationDuration?: number;
+    /** 图标组中的索引位置 */
+    groupIndex?: number;
+    /** 图标组中的总数 */
+    groupSize?: number;
+    /** 自定义加载图标 */
+    loadingIcon?: ReactNode;
+    /** 是否显示工具提示 */
+    tooltip?: string;
+    /** 工具提示位置 */
+    tooltipPosition?: 'top' | 'bottom' | 'left' | 'right';
+    /** 是否启用涟漪效果 */
+    ripple?: boolean;
+    /** 图标滤镜效果 */
+    filter?: 'none' | 'grayscale' | 'sepia' | 'blur' | 'brightness' | 'contrast' | 'hue-rotate';
+    /** 图标混合模式 */
+    blendMode?: 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten';
+    /** 测试标识 */
+    'data-testid'?: string;
+}
+/** 图标组件引用类型 */
+export type IconRef = {
+    /** 图标元素 */
+    element: SVGElement | HTMLImageElement | HTMLSpanElement | null;
+    /** 触发点击事件 */
+    click: () => void;
+    /** 设置禁用状态 */
+    setDisabled: (_disabled: boolean) => void;
+    /** 设置加载状态 */
+    setLoading: (_loading: boolean) => void;
+    /** 获取图标状态 */
+    getStatus: () => IconStatus;
+    /** 获取图标尺寸 */
+    getSize: () => IconSize | number;
+    /** 获取图标颜色 */
+    getColor: () => string;
+    /** 旋转图标 */
+    rotate: (_angle: IconRotation) => void;
+    /** 设置图标颜色 */
+    setColor: (_color: string) => void;
+    /** 设置图标尺寸 */
+    setSize: (_size: IconSize | number) => void;
+};
+/** 图标组属性接口 */
+export interface IconGroupProps {
+    /** 图标组内容 */
+    children: ReactNode;
+    /** 图标组尺寸 */
+    size?: IconSize | number;
+    /** 图标组颜色 */
+    color?: IconColor;
+    /** 图标组状态 */
+    status?: IconStatus;
+    /** 图标组主题 */
+    theme?: IconTheme;
+    /** 图标组间距 */
+    spacing?: number;
+    /** 图标组是否垂直排列 */
+    vertical?: boolean;
+    /** 图标组对齐方式 */
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    /** 图标组自定义样式类名 */
+    className?: string;
+    /** 图标组自定义样式 */
+    style?: React.CSSProperties;
+}
+/** 图标工具函数接口 */
+export interface IconUtils {
+    /** 获取图标样式类名 */
+    getIconClassName: (_props: Partial<IconProps>) => string;
+    /** 获取图标样式对象 */
+    getIconStyle: (_props: Partial<IconProps>) => React.CSSProperties;
+    /** 获取图标尺寸映射 */
+    getSizeMap: () => Record<IconSize, number>;
+    /** 获取图标状态映射 */
+    getStatusMap: () => Record<IconStatus, {
+        opacity: number;
+        cursor: string;
+        pointerEvents: string;
+    }>;
+    /** 验证图标属性 */
+    validateIconProps: (_props: IconProps) => boolean;
+    /** 格式化图标尺寸 */
+    formatIconSize: (_size: IconSize | number) => string;
+    /** 格式化图标类型 */
+    formatIconType: (_type: IconType) => string;
+    /** 格式化图标状态 */
+    formatIconStatus: (_status: IconStatus) => string;
+    /** 解析图标源 */
+    parseIconSource: (_source: IconSource) => {
+        type: IconType;
+        data: any;
+    };
+    /** 生成SVG路径 */
+    generateSVGPath: (_data: any) => ReactNode;
+    /** 生成字体图标 */
+    generateFontIcon: (_data: any) => ReactNode;
+    /** 生成图片图标 */
+    generateImageIcon: (_data: any) => ReactNode;
+    /** 生成自定义图标 */
+    generateCustomIcon: (_data: any) => ReactNode;
+    /** 检测图标类型 */
+    detectIconType: (_source: IconSource) => IconType;
+}
+/** 预定义图标集 */
+export interface IconSet {
+    /** 图标名称 */
+    name: string;
+    /** 图标数据 */
+    data: IconSource;
+    /** 图标类型 */
+    type: IconType;
+    /** 图标主题 */
+    theme?: IconTheme;
+    /** 图标分类 */
+    category?: string;
+    /** 图标标签 */
+    tags?: string[];
+}
+/** 图标库配置 */
+export interface IconLibraryConfig {
+    /** 图标库名称 */
+    name: string;
+    /** 图标库前缀 */
+    prefix: string;
+    /** 图标库类型 */
+    type: IconType;
+    /** 图标库基础URL */
+    baseUrl?: string;
+    /** 图标库CSS路径 */
+    cssPath?: string;
+    /** 图标库版本 */
+    version?: string;
+    /** 是否已加载 */
+    loaded: boolean;
+    /** 加载图标库 */
+    load: () => Promise<void>;
+    /** 获取图标URL */
+    getIconUrl: (_iconName: string) => string;
+    /** 获取图标CSS类名 */
+    getIconClassName: (_iconName: string) => string;
+}

package/dist/components/basic/Icon/IconManager.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Icon Manager
+ * Unified management of icon sets and utility functions for the Icon component
+ */
+import type { IconSet, IconSource, IconType, IconTheme } from './Icon.types';
+/**
+ * Icon Manager class
+ * Provides methods for managing and accessing icon sets
+ */
+export declare class IconManager {
+    private allIcons;
+    private iconMap;
+    private iconLibrary;
+    constructor();
+    /**
+     * Register icon set with category and theme
+     */
+    registerIcons(icons: IconSet[], category: string, theme: IconTheme): void;
+    /**
+     * Get icon by name, theme, and category
+     */
+    getIcon(name: string, theme?: IconTheme, category?: string): IconSet | undefined;
+    /**
+     * Get all icons
+     */
+    getAllIcons(): IconSet[];
+    /**
+     * Get icons by category
+     */
+    getIconsByCategory(category: string): IconSet[];
+    /**
+     * Get icons by theme
+     */
+    getIconsByTheme(theme: IconTheme): IconSet[];
+    /**
+     * Get icons by type
+     */
+    getIconsByType(type: IconType): IconSet[];
+    /**
+     * Search icons by name or tags
+     */
+    searchIcons(query: string): IconSet[];
+    /**
+     * Get icon source by name
+     */
+    getIconSource(name: string, theme?: IconTheme, category?: string): IconSource | undefined;
+    /**
+     * Get all categories
+     */
+    getCategories(): string[];
+    /**
+     * Get all themes
+     */
+    getThemes(): IconTheme[];
+    /**
+     * Check if icon exists
+     */
+    hasIcon(name: string, theme?: IconTheme, category?: string): boolean;
+    /**
+     * Get icon by name with automatic theme and category detection
+     */
+    findIcon(name: string): IconSet | undefined;
+    /**
+     * Get icon statistics
+     */
+    getStats(): {
+        totalIcons: number;
+        categories: number;
+        themes: number;
+        byCategory: {
+            [k: string]: number;
+        };
+        byTheme: {
+            [k: string]: number;
+        };
+    };
+}
+/**
+ * Create and export default IconManager instance
+ */
+export declare const iconManager: IconManager;
+/**
+ * Icon utility functions
+ */
+export declare const IconUtils: {
+    /**
+     * Get icon source by name
+     */
+    getIcon(name: string, theme?: IconTheme, category?: string): IconSource | undefined;
+    /**
+     * Check if icon exists
+     */
+    hasIcon(name: string, theme?: IconTheme, category?: string): boolean;
+    /**
+     * Get all icons
+     */
+    getAllIcons(): IconSet[];
+    /**
+     * Search icons
+     */
+    searchIcons(query: string): IconSet[];
+    /**
+     * Get icon by name with automatic detection
+     */
+    findIcon(name: string): IconSet | undefined;
+    /**
+     * Get icon statistics
+     */
+    getStats(): {
+        totalIcons: number;
+        categories: number;
+        themes: number;
+        byCategory: {
+            [k: string]: number;
+        };
+        byTheme: {
+            [k: string]: number;
+        };
+    };
+};

package/dist/components/basic/Icon/index.d.ts

@@ -0,0 +1,6 @@
+export { IconComponent, IconComponent as Icon } from './Icon';
+export type { IconProps, IconRef, IconGroupProps, IconUtils, IconType, IconSource, IconSize, IconColor, IconRotation, IconStatus, IconTheme, IconNativeProps, IconSet, IconLibraryConfig, } from './Icon.types';
+export { iconStyles } from './Icon.styles';
+/** 图标组件默认导出 */
+import { IconComponent } from './Icon';
+export { IconComponent as default };

package/dist/components/basic/Text/Text.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { TextProps, TextRef } from './Text.types';
+/** 文本组件 */
+export declare const TextComponent: React.ForwardRefExoticComponent<TextProps & React.RefAttributes<TextRef>>;
+/** 导出文本组件 */
+export declare const Text: React.ForwardRefExoticComponent<TextProps & React.RefAttributes<TextRef>>;
+export default TextComponent;

package/dist/components/basic/Text/Text.styles.d.ts

@@ -0,0 +1,67 @@
+import type { TextProps, TextSize, TextWeight, TextColor, TextStatus } from './Text.types';
+/** 样式工具类 */
+export declare class TextStyles {
+    /** 获取平台前缀 */
+    private static getPlatformPrefix;
+    /** 尺寸映射 */
+    static readonly SIZE_MAP: Record<TextSize, {
+        fontSize: number;
+        _lineHeight: number;
+    }>;
+    /** 权重映射 */
+    static readonly WEIGHT_MAP: Record<TextWeight, number>;
+    /** 颜色映射 */
+    static readonly COLOR_MAP: Record<TextColor, string>;
+    /** 状态映射 */
+    static readonly STATUS_MAP: Record<TextStatus, {
+        opacity: number;
+        cursor: string;
+        pointerEvents: string;
+    }>;
+    /** 行高映射 */
+    static readonly LINE_HEIGHT_MAP: Record<string, number>;
+    /** 字母间距映射 */
+    static readonly LETTER_SPACING_MAP: Record<string, string>;
+    /** 生成文本类名 */
+    static getClassName(props: Partial<TextProps>): string;
+    /** 生成文本样式 */
+    static getStyle(props: Partial<TextProps>): React.CSSProperties;
+    /** 生成链接样式 */
+    static getLinkStyle(props: {
+        color?: string;
+        underline?: boolean;
+        visited?: boolean;
+        active?: boolean;
+        hover?: boolean;
+    }): React.CSSProperties;
+    /** 生成代码样式 */
+    static getCodeStyle(props: {
+        variant?: 'inline' | 'block';
+        language?: string;
+    }): React.CSSProperties;
+    /** 生成引用样式 */
+    static getQuoteStyle(props: {
+        variant?: 'solid' | 'dashed' | 'dotted';
+        position?: 'left' | 'right';
+    }): React.CSSProperties;
+    /** 生成标题样式 */
+    static getHeadingStyle(level: 1 | 2 | 3 | 4 | 5 | 6): React.CSSProperties;
+    /** 生成加载动画样式 */
+    static getLoadingStyle(): React.CSSProperties;
+    /** 生成CSS变量 */
+    static generateCSSVariables(): string;
+    /** 生成关键帧动画 */
+    static generateKeyframes(): string;
+    /** 获取尺寸类名 */
+    static getSizeClassName(size: TextSize): string;
+    /** 获取权重类名 */
+    static getWeightClassName(weight: TextWeight): string;
+    /** 获取颜色类名 */
+    static getColorClassName(color: TextColor): string;
+    /** 获取状态类名 */
+    static getStatusClassName(status: TextStatus): string;
+    /** 获取类型类名 */
+    static getTypeClassName(type: string): string;
+}
+/** 导出样式工具 */
+export declare const textStyles: typeof TextStyles;

package/dist/components/basic/Text/Text.types.d.ts

@@ -0,0 +1,274 @@
+import type { ReactNode, HTMLAttributes } from 'react';
+import React from 'react';
+/** 文本尺寸 */
+export type TextSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl' | '8xl' | '9xl';
+/** 文本权重 */
+export type TextWeight = 'thin' | 'extralight' | 'light' | 'normal' | 'medium' | 'semibold' | 'bold' | 'extrabold' | 'black';
+/** 文本对齐 */
+export type TextAlign = 'left' | 'center' | 'right' | 'justify' | 'start' | 'end';
+/** 文本装饰 */
+export type TextDecoration = 'none' | 'underline' | 'overline' | 'line-through' | 'blink';
+/** 文本转换 */
+export type TextTransform = 'none' | 'capitalize' | 'uppercase' | 'lowercase';
+/** 文本溢出处理 */
+export type TextOverflow = 'clip' | 'ellipsis' | 'break-word' | 'break-all' | 'truncate';
+/** 文本方向 */
+export type TextDirection = 'ltr' | 'rtl';
+/** 文本样式 */
+export type TextStyle = 'normal' | 'italic' | 'oblique';
+/** 文本变体 */
+export type TextVariant = 'normal' | 'small-caps' | 'all-small-caps' | 'petite-caps' | 'all-petite-caps' | 'unicase' | 'titling-caps' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'body1' | 'body2' | 'body' | 'caption' | 'overline' | 'subtitle1' | 'subtitle2';
+/** 文本间距 */
+export type LetterSpacing = 'tighter' | 'tight' | 'normal' | 'wide' | 'wider' | 'widest' | number;
+/** 行高 */
+export type LineHeight = 'none' | 'tight' | 'snug' | 'normal' | 'relaxed' | 'loose' | number;
+/** 文本颜色类型 */
+export type TextColor = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'info' | 'disabled' | 'inherit' | 'current' | string;
+/** 文本状态 */
+export type TextStatus = 'normal' | 'active' | 'disabled' | 'loading';
+/** 文本类型 */
+export type TextType = 'body' | 'heading' | 'caption' | 'label' | 'link' | 'code' | 'quote' | 'helper';
+/** 文本原生属性类型 */
+export type TextNativeProps = HTMLAttributes<HTMLParagraphElement>;
+/** 文本组件属性接口 */
+export interface TextProps extends Omit<TextNativeProps, 'size' | 'color' | 'weight'> {
+    /** 文本内容 */
+    children?: ReactNode;
+    /** 文本尺寸 */
+    size?: TextSize;
+    /** 文本权重 */
+    weight?: TextWeight;
+    /** 文本颜色 */
+    color?: TextColor;
+    /** 文本对齐 */
+    align?: TextAlign;
+    /** 文本装饰 */
+    decoration?: TextDecoration;
+    /** 文本转换 */
+    transform?: TextTransform;
+    /** 文本溢出处理 */
+    overflow?: TextOverflow;
+    /** 文本方向 */
+    direction?: TextDirection;
+    /** 文本样式 */
+    fontStyle?: TextStyle;
+    /** 文本变体 */
+    variant?: TextVariant;
+    /** 字母间距 */
+    letterSpacing?: LetterSpacing;
+    /** 行高 */
+    lineHeight?: LineHeight;
+    /** 文本状态 */
+    status?: TextStatus;
+    /** 文本类型 */
+    type?: TextType;
+    /** 是否可点击 */
+    clickable?: boolean;
+    /** 是否显示加载状态 */
+    loading?: boolean;
+    disabled?: boolean;
+    /** 是否块级显示 */
+    block?: boolean;
+    /** 是否内联块级显示 */
+    inlineBlock?: boolean;
+    /** 是否可选中 */
+    selectable?: boolean;
+    /** 是否可复制 */
+    copyable?: boolean;
+    /** 复制时的回调函数 */
+    onCopy?: () => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 点击事件处理函数 */
+    onClick?: (_event: React.MouseEvent) => void;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 最大行数 */
+    maxLines?: number;
+    /** 是否启用动画 */
+    animated?: boolean;
+    /** 动画持续时间 */
+    animationDuration?: number;
+    /** 是否启用无障碍访问 */
+    accessible?: boolean;
+    /** 无障碍标签 */
+    accessibilityLabel?: string;
+    /** 无障碍角色 */
+    accessibilityRole?: string;
+    /** 无障碍状态 */
+    accessibilityState?: {
+        disabled?: boolean;
+        selected?: boolean;
+        busy?: boolean;
+        expanded?: boolean;
+    };
+    /** 文本链接地址 */
+    href?: string;
+    /** 链接打开方式 */
+    target?: '_blank' | '_self' | '_parent' | '_top';
+    /** 是否显示下划线 */
+    underline?: boolean;
+    /** 是否删除线 */
+    strikethrough?: boolean;
+    /** 是否高亮 */
+    highlight?: boolean;
+    /** 高亮颜色 */
+    highlightColor?: string;
+    /** 是否显示省略号 */
+    ellipsis?: boolean;
+    /** 是否自动换行 */
+    wrap?: boolean;
+    /** 是否保持单词完整 */
+    breakWord?: boolean;
+    /** 文本阴影 */
+    textShadow?: string;
+    /** 文本轮廓 */
+    textOutline?: string;
+    /** 文本渐变 */
+    gradient?: {
+        start: string;
+        end: string;
+        direction?: 'to right' | 'to left' | 'to bottom' | 'to top' | 'to bottom right' | 'to top left';
+    };
+    /** 自定义字体 */
+    fontFamily?: string | string[];
+    /** 文本间距 */
+    wordSpacing?: number | string;
+    /** 文本缩进 */
+    textIndent?: number | string;
+    /** 白空格处理 */
+    whiteSpace?: 'normal' | 'nowrap' | 'pre' | 'pre-wrap' | 'pre-line' | 'break-spaces';
+    /** 垂直对齐 */
+    verticalAlign?: 'baseline' | 'sub' | 'super' | 'top' | 'text-top' | 'middle' | 'bottom' | 'text-bottom';
+    /** 文本方向组合 */
+    writingMode?: 'horizontal-tb' | 'vertical-rl' | 'vertical-lr';
+    /** 文本渲染优化 */
+    textRendering?: 'auto' | 'optimizeSpeed' | 'optimizeLegibility' | 'geometricPrecision';
+    ariaLabel?: string;
+    numberOfLines?: number;
+    ellipsizeMode?: 'head' | 'middle' | 'tail' | 'clip';
+    role?: string;
+    dangerouslySetInnerHTML?: {
+        __html: string;
+    };
+    suppressContentEditableWarning?: boolean;
+    suppressHydrationWarning?: boolean;
+}
+/** 文本组件引用类型 */
+export type TextRef = {
+    /** 文本元素 */
+    element: HTMLParagraphElement | HTMLSpanElement | null;
+    /** 获取文本内容 */
+    getText: () => string;
+    /** 设置文本内容 */
+    setText: (_text: string) => void;
+    /** 复制文本 */
+    copy: () => Promise<void>;
+    /** 选择文本 */
+    select: () => void;
+    /** 设置禁用状态 */
+    setDisabled: (_disabled: boolean) => void;
+    /** 设置加载状态 */
+    setLoading: (_loading: boolean) => void;
+    /** 获取文本状态 */
+    getStatus: () => TextStatus;
+    /** 获取文本尺寸 */
+    getSize: () => TextSize;
+    /** 获取文本颜色 */
+    getColor: () => string;
+    /** 设置文本颜色 */
+    setColor: (_color: string) => void;
+    /** 设置文本尺寸 */
+    setSize: (_size: TextSize) => void;
+    /** 设置文本权重 */
+    setWeight: (_weight: TextWeight) => void;
+    /** 滚动到视图 */
+    scrollIntoView: (options?: ScrollIntoViewOptions) => void;
+};
+/** 文本工具函数接口 */
+export interface TextUtils {
+    /** 获取文本样式类名 */
+    getTextClassName: (_props: Partial<TextProps>) => string;
+    /** 获取文本样式对象 */
+    getTextStyle: (_props: Partial<TextProps>) => React.CSSProperties;
+    /** 获取文本尺寸映射 */
+    getSizeMap: () => Record<TextSize, {
+        fontSize: number;
+        lineHeight: number;
+    }>;
+    /** 获取文本权重映射 */
+    getWeightMap: () => Record<TextWeight, number>;
+    /** 获取文本颜色映射 */
+    getColorMap: () => Record<TextColor, string>;
+    /** 验证文本属性 */
+    validateTextProps: (_props: TextProps) => boolean;
+    /** 格式化文本尺寸 */
+    formatTextSize: (_size: TextSize) => string;
+    /** 格式化文本权重 */
+    formatTextWeight: (_weight: TextWeight) => string;
+    /** 格式化文本颜色 */
+    formatTextColor: (_color: TextColor) => string;
+    /** 截断文本 */
+    truncateText: (_text: string, maxLength: number, suffix?: string) => string;
+    /** 高亮文本 */
+    highlightText: (_text: string, highlight: string, highlightColor?: string) => ReactNode;
+    /** 格式化数字 */
+    formatNumber: (_num: number, options?: Intl.NumberFormatOptions) => string;
+    /** 格式化日期 */
+    formatDate: (_date: Date | string | number, format?: string) => string;
+    /** 格式化货币 */
+    formatCurrency: (_amount: number, currency?: string, locale?: string) => string;
+    /** 计算文本长度 */
+    calculateTextLength: (_text: string, options?: {
+        fontSize: number;
+        fontFamily: string;
+    }) => number;
+    /** 检测文本语言 */
+    detectLanguage: (_text: string) => string;
+    /** 清理文本 */
+    sanitizeText: (_text: string) => string;
+    /** 转换HTML实体 */
+    escapeHtml: (_text: string) => string;
+    /** 反转换HTML实体 */
+    unescapeHtml: (_text: string) => string;
+}
+/** 打字机效果属性 */
+export interface TypewriterProps {
+    /** 要显示的文本 */
+    text: string;
+    /** 打字速度（毫秒） */
+    speed?: number;
+    /** 删除速度（毫秒） */
+    deleteSpeed?: number;
+    /** 是否循环 */
+    loop?: boolean;
+    /** 延迟开始时间（毫秒） */
+    delay?: number;
+    /** 删除前等待时间（毫秒） */
+    waitTime?: number;
+    /** 是否显示光标 */
+    showCursor?: boolean;
+    /** 光标字符 */
+    cursorChar?: string;
+    /** 完成回调 */
+    onComplete?: () => void;
+    /** 开始回调 */
+    onStart?: () => void;
+    /** 删除回调 */
+    onDelete?: () => void;
+}
+/** 文本渐变属性 */
+export interface TextGradientProps {
+    /** 渐变开始颜色 */
+    start: string;
+    /** 渐变结束颜色 */
+    end: string;
+    /** 渐变方向 */
+    direction?: 'to right' | 'to left' | 'to bottom' | 'to top' | 'to bottom right' | 'to top left';
+    /** 子元素 */
+    children: ReactNode;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义类名 */
+    className?: string;
+}

package/dist/components/basic/Text/index.d.ts

@@ -0,0 +1,5 @@
+export { Text } from './Text';
+export type { TextProps, TextRef, TextUtils, TextSize, TextWeight, TextAlign, TextDecoration, TextTransform, TextOverflow, TextDirection, TextStyle, TextVariant, LetterSpacing, LineHeight, TextColor, TextStatus, TextType, TextNativeProps, TypewriterProps, TextGradientProps, } from './Text.types';
+export { textStyles } from './Text.styles';
+/** 文本组件默认导出 */
+export default Text;

package/dist/components/basic/Typography/Typography.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { TypographyProps, TypographyRef } from './Typography.types';
+/**
+ * Typography 排版组件
+ * 提供丰富的文本排版功能，包括标题、段落、文本、链接等
+ */
+export declare const Typography: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<TypographyRef>>;
+export default Typography;