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

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

@@ -244,6 +244,7 @@ function resolveLegacySelectionOptions(input) {
     };
   }
   var isMultiRow = rowSelection.mode === 'multiRow';
+  var hasRowSelection = !!propsRowSelection;
   var fill = function fill(key, value) {
     if (value !== undefined && rowSelection[key] === undefined) rowSelection[key] = value;
   };
@@ -292,9 +293,16 @@ function resolveLegacySelectionOptions(input) {
     }
   }
 
+  // 页面没声明 rowSelection 也没写旧复选框标志时不带选择列（需要时页面显式声明）；
+  // 点击选行仍可用，只是不再凭空多出一列复选框。
+  if (!hasRowSelection && rowSelection.checkboxes === undefined) {
+    rowSelection.checkboxes = false;
+  }
+
   // ---- 单元格范围选择 ----
-  // 历史行为：AgGridPlus 固定开启范围选择，调用方的 enableRangeSelection 取值不起作用，这里保持开启。
-  var cellSelection = true;
+  // 默认关闭：开启后 Shift+↑↓ / Ctrl+A 在 AG Grid 里变成单元格范围选择，与列表键盘模型（DESIGN.md §7.9）冲突。
+  // 页面显式写 enableRangeSelection / 填充柄 / 范围柄，或直接传 cellSelection 时才开启。
+  var cellSelection = !!legacy.enableRangeSelection;
   var cell = {};
   if (legacy.suppressMultiRangeSelection) cell.suppressMultiRanges = true;
   if (legacy.enableFillHandle) {
@@ -312,7 +320,8 @@ function resolveLegacySelectionOptions(input) {
       mode: 'range'
     };
   }
-  if (Object.keys(cell).length > 0) cellSelection = cell;
+  // 只有范围选择开关或柄存在时才带上细项；单写 suppressMultiRangeSelection 不会把范围选择打开
+  if (Object.keys(cell).length > 0 && (cellSelection || cell.handle)) cellSelection = cell;
 
   // ---- 旧事件名 ----
   var eventHandlers = {};

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

@@ -1,4 +1,5 @@
 import { ColDef, ICellRendererParams } from 'ag-grid-community';
+import { type StatusKey } from './statusPill';
 /**
  * 扩展的列状态接口
  */
