@nokecy/qc-ui 1.1.76 → 1.1.78

package/dist/cjs/standardList/index.js

@@ -0,0 +1,176 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "GridEmptyContext", {
+  enumerable: true,
+  get: function get() {
+    return _emptyState.GridEmptyContext;
+  }
+});
+Object.defineProperty(exports, "GridEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _emptyState.GridEmptyState;
+  }
+});
+Object.defineProperty(exports, "StandardAgGridColumn", {
+  enumerable: true,
+  get: function get() {
+    return _StandardAgGridPlus.StandardAgGridColumn;
+  }
+});
+Object.defineProperty(exports, "StandardAgGridPlus", {
+  enumerable: true,
+  get: function get() {
+    return _StandardAgGridPlus.StandardAgGridPlus;
+  }
+});
+Object.defineProperty(exports, "applyColDefSort", {
+  enumerable: true,
+  get: function get() {
+    return _gridColumnDefs.applyColDefSort;
+  }
+});
+Object.defineProperty(exports, "applyGridValueEnumToColumns", {
+  enumerable: true,
+  get: function get() {
+    return _enumColumns.applyGridValueEnumToColumns;
+  }
+});
+Object.defineProperty(exports, "applyNormalizedEnumFallbacksToColumns", {
+  enumerable: true,
+  get: function get() {
+    return _enumColumns.applyNormalizedEnumFallbacksToColumns;
+  }
+});
+Object.defineProperty(exports, "compositeClasses", {
+  enumerable: true,
+  get: function get() {
+    return _groupedHeaders.compositeClasses;
+  }
+});
+Object.defineProperty(exports, "createNormalizedEnumFallbackRenderer", {
+  enumerable: true,
+  get: function get() {
+    return _enumColumns.createNormalizedEnumFallbackRenderer;
+  }
+});
+Object.defineProperty(exports, "detachLiveSortFromColumnDefs", {
+  enumerable: true,
+  get: function get() {
+    return _gridColumnDefs.detachLiveSortFromColumnDefs;
+  }
+});
+Object.defineProperty(exports, "firstGridSorter", {
+  enumerable: true,
+  get: function get() {
+    return _gridColumnDefs.firstGridSorter;
+  }
+});
+Object.defineProperty(exports, "flattenColumnDefs", {
+  enumerable: true,
+  get: function get() {
+    return _listDefaultSort.flattenColumnDefs;
+  }
+});
+Object.defineProperty(exports, "formatDate", {
+  enumerable: true,
+  get: function get() {
+    return _dateFormat.formatDate;
+  }
+});
+Object.defineProperty(exports, "formatDateTime", {
+  enumerable: true,
+  get: function get() {
+    return _dateFormat.formatDateTime;
+  }
+});
+Object.defineProperty(exports, "getCompositeColumnEdges", {
+  enumerable: true,
+  get: function get() {
+    return _groupedHeaders.getCompositeColumnEdges;
+  }
+});
+Object.defineProperty(exports, "getListDateType", {
+  enumerable: true,
+  get: function get() {
+    return _listDateDisplay.getListDateType;
+  }
+});
+Object.defineProperty(exports, "hasActiveFilter", {
+  enumerable: true,
+  get: function get() {
+    return _emptyState.hasActiveFilter;
+  }
+});
+Object.defineProperty(exports, "inferListDefaultSort", {
+  enumerable: true,
+  get: function get() {
+    return _listDefaultSort.inferListDefaultSort;
+  }
+});
+Object.defineProperty(exports, "normalizeExtendedDateColumn", {
+  enumerable: true,
+  get: function get() {
+    return _listDateDisplay.normalizeExtendedDateColumn;
+  }
+});
+Object.defineProperty(exports, "normalizeListDateColumn", {
+  enumerable: true,
+  get: function get() {
+    return _listDateDisplay.normalizeListDateColumn;
+  }
+});
+Object.defineProperty(exports, "readRefreshToken", {
+  enumerable: true,
+  get: function get() {
+    return _listRefresh.readRefreshToken;
+  }
+});
+Object.defineProperty(exports, "resolveListSortPolicy", {
+  enumerable: true,
+  get: function get() {
+    return _listDefaultSort.resolveListSortPolicy;
+  }
+});
+Object.defineProperty(exports, "shouldRefresh", {
+  enumerable: true,
+  get: function get() {
+    return _listRefresh.shouldRefresh;
+  }
+});
+Object.defineProperty(exports, "sortingText", {
+  enumerable: true,
+  get: function get() {
+    return _listDefaultSort.sortingText;
+  }
+});
+Object.defineProperty(exports, "withCompositeGroupHeader", {
+  enumerable: true,
+  get: function get() {
+    return _groupedHeaders.withCompositeGroupHeader;
+  }
+});
+Object.defineProperty(exports, "withCompositeLeafHeader", {
+  enumerable: true,
+  get: function get() {
+    return _groupedHeaders.withCompositeLeafHeader;
+  }
+});
+Object.defineProperty(exports, "withRefreshToken", {
+  enumerable: true,
+  get: function get() {
+    return _listRefresh.withRefreshToken;
+  }
+});
+var _StandardAgGridPlus = require("./StandardAgGridPlus");
+var _emptyState = require("./emptyState");
+var _gridColumnDefs = require("./gridColumnDefs");
+var _groupedHeaders = require("./groupedHeaders");
+var _listDateDisplay = require("./listDateDisplay");
+var _dateFormat = require("./dateFormat");
+var _listDefaultSort = require("./listDefaultSort");
+var _listRefresh = require("./listRefresh");
+var _enumColumns = require("./enumColumns");

