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

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

@@ -0,0 +1,351 @@
+"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 _statusPill = require("./statusPill");
+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$, _col$cellRenderer;
+  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 就用页面的，valueEnum 仍负责筛选与查询表单
+    cellRenderer: (_col$cellRenderer = col.cellRenderer) !== null && _col$cellRenderer !== void 0 ? _col$cellRenderer : function (params) {
+      var match = (0, _optionValue.findOptionByValue)(valueEnum, params.value, function (item) {
+        return item.value;
+      });
+      if (match) {
+        // 配了 status 的枚举项走状态胶囊（形状 + 文字 + 底色），不再看 color
+        if ((0, _statusPill.isStatusKey)(match.status)) {
+          // 传了 background（valueEnumContrast）且是深色表面时用深色版
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)(_statusPill.StatusPill, {
+            status: match.status,
+            dark: (0, _valueEnumColor.isDarkSurface)(background),
+            children: match.label
+          });
+        }
+        // 没配颜色的枚举项曾经默认成 '#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,48 @@
+/**
+ * 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[];
+/**
+ * 默认分页大小：DESIGN.md §7.3 规定每页默认 100（全量渲染的表格最大每页 100）。
+ * 页面可用 pageSize 覆盖。
+ */
+export declare const DEFAULT_PAGE_SIZE = 100;
+/**
+ * 隐藏分页时的默认分页大小
+ */
+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,63 @@
+"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];
+
+/**
+ * 默认分页大小：DESIGN.md §7.3 规定每页默认 100（全量渲染的表格最大每页 100）。
+ * 页面可用 pageSize 覆盖。
+ */
+var DEFAULT_PAGE_SIZE = exports.DEFAULT_PAGE_SIZE = 100;
+
+/**
+ * 隐藏分页时的默认分页大小
+ */
+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/crossPageSelection.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 跨页勾选（DESIGN.md §7.4）：服务端分页时翻页会换掉整批 rowData，AG Grid 的选中随之丢失。
+ * 这里按行 ID 记住所有已勾选的行，翻页回来后把当前页里命中的行重新勾上。
+ * 纯逻辑，不依赖 React，便于单测。
+ * @author nokecy
+ */
+import type { GridApi, IRowNode } from 'ag-grid-community';
+export interface CrossPageSelection<T = any> {
+    /** 行勾选状态变化时调用（来自 rowSelected 事件） */
+    track: (node: IRowNode<T>) => void;
+    /** 换页后把当前页里命中的行重新勾上，并用最新数据刷新记录；返回是否有改动 */
+    restore: (api: GridApi) => boolean;
+    /** 所有已勾选的行（含不在当前页的） */
+    rows: () => T[];
+    size: () => number;
+    /** 清空记录（不动网格，网格由调用方 deselectAll） */
+    clear: () => void;
+    /** 恢复勾选期间产生的事件不应改写记录 */
+    isRestoring: () => boolean;
+}
+export declare function createCrossPageSelection<T = any>(getId: (data: T) => string): CrossPageSelection<T>;

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

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createCrossPageSelection = createCrossPageSelection;
+/**
+ * 跨页勾选（DESIGN.md §7.4）：服务端分页时翻页会换掉整批 rowData，AG Grid 的选中随之丢失。
+ * 这里按行 ID 记住所有已勾选的行，翻页回来后把当前页里命中的行重新勾上。
+ * 纯逻辑，不依赖 React，便于单测。
+ * @author nokecy
+ */
+
+function createCrossPageSelection(getId) {
+  var picked = new Map();
+  var restoring = false;
+  return {
+    track: function track(node) {
+      if (restoring || !node.data) return;
+      var id = getId(node.data);
+      if (!id) return;
+      if (node.isSelected()) picked.set(id, node.data);else picked.delete(id);
+    },
+    restore: function restore(api) {
+      if (picked.size === 0) return false;
+      var changed = false;
+      restoring = true;
+      try {
+        api.forEachNode(function (node) {
+          if (!node.data) return;
+          var id = getId(node.data);
+          if (!picked.has(id)) return;
+          // 记录里的行数据换成最新一页的（审核等操作后列表刷新，业务拿到的应是新数据）
+          picked.set(id, node.data);
+          if (!node.isSelected()) {
+            node.setSelected(true, false, 'api');
+            changed = true;
+          }
+        });
+      } finally {
+        restoring = false;
+      }
+      return changed;
+    },
+    rows: function rows() {
+      return Array.from(picked.values());
+    },
+    size: function size() {
+      return picked.size;
+    },
+    clear: function clear() {
+      return picked.clear();
+    },
+    isRestoring: function isRestoring() {
+      return restoring;
+    }
+  };
+}

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

@@ -0,0 +1,56 @@
+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;
+    /** 后端给出的失败原因；加载失败且没有自定义文案时写成「加载失败，原因：…」 */
+    reason?: string;
+}): 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>;
+};