aha-components 1.7.12 → 1.8.2

package/dist/components/Input/index.d.ts

@@ -1,41 +1,30 @@
 import React from 'react';
 export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix' | 'suffix'> {
-    /** 输入框大小 */
     size?: 'small' | 'mediumSmall' | 'medium' | 'large';
-    /** 是否禁用 */
     disabled?: boolean;
-    /** 是否显示错误状态 */
     error?: boolean;
-    /** 是否只读 */
     readOnly?: boolean;
-    /** 输入框前缀图标 */
     prefix?: React.ReactNode;
-    /** 输入框后缀图标 */
     suffix?: React.ReactNode;
-    /** 允许清除 */
     allowClear?: boolean;
-    /** 清除回调 */
     onClear?: () => void;
-    /** 自定义类名 */
     className?: string;
-    /** 自定义样式 */
     style?: React.CSSProperties;
-    /** 输入框类型 */
     type?: string;
-    /** 占位符 */
     placeholder?: string;
-    /** 值 */
     value?: string;
-    /** 默认值 */
     defaultValue?: string;
-    /** 变化回调 */
     onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
-    /** 聚焦回调 */
     onFocus?: (e: React.FocusEvent<HTMLInputElement>) => void;
-    /** 失焦回调 */
     onBlur?: (e: React.FocusEvent<HTMLInputElement>) => void;
-    /** 按下回车回调 */
     onPressEnter?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    label?: string;
+    required?: boolean;
+    hintText?: string;
 }
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 export default Input;
+export { default as InputGroup } from './InputGroup';
+export type { InputGroupProps } from './InputGroup';
+export { default as InputTags } from './InputTags';
+export type { InputTagsProps } from './InputTags';

package/dist/components/Loading/Loading.stories 2.d.ts

@@ -0,0 +1,11 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Loading from './index';
+import '../../index.css';
+declare const meta: Meta<typeof Loading>;
+export default meta;
+type Story = StoryObj<typeof Loading>;
+export declare const Basic: Story;
+export declare const DifferentSizes: Story;
+export declare const CustomColors: Story;
+export declare const StrokeWidthVariants: Story;
+export declare const InlineUsage: Story;

package/dist/components/Loading/index 2.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface LoadingProps {
+    width?: number | string;
+    height?: number | string;
+    strokeWidth?: number;
+    color?: string;
+    className?: string;
+}
+declare const Loading: React.FC<LoadingProps>;
+export default Loading;

package/dist/components/MenuList/MenuList.stories 2.d.ts

@@ -0,0 +1,17 @@
+import { Meta, StoryObj } from '@storybook/react';
+import MenuList from './index';
+declare const meta: Meta<typeof MenuList>;
+export default meta;
+type Story = StoryObj<typeof MenuList>;
+export declare const Basic: Story;
+export declare const WithoutIcons: Story;
+export declare const MixedIcons: Story;
+export declare const FullExample: Story;
+export declare const WithUserProfile: Story;
+export declare const WithDisabled: Story;
+export declare const WithDanger: Story;
+export declare const Controlled: Story;
+export declare const CustomRender: Story;
+export declare const CustomUserProfile: Story;
+export declare const ClickEvents: Story;
+export declare const UnifiedClickEvent: Story;

package/dist/components/MenuList/MenuList.test 2.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/MenuList/index 2.d.ts

@@ -0,0 +1,85 @@
+import React from 'react';
+export interface MenuItemType {
+    /** 唯一标识 */
+    key: string;
+    /** 菜单项标签 */
+    label: React.ReactNode;
+    /** 菜单项图标 */
+    icon?: React.ReactNode;
+    /** 菜单项右侧图标 */
+    suffixIcon?: React.ReactNode;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否危险项（红色） */
+    danger?: boolean;
+    /** 自定义渲染函数，如果提供则完全自定义该项的渲染 */
+    render?: (item: MenuItemType, isSelected: boolean) => React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 点击事件 */
+    onClick?: (info: {
+        key: string;
+        keyPath: string[];
+    }) => void;
+    /** 是否跳过全局点击事件（MenuList 的 onClick），默认为 false */
+    skipGlobalClick?: boolean;
+}
+export interface MenuGroupType {
+    /** 分组标题 */
+    title?: React.ReactNode;
+    /** 分组下的菜单项 */
+    children: MenuItemType[];
+    /** 自定义类名 */
+    className?: string;
+}
+export interface UserProfileType {
+    /** 用户头像 */
+    avatar?: React.ReactNode;
+    /** 用户姓名 */
+    name: React.ReactNode;
+    /** 用户邮箱 */
+    email?: React.ReactNode;
+    /** 在线状态 */
+    online?: boolean;
+    /** 自定义渲染函数，如果提供则完全自定义用户资料的渲染 */
+    render?: (profile: UserProfileType) => React.ReactNode;
+    /** 点击事件 */
+    onClick?: () => void;
+}
+export interface MenuListProps {
+    /** 菜单项数据 */
+    items: (MenuItemType | MenuGroupType)[];
+    /** 用户资料信息（显示在顶部） */
+    userProfile?: UserProfileType;
+    /** 当前选中的菜单项 key */
+    selectedKeys?: string[];
+    /** 默认选中的菜单项 key */
+    defaultSelectedKeys?: string[];
+    /** 选中项变化时的回调 */
+    onSelect?: (info: {
+        key: string;
+        keyPath: string[];
+        selectedKeys: string[];
+    }) => void;
+    /** 取消选中时的回调 */
+    onDeselect?: (info: {
+        key: string;
+        keyPath: string[];
+        selectedKeys: string[];
+    }) => void;
+    /** 统一的点击事件，无论点击哪个子项都会触发 */
+    onClick?: (info: {
+        key: string;
+        keyPath: string[];
+    }) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 菜单宽度 */
+    width?: number | string;
+}
+declare const MenuList: React.FC<MenuListProps>;
+export default MenuList;

package/dist/components/Pagination/Pagination.stories 2.d.ts

@@ -0,0 +1,16 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Pagination from './index';
+declare const meta: Meta<typeof Pagination>;
+export default meta;
+type Story = StoryObj<typeof Pagination>;
+export declare const Basic: Story;
+export declare const Controlled: Story;
+export declare const WithTotal: Story;
+export declare const WithSizeChanger: Story;
+export declare const WithQuickJumper: Story;
+export declare const FullFeatures: Story;
+export declare const Simple: Story;
+export declare const Sizes: Story;
+export declare const LargeTotal: Story;
+export declare const CustomGoButton: Story;
+export declare const Responsive: Story;

package/dist/components/Pagination/index 2.d.ts

@@ -0,0 +1,27 @@
+import React from "react";
+export interface PaginationProps {
+    current?: number;
+    defaultCurrent?: number;
+    total?: number;
+    pageSize?: number;
+    defaultPageSize?: number;
+    showSizeChanger?: boolean;
+    pageSizeOptions?: string[];
+    showQuickJumper?: boolean | {
+        goButton?: React.ReactNode;
+    };
+    showTotal?: (total: number, range: [number, number]) => React.ReactNode;
+    onChange?: (page: number, pageSize?: number) => void;
+    onShowSizeChange?: (current: number, size: number) => void;
+    simple?: boolean;
+    disabled?: boolean;
+    hideOnSinglePage?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    size?: "default" | "small";
+    responsive?: boolean;
+    showLessItems?: boolean;
+    itemRender?: (page: number, type: "page" | "prev" | "next" | "jump-prev" | "jump-next", originalElement: React.ReactNode) => React.ReactNode;
+}
+declare const Pagination: React.FC<PaginationProps>;
+export default Pagination;

package/dist/components/Popover/Popover.stories 2.d.ts

