@nokecy/qc-ui 1.1.41 → 1.1.43

package/dist/cjs/ag-grid-plus/ag-gridPlus.js

@@ -16,6 +16,7 @@ var _toolBar = _interopRequireDefault(require("./toolBar"));
 var _settingItem = _interopRequireDefault(require("./settingItem"));
 var _icons = require("@ant-design/icons");
 var _utils = require("./utils");
+var _columnProcessors = require("./utils/columnProcessors");
 var _AdvancedQueryBuilder = _interopRequireDefault(require("./queryForm/AdvancedQueryBuilder"));
 var _uuid = require("uuid");
 var _setting = _interopRequireDefault(require("./setting"));
@@ -23,6 +24,9 @@ var _2 = require(".");
 var _useRowId2 = require("./hooks/useRowId");
 var _lodash = _interopRequireWildcard(require("lodash"));
 var _customGroupCellRenderer = _interopRequireDefault(require("./_utils/customGroupCellRenderer"));
+var _NoRowsOverlay = _interopRequireDefault(require("./shared/NoRowsOverlay"));
+var _constants = require("./utils/constants");
+var _emptyState = require("./utils/emptyState");
 var _processColumnGroups = _interopRequireDefault(require("./_utils/processColumnGroups"));
 var _processFormColumnState = _interopRequireDefault(require("./_utils/processFormColumnState"));
 var _antdV = require("@formily/antd-v5");
@@ -32,7 +36,6 @@ var _queryFormContext = require("./context/queryFormContext");
 var _useSchemeManager = require("./context/useSchemeManager");
 var _useSchemeDataFlow = require("./context/useSchemeDataFlow");
 var _schemeDataMigration = require("./shared/utils/schemeDataMigration");
-var _sanitize = require("./utils/sanitize");
 var _aggregation = require("./utils/aggregation");
 var _queryFormDerivation = require("./utils/queryFormDerivation");
 var _rowSelection = require("./utils/rowSelection");
