@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.0

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

@@ -0,0 +1,340 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyColumnCellConfig = applyColumnCellConfig;
+exports.buildQueryFormItems = buildQueryFormItems;
+exports.createCellRenderer = createCellRenderer;
+exports.filterHiddenColumns = filterHiddenColumns;
+exports.handleGridPlusColumnState = handleGridPlusColumnState;
+exports.inferDataType = inferDataType;
+exports.mergeInferredColumnType = mergeInferredColumnType;
+exports.processEllipsisColumn = processEllipsisColumn;
+exports.processEnumColumn = processEnumColumn;
+exports.renderDefaultCell = renderDefaultCell;
+exports.toColumnType = toColumnType;
+var _agGridCompat = require("./agGridCompat");
+var _react = _interopRequireDefault(require("react"));
+var _antd = require("antd");
+var _formilyAntd = require("@nokecy/formily-antd");
+var _lodash = require("lodash");
+var _constants = require("./constants");
+var _valueEnumColor = require("./valueEnumColor");
+var _optionValue = require("../../shared/optionValue");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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 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); }
+var Text = _antd.Typography.Text;
+
+/**
+ * 扩展的列状态接口
+ */
+
+/**
+ * 列单元格配置映射
+ */
+
+/**
+ * 枚举值项
+ */
+
+/**
+ * 数据类型推断结果
+ */
+
+/**
+ * 处理列状态，提取单元格配置
+ *
+ * @param columnState 列状态数组
+ * @returns 字段到配置的映射
+ */
+function handleGridPlusColumnState(columnState) {
+  var cellConfigMap = {};
+  if ((0, _lodash.isArray)(columnState)) {
+    columnState.forEach(function (item) {
+      if (item.field && (item.cellClass || item.suppressHeaderFilterButton !== undefined || item.groupName)) {
+        cellConfigMap[item.field] = {
+          cellClass: item.cellClass,
+          suppressHeaderFilterButton: item.suppressHeaderFilterButton,
+          groupName: item.groupName
+        };
+      }
+    });
+  }
+  return cellConfigMap;
+}
+
+/**
+ * 推断数据类型
+ *
+ * @param data 数据对象
+ * @param colName 列名
+ * @param valueEnum 枚举值
+ * @returns 数据类型推断结果
+ */
+function inferDataType(data, colName, valueEnum) {
+  var value = data[colName];
+  if (typeof value === 'number') {
+    // 数值只决定对齐；合计必须由列定义显式声明。@author nokecy
+    return {
+      type: 'number',
+      calculateType: valueEnum !== null && valueEnum !== void 0 && valueEnum.length ? false : undefined
+    };
+  }
+  if (typeof value === 'boolean') {
+    return {
+      type: 'boolean',
+      calculateType: false
+    };
+  }
+  if (value instanceof Date) {
+    return {
+      type: 'date',
+      calculateType: false
+    };
+  }
+  return undefined;
+}
+
+/**
+ * 把「推断出的数据类型」翻译成列定义片段。
+ *
+ * dataType.type 是数据类型（number/string/...），不是 AG Grid 的列类型（columnTypes）。
+ * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
+ * 根本没有叫 number 的类型，这个字段一直没生效。
+ *
+ * 普通数值列右对齐；合计另由 calculateType 显式控制。
+ * 用 valueEnum 表示分类的数值列（状态码之类）不动。
+ *
+ * @author nokecy
+ */
+function toColumnType(dataType) {
+  if (!dataType) return {};
+  if (dataType.type === 'number' && dataType.calculateType !== false) {
+    return dataType.calculateType ? {
+      calculateType: dataType.calculateType,
+      type: 'rightAligned'
+    } : {
+      type: 'rightAligned'
+    };
+  }
+  return {
+    calculateType: dataType.calculateType
+  };
+}
+
+/** 显式列类型只控制显示方式，不遮蔽数值对齐或显式合计配置。@author nokecy */
+function mergeInferredColumnType(column, dataType) {
+  return _objectSpread(_objectSpread({}, toColumnType(dataType)), column);
+}
+
+/**
+ * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
+ *
+ * `cellRenderer` 必须在 `...col` 展开**之后**写入：否则业务传入的 `cellRenderer` 会把枚举映射盖掉，
+ * 列退回原始码；反过来，业务也无法靠自己的 `cellRenderer` 接管枚举列（这正是本函数的职责边界）。
+ *
+ * 命中枚举项：按 `match.color` 上色。`color` 是 **CSS 颜色**，语义档名（`success` 等）不是合法 CSS，
+ * 会被浏览器静默忽略、整列退回正文色 —— 消费方需用 `gridValueEnum()` 之类适配层先转成色值。
+ *
+ * **未命中枚举**（`null` / `undefined` / 空串 / 后端新增了码值而前端枚举未跟上）：
+ * - 列上配了 `enumFallbackRenderer` → 交给它渲染。业务侧据此输出中性「—」/「未知（原码）」，
+ *   不必再改壳；
+ * - 没配 → 原样返回该值（历史行为，保持向后兼容）。
+ *
+ * @param col 原始列定义
+ * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
+ * @param background 单元格底色（hex）。传入则把枚举颜色压/提到够读的对比度；不传则 color 原样输出
+ * @returns 处理后的列定义
+ * @author nokecy
+ */
+function processEnumColumn(col, dataType, background) {
+  var _defaultItems$0$value, _defaultItems$;
+  var valueEnum = col === null || col === void 0 ? void 0 : col.valueEnum;
+  if (!valueEnum || !Array.isArray(valueEnum)) {
+    return col;
+  }
+
+  // 统计默认值
+  var defaultItems = valueEnum.filter(function (item) {
+    return item.default;
+  });
+  var isMultiple = defaultItems.length > 1;
+  var defaultValue = isMultiple ? defaultItems.map(function (item) {
+    return item.value;
+  }) : (_defaultItems$0$value = (_defaultItems$ = defaultItems[0]) === null || _defaultItems$ === void 0 ? void 0 : _defaultItems$.value) !== null && _defaultItems$0$value !== void 0 ? _defaultItems$0$value : undefined;
+
+  // 值格式化函数
+  var valueFormatter = function valueFormatter(params) {
+    var match = (0, _optionValue.findOptionByValue)(valueEnum, params.value, function (item) {
+      return item.value;
+    });
+    return match ? match.label : params.value;
+  };
+  var fallbackRenderer = col.enumFallbackRenderer;
+  return _objectSpread(_objectSpread(_objectSpread({}, toColumnType(dataType)), col), {}, {
+    cellRenderer: function cellRenderer(params) {
+      var match = (0, _optionValue.findOptionByValue)(valueEnum, params.value, function (item) {
+        return item.value;
+      });
+      if (match) {
+        // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
+        // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色 的覆盖来擦屁股，
+        // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
+        // 传了 background 才启用对比度适配（AgGridPlus 的 valueEnumContrast）；否则 color 按 CSS 原样输出。@author nokecy
+        var color = background ? (0, _valueEnumColor.toGridTextColor)(match.color, background) : match.color || 'inherit';
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          style: {
+            color: color,
+            backgroundColor: 'transparent',
+            fontWeight: 500
+          },
+          children: match.label
+        });
+      }
+      if (typeof fallbackRenderer === 'function') {
+        return fallbackRenderer(params);
+      }
+      return params.value;
+    },
+    filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
+      valueFormatter: valueFormatter
+    }),
+    searchComponent: _formilyAntd.Select,
+    searchComponentProps: {
+      options: valueEnum.map(function (item) {
+        return {
+          label: item.label,
+          value: item.value
+        };
+      }),
+      mode: isMultiple ? 'multiple' : undefined,
+      defaultValue: defaultValue
+    }
+  });
+}
+
+/**
+ * 处理省略列定义
+ *
+ * @param col 原始列定义
+ * @returns 处理后的列定义
+ */
+function processEllipsisColumn(col) {
+  if (!col.ellipsis) {
+    return col;
+  }
+  return _objectSpread(_objectSpread({}, col), {}, {
+    // 块级占满单元格,对齐继承单元格的 text-align(列方案的左/中/右对齐、数字列右对齐);
+    // 以前写死 flex 居中,列方案选左对齐也居中,且 flex 容器里省略号不截断。@author nokecy
+    cellRenderer: function cellRenderer(_ref) {
+      var value = _ref.value;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(Text, {
+        ellipsis: {
+          tooltip: value
+        },
+        style: {
+          display: 'block',
+          width: '100%',
+          color: 'inherit',
+          lineHeight: 'inherit'
+        },
+        children: value
+      });
+    }
+  });
+}
+
+/**
+ * 默认单元格渲染：固定行（合计等）显示原值；数据行有自定义渲染器（`customCellRenderer`）时交给它；
+ * 否则显示 `valueFormatted`（列上配了 `valueFormatter` 时由 AG Grid 算好），没配则显示原值。
+ *
+ * 以前这里直接返回 `params.value`，普通列（没有 `type`、没有自定义渲染器）上写的 `valueFormatter`
+ * 被绕过：状态码列显示原码、「0/1」列显示 0/1，而不是格式化后的文字。
+ * 固定行保持原行为：格式化函数多按数据行写，空值常被格式化成「—」，不能让合计行冒出占位符。
+ *
+ * @author nokecy
+ */
+function renderDefaultCell(params) {
+  var _node$isRowPinned;
+  var value = params.value,
+    valueFormatted = params.valueFormatted,
+    node = params.node,
+    colDef = params.colDef;
+  if (node !== null && node !== void 0 && (_node$isRowPinned = node.isRowPinned) !== null && _node$isRowPinned !== void 0 && _node$isRowPinned.call(node)) return value;
+  var customRenderer = (0, _agGridCompat.getQcColDefProp)(colDef, 'customCellRenderer');
+  if (!customRenderer) return valueFormatted !== null && valueFormatted !== void 0 ? valueFormatted : value;
+  return customRenderer(params);
+}
+
+/**
+ * 创建自定义单元格渲染器包装
+ *
+ * @param _customRenderer 保留参数，实际取列上的 `customCellRenderer`
+ * @returns 包装后的渲染器
+ */
+function createCellRenderer(_customRenderer) {
+  return renderDefaultCell;
+}
+
+/**
+ * 构建查询表单项
+ *
+ * @param colDefs 列定义数组
+ * @returns 查询表单项数组
+ */
+function buildQueryFormItems(colDefs) {
+  return colDefs.filter(function (col) {
+    return col.filter !== false && !col.hideInSearch;
+  }).map(function (col) {
+    var _col$queryField, _col$searchSort;
+    return _objectSpread({
+      field: (_col$queryField = col.queryField) !== null && _col$queryField !== void 0 ? _col$queryField : col.field,
+      headerName: col.headerName,
+      order: (_col$searchSort = col.searchSort) !== null && _col$searchSort !== void 0 ? _col$searchSort : _constants.DEFAULT_SEARCH_SORT_ORDER
+    }, col);
+  });
+}
+
+/**
+ * 应用列单元格配置
+ *
+ * @param columnDefs 列定义数组
+ * @param columnCellConfig 单元格配置映射
+ * @returns 应用配置后的列定义
+ */
+function applyColumnCellConfig(columnDefs, columnCellConfig) {
+  return columnDefs.map(function (colDef) {
+    var cellConfig = columnCellConfig[colDef.field];
+    if (cellConfig) {
+      if (cellConfig.cellClass) {
+        colDef.cellClass = cellConfig.cellClass;
+      }
+      if (cellConfig.groupName) {
+        colDef.groupName = cellConfig.groupName;
+      }
+      if (cellConfig.suppressHeaderFilterButton !== undefined) {
+        colDef.suppressHeaderFilterButton = !cellConfig.suppressHeaderFilterButton;
+      }
+    }
+    return colDef;
+  });
+}
+
+/**
+ * 过滤隐藏列
+ *
+ * @param columnDefs 列定义数组
+ * @returns 过滤后的列定义
+ */
+function filterHiddenColumns(columnDefs) {
+  return columnDefs.filter(function (col) {
+    return !col.hideInTable;
+  });
+}

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

