@nokecy/qc-ui 1.0.94 → 1.0.96

package/dist/esm/ag-grid-plus/schemes/storage/useRemoteStorage.d.ts

@@ -1,29 +0,0 @@
-import { RemoteStorageAdapter, RemoteStorageConfig } from './remoteStorageAdapter';
-/**
- * 使用全局配置创建 RemoteStorageAdapter
- * 自动从 GridPlusContext 获取全局配置并与局部配置合并
- *
- * @param localConfig 局部配置,会覆盖全局配置
- * @returns RemoteStorageAdapter 实例
- *
- * @example
- * ```tsx
- * // 1. 在顶层提供全局配置
- * <GridPlusContext.Provider value={{
- *   remoteStorageConfig: {
- *     apiBaseUrl: 'https://api.example.com',
- *     getToken: () => localStorage.getItem('token'),
- *     getUserId: () => localStorage.getItem('userId'),
- *   }
- * }}>
- *   <AgGridPlus ... />
- * </GridPlusContext.Provider>
- *
- * // 2. 在组件中使用(会自动合并全局配置)
- * const adapter = useRemoteStorage({
- *   // 仅需提供差异配置,其他从全局继承
- *   apiVersion: 'v2', // 覆盖全局的 apiVersion
- * });
- * ```
- */
-export declare function useRemoteStorage(localConfig?: Partial<RemoteStorageConfig>): RemoteStorageAdapter;

package/dist/esm/ag-grid-plus/schemes/storage/useRemoteStorage.js

@@ -1,40 +0,0 @@
-import { useContext, useMemo } from 'react';
-import { GridPlusContext } from "../../context/gridContext";
-import { RemoteStorageAdapter } from "./remoteStorageAdapter";
-import { mergeRemoteStorageConfig } from "./configMerger";
-
-/**
- * 使用全局配置创建 RemoteStorageAdapter
- * 自动从 GridPlusContext 获取全局配置并与局部配置合并
- *
- * @param localConfig 局部配置,会覆盖全局配置
- * @returns RemoteStorageAdapter 实例
- *
- * @example
- * ```tsx
- * // 1. 在顶层提供全局配置
- * <GridPlusContext.Provider value={{
- *   remoteStorageConfig: {
- *     apiBaseUrl: 'https://api.example.com',
- *     getToken: () => localStorage.getItem('token'),
- *     getUserId: () => localStorage.getItem('userId'),
- *   }
- * }}>
- *   <AgGridPlus ... />
- * </GridPlusContext.Provider>
- *
- * // 2. 在组件中使用(会自动合并全局配置)
- * const adapter = useRemoteStorage({
- *   // 仅需提供差异配置,其他从全局继承
- *   apiVersion: 'v2', // 覆盖全局的 apiVersion
- * });
- * ```
- */
-export function useRemoteStorage(localConfig) {
-  var context = useContext(GridPlusContext);
-  return useMemo(function () {
-    // 合并全局配置和局部配置
-    var mergedConfig = mergeRemoteStorageConfig(context.remoteStorageConfig, localConfig);
-    return new RemoteStorageAdapter(mergedConfig);
-  }, [context.remoteStorageConfig, localConfig]);
-}

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

@@ -1,131 +0,0 @@
-import { ColumnState } from 'ag-grid-community';
-import type { FlatColumnItem } from '../setting/columnGroupTypes';
-/**
- * 列配置方案数据结构
- */
-export interface ColumnScheme {
-    /** 方案唯一标识（UUID） */
-    id: string;
-    /** 方案名称（用户可编辑） */
-    name: string;
-    /** 是否为默认方案（首次加载自动应用） */
-    isDefault?: boolean;
-    /** 是否为系统预设方案（不可删除） */
-    isSystem?: boolean;
-    /** 创建时间戳 */
-    createdAt: number;
-    /** 更新时间戳 */
-    updatedAt: number;
-    /** 完整的列配置数据(包含分组层级结构) */
-    columnConfig: FlatColumnItem[];
-    /** AG-Grid 过滤器模型数据（可选） */
-    filterModel?: any;
-    /** 方案描述（可选） */
-    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, columnConfig: FlatColumnItem[], options?: Partial<ColumnScheme> & {
-        activate?: boolean;
-    }) => Promise<ColumnScheme>;
-    /** 更新方案信息（不影响 columnConfig） */
-    updateScheme: (schemeId: string, updates: Partial<Omit<ColumnScheme, 'id' | 'columnConfig'>>) => 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/esm/ag-grid-plus/schemes/types.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,27 +0,0 @@
-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/esm/ag-grid-plus/schemes/utils/validator.js

