aha-components 1.8.1 → 1.8.2

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

@@ -0,0 +1,96 @@
+import React from 'react';
+export interface DateRange {
+    startDate: Date | null;
+    endDate: Date | null;
+}
+export interface PresetRange {
+    label: string;
+    range: DateRange;
+}
+export interface DatePickerBaseProps {
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否显示错误状态 */
+    error?: boolean;
+    /** 占位符（单个日期模式） */
+    placeholder?: string;
+    /** 开始日期占位符（范围模式） */
+    startPlaceholder?: string;
+    /** 结束日期占位符（范围模式） */
+    endPlaceholder?: string;
+    /** 尺寸 */
+    size?: 'small' | 'mediumSmall' | 'medium' | 'large';
+    /** 是否允许清除 */
+    allowClear?: boolean;
+    /** 日期格式 */
+    format?: string;
+    /** 聚焦回调 */
+    onFocus?: (e: React.FocusEvent) => void;
+    /** 失焦回调 */
+    onBlur?: (e: React.FocusEvent) => void;
+    /** 下拉框打开回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 下拉框类名 */
+    dropdownClassName?: string;
+    /** 下拉框样式 */
+    dropdownStyle?: React.CSSProperties;
+    /** 是否默认打开 */
+    defaultOpen?: boolean;
+    /** 是否打开（受控） */
+    open?: boolean;
+    /** 最小日期 */
+    minDate?: Date;
+    /** 最大日期 */
+    maxDate?: Date;
+    /** 分隔符（范围模式） */
+    separator?: string;
+    /** 预设日期范围列表（仅在范围模式下有效） */
+    presetRanges?: PresetRange[] | boolean;
+    /** 显示日历数量：1=单月，2=双月（仅在范围模式下有效，默认1） */
+    calendarCount?: 1 | 2;
+    /** 是否显示 Apply/Cancel 按钮（仅在范围模式下有效） */
+    showApplyCancel?: boolean;
+    /** Apply 按钮文本 */
+    applyText?: string;
+    /** Cancel 按钮文本 */
+    cancelText?: string;
+    /** Apply 按钮回调 */
+    onApply?: (range: DateRange) => void;
+    /** Cancel 按钮回调 */
+    onCancel?: () => void;
+    /** 是否显示选中的日期段（仅在范围模式下有效，默认false） */
+    showSelectedRange?: boolean;
+    /** 选中的开始日期段文本 */
+    startSelectedRangeText?: string;
+    /** 选中的结束日期段文本 */
+    endSelectedRangeText?: string;
+    /** 范围显示模式：'range'=显示两个输入框（xxx - xxx），'text'=显示一句话（仅在范围模式下有效，默认'range'） */
+    rangeDisplayMode?: 'range' | 'text';
+}
+export interface DatePickerSingleProps extends DatePickerBaseProps {
+    /** 模式：单个日期 */
+    mode?: 'date';
+    /** 当前选中的值 */
+    value?: Date | null;
+    /** 默认选中的值 */
+    defaultValue?: Date | null;
+    /** 变化回调 */
+    onChange?: (date: Date | null) => void;
+}
+export interface DatePickerRangeProps extends DatePickerBaseProps {
+    /** 模式：日期范围 */
+    mode: 'range';
+    /** 当前选中的值 */
+    value?: DateRange;
+    /** 默认选中的值 */
+    defaultValue?: DateRange;
+    /** 变化回调 */
+    onChange?: (range: DateRange) => void;
+}
+export type DatePickerProps = DatePickerSingleProps | DatePickerRangeProps;
+declare const DatePicker: React.FC<DatePickerProps>;
+export default DatePicker;

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

@@ -0,0 +1,9 @@
+import { Meta, StoryObj } from "@storybook/react";
+import Drawer from "./index";
+declare const meta: Meta<typeof Drawer>;
+export default meta;
+type Story = StoryObj<typeof Drawer>;
+export declare const Basic: Story;
+export declare const Placements: Story;
+export declare const NonControlled: Story;
+export declare const MobileWidthDemo: Story;

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

