@nokecy/qc-ui 1.1.75 → 1.1.78

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

@@ -0,0 +1,16 @@
+/**
+ * 列表日期显示格式：日期 `YYYY-MM-DD`，日期时间 `YYYY-MM-DD HH:mm:ss`，按浏览器本地时区。
+ * @author nokecy
+ */
+/**
+ * 将时间格式化为 yyyy-MM-dd HH:mm:ss 格式
+ * @param value 时间值（字符串、Date对象或null/undefined）
+ * @returns 格式化后的时间字符串，如果输入无效则返回空字符串
+ */
+export declare const formatDateTime: (value: string | Date | null | undefined) => string;
+/**
+ * 将时间格式化为 yyyy-MM-dd 格式
+ * @param value 时间值（字符串、Date对象或null/undefined）
+ * @returns 格式化后的日期字符串，如果输入无效则返回空字符串
+ */
+export declare const formatDate: (value: string | Date | null | undefined) => string;

package/dist/cjs/standardList/dateFormat.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatDateTime = exports.formatDate = void 0;
+/**
+ * 列表日期显示格式：日期 `YYYY-MM-DD`，日期时间 `YYYY-MM-DD HH:mm:ss`，按浏览器本地时区。
+ * @author nokecy
+ */
+
+/** 纯日期按本地日历解析；带时区的时间按浏览器时区转换。@author nokecy */
+var parseDate = function parseDate(value) {
+  return new Date(typeof value === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(value) ? "".concat(value, "T00:00:00") : value);
+};
+
+/**
+ * 将时间格式化为 yyyy-MM-dd HH:mm:ss 格式
+ * @param value 时间值（字符串、Date对象或null/undefined）
+ * @returns 格式化后的时间字符串，如果输入无效则返回空字符串
+ */
+var formatDateTime = exports.formatDateTime = function formatDateTime(value) {
+  if (!value) return '';
+  try {
+    var date = parseDate(value);
+    if (isNaN(date.getTime())) return '';
+    var year = String(date.getFullYear()).padStart(4, '0');
+    var month = String(date.getMonth() + 1).padStart(2, '0');
+    var day = String(date.getDate()).padStart(2, '0');
+    var hours = String(date.getHours()).padStart(2, '0');
+    var minutes = String(date.getMinutes()).padStart(2, '0');
+    var seconds = String(date.getSeconds()).padStart(2, '0');
+    return "".concat(year, "-").concat(month, "-").concat(day, " ").concat(hours, ":").concat(minutes, ":").concat(seconds);
+  } catch (error) {
+    return '';
+  }
+};
+
+/**
+ * 将时间格式化为 yyyy-MM-dd 格式
+ * @param value 时间值（字符串、Date对象或null/undefined）
+ * @returns 格式化后的日期字符串，如果输入无效则返回空字符串
+ */
+var formatDate = exports.formatDate = function formatDate(value) {
+  if (!value) return '';
+  try {
+    var date = parseDate(value);
+    if (isNaN(date.getTime())) return '';
+    var year = String(date.getFullYear()).padStart(4, '0');
+    var month = String(date.getMonth() + 1).padStart(2, '0');
+    var day = String(date.getDate()).padStart(2, '0');
+    return "".concat(year, "-").concat(month, "-").concat(day);
+  } catch (error) {
+    return '';
+  }
+};

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

