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

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

@@ -0,0 +1,102 @@
+"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: '没有查看权限，请联系管理员开通',
+  // 「试试调整筛选条件」只能出现在这一支（DESIGN.md §10.1）
+  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;
+  if (state.override) return state.override;
+  var branch = resolveEmptyBranch(state);
+  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];
+}
+
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `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[];

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

@@ -0,0 +1,155 @@
+"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
+  }
+};
+
+/**
+ * 将单个扩展字段转换为列定义
+ * 使用 {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))
+ */
+function fieldToColumnDef(field) {
+  var extraPropertiesPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'extraProperties';
+  // 防御 Array.map 将 index（number）传入第二参数的情况，回退到默认路径
+  var resolvedPath = typeof extraPropertiesPath === 'string' ? extraPropertiesPath : 'extraProperties';
+  var config = dataTypeColumnConfig[field.dataType] || {
+    width: 150,
+    hideInSearch: false
+  };
+  var colDef = _objectSpread(_objectSpread({
+    // 使用可配置前缀的嵌套路径访问扩展属性数据
+    field: "".concat(resolvedPath, ".").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 实体扩展配置映射
+ * @param extraPropertiesPath 扩展属性的路径前缀，默认 'extraProperties'（保持向后兼容）
+ * @returns 扩展列定义数组，按 sortOrder 排序
+ * @author nokecy
+ */
+function getEntityExtensionColumns(entityType, extensions) {
+  var extraPropertiesPath = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'extraProperties';
+  // 边界情况处理：无效输入直接返回空数组
+  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(function (f) {
+    return fieldToColumnDef(f, extraPropertiesPath);
+  });
+}

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/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AG-Grid Plus 日志工具
+ */
+declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error",
+    FATAL = "fatal"
+}
+interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: any;
+}
+declare class Logger {
+    private isDevelopment;
+    private enableConsole;
+    private logHistory;
+    private maxHistorySize;
+    private log;
+    debug(message: string, context?: any): void;
+    info(message: string, context?: any): void;
+    warn(message: string, context?: any): void;
+    error(message: string, context?: any): void;
+    fatal(message: string, context?: any): void;
+    getHistory(): LogEntry[];
+    clearHistory(): void;
+    setConsoleEnabled(enabled: boolean): void;
+}
+export declare const logger: Logger;
+export { LogLevel };
+export type { LogEntry };

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

@@ -0,0 +1,118 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.logger = exports.LogLevel = void 0;
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+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); }
+/**
+ * AG-Grid Plus 日志工具
+ */
+var LogLevel = exports.LogLevel = /*#__PURE__*/function (LogLevel) {
+  LogLevel["DEBUG"] = "debug";
+  LogLevel["INFO"] = "info";
+  LogLevel["WARN"] = "warn";
+  LogLevel["ERROR"] = "error";
+  LogLevel["FATAL"] = "fatal";
+  return LogLevel;
+}(LogLevel || {});
+var Logger = /*#__PURE__*/function () {
+  function Logger() {
+    _classCallCheck(this, Logger);
+    _defineProperty(this, "isDevelopment", process.env.NODE_ENV === 'development');
+    _defineProperty(this, "enableConsole", true);
+    _defineProperty(this, "logHistory", []);
+    _defineProperty(this, "maxHistorySize", 100);
+  }
+  _createClass(Logger, [{
+    key: "log",
+    value: function log(level, message, context) {
+      var entry = {
+        timestamp: new Date().toISOString(),
+        level: level,
+        message: message,
+        context: context
+      };
+
+      // 记录到历史
+      this.logHistory.push(entry);
+      if (this.logHistory.length > this.maxHistorySize) {
+        this.logHistory.shift();
+      }
+
+      // 控制台输出
+      if (this.enableConsole) {
+        var prefix = "[AG-Grid Plus] [".concat(level.toUpperCase(), "]");
+        var timestamp = new Date().toLocaleTimeString();
+        switch (level) {
+          case LogLevel.DEBUG:
+            this.isDevelopment && void 0;
+            break;
+          case LogLevel.INFO:
+            break;
+          case LogLevel.WARN:
+            console.warn("".concat(prefix, " ").concat(timestamp), message, context || '');
+            break;
+          case LogLevel.ERROR:
+          case LogLevel.FATAL:
+            console.error("".concat(prefix, " ").concat(timestamp), message, context || '');
+            break;
+        }
+      }
+    }
+  }, {
+    key: "debug",
+    value: function debug(message, context) {
+      this.log(LogLevel.DEBUG, message, context);
+    }
+  }, {
+    key: "info",
+    value: function info(message, context) {
+      this.log(LogLevel.INFO, message, context);
+    }
+  }, {
+    key: "warn",
+    value: function warn(message, context) {
+      this.log(LogLevel.WARN, message, context);
+    }
+  }, {
+    key: "error",
+    value: function error(message, context) {
+      this.log(LogLevel.ERROR, message, context);
+    }
+  }, {
+    key: "fatal",
+    value: function fatal(message, context) {
+      this.log(LogLevel.FATAL, message, context);
+    }
+  }, {
+    key: "getHistory",
+    value: function getHistory() {
+      return _toConsumableArray(this.logHistory);
+    }
+  }, {
+    key: "clearHistory",
+    value: function clearHistory() {
+      this.logHistory = [];
+    }
+  }, {
+    key: "setConsoleEnabled",
+    value: function setConsoleEnabled(enabled) {
+      this.enableConsole = enabled;
+    }
+  }]);
+  return Logger;
+}();
+var logger = exports.logger = new Logger();

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;