@@ -0,0 +1,58 @@
+import React from "react";
+export type DrawerPlacement = "left" | "right" | "top" | "bottom";
+export interface DrawerProps {
+    /** 是否打开（受控） */
+    open?: boolean;
+    /** 默认是否打开（非受控） */
+    defaultOpen?: boolean;
+    /** 关闭回调 */
+    onClose?: (e?: React.MouseEvent | React.KeyboardEvent) => void;
+    /** 打开/关闭动画结束回调 */
+    afterOpenChange?: (open: boolean) => void;
+    /** 抽屉标题 */
+    title?: React.ReactNode;
+    /** 头部右侧内容 */
+    extra?: React.ReactNode;
+    /** 底部内容 */
+    footer?: React.ReactNode;
+    /** 内容 */
+    children?: React.ReactNode;
+    /** 打开方向 */
+    placement?: DrawerPlacement;
+    /** PC 端宽度（移动端始终使用 100vw） */
+    width?: number | string;
+    /** 高度（top/bottom 生效，移动端同样支持） */
+    height?: number | string;
+    /** 是否显示遮罩 */
+    mask?: boolean;
+    /** 点击遮罩是否关闭 */
+    maskClosable?: boolean;
+    /** 是否显示右上角关闭按钮 */
+    closable?: boolean;
+    /** 自定义关闭图标 */
+    closeIcon?: React.ReactNode;
+    /** 是否支持 Esc 关闭 */
+    keyboard?: boolean;
+    /** 是否在关闭后销毁内容 */
+    destroyOnClose?: boolean;
+    /** 层级 */
+    zIndex?: number;
+    /** 移动端断点 */
+    mobileBreakpoint?: number;
+    /** 容器类名 */
+    className?: string;
+    /** 容器样式 */
+    style?: React.CSSProperties;
+    /** 抽屉面板类名 */
+    drawerStyle?: React.CSSProperties;
+    /** 头部样式 */
+    headerStyle?: React.CSSProperties;
+    /** 内容样式 */
+    bodyStyle?: React.CSSProperties;
+    /** 底部样式 */
+    footerStyle?: React.CSSProperties;
+    /** 遮罩样式 */
+    maskStyle?: React.CSSProperties;
+}
+declare const Drawer: React.FC<DrawerProps>;
+export default Drawer;

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

@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Form from './index';
+declare const meta: Meta<typeof Form>;
+export default meta;
+type Story = StoryObj<typeof Form>;
+export declare const Basic: Story;
+export declare const Complete: Story;
+export declare const Layouts: Story;
+export declare const ValidationRules: Story;
+export declare const WithFormInstance: Story;
+export declare const WithHelpAndExtra: Story;
+export declare const WithTooltip: Story;
+export declare const ProgrammaticSubmit: Story;
+export declare const SingleFieldOperations: Story;
+export declare const FormLevelOperations: Story;

package/dist/components/Form/FormContext 2.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+export interface FieldData {
+    value?: any;
+    error?: string;
+    touched?: boolean;
+    validating?: boolean;
+    rules?: any[];
+    required?: boolean;
+}
+export interface FormContextValue {
+    fields: Record<string, FieldData>;
+    getFieldValue: (name: string) => any;
+    setFieldValue: (name: string, value: any) => void;
+    getFieldError: (name: string) => string | undefined;
+    setFieldError: (name: string, error: string | undefined) => void;
+    isFieldTouched: (name: string) => boolean;
+    setFieldTouched: (name: string, touched: boolean) => void;
+    isFieldValidating: (name: string) => boolean;
+    setFieldValidating: (name: string, validating: boolean) => void;
+    registerField: (name: string, options: {
+        rules?: any[];
+        required?: boolean;
+    }) => void;
+    unregisterField: (name: string) => void;
+    validateField: (name: string) => Promise<string | undefined>;
+    validateFields: (nameList?: string[]) => Promise<any>;
+    resetFields: (nameList?: string[]) => void;
+    getFieldsValue: (nameList?: string[]) => any;
+    setFieldsValue: (values: Record<string, any>) => void;
+    submit: () => Promise<any>;
+    setFields: (fields: Array<{
+        name: string;
+        value?: any;
+        errors?: string[];
+    }>) => void;
+    scrollToField: (name: string, options?: ScrollIntoViewOptions) => void;
+    registerFieldRef: (name: string, element: HTMLElement | null) => void;
+    labelWidth?: number | string;
+    labelAlign?: 'left' | 'right';
+}
+export declare const FormContext: React.Context<FormContextValue | null>;

