@nokecy/qc-ui 1.0.70 → 1.0.72

package/dist/cjs/ag-grid-plus/schemes/types.d.ts

@@ -0,0 +1,126 @@
+import { ColumnState } from 'ag-grid-community';
+/**
+ * 列配置方案数据结构
+ */
+export interface ColumnScheme {
+    /** 方案唯一标识（UUID） */
+    id: string;
+    /** 方案名称（用户可编辑） */
+    name: string;
+    /** 是否为默认方案（首次加载自动应用） */
+    isDefault?: boolean;
+    /** 是否为系统预设方案（不可删除） */
+    isSystem?: boolean;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 更新时间戳 */
+    updatedAt: number;
+    /** AG-Grid 列状态数据 */
+    columnState: ColumnState[];
+    /** 方案描述（可选） */
+    description?: string;
+    /** 标签分类（可选，扩展功能） */
+    tags?: string[];
+    /** 共享级别（可选，扩展功能） */
+    shareLevel?: 'private' | 'team' | 'public';
+}
+/**
+ * 方案管理器配置
+ */
+export interface SchemeManagerConfig {
+    /** 表格唯一标识 */
+    gridId: string;
+    /** 自定义存储适配器（可选） */
+    storageAdapter?: StorageAdapter;
+    /** 是否启用自动保存到当前方案（默认 true） */
+    enableAutoSave?: boolean;
+    /** 方案切换回调 */
+    onSchemeChange?: (scheme: ColumnScheme | null) => void;
+    /** 方案保存回调 */
+    onSchemeSave?: (scheme: ColumnScheme) => void;
+    /** 方案删除回调 */
+    onSchemeDelete?: (schemeId: string) => void;
+}
+/**
+ * 存储适配器接口
+ * 允许自定义存储实现（LocalStorage / IndexedDB / 后端API等）
+ */
+export interface StorageAdapter {
+    /**
+     * 获取指定表格的所有方案
+     * @param gridId 表格唯一标识
+     * @returns 方案列表
+     */
+    getSchemes(gridId: string): Promise<ColumnScheme[]>;
+    /**
+     * 保存方案列表到存储
+     * @param gridId 表格唯一标识
+     * @param schemes 方案列表
+     */
+    saveSchemes(gridId: string, schemes: ColumnScheme[]): Promise<void>;
+    /**
+     * 清除指定表格的所有方案
+     * @param gridId 表格唯一标识
+     */
+    clearSchemes?(gridId: string): Promise<void>;
+    /**
+     * 获取当前激活的方案ID（用于刷新后恢复）
+     * @param gridId 表格唯一标识
+     * @returns 方案ID，如果没有则返回 null
+     */
+    getCurrentSchemeId?(gridId: string): Promise<string | null>;
+    /**
+     * 保存当前激活的方案ID
+     * @param gridId 表格唯一标识
+     * @param schemeId 方案ID，null 表示清除
+     */
+    saveCurrentSchemeId?(gridId: string, schemeId: string | null): Promise<void>;
+}
+/**
+ * 方案验证结果
+ */
+export interface SchemeValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 无效的列 ID 列表 */
+    invalidColumns: string[];
+    /** 验证后的有效列状态 */
+    validatedState: ColumnState[];
+    /** 警告信息 */
+    warnings?: string[];
+}
+/**
+ * 方案管理器 Hook 返回值
+ */
+export interface UseColumnSchemesReturn {
+    /** 当前激活的方案 */
+    currentScheme: ColumnScheme | null;
+    /** 所有可用方案列表 */
+    schemes: ColumnScheme[];
+    /** 当前配置是否有未保存的修改 */
+    isDirty: boolean;
+    /** 是否正在加载 */
+    loading: boolean;
+    /** 加载指定方案 */
+    loadScheme: (schemeId: string) => Promise<void>;
+    /** 保存当前方案（更新现有方案） */
+    saveScheme: (updates?: Partial<ColumnScheme>) => Promise<void>;
+    /** 创建新方案 */
+    createScheme: (name: string, columnState: ColumnState[], options?: Partial<ColumnScheme>) => Promise<ColumnScheme>;
+    /** 更新方案信息（不影响 columnState） */
+    updateScheme: (schemeId: string, updates: Partial<Omit<ColumnScheme, 'id' | 'columnState'>>) => Promise<void>;
+    /** 删除方案 */
+    deleteScheme: (schemeId: string) => Promise<void>;
+    /** 重置到方案原始状态 */
+    resetToScheme: () => void;
+    /** 设置默认方案 */
+    setDefaultScheme: (schemeId: string) => Promise<void>;
+    /** 验证方案有效性 */
+    validateScheme: (scheme: ColumnScheme, currentColumnDefs: any[]) => SchemeValidationResult;
+}
+/**
+ * 旧格式列状态数据（用于迁移）
+ */
+export interface LegacyColumnState {
+    [gridKey: string]: ColumnState[];
+}

package/dist/cjs/ag-grid-plus/schemes/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

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