@@ -1,100 +0,0 @@
-import { MAX_SCHEME_NAME_LENGTH, MAX_SCHEME_DESCRIPTION_LENGTH } from "../constants";
-
-/**
- * 验证方案有效性
- */
-export function validateScheme(scheme, currentColumnDefs) {
-  var warnings = [];
-  var invalidColumns = [];
-  var validatedState = [];
-
-  // 获取当前有效的列 field 集合
-  var validFields = new Set(currentColumnDefs.filter(function (col) {
-    return col.field || col.colId;
-  }).map(function (col) {
-    return col.field || col.colId;
-  }));
-
-  // 验证每个列配置项
-  scheme.columnConfig.forEach(function (item) {
-    // 只验证列类型(非分组),因为分组没有对应的 field
-    if (item.type === 'column' && item.field) {
-      // 检查列是否仍然存在于表格定义中
-      if (!validFields.has(item.field)) {
-        invalidColumns.push(item.field);
-        warnings.push("\u5217 \"".concat(item.field, "\" \u5728\u5F53\u524D\u8868\u683C\u4E2D\u4E0D\u5B58\u5728"));
-      }
-    }
-  });
-  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"));
-  }
-
-  // 注意: validatedState 保持为空数组,因为 columnConfig 不是 ColumnState 格式
-  // 如果需要转换,应在调用方进行
-  return {
-    valid: valid,
-    invalidColumns: invalidColumns,
-    validatedState: validatedState,
-    warnings: warnings.length > 0 ? warnings : undefined
-  };
-}
-
-/**
- * 验证方案名称
- */
-export function validateSchemeName(name) {
-  if (!name || name.trim().length === 0) {
-    return {
-      valid: false,
-      error: '方案名称不能为空'
-    };
-  }
-  if (name.length > MAX_SCHEME_NAME_LENGTH) {
-    return {
-      valid: false,
-      error: "\u65B9\u6848\u540D\u79F0\u4E0D\u80FD\u8D85\u8FC7 ".concat(MAX_SCHEME_NAME_LENGTH, " \u4E2A\u5B57\u7B26")
-    };
-  }
-  return {
-    valid: true
-  };
-}
-
-/**
- * 验证方案描述
- */
-export function validateSchemeDescription(description) {
-  if (description && description.length > MAX_SCHEME_DESCRIPTION_LENGTH) {
-    return {
-      valid: false,
-      error: "\u65B9\u6848\u63CF\u8FF0\u4E0D\u80FD\u8D85\u8FC7 ".concat(MAX_SCHEME_DESCRIPTION_LENGTH, " \u4E2A\u5B57\u7B26")
-    };
-  }
-  return {
-    valid: true
-  };
-}
-
-/**
- * 检查方案名称是否重复
- */
-export function checkDuplicateName(name, schemes, excludeId) {
-  return schemes.some(function (scheme) {
-    return scheme.name === name && scheme.id !== excludeId;
-  });
-}
-
-/**
- * 生成唯一的方案名称（处理重名情况）
- */
-export function generateUniqueName(baseName, schemes) {
-  var name = baseName;
-  var counter = 1;
-  while (checkDuplicateName(name, schemes)) {
-    name = "".concat(baseName, " (").concat(counter, ")");
-    counter++;
-  }
-  return name;
-}

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

@@ -1,13 +0,0 @@
-/**
- * 方案存储模块
- *
- * @deprecated 整个 storage 模块已废弃
- *
- * SchemeSyncManager 和全局同步系统已被完全移除。
- * 请使用 RemoteStorageAdapter 替代。
- *
- * @see RemoteStorageAdapter - 新的远程存储适配器
- *
- * 迁移指南: docs/ag-grid-plus/DEPRECATION-NOTICE.md
- */
-export {};

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

@@ -1,17 +0,0 @@
-/**
- * 方案存储模块
- *
- * @deprecated 整个 storage 模块已废弃
- *
- * SchemeSyncManager 和全局同步系统已被完全移除。
- * 请使用 RemoteStorageAdapter 替代。
- *
- * @see RemoteStorageAdapter - 新的远程存储适配器
- *
- * 迁移指南: docs/ag-grid-plus/DEPRECATION-NOTICE.md
- */
-
-// 此文件仅保留用于向后兼容性说明
-// 所有实际代码已移除
-
-export {};