bw-pro-table 0.0.4 → 0.0.6

package/dist/types/BwProTable.vue.d.ts

@@ -1,8 +1,20 @@
 import { BwProTableProps, ProColumnType } from './types';
+/**
+ * Props 声明策略：仅声明 BwProTable 内部消费或需要名称映射的属性。
+ * 纯透传属性（scroll/sticky/customRow/class/style/showHeader/indentSize/tableLayout/
+ * customCell/customHeaderCell/defaultExpandAllRows 等）不再声明于此，
+ * 由 Vue $attrs 经 v-bind="$attrs" → BwProTableCore → <a-table> 自然流通。
+ *
+ * 保留声明但不在 $attrs 中透传的属性：
+ * - tableLocale: 名称映射，模板显式绑定 :locale="props.tableLocale"（antd 原生名为 locale）
+ * - expandedRowKeys/expandedRowRender: 通过 mergedExpandable 合并到 expandable 通道，消除二义性
+ * - loading/bordered/size/pagination/rowSelection/expandable/rowClassName/rowKey: 内部逻辑依赖
+ * - antd 原生 `title` 通过 $attrs 透传；工具栏标题使用 `toolbar.title` 配置
+ */
 interface Props extends BwProTableProps {
 }
 declare function fetchData(_retryCount?: number): Promise<void>;