@@ -0,0 +1,47 @@
+/**
+ * AG-Grid Plus 常量定义
+ */
+/**
+ * 列状态应用延迟（毫秒）
+ * AG-Grid 需要延迟应用列状态以确保 DOM 已就绪
+ */
+export declare const COLUMN_STATE_APPLY_DELAY = 10;
+/**
+ * 默认查询表单排序顺序
+ * 用于未指定 searchSort 的列
+ */
+export declare const DEFAULT_SEARCH_SORT_ORDER = 999;
+/**
+ * 默认分页大小选项
+ */
+/**
+ * 一次取 10000 行会让车间那台低配 PC 直接卡死，而且没有哪个岗位需要一屏翻一万行——
+ * 要全量数据应该走导出。上限收到 1000。
+ * 不分页场景另有 DEFAULT_PAGE_SIZE_WHEN_HIDDEN，不受这里影响。
+ * @author nokecy
+ */
+export declare const DEFAULT_PAGE_SIZE_OPTIONS: number[];
+/**
+ * 默认分页大小
+ */
+export declare const DEFAULT_PAGE_SIZE = 200;
+/**
+ * 隐藏分页时的默认分页大小
+ */
+export declare const DEFAULT_PAGE_SIZE_WHEN_HIDDEN = 10000;
+/**
+ * 计算列默认小数位数
+ */
+export declare const DEFAULT_DECIMAL_PLACES = 2;
+/**
+ * 空数据默认提示文本
+ */
+export declare const DEFAULT_EMPTY_TEXT = "\u6CA1\u6709\u627E\u5230\u6570\u636E\uFF0C\u8BD5\u8BD5\u8C03\u6574\u7B5B\u9009\u6761\u4EF6\u5427\uFF01";
+/**
+ * 请求防抖延迟（毫秒）
+ */
+export declare const REQUEST_DEBOUNCE_DELAY = 300;
+/**
+ * 列配置保存防抖延迟（毫秒）
+ */
+export declare const COLUMN_STATE_SAVE_DEBOUNCE_DELAY = 300;

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

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.REQUEST_DEBOUNCE_DELAY = exports.DEFAULT_SEARCH_SORT_ORDER = exports.DEFAULT_PAGE_SIZE_WHEN_HIDDEN = exports.DEFAULT_PAGE_SIZE_OPTIONS = exports.DEFAULT_PAGE_SIZE = exports.DEFAULT_EMPTY_TEXT = exports.DEFAULT_DECIMAL_PLACES = exports.COLUMN_STATE_SAVE_DEBOUNCE_DELAY = exports.COLUMN_STATE_APPLY_DELAY = void 0;
+/**
+ * AG-Grid Plus 常量定义
+ */
+
+/**
+ * 列状态应用延迟（毫秒）
+ * AG-Grid 需要延迟应用列状态以确保 DOM 已就绪
+ */
+var COLUMN_STATE_APPLY_DELAY = exports.COLUMN_STATE_APPLY_DELAY = 10;
+
+/**
+ * 默认查询表单排序顺序
+ * 用于未指定 searchSort 的列
+ */
+var DEFAULT_SEARCH_SORT_ORDER = exports.DEFAULT_SEARCH_SORT_ORDER = 999;
+
+/**
+ * 默认分页大小选项
+ */
+/**
+ * 一次取 10000 行会让车间那台低配 PC 直接卡死，而且没有哪个岗位需要一屏翻一万行——
+ * 要全量数据应该走导出。上限收到 1000。
+ * 不分页场景另有 DEFAULT_PAGE_SIZE_WHEN_HIDDEN，不受这里影响。
+ * @author nokecy
+ */
+var DEFAULT_PAGE_SIZE_OPTIONS = exports.DEFAULT_PAGE_SIZE_OPTIONS = [10, 20, 50, 100, 200, 500, 1000];
+
+/**
+ * 默认分页大小
+ */
+var DEFAULT_PAGE_SIZE = exports.DEFAULT_PAGE_SIZE = 200;
+
+/**
+ * 隐藏分页时的默认分页大小
+ */
+var DEFAULT_PAGE_SIZE_WHEN_HIDDEN = exports.DEFAULT_PAGE_SIZE_WHEN_HIDDEN = 10000;
+
+/**
+ * 计算列默认小数位数
+ */
+var DEFAULT_DECIMAL_PLACES = exports.DEFAULT_DECIMAL_PLACES = 2;
+
+/**
+ * 空数据默认提示文本
+ */
+var DEFAULT_EMPTY_TEXT = exports.DEFAULT_EMPTY_TEXT = '没有找到数据，试试调整筛选条件吧！';
+
+/**
+ * 请求防抖延迟（毫秒）
+ */
+var REQUEST_DEBOUNCE_DELAY = exports.REQUEST_DEBOUNCE_DELAY = 300;
+
+/**
+ * 列配置保存防抖延迟（毫秒）
+ */
+var COLUMN_STATE_SAVE_DEBOUNCE_DELAY = exports.COLUMN_STATE_SAVE_DEBOUNCE_DELAY = 300;

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

