@yidun/antd-super-table 0.1.12 → 0.1.14

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to `@yidun/antd-super-table` will be documented in this file.
+
+## 0.1.14
+
+- ✨ 查询条件操作区新增插槽 `searchActionsExtra`：与内置查询/重置/高级筛选/展开同一行右侧，作用域参数 `loading` / `search` / `reset`
+- 🐛 修复关闭「展开/收起」时，若本地缓存为收起态导致仅显示第一行查询条件的问题
+- 🐛 修复 `type: 'component'` 查询项误走 input-group 从而在左侧展示 label 的问题（与 `showLabel` 语义一致）
+- 🔧 修复构建：`SuperTable.vue` 补充 `SuperTableDataItem` 类型导入，保证 `vue-tsc` 生成声明通过
+- 📚 类型：`SuperTableSearchActionsExtraSlotProps`、`SuperTableSlots.searchActionsExtra`
+- 📚 文档：`README` 补充 `searchOnFormItemChange`、`showExpandButton`、`showResetButton` 及插槽示例（修正 `toolBar` → `toolBarExtra`）
+
+## 0.1.13
+
+- 🔧 `addonAfter` 展示条件收紧：仅在显式配置非空对象且表单项类型为 `input`（支持 antd Input 的 `addonAfter` 插槽）时渲染；空配置 `{}` 不展示
+
+## 0.1.12
+
+- ✨ 查询项 `input` 新增 `addonAfter` 能力：
+  - 支持 `link + small` 按钮
+  - 支持 `text / className / show / disabled / onClick` 配置
+  - 兼容历史错拼字段 `addonAffter`、`addonAter`
+- 🧩 查询项视觉与交互优化：
+  - `FormFieldItem` 拼接样式优化，减少 label 与输入组件边框断点和缝隙
+- ✨ 请求行为增强：
+  - 新增 `autoSearch`，支持关闭自动请求并保留手动查询能力
+  - `customQueryParams` 在请求阶段持续合并，切换场景后依然生效
+- ✨ 新增 `enableAdvancedFilter`：
+  - 支持 `enableScene=false` 时独立使用“高级筛选”弹窗
+  - 不开场景时可按 `fixed/selected` 控制默认展示项
+- 📚 文档与示例更新：
+  - 更新 `README` API/用法说明
+  - 更新 `example`：新增独立高级筛选开关示例
+
+## 0.1.10
+
+- ✨ 支持通过列配置 `slotName` 渲染自定义单元格插槽：
+  - 当 `column.slotName` 命中外层具名插槽时，优先使用插槽渲染
+  - 未命中时保持原有 `table-cell-content` 渲染逻辑（`type/component` 等）不变
+- ✨ 新增自定义单元格插槽类型声明：
+  - `SuperTableColumn` 新增 `slotName?: string`
+  - `SuperTableSlots` 支持动态具名插槽索引签名
+- 💄 插槽单元格样式增强：
+  - 自定义插槽分支新增独立容器样式
+  - 对插槽内容设置 `white-space: normal`，避免受单行文本策略影响
+- 📚 示例更新：
+  - `example/tableColumns.ts` 增加 `slotName` 列示例
+  - `example/index.vue` 增加多行列表 + 非纯文本元素（badge/button/tag）插槽示例
+- ✨ 查询条件新增 `tooltip`（`string | number`）：
+  - 主页面查询条件标签支持 icon + tooltip（默认 `placement="top"`）
+  - 场景弹窗筛选条件行支持 icon + tooltip（默认 `placement="top"`）
+- 🎯 布局一致性优化：
+  - 查询条件标签区域按 tooltip 图标预留宽度，避免输入区域换行或遮挡
+  - 场景弹窗统一预留 tooltip 占位，无 tooltip 时不展示 icon 但保留宽度
+
+## 0.1.6
+
+- 🐛 修复依赖问题：将 `jsonpath-plus` 从 `optionalDependencies` 移到 `dependencies`，解决其他项目使用 `npm ci` 时的依赖缺失问题
+- ✨ 优化场景初始化：当没有选中过场景 code 且有默认场景时，自动选中默认场景并触发查询
+- 📝 示例代码优化：添加默认场景配置示例，新增清空缓存功能，场景功能默认开启
+
+## 0.1.2
+
+- 新增 `tableWrapperStyle` 属性，支持自定义表格容器样式
+- 修复 `toolBarExtra` 插槽在未提供 `tableHead` 时无法展示的问题
+- 修复 `rowKey` 为函数时构建声明文件的类型错误
+
+## 0.0.7
+
+- 🔄 **重构场景管理 API**：`sceneRequestUrls` 重构为 `sceneRequest`，由 URL 字符串改为请求函数，便于自定义逻辑与错误处理
+- 🔧 **错误处理**：`sceneStorageType` 为 `api` 但未配置 `sceneRequest` 时给出明确提示并降级
+- 🗑️ **架构**：移除 `apiSceneService` 中间层，直接使用 `sceneRequest`
+- 📚 **文档**：补充本地 / API 两种存储模式说明与示例
+- 🖼️ **文档资源**：示例图改为 CDN，修复 npm 包内图片无法展示的问题
+
+## 0.0.6
+
+- 🐛 修复场景管理相关问题
+- 🐛 修复表格列配置缓存问题
+- 💄 优化 UI 样式与交互
+
+## 0.0.2
+
+- ✨ 表格拖拽排序、表格配置、自定义查询参数、多种插槽、级联/树形选择等能力
+- 🐛 场景与列配置相关问题修复
+- 📚 TypeScript 类型与文档示例完善