@@ -0,0 +1,36 @@
+import React from 'react';
+import type { GridPlusError } from '../ag-grid-plus/errors';
+/**
+ * 列表空态四分支（U2）。
+ *
+ * 四分支：
+ * 1. **无权限**（请求 403）→ 说明缺权限，不给新建入口；
+ * 2. **加载失败** → 给「重新加载」按钮；
+ * 3. **筛选无结果**（最近一次请求带条件）→ 引导调整/清空筛选；
+ * 4. **无数据** → 「暂无数据」+ 业务页注入的操作（通常是 Access 包裹的新建按钮）。
+ *
+ * 渲染方式：作为 AG-Grid 的 `noRowsOverlayComponent` 挂在标准列表基座上（见 ./StandardAgGridPlus.tsx）。
+ * ag-grid-react 的 overlay 组件经 portal 渲染、仍在 React 树内，所以用 context 传动态状态，
+ * 请求失败/成功的状态变化能驱动 overlay 重渲染。
+ *
+ * @author nokecy
+ */
+export interface GridEmptyContextValue {
+    /** 最近一次加载失败；请求成功时清空 */
+    error?: GridPlusError;
+    /** 最近一次请求是否带筛选条件（区分「没有数据」与「筛选无结果」） */
+    hasFilter?: boolean;
+    /** 业务页注入的空态操作（通常是 Access 包裹的新建按钮） */
+    actions?: React.ReactNode;
+    /** 业务页注入的筛选无结果操作（通常是清空自定义筛选） */
+    clearFilterAction?: React.ReactNode;
+    /** 重试（= 重新请求） */
+    onRetry?: () => void;
+}
+export declare const GridEmptyContext: React.Context<GridEmptyContextValue>;
+export declare const GridEmptyState: React.FC;
+/**
+ * 判断请求 filter 是否带生效条件（任意叶子值非空即算有筛选）。
+ * qc-ui 的 queryFilter 是嵌套对象，空表单也会产生空值键。
+ */
+export declare const hasActiveFilter: (filter: any) => boolean;

package/dist/cjs/standardList/emptyState.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasActiveFilter = exports.GridEmptyState = exports.GridEmptyContext = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _antd = require("antd");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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); }
+/**
+ * 列表空态四分支（U2）。
+ *
+ * 四分支：
+ * 1. **无权限**（请求 403）→ 说明缺权限，不给新建入口；
+ * 2. **加载失败** → 给「重新加载」按钮；
+ * 3. **筛选无结果**（最近一次请求带条件）→ 引导调整/清空筛选；
+ * 4. **无数据** → 「暂无数据」+ 业务页注入的操作（通常是 Access 包裹的新建按钮）。
+ *
+ * 渲染方式：作为 AG-Grid 的 `noRowsOverlayComponent` 挂在标准列表基座上（见 ./StandardAgGridPlus.tsx）。
+ * ag-grid-react 的 overlay 组件经 portal 渲染、仍在 React 树内，所以用 context 传动态状态，
+ * 请求失败/成功的状态变化能驱动 overlay 重渲染。
+ *
+ * @author nokecy
+ */
+
+var GridEmptyContext = exports.GridEmptyContext = /*#__PURE__*/_react.default.createContext({});
+
+/** 从 GridPlusError 里取 HTTP 状态码（ABP axios 错误在 context.originalError.response.status） */
+var httpStatusOf = function httpStatusOf(error) {
+  var _response$status, _error$context, _error$originalError;
+  return (_response$status = error === null || error === void 0 || (_error$context = error.context) === null || _error$context === void 0 || (_error$context = _error$context.originalError) === null || _error$context === void 0 || (_error$context = _error$context.response) === null || _error$context === void 0 ? void 0 : _error$context.status) !== null && _response$status !== void 0 ? _response$status : error === null || error === void 0 || (_error$originalError = error.originalError) === null || _error$originalError === void 0 || (_error$originalError = _error$originalError.response) === null || _error$originalError === void 0 ? void 0 : _error$originalError.status;
+};
+var GridEmptyState = exports.GridEmptyState = function GridEmptyState() {
+  var _React$useContext = _react.default.useContext(GridEmptyContext),
+    error = _React$useContext.error,
+    hasFilter = _React$useContext.hasFilter,
+    actions = _React$useContext.actions,
+    clearFilterAction = _React$useContext.clearFilterAction,
+    onRetry = _React$useContext.onRetry;
+
+  // 分支 1：无权限（403）——说明原因，不给任何入口
+  if (error && httpStatusOf(error) === 403) {
+    return /*#__PURE__*/_react.default.createElement(_antd.Empty, {
+      image: _antd.Empty.PRESENTED_IMAGE_SIMPLE,
+      description: "\u6CA1\u6709\u6743\u9650\u67E5\u770B\u6B64\u5217\u8868\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u5F00\u901A"
+    });
+  }
+
+  // 分支 2：加载失败——给重试
+  if (error) {
+    return /*#__PURE__*/_react.default.createElement(_antd.Empty, {
+      image: _antd.Empty.PRESENTED_IMAGE_SIMPLE,
+      description: "\u52A0\u8F7D\u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5\u540E\u91CD\u8BD5"
+    }, onRetry && /*#__PURE__*/_react.default.createElement(_antd.Button, {
+      size: "small",
+      type: "primary",
+      onClick: onRetry
+    }, "\u91CD\u65B0\u52A0\u8F7D"));
+  }
+
+  // 分支 3：筛选无结果——引导调整条件，并可提供一键清空入口
+  if (hasFilter) {
+    return /*#__PURE__*/_react.default.createElement(_antd.Empty, {
+      image: _antd.Empty.PRESENTED_IMAGE_SIMPLE,
+      description: "\u6CA1\u6709\u7B26\u5408\u6761\u4EF6\u7684\u6570\u636E"
+    }, clearFilterAction);
+  }
+
+  // 分支 4：无数据——业务页可注入新建入口
+  return /*#__PURE__*/_react.default.createElement(_antd.Empty, {
+    image: _antd.Empty.PRESENTED_IMAGE_SIMPLE,
+    description: "\u6682\u65E0\u6570\u636E"
+  }, actions);
+};
+
+/**
+ * 判断请求 filter 是否带生效条件（任意叶子值非空即算有筛选）。
+ * qc-ui 的 queryFilter 是嵌套对象，空表单也会产生空值键。
+ */
+var hasActiveFilter = exports.hasActiveFilter = function hasActiveFilter(filter) {
+  if (!filter || _typeof(filter) !== 'object') return false;
+  return Object.values(filter).some(function (v) {
+    if (v === null || v === undefined || v === '') return false;
+    if (Array.isArray(v)) return v.length > 0;
+    if (_typeof(v) === 'object') return hasActiveFilter(v);
+    return true;
+  });
+};

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