@@ -0,0 +1,54 @@
+import type { QueryFilterState } from '../types';
+/**
+ * 表格空态四分。
+ *
+ * 原来空态的全部表达能力是一个字符串，兜底文案是「没有找到数据，试试调整筛选条件吧！」——
+ * 请求失败时显示的也是这一句。在 MES 这类业务里，「这条数据确实没有」和「接口挂了」
+ * 导向完全相反的动作（去补录 vs 去叫 IT），用同一句话回答，还主动把用户往筛选条件上引，
+ * 是一次系统性的假阴性。
+ *
+ * 这里把空态拆成四支：加载失败 / 无权限 / 筛选无结果 / 无数据，逻辑写成纯函数便于单测。
+ *
+ * @author nokecy
+ */
+export type EmptyStateBranch = 'error' | 'noPermission' | 'noResult' | 'noData';
+/** 四支文案，按支覆盖。不传的支走默认。 */
+export type EmptyStateTexts = Partial<Record<EmptyStateBranch, string>>;
+export declare const DEFAULT_EMPTY_TEXTS: Record<EmptyStateBranch, string>;
+/**
+ * 判断本次请求是否带着生效筛选。
+ * 只有它为真，空结果才该说「换个筛选条件试试」；否则说「暂无数据」。
+ *
+ * @param filterString buildFilterString 的产物，涵盖简单查询与高级查询
+ * @param queryFilter  查询表单当前值，用于兜住 filterString 尚未覆盖的场景
+ */
+export declare function hasEffectiveFilter(filterString?: string, queryFilter?: QueryFilterState | null): boolean;
+/** 选出当前该走哪一支。优先级：加载失败 > 无权限 > 筛选无结果 > 无数据。 */
+export declare function resolveEmptyBranch(state: {
+    hasError?: boolean;
+    accessible?: boolean;
+    filtered?: boolean;
+}): EmptyStateBranch;
+/**
+ * 算出最终要显示的空态文案。
+ * `override` 是调用方原来就在用的 `overlayNoRowsTemplateText`，保持最高优先级，向后兼容。
+ */
+export declare function resolveEmptyText(state: {
+    hasError?: boolean;
+    accessible?: boolean;
+    filtered?: boolean;
+    override?: string;
+    texts?: EmptyStateTexts;
+}): string;
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `noRowsOverlayComponent` 就用调用方的：宿主往往有自己的空态（例如无数据时带「新建」按钮、
+ * 外部筛选栏的「清空筛选」），此前内置浮层写死在 `...rest` 之后，把它们全部覆盖掉了。
+ * 入参合并：内置的 branch / text / onRetry 照样传给自定义组件，调用方同名入参优先。
+ *
+ * @author nokecy
+ */
+export declare function resolveNoRowsOverlay<C, P extends object>(builtIn: C, builtInParams: P, custom?: C | null, customParams?: Record<string, any> | null): {
+    component: C;
+    params: P & Record<string, any>;
+};

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