@@ -40,7 +43,7 @@ var _requestParams = require("./utils/requestParams");
 var _errors = require("./errors");
 var _logger = require("./utils/logger");
 var _entityExtensionColumns = require("./utils/entityExtensionColumns");
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "emptyState", "accessible", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType"];
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
@@ -103,6 +106,9 @@ function AgGridPlus(props) {
     overlayNoRowsTemplateText = props.overlayNoRowsTemplateText,
     queryDefaultRows = props.queryDefaultRows,
     onSelectedRowsChange = props.onSelectedRowsChange,
+    emptyState = props.emptyState,
+    _props$accessible = props.accessible,
+    accessible = _props$accessible === void 0 ? true : _props$accessible,
     _props$enableClickSel = props.enableClickSelection,
     enableClickSelection = _props$enableClickSel === void 0 ? true : _props$enableClickSel,
     propsRowSelection = props.rowSelection,
@@ -149,35 +155,44 @@ function AgGridPlus(props) {
     _useState6 = _slicedToArray(_useState5, 2),
     loading = _useState6[0],
     setLoading = _useState6[1];
-  var _useState7 = (0, _react.useState)(),
+  // 空态四分需要的两个事实：这次请求是不是失败了、用户有没有施加筛选。@author nokecy
+  var _useState7 = (0, _react.useState)(null),
     _useState8 = _slicedToArray(_useState7, 2),
-    columnState = _useState8[0],
-    setColumnState = _useState8[1];
-  var _useState9 = (0, _react.useState)({}),
+    loadError = _useState8[0],
+    setLoadError = _useState8[1];
+  var _useState9 = (0, _react.useState)(false),
     _useState10 = _slicedToArray(_useState9, 2),
-    columnCellClass = _useState10[0],
-    setColumnCellClass = _useState10[1];
-  var _useState11 = (0, _react.useState)([]),
+    filtered = _useState10[0],
+    setFiltered = _useState10[1];
+  var _useState11 = (0, _react.useState)(),
     _useState12 = _slicedToArray(_useState11, 2),
-    rowData = _useState12[0],
-    setRowData = _useState12[1];
+    columnState = _useState12[0],
+    setColumnState = _useState12[1];
   var _useState13 = (0, _react.useState)({}),
     _useState14 = _slicedToArray(_useState13, 2),
-    queryFilter = _useState14[0],
-    setQueryFilter = _useState14[1];
-  var _useState15 = (0, _react.useState)(),
+    columnCellClass = _useState14[0],
+    setColumnCellClass = _useState14[1];
+  var _useState15 = (0, _react.useState)([]),
     _useState16 = _slicedToArray(_useState15, 2),
-    sortColumn = _useState16[0],
-    setSortColumn = _useState16[1];
+    rowData = _useState16[0],
+    setRowData = _useState16[1];
+  var _useState17 = (0, _react.useState)({}),
+    _useState18 = _slicedToArray(_useState17, 2),
+    queryFilter = _useState18[0],
+    setQueryFilter = _useState18[1];
+  var _useState19 = (0, _react.useState)(),
+    _useState20 = _slicedToArray(_useState19, 2),
+    sortColumn = _useState20[0],
+    setSortColumn = _useState20[1];
   // 初始化分页参数，支持外部传入的pageSize
-  var _useState17 = (0, _react.useState)({
+  var _useState21 = (0, _react.useState)({
       pageSize: props.pageSize !== undefined ? props.pageSize : props.hidePagination ? 10000 : 200,
       current: 1,
       total: dataSource ? dataSource.length : 0
     }),
-    _useState18 = _slicedToArray(_useState17, 2),
-    pagination = _useState18[0],
-    setPagination = _useState18[1];
+    _useState22 = _slicedToArray(_useState21, 2),
+    pagination = _useState22[0],
+    setPagination = _useState22[1];
 
   // ============ 方案管理 - 使用集中式 Context ============
   var _useGridSchemes = (0, _useSchemeManager.useGridSchemes)(),
@@ -196,16 +211,16 @@ function AgGridPlus(props) {
     getColumnSchemes = _useGridSchemes.getColumnSchemes,
     getQuerySchemes = _useGridSchemes.getQuerySchemes,
     getCurrentScheme = _useGridSchemes.getCurrentScheme;
-  var _useState19 = (0, _react.useState)([]),
-    _useState20 = _slicedToArray(_useState19, 2),
-    queryItemsOrder = _useState20[0],
-    setQueryItemsOrder = _useState20[1];
+  var _useState23 = (0, _react.useState)([]),
+    _useState24 = _slicedToArray(_useState23, 2),
+    queryItemsOrder = _useState24[0],
+    setQueryItemsOrder = _useState24[1];
 
   // 高级查询状态
-  var _useState21 = (0, _react.useState)(false),
-    _useState22 = _slicedToArray(_useState21, 2),
-    advancedPopoverOpen = _useState22[0],
-    setAdvancedPopoverOpen = _useState22[1];
+  var _useState25 = (0, _react.useState)(false),
+    _useState26 = _slicedToArray(_useState25, 2),
+    advancedPopoverOpen = _useState26[0],
+    setAdvancedPopoverOpen = _useState26[1];
   var createEmptyRuleGroup = function createEmptyRuleGroup() {
     return {
       id: (0, _uuid.v4)(),
@@ -213,10 +228,10 @@ function AgGridPlus(props) {
       children: []
     };
   };
-  var _useState23 = (0, _react.useState)(createEmptyRuleGroup),
-    _useState24 = _slicedToArray(_useState23, 2),
-    advancedQueryRules = _useState24[0],
-    setAdvancedQueryRules = _useState24[1];
+  var _useState27 = (0, _react.useState)(createEmptyRuleGroup),
+    _useState28 = _slicedToArray(_useState27, 2),
+    advancedQueryRules = _useState28[0],
+    setAdvancedQueryRules = _useState28[1];
 
   /**
    * 【P1 架构优化】使用单向数据流架构
@@ -476,7 +491,7 @@ function AgGridPlus(props) {
         });
         return match ? match.label : params.value;
       };
-      return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+      return _objectSpread(_objectSpread(_objectSpread({}, (0, _columnProcessors.toColumnType)(dataType)), col), {}, {
         cellRenderer: function cellRenderer(params) {
           var match = valueEnum.find(function (item) {
             return item.value == params.value;
@@ -536,7 +551,7 @@ function AgGridPlus(props) {
         cellRenderer: cellRenderer
       });
     }
-    return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+    return _objectSpread(_objectSpread(_objectSpread({}, (0, _columnProcessors.toColumnType)(dataType)), col), {}, {
       customCellRenderer: col.cellRenderer,
       cellRenderer: cellRenderer
     });
@@ -697,6 +712,8 @@ function AgGridPlus(props) {
     try {
       // 处理高级查询模式 / 简单模式的过滤字符串构建
       var filter = (0, _requestParams.buildFilterString)(queryFilter, allColDefsRef.current);
+      // 空结果要不要说「换个筛选条件试试」，取决于用户这次到底有没有筛。@author nokecy
+      setFiltered((0, _emptyState.hasEffectiveFilter)(filter, queryFilter));
       var params = _objectSpread(_objectSpread({
         filter: filter
       }, stableGridParams), {}, {
@@ -734,6 +751,7 @@ function AgGridPlus(props) {
           });
         });
         setLoading(false);
+        setLoadError(null);
         _logger.logger.info('数据请求成功', {
           rowCount: rowCount
         });
@@ -796,6 +814,9 @@ function AgGridPlus(props) {
           originalError: error
         }, error);
 
+        // 失败必须留痕：不留痕的话表格只会显示「没有找到数据」，把接口故障说成没数据。@author nokecy
+        setLoadError(gridError);
+
         // 记录错误
         _logger.logger.error('数据请求失败', gridError.getDetails());
 
@@ -815,6 +836,7 @@ function AgGridPlus(props) {
         queryFilter: queryFilter,
         allColDefs: allColDefsRef.current
       }, error instanceof Error ? error : undefined);
+      setLoadError(gridError);
       _logger.logger.error('数据请求处理失败', gridError.getDetails());
       _antd.message.error(gridError.getUserMessage());
       if (onErrorRef.current) {
@@ -895,6 +917,27 @@ function AgGridPlus(props) {
       onRequest(stableQueryFilter);
     }
   }, [onRequest, stableQueryFilter]);
+
+  // 空态四分：加载失败 / 无权限 / 筛选无结果 / 无数据，各说各的，失败那支还给出「重试」。
+  // 以前四种情况共用一句「没有找到数据，试试调整筛选条件吧！」，接口挂了也这么说，
+  // 用户按提示去调筛选，越调越没有。@author nokecy
+  var noRowsOverlayParams = (0, _react.useMemo)(function () {
+    return {
+      branch: (0, _emptyState.resolveEmptyBranch)({
+        hasError: !!loadError,
+        accessible: accessible,
+        filtered: filtered
+      }),
+      text: (0, _emptyState.resolveEmptyText)({
+        hasError: !!loadError,
+        accessible: accessible,
+        filtered: filtered,
+        override: overlayNoRowsTemplateText,
+        texts: emptyState
+      }),
+      onRetry: onRefresh
+    };
+  }, [loadError, accessible, filtered, overlayNoRowsTemplateText, emptyState, onRefresh]);
   (0, _react.useEffect)(function () {
     gridRef.current = {
       onRefresh: onRefresh
@@ -1336,7 +1379,12 @@ function AgGridPlus(props) {
       ensureDomOrder: true,
       columnHoverHighlight: true
     },
-    overlayNoRowsTemplate: (0, _sanitize.createSafeHtmlTemplate)(overlayNoRowsTemplateText || '没有找到数据，试试调整筛选条件吧！'),
+    noRowsOverlayComponent: _NoRowsOverlay.default,
+    noRowsOverlayComponentParams: noRowsOverlayParams
+    // 加载中不显示空态：外层 Spin 已经在转，再叠一句「暂无数据」会让用户
+    // 以为真的没数据（冒烟截图里这两者确实同时出现过）。@author nokecy
+    ,
+    suppressNoRowsOverlay: loading,
     enableRangeSelection: true,
     suppressCopyRowsToClipboard: true,
     autoGroupColumnDef: autoGroupColumnDef
@@ -1416,7 +1464,7 @@ function AgGridPlus(props) {
     showTotal: function showTotal(total, range) {
       return "\u7B2C ".concat(range[0], "-").concat(range[1], " \u6761/\u603B\u5171 ").concat(total, " \u6761");
     },
-    pageSizeOptions: props.pageSizeOptions || [10, 20, 50, 100, 200, 500, 1000, 10000],
+    pageSizeOptions: props.pageSizeOptions || _constants.DEFAULT_PAGE_SIZE_OPTIONS,
     hideOnSinglePage: false,
     showQuickJumper: false
   })))))));

package/dist/cjs/ag-grid-plus/interface.d.ts

@@ -2,6 +2,7 @@ import { GridApi, ColDef, ColGroupDef } from "ag-grid-community";
 import { AgGridReactProps } from "ag-grid-react";
 import React, { CSSProperties, ReactNode } from "react";
 import type { GridPlusError } from "./errors";
+import type { EmptyStateTexts } from "./utils/emptyState";
 interface GridRef {
     onRefresh: () => void;
 }
@@ -42,9 +43,24 @@ interface GridProps extends AgGridReactProps {
      */
     gridColumnState?: any[];
     /**
-     * 列表空数据文字提示
+     * 列表空数据文字提示。
+     * 传了它就一律用它（最高优先级），保持既有调用点行为不变；
+     * 想按「无数据 / 筛选无结果 / 无权限 / 加载失败」分别给文案，用 `emptyState`。
      */
     overlayNoRowsTemplateText?: string;
+    /**
+     * 空态四分文案覆盖：{ noData, noResult, noPermission, error }。
+     * 不传就用内置默认：加载失败说加载失败并给「重试」，没筛选就说「暂无数据」，
+     * 不再一律引导用户去调筛选条件。
+     * @author nokecy
+     */
+    emptyState?: EmptyStateTexts;
+    /**
+     * 当前用户是否有权查看该列表。传 false 时空态说「没有权限」而不是「暂无数据」，
+     * 免得用户以为是数据还没录进来。
+     * @author nokecy
+     */
+    accessible?: boolean;
     /**
      * 查询Form默认展示行数
      */

package/dist/cjs/ag-grid-plus/queryForm/queryForm.js

@@ -83,7 +83,7 @@ var QueryForm = (0, _react.observer)(function (props) {
 
   var renderActions = function renderActions() {
     return /*#__PURE__*/_react2.default.createElement(_react2.Fragment, null, /*#__PURE__*/_react2.default.createElement(_antdV.Submit, {
-      type: "default",
+      type: "primary",
       icon: /*#__PURE__*/_react2.default.createElement(_icons.SearchOutlined, null)
     }, "\u67E5\u8BE2"), /*#__PURE__*/_react2.default.createElement(_antd.Button, {
       icon: /*#__PURE__*/_react2.default.createElement(_icons.ClearOutlined, null),

package/dist/cjs/ag-grid-plus/shared/NoRowsOverlay.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { EmptyStateBranch } from '../utils/emptyState';
+/**
+ * 表格空态浮层。
+ *
+ * 换掉原来的 `overlayNoRowsTemplate` 纯 HTML 模板：模板只能放一句话，
+ * 于是「接口挂了」和「这条数据确实没有」共用了同一句
+ * 「没有找到数据，试试调整筛选条件吧！」，把用户往错误的方向引。
+ * 用 React 浮层才放得下「重试」这样的出路。
+ *
+ * @author nokecy
+ */
+export interface NoRowsOverlayParams {
+    /** 当前该走哪一支：加载失败 / 无权限 / 筛选无结果 / 无数据 */
+    branch?: EmptyStateBranch;
+    /** 该支的文案 */
+    text?: string;
+    /** 加载失败时的重试入口 */
+    onRetry?: () => void;
+}
+declare const NoRowsOverlay: React.FC<NoRowsOverlayParams>;
+export default NoRowsOverlay;

package/dist/cjs/ag-grid-plus/shared/NoRowsOverlay.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _antd = require("antd");
+var _react = _interopRequireDefault(require("react"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 表格空态浮层。
+ *
+ * 换掉原来的 `overlayNoRowsTemplate` 纯 HTML 模板：模板只能放一句话，
+ * 于是「接口挂了」和「这条数据确实没有」共用了同一句
+ * 「没有找到数据，试试调整筛选条件吧！」，把用户往错误的方向引。
+ * 用 React 浮层才放得下「重试」这样的出路。
+ *
+ * @author nokecy
+ */
+
+var NoRowsOverlay = function NoRowsOverlay(_ref) {
+  var branch = _ref.branch,
+    text = _ref.text,
+    onRetry = _ref.onRetry;
+  return /*#__PURE__*/_react.default.createElement("div", {
+    style: {
+      display: 'flex',
+      flexDirection: 'column',
+      alignItems: 'center',
+      gap: 8
+    }
+  }, /*#__PURE__*/_react.default.createElement(_antd.Empty, {
+    image: _antd.Empty.PRESENTED_IMAGE_SIMPLE,
+    description: text
+  }), branch === 'error' && onRetry ? /*#__PURE__*/_react.default.createElement(_antd.Button, {
+    size: "small",
+    danger: true,
+    onClick: onRetry
+  }, "\u91CD\u8BD5") : null);
+};
+var _default = exports.default = NoRowsOverlay;

package/dist/cjs/ag-grid-plus/utils/columnProcessors.d.ts

@@ -49,6 +49,22 @@ export declare function handleGridPlusColumnState(columnState: ExtendedColumnSta
  * @returns 数据类型推断结果
  */
 export declare function inferDataType(data: any, colName: string, valueEnum?: ValueEnumItem[]): DataTypeInference | undefined;
+/**
+ * 把「推断出的数据类型」翻译成列定义片段。
+ *
+ * dataType.type 是数据类型（number/string/...），不是 AG Grid 的列类型（columnTypes）。
+ * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
+ * 根本没有叫 number 的类型，这个字段一直没生效。
+ *
+ * 数量型数值列真正该有的是右对齐：位数对齐了才能一眼比大小。只有 calculateType 为真
+ * （可求和的数量型）才右对齐；用 valueEnum 表示分类的数值列（状态码之类）不动。
+ *
+ * @author nokecy
+ */
+export declare function toColumnType(dataType?: DataTypeInference): {
+    calculateType?: any;
+    type?: string;
+};
 /**
  * 处理枚举列定义
  *

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

@@ -11,6 +11,7 @@ exports.handleGridPlusColumnState = handleGridPlusColumnState;
 exports.inferDataType = inferDataType;
 exports.processEllipsisColumn = processEllipsisColumn;
 exports.processEnumColumn = processEnumColumn;
+exports.toColumnType = toColumnType;
 var _react = _interopRequireDefault(require("react"));
 var _antd = require("antd");
 var _antdV = require("@formily/antd-v5");
@@ -96,6 +97,31 @@ function inferDataType(data, colName, valueEnum) {
   return undefined;
 }
 
+/**
+ * 把「推断出的数据类型」翻译成列定义片段。
+ *
+ * dataType.type 是数据类型（number/string/...），不是 AG Grid 的列类型（columnTypes）。
+ * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
+ * 根本没有叫 number 的类型，这个字段一直没生效。
+ *
+ * 数量型数值列真正该有的是右对齐：位数对齐了才能一眼比大小。只有 calculateType 为真
+ * （可求和的数量型）才右对齐；用 valueEnum 表示分类的数值列（状态码之类）不动。
+ *
+ * @author nokecy
+ */
+function toColumnType(dataType) {
+  if (!dataType) return {};
+  if (dataType.type === 'number' && dataType.calculateType) {
+    return {
+      calculateType: dataType.calculateType,
+      type: 'rightAligned'
+    };
+  }
+  return {
+    calculateType: dataType.calculateType
+  };
+}
+
 /**
  * 处理枚举列定义
  *

package/dist/cjs/ag-grid-plus/utils/constants.d.ts

@@ -14,6 +14,12 @@ export declare const DEFAULT_SEARCH_SORT_ORDER = 999;
 /**
  * 默认分页大小选项
  */
+/**
+ * 一次取 10000 行会让车间那台低配 PC 直接卡死，而且没有哪个岗位需要一屏翻一万行——
+ * 要全量数据应该走导出。上限收到 1000。
+ * 不分页场景另有 DEFAULT_PAGE_SIZE_WHEN_HIDDEN，不受这里影响。
+ * @author nokecy
+ */
 export declare const DEFAULT_PAGE_SIZE_OPTIONS: number[];
 /**
  * 默认分页大小

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

@@ -23,7 +23,13 @@ var DEFAULT_SEARCH_SORT_ORDER = exports.DEFAULT_SEARCH_SORT_ORDER = 999;
 /**
  * 默认分页大小选项
  */
-var DEFAULT_PAGE_SIZE_OPTIONS = exports.DEFAULT_PAGE_SIZE_OPTIONS = [10, 20, 50, 100, 200, 500, 1000, 10000];
+/**
+ * 一次取 10000 行会让车间那台低配 PC 直接卡死，而且没有哪个岗位需要一屏翻一万行——
+ * 要全量数据应该走导出。上限收到 1000。
+ * 不分页场景另有 DEFAULT_PAGE_SIZE_WHEN_HIDDEN，不受这里影响。
+ * @author nokecy
+ */
+var DEFAULT_PAGE_SIZE_OPTIONS = exports.DEFAULT_PAGE_SIZE_OPTIONS = [10, 20, 50, 100, 200, 500, 1000];
 
 /**
  * 默认分页大小

package/dist/cjs/ag-grid-plus/utils/emptyState.d.ts

@@ -0,0 +1,42 @@
+import type { QueryFilterState } from '../types';
+/**
+ * 表格空态四分。
+ *
+ * 原来空态的全部表达能力是一个字符串，兜底文案是「没有找到数据，试试调整筛选条件吧！」——
+ * 请求失败时显示的也是这一句。在 MES 这类业务里，「这条数据确实没有」和「接口挂了」
+ * 导向完全相反的动作（去补录 vs 去叫 IT），用同一句话回答，还主动把用户往筛选条件上引，
+ * 是一次系统性的假阴性。
+ *
+ * 这里把空态拆成四支：加载失败 / 无权限 / 筛选无结果 / 无数据，逻辑写成纯函数便于单测。
+ *
+ * @author nokecy
+ */
+export type EmptyStateBranch = 'error' | 'noPermission' | 'noResult' | 'noData';
+/** 四支文案，按支覆盖。不传的支走默认。 */
+export type EmptyStateTexts = Partial<Record<EmptyStateBranch, string>>;
+export declare const DEFAULT_EMPTY_TEXTS: Record<EmptyStateBranch, string>;
+/**
+ * 判断本次请求是否带着生效筛选。
+ * 只有它为真，空结果才该说「换个筛选条件试试」；否则说「暂无数据」。
+ *
+ * @param filterString buildFilterString 的产物，涵盖简单查询与高级查询
+ * @param queryFilter  查询表单当前值，用于兜住 filterString 尚未覆盖的场景
+ */
+export declare function hasEffectiveFilter(filterString?: string, queryFilter?: QueryFilterState | null): boolean;
+/** 选出当前该走哪一支。优先级：加载失败 > 无权限 > 筛选无结果 > 无数据。 */
+export declare function resolveEmptyBranch(state: {
+    hasError?: boolean;
+    accessible?: boolean;
+    filtered?: boolean;
+}): EmptyStateBranch;
+/**
+ * 算出最终要显示的空态文案。
+ * `override` 是调用方原来就在用的 `overlayNoRowsTemplateText`，保持最高优先级，向后兼容。
+ */
+export declare function resolveEmptyText(state: {
+    hasError?: boolean;
+    accessible?: boolean;
+    filtered?: boolean;
+    override?: string;
+    texts?: EmptyStateTexts;
+}): string;

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

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_EMPTY_TEXTS = void 0;
+exports.hasEffectiveFilter = hasEffectiveFilter;
+exports.resolveEmptyBranch = resolveEmptyBranch;
+exports.resolveEmptyText = resolveEmptyText;
+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 = {
+  error: '数据加载失败，请点上方「重试」',
+  noPermission: '没有查看该数据的权限，请联系系统管理员',
+  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$branch, _state$texts;
+  if (state.override) return state.override;
+  var branch = resolveEmptyBranch(state);
+  return (_state$texts$branch = (_state$texts = state.texts) === null || _state$texts === void 0 ? void 0 : _state$texts[branch]) !== null && _state$texts$branch !== void 0 ? _state$texts$branch : DEFAULT_EMPTY_TEXTS[branch];
+}

package/dist/cjs/array-table/utils.d.ts

@@ -20,6 +20,17 @@ declare const useArrayTableActions: () => ObservableColumnSource[];
  * 校验安全:未碰过的存量格本就是 readPretty、本就不参与校验,不挂树校验语义零变化。@author nokecy
  */
 declare const LazyAgField: (params: any) => React.JSX.Element;
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
 declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
 declare const useAddition: () => React.JSX.Element | null;
-export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField };
+export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };