vue3-smart-table 1.0.5 → 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.0.0] - 2025-12-29
+
+### ⚠️ Breaking Changes
+- 重新发布项目，废弃之前的 2.0.0 版本
+- 建议所有用户升级到 3.0.0 版本
+
+### Added
+- 基于 Vue 3 + Element Plus 的高可复用表格组件
+- 插件化架构，支持自定义渲染器
+- 内置 13 种常用渲染器（html、copy、img、dict、map、formatter、icon、input、input-number、select、button、link、slot）
+- 完整的 TypeScript 类型支持
+- 操作列权限控制
+- 列配置缓存
+
+## [2.0.0] - 2025-12-29
+
+### ⚠️ Deprecated
+- 此版本已被废弃，请升级到 3.0.0 版本
+
+### Added
+- 全新重构发布
+- 基于 Vue 3 + Element Plus 的高可复用表格组件
+- 插件化架构，支持自定义渲染器
+- 内置 13 种常用渲染器（html、copy、img、dict、map、formatter、icon、input、input-number、select、button、link、slot）
+- 完整的 TypeScript 类型支持
+- 操作列权限控制
+- 列配置缓存

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 chenx18
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1342,7 +1342,7 @@ import { SmartTable } from 'vue3-smart-table'
 </SmartTable>
 ```
 ## 完整示例代码
-![DEMO](./demo/assets/dmeo.jpg)
+![DEMO](./demo/assets/demo.jpg)
 ```vue
 <template>
     <div class="demo-container" style="padding: 20px;">

package/dist/types/components/SmartTable/config.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 全局配置管理
+ */
+import type { SmartTableConfig } from './types';
+/**
+ * 全局配置类
+ */
+declare class ConfigManager {
+    private config;
+    /**
+     * 获取所有配置
+     */
+    getConfig(): SmartTableConfig;
+    /**
+     * 设置配置
+     */
+    setConfig(config: Partial<SmartTableConfig>): void;
+    /**
+     * 获取特定配置项
+     */
+    get<K extends keyof SmartTableConfig>(key: K): SmartTableConfig[K];
+    /**
+     * 重置为默认配置
+     */
+    reset(): void;
+    /**
+     * 深度合并配置
+     */
+    private mergeConfig;
+}
+/**
+ * 获取全局配置管理器
+ */
+export declare function getConfigManager(): ConfigManager;
+/**
+ * 安装插件（用于 Vue.use()）
+ */
+export interface SmartTablePlugin {
+    install: (options?: SmartTableConfig) => void;
+}
+/**
+ * 创建插件实例
+ */
+export declare function createSmartTablePlugin(defaultOptions?: SmartTableConfig): SmartTablePlugin;
+/**
+ * 全局配置快捷方法
+ */
+export declare function setSmartTableConfig(config: Partial<SmartTableConfig>): void;
+export declare function getSmartTableConfig(): SmartTableConfig;
+export {};

package/dist/types/components/SmartTable/hooks/useOperationColumn.d.ts

@@ -0,0 +1,19 @@
+import { ButtonConfig } from "../types";
+/**
+ * useOperationColumn
+ *
+ * 操作列专用逻辑 Hook，负责：
+ * 1. 根据权限判断操作列是否需要显示
+ * 2. 计算操作列宽度（支持按钮自定义宽度）
+ * 3. 支持行级 visible 配置
+ * @param buttonConfigs 操作列按钮配置
+ * @param maxbtn        操作列最多显示按钮数量（超过的不参与宽度计算）
+ * @param userPermissions 当前用户权限列表
+ */
+export declare function useOperationColumn(buttonConfigs: ButtonConfig[], maxbtn?: number, userPermissions?: string[]): {
+    hasAnyButton: import("vue").ComputedRef<boolean>;
+    optWidth: import("vue").ComputedRef<number>;
+    hasAnyVisibleButton: (rows: any[]) => boolean;
+    getMaxOptWidth: (rows: any[]) => any;
+    getVisibleButtons: (row: any) => ButtonConfig<any>[];
+};

package/dist/types/components/SmartTable/hooks/useTableColumns.d.ts

