bw-pro-table 0.0.1

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

@@ -0,0 +1,38 @@
+import type { ProColumnsType } from './types';
+interface Props {
+    columns: ProColumnsType;
+    /** 行 key 属性名（与 ant-design-vue Table rowKey 语义一致，默认 'id'） */
+    rowKey?: string;
+    loading?: boolean;
+    errorMessage?: string;
+    pagination?: false | Record<string, any>;
+    onRetry?: () => void | Promise<void>;
+}
+declare var __VLS_24: string, __VLS_25: any, __VLS_28: any, __VLS_36: {
+    column: any;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_24>]?: (props: typeof __VLS_25) => any;
+} & {
+    bodyCell?: (props: typeof __VLS_28) => any;
+} & {
+    headerCell?: (props: typeof __VLS_36) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<Props, {
+    retry: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    retry: () => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    onRetry?: (() => any) | undefined;
+}>, {
+    columns: ProColumnsType;
+    rowKey: 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;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

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

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

@@ -0,0 +1,84 @@
+import type { ProColumnsType, PersistedColumnState } from './types';
+interface Props {
+    title?: string;
+    loading?: boolean;
+    hasFilters?: boolean;
+    bordered?: boolean;
+    striped?: boolean;
+    /** 当前表格密度尺寸 */
+    size?: 'small' | 'middle' | 'default';
+    toolbarConfig?: {
+        bordered?: boolean;
+        striped?: boolean;
+        refresh?: boolean;
+        density?: boolean;
+        fullscreen?: boolean;
+        columnSetting?: boolean;
+        export?: boolean;
+        clearFilter?: boolean;
+        import?: boolean;
+        viewManager?: boolean;
+    };
+    /** 列定义（透传给列设置面板） */
+    columns?: ProColumnsType;
+    /** 当前持久化的列状态（透传给列设置面板） */
+    columnState?: PersistedColumnState[];
+    /** 全屏状态（由父组件传入，控制图标切换） */
+    isFullscreen?: boolean;
+    /** 选中数量（跨页模式下为全量数，普通模式下为当前页数） */
+    selectionCount?: number;
+    /** 是否启用跨页选择 */
+    hasCrossPageSelection?: 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;
+    refresh: () => any;
+    "clear-filter": () => any;
+    "clear-selection": () => any;
+    "density-change": (size: "default" | "small" | "middle") => any;
+    "column-setting": () => any;
+    "column-change": (columns: PersistedColumnState[]) => any;
+    "column-reset": () => any;
+    "toggle-bordered": () => any;
+    "toggle-striped": () => any;
+    fullscreen: () => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    onExport?: (() => any) | undefined;
+    onRefresh?: (() => any) | undefined;
+    "onClear-filter"?: (() => any) | undefined;
+    "onClear-selection"?: (() => any) | undefined;
+    "onDensity-change"?: ((size: "default" | "small" | "middle") => any) | undefined;
+    "onColumn-setting"?: (() => any) | undefined;
+    "onColumn-change"?: ((columns: PersistedColumnState[]) => any) | undefined;
+    "onColumn-reset"?: (() => any) | undefined;
+    "onToggle-bordered"?: (() => any) | undefined;
+    "onToggle-striped"?: (() => any) | undefined;
+    onFullscreen?: (() => any) | undefined;
+}>, {
+    size: "small" | "middle" | "default";
+    toolbarConfig: {
+        bordered?: boolean;
+        striped?: boolean;
+        refresh?: boolean;
+        density?: boolean;
+        fullscreen?: boolean;
+        columnSetting?: boolean;
+        export?: boolean;
+        clearFilter?: boolean;
+        import?: boolean;
+        viewManager?: boolean;
+    };
+    isFullscreen: 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;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,25 @@
+export { useQueryParams } from './useQueryParams';
+export type { UseQueryParamsOptions, UseQueryParamsReturn } from './useQueryParams';
+export { useBwRowEdit } from './useBwRowEdit';
+export type { UseBwRowEditOptions, UseBwRowEditReturn } from './useBwRowEdit';
+export { useBwRowSelection } from './useBwRowSelection';
+export type { UseBwRowSelectionOptions, UseBwRowSelectionReturn } from './useBwRowSelection';
+export { useExportExcel } from './useExportExcel';
+export type { UseExportExcelOptions, UseExportExcelReturn } from './useExportExcel';
+export { useImportExcel } from './useImportExcel';
+export type { UseImportExcelOptions, UseImportExcelReturn } from './useImportExcel';
+export { usePersistence } from './usePersistence';
+export type { UsePersistenceOptions, UsePersistenceReturn } from './usePersistence';
+export { useContextMenu } from './useContextMenu';
+export type { UseContextMenuOptions, UseContextMenuReturn, ContextMenuState } from './useContextMenu';
+export { useDragSort } from './useDragSort';
+export type { UseDragSortOptions, UseDragSortReturn } from './useDragSort';
+export { useBwKeyboard } from './useBwKeyboard';
+export type { UseBwKeyboardOptions, UseBwKeyboardReturn } from './useBwKeyboard';
+export { useTableView } from './useTableView';
+export type { UseTableViewOptions, UseTableViewReturn } from './useTableView';
+export { useBwPermission } from './useBwPermission';
+export type { UseBwPermissionOptions, UseBwPermissionReturn, MaskType } from './useBwPermission';
+export { useColumnHeaderSearch } from './useColumnHeaderSearch';
+export type { UseColumnHeaderSearchOptions, UseColumnHeaderSearchReturn } from './useColumnHeaderSearch';
+export { useLocale, mergeLocale, BW_PRO_TABLE_LOCALE_KEY } from './useLocale';

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

@@ -0,0 +1,44 @@
+import { type Ref } from 'vue';
+export interface UseBwKeyboardOptions {
+    /** 数据源长度 */
+    dataLength: Ref<number> | number;
+    /** 列数量 */
+    columnCount?: number;
+}
+export interface FocusedCell {
+    rowIndex: number;
+    colIndex: number;
+}
+export interface UseBwKeyboardReturn {
+    /** 当前聚焦单元格 */
+    focusedCell: Ref<FocusedCell | null>;
+    /** 粘贴的文本值 */
+    copiedValue: Ref<string | null>;
+    /** 键盘事件处理 */
+    onKeydown: (e: KeyboardEvent, context?: {
+        rowIndex: number;
+        colIndex: number;
+    }) => void;
+    /** 聚焦单元格 */
+    focusCell: (rowIndex: number, colIndex: number) => void;
+    /** 清除焦点 */
+    clearFocus: () => void;
+    /** 当前是否处于编辑态（Enter 键行为切换：保存 vs 进入行编辑） */
+    editable: Ref<boolean>;
+    /** 进入单元格编辑回调 (rowIndex, colIndex) */
+    onEditCell: Ref<((rowIndex: number, colIndex: number) => void) | null>;
+    /** 保存当前编辑回调 (rowIndex, colIndex) */
+    onSaveEdit: Ref<((rowIndex: number, colIndex: number) => void) | null>;
+    /** 取消当前编辑回调 */
+    onCancelEdit: Ref<(() => void) | null>;
+    /** 删除行回调 (rowIndex) */
+    onDeleteCell: Ref<((rowIndex: number) => void) | null>;
+    /** Enter 键在非编辑态时的行操作回调 (rowIndex) */
+    onEnterRow: Ref<((rowIndex: number) => void) | null>;
+}
+/**
+ * useBwKeyboard — 键盘操作 composable
+ *
+ * 支持方向键导航、Tab切换、Enter/Escape编辑、Ctrl+C/V 复制粘贴。
+ */
+export declare function useBwKeyboard(options: UseBwKeyboardOptions): UseBwKeyboardReturn;

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

@@ -0,0 +1,50 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { ProColumnsType } from '../types';
+export interface UseBwPermissionOptions {
+    /** 列定义 */
+    columns: Ref<ProColumnsType> | ComputedRef<ProColumnsType>;
+    /**
+     * 当前用户的权限列表（不传则所有列/操作均视为有权限）
+     *
+     * @example
+     * // 从 Pinia store 传入：
+     * const userStore = useUserStore();
+     * useBwPermission({ columns, permissions: computed(() => userStore.role?.permissions ?? []) });
+     */
+    permissions?: Ref<{
+        name: string;
+    }[]> | ComputedRef<{
+        name: string;
+    }[]>;
+}
+export interface UseBwPermissionReturn {
+    /** 过滤后的列（仅显示有权限的列） */
+    authorizedColumns: ComputedRef<ProColumnsType>;
+    /** 检查操作是否有权限 */
+    hasActionPermission: (authority?: string | string[]) => boolean;
+    /** 检查列是否有权限 */
+    hasColumnPermission: (column: any) => boolean;
+    /** 数据脱敏 */
+    maskValue: (value: string, type?: MaskType) => string;
+}
+/** 脱敏类型 */
+export type MaskType = 'phone' | 'email' | 'idcard' | 'bankcard' | 'name';
+/**
+ * useBwPermission — 权限控制 composable
+ *
+ * 不依赖项目特定 Store，通过 permissions 参数注入权限列表。
+ * 支持列权限过滤、操作权限检查、数据脱敏。
+ *
+ * @example
+ * ```ts
+ * import { useBwPermission } from '@/components/bw-pro-table';
+ * import { useUserStore } from '@/store/user';
+ *
+ * const userStore = useUserStore();
+ * const { authorizedColumns } = useBwPermission({
+ *   columns,
+ *   permissions: computed(() => userStore.role?.permissions ?? []),
+ * });
+ * ```
+ */
+export declare function useBwPermission(options: UseBwPermissionOptions): UseBwPermissionReturn;

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

@@ -0,0 +1,83 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { EditConfig, ProColumnsType } from '../types';
+export interface UseBwRowEditOptions<RecordType = any> {
+    /** 全量数据源 */
+    dataSource: Ref<RecordType[]>;
+    /** 列定义 */
+    columns: Ref<ProColumnsType<RecordType>> | ComputedRef<ProColumnsType<RecordType>>;
+    /** 行 key 属性名 */
+    rowKey?: string;
+    /** 编辑配置 */
+    editConfig?: Ref<EditConfig<RecordType> | undefined>;
+    /** 保存回调 */
+    onSave?: (record: RecordType, isNew: boolean) => Promise<void>;
+    /** 删除回调 */
+    onDelete?: (keys: (string | number)[]) => Promise<void>;
+}
+export interface UseBwRowEditReturn<RecordType = any> {
+    /** 当前处于编辑态的行 keys */
+    editingKeys: Ref<Set<string | number>>;
+    /** cellEditing — key -> field set（单元格编辑模式） */
+    cellEditing: Ref<Map<string | number, Set<string>>>;
+    /** 是否为行编辑模式 */
+    isRowEditing: (key: string | number) => boolean;
+    /** 是否为单元格编辑模式 */
+    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;
+    /** 新增空行 */
+    addRow: (position?: 'top' | 'bottom') => void;
+    /** 克隆行 */
+    cloneRow: (key: string | number) => void;
+    /** 保存编辑 */
+    saveEdit: (key: string | number) => Promise<boolean>;
+    /** 取消编辑 */
+    cancelEdit: (key: string | number) => void;
+    /** 删除行 */
+    deleteRow: (key: string | number) => Promise<void>;
+    /** 批量删除 */
+    deleteRows: (keys: (string | number)[]) => Promise<void>;
+    /** 校验指定行 */
+    validateRow: (key: string | number) => Promise<{
+        valid: boolean;
+        errors: Record<string, string>;
+    }>;
+    /** 获取字段校验错误 */
+    getFieldError: (key: string | number, field: string) => string | undefined;
+    /** 撤销 */
+    undo: () => void;
+    /** 重做 */
+    redo: () => void;
+    /** 是否有可撤销操作 */
+    canUndo: ComputedRef<boolean>;
+    /** 是否有可重做操作 */
+    canRedo: ComputedRef<boolean>;
+    /** 批量编辑选中行 */
+    batchEdit: (keys: (string | number)[], field: string, value: any) => Promise<void>;
+    /** 批量编辑弹窗状态 */
+    batchEditVisible: Ref<boolean>;
+    /** 打开批量编辑弹窗 */
+    openBatchEdit: () => void;
+    /** 关闭批量编辑弹窗 */
+    closeBatchEdit: () => void;
+    /** 是否有未保存的新增行 */
+    hasUncommittedNew: ComputedRef<boolean>;
+}
+/**
+ * useBwRowEdit — 行内编辑 composable
+ *
+ * 支持：
+ * - 单元格编辑 / 整行编辑两种模式
+ * - 草稿数据管理（draftData Map）
+ * - 表单校验（formRules）
+ * - 撤销/重做（Command Pattern）
+ * - 批量编辑弹窗
+ * - Ctrl+S 保存 / Escape 取消
+ */
+export declare function useBwRowEdit<RecordType extends Record<string, any> = any>(options: UseBwRowEditOptions<RecordType>): UseBwRowEditReturn<RecordType>;

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

@@ -0,0 +1,42 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { TableRowSelection } from 'ant-design-vue/es/table/interface';
+export interface UseBwRowSelectionOptions<RecordType = any> {
+    /** 全量数据源 */
+    dataSource: Ref<RecordType[]> | ComputedRef<RecordType[]>;
+    /** 行 key 属性名 */
+    rowKey?: string;
+    /** 最大选中数量 */
+    maxSelect?: number;
+    /** 选中类型 */
+    type?: 'checkbox' | 'radio';
+}
+export interface UseBwRowSelectionReturn<RecordType = any> {
+    /** 选中的 keys */
+    selectedRowKeys: Ref<(string | number)[]>;
+    /** 选中的行数据 */
+    selectedRows: Ref<RecordType[]>;
+    /** 行选择配置（可直接传给 a-table rowSelection） */
+    rowSelection: ComputedRef<TableRowSelection<RecordType>>;
+    /** 是否有选中项 */
+    hasSelection: ComputedRef<boolean>;
+    /** 选中数量 */
+    selectionCount: ComputedRef<number>;
+    /** 是否全选 */
+    isAllSelected: ComputedRef<boolean>;
+    /** 全选/取消全选 */
+    toggleSelectAll: () => void;
+    /** 清除选中 */
+    clearSelection: () => void;
+    /** 设置选中 */
+    setSelected: (keys: (string | number)[], rows?: RecordType[]) => void;
+}
+/**
+ * useBwRowSelection — 行选择 composable
+ *
+ * 支持：
+ * - 多选/单选
+ * - 跨页保留选中（preserveSelectedRowKeys）
+ * - 选中上限限制
+ * - 批量操作栏状态
+ */
+export declare function useBwRowSelection<RecordType extends Record<string, any> = any>(options: UseBwRowSelectionOptions<RecordType>): UseBwRowSelectionReturn<RecordType>;

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

@@ -0,0 +1,28 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { ProColumnsType, FilterValue } from '../types';
+export interface UseColumnHeaderSearchOptions<RecordType = any> {
+    /** 列定义 */
+    columns: Ref<ProColumnsType<RecordType>> | ComputedRef<ProColumnsType<RecordType>>;
+}
+export interface UseColumnHeaderSearchReturn {
+    /** 列筛选值 */
+    columnFilters: Ref<Record<string, FilterValue | null>>;
+    /** 更新列筛选 */
+    setColumnFilter: (field: string, value: FilterValue | null) => void;
+    /** 清除所有列筛选 */
+    clearAllFilters: () => void;
+    /** 获取活跃筛选标签 */
+    activeFilterTags: ComputedRef<{
+        field: string;
+        label: string;
+        value: any;
+    }[]>;
+    /** 移除指定筛选 */
+    removeFilterTag: (field: string) => void;
+}
+/**
+ * useColumnHeaderSearch — 列头搜索 composable
+ *
+ * 管理列筛选状态、筛选标签显示、一键清除。
+ */
+export declare function useColumnHeaderSearch<RecordType extends Record<string, any> = any>(options: UseColumnHeaderSearchOptions<RecordType>): UseColumnHeaderSearchReturn;

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

@@ -0,0 +1,54 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { ContextMenuItem, ContextMenuType, ContextMenuConfig, ProColumnsType } from '../types';
+export interface ContextMenuState {
+    /** 是否可见 */
+    visible: boolean;
+    /** 菜单类型 */
+    type: ContextMenuType;
+    /** 菜单位置 */
+    x: number;
+    y: number;
+    /** 当前行数据 */
+    record?: any;
+    /** 当前行 key */
+    rowKey?: string | number;
+    /** 当前字段名 */
+    field?: string;
+    /** 当前列配置 */
+    column?: any;
+    /** 菜单项 */
+    items: ContextMenuItem[];
+}
+export interface UseContextMenuOptions {
+    /** 右键菜单配置 */
+    config?: ContextMenuConfig;
+    /** 列定义（用于生成表头菜单默认项） */
+    columns?: Ref<ProColumnsType> | ComputedRef<ProColumnsType>;
+}
+export interface UseContextMenuReturn {
+    /** 菜单状态 */
+    menuState: Ref<ContextMenuState>;
+    /** 显示行右键菜单 */
+    showRowMenu: (e: MouseEvent, record: any, rowKey: string | number) => void;
+    /** 显示单元格右键菜单 */
+    showCellMenu: (e: MouseEvent, record: any, rowKey: string | number, field: string, value: any) => void;
+    /** 显示表头右键菜单 */
+    showHeaderMenu: (e: MouseEvent, column: any, field: string) => void;
+    /** 隐藏菜单 */
+    hideMenu: () => void;
+    /** 菜单点击处理 */
+    onMenuClick: (key: string, handler?: (ctx: any) => void) => void;
+    /** 内置菜单项处理 */
+    handleBuiltinAction: (key: string) => void;
+}
+/**
+ * useContextMenu — 右键菜单状态管理 composable
+ *
+ * 支持三种上下文菜单：
+ * - 行右键菜单（customRow onContextmenu）
+ * - 单元格右键菜单（customCell onContextmenu）
+ * - 表头右键菜单（customHeaderCell onContextmenu）
+ *
+ * 菜单定位使用 event.clientX/Y（fixed 定位）。
+ */
+export declare function useContextMenu(options?: UseContextMenuOptions): UseContextMenuReturn;

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

@@ -0,0 +1,36 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { DragConfig, ProColumnsType } from '../types';
+export interface UseDragSortOptions<RecordType = any> {
+    /** 数据源 */
+    dataSource: Ref<RecordType[]>;
+    /** 列定义 */
+    columns?: Ref<ProColumnsType<RecordType>> | ComputedRef<ProColumnsType<RecordType>>;
+    /** 拖拽配置 */
+    dragConfig?: Ref<DragConfig | undefined>;
+    /** 拖拽结束回调 */
+    onRowDragEnd?: (fromIndex: number, toIndex: number) => void;
+}
+export interface UseDragSortReturn {
+    /** 是否正在拖拽 */
+    dragging: Ref<boolean>;
+    /** 拖拽状态 */
+    dragState: Ref<{
+        fromIndex: number;
+        toIndex: number;
+    } | null>;
+    /** 行拖拽开始 */
+    onRowDragStart: (index: number) => void;
+    /** 行拖拽结束 */
+    onRowDragEnd: (toIndex: number) => void;
+    /** 交换行位置 */
+    swapRows: (fromIndex: number, toIndex: number) => void;
+    /** 列拖拽排序 */
+    reorderColumns: (fromIndex: number, toIndex: number) => void;
+}
+/**
+ * useDragSort — 拖拽排序 composable
+ *
+ * 支持行拖拽排序和列拖拽排序。
+ * 使用本地状态管理拖拽过程，不依赖 sortablejs 运行时（需在组件层集成）。
+ */
+export declare function useDragSort<RecordType extends Record<string, any> = any>(options: UseDragSortOptions<RecordType>): UseDragSortReturn;

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

@@ -0,0 +1,35 @@
+import { type Ref } from 'vue';
+import type { ProColumnsType, ExportConfig } from '../types';
+export interface UseExportExcelOptions<RecordType = any> {
+    /** 列定义 */
+    columns: Ref<ProColumnsType<RecordType>>;
+    /** 数据源 */
+    dataSource: Ref<readonly RecordType[]>;
+    /** 导出配置 */
+    exportConfig?: ExportConfig;
+}
+export interface UseExportExcelReturn {
+    /** 导出 Excel */
+    exportExcel: () => Promise<void>;
+    /** 导出 CSV */
+    exportCsv: () => void;
+    /** 导出选中行 */
+    exportSelected: (selectedRows: any[]) => Promise<void>;
+    /** 导出自定义列弹窗 */
+    showColumnSelect: Ref<boolean>;
+    /** 是否正在导出 */
+    exporting: Ref<boolean>;
+    /** 导出进度 */
+    exportProgress: Ref<number>;
+}
+/**
+ * useExportExcel — 导出 composable
+ *
+ * 使用 xlsx (SheetJS) 生成 Excel 文件。
+ * 支持：
+ * - 导出 Excel / CSV
+ * - 导出选中行
+ * - 分片导出（大数据量 + 进度条）
+ * - 自定义列选择导出
+ */
+export declare function useExportExcel<RecordType extends Record<string, any> = any>(options: UseExportExcelOptions<RecordType>): UseExportExcelReturn;

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

@@ -0,0 +1,45 @@
+import { type Ref } from 'vue';
+import type { ImportConfig } from '../types';
+export interface UseImportExcelOptions {
+    /** 导入配置 */
+    importConfig?: ImportConfig;
+}
+export interface UseImportExcelReturn {
+    /** 是否正在导入 */
+    importing: Ref<boolean>;
+    /** 预览数据 */
+    previewData: Ref<any[]>;
+    /** 预览列头 */
+    previewColumns: Ref<string[]>;
+    /** 是否显示预览 */
+    showPreview: Ref<boolean>;
+    /** 列映射 */
+    columnMapping: Ref<Record<string, string>>;
+    /** 校验错误 */
+    validateErrors: Ref<string[]>;
+    /** 打开文件选择 */
+    openFileDialog: () => void;
+    /** 处理文件 */
+    handleFile: (file: File) => Promise<void>;
+    /** 确认导入 */
+    confirmImport: () => Promise<void>;
+    /** 取消 */
+    cancel: () => void;
+    /** 下载模板 */
+    downloadTemplate: (columns: {
+        title: string;
+        dataIndex: string;
+    }[]) => Promise<void>;
+}
+/**
+ * useImportExcel — Excel 导入 composable
+ *
+ * 使用 FileReader + xlsx 解析 Excel 文件。
+ * 支持：
+ * - 预览解析数据
+ * - 列映射配置
+ * - 数据校验
+ * - 导入提交
+ * - 模板下载
+ */
+export declare function useImportExcel(options?: UseImportExcelOptions): UseImportExcelReturn;

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

@@ -0,0 +1,14 @@
+import type { InjectionKey, ComputedRef } from 'vue';
+import type { BwProTableLocale } from '../types';
+/** 注入 Key */
+export declare const BW_PRO_TABLE_LOCALE_KEY: InjectionKey<ComputedRef<BwProTableLocale>>;
+/**
+ * 在 setup 中获取当前生效的语言包。
+ * 必须在 BwProTable 子树内调用（即通过 provide 已提供 locale），否则回退到默认 zh-CN。
+ */
+export declare function useLocale(): ComputedRef<BwProTableLocale>;
+/**
+ * 深度合并自定义 locale 到默认 zh-CN。
+ * 外部传入 Partial<BwProTableLocale>，内部补全缺失字段。
+ */
+export declare function mergeLocale(custom?: Partial<BwProTableLocale>): BwProTableLocale;