@nokecy/qc-ui 1.1.88 → 1.1.90

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

@@ -43,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", "emptyState", "accessible", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType", "valueEnumContrast"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "onQueryValuesChange", "emptyState", "accessible", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType", "valueEnumContrast"];
 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; }
@@ -109,6 +109,7 @@ function AgGridPlus(props) {
     overlayNoRowsTemplateText = props.overlayNoRowsTemplateText,
     queryDefaultRows = props.queryDefaultRows,
     onSelectedRowsChange = props.onSelectedRowsChange,
+    onQueryValuesChange = props.onQueryValuesChange,
     emptyState = props.emptyState,
     _props$accessible = props.accessible,
     accessible = _props$accessible === void 0 ? true : _props$accessible,
@@ -1161,6 +1162,7 @@ function AgGridPlus(props) {
     columnStates: (_ref = derivedColumnState !== null && derivedColumnState !== void 0 ? derivedColumnState : columnState) !== null && _ref !== void 0 ? _ref : [],
     defaultExpand: defaultSearchExpand,
     gridApi: apiRef.current,
+    onValuesChange: onQueryValuesChange,
     onQuery: function onQuery(formValues) {
       // 优先使用高级搜索：如果存在高级搜索条件，忽略简单查询
       if (advancedQueryRules.children.length > 0) {

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

@@ -85,6 +85,12 @@ interface GridProps extends AgGridReactProps {
      * 选中行变化回调函数
      */
     onSelectedRowsChange?: (selectedRows: any[]) => void;
+    /**
+     * 查询区条件值变化时回调（输入、默认值落位、重置都会触发），参数为当前条件快照，以查询字段名为键。
+     * 只通知、不发起查询；宿主可据此与上次查询用的条件比较，提示「条件已变更，请查询」。
+     * @author nokecy
+     */
+    onQueryValuesChange?: (values: Record<string, any>) => void;
     /**
      * 错误处理回调函数
      * 当组件发生错误时调用，可用于自定义错误处理逻辑

package/dist/cjs/ag-grid-plus/queryForm/index.d.ts

@@ -1,6 +1,8 @@
 import { ColDef, ColumnState, GridApi } from 'ag-grid-community';
 import React from 'react';
 import './index.less';
+/** 查询区初始化兜底：requestAnimationFrame 迟迟不触发时，最迟这么久后通知首查（毫秒）。@author nokecy */
+export declare const INIT_FALLBACK_DELAY = 300;
 declare const FormRender: (props: {
     className?: any;
     gridApi?: GridApi<any> | undefined;
@@ -12,5 +14,7 @@ declare const FormRender: (props: {
     defaultRows?: number | undefined;
     onQuery: (formValue: any) => void;
     onInit?: ((defaultValues: any) => void) | undefined;
+    /** 查询条件值变化（输入、默认值落位、重置）时回调，参数为当前条件快照；不触发查询。@author nokecy */
+    onValuesChange?: ((values: Record<string, any>) => void) | undefined;
 }) => React.JSX.Element;
 export default FormRender;

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

@@ -4,7 +4,7 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.default = exports.INIT_FALLBACK_DELAY = void 0;
 var _antdV = require("@formily/antd-v5");
 var _core = require("@formily/core");
 var _react = require("@formily/react");
@@ -30,6 +30,8 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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; } // @author nokecy
+/** 查询区初始化兜底：requestAnimationFrame 迟迟不触发时，最迟这么久后通知首查（毫秒）。@author nokecy */
+var INIT_FALLBACK_DELAY = exports.INIT_FALLBACK_DELAY = 300;
 var FormRender = function FormRender(props) {
   var className = props.className,
     colDefs = props.colDefs,
@@ -55,6 +57,20 @@ var FormRender = function FormRender(props) {
   var form = (0, _react2.useMemo)(function () {
     return (0, _core.createForm)();
   }, []);
+
+  // 条件变化只通知宿主（如提示「条件已变更」），回调走 ref，宿主每次渲染传新函数也不重复订阅。@author nokecy
+  var onValuesChangeRef = (0, _react2.useRef)(props.onValuesChange);
+  onValuesChangeRef.current = props.onValuesChange;
+  (0, _react2.useEffect)(function () {
+    var id = form.subscribe(function (_ref) {
+      var _onValuesChangeRef$cu;
+      var type = _ref.type;
+      if (type === _core.LifeCycleTypes.ON_FORM_VALUES_CHANGE) (_onValuesChangeRef$cu = onValuesChangeRef.current) === null || _onValuesChangeRef$cu === void 0 || _onValuesChangeRef$cu.call(onValuesChangeRef, _objectSpread({}, form.values));
+    });
+    return function () {
+      return form.unsubscribe(id);
+    };
+  }, [form]);
   var SchemaField = (0, _react2.useMemo)(function () {
     return (0, _react.createSchemaField)({
       components: {
@@ -196,10 +212,10 @@ var FormRender = function FormRender(props) {
     previousFieldsRef.current = Object.keys(fieldSchemas);
     setSchema(new_schema);
     // 已有字段同步元数据，不触碰仍有效字段的查询值，也不触发查询。@author nokecy
-    Object.entries(fieldSchemas).forEach(function (_ref) {
-      var _ref2 = _slicedToArray(_ref, 2),
-        name = _ref2[0],
-        fieldSchema = _ref2[1];
+    Object.entries(fieldSchemas).forEach(function (_ref2) {
+      var _ref3 = _slicedToArray(_ref2, 2),
+        name = _ref3[0],
+        fieldSchema = _ref3[1];
       form.query(name).take(function (field) {
         var _fieldSchema$enum;
         field.title = fieldSchema.title;
@@ -222,11 +238,18 @@ var FormRender = function FormRender(props) {
     if (!initializedRef.current) {
       initializedRef.current = true;
       // 使用 requestAnimationFrame + setTimeout 确保默认值已应用
+      // 后台标签页或浏览器繁忙时 requestAnimationFrame 可能迟迟不触发，列表首查就一直不发，
+      // 只能手动点「查询」；另设一个定时兜底，两条路先到先执行、只执行一次。@author nokecy
+      var initialized = false;
+      var notifyInit = function notifyInit() {
+        if (initialized) return;
+        initialized = true;
+        props.onInit && props.onInit(form.values);
+      };
       requestAnimationFrame(function () {
-        setTimeout(function () {
-          props.onInit && props.onInit(form.values);
-        }, 0);
+        setTimeout(notifyInit, 0);
       });
+      setTimeout(notifyInit, INIT_FALLBACK_DELAY);
     }
   }, [schemaKey, defaultRows, props.defaultExpand]);
   return /*#__PURE__*/_react2.default.createElement("div", {

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

@@ -28,6 +28,13 @@ export interface GridEmptyContextValue {
     onRetry?: () => void;
 }
 export declare const GridEmptyContext: React.Context<GridEmptyContextValue>;
+/**
+ * 403 是否真的是「没有权限」。ABP 的业务异常（BusinessException）默认也按 403 返回，
+ * 例如「工厂日历缺少所选年周」；这类有业务错误码的 403 要显示后端原因并允许重试，
+ * 不能说成没权限，否则用户会去找管理员授权而真因在数据。
+ * 授权失败的错误码以 Volo.Authorization 开头，或没有错误码。@author nokecy
+ */
+export declare const isPermissionDenied: (status?: number, code?: string) => boolean;
 export declare const GridEmptyState: React.FC;
 /**
  * 判断请求 filter 是否带生效条件（任意叶子值非空即算有筛选）。

package/dist/cjs/standardList/emptyState.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.hasActiveFilter = exports.GridEmptyState = exports.GridEmptyContext = void 0;
+exports.isPermissionDenied = 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 }; }
@@ -31,6 +31,16 @@ 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;
 };
+
+/**
+ * 403 是否真的是「没有权限」。ABP 的业务异常（BusinessException）默认也按 403 返回，
+ * 例如「工厂日历缺少所选年周」；这类有业务错误码的 403 要显示后端原因并允许重试，
+ * 不能说成没权限，否则用户会去找管理员授权而真因在数据。
+ * 授权失败的错误码以 Volo.Authorization 开头，或没有错误码。@author nokecy
+ */
+var isPermissionDenied = exports.isPermissionDenied = function isPermissionDenied(status, code) {
+  return status === 403 && (!code || code.startsWith('Volo.Authorization'));
+};
 var GridEmptyState = exports.GridEmptyState = function GridEmptyState() {
   var _React$useContext = _react.default.useContext(GridEmptyContext),
     error = _React$useContext.error,
@@ -48,8 +58,8 @@ var GridEmptyState = exports.GridEmptyState = function GridEmptyState() {
     });
   }
 
-  // 分支 1：无权限（403）——说明原因，不给任何入口
-  if (error && httpStatusOf(error) === 403) {
+  // 分支 1：无权限（403 且不是业务异常）——说明原因，不给任何入口
+  if (error && isPermissionDenied(httpStatusOf(error), remoteError === null || remoteError === void 0 ? void 0 : remoteError.code)) {
     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"
@@ -59,8 +69,10 @@ var GridEmptyState = exports.GridEmptyState = function GridEmptyState() {
   // 分支 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"
+      image: _antd.Empty.PRESENTED_IMAGE_SIMPLE
+      // 后端给了业务原因（如数据未维护）时直接显示原因，告诉用户下一步。@author nokecy
+      ,
+      description: remoteError !== null && remoteError !== void 0 && remoteError.code && remoteError.message ? remoteError.message : '加载失败，请检查后重试'
     }, onRetry && /*#__PURE__*/_react.default.createElement(_antd.Button, {
       size: "small",
       type: "primary",

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

@@ -6,7 +6,7 @@
  */
 export { StandardAgGridColumn, StandardAgGridPlus } from './StandardAgGridPlus';
 export type { AppGridColumn, StandardListPolicy } from './StandardAgGridPlus';
-export { GridEmptyContext, GridEmptyState, hasActiveFilter } from './emptyState';
+export { GridEmptyContext, GridEmptyState, hasActiveFilter, isPermissionDenied } from './emptyState';
 export type { GridEmptyContextValue } from './emptyState';
 export { applyColDefSort, detachLiveSortFromColumnDefs, firstGridSorter } from './gridColumnDefs';
 export { compositeClasses, getCompositeColumnEdges, withCompositeGroupHeader, withCompositeLeafHeader } from './groupedHeaders';

package/dist/cjs/standardList/index.js

@@ -111,6 +111,12 @@ Object.defineProperty(exports, "inferListDefaultSort", {
     return _listDefaultSort.inferListDefaultSort;
   }
 });
+Object.defineProperty(exports, "isPermissionDenied", {
+  enumerable: true,
+  get: function get() {
+    return _emptyState.isPermissionDenied;
+  }
+});
 Object.defineProperty(exports, "normalizeExtendedDateColumn", {
   enumerable: true,
   get: function get() {

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

@@ -1,4 +1,4 @@
-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", "valueEnumContrast"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "onQueryValuesChange", "emptyState", "accessible", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType", "valueEnumContrast"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
@@ -101,6 +101,7 @@ function AgGridPlus(props) {
     overlayNoRowsTemplateText = props.overlayNoRowsTemplateText,
     queryDefaultRows = props.queryDefaultRows,
     onSelectedRowsChange = props.onSelectedRowsChange,
+    onQueryValuesChange = props.onQueryValuesChange,
     emptyState = props.emptyState,
     _props$accessible = props.accessible,
     accessible = _props$accessible === void 0 ? true : _props$accessible,
@@ -1153,6 +1154,7 @@ function AgGridPlus(props) {
     columnStates: (_ref = derivedColumnState !== null && derivedColumnState !== void 0 ? derivedColumnState : columnState) !== null && _ref !== void 0 ? _ref : [],
     defaultExpand: defaultSearchExpand,
     gridApi: apiRef.current,
+    onValuesChange: onQueryValuesChange,
     onQuery: function onQuery(formValues) {
       // 优先使用高级搜索：如果存在高级搜索条件，忽略简单查询
       if (advancedQueryRules.children.length > 0) {

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

@@ -85,6 +85,12 @@ interface GridProps extends AgGridReactProps {
      * 选中行变化回调函数
      */
     onSelectedRowsChange?: (selectedRows: any[]) => void;
+    /**
+     * 查询区条件值变化时回调（输入、默认值落位、重置都会触发），参数为当前条件快照，以查询字段名为键。
+     * 只通知、不发起查询；宿主可据此与上次查询用的条件比较，提示「条件已变更，请查询」。
+     * @author nokecy
+     */
+    onQueryValuesChange?: (values: Record<string, any>) => void;
     /**
      * 错误处理回调函数
      * 当组件发生错误时调用，可用于自定义错误处理逻辑

package/dist/esm/ag-grid-plus/queryForm/index.d.ts

@@ -1,6 +1,8 @@
 import { ColDef, ColumnState, GridApi } from 'ag-grid-community';
 import React from 'react';
 import './index.less';
+/** 查询区初始化兜底：requestAnimationFrame 迟迟不触发时，最迟这么久后通知首查（毫秒）。@author nokecy */
+export declare const INIT_FALLBACK_DELAY = 300;
 declare const FormRender: (props: {
     className?: any;
     gridApi?: GridApi<any> | undefined;
@@ -12,5 +14,7 @@ declare const FormRender: (props: {
     defaultRows?: number | undefined;
     onQuery: (formValue: any) => void;
     onInit?: ((defaultValues: any) => void) | undefined;
+    /** 查询条件值变化（输入、默认值落位、重置）时回调，参数为当前条件快照；不触发查询。@author nokecy */
+    onValuesChange?: ((values: Record<string, any>) => void) | undefined;
 }) => React.JSX.Element;
 export default FormRender;

package/dist/esm/ag-grid-plus/queryForm/index.js

@@ -11,7 +11,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 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; }
 import { DatePicker, FormButtonGroup, FormGrid, FormItem, Form, Input, Select, Submit } from '@formily/antd-v5'; // @author nokecy
-import { createForm } from '@formily/core';
+import { createForm, LifeCycleTypes } from '@formily/core';
 import { createSchemaField } from '@formily/react';
 import { Button, theme } from 'antd';
 import classNames from 'classnames';
@@ -21,6 +21,9 @@ import { queryFormSchemaKey } from "./schemaKey";
 import { resolveQueryColumns } from "./queryColumns";
 import BoolSelect from "../_utils/boolSelect";
 import "./index.less";
+
+/** 查询区初始化兜底：requestAnimationFrame 迟迟不触发时，最迟这么久后通知首查（毫秒）。@author nokecy */
+export var INIT_FALLBACK_DELAY = 300;
 var FormRender = function FormRender(props) {
   var className = props.className,
     colDefs = props.colDefs,
@@ -46,6 +49,20 @@ var FormRender = function FormRender(props) {
   var form = useMemo(function () {
     return createForm();
   }, []);
+
+  // 条件变化只通知宿主（如提示「条件已变更」），回调走 ref，宿主每次渲染传新函数也不重复订阅。@author nokecy
+  var onValuesChangeRef = useRef(props.onValuesChange);
+  onValuesChangeRef.current = props.onValuesChange;
+  useEffect(function () {
+    var id = form.subscribe(function (_ref) {
+      var _onValuesChangeRef$cu;
+      var type = _ref.type;
+      if (type === LifeCycleTypes.ON_FORM_VALUES_CHANGE) (_onValuesChangeRef$cu = onValuesChangeRef.current) === null || _onValuesChangeRef$cu === void 0 || _onValuesChangeRef$cu.call(onValuesChangeRef, _objectSpread({}, form.values));
+    });
+    return function () {
+      return form.unsubscribe(id);
+    };
+  }, [form]);
   var SchemaField = useMemo(function () {
     return createSchemaField({
       components: {
@@ -187,10 +204,10 @@ var FormRender = function FormRender(props) {
     previousFieldsRef.current = Object.keys(fieldSchemas);
     setSchema(new_schema);
     // 已有字段同步元数据，不触碰仍有效字段的查询值，也不触发查询。@author nokecy
-    Object.entries(fieldSchemas).forEach(function (_ref) {
-      var _ref2 = _slicedToArray(_ref, 2),
-        name = _ref2[0],
-        fieldSchema = _ref2[1];
+    Object.entries(fieldSchemas).forEach(function (_ref2) {
+      var _ref3 = _slicedToArray(_ref2, 2),
+        name = _ref3[0],
+        fieldSchema = _ref3[1];
       form.query(name).take(function (field) {
         var _fieldSchema$enum;
         field.title = fieldSchema.title;
@@ -213,11 +230,18 @@ var FormRender = function FormRender(props) {
     if (!initializedRef.current) {
       initializedRef.current = true;
       // 使用 requestAnimationFrame + setTimeout 确保默认值已应用
+      // 后台标签页或浏览器繁忙时 requestAnimationFrame 可能迟迟不触发，列表首查就一直不发，
+      // 只能手动点「查询」；另设一个定时兜底，两条路先到先执行、只执行一次。@author nokecy
+      var initialized = false;
+      var notifyInit = function notifyInit() {
+        if (initialized) return;
+        initialized = true;
+        props.onInit && props.onInit(form.values);
+      };
       requestAnimationFrame(function () {
-        setTimeout(function () {
-          props.onInit && props.onInit(form.values);
-        }, 0);
+        setTimeout(notifyInit, 0);
       });
+      setTimeout(notifyInit, INIT_FALLBACK_DELAY);
     }
   }, [schemaKey, defaultRows, props.defaultExpand]);
   return /*#__PURE__*/React.createElement("div", {

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

@@ -28,6 +28,13 @@ export interface GridEmptyContextValue {
     onRetry?: () => void;
 }
 export declare const GridEmptyContext: React.Context<GridEmptyContextValue>;
+/**
+ * 403 是否真的是「没有权限」。ABP 的业务异常（BusinessException）默认也按 403 返回，
+ * 例如「工厂日历缺少所选年周」；这类有业务错误码的 403 要显示后端原因并允许重试，
+ * 不能说成没权限，否则用户会去找管理员授权而真因在数据。
+ * 授权失败的错误码以 Volo.Authorization 开头，或没有错误码。@author nokecy
+ */
+export declare const isPermissionDenied: (status?: number, code?: string) => boolean;
 export declare const GridEmptyState: React.FC;
 /**
  * 判断请求 filter 是否带生效条件（任意叶子值非空即算有筛选）。

package/dist/esm/standardList/emptyState.js

@@ -25,6 +25,16 @@ 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;
 };
+
+/**
+ * 403 是否真的是「没有权限」。ABP 的业务异常（BusinessException）默认也按 403 返回，
+ * 例如「工厂日历缺少所选年周」；这类有业务错误码的 403 要显示后端原因并允许重试，
+ * 不能说成没权限，否则用户会去找管理员授权而真因在数据。
+ * 授权失败的错误码以 Volo.Authorization 开头，或没有错误码。@author nokecy
+ */
+export var isPermissionDenied = function isPermissionDenied(status, code) {
+  return status === 403 && (!code || code.startsWith('Volo.Authorization'));
+};
 export var GridEmptyState = function GridEmptyState() {
   var _React$useContext = React.useContext(GridEmptyContext),
     error = _React$useContext.error,
@@ -42,8 +52,8 @@ export var GridEmptyState = function GridEmptyState() {
     });
   }
 
-  // 分支 1：无权限（403）——说明原因，不给任何入口
-  if (error && httpStatusOf(error) === 403) {
+  // 分支 1：无权限（403 且不是业务异常）——说明原因，不给任何入口
+  if (error && isPermissionDenied(httpStatusOf(error), remoteError === null || remoteError === void 0 ? void 0 : remoteError.code)) {
     return /*#__PURE__*/React.createElement(Empty, {
       image: Empty.PRESENTED_IMAGE_SIMPLE,
       description: "\u6CA1\u6709\u6743\u9650\u67E5\u770B\u6B64\u5217\u8868\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u5F00\u901A"
@@ -53,8 +63,10 @@ export var GridEmptyState = function GridEmptyState() {
   // 分支 2：加载失败——给重试
   if (error) {
     return /*#__PURE__*/React.createElement(Empty, {
-      image: Empty.PRESENTED_IMAGE_SIMPLE,
-      description: "\u52A0\u8F7D\u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5\u540E\u91CD\u8BD5"
+      image: Empty.PRESENTED_IMAGE_SIMPLE
+      // 后端给了业务原因（如数据未维护）时直接显示原因，告诉用户下一步。@author nokecy
+      ,
+      description: remoteError !== null && remoteError !== void 0 && remoteError.code && remoteError.message ? remoteError.message : '加载失败，请检查后重试'
     }, onRetry && /*#__PURE__*/React.createElement(Button, {
       size: "small",
       type: "primary",

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

@@ -6,7 +6,7 @@
  */
 export { StandardAgGridColumn, StandardAgGridPlus } from './StandardAgGridPlus';
 export type { AppGridColumn, StandardListPolicy } from './StandardAgGridPlus';
-export { GridEmptyContext, GridEmptyState, hasActiveFilter } from './emptyState';
+export { GridEmptyContext, GridEmptyState, hasActiveFilter, isPermissionDenied } from './emptyState';
 export type { GridEmptyContextValue } from './emptyState';
 export { applyColDefSort, detachLiveSortFromColumnDefs, firstGridSorter } from './gridColumnDefs';
 export { compositeClasses, getCompositeColumnEdges, withCompositeGroupHeader, withCompositeLeafHeader } from './groupedHeaders';

package/dist/esm/standardList/index.js

@@ -5,7 +5,7 @@
  * @author nokecy
  */
 export { StandardAgGridColumn, StandardAgGridPlus } from "./StandardAgGridPlus";
-export { GridEmptyContext, GridEmptyState, hasActiveFilter } from "./emptyState";
+export { GridEmptyContext, GridEmptyState, hasActiveFilter, isPermissionDenied } from "./emptyState";
 export { applyColDefSort, detachLiveSortFromColumnDefs, firstGridSorter } from "./gridColumnDefs";
 export { compositeClasses, getCompositeColumnEdges, withCompositeGroupHeader, withCompositeLeafHeader } from "./groupedHeaders";
 export { getListDateType, normalizeExtendedDateColumn, normalizeListDateColumn } from "./listDateDisplay";