@dckj-npm/dc-material 0.1.378 → 0.1.379

package/es/components/custom-form/custom-form.d.ts

@@ -111,6 +111,13 @@ export interface SubmitMappingItem {
     /** 模板字符串（同 computedFields 格式，与 field 二选一），如 "{package_name},{guest_count}人" */
     template?: string;
 }
+/** rename 模式：单条字段重命名规则 */
+export interface FieldRenameItem {
+    /** 表单字段名（源） */
+    fromField: string;
+    /** API 参数名（目标） */
+    toField: string;
+}
 /**
  * 操作按钮配置项（阶段四新增）
  * 表单底部可配置多个按钮，每个按钮均可独立设置操作类型与数据源。
@@ -138,15 +145,28 @@ export interface OperationItem {
     buttonProps?: Record<string, any>;
 }
 /**
- * 提交映射配置（阶段二）
- * 配置后，提交时自动将指定字段组装为 { columnName, columnValue }[] 格式并写入 finalValues。
- * 消灭手写 onSubmitClick 中的 itemList 拼接逻辑。
+ * 提交参数配置（阶段五扩展）
+ *
+ * 三种工作模式（mode）：
+ * - 'passthrough'：直接将 finalValues 作为请求参数，无需任何配置（字段名与 API 参数名相同时使用）。
+ * - 'rename'：按 fieldRenameMap 规则重命名指定字段，未列出的字段保持原名透传；
+ *             适合字段名与 API 参数名不一致的标准 REST 接口。
+ * - 'itemList'：将字段转换为动态表单格式 [{columnName, columnValue}]，
+ *              适合 /source/api/dynamicFormTableRecord/ 等动态表单接口。
+ *
+ * 向后兼容：未设置 mode 时，若 items 不为空则自动识别为 'itemList' 模式，否则等同于 'passthrough'。
  */
 export interface SubmitMapping {
-    /** 写入 finalValues 的目标字段名，默认 'itemList' */
+    /**
+     * 参数构建模式，默认 'passthrough'（无 items 时）或 'itemList'（有 items 时，向后兼容）。
+     */
+    mode?: 'passthrough' | 'rename' | 'itemList';
+    /** rename 模式：字段重命名规则列表，未列出的字段按原名透传 */
+    fieldRenameMap?: FieldRenameItem[];
+    /** itemList 模式：组装结果写入 finalValues 的目标字段名，默认 'itemList' */
     targetField?: string;
-    /** 映射规则数组 */
-    items: SubmitMappingItem[];
+    /** itemList 模式：字段映射规则 */
+    items?: SubmitMappingItem[];
 }
 export interface CustomFormProps extends Omit<FormProps, 'onSubmit' | 'onChange'> {
     columns?: number;

package/es/components/custom-form/custom-form.js

@@ -10,7 +10,8 @@ import _Select from "@alifd/next/es/select";
 import _Input from "@alifd/next/es/input";
 import _ResponsiveGrid from "@alifd/next/es/responsive-grid";
 import _Form from "@alifd/next/es/form";
-var _excluded = ["columns", "spacing", "emptyContent", "formItems", "initialValues", "computedFields", "fieldLinkage", "submitMapping", "fullWidth", "showSubmit", "submitText", "submitValidate", "submitDataSource", "submitButtonProps", "showReset", "resetText", "resetButtonProps", "operations", "operationAlign", "onSubmit", "onSubmitFailed", "onChange", "onReset", "children", "labelAlign", "labelCol", "size"];
+var _excluded = ["format", "showTime"],
+  _excluded2 = ["columns", "spacing", "emptyContent", "formItems", "initialValues", "computedFields", "fieldLinkage", "submitMapping", "fullWidth", "showSubmit", "submitText", "submitValidate", "submitDataSource", "submitButtonProps", "showReset", "resetText", "resetButtonProps", "operations", "operationAlign", "onSubmit", "onSubmitFailed", "onChange", "onReset", "children", "labelAlign", "labelCol", "size"];
 /**
  * CustomForm v0.5
  * 阶段一新增能力：
@@ -88,15 +89,24 @@ var UploadAny = _Upload;
 
 /** 提交映射 item（阶段二） */
 
+/** rename 模式：单条字段重命名规则 */
+
 /**
  * 操作按钮配置项（阶段四新增）
  * 表单底部可配置多个按钮，每个按钮均可独立设置操作类型与数据源。
  */
 
 /**
- * 提交映射配置（阶段二）
- * 配置后，提交时自动将指定字段组装为 { columnName, columnValue }[] 格式并写入 finalValues。
- * 消灭手写 onSubmitClick 中的 itemList 拼接逻辑。
+ * 提交参数配置（阶段五扩展）
+ *
+ * 三种工作模式（mode）：
+ * - 'passthrough'：直接将 finalValues 作为请求参数，无需任何配置（字段名与 API 参数名相同时使用）。
+ * - 'rename'：按 fieldRenameMap 规则重命名指定字段，未列出的字段保持原名透传；
+ *             适合字段名与 API 参数名不一致的标准 REST 接口。
+ * - 'itemList'：将字段转换为动态表单格式 [{columnName, columnValue}]，
+ *              适合 /source/api/dynamicFormTableRecord/ 等动态表单接口。
+ *
+ * 向后兼容：未设置 mode 时，若 items 不为空则自动识别为 'itemList' 模式，否则等同于 'passthrough'。
  */
 
 // ─── 工具：模板字符串渲染 ─────────────────────────────────────────────────────
@@ -166,6 +176,13 @@ var runSubmitDataSource = function runSubmitDataSource(submitDataSource, values,
     submitDataSource(values, errors, field);
     return;
   }
+  // lowcode-engine 数据源对象（this.dataSourceMap.xxx）使用 .load(params) 触发请求。
+  // params 会与数据源静态 options.params 合并覆盖；
+  // 若 submitMapping 已配置，values 中包含 itemList，可直接覆盖接口默认参数。
+  if (typeof (submitDataSource === null || submitDataSource === void 0 ? void 0 : submitDataSource.load) === 'function') {
+    submitDataSource.load(values);
+    return;
+  }
   if (typeof (submitDataSource === null || submitDataSource === void 0 ? void 0 : submitDataSource.run) === 'function') {
     submitDataSource.run(values, errors, field);
     return;
@@ -205,13 +222,29 @@ var renderFormItemComponent = function renderFormItemComponent(item) {
     case 'NumberPicker':
       return /*#__PURE__*/React.createElement(NumberPickerAny, componentProps);
     case 'DatePicker':
-      return /*#__PURE__*/React.createElement(DatePickerAny, componentProps);
-    case 'DateTimePicker':
-      // 日期时间选择器：showTime 开启，格式化为 YYYY-MM-DD HH:mm
       return /*#__PURE__*/React.createElement(DatePickerAny, _extends({
-        showTime: true,
-        format: "YYYY-MM-DD HH:mm"
+        format: "YYYY-MM-DD"
       }, componentProps));
+    case 'DateTimePicker':
+      {
+        // 将 format / showTime 从 componentProps 中单独析构，防止 spread 覆盖我们的计算值
+        var cpFormat = componentProps.format,
+          _ignoredShowTime = componentProps.showTime,
+          restCp = _objectWithoutPropertiesLoose(componentProps, _excluded);
+        var dtFmt = cpFormat || 'YYYY-MM-DD HH:mm:ss';
+        // 提取日期部分（空格前）和时间部分（空格后）
+        // @alifd/next DatePicker 会将 format（日期）与 showTime.format（时间）拼接显示
+        // 若把含时间的完整格式传给 format，再传 showTime.format，会导致时间重复显示
+        var spaceIdx = dtFmt.indexOf(' ');
+        var dateFmt = spaceIdx !== -1 ? dtFmt.slice(0, spaceIdx) : dtFmt;
+        var timeFmt = spaceIdx !== -1 ? dtFmt.slice(spaceIdx + 1) : 'HH:mm:ss';
+        return /*#__PURE__*/React.createElement(DatePickerAny, _extends({}, restCp, {
+          format: dateFmt,
+          showTime: {
+            format: timeFmt
+          }
+        }));
+      }
     case 'Upload':
       return /*#__PURE__*/React.createElement(UploadAny, componentProps);
     case 'Input':
@@ -257,7 +290,7 @@ var CustomForm = function CustomForm(_ref) {
     labelAlign = _ref.labelAlign,
     labelCol = _ref.labelCol,
     globalSize = _ref.size,
-    otherProps = _objectWithoutPropertiesLoose(_ref, _excluded);
+    otherProps = _objectWithoutPropertiesLoose(_ref, _excluded2);
   // ─── 直接传递列数，通过 device="desktop" 锁定成桌面模式，防止 ResponsiveGrid 根据视口自动缩列
   // ResponsiveGrid columns 只接受 number/string，不接受 breakpoint 对象
   var fixedColumns = columns;
@@ -283,9 +316,9 @@ var CustomForm = function CustomForm(_ref) {
   var valuesRef = useRef(resolvedInitialValues ? _extends({}, resolvedInitialValues) : {});
 
   // ─── 联动回填触发器：用 state 驱动组件重渲染以更新受控字段 ───────────────
-  var _useState = useState(function () {
-      return resolvedInitialValues ? _extends({}, resolvedInitialValues) : {};
-    }),
+  // 注意：不预填 resolvedInitialValues，初始值通过 defaultValue（非受控）处理
+  // 预填会导致所有有初始值的字段变为受控组件，用户改值后因 linkageValues 未更新而回显旧值
+  var _useState = useState({}),
     linkageValues = _useState[0],
     setLinkageValues = _useState[1];
 
@@ -397,27 +430,47 @@ var CustomForm = function CustomForm(_ref) {
     // 追加 computedFields 衍生字段
     var finalValues = applyComputedFields(mergedValues, resolvedComputedFields);
 
-    // submitMapping：自动组装 itemList 格式（阶段二）
-    if (submitMapping && submitMapping.items && submitMapping.items.length > 0) {
-      var _extends3;
-      var targetField = submitMapping.targetField || 'itemList';
-      var itemList = submitMapping.items.map(function (mappingItem) {
-        var columnValue;
-        if (mappingItem.field) {
-          var _finalValues$mappingI;
-          columnValue = (_finalValues$mappingI = finalValues[mappingItem.field]) !== null && _finalValues$mappingI !== void 0 ? _finalValues$mappingI : '';
-        } else if (mappingItem.template) {
-          columnValue = renderTemplate(mappingItem.template, finalValues);
-        } else {
-          columnValue = '';
-        }
-        return {
-          columnName: mappingItem.columnName,
-          columnValue: columnValue
-        };
-      });
-      finalValues = _extends({}, finalValues, (_extends3 = {}, _extends3[targetField] = itemList, _extends3));
-      cfLog('submitMapping', "\u5DF2\u751F\u6210 " + targetField, itemList);
+    // submitMapping：按 mode 构建请求参数（阶段五）
+    if (submitMapping) {
+      var _submitMapping$mode, _submitMapping$items, _submitMapping$fieldR, _submitMapping$items2;
+      // 向后兼容：未设置 mode 时，有 items 数组则默认 itemList，否则 passthrough
+      var mode = (_submitMapping$mode = submitMapping.mode) !== null && _submitMapping$mode !== void 0 ? _submitMapping$mode : (_submitMapping$items = submitMapping.items) !== null && _submitMapping$items !== void 0 && _submitMapping$items.length ? 'itemList' : 'passthrough';
+      if (mode === 'rename' && (_submitMapping$fieldR = submitMapping.fieldRenameMap) !== null && _submitMapping$fieldR !== void 0 && _submitMapping$fieldR.length) {
+        // ── rename：重命名指定字段，其余字段按原名透传
+        var renamed = _extends({}, finalValues);
+        submitMapping.fieldRenameMap.forEach(function (_ref3) {
+          var fromField = _ref3.fromField,
+            toField = _ref3.toField;
+          if (fromField && toField && fromField in renamed) {
+            renamed[toField] = renamed[fromField];
+            if (fromField !== toField) delete renamed[fromField];
+          }
+        });
+        finalValues = renamed;
+        cfLog('submitMapping', 'rename 模式字段重命名完成', finalValues);
+      } else if (mode === 'itemList' && (_submitMapping$items2 = submitMapping.items) !== null && _submitMapping$items2 !== void 0 && _submitMapping$items2.length) {
+        var _extends3;
+        // ── itemList：转换为动态表单格式 [{columnName, columnValue}]
+        var targetField = submitMapping.targetField || 'itemList';
+        var itemList = submitMapping.items.map(function (mappingItem) {
+          var columnValue;
+          if (mappingItem.field) {
+            var _finalValues$mappingI;
+            columnValue = (_finalValues$mappingI = finalValues[mappingItem.field]) !== null && _finalValues$mappingI !== void 0 ? _finalValues$mappingI : '';
+          } else if (mappingItem.template) {
+            columnValue = renderTemplate(mappingItem.template, finalValues);
+          } else {
+            columnValue = '';
+          }
+          return {
+            columnName: mappingItem.columnName,
+            columnValue: columnValue
+          };
+        });
+        finalValues = _extends({}, finalValues, (_extends3 = {}, _extends3[targetField] = itemList, _extends3));
+        cfLog('submitMapping', "itemList \u6A21\u5F0F\u5DF2\u751F\u6210 " + targetField, itemList);
+      }
+      // passthrough: finalValues 直接作为请求参数，无需处理
     }
     cfLog('submit', '提交触发', {
       rawValues: values,
@@ -467,7 +520,14 @@ var CustomForm = function CustomForm(_ref) {
         if (typeof ((_item$componentProps2 = item.componentProps) === null || _item$componentProps2 === void 0 ? void 0 : _item$componentProps2.onChange) === 'function') {
           item.componentProps.onChange(value);
         }
-        handleFieldChange(item.field, value);
+        // DatePicker / DateTimePicker 的 onChange 返回 Moment 对象，需格式化为字符串后再存储
+        var storedValue = value;
+        if (['DatePicker', 'DateTimePicker'].includes(item.componentType) && value && typeof value.format === 'function') {
+          var _item$componentProps3;
+          var fmt = ((_item$componentProps3 = item.componentProps) === null || _item$componentProps3 === void 0 ? void 0 : _item$componentProps3.format) || (item.componentType === 'DateTimePicker' ? 'YYYY-MM-DD HH:mm:ss' : 'YYYY-MM-DD');
+          storedValue = value.format(fmt);
+        }
+        handleFieldChange(item.field, storedValue);
       }
     });
 

package/lib/components/custom-form/custom-form.d.ts

@@ -111,6 +111,13 @@ export interface SubmitMappingItem {
     /** 模板字符串（同 computedFields 格式，与 field 二选一），如 "{package_name},{guest_count}人" */
     template?: string;
 }
+/** rename 模式：单条字段重命名规则 */
+export interface FieldRenameItem {
+    /** 表单字段名（源） */
+    fromField: string;
+    /** API 参数名（目标） */
+    toField: string;
+}
 /**
  * 操作按钮配置项（阶段四新增）
  * 表单底部可配置多个按钮，每个按钮均可独立设置操作类型与数据源。
@@ -138,15 +145,28 @@ export interface OperationItem {
     buttonProps?: Record<string, any>;
 }
 /**
- * 提交映射配置（阶段二）
- * 配置后，提交时自动将指定字段组装为 { columnName, columnValue }[] 格式并写入 finalValues。
- * 消灭手写 onSubmitClick 中的 itemList 拼接逻辑。
+ * 提交参数配置（阶段五扩展）
+ *
+ * 三种工作模式（mode）：
+ * - 'passthrough'：直接将 finalValues 作为请求参数，无需任何配置（字段名与 API 参数名相同时使用）。
+ * - 'rename'：按 fieldRenameMap 规则重命名指定字段，未列出的字段保持原名透传；
+ *             适合字段名与 API 参数名不一致的标准 REST 接口。
+ * - 'itemList'：将字段转换为动态表单格式 [{columnName, columnValue}]，
+ *              适合 /source/api/dynamicFormTableRecord/ 等动态表单接口。
+ *
+ * 向后兼容：未设置 mode 时，若 items 不为空则自动识别为 'itemList' 模式，否则等同于 'passthrough'。
  */
 export interface SubmitMapping {
-    /** 写入 finalValues 的目标字段名，默认 'itemList' */
+    /**
+     * 参数构建模式，默认 'passthrough'（无 items 时）或 'itemList'（有 items 时，向后兼容）。
+     */
+    mode?: 'passthrough' | 'rename' | 'itemList';
+    /** rename 模式：字段重命名规则列表，未列出的字段按原名透传 */
+    fieldRenameMap?: FieldRenameItem[];
+    /** itemList 模式：组装结果写入 finalValues 的目标字段名，默认 'itemList' */
     targetField?: string;
-    /** 映射规则数组 */
-    items: SubmitMappingItem[];
+    /** itemList 模式：字段映射规则 */
+    items?: SubmitMappingItem[];
 }
 export interface CustomFormProps extends Omit<FormProps, 'onSubmit' | 'onChange'> {
     columns?: number;

package/lib/components/custom-form/custom-form.js

@@ -17,7 +17,8 @@ var _responsiveGrid = _interopRequireDefault(require("@alifd/next/lib/responsive
 var _form = _interopRequireDefault(require("@alifd/next/lib/form"));
 var _react = _interopRequireWildcard(require("react"));
 require("./index.scss");
-var _excluded = ["columns", "spacing", "emptyContent", "formItems", "initialValues", "computedFields", "fieldLinkage", "submitMapping", "fullWidth", "showSubmit", "submitText", "submitValidate", "submitDataSource", "submitButtonProps", "showReset", "resetText", "resetButtonProps", "operations", "operationAlign", "onSubmit", "onSubmitFailed", "onChange", "onReset", "children", "labelAlign", "labelCol", "size"];
+var _excluded = ["format", "showTime"],
+  _excluded2 = ["columns", "spacing", "emptyContent", "formItems", "initialValues", "computedFields", "fieldLinkage", "submitMapping", "fullWidth", "showSubmit", "submitText", "submitValidate", "submitDataSource", "submitButtonProps", "showReset", "resetText", "resetButtonProps", "operations", "operationAlign", "onSubmit", "onSubmitFailed", "onChange", "onReset", "children", "labelAlign", "labelCol", "size"];
 /**
  * CustomForm v0.5
  * 阶段一新增能力：
@@ -94,15 +95,24 @@ var UploadAny = _upload["default"];
 
 /** 提交映射 item（阶段二） */
 
+/** rename 模式：单条字段重命名规则 */
+
 /**
  * 操作按钮配置项（阶段四新增）
  * 表单底部可配置多个按钮，每个按钮均可独立设置操作类型与数据源。
  */
 
 /**
- * 提交映射配置（阶段二）
- * 配置后，提交时自动将指定字段组装为 { columnName, columnValue }[] 格式并写入 finalValues。
- * 消灭手写 onSubmitClick 中的 itemList 拼接逻辑。
+ * 提交参数配置（阶段五扩展）
+ *
+ * 三种工作模式（mode）：
+ * - 'passthrough'：直接将 finalValues 作为请求参数，无需任何配置（字段名与 API 参数名相同时使用）。
+ * - 'rename'：按 fieldRenameMap 规则重命名指定字段，未列出的字段保持原名透传；
+ *             适合字段名与 API 参数名不一致的标准 REST 接口。
+ * - 'itemList'：将字段转换为动态表单格式 [{columnName, columnValue}]，
+ *              适合 /source/api/dynamicFormTableRecord/ 等动态表单接口。
+ *
+ * 向后兼容：未设置 mode 时，若 items 不为空则自动识别为 'itemList' 模式，否则等同于 'passthrough'。
  */
 
 // ─── 工具：模板字符串渲染 ─────────────────────────────────────────────────────
@@ -172,6 +182,13 @@ var runSubmitDataSource = function runSubmitDataSource(submitDataSource, values,
     submitDataSource(values, errors, field);
     return;
   }
+  // lowcode-engine 数据源对象（this.dataSourceMap.xxx）使用 .load(params) 触发请求。
+  // params 会与数据源静态 options.params 合并覆盖；
+  // 若 submitMapping 已配置，values 中包含 itemList，可直接覆盖接口默认参数。
+  if (typeof (submitDataSource === null || submitDataSource === void 0 ? void 0 : submitDataSource.load) === 'function') {
+    submitDataSource.load(values);
+    return;
+  }
   if (typeof (submitDataSource === null || submitDataSource === void 0 ? void 0 : submitDataSource.run) === 'function') {
     submitDataSource.run(values, errors, field);
     return;
@@ -211,13 +228,29 @@ var renderFormItemComponent = function renderFormItemComponent(item) {
     case 'NumberPicker':
       return /*#__PURE__*/_react["default"].createElement(NumberPickerAny, componentProps);
     case 'DatePicker':
-      return /*#__PURE__*/_react["default"].createElement(DatePickerAny, componentProps);
-    case 'DateTimePicker':
-      // 日期时间选择器：showTime 开启，格式化为 YYYY-MM-DD HH:mm
       return /*#__PURE__*/_react["default"].createElement(DatePickerAny, (0, _extends4["default"])({
-        showTime: true,
-        format: "YYYY-MM-DD HH:mm"
+        format: "YYYY-MM-DD"
       }, componentProps));
+    case 'DateTimePicker':
+      {
+        // 将 format / showTime 从 componentProps 中单独析构，防止 spread 覆盖我们的计算值
+        var cpFormat = componentProps.format,
+          _ignoredShowTime = componentProps.showTime,
+          restCp = (0, _objectWithoutPropertiesLoose2["default"])(componentProps, _excluded);
+        var dtFmt = cpFormat || 'YYYY-MM-DD HH:mm:ss';
+        // 提取日期部分（空格前）和时间部分（空格后）
+        // @alifd/next DatePicker 会将 format（日期）与 showTime.format（时间）拼接显示
+        // 若把含时间的完整格式传给 format，再传 showTime.format，会导致时间重复显示
+        var spaceIdx = dtFmt.indexOf(' ');
+        var dateFmt = spaceIdx !== -1 ? dtFmt.slice(0, spaceIdx) : dtFmt;
+        var timeFmt = spaceIdx !== -1 ? dtFmt.slice(spaceIdx + 1) : 'HH:mm:ss';
+        return /*#__PURE__*/_react["default"].createElement(DatePickerAny, (0, _extends4["default"])({}, restCp, {
+          format: dateFmt,
+          showTime: {
+            format: timeFmt
+          }
+        }));
+      }
     case 'Upload':
       return /*#__PURE__*/_react["default"].createElement(UploadAny, componentProps);
     case 'Input':
@@ -263,7 +296,7 @@ var CustomForm = function CustomForm(_ref) {
     labelAlign = _ref.labelAlign,
     labelCol = _ref.labelCol,
     globalSize = _ref.size,
-    otherProps = (0, _objectWithoutPropertiesLoose2["default"])(_ref, _excluded);
+    otherProps = (0, _objectWithoutPropertiesLoose2["default"])(_ref, _excluded2);
   // ─── 直接传递列数，通过 device="desktop" 锁定成桌面模式，防止 ResponsiveGrid 根据视口自动缩列
   // ResponsiveGrid columns 只接受 number/string，不接受 breakpoint 对象
   var fixedColumns = columns;
@@ -289,9 +322,9 @@ var CustomForm = function CustomForm(_ref) {
   var valuesRef = (0, _react.useRef)(resolvedInitialValues ? (0, _extends4["default"])({}, resolvedInitialValues) : {});
 
   // ─── 联动回填触发器：用 state 驱动组件重渲染以更新受控字段 ───────────────
-  var _useState = (0, _react.useState)(function () {
-      return resolvedInitialValues ? (0, _extends4["default"])({}, resolvedInitialValues) : {};
-    }),
+  // 注意：不预填 resolvedInitialValues，初始值通过 defaultValue（非受控）处理
+  // 预填会导致所有有初始值的字段变为受控组件，用户改值后因 linkageValues 未更新而回显旧值
+  var _useState = (0, _react.useState)({}),
     linkageValues = _useState[0],
     setLinkageValues = _useState[1];
 
@@ -403,27 +436,47 @@ var CustomForm = function CustomForm(_ref) {
     // 追加 computedFields 衍生字段
     var finalValues = applyComputedFields(mergedValues, resolvedComputedFields);
 
-    // submitMapping：自动组装 itemList 格式（阶段二）
-    if (submitMapping && submitMapping.items && submitMapping.items.length > 0) {
-      var _extends3;
-      var targetField = submitMapping.targetField || 'itemList';
-      var itemList = submitMapping.items.map(function (mappingItem) {
-        var columnValue;
-        if (mappingItem.field) {
-          var _finalValues$mappingI;
-          columnValue = (_finalValues$mappingI = finalValues[mappingItem.field]) !== null && _finalValues$mappingI !== void 0 ? _finalValues$mappingI : '';
-        } else if (mappingItem.template) {
-          columnValue = renderTemplate(mappingItem.template, finalValues);
-        } else {
-          columnValue = '';
-        }
-        return {
-          columnName: mappingItem.columnName,
-          columnValue: columnValue
-        };
-      });
-      finalValues = (0, _extends4["default"])({}, finalValues, (_extends3 = {}, _extends3[targetField] = itemList, _extends3));
-      cfLog('submitMapping', "\u5DF2\u751F\u6210 " + targetField, itemList);
+    // submitMapping：按 mode 构建请求参数（阶段五）
+    if (submitMapping) {
+      var _submitMapping$mode, _submitMapping$items, _submitMapping$fieldR, _submitMapping$items2;
+      // 向后兼容：未设置 mode 时，有 items 数组则默认 itemList，否则 passthrough
+      var mode = (_submitMapping$mode = submitMapping.mode) !== null && _submitMapping$mode !== void 0 ? _submitMapping$mode : (_submitMapping$items = submitMapping.items) !== null && _submitMapping$items !== void 0 && _submitMapping$items.length ? 'itemList' : 'passthrough';
+      if (mode === 'rename' && (_submitMapping$fieldR = submitMapping.fieldRenameMap) !== null && _submitMapping$fieldR !== void 0 && _submitMapping$fieldR.length) {
+        // ── rename：重命名指定字段，其余字段按原名透传
+        var renamed = (0, _extends4["default"])({}, finalValues);
+        submitMapping.fieldRenameMap.forEach(function (_ref3) {
+          var fromField = _ref3.fromField,
+            toField = _ref3.toField;
+          if (fromField && toField && fromField in renamed) {
+            renamed[toField] = renamed[fromField];
+            if (fromField !== toField) delete renamed[fromField];
+          }
+        });
+        finalValues = renamed;
+        cfLog('submitMapping', 'rename 模式字段重命名完成', finalValues);
+      } else if (mode === 'itemList' && (_submitMapping$items2 = submitMapping.items) !== null && _submitMapping$items2 !== void 0 && _submitMapping$items2.length) {
+        var _extends3;
+        // ── itemList：转换为动态表单格式 [{columnName, columnValue}]
+        var targetField = submitMapping.targetField || 'itemList';
+        var itemList = submitMapping.items.map(function (mappingItem) {
+          var columnValue;
+          if (mappingItem.field) {
+            var _finalValues$mappingI;
+            columnValue = (_finalValues$mappingI = finalValues[mappingItem.field]) !== null && _finalValues$mappingI !== void 0 ? _finalValues$mappingI : '';
+          } else if (mappingItem.template) {
+            columnValue = renderTemplate(mappingItem.template, finalValues);
+          } else {
+            columnValue = '';
+          }
+          return {
+            columnName: mappingItem.columnName,
+            columnValue: columnValue
+          };
+        });
+        finalValues = (0, _extends4["default"])({}, finalValues, (_extends3 = {}, _extends3[targetField] = itemList, _extends3));
+        cfLog('submitMapping', "itemList \u6A21\u5F0F\u5DF2\u751F\u6210 " + targetField, itemList);
+      }
+      // passthrough: finalValues 直接作为请求参数，无需处理
     }
     cfLog('submit', '提交触发', {
       rawValues: values,
@@ -473,7 +526,14 @@ var CustomForm = function CustomForm(_ref) {
         if (typeof ((_item$componentProps2 = item.componentProps) === null || _item$componentProps2 === void 0 ? void 0 : _item$componentProps2.onChange) === 'function') {
           item.componentProps.onChange(value);
         }
-        handleFieldChange(item.field, value);
+        // DatePicker / DateTimePicker 的 onChange 返回 Moment 对象，需格式化为字符串后再存储
+        var storedValue = value;
+        if (['DatePicker', 'DateTimePicker'].includes(item.componentType) && value && typeof value.format === 'function') {
+          var _item$componentProps3;
+          var fmt = ((_item$componentProps3 = item.componentProps) === null || _item$componentProps3 === void 0 ? void 0 : _item$componentProps3.format) || (item.componentType === 'DateTimePicker' ? 'YYYY-MM-DD HH:mm:ss' : 'YYYY-MM-DD');
+          storedValue = value.format(fmt);
+        }
+        handleFieldChange(item.field, storedValue);
       }
     });