bw-pro-table 0.0.1 → 0.0.3

package/dist/types/drag-icon.vue.d.ts

@@ -1,14 +1,14 @@
 interface Props {
     draggable?: boolean;
 }
-declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     dragend: (e: DragEvent) => any;
     dragstart: (e: DragEvent) => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     onDragend?: ((e: DragEvent) => any) | undefined;
     onDragstart?: ((e: DragEvent) => any) | undefined;
 }>, {
     draggable: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/index.d.ts

@@ -12,7 +12,7 @@ export { initBuiltinRenderers, resetRenderers } from './renderers/index';
 export { BW_PRO_TABLE_KEY } from './injection-keys';
 export type { BwProTableContext } from './injection-keys';
 export { useQueryParams, useBwRowEdit, useBwRowSelection, useExportExcel, useImportExcel, usePersistence, useContextMenu, useDragSort, useBwKeyboard, useTableView, useBwPermission, useColumnHeaderSearch, } from './composables/index';
-export type { ProColumnType, ProColumnsType, ValueType, ValueEnumItem, ValueEnumMap, ActionItem, FormRule, BwProTableProps, EditConfig, ContextMenuConfig, ContextMenuItem, DragConfig, ExportConfig, ImportConfig, ViewConfig, TableState, TableStatus, PersistedColumnState, PersistedTableState, StorageAdapter, PersistenceConfig, EditCommand, FilterOperator, AdvancedFilterCondition, AdvancedFilterGroup, } from './types';
+export type { ProColumnType, ProColumnsType, ValueType, ValueEnumItem, ValueEnumMap, ActionItem, FormRule, GetRowKey, TableRowSelection, ExpandableConfig, BwProTableProps, EditConfig, ContextMenuConfig, ContextMenuItem, DragConfig, ExportConfig, ImportConfig, ViewConfig, TableState, TableStatus, PersistedColumnState, PersistedTableState, StorageAdapter, PersistenceConfig, EditCommand, FilterOperator, AdvancedFilterCondition, AdvancedFilterGroup, } from './types';
 export type { RendererFn, RendererContext } from './renderers/index';
 export { DEFAULT_EMPTY_TEXT, DEFAULT_PAGE_SIZE, DEFAULT_DATE_FORMAT } from './constants';
 export { default as zhCN } from './locales/zh-CN';

package/dist/types/injection-keys.d.ts

@@ -1,8 +1,5 @@
-/**
- * BwProTable provide/inject 类型安全 InjectionKey
- */
-import type { InjectionKey, Ref, ComputedRef } from 'vue';
-import type { TableState } from './types';
+import { InjectionKey, Ref, ComputedRef } from 'vue';
+import { TableState } from './types';
 export interface BwProTableContext {
     /** 表格唯一标识 */
     tableId: ComputedRef<string | undefined>;
@@ -35,10 +32,10 @@ export interface BwProTableContext {
     isCellEditing: (key: string | number, field: string) => boolean;
     getDraftValue: (key: string | number, field: string) => any;
     setDraftValue: (key: string | number, field: string, value: any) => void;
-    startCellEdit: (key: string | number, field: string) => void;
-    startRowEdit: (key: string | number) => void;
+    startCellEdit: (key: string | number, field: string) => Promise<void>;
+    startRowEdit: (key: string | number) => Promise<void>;
     saveEdit: (key: string | number) => Promise<boolean>;
-    cancelEdit: (key: string | number) => void;
+    cancelEdit: (key: string | number, field?: string) => void;
     deleteRow: (key: string | number) => Promise<void>;
     getFieldError: (key: string | number, field: string) => string | undefined;
     undo: () => void;
@@ -49,8 +46,8 @@ export interface BwProTableContext {
     columnDraggable?: Ref<boolean>;
     /** 表头拖拽后重排列（fromDataIndex → toDataIndex） */
     reorderColumns?: (fromDataIndex: string, toDataIndex: string) => void;
-    /** 跨页选中 key 集合（仅跨页模式时注入） */
-    crossPageKeys?: Ref<Set<string | number>>;
+    /** 跨页选中 key 集合（仅跨页模式时注入，computed 确保模式切换时响应式更新） */
+    crossPageKeys?: Ref<Set<string | number>> | ComputedRef<Set<string | number> | undefined>;
     /** 选中计数（computed，跨页模式下为全量数） */
     selectionCount?: ComputedRef<number>;
     /** 清空所有跨页选择 */

package/dist/types/locales/zh-CN.d.ts

@@ -1,6 +1,3 @@
-/**
- * BwProTable 中文语言包
- */
-import type { BwProTableLocale } from '../types';
+import { BwProTableLocale } from '../types';
 declare const zhCN: BwProTableLocale;
 export default zhCN;

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

@@ -1,6 +1,6 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 操作列渲染器 — valueType: 'action'
- * 渲染按钮组，自动 fixed:'right'，a-popconfirm 删除确认
+ * 渲染按钮组，自动 fixed:'right'，支持 Popconfirm 气泡确认
  */
 export declare const actionRenderer: RendererFn;

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 头像渲染器 — valueType: 'avatar'
  * 渲染 a-avatar + 名称

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 布尔渲染器 — valueType: 'boolean'
  * 渲染 ✓/✗ 图标或 a-switch 开关

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 货币渲染器 — valueType: 'currency'
  * 自动千分位 + 前缀/后缀符号（¥ / $ / %）

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 日期渲染器 — valueType: 'date'
  * 自动 dayjs 格式化，支持 dateFormat 配置

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 图片渲染器 — valueType: 'image'
  * 缩略图展示 + a-image-preview-group 大图预览

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 序号渲染器 — valueType: 'index'
  * 自动计算行号，支持跨页连续编号

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

@@ -1,11 +1,3 @@
-/**
- * 渲染器统一导出 + 内置渲染器注册
- *
- * 使用方式：
- * - 通过 ensureRenderers() 惰性初始化所有内置 valueType 渲染器
- * - 通过 defineColumnType() 注册自定义 valueType
- * - 初次调用 getRenderer/hasRenderer 前自动初始化
- */
 import { getRenderer } from './registry';
 /**
  * 惰性初始化所有内置渲染器（幂等，仅执行一次）
@@ -19,7 +11,7 @@ export declare const initBuiltinRenderers: typeof ensureRenderers;
  * 获取渲染器（自动确保内置渲染器已初始化）
  */
 export declare function getRendererSafe(type: string): ReturnType<typeof getRenderer>;
-export { registerRenderer, getRenderer, hasRenderer, defineColumnType } from './registry';
+export { registerRenderer, getRenderer, hasRenderer, defineColumnType, clearRendererRegistry } from './registry';
 export type { RendererFn, RendererContext } from './registry';
 /**
  * 重置渲染器注册表（仅用于测试隔离）

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 链接渲染器 — valueType: 'link'
  * 渲染 a-typography-link，支持 href 模板或 onClick 回调

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 数字渲染器 — valueType: 'number'
  * 自动千分位格式化，支持 precision 配置

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 进度条渲染器 — valueType: 'progress'
  * 将数值渲染为 a-progress 组件

package/dist/types/renderers/registry.d.ts

@@ -1,5 +1,5 @@
-import type { ProColumnType } from '../types';
-import type { VNode } from 'vue';
+import { ProColumnType } from '../types';
+import { VNode } from 'vue';
 /**
  * 渲染器上下文 — 每个 valueType 渲染器都接收此上下文
  */
@@ -39,3 +39,7 @@ export declare function defineColumnType(type: string, renderer: RendererFn): vo
  * 获取渲染器注册表（仅用于调试）
  */
 export declare function getRendererRegistry(): ReadonlyMap<string, RendererFn>;
+/**
+ * 清空渲染器注册表（仅用于测试隔离）
+ */
+export declare function clearRendererRegistry(): void;

package/dist/types/renderers/tag-enum-renderer.d.ts

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 标签/枚举渲染器 — valueType: 'tag'
  * 根据 valueEnum 映射为 a-tag + 颜色

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

@@ -1,4 +1,4 @@
-import type { RendererFn } from './registry';
+import { RendererFn } from './registry';
 /**
  * 文本渲染器 — valueType: 'text'
  * 默认类型，自动应用 ellipsis + Tooltip

package/dist/types/types.d.ts

@@ -1,13 +1,55 @@
-import type { VNode } from 'vue';
-import type { TableColumnType, TablePaginationConfig } from 'ant-design-vue';
-import type { TableRowSelection, ExpandableConfig, GetRowKey } from 'ant-design-vue/es/table/interface';
+import { VNode, CSSProperties } 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 接口） */
+export interface TableRowSelection<RecordType = any> {
+    type?: 'checkbox' | 'radio';
+    selectedRowKeys?: (string | number)[];
+    onChange?: (selectedRowKeys: (string | number)[], selectedRows: RecordType[]) => void;
+    getCheckboxProps?: (record: RecordType) => any;
+    selections?: any[] | boolean;
+    columnWidth?: number | string;
+    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;
+    onSelectAll?: (selected: boolean, selectedRows: RecordType[], changeRows: RecordType[]) => void;
+    onSelectInvert?: (selectedRowKeys: (string | number)[]) => void;
+    onSelectNone?: () => void;
+}
+/** 可展开行配置（对齐 ant-design-vue ExpandableConfig 接口） */
+export interface ExpandableConfig<RecordType = any> {
+    expandedRowKeys?: (string | number)[];
+    defaultExpandedRowKeys?: (string | number)[];
+    expandedRowRender?: (props: {
+        record: RecordType;
+        index: number;
+        indent: number;
+        expanded: boolean;
+    }) => VNode;
+    expandRowByClick?: boolean;
+    expandIcon?: (props: {
+        expanded: boolean;
+        onExpand: (record: RecordType, e: Event) => void;
+        record: RecordType;
+    }) => VNode;
+    rowExpandable?: (record: RecordType) => boolean;
+    onExpand?: (expanded: boolean, record: RecordType) => void;
+    onExpandedRowsChange?: (expandedRows: (string | number)[]) => void;
+    expandedRowClassName?: (record: RecordType, index: number, indent: number) => string;
+    indentSize?: number;
+    columnWidth?: number | string;
+    fixed?: boolean | 'left' | 'right';
+}
 /** 排序方向 */
 export type SortOrder = 'ascend' | 'descend' | null;
 /** 筛选值类型 */
 export type FilterValue = (string | number)[] | null;
 /** 行 Key 类型 */
 export type Key = string | number;
-import type { CSSProperties } from 'vue';
 /** 支持的 valueType 预设值 */
 export type ValueType = 'text' | 'number' | 'date' | 'tag' | 'image' | 'link' | 'progress' | 'avatar' | 'action' | 'index' | 'currency' | 'boolean';
 /** valueEnum 映射定义 */
@@ -88,6 +130,8 @@ export interface ProColumnType<RecordType = any> extends Omit<TableColumnType<Re
     children?: ProColumnsType<RecordType>;
     /** 是否隐藏该列 */
     hidden?: boolean;
+    /** 是否在搜索栏中隐藏该列（默认 false，即显示在搜索栏中） */
+    hideInSearch?: boolean;
     /** 列所属分组 */
     columnGroup?: string;
     /** 列头搜索配置（true 或 HeaderSearchConfig 对象启用；仅对 valueType='text' 生效） */
@@ -124,6 +168,7 @@ export interface ActionItem<RecordType = any> {
     /** 危险操作样式，对应 ant-design-vue Button 的 danger 属性 */
     danger?: boolean;
     icon?: string;
+    /** 气泡确认文案，设置后点击按钮会先弹出 Popconfirm 确认 */
     confirm?: string;
     authority?: string | string[];
     disabled?: boolean | ((record: RecordType) => boolean);
@@ -140,6 +185,11 @@ export interface FormRule {
     pattern?: RegExp;
     validator?: (value: any, record: any) => Promise<void> | void;
 }
+/** 导入校验规则 — 继承 FormRule 并附加必填 field 字段 */
+export interface ImportValidateRule extends FormRule {
+    /** 校验目标字段名（必填） */
+    field: string;
+}
 export interface EditConfig<RecordType = any> {
     /** 编辑模式 */
     mode?: 'cell' | 'row';
@@ -240,14 +290,25 @@ export interface ExportConfig {
     type?: 'xlsx' | 'csv';
     /** 自定义列映射 */
     columnMapping?: Record<string, string>;
-    /** 导出前回调 */
+    /** 导出前回调，返回 false 可阻止导出 */
     beforeExport?: () => Promise<boolean> | boolean;
+    /**
+     * Request 模式下导出全量数据回调。
+     * 不提供时仅导出当前页数据；提供后可通过此回调获取全部数据。
+     * 接收当前搜索/筛选/排序参数，返回全量数据数组。
+     */
+    onExportAll?: (params: Record<string, any>) => Promise<any[]> | any[];
+    /**
+     * Request 模式下导出选中行回调（跨页选择时选中行数据可能不完整）。
+     * 接收选中的 rowKey 数组，返回对应的行数据数组。
+     */
+    onExportSelected?: (keys: (string | number)[]) => Promise<any[]> | any[];
 }
 export interface ImportConfig {
     /** 列映射 */
     columnMapping?: Record<string, string>;
     /** 校验规则 */
-    validateRules?: FormRule[];
+    validateRules?: ImportValidateRule[];
     /** 导入前回调 */
     beforeImport?: (data: any[]) => Promise<any[]> | any[];
     /** 导入回调 */
@@ -288,6 +349,7 @@ export interface BwProTableLocale {
         exitFullscreen: string;
         columnSetting: string;
         export: string;
+        import: string;
         clearFilter: string;
         search: string;
         border: string;
@@ -448,18 +510,24 @@ export interface BwProTableProps<RecordType = any> {
     dataSource?: RecordType[];
     /** 行 key 属性 */
     rowKey?: string | GetRowKey<RecordType>;
-    /** 搜索栏配置 */
-    search?: false | {
+    /** 搜索栏配置。true 启用（全部默认值），false 禁用 */
+    search?: boolean | {
         labelWidth?: number;
         defaultCollapsed?: boolean;
         resetText?: string;
         searchText?: string;
         collapsedCount?: number;
+        /** 是否显示 label 后的冒号（默认 true，与 antd 一致） */
+        colon?: boolean;
     };
     /** 列头搜索全局配置（false 禁用所有列的 headerSearch，对象覆写默认值） */
     columnSearch?: false | HeaderSearchConfig;
     /** 工具栏配置 */
     toolbar?: false | {
+        /** 是否显示边框切换开关（默认 true） */
+        bordered?: boolean;
+        /** 是否显示斑马纹切换开关（默认 true） */
+        striped?: boolean;
         refresh?: boolean;
         density?: boolean;
         fullscreen?: boolean;
@@ -514,6 +582,8 @@ export interface BwProTableProps<RecordType = any> {
     class?: string;
     /** 表格样式 */
     style?: CSSProperties;
+    /** 行 className 函数（覆盖内置斑马纹/选中行样式） */
+    rowClassName?: (record: RecordType, index: number) => string;
 }
 export type TableStatus = 'loading' | 'success' | 'error';
 export interface TableState {
@@ -527,8 +597,7 @@ export interface PersistedColumnState {
     order: number;
     width?: number;
 }
-/** 当前持久化数据版本（已迁移到 constants.ts，保留向后兼容 re-export） */
-export { PERSISTED_DATA_VERSION } from './constants';
+/** 当前持久化数据版本（已迁移到 constants.ts，请从 constants 直接导入） */
 export interface PersistedTableState {
     /** 数据版本号，用于版本迁移 */
     version: string;

package/locales/zh-CN.ts

@@ -28,6 +28,7 @@ const zhCN: BwProTableLocale = {
     exitFullscreen: '退出全屏',
     columnSetting: '列设置',
     export: '导出',
+    import: '导入',
     clearFilter: '清除筛选',
     search: '搜索',
     border: '边框',

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "bw-pro-table",
-  "version": "0.0.1",
+  "version": "0.0.3",
+  "author": {"name": "ZM"},
   "description": "基于 ant-design-vue 的高级业务表格组件（ProTable），支持请求/数据源双模式、行内编辑、搜索筛选、列拖拽排序、导出导入、跨页多选、持久化等",
   "type": "module",
   "main": "./dist/bw-pro-table.umd.cjs",
@@ -37,16 +38,16 @@
   ],
   "scripts": {
     "dev": "vite --open dev/index.html",
-    "build": "vite build && vue-tsc --project tsconfig.build.json --emitDeclarationOnly",
-    "build:vite": "vite build",
+    "build": "vite build",
+    "build:vue-tsc": "vite build && vue-tsc --project tsconfig.build.json --emitDeclarationOnly",
     "build:types": "vue-tsc --project tsconfig.build.json --emitDeclarationOnly",
     "typecheck": "vue-tsc --project tsconfig.build.json --noEmit",
     "lint": "eslint . --ext .vue,.ts",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
-    "@ant-design/icons-vue": "^6.0.0 || ^7.0.0",
-    "ant-design-vue": "^3.2.0 || ^4.0.0",
+    "@ant-design/icons-vue": "^7.0.0",
+    "ant-design-vue": "^4.0.0",
     "dayjs": "^1.11.0",
     "screenfull": "^6.0.0",
     "vue": "^3.3.0",
@@ -63,19 +64,19 @@
   },
   "devDependencies": {
     "@ant-design/icons-vue": "^7.0.1",
-    "@types/node": "^24.13.2",
+    "@types/node": "^26.0.0",
     "@vitejs/plugin-vue": "^6.0.7",
-    "@vue/language-core": "^3.3.4",
+    "@vue/language-core": "^3.3.5",
     "ant-design-vue": "^4.2.6",
     "dayjs": "^1.11.21",
-    "less": "^4.6.4",
+    "less": "^4.6.6",
     "screenfull": "^6.0.2",
     "typescript": "^6.0.3",
     "vite": "^8.0.16",
     "vite-plugin-dts": "^5.0.2",
-    "vue": "^3.5.35",
-    "vue-i18n": "^11.4.5",
-    "vue-tsc": "^3.3.4",
+    "vue": "^3.5.38",
+    "vue-i18n": "^11.4.6",
+    "vue-tsc": "^3.3.5",
     "xlsx": "^0.18.5"
   },
   "keywords": [

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

@@ -1,17 +0,0 @@
-import type { AdvancedFilterCondition, ProColumnsType } from './types';
-interface Props {
-    visible: boolean;
-    columns: ProColumnsType<any>;
-    initialConditions?: AdvancedFilterCondition[];
-}
-declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    reset: () => any;
-    "update:visible": (value: boolean) => any;
-    apply: (conditions: AdvancedFilterCondition[]) => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    onReset?: (() => any) | undefined;
-    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
-    onApply?: ((conditions: AdvancedFilterCondition[]) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;

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

@@ -1,20 +0,0 @@
-import type { ContextMenuItem } from './types';
-interface Props {
-    visible: boolean;
-    x: number;
-    y: number;
-    items: ContextMenuItem[];
-    /** 菜单宽度 */
-    width?: number;
-}
-declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    click: (key: string, item: ContextMenuItem) => any;
-    close: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    onClick?: ((key: string, item: ContextMenuItem) => any) | undefined;
-    onClose?: (() => any) | undefined;
-}>, {
-    width: number;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;