aha-components 1.7.11 → 1.8.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { ReactNode, MouseEventHandler, FC } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -87,15 +87,31 @@ declare const ToastProvider: React.FC<{
 
 type TagColor = 'Green' | 'Red' | 'Orange' | 'Cyan' | 'Violet' | 'Pink' | 'Gray' | 'Yellow' | 'Blue' | string;
 type TagVariant = 'light' | 'fill';
-type TagSize = 'large' | 'small';
+/** sm/md/lg are the canonical sizes; large/small are legacy aliases */
+type TagSize = 'sm' | 'md' | 'lg' | 'large' | 'small';
+/** Leading icon variant */
+type TagIconType = 'none' | 'dot' | 'avatar' | 'icon';
+/** Right-side action */
+type TagAction = 'none' | 'x-close' | 'count';
+/** @deprecated Use iconType instead */
 type IconPosition = 'leading' | 'after' | 'none';
 interface TagProps {
     children: React.ReactNode;
-    color: TagColor;
+    color?: TagColor;
     variant?: TagVariant;
     size?: TagSize;
     stroke?: boolean;
+    iconType?: TagIconType;
     icon?: React.ReactElement;
+    avatarSrc?: string;
+    dotColor?: string;
+    action?: TagAction;
+    count?: number;
+    onClose?: () => void;
+    checkbox?: boolean;
+    checked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    /** @deprecated use iconType='icon' */
     iconPosition?: IconPosition;
     className?: string;
     onClick?: () => void;
@@ -298,6 +314,12 @@ interface CheckboxProps {
     className?: string;
     style?: React.CSSProperties;
     children?: React.ReactNode;
+    /** sm = 16px, md = 20px */
+    size?: 'sm' | 'md';
+    /** Secondary description rendered below the label */
+    hint?: React.ReactNode;
+    /** Force focused appearance (useful for Storybook demos) */
+    isFocused?: boolean;
 }
 declare const Checkbox: React.FC<CheckboxProps>;
 
@@ -310,6 +332,12 @@ interface RadioProps {
     children?: React.ReactNode;
     value?: any;
     name?: string;
+    /** sm = 16px, md = 20px */
+    size?: 'sm' | 'md';
+    /** Secondary description rendered below the label */
+    hint?: React.ReactNode;
+    /** Force focused appearance (useful for Storybook demos) */
+    isFocused?: boolean;
 }
 declare const Radio: React.FC<RadioProps>;
 
@@ -410,6 +438,13 @@ interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, '
 }
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 
+interface LinkifyOptions {
+    validate?: (url: string) => boolean;
+    className?: string;
+    needProtocol?: boolean;
+    needHost?: boolean;
+    allowedTlds?: string[];
+}
 interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size'> {
     /** 是否禁用 */
     disabled?: boolean;
@@ -444,6 +479,10 @@ interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaEl
     onFocus?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
     /** 失焦回调 */
     onBlur?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    /** 是否启用实时链接识别 */
+    linkify?: boolean;
+    /** 链接识别配置 */
+    linkifyOptions?: LinkifyOptions;
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 
@@ -986,6 +1025,116 @@ interface LoadingProps {
 }
 declare const Loading: React.FC<LoadingProps>;
 
+type BadgeColor = 'gray' | 'brand' | 'error' | 'warning' | 'success' | 'grayBlue' | 'blueLight' | 'blue' | 'indigo' | 'purple' | 'pink' | 'orange';
+type BadgeVariant = 'pill' | 'badge' | 'modern';
+type BadgeSize = 'sm' | 'md' | 'lg';
+type BadgeIconComponent = React.FC<{
+    style?: React.CSSProperties;
+    className?: string;
+}>;
+interface BadgeProps {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    color?: BadgeColor;
+    children: ReactNode;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const Badge: React.FC<BadgeProps>;
+interface BadgeWithDotProps {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    color?: BadgeColor;
+    children: ReactNode;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const BadgeWithDot: React.FC<BadgeWithDotProps>;
+interface BadgeWithIconProps {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    color?: BadgeColor;
+    iconLeading?: BadgeIconComponent;
+    iconTrailing?: BadgeIconComponent;
+    children: ReactNode;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const BadgeWithIcon: React.FC<BadgeWithIconProps>;
+interface BadgeWithButtonProps {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    color?: BadgeColor;
+    icon?: BadgeIconComponent;
+    children: ReactNode;
+    buttonLabel?: string;
+    onButtonClick?: MouseEventHandler<HTMLButtonElement>;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const BadgeWithButton: React.FC<BadgeWithButtonProps>;
+interface BadgeIconProps {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    color?: BadgeColor;
+    icon: BadgeIconComponent;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const BadgeIcon: React.FC<BadgeIconProps>;
+interface BadgeWithImageProps {
+    variant?: Exclude<BadgeVariant, 'modern'>;
+    size?: BadgeSize;
+    color?: BadgeColor;
+    imgSrc: string;
+    imgAlt?: string;
+    children: ReactNode;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const BadgeWithImage: React.FC<BadgeWithImageProps>;
+
+type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+interface AvatarProps {
+    size?: AvatarSize;
+    src?: string | null;
+    alt?: string;
+    /** Two-letter initials displayed when no image is provided */
+    initials?: string;
+    /** Custom icon component displayed as placeholder */
+    placeholderIcon?: FC<{
+        style?: React.CSSProperties;
+    }>;
+    /** Online/offline status indicator dot */
+    status?: 'online' | 'offline';
+    /** Company logo badge displayed bottom-right */
+    companyIcon?: {
+        src: string;
+        alt?: string;
+    };
+    /** Blue verified checkmark badge */
+    verified?: boolean;
+    style?: React.CSSProperties;
+    className?: string;
+}
+interface AvatarLabelGroupProps {
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    name: string;
+    supportingText?: string;
+    avatarSrc?: string | null;
+    avatarInitials?: string;
+    status?: 'online' | 'offline';
+    companyIcon?: {
+        src: string;
+        alt?: string;
+    };
+    verified?: boolean;
+    style?: React.CSSProperties;
+    className?: string;
+}
+declare const Avatar: React.FC<AvatarProps>;
+declare const AvatarLabelGroup: React.FC<AvatarLabelGroupProps>;
+
 interface ThemeConfig {
     primaryColor?: string;
 }
@@ -1005,4 +1154,4 @@ declare const MinusIcon: React.FC<{
     style?: React.CSSProperties;
 }>;
 
-export { Alert, AlertProps, Button, ButtonProps, CheckIcon, Checkbox, CheckboxProps, ColumnType, DatePicker, DatePickerProps, DateRange, Drawer, DrawerPlacement, DrawerProps, FormWithItem as Form, FormInstance, FormItemProps, FormProps, Input, InputProps, Loading, LoadingProps, MenuGroupType, MenuItemType, MenuList, MenuListProps, MinusIcon, Pagination, PaginationProps, Popover, PopoverPlacement, PopoverProps, PopoverTrigger, Progress, ProgressProps, ProgressStatus, ProgressType, Radio, RadioProps, Select, SelectOption, SelectProps, SortOrder, SorterResult, Switch, SwitchProps, Tab, TabItem, TabLayout, TabProps, TabVariant, Table, TableCurrentDataSource, TableLayout, TableProps, TableRowSelection, TableSize, Tag, TagProps, Textarea, TextareaProps, ThemeConfig, ThemeProvider, ThemeProviderProps, Toast, ToastPosition, ToastProps, ToastProvider, ToastType, Tooltip, TooltipPosition, TooltipProps, UserProfileType, clearAllToasts, closeToast, debugToast, toast, toastError, toastInfo, toastQuestion, toastSuccess, useTheme };
+export { Alert, AlertProps, Avatar, AvatarLabelGroup, AvatarLabelGroupProps, AvatarProps, AvatarSize, Badge, BadgeColor, BadgeIcon, BadgeIconComponent, BadgeIconProps, BadgeProps, BadgeSize, BadgeVariant, BadgeWithButton, BadgeWithButtonProps, BadgeWithDot, BadgeWithDotProps, BadgeWithIcon, BadgeWithIconProps, BadgeWithImage, BadgeWithImageProps, Button, ButtonProps, CheckIcon, Checkbox, CheckboxProps, ColumnType, DatePicker, DatePickerProps, DateRange, Drawer, DrawerPlacement, DrawerProps, FormWithItem as Form, FormInstance, FormItemProps, FormProps, Input, InputProps, Loading, LoadingProps, MenuGroupType, MenuItemType, MenuList, MenuListProps, MinusIcon, Pagination, PaginationProps, Popover, PopoverPlacement, PopoverProps, PopoverTrigger, Progress, ProgressProps, ProgressStatus, ProgressType, Radio, RadioProps, Select, SelectOption, SelectProps, SortOrder, SorterResult, Switch, SwitchProps, Tab, TabItem, TabLayout, TabProps, TabVariant, Table, TableCurrentDataSource, TableLayout, TableProps, TableRowSelection, TableSize, Tag, TagProps, Textarea, TextareaProps, ThemeConfig, ThemeProvider, ThemeProviderProps, Toast, ToastPosition, ToastProps, ToastProvider, ToastType, Tooltip, TooltipPosition, TooltipProps, UserProfileType, clearAllToasts, closeToast, debugToast, toast, toastError, toastInfo, toastQuestion, toastSuccess, useTheme };