@@ -0,0 +1,27 @@
+import { ColumnScheme, SchemeValidationResult } from '../types';
+/**
+ * 验证方案有效性
+ */
+export declare function validateScheme(scheme: ColumnScheme, currentColumnDefs: any[]): SchemeValidationResult;
+/**
+ * 验证方案名称
+ */
+export declare function validateSchemeName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * 验证方案描述
+ */
+export declare function validateSchemeDescription(description: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * 检查方案名称是否重复
+ */
+export declare function checkDuplicateName(name: string, schemes: ColumnScheme[], excludeId?: string): boolean;
+/**
+ * 生成唯一的方案名称（处理重名情况）
+ */
+export declare function generateUniqueName(baseName: string, schemes: ColumnScheme[]): string;

package/dist/cjs/ag-grid-plus/schemes/utils/validator.js

@@ -0,0 +1,113 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.checkDuplicateName = checkDuplicateName;
+exports.generateUniqueName = generateUniqueName;
+exports.validateScheme = validateScheme;
+exports.validateSchemeDescription = validateSchemeDescription;
+exports.validateSchemeName = validateSchemeName;
+var _constants = require("../constants");
+/**
+ * 验证方案有效性
+ */
+function validateScheme(scheme, currentColumnDefs) {
+  var warnings = [];
+  var invalidColumns = [];
+  var validatedState = [];
+
+  // 获取当前有效的列 ID 集合
+  var validColIds = new Set(currentColumnDefs.filter(function (col) {
+    return col.field || col.colId;
+  }).map(function (col) {
+    return col.field || col.colId;
+  }));
+
+  // 验证每个列状态
+  scheme.columnState.forEach(function (columnState) {
+    var colId = columnState.colId;
+    if (!colId) {
+      warnings.push('发现没有 colId 的列状态');
+      return;
+    }
+
+    // 检查列是否仍然存在于表格定义中
+    if (!validColIds.has(colId)) {
+      invalidColumns.push(colId);
+      warnings.push("\u5217 \"".concat(colId, "\" \u5728\u5F53\u524D\u8868\u683C\u4E2D\u4E0D\u5B58\u5728"));
+      return;
+    }
+
+    // 列有效，添加到验证后的状态中
+    validatedState.push(columnState);
+  });
+  var valid = invalidColumns.length === 0;
+  if (!valid) {
+    warnings.push("\u5171\u6709 ".concat(invalidColumns.length, " \u4E2A\u5217\u5728\u5F53\u524D\u8868\u683C\u4E2D\u4E0D\u5B58\u5728\uFF0C\u5DF2\u81EA\u52A8\u8FC7\u6EE4"));
+  }
+  return {
+    valid: valid,
+    invalidColumns: invalidColumns,
+    validatedState: validatedState,
+    warnings: warnings.length > 0 ? warnings : undefined
+  };
+}
+
+/**
+ * 验证方案名称
+ */
+function validateSchemeName(name) {
+  if (!name || name.trim().length === 0) {
+    return {
+      valid: false,
+      error: '方案名称不能为空'
+    };
+  }
+  if (name.length > _constants.MAX_SCHEME_NAME_LENGTH) {
+    return {
+      valid: false,
+      error: "\u65B9\u6848\u540D\u79F0\u4E0D\u80FD\u8D85\u8FC7 ".concat(_constants.MAX_SCHEME_NAME_LENGTH, " \u4E2A\u5B57\u7B26")
+    };
+  }
+  return {
+    valid: true
+  };
+}
+
+/**
+ * 验证方案描述
+ */
+function validateSchemeDescription(description) {
+  if (description && description.length > _constants.MAX_SCHEME_DESCRIPTION_LENGTH) {
+    return {
+      valid: false,
+      error: "\u65B9\u6848\u63CF\u8FF0\u4E0D\u80FD\u8D85\u8FC7 ".concat(_constants.MAX_SCHEME_DESCRIPTION_LENGTH, " \u4E2A\u5B57\u7B26")
+    };
+  }
+  return {
+    valid: true
+  };
+}
+
+/**
+ * 检查方案名称是否重复
+ */
+function checkDuplicateName(name, schemes, excludeId) {
+  return schemes.some(function (scheme) {
+    return scheme.name === name && scheme.id !== excludeId;
+  });
+}
+
+/**
+ * 生成唯一的方案名称（处理重名情况）
+ */
+function generateUniqueName(baseName, schemes) {
+  var name = baseName;
+  var counter = 1;
+  while (checkDuplicateName(name, schemes)) {
+    name = "".concat(baseName, " (").concat(counter, ")");
+    counter++;
+  }
+  return name;
+}

package/dist/cjs/ag-grid-plus/setting/ColumnSetting.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { GridApi } from 'ag-grid-community';
+import type { UseColumnSchemesReturn } from '../schemes/types';
+interface ColumnSettingProps {
+    gridKey: string;
+    gridApi: GridApi;
+    visible: boolean;
+    onClose: () => void;
+    onSaveColumnState: (state: any) => void;
+    schemeManager?: UseColumnSchemesReturn;
+    type?: string;
+}
+/**
+ * 列设置组件 - 集成列配置和列方案管理
+ */
+declare const ColumnSetting: React.FC<ColumnSettingProps>;
+export default ColumnSetting;