foucui 1.0.1

package/dist/components/QiuTable/types.d.ts

@@ -0,0 +1,353 @@
+/** QiuTable 列配置（props.columns） */
+export interface QiuTableColumnConfig {
+    /** 列标题（同 title，优先 label） */
+    label?: string;
+    /** vxe 别名，与 label 等价 */
+    title?: string;
+    prop?: string;
+    field?: string;
+    /** 固定列宽；与 minWidth 同时存在时以 width 为准 */
+    width?: string | number;
+    /** 最小列宽；未设 width 时作为弹性列下限，并可参与剩余宽度分配 */
+    minWidth?: string | number;
+    /** 最大列宽；拖拽与自适应时的上限 */
+    maxWidth?: string | number;
+    fixed?: boolean | 'left' | 'right';
+    sortable?: boolean | string;
+    /** 开启筛选；未传 filters 时按当前列数据自动生成选项 */
+    filterable?: boolean;
+    align?: 'left' | 'center' | 'right';
+    footerAlign?: 'left' | 'center' | 'right';
+    /**
+     * 编辑器类型（与 type 二选一，优先 editor）
+     * switch | select | input | number | date | datetime | text
+     */
+    editor?: 'switch' | 'select' | 'input' | 'number' | 'date' | 'datetime' | 'time' | 'text';
+    /**
+     * 完整编辑渲染对象（优先于 editor / type）
+     * 对齐 vxe editRender：{ name, props, options, events, attrs, enabled }
+     */
+    editRender?: string | QiuTableEditRender;
+    /**
+     * selection/index/seq，或编辑器类型别名
+     */
+    type?: string;
+    editorProps?: Record<string, any>;
+    options?: {
+        label: string;
+        value: any;
+    }[];
+    slot?: string;
+    formatter?: (row: any, column: QiuTableColumnConfig, cellValue: any) => string;
+    editable?: boolean;
+    filters?: {
+        text: string;
+        value: any;
+    }[];
+    filterMethod?: (value: any, row: any, column: QiuTableColumnConfig) => boolean;
+    treeNode?: boolean;
+    dragSort?: boolean;
+    showOverflowTooltip?: boolean;
+    className?: string;
+    headerClassName?: string;
+    footerClassName?: string;
+    headerAlign?: 'left' | 'center' | 'right';
+    /** 多级表头子列（父子列自动合并表头单元格） */
+    children?: QiuTableColumnConfig[];
+    /** 表尾格式化 */
+    footerFormatter?: (params: {
+        column: QiuTableColumnConfig;
+        items: any[];
+        data: any[];
+        rowIndex: number;
+    }) => string;
+    /** 快捷聚合：sum | avg | count（配合 showFooter） */
+    aggFunc?: 'sum' | 'avg' | 'count';
+    resizable?: boolean;
+    /** 全局 formats 名称，或列内 formatter 优先 */
+    format?: string;
+    /** 全局 renderer 名称 */
+    cellRender?: string | {
+        name: string;
+        props?: Record<string, any>;
+    };
+    /** 自定义列面板中是否默认可见 */
+    visible?: boolean;
+    /** 透传业务参数 */
+    params?: Record<string, any>;
+}
+/** 列 editRender 完整对象 */
+export interface QiuTableEditRender {
+    /** 内置：input/select/number/date/datetime/time/switch/text；或 QiuTableEditRenderer 注册名 */
+    name: string;
+    props?: Record<string, any>;
+    options?: {
+        label: string;
+        value: any;
+    }[];
+    attrs?: Record<string, any>;
+    events?: Record<string, (...args: any[]) => void>;
+    /** false 时禁用编辑 */
+    enabled?: boolean;
+    autofocus?: string | boolean;
+}
+/** @deprecated 使用 QiuTableColumnConfig */
+export type QiuTableColumn = QiuTableColumnConfig;
+export interface QiuTableRegisteredColumn {
+    id: symbol;
+    props: Record<string, any>;
+    slots: {
+        default?: (scope: QiuTableCellScope) => any;
+        header?: (scope: QiuTableHeaderScope) => any;
+    };
+}
+export interface QiuTableCellScope {
+    row: any;
+    column: QiuTableColumnConfig;
+    $index: number;
+    cellValue: any;
+    level?: number;
+}
+export interface QiuTableHeaderScope {
+    column: QiuTableColumnConfig;
+}
+export interface QiuTableFlatRow {
+    row: any;
+    level: number;
+    hasChildren: boolean;
+    expanded: boolean;
+    flatIndex: number;
+}
+export interface QiuTableRegisterContext {
+    register: (col: QiuTableRegisteredColumn) => void;
+    unregister: (id: symbol) => void;
+    update: (col: QiuTableRegisteredColumn) => void;
+}
+export interface QiuTableEditConfig {
+    trigger?: 'click' | 'dblclick' | 'manual' | 'always';
+    mode?: 'cell' | 'row';
+    showIcon?: boolean;
+    /** 点击表格外自动清除编辑态，默认 true */
+    autoClear?: boolean;
+}
+export interface QiuTableSortConfig {
+    /** true：不本地排序，仅抛 sort-change */
+    remote?: boolean;
+    multiple?: boolean;
+    chronological?: boolean;
+    defaultSort?: {
+        field?: string;
+        prop?: string;
+        order?: 'asc' | 'desc' | null;
+    } | {
+        field?: string;
+        prop?: string;
+        order?: 'asc' | 'desc' | null;
+    }[];
+    trigger?: 'default' | 'cell';
+}
+export interface QiuTableRadioConfig {
+    highlight?: boolean;
+    checkRowKey?: string | number;
+    strict?: boolean;
+    trigger?: 'default' | 'row' | 'cell';
+}
+export interface QiuTableExpandConfig {
+    expandAll?: boolean;
+    accordion?: boolean;
+    lazy?: boolean;
+    labelField?: string;
+}
+export interface QiuTableColumnDragConfig {
+    enabled?: boolean;
+    showIcon?: boolean;
+}
+export interface QiuTableKeepSourceConfig {
+    enabled?: boolean;
+}
+export interface QiuTableFilterConfig {
+    /** true：不本地过滤，仅抛 filter-change */
+    remote?: boolean;
+}
+export interface QiuTableRowConfig {
+    /** 点击高亮当前行，默认 true */
+    isCurrent?: boolean;
+    /** 鼠标悬停高亮，默认 true */
+    isHover?: boolean;
+    /** vxe 别名 → isHover */
+    highlightHoverRow?: boolean;
+    /** vxe 别名 → isCurrent */
+    highlightCurrentRow?: boolean;
+    height?: number;
+    keyField?: string;
+}
+/** 键盘行为（对齐 vxe keyboardConfig） */
+export interface QiuTableKeyboardConfig {
+    /** ↑↓ 移动当前行 / 活动单元格，默认 true */
+    isArrow?: boolean;
+    /** Enter 进入编辑，默认 true（需 editable） */
+    isEnter?: boolean;
+    /** Esc 退出编辑，默认 true */
+    isEsc?: boolean;
+    /** Tab 横向移动单元格，默认 false */
+    isTab?: boolean;
+    /** Ctrl+Z / Ctrl+Y 撤销重做，默认 true（需 historyConfig 开启） */
+    isUndo?: boolean;
+    /** 编辑时方向键是否仍导航，默认 false */
+    isEdit?: boolean;
+}
+/** 剪贴板（对齐 vxe clipboardConfig） */
+export interface QiuTableClipboardConfig {
+    /** Ctrl+C 复制选区，默认 true */
+    isCopy?: boolean;
+    /** Ctrl+X 剪切，默认 true */
+    isCut?: boolean;
+    /** Ctrl+V 粘贴，默认 true */
+    isPaste?: boolean;
+}
+/** 溢出提示（对齐 vxe tooltipConfig） */
+export interface QiuTableTooltipConfig {
+    /** 全局开启溢出 tooltip，默认 true */
+    showAll?: boolean;
+    /** 主题：light | dark */
+    theme?: 'light' | 'dark';
+    /** 进入延迟 ms */
+    enterDelay?: number;
+    /** 离开延迟 ms */
+    leaveDelay?: number;
+    /** 自定义内容；返回 null 则不显示 */
+    contentMethod?: (params: {
+        row: any;
+        column: QiuTableColumnConfig;
+        cellValue: any;
+    }) => string | null | undefined;
+}
+/** 导出配置对象（对齐 vxe exportConfig） */
+export interface QiuTableExportConfig {
+    filename?: string;
+    /** 默认格式 */
+    type?: 'csv' | 'xls' | 'xlsx';
+    sheetName?: string;
+    /** 导出模式：当前页 / 全部 / 选中 / 指定页码范围 */
+    mode?: 'current' | 'all' | 'selected' | 'range';
+    modes?: Array<'current' | 'all' | 'selected' | 'range'>;
+    /** 范围导出起始页（从 1 开始，mode=range 时有效） */
+    startPage?: number;
+    /** 范围导出结束页（从 1 开始，mode=range 时有效） */
+    endPage?: number;
+    /** 打开导出前 */
+    beforeExportMethod?: (params: {
+        options: QiuTableExportConfig;
+    }) => void | boolean | Promise<void | boolean>;
+    /** 导出后 */
+    afterExportMethod?: (params: {
+        options: QiuTableExportConfig;
+    }) => void;
+    /** 列过滤 */
+    columnFilterMethod?: (params: {
+        column: QiuTableColumnConfig;
+    }) => boolean;
+}
+/** 自定义工具栏工具 */
+export interface QiuTableToolbarTool {
+    /** 唯一名称 */
+    name: string;
+    /** 渲染组件；传入组件对象 */
+    component?: any;
+    /** 透传给组件的 props */
+    props?: Record<string, any>;
+    /** 位置：left | center | right，默认 right */
+    position?: 'left' | 'center' | 'right';
+    /** 排序权重 */
+    order?: number;
+}
+/** 工具栏配置对象（对齐 vxe toolbarConfig） */
+export interface QiuTableToolbarConfig {
+    enabled?: boolean;
+    /** 刷新按钮，默认 true */
+    refresh?: boolean;
+    /** 导出按钮，默认 true */
+    export?: boolean;
+    /** 导入按钮，默认 false */
+    import?: boolean;
+    /** 打印按钮，默认 false */
+    print?: boolean;
+    /** 列自定义按钮，默认 true */
+    custom?: boolean;
+    /** 全屏按钮，默认 true */
+    zoom?: boolean;
+    /** Excel 复制按钮，默认 false */
+    copy?: boolean;
+    /** 内置工具按钮的位置，默认 right */
+    toolsPlacement?: 'left' | 'center' | 'right';
+    /** 自定义工具插件 */
+    customTools?: QiuTableToolbarTool[];
+}
+/** 编辑历史（undo/redo） */
+export interface QiuTableHistoryConfig {
+    /** 默认 false；设 true 或配合 keyboardConfig.isUndo */
+    enabled?: boolean;
+    /** 栈深度，默认 50 */
+    size?: number;
+}
+/** 解析行 hover 是否开启 */
+export declare function resolveRowHover(cfg?: QiuTableRowConfig): boolean;
+/** 解析当前行高亮是否开启 */
+export declare function resolveRowCurrent(cfg?: QiuTableRowConfig): boolean;
+/** 解析列 editRender 对象 */
+export declare function resolveEditRender(col: Pick<QiuTableColumnConfig, 'editRender' | 'editor' | 'type' | 'editorProps' | 'options'>): QiuTableEditRender | undefined;
+export interface QiuTableColumnConfigExtra {
+    resizable?: boolean;
+    /** 未指定列宽时的默认最小宽 */
+    minWidth?: number;
+    /** 默认最大宽 */
+    maxWidth?: number;
+    /** 默认固定宽 */
+    width?: number;
+}
+export interface QiuTableMergeCell {
+    row: number;
+    col: number;
+    rowspan: number;
+    colspan: number;
+}
+export type QiuTableSpanMethod = (params: {
+    row: any;
+    column: QiuTableColumnConfig;
+    rowIndex: number;
+    columnIndex: number;
+    data: any[];
+}) => {
+    rowspan: number;
+    colspan: number;
+} | [number, number] | number[] | null | undefined;
+export interface QiuTablePagerConfig {
+    enabled?: boolean;
+    currentPage?: number;
+    pageSize?: number;
+    pageSizes?: number[];
+    total?: number;
+    layouts?: string[];
+    background?: boolean;
+    small?: boolean;
+}
+export interface QiuTableFooterMethodParams {
+    columns: QiuTableColumnConfig[];
+    data: any[];
+}
+export type QiuTableFooterMethod = (params: QiuTableFooterMethodParams) => string[][];
+export interface QiuTableHeaderCell {
+    column: QiuTableColumnConfig & {
+        _key: string;
+    };
+    label: string;
+    colspan: number;
+    rowspan: number;
+    isLeaf: boolean;
+    colIndex: number;
+}
+export declare const QIU_TABLE_REGISTER_KEY: unique symbol;
+export declare const QIU_EDITOR_TYPES: Set<string>;
+export declare const QIU_SPECIAL_COL_TYPES: Set<string>;
+export declare function resolveColumnEditor(col: Pick<QiuTableColumnConfig, 'editor' | 'type' | 'editRender'>): QiuTableColumnConfig['editor'] | string | undefined;
+export declare function resolveColumnProp(col: QiuTableColumnConfig): string | undefined;

