@nokecy/qc-ui 1.1.35 → 1.1.37

package/dist/cjs/ag-grid-plus/ag-gridPlus.js

@@ -35,7 +35,8 @@ var _schemeDataMigration = require("./shared/utils/schemeDataMigration");
 var _sanitize = require("./utils/sanitize");
 var _errors = require("./errors");
 var _logger = require("./utils/logger");
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableClickSelection", "rowSelection", "useNativeTreeFilter"];
+var _entityExtensionColumns = require("./utils/entityExtensionColumns");
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType"];
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -93,6 +94,7 @@ function AgGridPlus(props) {
     propsRowSelection = props.rowSelection,
     _props$useNativeTreeF = props.useNativeTreeFilter,
     useNativeTreeFilter = _props$useNativeTreeF === void 0 ? false : _props$useNativeTreeF,
+    entityType = props.entityType,
     rest = _objectWithoutProperties(props, _excluded);
   var _useGridPlusColumnSta = (0, _.useGridPlusColumnState)(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -104,7 +106,8 @@ function AgGridPlus(props) {
     globalConfigPermissions = _useGridPlusColumnSta.globalConfigPermissions,
     applySchemeToGlobal = _useGridPlusColumnSta.applySchemeToGlobal,
     resetToGlobal = _useGridPlusColumnSta.resetToGlobal,
-    resetAllUsers = _useGridPlusColumnSta.resetAllUsers;
+    resetAllUsers = _useGridPlusColumnSta.resetAllUsers,
+    hostEntityExtensions = _useGridPlusColumnSta.hostEntityExtensions;
   var gridRef = (0, _react.useRef)();
   var apiRef = (0, _react.useRef)();
   var allColDefsRef = (0, _react.useRef)([]);
@@ -617,6 +620,30 @@ function AgGridPlus(props) {
         cellRenderer: cellRenderer
       });
     });
+
+    // 基于 entityType 自动注入扩展列 @author nokecy
+    // 从 context 的 hostEntityExtensions 获取对应实体的扩展字段并转换为列定义
+    var extensionCols = (0, _entityExtensionColumns.getEntityExtensionColumns)(entityType, hostEntityExtensions);
+    if (extensionCols.length > 0) {
+      // 查找操作列位置（pinned='right' 或 field='action'），插入到其之前
+      var actionIndex = columnDefs.findIndex(function (col) {
+        return col.field === 'action' || col.pinned === 'right';
+      });
+      if (actionIndex === -1) {
+        var _columnDefs;
+        (_columnDefs = columnDefs).push.apply(_columnDefs, _toConsumableArray(extensionCols));
+      } else {
+        var _columnDefs2;
+        (_columnDefs2 = columnDefs).splice.apply(_columnDefs2, [actionIndex, 0].concat(_toConsumableArray(extensionCols)));
+      }
+      _logger.logger.debug('[AgGridPlus] 已注入实体扩展列', {
+        entityType: entityType,
+        extensionColsCount: extensionCols.length,
+        extensionCols: extensionCols.map(function (c) {
+          return c.field;
+        })
+      });
+    }
     return columnDefs;
   };
 