@@ -24,6 +25,8 @@ export interface ValueEnumItem {
     value: any;
     label: string;
     color?: string;
+    /** 状态语义，配置后渲染为状态胶囊，优先于 color */
+    status?: StatusKey;
     default?: boolean;
 }
 /**

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

@@ -21,6 +21,7 @@ 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 }; }
@@ -155,7 +156,7 @@ function mergeInferredColumnType(column, dataType) {
  * @author nokecy
  */
 function processEnumColumn(col, dataType, background) {
-  var _defaultItems$0$value, _defaultItems$;
+  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;
@@ -179,11 +180,21 @@ function processEnumColumn(col, dataType, background) {
   };
   var fallbackRenderer = col.enumFallbackRenderer;
   return _objectSpread(_objectSpread(_objectSpread({}, toColumnType(dataType)), col), {}, {
-    cellRenderer: function cellRenderer(params) {
+    // 页面显式传了 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

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

@@ -22,9 +22,10 @@ export declare const DEFAULT_SEARCH_SORT_ORDER = 999;
  */
 export declare const DEFAULT_PAGE_SIZE_OPTIONS: number[];
 /**
- * 默认分页大小
+ * 默认分页大小：DESIGN.md §7.3 规定每页默认 100（全量渲染的表格最大每页 100）。
+ * 页面可用 pageSize 覆盖。
  */
-export declare const DEFAULT_PAGE_SIZE = 200;
+export declare const DEFAULT_PAGE_SIZE = 100;
 /**
  * 隐藏分页时的默认分页大小
  */

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

@@ -32,9 +32,10 @@ var DEFAULT_SEARCH_SORT_ORDER = exports.DEFAULT_SEARCH_SORT_ORDER = 999;
 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 = 200;
+var DEFAULT_PAGE_SIZE = exports.DEFAULT_PAGE_SIZE = 100;
 
 /**
  * 隐藏分页时的默认分页大小

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

@@ -39,6 +39,8 @@ export declare function resolveEmptyText(state: {
     filtered?: boolean;
     override?: string;
     texts?: EmptyStateTexts;
+    /** 后端给出的失败原因；加载失败且没有自定义文案时写成「加载失败，原因：…」 */
+    reason?: string;
 }): string;
 /**
  * 选出空态浮层组件及其入参。

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

@@ -33,9 +33,10 @@ var DEFAULT_EMPTY_TEXTS = exports.DEFAULT_EMPTY_TEXTS = {
   // 不写方位：重试按钮就渲染在这句话正下方（见 shared/NoRowsOverlay）。
   // 原文写的是「请点上方「重试」」，方位指错了。@author nokecy
   error: '数据加载失败，可点下方按钮重试',
-  noPermission: '没有查看该数据的权限，请联系系统管理员',
-  noResult: '没有符合当前筛选条件的数据，试试放宽或清空筛选条件',
-  noData: '暂无数据'
+  noPermission: '没有查看权限，请联系管理员开通',
+  // 「试试调整筛选条件」只能出现在这一支（DESIGN.md §10.1）
+  noResult: '没有符合条件的结果，试试调整筛选条件',
+  noData: '还没有数据'
 };
 var isBlank = function isBlank(value) {
   if (value === undefined || value === null || value === '') return true;
@@ -76,10 +77,13 @@ function resolveEmptyBranch(state) {
  * `override` 是调用方原来就在用的 `overlayNoRowsTemplateText`，保持最高优先级，向后兼容。
  */
 function resolveEmptyText(state) {
-  var _state$texts$branch, _state$texts;
+  var _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];
+  var custom = (_state$texts = state.texts) === null || _state$texts === void 0 ? void 0 : _state$texts[branch];
+  if (custom) return custom;
+  if (branch === 'error' && state.reason) return "\u52A0\u8F7D\u5931\u8D25\uFF0C\u539F\u56E0\uFF1A".concat(state.reason);
+  return DEFAULT_EMPTY_TEXTS[branch];
 }
 
 /**

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

@@ -0,0 +1,24 @@
+/**
+ * 列表页表格区键盘模型（DESIGN.md §7.9）里需要基座接管的键位。
+ * ↑↓、Home/End、PageUp/PageDown、Space 沿用 AG Grid 自带行为，这里只补它没有的：
+ *
+ * - Alt+Shift+↑/↓：从活动行起连续勾选 / 取消（不用 Shift+↑↓，那是单元格范围选择）
+ * - Alt+A：全选当前页（不用 Ctrl/⌘+A，同上）
+ * - Ctrl/⌘+←/→：上一页 / 下一页
+ * - Esc：先清除勾选，再取消活动行
+ *
+ * 焦点在输入框、下拉、文本域内时一律不拦截。纯函数，便于单测。
+ * @author nokecy
+ */
+import type { GridApi } from 'ag-grid-community';
+export interface ListKeyboardOptions {
+    getApi: () => GridApi | undefined;
+    /** 翻页：-1 上一页，1 下一页；不传则不处理 Ctrl/⌘+←/→ */
+    onPage?: (delta: -1 | 1) => void;
+}
+type KeyLike = Pick<KeyboardEvent, 'key' | 'code' | 'altKey' | 'shiftKey' | 'ctrlKey' | 'metaKey' | 'preventDefault'> & {
+    target: EventTarget | null;
+};
+/** 返回 true 表示已处理（已 preventDefault） */
+export declare function createListKeyHandler({ getApi, onPage }: ListKeyboardOptions): (e: KeyLike) => boolean;
+export {};

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

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createListKeyHandler = createListKeyHandler;
+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); }
+/**
+ * 列表页表格区键盘模型（DESIGN.md §7.9）里需要基座接管的键位。
+ * ↑↓、Home/End、PageUp/PageDown、Space 沿用 AG Grid 自带行为，这里只补它没有的：
+ *
+ * - Alt+Shift+↑/↓：从活动行起连续勾选 / 取消（不用 Shift+↑↓，那是单元格范围选择）
+ * - Alt+A：全选当前页（不用 Ctrl/⌘+A，同上）
+ * - Ctrl/⌘+←/→：上一页 / 下一页
+ * - Esc：先清除勾选，再取消活动行
+ *
+ * 焦点在输入框、下拉、文本域内时一律不拦截。纯函数，便于单测。
+ * @author nokecy
+ */
+
+var EDITABLE = 'input, textarea, select, [contenteditable=""], [contenteditable="true"], .ag-cell-inline-editing';
+var isEditableTarget = function isEditableTarget(target) {
+  return !!target && typeof target.closest === 'function' && !!target.closest(EDITABLE);
+};
+var isMultiRow = function isMultiRow(api) {
+  var selection = api.getGridOption('rowSelection');
+  return !!selection && _typeof(selection) === 'object' && selection.mode === 'multiRow';
+};
+
+/** 返回 true 表示已处理（已 preventDefault） */
+function createListKeyHandler(_ref) {
+  var getApi = _ref.getApi,
+    onPage = _ref.onPage;
+  return function (e) {
+    var _api$isDestroyed;
+    var api = getApi();
+    if (!api || (_api$isDestroyed = api.isDestroyed) !== null && _api$isDestroyed !== void 0 && _api$isDestroyed.call(api) || isEditableTarget(e.target)) return false;
+
+    // Mac 上 Alt+A 的 key 是 å，用物理键位判断
+    if (e.altKey && !e.shiftKey && !e.ctrlKey && !e.metaKey && e.code === 'KeyA') {
+      if (!isMultiRow(api)) return false;
+      e.preventDefault();
+      api.selectAllFiltered();
+      return true;
+    }
+    if (e.altKey && e.shiftKey && !e.ctrlKey && !e.metaKey && (e.key === 'ArrowUp' || e.key === 'ArrowDown')) {
+      if (!isMultiRow(api)) return false;
+      var focused = api.getFocusedCell();
+      if (!focused) return false;
+      e.preventDefault();
+      var step = e.key === 'ArrowDown' ? 1 : -1;
+      var current = api.getDisplayedRowAtIndex(focused.rowIndex);
+      var next = api.getDisplayedRowAtIndex(focused.rowIndex + step);
+      if (!current || !next) return true; // 到头不循环
+      // 下一行已勾选：说明在回收这段连续勾选，取消活动行；否则连同活动行一起勾上
+      if (next.isSelected()) {
+        current.setSelected(false);
+      } else {
+        current.setSelected(true);
+        next.setSelected(true);
+      }
+      api.setFocusedCell(focused.rowIndex + step, focused.column);
+      return true;
+    }
+    if ((e.ctrlKey || e.metaKey) && !e.altKey && !e.shiftKey && (e.key === 'ArrowLeft' || e.key === 'ArrowRight')) {
+      if (!onPage) return false;
+      e.preventDefault();
+      onPage(e.key === 'ArrowRight' ? 1 : -1);
+      return true;
+    }
+    if (e.key === 'Escape' && !e.altKey && !e.ctrlKey && !e.metaKey && !e.shiftKey) {
+      if (api.getSelectedNodes().length > 0) {
+        api.deselectAll();
+        return true;
+      }
+      if (api.getFocusedCell()) {
+        api.clearFocusedCell();
+        return true;
+      }
+    }
+    return false;
+  };
+}

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