package/dist/components/QiuTable/useArea.d.ts

@@ -0,0 +1,51 @@
+import { Ref } from 'vue';
+import { QiuTableColumnConfig } from './types';
+export type QiuTableCellPos = {
+    rowId: string;
+    /** 叶子列 prop / field */
+    prop: string;
+    rowIndex: number;
+    colIndex: number;
+};
+/**
+ * 键盘/剪贴板活动单元格与矩形选区
+ */
+export declare function useTableArea(opts: {
+    getRows: () => any[];
+    getColumns: () => (QiuTableColumnConfig & {
+        _key: string;
+    })[];
+    getRowId: (row: any) => string;
+}): {
+    activeCell: Ref<QiuTableCellPos | null>;
+    areaEnd: Ref<{
+        rowId: string;
+        prop: string;
+        rowIndex: number;
+        colIndex: number;
+    }, QiuTableCellPos | {
+        rowId: string;
+        prop: string;
+        rowIndex: number;
+        colIndex: number;
+    }>;
+    areaBounds: globalThis.ComputedRef<{
+        r0: number;
+        r1: number;
+        c0: number;
+        c1: number;
+    }>;
+    setActive: (row: any, col: QiuTableColumnConfig, extend?: boolean) => void;
+    clearArea: () => void;
+    isCellInArea: (row: any, col: QiuTableColumnConfig) => boolean;
+    isActiveCell: (row: any, col: QiuTableColumnConfig) => boolean;
+    moveActive: (dRow: number, dCol: number, extend?: boolean) => {
+        row: any;
+        prop: string;
+        pos: QiuTableCellPos;
+    };
+    buildTsv: (formatCell: (row: any, prop: string) => string) => string;
+    pasteTsv: (text: string, apply: (row: any, prop: string, value: string) => void) => void;
+    clearAreaValues: (apply: (row: any, prop: string, value: string) => void) => void;
+    findPos: (rowId: string, prop: string) => QiuTableCellPos | null;
+};