package/dist/components/Form/FormItem 2.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+export interface FormItemProps {
+    /** 字段名 */
+    name?: string;
+    /** 标签 */
+    label?: React.ReactNode;
+    /** 标签的 HTML for 属性 */
+    htmlFor?: string;
+    /** 标签布局 */
+    labelCol?: {
+        span?: number;
+        offset?: number;
+    };
+    /** 输入控件布局 */
+    wrapperCol?: {
+        span?: number;
+        offset?: number;
+    };
+    /** 是否必填（显示红色星号） */
+    required?: boolean;
+    /** 校验规则 */
+    rules?: Array<{
+        required?: boolean;
+        message?: string;
+        validator?: (rule: any, value: any) => Promise<void> | void;
+        pattern?: RegExp;
+        min?: number;
+        max?: number;
+        len?: number;
+        type?: 'string' | 'number' | 'boolean' | 'method' | 'regexp' | 'integer' | 'float' | 'array' | 'object' | 'enum' | 'date' | 'url' | 'hex' | 'email';
+        whitespace?: boolean;
+        [key: string]: any;
+    }>;
+    /** 是否显示校验信息 */
+    hasFeedback?: boolean;
+    /** 校验状态 */
+    validateStatus?: 'success' | 'warning' | 'error' | 'validating';
+    /** 帮助信息 */
+    help?: React.ReactNode;
+    /** 额外的提示信息 */
+    extra?: React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 子元素 */
+    children?: React.ReactNode;
+    /** 标签对齐方式 */
+    labelAlign?: 'left' | 'right';
+    /** 标签宽度 */
+    labelWidth?: number | string;
+    /** 是否隐藏 */
+    hidden?: boolean;
+    /** 标签提示信息（tooltip） */
+    tooltip?: React.ReactNode;
+}
+declare const FormItem: React.FC<FormItemProps>;
+export default FormItem;

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

@@ -0,0 +1,85 @@
+import React from 'react';
+import FormItem from './FormItem';
+export interface FormProps {
+    /** 表单初始值 */
+    initialValues?: Record<string, any>;
+    /** 表单值变化回调 */
+    onValuesChange?: (changedValues: Record<string, any>, allValues: Record<string, any>) => void;
+    /** 表单提交回调 */
+    onFinish?: (values: Record<string, any>) => void;
+    /** 表单提交失败回调 */
+    onFinishFailed?: (errorInfo: {
+        values: Record<string, any>;
+        errorFields: Array<{
+            name: string;
+            errors: string[];
+        }>;
+    }) => void;
+    /** 标签宽度 */
+    labelWidth?: number | string;
+    /** 标签对齐方式 */
+    labelAlign?: 'left' | 'right';
+    /** 布局方式 */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /** 尺寸 */
+    size?: 'small' | 'medium' | 'large';
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 子元素 */
+    children?: React.ReactNode;
+}
+/** scrollToField 的选项，与 Element.scrollIntoView 一致 */
+export type ScrollToFieldOptions = ScrollIntoViewOptions;
+/** 校验失败时抛出的错误，携带 values 和 errorFields，便于 catch 后使用 */
+export declare class FormValidationError extends Error {
+    /** 当前表单值 */
+    values: Record<string, any>;
+    /** 校验失败的字段列表 */
+    errorFields: Array<{
+        name: string;
+        errors: string[];
+    }>;
+    constructor(message: string, values: Record<string, any>, errorFields: Array<{
+        name: string;
+        errors: string[];
+    }>);
+}
+export interface FormInstance {
+    /** 获取字段值 */
+    getFieldValue: (name: string) => any;
+    /** 获取所有字段值 */
+    getFieldsValue: (nameList?: string[]) => any;
+    /** 设置字段值 */
+    setFieldValue: (name: string, value: any) => void;
+    /** 设置所有字段值 */
+    setFieldsValue: (values: Record<string, any>) => void;
+    /** 批量设置字段（值 + 错误），类似 antd 的 setFields */
+    setFields: (fields: Array<{
+        name: string;
+        value?: any;
+        errors?: string[];
+    }>) => void;
+    /** 获取字段错误 */
+    getFieldError: (name: string) => string | undefined;
+    /** 校验字段 */
+    validateField: (name: string) => Promise<string | undefined>;
+    /** 校验所有字段 */
+    validateFields: (nameList?: string[]) => Promise<any>;
+    /** 重置字段 */
+    resetFields: (nameList?: string[]) => void;
+    /** 提交表单：校验通过时 resolve 表单值，校验失败时 reject 为 FormValidationError（需 await 或 .catch() 才能捕获） */
+    submit: () => Promise<any>;
+    /** 滚动到指定字段（如第一个报错项） */
+    scrollToField: (name: string, options?: ScrollToFieldOptions) => void;
+}
+declare const Form: React.ForwardRefExoticComponent<FormProps & React.RefAttributes<FormInstance>>;
+/** 获取表单实例的 hook，用法与 antd Form.useForm() 一致，返回的 ref 传给 <Form ref={formRef} /> 后即可使用 formRef.current?.setFieldValue 等方法 */
+declare function useForm(): [React.RefObject<FormInstance | null>];
+declare const FormWithItem: typeof Form & {
+    Item: typeof FormItem;
+    useForm: typeof useForm;
+};
+export default FormWithItem;
+export { useForm };

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

