bw-pro-table 0.0.1 → 0.0.2

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

@@ -1,20 +1,20 @@
-import type { BwProTableProps, ProColumnType } from './types';
+import { BwProTableProps, ProColumnType } from './types';
 interface Props extends BwProTableProps {
 }
 declare function fetchData(_retryCount?: number): Promise<void>;
 /** 清空所有跨页选择 */
 declare function handleClearAllSelection(): void;
-declare var __VLS_1: {}, __VLS_12: {}, __VLS_23: {}, __VLS_35: string, __VLS_36: any;
+declare var __VLS_7: {}, __VLS_19: {}, __VLS_42: {}, __VLS_56: string, __VLS_57: any;
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_35>]?: (props: typeof __VLS_36) => any;
+    [K in NonNullable<typeof __VLS_56>]?: (props: typeof __VLS_57) => any;
 } & {
-    search?: (props: typeof __VLS_1) => any;
+    search?: (props: typeof __VLS_7) => any;
 } & {
-    toolbar?: (props: typeof __VLS_12) => any;
+    toolbar?: (props: typeof __VLS_19) => any;
 } & {
-    'toolbar-extra'?: (props: typeof __VLS_23) => any;
+    'toolbar-extra'?: (props: typeof __VLS_42) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Props, {
+declare const __VLS_base: import('vue').DefineComponent<Props, {
     fetchData: typeof fetchData;
     getSelectedRowKeys: () => (string | number)[];
     getSelectedRows: () => any[];
@@ -22,7 +22,30 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
     clearSelection: typeof handleClearAllSelection;
     getCrossPageSelectedKeys: () => (string | number)[];
     getCrossPageSelectedRows: () => any[];
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    startRowEdit: (key: string | number) => Promise<void>;
+    startCellEdit: (key: string | number, field: string) => Promise<void>;
+    saveEdit: (key: string | number) => Promise<boolean>;
+    cancelEdit: (key: string | number, field?: string) => void;
+    addRow: (position?: "top" | "bottom") => void;
+    cloneRow: (key: string | number) => void;
+    deleteRow: (key: string | number) => Promise<void>;
+    deleteRows: (keys: (string | number)[]) => Promise<void>;
+    isCellEditing: (key: string | number, field: string) => boolean;
+    getEditingKeys: () => Set<string | number>;
+    canUndo: () => boolean;
+    canRedo: () => boolean;
+    undo: () => void;
+    redo: () => void;
+    openBatchEdit: () => void;
+    exportExcel: () => Promise<void>;
+    exportCsv: () => Promise<void>;
+    exportSelected: (selectedRows: any[], selectedKeys?: (string | number)[]) => Promise<void>;
+    openFileDialog: () => void;
+    downloadTemplate: (columns: {
+        title: string;
+        dataIndex: string;
+    }[]) => Promise<void>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     error: (error: Error) => any;
     change: (pagination: any, filters: any, sorter: any, extra?: {
         action: "paginate" | "sort" | "filter";
@@ -33,7 +56,7 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
         total: number;
     }) => any;
     resizeColumn: (w: number, col: ProColumnType<any>) => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     onError?: ((error: Error) => any) | undefined;
     onChange?: ((pagination: any, filters: any, sorter: any, extra?: {
         action: "paginate" | "sort" | "filter";
@@ -45,12 +68,12 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
     }) => any) | undefined;
     onResizeColumn?: ((w: number, col: ProColumnType<any>) => any) | undefined;
 }>, {
-    rowKey: string | import("ant-design-vue/es/vc-table/interface").GetRowKey<any>;
+    rowKey: string | import('./types').GetRowKey<any>;
     size: "small" | "middle" | "default";
     tableId: string;
-    pagination: false | import("ant-design-vue").TablePaginationConfig;
+    pagination: false | import('ant-design-vue').TablePaginationConfig;
     defaultEmptyText: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,4 +1,4 @@
-import type { ProColumnsType } from './types';
+import { ProColumnsType } from './types';
 interface Props {
     visible: boolean;
     columns: ProColumnsType;
@@ -6,18 +6,18 @@ interface Props {
     /** 行主键属性名（排除 rowKey 列，防止将主键字段作为批量编辑目标） */
     rowKey?: string;
 }
-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, {
     "update:visible": (value: boolean) => any;
     confirm: (payload: {
         field: string;
         value: any;
     }) => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:visible"?: ((value: boolean) => any) | undefined;
     onConfirm?: ((payload: {
         field: string;
         value: any;
     }) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -5,10 +5,10 @@ interface Props {
     searchText?: string;
     resetText?: string;
 }
-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, {
     close: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     onClose?: (() => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,14 +1,14 @@
-import type { ProColumnsType, PersistedColumnState } from './types';
+import { ProColumnsType, PersistedColumnState } from './types';
 interface Props {
     columns: ProColumnsType;
     persistedColumns?: PersistedColumnState[];
 }
-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, {
     change: (columns: PersistedColumnState[]) => any;
     reset: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     onChange?: ((columns: PersistedColumnState[]) => any) | undefined;
     onReset?: (() => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,4 +1,4 @@
-import type { ProColumnsType } from './types';
+import { ProColumnsType } from './types';
 interface Props {
     columns: ProColumnsType;
     /** 行 key 属性名（与 ant-design-vue Table rowKey 语义一致，默认 'id'） */
@@ -7,6 +7,8 @@ interface Props {
     errorMessage?: string;
     pagination?: false | Record<string, any>;
     onRetry?: () => void | Promise<void>;
+    /** 全局空单元格占位符，优先级低于列级 emptyText */
+    defaultEmptyText?: string;
 }
 declare var __VLS_24: string, __VLS_25: any, __VLS_28: any, __VLS_36: {
     column: any;
@@ -18,16 +20,17 @@ type __VLS_Slots = {} & {
 } & {
     headerCell?: (props: typeof __VLS_36) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Props, {
+declare const __VLS_base: import('vue').DefineComponent<Props, {
     retry: () => void;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     retry: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     onRetry?: (() => any) | undefined;
 }>, {
     columns: ProColumnsType;
     rowKey: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+    defaultEmptyText: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -0,0 +1,40 @@
+import { ProColumnsType } from './types';
+interface Props {
+    /** 是否显示弹窗 */
+    visible: boolean;
+    /** 是否正在导入 */
+    importing?: boolean;
+    /** 预览数据 */
+    previewData?: any[];
+    /** 预览列头 */
+    previewColumns?: string[];
+    /** 校验错误 */
+    validateErrors?: string[];
+    /** 表格列定义（用于列映射下拉和模板下载） */
+    columns?: ProColumnsType;
+    /** 列映射当前值 */
+    columnMapping?: Record<string, string>;
+}
+declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cancel: () => any;
+    "update:visible": (val: boolean) => any;
+    confirm: () => any;
+    "select-file": () => any;
+    "update:columnMapping": (val: Record<string, string>) => any;
+    "download-template": () => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    "onUpdate:visible"?: ((val: boolean) => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+    "onSelect-file"?: (() => any) | undefined;
+    "onUpdate:columnMapping"?: ((val: Record<string, string>) => any) | undefined;
+    "onDownload-template"?: (() => any) | undefined;
+}>, {
+    importing: boolean;
+    previewData: any[];
+    previewColumns: string[];
+    validateErrors: string[];
+    columnMapping: Record<string, string>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -1,4 +1,4 @@
-import type { ProColumnsType } from './types';
+import { ProColumnsType } from './types';
 interface Props {
     columns: ProColumnsType;
     searchConfig?: {
@@ -11,12 +11,12 @@ interface Props {
 }
 /** 暴露给父组件：仅清空表单 UI，不触发事件 */
 declare function resetForm(): void;
-declare const __VLS_export: import("vue").DefineComponent<Props, {
+declare const __VLS_export: import('vue').DefineComponent<Props, {
     resetForm: typeof resetForm;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     search: (params: Record<string, any>) => any;
     reset: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     onSearch?: ((params: Record<string, any>) => any) | undefined;
     onReset?: (() => any) | undefined;
 }>, {
@@ -28,6 +28,6 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {
         searchText?: string;
         collapsedCount?: number;
     };
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,4 +1,4 @@
-import type { ProColumnsType, PersistedColumnState } from './types';
+import { ProColumnsType, PersistedColumnState } from './types';
 interface Props {
     title?: string;
     loading?: boolean;
@@ -29,16 +29,23 @@ interface Props {
     selectionCount?: number;
     /** 是否启用跨页选择 */
     hasCrossPageSelection?: boolean;
+    /** 是否正在导出 */
+    exporting?: boolean;
+    /** 是否正在导入 */
+    importing?: boolean;
 }
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     extra?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    export: () => any;
+declare const __VLS_base: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    import: () => any;
     refresh: () => any;
     "clear-filter": () => any;
     "clear-selection": () => any;
+    "export-excel": () => any;
+    "export-csv": () => any;
+    "export-selected": () => any;
     "density-change": (size: "default" | "small" | "middle") => any;
     "column-setting": () => any;
     "column-change": (columns: PersistedColumnState[]) => any;
@@ -46,11 +53,14 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
     "toggle-bordered": () => any;
     "toggle-striped": () => any;
     fullscreen: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    onExport?: (() => any) | undefined;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    onImport?: (() => any) | undefined;
     onRefresh?: (() => any) | undefined;
     "onClear-filter"?: (() => any) | undefined;
     "onClear-selection"?: (() => any) | undefined;
+    "onExport-excel"?: (() => any) | undefined;
+    "onExport-csv"?: (() => any) | undefined;
+    "onExport-selected"?: (() => any) | undefined;
     "onDensity-change"?: ((size: "default" | "small" | "middle") => any) | undefined;
     "onColumn-setting"?: (() => any) | undefined;
     "onColumn-change"?: ((columns: PersistedColumnState[]) => any) | undefined;
@@ -73,7 +83,9 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
         viewManager?: boolean;
     };
     isFullscreen: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+    exporting: boolean;
+    importing: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,4 +1,4 @@
-import { type Ref } from 'vue';
+import { Ref } from 'vue';
 export interface UseBwKeyboardOptions {
     /** 数据源长度 */
     dataLength: Ref<number> | number;

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

@@ -1,5 +1,5 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { ProColumnsType } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { ProColumnsType } from '../types';
 export interface UseBwPermissionOptions {
     /** 列定义 */
     columns: Ref<ProColumnsType> | ComputedRef<ProColumnsType>;

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

@@ -1,18 +1,20 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { EditConfig, ProColumnsType } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { EditConfig, ProColumnsType } from '../types';
 export interface UseBwRowEditOptions<RecordType = any> {
     /** 全量数据源 */
     dataSource: Ref<RecordType[]>;
     /** 列定义 */
     columns: Ref<ProColumnsType<RecordType>> | ComputedRef<ProColumnsType<RecordType>>;
-    /** 行 key 属性名 */
-    rowKey?: string;
+    /** 行 key 属性名（支持 ComputedRef 以响应 rowKey 变化） */
+    rowKey?: string | ComputedRef<string>;
     /** 编辑配置 */
     editConfig?: Ref<EditConfig<RecordType> | undefined>;
     /** 保存回调 */
     onSave?: (record: RecordType, isNew: boolean) => Promise<void>;
     /** 删除回调 */
     onDelete?: (keys: (string | number)[]) => Promise<void>;
+    /** 国际化语言包（由 BwProTable 传入，避免 provide/inject 时序问题） */
+    locale?: ComputedRef<import('../types').BwProTableLocale>;
 }
 export interface UseBwRowEditReturn<RecordType = any> {
     /** 当前处于编辑态的行 keys */
@@ -28,17 +30,17 @@ export interface UseBwRowEditReturn<RecordType = any> {
     /** 设置草稿值 */
     setDraftValue: (key: string | number, field: string, value: any) => void;
     /** 进入单元格编辑 */
-    startCellEdit: (key: string | number, field: string) => void;
+    startCellEdit: (key: string | number, field: string) => Promise<void>;
     /** 进入行编辑 */
-    startRowEdit: (key: string | number) => void;
+    startRowEdit: (key: string | number) => Promise<void>;
     /** 新增空行 */
     addRow: (position?: 'top' | 'bottom') => void;
     /** 克隆行 */
     cloneRow: (key: string | number) => void;
     /** 保存编辑 */
     saveEdit: (key: string | number) => Promise<boolean>;
-    /** 取消编辑 */
-    cancelEdit: (key: string | number) => void;
+    /** 取消编辑（指定 field 时仅取消该单元格编辑） */
+    cancelEdit: (key: string | number, field?: string) => void;
     /** 删除行 */
     deleteRow: (key: string | number) => Promise<void>;
     /** 批量删除 */

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

@@ -1,5 +1,5 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { TableRowSelection } from 'ant-design-vue/es/table/interface';
+import { Ref, ComputedRef } from 'vue';
+import { TableRowSelection } from '../types';
 export interface UseBwRowSelectionOptions<RecordType = any> {
     /** 全量数据源 */
     dataSource: Ref<RecordType[]> | ComputedRef<RecordType[]>;

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

@@ -1,5 +1,5 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { ProColumnsType, FilterValue } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { ProColumnsType, FilterValue } from '../types';
 export interface UseColumnHeaderSearchOptions<RecordType = any> {
     /** 列定义 */
     columns: Ref<ProColumnsType<RecordType>> | ComputedRef<ProColumnsType<RecordType>>;

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

@@ -1,5 +1,5 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { ContextMenuItem, ContextMenuType, ContextMenuConfig, ProColumnsType } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { ContextMenuItem, ContextMenuType, ContextMenuConfig, ProColumnsType } from '../types';
 export interface ContextMenuState {
     /** 是否可见 */
     visible: boolean;
@@ -24,6 +24,8 @@ export interface UseContextMenuOptions {
     config?: ContextMenuConfig;
     /** 列定义（用于生成表头菜单默认项） */
     columns?: Ref<ProColumnsType> | ComputedRef<ProColumnsType>;
+    /** 国际化语言包（由 BwProTable 传入，避免 provide/inject 时序问题） */
+    locale?: ComputedRef<import('../types').BwProTableLocale>;
 }
 export interface UseContextMenuReturn {
     /** 菜单状态 */

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

@@ -1,5 +1,5 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { DragConfig, ProColumnsType } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { DragConfig, ProColumnsType } from '../types';
 export interface UseDragSortOptions<RecordType = any> {
     /** 数据源 */
     dataSource: Ref<RecordType[]>;

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

@@ -1,20 +1,24 @@
-import { type Ref } from 'vue';
-import type { ProColumnsType, ExportConfig } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { ProColumnsType, ExportConfig } from '../types';
 export interface UseExportExcelOptions<RecordType = any> {
     /** 列定义 */
-    columns: Ref<ProColumnsType<RecordType>>;
+    columns: Ref<ProColumnsType<RecordType>> | ComputedRef<ProColumnsType<RecordType>>;
     /** 数据源 */
     dataSource: Ref<readonly RecordType[]>;
-    /** 导出配置 */
-    exportConfig?: ExportConfig;
+    /** 导出配置（支持响应式） */
+    exportConfig?: Ref<ExportConfig | undefined> | ComputedRef<ExportConfig | undefined> | ExportConfig;
+    /** 当前搜索/筛选/排序参数（传入 onExportAll 回调） */
+    searchParams?: Ref<Record<string, any>> | ComputedRef<Record<string, any>>;
+    /** 国际化语言包（由 BwProTable 传入，避免 provide/inject 时序问题） */
+    locale?: ComputedRef<import('../types').BwProTableLocale>;
 }
 export interface UseExportExcelReturn {
     /** 导出 Excel */
     exportExcel: () => Promise<void>;
     /** 导出 CSV */
-    exportCsv: () => void;
+    exportCsv: () => Promise<void>;
     /** 导出选中行 */
-    exportSelected: (selectedRows: any[]) => Promise<void>;
+    exportSelected: (selectedRows: any[], selectedKeys?: (string | number)[]) => Promise<void>;
     /** 导出自定义列弹窗 */
     showColumnSelect: Ref<boolean>;
     /** 是否正在导出 */
@@ -29,7 +33,10 @@ export interface UseExportExcelReturn {
  * 支持：
  * - 导出 Excel / CSV
  * - 导出选中行
+ * - Request 模式通过 onExportAll 回调获取全量数据
+ * - beforeExport 导出前拦截
  * - 分片导出（大数据量 + 进度条）
  * - 自定义列选择导出
+ * - 导出配置响应式更新
  */
 export declare function useExportExcel<RecordType extends Record<string, any> = any>(options: UseExportExcelOptions<RecordType>): UseExportExcelReturn;

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

@@ -1,8 +1,12 @@
-import { type Ref } from 'vue';
-import type { ImportConfig } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { ImportConfig, ProColumnsType } from '../types';
 export interface UseImportExcelOptions {
-    /** 导入配置 */
-    importConfig?: ImportConfig;
+    /** 导入配置（支持响应式） */
+    importConfig?: Ref<ImportConfig | undefined> | ComputedRef<ImportConfig | undefined> | ImportConfig;
+    /** 列定义（用于自动列映射） */
+    columns?: Ref<ProColumnsType> | ComputedRef<ProColumnsType>;
+    /** 国际化语言包（由 BwProTable 传入，避免 provide/inject 时序问题） */
+    locale?: ComputedRef<import('../types').BwProTableLocale>;
 }
 export interface UseImportExcelReturn {
     /** 是否正在导入 */
@@ -21,8 +25,8 @@ export interface UseImportExcelReturn {
     openFileDialog: () => void;
     /** 处理文件 */
     handleFile: (file: File) => Promise<void>;
-    /** 确认导入 */
-    confirmImport: () => Promise<void>;
+    /** 确认导入，返回是否成功 */
+    confirmImport: () => Promise<boolean>;
     /** 取消 */
     cancel: () => void;
     /** 下载模板 */
@@ -37,9 +41,11 @@ export interface UseImportExcelReturn {
  * 使用 FileReader + xlsx 解析 Excel 文件。
  * 支持：
  * - 预览解析数据
- * - 列映射配置
- * - 数据校验
+ * - 自动列映射（基于 Excel 表头 ↔ 列 title 匹配）
+ * - 手动列映射配置
+ * - 数据校验（基于 FormRule 指定字段）
  * - 导入提交
  * - 模板下载
+ * - 配置响应式更新
  */
 export declare function useImportExcel(options?: UseImportExcelOptions): UseImportExcelReturn;

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

@@ -1,12 +1,16 @@
-import type { InjectionKey, ComputedRef } from 'vue';
-import type { BwProTableLocale } from '../types';
+import { InjectionKey, ComputedRef } from 'vue';
+import { BwProTableLocale } from '../types';
 /** 注入 Key */
 export declare const BW_PRO_TABLE_LOCALE_KEY: InjectionKey<ComputedRef<BwProTableLocale>>;
 /**
  * 在 setup 中获取当前生效的语言包。
- * 必须在 BwProTable 子树内调用（即通过 provide 已提供 locale），否则回退到默认 zh-CN。
+ *
+ * 优先级：
+ * 1. 直接传入的 locale 参数（父组件 provide 时自身无法 inject，需显式传递）
+ * 2. 通过 provide/inject 注入的 locale（子组件场景）
+ * 3. 回退到默认 zh-CN
  */
-export declare function useLocale(): ComputedRef<BwProTableLocale>;
+export declare function useLocale(directLocale?: ComputedRef<BwProTableLocale>): ComputedRef<BwProTableLocale>;
 /**
  * 深度合并自定义 locale 到默认 zh-CN。
  * 外部传入 Partial<BwProTableLocale>，内部补全缺失字段。

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

@@ -1,5 +1,5 @@
-import { type Ref } from 'vue';
-import type { PersistedColumnState, ProColumnsType, PersistenceConfig, FilterValue, SortOrder } from '../types';
+import { Ref } from 'vue';
+import { PersistedTableState, PersistedColumnState, ProColumnsType, PersistenceConfig, FilterValue, SortOrder } from '../types';
 export interface UsePersistenceOptions {
     /** 表格唯一标识 */
     tableId?: string;
@@ -47,6 +47,8 @@ export interface UsePersistenceReturn {
     clearCache: () => void;
     /** 同步当前 columns 到缓存 */
     syncColumnState: () => void;
+    /** 一次性读取完整持久化状态（避免批量加载时多次 localStorage.get + JSON.parse） */
+    readFullState: () => PersistedTableState | null;
 }
 /**
  * usePersistence — 列配置持久化 composable

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

@@ -1,5 +1,5 @@
-import { type Ref, type ComputedRef } from 'vue';
-import type { SortOrder, FilterValue } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { SortOrder, FilterValue } from '../types';
 export interface UseQueryParamsOptions {
     /** 初始分页 */
     initialPageSize?: number;

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

@@ -1,9 +1,11 @@
-import { type Ref } from 'vue';
-import type { ViewConfig, PersistedColumnState, ProColumnsType } from '../types';
+import { Ref, ComputedRef } from 'vue';
+import { ViewConfig, PersistedColumnState, ProColumnsType } from '../types';
 export interface UseTableViewOptions {
     tableId: string;
     columns?: Ref<ProColumnsType>;
     defaultColumns?: PersistedColumnState[];
+    /** 国际化语言包（由 BwProTable 传入，避免 provide/inject 时序问题） */
+    locale?: ComputedRef<import('../types').BwProTableLocale>;
 }
 export interface UseTableViewReturn {
     /** 所有视图列表 */

package/dist/types/constants.d.ts

@@ -1,4 +1,4 @@
-import type { ValueType, PersistedTableState, TableState } from './types';
+import { ValueType, PersistedTableState, TableState, ProColumnType } from './types';
 /** 默认每页条数 */
 export declare const DEFAULT_PAGE_SIZE = 10;
 /** 可选每页条数 */
@@ -42,8 +42,6 @@ export declare const DEFAULT_EXPORT_CHUNK_SIZE = 10000;
 export declare const DEFAULT_EXPORT_MAX_ROWS_WARNING = 50000;
 /** 导出默认文件名 */
 export declare const DEFAULT_EXPORT_FILENAME = "export";
-/** 请求防抖延迟（ms） */
-export declare const REQUEST_DEBOUNCE_DELAY = 300;
 /** 键盘导航列键映射 */
 export declare const KEYBOARD_NAV_KEYS: {
     readonly UP: "ArrowUp";
@@ -58,3 +56,9 @@ export declare const KEYBOARD_NAV_KEYS: {
 };
 /** 导入预览显示行数 */
 export declare const IMPORT_PREVIEW_MAX_ROWS = 10;
+/**
+ * Issue #13 修复：统一的特殊列判断工具函数
+ * 判断列是否属于「特殊列」（不应参与拖拽排序、导出、列设置等操作）
+ * 覆盖 valueType 和 dataIndex/key 两种标识方式
+ */
+export declare function isSpecialColumn(col: ProColumnType): boolean;

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';