package/dist/components/QiuTable/useColumns.d.ts

@@ -0,0 +1,67 @@
+import { QiuTableColumnConfig, QiuTableHeaderCell } from './types';
+export type LeafColumn = QiuTableColumnConfig & {
+    _key: string;
+    _defaultSlot?: (scope: any) => any;
+    _headerSlot?: (scope: any) => any;
+};
+/** 解析列宽为像素；百分比需传入 containerWidth */
+export declare function parseWidth(w?: string | number, containerWidth?: number): number;
+export declare function colStyle(col: LeafColumn): Record<string, string>;
+export type ColumnSizeHints = {
+    /** 显式 width（固定列宽） */
+    fixedWidth: number;
+    minWidth: number;
+    maxWidth: number;
+    /** 无 width，仅靠 minWidth 参与剩余空间分配 */
+    isFlex: boolean;
+};
+export declare function getColumnSizeHints(col: LeafColumn, containerWidth?: number, defaults?: {
+    minWidth?: number;
+    maxWidth?: number;
+}): ColumnSizeHints;
+/**
+ * 计算每列最终渲染宽度（对齐 vxe：width 固定；仅 minWidth 的列吃剩余空间）
+ * resized 优先
+ */
+export declare function computeRenderWidths(leafColumns: LeafColumn[], opts: {
+    containerWidth: number;
+    showSelection: boolean;
+    showIndex: boolean;
+    showRadio?: boolean;
+    showExpand?: boolean;
+    fit?: boolean;
+    resized?: Record<string, number>;
+    defaults?: {
+        minWidth?: number;
+        maxWidth?: number;
+    };
+}): Record<string, number>;
+export declare function computeTableMinWidth(leafColumns: LeafColumn[], opts: {
+    showSelection: boolean;
+    showIndex: boolean;
+    showRadio?: boolean;
+    showExpand?: boolean;
+}, 
+/** 优先用最终渲染宽 / 拖拽宽 */
+resolveWidth?: (col: LeafColumn) => number | undefined, defaults?: {
+    minWidth?: number;
+    maxWidth?: number;
+}): number;
+export declare function leftOffsetForColumn(leafColumns: LeafColumn[], colKey: string, opts: {
+    showSelection: boolean;
+    showIndex: boolean;
+    showRadio?: boolean;
+    showExpand?: boolean;
+}, resolveWidth?: (col: LeafColumn) => number): number;
+export declare function rightOffsetForColumn(leafColumns: LeafColumn[], colKey: string, resolveWidth?: (col: LeafColumn) => number): number;
+/** 是否左侧固定列中的最后一列（用于阴影） */
+export declare function isLastFixedLeft(leafColumns: LeafColumn[], colKey: string): boolean;
+/** 是否右侧固定列中的第一列（从右往左的最内侧，用于阴影） */
+export declare function isFirstFixedRight(leafColumns: LeafColumn[], colKey: string): boolean;
+/** 生成稳定且唯一的列 key（同 prop 多列也不会冲突） */
+export declare function makeColumnKey(col: QiuTableColumnConfig, index: number, prefix?: string): string;
+export { makeColumnKey as createColumnKey };
+/** 扁平化叶子列（跳过仅分组的父列） */
+export declare function flattenLeafColumns(columns: QiuTableColumnConfig[], prefix?: string): LeafColumn[];
+/** 生成多级表头矩阵（每行一组 th） */
+export declare function buildHeaderRows(columns: QiuTableColumnConfig[], keyPrefix?: string): QiuTableHeaderCell[][];

