@nokecy/qc-ui 1.1.44 → 1.1.46

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

@@ -10,6 +10,7 @@ var _antd = require("antd");
 var _react = _interopRequireWildcard(require("react"));
 var _agGridEnterprise = require("ag-grid-enterprise");
 var _theme = require("./theme");
+var _useTypeInferenceRow = require("./hooks/useTypeInferenceRow");
 require("./index.less");
 var _queryForm = _interopRequireDefault(require("./queryForm"));
 var _toolBar = _interopRequireDefault(require("./toolBar"));
@@ -315,16 +316,8 @@ function AgGridPlus(props) {
     };
   }, []);
 
-  // 【修复】缓存第一次数据用于类型推断,避免 rowData 更新时重新计算 colDefs
-  // 原因: getTableColumns 只需要第一行数据来推断列的数据类型(数字列自动求和)
-  //      类型推断应该只在初始化时进行一次,后续数据更新不应改变列定义
-  var firstRowDataRef = (0, _react.useRef)(null);
-  (0, _react.useEffect)(function () {
-    // 只在首次有数据时保存
-    if (!firstRowDataRef.current && rowData.length > 0) {
-      firstRowDataRef.current = rowData[0];
-    }
-  }, [rowData]);
+  // 用于列类型推断的首行数据。为什么必须是 state 而不是 ref,见该 hook 的注释。@author nokecy
+  var typeInferenceRow = (0, _useTypeInferenceRow.useTypeInferenceRow)(rowData);
 
   /**
    * 【P0 + P1 优化】使用派生状态应用方案（单向数据流）
@@ -497,7 +490,10 @@ function AgGridPlus(props) {
             return item.value == params.value;
           });
           if (match) {
-            var color = match.color || '#ffffff';
+            // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
+            // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色的覆盖来擦屁股，
+            // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
+            var color = match.color || 'inherit';
             return /*#__PURE__*/_react.default.createElement("span", {
               style: {
                 color: color,
@@ -622,7 +618,7 @@ function AgGridPlus(props) {
   // 计算所有列定义(包括隐藏的列)
   // 【修复】移除 rowData 依赖,使用缓存的首行数据进行类型推断
   var allColDefs = (0, _react.useMemo)(function () {
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var cols = getTableColumns([dataForTypeInference]);
     allColDefsRef.current = cols; // 同步更新 ref
 
@@ -642,7 +638,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions]);
+  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow]);
 
   // 稳定化 gridParams 和 sortColumn 的引用(深比较,内容不变即复用旧引用)
   var stableGridParams = useDeepCompareStable(gridParams);
@@ -1049,7 +1045,7 @@ function AgGridPlus(props) {
     // 【默认逻辑】没有方案配置时，使用原有的列定义生成逻辑
     // 使用缓存的首行数据进行类型推断,而不是当前的 rowData
     // 这样 rowData 更新时不会触发 colDefs 重新计算
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var columnDefs = getTableColumns([dataForTypeInference]);
 
     // 递归应用 columnCellClass 配置
@@ -1087,7 +1083,9 @@ function AgGridPlus(props) {
   // 【关键】优先依赖派生状态
   derivedColumnDefs, _react.default.Children.count(children), props.columnDefs, extensibleColumns, columnCellClass,
   // ref.current 变更不触发重渲染,作依赖无效;改依赖真正的数据源 allColDefs(memo 值) @author nokecy
-  allColDefs]);
+  allColDefs,
+  // 首批数据到达时重算一次,否则数值列的右对齐永远推断不出来 @author nokecy
+  typeInferenceRow]);
 
   // 构建查询表单项（带 order 属性）
   var queryFormItems = (0, _react.useMemo)(function () {

package/dist/cjs/ag-grid-plus/hooks/useTypeInferenceRow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export declare function useTypeInferenceRow(rowData: any[] | undefined | null): any;
+export default useTypeInferenceRow;

package/dist/cjs/ag-grid-plus/hooks/useTypeInferenceRow.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.useTypeInferenceRow = useTypeInferenceRow;
+var _react = require("react");
+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; }
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+function useTypeInferenceRow(rowData) {
+  var _useState = (0, _react.useState)(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    row = _useState2[0],
+    setRow = _useState2[1];
+  (0, _react.useEffect)(function () {
+    if (!row && rowData && rowData.length > 0) {
+      setRow(rowData[0]);
+    }
+  }, [rowData, row]);
+  return row;
+}
+var _default = exports.default = useTypeInferenceRow;

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

@@ -157,7 +157,10 @@ function processEnumColumn(col, dataType) {
         return item.value == params.value;
       });
       if (match) {
-        var color = match.color || '#ffffff';
+        // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
+        // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色 的覆盖来擦屁股，
+        // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
+        var color = match.color || 'inherit';
         return /*#__PURE__*/_react.default.createElement("span", {
           style: {
             color: color,

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

@@ -24,7 +24,9 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 /** 四支文案，按支覆盖。不传的支走默认。 */
 
 var DEFAULT_EMPTY_TEXTS = exports.DEFAULT_EMPTY_TEXTS = {
-  error: '数据加载失败，请点上方「重试」',
+  // 不写方位：重试按钮就渲染在这句话正下方（见 shared/NoRowsOverlay）。
+  // 原文写的是「请点上方「重试」」，方位指错了。@author nokecy
+  error: '数据加载失败，可点下方按钮重试',
   noPermission: '没有查看该数据的权限，请联系系统管理员',
   noResult: '没有符合当前筛选条件的数据，试试放宽或清空筛选条件',
   noData: '暂无数据'

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

@@ -29,6 +29,7 @@ ModuleRegistry.registerModules([AllEnterpriseModule]);
 
 // 导入 AG-Grid v33 主题
 import { agGridTheme } from "./theme";
+import { useTypeInferenceRow } from "./hooks/useTypeInferenceRow";
 import "./index.less";
 import FormRender from "./queryForm";
 import ToolBar from "./toolBar";
@@ -307,16 +308,8 @@ function AgGridPlus(props) {
     };
   }, []);
 
-  // 【修复】缓存第一次数据用于类型推断,避免 rowData 更新时重新计算 colDefs
-  // 原因: getTableColumns 只需要第一行数据来推断列的数据类型(数字列自动求和)
-  //      类型推断应该只在初始化时进行一次,后续数据更新不应改变列定义
-  var firstRowDataRef = useRef(null);
-  useEffect(function () {
-    // 只在首次有数据时保存
-    if (!firstRowDataRef.current && rowData.length > 0) {
-      firstRowDataRef.current = rowData[0];
-    }
-  }, [rowData]);
+  // 用于列类型推断的首行数据。为什么必须是 state 而不是 ref,见该 hook 的注释。@author nokecy
+  var typeInferenceRow = useTypeInferenceRow(rowData);
 
   /**
    * 【P0 + P1 优化】使用派生状态应用方案（单向数据流）
@@ -489,7 +482,10 @@ function AgGridPlus(props) {
             return item.value == params.value;
           });
           if (match) {
-            var color = match.color || '#ffffff';
+            // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
+            // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色的覆盖来擦屁股，
+            // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
+            var color = match.color || 'inherit';
             return /*#__PURE__*/React.createElement("span", {
               style: {
                 color: color,
@@ -614,7 +610,7 @@ function AgGridPlus(props) {
   // 计算所有列定义(包括隐藏的列)
   // 【修复】移除 rowData 依赖,使用缓存的首行数据进行类型推断
   var allColDefs = useMemo(function () {
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var cols = getTableColumns([dataForTypeInference]);
     allColDefsRef.current = cols; // 同步更新 ref
 
@@ -634,7 +630,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions]);
+  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow]);
 
   // 稳定化 gridParams 和 sortColumn 的引用(深比较,内容不变即复用旧引用)
   var stableGridParams = useDeepCompareStable(gridParams);
@@ -1041,7 +1037,7 @@ function AgGridPlus(props) {
     // 【默认逻辑】没有方案配置时，使用原有的列定义生成逻辑
     // 使用缓存的首行数据进行类型推断,而不是当前的 rowData
     // 这样 rowData 更新时不会触发 colDefs 重新计算
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var columnDefs = getTableColumns([dataForTypeInference]);
 
     // 递归应用 columnCellClass 配置
@@ -1079,7 +1075,9 @@ function AgGridPlus(props) {
   // 【关键】优先依赖派生状态
   derivedColumnDefs, React.Children.count(children), props.columnDefs, extensibleColumns, columnCellClass,
   // ref.current 变更不触发重渲染,作依赖无效;改依赖真正的数据源 allColDefs(memo 值) @author nokecy
-  allColDefs]);
+  allColDefs,
+  // 首批数据到达时重算一次,否则数值列的右对齐永远推断不出来 @author nokecy
+  typeInferenceRow]);
 
   // 构建查询表单项（带 order 属性）
   var queryFormItems = useMemo(function () {

package/dist/esm/ag-grid-plus/hooks/useTypeInferenceRow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export declare function useTypeInferenceRow(rowData: any[] | undefined | null): any;
+export default useTypeInferenceRow;

package/dist/esm/ag-grid-plus/hooks/useTypeInferenceRow.js

@@ -0,0 +1,37 @@
+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; }
+import { useEffect, useState } from 'react';
+
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export function useTypeInferenceRow(rowData) {
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    row = _useState2[0],
+    setRow = _useState2[1];
+  useEffect(function () {
+    if (!row && rowData && rowData.length > 0) {
+      setRow(rowData[0]);
+    }
+  }, [rowData, row]);
+  return row;
+}
+export default useTypeInferenceRow;

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

@@ -142,7 +142,10 @@ export function processEnumColumn(col, dataType) {
         return item.value == params.value;
       });
       if (match) {
-        var color = match.color || '#ffffff';
+        // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
+        // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色 的覆盖来擦屁股，
+        // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
+        var color = match.color || 'inherit';
         return /*#__PURE__*/React.createElement("span", {
           style: {
             color: color,

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

@@ -15,7 +15,9 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 /** 四支文案，按支覆盖。不传的支走默认。 */
 
 export var DEFAULT_EMPTY_TEXTS = {
-  error: '数据加载失败，请点上方「重试」',
+  // 不写方位：重试按钮就渲染在这句话正下方（见 shared/NoRowsOverlay）。
+  // 原文写的是「请点上方「重试」」，方位指错了。@author nokecy
+  error: '数据加载失败，可点下方按钮重试',
   noPermission: '没有查看该数据的权限，请联系系统管理员',
   noResult: '没有符合当前筛选条件的数据，试试放宽或清空筛选条件',
   noData: '暂无数据'