@@ -0,0 +1,28 @@
+/**
+ * useTableColumns
+ *
+ * 表格列管理 Hook
+ *
+ * 职责：
+ * - 管理表格列顺序
+ * - 管理列显示 / 隐藏
+ * - 持久化用户配置
+ */
+export declare function useTableColumns(defaultColumns: any[], options?: {
+    /** 缓存唯一标识 */
+    cacheKey?: string;
+    /** 存储介质，默认 localStorage */
+    storage?: Storage;
+}): {
+    /** 当前列配置（响应式） */
+    columns: import("vue").Ref<any[], any[]>;
+    /**
+     * 主动设置列配置
+     * 常用于：列设置弹窗 / 拖拽排序完成
+     */
+    setColumns(newColumns: any[]): void;
+    /**
+     * 重置为默认列配置
+     */
+    resetColumns(): void;
+};

package/dist/types/components/SmartTable/index.vue.d.ts

@@ -0,0 +1,89 @@
+import { PropType } from 'vue';
+declare var __VLS_44: any, __VLS_45: any, __VLS_54: any, __VLS_55: any;
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_44>]?: (props: typeof __VLS_45) => any;
+} & {
+    [K in NonNullable<typeof __VLS_54>]?: (props: typeof __VLS_55) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    data: {
+        type: ArrayConstructor;
+        default: () => never[];
+    };
+    columns: {
+        type: ArrayConstructor;
+        default: () => never[];
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    permissions: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    cacheKey: StringConstructor;
+    pagination: {
+        type: ObjectConstructor;
+        default: () => {};
+    };
+}>, {
+    tableRef: import("vue").Ref<any, any>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:columns": (...args: any[]) => void;
+    cellChange: (...args: any[]) => void;
+    cellBlur: (...args: any[]) => void;
+    cellEnter: (...args: any[]) => void;
+    "cell-click": (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    data: {
+        type: ArrayConstructor;
+        default: () => never[];
+    };
+    columns: {
+        type: ArrayConstructor;
+        default: () => never[];
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    permissions: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    cacheKey: StringConstructor;
+    pagination: {
+        type: ObjectConstructor;
+        default: () => {};
+    };
+}>> & Readonly<{
+    "onUpdate:columns"?: ((...args: any[]) => any) | undefined;
+    onCellChange?: ((...args: any[]) => any) | undefined;
+    onCellBlur?: ((...args: any[]) => any) | undefined;
+    onCellEnter?: ((...args: any[]) => any) | undefined;
+    "onCell-click"?: ((...args: any[]) => any) | undefined;
+}>, {
+    data: unknown[];
+    loading: boolean;
+    columns: unknown[];
+    rowKey: string;
+    permissions: string[];
+    pagination: Record<string, any>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/SmartTable/renderer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SmartTable 内部渲染器管理系统
+ * 移动到组件内部，保证组件的自包含性
+ */
+import { Component } from 'vue';
+import type { Renderer } from './types';
+/**
+ * 渲染器注册表接口
+ */
+export interface RendererRegistry {
+    register(name: string, renderer: Renderer): void;
+    registerMultiple(renderers: Record<string, Renderer>): void;
+    get(name: string): Renderer | undefined;
+    has(name: string): boolean;
+    unregister(name: string): boolean;
+    clear(): void;
+    names(): string[];
+}
+/**
+ * 渲染器管理器类
+ */
+declare class RendererManager implements RendererRegistry {
+    private renderers;
+    register(name: string, renderer: Renderer): void;
+    registerMultiple(renderers: Record<string, Renderer>): void;
+    get(name: string): Renderer | undefined;
+    has(name: string): boolean;
+    unregister(name: string): boolean;
+    clear(): void;
+    names(): string[];
+}
+/**
+ * 获取渲染器管理器
+ */
+export declare function getRendererManager(): RendererManager;
+/**
+ * 包装 SFC 组件为渲染器
+ */
+export declare function wrapSFCComponent(comp: Component): Renderer;
+/**
+ * 创建函数式渲染器
+ */
+export declare function createFunctionalRenderer(render: (props: {
+    row: any;
+    col: any;
+    index: number;
+    onCellChange?: (row: any, col: any) => void;
+    onCellBlur?: (row: any, col: any) => void;
+    onCellEnter?: (row: any, col: any) => void;
+    onClick?: (row: any, col: any) => void;
+}) => any): Renderer;
+/**
+ * 验证渲染器配置
+ * 在开发环境下验证 renderProps 的正确性
+ */
+export declare function validateRendererProps(rendererName: string, renderProps: Record<string, any> | undefined): void;
+export {};

package/dist/types/components/SmartTable/renderers/index.d.ts

@@ -0,0 +1,46 @@
+import type { ColumnConfig } from '../types';
+/**
+ * formatter 渲染器
+ */
+export declare function isDataColumn(col: ColumnConfig): col is any;
+/**
+ * 所有内置渲染器
+ */
+export declare const builtInRenderers: {
+    input: import("../types").Renderer;
+    'input-number': import("../types").Renderer;
+    select: import("../types").Renderer;
+    button: import("../types").Renderer;
+    link: import("../types").Renderer;
+    html: import("../types").Renderer;
+    copy: import("../types").Renderer;
+    img: import("../types").Renderer;
+    dict: import("../types").Renderer;
+    map: import("../types").Renderer;
+    formatter: import("../types").Renderer;
+    icon: import("../types").Renderer;
+};
+/**
+ * 安装所有内置渲染器
+ */
+export declare function registerBuiltInRenderers(registry: {
+    registerMultiple: (renderers: Record<string, any>) => void;
+}): void;
+/**
+ * 创建默认渲染器集合（兼容旧 API）
+ * @deprecated 建议使用插件化架构
+ */
+export declare function createRenderer(): {
+    input: import("../types").Renderer;
+    'input-number': import("../types").Renderer;
+    select: import("../types").Renderer;
+    button: import("../types").Renderer;
+    link: import("../types").Renderer;
+    html: import("../types").Renderer;
+    copy: import("../types").Renderer;
+    img: import("../types").Renderer;
+    dict: import("../types").Renderer;
+    map: import("../types").Renderer;
+    formatter: import("../types").Renderer;
+    icon: import("../types").Renderer;
+};

package/dist/types/components/SmartTable/renderers/input.vue.d.ts

@@ -0,0 +1,11 @@
+import type { ColumnConfig } from '../types';
+interface Props {
+    readonly row: any;
+    readonly col: ColumnConfig;
+    readonly index: number;
+    onCellBlur?: (row: any, col: ColumnConfig) => void;
+    onCellEnter?: (row: any, col: ColumnConfig) => void;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/SmartTable/renderers/inputNumber.vue.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnConfig } from '../types';
+interface Props {
+    readonly row: any;
+    readonly col: ColumnConfig;
+    readonly index: number;
+    onCellChange?: (row: any, col: ColumnConfig) => void;
+    onCellBlur?: (row: any, col: ColumnConfig) => void;
+    onCellEnter?: (row: any, col: ColumnConfig) => void;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/SmartTable/renderers/select.vue.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnConfig } from '../types';
+interface Props {
+    readonly row: any;
+    readonly col: ColumnConfig;
+    readonly index: number;
+    onCellChange?: (row: any, col: ColumnConfig) => void;
+    onCellBlur?: (row: any, col: ColumnConfig) => void;
+    onCellEnter?: (row: any, col: ColumnConfig) => void;
+}
+declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -0,0 +1,193 @@
+import type { ButtonProps, TableColumnCtx } from 'element-plus';
+import { DefaultRow } from 'element-plus/es/components/table/src/table/defaults';
+import type { Component } from 'vue';
+export type { validateRendererProps } from './renderer';
+/** 支持额外参数（Element Plus 透传 props） */
+export type WithRestProps<T> = T & {
+    [key: string]: any;
+};
+/** Renderer 组件类型 */
+export type Renderer = Component;
+/** 渲染器注册表接口 */
+export interface RendererRegistry {
+    register(name: string, renderer: Renderer): void;
+    registerMultiple(renderers: Record<string, Renderer>): void;
+    get(name: string): Renderer | undefined;
+    has(name: string): boolean;
+    unregister(name: string): boolean;
+    clear(): void;
+    names(): string[];
+}
+/** 全局配置接口 */
+export interface SmartTableConfig {
+    /** 自定义渲染器 */
+    renderers?: Record<string, Renderer>;
+    /** 默认分页配置 */
+    defaultPagination?: {
+        page?: number;
+        size?: number;
+        total?: number;
+    };
+    /** 默认表格属性 */
+    defaultTableProps?: Record<string, any>;
+    /** 默认列属性 */
+    defaultColumnProps?: Record<string, any>;
+}
+export interface ButtonConfig<R = any> {
+    permission?: string | string[];
+    label: string;
+    type?: 'primary' | 'success' | 'warning' | 'danger' | 'info';
+    action: (row: R) => void;
+    visible?: (row: R) => boolean;
+    width?: number;
+}
+export type RendererName = 'html' | 'copy' | 'img' | 'dict' | 'map' | 'formatter' | 'icon' | 'input' | 'input-number' | 'select' | 'button' | 'link' | 'slot';
+/** renderer 对应的 renderProps */
+export interface RendererPropsMap {
+    html: WithRestProps<{
+        style?: string;
+        class?: string;
+    }>;
+    copy: WithRestProps<{
+        /** 复制按钮图标颜色 */
+        iconColor?: string;
+        /** 复制按钮提示文本 */
+        copyTitle?: string;
+        /** 复制成功提示 */
+        successText?: string;
+        /** 复制失败提示 */
+        errorText?: string;
+        lineClamp?: number;
+        textStyles?: any;
+        textClass?: string;
+    }>;
+    img: WithRestProps<{
+        /** 图片宽度 */
+        width?: string | number;
+        /** 图片高度 */
+        height?: string | number;
+        /** 图片适应方式 */
+        fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+        /** 预览图片列表 */
+        previewSrcList?: string[];
+        /** 无图片时的占位文本 */
+        placeholder?: string;
+        /** 自定义样式 */
+        style?: string;
+    }>;
+    dict: WithRestProps<{
+        /** 字典配置 */
+        options: Array<{
+            label: string;
+            value: string | number;
+            listClass?: string;
+            cssClass?: string;
+        }>;
+        /** 是否显示未匹配的值 */
+        showValue?: boolean;
+    }>;
+    map: WithRestProps<{
+        /** key-value 映射 */
+        options: Record<string | number, any>;
+    }>;
+    formatter: never;
+    icon: WithRestProps<{
+        /** 自定义样式 */
+        style?: string;
+        /** 图标大小（像素） */
+        size?: number;
+        /** 自定义类名 */
+        class?: string;
+    }>;
+    input: WithRestProps<{
+        /** 占位文本 */
+        placeholder?: string;
+        /** 输入框尺寸 */
+        size?: 'small' | 'default' | 'large';
+        /** 是否可清空 */
+        clearable?: boolean;
+    }>;
+    'input-number': WithRestProps<{
+        /** 最小值 */
+        min?: number;
+        /** 最大值 */
+        max?: number;
+        /** 步长 */
+        step?: number;
+        /** 精度 */
+        precision?: number;
+        /** 输入框尺寸 */
+        size?: 'small' | 'default' | 'large';
+        /** 是否显示增减按钮 */
+        controls?: boolean;
+    }>;
+    select: WithRestProps<{
+        /** 选项配置 */
+        options: Array<{
+            label: string;
+            value: string | number;
+        }>;
+        /** 占位文本 */
+        placeholder?: string;
+        /** 选择器尺寸 */
+        size?: 'small' | 'default' | 'large';
+        /** 是否可清空 */
+        clearable?: boolean;
+    }>;
+    button: WithRestProps<ButtonProps & {
+        /** 按钮文本 */
+        label?: string;
+        /** 自定义样式 */
+        style?: string;
+        /** 自定义类名 */
+        class?: string;
+    }>;
+    link: WithRestProps<{
+        /** 链接文本 */
+        label?: string;
+        /** 链接地址 */
+        href: string;
+        /** 是否新窗口打开 */
+        blank?: boolean;
+        /** 自定义样式 */
+        style?: string;
+        /** 自定义类名 */
+        class?: string;
+    }>;
+}
+export type ColumnType = 'default' | 'selection' | 'index' | 'operation';
+export interface BaseColumn<R extends DefaultRow> {
+    key: keyof R & string;
+    label?: string;
+    visible?: boolean;
+    inControl?: boolean;
+    columnProps?: Partial<TableColumnCtx<R>>;
+    render?: RendererName;
+    slot?: string;
+    renderProps?: Partial<RendererPropsMap[keyof RendererPropsMap]>;
+    buttons?: ButtonConfig<R>[];
+    maxbtn?: number;
+    __rows?: R[];
+}
+export interface SelectionColumn<R extends DefaultRow> extends BaseColumn<R> {
+    type: 'selection';
+}
+export interface IndexColumn<R extends DefaultRow> extends BaseColumn<R> {
+    type: 'index';
+}
+export interface OperationColumn<R extends DefaultRow> extends BaseColumn<R> {
+    type: 'operation';
+    buttons: ButtonConfig<R>[];
+}
+export interface DataColumn<R extends DefaultRow> extends BaseColumn<R> {
+    type?: 'default';
+    /**
+     * 格式化函数
+     * @param value 单元格值
+     * @param row 当前行数据
+     * @param index 当前行索引（从0开始）
+     * @returns 格式化后的显示内容
+     */
+    formatter?: (value: any, row: R, index: number) => any;
+}
+export type ColumnConfig<R extends DefaultRow = any> = SelectionColumn<R> | IndexColumn<R> | OperationColumn<R> | DataColumn<R>;

package/dist/types/components/SmartTable/utils/path.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 安全获取对象深层属性
+ * 支持 a.b.c / a.0.b
+ */
+export declare function getValueByPath(obj: any, path?: string): any;
+/**
+ * 安全设置对象深层属性（用于可编辑表格）
+ */
+export declare function setValueByPath(obj: any, path: string, value: any): void;

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Vue3 Smart Table - 主入口文件
+ *
+ * 基于 Vue 3 + Element Plus 的高可复用表格组件库
+ */
+import SmartTable from './components/SmartTable/index.vue';
+export * from './components/SmartTable/types';
+export { getRendererManager, wrapSFCComponent, createFunctionalRenderer, validateRendererProps } from './components/SmartTable/renderer';
+export { setSmartTableConfig, getSmartTableConfig } from './components/SmartTable/config';
+export { builtInRenderers, registerBuiltInRenderers, createRenderer } from './components/SmartTable/renderers';
+export { defineColumn } from './types/enhanced';
+export { SmartTable };
+export default SmartTable;

package/dist/types/types/enhanced.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 增强类型系统 - 提供更好的类型推断
+ */
+import type { ColumnConfig, RendererName } from '../components/SmartTable/types';
+/**
+ * 提取行数据的类型
+ */
+export type ExtractRowType<T> = T extends ColumnConfig<infer R> ? R : never;
+/**
+ * 根据列配置提取表格数据类型
+ */
+export type TableDataFromColumns<T extends ColumnConfig[]> = T extends (infer C)[] ? C extends ColumnConfig<infer R> ? R : any : any;
+/**
+ * 渲染器 Props 类型推断
+ */
+export type InferRendererProps<T extends RendererName> = T extends 'html' ? {
+    style?: string;
+    class?: string;
+    [key: string]: any;
+} : T extends 'copy' ? {
+    successText?: string;
+    errorText?: string;
+    iconColor?: string;
+    [key: string]: any;
+} : T extends 'img' ? {
+    width?: string | number;
+    height?: string | number;
+    fit?: string;
+    previewSrcList?: string[];
+    [key: string]: any;
+} : T extends 'dict' ? {
+    options: Array<{
+        label: string;
+        value: string | number;
+        listClass?: string;
+        cssClass?: string;
+    }>;
+    showValue?: boolean;
+} : T extends 'map' ? {
+    options: Record<string | number, any>;
+} : T extends 'input' ? {
+    placeholder?: string;
+    size?: 'small' | 'default' | 'large';
+    clearable?: boolean;
+} : T extends 'select' ? {
+    options: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    placeholder?: string;
+    clearable?: boolean;
+} : {
+    [key: string]: any;
+};
+/**
+ * 快捷创建列的辅助函数（类型安全简化版）
+ */
+export declare function defineColumn(key: string, config?: Partial<Omit<ColumnConfig, 'key'>>): ColumnConfig;