@@ -0,0 +1,31 @@
+export type EnumFallbackParams = {
+    value: unknown;
+    node?: {
+        rowPinned?: string | null;
+    } | null;
+};
+export type EnumFallbackRenderer = (params: EnumFallbackParams) => unknown;
+type GridEnumItem = {
+    color?: string;
+    label?: string;
+    value?: unknown;
+};
+type GridColumnLike = {
+    field?: string;
+    valueEnum?: readonly GridEnumItem[];
+    enumFallbackRenderer?: EnumFallbackRenderer;
+    children?: GridColumnLike[];
+};
+/**
+ * 递归给 columnDefs / 列组 children 的 valueEnum 套上 `gridValueEnum`，并补默认未知值显示。
+ * 没有 valueEnum 且没有 children 的列保持原引用。
+ */
+export declare const applyGridValueEnumToColumns: <T extends GridColumnLike>(columns: T[] | null | undefined, background?: string, fallback?: EnumFallbackRenderer) => T[] | null | undefined;
+/**
+ * 未命中时再按规范化后的码值补一次枚举匹配。精确命中的值仍由表格原有枚举渲染处理；
+ * 真正未知的码交给 `fallback`，不传则回原码。
+ */
+export declare const createNormalizedEnumFallbackRenderer: (items: readonly GridEnumItem[], fallback?: EnumFallbackRenderer) => (params: EnumFallbackParams) => unknown;
+/** columnDefs 路径也包住显式业务回退，所有经标准列表的表格共享同一套旧码规范化。 */
+export declare const applyNormalizedEnumFallbacksToColumns: <T extends GridColumnLike>(columns: T[] | null | undefined, fallback?: EnumFallbackRenderer) => T[] | null | undefined;
+export {};

package/dist/cjs/standardList/enumColumns.js

