@zat-design/sisyphus-react 4.5.0 → 4.5.2

package/es/ProForm/hooks/useWatch.js

@@ -1,8 +1,8 @@
+import _cloneDeep from "lodash/cloneDeep";
+import _isEqual from "lodash/isEqual";
 import _debounce from "lodash/debounce";
 import warning from 'rc-util/lib/warning';
 import { useState, useEffect, useRef, useMemo } from 'react';
-import isEqual from 'lodash/isEqual';
-import cloneDeep from 'lodash/cloneDeep';
 import { toArray } from "../utils";
 
 // 从一个对象或Form值中获取特定路径的值
@@ -79,10 +79,8 @@ const useWatchWarning = process.env.NODE_ENV !== 'production' ? dependencies =>
 function useWatch(dependencies, form, wait) {
   const isSelector = typeof dependencies === 'function';
 
-  // selector 模式跳过依赖字符串化警告（函数引用每次都不同，无法稳定比较）
-  if (!isSelector) {
-    useWatchWarning(dependencies);
-  }
+  // 无条件调用，内部按 isSelector 决定是否真正执行警告逻辑，保证 Hook 顺序稳定
+  useWatchWarning(dependencies);
 
   // 获取表单实例
   const formInstance = form;
@@ -134,8 +132,8 @@ function useWatch(dependencies, form, wait) {
     if (wait) {
       return _debounce(value => {
         // 只在值真正变化时才更新状态
-        if (!isEqual(prevStateRef.current, value)) {
-          prevStateRef.current = cloneDeep(value);
+        if (!_isEqual(prevStateRef.current, value)) {
+          prevStateRef.current = _cloneDeep(value);
           setState(value);
         }
       }, wait);
@@ -143,8 +141,8 @@ function useWatch(dependencies, form, wait) {
 
     // 非防抖版本
     return value => {
-      if (!isEqual(prevStateRef.current, value)) {
-        prevStateRef.current = cloneDeep(value);
+      if (!_isEqual(prevStateRef.current, value)) {
+        prevStateRef.current = _cloneDeep(value);
         setState(value);
       }
     };

package/es/ProLayout/components/ProHeader/index.js

@@ -18,6 +18,15 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 const {
   formatAmount
 } = tools;
+const toKeyPart = value => {
+  if (value == null || value === '') return undefined;
+  if (typeof value === 'string' || typeof value === 'number') return String(value);
+  return undefined;
+};
+const getDescribeColumnKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.value) ?? `describe-${index}`;
+const getDescribeValueKey = (item, parentKey, index) => toKeyPart(item.link) ?? toKeyPart(item.value) ?? `${parentKey}-value-${index}`;
+const getTagKey = (tagItem, parentKey, index) => toKeyPart(tagItem) ?? `${parentKey}-tag-${index}`;
+const getSubDescribeKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.code) ?? `sub-describe-${index}`;
 const ProHeader = props => {
   const {
     breadcrumbColumns,
@@ -93,6 +102,7 @@ const ProHeader = props => {
           items = [],
           width
         } = item;
+        const describeItemKey = getDescribeColumnKey(item, index);
         // show为false直接隐藏¸
         if (show === false || !show) {
           return null;
@@ -102,11 +112,11 @@ const ProHeader = props => {
           if (Array.isArray(params?.tag) && params?.tag.length) {
             return /*#__PURE__*/_jsx(Space, {
               size: 4,
-              children: params.tag.map((tagItem, index) => {
+              children: params.tag.map((tagItem, tagIndex) => {
                 return /*#__PURE__*/_jsx("div", {
                   className: "pro-header-tag",
                   children: tagItem
-                }, index);
+                }, getTagKey(tagItem, describeItemKey, tagIndex));
               })
             });
           }
@@ -145,10 +155,10 @@ const ProHeader = props => {
               'pro-header-describe-items': true,
               'pro-header-describe-items-more': items.length >= 2
             }),
-            children: [items?.length > 3 ? `共${items?.length}个，` : null, items.map((item, index) => {
+            children: [items?.length > 3 ? `共${items?.length}个，` : null, items.map((item, itemIndex) => {
               return /*#__PURE__*/_jsxs("span", {
-                children: [valueRender(item), items?.length !== index + 1 ? ' 、' : null]
-              }, index);
+                children: [valueRender(item), items?.length !== itemIndex + 1 ? ' 、' : null]
+              }, getDescribeValueKey(item, describeItemKey, itemIndex));
             }), itemsHidden ? /*#__PURE__*/_jsx("span", {
               className: "pro-header-describe-items-omit",
               children: "..."
@@ -156,11 +166,11 @@ const ProHeader = props => {
           });
           if (itemsHidden) {
             const tipResult = /*#__PURE__*/_jsx(_Fragment, {
-              children: items.map((item, index) => {
+              children: items.map((item, itemIndex) => {
                 return /*#__PURE__*/_jsx("p", {
                   className: "pro-header-describe-items-tip-value",
                   children: valueRender(item)
-                }, index);
+                }, getDescribeValueKey(item, describeItemKey, itemIndex));
               })
             });
             return /*#__PURE__*/_jsx(Tooltip, {
@@ -200,7 +210,7 @@ const ProHeader = props => {
               })
             })]
           })
-        }, index);
+        }, describeItemKey);
       })
     });
   };