package/dist/cjs/standardList/listDateDisplay.d.ts

@@ -0,0 +1,9 @@
+type DateColumn = Record<string, any>;
+type ListDateType = 'dateColumn' | 'dateTimeColumn';
+/** 从日期类型、字段及标题识别日历日期与操作时间，排除耗时和工时。@author nokecy */
+export declare const getListDateType: (column: DateColumn) => ListDateType | undefined;
+/** 列表只格式化展示值，保留数据源中的日期供排序、筛选及提交使用。@author nokecy */
+export declare const normalizeListDateColumn: <T extends DateColumn>(column: T) => T;
+/** 配置扩展列由表格内部追加，必须在注入前配置日期渲染器。@author nokecy */
+export declare const normalizeExtendedDateColumn: <T extends DateColumn>(column: T) => T;
+export {};

package/dist/cjs/standardList/listDateDisplay.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.normalizeListDateColumn = exports.normalizeExtendedDateColumn = exports.getListDateType = void 0;
+var _dateFormat = require("./dateFormat");
+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 */
+var getListDateType = exports.getListDateType = function getListDateType(column) {
+  var _column$field, _column$headerName;
+  var types = (Array.isArray(column.type) ? column.type : [column.type]).map(String);
+  var field = String((_column$field = column.field) !== null && _column$field !== void 0 ? _column$field : '');
+  var title = String((_column$headerName = column.headerName) !== null && _column$headerName !== void 0 ? _column$headerName : '');
+  if (types.some(function (type) {
+    return /^(?:dateTimeColumn|dateTime|DateTimeOffset|System\.DateTime(?:Offset)?)$/i.test(type);
+  })) return 'dateTimeColumn';
+  if (types.some(function (type) {
+    return /^(?:numericColumn|numberColumn|number|rightAligned|bool|boolean)$/i.test(type);
+  }) || /耗时|时长|工时|天数|毫秒|秒数|分钟数|星期/.test(title) || /(?:Duration|Days|TimeMs|TimeSeconds|TimeMinutes)$/.test(field)) return undefined;
+  if (/时间/.test(title)) return 'dateTimeColumn';
+  if (types.some(function (type) {
+    return /^(?:dateColumn|date|DateOnly|System\.DateOnly)$/i.test(type);
+  })) return 'dateColumn';
+  if (/(?:Time|At)$/.test(field) || /^(?:time|createdAt|updatedAt|occurredAt)$/i.test(field) || /(?:Create|Creation|Submit|Submitted|Check|Audit|Approve|Approval|Edit|Editor|Modify|Modified|Change|Update|Confirm|Review)Date$/.test(field) || /^(?:create|creation|submit|check|audit|edit|editor|modify|modified|change|update|confirm|review)Date$/i.test(field)) return 'dateTimeColumn';
+  if (/(?:Date)$/.test(field) || /^date$/i.test(field) || /日期|交期|开始日|结束日|截止日/.test(title)) return 'dateColumn';
+  return undefined;
+};
+
+/** 列表只格式化展示值，保留数据源中的日期供排序、筛选及提交使用。@author nokecy */
+var normalizeListDateColumn = exports.normalizeListDateColumn = function normalizeListDateColumn(column) {
+  var _column$type, _column$cellRenderer;
+  var dateType = getListDateType(column);
+  if (!dateType) return column;
+  var formatter = function formatter(_ref) {
+    var value = _ref.value;
+    return dateType === 'dateTimeColumn' ? (0, _dateFormat.formatDateTime)(value) : (0, _dateFormat.formatDate)(value);
+  };
+  return _objectSpread(_objectSpread({}, column), {}, {
+    type: (_column$type = column.type) !== null && _column$type !== void 0 ? _column$type : dateType,
+    valueFormatter: formatter,
+    // 某些表格包装层默认渲染原值；显式渲染保证页面列也使用格式化结果。
+    cellRenderer: (_column$cellRenderer = column.cellRenderer) !== null && _column$cellRenderer !== void 0 ? _column$cellRenderer : formatter
+  });
+};
+
+/** 配置扩展列由表格内部追加，必须在注入前配置日期渲染器。@author nokecy */
+var normalizeExtendedDateColumn = exports.normalizeExtendedDateColumn = function normalizeExtendedDateColumn(column) {
+  var normalized = normalizeListDateColumn(_objectSpread(_objectSpread({}, column), {}, {
+    field: column.name,
+    headerName: column.displayName,
+    type: column.propertyType
+  }));
+  if (!getListDateType(normalized)) return column;
+  return _objectSpread(_objectSpread({}, column), {}, {
+    propertyType: getListDateType(normalized),
+    cellRenderer: normalized.cellRenderer
+  });
+};