@@ -0,0 +1,87 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createNormalizedEnumFallbackRenderer = exports.applyNormalizedEnumFallbacksToColumns = exports.applyGridValueEnumToColumns = void 0;
+var _react = require("react");
+var _valueEnumColor = require("../ag-grid-plus/utils/valueEnumColor");
+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); } /**
+ * 列定义上的枚举列统一处理：颜色按底色收成可读色、未配置回退的枚举列补默认的未知值显示、
+ * 按规范化后的码值再匹配一次（兼容旧 char 字段的尾随空格与数字/字符串差异）。
+ *
+ * 未知值的文案属于宿主口径，由 `fallback` 注入；不传则保持表格自身的行为（未命中显示原码）。
+ *
+ * @author nokecy
+ */
+/**
+ * 递归给 columnDefs / 列组 children 的 valueEnum 套上 `gridValueEnum`，并补默认未知值显示。
+ * 没有 valueEnum 且没有 children 的列保持原引用。
+ */
+var applyGridValueEnumToColumns = exports.applyGridValueEnumToColumns = function applyGridValueEnumToColumns(columns, background, fallback) {
+  if (!columns) return columns;
+  return columns.map(function (col) {
+    var _col$enumFallbackRend;
+    var nextChildren = col.children ? applyGridValueEnumToColumns(col.children, background, fallback) : col.children;
+    var nextEnum = Array.isArray(col.valueEnum) ? (0, _valueEnumColor.gridValueEnum)(col.valueEnum, background) : col.valueEnum;
+    if (nextChildren === col.children && nextEnum === col.valueEnum) return col;
+    var defaultFallback = (_col$enumFallbackRend = col.enumFallbackRenderer) !== null && _col$enumFallbackRend !== void 0 ? _col$enumFallbackRend : fallback;
+    return _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, col), Array.isArray(nextEnum) && defaultFallback ? {
+      enumFallbackRenderer: defaultFallback
+    } : {}), nextEnum !== col.valueEnum ? {
+      valueEnum: nextEnum
+    } : {}), nextChildren !== col.children ? {
+      children: nextChildren
+    } : {});
+  });
+};
+var normalizeEnumCode = function normalizeEnumCode(value) {
+  if (value === null || value === undefined || typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean') return undefined;
+  var normalized = String(value).trim();
+  return normalized === '' ? undefined : normalized;
+};
+
+/**
+ * 未命中时再按规范化后的码值补一次枚举匹配。精确命中的值仍由表格原有枚举渲染处理；
+ * 真正未知的码交给 `fallback`，不传则回原码。
+ */
+var createNormalizedEnumFallbackRenderer = exports.createNormalizedEnumFallbackRenderer = function createNormalizedEnumFallbackRenderer(items, fallback) {
+  return function (params) {
+    var normalizedValue = normalizeEnumCode(params.value);
+    if (normalizedValue !== undefined) {
+      var matched = items.find(function (item) {
+        return item.value !== params.value && normalizeEnumCode(item.value) === normalizedValue;
+      });
+      if (matched) {
+        var _matched$label;
+        return /*#__PURE__*/(0, _react.createElement)('span', {
+          style: {
+            color: matched.color || 'inherit'
+          }
+        }, (_matched$label = matched.label) !== null && _matched$label !== void 0 ? _matched$label : '');
+      }
+    }
+    return fallback ? fallback(params) : params.value;
+  };
+};
+
+/** columnDefs 路径也包住显式业务回退，所有经标准列表的表格共享同一套旧码规范化。 */
+var applyNormalizedEnumFallbacksToColumns = exports.applyNormalizedEnumFallbacksToColumns = function applyNormalizedEnumFallbacksToColumns(columns, fallback) {
+  if (!columns) return columns;
+  return columns.map(function (col) {
+    var _col$enumFallbackRend2;
+    var nextChildren = col.children ? applyNormalizedEnumFallbacksToColumns(col.children, fallback) : col.children;
+    var nextFallback = Array.isArray(col.valueEnum) ? createNormalizedEnumFallbackRenderer(col.valueEnum, (_col$enumFallbackRend2 = col.enumFallbackRenderer) !== null && _col$enumFallbackRend2 !== void 0 ? _col$enumFallbackRend2 : fallback) : col.enumFallbackRenderer;
+    if (nextChildren === col.children && nextFallback === col.enumFallbackRenderer) return col;
+    return _objectSpread(_objectSpread(_objectSpread({}, col), nextChildren !== col.children ? {
+      children: nextChildren
+    } : {}), nextFallback !== col.enumFallbackRenderer ? {
+      enumFallbackRenderer: nextFallback
+    } : {});
+  });
+};

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

@@ -0,0 +1,33 @@
+/**
+ * 表格列定义在进 AG Grid 之前的收口。
+ *
+ * AG Grid 把 ColDef.sort 当成**受控属性**：每次 columnDefs 引用变化都会
+ * `_updateColumnState` → `updateColSort`。sort 有值就强制写回该列，undefined 才不动。
+ *
+ * 列表的默认排序写在 colDef.sort 上（如送货单 `number: 'asc'`）。行点击会
+ * setState → 父组件重建 columnDefs → 默认列被重新套上升序。用户刚点的「送货日期 desc」
+ * 还在，于是变成多列排序；qc-ui `getSort` 又只取列状态里**第一个**有 sort 的列
+ * （单号钉在最左），请求就改回单号升序。表现就是：点成时间降序后，再点单元格，排序自己变了。
+ *
+ * 处理：把 `sort` 挪到 `initialSort`。AG Grid 只在建列时读 initialSort，之后更新列定义不会再套。
+ *
+ * @author nokecy
+ */
+type GridColumnLike = {
+    sort?: string;
+    initialSort?: string;
+    children?: GridColumnLike[];
+};
+/** AG Grid 更新列定义时对 ColDef.sort 的处理（ag-grid-community SortService.updateColSort）。 */
+export declare const applyColDefSort: (current: string | undefined, colDefSort: string | undefined) => string | undefined;
+/** qc-ui getSort：列状态里第一个带 sort 的列，拼成 `colId direction`。 */
+export declare const firstGridSorter: (cols: readonly {
+    colId: string;
+    sort?: string;
+}[]) => string;
+/**
+ * 去掉列定义上的 live `sort`，只保留 `initialSort`（首屏建列用）。
+ * 没有 sort、也没有 children 的列保持原引用。
+ */
+export declare const detachLiveSortFromColumnDefs: <T extends GridColumnLike>(columns: T[] | null | undefined) => T[] | null | undefined;
+export {};

package/dist/cjs/standardList/gridColumnDefs.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.firstGridSorter = exports.detachLiveSortFromColumnDefs = exports.applyColDefSort = void 0;
+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); }
+/**
+ * 表格列定义在进 AG Grid 之前的收口。
+ *
+ * AG Grid 把 ColDef.sort 当成**受控属性**：每次 columnDefs 引用变化都会
+ * `_updateColumnState` → `updateColSort`。sort 有值就强制写回该列，undefined 才不动。
+ *
+ * 列表的默认排序写在 colDef.sort 上（如送货单 `number: 'asc'`）。行点击会
+ * setState → 父组件重建 columnDefs → 默认列被重新套上升序。用户刚点的「送货日期 desc」
+ * 还在，于是变成多列排序；qc-ui `getSort` 又只取列状态里**第一个**有 sort 的列
+ * （单号钉在最左），请求就改回单号升序。表现就是：点成时间降序后，再点单元格，排序自己变了。
+ *
+ * 处理：把 `sort` 挪到 `initialSort`。AG Grid 只在建列时读 initialSort，之后更新列定义不会再套。
+ *
+ * @author nokecy
+ */
+
+/** AG Grid 更新列定义时对 ColDef.sort 的处理（ag-grid-community SortService.updateColSort）。 */
+var applyColDefSort = exports.applyColDefSort = function applyColDefSort(current, colDefSort) {
+  if (colDefSort === undefined) return current;
+  return colDefSort === 'asc' || colDefSort === 'desc' ? colDefSort : undefined;
+};
+
+/** qc-ui getSort：列状态里第一个带 sort 的列，拼成 `colId direction`。 */
+var firstGridSorter = exports.firstGridSorter = function firstGridSorter(cols) {
+  var hit = cols.find(function (col) {
+    return Boolean(col.sort);
+  });
+  return hit ? "".concat(hit.colId, " ").concat(hit.sort) : '';
+};
+
+/**
+ * 去掉列定义上的 live `sort`，只保留 `initialSort`（首屏建列用）。
+ * 没有 sort、也没有 children 的列保持原引用。
+ */
+var detachLiveSortFromColumnDefs = exports.detachLiveSortFromColumnDefs = function detachLiveSortFromColumnDefs(columns) {
+  if (!columns) return columns;
+  return columns.map(function (col) {
+    var nextChildren = col.children ? detachLiveSortFromColumnDefs(col.children) : col.children;
+    var hasLiveSort = col.sort !== undefined;
+    if (!hasLiveSort && nextChildren === col.children) return col;
+    var next = _objectSpread({}, col);
+    if (hasLiveSort) {
+      if (next.initialSort === undefined) next.initialSort = col.sort;
+      delete next.sort;
+    }
+    if (nextChildren !== col.children) next.children = nextChildren;
+    return next;
+  });
+};

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