@@ -0,0 +1,98 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_EMPTY_TEXTS = void 0;
+exports.hasEffectiveFilter = hasEffectiveFilter;
+exports.resolveEmptyBranch = resolveEmptyBranch;
+exports.resolveEmptyText = resolveEmptyText;
+exports.resolveNoRowsOverlay = resolveNoRowsOverlay;
+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); }
+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); }
+/**
+ * 表格空态四分。
+ *
+ * 原来空态的全部表达能力是一个字符串，兜底文案是「没有找到数据，试试调整筛选条件吧！」——
+ * 请求失败时显示的也是这一句。在 MES 这类业务里，「这条数据确实没有」和「接口挂了」
+ * 导向完全相反的动作（去补录 vs 去叫 IT），用同一句话回答，还主动把用户往筛选条件上引，
+ * 是一次系统性的假阴性。
+ *
+ * 这里把空态拆成四支：加载失败 / 无权限 / 筛选无结果 / 无数据，逻辑写成纯函数便于单测。
+ *
+ * @author nokecy
+ */
+
+/** 四支文案，按支覆盖。不传的支走默认。 */
+
+var DEFAULT_EMPTY_TEXTS = exports.DEFAULT_EMPTY_TEXTS = {
+  // 不写方位：重试按钮就渲染在这句话正下方（见 shared/NoRowsOverlay）。
+  // 原文写的是「请点上方「重试」」，方位指错了。@author nokecy
+  error: '数据加载失败，可点下方按钮重试',
+  noPermission: '没有查看该数据的权限，请联系系统管理员',
+  noResult: '没有符合当前筛选条件的数据，试试放宽或清空筛选条件',
+  noData: '暂无数据'
+};
+var isBlank = function isBlank(value) {
+  if (value === undefined || value === null || value === '') return true;
+  if (Array.isArray(value)) return value.length === 0;
+  return false;
+};
+
+/**
+ * 判断本次请求是否带着生效筛选。
+ * 只有它为真，空结果才该说「换个筛选条件试试」；否则说「暂无数据」。
+ *
+ * @param filterString buildFilterString 的产物，涵盖简单查询与高级查询
+ * @param queryFilter  查询表单当前值，用于兜住 filterString 尚未覆盖的场景
+ */
+function hasEffectiveFilter(filterString, queryFilter) {
+  if (typeof filterString === 'string' && filterString.trim() !== '') return true;
+  if (!queryFilter || _typeof(queryFilter) !== 'object') return false;
+  var anyFilter = queryFilter;
+  if (anyFilter.__advancedMode__) {
+    var _anyFilter$__rules__$, _anyFilter$__rules__;
+    return ((_anyFilter$__rules__$ = (_anyFilter$__rules__ = anyFilter.__rules__) === null || _anyFilter$__rules__ === void 0 || (_anyFilter$__rules__ = _anyFilter$__rules__.children) === null || _anyFilter$__rules__ === void 0 ? void 0 : _anyFilter$__rules__.length) !== null && _anyFilter$__rules__$ !== void 0 ? _anyFilter$__rules__$ : 0) > 0;
+  }
+  return Object.values(anyFilter).some(function (value) {
+    return !isBlank(value);
+  });
+}
+
+/** 选出当前该走哪一支。优先级：加载失败 > 无权限 > 筛选无结果 > 无数据。 */
+function resolveEmptyBranch(state) {
+  if (state.hasError) return 'error';
+  if (state.accessible === false) return 'noPermission';
+  if (state.filtered) return 'noResult';
+  return 'noData';
+}
+
+/**
+ * 算出最终要显示的空态文案。
+ * `override` 是调用方原来就在用的 `overlayNoRowsTemplateText`，保持最高优先级，向后兼容。
+ */
+function resolveEmptyText(state) {
+  var _state$texts$branch, _state$texts;
+  if (state.override) return state.override;
+  var branch = resolveEmptyBranch(state);
+  return (_state$texts$branch = (_state$texts = state.texts) === null || _state$texts === void 0 ? void 0 : _state$texts[branch]) !== null && _state$texts$branch !== void 0 ? _state$texts$branch : DEFAULT_EMPTY_TEXTS[branch];
+}
+
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `noRowsOverlayComponent` 就用调用方的：宿主往往有自己的空态（例如无数据时带「新建」按钮、
+ * 外部筛选栏的「清空筛选」），此前内置浮层写死在 `...rest` 之后，把它们全部覆盖掉了。
+ * 入参合并：内置的 branch / text / onRetry 照样传给自定义组件，调用方同名入参优先。
+ *
+ * @author nokecy
+ */
+function resolveNoRowsOverlay(builtIn, builtInParams, custom, customParams) {
+  return {
+    component: custom !== null && custom !== void 0 ? custom : builtIn,
+    params: customParams ? _objectSpread(_objectSpread({}, builtInParams), customParams) : builtInParams
+  };
+}

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

