@xinghunm/compass-ui 0.5.0 → 0.7.0

package/dist/index.d.mts

@@ -1,23 +1,21 @@
 import * as React$1 from 'react';
 import React__default, { CSSProperties, ReactElement, ReactNode } from 'react';
-import { Placement } from '@floating-ui/react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Placement } from '@floating-ui/react';
 import { RuleItem } from 'async-validator';
+export { RuleItem } from 'async-validator';
 
 interface ButtonBaseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     /** Whether to enable ripple effect */
     hasRipple?: boolean;
-    /** Ripple background color */
-    rippleBgColor?: string;
-    /** Ripple opacity */
-    rippleOpacity?: number;
+    children?: React.ReactNode;
 }
 
 interface ButtonProps extends ButtonBaseProps {
     /** Button type */
     variant?: 'primary' | 'default' | 'dashed' | 'text' | 'link';
     /** Button size */
-    size?: 'small' | 'default' | 'large';
+    size?: 'small' | 'medium' | 'large';
     /** Button shape */
     shape?: 'default' | 'circle' | 'round';
     /** Whether the button is disabled */
@@ -30,6 +28,20 @@ interface ButtonProps extends ButtonBaseProps {
     block?: boolean;
     /** Button icon */
     icon?: React.ReactNode;
+    /** Custom class names for internal elements */
+    classNames?: {
+        root?: string;
+        icon?: string;
+        text?: string;
+        loading?: string;
+    };
+    /** Custom styles for internal elements */
+    styles?: {
+        root?: React.CSSProperties;
+        icon?: React.CSSProperties;
+        text?: React.CSSProperties;
+        loading?: React.CSSProperties;
+    };
 }
 
 declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
@@ -48,9 +60,7 @@ interface StepProps {
     status?: StepStatus;
     /** Disabled state */
     disabled?: boolean;
-    /** Custom className */
     className?: string;
-    /** Custom style */
     style?: React__default.CSSProperties;
 }
 interface StepsProps {
@@ -70,10 +80,40 @@ interface StepsProps {
     children?: React__default.ReactNode;
     /** Change handler */
     onChange?: (current: number) => void;
-    /** Custom className */
+    /**
+     * Custom class name for root element
+     */
     className?: string;
-    /** Custom style */
+    /**
+     * Custom style for root element
+     */
     style?: React__default.CSSProperties;
+    /**
+     * Granular styles
+     */
+    styles?: {
+        root?: React__default.CSSProperties;
+        item?: React__default.CSSProperties;
+        icon?: React__default.CSSProperties;
+        content?: React__default.CSSProperties;
+        title?: React__default.CSSProperties;
+        subtitle?: React__default.CSSProperties;
+        description?: React__default.CSSProperties;
+        tail?: React__default.CSSProperties;
+    };
+    /**
+     * Granular class names
+     */
+    classNames?: {
+        root?: string;
+        item?: string;
+        icon?: string;
+        content?: string;
+        title?: string;
+        subtitle?: string;
+        description?: string;
+        tail?: string;
+    };
 }
 
 declare const Step: React__default.FC<StepProps>;
@@ -81,6 +121,156 @@ declare const Steps: React__default.FC<StepsProps> & {
     Step: typeof Step;
 };
 
+interface PaginationProps {
+    /** Current page number */
+    current?: number;
+    /** Default initial page number */
+    defaultCurrent?: number;
+    /** Total number of data items */
+    total?: number;
+    /** Number of data items per page */
+    pageSize?: number;
+    /** Default number of data items per page */
+    defaultPageSize?: number;
+    /** Callback executed when page number or pageSize is changed */
+    onChange?: (page: number, pageSize: number) => void;
+    /** Disable pagination */
+    disabled?: boolean;
+    /** Determine whether to show the size changer */
+    showSizeChanger?: boolean;
+    /** Specify the size changer options */
+    pageSizeOptions?: number[];
+    /** Determine whether you can jump to pages directly */
+    showQuickJumper?: boolean;
+    /** To display the total number and range */
+    showTotal?: (total: number, range: [number, number]) => React.ReactNode;
+    /** Specify the alignment of total text */
+    totalAlign?: 'left' | 'right';
+    /** Whether to use simple mode */
+    simple?: boolean;
+    /** Specify the size of pagination component */
+    size?: 'default' | 'small';
+    /** Custom class name */
+    className?: string;
+    /** Custom style */
+    style?: React.CSSProperties;
+    /**
+     * Granular styles
+     */
+    styles?: {
+        root?: React.CSSProperties;
+        item?: React.CSSProperties;
+        activeItem?: React.CSSProperties;
+        jumpItem?: React.CSSProperties;
+        options?: React.CSSProperties;
+        total?: React.CSSProperties;
+    };
+    /**
+     * Granular class names
+     */
+    classNames?: {
+        root?: string;
+        item?: string;
+        activeItem?: string;
+        jumpItem?: string;
+        options?: string;
+        total?: string;
+    };
+}
+
+declare const Pagination: React__default.FC<PaginationProps>;
+
+interface ColumnType<T = unknown> {
+    /** Column title */
+    title: React__default.ReactNode;
+    /** Unique key for column */
+    key?: React__default.Key;
+    /** Field name to get value from record */
+    dataIndex?: keyof T;
+    /** Render function */
+    render?: (value: any, record: T, index: number) => React__default.ReactNode;
+    /** Column alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Column width */
+    width?: string | number;
+    /** Fixed column */
+    fixed?: 'left' | 'right' | boolean;
+    /** Sorter function */
+    sorter?: (a: T, b: T) => number;
+}
+interface RowSelection<T> {
+    /** Selected row keys */
+    selectedRowKeys?: React__default.Key[];
+    /** Callback when selection changes */
+    onChange?: (selectedRowKeys: React__default.Key[], selectedRows: T[]) => void;
+}
+interface TableProps<T = unknown> {
+    /** Data source array */
+    dataSource: T[];
+    /** Columns configuration */
+    columns: ColumnType<T>[];
+    /**
+     * Row's unique key
+     * @default 'key'
+     */
+    rowKey?: string | ((record: T) => string);
+    /** Whether to show border */
+    bordered?: boolean;
+    /** Table size */
+    size?: 'small' | 'medium' | 'large';
+    /** Loading status */
+    loading?: boolean;
+    /** Custom loading indicator */
+    loadingIndicator?: React__default.ReactNode;
+    /** Pagination config, set false to hide */
+    pagination?: PaginationProps | false;
+    /** Row selection config */
+    rowSelection?: RowSelection<T>;
+    /** Empty text */
+    emptyText?: React__default.ReactNode;
+    /** Scroll config */
+    scroll?: {
+        x?: string | number;
+        y?: string | number;
+    };
+    /** Set header row properties */
+    onHeaderRow?: (columns: ColumnType<T>[], index?: number) => React__default.HTMLAttributes<HTMLTableRowElement>;
+    /** Set row properties */
+    onRow?: (record: T, index?: number) => React__default.HTMLAttributes<HTMLTableRowElement>;
+    /** Custom class name */
+    className?: string;
+    /** Custom style */
+    style?: React__default.CSSProperties;
+    /** Granular styles */
+    styles?: {
+        root?: React__default.CSSProperties;
+        table?: React__default.CSSProperties;
+        thead?: React__default.CSSProperties;
+        tbody?: React__default.CSSProperties;
+        tr?: React__default.CSSProperties;
+        th?: React__default.CSSProperties;
+        td?: React__default.CSSProperties;
+        pagination?: React__default.CSSProperties;
+        empty?: React__default.CSSProperties;
+        loadingOverlay?: React__default.CSSProperties;
+    };
+    /** Granular class names */
+    classNames?: {
+        root?: string;
+        table?: string;
+        thead?: string;
+        tbody?: string;
+        tr?: string;
+        th?: string;
+        td?: string;
+        pagination?: string;
+        empty?: string;
+        loadingOverlay?: string;
+    };
+}
+
+declare function Table<T = unknown>(props: TableProps<T>): react_jsx_runtime.JSX.Element;
+
 interface DataNode {
     key: string | number;
     title?: React__default.ReactNode;
@@ -90,7 +280,8 @@ interface DataNode {
     checkable?: boolean;
     icon?: React__default.ReactNode;
     isLeaf?: boolean;
-    [key: string]: unknown;
+    /** Additional custom data fields */
+    extraData?: Record<string, unknown>;
 }
 interface TreeProps {
     /** Tree data */
@@ -138,18 +329,46 @@ interface TreeProps {
     }) => React__default.ReactNode);
     /** Custom title render */
     titleRender?: (node: DataNode) => React__default.ReactNode;
+    /** Whether to expand node on click */
+    expandOnClick?: boolean;
     /** Virtual scroll height */
     height?: number;
     /** Virtual scroll item height */
     itemHeight?: number;
     /** Enable virtual scrolling */
     virtual?: boolean;
-    /** Virtual List props */
-    virtualListProps?: Record<string, unknown>;
-    /** Class name */
+    /**
+     * Custom class name for root element
+     */
     className?: string;
-    /** Style */
+    /**
+     * Custom style for root element
+     */
     style?: React__default.CSSProperties;
+    /**
+     * Granular styles
+     */
+    styles?: {
+        root?: React__default.CSSProperties;
+        node?: React__default.CSSProperties;
+        content?: React__default.CSSProperties;
+        switcher?: React__default.CSSProperties;
+        checkbox?: React__default.CSSProperties;
+        icon?: React__default.CSSProperties;
+        title?: React__default.CSSProperties;
+    };
+    /**
+     * Granular class names
+     */
+    classNames?: {
+        root?: string;
+        node?: string;
+        content?: string;
+        switcher?: string;
+        checkbox?: string;
+        icon?: string;
+        title?: string;
+    };
 }
 interface TreeNodeProps extends Omit<DataNode, 'children'> {
     eventKey: string | number;
@@ -173,6 +392,9 @@ interface TreeNodeProps extends Omit<DataNode, 'children'> {
     showIcon?: boolean;
     isLast?: boolean;
     indentLines?: boolean[];
+    hasTitleRender?: boolean;
+    styles?: TreeProps['styles'];
+    classNames?: TreeProps['classNames'];
 }
 
 declare const Tree: React$1.FC<TreeProps>;
@@ -182,7 +404,6 @@ interface SelectOption {
     label: React__default.ReactNode;
     value: string | number;
     disabled?: boolean;
-    [key: string]: unknown;
 }
 interface SelectProps {
     /**
@@ -229,14 +450,6 @@ interface SelectProps {
      * Whether to allow clearing the selection
      */
     allowClear?: boolean;
-    /**
-     * Custom class name
-     */
-    className?: string;
-    /**
-     * Custom style
-     */
-    style?: React__default.CSSProperties;
     /**
      * Size of the select input
      * @default 'medium'
@@ -263,6 +476,45 @@ interface SelectProps {
      * @default 'click'
      */
     trigger?: 'click' | 'hover';
+    /** Custom class name */
+    className?: string;
+    /** Custom style */
+    style?: React__default.CSSProperties;
+    /**
+     * Granular styles for internal components
+     */
+    styles?: {
+        root?: React__default.CSSProperties;
+        trigger?: React__default.CSSProperties;
+        dropdown?: React__default.CSSProperties;
+        option?: React__default.CSSProperties;
+        tag?: React__default.CSSProperties;
+    };
+    /**
+     * Granular class names for internal components
+     */
+    classNames?: {
+        root?: string;
+        trigger?: string;
+        dropdown?: string;
+        option?: string;
+        tag?: string;
+    };
+    /**
+     * Custom option renderer
+     */
+    optionRender?: (option: SelectOption, info: {
+        index: number;
+        selected: boolean;
+    }) => React__default.ReactNode;
+    /**
+     * Custom label renderer (for the selected value in the trigger)
+     */
+    labelRender?: (props: SelectOption) => React__default.ReactNode;
+    /**
+     * Custom selected icon in the dropdown menu
+     */
+    menuItemSelectedIcon?: React__default.ReactNode;
 }
 interface OptionProps {
     value: string | number;
@@ -270,6 +522,7 @@ interface OptionProps {
     disabled?: boolean;
     className?: string;
     style?: React__default.CSSProperties;
+    menuItemSelectedIcon?: React__default.ReactNode;
     /**
      * Internal prop to pass label if children is complex
      */
@@ -312,6 +565,28 @@ interface TreeSelectProps extends Omit<SelectProps, 'options' | 'onChange'> {
      * Custom icon for selected tree node
      */
     treeSelectedIcon?: React__default.ReactNode;
+    /**
+     * Custom title render
+     */
+    titleRender?: (node: DataNode, searchValue: string) => React__default.ReactNode;
+    /**
+     * Custom expand icon
+     */
+    switcherIcon?: React__default.ReactNode | ((props: {
+        expanded: boolean;
+    }) => React__default.ReactNode);
+    /**
+     * Only allow selecting leaf nodes
+     */
+    onlyLeafSelect?: boolean;
+    /**
+     * Custom className
+     */
+    className?: string;
+    /**
+     * Custom style
+     */
+    style?: React__default.CSSProperties;
 }
 
 declare const TreeSelect: React__default.FC<TreeSelectProps>;
@@ -383,6 +658,24 @@ interface MenuProps {
      * Select handler
      */
     onSelect?: (keys: (string | number)[]) => void;
+    /**
+     * Granular styles
+     */
+    styles?: {
+        root?: React__default.CSSProperties;
+        item?: React__default.CSSProperties;
+        icon?: React__default.CSSProperties;
+        content?: React__default.CSSProperties;
+    };
+    /**
+     * Granular class names
+     */
+    classNames?: {
+        root?: string;
+        item?: string;
+        icon?: string;
+        content?: string;
+    };
 }
 interface MenuItemProps {
     /**
@@ -405,6 +698,10 @@ interface MenuItemProps {
      * Danger state
      */
     danger?: boolean;
+    /**
+     * Unique key for event handling
+     */
+    eventKey?: string | number;
     /**
      * Custom class name
      */
@@ -413,17 +710,18 @@ interface MenuItemProps {
      * Custom style
      */
     style?: React__default.CSSProperties;
-    /**
-     * Unique key for event handling
-     */
-    eventKey?: string | number;
 }
 
-declare const Menu: React__default.FC<MenuProps> & {
+declare const InternalMenu: React__default.ForwardRefExoticComponent<MenuProps & React__default.RefAttributes<HTMLUListElement>>;
+declare const MenuItem: React__default.ForwardRefExoticComponent<MenuItemProps & React__default.RefAttributes<HTMLLIElement>>;
+type MenuComponent = typeof InternalMenu & {
     Item: typeof MenuItem;
 };
-declare const MenuItem: React__default.FC<MenuItemProps>;
+declare const Menu: MenuComponent;
 
+/**
+ * Dropdown component properties
+ */
 interface DropdownProps {
     /**
      * Trigger mode
@@ -460,13 +758,43 @@ interface DropdownProps {
      */
     disabled?: boolean;
     /**
-     * Custom class name
+     * Custom root element class name
      */
     className?: string;
     /**
-     * Custom style
+     * Custom root element style
      */
     style?: React__default.CSSProperties;
+    /**
+     * Custom overlay element class name
+     */
+    overlayClassName?: string;
+    /**
+     * Custom overlay element style
+     */
+    overlayStyle?: React__default.CSSProperties;
+    /**
+     * Semantic class names for internal elements
+     */
+    classNames?: {
+        /** Class name for the trigger element */
+        trigger?: string;
+        /** Class name for the overlay container */
+        overlay?: string;
+        /** Class name for the content wrapper */
+        content?: string;
+    };
+    /**
+     * Semantic styles for internal elements
+     */
+    styles?: {
+        /** Style for the trigger element */
+        trigger?: React__default.CSSProperties;
+        /** Style for the overlay container */
+        overlay?: React__default.CSSProperties;
+        /** Style for the content wrapper */
+        content?: React__default.CSSProperties;
+    };
     /**
      * Whether to close the dropdown when a menu item is selected
      * @default true
@@ -482,20 +810,9 @@ interface InputFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLIn
      * @default 'text'
      */
     type?: 'text' | 'password' | 'search';
-    /**
-     * The label content.
-     */
-    label?: React__default.ReactNode;
-    /**
-     * The error content.
-     */
-    error?: boolean | React__default.ReactNode;
-    /**
-     * The helper text content.
-     */
-    helperText?: React__default.ReactNode;
     /**
      * If `true`, the input will take up the full width of its container.
+     * @default false
      */
     fullWidth?: boolean;
     /**
@@ -508,6 +825,7 @@ interface InputFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLIn
     suffix?: React__default.ReactNode;
     /**
      * If `true`, a clear icon will appear when the input has value.
+     * @default false
      */
     allowClear?: boolean;
     /**
@@ -527,6 +845,40 @@ interface InputFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLIn
      * The callback function that is triggered when Enter key is pressed.
      */
     onPressEnter?: (event: React__default.KeyboardEvent<HTMLInputElement>) => void;
+    /**
+     * The validation status.
+     */
+    status?: 'error' | 'warning';
+    /**
+     * Semantic class names for internal elements
+     */
+    classNames?: {
+        /** Class name for the root element */
+        root?: string;
+        /** Class name for the input element */
+        input?: string;
+        /** Class name for the prefix element */
+        prefix?: string;
+        /** Class name for the suffix element */
+        suffix?: string;
+        /** Class name for the clear button */
+        clear?: string;
+    };
+    /**
+     * Semantic styles for internal elements
+     */
+    styles?: {
+        /** Style for the root element */
+        root?: React__default.CSSProperties;
+        /** Style for the input element */
+        input?: React__default.CSSProperties;
+        /** Style for the prefix element */
+        prefix?: React__default.CSSProperties;
+        /** Style for the suffix element */
+        suffix?: React__default.CSSProperties;
+        /** Style for the clear button */
+        clear?: React__default.CSSProperties;
+    };
 }
 
 /**
@@ -534,6 +886,77 @@ interface InputFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLIn
  */
 declare const InputField: React__default.ForwardRefExoticComponent<InputFieldProps & React__default.RefAttributes<HTMLInputElement>>;
 
+interface AutoCompleteOption {
+    /** The value of the option */
+    value: string;
+    /** The label to display for the option */
+    label?: React__default.ReactNode;
+    /** Whether the option is disabled */
+    disabled?: boolean;
+    /** Allow additional custom fields */
+    [key: string]: unknown;
+}
+interface AutoCompleteProps extends Omit<InputFieldProps, 'onChange' | 'onSelect'> {
+    /**
+     * Current value of the input
+     */
+    value?: string;
+    /**
+     * Default value of the input
+     */
+    defaultValue?: string;
+    /**
+     * Data source for suggestions
+     */
+    options?: AutoCompleteOption[];
+    /**
+     * Callback when searching (search value change)
+     */
+    onSearch?: (value: string) => void;
+    /**
+     * Callback when selecting an option
+     */
+    onSelect?: (value: string, option: AutoCompleteOption) => void;
+    /**
+     * Callback when input value changes
+     */
+    onChange?: (value: string) => void;
+    /**
+     * Custom filter function or true to filter by label
+     * default: true
+     */
+    filterOption?: boolean | ((inputValue: string, option: AutoCompleteOption) => boolean);
+    /**
+     * Whether the dropdown width should match the input width
+     * default: true
+     */
+    dropdownMatchSelectWidth?: boolean | number;
+    /**
+     * Content to show when no options match
+     */
+    notFoundContent?: React__default.ReactNode;
+    /**
+     * Semantic DOM class names
+     */
+    classNames?: {
+        root?: string;
+        input?: string;
+        dropdown?: string;
+        option?: string;
+    };
+    /**
+     * Semantic DOM styles
+     */
+    styles?: {
+        root?: React__default.CSSProperties;
+        input?: React__default.CSSProperties;
+        dropdown?: React__default.CSSProperties;
+        option?: React__default.CSSProperties;
+    };
+}
+
+declare const AutoComplete: React__default.FC<AutoCompleteProps>;
+
 type MessageType$1 = 'info' | 'success' | 'error' | 'warning' | 'loading';
 interface MessageProps {
     key?: string;
@@ -593,6 +1016,8 @@ interface ModalBaseProps {
     style?: CSSProperties;
     /** Modal title */
     title?: React__default.ReactNode;
+    /** Custom header content */
+    header?: React__default.ReactNode;
     /** Whether to show the close button */
     closable?: boolean;
     /** Width of the modal */
@@ -608,7 +1033,26 @@ interface ModalBaseProps {
     /** Whether the OK button is loading */
     confirmLoading?: boolean;
     /** Callback when the modal is completely closed (after animation) */
+    /** Callback when the modal is completely closed (after animation) */
     afterClose?: () => void;
+    /** Granular styles */
+    styles?: {
+        root?: React__default.CSSProperties;
+        mask?: React__default.CSSProperties;
+        content?: React__default.CSSProperties;
+        header?: React__default.CSSProperties;
+        body?: React__default.CSSProperties;
+        footer?: React__default.CSSProperties;
+    };
+    /** Granular class names */
+    classNames?: {
+        root?: string;
+        mask?: string;
+        content?: string;
+        header?: string;
+        body?: string;
+        footer?: string;
+    };
 }
 
 declare const Modal: (props: ModalBaseProps) => React__default.ReactPortal;
@@ -714,51 +1158,26 @@ interface ProgressProps {
  */
 declare const Progress: React__default.ForwardRefExoticComponent<ProgressProps & React__default.RefAttributes<HTMLDivElement>>;
 
-interface PaginationProps {
-    /** Current page number */
-    current?: number;
-    /** Default initial page number */
-    defaultCurrent?: number;
-    /** Total number of data items */
-    total?: number;
-    /** Number of data items per page */
-    pageSize?: number;
-    /** Default number of data items per page */
-    defaultPageSize?: number;
-    /** Callback executed when page number or pageSize is changed */
-    onChange?: (page: number, pageSize: number) => void;
-    /** Disable pagination */
-    disabled?: boolean;
-    /** Determine whether to show the size changer */
-    showSizeChanger?: boolean;
-    /** Specify the size changer options */
-    pageSizeOptions?: number[];
-    /** Determine whether you can jump to pages directly */
-    showQuickJumper?: boolean;
-    /** To display the total number and range */
-    showTotal?: (total: number, range: [number, number]) => React.ReactNode;
-    /** Specify the alignment of total text */
-    totalAlign?: 'left' | 'right';
-    /** Whether to use simple mode */
-    simple?: boolean;
-    /** Specify the size of pagination component */
-    size?: 'default' | 'small';
-    /** Custom class name */
-    className?: string;
-    /** Custom style */
-    style?: React.CSSProperties;
-}
-
-declare const Pagination: React__default.FC<PaginationProps>;
-
 type DatePickerMode = 'date' | 'week' | 'month' | 'quarter' | 'year';
-interface DatePickerProps {
-    /** Selected date (JS Date) */
-    value?: Date | null;
-    /** Default selected date (JS Date) (Only effective on mount) */
-    defaultValue?: Date | null;
-    /** Callback when date changes */
-    onChange?: (date: Date | null) => void;
+interface DatePickerStyles {
+    root?: React.CSSProperties;
+    input?: React.CSSProperties;
+    popup?: React.CSSProperties;
+    header?: React.CSSProperties;
+    body?: React.CSSProperties;
+    footer?: React.CSSProperties;
+    day?: React.CSSProperties;
+}
+interface DatePickerClassNames {
+    root?: string;
+    input?: string;
+    popup?: string;
+    header?: string;
+    body?: string;
+    footer?: string;
+    day?: string;
+}
+interface DatePickerSharedProps {
     /** Picker mode */
     picker?: DatePickerMode;
     /** Whether to show time picker */
@@ -767,8 +1186,6 @@ interface DatePickerProps {
     format?: string;
     /** Disabled state */
     disabled?: boolean;
-    /** Placeholder text */
-    placeholder?: string;
     /** Clearable */
     clearable?: boolean;
     /** Custom class name */
@@ -777,32 +1194,36 @@ interface DatePickerProps {
     style?: React.CSSProperties;
     /** Whether the picker should take up the full width of its container */
     fullWidth?: boolean;
+    /** Validation status */
+    status?: 'error' | 'warning';
+    /**
+     * Granular styles for internal components
+     */
+    styles?: DatePickerStyles;
+    /**
+     * Granular class names for internal components
+     */
+    classNames?: DatePickerClassNames;
 }
-interface DateRangePickerProps {
+interface DatePickerProps extends DatePickerSharedProps {
+    /** Selected date (JS Date) */
+    value?: Date | null;
+    /** Default selected date (JS Date) (Only effective on mount) */
+    defaultValue?: Date | null;
+    /** Callback when date changes */
+    onChange?: (date: Date | null) => void;
+    /** Placeholder text */
+    placeholder?: string;
+}
+interface DateRangePickerProps extends DatePickerSharedProps {
     /** Selected date range */
     value?: [Date | null, Date | null];
     /** Default selected date range */
     defaultValue?: [Date | null, Date | null];
     /** Callback when date range changes */
     onChange?: (dates: [Date | null, Date | null]) => void;
-    /** Picker mode */
-    picker?: DatePickerMode;
-    /** Whether to show time picker */
-    showTime?: boolean;
-    /** Date format string */
-    format?: string;
-    /** Disabled state */
-    disabled?: boolean;
     /** Placeholder text */
     placeholder?: [string, string];
-    /** Clearable */
-    clearable?: boolean;
-    /** Custom class name */
-    className?: string;
-    /** Custom style */
-    style?: React.CSSProperties;
-    /** Whether the picker should take up the full width of its container */
-    fullWidth?: boolean;
 }
 
 declare const DatePicker$1: React__default.ForwardRefExoticComponent<DatePickerProps & React__default.RefAttributes<HTMLDivElement>>;
@@ -818,8 +1239,8 @@ declare const DatePicker: DatePickerInterface;
 interface Theme {
     colors: {
         primary: string;
-        primaryHover: string;
-        primaryActive: string;
+        primaryHover?: string;
+        primaryActive?: string;
         success: string;
         warning: string;
         error: string;
@@ -831,9 +1252,11 @@ interface Theme {
         background: string;
         backgroundSecondary: string;
         backgroundTertiary: string;
+        backgroundHover: string;
         border: string;
         borderSecondary: string;
         borderHover: string;
+        white: string;
     };
     spacing: {
         xs: number;
@@ -903,8 +1326,18 @@ interface Theme {
         tree: TreeTheme;
         form: FormTheme;
         tabs: TabsTheme;
+        table: TableTheme;
     };
 }
+interface TableTheme {
+    headerBg: string;
+    headerColor: string;
+    rowHoverBg: string;
+    borderColor: string;
+    bodyBg: string;
+    color: string;
+    cellPadding: string;
+}
 interface FormTheme {
     itemMarginBottom: string;
     labelColor: string;
@@ -1021,9 +1454,12 @@ interface ButtonTheme {
         md: string;
         lg: string;
     };
+    rippleOpacity: number;
 }
 interface MessageTheme {
     contentPadding: string;
+    contentBg: string;
+    contentColor: string;
     borderRadius: string;
     boxShadow: string;
     zIndex: number;
@@ -1037,6 +1473,7 @@ interface ModalTheme {
     bodyPadding: string;
     footerPadding: string;
     zIndex: number;
+    padding: string;
 }
 interface ProgressTheme {
     trackColor: string;
@@ -1162,6 +1599,8 @@ interface ThemeConfig {
     light?: DeepPartial<Theme>;
     dark?: DeepPartial<Theme>;
     defaultMode?: ThemeMode;
+    /** Whether to inject CSS variables to :root. */
+    global?: boolean;
 }
 interface ConfigProviderProps {
     /**
@@ -1222,14 +1661,40 @@ interface InputNumberProps extends Omit<InputFieldProps, 'onChange' | 'value' |
      * @default true
      */
     keyboard?: boolean;
+    /**
+     * Semantic class names for internal elements
+     */
+    classNames?: {
+        root?: string;
+        input?: string;
+        inputWrapper?: string;
+        prefix?: string;
+        suffix?: string;
+        upHandler?: string;
+        downHandler?: string;
+    };
+    /**
+     * Semantic styles for internal elements
+     */
+    styles?: {
+        root?: React.CSSProperties;
+        input?: React.CSSProperties;
+        inputWrapper?: React.CSSProperties;
+        prefix?: React.CSSProperties;
+        suffix?: React.CSSProperties;
+        upHandler?: React.CSSProperties;
+        downHandler?: React.CSSProperties;
+    };
 }
 
 declare const InputNumber: React__default.ForwardRefExoticComponent<InputNumberProps & React__default.RefAttributes<HTMLInputElement>>;
 
+type InternalNamePath = (string | number)[];
+type NamePath = string | number | InternalNamePath;
 type StoreValue = unknown;
 type Store = Record<string, StoreValue>;
 interface FieldData {
-    name: string;
+    name: InternalNamePath;
     value?: StoreValue;
     touched?: boolean;
     validating?: boolean;
@@ -1243,16 +1708,11 @@ interface FieldEntity {
     validateRules: (options?: {
         triggerName?: string;
     }) => Promise<string[] | null>;
-    getName: () => string;
+    getNamePath: () => InternalNamePath;
     getErrors: () => string[];
     isFieldValidating: () => boolean;
     isFieldTouched: () => boolean;
-    props: {
-        name?: string;
-        rules?: RuleItem[];
-        dependencies?: string[];
-        initialValue?: unknown;
-    };
+    props: FormItemProps;
     setErrors: (errors: string[]) => void;
 }
 interface Callbacks<Values = Record<string, unknown>> {
@@ -1264,72 +1724,122 @@ interface Callbacks<Values = Record<string, unknown>> {
 interface ValidateErrorEntity<Values = Record<string, unknown>> {
     values: Values;
     errorFields: {
-        name: string;
+        name: InternalNamePath;
         errors: string[];
     }[];
     outOfDate: boolean;
 }
 interface InternalHooks {
     registerField: (entity: FieldEntity) => () => void;
-    registerWatch: (callback: (name: string) => void) => () => void;
+    registerWatch: (callback: (namePath: InternalNamePath) => void) => () => void;
     setInitialValues: (values: Store, init: boolean) => void;
     setCallbacks: (callbacks: Callbacks) => void;
     dispatch: (action: ReducerAction) => void;
-    getFieldValue: (name: string) => StoreValue;
-    notifyFieldChange: (name: string) => void;
+    getFieldValue: (name: NamePath) => StoreValue;
+    notifyFieldChange: (name: InternalNamePath) => void;
 }
 interface FormInstance<Values = Record<string, unknown>> {
-    getFieldValue: (name: string) => StoreValue;
+    getFieldValue: (name: NamePath) => StoreValue;
     getFieldsValue: () => Values;
-    getFieldError: (name: string) => string[];
-    isFieldsTouched: (nameList?: string[]) => boolean;
-    isFieldTouched: (name: string) => boolean;
-    isFieldValidating: (name: string) => boolean;
-    resetFields: (fields?: string[]) => void;
+    getFieldError: (name: NamePath) => string[];
+    isFieldsTouched: (nameList?: NamePath[]) => boolean;
+    isFieldTouched: (name: NamePath) => boolean;
+    isFieldValidating: (name: NamePath) => boolean;
+    resetFields: (fields?: NamePath[]) => void;
     setFields: (fields: FieldData[]) => void;
-    setFieldValue: (name: string, value: unknown) => void;
+    setFieldValue: (name: NamePath, value: unknown) => void;
     setFieldsValue: (values: RecursivePartial<Values>) => void;
-    validateFields: (nameList?: string[]) => Promise<Values>;
+    validateFields: (nameList?: NamePath[]) => Promise<Values>;
     submit: () => void;
     getInternalHooks: (secret: string) => InternalHooks | null;
 }
-type RecursivePartial<T> = {
-    [P in keyof T]?: T[P] extends (infer U)[] ? RecursivePartial<U>[] : T[P] extends object ? RecursivePartial<T[P]> : T[P];
-};
-interface ReducerAction {
-    type: string;
-    payload: unknown;
-}
-
+/**
+ * Form properties
+ */
 interface FormProps<Values = Record<string, unknown>> {
+    /** Form instance */
     form?: FormInstance<Values>;
+    /** Form layout */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /** Initial values for the form */
     initialValues?: Store;
+    /** Form items and other content */
     children?: ReactNode;
+    /** Callback triggered after successfully submitting the form and validation */
     onFinish?: (values: Values) => void;
+    /** Callback triggered after submitting the form and validation fails */
     onFinishFailed?: (errorInfo: ValidateErrorEntity<Values>) => void;
+    /** Callback triggered when any field value changes */
     onValuesChange?: (changedValues: Store, values: Values) => void;
+    /** Callback triggered when any field state changes */
     onFieldsChange?: (changedFields: FieldData[], allFields: FieldData[]) => void;
+    /** Custom root element class name */
     className?: string;
+    /** Custom root element style */
     style?: React__default.CSSProperties;
+    /** Semantic class names for internal elements */
+    classNames?: {
+        /** Class name for the form element */
+        form?: string;
+        /** Class name for the form items */
+        item?: string;
+        /** Class name for the labels */
+        label?: string;
+        /** Class name for the error messages */
+        error?: string;
+    };
+    /** Semantic styles for internal elements */
+    styles?: {
+        /** Style for the form element */
+        form?: React__default.CSSProperties;
+        /** Style for the form items */
+        item?: React__default.CSSProperties;
+        /** Style for the labels */
+        label?: React__default.CSSProperties;
+        /** Style for the error messages */
+        error?: React__default.CSSProperties;
+    };
 }
-declare const Form$1: <Values extends Record<string, unknown> = Record<string, unknown>>({ form, initialValues, children, onFinish, onFinishFailed, onValuesChange, onFieldsChange, className, style, }: FormProps<Values>) => react_jsx_runtime.JSX.Element;
-
+/**
+ * Form Item properties
+ */
 interface FormItemProps {
-    name?: string;
-    label?: string;
+    /** Field name */
+    name?: NamePath;
+    /** Label text or node */
+    label?: React__default.ReactNode;
+    /** Validation rules */
     rules?: RuleItem[];
+    /** Field components */
     children: ReactElement;
+    /** Validation trigger */
     validateTrigger?: string | string[];
+    /** Initial value of the field */
     initialValue?: unknown;
+    /** Custom root element class name */
     className?: string;
+    /** Custom root element style */
     style?: React__default.CSSProperties;
+    /** The prompt message. If not provided, use the validation result. */
     help?: React__default.ReactNode;
+    /** Related fields. If any related field changes, this field will be validated. */
+    dependencies?: NamePath[];
+}
+type RecursivePartial<T> = {
+    [P in keyof T]?: T[P] extends (infer U)[] ? RecursivePartial<U>[] : T[P] extends object ? RecursivePartial<T[P]> : T[P];
+};
+interface ReducerAction {
+    type: string;
+    payload: unknown;
 }
+
+declare const Form$1: React__default.ForwardRefExoticComponent<FormProps<Record<string, unknown>> & React__default.RefAttributes<HTMLFormElement>>;
+
 declare const FormItem: React__default.FC<FormItemProps>;
 
 declare const useForm: <Values extends Record<string, unknown> = Record<string, unknown>>(form?: FormInstance<Values>) => [FormInstance<Values>];
 
-declare const useWatch: <T = unknown>(name: string | string[], form?: FormInstance) => T;
+declare const useWatch: <T = unknown>(name: NamePath, form?: FormInstance) => T;
 
 type InternalFormType = typeof Form$1;
 interface FormInterface extends InternalFormType {
@@ -1360,14 +1870,30 @@ interface TabsProps {
     type?: 'line' | 'card' | 'editable-card';
     /** Tab size */
     size?: 'small' | 'default' | 'large';
-    /** Custom className */
-    className?: string;
-    /** Custom style */
-    style?: React__default.CSSProperties;
+    /** Tab bar position (controls layout separate from styling) */
+    tabBarPosition?: 'top' | 'right' | 'bottom' | 'left';
     /** Children (TabPane components) */
     children?: React__default.ReactNode;
     /** Callback when tab is edited */
     onEdit?: (targetKey: string, action: 'add' | 'remove') => void;
+    /** Custom class name */
+    className?: string;
+    /** Custom style */
+    style?: React__default.CSSProperties;
+    /** Granular styles */
+    styles?: {
+        root?: React__default.CSSProperties;
+        nav?: React__default.CSSProperties;
+        inkBar?: React__default.CSSProperties;
+        content?: React__default.CSSProperties;
+    };
+    /** Granular class names */
+    classNames?: {
+        root?: string;
+        nav?: string;
+        inkBar?: string;
+        content?: string;
+    };
 }
 interface TabItem {
     key: string;
@@ -1402,4 +1928,4 @@ type TabsComponent = typeof Tabs & {
 };
 declare const _default: TabsComponent;
 
-export { Button, type ButtonProps, ConfigProvider, type ConfigProviderProps, type DataNode, DatePicker, type DatePickerProps, type DateRangePickerProps, Dropdown, type DropdownProps, type FieldData, Form, type FormInstance, type FormItemProps, type FormProps, InputField, type InputFieldProps, InputNumber, type InputNumberProps, type ItemType, Menu, type MenuItemProps, type MenuProps, messageWithHook as Message, type MessageProps, ModalWithStatics as Modal, type ModalBaseProps as ModalProps, Pagination, type PaginationProps, Progress, type ProgressProps, Select, type SelectOption, type SelectProps, type SelectValue, Steps, type StepsProps, type TabItem, type TabPaneProps, _default as Tabs, type TabsProps, Tree, type TreeNodeProps, type TreeProps, TreeSelect, type TreeSelectProps, type ValidateErrorEntity };
+export { AutoComplete, type AutoCompleteOption, type AutoCompleteProps, Button, type ButtonProps, type ColumnType, ConfigProvider, type ConfigProviderProps, type DataNode, DatePicker, type DatePickerProps, type DateRangePickerProps, Dropdown, type DropdownProps, type FieldData, Form, type FormInstance, type FormItemProps, type FormProps, InputField, type InputFieldProps, InputNumber, type InputNumberProps, type ItemType, Menu, type MenuItemProps, type MenuProps, messageWithHook as Message, type MessageProps, ModalWithStatics as Modal, type ModalBaseProps as ModalProps, type NamePath, Pagination, type PaginationProps, Progress, type ProgressProps, type RowSelection, Select, type SelectOption, type SelectProps, type SelectValue, Steps, type StepsProps, type TabItem, type TabPaneProps, Table, type TableProps, _default as Tabs, type TabsProps, Tree, type TreeNodeProps, type TreeProps, TreeSelect, type TreeSelectProps, type ValidateErrorEntity };