@@ -0,0 +1,28 @@
+/** 分组表头及可见分组边界的统一样式。@author nokecy */
+type DisplayedGroup = {
+    getParent(): DisplayedGroup | null;
+    isPadding(): boolean;
+    getColGroupDef(): unknown;
+    getDisplayedLeafColumns(): DisplayedColumn[];
+};
+type DisplayedColumn = {
+    getParent(): DisplayedGroup | null;
+};
+export declare const compositeClasses: {
+    readonly group: "app-grid-composite-group";
+    readonly header: "app-grid-composite-header";
+    readonly cell: "app-grid-composite-cell";
+    readonly start: "app-grid-composite-start";
+    readonly end: "app-grid-composite-end";
+};
+/** 使用显示分组而非原始列顺序，覆盖隐藏列、拆分分组、固定列及多层嵌套。@author nokecy */
+export declare const getCompositeColumnEdges: (column?: DisplayedColumn | null) => {
+    grouped: boolean;
+    start: boolean;
+    end: boolean;
+};
+/** 保留页面自定义表头类，所有真实分组共用居中标题和边框。@author nokecy */
+export declare const withCompositeGroupHeader: <T extends Record<string, any>>(column: T) => T;
+/** 原有类名和规则完整保留；分组边框规则随当前显示列重新求值并移除失效边框。@author nokecy */
+export declare const withCompositeLeafHeader: <T extends Record<string, any>>(column: T) => T;
+export {};