package/dist/components/QiuTable/useEdit.d.ts

@@ -0,0 +1,36 @@
+import { Ref } from 'vue';
+import { QiuTableColumnConfig, QiuTableEditConfig } from './types';
+export declare function useTableEdit(opts: {
+    editable: Ref<boolean> | (() => boolean);
+    editTrigger: Ref<string> | (() => string);
+    editConfig: Ref<QiuTableEditConfig | undefined> | (() => QiuTableEditConfig | undefined);
+    getRowId: (row: any) => string;
+    emit: (event: string, payload: any) => void;
+}): {
+    editing: Ref<{
+        rowId: string;
+        prop: string;
+    }, {
+        rowId: string;
+        prop: string;
+    } | {
+        rowId: string;
+        prop: string;
+    }>;
+    getColEditor: (col: QiuTableColumnConfig) => string;
+    getEditRender: (col: QiuTableColumnConfig) => import('./types').QiuTableEditRender;
+    getProp: (col: QiuTableColumnConfig) => string;
+    canEditCol: (col: QiuTableColumnConfig) => boolean;
+    hasAlwaysEditor: (col: QiuTableColumnConfig) => boolean;
+    isInputEditor: (col: QiuTableColumnConfig) => boolean;
+    isEditing: (row: any, col: QiuTableColumnConfig) => boolean;
+    isInputFill: (row: any, col: QiuTableColumnConfig) => boolean;
+    startEdit: (row: any, col: QiuTableColumnConfig, focusRoot?: HTMLElement | null) => void;
+    clearEdit: () => void;
+    commitEdit: (row: any, col: QiuTableColumnConfig, value: any) => void;
+    inEditGuard: () => boolean;
+    getTrigger: () => string;
+    getMode: () => "cell" | "row";
+    getAutoClear: () => boolean;
+    getShowIcon: () => boolean;
+};