package/README.md

@@ -445,8 +445,12 @@ export const createFormItems = () => {
 | tooltip      | string/boolean/function | -      | 内容提示信息                        |
 | component    | Component               | -      | 自定义组件（type为component时必填） |
 | props        | object/function         | {}     | 传递给组件的属性                    |
+| dataIndex    | string                  | -      | 数据字段路径（与 customRender 组合时优先于 content） |
+| customRender | function                | -      | 自定义渲染（优先级高于 content）    |
 | width        | number                  | 120    | 列宽度                              |
 | visible      | boolean                 | true   | 是否可见                            |
+| showInExpand | boolean                 | true   | 当 visible=false 且开启 showHiddenColumnsInExpand 时，是否展示在展开区 |
+| expandItemProps | object               | {}     | 透传给 `a-descriptions-item` 的属性（如 label/span/style） |
 | fixed        | string                  | -      | 固定列位置，可选 'left' 或 'right'  |
 | copyable     | boolean                 | false  | 是否可复制                          |
 | ellipsis     | boolean                 | true   | 是否超出显示省略号                  |
@@ -639,6 +643,29 @@ const onRowSortEnd = newData => {
 </template>
 ```
 
+### 自定义 locale / theme
+
+```vue
+<script setup lang="ts">
+import enUS from 'ant-design-vue/es/locale/en_US'
+</script>
+
+<template>
+  <SuperTable
+    :form-items="formItems"
+    :columns="columns"
+    :request="onRequest"
+    :locale="enUS"
+    :theme="{
+      token: {
+        colorPrimary: '#1677ff',
+        borderRadius: 6,
+      },
+    }"
+  />
+</template>
+```
+
 ### 关闭场景，仅使用高级筛选
 
 ```vue
@@ -653,6 +680,20 @@ const onRowSortEnd = newData => {
 </template>
 ```
 
+### 隐藏列在展开区展示
+
+```vue
+<template>
+  <SuperTable
+    :form-items="formItems"
+    :columns="columns"
+    :request="onRequest"
+    :show-hidden-columns-in-expand="true"
+    :expand-descriptions-props="{ bordered: true, column: 2, labelStyle: { width: '150px' } }"
+  />
+</template>
+```
+
 ### 插槽使用
 
 ```vue
@@ -673,11 +714,17 @@ const onRowSortEnd = newData => {
       <h3>用户列表</h3>
     </template>
 
-    <!-- 工具栏 -->
-    <template #toolBar>
+    <!-- 工具栏额外区域 -->
+    <template #toolBarExtra>
       <a-button type="primary">新增用户</a-button>
     </template>
 
+    <!-- 查询条件行操作区扩展（与查询/重置/展开等同一行右侧，`enableScene=false` 时常见） -->
+    <template #searchActionsExtra="{ search, reset, loading }">
+      <a-button :loading="loading" @click="search">扩展查询</a-button>
+      <a-button @click="reset">扩展重置</a-button>
+    </template>
+
     <!-- 表格底部 -->
     <template #tableFoot>
       <div>总计: {{ total }} 条数据</div>
@@ -711,13 +758,20 @@ const onRowSortEnd = newData => {
 | debounceWait         | 查询防抖时间(ms)                 | `number`                      | `100`                           |
 | refreshDeps          | 依赖刷新选项                     | `any[]`                       | `[]`                            |
 | tableProps           | 表格属性                         | `TableProps`                  | `{}`                            |
+| locale               | ConfigProvider locale 配置       | `object`                      | `zhCN`                          |
+| theme                | ConfigProvider theme 配置        | `object`                      | `{ token: { borderRadius: 2 } }` |
 | formatDataSource     | 转换表格数据                     | `(data: any[]) => any[]`      | `(data) => data`                |
 | sortable             | 是否可排序                       | `boolean`                     | `false`                         |
 | wrapperStyle         | 容器样式                         | `object`                      | `{}`                            |
 | tableWrapperStyle    | 表格容器样式                     | `object`                      | `{}`                            |
 | customQueryParams    | 默认查询条件                     | `object`                      | `{}`                            |
 | autoSearch           | 是否自动发起查询                 | `boolean`                     | `true`                          |
-| showRefreshButton    | 展示刷新按钮                     | `boolean`                     | `false`                         |
+| searchOnFormItemChange | 表单项变更后是否自动触发查询（`quiet` 项除外） | `boolean`              | `true`                          |
+| showHiddenColumnsInExpand | 是否将隐藏列展示在展开区域   | `boolean`                     | `false`                         |
+| expandDescriptionsProps | 展开区域 `a-descriptions` 属性透传 | `object`                  | `{}`                            |
+| showRefreshButton    | 展示刷新按钮（依赖场景区域）     | `boolean`                     | `false`                         |
+| showExpandButton     | 查询条件是否展示展开/收起        | `boolean`                     | `false`                         |
+| showResetButton      | 是否展示重置（仅 `enableScene=false` 时生效；未传时非场景下默认展示） | `boolean \| undefined` | `undefined` |
 | enableTableConfig    | 开启表格设置                     | `boolean`                     | `true`                          |
 
 ### Events
@@ -1046,77 +1100,4 @@ export interface SuperTableAntdProps extends TableProps {
 
 ## 更新日志
 
-### v0.1.12
-
-- ✨ 查询项 `input` 新增 `addonAfter`：支持 `link + small` 按钮、`className` 和点击回调
-- ⚙️ 新增 `autoSearch`：支持在 `enableScene=false` 时关闭自动请求，仅手动查询
-- 🔒 `customQueryParams` 行为增强：切换场景后仍在请求阶段持续生效
-- 🧩 新增 `enableAdvancedFilter`：支持不开场景时独立使用“高级筛选”弹窗
-- 💄 查询项拼接边框样式优化：减少 `label + input/inputNumber` 的视觉缝隙
-- 📝 详细变更记录见 [CHANGELOG.md](./CHANGELOG.md)
-
-### v0.1.10
-
-- ✨ 新增列级自定义单元格插槽能力：支持在列配置中通过 `slotName` 指定外层具名插槽渲染
-- 🔁 渲染优先级优化：命中 `slotName` 时优先插槽渲染，未命中时继续使用原有 `type/component` 渲染
-- 🎨 样式优化：自定义插槽单元格新增容器，并默认 `white-space: normal` 以支持多行内容展示
-- ✨ 查询条件新增 `tooltip`（`string | number`）能力：主页面与场景弹窗均支持 icon 悬浮提示（默认 top）
-- 🎯 场景弹窗 tooltip 区域宽度统一预留：无 tooltip 时不展示 icon，但保留占位，避免布局抖动
-- 🧩 示例补充：新增 `slotName` 列配置与多行列表插槽示例（含 badge/button/tag 等非纯文本元素）
-- 📝 详细变更记录见 [CHANGELOG.md](./CHANGELOG.md)
-
-### v0.0.7
-
-- 🔄 **重构场景管理API**：
-  - 将 `sceneRequestUrls` 重构为 `sceneRequest`
-  - 从传递URL字符串改为传递请求函数，提供更大的灵活性
-  - 支持自定义请求逻辑、错误处理和认证机制
-- 🔧 **优化错误处理**：
-  - 当 `sceneStorageType` 为 `'api'` 但未提供 `sceneRequest` 时，提供清晰的错误提示
-  - 实现优雅降级，避免应用崩溃
-- 🗑️ **移除冗余代码**：
-  - 删除 `apiSceneService` 中间层，直接使用 `sceneRequest`
-  - 简化架构，提高代码可维护性
-- 📚 **完善文档**：
-  - 更新API文档和类型定义
-  - 添加详细的配置示例和错误处理说明
-  - 提供本地存储和API存储两种模式的完整示例
-- 🖼️ **修复文档图片**：
-  - 修复 npm 包中示例图片无法显示的问题
-  - 使用 CDN 方式确保图片在不同平台都能正确显示
-
-### v0.0.6
-
-- 🐛 修复场景管理相关问题
-- 🐛 修复表格列配置缓存问题
-- 💄 优化UI样式和交互体验
-
-### v0.0.2
-
-- ✨ 新增表格拖拽排序功能
-- ✨ 新增表格配置功能
-- ✨ 新增自定义查询参数支持
-- ✨ 新增多种插槽支持
-- ✨ 新增级联选择和树形选择组件
-- 🐛 修复场景管理相关问题
-- 🐛 修复表格列配置缓存问题
-- 💄 优化UI样式和交互体验
-- 📚 完善TypeScript类型定义
-- 📚 更新文档和示例代码
-
-## 更新记录
-
-### 0.1.6
-
-- 🐛 **修复依赖问题**：将 `jsonpath-plus` 从 `optionalDependencies` 移到 `dependencies`，解决其他项目使用 `npm ci` 时的依赖缺失问题
-- ✨ **优化场景初始化**：当没有选中过场景 code 且有默认场景时，自动选中默认场景并触发查询
-- 📝 **示例代码优化**：
-  - 添加默认场景配置示例
-  - 新增清空缓存功能
-  - 场景功能默认开启
-
-### 0.1.2
-
-- 新增 `tableWrapperStyle` 属性，支持自定义表格容器样式。
-- 修复 `toolBarExtra` 插槽在未提供 `tableHead` 时无法展示的问题。
-- 修复 `rowKey` 为函数时构建声明文件的类型错误。
+版本与变更说明统一在 **[CHANGELOG.md](./CHANGELOG.md)** 维护；发版时请更新该文件，避免与本文重复。

package/dist/SuperTable.vue.d.ts

@@ -1,7 +1,7 @@
 import 'dayjs/locale/zh-cn';
 import type { PropType } from 'vue';
 import type { TableProps } from 'ant-design-vue';
-import type { SuperTableFormItem, SuperTableColumn, SuperTableRequestFunction, SuperTableDefaultSceneConfig, SuperTableSceneRequestConfig, SuperTableSlots } from './interface';
+import type { SuperTableFormItem, SuperTableColumn, SuperTableDataItem, SuperTableRequestFunction, SuperTableDefaultSceneConfig, SuperTableSceneRequestConfig, SuperTableSlots } from './interface';
 type __VLS_Slots = SuperTableSlots;
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     /**
@@ -27,6 +27,11 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: NumberConstructor;
         default: number;
     };
+    /** 表单项变更后是否自动触发搜索（未配置时沿用 enableScene 行为） */
+    searchOnFormItemChange: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** 查询条件配置 */
     formItems: {
         type: PropType<SuperTableFormItem[]>;
@@ -62,6 +67,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: PropType<TableProps>;
         default: () => {};
     };
+    /** ConfigProvider locale 配置 */
+    locale: {
+        type: PropType<Record<string, any>>;
+        default: undefined;
+    };
+    /** ConfigProvider theme 配置 */
+    theme: {
+        type: PropType<Record<string, any>>;
+        default: undefined;
+    };
     /** 转换表格数据 */
     formatDataSource: {
         type: PropType<(data: any[]) => any[]>;
@@ -102,6 +117,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 是否将隐藏列自动展示在展开区域 */
+    showHiddenColumnsInExpand: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 展开区域 Descriptions 组件属性 */
+    expandDescriptionsProps: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
     /**
      * 是否显示展开/收起按钮
      * 默认 false，可通过开关控制，不受 enableScene 影响
@@ -144,9 +169,9 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     onRefresh: (force?: boolean) => void;
     onResetForm: () => void;
     isInitialized: import("vue").Ref<boolean, boolean>;
-    getTableData(): import("./interface").SuperTableDataItem[];
-    setTableData(data: import("./interface").SuperTableDataItem[]): void;
-    setTableDataItem(index: number, data: Partial<import("./interface").SuperTableDataItem>): void;
+    getTableData(): SuperTableDataItem[];
+    setTableData(data: SuperTableDataItem[]): void;
+    setTableDataItem(index: number, data: Partial<SuperTableDataItem>): void;
     getFormItem(name: string): SuperTableFormItem | undefined;
     setFormItem(name: string, keyPath: string, newConfig: any): void;
     getFormValues(name?: string | string[]): Record<string, any>;
@@ -186,6 +211,11 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: NumberConstructor;
         default: number;
     };
+    /** 表单项变更后是否自动触发搜索（未配置时沿用 enableScene 行为） */
+    searchOnFormItemChange: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** 查询条件配置 */
     formItems: {
         type: PropType<SuperTableFormItem[]>;
@@ -221,6 +251,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: PropType<TableProps>;
         default: () => {};
     };
+    /** ConfigProvider locale 配置 */
+    locale: {
+        type: PropType<Record<string, any>>;
+        default: undefined;
+    };
+    /** ConfigProvider theme 配置 */
+    theme: {
+        type: PropType<Record<string, any>>;
+        default: undefined;
+    };
     /** 转换表格数据 */
     formatDataSource: {
         type: PropType<(data: any[]) => any[]>;
@@ -261,6 +301,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 是否将隐藏列自动展示在展开区域 */
+    showHiddenColumnsInExpand: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 展开区域 Descriptions 组件属性 */
+    expandDescriptionsProps: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
     /**
      * 是否显示展开/收起按钮
      * 默认 false，可通过开关控制，不受 enableScene 影响
@@ -310,7 +360,9 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "onResize-column"?: ((width: number, column: SuperTableColumn) => any) | undefined;
 }>, {
     columns: SuperTableColumn[];
+    theme: Record<string, any>;
     sortable: boolean;
+    locale: Record<string, any>;
     formItems: SuperTableFormItem[];
     formItemColSpan: number;
     enableScene: boolean;
@@ -319,6 +371,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     sceneType: string;
     maxSceneCount: number;
     debounceWait: number;
+    searchOnFormItemChange: boolean;
     refreshDeps: unknown[];
     autoSearch: boolean;
     tableProps: TableProps<any>;
@@ -328,6 +381,8 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     customQueryParams: Record<string, any>;
     showRefreshButton: boolean;
     enableAdvancedFilter: boolean;
+    showHiddenColumnsInExpand: boolean;
+    expandDescriptionsProps: Record<string, any>;
     defaultScene: SuperTableDefaultSceneConfig | SuperTableDefaultSceneConfig[];
     sceneStorageType: "local" | "api";
     sceneRequest: SuperTableSceneRequestConfig;

package/dist/components/EllipsisElement.vue.d.ts

@@ -2,6 +2,7 @@ import { DownOutlined } from '@ant-design/icons-vue';
 import { SuperTableColumnTypeEnum } from '../config';
 import type { PropType } from 'vue';
 import type { SuperTableDataItem, SuperTableColumnType } from '../interface';
+declare const resolvedFlexDirection: import("vue").ComputedRef<"row" | "column">;
 /**
  * 展示出来的节点列表
  * @returns {Record<string, any>[]} 可见的节点列表
@@ -34,14 +35,22 @@ declare const __VLS_ctx: {
         "elementItem": string;
     } & {
         "ellipsisElementHasGap": string;
+    } & {
+        "ellipsisElementVertical": string;
+    } & {
+        "elementItem": string;
     } & {
         "flexWrap": string;
     } & {
         "ellipsisTag": string;
+    } & {
+        "ellipsisTagAutoWidth": string;
     } & {
         "imageEllipsisTag": string;
     } & {
         "ellipsisList": string;
+    } & {
+        "ellipsisListVertical": string;
     }>;
     $: import("vue").ComponentInternalInstance;
     $data: {};
@@ -52,6 +61,8 @@ declare const __VLS_ctx: {
         maxCount: number;
         displayType: string;
         trigger: string | unknown[];
+        flexDirection: "row" | "column";
+        layout: "horizontal" | "vertical";
     }> & Omit<{
         readonly type: SuperTableColumnType;
         readonly record: SuperTableDataItem;
@@ -60,7 +71,9 @@ declare const __VLS_ctx: {
         readonly maxCount: number;
         readonly displayType: string;
         readonly trigger: string | unknown[];
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, "type" | "cellWidth" | "list" | "maxCount" | "displayType" | "trigger">;
+        readonly flexDirection: "row" | "column";
+        readonly layout?: "horizontal" | "vertical" | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, "type" | "cellWidth" | "list" | "maxCount" | "displayType" | "trigger" | "flexDirection" | "layout">;
     $attrs: {
         [x: string]: unknown;
     };
@@ -138,9 +151,27 @@ declare const __VLS_ctx: {
             type: (StringConstructor | ArrayConstructor)[];
             default: string;
         };
+        /**
+         * 列表排布方向
+         * @type {'row' | 'column'}
+         * @default 'row'
+         */
+        flexDirection: {
+            type: PropType<"row" | "column">;
+            default: string;
+        };
+        /**
+         * 兼容字段（不推荐）
+         * @deprecated 请使用 flexDirection
+         */
+        layout: {
+            type: PropType<"horizontal" | "vertical">;
+            default: undefined;
+        };
     }>> & Readonly<{}>, {
         DownOutlined: typeof DownOutlined;
         SuperTableColumnTypeEnum: typeof SuperTableColumnTypeEnum;
+        resolvedFlexDirection: typeof resolvedFlexDirection;
         visibleList: typeof visibleList;
         ellipsisList: typeof ellipsisList;
         ellipsisMenuItems: typeof ellipsisMenuItems;
@@ -152,6 +183,8 @@ declare const __VLS_ctx: {
         maxCount: number;
         displayType: string;
         trigger: string | unknown[];
+        flexDirection: "row" | "column";
+        layout: "horizontal" | "vertical";
     }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & {
         beforeCreate?: (() => void) | (() => void)[];
         created?: (() => void) | (() => void)[];
@@ -178,9 +211,12 @@ declare const __VLS_ctx: {
     maxCount: number;
     displayType: string;
     trigger: string | unknown[];
+    flexDirection: "row" | "column";
+    layout: "horizontal" | "vertical";
     record: SuperTableDataItem;
     DownOutlined: typeof DownOutlined;
     SuperTableColumnTypeEnum: typeof SuperTableColumnTypeEnum;
+    resolvedFlexDirection: "row" | "column";
     visibleList: Record<string, any>[];
     ellipsisList: Record<string, any>[];
     ellipsisMenuItems: {
@@ -267,6 +303,23 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: (StringConstructor | ArrayConstructor)[];
         default: string;
     };
+    /**
+     * 列表排布方向
+     * @type {'row' | 'column'}
+     * @default 'row'
+     */
+    flexDirection: {
+        type: PropType<"row" | "column">;
+        default: string;
+    };
+    /**
+     * 兼容字段（不推荐）
+     * @deprecated 请使用 flexDirection
+     */
+    layout: {
+        type: PropType<"horizontal" | "vertical">;
+        default: undefined;
+    };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     /**
      * 当前行数据
@@ -330,6 +383,23 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: (StringConstructor | ArrayConstructor)[];
         default: string;
     };
+    /**
+     * 列表排布方向
+     * @type {'row' | 'column'}
+     * @default 'row'
+     */
+    flexDirection: {
+        type: PropType<"row" | "column">;
+        default: string;
+    };
+    /**
+     * 兼容字段（不推荐）
+     * @deprecated 请使用 flexDirection
+     */
+    layout: {
+        type: PropType<"horizontal" | "vertical">;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
     type: SuperTableColumnType;
     cellWidth: number;
@@ -337,6 +407,8 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     maxCount: number;
     displayType: string;
     trigger: string | unknown[];
+    flexDirection: "row" | "column";
+    layout: "horizontal" | "vertical";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;