@@ -0,0 +1,32 @@
+/**
+ * 实体扩展字段列转换工具
+ * 将后端 ABP 配置的扩展字段转换为 AG-Grid 列定义
+ *
+ * @author nokecy
+ */
+import type { ExtendedColDef, EntityExtensionField, HostEntityExtensions } from '../types';
+/**
+ * 将单个扩展字段转换为列定义
+ * 使用 {extraPropertiesPath}.xxx 嵌套路径访问数据
+ *
+ * @param field 扩展字段定义
+ * @param extraPropertiesPath 扩展属性的路径前缀，默认 'extraProperties'（保持向后兼容）
+ * @returns AG-Grid 列定义
+ * @author nokecy
+ *
+ * @warning 请勿将此函数直接传给 Array.prototype.map()。
+ * Array.map 会将 (element, index, array) 全部传入，index（数字）会绑定到
+ * extraPropertiesPath，导致 field 路径变为 '0.foo'、'1.bar' 等非法值。
+ * 请始终用箭头函数包装：someArray.map((f) => fieldToColumnDef(f, path))
+ */
+export declare function fieldToColumnDef(field: EntityExtensionField, extraPropertiesPath?: string): ExtendedColDef;
+/**
+ * 获取指定实体的扩展列定义
+ *
+ * @param entityType 实体类型全名 (如 "Burn.Product.Domain.Product")
+ * @param extensions 实体扩展配置映射
+ * @param extraPropertiesPath 扩展属性的路径前缀，默认 'extraProperties'（保持向后兼容）
+ * @returns 扩展列定义数组，按 sortOrder 排序
+ * @author nokecy
+ */
+export declare function getEntityExtensionColumns(entityType: string | undefined, extensions?: HostEntityExtensions, extraPropertiesPath?: string): ExtendedColDef[];