@vtable-guild/vtable-guild 2.0.5 → 2.1.0

package/dist/table/src/index.d.ts

@@ -0,0 +1,198 @@
+import { SELECTION_ALL, SELECTION_INVERT, SELECTION_NONE, EXPAND_COLUMN, SELECTION_COLUMN } from './constants';
+declare const VTable: (<TRecord extends object = Record<string, unknown>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+    slots: Readonly<import('../../vtable-guild/src/index.ts').TableSlotsDecl<TRecord>> & import('../../vtable-guild/src/index.ts').TableSlotsDecl<TRecord>;
+    attrs: any;
+    emit: ((evt: "change", filters: import('../../vtable-guild/src/index.ts').TableFiltersInfo, sorter: import('../../vtable-guild/src/index.ts').VTableSorterResult<TRecord>, extra: import('../../vtable-guild/src/index.ts').TableChangeExtra<TRecord>) => void) & ((evt: "resizeColumn", column: import('../../vtable-guild/src/index.ts').ColumnType<TRecord>, width: number) => void);
+}, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: {
+        readonly onChange?: ((filters: import('../../vtable-guild/src/index.ts').TableFiltersInfo, sorter: import('../../vtable-guild/src/index.ts').VTableSorterResult<TRecord>, extra: import('../../vtable-guild/src/index.ts').TableChangeExtra<TRecord>) => any) | undefined;
+        readonly onResizeColumn?: ((column: import('../../vtable-guild/src/index.ts').ColumnType<TRecord>, width: number) => any) | undefined;
+        dataSource: TRecord[];
+        columns: import('../../vtable-guild/src/index.ts').ColumnsType<TRecord>;
+        rowKey?: string | ((record: TRecord) => import('../../vtable-guild/src/index.ts').Key) | undefined;
+        loading?: boolean | {
+            spinning?: boolean;
+            indicator?: import('vue').VNodeChild;
+            tip?: string;
+        } | undefined;
+        size?: "small" | "middle" | "large" | undefined;
+        bordered?: boolean | undefined;
+        striped?: boolean | undefined;
+        hoverable?: boolean | undefined;
+        ui?: import('../../core/src/index.ts').SlotProps<{
+            slots: Record<import('../../theme/src/index.ts').TableSlots, string>;
+        }> | undefined;
+        class?: string | undefined;
+        tableLayout?: import('./types').TableLayout | undefined;
+        showHeader?: boolean | undefined;
+        headerEllipsis?: boolean | undefined;
+        rowClassName?: string | import('./types').RowClassName<TRecord> | undefined;
+        customRow?: import('./types').GetComponentProps<TRecord> | undefined;
+        customHeaderRow?: ((columns: (import('../../vtable-guild/src/index.ts').ColumnType<TRecord> | import('../../vtable-guild/src/index.ts').ColumnGroupType<TRecord>)[], index?: number) => import('../../vtable-guild/src/index.ts').CellAdditionalProps) | undefined;
+        showSorterTooltip?: boolean | undefined;
+        sortDirections?: import('../../vtable-guild/src/index.ts').SortOrder[] | undefined;
+        locale?: import('../../core/src/index.ts').LocaleName | undefined;
+        locales?: import('../../core/src/index.ts').LocaleRegistry | undefined;
+        localeOverrides?: import('../../core/src/index.ts').DeepPartial<import('../../core/src/index.ts').VTableGuildTableLocale> | undefined;
+        sticky?: (boolean | import('./types').TableSticky) | undefined;
+        getPopupContainer?: ((triggerNode: HTMLElement) => HTMLElement) | undefined;
+        transformCellText?: import('./types').TransformCellText<TRecord> | undefined;
+        rowSelection?: import('../../vtable-guild/src/index.ts').RowSelection<TRecord> | undefined;
+        expandable?: import('../../vtable-guild/src/index.ts').Expandable<TRecord> | undefined;
+        title?: ((data: TRecord[]) => import('vue').VNodeChild) | undefined;
+        footer?: ((data: TRecord[]) => import('vue').VNodeChild) | undefined;
+        scroll?: {
+            x?: number | string;
+            y?: number | string;
+        } | undefined;
+        virtual?: boolean | undefined;
+        childrenColumnName?: string | undefined;
+        indentSize?: number | undefined;
+        expandedRowKeys?: import('../../vtable-guild/src/index.ts').Key[] | undefined;
+        defaultExpandedRowKeys?: import('../../vtable-guild/src/index.ts').Key[] | undefined;
+        defaultExpandAllRows?: boolean | undefined;
+        onExpand?: ((expanded: boolean, record: TRecord) => void) | undefined;
+        onExpandedRowsChange?: ((expandedKeys: import('../../vtable-guild/src/index.ts').Key[]) => void) | undefined;
+    } & import('vue').PublicProps;
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: Readonly<import('../../vtable-guild/src/index.ts').TableSlotsDecl<TRecord>> & import('../../vtable-guild/src/index.ts').TableSlotsDecl<TRecord>;
+    emit: ((evt: "change", filters: import('../../vtable-guild/src/index.ts').TableFiltersInfo, sorter: import('../../vtable-guild/src/index.ts').VTableSorterResult<TRecord>, extra: import('../../vtable-guild/src/index.ts').TableChangeExtra<TRecord>) => void) & ((evt: "resizeColumn", column: import('../../vtable-guild/src/index.ts').ColumnType<TRecord>, width: number) => void);
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+}) & {
+    readonly SELECTION_ALL: "SELECT_ALL";
+    readonly SELECTION_INVERT: "SELECT_INVERT";
+    readonly SELECTION_NONE: "SELECT_NONE";
+    readonly EXPAND_COLUMN: typeof EXPAND_COLUMN;
+    readonly SELECTION_COLUMN: typeof SELECTION_COLUMN;
+};
+declare const VTableSummary: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        fixed: {
+            type: import('vue').PropType<import('../../vtable-guild/src/index.ts').SummaryFixed>;
+            default: undefined;
+        };
+    }>> & Readonly<{}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+        [key: string]: any;
+    }>[] | undefined, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+        fixed: import('../../vtable-guild/src/index.ts').SummaryFixed;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        fixed: {
+            type: import('vue').PropType<import('../../vtable-guild/src/index.ts').SummaryFixed>;
+            default: undefined;
+        };
+    }>> & Readonly<{}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+        [key: string]: any;
+    }>[] | undefined, {}, {}, {}, {
+        fixed: import('../../vtable-guild/src/index.ts').SummaryFixed;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    fixed: {
+        type: import('vue').PropType<import('../../vtable-guild/src/index.ts').SummaryFixed>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+    fixed: import('../../vtable-guild/src/index.ts').SummaryFixed;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & {
+    Row: import('vue').DefineComponent<{}, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+    Cell: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        index: {
+            type: NumberConstructor;
+            required: true;
+        };
+        colSpan: {
+            type: NumberConstructor;
+            default: number;
+        };
+        rowSpan: {
+            type: NumberConstructor;
+            default: undefined;
+        };
+        align: {
+            type: import('vue').PropType<import('../../vtable-guild/src/index.ts').AlignType>;
+            default: undefined;
+        };
+    }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        index: {
+            type: NumberConstructor;
+            required: true;
+        };
+        colSpan: {
+            type: NumberConstructor;
+            default: number;
+        };
+        rowSpan: {
+            type: NumberConstructor;
+            default: undefined;
+        };
+        align: {
+            type: import('vue').PropType<import('../../vtable-guild/src/index.ts').AlignType>;
+            default: undefined;
+        };
+    }>> & Readonly<{}>, {
+        align: import('../../vtable-guild/src/index.ts').AlignType;
+        colSpan: number;
+        rowSpan: number;
+    }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+};
+declare const VTableSummaryRow: import('vue').DefineComponent<{}, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const VTableSummaryCell: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    index: {
+        type: NumberConstructor;
+        required: true;
+    };
+    colSpan: {
+        type: NumberConstructor;
+        default: number;
+    };
+    rowSpan: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    align: {
+        type: import('vue').PropType<import('../../vtable-guild/src/index.ts').AlignType>;
+        default: undefined;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    index: {
+        type: NumberConstructor;
+        required: true;
+    };
+    colSpan: {
+        type: NumberConstructor;
+        default: number;
+    };
+    rowSpan: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    align: {
+        type: import('vue').PropType<import('../../vtable-guild/src/index.ts').AlignType>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    align: import('../../vtable-guild/src/index.ts').AlignType;
+    colSpan: number;
+    rowSpan: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export { VTable, VTableSummary, VTableSummaryRow, VTableSummaryCell, SELECTION_ALL, SELECTION_INVERT, SELECTION_NONE, EXPAND_COLUMN, SELECTION_COLUMN, };
+export type { Key, AlignType, Breakpoint, DataIndex, CellAdditionalProps, CustomRenderContext, RenderedCell, ColumnType, ColumnType as TableColumnType, ColumnGroupType, ColumnGroupType as TableColumnGroupType, ColumnsType, ColumnsType as TableColumnsType, SortOrder, SorterFn, ColumnSorter, ColumnFilterItem, TableProps, TableBodyCellSlotProps, TableHeaderCellSlotProps, TableDataSlotProps, TableSlotsDecl, CustomFilterDropdownSlotProps, TableFiltersInfo, TableChangeExtra, VTableSorterResult, VTableEventProps, VTablePublicProps, VTableComponent, RowSelection, RowSelectionType, SelectionItem, SelectionSentinel, ColumnSentinel, ExpandColumnSentinel, SelectionColumnSentinel, Expandable, } from './types';
+export type { SummaryFixed } from './components/VTableSummary';
+export type { VTableGuildTableLocale } from '../../core/src/index.ts';
+export { useColumns, getByDataIndex } from './composables';
+export type { SorterResult, SelectionState } from './composables';
+export type { FlattenRow } from './composables/useTreeData';
+//# sourceMappingURL=index.d.ts.map

package/dist/table/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../table/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAKpB,QAAA,MAAM,MAAM;;;;;;;;;;;;oBAoEsvG,CAAC;qBAAoB,CAAC;eAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAAkqD,CAAC;aAAoB,CAAC;;;;;;;;;;;;;;;;SAAypM,CAAC;;;;;;;CA9DjnW,CAAA;AACX,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiB,CAAA;AACpC,QAAA,MAAM,gBAAgB,wTAAoB,CAAA;AAC1C,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAAqB,CAAA;AAE5C,OAAO,EACL,MAAM,EACN,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,CAAA;AAED,YAAY,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,UAAU,IAAI,eAAe,EAC7B,eAAe,EACf,eAAe,IAAI,oBAAoB,EACvC,WAAW,EACX,WAAW,IAAI,gBAAgB,EAC/B,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAEhE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC1D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/table/src/preset-config.d.ts

@@ -0,0 +1,14 @@
+import { Component } from 'vue';
+import { ThemePresetName } from '../../core/src/index.ts';
+export interface TablePresetConfig {
+    sortAscIcon: Component;
+    sortDescIcon: Component;
+    filterIcon: Component;
+    filterSingleSelectMode: 'radio' | 'highlight';
+    showSorterTooltip: boolean;
+    emptyIcon?: Component;
+    loadingIcon: Component;
+}
+export declare const tablePresetConfigs: Record<ThemePresetName, TablePresetConfig>;
+export declare function resolveTablePresetConfig(name?: ThemePresetName): TablePresetConfig;
+//# sourceMappingURL=preset-config.d.ts.map

package/dist/table/src/preset-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-config.d.ts","sourceRoot":"","sources":["../../../../table/src/preset-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAazD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,SAAS,CAAA;IACtB,YAAY,EAAE,SAAS,CAAA;IACvB,UAAU,EAAE,SAAS,CAAA;IACrB,sBAAsB,EAAE,OAAO,GAAG,WAAW,CAAA;IAC7C,iBAAiB,EAAE,OAAO,CAAA;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,WAAW,EAAE,SAAS,CAAA;CACvB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAkBzE,CAAA;AAED,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,eAAyB,GAAG,iBAAiB,CAE3F"}

package/dist/table/src/types/column.d.ts

@@ -0,0 +1,234 @@
+import { CSSProperties, VNodeChild } from 'vue';
+import { CustomFilterDropdownSlotProps } from './table';
+import { ColumnSentinel } from '../constants';
+/** 行唯一标识 */
+export type Key = string | number;
+/** 对齐方式 */
+export type AlignType = 'left' | 'center' | 'right';
+/** 排序方向 */
+export type SortOrder = 'ascend' | 'descend' | null;
+/** 排序器：布尔值表示使用默认排序，函数表示自定义比较 */
+export type SorterFn<TRecord = Record<string, any>> = (a: TRecord, b: TRecord) => number;
+export interface ColumnSorterObject<TRecord = Record<string, any>> {
+    compare?: SorterFn<TRecord>;
+    multiple?: number;
+}
+export type ColumnSorter<TRecord = Record<string, any>> = boolean | SorterFn<TRecord> | ColumnSorterObject<TRecord>;
+export type Breakpoint = 'xxxl' | 'xxl' | 'xl' | 'lg' | 'md' | 'sm' | 'xs';
+export type TableLayout = 'auto' | 'fixed';
+export type RowClassName<TRecord = Record<string, any>> = (record: TRecord, index: number, indent: number) => string;
+export interface TableSticky {
+    offsetHeader?: number;
+    offsetSummary?: number;
+    offsetScroll?: number;
+    getContainer?: () => Window | HTMLElement;
+}
+export type TransformCellText<TRecord extends object = Record<string, any>> = (opt: {
+    text: unknown;
+    column: ColumnType<TRecord>;
+    record: TRecord;
+    index: number;
+}) => unknown;
+export interface CellAdditionalProps {
+    class?: string;
+    className?: string;
+    style?: CSSProperties;
+    colSpan?: number;
+    rowSpan?: number;
+    colspan?: number;
+    rowspan?: number;
+    onClick?: (event: MouseEvent) => void;
+    onMouseenter?: (event: MouseEvent) => void;
+    onMouseleave?: (event: MouseEvent) => void;
+    [key: string]: unknown;
+}
+export interface RenderedCell {
+    props?: CellAdditionalProps;
+    children?: VNodeChild;
+}
+export type GetComponentProps<TData, TRecord extends object = Record<string, any>> = (data: TData, index: number, column?: ColumnType<TRecord>) => CellAdditionalProps | undefined;
+export interface ColumnTitleProps<TRecord extends object = Record<string, any>> {
+    sortOrder?: SortOrder;
+    sortColumn?: ColumnType<TRecord>;
+    sortColumns?: Array<{
+        column: ColumnType<TRecord>;
+        order: SortOrder;
+    }>;
+    filters?: Record<string, (string | number | boolean)[] | null>;
+}
+export type ColumnTitle<TRecord extends object = Record<string, any>> = VNodeChild | ((props: ColumnTitleProps<TRecord>) => VNodeChild);
+/**
+ * 叶子列配置。
+ */
+export interface ColumnType<TRecord extends object = Record<string, any>> {
+    key?: Key;
+    title?: ColumnTitle<TRecord>;
+    dataIndex?: DataIndex;
+    width?: number | string;
+    align?: AlignType;
+    /**
+     * 单元格内容超出时省略并显示 tooltip。
+     * - `true`：省略 + 鼠标悬停显示完整内容
+     * - `{ showTitle: false }`：省略但不显示 tooltip（与 ant-design-vue 对齐）
+     */
+    ellipsis?: boolean | {
+        showTitle?: boolean;
+    };
+    className?: string;
+    colSpan?: number;
+    customRender?: (ctx: CustomRenderContext<TRecord>) => VNodeChild | RenderedCell;
+    customCell?: GetComponentProps<TRecord, TRecord>;
+    customHeaderCell?: GetComponentProps<ColumnType<TRecord> | ColumnGroupType<TRecord>, TRecord>;
+    /**
+     * 固定列。`'left'` / `'right'` 固定到对应侧；`true` 等价于 `'left'`（与 ant-design-vue 对齐）。
+     */
+    fixed?: 'left' | 'right' | true;
+    /** 是否可拖拽调整列宽 */
+    resizable?: boolean;
+    /** 最小列宽（拖拽调整时），默认 50 */
+    minWidth?: number;
+    /** 最大列宽（拖拽调整时） */
+    maxWidth?: number;
+    /**
+     * 排序器。
+     * - `true`：使用默认比较（字符串/数字自动判断）
+     * - `(a, b) => number`：自定义比较函数（与 Array.sort 签名一致）
+     * - 不传或 `undefined`：该列不可排序
+     */
+    sorter?: ColumnSorter<TRecord>;
+    /**
+     * 受控排序方向。
+     * 传入后组件不再自行管理排序状态，完全由外部控制。
+     */
+    sortOrder?: SortOrder;
+    /**
+     * 非受控默认排序方向。
+     * 仅在组件首次渲染时生效，后续由内部状态管理。
+     */
+    defaultSortOrder?: SortOrder;
+    /**
+     * 可用排序方向列表。
+     * 点击表头时按此数组循环切换。
+     * 默认 ['ascend', 'descend']（不含 null 则不回到"无排序"状态）。
+     */
+    sortDirections?: SortOrder[];
+    /**
+     * 筛选项列表。传入后该列表头显示筛选图标。
+     */
+    filters?: ColumnFilterItem[];
+    /**
+     * 筛选函数。返回 true 表示该行匹配当前筛选值。
+     * @param value - 当前选中的筛选值
+     * @param record - 行数据
+     */
+    onFilter?: (value: string | number | boolean, record: TRecord) => boolean;
+    /**
+     * 是否支持多选筛选。默认 true。
+     */
+    filterMultiple?: boolean;
+    /**
+     * 受控筛选值。传入后组件不再自行管理筛选状态。
+     */
+    filteredValue?: (string | number | boolean)[] | null;
+    /**
+     * 非受控默认筛选值。
+     */
+    defaultFilteredValue?: (string | number | boolean)[];
+    /**
+     * 自定义筛选下拉菜单。
+     * 设为 true 时，使用 Table 的 customFilterDropdown slot。
+     */
+    customFilterDropdown?: boolean;
+    /**
+     * 筛选搜索框。
+     * - `true`：使用默认搜索（text.includes(input)）
+     * - `(input, filter) => boolean`：自定义搜索函数
+     */
+    filterSearch?: boolean | ((input: string, filter: ColumnFilterItem) => boolean);
+    /**
+     * 筛选模式。
+     * - `'menu'`（默认）：平铺列表
+     * - `'tree'`：树形嵌套
+     */
+    filterMode?: 'menu' | 'tree';
+    /**
+     * 重置时是否恢复为 defaultFilteredValue 而非清空。
+     */
+    filterResetToDefaultFilteredValue?: boolean;
+    /**
+     * 受控筛选下拉可见性。
+     */
+    filterDropdownOpen?: boolean;
+    /**
+     * 筛选下拉可见性变化回调。
+     */
+    onFilterDropdownOpenChange?: (visible: boolean) => void;
+    /**
+     * 外部控制筛选高亮状态（不影响实际筛选逻辑）。
+     */
+    filtered?: boolean;
+    /**
+     * 自定义筛选图标渲染函数。
+     */
+    filterIcon?: (opt: {
+        filtered: boolean;
+    }) => VNodeChild;
+    /**
+     * 列级别自定义筛选下拉渲染函数。
+     * 优先级高于 customFilterDropdown slot。
+     */
+    filterDropdown?: VNodeChild | ((props: CustomFilterDropdownSlotProps<TRecord>) => VNodeChild);
+    /**
+     * 列级别控制是否显示排序 tooltip。
+     * 未设置时使用 Table 级别的 showSorterTooltip。
+     */
+    showSorterTooltip?: boolean;
+    /**
+     * 响应式可见断点。
+     * 当前屏幕命中任一断点时显示该列。
+     */
+    responsive?: Breakpoint[];
+}
+/**
+ * 数据索引路径
+ *
+ * - `'name'` - 直接取record.name
+ * - `['address', 'city']` — 取 record.address.city
+ */
+export type DataIndex = string | number | Array<string | number>;
+/**
+ * customRender 回调参数。
+ */
+export interface CustomRenderContext<TRecord extends object = Record<string, any>> {
+    /** 当前单元格的值（通过 dataIndex 取出） */
+    text: unknown;
+    /** 与 ant-design-vue 对齐的 value 别名 */
+    value: unknown;
+    /** 当前行数据 */
+    record: TRecord;
+    /** 行索引 */
+    index: number;
+    /** 当前渲染行索引 */
+    renderIndex: number;
+    /** 列配置 */
+    column: ColumnType<TRecord>;
+}
+/**
+ * 列组配置（含 children）。
+ */
+export interface ColumnGroupType<TRecord extends object = Record<string, any>> extends Omit<ColumnType<TRecord>, 'dataIndex' | 'customRender' | 'sorter' | 'sortOrder' | 'defaultSortOrder' | 'sortDirections' | 'filters' | 'onFilter' | 'filterMultiple' | 'filteredValue' | 'defaultFilteredValue' | 'customFilterDropdown' | 'filterSearch' | 'filterMode' | 'filterResetToDefaultFilteredValue' | 'filterDropdownOpen' | 'onFilterDropdownOpenChange' | 'filtered' | 'filterIcon' | 'filterDropdown'> {
+    children: Array<ColumnType<TRecord> | ColumnGroupType<TRecord>>;
+}
+/**
+ * columns prop 的类型。
+ */
+export type ColumnsType<TRecord extends object = Record<string, any>> = Array<ColumnType<TRecord> | ColumnGroupType<TRecord> | ColumnSentinel>;
+/**
+ * 筛选项。
+ */
+export interface ColumnFilterItem {
+    text: string;
+    value: string | number | boolean;
+    children?: ColumnFilterItem[];
+}
+//# sourceMappingURL=column.d.ts.map

package/dist/table/src/types/column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/column.ts"],"names":[],"mappings":"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"}

package/dist/table/src/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { Key, AlignType, Breakpoint, DataIndex, CellAdditionalProps, CustomRenderContext, RenderedCell, GetComponentProps, ColumnTitleProps, ColumnTitle, ColumnType, ColumnGroupType, ColumnsType, SortOrder, SorterFn, ColumnSorterObject, ColumnSorter, ColumnFilterItem, TableLayout, TableSticky, RowClassName, TransformCellText, } from './column';
+export type { ColumnType as TableColumnType } from './column';
+export type { ColumnGroupType as TableColumnGroupType } from './column';
+export type { ColumnsType as TableColumnsType } from './column';
+export type { TableProps, TableBodyCellSlotProps, TableHeaderCellSlotProps, TableDataSlotProps, TableSlotsDecl, CustomFilterDropdownSlotProps, TableFiltersInfo, SorterResultLike, TableChangeExtra, VTableSorterResult, VTableEventProps, VTablePublicProps, VTableComponent, RowSelection, RowSelectionType, SelectionItem, Expandable, } from './table';
+export type { SelectionSentinel, ColumnSentinel, ExpandColumnSentinel, SelectionColumnSentinel, } from '../constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/table/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAC7D,YAAY,EAAE,eAAe,IAAI,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACvE,YAAY,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE/D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,cAAc,CAAA"}