package/dist/cjs/standardList/listDefaultSort.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 列表默认排序的纯逻辑：由列定义推断（状态优先、再按记录时间），或由页面显式指定。@author nokecy
+ */
+/** 列表默认排序；exclusive 表示由页面显式指定，取代状态/时间推断，其他列的初始排序一并清掉。 */
+export type ListDefaultSort = {
+    field: string;
+    sort: 'asc' | 'desc';
+    sortIndex: number;
+}[] & {
+    exclusive?: boolean;
+};
+/** 页面显式指定的默认排序（AgGridPlus 的 defaultSort 属性）。 */
+export type ListDefaultSortOverride = {
+    field: string;
+    sort: 'asc' | 'desc';
+}[];
+/**
+ * 默认排序的字段口径，由宿主提供：
+ * `statusFields` 按优先级列出「状态」字段（有状态的单据先按状态升序）；
+ * `timestampFields` 按优先级列出「记录时间」字段（其次按它倒序）。
+ * 不传则不识别状态，只按列名/标题规则推断记录时间。
+ */
+export type ListSortPolicy = {
+    statusFields?: readonly string[];
+    timestampFields?: readonly string[];
+};
+export declare const resolveListSortPolicy: (policy?: ListSortPolicy) => {
+    statusFields: string[];
+    statusFieldSet: Set<string>;
+    timestampFields: string[];
+    timestampFieldSet: Set<string>;
+};
+type ResolvedSortPolicy = ReturnType<typeof resolveListSortPolicy>;
+export declare const flattenColumnDefs: (columns: any[] | undefined, result?: Record<string, any>[]) => Record<string, any>[];
+/** 有状态的单据按状态、再按真实记录时间排序；无状态页保留显式业务排序，否则采用实际时间字段。@author nokecy */
+export declare const inferListDefaultSort: (columns: Record<string, any>[], override?: ListDefaultSortOverride, policy?: ListSortPolicy | ResolvedSortPolicy) => ListDefaultSort;
+export declare const sortingText: (sorting: ListDefaultSort) => string;
+export {};