@@ -269,10 +279,11 @@ const ProHeader = props => {
           orientation: "vertical"
         }),
         children: actionRender.map((item, index) => {
+          const actionKey = ( /*#__PURE__*/React.isValidElement(item) && item.key != null ? String(item.key) : undefined) ?? toKeyPart(item?.type) ?? `action-${index}`;
           if (_isFunction(item?.type)) {
             return /*#__PURE__*/_jsx("div", {
               children: item
-            }, index);
+            }, actionKey);
           }
           // 判断第一层dom节点为空
           if (item?.type && !item?.props?.children) {
@@ -280,7 +291,7 @@ const ProHeader = props => {
           }
           return /*#__PURE__*/_jsx("div", {
             children: item
-          }, index);
+          }, actionKey);
         })
       });
     }
@@ -303,15 +314,16 @@ const ProHeader = props => {
         show = true,
         tag
       } = item;
+      const breadcrumbItemKey = toKeyPart(value) ?? `breadcrumb-${index}`;
       const tagRender = () => {
         if (Array.isArray(tag) && tag.length) {
           return /*#__PURE__*/_jsx(Space, {
             size: 8,
-            children: tag.map((tagItem, index) => {
+            children: tag.map((tagItem, tagIndex) => {
               return /*#__PURE__*/_jsx("div", {
                 className: "pro-header-tag",
                 children: tagItem
-              }, index);
+              }, getTagKey(tagItem, breadcrumbItemKey, tagIndex));
             })
           });
         }
@@ -330,7 +342,7 @@ const ProHeader = props => {
         return null;
       }
       return {
-        key: index,
+        key: breadcrumbItemKey,
         title: /*#__PURE__*/_jsxs(Space, {
           size: 4,
           children: [value, " ", tagRender()]
@@ -362,6 +374,7 @@ const ProHeader = props => {
           width,
           tag
         } = item;
+        const infoItemKey = (type && toKeyPart(value) ? `${type}-${toKeyPart(value)}` : undefined) ?? toKeyPart(value) ?? `info-${index}`;
         // show或者值不存在为false直接隐藏¸
         if (!show || !value) {
           return '';
@@ -419,7 +432,7 @@ const ProHeader = props => {
             hidden: ['version', 'tag'].includes(type) && !val
           }),
           children: type === 'copy' ? valueRender('copy') : valueRender()
-        }, index);
+        }, infoItemKey);
       })
     });
   };