package/dist/cjs/standardList/groupedHeaders.js

@@ -0,0 +1,84 @@
+"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.withCompositeLeafHeader = exports.withCompositeGroupHeader = exports.getCompositeColumnEdges = exports.compositeClasses = void 0;
+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 _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 */
+
+var compositeClasses = exports.compositeClasses = {
+  group: 'app-grid-composite-group',
+  header: 'app-grid-composite-header',
+  cell: 'app-grid-composite-cell',
+  start: 'app-grid-composite-start',
+  end: 'app-grid-composite-end'
+};
+
+/** 使用显示分组而非原始列顺序，覆盖隐藏列、拆分分组、固定列及多层嵌套。@author nokecy */
+var getCompositeColumnEdges = exports.getCompositeColumnEdges = function getCompositeColumnEdges(column) {
+  var grouped = false;
+  var start = false;
+  var end = false;
+  for (var group = column === null || column === void 0 ? void 0 : column.getParent(); group; group = group.getParent()) {
+    if (group.isPadding() || !group.getColGroupDef()) continue;
+    grouped = true;
+    var leaves = group.getDisplayedLeafColumns();
+    start || (start = leaves[0] === column);
+    end || (end = leaves[leaves.length - 1] === column);
+  }
+  return {
+    grouped: grouped,
+    start: start,
+    end: end
+  };
+};
+var classesOf = function classesOf(value) {
+  return (Array.isArray(value) ? value : [value]).flatMap(function (item) {
+    var _item$split$filter;
+    return (_item$split$filter = item === null || item === void 0 ? void 0 : item.split(/\s+/).filter(Boolean)) !== null && _item$split$filter !== void 0 ? _item$split$filter : [];
+  });
+};
+var mergeClasses = function mergeClasses(original, params, extra) {
+  return Array.from(new Set([].concat(_toConsumableArray(classesOf(typeof original === 'function' ? original(params) : original)), _toConsumableArray(extra))));
+};
+
+/** 保留页面自定义表头类，所有真实分组共用居中标题和边框。@author nokecy */
+var withCompositeGroupHeader = exports.withCompositeGroupHeader = function withCompositeGroupHeader(column) {
+  var originalHeaderClass = column.headerClass;
+  return _objectSpread(_objectSpread({}, column), {}, {
+    headerClass: function headerClass(params) {
+      var _params$columnGroup;
+      return mergeClasses(originalHeaderClass, params, (_params$columnGroup = params.columnGroup) !== null && _params$columnGroup !== void 0 && _params$columnGroup.isPadding() ? [] : [compositeClasses.group]);
+    }
+  });
+};
+
+/** 原有类名和规则完整保留；分组边框规则随当前显示列重新求值并移除失效边框。@author nokecy */
+var withCompositeLeafHeader = exports.withCompositeLeafHeader = function withCompositeLeafHeader(column) {
+  var originalHeaderClass = column.headerClass;
+  return _objectSpread(_objectSpread({}, column), {}, {
+    headerClass: function headerClass(params) {
+      var edges = getCompositeColumnEdges(params.column);
+      return mergeClasses(originalHeaderClass, params, [].concat(_toConsumableArray(edges.grouped ? [compositeClasses.header] : []), _toConsumableArray(edges.start ? [compositeClasses.start] : []), _toConsumableArray(edges.end ? [compositeClasses.end] : [])));
+    },
+    cellClassRules: _objectSpread(_objectSpread({}, column.cellClassRules), {}, _defineProperty(_defineProperty(_defineProperty({}, compositeClasses.cell, function (params) {
+      return getCompositeColumnEdges(params.column).grouped;
+    }), compositeClasses.start, function (params) {
+      return getCompositeColumnEdges(params.column).start;
+    }), compositeClasses.end, function (params) {
+      return getCompositeColumnEdges(params.column).end;
+    }))
+  });
+};