@@ -0,0 +1,11 @@
+import { Meta, StoryObj } from "@storybook/react";
+import Popover from "./index";
+declare const meta: Meta<typeof Popover>;
+export default meta;
+type Story = StoryObj<typeof Popover>;
+export declare const Default: Story;
+export declare const HoverTrigger: Story;
+export declare const Placements: Story;
+export declare const CustomWidth: Story;
+export declare const MobileWidthAndAutoFlip: Story;
+export declare const CloseByContentClick: Story;

package/dist/components/Popover/index 2.d.ts

@@ -0,0 +1,31 @@
+import React from "react";
+export type PopoverTrigger = "click" | "hover";
+export type PopoverPlacement = "top" | "right" | "bottom" | "left";
+export interface PopoverProps {
+    /** 触发节点 */
+    children: React.ReactNode;
+    /** Popover 内容 */
+    content: React.ReactNode;
+    /** 触发模式 */
+    trigger?: PopoverTrigger;
+    /** 是否显示（受控） */
+    open?: boolean;
+    /** 默认是否显示（非受控） */
+    defaultOpen?: boolean;
+    /** 显示状态变化回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 展示方向 */
+    placement?: PopoverPlacement;
+    /** 内容宽度 */
+    width?: string | number;
+    /** 触发节点和 Popover 的间距 */
+    offset?: number;
+    /** 自定义容器类名 */
+    className?: string;
+    /** 自定义 Popover 类名 */
+    popoverClassName?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+declare const Popover: React.FC<PopoverProps>;
+export default Popover;

package/dist/components/Progress/Progress.stories 2.d.ts

@@ -0,0 +1,18 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Progress from './index';
+import '../../index.css';
+declare const meta: Meta<typeof Progress>;
+export default meta;
+type Story = StoryObj<typeof Progress>;
+export declare const Circle: Story;
+export declare const Semicircle: Story;
+export declare const WithTitle: Story;
+export declare const WithoutPercent: Story;
+export declare const DifferentSizes: Story;
+export declare const SemicircleSizes: Story;
+export declare const WithTitleAndPercent: Story;
+export declare const TitlePositionInside: Story;
+export declare const TitlePositionOutside: Story;
+export declare const StatusVariants: Story;
+export declare const AnimatedProgress: Story;
+export declare const CustomColors: Story;

package/dist/components/Progress/Progress.test 2.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Progress/index 2.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+export type ProgressType = 'circle' | 'semicircle' | string;
+export type ProgressStatus = 'normal' | 'success' | 'exception' | 'active';
+export type TitlePosition = 'inside' | 'outside';
+export interface ProgressProps {
+    /** 进度百分比，范围 0-100 */
+    percent?: number;
+    /** 进度条类型，目前支持 circle（圆形）和 semicircle（半圆） */
+    type?: ProgressType;
+    /** 进度条宽度（尺寸），单位 px */
+    width?: number;
+    /** 标题文本 */
+    title?: string;
+    /** 标题位置，圆内（inside）或圆外（outside），圆外时显示在圆下方 */
+    titlePosition?: TitlePosition;
+    /** 是否显示百分比 */
+    showPercent?: boolean;
+    /** 是否启用动画效果 */
+    animated?: boolean;
+    /** 进度条状态 */
+    status?: ProgressStatus;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 进度条颜色，不设置则使用主题色 */
+    strokeColor?: string;
+    /** 进度条轨道颜色 */
+    trailColor?: string;
+    [key: string]: any;
+}
+declare const Progress: React.FC<ProgressProps>;
+export default Progress;

package/dist/components/Radio/Radio.stories 2.d.ts

@@ -0,0 +1,10 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Radio from './index';
+declare const meta: Meta<typeof Radio>;
+export default meta;
+type Story = StoryObj<typeof Radio>;
+export declare const Basic: Story;
+export declare const Checked: Story;
+export declare const Disabled: Story;
+export declare const RadioGroup: Story;
+export declare const Sizes: Story;

package/dist/components/Radio/Radio.stories.d.ts

@@ -3,8 +3,10 @@ import Radio from './index';
 declare const meta: Meta<typeof Radio>;
 export default meta;
 type Story = StoryObj<typeof Radio>;
-export declare const Basic: Story;
-export declare const Checked: Story;
-export declare const Disabled: Story;
-export declare const RadioGroup: Story;
+export declare const Default: Story;
+export declare const WithHint: Story;
 export declare const Sizes: Story;
+export declare const AllStates: Story;
+export declare const Focused: Story;
+export declare const RadioGroup: Story;
+export declare const RadioGroupWithHint: Story;

package/dist/components/Radio/index 2.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface RadioProps {
+    checked?: boolean;
+    disabled?: boolean;
+    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+    value?: any;
+    name?: string;
+}
+declare const Radio: React.FC<RadioProps>;
+export default Radio;

package/dist/components/Radio/index.d.ts

@@ -8,6 +8,12 @@ export 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>;
 export default Radio;

package/dist/components/Select/Select.stories 2.d.ts

@@ -0,0 +1,17 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Select from './index';
+declare const meta: Meta<typeof Select>;
+export default meta;
+type Story = StoryObj<typeof Select>;
+export declare const Basic: Story;
+export declare const Sizes: Story;
+export declare const Disabled: Story;
+export declare const Error: Story;
+export declare const Searchable: Story;
+export declare const Multiple: Story;
+export declare const MultipleWithMaxTag: Story;
+export declare const WithClear: Story;
+export declare const Controlled: Story;
+export declare const WithDisabledOption: Story;
+export declare const LongList: Story;
+export declare const AllStates: Story;

package/dist/components/Select/index 2.d.ts

@@ -0,0 +1,74 @@
+import React from 'react';
+export interface SelectOption {
+    label: React.ReactNode;
+    value: string | number;
+    disabled?: boolean;
+    [key: string]: any;
+}
+export interface SelectProps {
+    /** 当前选中的值 */
+    value?: string | number | (string | number)[];
+    /** 默认选中的值 */
+    defaultValue?: string | number | (string | number)[];
+    /** 选项数据 */
+    options?: SelectOption[];
+    /** 是否支持多选 */
+    mode?: 'multiple' | 'tags';
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否显示错误状态 */
+    error?: boolean;
+    /** 占位符 */
+    placeholder?: string;
+    /** 尺寸 */
+    size?: 'small' | 'mediumSmall' | 'medium' | 'large';
+    /** 是否可搜索 */
+    showSearch?: boolean;
+    /** 搜索过滤函数 */
+    filterOption?: boolean | ((input: string, option: SelectOption) => boolean);
+    /** 是否允许清除 */
+    allowClear?: boolean;
+    /** 变化回调 */
+    onChange?: (value: string | number | (string | number)[], option: SelectOption | SelectOption[]) => void;
+    /** 选择回调 */
+    onSelect?: (value: string | number, option: SelectOption) => void;
+    /** 取消选择回调 */
+    onDeselect?: (value: string | number, option: SelectOption) => void;
+    /** 搜索回调 */
+    onSearch?: (value: string) => void;
+    /** 聚焦回调 */
+    onFocus?: (e: React.FocusEvent) => void;
+    /** 失焦回调 */
+    onBlur?: (e: React.FocusEvent) => void;
+    /** 下拉框打开回调 */
+    onDropdownVisibleChange?: (open: boolean) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 下拉框类名 */
+    dropdownClassName?: string;
+    /** 下拉框样式 */
+    dropdownStyle?: React.CSSProperties;
+    /** 是否默认打开 */
+    defaultOpen?: boolean;
+    /** 是否打开（受控） */
+    open?: boolean;
+    /** 最大标签数量 */
+    maxTagCount?: number | 'responsive';
+    /** 标签渲染函数 */
+    tagRender?: (props: {
+        label: React.ReactNode;
+        value: string | number;
+        closable: boolean;
+        onClose: () => void;
+    }) => React.ReactNode;
+    /** 选项渲染函数 */
+    optionRender?: (option: SelectOption, info: {
+        selected: boolean;
+        focused: boolean;
+        disabled: boolean;
+    }) => React.ReactNode;
+}
+declare const Select: React.FC<SelectProps>;
+export default Select;

package/dist/components/Switch/Switch.stories 2.d.ts

@@ -0,0 +1,14 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Switch from './index';
+declare const meta: Meta<typeof Switch>;
+export default meta;
+type Story = StoryObj<typeof Switch>;
+export declare const Basic: Story;
+export declare const Sizes: Story;
+export declare const Checked: Story;
+export declare const Unchecked: Story;
+export declare const Disabled: Story;
+export declare const Loading: Story;
+export declare const WithChildren: Story;
+export declare const Controlled: Story;
+export declare const AllStates: Story;

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

@@ -0,0 +1,27 @@
+import React from 'react';
+export interface SwitchProps {
+    /** 是否选中 */
+    checked?: boolean;
+    /** 默认是否选中 */
+    defaultChecked?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 变化回调 */
+    onChange?: (checked: boolean, event: React.MouseEvent) => void;
+    /** 点击回调 */
+    onClick?: (checked: boolean, event: React.MouseEvent) => void;
+    /** 选中时的内容 */
+    checkedChildren?: React.ReactNode;
+    /** 非选中时的内容 */
+    unCheckedChildren?: React.ReactNode;
+    /** 尺寸 */
+    size?: 'small' | 'default';
+    /** 加载状态 */
+    loading?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+declare const Switch: React.FC<SwitchProps>;
+export default Switch;

package/dist/components/Tab/Tab.stories 2.d.ts

@@ -0,0 +1,19 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Tab from './index';
+declare const meta: Meta<typeof Tab>;
+export default meta;
+type Story = StoryObj<typeof Tab>;
+export declare const Underline: Story;
+export declare const UnderlineWithBadge: Story;
+export declare const UnderlineWithIcon: Story;
+export declare const BackgroundEqual: Story;
+export declare const BackgroundSpaced: Story;
+export declare const BackgroundWithIconAndBadge: Story;
+export declare const WithCustomElement: Story;
+export declare const ValueMode: Story;
+export declare const WithDisabled: Story;
+export declare const FullExample: Story;
+export declare const WithNumberArray: Story;
+export declare const StringArrayWithValue: Story;
+export declare const ControlledWithNumbers: Story;
+export declare const ScrollableTabs: Story;

package/dist/components/Tab/index 2.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+export type TabVariant = 'underline' | 'background';
+export type TabLayout = 'equal' | 'spaced';
+export interface TabItem {
+    key: string | number;
+    label: React.ReactNode;
+    icon?: React.ReactElement | React.ComponentType<any>;
+    badge?: number | string;
+    customElement?: React.ReactNode;
+    disabled?: boolean;
+    children?: React.ReactNode;
+}
+export interface TabProps {
+    items: TabItem[] | string[] | number[];
+    variant?: TabVariant;
+    layout?: TabLayout;
+    defaultValue?: string | number;
+    value?: string | number;
+    onChange?: (value: string | number) => void;
+    className?: string;
+    mode?: 'children' | 'value';
+    scrollable?: boolean;
+    [key: string]: any;
+}
+declare const Tab: React.FC<TabProps>;
+export default Tab;

package/dist/components/Table/Table.stories 2.d.ts

@@ -0,0 +1,21 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Table from './index';
+declare const meta: Meta<typeof Table>;
+export default meta;
+type Story = StoryObj<typeof Table>;
+export declare const Basic: Story;
+export declare const Loading: Story;
+export declare const LoadingCustom: Story;
+export declare const Empty: Story;
+export declare const EmptyWithCustomText: Story;
+export declare const EmptyWithCustomNode: Story;
+export declare const WithPagination: Story;
+export declare const WithRowSelection: Story;
+export declare const WithSorting: Story;
+export declare const WithSorterChange: Story;
+export declare const WithFixedColumns: Story;
+export declare const WithColumnWidth: Story;
+export declare const WithRowSelectionDisabled: Story;
+export declare const WithCustomRender: Story;
+export declare const WithAlign: Story;
+export declare const WithPaginationChange: Story;