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

package/dist/esm/ag-grid-plus/utils/agGridLicenseNotice.js

@@ -0,0 +1,97 @@
+/**
+ * AG Grid Enterprise 试用提示收敛（组件库内统一处理，宿主不必再各自 patch node_modules）。
+ *
+ * ag-gridPlus.tsx 在模块顶层注册 AllEnterpriseModule，但组件库不内置 license key——
+ * 授权由宿主决定。未注入 key 时，AG Grid 会在每个表格实例创建时打印一整块星号框
+ * （"AG Grid Enterprise License / License Key Not Found"），并在表格右下角渲染
+ * .ag-watermark（5 秒后淡出）。
+ *
+ * 这里只在没有正式 key 时静默这块提示，水印由同目录 index.less 关闭。宿主拿到正式
+ * 授权后调用 setAgGridLicenseKey()，静默立即停用，AG Grid 恢复常规行为。
+ */
+import { LicenseManager } from 'ag-grid-enterprise';
+var STATE_KEY = '__qcUiAgGridLicenseNotice__';
+/** license 星号框同一批输出允许的最长间隔（毫秒）：块内分隔行可能异步到达。 */
+var BANNER_WINDOW_MS = 1000;
+
+/** 星号框正文行：`**** AG Grid Enterprise License ****` / `* ... trial. *`。 */
+function isLicenseLine(text) {
+  return /^\*+.*\*+$/.test(text) && /license|trial|watermark|ag-grid/i.test(text);
+}
+
+/** 星号框分隔行（整行都是星号）。 */
+function isBannerLine(text) {
+  return /^\*+$/.test(text);
+}
+
+/**
+ * 安装一次 console.error 过滤：只吞 AG Grid 的 license 星号框，其余错误保持原参数、
+ * 原调用对象输出，不改变业务日志。多个组件库副本/重复 import 只包一层。
+ */
+export function installAgGridLicenseNotice() {
+  if (typeof console === 'undefined') return;
+  var host = globalThis;
+  if (host[STATE_KEY]) return;
+  var originalError = console.error;
+  var state = {
+    originalError: originalError,
+    licensed: false
+  };
+  host[STATE_KEY] = state;
+
+  // 星号框第一行是纯星号、出现在关键词行之前：先暂存，确认是 license 块后丢弃；
+  // 若是别的来源打印的星号行，则在当前同步任务结束前原样补输出。
+  var pending = [];
+  var flushScheduled = false;
+  var lastLicenseAt = 0;
+  var flush = function flush() {
+    var lines = pending;
+    pending = [];
+    for (var _i = 0, _lines = lines; _i < _lines.length; _i++) {
+      var args = _lines[_i];
+      originalError.apply(console, args);
+    }
+  };
+  var scheduleFlush = function scheduleFlush() {
+    if (flushScheduled) return;
+    flushScheduled = true;
+    queueMicrotask(function () {
+      flushScheduled = false;
+      flush();
+    });
+  };
+  console.error = function () {
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    if (state.licensed) {
+      flush();
+      originalError.apply(console, args);
+      return;
+    }
+    var text = args.length === 1 && typeof args[0] === 'string' ? args[0].trim() : '';
+    if (isLicenseLine(text)) {
+      lastLicenseAt = Date.now();
+      pending = [];
+      return;
+    }
+    if (isBannerLine(text)) {
+      if (Date.now() - lastLicenseAt < BANNER_WINDOW_MS) return;
+      pending.push(args);
+      scheduleFlush();
+      return;
+    }
+    flush();
+    originalError.apply(console, args);
+  };
+}
+
+/** 注入正式 AG Grid Enterprise license key；注入后不再静默任何控制台输出。 */
+export function setAgGridLicenseKey(licenseKey) {
+  var key = licenseKey === null || licenseKey === void 0 ? void 0 : licenseKey.trim();
+  if (!key) return;
+  LicenseManager.setLicenseKey(key);
+  var host = globalThis;
+  var state = host[STATE_KEY];
+  if (state) state.licensed = true;
+}