-/** 清空所有跨页选择 */
+/** 清空所有选择（跨页/非跨页模式均生效） */
 declare function handleClearAllSelection(): void;
 declare var __VLS_7: {}, __VLS_19: {}, __VLS_42: {}, __VLS_45: {}, __VLS_59: string, __VLS_60: any;
 type __VLS_Slots = {} & {

package/dist/types/BwProTableCore.vue.d.ts

@@ -1,24 +1,47 @@
-import { ProColumnsType } from './types';
+import { ProColumnsType, ProColumnType } from './types';
 interface Props {
     columns: ProColumnsType;
     /** 行 key 属性名（与 ant-design-vue Table rowKey 语义一致，默认 'id'） */
     rowKey?: string;
-    loading?: boolean;
+    /** 加载态（兼容 antd Table loading 对象形式：{ spinning, tip }） */
+    loading?: boolean | {
+        spinning?: boolean;
+        tip?: string;
+    };
     errorMessage?: string;
     pagination?: false | Record<string, any>;
     onRetry?: () => void | Promise<void>;
     /** 全局空单元格占位符，优先级低于列级 emptyText */
     defaultEmptyText?: string;
+    /** antd 原生 customRow：自定义行属性（含 onClick 等事件） */
+    customRow?: (record: any, index: number) => Record<string, any>;
 }
-declare var __VLS_24: string, __VLS_25: any, __VLS_28: any, __VLS_36: {
+declare var __VLS_24: string, __VLS_25: any, __VLS_33: {
+    /** BwProTable 预渲染的默认内容（VNode），包含编辑组件/值类型渲染/空值处理 */
+    defaultContent: any;
+    /** 编辑态上下文 */
+    editing: {
+        isEditing: boolean;
+        isRowEditing: boolean;
+    };
+    /** 当前列 valueType（text/number/date/tag 等） */
+    valueType: import('./types').ValueType | undefined;
+    /** 当前单元格值是否为空（null/undefined/空字符串） */
+    isEmpty: boolean;
+    column: ProColumnType;
+    record: any;
+    index: number;
+    text: any;
+    value: any;
+}, __VLS_41: {
     column: any;
 };
 type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_24>]?: (props: typeof __VLS_25) => any;
 } & {
-    bodyCell?: (props: typeof __VLS_28) => any;
+    bodyCell?: (props: typeof __VLS_33) => any;
 } & {
-    headerCell?: (props: typeof __VLS_36) => any;
+    headerCell?: (props: typeof __VLS_41) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<Props, {
     retry: () => void;

package/dist/types/BwProTableSearch.vue.d.ts

@@ -1,27 +1,35 @@
-import { ProColumnsType } from './types';
+import { ProColumnsType, SearchConfig, SearchFieldConfig } from './types';
 interface Props {
-    columns: ProColumnsType;
+    /**
+     * 列定义（独立使用时的降级数据源、或向后兼容）。
+     * 当 searchFields 未提供时，自动从 columns 生成搜索字段。
+     */
+    columns?: ProColumnsType;
+    /**
+     * 已解析的搜索字段列表（由父组件 BwProTable 通过 useSearchFields 合并后传入）。
+     * 优先级高于 columns：传入后直接使用，不再从 columns 自动生成。
+     */
+    searchFields?: SearchFieldConfig[];
     /**
      * 搜索栏配置。true 启用（全部默认值），false 禁用。
      * 注意：当值为 boolean 时，内部通过 ?? 安全回退所有字段到默认值。
      */
-    searchConfig?: boolean | {
-        labelWidth?: number;
-        defaultCollapsed?: boolean;
-        resetText?: string;
-        searchText?: string;
-        collapsedCount?: number;
-        colon?: boolean;
-    };
+    searchConfig?: boolean | SearchConfig;
 }
 /**
- * 暴露给父组件：仅清空表单 UI，不触发 reset 事件。
+ * 收集非空表单值（过滤掉 undefined/null/''）。
+ * 修复 issue #14：key 使用 field.field 而非 col.dataIndex。
+ */
+declare function collectFormValues(): Record<string, any>;
+/**
+ * 暴露给父组件：仅清空/恢复表单 UI，不触发 reset 事件。
  * 用于父组件在外部重置搜索状态时同步清空表单渲染，
  * 避免触发多余的 onSearchReset → fetchData 调用。
  */
 declare function resetForm(): void;
 declare const __VLS_export: import('vue').DefineComponent<Props, {
     resetForm: typeof resetForm;
+    collectFormValues: typeof collectFormValues;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     search: (params: Record<string, any>) => any;
     reset: () => any;
@@ -30,14 +38,7 @@ declare const __VLS_export: import('vue').DefineComponent<Props, {
     onReset?: (() => any) | undefined;
 }>, {
     columns: ProColumnsType;
-    searchConfig: boolean | {
-        labelWidth?: number;
-        defaultCollapsed?: boolean;
-        resetText?: string;
-        searchText?: string;
-        collapsedCount?: number;
-        colon?: boolean;
-    };
+    searchConfig: boolean | SearchConfig;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/BwProTableToolbar.vue.d.ts

@@ -1,6 +1,6 @@
 import { ProColumnsType, PersistedColumnState } from './types';
 interface Props {
-    title?: string;
+    headerTitle?: string;
     loading?: boolean;
     hasFilters?: boolean;
     bordered?: boolean;

package/dist/types/composables/useSearchComponentMap.d.ts

@@ -0,0 +1,46 @@
+import { SearchComponentType, SearchFieldConfig } from '../types';
+/**
+ * valueType 到搜索控件类型的映射。
+ * 当 searchField 未显式指定 component 时，通过此表自动匹配。
+ * 仅包含可搜索类型（非 UNSEARCHABLE_TYPES 成员）。
+ */
+export declare const VALUE_TYPE_TO_SEARCH_COMPONENT: Record<string, SearchComponentType>;
+/**
+ * 搜索控件类型到 ant-design-vue 组件标签的映射。
+ * 用于 <component :is="tag"> 动态渲染。
+ */
+export declare const SEARCH_COMPONENT_TAG_MAP: Record<SearchComponentType, string>;
+/**
+ * 判断指定的 SearchComponentType 是否为精确匹配控件。
+ * 用于 applyClientFilters 客户端筛选决定采用 === 匹配还是 includes 模糊匹配。
+ *
+ * 经由 VALUE_TYPE_TO_SEARCH_COMPONENT 映射链：所有非 input 组件均精确匹配。
+ */
+export declare function isExactMatchComponent(type: SearchComponentType): boolean;
+/**
+ * 根据 SearchFieldConfig 推断最终使用的搜索控件类型。
+ *
+ * 优先级链（从高到低）：
+ * 1. renderFormItem 存在 → custom（自定义渲染，不匹配标准组件）
+ * 2. component 显式指定 → 直接返回
+ * 3. valueType → VALUE_TYPE_TO_SEARCH_COMPONENT 映射
+ * 4. 兜底 → input
+ */
+export declare function resolveSearchComponent(field: SearchFieldConfig): SearchComponentType;
+/**
+ * 根据控件类型获取 antd 组件标签名。
+ */
+export declare function resolveComponentTag(type: SearchComponentType): string;
+/**
+ * 合并 SearchFieldConfig 属性与 componentProps，处理特殊组件逻辑。
+ *
+ * 属性优先级：field 单独属性 > componentProps 相同属性
+ * 特殊处理：
+ * - dateTimePicker: 自动追加 showTime: true
+ * - dateRangePicker: 自动追加 format（若未提供）
+ *
+ * @param field - 搜索字段配置
+ * @param defaultPlaceholder - 默认占位文本（从 locale 获取）
+ * @param defaultFormat - 默认日期格式（从全局配置获取，默认 'YYYY-MM-DD'）
+ */
+export declare function resolveComponentProps(field: SearchFieldConfig, defaultPlaceholder?: string, defaultFormat?: string): Record<string, any>;

package/dist/types/composables/useSearchFields.d.ts

@@ -0,0 +1,25 @@
+import { Ref } from 'vue';
+import { ProColumnsType, SearchConfig, SearchFieldConfig } from '../types';
+/**
+ * 将 dataIndex 归一化为字符串。
+ * ant-design-vue 支持 dataIndex 为数组（如 ['user', 'name'] 用于嵌套对象），
+ * 搜索表单 key 不支持嵌套路径，用 '.' 连接降级为平铺键名。
+ */
+export declare function normalizeDataIndex(dataIndex: unknown): string | undefined;
+/**
+ * 从列的 title 属性解析出纯文本 label。
+ * ant-design-vue 的 title 支持 string | VNode | (() => VNode) 三种形式。
+ * 无法解析时回退为 dataIndex。
+ */
+export declare function resolveColumnLabel(col: any, fallback: string): string;
+/**
+ * 将单个 ProColumnType 转换为 SearchFieldConfig（向后兼容的降级逻辑）
+ */
+export declare function columnToSearchField(col: any, index: number): SearchFieldConfig;
+/**
+ * 合并 searchFields 与 columns 自动生成字段
+ * @param columns - 表格列定义 Ref
+ * @param searchConfig - 搜索配置 Ref
+ * @returns 最终用于渲染的搜索字段列表 ComputedRef
+ */
+export declare function useSearchFields(columns: Ref<ProColumnsType>, searchConfig: Ref<SearchConfig | undefined>): import('vue').ComputedRef<SearchFieldConfig[]>;

package/dist/types/renderers/dateTime-renderer.d.ts

@@ -0,0 +1,6 @@
+import { RendererFn } from './registry';
+/**
+ * 日期时间渲染器 — valueType: 'dateTime'
+ * 自动 dayjs 格式化，默认 'YYYY-MM-DD HH:mm:ss'，可通过 column.dateTimeFormat 或 column.dateFormat 自定义
+ */
+export declare const dateTimeRenderer: RendererFn;

package/dist/types/types.d.ts

@@ -1,21 +1,24 @@
-import { VNode, CSSProperties } from 'vue';
+import { VNode } from 'vue';
 import { TableColumnType, TablePaginationConfig } from 'ant-design-vue';
 /** 行 key 获取函数 */
 export type GetRowKey<RecordType = any> = (record: RecordType, index?: number) => string | number;
-/** 行选择配置（对齐 ant-design-vue TableRowSelection 接口） */
+/** 行选择配置（对齐 ant-design-vue v4.2.6 TableRowSelection 接口） */
 export interface TableRowSelection<RecordType = any> {
     type?: 'checkbox' | 'radio';
     selectedRowKeys?: (string | number)[];
+    defaultSelectedRowKeys?: (string | number)[];
     onChange?: (selectedRowKeys: (string | number)[], selectedRows: RecordType[]) => void;
     getCheckboxProps?: (record: RecordType) => any;
     selections?: any[] | boolean;
     columnWidth?: number | string;
+    columnTitle?: string | VNode;
     fixed?: boolean;
     hideSelectAll?: boolean;
     preserveSelectedRowKeys?: boolean;
     checkStrictly?: boolean;
     renderCell?: (value: boolean, record: RecordType, index: number, originNode: VNode) => VNode;
     onSelect?: (record: RecordType, selected: boolean, selectedRows: RecordType[], nativeEvent: Event) => void;
+    onSelectMultiple?: (selected: boolean, selectedRows: RecordType[], changeRows: RecordType[]) => void;
     onSelectAll?: (selected: boolean, selectedRows: RecordType[], changeRows: RecordType[]) => void;
     onSelectInvert?: (selectedRowKeys: (string | number)[]) => void;
     onSelectNone?: () => void;
@@ -51,7 +54,7 @@ export type FilterValue = (string | number)[] | null;
 /** 行 Key 类型 */
 export type Key = string | number;
 /** 支持的 valueType 预设值 */
-export type ValueType = 'text' | 'number' | 'date' | 'tag' | 'image' | 'link' | 'progress' | 'avatar' | 'action' | 'index' | 'currency' | 'boolean';
+export type ValueType = 'text' | 'number' | 'date' | 'dateTime' | 'tag' | 'image' | 'link' | 'progress' | 'avatar' | 'action' | 'index' | 'currency' | 'boolean';
 /** valueEnum 映射定义 */
 export interface ValueEnumItem {
     text: string;
@@ -70,6 +73,66 @@ export interface HeaderSearchConfig {
     /** 重置按钮文本 */
     resetText?: string;
 }
+/** 支持的搜索控件类型枚举 */
+export type SearchComponentType = 'input' | 'select' | 'datePicker' | 'dateRangePicker' | 'dateTimePicker' | 'inputNumber' | 'switch' | 'radioGroup' | 'checkboxGroup' | 'cascader' | 'treeSelect' | 'custom';
+/**
+ * 搜索字段独立配置 — 支持脱离表格 column 独立定义搜索项。
+ *
+ * 核心契约: field 值将作为 key 出现在：
+ * 1. request 函数的 params 参数中
+ * 2. onExportAll 回调的 params 参数中
+ * 3. onSelectAllPages 回调的 searchParams 参数中
+ */
+export interface SearchFieldConfig {
+    /** 搜索参数字段名（对应 request 参数中的 key）@required */
+    field: string;
+    /** 搜索表单中的标签文本 @required */
+    label: string;
+    /** 控件类型枚举，显式指定时优先于 valueType 自动匹配 */
+    component?: SearchComponentType;
+    /** valueType 语义（复用表格列的类型体系），用于自动匹配搜索组件。优先级：component > valueType 映射 > 默认 input */
+    valueType?: ValueType | string;
+    /** 透传给对应 antd 组件的额外 props（如 select 的 options、mode 等） */
+    componentProps?: Record<string, any>;
+    /** 占位文本（dateRangePicker 等范围组件支持 [string, string]） */
+    placeholder?: string | string[];
+    /** 表单默认值（初始化 + 重置时恢复） */
+    defaultValue?: any;
+    /** 最高优先级自定义渲染（签名与 ProColumnType.renderFormItem 一致）。提供后完全接管该字段的搜索表单渲染 */
+    renderFormItem?: (context: {
+        model: Record<string, any>;
+        search: () => void;
+        resetField: (field: string) => void;
+    }) => VNode;
+    /** 排序权重（自定义字段默认 0，自动生成字段默认 1000+index，确保自定义在前） */
+    order?: number;
+    /** 折叠时始终显示（不参与 collapsedCount 截断计算） */
+    persistOnCollapse?: boolean;
+    /** 关联的表格列 dataIndex。设置后从该列继承 title/valueType 等配置，并阻止同名列自动生成搜索项 */
+    columnDataIndex?: string;
+    /** 是否启用 clear 按钮（默认 true） */
+    allowClear?: boolean;
+    /** 是否禁用（默认 false） */
+    disabled?: boolean;
+    /** 隐藏该搜索项（可与 v-if 配合使用） */
+    hidden?: boolean;
+    /** DataSource 模式下跳过客户端筛选，仅 Request 模式生效 */
+    serverOnly?: boolean;
+    /** DataSource 模式自定义筛选函数，优先于内置匹配策略 */
+    onFilter?: (value: any, record: any) => boolean;
+}
+/** 搜索配置（扩展原有 boolean | {...} 为结构化类型） */
+export interface SearchConfig {
+    labelWidth?: number;
+    defaultCollapsed?: boolean;
+    resetText?: string;
+    searchText?: string;
+    collapsedCount?: number;
+    /** 是否显示 label 后的冒号（默认 true，与 antd 一致） */
+    colon?: boolean;
+    /** 自定义搜索字段列表。未提供时降级为从 columns 自动生成（向后兼容） */
+    searchFields?: SearchFieldConfig[];
+}
 /** ProColumn 类型 — 在 ant-design-vue TableColumnType 基础上扩展 ProTable 特有字段 */
 export interface ProColumnType<RecordType = any> extends Omit<TableColumnType<RecordType>, 'children'> {
     /** 列类型预设值 */
@@ -78,6 +141,8 @@ export interface ProColumnType<RecordType = any> extends Omit<TableColumnType<Re
     valueEnum?: ValueEnumMap;
     /** 日期格式（valueType='date' 时生效） */
     dateFormat?: string;
+    /** 日期时间格式（valueType='dateTime' 时生效，默认 'YYYY-MM-DD HH:mm:ss'） */
+    dateTimeFormat?: string;
     /** 小数精度（valueType='number'/'currency' 时生效） */
     precision?: number;
     /** 货币前缀符号 */
@@ -132,6 +197,12 @@ export interface ProColumnType<RecordType = any> extends Omit<TableColumnType<Re
     hidden?: boolean;
     /** 是否在搜索栏中隐藏该列（默认 false，即显示在搜索栏中） */
     hideInSearch?: boolean;
+    /** 搜索栏占位文本（设置后该列自动生成的搜索项使用此值）。范围组件支持 [string, string] 格式 */
+    searchPlaceholder?: string | string[];
+    /** 搜索栏排序权重（设置后覆盖默认的 1000+index 基线，值越小越靠前） */
+    searchOrder?: number;
+    /** 搜索栏初始值/重置默认值（设置后该列自动生成的搜索项使用此值） */
+    initialValue?: any;
     /** 列所属分组 */
     columnGroup?: string;
     /** 列头搜索配置（true 或 HeaderSearchConfig 对象启用；仅对 valueType='text' 生效） */
@@ -510,20 +581,14 @@ export interface BwProTableProps<RecordType = any> {
     dataSource?: RecordType[];
     /** 行 key 属性 */
     rowKey?: string | GetRowKey<RecordType>;
-    /** 搜索栏配置。true 启用（全部默认值），false 禁用 */
-    search?: boolean | {
-        labelWidth?: number;
-        defaultCollapsed?: boolean;
-        resetText?: string;
-        searchText?: string;
-        collapsedCount?: number;
-        /** 是否显示 label 后的冒号（默认 true，与 antd 一致） */
-        colon?: boolean;
-    };
+    /** 搜索栏配置。true 启用（全部默认值），false 禁用，SearchConfig 启用含自定义搜索字段 */
+    search?: boolean | SearchConfig;
     /** 列头搜索全局配置（false 禁用所有列的 headerSearch，对象覆写默认值） */
     columnSearch?: false | HeaderSearchConfig;
     /** 工具栏配置 */
     toolbar?: false | {
+        /** 工具栏左侧标题文本（非 antd Table 原生 title，后者通过 $attrs 透传） */
+        title?: string;
         /** 是否显示边框切换开关（默认 true） */
         bordered?: boolean;
         /** 是否显示斑马纹切换开关（默认 true） */
@@ -543,8 +608,6 @@ export interface BwProTableProps<RecordType = any> {
     contextMenu?: ContextMenuConfig;
     /** 拖拽配置 */
     dragConfig?: DragConfig;
-    /** 表格标题 */
-    title?: string;
     /** 表格边框 */
     bordered?: boolean;
     /** 斑马纹 */
@@ -559,8 +622,13 @@ export interface BwProTableProps<RecordType = any> {
     persistence?: false | PersistenceConfig;
     /** 语言包（覆盖默认中文文案），传入部分字段即可完成局部覆写 */
     locale?: Partial<BwProTableLocale>;
-    /** 加载态 */
-    loading?: boolean;
+    /** 透传给 ant-design-vue Table 组件的原生 locale（如 Empty 组件文案），优先级高于 locale */
+    tableLocale?: Record<string, any>;
+    /** 加载态（兼容 antd Table loading 对象形式：{ spinning, tip }） */
+    loading?: boolean | {
+        spinning?: boolean;
+        tip?: string;
+    };
     /** 分页配置 */
     pagination?: false | TablePaginationConfig;
     /** 行选择 */
@@ -569,19 +637,21 @@ export interface BwProTableProps<RecordType = any> {
     crossPageSelection?: false | CrossPageSelectionConfig;
     /** 可展开行 */
     expandable?: ExpandableConfig<RecordType>;
-    /** 滚动 */
-    scroll?: {
-        x?: number | string | true;
-        y?: number | string;
-    };
-    /** 固定表头 */
-    sticky?: boolean | {
-        offsetHeader?: number;
-    };
-    /** 表格 CSS 类名 */
-    class?: string;
-    /** 表格样式 */
-    style?: CSSProperties;
+    /**
+     * 受控展开行 keys（与 expandable.expandedRowKeys 等价）。
+     * 统一收敛到 expandable 通道：expandable 配置内同名属性优先。
+     */
+    expandedRowKeys?: (string | number)[];
+    /**
+     * 展开行渲染函数（与 expandable.expandedRowRender 等价）。
+     * 统一收敛到 expandable 通道：expandable 配置内同名属性优先。
+     */
+    expandedRowRender?: (props: {
+        record: RecordType;
+        index: number;
+        indent: number;
+        expanded: boolean;
+    }) => VNode;
     /** 行 className 函数（覆盖内置斑马纹/选中行样式） */
     rowClassName?: (record: RecordType, index: number) => string;
 }

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "bw-pro-table",
-  "version": "0.0.4",
-  "author": {"name": "ZM"},
+  "version": "0.0.6",
+  "author": {
+    "name": "ZM"
+  },
   "description": "基于 ant-design-vue 的高级业务表格组件（ProTable），支持请求/数据源双模式、行内编辑、搜索筛选、列拖拽排序、导出导入、跨页多选、持久化等",
   "type": "module",
   "main": "./dist/bw-pro-table.umd.cjs",
@@ -64,19 +66,19 @@
   },
   "devDependencies": {
     "@ant-design/icons-vue": "^7.0.1",
-    "@types/node": "^26.0.0",
+    "@types/node": "^26.1.0",
     "@vitejs/plugin-vue": "^6.0.7",
-    "@vue/language-core": "^3.3.5",
+    "@vue/language-core": "^3.3.6",
     "ant-design-vue": "^4.2.6",
     "dayjs": "^1.11.21",
-    "less": "^4.6.6",
+    "less": "^4.6.7",
     "screenfull": "^6.0.2",
     "typescript": "^6.0.3",
-    "vite": "^8.0.16",
-    "vite-plugin-dts": "^5.0.2",
-    "vue": "^3.5.38",
+    "vite": "^8.1.2",
+    "vite-plugin-dts": "^5.0.3",
+    "vue": "^3.5.39",
     "vue-i18n": "^11.4.6",
-    "vue-tsc": "^3.3.5",
+    "vue-tsc": "^3.3.6",
     "xlsx": "^0.18.5"
   },
   "keywords": [