@douyinfe/semi-ui 2.22.2 → 2.23.0-alpha.0

package/lib/cjs/tagInput/index.d.ts

@@ -37,7 +37,7 @@ export interface TagInputProps {
     insetLabel?: React.ReactNode;
     insetLabelId?: string;
     prefix?: React.ReactNode;
-    renderTagItem?: (value: string, index: number) => React.ReactNode;
+    renderTagItem?: (value: string, index: number, onClose: () => void) => React.ReactNode;
     separator?: string | string[] | null;
     showClear?: boolean;
     size?: Size;
@@ -89,7 +89,7 @@ declare class TagInput extends BaseComponent<TagInputProps, TagInputState> {
         onAdd: PropTypes.Requireable<(...args: any[]) => any>;
         onRemove: PropTypes.Requireable<(...args: any[]) => any>;
         onKeyDown: PropTypes.Requireable<(...args: any[]) => any>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         validateStatus: PropTypes.Requireable<"default" | "error" | "warning" | "success">;
         prefix: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
         suffix: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;

package/lib/cjs/tagInput/index.js

@@ -152,20 +152,22 @@ class TagInput extends _baseComponent.default {
       return tagsArray.map((value, index) => {
         const elementKey = showIconHandler ? value : "".concat(index).concat(value);
 
+        const onClose = () => {
+          !disabled && this.handleTagClose(index);
+        };
+
         if ((0, _isFunction2.default)(renderTagItem)) {
           return showIconHandler ? /*#__PURE__*/_react.default.createElement("div", {
             className: itemWrapperCls,
             key: elementKey
-          }, /*#__PURE__*/_react.default.createElement(DragHandle, null), renderTagItem(value, index)) : renderTagItem(value, index);
+          }, /*#__PURE__*/_react.default.createElement(DragHandle, null), renderTagItem(value, index, onClose)) : renderTagItem(value, index, onClose);
         } else {
           return /*#__PURE__*/_react.default.createElement(_tag.default, {
             className: tagCls,
             color: "white",
             size: size === 'small' ? 'small' : 'large',
             type: "light",
-            onClose: () => {
-              !disabled && this.handleTagClose(index);
-            },
+            onClose: onClose,
             closable: !disabled,
             key: elementKey,
             visible: true,

package/lib/cjs/timePicker/TimePicker.d.ts

@@ -125,7 +125,7 @@ export default class TimePicker extends BaseComponent<TimePickerProps, TimePicke
         secondStep: PropTypes.Requireable<number>;
         focusOnOpen: PropTypes.Requireable<boolean>;
         autoFocus: PropTypes.Requireable<boolean>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         panels: PropTypes.Requireable<PropTypes.InferProps<{
             panelHeader: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
             panelFooter: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;

package/lib/cjs/timePicker/index.d.ts

@@ -46,7 +46,7 @@ export default class LocaleTimePicker extends React.PureComponent<LocalePickerPr
         secondStep: import("prop-types").Requireable<number>;
         focusOnOpen: import("prop-types").Requireable<boolean>;
         autoFocus: import("prop-types").Requireable<boolean>;
-        size: import("prop-types").Requireable<"default" | "small" | "large">;
+        size: import("prop-types").Requireable<"small" | "default" | "large">;
         panels: import("prop-types").Requireable<import("prop-types").InferProps<{
             panelHeader: import("prop-types").Requireable<NonNullable<import("prop-types").ReactNodeLike>>;
             panelFooter: import("prop-types").Requireable<NonNullable<import("prop-types").ReactNodeLike>>;

package/lib/cjs/transfer/index.d.ts

@@ -152,6 +152,7 @@ declare class Transfer extends BaseComponent<TransferProps, TransferState> {
     static getDerivedStateFromProps(props: TransferProps, state: TransferState): TransferState;
     get adapter(): TransferAdapter<TransferProps, TransferState>;
     onInputChange(value: string): void;
+    search(value: string): void;
     onSelectOrRemove(item: ResolvedDataItem): void;
     onSortEnd(callbackProps: OnSortEndProps): void;
     renderFilter(locale: Locale['Transfer']): JSX.Element;

package/lib/cjs/transfer/index.js

@@ -155,7 +155,13 @@ class Transfer extends _baseComponent.default {
   }
 
   onInputChange(value) {
-    this.foundation.handleInputChange(value);
+    this.foundation.handleInputChange(value, true);
+  }
+
+  search(value) {
+    // The search method is used to provide the user with a manually triggered search
+    // Since the method is manually called by the user, setting the second parameter to false does not trigger the onSearch callback to notify the user
+    this.foundation.handleInputChange(value, false);
   }
 
   onSelectOrRemove(item) {

package/lib/es/anchor/index.d.ts

@@ -39,7 +39,7 @@ declare class Anchor extends BaseComponent<AnchorProps, AnchorState> {
     static contextType: React.Context<ContextValue>;
     static Link: typeof Link;
     static PropTypes: {
-        size: PropTypes.Requireable<"default" | "small">;
+        size: PropTypes.Requireable<"small" | "default">;
         railTheme: PropTypes.Requireable<"primary" | "tertiary" | "muted">;
         className: PropTypes.Requireable<string>;
         style: PropTypes.Requireable<object>;

package/lib/es/autoComplete/index.d.ts

@@ -123,7 +123,7 @@ declare class AutoComplete<T extends AutoCompleteItems> extends BaseComponent<Au
         renderSelectedItem: PropTypes.Requireable<(...args: any[]) => any>;
         suffix: PropTypes.Requireable<PropTypes.ReactNodeLike>;
         showClear: PropTypes.Requireable<boolean>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         style: PropTypes.Requireable<object>;
         stopPropagation: PropTypes.Requireable<NonNullable<string | boolean>>;
         maxHeight: PropTypes.Requireable<NonNullable<string | number>>;

package/lib/es/button/Button.d.ts

@@ -47,7 +47,7 @@ export default class Button extends PureComponent<ButtonProps> {
         disabled: PropTypes.Requireable<boolean>;
         prefixCls: PropTypes.Requireable<string>;
         style: PropTypes.Requireable<object>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         type: PropTypes.Requireable<"warning" | "primary" | "tertiary" | "secondary" | "danger">;
         block: PropTypes.Requireable<boolean>;
         onClick: PropTypes.Requireable<(...args: any[]) => any>;

package/lib/es/button/buttonGroup.d.ts

@@ -18,7 +18,7 @@ export default class ButtonGroup extends BaseComponent<ButtonGroupProps> {
         children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
         disabled: PropTypes.Requireable<boolean>;
         type: PropTypes.Requireable<string>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         theme: PropTypes.Requireable<"solid" | "light" | "borderless">;
         'aria-label': PropTypes.Requireable<string>;
     };

package/lib/es/button/index.d.ts

@@ -22,7 +22,7 @@ declare class Button extends React.PureComponent<ButtonProps> {
         onMouseEnter: import("prop-types").Requireable<(...args: any[]) => any>;
         onMouseLeave: import("prop-types").Requireable<(...args: any[]) => any>;
         disabled: import("prop-types").Requireable<boolean>;
-        size: import("prop-types").Requireable<"default" | "small" | "large">;
+        size: import("prop-types").Requireable<"small" | "default" | "large">;
         type: import("prop-types").Requireable<"warning" | "primary" | "tertiary" | "secondary" | "danger">;
         block: import("prop-types").Requireable<boolean>;
         onClick: import("prop-types").Requireable<(...args: any[]) => any>;

package/lib/es/datePicker/datePicker.d.ts

@@ -44,7 +44,7 @@ export default class DatePicker extends BaseComponent<DatePickerProps, DatePicke
         'aria-labelledby': PropTypes.Requireable<string>;
         'aria-required': PropTypes.Requireable<boolean>;
         type: PropTypes.Requireable<"dateTime" | "date" | "month" | "dateRange" | "year" | "dateTimeRange">;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         density: PropTypes.Requireable<"default" | "compact">;
         defaultValue: PropTypes.Requireable<NonNullable<string | number | object>>;
         value: PropTypes.Requireable<NonNullable<string | number | object>>;

package/lib/es/form/baseForm.d.ts

@@ -11,7 +11,7 @@ import { BaseFormProps, FormApi } from './interface';
 interface BaseFormState {
     formId: string;
 }
-declare class Form extends BaseComponent<BaseFormProps, BaseFormState> {
+declare class Form<Values extends Record<string, any> = any> extends BaseComponent<BaseFormProps<Values>, BaseFormState> {
     static propTypes: {
         'aria-label': PropTypes.Requireable<string>;
         onSubmit: PropTypes.Requireable<(...args: any[]) => any>;
@@ -128,7 +128,7 @@ declare class Form extends BaseComponent<BaseFormProps, BaseFormState> {
         preventScroll?: boolean;
         showRestTagsPopover?: boolean;
         restTagsPopoverProps?: import("../popover").PopoverProps;
-    } & Pick<import("../tooltip").TooltipProps, "stopPropagation" | "motion" | "getPopupContainer" | "spacing" | "mouseEnterDelay" | "autoAdjustOverflow" | "mouseLeaveDelay"> & React.RefAttributes<any> & import("./interface").CommonFieldProps, import("./interface").CommonexcludeType>> & import("./interface").SelectStatic;
+    } & Pick<import("../tooltip").TooltipProps, "motion" | "stopPropagation" | "getPopupContainer" | "spacing" | "mouseEnterDelay" | "autoAdjustOverflow" | "mouseLeaveDelay"> & React.RefAttributes<any> & import("./interface").CommonFieldProps, import("./interface").CommonexcludeType>> & import("./interface").SelectStatic;
     static Checkbox: React.ComponentType<import("utility-types").Subtract<import("./interface").CommonFieldProps, import("./interface").RadioCheckboxExcludeProps> & import("../checkbox").CheckboxProps & import("./interface").RCIncludeType>;
     static CheckboxGroup: React.ComponentType<import("utility-types").Subtract<import("../checkbox").CheckboxGroupProps, import("./interface").CommonexcludeType> & import("./interface").CommonFieldProps & React.RefAttributes<any>>;
     static Radio: React.ComponentType<import("utility-types").Subtract<import("./interface").CommonFieldProps, import("./interface").RadioCheckboxExcludeProps> & import("../radio").RadioProps & import("./interface").RCIncludeType>;
@@ -148,11 +148,11 @@ declare class Form extends BaseComponent<BaseFormProps, BaseFormState> {
     static InputGroup: typeof FormInputGroup;
     static Label: typeof Label;
     static Section: typeof Section;
-    formApi: FormApi;
-    constructor(props: BaseFormProps);
+    formApi: FormApi<Values>;
+    constructor(props: BaseFormProps<Values>);
     componentDidMount(): void;
     componentWillUnmount(): void;
-    get adapter(): BaseFormAdapter<BaseFormProps, BaseFormState>;
+    get adapter(): BaseFormAdapter<BaseFormProps<Values>, BaseFormState, Values>;
     get content(): React.ReactNode;
     submit(e: React.FormEvent<HTMLFormElement>): void;
     reset(e: React.FormEvent<HTMLFormElement>): void;

package/lib/es/form/errorMessage.d.ts

@@ -1,6 +1,7 @@
 import React, { PureComponent } from 'react';
 import PropTypes from 'prop-types';
-export declare type ReactFieldError = Array<any> | React.ReactNode;
+import type { BasicFieldError } from '@douyinfe/semi-foundation/lib/es/form/interface';
+export declare type ReactFieldError = BasicFieldError | React.ReactNode;
 export interface ErrorMessageProps {
     error?: ReactFieldError;
     className?: string;

package/lib/es/form/field.d.ts

@@ -76,7 +76,7 @@ declare const FormSelect: import("react").ComponentType<import("utility-types").
     preventScroll?: boolean;
     showRestTagsPopover?: boolean;
     restTagsPopoverProps?: import("../popover").PopoverProps;
-} & Pick<import("../tooltip").TooltipProps, "stopPropagation" | "motion" | "getPopupContainer" | "spacing" | "mouseEnterDelay" | "autoAdjustOverflow" | "mouseLeaveDelay"> & import("react").RefAttributes<any> & import("./interface").CommonFieldProps, import("./interface").CommonexcludeType>> & import("./interface").SelectStatic;
+} & Pick<import("../tooltip").TooltipProps, "motion" | "stopPropagation" | "getPopupContainer" | "spacing" | "mouseEnterDelay" | "autoAdjustOverflow" | "mouseLeaveDelay"> & import("react").RefAttributes<any> & import("./interface").CommonFieldProps, import("./interface").CommonexcludeType>> & import("./interface").SelectStatic;
 declare const FormCheckboxGroup: import("react").ComponentType<import("utility-types").Subtract<import("../checkbox/checkboxGroup").CheckboxGroupProps, import("./interface").CommonexcludeType> & import("./interface").CommonFieldProps & import("react").RefAttributes<any>>;
 declare const FormCheckbox: import("react").ComponentType<import("utility-types").Subtract<import("./interface").CommonFieldProps, import("./interface").RadioCheckboxExcludeProps> & import("../checkbox/checkbox").CheckboxProps & import("./interface").RCIncludeType>;
 declare const FormRadioGroup: import("react").ComponentType<import("utility-types").Subtract<import("../radio/radioGroup").RadioGroupProps, import("./interface").CommonexcludeType> & import("./interface").CommonFieldProps & import("react").RefAttributes<any>>;

package/lib/es/form/hooks/useFormState.d.ts

@@ -1,2 +1,3 @@
-declare function useFormState(): import("@douyinfe/semi-foundation/lib/es/form/interface").FormState<any>;
+import { FormState } from '@douyinfe/semi-foundation/lib/es/form/interface';
+declare function useFormState<T extends Record<string, any> = any>(): FormState<T>;
 export default useFormState;

package/lib/es/form/interface.d.ts

@@ -1,16 +1,16 @@
 import * as React from 'react';
 import { Subtract } from 'utility-types';
 import type { RuleItem } from 'async-validator';
-import { Options as scrollIntoViewOptions } from 'scroll-into-view-if-needed';
-import { BaseFormApi as FormApi, FormState, WithFieldOption } from '@douyinfe/semi-foundation/lib/es/form/interface';
-import { SelectProps } from '../select/index';
+import type { Options as scrollIntoViewOptions } from 'scroll-into-view-if-needed';
+import type { BaseFormApi as FormApi, FormState, WithFieldOption, AllErrors } from '@douyinfe/semi-foundation/lib/es/form/interface';
+import type { SelectProps } from '../select/index';
 import Option from '../select/option';
 import OptGroup from '../select/optionGroup';
-import { CheckboxProps } from '../checkbox/index';
-import { RadioProps } from '../radio/index';
+import type { CheckboxProps } from '../checkbox/index';
+import type { RadioProps } from '../radio/index';
 import { ReactFieldError as FieldError } from './errorMessage';
-import { LabelProps } from './label';
-export { FormState, FormApi, WithFieldOption, RuleItem };
+import type { LabelProps } from './label';
+export type { FormState, FormApi, WithFieldOption, RuleItem };
 export declare type CommonFieldProps = {
     /** Field is required (except Form. Checkbox within the Group, Form. Radio) */
     field: string;
@@ -81,19 +81,19 @@ export interface FormFCChild<K extends Record<string, any> = any> {
     values: K;
     formApi: FormApi<K>;
 }
-export interface BaseFormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, 'children' | 'onChange'> {
+export interface BaseFormProps<Values extends Record<string, any> = any> extends Omit<React.FormHTMLAttributes<HTMLFormElement>, 'children' | 'onChange' | 'onSubmit' | 'onReset'> {
     'aria-label'?: React.AriaAttributes['aria-label'];
-    onSubmit?: (values: Record<string, any>) => void;
-    onSubmitFail?: (errors: Record<string, FieldError>, values: any) => void;
+    onSubmit?: (values: Values) => void;
+    onSubmitFail?: (errors: Record<keyof Values, FieldError>, values: Partial<Values>) => void;
     onReset?: () => void;
-    onValueChange?: (values: Record<string, any>, changedValue: Record<string, any>) => void;
-    onChange?: (formState: FormState) => void;
-    validateFields?: (values: Record<string, any>) => string | Record<string, any>;
+    onValueChange?: (values: Values, changedValue: Partial<Values>) => void;
+    onChange?: (formState: FormState<Values>) => void;
+    validateFields?: (values: Values) => string | Partial<AllErrors<Values>>;
     /** Use this if you want to populate the form with initial values. */
-    initValues?: Record<string, any>;
+    initValues?: Values;
     id?: string;
     /** getFormApi will be call once when Form mounted, u can save formApi reference in your component  */
-    getFormApi?: (formApi: FormApi) => void;
+    getFormApi?: (formApi: FormApi<Values>) => void;
     style?: React.CSSProperties;
     className?: string;
     layout?: 'horizontal' | 'vertical';

package/lib/es/image/image.js

@@ -1,4 +1,5 @@
 import _isObject from "lodash/isObject";
+import _isBoolean from "lodash/isBoolean";
 
 /* eslint-disable jsx-a11y/click-events-have-key-events */
 
@@ -131,6 +132,16 @@ export default class Image extends BaseComponent {
       willUpdateStates.loadStatus = "loading";
     }
 
+    if (_isObject(props.preview)) {
+      const {
+        visible
+      } = props.preview;
+
+      if (_isBoolean(visible)) {
+        willUpdateStates.previewVisible = visible;
+      }
+    }
+
     return willUpdateStates;
   }
 

package/lib/es/image/interface.d.ts

@@ -60,7 +60,7 @@ export interface PreviewProps extends BaseProps {
     onPrev?: (index: number) => void;
     onNext?: (index: number) => void;
     onRatioChange?: (type: RatioType) => void;
-    onRotateChange?: (angle: number) => void;
+    onRotateLeft?: (angle: number) => void;
     onDownload?: (src: string, index: number) => void;
 }
 export interface MenuProps {

package/lib/es/image/preview.d.ts

@@ -44,8 +44,8 @@ export default class Preview extends BaseComponent<PreviewProps, PreviewState> {
         onPrev: PropTypes.Requireable<(...args: any[]) => any>;
         onNext: PropTypes.Requireable<(...args: any[]) => any>;
         onDownload: PropTypes.Requireable<(...args: any[]) => any>;
+        onRotateLeft: PropTypes.Requireable<(...args: any[]) => any>;
         onRatioChange: PropTypes.Requireable<(...args: any[]) => any>;
-        onRotateChange: PropTypes.Requireable<(...args: any[]) => any>;
     };
     static defaultProps: {
         src: any[];

package/lib/es/image/preview.js

@@ -220,8 +220,8 @@ Preview.propTypes = {
   onPrev: PropTypes.func,
   onNext: PropTypes.func,
   onDownload: PropTypes.func,
-  onRatioChange: PropTypes.func,
-  onRotateChange: PropTypes.func
+  onRotateLeft: PropTypes.func,
+  onRatioChange: PropTypes.func
 };
 Preview.defaultProps = {
   src: [],

package/lib/es/image/previewImage.d.ts

@@ -13,7 +13,7 @@ export default class PreviewImage extends BaseComponent<PreviewImageProps, Previ
         zoomStep: PropTypes.Requireable<number>;
         zoom: PropTypes.Requireable<number>;
         ratio: PropTypes.Requireable<string>;
-        disableDownload: PropTypes.Requireable<number>;
+        disableDownload: PropTypes.Requireable<boolean>;
         clickZoom: PropTypes.Requireable<number>;
         setRatio: PropTypes.Requireable<(...args: any[]) => any>;
         onZoom: PropTypes.Requireable<(...args: any[]) => any>;

package/lib/es/image/previewImage.js

@@ -223,7 +223,7 @@ PreviewImage.propTypes = {
   zoomStep: PropTypes.number,
   zoom: PropTypes.number,
   ratio: PropTypes.string,
-  disableDownload: PropTypes.number,
+  disableDownload: PropTypes.bool,
   clickZoom: PropTypes.number,
   setRatio: PropTypes.func,
   onZoom: PropTypes.func,

package/lib/es/image/previewInner.d.ts

@@ -45,7 +45,7 @@ export default class PreviewInner extends BaseComponent<PreviewInnerProps, Previ
         onNext: PropTypes.Requireable<(...args: any[]) => any>;
         onDownload: PropTypes.Requireable<(...args: any[]) => any>;
         onRatioChange: PropTypes.Requireable<(...args: any[]) => any>;
-        onRotateChange: PropTypes.Requireable<(...args: any[]) => any>;
+        onRotateLeft: PropTypes.Requireable<(...args: any[]) => any>;
     };
     static defaultProps: {
         showTooltip: boolean;

package/lib/es/image/previewInner.js

@@ -105,11 +105,19 @@ export default class PreviewInner extends BaseComponent {
   get adapter() {
     return Object.assign(Object.assign({}, super.adapter), {
       getIsInGroup: () => this.isInGroup(),
-      notifyChange: index => {
+      notifyChange: (index, direction) => {
         const {
-          onChange
+          onChange,
+          onPrev,
+          onNext
         } = this.props;
         _isFunction(onChange) && onChange(index);
+
+        if (direction === "prev") {
+          onPrev && onPrev(index);
+        } else {
+          onNext && onNext(index);
+        }
       },
       notifyZoom: (zoom, increase) => {
         const {
@@ -143,9 +151,9 @@ export default class PreviewInner extends BaseComponent {
       },
       notifyRotateChange: angle => {
         const {
-          onRotateChange
+          onRotateLeft
         } = this.props;
-        _isFunction(onRotateChange) && onRotateChange(angle);
+        _isFunction(onRotateLeft) && onRotateLeft(angle);
       },
       notifyDownload: (src, index) => {
         const {
@@ -403,7 +411,7 @@ PreviewInner.propTypes = {
   onNext: PropTypes.func,
   onDownload: PropTypes.func,
   onRatioChange: PropTypes.func,
-  onRotateChange: PropTypes.func
+  onRotateLeft: PropTypes.func
 };
 PreviewInner.defaultProps = {
   showTooltip: false,

package/lib/es/input/index.d.ts

@@ -82,7 +82,7 @@ declare class Input extends BaseComponent<InputProps, InputState> {
         showClear: PropTypes.Requireable<boolean>;
         hideSuffix: PropTypes.Requireable<boolean>;
         placeholder: PropTypes.Requireable<any>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         className: PropTypes.Requireable<string>;
         style: PropTypes.Requireable<object>;
         validateStatus: PropTypes.Requireable<"default" | "error" | "warning" | "success">;

package/lib/es/input/inputGroup.d.ts

@@ -21,7 +21,7 @@ export default class inputGroup extends BaseComponent<InputGroupProps, InputGrou
     static propTypes: {
         className: PropTypes.Requireable<string>;
         children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         style: PropTypes.Requireable<object>;
         onBlur: PropTypes.Requireable<(...args: any[]) => any>;
         onFocus: PropTypes.Requireable<(...args: any[]) => any>;

package/lib/es/locale/source/tr_TR.js

@@ -80,8 +80,8 @@ const local = {
       Wed: 'Çar',
       Thu: 'Perş',
       Fri: 'Cum',
-      Sat: 'Oturdu',
-      Sun: 'Güneş'
+      Sat: 'Cmt',
+      Sun: 'Paz'
     },
     localeFormatToken: {
       FORMAT_SWITCH_DATE: 'yyyy-MM-dd'

package/lib/es/navigation/Item.d.ts

@@ -12,6 +12,7 @@ export interface NavItemProps extends ItemProps, BaseProps {
     level?: number;
     link?: string;
     linkOptions?: React.AnchorHTMLAttributes<HTMLAnchorElement>;
+    tabIndex?: number;
     text?: React.ReactNode;
     tooltipHideDelay?: number;
     tooltipShowDelay?: number;
@@ -45,6 +46,7 @@ export default class NavItem extends BaseComponent<NavItemProps, NavItemState> {
         link: PropTypes.Requireable<string>;
         linkOptions: PropTypes.Requireable<object>;
         disabled: PropTypes.Requireable<boolean>;
+        tabIndex: PropTypes.Requireable<number>;
     };
     static defaultProps: {
         isSubNav: boolean;
@@ -55,6 +57,7 @@ export default class NavItem extends BaseComponent<NavItemProps, NavItemState> {
         onMouseEnter: (...args: any[]) => void;
         onMouseLeave: (...args: any[]) => void;
         disabled: boolean;
+        tabIndex: number;
     };
     foundation: ItemFoundation;
     context: NavContextType;
@@ -66,5 +69,5 @@ export default class NavItem extends BaseComponent<NavItemProps, NavItemState> {
     wrapTooltip: (node: React.ReactNode) => JSX.Element;
     handleClick: (e: React.MouseEvent) => void;
     handleKeyPress: (e: React.KeyboardEvent) => void;
-    render(): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+    render(): React.ReactNode;
 }

package/lib/es/navigation/Item.js

@@ -148,7 +148,8 @@ export default class NavItem extends BaseComponent {
       link,
       linkOptions,
       disabled,
-      level = 0
+      level = 0,
+      tabIndex
     } = this.props;
     const {
       mode,
@@ -211,7 +212,8 @@ export default class NavItem extends BaseComponent {
         ["".concat(clsPrefix, "-sub")]: isSubNav,
         ["".concat(clsPrefix, "-selected")]: selected && !isSubNav,
         ["".concat(clsPrefix, "-collapsed")]: isCollapsed,
-        ["".concat(clsPrefix, "-disabled")]: disabled
+        ["".concat(clsPrefix, "-disabled")]: disabled,
+        ["".concat(clsPrefix, "-has-link")]: typeof link === 'string'
       });
       const ariaProps = {
         'aria-disabled': disabled
@@ -228,7 +230,7 @@ export default class NavItem extends BaseComponent {
       React.createElement("li", Object.assign({
         // if role = menuitem, the narration will read all expanded li
         role: isSubNav ? null : "menuitem",
-        tabIndex: isSubNav ? -1 : 0
+        tabIndex: isSubNav ? -1 : tabIndex
       }, ariaProps, {
         style: style,
         ref: this.setItemRef,
@@ -245,6 +247,15 @@ export default class NavItem extends BaseComponent {
       itemDom = this.wrapTooltip(itemDom);
     }
 
+    if (typeof this.context.renderWrapper === 'function') {
+      return this.context.renderWrapper({
+        itemElement: itemDom,
+        isSubNav: isSubNav,
+        isInSubNav: isInSubNav,
+        props: this.props
+      });
+    }
+
     return itemDom;
   }
 
@@ -267,7 +278,8 @@ NavItem.propTypes = {
   isSubNav: PropTypes.bool,
   link: PropTypes.string,
   linkOptions: PropTypes.object,
-  disabled: PropTypes.bool
+  disabled: PropTypes.bool,
+  tabIndex: PropTypes.number
 };
 NavItem.defaultProps = {
   isSubNav: false,
@@ -277,5 +289,6 @@ NavItem.defaultProps = {
   onClick: _noop,
   onMouseEnter: _noop,
   onMouseLeave: _noop,
-  disabled: false
+  disabled: false,
+  tabIndex: 0
 };

package/lib/es/navigation/index.d.ts

@@ -1,5 +1,5 @@
 import BaseComponent, { BaseProps } from '../_base/baseComponent';
-import React from 'react';
+import React, { ReactElement, ReactNode } from 'react';
 import PropTypes from 'prop-types';
 import { NavigationAdapter } from '@douyinfe/semi-foundation/lib/es/navigation/foundation';
 import SubNav, { SubNavProps } from './SubNav';
@@ -63,6 +63,12 @@ export interface NavProps extends BaseProps {
         isOpen: boolean;
     }) => void;
     onSelect?: (data: OnSelectedData) => void;
+    renderWrapper?: ({ itemElement, isSubNav, isInSubNav, props }: {
+        itemElement: ReactElement;
+        isInSubNav: boolean;
+        isSubNav: boolean;
+        props: NavItemProps | SubNavProps;
+    }) => ReactNode;
 }
 export interface NavState {
     isCollapsed: boolean;

package/lib/es/navigation/index.js

@@ -205,7 +205,8 @@ class Nav extends BaseComponent {
       footer,
       header,
       toggleIconPosition,
-      limitIndent
+      limitIndent,
+      renderWrapper
     } = this.props;
     const {
       selectedKeys,
@@ -310,7 +311,8 @@ class Nav extends BaseComponent {
         locale,
         prefixCls,
         toggleIconPosition,
-        limitIndent
+        limitIndent,
+        renderWrapper
       }
     }, /*#__PURE__*/React.createElement("div", {
       className: finalCls,

package/lib/es/navigation/nav-context.d.ts

@@ -18,6 +18,7 @@ export interface NavContextType {
     subNavCloseDelay?: NavProps['subNavCloseDelay'];
     subNavOpenDelay?: NavProps['subNavOpenDelay'];
     canUpdateOpenKeys?: boolean;
+    renderWrapper?: NavProps['renderWrapper'];
 }
 declare const NavContext: React.Context<NavContextType>;
 export default NavContext;

package/lib/es/rating/index.d.ts

@@ -69,7 +69,7 @@ export default class Rating extends BaseComponent<RatingProps, RatingState> {
         onBlur: PropTypes.Requireable<(...args: any[]) => any>;
         onKeyDown: PropTypes.Requireable<(...args: any[]) => any>;
         autoFocus: PropTypes.Requireable<boolean>;
-        size: PropTypes.Requireable<NonNullable<number | "default" | "small">>;
+        size: PropTypes.Requireable<NonNullable<number | "small" | "default">>;
         tooltips: PropTypes.Requireable<string[]>;
         id: PropTypes.Requireable<string>;
         preventScroll: PropTypes.Requireable<boolean>;

package/lib/es/rating/item.d.ts

@@ -40,7 +40,7 @@ export default class Item extends BaseComponent<RatingItemProps, RatingItemState
         disabled: PropTypes.Requireable<boolean>;
         count: PropTypes.Requireable<number>;
         ariaLabelPrefix: PropTypes.Requireable<string>;
-        size: PropTypes.Requireable<NonNullable<number | "default" | "small">>;
+        size: PropTypes.Requireable<NonNullable<number | "small" | "default">>;
         'aria-describedby': PropTypes.Requireable<string>;
         onFocus: PropTypes.Requireable<(...args: any[]) => any>;
         onBlur: PropTypes.Requireable<(...args: any[]) => any>;

package/lib/es/switch/index.d.ts

@@ -45,7 +45,7 @@ declare class Switch extends BaseComponent<SwitchProps, SwitchState> {
         onMouseEnter: PropTypes.Requireable<(...args: any[]) => any>;
         onMouseLeave: PropTypes.Requireable<(...args: any[]) => any>;
         style: PropTypes.Requireable<object>;
-        size: PropTypes.Requireable<"default" | "small" | "large">;
+        size: PropTypes.Requireable<"small" | "default" | "large">;
         uncheckedText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
         id: PropTypes.Requireable<string>;
     };