package/dist/components/QiuTable/useExtras.d.ts

@@ -0,0 +1,38 @@
+import { Ref } from 'vue';
+/** 行展开（非树） */
+export declare function useExpandRows(opts: {
+    getRowId: (row: any) => string;
+}): {
+    expanded: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    isRowExpand: (row: any) => boolean;
+    toggleRowExpand: (row: any) => void;
+    setRowExpand: (rows: any[], checked: boolean) => void;
+    clearRowExpand: () => void;
+};
+/** 单选 radio */
+export declare function useRadioRow(opts: {
+    getRowId: (row: any) => string;
+}): {
+    radioRowId: Ref<string, string>;
+    isRadioChecked: (row: any) => boolean;
+    setRadioRow: (row: any | null) => void;
+    clearRadioRow: () => void;
+};
+/** keepSource 脏数据追踪 */
+export declare function useKeepSource(opts: {
+    enabled: () => boolean;
+    getRowId: (row: any) => string;
+    data: Ref<any[]> | (() => any[]);
+}): {
+    snapshot: () => void;
+    isUpdateByRow: (row: any) => boolean;
+    getUpdateRecords: () => any[];
+    getInsertRecords: () => any[];
+    reloadRow: (row: any) => void;
+    sourceMap: Record<string, string>;
+};
+export type SortItem = {
+    prop: string;
+    order: 'asc' | 'desc';
+};
+export declare function compareRows(a: any, b: any, sorts: SortItem[]): number;