package/dist/cjs/standardList/listDefaultSort.js

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sortingText = exports.resolveListSortPolicy = exports.inferListDefaultSort = exports.flattenColumnDefs = void 0;
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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; }
+/**
+ * 列表默认排序的纯逻辑：由列定义推断（状态优先、再按记录时间），或由页面显式指定。@author nokecy
+ */
+/** 列表默认排序；exclusive 表示由页面显式指定，取代状态/时间推断，其他列的初始排序一并清掉。 */
+
+/** 页面显式指定的默认排序（AgGridPlus 的 defaultSort 属性）。 */
+
+/**
+ * 默认排序的字段口径，由宿主提供：
+ * `statusFields` 按优先级列出「状态」字段（有状态的单据先按状态升序）；
+ * `timestampFields` 按优先级列出「记录时间」字段（其次按它倒序）。
+ * 不传则不识别状态，只按列名/标题规则推断记录时间。
+ */
+
+var resolveListSortPolicy = exports.resolveListSortPolicy = function resolveListSortPolicy(policy) {
+  var _policy$statusFields, _policy$timestampFiel;
+  var statusFields = _toConsumableArray((_policy$statusFields = policy === null || policy === void 0 ? void 0 : policy.statusFields) !== null && _policy$statusFields !== void 0 ? _policy$statusFields : []);
+  var timestampFields = _toConsumableArray((_policy$timestampFiel = policy === null || policy === void 0 ? void 0 : policy.timestampFields) !== null && _policy$timestampFiel !== void 0 ? _policy$timestampFiel : []);
+  return {
+    statusFields: statusFields,
+    statusFieldSet: new Set(statusFields.map(function (field) {
+      return field.toLowerCase();
+    })),
+    timestampFields: timestampFields,
+    timestampFieldSet: new Set(timestampFields.map(function (field) {
+      return field.toLowerCase();
+    }))
+  };
+};
+var isRecordTimestamp = function isRecordTimestamp(column, recordTimestampFieldSet) {
+  var _column$field, _column$headerName;
+  var field = String((_column$field = column.field) !== null && _column$field !== void 0 ? _column$field : '').toLowerCase();
+  var title = String((_column$headerName = column.headerName) !== null && _column$headerName !== void 0 ? _column$headerName : '');
+  if (/(?:expiry|expiration|production|manufactur|delivery|required|need|effective|valid|shelf)/i.test(field) || /有效期|生产日期|交货日期|需求日期|要求日期|保质期/.test(title)) return false;
+  if (recordTimestampFieldSet.has(field)) return true;
+  if (/(?:create|creation|submit|submitted|audit|check|approve|review|modif|update|change|document|order|bill|invoice|statement|receipt|record|business|make|confirm|transfer|occurred).*(?:time|date)$/i.test(field)) return true;
+  return (column.type === 'dateColumn' || column.type === 'dateTimeColumn' || /日期|时间/.test(title)) && /创建|制单|单据|开单|录入|发生|提交|审核|修改|更改|业务|对账|开票|确认|转移/.test(title);
+};
+var flattenColumnDefs = exports.flattenColumnDefs = function flattenColumnDefs(columns) {
+  var result = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  var _iterator = _createForOfIteratorHelper(columns !== null && columns !== void 0 ? columns : []),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var column = _step.value;
+      if (Array.isArray(column === null || column === void 0 ? void 0 : column.children) && column.children.length) flattenColumnDefs(column.children, result);else result.push(column !== null && column !== void 0 ? column : {});
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return result;
+};
+
+/** 有状态的单据按状态、再按真实记录时间排序；无状态页保留显式业务排序，否则采用实际时间字段。@author nokecy */
+var inferListDefaultSort = exports.inferListDefaultSort = function inferListDefaultSort(columns, override, policy) {
+  var _ref = 'statusFieldSet' in (policy !== null && policy !== void 0 ? policy : {}) ? policy : resolveListSortPolicy(policy),
+    documentStatusFields = _ref.statusFields,
+    recordTimestampFields = _ref.timestampFields,
+    timestampFieldSet = _ref.timestampFieldSet;
+  if (override !== null && override !== void 0 && override.length) {
+    return Object.assign(override.map(function (item, index) {
+      return {
+        field: item.field,
+        sort: item.sort,
+        sortIndex: index
+      };
+    }), {
+      exclusive: true
+    });
+  }
+  var leaves = columns.filter(function (column) {
+    return column.field && column.sortable !== false;
+  });
+  var statusColumn = documentStatusFields.map(function (field) {
+    return leaves.find(function (column) {
+      return String(column.field).toLowerCase() === field.toLowerCase();
+    });
+  }).find(Boolean);
+  var timestamps = leaves.filter(function (column) {
+    return isRecordTimestamp(column, timestampFieldSet);
+  });
+  var timestampColumn = recordTimestampFields.map(function (field) {
+    return timestamps.find(function (column) {
+      return String(column.field).toLowerCase() === field.toLowerCase();
+    });
+  }).find(Boolean);
+  if (statusColumn) {
+    return [{
+      field: String(statusColumn.field),
+      sort: 'asc',
+      sortIndex: 0
+    }].concat(_toConsumableArray(timestampColumn ? [{
+      field: String(timestampColumn.field),
+      sort: 'desc',
+      sortIndex: 1
+    }] : []));
+  }
+  var explicitSorts = leaves.filter(function (column) {
+    return column.initialSort === 'asc' || column.initialSort === 'desc' || column.sort === 'asc' || column.sort === 'desc';
+  }).sort(function (left, right) {
+    var _left$sortIndex, _right$sortIndex;
+    return Number((_left$sortIndex = left.sortIndex) !== null && _left$sortIndex !== void 0 ? _left$sortIndex : 0) - Number((_right$sortIndex = right.sortIndex) !== null && _right$sortIndex !== void 0 ? _right$sortIndex : 0);
+  });
+  if (explicitSorts.length) {
+    return explicitSorts.map(function (column, index) {
+      var _column$initialSort;
+      return {
+        field: String(column.field),
+        sort: (_column$initialSort = column.initialSort) !== null && _column$initialSort !== void 0 ? _column$initialSort : column.sort,
+        sortIndex: Number.isFinite(Number(column.sortIndex)) ? Number(column.sortIndex) : index
+      };
+    });
+  }
+  return timestampColumn ? [{
+    field: String(timestampColumn.field),
+    sort: 'desc',
+    sortIndex: 0
+  }] : [];
+};
+var sortingText = exports.sortingText = function sortingText(sorting) {
+  return sorting.map(function (item) {
+    return "".concat(item.field, " ").concat(item.sort);
+  }).join(', ');
+};