package/dist/cjs/standardList/groupedHeaders.less

@@ -0,0 +1,29 @@
+// 复合表头模板：上层居中，组内细线、组间加粗，颜色跟随当前主题。@author nokecy
+.ag-root-wrapper {
+	.app-grid-composite-group {
+		border-top: 1px solid var(--ag-border-color) !important;
+		border-inline: 2px solid var(--ag-border-color) !important;
+
+		.ag-header-group-cell-label {
+			justify-content: center !important;
+			width: 100%;
+		}
+	}
+
+	.app-grid-composite-header {
+		border-bottom: 1px solid var(--ag-border-color) !important;
+		border-inline-end: 1px solid var(--ag-border-color) !important;
+	}
+
+	.app-grid-composite-cell {
+		border-inline-end: 1px solid var(--ag-border-color) !important;
+	}
+
+	.app-grid-composite-start {
+		border-inline-start: 2px solid var(--ag-border-color) !important;
+	}
+
+	.app-grid-composite-end {
+		border-inline-end: 2px solid var(--ag-border-color) !important;
+	}
+}

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

@@ -0,0 +1,20 @@
+/**
+ * 标准列表：在 AgGridPlus 外面包一层公司列表规范，宿主通过属性注入刷新令牌与口径。
+ * 默认不影响任何现有使用方，需要时显式使用 `StandardAgGridPlus`。
+ *
+ * @author nokecy
+ */
+export { StandardAgGridColumn, StandardAgGridPlus } from './StandardAgGridPlus';
+export type { AppGridColumn, StandardListPolicy } from './StandardAgGridPlus';
+export { GridEmptyContext, GridEmptyState, hasActiveFilter } from './emptyState';
+export type { GridEmptyContextValue } from './emptyState';
+export { applyColDefSort, detachLiveSortFromColumnDefs, firstGridSorter } from './gridColumnDefs';
+export { compositeClasses, getCompositeColumnEdges, withCompositeGroupHeader, withCompositeLeafHeader } from './groupedHeaders';
+export { getListDateType, normalizeExtendedDateColumn, normalizeListDateColumn } from './listDateDisplay';
+export { formatDate, formatDateTime } from './dateFormat';
+export { flattenColumnDefs, inferListDefaultSort, resolveListSortPolicy, sortingText } from './listDefaultSort';
+export type { ListDefaultSort, ListDefaultSortOverride, ListSortPolicy } from './listDefaultSort';
+export { readRefreshToken, shouldRefresh, withRefreshToken } from './listRefresh';
+export type { RefreshDecisionInput } from './listRefresh';
+export { applyGridValueEnumToColumns, applyNormalizedEnumFallbacksToColumns, createNormalizedEnumFallbackRenderer } from './enumColumns';
+export type { EnumFallbackParams, EnumFallbackRenderer } from './enumColumns';