package/dist/esm/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/esm/ag-grid-plus/utils/columnProcessors.js

@@ -10,7 +10,8 @@ import { Typography } from 'antd';
 import { Select } from '@nokecy/formily-antd';
 import { isArray } from 'lodash';
 import { DEFAULT_SEARCH_SORT_ORDER } from "./constants";
-import { toGridTextColor } from "./valueEnumColor";
+import { isDarkSurface, toGridTextColor } from "./valueEnumColor";
+import { isStatusKey, StatusPill } from "./statusPill";
 import { findOptionByValue } from "../../shared/optionValue";
 import { jsx as _jsx } from "react/jsx-runtime";
 var Text = Typography.Text;
@@ -138,7 +139,7 @@ export function mergeInferredColumnType(column, dataType) {
  * @author nokecy
  */
 export 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;
@@ -162,11 +163,21 @@ export 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 = findOptionByValue(valueEnum, params.value, function (item) {
         return item.value;
       });
       if (match) {
+        // 配了 status 的枚举项走状态胶囊（形状 + 文字 + 底色），不再看 color
+        if (isStatusKey(match.status)) {
+          // 传了 background（valueEnumContrast）且是深色表面时用深色版
+          return /*#__PURE__*/_jsx(StatusPill, {
+            status: match.status,
+            dark: isDarkSurface(background),
+            children: match.label
+          });
+        }
         // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
         // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色 的覆盖来擦屁股，
         // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy

package/dist/esm/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/esm/ag-grid-plus/utils/constants.js

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

package/dist/esm/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/esm/ag-grid-plus/utils/crossPageSelection.js

@@ -0,0 +1,52 @@
+/**
+ * 跨页勾选（DESIGN.md §7.4）：服务端分页时翻页会换掉整批 rowData，AG Grid 的选中随之丢失。
+ * 这里按行 ID 记住所有已勾选的行，翻页回来后把当前页里命中的行重新勾上。
+ * 纯逻辑，不依赖 React，便于单测。
+ * @author nokecy
+ */
+
+export 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/esm/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/esm/ag-grid-plus/utils/emptyState.js

@@ -23,9 +23,10 @@ export var 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;
@@ -66,10 +67,13 @@ export function resolveEmptyBranch(state) {
  * `override` 是调用方原来就在用的 `overlayNoRowsTemplateText`，保持最高优先级，向后兼容。
  */
 export 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/esm/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/esm/ag-grid-plus/utils/listKeyboard.js

@@ -0,0 +1,77 @@
+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） */
+export 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/esm/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/esm/ag-grid-plus/utils/pagination.js

@@ -0,0 +1,60 @@
+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); }
+import { DEFAULT_PAGE_SIZE, DEFAULT_PAGE_SIZE_WHEN_HIDDEN } from "./constants";
+
+/**
+ * 分页与默认列定义的纯函数，便于单测。
+ * @author nokecy
+ */
+
+/** 页面没传 pageSize 时的取值：分页默认 100（DESIGN.md §7.3），隐藏分页时一次取全。 */
+export function resolveInitialPageSize(pageSize, hidePagination) {
+  if (pageSize !== undefined) return pageSize;
+  return hidePagination ? DEFAULT_PAGE_SIZE_WHEN_HIDDEN : DEFAULT_PAGE_SIZE;
+}
+
+/**
+ * 把页码收进 [1, 末页]。total 未知（<=0，首次请求前）时只保证不小于 1，
+ * 否则首次加载前调用 goToPage(3) 会被无条件打回第 1 页。
+ */
+export 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（本地数据）模式的真正分页：只把当前页的行交给表格。 */
+export function sliceRowsByPage(rows, current, pageSize) {
+  var start = (current - 1) * pageSize;
+  return rows.slice(start, start + pageSize);
+}
+
+/** 分页左侧的总条数文案：第 a-b 条/总共 n 条。 */
+export 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 逐键合并，页面只改模板以外的参数时不丢内置表头模板。
+ */
+export 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/esm/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/esm/ag-grid-plus/utils/queryDispatch.js

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

package/dist/esm/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 {};