@@ -0,0 +1,26 @@
+import type { ColDef } from 'ag-grid-community';
+/**
+ * 分页与默认列定义的纯函数，便于单测。
+ * @author nokecy
+ */
+/** 页面没传 pageSize 时的取值：分页默认 100（DESIGN.md §7.3），隐藏分页时一次取全。 */
+export declare function resolveInitialPageSize(pageSize?: number, hidePagination?: boolean): number;
+/**
+ * 把页码收进 [1, 末页]。total 未知（<=0，首次请求前）时只保证不小于 1，
+ * 否则首次加载前调用 goToPage(3) 会被无条件打回第 1 页。
+ */
+export declare function clampPage(page: number, total: number, pageSize: number): number;
+/** dataSource（本地数据）模式的真正分页：只把当前页的行交给表格。 */
+export declare function sliceRowsByPage<T>(rows: readonly T[], current: number, pageSize: number): T[];
+/** 分页左侧的总条数文案：第 a-b 条/总共 n 条。 */
+export declare function formatPaginationTotal(total: number, current: number, pageSize: number): string;
+/**
+ * 合并默认列定义：内置 < 页面传入的 defaultColDef。
+ * 此前内置对象写在透传 props 之后，页面传的 defaultColDef 被整体覆盖，只能逐列配置。
+ * `headerFilter === false` 时把列头筛选按钮收起（suppressHeaderFilterButton），
+ * 不动 `filter`：列的 `filter` 还决定它是否出现在查询区。页面 defaultColDef 里显式写的同名项优先。
+ * headerComponentParams 逐键合并，页面只改模板以外的参数时不丢内置表头模板。
+ */
+export declare function mergeDefaultColDef(builtIn: ColDef<any>, custom: ColDef<any> | undefined, options?: {
+    headerFilter?: boolean;
+}): ColDef<any>;

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

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clampPage = clampPage;
+exports.formatPaginationTotal = formatPaginationTotal;
+exports.mergeDefaultColDef = mergeDefaultColDef;
+exports.resolveInitialPageSize = resolveInitialPageSize;
+exports.sliceRowsByPage = sliceRowsByPage;
+var _constants = require("./constants");
+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); }
+/**
+ * 分页与默认列定义的纯函数，便于单测。
+ * @author nokecy
+ */
+
+/** 页面没传 pageSize 时的取值：分页默认 100（DESIGN.md §7.3），隐藏分页时一次取全。 */
+function resolveInitialPageSize(pageSize, hidePagination) {
+  if (pageSize !== undefined) return pageSize;
+  return hidePagination ? _constants.DEFAULT_PAGE_SIZE_WHEN_HIDDEN : _constants.DEFAULT_PAGE_SIZE;
+}
+
+/**
+ * 把页码收进 [1, 末页]。total 未知（<=0，首次请求前）时只保证不小于 1，
+ * 否则首次加载前调用 goToPage(3) 会被无条件打回第 1 页。
+ */
+function clampPage(page, total, pageSize) {
+  var target = Number.isFinite(page) ? Math.max(1, Math.floor(page)) : 1;
+  if (!(total > 0) || !(pageSize > 0)) return target;
+  return Math.min(target, Math.max(1, Math.ceil(total / pageSize)));
+}
+
+/** dataSource（本地数据）模式的真正分页：只把当前页的行交给表格。 */
+function sliceRowsByPage(rows, current, pageSize) {
+  var start = (current - 1) * pageSize;
+  return rows.slice(start, start + pageSize);
+}
+
+/** 分页左侧的总条数文案：第 a-b 条/总共 n 条。 */
+function formatPaginationTotal(total, current, pageSize) {
+  if (total <= 0) return '第 0-0 条/总共 0 条';
+  var start = (current - 1) * pageSize + 1;
+  var end = Math.min(current * pageSize, total);
+  return "\u7B2C ".concat(start, "-").concat(end, " \u6761/\u603B\u5171 ").concat(total, " \u6761");
+}
+
+/**
+ * 合并默认列定义：内置 < 页面传入的 defaultColDef。
+ * 此前内置对象写在透传 props 之后，页面传的 defaultColDef 被整体覆盖，只能逐列配置。
+ * `headerFilter === false` 时把列头筛选按钮收起（suppressHeaderFilterButton），
+ * 不动 `filter`：列的 `filter` 还决定它是否出现在查询区。页面 defaultColDef 里显式写的同名项优先。
+ * headerComponentParams 逐键合并，页面只改模板以外的参数时不丢内置表头模板。
+ */
+function mergeDefaultColDef(builtIn, custom) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var base = options.headerFilter === false ? _objectSpread(_objectSpread({}, builtIn), {}, {
+    suppressHeaderFilterButton: true
+  }) : builtIn;
+  if (!custom) return base;
+  return _objectSpread(_objectSpread(_objectSpread({}, base), custom), {}, {
+    headerComponentParams: _objectSpread(_objectSpread({}, base.headerComponentParams), custom.headerComponentParams)
+  });
+}

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