package/dist/cjs/standardList/listRefresh.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 「保存后回列表，列表要是新的」这件事的判定逻辑。
+ *
+ * 为什么需要它：`pubGoBack()` 只是 push 回父路径再关掉表单页的标签，
+ * 而列表页在 KeepAlive 缓存里，push 回去是**直接复原缓存的那棵树，不会重新拉数据**——
+ * 用户刚保存的记录不在列表里，于是以为没存上，再存一遍。全仓有 196 处这样的返回。
+ *
+ * 判定单独拆出来是因为它有三个都会出错的边界：缓存页不活跃时不能刷、同一个 refresh 值不能重复刷、
+ * 挂载时 URL 上已有的 refresh 值不算（那是别人触发的，自己刚加载完，再刷一次纯属浪费）。
+ *
+ * @author nokecy
+ */
+export type RefreshDecisionInput = {
+    /** 当前页面是否是活跃页面。KeepAlive 缓存的页面 useEffect 照样在跑，不判这个会串台 */
+    isActive: boolean;
+    /** URL 上的 refresh 值 */
+    refresh?: string | null;
+    /** 上一次已经响应过的 refresh 值 */
+    lastHandled?: string | null;
+};
+export declare const shouldRefresh: ({ isActive, refresh, lastHandled }: RefreshDecisionInput) => boolean;
+/** 从 location.search 里取 refresh。 */
+export declare const readRefreshToken: (search?: string | null) => string | null;
+/** 给列表路径带上刷新标记；已有 refresh 的会被替换而不是叠加。 */
+export declare const withRefreshToken: (listPath: string, token: string | number) => string;

