@bscjc/webui 1.2.4 → 1.4.0

package/README.md

@@ -1,4 +1,5 @@
 # @bscjc/webui
+
 一个 Vue3 组件库，使用 Vite，Element Plus 和 TypeScript 构建的组件库
 
 ## 组件目录介绍
@@ -14,13 +15,15 @@
 | JcInputComplex     | 复杂输入切换组件，支持单行和多行文本输入       |
 | JcTagQuery         | 标签查询组件，用于展示和管理查询标签           |
 | JcMoreQueryContain | 查询容器，用于包裹更多查询条件                 |
+| JcImportDialog     | 导入弹窗组件，支持导入操作和下载模版           |
+| JcImportButton     | 导入按钮组件，支持导入操作                     |
 
 ## 安装使用说明
 
 ### 安装
 
 ```shell
-npm i @bscjc/webui  
+npm i @bscjc/webui
 // 或者
 pnpm add @bscjc/webui
 ```
@@ -55,4 +58,4 @@ app.mount("#app");
 <script setup>
 import { JcSelectQuery } from "@bscjc/webui";
 </script>
-```
+```

package/dist/components/JcCascader/index.d.ts

@@ -1,58 +1,156 @@
-import type { Plugin } from "vue";
-type SFCWithInstall<T> = T & Plugin;
-export declare const JcCascader: SFCWithInstall<import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    field: {
-        type: StringConstructor;
-        required: true;
-        default: string;
-    };
-    options: {
-        type: import("vue").PropType<Array<{
+export declare const JcCascader: {
+    new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
+        field: {
+            type: StringConstructor;
+            required: true;
+            default: string;
+        };
+        options: {
+            type: import("vue").PropType<Array<{
+                label: string;
+                value: string;
+                children?: Array<{
+                    label: string;
+                    value: string;
+                }>;
+            }>> | never[];
+            default: () => never[];
+        };
+        keyField: {
+            type: any;
+            default: () => string[];
+        };
+        width: {
+            type: StringConstructor;
+            default: string;
+        };
+        size: {
+            type: import("vue").PropType<"small" | "default" | "large">;
+            default: string;
+            validator: (value: string) => boolean;
+        };
+        footerBtnName: {
+            type: StringConstructor;
+            default: string;
+        };
+        isNeedFooter: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        isNeedHeader: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        isNeedOnlySelect: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        injectionKey: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{}>, {
+        [x: string]: any;
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, import("vue").PublicProps, {
+        size: "small" | "default" | "large";
+        injectionKey: string;
+        field: string;
+        options: {
             label: string;
             value: string;
             children?: Array<{
                 label: string;
                 value: string;
             }>;
-        }>> | never[];
-        default: () => never[];
-    };
-    keyField: {
-        type: any;
-        default: () => string[];
-    };
-    width: {
-        type: StringConstructor;
-        default: string;
-    };
-    size: {
-        type: import("vue").PropType<"small" | "default" | "large">;
-        default: string;
-        validator: (value: string) => boolean;
-    };
-    footerBtnName: {
-        type: StringConstructor;
-        default: string;
-    };
-    isNeedFooter: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    isNeedHeader: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    isNeedOnlySelect: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    injectionKey: {
-        type: StringConstructor;
-        default: string;
-    };
-}>, {
-    [x: string]: any;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+        }[];
+        keyField: any;
+        width: string;
+        footerBtnName: string;
+        isNeedFooter: boolean;
+        isNeedOnlySelect: boolean;
+        isNeedHeader: boolean;
+    }, true, {}, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {}, any, import("vue").ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import("vue").ExtractPropTypes<{
+        field: {
+            type: StringConstructor;
+            required: true;
+            default: string;
+        };
+        options: {
+            type: import("vue").PropType<Array<{
+                label: string;
+                value: string;
+                children?: Array<{
+                    label: string;
+                    value: string;
+                }>;
+            }>> | never[];
+            default: () => never[];
+        };
+        keyField: {
+            type: any;
+            default: () => string[];
+        };
+        width: {
+            type: StringConstructor;
+            default: string;
+        };
+        size: {
+            type: import("vue").PropType<"small" | "default" | "large">;
+            default: string;
+            validator: (value: string) => boolean;
+        };
+        footerBtnName: {
+            type: StringConstructor;
+            default: string;
+        };
+        isNeedFooter: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        isNeedHeader: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        isNeedOnlySelect: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        injectionKey: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{}>, {
+        [x: string]: any;
+    }, {}, {}, {}, {
+        size: "small" | "default" | "large";
+        injectionKey: string;
+        field: string;
+        options: {
+            label: string;
+            value: string;
+            children?: Array<{
+                label: string;
+                value: string;
+            }>;
+        }[];
+        keyField: any;
+        width: string;
+        footerBtnName: string;
+        isNeedFooter: boolean;
+        isNeedOnlySelect: boolean;
+        isNeedHeader: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{
     field: {
         type: StringConstructor;
         required: true;
@@ -103,6 +201,8 @@ export declare const JcCascader: SFCWithInstall<import("vue").DefineComponent<im
         default: string;
     };
 }>> & Readonly<{}>, {
+    [x: string]: any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {
     size: "small" | "default" | "large";
     injectionKey: string;
     field: string;
@@ -120,5 +220,5 @@ export declare const JcCascader: SFCWithInstall<import("vue").DefineComponent<im
     isNeedFooter: boolean;
     isNeedOnlySelect: boolean;
     isNeedHeader: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>>;
+}, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & import("vue").Plugin;
 export default JcCascader;

package/dist/components/JcColumnConfig/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ToolbarColumnConfigV2 常量定义
+ */
+/** 存储键前缀 */
+export declare const STORAGE_PREFIX = "VXE_TABLE_CUSTOM_COLUMN_";
+/** 存储版本号 */
+export declare const STORAGE_VERSION = 1;
+/** 特殊列类型（不参与配置） */
+export declare const SPECIAL_COLUMN_TYPES: readonly ["checkbox", "seq", "radio", "expand"];

package/dist/components/JcColumnConfig/index.d.ts

@@ -0,0 +1,190 @@
+export declare const JcColumnConfig: {
+    new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
+        table: {
+            type: import("vue").PropType<import("vxe-table").VxeTableInstance>;
+            default: null;
+        };
+        itemWidth: {
+            type: NumberConstructor;
+            default: number;
+        };
+        drawerWidth: {
+            type: StringConstructor;
+            default: string;
+        };
+        maxFixedCount: {
+            type: NumberConstructor;
+            default: number;
+        };
+        lockFieldList: {
+            type: import("vue").PropType<string[]>;
+            default: () => never[];
+        };
+        storagePrefix: {
+            type: StringConstructor;
+            default: string;
+        };
+        columnGroups: {
+            type: import("vue").PropType<import("./types").ColumnGroupConfig[]>;
+            default: () => never[];
+        };
+    }>> & Readonly<{
+        onChange?: ((config: import("./types").ColumnConfig[]) => any) | undefined;
+        onReset?: (() => any) | undefined;
+        onSaved?: ((config: import("./types").ColumnConfig[]) => any) | undefined;
+        "onWidth-change"?: ((params: {
+            field: string;
+            width: number;
+        }) => any) | undefined;
+    }>, {
+        openDrawer: () => void;
+        closeDrawer: () => void;
+        loadStoredConfig: () => Promise<void>;
+        resetToDefault: () => Promise<void>;
+        saveAndApply: () => Promise<void>;
+        onResizableChange: (params: import("vxe-table").VxeTableDefines.ResizableChangeEventParams) => void;
+        hasStoredConfig: () => boolean;
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+        change: (config: import("./types").ColumnConfig[]) => any;
+        reset: () => any;
+        saved: (config: import("./types").ColumnConfig[]) => any;
+        "width-change": (params: {
+            field: string;
+            width: number;
+        }) => any;
+    }, import("vue").PublicProps, {
+        table: import("vxe-table").VxeTableInstance;
+        lockFieldList: string[];
+        maxFixedCount: number;
+        storagePrefix: string;
+        itemWidth: number;
+        drawerWidth: string;
+        columnGroups: import("./types").ColumnGroupConfig[];
+    }, true, {}, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {}, any, import("vue").ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import("vue").ExtractPropTypes<{
+        table: {
+            type: import("vue").PropType<import("vxe-table").VxeTableInstance>;
+            default: null;
+        };
+        itemWidth: {
+            type: NumberConstructor;
+            default: number;
+        };
+        drawerWidth: {
+            type: StringConstructor;
+            default: string;
+        };
+        maxFixedCount: {
+            type: NumberConstructor;
+            default: number;
+        };
+        lockFieldList: {
+            type: import("vue").PropType<string[]>;
+            default: () => never[];
+        };
+        storagePrefix: {
+            type: StringConstructor;
+            default: string;
+        };
+        columnGroups: {
+            type: import("vue").PropType<import("./types").ColumnGroupConfig[]>;
+            default: () => never[];
+        };
+    }>> & Readonly<{
+        onChange?: ((config: import("./types").ColumnConfig[]) => any) | undefined;
+        onReset?: (() => any) | undefined;
+        onSaved?: ((config: import("./types").ColumnConfig[]) => any) | undefined;
+        "onWidth-change"?: ((params: {
+            field: string;
+            width: number;
+        }) => any) | undefined;
+    }>, {
+        openDrawer: () => void;
+        closeDrawer: () => void;
+        loadStoredConfig: () => Promise<void>;
+        resetToDefault: () => Promise<void>;
+        saveAndApply: () => Promise<void>;
+        onResizableChange: (params: import("vxe-table").VxeTableDefines.ResizableChangeEventParams) => void;
+        hasStoredConfig: () => boolean;
+    }, {}, {}, {}, {
+        table: import("vxe-table").VxeTableInstance;
+        lockFieldList: string[];
+        maxFixedCount: number;
+        storagePrefix: string;
+        itemWidth: number;
+        drawerWidth: string;
+        columnGroups: import("./types").ColumnGroupConfig[];
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{
+    table: {
+        type: import("vue").PropType<import("vxe-table").VxeTableInstance>;
+        default: null;
+    };
+    itemWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    drawerWidth: {
+        type: StringConstructor;
+        default: string;
+    };
+    maxFixedCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    lockFieldList: {
+        type: import("vue").PropType<string[]>;
+        default: () => never[];
+    };
+    storagePrefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    columnGroups: {
+        type: import("vue").PropType<import("./types").ColumnGroupConfig[]>;
+        default: () => never[];
+    };
+}>> & Readonly<{
+    onChange?: ((config: import("./types").ColumnConfig[]) => any) | undefined;
+    onReset?: (() => any) | undefined;
+    onSaved?: ((config: import("./types").ColumnConfig[]) => any) | undefined;
+    "onWidth-change"?: ((params: {
+        field: string;
+        width: number;
+    }) => any) | undefined;
+}>, {
+    openDrawer: () => void;
+    closeDrawer: () => void;
+    loadStoredConfig: () => Promise<void>;
+    resetToDefault: () => Promise<void>;
+    saveAndApply: () => Promise<void>;
+    onResizableChange: (params: import("vxe-table").VxeTableDefines.ResizableChangeEventParams) => void;
+    hasStoredConfig: () => boolean;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    change: (config: import("./types").ColumnConfig[]) => any;
+    reset: () => any;
+    saved: (config: import("./types").ColumnConfig[]) => any;
+    "width-change": (params: {
+        field: string;
+        width: number;
+    }) => any;
+}, string, {
+    table: import("vxe-table").VxeTableInstance;
+    lockFieldList: string[];
+    maxFixedCount: number;
+    storagePrefix: string;
+    itemWidth: number;
+    drawerWidth: string;
+    columnGroups: import("./types").ColumnGroupConfig[];
+}, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & import("vue").Plugin;
+export default JcColumnConfig;
+export type { ColumnGroupConfig } from "./types";

package/dist/components/JcColumnConfig/index.vue.d.ts

@@ -0,0 +1,95 @@
+import { type PropType } from "vue";
+import type { VxeTableInstance, VxeTableDefines } from "vxe-table";
+import type { ColumnConfig, ColumnGroupConfig } from "./types";
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    table: {
+        type: PropType<VxeTableInstance>;
+        default: null;
+    };
+    itemWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    drawerWidth: {
+        type: StringConstructor;
+        default: string;
+    };
+    maxFixedCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    lockFieldList: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    storagePrefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    columnGroups: {
+        type: PropType<ColumnGroupConfig[]>;
+        default: () => never[];
+    };
+}>, {
+    openDrawer: () => void;
+    closeDrawer: () => void;
+    loadStoredConfig: () => Promise<void>;
+    resetToDefault: () => Promise<void>;
+    saveAndApply: () => Promise<void>;
+    onResizableChange: (params: VxeTableDefines.ResizableChangeEventParams) => void;
+    hasStoredConfig: () => boolean;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    change: (config: ColumnConfig[]) => any;
+    reset: () => any;
+    saved: (config: ColumnConfig[]) => any;
+    "width-change": (params: {
+        field: string;
+        width: number;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    table: {
+        type: PropType<VxeTableInstance>;
+        default: null;
+    };
+    itemWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    drawerWidth: {
+        type: StringConstructor;
+        default: string;
+    };
+    maxFixedCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    lockFieldList: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    storagePrefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    columnGroups: {
+        type: PropType<ColumnGroupConfig[]>;
+        default: () => never[];
+    };
+}>> & Readonly<{
+    onChange?: ((config: ColumnConfig[]) => any) | undefined;
+    onReset?: (() => any) | undefined;
+    onSaved?: ((config: ColumnConfig[]) => any) | undefined;
+    "onWidth-change"?: ((params: {
+        field: string;
+        width: number;
+    }) => any) | undefined;
+}>, {
+    table: VxeTableInstance;
+    lockFieldList: string[];
+    maxFixedCount: number;
+    storagePrefix: string;
+    itemWidth: number;
+    drawerWidth: string;
+    columnGroups: ColumnGroupConfig[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/JcColumnConfig/storage.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ToolbarColumnConfigV2 存储工具函数
+ */
+import type { StoredColumnConfig, TableColumnStorage } from './types';
+/**
+ * 获取存储键
+ */
+export declare const getStorageKey: (tableId: string, prefix: string) => string;
+/**
+ * 读取存储
+ */
+export declare const getStorage: (tableId: string, prefix: string) => TableColumnStorage | null;
+/**
+ * 保存存储
+ */
+export declare const setStorage: (tableId: string, prefix: string, columns: StoredColumnConfig[]) => void;
+/**
+ * 删除存储
+ */
+export declare const removeStorage: (tableId: string, prefix: string) => void;
+/**
+ * 更新单列宽度（增量更新）
+ */
+export declare const updateColumnWidth: (tableId: string, prefix: string, field: string, width: number, allColumnsForFallback?: StoredColumnConfig[]) => void;
+/**
+ * 检查是否有存储配置
+ */
+export declare const hasStorage: (tableId: string, prefix: string) => boolean;

package/dist/components/JcColumnConfig/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * ToolbarColumnConfigV2 类型定义
+ */
+import type { VxeTableInstance, VxeTableDefines } from 'vxe-table';
+/**
+ * 外部传入的列分组配置（简化版）
+ */
+export interface ColumnGroupConfig {
+    /** 分组标题 */
+    title: string;
+    /** 分组下的字段列表 */
+    fields: string[];
+}
+/**
+ * 内部使用的列分组（带 id）
+ */
+export interface ColumnGroup extends ColumnGroupConfig {
+    /** 分组唯一标识（自动生成） */
+    id: string;
+    /** 是否为默认分组（[基础信息]） */
+    isDefault?: boolean;
+}
+/**
+ * 存储的列配置（持久化到 localStorage）
+ */
+export interface StoredColumnConfig {
+    /** 列字段名（唯一标识） */
+    field: string;
+    /** 是否可见 */
+    visible: boolean;
+    /** 固定方向 */
+    fixed?: 'left' | 'right';
+    /** 列宽（像素） */
+    width?: number;
+    /** 排序序号 */
+    sortNumber: number;
+}
+/**
+ * 完整存储结构
+ */
+export interface TableColumnStorage {
+    /** 存储版本（用于兼容性升级） */
+    version: number;
+    /** 最后更新时间戳 */
+    timestamp: number;
+    /** 列配置数组 */
+    columns: StoredColumnConfig[];
+}
+/**
+ * 组件内部使用的列配置（扩展自 StoredColumnConfig）
+ */
+export interface ColumnConfig extends StoredColumnConfig {
+    /** 列标题 */
+    title: string;
+    /** 是否锁定可见性（由 lockFieldList 决定） */
+    visibleLocked: boolean;
+    /** 原始索引（用于判断顺序是否变化） */
+    originalIndex: number;
+    /** 所属分组ID */
+    groupId?: string;
+}
+/**
+ * 组件 Props 类型
+ */
+export interface ToolbarColumnConfigV2Props {
+    /** 表格实例（必需） */
+    table: VxeTableInstance | null;
+    /** 锁定不能隐藏的字段列表 */
+    lockFieldList?: string[];
+    /** 最大固定列数（左右合计） */
+    maxFixedCount?: number;
+    /** 每个字段项的宽度 */
+    itemWidth?: number;
+    /** 抽屉宽度 */
+    drawerWidth?: string;
+    /** 存储键前缀 */
+    storagePrefix?: string;
+    /** 列分组配置（可选） */
+    columnGroups?: ColumnGroupConfig[];
+}
+/**
+ * 组件暴露的方法
+ */
+export interface ToolbarColumnConfigV2Expose {
+    /** 加载存储配置并应用到表格 */
+    loadStoredConfig: () => Promise<void>;
+    /** 恢复默认配置 */
+    resetToDefault: () => Promise<void>;
+    /** 保存并应用配置 */
+    saveAndApply: () => Promise<void>;
+    /** 打开配置抽屉 */
+    openDrawer: () => void;
+    /** 关闭配置抽屉 */
+    closeDrawer: () => void;
+    /** 处理列宽变化事件 */
+    onResizableChange: (params: VxeTableDefines.ResizableChangeEventParams) => void;
+    /** 检查是否有存储配置 */
+    hasStoredConfig: () => boolean;
+}