@@ -513,7 +526,7 @@ const ProHeader = props => {
           children: _subDescribeColumns.map((item, index) => {
             return /*#__PURE__*/_jsx("li", {
               children: subDescribeRender(item)
-            }, index);
+            }, getSubDescribeKey(item, index));
           })
         }), /*#__PURE__*/_jsx("div", {
           className: "pro-header-fold",

package/es/ProSelect/index.js

@@ -1,6 +1,5 @@
 import _isNumber from "lodash/isNumber";
 import _omit from "lodash/omit";
-import _isString from "lodash/isString";
 import _isObject from "lodash/isObject";
 import _isFunction from "lodash/isFunction";
 import { useDeepCompareEffect, useRequest as useRequestFunc } from 'ahooks';
@@ -11,22 +10,8 @@ import Container from "../ProForm/components/Container";
 import AdaptiveTooltip from "./components/AdaptiveTooltip";
 import { ProForm } from '..';
 import locale from "../locale";
-import { getSelectList } from "./utils";
-
-/** 将 selectList（扁平或分组）转为扁平选项列表，用于查找、回显、defaultOne */
+import { getSelectList, flattenOptions, findValueObject, defaultFilterOption as defaultFilterOptionFn, getInnerRecord, buildSelectOptions, resolveChangeOption, computeChangeValue, computeTransformValue } from "./utils";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-function flattenOptions(list) {
-  if (!Array.isArray(list) || !list.length) return [];
-  const out = [];
-  list.forEach(item => {
-    if (Array.isArray(item.options)) {
-      out.push(...item.options);
-    } else {
-      out.push(item);
-    }
-  });
-  return out;
-}
 export const ProSelect = (props, ref) => {
   const {
     fieldNames: proSelectFieldNames = {},
@@ -122,18 +107,10 @@ export const ProSelect = (props, ref) => {
     fetchFunctionRef.current = fetchFunction;
   }, [fetchFunction]);
   const cacheList = useRequest?.options?.cacheKey ? successTransformDataHandle(fetchFunction?.data) : [];
-  const flatOptions = flattenOptions(selectList);
-  const getValueObject = input => {
-    if (Array.isArray(input) && input.length) {
-      const resArr = [];
-      input.forEach(i => {
-        const res = flatOptions.find(item => item[code] === i);
-        if (res) resArr.push(res);
-      });
-      return resArr;
-    }
-    return flatOptions.find(item => item[code] === input);
-  };
+
+  // 展平结果仅随 selectList 变化；滚动重挂载/无关 rerender 时复用，避免重复展平
+  const flatOptions = useMemo(() => flattenOptions(selectList), [selectList]);
+  const getValueObject = input => findValueObject(flatOptions, code, input);
   useImperativeHandle(ref, () => ({
     getValueObject,
     useRequestRef: fetchFunction
@@ -203,53 +180,29 @@ export const ProSelect = (props, ref) => {
     if (!flatOptions.length) {
       return viewEmpty;
     }
-    const labelList = value.map(v => {
-      const option = flatOptions.find(item => {
-        if (labelInValue) {
-          return item[code] === v[code];
-        }
-        return item[code] === v;
-      });
-      if (option) {
-        return selectProps.showCodeName ? `${option[code]}-${option[label]}` : option?.[label];
-      }
-      return '-';
-    });
-    const record = value.map(v => {
-      return flatOptions.find(item => {
-        if (labelInValue) {
-          return item[code] === v[code];
-        }
-        return item[code] === v;
-      });
-    }).filter(v => !!v);
+    const findOption = v => flatOptions.find(item => labelInValue ? item[code] === v[code] : item[code] === v);
+    const record = value.map(findOption).filter(v => !!v);
 
-    // 自定义option时，默认取optionRender的值
-    const _optionRender = () => {
-      if (!record.length) {
-        return viewEmpty;
-      }
-      const arr = [];
-      record.forEach(item => {
-        arr.push(props.optionRender(item));
-      });
+    // 自定义 option 时，默认取 optionRender 的值
+    if (_isFunction(props.optionRender) && record.length) {
       return /*#__PURE__*/_jsx(Space, {
         orientation: "vertical",
         size: 4,
-        children: arr.map(item => /*#__PURE__*/_jsx(React.Fragment, {
-          children: item
-        }, item))
+        children: record.map(item => /*#__PURE__*/_jsx(React.Fragment, {
+          children: props.optionRender(item)
+        }, item[code]))
       });
-    };
-    return _isFunction(props.optionRender) && record.length ? _optionRender() : labelList?.join('、');
+    }
+    const labelList = value.map(v => {
+      const option = findOption(v);
+      if (!option) return '-';
+      return selectProps.showCodeName ? `${option[code]}-${option[label]}` : option?.[label];
+    });
+    return labelList?.join('、');
   };
 
   // 必须在早期 return 之前声明，确保每次渲染 hooks 调用数量一致（React Rules of Hooks）
-  const defaultFilterOption = useCallback((input, option) => {
-    if (option?.value == null) return false;
-    const optionLabel = option?.searchText ?? option?.title ?? option?.label;
-    return String(optionLabel ?? '').toLowerCase().includes(input.toLowerCase());
-  }, []);
+  const defaultFilterOption = useCallback(defaultFilterOptionFn, []);
   const mergedShowSearch = useMemo(() => {
     const defaultConfig = {
       enabled: true,
@@ -283,6 +236,29 @@ export const ProSelect = (props, ref) => {
     }
     return defaultConfig;
   }, [_onSearch, defaultFilterOption, selectProps.showSearch]);
+  let newSelectList = selectList;
+  if (otherProps?.listName && filterInList) {
+    newSelectList = getSelectList({
+      otherProps,
+      value,
+      dataSource: selectList,
+      labelInValue,
+      fieldNames,
+      mode: selectProps.mode
+    });
+  }
+
+  // antd Select 的 options 仅随数据源/字段映射/展示配置变化；滚动重挂载与无关 rerender 时复用，
+  // 避免每次渲染全量重建 option 对象（落在虚拟表格挂载热路径上）。
+  // 依赖用 buildSelectOptions 实际消费的原始值（code/label/showCodeName/OptionRender），
+  // 而非每次新建的函数引用，避免缓存失效。
+  // 必须在 isView 早期 return 之前声明，确保每次渲染 hooks 调用数量一致（React Rules of Hooks）。
+  const selectOptions = useMemo(() => buildSelectOptions(newSelectList, {
+    code,
+    label,
+    showCodeName: selectProps.showCodeName,
+    optionRender: OptionRender
+  }), [newSelectList, code, label, selectProps.showCodeName, OptionRender]);
   if (isView || props.isView) {
     if (Array.isArray(value)) {
       // 如果设置了maxTagCount且超出数量，需要截断显示
@@ -337,32 +313,6 @@ export const ProSelect = (props, ref) => {
     return props.children;
   };
   const isReactElement = element => /*#__PURE__*/isValidElement(element);
-  const getInnerRecord = option => {
-    if (!option) return undefined;
-    if (option.record) return option.record;
-    if (option.data?.record) return option.data.record;
-    return undefined;
-  };
-  const getOptionText = item => {
-    if (OptionRender) {
-      const rendered = OptionRender(item);
-      return _isString(rendered) ? rendered : String(item[label] ?? '');
-    }
-    const text = selectProps.showCodeName ? `${item[code]}-${item[label]}` : item[label];
-    return _isString(text) ? text : String(text ?? '');
-  };
-  const buildOptionItem = (item, index) => {
-    const text = getOptionText(item);
-    return {
-      key: item[code] != null ? `${item[code]}-${index}` : `option-${index}`,
-      label: text,
-      value: item[code] != null ? item[code] : undefined,
-      disabled: !!item.disabled,
-      title: text,
-      searchText: text,
-      record: item
-    };
-  };
   const selectOptionRender = option => {
     const currentRecord = option?.data?.record || option?.record;
     const text = option?.data?.searchText ?? option?.data?.title ?? option?.label ?? '';
@@ -381,93 +331,42 @@ export const ProSelect = (props, ref) => {
       })
     });
   };
-  const handleChange = (value, _option) => {
-    // option/其第一层子节点是react节点且是labelInValue就拿record
-    let option = _option;
-    if (labelInValue && (isReactElement(_option) || isReactElement(_option?.children))) {
-      option = getInnerRecord(_option);
-    }
-    if (selectProps.mode && selectProps.mode === 'multiple') {
-      if (Array.isArray(option)) {
-        option.forEach(item => {
-          const currentRecord = getInnerRecord(item);
-          if (currentRecord) {
-            Object.assign(item, currentRecord);
-          }
-          delete item.record;
-          delete item.children;
-        });
-      }
-      if (labelInValue) {
-        onChange?.(getChangeValue ? getChangeValue(getValueObject(value)) : getValueObject(value), option);
-      } else {
-        onChange?.(getChangeValue ? getChangeValue(value) : value, option);
-      }
-    } else if (!selectProps.mode && labelInValue) {
-      onChange(getChangeValue ? getChangeValue(getValueObject(value)) : getValueObject(value), option);
-    } else {
-      onChange?.(getChangeValue ? getChangeValue(value) : value, getInnerRecord(_option));
-    }
-  };
-
-  /**
-   * 处理 labelInValue 模式下值的回填
-   * @returns
-   */
-  const transformValue = () => {
-    if (labelInValue && !selectProps.mode) {
-      if (!_isObject(value)) {
-        return undefined;
-      }
-      return value?.[code] || value?.value;
-    }
-    if (labelInValue && selectProps.mode) {
-      // 对传入的值做一些基础判断
-      if (!Array.isArray(value)) {
-        return [];
-      }
-      return value.map(item => item?.[code]);
-    }
-    // Handling Jialuo's Extreme Demands
-    if (selectProps.mode && value === null) {
-      return undefined;
-    }
-    // 只有当 dataSource 只有一个值时才默认回填（只返回值，不进行状态更新）
-    if (defaultOne && !value && !isDefaultOne && selectList?.length === 1) {
-      const option = flatOptions[0];
-      // selectList 可能是异步回来的值
-      if (option) {
-        return option?.[code];
-      }
-    }
-    // 修复空字符placeholder不显示
-    if (value === '') {
-      return undefined;
+  const mode = selectProps.mode;
+  const handleChange = (value, rawOption) => {
+    // 仅多选、或单选 labelInValue 需要加工 option；其余直接取原始节点上的 record
+    if (mode !== 'multiple' && !(labelInValue && !mode)) {
+      onChange?.(computeChangeValue(value, {
+        mode,
+        getChangeValue,
+        flatOptions,
+        code
+      }), getInnerRecord(rawOption));
+      return;
     }
-    return value;
-  };
-  let newSelectList = selectList;
-  if (otherProps?.listName && filterInList) {
-    newSelectList = getSelectList({
-      otherProps,
-      value,
-      dataSource: selectList,
-      labelInValue,
-      fieldNames,
-      mode: selectProps.mode
+    // labelInValue 下，option/其首层子节点是 React 节点时取挂载的 record
+    const isReactNode = labelInValue && (isReactElement(rawOption) || isReactElement(rawOption?.children));
+    const option = resolveChangeOption(rawOption, {
+      mode,
+      isReactNode
     });
-  }
-  const selectOptions = Array.isArray(newSelectList) ? newSelectList.map((item, index) => {
-    const groupOptions = item.options;
-    if (Array.isArray(groupOptions)) {
-      return {
-        key: item[label] ?? `group-${index}`,
-        label: item[label],
-        options: groupOptions.map((opt, optIndex) => buildOptionItem(opt, optIndex))
-      };
-    }
-    return buildOptionItem(item, index);
-  }) : [];
+    onChange?.(computeChangeValue(value, {
+      labelInValue,
+      mode,
+      getChangeValue,
+      flatOptions,
+      code
+    }), option);
+  };
+  const transformValue = () => computeTransformValue({
+    value,
+    labelInValue,
+    mode,
+    defaultOne,
+    isDefaultOne,
+    selectList,
+    flatOptions,
+    code
+  });
   return /*#__PURE__*/_jsx("div", {
     style: props.style,
     className: "pro-select",

package/es/ProSelect/utils/index.js

@@ -1,4 +1,6 @@
 import _difference from "lodash/difference";
+import _isString from "lodash/isString";
+import _isObject from "lodash/isObject";
 import _isNumber from "lodash/isNumber";
 /* eslint-disable no-restricted-syntax */
 /**
@@ -109,4 +111,176 @@ export const getSelectList = ({
     fieldNames,
     mode
   });
+};
+
+/** 将 selectList（扁平或分组）转为扁平选项列表，用于查找、回显、defaultOne */
+export const flattenOptions = list => {
+  if (!Array.isArray(list) || !list.length) return [];
+  const out = [];
+  list.forEach(item => {
+    if (Array.isArray(item.options)) {
+      out.push(...item.options);
+    } else {
+      out.push(item);
+    }
+  });
+  return out;
+};
+
+/**
+ * 根据 code 在扁平选项中查找对应的数据对象
+ * @param flatOptions 扁平选项列表
+ * @param code 值字段名
+ * @param input 单个值或值数组
+ */
+export const findValueObject = (flatOptions, code, input) => {
+  if (Array.isArray(input) && input.length) {
+    return input.map(i => flatOptions.find(item => item[code] === i)).filter(item => !!item);
+  }
+  return flatOptions.find(item => item[code] === input);
+};
+
+/** 默认搜索过滤：在 searchText/title/label 中做大小写不敏感的包含匹配 */
+export const defaultFilterOption = (input, option) => {
+  if (option?.value == null) return false;
+  const optionLabel = option?.searchText ?? option?.title ?? option?.label;
+  return String(optionLabel ?? '').toLowerCase().includes(input.toLowerCase());
+};
+
+/** 取选项上挂载的原始 record（兼容 option.record / option.data.record） */
+export const getInnerRecord = option => {
+  if (!option) return undefined;
+  if (option.record) return option.record;
+  if (option.data?.record) return option.data.record;
+  return undefined;
+};
+
+/**
+ * 计算单个选项的展示文本
+ * @param optionRender 自定义渲染函数，返回字符串时直接使用
+ * @param showCodeName 是否以 code-label 形式展示
+ */
+export const getOptionText = ({
+  item,
+  optionRender,
+  showCodeName,
+  code,
+  label
+}) => {
+  if (optionRender) {
+    const rendered = optionRender(item);
+    return _isString(rendered) ? rendered : String(item[label] ?? '');
+  }
+  const text = showCodeName ? `${item[code]}-${item[label]}` : item[label];
+  return _isString(text) ? text : String(text ?? '');
+};
+
+/** 构建单个 antd Select option 对象 */
+export const buildOptionItem = (item, index, config) => {
+  const text = getOptionText({
+    item,
+    ...config
+  });
+  return {
+    key: item[config.code] != null ? `${item[config.code]}-${index}` : `option-${index}`,
+    label: text,
+    value: item[config.code] != null ? item[config.code] : undefined,
+    disabled: !!item.disabled,
+    title: text,
+    searchText: text,
+    record: item
+  };
+};
+
+/**
+ * 构建 antd Select 的 options（支持分组）
+ * @param list 当前数据源（可能含 options 分组项）
+ */
+export const buildSelectOptions = (list, config) => {
+  if (!Array.isArray(list)) {
+    return [];
+  }
+  return list.map((item, index) => {
+    const groupOptions = item.options;
+    if (Array.isArray(groupOptions)) {
+      return {
+        key: item[config.label] ?? `group-${index}`,
+        label: item[config.label],
+        options: groupOptions.map((opt, optIndex) => buildOptionItem(opt, optIndex, config))
+      };
+    }
+    return buildOptionItem(item, index, config);
+  });
+};
+
+/**
+ * labelInValue 模式下解析 onChange 回调拿到的 option：
+ * 多选模式下将 record 合并进每项并清理临时字段，单选直接透传
+ */
+export const resolveChangeOption = (rawOption, {
+  mode,
+  isReactNode
+}) => {
+  let option = rawOption;
+  if (isReactNode) {
+    option = getInnerRecord(rawOption);
+  }
+  if (mode === 'multiple' && Array.isArray(option)) {
+    option.forEach(item => {
+      const currentRecord = getInnerRecord(item);
+      if (currentRecord) {
+        Object.assign(item, currentRecord);
+      }
+      delete item.record;
+      delete item.children;
+    });
+  }
+  return option;
+};
+
+/**
+ * 计算 onChange 第一个参数（值）：根据 labelInValue/getChangeValue 决定透传原始值还是值对象
+ */
+export const computeChangeValue = (value, {
+  labelInValue,
+  mode,
+  getChangeValue,
+  flatOptions,
+  code
+}) => {
+  const useValueObject = labelInValue && (mode === 'multiple' || !mode);
+  const resolved = useValueObject ? findValueObject(flatOptions, code, value) : value;
+  return getChangeValue ? getChangeValue(resolved) : resolved;
+};
+
+/**
+ * 处理 labelInValue 模式及 defaultOne 下值的回填（只返回值，不触发状态更新）
+ */
+export const computeTransformValue = ({
+  value,
+  labelInValue,
+  mode,
+  defaultOne,
+  isDefaultOne,
+  selectList,
+  flatOptions,
+  code
+}) => {
+  if (labelInValue && !mode) {
+    if (!_isObject(value)) return undefined;
+    return value?.[code] || value?.value;
+  }
+  if (labelInValue && mode) {
+    if (!Array.isArray(value)) return [];
+    return value.map(item => item?.[code]);
+  }
+  // 兼容多选下显式传 null 的极端场景
+  if (mode && value === null) return undefined;
+  // 仅当 dataSource 只有一项时默认回填
+  if (defaultOne && !value && !isDefaultOne && selectList?.length === 1) {
+    return flatOptions[0]?.[code];
+  }
+  // 修复空字符 placeholder 不显示
+  if (value === '') return undefined;
+  return value;
 };