package/dist/components/QiuTable/useHistory.d.ts

@@ -0,0 +1,44 @@
+export type QiuTableHistoryPatch = {
+    rowId: string;
+    prop: string;
+    oldValue: any;
+    newValue: any;
+};
+/**
+ * 单元格编辑 undo/redo 栈
+ */
+export declare function useTableHistory(opts: {
+    enabled: () => boolean;
+    size?: () => number;
+    findRow: (rowId: string) => any | null;
+    onApply?: (patch: QiuTableHistoryPatch, direction: 'undo' | 'redo') => void;
+}): {
+    undoStack: globalThis.Ref<{
+        rowId: string;
+        prop: string;
+        oldValue: any;
+        newValue: any;
+    }[], QiuTableHistoryPatch[] | {
+        rowId: string;
+        prop: string;
+        oldValue: any;
+        newValue: any;
+    }[]>;
+    redoStack: globalThis.Ref<{
+        rowId: string;
+        prop: string;
+        oldValue: any;
+        newValue: any;
+    }[], QiuTableHistoryPatch[] | {
+        rowId: string;
+        prop: string;
+        oldValue: any;
+        newValue: any;
+    }[]>;
+    push: (patch: QiuTableHistoryPatch) => void;
+    undo: () => boolean;
+    redo: () => boolean;
+    clear: () => void;
+    canUndo: () => boolean;
+    canRedo: () => boolean;
+};