@@ -0,0 +1,7 @@
+/**
+ * 内置查询（查询/重置/高级搜索）只发一次请求。
+ *
+ * 条件或页码变了，状态更新会让「条件/分页变化」的 effect 请求一次，此时不能再手动请求；
+ * 条件与页码都没变（用户点「查询」想重新取数），effect 不会触发，才需要手动请求。@author nokecy
+ */
+export declare function needsDirectRequest(prevFilter: unknown, nextFilter: unknown, currentPage: number): boolean;

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

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.needsDirectRequest = needsDirectRequest;
+var _isEqual = _interopRequireDefault(require("lodash/isEqual"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 内置查询（查询/重置/高级搜索）只发一次请求。
+ *
+ * 条件或页码变了，状态更新会让「条件/分页变化」的 effect 请求一次，此时不能再手动请求；
+ * 条件与页码都没变（用户点「查询」想重新取数），effect 不会触发，才需要手动请求。@author nokecy
+ */
+function needsDirectRequest(prevFilter, nextFilter, currentPage) {
+  return currentPage === 1 && (0, _isEqual.default)(prevFilter, nextFilter);
+}

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

@@ -0,0 +1,25 @@
+/**
+ * `valueEnum` 的状态胶囊：形状 + 文字 + 底色三重编码，去掉颜色后仍可凭形状与文字区分。
+ *
+ * 状态语义色属于语义层，不随主题变化，所以色值写在这里；
+ * 文字色对底色 ≥ 4.5:1，图标色对底色 ≥ 3:1。
+ */
+import React from 'react';
+export type StatusKey = 'wait' | 'running' | 'done' | 'warning' | 'alarm' | 'closed';
+type StatusIcon = 'ring' | 'half' | 'check' | 'warn' | 'cross' | 'dash';
+export declare const STATUS_PILL: Record<StatusKey, {
+    icon: StatusIcon;
+    fg: string;
+    bg: string;
+    mark: string;
+}>;
+/** 深色表面上的六态：底色压暗、文字与图标提亮，文字对底色 ≥ 4.5:1，图标 ≥ 3:1 */
+export declare const STATUS_PILL_DARK: typeof STATUS_PILL;
+export declare const isStatusKey: (v: unknown) => v is StatusKey;
+/** 表格单元格内的状态胶囊，高 18px，适配紧凑行高 */
+export declare const StatusPill: React.FC<{
+    status: StatusKey;
+    dark?: boolean;
+    children?: React.ReactNode;
+}>;
+export {};