@flatbiz/antd 4.2.85 → 4.2.87

package/index.d.ts

@@ -6,7 +6,7 @@ import { API, ModelType } from '@dimjs/model';
 import { PlainObject } from '@dimjs/utils';
 import { DateFormatType, TAny, TNoopDefine, TPlainObject } from '@flatbiz/utils';
 import { IAllProps } from '@tinymce/tinymce-react';
-import { ButtonProps, CascaderProps, CheckboxProps, CollapseProps, ColorPickerProps, DrawerProps, DropdownProps, FormInstance, FormItemProps, FormListFieldData, FormListOperation, InputNumberProps, InputProps, ModalProps, PaginationProps, PopconfirmProps, PopoverProps, RadioGroupProps, RowProps, SelectProps, SpaceProps, SwitchProps, TableProps, TabsProps, TagProps, TimePickerProps, TimeRangePickerProps, TooltipProps, TreeProps, TreeSelectProps, UploadProps } from 'antd';
+import { ButtonProps, CardProps, CascaderProps, CheckboxProps, CollapseProps, ColorPickerProps, DrawerProps, DropdownProps, FormInstance, FormItemProps, FormListFieldData, FormListOperation, InputNumberProps, InputProps, ModalProps, PaginationProps, PopconfirmProps, PopoverProps, RadioGroupProps, RowProps, SelectProps, SpaceProps, SwitchProps, TableProps, TabsProps, TagProps, TimePickerProps, TimeRangePickerProps, TooltipProps, TreeProps, TreeSelectProps, UploadProps } from 'antd';
 import { ConfigProviderProps } from 'antd/es/config-provider';
 import { PickerDateProps, RangePickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { FormListProps } from 'antd/es/form';
@@ -73,8 +73,21 @@ export type ButtonWrapperProps = Omit<ButtonProps, "onClick"> & {
  * @returns
  */
 export declare const ButtonWrapper: (props: ButtonWrapperProps) => import("react/jsx-runtime").JSX.Element | null;
+export type FormItemNamePath = string | number | Array<string | number>;
+export type TLocale = "en" | "zh-cn";
+export type TFbaLocale = {
+	TreeWrapper?: {
+		/** 数据加载异常默认文案 */
+		requestError?: string;
+	};
+	FbaDialogModal?: {
+		cancelText?: string;
+	};
+};
 export type ConfigProviderWrapperProps = Omit<ConfigProviderProps, "locale"> & {
-	locale?: "en" | "zh-cn";
+	locale?: TLocale;
+	/** 自定义国际化数据 */
+	customLocaleMessage?: Partial<TFbaLocale>;
 };
 export declare const ConfigProviderWrapper: (props: ConfigProviderWrapperProps) => import("react/jsx-runtime").JSX.Element;
 export type DialogModalProps = Omit<ModalProps, "onOk" | "onCancel" | "getContainer" | "open" | "open" | "okButtonProps" | "cancelButtonProps"> & {
@@ -99,33 +112,16 @@ export type DialogModalProps = Omit<ModalProps, "onOk" | "onCancel" | "getContai
 	titleExtra?: ReactElement;
 };
 /**
- * 函数式调用弹框；初始化后，内容无法更新
- *```
- * 1. 基础使用方式
- * dialogModal.open({
- *   title: '我是弹框',
- *   content: <div>我是内容</div>,
- * });
- * ```
- * ```
- * ***************************
- * 2. 结合内置form使用，可在onOK、onCancel获取form对象
- * dialogModal.open({
- *   title: '我是弹框',
- *   content: (form, operate) => {
- *     return (
- *       <Form form={form}>
- *         <Form.Item name="useName">
- *           <Input placeholder="请输入" />
- *         </Form.Item>
- *       </Form>
- *     );
- *   },
- *   onOK: (form) => {
- *     console.log('content form数据', form.getFieldsValue());
- *     return Promise.resolve();
- *   },
- * });
+ *
+ * @deprecated 已过期
+ * ```
+ * 1. 为什么过期
+ *    dialogModal.open 打开的内容无法适配兼容自定义主题、无法适配兼容旧版浏览器、无法兼容国际化
+ *    适配兼容旧版浏览器（https://ant-design.antgroup.com/docs/react/compatible-style-cn）
+ * 2. 请使用
+ * const { appDialogModal } = FbaApp.useDialogModal();
+ * appDialogModal.open({})
+ *
  * ```
  */
 export declare const dialogModal: {
@@ -217,6 +213,14 @@ export declare const ButtonOperateItemContent: (props: Pick<ButtonOperateItem, "
  * ```
  */
 export declare const ButtonOperate: FC<ButtonOperateProps>;
+/**
+ * ```
+ * 主要为了解决，标题固定，内容滚动
+ * ```
+ * @param props
+ * @returns
+ */
+export declare const CardWrapper: (props: CardProps) => import("react/jsx-runtime").JSX.Element;
 export type TRequestStatus = "request-init" | "request-progress" | "request-success" | "request-error" | "no-dependencies-params";
 export type TRequestStatusProps = {
 	status?: TRequestStatus;
@@ -365,7 +369,7 @@ export interface DrawerActionsParamType {
  * drawer弹窗模型
  * @param key 唯一值必传
  * @returns
- * @deprecated 废弃 DrawerWrapper 4.3.0版本移除， 请使用 dialogDrawer
+ * @deprecated 废弃 DrawerWrapper 4.3.0版本移除， 请使用 const { appDialogModal } = FbaApp.useDialogModal();
  */
 export declare const createDrawerWrapperModel: (key: string) => API<ModelType<DrawerStateType, DrawerActionsParamType, any>>;
 export interface ModalStateType {
@@ -389,7 +393,7 @@ export interface ModalActionsParamType {
 /**
  * modal弹窗模型
  * @param key 唯一值必传
- * @deprecated 废弃 ModalWrapper 4.3.0版本移除，请使用 dialogModal
+ * @deprecated 废弃 ModalWrapper 4.3.0版本移除，请使用 const { appDialogModal } = FbaApp.useDialogModal();
  */
 export declare const createModalWrapperModel: (key: string) => API<ModelType<ModalStateType, ModalActionsParamType, any>>;
 export type CssHoverProps = {
@@ -503,7 +507,6 @@ export type DateRangePickerWrapperProps = Omit<RangePickerDateProps<TAny>, "valu
  * ```
  */
 export declare const DateRangePickerWrapper: (props: DateRangePickerWrapperProps) => import("react/jsx-runtime").JSX.Element;
-export type FormItemNamePath = string | number | Array<string | number>;
 export type DateRangePickerWrapperFormItemProps = Omit<FormItemProps, "name"> & {
 	/**
 	 * 开始的时间name
@@ -530,11 +533,33 @@ export declare const DateRangePickerWrapperFormItem: (props: DateRangePickerWrap
 export type DialogAlertProps = Omit<DialogModalProps, "onOk" | "cancelHidden" | "cancelButtonProps" | "onCancel" | "onClick"> & {
 	onClick?: (e: React.MouseEvent<HTMLElement>) => void | Promise<void>;
 };
+/**
+ * @deprecated 已过期
+ * ```
+ * 1. 为什么过期
+ *    dialogAlert.open 打开的内容无法配兼自定义主题、无法适配兼容旧版浏览器、无法兼容国际化
+ *    适配兼容旧版浏览器（https://ant-design.antgroup.com/docs/react/compatible-style-cn）
+ * 2. 请使用
+ * const { appDialogModal } = FbaApp.useDialogModal();
+ * appDialogModal.open({})
+ * ```
+ */
 export declare const dialogAlert: {
 	open: (props: DialogAlertProps) => {
 		close: () => void;
 	};
 };
+/**
+ * @deprecated 已过期
+ * ```
+ * 1. 为什么过期
+ *    dialogConfirm.open 打开的内容无法配兼自定义主题、无法适配兼容旧版浏览器、无法兼容国际化
+ *    适配兼容旧版浏览器（https://ant-design.antgroup.com/docs/react/compatible-style-cn）
+ * 2. 请使用
+ * const { appDialogModal } = FbaApp.useDialogModal();
+ * appDialogModal.open({})
+ * ```
+ */
 export declare const dialogConfirm: {
 	open: (props: DialogModalProps) => {
 		close: () => void;
@@ -558,36 +583,16 @@ export type DialogDrawerProps = Omit<DrawerProps, "onOk" | "onCancel" | "getCont
 	extra?: ReactNode | ((form: FormInstance) => ReactElement);
 };
 /**
- * 函数式调用弹框；初始化后，内容无法更新
- *```
- * 1. 基础使用方式
- * dialogDrawer.open({
- *   title: '我是标题',
- *   content: <div>我是内容</div>,
- * });
- * ```
- * ```
- * ***************************
- * 2. 结合内置form使用，可在onOK、onCancel获取form对象
- * dialogDrawer.open({
- *   title: '我是标题',
- *   content: (form, operate) => {
- *     return (
- *       <Form form={form}>
- *         <Form.Item name="useName">
- *           <Input placeholder="请输入" />
- *         </Form.Item>
- *       </Form>
- *     );
- *   },
- *   onOk: (form) => {
- *     console.log('content form数据', form.getFieldsValue());
- *     return Promise.resolve();
- *   },
- * });
  *
- * 注意：
- * 1.  设置operateRender后，需要自定义操作按钮，onOk、onCancel、okText、cancelText、okButtonExtraProps、cancelButtonExtraProps配置失效
+ * @deprecated 已过期
+ * ```
+ * 1. 为什么过期
+ *    dialogConfirm.open 打开的内容无法配兼自定义主题、无法适配兼容旧版浏览器、无法兼容国际化
+ *    适配兼容旧版浏览器（https://ant-design.antgroup.com/docs/react/compatible-style-cn）
+ * 2. 请使用
+ * const { appDialogModal } = FbaApp.useDialogModal();
+ * appDialogModal.open({})
+ *
  * ```
  */
 export declare const dialogDrawer: {
@@ -629,6 +634,19 @@ export type DialogLoadingProps = {
 	message?: string;
 	mask?: boolean;
 };
+/**
+ *
+ * @deprecated 已过期
+ * ```
+ * 1. 为什么过期
+ *    dialogLoading.open 打开的内容无法配兼自定义主题、无法适配兼容旧版浏览器、无法兼容国际化
+ *    适配兼容旧版浏览器（https://ant-design.antgroup.com/docs/react/compatible-style-cn）
+ * 2. 请使用
+ * const { appDialogModal } = FbaApp.useDialogModal();
+ * appDialogModal.open({})
+ *
+ * ```
+ */
 export declare const dialogLoading: {
 	open: (props?: DialogLoadingProps) => {
 		close: () => void;
@@ -871,7 +889,7 @@ declare const DrawerWrapperContent: (props: {
 declare const DrawerWrapperFooter: (props: any) => import("react/jsx-runtime").JSX.Element;
 /**
  * 弹窗机制
- * @deprecated 已过时 4.3.0版本移除；请使用 dialogDrawer.open
+ * @deprecated 已过时 4.3.0版本移除；请使用 const { appDialogModal } = FbaApp.useDialogModal();
  * ```
  * 1. 默认 destroyOnClose = true
  * 2. 默认 forceRender = false
@@ -1300,15 +1318,17 @@ export type SelectorWrapperProps = Omit<SelectProps, "onSearch" | "notFoundConte
 	/**
 	 * 参数Key映射
 	 * ```
-	 * 1. list 为 onRequest 返回数据中列表key值，可多级取值，例如： 'a.b.c'
-	 * 2. 配置 serviceConfig.onRequestResultAdapter后，fieldNames.list配置失效
+	 * 1. 默认值：value=value、label=label、disabled=disabled
+	 * 2. list 为 onRequest 返回数据中列表key值，可多级取值，例如： 'a.b.c'
+	 * 3. 配置 serviceConfig.onRequestResultAdapter后，fieldNames.list配置失效
+	 * 4. 如果没有配置list，可说明接口返回为数组
 	 * ```
 	 */
 	fieldNames?: {
-		label: string;
-		value: string;
-		disabled?: string;
 		list?: string;
+		label?: string;
+		value?: string;
+		disabled?: string;
 	};
 	/**
 	 * 请求服务需求的数据
@@ -1339,7 +1359,10 @@ export type SelectorWrapperProps = Omit<SelectProps, "onSearch" | "notFoundConte
 	 * 2. 可配置label、value
 	 * ```
 	 */
-	showAllOption?: true | TPlainObject<string | number>;
+	showAllOption?: true | {
+		label: string;
+		value: string | number;
+	};
 	onLabelRenderAdapter?: (dataItem: TPlainObject) => string | ReactElement;
 	onChange?: (value?: SelectorWrapperValue, selectedList?: TPlainObject[] | TPlainObject) => void;
 	showIcon?: boolean;
@@ -1373,6 +1396,37 @@ export type SelectorWrapperProps = Omit<SelectProps, "onSearch" | "notFoundConte
  * ```
  */
 export declare const SelectorWrapper: (props: SelectorWrapperProps) => import("react/jsx-runtime").JSX.Element;
+export type SwitchWrapperValue = string | number | boolean;
+export type SwitchWrapperProps = Omit<SwitchProps, "checked" | "defaultChecked" | "onChange"> & {
+	value?: SwitchWrapperValue;
+	checkedValue: SwitchWrapperValue;
+	unCheckedValue: SwitchWrapperValue;
+	onChange?: (value: SwitchWrapperValue) => void;
+	tooltipProps?: Omit<TooltipProps, "title">;
+	tooltipTitle?: string | ((value?: SwitchWrapperValue) => string | undefined);
+	serviceConfig?: {
+		onRequest: (value: SwitchWrapperValue) => TAny;
+		message?: {
+			success?: string;
+			defaultError?: string;
+		};
+	};
+};
+/**
+ * 解决Switch只能接收boolean的限制，与Form.Item结合使用最佳
+ * ```
+ * 1. value 为状态值，不局限于boolean，可以为 [string | number | boolean]
+ * 2. checkedValue 选中值
+ * 3. unCheckedValue 未选中值
+ * 4. 与 Form.Item 结合使用，不再需要配置 valuePropName
+ *     <Form.Item name="fieldName">
+ *       <SwitchWrapper checkedValue={2} unCheckedValue={1} />
+ *     </Form.Item>
+ * 5. 可设置tooltip效果数据显示
+ * 6. 可设置 serviceConfig 配置服务调用交互
+ * ```
+ */
+export declare const SwitchWrapper: (props: SwitchWrapperProps) => import("react/jsx-runtime").JSX.Element;
 export type UploadWrapperFileItem = {
 	uid: string;
 	name: string;
@@ -1464,6 +1518,10 @@ export type EditableFileUploadConfig = {
 	type: "uploadWrapper";
 	editableComptProps: UploadWrapperProps;
 };
+export type EditableSwitchWrapperConfig = {
+	type: "switchWrapper";
+	editableComptProps: SwitchWrapperProps;
+};
 /**
  * 自定义编辑组件
  * ```
@@ -1490,7 +1548,7 @@ export type EditableCustomConfig = {
 		tableRowIndex: number;
 	}) => ReactElement;
 };
-export type EditableTypeConfig = EditableCustomConfig | EditableInputConfig | EditableSelectWrapperConfig | EditableDatePickerWrapperConfig | EditableDateRangePickerWrapperConfig | EditableCheckboxGroupConfig | EditableTextareaConfig | EditableInputNumberConfig | EditableRadioGroupConfig | EditableFileUploadConfig;
+export type EditableTypeConfig = EditableCustomConfig | EditableInputConfig | EditableSelectWrapperConfig | EditableDatePickerWrapperConfig | EditableDateRangePickerWrapperConfig | EditableCheckboxGroupConfig | EditableTextareaConfig | EditableInputNumberConfig | EditableRadioGroupConfig | EditableFileUploadConfig | EditableSwitchWrapperConfig;
 export type FieldSingleConfig = {
 	editable?: boolean | ((data: {
 		tableRowIndex: number;
@@ -1692,6 +1750,7 @@ export type FbaAppModalProps = Omit<ModalProps, "onOk" | "onCancel" | "getContai
 	 * ```
 	 */
 	bodyHeightPercent?: number;
+	titleExtra?: ReactElement;
 };
 export type FbaAppAlertProps = Omit<FbaAppModalProps, "onOk" | "cancelHidden" | "cancelButtonProps" | "onCancel" | "onClick"> & {
 	onClick?: (e: React.MouseEvent<HTMLElement>) => void | Promise<void>;
@@ -1767,6 +1826,7 @@ export declare const fbaHooks: {
 		S,
 		import("react").Dispatch<import("react").SetStateAction<S>>
 	];
+	useMemoCustom: <T_1>(fn: () => T_1, deps?: import("react").DependencyList | undefined) => T_1;
 };
 declare function attachPropertiesToComponent<C, P extends Record<string, unknown>>(component: C, properties: P): C & P;
 export declare const fbaUtils: {
@@ -1816,21 +1876,21 @@ export type FileSelectProps = {
 export declare const FileSelect: (props: FileSelectProps) => import("react/jsx-runtime").JSX.Element;
 export type FlexLayoutProps = {
 	className?: string;
-	fullIndex?: number | number[];
+	/** 子组件铺满的索引值，从0开始 */
+	fullIndex: number | number[];
+	/**方向，默认值vertical */
 	direction?: "vertical" | "horizontal";
 	onClick?: () => void;
 	style?: CSSProperties;
+	/** 间隙尺寸 */
 	gap?: number;
 	children?: ReactNode | null | Array<ReactNode | null>;
 };
 /**
- * flex布局
- * 1. direction：默认值vertical
- * 2. gap间隙距离
- * 3. fullIndex：指定children数组索引值对象flex=1
- * 4. 为children添加key属性
- * @param props
- * @returns
+ * flex布局，主要用于Flex结构性布局
+ * ```
+ * 4.2.87版本中将fullIndex改为了必填属性，如果在升级中遇到问题，不确定怎么写，可设置 fullIndex=[] 保持原样
+ * ```
  */
 export declare const FlexLayout: (props: FlexLayoutProps) => import("react/jsx-runtime").JSX.Element;
 export type FormColProps = {
@@ -2100,14 +2160,14 @@ export type InputWrapperProps = Omit<InputProps, "defaultValue"> & {
 export declare const InputWrapper: (props: InputWrapperProps) => import("react/jsx-runtime").JSX.Element;
 export type LabelValueLayoutProps = {
 	options: {
-		key?: string | number;
 		label: string | ReactElement;
-		value?: string | number | ReactElement;
+		value?: string | number | ReactElement | null;
 		span?: number;
 		hidden?: boolean;
 	}[];
 	labelWidth?: number | "auto";
 	column?: number;
+	/** 添加边框 */
 	bordered?: boolean;
 	className?: string;
 	style?: CSSProperties;
@@ -2118,7 +2178,7 @@ export type LabelValueLayoutProps = {
  */
 export declare const LabelValueLayout: (props: LabelValueLayoutProps) => import("react/jsx-runtime").JSX.Element;
 export type LocalLoadingServiceConfig = {
-	onRequest: (params?: TAny) => Promise<TPlainObject>;
+	onRequest: (params?: TAny) => Promise<TAny>;
 	params?: TPlainObject;
 	/** 标记serviceConfig.params中无效参数，被设置的params key 不传入服务接口入参  */
 	invalidParamKey?: string[];
@@ -2398,6 +2458,8 @@ export interface RichTextEditorProps extends Omit<IAllProps, "onChange" | "init"
 		/** 工具栏添加；自定义toolbar后失效  */
 		toolbar_append?: string;
 	};
+	/** 点击全屏按钮回调 */
+	onFullScreenChange?: (state?: boolean) => void;
 }
 /**
  * 富文本编辑器，配置参考tinymce https://www.tiny.cloud/docs/tinymce/6
@@ -2617,6 +2679,9 @@ export type SimpleLayoutProps = {
 	style?: CSSProperties;
 	title?: string | ReactElement;
 	desc?: string | ReactElement | string[] | ReactElement[];
+	/**
+	 * @deprecated 已过期，请使用form className 属性 preDefinedClassName.form.xxx
+	 */
 	formLabelAlign?: "left" | "right";
 	/**
 	 * layoutType 布局类型
@@ -2750,37 +2815,6 @@ export type SwitchConfirmWrapperProps = Omit<SwitchProps, "defaultChecked" | "on
  * ```
  */
 export declare const SwitchConfirmWrapper: (props: SwitchConfirmWrapperProps) => import("react/jsx-runtime").JSX.Element;
-export type SwitchWrapperValue = string | number | boolean;
-export type SwitchWrapperProps = Omit<SwitchProps, "checked" | "defaultChecked" | "onChange"> & {
-	value?: SwitchWrapperValue;
-	checkedValue: SwitchWrapperValue;
-	unCheckedValue: SwitchWrapperValue;
-	onChange?: (value: SwitchWrapperValue) => void;
-	tooltipProps?: Omit<TooltipProps, "title">;
-	tooltipTitle?: string | ((value?: SwitchWrapperValue) => string | undefined);
-	serviceConfig?: {
-		onRequest: (value: SwitchWrapperValue) => TAny;
-		message?: {
-			success?: string;
-			defaultError?: string;
-		};
-	};
-};
-/**
- * 解决Switch只能接收boolean的限制，与Form.Item结合使用最佳
- * ```
- * 1. value 为状态值，不局限于boolean，可以为 [string | number | boolean]
- * 2. checkedValue 选中值
- * 3. unCheckedValue 未选中值
- * 4. 与 Form.Item 结合使用，不再需要配置 valuePropName
- *     <Form.Item name="fieldName">
- *       <SwitchWrapper checkedValue={2} unCheckedValue={1} />
- *     </Form.Item>
- * 5. 可设置tooltip效果数据显示
- * 6. 可设置 serviceConfig 配置服务调用交互
- * ```
- */
-export declare const SwitchWrapper: (props: SwitchWrapperProps) => import("react/jsx-runtime").JSX.Element;
 export type TagListSelectValue = string | number | boolean;
 export type TagListSelectDataItem = {
 	label: string;
@@ -2791,7 +2825,7 @@ export type TagListSelectProps = {
 	dataList: TagListSelectDataItem[];
 	/** 颜色配置数据，例如：{ 1:'red', 2: 'blue'} key值与 dataList中value相同 */
 	colorMap?: Record<string | number, string>;
-	value?: TagListSelectValue;
+	value?: TagListSelectValue | TagListSelectValue[];
 	/** 是否强制匹配，默认值false */
 	forceMatch?: boolean;
 };
@@ -2911,9 +2945,11 @@ export declare const tableCellRender: {
 	 * render: (value) => {
 	 *   return tableCellRender.selectorCell([{ label: '已开启', value: 1 ])(value)
 	 * }
+	 *
+	 * 其中value值可以是单个值或者数组；例如：'1' 或者 ['1', '2']
 	 * ```
 	 */
-	selectorCell: (selectorList: TagListSelectProps["dataList"], colorMap?: TagListSelectProps["colorMap"]) => (value: string | number) => import("react/jsx-runtime").JSX.Element;
+	selectorCell: (selectorList: TagListSelectProps["dataList"], colorMap?: TagListSelectProps["colorMap"]) => (value?: TAny) => import("react/jsx-runtime").JSX.Element | null;
 	/**
 	 * 单元格对象数据处理，支持多级处理
 	 * ```
@@ -2963,7 +2999,7 @@ export declare const tableCellRender: {
 		label: string;
 		value: TagListSelectValue;
 		color?: string;
-	}[], colorMap?: Record<string | string, string>) => (value: string | number) => string | number | import("react/jsx-runtime").JSX.Element;
+	}[], colorMap?: Record<string | string, string>) => (value?: TAny) => any;
 };
 export type TableScrollProps = {
 	children: React.ReactNode;
@@ -3055,13 +3091,21 @@ export type TagWrapperProps = Omit<TagProps, "onClick"> & {
  */
 export declare const TagWrapper: (props: TagWrapperProps) => import("react/jsx-runtime").JSX.Element;
 export type CssTextEllipsisProps = {
-	text?: string;
-	width: number;
+	text: string;
+	width?: number;
+	/** 隐藏tips */
+	hideTips?: boolean;
 };
 /**
- * 根据配置宽度显示数据，内容超过宽度截取，并在尾部添加...，被截取的添加Tooltip显示完整数据
- * @param props
- * @returns
+ * 内容超过宽度截取，并在尾部添加...，被截取的添加Tooltip显示完整数据
+ * ```
+ * 1. 如果配置 width，则使用文本长度与width进行比较
+ * 2. 如果没有配置 width，则使用文本长度与当前节点父节点宽度进行比较
+ *
+ * 注意：
+ * 1. 当前节点父节点可能需要添加 overflow-x: hidden;
+ * 2. 如果父节点设置flex-shrink会有影响，可复写flex-shrink: initial;
+ * ```
  */
 export declare const TextCssEllipsis: (props: CssTextEllipsisProps) => import("react/jsx-runtime").JSX.Element;
 export type TextOverflowRenderProps = {
@@ -3260,7 +3304,17 @@ export type TreeSelectorWrapperProps = Omit<TreeSelectProps, "treeExpandedKeys"
 	 */
 	onChange?: (selectedValue?: TreeSelectorWrapperValue, selectedData?: TPlainObject[] | TPlainObject, triggerInfo?: TPlainObject) => void;
 	/**
-	 * tree item 数据适配器
+	 * tree item 数据适配器，返回的数据会通过fieldNames配置取数据
+	 * ```
+	 * 1. 可用于设置disabled状态
+	 * onTreeItemDataAdapter: (dataItem) => {
+	 *   if(dataItem.xx === xx){
+	 *     dataItem['disabled] = true;
+	 *   }
+	 *   return dataItem;
+	 * }
+	 * 2. 可设置label数据显示
+	 * ```
 	 */
 	onTreeItemDataAdapter?: (dataItem: TPlainObject) => TPlainObject;
 	/** 自定义异常提示文案 */
@@ -3330,11 +3384,25 @@ export type TreeWrapperMenuItem = {
 	icon?: ReactElement;
 };
 export type TreeWrapperProps = Omit<TreeProps, "treeData" | "onExpand" | "selectedKeys" | "checkedKeys" | "onCheck" | "onSelect" | "fieldNames" | "multiple" | "loadData" | "icon" | "defaultCheckedKeys" | "defaultExpandParent" | "defaultSelectedKeys"> & {
+	/** 唯一值，用于缓存数据 */
 	modelKey: string;
+	/**
+	 * 字段映射
+	 * ```
+	 * 默认值：
+	 * label = 'label'
+	 * value = 'value'
+	 * children = 'children'
+	 *
+	 * 如果未设置list，则说明接口返回数据为数组
+	 * 如果返回数据存在多级，可通过设置 list='a.b.list'
+	 * ```
+	 */
 	fieldNames?: {
 		label?: string;
 		value?: string;
 		children?: string;
+		list?: string;
 	};
 	/**
 	 * useEffect依赖项数组，用于重新发起获取接口数据
@@ -3348,7 +3416,13 @@ export type TreeWrapperProps = Omit<TreeProps, "treeData" | "onExpand" | "select
 	 * 是否开启异步加载
 	 */
 	loadDataFlag?: boolean;
-	/** 异步加载数据配置 */
+	/**
+	 * 异步加载数据配置
+	 * ```
+	 * 1. 会通过fieldNames配置label、value、children进行转义
+	 * 2. fieldNames.list 配置在此处无效
+	 * ```
+	 */
 	loadDataServiceConfig?: TreeLoadDataServiceConfig;
 	/**
 	 * 当设置selectorTreeList后，serviceConfig将失效
@@ -3418,10 +3492,14 @@ export type TreeWrapperProps = Omit<TreeProps, "treeData" | "onExpand" | "select
 	icon?: (data: {
 		isParent: boolean;
 		isLeaf: boolean;
+		[key: string]: TAny;
 	}) => ReactElement;
 	/**
 	 * 是否必选，最后一个不能取消
 	 */
+	/**
+	 * 状态文案配置
+	 */
 	requestMessageConfig?: TRequestStatusProps["messageConfig"];
 	/**
 	 * value格式
@@ -3433,9 +3511,16 @@ export type TreeWrapperProps = Omit<TreeProps, "treeData" | "onExpand" | "select
 	 * ```
 	 */
 	value?: TreeWrapperValue;
+	/**
+	 * 选择的节点数据，是否包含label信息
+	 * ```
+	 * 默认选择的节点只有value数据
+	 * ```
+	 */
 	labelInValue?: boolean;
 	/**
 	 * ```
+	 * @deprecated 废弃
 	 * lableInValue = true，onChange输出数据字段名称，默认：{ label: string; value: string|number }
 	 * ```
 	 */
@@ -3515,6 +3600,7 @@ export declare const TreeWrapper: import("react").ForwardRefExoticComponent<Omit
 		label?: string | undefined;
 		value?: string | undefined;
 		children?: string | undefined;
+		list?: string | undefined;
 	} | undefined;
 	effectDependencyList?: import("react").DependencyList | undefined;
 	serviceConfig?: {
@@ -3548,6 +3634,7 @@ export declare const TreeWrapper: import("react").ForwardRefExoticComponent<Omit
 	searchPlaceholder?: string | undefined;
 	searchStyle?: import("react").CSSProperties | undefined;
 	icon?: ((data: {
+		[key: string]: any;
 		isParent: boolean;
 		isLeaf: boolean;
 	}) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>>) | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flatbiz/antd",
-  "version": "4.2.85",
+  "version": "4.2.87",
   "description": "flat-biz ui components",
   "main": "index.js",
   "typings": "index.d.ts",
@@ -31,7 +31,7 @@
     "@dimjs/model": ">=1.2.1",
     "@dimjs/model-react": ">=1.2.1",
     "@dimjs/utils": ">=1.4.4",
-    "@flatbiz/utils": ">=4.0.16",
+    "@flatbiz/utils": ">=4.0.17",
     "@wove/react": ">=1.2.23",
     "antd": ">=5.5.1",
     "dayjs": ">=1.11.9",
@@ -62,7 +62,8 @@
     "@dnd-kit/core": "^6.0.8",
     "@dnd-kit/modifiers": "^6.0.1",
     "@dnd-kit/sortable": "^7.0.2",
-    "@dnd-kit/utilities": "^3.2.1"
+    "@dnd-kit/utilities": "^3.2.1",
+    "use-intl": "3.0.0-rc.6"
   },
   "gitHead": "4378d433b73ee28fd7cb4c64bed8571f993eb5a9"
 }