package/dist/cjs/standardList/listRefresh.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withRefreshToken = exports.shouldRefresh = exports.readRefreshToken = void 0;
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure 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 _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 _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+/**
+ * 「保存后回列表，列表要是新的」这件事的判定逻辑。
+ *
+ * 为什么需要它：`pubGoBack()` 只是 push 回父路径再关掉表单页的标签，
+ * 而列表页在 KeepAlive 缓存里，push 回去是**直接复原缓存的那棵树，不会重新拉数据**——
+ * 用户刚保存的记录不在列表里，于是以为没存上，再存一遍。全仓有 196 处这样的返回。
+ *
+ * 判定单独拆出来是因为它有三个都会出错的边界：缓存页不活跃时不能刷、同一个 refresh 值不能重复刷、
+ * 挂载时 URL 上已有的 refresh 值不算（那是别人触发的，自己刚加载完，再刷一次纯属浪费）。
+ *
+ * @author nokecy
+ */
+
+var shouldRefresh = exports.shouldRefresh = function shouldRefresh(_ref) {
+  var isActive = _ref.isActive,
+    refresh = _ref.refresh,
+    lastHandled = _ref.lastHandled;
+  return Boolean(isActive && refresh && refresh !== lastHandled);
+};
+
+/** 从 location.search 里取 refresh。 */
+var readRefreshToken = exports.readRefreshToken = function readRefreshToken(search) {
+  if (!search) return null;
+  try {
+    return new URLSearchParams(search).get('refresh');
+  } catch (_unused) {
+    return null;
+  }
+};
+
+/** 给列表路径带上刷新标记；已有 refresh 的会被替换而不是叠加。 */
+var withRefreshToken = exports.withRefreshToken = function withRefreshToken(listPath, token) {
+  var _listPath$split = listPath.split('?'),
+    _listPath$split2 = _slicedToArray(_listPath$split, 2),
+    path = _listPath$split2[0],
+    _listPath$split2$ = _listPath$split2[1],
+    search = _listPath$split2$ === void 0 ? '' : _listPath$split2$;
+  var params = new URLSearchParams(search);
+  params.set('refresh', String(token));
+  return "".concat(path, "?").concat(params.toString());
+};

package/dist/esm/index.d.ts

@@ -32,6 +32,7 @@ export type { ColumnConfig } from "./array-table/columnHelper";
 export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeStorageConfig, LocalStorageAdapterConfig, BackendApiAdapterConfig, UseSchemeManagerConfig, GridPlusContextValue, GlobalConfigPermissions, } from "./ag-grid-plus";
 export * from './adapters';
 export * from "./readPretty";
+export * from "./standardList";
 export { createEntitySelect } from "./entitySelect";
 export { default as ExportButton, buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName } from "./exportButton";
 export type { ExportButtonProps, ExportTemplateApi, ExportTemplateOption } from "./exportButton";

package/dist/esm/index.js

@@ -43,6 +43,7 @@ useSchemeManager, useGridSchemes, LocalStorageSchemeAdapter, BackendApiSchemeAda
 // 分页适配器:值 + 类型一并导出,支持非 ABP 后端注入
 export * from "./adapters";
 export * from "./readPretty";
+export * from "./standardList";
 export { createEntitySelect } from "./entitySelect";
 export { default as ExportButton, buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName } from "./exportButton";
 export { saveAs } from "./utils/download";

