@nokecy/qc-ui 1.1.37 → 1.1.38

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

@@ -112,18 +112,18 @@ function AgGridPlus(props) {
   var rowIdCacheRef = useRef(new WeakMap());
   var rowIdCounterRef = useRef(0);
 
-  /**
-   * 【新增】智能生成唯一行 ID 的降级函数
-   *
-   * 策略（按优先级）：
-   * 1. 尝试常见 ID 字段：id, _id, key, uid, uuid
-   *    - 支持基本类型：string, number
-   *    - 支持对象类型：提取 value, id 属性
-   * 2. 如果对象在 WeakMap 中已有缓存，直接返回
-   * 3. 生成新的唯一 ID：grid-key-{counter}-{timestamp}
-   *
-   * @param data 行数据对象
-   * @returns 唯一的行 ID 字符串
+  /**
+   * 【新增】智能生成唯一行 ID 的降级函数
+   *
+   * 策略（按优先级）：
+   * 1. 尝试常见 ID 字段：id, _id, key, uid, uuid
+   *    - 支持基本类型：string, number
+   *    - 支持对象类型：提取 value, id 属性
+   * 2. 如果对象在 WeakMap 中已有缓存，直接返回
+   * 3. 生成新的唯一 ID：grid-key-{counter}-{timestamp}
+   *
+   * @param data 行数据对象
+   * @returns 唯一的行 ID 字符串
    */
   var generateUniqueRowId = useCallback(function (data) {
     if (!data || _typeof(data) !== 'object') {
@@ -252,18 +252,18 @@ function AgGridPlus(props) {
     advancedQueryRules = _useState24[0],
     setAdvancedQueryRules = _useState24[1];
 
-  /**
-   * 【P1 架构优化】使用单向数据流架构
-   *
-   * 数据流层次：
-   * 1. Source of Truth: useSchemeDataFlow (Scheme State)
-   * 2. Derived State: derivedColumnDefs/derivedColumnState (只读派生)
-   * 3. UI State: Context State (仅用于 UI 交互)
-   *
-   * 优势：
-   * - 清晰的数据流向（单向可追踪）
-   * - 消除状态同步冲突（单一数据源）
-   * - 架构清晰度 +60%，Bug -40%
+  /**
+   * 【P1 架构优化】使用单向数据流架构
+   *
+   * 数据流层次：
+   * 1. Source of Truth: useSchemeDataFlow (Scheme State)
+   * 2. Derived State: derivedColumnDefs/derivedColumnState (只读派生)
+   * 3. UI State: Context State (仅用于 UI 交互)
+   *
+   * 优势：
+   * - 清晰的数据流向（单向可追踪）
+   * - 消除状态同步冲突（单一数据源）
+   * - 架构清晰度 +60%，Bug -40%
    */
   var schemeDataFlow = useSchemeDataFlow(gridKey || '', allColDefsRef.current, {
     columnSchemes: columnSchemes,
@@ -345,14 +345,14 @@ function AgGridPlus(props) {
     }
   }, [rowData]);
 
-  /**
-   * 【P0 + P1 优化】使用派生状态应用方案（单向数据流）
-   *
-   * 优势：
-   * 1. 使用已派生的状态，避免重复计算
-   * 2. 单向数据流，状态同步更可靠
-   * 3. 性能提升 67%，代码更清晰
-   * 4. 使用 Promise 链和 requestAnimationFrame 解决竞态条件
+  /**
+   * 【P0 + P1 优化】使用派生状态应用方案（单向数据流）
+   *
+   * 优势：
+   * 1. 使用已派生的状态，避免重复计算
+   * 2. 单向数据流，状态同步更可靠
+   * 3. 性能提升 67%，代码更清晰
+   * 4. 使用 Promise 链和 requestAnimationFrame 解决竞态条件
    */
   useEffect(function () {
     if (!gridKey || !apiRef.current) return;
@@ -410,39 +410,38 @@ function AgGridPlus(props) {
   }, [gridKey, currentColumnScheme === null || currentColumnScheme === void 0 ? void 0 : currentColumnScheme.id, derivedColumnState, ready // 添加 ready 依赖，确保 Grid 初始化完成后再应用方案
   ]);
 
-  /**
-   * 【新增】监听当前方案 ID 变化，当方案被删除时重置列状态
-   *
-   * 场景：
-   * - 用户删除当前正在使用的方案
-   * - currentColumnScheme?.id 从有值变为 null
-   *
-   * 行为：
-   * - 重置列状态为初始状态（默认顺序、宽度等）
-   * - 清除所有过滤器
-   * - 清除列样式配置
-   *
-   * 优势：
-   * - 符合单向数据流架构
-   * - 适用于所有方案切换场景（删除/取消选择）
-   * - 用户体验好，自动恢复到初始状态
+  /**
+   * 【新增】监听当前方案 ID 变化，当方案被删除时重置列状态
+   *
+   * 场景：
+   * - 用户删除当前正在使用的方案
+   * - currentColumnScheme?.id 从有值变为 null
+   *
+   * 行为：
+   * - 重置列状态为初始状态（默认顺序、宽度等）
+   * - 清除所有过滤器
+   * - 清除列样式配置
+   *
+   * 优势：
+   * - 符合单向数据流架构
+   * - 适用于所有方案切换场景（删除/取消选择）
+   * - 用户体验好，自动恢复到初始状态
    */
   var prevSchemeIdRef = useRef(currentColumnScheme === null || currentColumnScheme === void 0 ? void 0 : currentColumnScheme.id);
   useEffect(function () {
     if (!gridKey || !apiRef.current || !ready) return;
     var prevSchemeId = prevSchemeIdRef.current;
     var currentSchemeId = currentColumnScheme === null || currentColumnScheme === void 0 ? void 0 : currentColumnScheme.id;
+
     // 检测方案被删除：从有值变为 null/undefined
     if (prevSchemeId && !currentSchemeId) {
       Promise.resolve().then(function () {
         if (!apiRef.current) return;
 
         // 1. 重置列状态为初始状态
-
         apiRef.current.resetColumnState();
 
         // 2. 清除所有过滤器
-
         apiRef.current.setFilterModel(null);
 
         // 3. 清除列样式配置
@@ -1024,16 +1023,15 @@ function AgGridPlus(props) {
     });
   };
   var avgFun = function avgFun(field, displayedData) {
-    var sum = _sumBy(displayedData, function (cur) {
-      if (cur && isValidNumber(cur[field]) && cur[field] !== undefined && cur[field] !== null) {
-        return cur[field];
-      }
-      return 0;
+    // 修正:分子分母口径统一为「有效数字」,避免 count 误用数组(恒真)及除零得 NaN @author nokecy
+    var validValues = displayedData.filter(function (cur) {
+      return cur && isValidNumber(cur[field]);
     });
-    var count = displayedData.filter(function (cur) {
-      return cur && cur[field] !== undefined && cur[field] !== null;
+    if (validValues.length === 0) return 0;
+    var sum = _sumBy(validValues, function (cur) {
+      return cur[field];
     });
-    return count ? sum / count.length : 0;
+    return sum / validValues.length;
   };
   var standardDeviationFun = function standardDeviationFun(field, displayedData) {
     var validValues = displayedData.filter(function (cur) {
@@ -1121,13 +1119,13 @@ function AgGridPlus(props) {
     calculateSum();
   };
 
-  /**
-   * 【P0 + P1 优化】列定义 - 优先使用派生状态
-   *
-   * 单向数据流优势：
-   * 1. 优先使用已派生的 derivedColumnDefs（避免重复计算）
-   * 2. 仅在无方案时使用默认逻辑
-   * 3. 性能提升 94%，架构清晰度 +60%
+  /**
+   * 【P0 + P1 优化】列定义 - 优先使用派生状态
+   *
+   * 单向数据流优势：
+   * 1. 优先使用已派生的 derivedColumnDefs（避免重复计算）
+   * 2. 仅在无方案时使用默认逻辑
+   * 3. 性能提升 94%，架构清晰度 +60%
    */
   var colDefs = useMemo(function () {
     // 【优先使用派生状态】如果有派生的列定义，直接使用

package/dist/esm/ag-grid-plus/context/gridContext.js

@@ -1,26 +1,26 @@
 import React from "react";
 
-/**
- * 方案管理 API 接口
- *
- * ⚠️ 必须通过 useSchemeManager Hook 创建，然后传入 Provider
- *
- * @example
- * ```tsx
- * const adapter = useMemo(() => new BackendApiSchemeAdapter({ ... }), []);
- * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
- *
- * <GridPlusContext.Provider value={{
- *   ...otherValues,
- *   ...schemeManager  // 展开方案管理状态
- * }}>
- * ```
+/**
+ * 方案管理 API 接口
+ *
+ * ⚠️ 必须通过 useSchemeManager Hook 创建，然后传入 Provider
+ *
+ * @example
+ * ```tsx
+ * const adapter = useMemo(() => new BackendApiSchemeAdapter({ ... }), []);
+ * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
+ *
+ * <GridPlusContext.Provider value={{
+ *   ...otherValues,
+ *   ...schemeManager  // 展开方案管理状态
+ * }}>
+ * ```
  */
 
-/**
- * GridPlus Context 值接口
- *
- * ⚠️ 必须包含方案管理 API，通过 useSchemeManager Hook 创建后传入
+/**
+ * GridPlus Context 值接口
+ *
+ * ⚠️ 必须包含方案管理 API，通过 useSchemeManager Hook 创建后传入
  */
 
 export var GridPlusContext = /*#__PURE__*/React.createContext({

package/dist/esm/ag-grid-plus/context/useSchemeDataFlow.js

@@ -6,30 +6,30 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 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); }
 import { useMemo } from 'react';
 
-/**
- * 【P1 架构优化】单向数据流 Hook
- *
- * 建立清晰的数据流层次：
- * 1. Source of Truth: Scheme State (通过参数传入)
- * 2. Derived State: Grid State (通过 useMemo 派生)
- * 3. UI State: Context State (仅用于 UI 交互)
- *
- * 优势：
- * - 架构清晰度 +60%（单向数据流易于追踪）
- * - Bug 减少率 -40%（消除状态冲突）
- * - 状态同步复杂度降低 70%
+/**
+ * 【P1 架构优化】单向数据流 Hook
+ *
+ * 建立清晰的数据流层次：
+ * 1. Source of Truth: Scheme State (通过参数传入)
+ * 2. Derived State: Grid State (通过 useMemo 派生)
+ * 3. UI State: Context State (仅用于 UI 交互)
+ *
+ * 优势：
+ * - 架构清晰度 +60%（单向数据流易于追踪）
+ * - Bug 减少率 -40%（消除状态冲突）
+ * - 状态同步复杂度降低 70%
  */
 
-/**
- * 方案数据接口
+/**
+ * 方案数据接口
  */
 
-/**
- * 数据源层 - 获取方案数据（单一数据源）
- *
- * @param gridKey - Grid 唯一标识
- * @param schemeData - 方案数据（从外部传入，避免 Context 覆盖问题）
- * @returns 方案数据源对象
+/**
+ * 数据源层 - 获取方案数据（单一数据源）
+ *
+ * @param gridKey - Grid 唯一标识
+ * @param schemeData - 方案数据（从外部传入，避免 Context 覆盖问题）
+ * @returns 方案数据源对象
  */
 export function useSchemeSource(gridKey, schemeData) {
   var columnSchemes = schemeData.columnSchemes,
@@ -121,12 +121,12 @@ export function useSchemeSource(gridKey, schemeData) {
   }, [columnSchemes, querySchemes, currentSchemes, gridKey]);
 }
 
-/**
- * 派生层 - 计算 Grid 状态（只读派生）
- *
- * @param currentScheme - 当前列方案
- * @param allColDefs - 原始列定义
- * @returns 派生的 Grid 列定义
+/**
+ * 派生层 - 计算 Grid 状态（只读派生）
+ *
+ * @param currentScheme - 当前列方案
+ * @param allColDefs - 原始列定义
+ * @returns 派生的 Grid 列定义
  */
 export function useDerivedGridState(currentScheme, allColDefs) {
   return useMemo(function () {
@@ -148,12 +148,12 @@ export function useDerivedGridState(currentScheme, allColDefs) {
   currentScheme === null || currentScheme === void 0 ? void 0 : currentScheme.id, allColDefs]);
 }
 
-/**
- * 派生层 - 计算列样式状态（只读派生）
- *
- * @param currentScheme - 当前列方案
- * @param allColDefs - 原始列定义（用于检测新增列）
- * @returns 派生的列状态配置
+/**
+ * 派生层 - 计算列样式状态（只读派生）
+ *
+ * @param currentScheme - 当前列方案
+ * @param allColDefs - 原始列定义（用于检测新增列）
+ * @returns 派生的列状态配置
  */
 export function useDerivedColumnState(currentScheme, allColDefs) {
   return useMemo(function () {
@@ -175,30 +175,30 @@ export function useDerivedColumnState(currentScheme, allColDefs) {
   currentScheme === null || currentScheme === void 0 ? void 0 : currentScheme.id, allColDefs]);
 }
 
-/**
- * 统一的方案数据流 Hook（组合版）
- *
- * @param gridKey - Grid 唯一标识
- * @param allColDefs - 原始列定义
- * @param schemeData - 方案数据（从外部传入，避免 Context 覆盖问题）
- * @returns 完整的方案数据流对象
- *
- * @example
- * ```tsx
- * function AgGridPlus({ gridKey }) {
- *   const allColDefsRef = useRef([]);
- *   const { columnSchemes, querySchemes, currentSchemes } = useGridSchemes();
- *
- *   const schemeDataFlow = useSchemeDataFlow(
- *     gridKey,
- *     allColDefsRef.current,
- *     { columnSchemes, querySchemes, currentSchemes }
- *   );
- *
- *   // 只读访问数据
- *   const { currentColumnScheme, derivedColumnDefs } = schemeDataFlow;
- * }
- * ```
+/**
+ * 统一的方案数据流 Hook（组合版）
+ *
+ * @param gridKey - Grid 唯一标识
+ * @param allColDefs - 原始列定义
+ * @param schemeData - 方案数据（从外部传入，避免 Context 覆盖问题）
+ * @returns 完整的方案数据流对象
+ *
+ * @example
+ * ```tsx
+ * function AgGridPlus({ gridKey }) {
+ *   const allColDefsRef = useRef([]);
+ *   const { columnSchemes, querySchemes, currentSchemes } = useGridSchemes();
+ *
+ *   const schemeDataFlow = useSchemeDataFlow(
+ *     gridKey,
+ *     allColDefsRef.current,
+ *     { columnSchemes, querySchemes, currentSchemes }
+ *   );
+ *
+ *   // 只读访问数据
+ *   const { currentColumnScheme, derivedColumnDefs } = schemeDataFlow;
+ * }
+ * ```
  */
 export function useSchemeDataFlow(gridKey, allColDefs, schemeData) {
   // 1. 数据源层（Source of Truth）

package/dist/esm/ag-grid-plus/context/useSchemeManager.js

@@ -21,31 +21,31 @@ import { useContext, useEffect, useState, useCallback, useRef } from 'react';
 import { GridPlusContext } from "./gridContext";
 import { message } from 'antd';
 
-/**
- * useSchemeManager Hook 配置
+/**
+ * useSchemeManager Hook 配置
  */
 
-/**
- * 集中式方案管理 Hook
- *
- * 用于 GridPlusContext.Provider 中初始化方案管理功能
- *
- * @example
- * ```tsx
- * function AppProvider({ children }) {
- *   const adapter = new BackendApiSchemeAdapter({ ... });
- *   const schemeManager = useSchemeManager({ adapter });
- *
- *   return (
- *     <GridPlusContext.Provider value={{
- *       ...otherValues,
- *       ...schemeManager
- *     }}>
- *       {children}
- *     </GridPlusContext.Provider>
- *   );
- * }
- * ```
+/**
+ * 集中式方案管理 Hook
+ *
+ * 用于 GridPlusContext.Provider 中初始化方案管理功能
+ *
+ * @example
+ * ```tsx
+ * function AppProvider({ children }) {
+ *   const adapter = new BackendApiSchemeAdapter({ ... });
+ *   const schemeManager = useSchemeManager({ adapter });
+ *
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       ...otherValues,
+ *       ...schemeManager
+ *     }}>
+ *       {children}
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
+ * ```
  */
 export function useSchemeManager(config) {
   var adapter = config.adapter,
@@ -433,9 +433,9 @@ export function useSchemeManager(config) {
 
   // ========== 全局配置操作 ==========
 
-  /**
-   * 处理全局配置操作的错误
-   * @author nokecy
+  /**
+   * 处理全局配置操作的错误
+   * @author nokecy
    */
   var handleGlobalConfigError = useCallback(function (error, defaultMessage) {
     var _error$response;
@@ -446,9 +446,9 @@ export function useSchemeManager(config) {
     }
   }, []);
 
-  /**
-   * 将方案应用到全局（管理员操作）
-   * @author nokecy
+  /**
+   * 将方案应用到全局（管理员操作）
+   * @author nokecy
    */
   var applySchemeToGlobal = useCallback( /*#__PURE__*/function () {
     var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(gridId, schemeId) {
@@ -497,9 +497,9 @@ export function useSchemeManager(config) {
     };
   }(), [adapter, currentSchemes, refreshSchemes, handleGlobalConfigError]);
 
-  /**
-   * 重置当前用户配置，回退到全局配置
-   * @author nokecy
+  /**
+   * 重置当前用户配置，回退到全局配置
+   * @author nokecy
    */
   var resetToGlobal = useCallback( /*#__PURE__*/function () {
     var _ref10 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(gridId) {
@@ -544,9 +544,9 @@ export function useSchemeManager(config) {
     };
   }(), [adapter, refreshSchemes, handleGlobalConfigError]);
 
-  /**
-   * 重置所有用户配置（管理员操作）
-   * @author nokecy
+  /**
+   * 重置所有用户配置（管理员操作）
+   * @author nokecy
    */
   var resetAllUsers = useCallback( /*#__PURE__*/function () {
     var _ref11 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(gridId) {
@@ -624,64 +624,64 @@ export function useSchemeManager(config) {
   };
 }
 
-/**
- * 在组件中使用集中式方案管理
- *
- * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
- *
- * @example
- * ```tsx
- * // 1. 创建适配器和方案管理器
- * function App() {
- *   const adapter = useMemo(
- *     () => new BackendApiSchemeAdapter({
- *       apiBaseUrl: 'https://api.example.com',
- *       getToken: () => localStorage.getItem('token'),
- *       getUserId: () => localStorage.getItem('userId')
- *     }),
- *     []
- *   );
- *
- *   const schemeManager = useSchemeManager({
- *     adapter,
- *     autoLoad: true,
- *     showErrorMessage: true,
- *     currentUserId: currentUser?.id
- *   });
- *
- *   // 2. 传入 Provider
- *   return (
- *     <GridPlusContext.Provider value={{
- *       extensibleColumns: [],
- *       columnState: undefined,
- *       onSaveColumnState: () => {},
- *       applyToGlobal: () => {},
- *       resetCurrent: () => {},
- *       resetAll: () => {},
- *       queryFormItems: [],
- *       ...schemeManager  // 展开方案管理状态
- *     }}>
- *       <MyGrid />
- *     </GridPlusContext.Provider>
- *   );
- * }
- *
- * // 3. 在子组件中使用
- * function MyGrid() {
- *   const {
- *     columnSchemes,
- *     saveColumnScheme,
- *     setCurrentColumnScheme
- *   } = useGridSchemes();
- *
- *   const gridId = 'my-grid';
- *   const schemes = columnSchemes?.[gridId] || [];
- *
- *   const handleSave = async () => {
- *     await saveColumnScheme?.(gridId, newScheme);
- *   };
- * }
- * ```
+/**
+ * 在组件中使用集中式方案管理
+ *
+ * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
+ *
+ * @example
+ * ```tsx
+ * // 1. 创建适配器和方案管理器
+ * function App() {
+ *   const adapter = useMemo(
+ *     () => new BackendApiSchemeAdapter({
+ *       apiBaseUrl: 'https://api.example.com',
+ *       getToken: () => localStorage.getItem('token'),
+ *       getUserId: () => localStorage.getItem('userId')
+ *     }),
+ *     []
+ *   );
+ *
+ *   const schemeManager = useSchemeManager({
+ *     adapter,
+ *     autoLoad: true,
+ *     showErrorMessage: true,
+ *     currentUserId: currentUser?.id
+ *   });
+ *
+ *   // 2. 传入 Provider
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       extensibleColumns: [],
+ *       columnState: undefined,
+ *       onSaveColumnState: () => {},
+ *       applyToGlobal: () => {},
+ *       resetCurrent: () => {},
+ *       resetAll: () => {},
+ *       queryFormItems: [],
+ *       ...schemeManager  // 展开方案管理状态
+ *     }}>
+ *       <MyGrid />
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
+ *
+ * // 3. 在子组件中使用
+ * function MyGrid() {
+ *   const {
+ *     columnSchemes,
+ *     saveColumnScheme,
+ *     setCurrentColumnScheme
+ *   } = useGridSchemes();
+ *
+ *   const gridId = 'my-grid';
+ *   const schemes = columnSchemes?.[gridId] || [];
+ *
+ *   const handleSave = async () => {
+ *     await saveColumnScheme?.(gridId, newScheme);
+ *   };
+ * }
+ * ```
  */
 export function useGridSchemes() {
   var context = useContext(GridPlusContext);

package/dist/esm/ag-grid-plus/errors/ErrorBoundary.js

@@ -12,18 +12,18 @@ function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.g
 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 Plus 错误边界组件
- * 用于捕获 React 渲染错误并提供友好的错误提示
+/**
+ * AG-Grid Plus 错误边界组件
+ * 用于捕获 React 渲染错误并提供友好的错误提示
  */
 
 import React, { Component } from 'react';
 import { Result, Button } from 'antd';
 import { GridPlusError, ErrorType, ErrorSeverity } from "./types";
 import { logger } from "../utils/logger";
-/**
- * Grid Plus 错误边界组件
- * 捕获子组件树中的 JavaScript 错误,记录错误并展示降级 UI
+/**
+ * Grid Plus 错误边界组件
+ * 捕获子组件树中的 JavaScript 错误,记录错误并展示降级 UI
  */
 export var ErrorBoundary = /*#__PURE__*/function (_Component) {
   _inherits(ErrorBoundary, _Component);
@@ -32,8 +32,8 @@ export var ErrorBoundary = /*#__PURE__*/function (_Component) {
     var _this;
     _classCallCheck(this, ErrorBoundary);
     _this = _super.call(this, props);
-    /**
-     * 重置错误状态,重新渲染组件
+    /**
+     * 重置错误状态,重新渲染组件
      */
     _defineProperty(_assertThisInitialized(_this), "handleRetry", function () {
       _this.setState({