@@ -0,0 +1,16 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Input from './index';
+declare const meta: Meta<typeof Input>;
+export default meta;
+type Story = StoryObj<typeof Input>;
+export declare const Basic: Story;
+export declare const Sizes: Story;
+export declare const Disabled: Story;
+export declare const Error: Story;
+export declare const ReadOnly: Story;
+export declare const WithPrefix: Story;
+export declare const WithSuffix: Story;
+export declare const WithClear: Story;
+export declare const WithPressEnter: Story;
+export declare const Controlled: Story;
+export declare const AllStates: Story;

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

@@ -9,8 +9,11 @@ export declare const Disabled: Story;
 export declare const Error: Story;
 export declare const ReadOnly: Story;
 export declare const WithPrefix: Story;
-export declare const WithSuffix: Story;
 export declare const WithClear: Story;
-export declare const WithPressEnter: Story;
-export declare const Controlled: Story;
-export declare const AllStates: Story;
+export declare const LeadingText: Story;
+export declare const LeadingDropdown: Story;
+export declare const TrailingDropdown: Story;
+export declare const TrailingButton: Story;
+export declare const PaymentInput: Story;
+export declare const Tags: Story;
+export declare const AllVariants: Story;

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

@@ -0,0 +1,25 @@
+import React from 'react';
+export interface InputGroupProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix' | 'suffix'> {
+    size?: 'small' | 'mediumSmall' | 'medium' | 'large';
+    error?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+    prefix?: React.ReactNode;
+    suffix?: React.ReactNode;
+    /** Text addon on the left (e.g. "https://") — auto-styled with correct padding */
+    leadingText?: React.ReactNode;
+    /** Text addon on the right (e.g. "USD") — auto-styled with correct padding */
+    trailingText?: React.ReactNode;
+    /** Raw ReactNode on the left (dropdown, icon button, etc.) — no padding added */
+    leadingAddon?: React.ReactNode;
+    /** Raw ReactNode on the right (button, select, etc.) — no padding added */
+    trailingAddon?: React.ReactNode;
+    onPressEnter?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    label?: string;
+    required?: boolean;
+    hintText?: string;
+}
+declare const InputGroup: React.ForwardRefExoticComponent<InputGroupProps & React.RefAttributes<HTMLInputElement>>;
+export default InputGroup;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+export interface InputTagsProps {
+    value?: string[];
+    defaultValue?: string[];
+    onChange?: (tags: string[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    error?: boolean;
+    size?: 'small' | 'mediumSmall' | 'medium' | 'large';
+    className?: string;
+    style?: React.CSSProperties;
+    label?: string;
+    required?: boolean;
+    hintText?: string;
+}
+declare const InputTags: React.FC<InputTagsProps>;
+export default InputTags;

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

@@ -0,0 +1,41 @@
+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;
+}
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+export default Input;

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;