@nokecy/qc-ui 1.1.75 → 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/cjs/utils/download.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 把 Blob 存成本地文件。
+ *
+ * @author nokecy
+ */
+export declare const saveAs: (blob: Blob, filename: string) => void;

package/dist/cjs/utils/download.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.saveAs = void 0;
+/**
+ * 把 Blob 存成本地文件。
+ *
+ * @author nokecy
+ */
+var saveAs = exports.saveAs = function saveAs(blob, filename) {
+  var nav = window.navigator;
+  if (typeof nav.msSaveBlob === 'function') {
+    nav.msSaveBlob(blob, filename);
+    return;
+  }
+  var link = document.createElement('a');
+  link.href = window.URL.createObjectURL(blob);
+  link.download = filename;
+  link.click();
+  window.URL.revokeObjectURL(link.href);
+};

package/dist/esm/exportButton/exportAction.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 导出按钮的行为决策与地址构造。
+ *
+ * 抽成纯函数是为了能直接测：这里的分支决定了「现场点导出会发生什么」，
+ * 而它最容易出问题的两个场景——模板没配、模板接口挂了——在页面里很难复现。
+ *
+ * @author nokecy
+ */
+/** 导出模板服务的接口地址：可用模板列表与按模板渲染文件。默认指向 MES 后端的 export-template 服务，其他后端可在 ExportButton 上覆盖。 */
+export interface ExportTemplateApi {
+    /** 按页面标识取可用模板（GET，参数 gridKey） */
+    options: string;
+    /** 按模板渲染并下载（GET，参数 TemplateId、Filter） */
+    render: string;
+}
+/** 默认的导出模板服务地址。 */
+export declare const DEFAULT_EXPORT_TEMPLATE_API: ExportTemplateApi;
+/** 后端 `export-template/options` 返回的模板项 */
+export interface ExportTemplateOption {
+    id: string;
+    name: string;
+    isDefault: boolean;
+}
+/** 导出按钮该以什么形态出现 */
+export type ExportAction = 
+/** 没有可用模板：走页面自带的旧导出入口 */
+{
+    kind: 'legacy';
+}
+/** 只有一个模板：按钮直接导 */
+ | {
+    kind: 'single';
+    template: ExportTemplateOption;
+}
+/** 多个模板：下拉选择 */
+ | {
+    kind: 'menu';
+    templates: ExportTemplateOption[];
+    defaultTemplate: ExportTemplateOption;
+};
+/**
+ * 根据可用模板决定导出按钮的行为。
+ *
+ * 传 null / undefined 表示「没拿到模板列表」（接口失败或还没加载），
+ * 与「确实一个模板都没配」一样回落到旧导出——模板服务出问题不该让现场导不出数据。
+ */
+export declare const resolveExportAction: (templates: ExportTemplateOption[] | null | undefined) => ExportAction;
+/**
+ * 导出接口地址。这里已经把参数百分号编码好了（Gridify 的值里可能有 `&` `#` `+`，不编会截断 query string）。
+ *
+ * <b>因此下载不能走 `downloadBlob`</b>：它内部还会 `encodeURI(url)` 再编一次，
+ * `%` 被转义成 `%25`（`boxCode%3D*BOX001` → `boxCode%253D*BOX001`），
+ * 后端解析不出筛选串——现场表现是「在列表上筛完点导出，导出的是全量」。
+ * 见本目录 index.tsx 里的 `download`。
+ */
+export declare const buildExportUrl: (templateId: string, filter?: string | null, renderUrl?: string) => string;
+/**
+ * 从响应头取导出文件名。
+ *
+ * 文件名是运维在模板上配的（可带 {date} 之类的占位），只有服务端知道最终值；
+ * 客户端自己起名会让那项配置永远不生效。头里取不到就用兜底名。
+ *
+ * 后端用 `filename*=UTF-8''xxx`（RFC 5987）传中文名，老式 `filename="xxx"` 也认。
+ */
+export declare const resolveFileName: (contentDisposition: string | undefined | null, fallback: string) => string;
+/**
+ * 从导出失败的异常里取出给人看的错误信息。
+ *
+ * 导出请求是 `responseType: 'blob'`，后端返回的 JSON 错误体也会被 axios 当成 blob 收下，
+ * `e.response.data.error.message` 这条路永远取不到东西——现场看到的是 axios 自己的
+ * "Request failed with status code 500"，既不知道是数据太多超时还是模板配错。
+ * 所以先把 blob 读回来解析一次。
+ */
+export declare const resolveExportError: (error: any) => Promise<string>;