package/dist/esm/standardList/StandardAgGridPlus.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+import type { AgGridColumnPropsClone, GridRef } from '../ag-grid-plus/interface';
+import { type EnumFallbackRenderer } from './enumColumns';
+import './groupedHeaders.less';
+import { type ListSortPolicy } from './listDefaultSort';
+/**
+ * 标准列表的宿主口径。
+ * - `enumFallbackRenderer`：枚举列未命中时的显示（如「未知（原码）」）；不传则显示原码。
+ * - `sortPolicy`：默认排序识别的状态字段与记录时间字段。
+ */
+export interface StandardListPolicy {
+    enumFallbackRenderer?: EnumFallbackRenderer;
+    sortPolicy?: ListSortPolicy;
+}
+/**
+ * 标准列表列定义：在表格列定义上补 businessKey。
+ * businessKey 为 true 表示该列是业务单号（如 mrpID、mpsID），不按「ID 结尾」当内部键隐藏。
+ * @author nokecy
+ */
+export type AppGridColumn = AgGridColumnPropsClone & {
+    businessKey?: boolean;
+};
+/**
+ * 标准列表基座：在 AgGridPlus 外面包一层公司列表规范（序号、内部字段隐藏、日期显示、分组表头、空态四分支、
+ * 默认排序、枚举回退等）。宿主的页面一律经宿主自己的薄封装导入它，这里加一次，等于所有列表页都有了。
+ * 与路由相关的刷新令牌和宿主口径（未知值文案、排序字段）由宿主通过属性传入。
+ *
+ * 这层目前做三件事：
+ *
+ * 1. **从表单页保存返回时，把列表刷新一遍**。
+ *    起因是 `pubGoBack()` 只 push 回父路径再关掉表单页标签，而列表页在 KeepAlive 缓存里，
+ *    push 回去是直接复原缓存的那棵树，不会重新请求——用户刚保存的记录不在列表里，
+ *    于是以为没存上，再存一遍。全仓 196 处返回都是这个行为。
+ *    为什么不直接 `dropByCacheKey(列表路径)` 把缓存丢掉：那样确实会重新加载，
+ *    但连筛选条件、滚动位置、分页和列宽一起丢了。用户进表单前设的筛选，回来就没了。
+ *    走 URL 上的 refresh 标记只重新取数，页面状态原样保留。
+ *
+ * 2. **空态四分支（U2）**：无数据 / 筛选无结果 / 无权限(403) / 加载失败。
+ *    qc-ui 只支持一句空数据文字（overlayNoRowsTemplateText），分不出四种情况。
+ *    这里用 AG-Grid 原生的 `noRowsOverlayComponent`（优先级高于 overlayNoRowsTemplate）
+ *    挂 `GridEmptyState`，请求成败与是否带筛选经 context 传给 overlay 组件。
+ *    业务页可通过 `emptyActions` 注入「无数据」分支的操作（通常是 Access 包裹的新建按钮），
+ *    或用自己的 `noRowsOverlayComponent` 整体覆盖。
+ *
+ * 3. **valueEnum 文字对比度**：qc-ui 把 `valueEnum.color` 当 CSS 文字色，缺 color 时写成
+ *    `#ffffff`（销售跟踪「类型」列「普通订单」白底白字就是这条）。封装层给 columnDefs
+ *    和 AgGridColumn 统一套 `gridValueEnum()`：缺色用 inherit，浅色 / 预设名收成白底 ≥4.5:1。
+ *
+ * 4. **列定义上的 live `sort`**：AG Grid 把 `ColDef.sort` 当受控属性，每次 columnDefs 引用变化
+ *    都会强制写回。送货单点「送货日期」降序后再点单元格，选中态 setState 重建列定义，
+ *    默认「单号升序」被重新套上，排序就自己变了。封装层把 `sort` 收成只用于建列的 `initialSort`。
+ *
+ * @author nokecy
+ */
+declare const StandardAgGridColumn: React.FC<any>;
+declare const StandardAgGridPlus: React.FC<any>;
+export { StandardAgGridColumn, StandardAgGridPlus };
+export type { GridRef };