cloud-web-corejs 1.0.54-dev.687 → 1.0.54-dev.689

package/src/components/xform/lang/zh-CN.js

@@ -7,7 +7,7 @@ export default {
     document: "文档",
     qqGroup: "技术WX群",
     deployment: "私有部署",
-    subscription: "订阅Pro"
+    subscription: "订阅Pro",
   },
   designer: {
     componentLib: "组件库",
@@ -37,8 +37,9 @@ export default {
       "vf-dialog": "弹出窗口",
       "vf-drawer": "侧滑抽屉",
       input: "单行输入",
-      'input-batch': "批量输入",
+      "input-batch": "批量输入",
       textarea: "多行输入",
+      "script-input": "脚本输入框",
       number: "计数器",
       radio: "单选项",
       checkbox: "多选项",
@@ -57,46 +58,46 @@ export default {
       "vue-page": "Vue页面",
       button: "按钮",
       divider: "分隔线",
-      census: '统计',
-      'title-head': '标题头',
+      census: "统计",
+      "title-head": "标题头",
       "picture-upload": "图片",
       "file-upload": "文件",
-      "vabUpload": "凭证",
-      "vabUpload2": "凭证(海信)",
-      "vabsearch": "搜索框",
-      "search_button": "搜索按钮",
-      "save_button": "保存按钮",
-      "reset_button": "重置按钮",
-      "add_button": "新增按钮",
-      "export_button": "导出按钮",
-      "import_button": "导入按钮",
+      vabUpload: "凭证",
+      vabUpload2: "凭证(海信)",
+      vabsearch: "搜索框",
+      search_button: "搜索按钮",
+      save_button: "保存按钮",
+      reset_button: "刷新按钮",
+      add_button: "新增按钮",
+      export_button: "导出按钮",
+      import_button: "导入按钮",
       "import-button": "导入按钮",
       "import2-button": "明细导入按钮",
       "print-button": "导出/打印(列表)",
       "print-detail-button": "导出/打印(详情)",
-      "copy_button": "复制按钮",
+      copy_button: "复制按钮",
       "rich-editor": "富文本",
       cascader: "级联选择",
       "area-select": "地区选择",
       slot: "插槽",
-      echart: '图表',
-      'echart-pie': '饼图',
-      'echart-bar': '柱状图',
-      'echart-category': '折线图',
+      echart: "图表",
+      "echart-pie": "饼图",
+      "echart-bar": "柱状图",
+      "echart-category": "折线图",
       custom: "Custom Component",
-      'news-list': '列表',
-      descriptions: '描述列表',
-      panel: '面板',
-      query: '查询模块',
+      "news-list": "列表",
+      descriptions: "描述列表",
+      panel: "面板",
+      query: "查询模块",
       detail: "详情模块",
-      'detail-pane': "详情tab",
-      'detail-h5': "H5详情",
-      'list-h5': "H5列表",
-      "text": "文本",
-      'tree-pane': "树/列表布局",
-      'h5-card': "h5卡片",
-      'h5-card-pane': "h5卡片选项卡",
-      'h5-table': "h5表格",
+      "detail-pane": "详情tab",
+      "detail-h5": "H5详情",
+      "list-h5": "H5列表",
+      text: "文本",
+      "tree-pane": "树/列表布局",
+      "h5-card": "h5卡片",
+      "h5-card-pane": "h5卡片选项卡",
+      "h5-table": "h5表格",
       tree: "树形",
       "table-export-button": "列表导出",
       "select-export-item-button": "列表导出(明细)",
@@ -104,8 +105,8 @@ export default {
       status: "状态",
       "a-link": "超链接按钮",
       "a-text": "超链接文本",
-      'project-tag': '标签',
-      'dropdown': '下拉按钮',
+      "project-tag": "标签",
+      dropdown: "下拉按钮",
 
       "create_by-text": "创建人",
       "modify_by-text": "更新人",
@@ -115,10 +116,12 @@ export default {
       "saleOrg-vabsearch": "机构（单选）",
       "user-project-tag": "用户（多选）",
       "saleOrg-project-tag": "机构（多选）",
-      "tempStorage": "暂存按钮",
-      "oplog": "操作日志",
-      "gantt": "甘特图",
+      tempStorage: "暂存按钮",
+      oplog: "操作日志",
+      gantt: "甘特图",
       "download-button": "附件下载",
+      cascader: "级联选择",
+      childrenKeyName: "子节点属性名称",
     },
     hint: {
       formulaSetting: "公式设置",
@@ -146,60 +149,42 @@ export default {
       formulaObject: "对象",
       formulaDate: "日期",
       formulaChar: "文字",
-      formulaPleaseSelect:
-        "请选择组件名和函数",
+      formulaPleaseSelect: "请选择组件名和函数",
       formulaSample: "公式编辑举例",
       formulaPara: "参数",
-      formulaINT:
-        "将数值去掉小数，举例：INT(-8.9)=-9",
-      formulaSUM:
-        "返回一组数据的和，举例：SUM(1,2,3,...)=6",
-      formulaSUMIF:
-        `根据单个条件对指定区域内的数值求和，举例：SUMIF([10, 20, 30], ">10", [80, 120, 90])=210`,
-      formulaSUMIFS:
-        `根据多个条件对指定区域内的数值求和（条件需同时满足），举例：SUMIFS([1000, 2000, 1500, 3000], [400, 600, 700, 800], '>500', [2022, 2023, 2023, 2024], 2023)=3500`,
-      formulaAVERAGE:
-        "返回一组数据的平均数，举例：AVERAGE(1,2,3,...)=2",
-      formulaMAX:
-        "返回一组数中的最大值，举例：MAX(1,2,3,...)=3",
-      formulaMIN:
-        "返回一组数中的最小值，举例：MIN(1,2,3,...)=1",
-      formulaABS:
-        "求一个数的绝对值，举例：ABS(-5)=5",
-      formulaROUND:
-        "将数值保留指定小数位，举例：ROUND(8.999,2)=9.00",
-      formulaCEILING:
-        "将一个数向上取整，举例：CEILING(8.9)=9",
+      formulaINT: "将数值去掉小数，举例：INT(-8.9)=-9",
+      formulaSUM: "返回一组数据的和，举例：SUM(1,2,3,...)=6",
+      formulaSUMIF: `根据单个条件对指定区域内的数值求和，举例：SUMIF([10, 20, 30], ">10", [80, 120, 90])=210`,
+      formulaSUMIFS: `根据多个条件对指定区域内的数值求和（条件需同时满足），举例：SUMIFS([1000, 2000, 1500, 3000], [400, 600, 700, 800], '>500', [2022, 2023, 2023, 2024], 2023)=3500`,
+      formulaAVERAGE: "返回一组数据的平均数，举例：AVERAGE(1,2,3,...)=2",
+      formulaMAX: "返回一组数中的最大值，举例：MAX(1,2,3,...)=3",
+      formulaMIN: "返回一组数中的最小值，举例：MIN(1,2,3,...)=1",
+      formulaABS: "求一个数的绝对值，举例：ABS(-5)=5",
+      formulaROUND: "将数值保留指定小数位，举例：ROUND(8.999,2)=9.00",
+      formulaCEILING: "将一个数向上取整，举例：CEILING(8.9)=9",
       formulaLOG:
         "返回以参数2为底参数1的对数，举例：LOG(8,2)=3，以2为底8的对数为3",
-      formulaMOD:
-        "求两数相除的余数，举例：MOD(2,6)=2",
-      formulaPOWER:
-        "求数字的N次方，举例：POWER(5, 3)=125",
+      formulaMOD: "求两数相除的余数，举例：MOD(2,6)=2",
+      formulaPOWER: "求数字的N次方，举例：POWER(5, 3)=125",
       formulaAND:
         "当所有条件都符合时，返回true，否则返回false，举例：AND(1>0,2>1,...)=TRUE",
       formulaIF:
         "判断一个条件能否满足，如果满足则返回一个值，如果不满足则返回另一个值，举例：IF(1>2,1,0)=0",
-      formulaIFS:
-        "举例：IFS(false, 'Hello!', true, 'Goodbye!')=Goodbye!",
-      formulaIFERROR:
-        "举例：IFERROR('#DIV/0!', 'Error')",
+      formulaIFS: "举例：IFS(false, 'Hello!', true, 'Goodbye!')=Goodbye!",
+      formulaIFERROR: "举例：IFERROR('#DIV/0!', 'Error')",
       formulaIFNA: "举例：IFNA('#N/A', 'Error')",
       formulaNOT: "举例：NOT(true)=false",
       formulaOR: "举例: OR (true, false, true)=true",
       formulaSWITCH:
         "SWITCH(参数值,条件1,'条件值1',条件2,'条件值2'[,条件N,'条件值N',])，举例：SWITCH(7, 9, 'Nine', 7, 'Seven')=Seven",
-      formulaXOR:
-        "举例：XOR(true, false, true)=false",
+      formulaXOR: "举例：XOR(true, false, true)=false",
       formulaYEAR: '举例：YEAR("2022-10-1")=2022',
       formulaMONTH: '举例：MONTH("2022-10-1")=10',
       formulaDAY: '举例：DAY("2022-10-11")=11',
       formulaTODAY: '举例: TODAY()="2022-10-11"',
       formulaNOW: '举例: NOW="2022-10-11 17:04:33"',
-      formulaEMONTH:
-        "举例: EMONTH ('2022-12-13  ', -1)='2022-11-13 '",
-      formulaEDAY:
-        "举例: EMONTH ('2022-12-13  ', -1)='2022-12-12 '",
+      formulaEMONTH: "举例: EMONTH ('2022-12-13  ', -1)='2022-11-13 '",
+      formulaEDAY: "举例: EMONTH ('2022-12-13  ', -1)='2022-12-12 '",
       formulaFIND: `查找字符串(参数：
 1、查找句柄 2、查找目标字符串 3、开始查找下标)，
 举例：FIND('M', 'Miriam McGovern', 3)=8`,
@@ -207,20 +192,16 @@ export default {
         "获取字符串左侧N个字符，LEFT(字符串,截取长度)，举例：LEFT('Sale Price', 4)=Sale",
       formulaRIGHT:
         "获取字符串右侧N个字符 RIGHT(字符串,截取长度)，举例：RIGHT('Sale Price', 5)=Price",
-      formulaLEN:
-        "统计字符串长度，举例：LEN('abcdefgh')=8",
+      formulaLEN: "统计字符串长度，举例：LEN('abcdefgh')=8",
       formulaLOWER:
         "字符串转小写，举例：LOWER('E. E. Cummings')=e. e. cummings",
-      formulaUPPER:
-        "字符串转大写，举例：UPPER('total')=TOTAL",
+      formulaUPPER: "字符串转大写，举例：UPPER('total')=TOTAL",
       formulaMID:
         "截取字符串 MID(字符串,开始下标,截取长度)，举例：MID('Fluid Flow', 7, 20)=Flow",
       formulaTRIM:
         "字符串去除多余空格 TRIM(字符串)，举例：TRIM('     First     Quarter  ')=First Quarter",
-      formulaDateError:
-        "日期格式不正确",
-      formulaDateErrorMsg:
-        "日期转换错误明细",
+      formulaDateError: "日期格式不正确",
+      formulaDateErrorMsg: "日期转换错误明细",
 
       selectParentWidget: "选中父组件",
       moveUpWidget: "上移组件",
@@ -269,7 +250,8 @@ export default {
       sampleLoadedSuccess: "表单示例加载成功",
       sampleLoadedFail: "表单示例加载失败",
       loadFormTemplate: "加载此模板",
-      loadFormTemplateHint: "是否加载这个模板？加载后会覆盖设计器当前表单，你可以使用“撤销”功能恢复。",
+      loadFormTemplateHint:
+        "是否加载这个模板？加载后会覆盖设计器当前表单，你可以使用“撤销”功能恢复。",
       loadFormTemplateSuccess: "表单模板加载成功",
       loadFormTemplateFailed: "表单模板加载失败",
       currentNodeCannotBeSelected: "当前组件节点不可选择",
@@ -293,12 +275,16 @@ export default {
       urlValidator: "网址",
       noChineseValidator: "非中文字符",
       chineseValidator: "仅中文字符",
-      rowspanNotConsistentForMergeEntireRow: "存在行高不一致的单元格, 无法合并整行.",
-      colspanNotConsistentForMergeEntireColumn: "存在列宽不一致的单元格, 无法合并整列.",
-      rowspanNotConsistentForDeleteEntireRow: "存在行高不一致的单元格, 不可删除整行.",
-      colspanNotConsistentForDeleteEntireColumn: "存在列宽不一致的单元格, 不可删除整列.",
+      rowspanNotConsistentForMergeEntireRow:
+        "存在行高不一致的单元格, 无法合并整行.",
+      colspanNotConsistentForMergeEntireColumn:
+        "存在列宽不一致的单元格, 无法合并整列.",
+      rowspanNotConsistentForDeleteEntireRow:
+        "存在行高不一致的单元格, 不可删除整行.",
+      colspanNotConsistentForDeleteEntireColumn:
+        "存在列宽不一致的单元格, 不可删除整列.",
       lastColCannotBeDeleted: "最后一列不可删除.",
-      lastRowCannotBeDeleted: "最后一行不可删除."
+      lastRowCannotBeDeleted: "最后一行不可删除.",
     },
     toolbar: {
       undoHint: "撤销",
@@ -314,7 +300,7 @@ export default {
       exportJson: "导出JSON",
       exportCode: "导出代码",
       generateCode: "生成代码",
-      generateSFC: "生成SFC"
+      generateSFC: "生成SFC",
     },
     setting: {
       basicSetting: "基本属性",
@@ -351,7 +337,7 @@ export default {
       disabled: "禁用",
       hidden: "隐藏",
       textContent: "静态文字",
-      preWrap: '自动换行',
+      preWrap: "自动换行",
       htmlContent: "HTML",
       clearable: "可清除",
       areaDataType: "地区层级",
@@ -372,12 +358,13 @@ export default {
       multiple: "选项可多选",
       multipleLimit: "多选数量限制",
       checkStrictly: "任意级节点可选",
+      showAllLevels: "显示完整路径",
       contentPosition: "文字位置",
       dividerDirection: "分割线方向",
       plain: "朴素按钮",
       round: "圆角按钮",
       circle: "圆形按钮",
-      space: '间隔(px)',
+      space: "间隔(px)",
       icon: "图标",
       optionsSetting: "选项设置",
       addOption: "增加选项",
@@ -406,12 +393,12 @@ export default {
       colOffsetTitle: "左侧间隔格数",
       colPushTitle: "右移栅格数",
       colPullTitle: "左移栅格数",
-      colHeight: '栅格高度(px或%)',
+      colHeight: "栅格高度(px或%)",
       addColumn: "增加栅格",
       responsive: "响应式布局",
       tabPaneSetting: "选项卡设置",
       addTabPane: "增加选项卡页",
-      tabClass: '选项卡样式',
+      tabClass: "选项卡样式",
       paneActive: "激活",
       customLabelIcon: "定制字段标签",
       labelIconClass: "标签Icon样式",
@@ -422,7 +409,7 @@ export default {
       precision: "精度",
       step: "增减步长",
       controlsPosition: "控制按钮位置",
-      showbutton: '是否显示按钮',
+      showbutton: "是否显示按钮",
       minLength: "最小长度",
       maxLength: "最大长度",
       showWordLimit: "显示字数统计",
@@ -476,10 +463,10 @@ export default {
       formCss: "表单全局CSS",
       addCss: "编写CSS",
       customClass: "自定义CSS样式",
-      containerClass: '容器样式',
+      containerClass: "容器样式",
       styleTitClass: "样式选择",
       styleTableClass: "表格样式",
-      iconClass: '图标样式',
+      iconClass: "图标样式",
       globalFunctions: "表单全局函数",
       addEventHandler: "编写代码",
       editWidgetEventHandler: "组件事件处理",
@@ -591,8 +578,8 @@ export default {
       dsRequestBooleanTypeError: "布尔类型值错误",
       dsValidationError: "数据源设置存在错误，请修改",
       dsDuplicatedNameError: "数据源名称重复，请修改！",
-      echartHeight: '高度',
-      isFullscreen: '是否全屏',
+      echartHeight: "高度",
+      isFullscreen: "是否全屏",
       widgetWidth: "组件宽度",
       isFixbottom: "是否固定到最底",
 
@@ -621,7 +608,7 @@ export default {
       enterForQuery: "输入关键字进行过滤",
       add: "添加",
       delete: "删除",
-      censusClass: '统计样式'
-    }
-  }
-}
+      censusClass: "统计样式",
+    },
+  },
+};

package/src/components/xform/utils/dynamicSchemaUtil.js

@@ -0,0 +1,312 @@
+/**
+ * 后台动态定义（表头后台字段 / 数据表格动态列）共用协议。
+ *
+ * 单条定义顶层字段：
+ * - 通用：keyName、type、label、optionItems、required 等字段级属性、options
+ * - 表头：colspan
+ * - 数据表格：width、formatS（展示列）、children（多级表头）、dropdownItems（dropdown 操作列）
+ *
+ * 请求体：{ formData, ...extra }
+ * 响应体：objx 数组，或 { fields: [] } / { columns: [] }
+ */
+
+/** 顶层字段白名单 */
+export const DYNAMIC_SCHEMA_CORE_KEYS = [
+  "keyName",
+  "type",
+  "label",
+  "optionItems",
+  "options",
+];
+
+/** 字段级属性：写顶层，不写 options（与表头 dynamicFieldMixin 一致） */
+export const DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS = [
+  "required",
+  "readonly",
+  "disabled",
+  "hidden",
+  "defaultValue",
+  "placeholder",
+];
+
+export const DYNAMIC_SCHEMA_TABLE_HEADER_KEYS = ["colspan"];
+
+export const DYNAMIC_SCHEMA_COLUMN_EXTRA_KEYS = [
+  "width",
+  "align",
+  "sortable",
+  "filterable",
+  "show",
+  "fixed",
+  "formatS",
+  "render",
+  "utcTransformEnabled",
+  "children",
+  "dropdownItems",
+];
+
+export const DYNAMIC_SCHEMA_OPTION_KEYS = {
+  scriptCode: ["dynamicSchemaScriptCode", "dynamicColumnScriptCode"],
+  scriptParam: ["dynamicSchemaScriptParam", "dynamicColumnScriptParam"],
+  convert: ["dynamicSchemaConvert"],
+  mode: ["dynamicSchemaMode", "dynamicColumnMode"],
+};
+
+export const widgetTypeToEditFormatMap = {
+  input: "editInput",
+  number: "editNumber",
+  date: "editDate",
+  select: "editSelect",
+  vabsearch: "editSearch",
+  baseAttachment: "editAttachment",
+  status: "editStatus",
+  text: "text",
+  checkbox: "checkbox",
+  radio: "radio",
+  textarea: "textarea",
+  "script-input": "editScriptInput",
+  "a-text": "aText",
+  "a-link": "aLink",
+  button: "button",
+  dropdown: "dropdown",
+};
+
+const ACTION_COLUMN_FORMATS = new Set(["aLink", "button", "dropdown"]);
+
+export function buildDropdownWidgetFromDef(def, index = 0) {
+  const options = def?.options;
+  const dropdownItems = def?.dropdownItems;
+  if (!Array.isArray(dropdownItems) || !dropdownItems.length) return null;
+
+  const ts = `${Date.now()}_${index}`;
+  const widgetList = dropdownItems.map((entry, i) => ({
+    type: "dropdown-item",
+    id: `dropdownitem_${ts}_${i}`,
+    options: {
+      label: entry.label || "",
+      onClick: entry.onClick || "",
+      disabled: !!entry.disabled,
+      hidden: !!entry.hidden,
+    },
+  }));
+
+  return {
+    type: "dropdown",
+    id: `dropdown_${ts}`,
+    options: {
+      label: def.label || "操作",
+      dropdownType: options?.dropdownType || "link",
+      dropdownTrigger: options?.dropdownTrigger || "hover",
+      dropdownFlag: 1,
+    },
+    widgetList,
+  };
+}
+
+function isActionColumn(item, formatS) {
+  return isActionColumnFormat(formatS, item?.type);
+}
+
+export function isActionColumnFormat(formatS, type) {
+  if (ACTION_COLUMN_FORMATS.has(formatS)) return true;
+  return ["a-link", "button", "dropdown"].includes(type);
+}
+
+function isActionOrGroupColumn(item, formatS) {
+  if (Array.isArray(item.children) && item.children.length) return true;
+  return isActionColumn(item, formatS);
+}
+
+function buildWidgetOptions(item, formatS, label) {
+  let widgetOptions =
+    item.options && typeof item.options === "object"
+      ? { ...item.options }
+      : null;
+
+  if (widgetOptions) {
+    delete widgetOptions.dropdownItems;
+  }
+
+  DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS.forEach((key) => {
+    if (item[key] !== undefined) {
+      widgetOptions = widgetOptions || {};
+      widgetOptions[key] = item[key];
+    }
+  });
+
+  if (label) {
+    widgetOptions = widgetOptions || {};
+    if (!widgetOptions.label) {
+      widgetOptions.label = label;
+    }
+  }
+
+  if (!isActionColumn(item, formatS)) {
+    widgetOptions = widgetOptions || {};
+    widgetOptions.labelHidden = true;
+  }
+
+  return widgetOptions;
+}
+
+export function getDynamicSchemaOption(options, key) {
+  if (!options) return null;
+  const keys = DYNAMIC_SCHEMA_OPTION_KEYS[key] || [];
+  for (let i = 0; i < keys.length; i++) {
+    const val = options[keys[i]];
+    if (val !== undefined && val !== null && val !== "") {
+      return val;
+    }
+  }
+  return null;
+}
+
+export function resolveDynamicSchemaExtra(paramScript, handleCustomEvent) {
+  if (!paramScript || !handleCustomEvent) return {};
+  const result = handleCustomEvent(paramScript);
+  return result && typeof result === "object" && !Array.isArray(result)
+    ? result
+    : {};
+}
+
+export function buildDynamicSchemaRequestData(
+  formModel,
+  paramScript,
+  handleCustomEvent,
+  wrapContext
+) {
+  const extra = resolveDynamicSchemaExtra(paramScript, handleCustomEvent);
+  const payload = {
+    formData: formModel || {},
+    ...extra,
+  };
+  if (!wrapContext) {
+    return payload;
+  }
+  const { formCode, formVersion, taBm, dataId } = wrapContext;
+  return {
+    formCode,
+    formVersion,
+    taBm,
+    formData: payload.formData,
+    dataId,
+    data: {
+      dataId,
+      ...payload,
+    },
+  };
+}
+
+/** 从 objx 或转换脚本结果中提取定义数组 */
+export function extractDynamicSchemaItems(source) {
+  if (!source) return [];
+  if (Array.isArray(source)) return source;
+  if (typeof source !== "object") return [];
+  if (Array.isArray(source.fields)) return source.fields;
+  if (Array.isArray(source.columns)) return source.columns;
+  return [];
+}
+
+export function resolveDynamicSchemaResponse(res, convertScript, handleCustomEvent) {
+  if (convertScript && handleCustomEvent) {
+    const result = handleCustomEvent(convertScript, ["res"], [res]);
+    return extractDynamicSchemaItems(result);
+  }
+  return extractDynamicSchemaItems(res && res.objx);
+}
+
+export function normalizeDynamicFieldKey(item) {
+  if (!item || typeof item !== "object") return undefined;
+  return item.keyName;
+}
+
+export function normalizeDynamicColumnItem(item, index) {
+  if (!item || typeof item !== "object") {
+    return null;
+  }
+
+  const keyName = normalizeDynamicFieldKey(item);
+  const label = item.label;
+  let formatS = item.formatS || null;
+  if (!formatS && item.type) {
+    formatS = widgetTypeToEditFormatMap[item.type] || item.type;
+  }
+
+  let editFormatS = null;
+  if (formatS && String(formatS).startsWith("edit")) {
+    editFormatS = formatS;
+  }
+
+  const widgetOptions = buildWidgetOptions(item, formatS, label);
+
+  let widget = null;
+  let widgetList = null;
+  if (
+    (item.type === "dropdown" || formatS === "dropdown") &&
+    Array.isArray(item.dropdownItems) &&
+    item.dropdownItems.length
+  ) {
+    widget = buildDropdownWidgetFromDef(item, index);
+    if (widget && label) {
+      widget.options.label = label;
+    }
+    if (widget?.widgetList?.length) {
+      widgetList = widget.widgetList;
+    }
+  }
+
+  if (!keyName && !isActionOrGroupColumn(item, formatS)) {
+    return null;
+  }
+
+  const isAction = isActionColumn(item, formatS);
+
+  const widgetFlags = {};
+  DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS.forEach((key) => {
+    if (item[key] !== undefined) {
+      widgetFlags[key] = item[key];
+    } else if (widgetOptions?.[key] !== undefined) {
+      widgetFlags[key] = widgetOptions[key];
+    }
+  });
+
+  const children = Array.isArray(item.children)
+    ? item.children
+        .map((child, childIndex) =>
+          normalizeDynamicColumnItem(child, index * 1000 + childIndex)
+        )
+        .filter(Boolean)
+    : item.children;
+
+  return {
+    columnId: item.columnId || `${Date.now()}_${index}`,
+    type: item.type,
+    prop: keyName || undefined,
+    label,
+    width: item.width ?? 150,
+    show: item.show !== false,
+    sortable: isAction ? item.sortable === true : item.sortable !== false,
+    filterable: isAction ? item.filterable === true : item.filterable !== false,
+    ...(item.align ? { align: item.align } : {}),
+    fixed: item.fixed,
+    formatS,
+    editFormatS: editFormatS || undefined,
+    optionItems: item.optionItems,
+    widget,
+    widgetList,
+    widgetOptions,
+    children: children,
+    render: item.render,
+    utcTransformEnabled: item.utcTransformEnabled,
+    ...widgetFlags,
+  };
+}
+
+export function normalizeDynamicColumns(columns) {
+  if (!Array.isArray(columns)) {
+    return [];
+  }
+  return columns
+    .map((item, index) => normalizeDynamicColumnItem(item, index))
+    .filter(Boolean);
+}