package/dist/components/QiuTable/useMerge.d.ts

@@ -0,0 +1,28 @@
+import { QiuTableColumnConfig, QiuTableMergeCell, QiuTableSpanMethod } from './types';
+export type SpanResult = {
+    rowspan: number;
+    colspan: number;
+    visible: boolean;
+};
+/**
+ * 根据 spanMethod / mergeCells 计算单元格合并。
+ * columnIndex 为叶子数据列下标（不含 selection/index）。
+ */
+export declare function resolveCellSpan(opts: {
+    row: any;
+    column: QiuTableColumnConfig;
+    rowIndex: number;
+    columnIndex: number;
+    data: any[];
+    spanMethod?: QiuTableSpanMethod;
+    mergeCells?: QiuTableMergeCell[];
+    /** 预计算：被合并覆盖的格子 key `${rowIndex}:${columnIndex}` */
+    covered?: Set<string>;
+}): SpanResult;
+/** 根据 mergeCells 生成被覆盖格子集合 */
+export declare function buildMergeCoveredSet(mergeCells?: QiuTableMergeCell[]): Set<string>;
+/**
+ * 将 mergeHeaderCells 应用到表头矩阵（按 row/col 下标合并 th）
+ * children 多级表头已自动合并；本 API 用于扁平表头额外合并。
+ */
+export declare function applyMergeHeaderCells(headerRows: import('./types').QiuTableHeaderCell[][], merges?: QiuTableMergeCell[]): import('./types').QiuTableHeaderCell[][];

package/dist/components/QiuTable/useResize.d.ts

@@ -0,0 +1,19 @@
+import { Ref } from 'vue';
+/** 列宽拖拽：写入 columnWidths，供 colgroup / 单元格样式使用 */
+export declare function useColumnResize(opts?: {
+    minWidth?: number;
+    maxWidth?: number;
+}): {
+    columnWidths: Record<string, number>;
+    getWidth: (key: string, fallback?: string | number) => number;
+    onResizeStart: (key: string, currentWidth: number, e: MouseEvent, bounds?: {
+        minWidth?: number;
+        maxWidth?: number;
+    }) => void;
+    setColumnWidth: (key: string, width: number) => void;
+};
+export declare function bindAutoClearEdit(opts: {
+    rootRef: Ref<HTMLElement | null>;
+    enabled: () => boolean;
+    clearEdit: () => void;
+}): void;

package/dist/components/QiuTable/useScrollSync.d.ts

@@ -0,0 +1,25 @@
+import { Ref } from 'vue';
+/**
+ * 表头 / 表体 / 表尾横向滚动同步。
+ * 对齐策略（双表经典坑）：
+ * 1. 量出 body 纵向滚动条占用
+ * 2. header/footer wrap 用 paddingRight 留出同宽空隙
+ * 3. 强制 header/footer 内 table 的像素宽 = body table 宽
+ * 4. 把 body 各 col 的实际像素宽抄到 header/footer
+ * 5. 有纵向条时由根节点 --qiu-table-v-scrollbar + --scroll-y 在 padding 内侧补竖线
+ *
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+export declare function useScrollSync(opts: {
+    headerWrapRef: Ref<HTMLElement | null>;
+    bodyWrapRef: Ref<HTMLElement | null>;
+    footerWrapRef: Ref<HTMLElement | null>;
+    onLayoutChange?: () => void;
+}): {
+    scrollbarSize: Ref<number, number>;
+    measureScrollbar: () => void;
+    syncFromBody: () => void;
+    scheduleLayout: () => void;
+};