@@ -643,7 +670,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey]);
+  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions]);
 
   // 稳定化 gridParams 和 sortColumn 的引用
   var stableGridParams = (0, _react.useMemo)(function () {
@@ -1267,7 +1294,9 @@ function AgGridPlus(props) {
       resetAllUsers: resetAllUsers,
       // ========== 全局方案回退状态 @author nokecy ==========
       isUsingGlobalFallback: isUsingGlobalFallback,
-      isUsingGlobalQueryFallback: isUsingGlobalQueryFallback
+      isUsingGlobalQueryFallback: isUsingGlobalQueryFallback,
+      // ========== 实体扩展字段配置 @author nokecy ==========
+      hostEntityExtensions: hostEntityExtensions
     };
   }, [extensibleColumns, gridPlusColumnState, allColDefsRef.current,
   // 【修复】添加到依赖数组
@@ -1279,7 +1308,9 @@ function AgGridPlus(props) {
   // 全局配置依赖
   globalConfigPermissions, applySchemeToGlobal, resetToGlobal, resetAllUsers,
   // 全局方案回退状态依赖 @author nokecy
-  isUsingGlobalFallback, isUsingGlobalQueryFallback]);
+  isUsingGlobalFallback, isUsingGlobalQueryFallback,
+  // 实体扩展字段配置依赖 @author nokecy
+  hostEntityExtensions]);
   return /*#__PURE__*/_react.default.createElement(_gridContext.GridPlusContext.Provider, {
     value: gridPlusContextValue
   }, /*#__PURE__*/_react.default.createElement(_antd.Spin, {

package/dist/cjs/ag-grid-plus/context/gridContext.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { ColumnScheme, QueryScheme, CurrentSchemeDto } from "../shared/storage/schemeStorageAdapter";
 import type { GlobalConfigPermissions } from '../shared/permissions/globalConfigPermissions';
+import type { HostEntityExtensions } from '../types';
 /**
  * 方案管理 API 接口
  *
@@ -175,5 +176,10 @@ export interface GridPlusContextValue extends SchemeManagementAPI {
      * 是否使用全局查询方案作为回退
      */
     isUsingGlobalQueryFallback?: boolean;
+    /**
+     * 实体扩展字段配置映射
+     * 来自后端 ABP 配置，用于 AgGridPlus 根据 entityType 自动注入扩展列
+     */
+    hostEntityExtensions?: HostEntityExtensions;
 }
 export declare const GridPlusContext: React.Context<GridPlusContextValue>;

package/dist/cjs/ag-grid-plus/index.d.ts

@@ -13,3 +13,5 @@ export type { UseSchemeManagerConfig } from "./context/useSchemeManager";
 export type { BackendApiAdapterConfig } from "./shared/storage/backendApiAdapter";
 export type { LocalStorageAdapterConfig } from "./shared/storage/localStorageAdapter";
 export type { GlobalConfigPermissions } from "./shared/permissions/globalConfigPermissions";
+export type { EntityExtensionField, EntityExtensionConfig, HostEntityExtensions } from "./types";
+export { fieldToColumnDef, getEntityExtensionColumns } from "./utils/entityExtensionColumns";

package/dist/cjs/ag-grid-plus/index.js

@@ -57,6 +57,12 @@ Object.defineProperty(exports, "dateValueFormatter", {
     return _utils.dateValueFormatter;
   }
 });
+Object.defineProperty(exports, "fieldToColumnDef", {
+  enumerable: true,
+  get: function get() {
+    return _entityExtensionColumns.fieldToColumnDef;
+  }
+});
 Object.defineProperty(exports, "flatten", {
   enumerable: true,
   get: function get() {
@@ -69,6 +75,12 @@ Object.defineProperty(exports, "flattenTreeDeep", {
     return _utils.flattenTreeDeep;
   }
 });
+Object.defineProperty(exports, "getEntityExtensionColumns", {
+  enumerable: true,
+  get: function get() {
+    return _entityExtensionColumns.getEntityExtensionColumns;
+  }
+});
 Object.defineProperty(exports, "toTree", {
   enumerable: true,
   get: function get() {
@@ -101,4 +113,5 @@ var _utils = require("./utils");
 var _useSchemeManager = require("./context/useSchemeManager");
 var _localStorageAdapter = require("./shared/storage/localStorageAdapter");
 var _backendApiAdapter = require("./shared/storage/backendApiAdapter");
+var _entityExtensionColumns = require("./utils/entityExtensionColumns");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/dist/cjs/ag-grid-plus/interface.d.ts

@@ -95,6 +95,15 @@ interface GridProps extends AgGridReactProps {
      * @default false
      */
     useNativeTreeFilter?: boolean;
+    /**
+     * 实体类型全名，用于自动注入扩展字段列
+     * 当配置此属性时，组件会自动从 context 的 hostEntityExtensions
+     * 获取对应实体的扩展字段并转换为列定义
+     *
+     * @example "Burn.Product.Domain.Product"
+     * @author nokecy
+     */
+    entityType?: string;
 }
 interface AgGridColumnPropsClone extends ColDef {
     /**

package/dist/cjs/ag-grid-plus/types.d.ts

@@ -310,3 +310,36 @@ export type RowDataArray<T = any> = T[];
  * 查询表单项数组类型
  */
 export type QueryFormItems = QueryFormItem[];
+/**
+ * 扩展字段定义（来自后端 ABP 配置）
+ */
+export interface EntityExtensionField {
+    name: string;
+    displayName: string;
+    description?: string | null;
+    /** 数据类型: String, Int, Long, Decimal, Double, Float, Boolean, DateTime, Date, Guid, Enum, Text */
+    dataType: string;
+    maxLength?: number | null;
+    precision?: number | null;
+    scale?: number | null;
+    isRequired?: boolean;
+    sortOrder?: number;
+    uiComponent?: string | null;
+    placeholder?: string | null;
+    defaultValue?: any;
+    componentProps?: string | null;
+    validationRules?: string | null;
+}
+/**
+ * 单个实体的扩展配置
+ */
+export interface EntityExtensionConfig {
+    entityType: string;
+    displayName: string;
+    moduleName: string;
+    fields: EntityExtensionField[];
+}
+/**
+ * 实体扩展配置映射（key: 实体类型全名）
+ */
+export type HostEntityExtensions = Record<string, EntityExtensionConfig>;

package/dist/cjs/ag-grid-plus/utils/entityExtensionColumns.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 实体扩展字段列转换工具
+ * 将后端 ABP 配置的扩展字段转换为 AG-Grid 列定义
+ *
+ * @author nokecy
+ */
+import type { ExtendedColDef, EntityExtensionField, HostEntityExtensions } from '../types';
+/**
+ * 将单个扩展字段转换为列定义
+ * 使用 extraProperties.xxx 嵌套路径访问数据
+ *
+ * @param field 扩展字段定义
+ * @returns AG-Grid 列定义
+ */
+export declare function fieldToColumnDef(field: EntityExtensionField): ExtendedColDef;
+/**
+ * 获取指定实体的扩展列定义
+ *
+ * @param entityType 实体类型全名 (如 "Burn.Product.Domain.Product")
+ * @param extensions 实体扩展配置映射
+ * @returns 扩展列定义数组，按 sortOrder 排序
+ */
+export declare function getEntityExtensionColumns(entityType: string | undefined, extensions?: HostEntityExtensions): ExtendedColDef[];

package/dist/cjs/ag-grid-plus/utils/entityExtensionColumns.js

@@ -0,0 +1,140 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.fieldToColumnDef = fieldToColumnDef;
+exports.getEntityExtensionColumns = getEntityExtensionColumns;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 实体扩展字段列转换工具
+ * 将后端 ABP 配置的扩展字段转换为 AG-Grid 列定义
+ *
+ * @author nokecy
+ */
+
+/**
+ * 数据类型到列配置的映射
+ * 根据字段的数据类型自动配置列宽度、是否可搜索、列类型等
+ */
+var dataTypeColumnConfig = {
+  // 字符串类型
+  String: {
+    width: 150,
+    hideInSearch: false
+  },
+  Text: {
+    width: 200,
+    hideInSearch: true
+  },
+  // 数值类型
+  Int: {
+    width: 100,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Long: {
+    width: 100,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Decimal: {
+    width: 120,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Double: {
+    width: 120,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Float: {
+    width: 120,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  // 布尔类型
+  Boolean: {
+    width: 80,
+    hideInSearch: false
+  },
+  // 日期时间类型
+  DateTime: {
+    width: 160,
+    hideInSearch: true,
+    type: 'dateTimeColumn'
+  },
+  Date: {
+    width: 120,
+    hideInSearch: true,
+    type: 'dateColumn'
+  },
+  // 其他类型
+  Guid: {
+    width: 280,
+    hideInSearch: false
+  },
+  Enum: {
+    width: 100,
+    hideInSearch: false
+  }
+};
+
+/**
+ * 将单个扩展字段转换为列定义
+ * 使用 extraProperties.xxx 嵌套路径访问数据
+ *
+ * @param field 扩展字段定义
+ * @returns AG-Grid 列定义
+ */
+function fieldToColumnDef(field) {
+  var config = dataTypeColumnConfig[field.dataType] || {
+    width: 150,
+    hideInSearch: false
+  };
+  var colDef = _objectSpread(_objectSpread({
+    // 使用嵌套路径访问 extraProperties 中的数据 @author nokecy
+    field: "extraProperties.".concat(field.name),
+    headerName: field.displayName,
+    width: config.width,
+    hideInSearch: config.hideInSearch
+  }, config.type && {
+    type: config.type
+  }), field.description && {
+    headerTooltip: field.description
+  });
+  return colDef;
+}
+
+/**
+ * 获取指定实体的扩展列定义
+ *
+ * @param entityType 实体类型全名 (如 "Burn.Product.Domain.Product")
+ * @param extensions 实体扩展配置映射
+ * @returns 扩展列定义数组，按 sortOrder 排序
+ */
+function getEntityExtensionColumns(entityType, extensions) {
+  // 边界情况处理：无效输入直接返回空数组
+  var entityConfig = entityType ? extensions === null || extensions === void 0 ? void 0 : extensions[entityType] : undefined;
+  var fields = entityConfig === null || entityConfig === void 0 ? void 0 : entityConfig.fields;
+  if (!fields || !Array.isArray(fields)) {
+    return [];
+  }
+
+  // 按 sortOrder 排序后转换为列定义
+  return _toConsumableArray(fields).sort(function (a, b) {
+    var _a$sortOrder, _b$sortOrder;
+    return ((_a$sortOrder = a.sortOrder) !== null && _a$sortOrder !== void 0 ? _a$sortOrder : 0) - ((_b$sortOrder = b.sortOrder) !== null && _b$sortOrder !== void 0 ? _b$sortOrder : 0);
+  }).map(fieldToColumnDef);
+}

package/dist/esm/ag-grid-plus/ag-gridPlus.js

@@ -1,7 +1,7 @@
 import _sumBy from "lodash/sumBy";
 import _uniqueId from "lodash/uniqueId";
 import _isArray from "lodash/isArray";
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableClickSelection", "rowSelection", "useNativeTreeFilter"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -54,6 +54,7 @@ import { extractItemsOrder, extractHiddenFields } from "./shared/utils/schemeDat
 import { createSafeHtmlTemplate } from "./utils/sanitize";
 import { GridPlusError, ErrorType, ErrorSeverity } from "./errors";
 import { logger } from "./utils/logger";
+import { getEntityExtensionColumns } from "./utils/entityExtensionColumns";
 import { message } from 'antd';
 var Text = Typography.Text;
 var getSort = function getSort(columnState) {
@@ -85,6 +86,7 @@ function AgGridPlus(props) {
     propsRowSelection = props.rowSelection,
     _props$useNativeTreeF = props.useNativeTreeFilter,
     useNativeTreeFilter = _props$useNativeTreeF === void 0 ? false : _props$useNativeTreeF,
+    entityType = props.entityType,
     rest = _objectWithoutProperties(props, _excluded);
   var _useGridPlusColumnSta = useGridPlusColumnState(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -96,7 +98,8 @@ function AgGridPlus(props) {
     globalConfigPermissions = _useGridPlusColumnSta.globalConfigPermissions,
     applySchemeToGlobal = _useGridPlusColumnSta.applySchemeToGlobal,
     resetToGlobal = _useGridPlusColumnSta.resetToGlobal,
-    resetAllUsers = _useGridPlusColumnSta.resetAllUsers;
+    resetAllUsers = _useGridPlusColumnSta.resetAllUsers,
+    hostEntityExtensions = _useGridPlusColumnSta.hostEntityExtensions;
   var gridRef = useRef();
   var apiRef = useRef();
   var allColDefsRef = useRef([]);
@@ -609,6 +612,30 @@ function AgGridPlus(props) {
         cellRenderer: cellRenderer
       });
     });
+
+    // 基于 entityType 自动注入扩展列 @author nokecy
+    // 从 context 的 hostEntityExtensions 获取对应实体的扩展字段并转换为列定义
+    var extensionCols = getEntityExtensionColumns(entityType, hostEntityExtensions);
+    if (extensionCols.length > 0) {
+      // 查找操作列位置（pinned='right' 或 field='action'），插入到其之前
+      var actionIndex = columnDefs.findIndex(function (col) {
+        return col.field === 'action' || col.pinned === 'right';
+      });
+      if (actionIndex === -1) {
+        var _columnDefs;
+        (_columnDefs = columnDefs).push.apply(_columnDefs, _toConsumableArray(extensionCols));
+      } else {
+        var _columnDefs2;
+        (_columnDefs2 = columnDefs).splice.apply(_columnDefs2, [actionIndex, 0].concat(_toConsumableArray(extensionCols)));
+      }
+      logger.debug('[AgGridPlus] 已注入实体扩展列', {
+        entityType: entityType,
+        extensionColsCount: extensionCols.length,
+        extensionCols: extensionCols.map(function (c) {
+          return c.field;
+        })
+      });
+    }
     return columnDefs;
   };
 
@@ -635,7 +662,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey]);
+  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions]);
 
   // 稳定化 gridParams 和 sortColumn 的引用
   var stableGridParams = useMemo(function () {
@@ -1259,7 +1286,9 @@ function AgGridPlus(props) {
       resetAllUsers: resetAllUsers,
       // ========== 全局方案回退状态 @author nokecy ==========
       isUsingGlobalFallback: isUsingGlobalFallback,
-      isUsingGlobalQueryFallback: isUsingGlobalQueryFallback
+      isUsingGlobalQueryFallback: isUsingGlobalQueryFallback,
+      // ========== 实体扩展字段配置 @author nokecy ==========
+      hostEntityExtensions: hostEntityExtensions
     };
   }, [extensibleColumns, gridPlusColumnState, allColDefsRef.current,
   // 【修复】添加到依赖数组
@@ -1271,7 +1300,9 @@ function AgGridPlus(props) {
   // 全局配置依赖
   globalConfigPermissions, applySchemeToGlobal, resetToGlobal, resetAllUsers,
   // 全局方案回退状态依赖 @author nokecy
-  isUsingGlobalFallback, isUsingGlobalQueryFallback]);
+  isUsingGlobalFallback, isUsingGlobalQueryFallback,
+  // 实体扩展字段配置依赖 @author nokecy
+  hostEntityExtensions]);
   return /*#__PURE__*/React.createElement(GridPlusContext.Provider, {
     value: gridPlusContextValue
   }, /*#__PURE__*/React.createElement(Spin, {

package/dist/esm/ag-grid-plus/context/gridContext.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { ColumnScheme, QueryScheme, CurrentSchemeDto } from "../shared/storage/schemeStorageAdapter";
 import type { GlobalConfigPermissions } from '../shared/permissions/globalConfigPermissions';
+import type { HostEntityExtensions } from '../types';
 /**
  * 方案管理 API 接口
  *
@@ -175,5 +176,10 @@ export interface GridPlusContextValue extends SchemeManagementAPI {
      * 是否使用全局查询方案作为回退
      */
     isUsingGlobalQueryFallback?: boolean;
+    /**
+     * 实体扩展字段配置映射
+     * 来自后端 ABP 配置，用于 AgGridPlus 根据 entityType 自动注入扩展列
+     */
+    hostEntityExtensions?: HostEntityExtensions;
 }
 export declare const GridPlusContext: React.Context<GridPlusContextValue>;

package/dist/esm/ag-grid-plus/index.d.ts

@@ -13,3 +13,5 @@ export type { UseSchemeManagerConfig } from "./context/useSchemeManager";
 export type { BackendApiAdapterConfig } from "./shared/storage/backendApiAdapter";
 export type { LocalStorageAdapterConfig } from "./shared/storage/localStorageAdapter";
 export type { GlobalConfigPermissions } from "./shared/permissions/globalConfigPermissions";
+export type { EntityExtensionField, EntityExtensionConfig, HostEntityExtensions } from "./types";
+export { fieldToColumnDef, getEntityExtensionColumns } from "./utils/entityExtensionColumns";

package/dist/esm/ag-grid-plus/index.js

@@ -15,5 +15,10 @@ export { BackendApiSchemeAdapter } from "./shared/storage/backendApiAdapter";
 
 // 权限相关类型
 
+// 实体扩展字段类型 @author nokecy
+
+// 实体扩展列工具函数 @author nokecy
+export { fieldToColumnDef, getEntityExtensionColumns } from "./utils/entityExtensionColumns";
+
 // 注意: 旧的查询方案管理功能已废弃
 // 相关导出已移除，请使用集中式方案管理 API (useSchemeManager/useGridSchemes)

package/dist/esm/ag-grid-plus/interface.d.ts

@@ -95,6 +95,15 @@ interface GridProps extends AgGridReactProps {
      * @default false
      */
     useNativeTreeFilter?: boolean;
+    /**
+     * 实体类型全名，用于自动注入扩展字段列
+     * 当配置此属性时，组件会自动从 context 的 hostEntityExtensions
+     * 获取对应实体的扩展字段并转换为列定义
+     *
+     * @example "Burn.Product.Domain.Product"
+     * @author nokecy
+     */
+    entityType?: string;
 }
 interface AgGridColumnPropsClone extends ColDef {
     /**

package/dist/esm/ag-grid-plus/types.d.ts

@@ -310,3 +310,36 @@ export type RowDataArray<T = any> = T[];
  * 查询表单项数组类型
  */
 export type QueryFormItems = QueryFormItem[];
+/**
+ * 扩展字段定义（来自后端 ABP 配置）
+ */
+export interface EntityExtensionField {
+    name: string;
+    displayName: string;
+    description?: string | null;
+    /** 数据类型: String, Int, Long, Decimal, Double, Float, Boolean, DateTime, Date, Guid, Enum, Text */
+    dataType: string;
+    maxLength?: number | null;
+    precision?: number | null;
+    scale?: number | null;
+    isRequired?: boolean;
+    sortOrder?: number;
+    uiComponent?: string | null;
+    placeholder?: string | null;
+    defaultValue?: any;
+    componentProps?: string | null;
+    validationRules?: string | null;
+}
+/**
+ * 单个实体的扩展配置
+ */
+export interface EntityExtensionConfig {
+    entityType: string;
+    displayName: string;
+    moduleName: string;
+    fields: EntityExtensionField[];
+}
+/**
+ * 实体扩展配置映射（key: 实体类型全名）
+ */
+export type HostEntityExtensions = Record<string, EntityExtensionConfig>;

package/dist/esm/ag-grid-plus/utils/entityExtensionColumns.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 实体扩展字段列转换工具
+ * 将后端 ABP 配置的扩展字段转换为 AG-Grid 列定义
+ *
+ * @author nokecy
+ */
+import type { ExtendedColDef, EntityExtensionField, HostEntityExtensions } from '../types';
+/**
+ * 将单个扩展字段转换为列定义
+ * 使用 extraProperties.xxx 嵌套路径访问数据
+ *
+ * @param field 扩展字段定义
+ * @returns AG-Grid 列定义
+ */
+export declare function fieldToColumnDef(field: EntityExtensionField): ExtendedColDef;
+/**
+ * 获取指定实体的扩展列定义
+ *
+ * @param entityType 实体类型全名 (如 "Burn.Product.Domain.Product")
+ * @param extensions 实体扩展配置映射
+ * @returns 扩展列定义数组，按 sortOrder 排序
+ */
+export declare function getEntityExtensionColumns(entityType: string | undefined, extensions?: HostEntityExtensions): ExtendedColDef[];