stk-table-vue 1.2.1 → 1.2.2

package/src/StkTable/StkTable.vue

@@ -882,6 +882,7 @@ const [sortStates, sortCol, onColumnSort, setSorter, resetSorter, getSortColumns
     tableHeaderLast,
     dataSourceCopy,
     initDataSource,
+    onDataSourceChange,
 );
 
 const [isSRBRActive] = useScrollRowByRow(props, tableContainerRef);
@@ -936,6 +937,7 @@ const [
     getMaxRowSpanValue,
     scrollbarOptions,
     isExperimentalScrollY,
+    isRelativeMode,
     mergeCellsCache,
 );
 
@@ -1219,6 +1221,8 @@ onMounted(() => {
 });
 
 async function onDataSourceChange() {
+    // 数据顺序/行数变化后重算 rowspan 映射（排序后 mergeCells 的 rowIndex 会变化）
+    updateMaxRowSpan();
     await nextTick();
     initVirtualScrollY();
     updateCustomScrollbar();
@@ -1250,6 +1254,9 @@ function setFilter(
     filterStatus.value = status;
     if (!option?.remote) {
         initDataSource();
+        // #80：筛选改变 dataSourceCopy 后重算虚拟滚动窗口，
+        // 否则残留 startIndex/endIndex/scrollHeight 会导致只渲染 1 行或空白视口
+        onDataSourceChange();
     }
     if (!option?.silent) {
         emits('filter-change', status);
@@ -1525,14 +1532,16 @@ function getTHProps(col: PrivateStkTableColumn<DT>) {
         colspan: col.__C_SP__,
         style: cellStyleMap.value[TagType.TH].get(colKey),
         title: getHeaderTitle(col),
+        // class 用预拼接字符串（而非数组），降低每格 vnode diff 与 GC 开销
         class: [
             col.sorter ? 'sortable' : '',
-            isSorted && 'sorter-' + sortState?.order,
+            isSorted ? 'sorter-' + sortState?.order : '',
             col.headerClassName,
             fixedColClassMap.value.get(colKey),
-            col.headerAlign &&
-                (col.headerAlign === 'left' ? 'text-l' : col.headerAlign === 'right' ? 'text-r' : col.headerAlign === 'center' ? 'text-c' : null),
-        ],
+            col.headerAlign === 'left' ? 'text-l' : col.headerAlign === 'right' ? 'text-r' : col.headerAlign === 'center' ? 'text-c' : '',
+        ]
+            .filter(Boolean)
+            .join(' '),
     };
 }
 
@@ -1546,7 +1555,9 @@ function getTFProps(col: StkTableColumn<DT>) {
             fixedColClassMap.value.get(colKey),
             col.type === 'seq' ? 'seq-column' : '',
             col.align === 'center' ? 'text-c' : col.align === 'right' ? 'text-r' : '',
-        ],
+        ]
+            .filter(Boolean)
+            .join(' '),
     };
 }
 
@@ -1596,7 +1607,7 @@ function getTDProps(row: PrivateRowDT | null | undefined, col: StkTableColumn<Pr
     return {
         'data-col-key': colKey,
         style: cellStyleMap.value[TagType.TD].get(colKey),
-        class: classList,
+        class: classList.filter(Boolean).join(' '),
         ...mergeCellsWrapper(row, col, rowIndex, (col as PrivateStkTableColumn<DT>).__LF_S__ ?? 0),
     };
 }
@@ -2090,7 +2101,8 @@ function scrollTo(options?: ScrollToOptions | number | null, leftArg?: number |
     if (top === null && left === null) return;
     // 钳制到合法滚动范围（基于理论内容尺寸，与滚动条语义一致）
     if (top !== null) top = Math.min(Math.max(top, 0), getMaxScrollTop());
-    if (left !== null) left = Math.min(Math.max(left, 0), Math.max(0, getColLeft(tableHeaderLast.value.length) - virtualScrollX.value.containerWidth));
+    if (left !== null)
+        left = Math.min(Math.max(left, 0), Math.max(0, getColLeft(tableHeaderLast.value.length) - virtualScrollX.value.containerWidth));
     if (options.behavior === 'smooth') {
         smoothScrollTo(top, left);
     } else {

package/src/StkTable/useFixedStyle.ts

@@ -34,8 +34,6 @@ export function useFixedStyle<DT extends Record<string, any>>(
 
         const { headerRowHeight, rowHeight } = props;
         const isFixedLeft = fixed === 'left';
-        const { scrollLeft, scrollWidth, offsetLeft, containerWidth } = virtualScrollX.value;
-        const scrollRight = scrollWidth - containerWidth - scrollLeft;
 
         let style = '';
 
@@ -60,6 +58,8 @@ export function useFixedStyle<DT extends Record<string, any>>(
                     style += `right:${lr};`;
                 }
             } else {
+                const { scrollLeft, scrollWidth, offsetLeft, containerWidth } = virtualScrollX.value;
+                const scrollRight = scrollWidth - containerWidth - scrollLeft;
                 if (isFixedLeft) {
                     style += `left:${scrollLeft - (virtualX_on.value ? offsetLeft : 0)}px;`;
                 } else {

package/src/StkTable/useMergeCells.ts

@@ -48,6 +48,131 @@ export function useMergeCells(
 
     /** column index cache */
     let colIndexCache: Map<UniqKey, number> | null = null;
+    /** 空合并段列表（start 为绝对行索引）。禁止合并时返回共享空数组 */
+    const EMPTY_BLOCKS: { start: number; count: number }[] = [];
+
+    /** 空下方占位段列表。无下方合并行时返回共享空数组 */
+    const EMPTY_SEGMENTS: { count: number }[] = [];
+
+    /**
+     * mergeCellsWrapper 返回值记忆化缓存（WeakMap<行对象, Map<colKey, 结果>>）。
+     * 签名 = 绝对行索引 + 代际（wrapperCacheGen）：窗口/列/视口修正（上方空行段、
+     * 下方占位段、viewportEndIndex、下方行数）任一变化即整体失效。
+     */
+    const wrapperCache = new WeakMap<
+        object,
+        Map<UniqKey, { absRowIndex: number; gen: number; result: { colspan?: number; rowspan?: number } | undefined }>
+    >();
+
+    /** 是否存在合并列（仅依赖列配置，跨滚动帧缓存，不随数据/滚动重算） */
+    const hasMergeColumn = computed(() => tableHeaderLast.value.some(col => !!col.mergeCells));
+
+    /**
+     * 视口上方连续「无 td」空行段（行数 >= 2 才成段；单行保留独立 tr）。
+     * 空行判定与渲染保持一致：aboveViewportColumnMap 中列结果为空且非展开行。
+     * 供模板合并渲染（StkTable aboveRenderParts）与 rowspan 属性修正共用。
+     */
+    const aboveEmptyBlocks = computed<{ start: number; count: number }[]>(() => {
+        if (!canMergeEmptyRows.value) return EMPTY_BLOCKS;
+        const data = virtual_dataSourcePart.value;
+        const { startIndex, viewportStartIndex } = virtualScroll.value;
+        const aboveCount = Math.min(data.length, Math.max(0, viewportStartIndex - startIndex));
+        if (aboveCount <= 0) return EMPTY_BLOCKS;
+        const colMap = aboveViewportColumnMap.value;
+
+        const isEmptyRow = (row: PrivateRowDT): boolean => {
+            // 展开行有独立行高且渲染内容，不能参与合并
+            if (!row || row.__EXP_R__) return false;
+            const cols = colMap.get(rowKeyGen(row));
+            // 仅当映射中明确为空列结果时才算空行；缺失（异常）时保留原渲染
+            return cols !== void 0 && cols.length === 0;
+        };
+
+        const blocks: { start: number; count: number }[] = [];
+        let runStart = -1;
+        const flushRun = (endExclusive: number) => {
+            if (endExclusive - runStart >= 2) {
+                blocks.push({ start: startIndex + runStart, count: endExclusive - runStart });
+            }
+            runStart = -1;
+        };
+        for (let i = 0; i < aboveCount; i++) {
+            if (isEmptyRow(data[i])) {
+                if (runStart < 0) runStart = i;
+                continue;
+            }
+            if (runStart >= 0) flushRun(i);
+        }
+        if (runStart >= 0) flushRun(aboveCount);
+        return blocks.length ? blocks : EMPTY_BLOCKS;
+    });
+
+    /**
+     * 视口下方占位段：把 [viewportEndIndex+1, endIndex] 按跨界 rowspan 的
+     * 去重结束行切分为多段，每段渲染一个占位 tr。
+     *
+     * 单个占位 tr 无法表达多个 rowspan 的不同逻辑结束位置（不规律合并下
+     * 多个单元格会塌缩到同一 tr 底边，滚动时高度跳动）；按结束行切段后，
+     * 每个单元格的修正 rowspan 恰好止于包含其逻辑结束行的段。
+     * 超长 rowspan 场景只有一个结束行（= 区域末端），仍只产生 1 段，不增加 DOM。
+     */
+    const belowPhSegments = computed<{ count: number }[]>(() => {
+        const belowCount = belowViewportRowCount.value;
+        if (belowCount <= 0) return EMPTY_SEGMENTS;
+        const data = virtual_dataSourcePart.value;
+        const { startIndex, viewportEndIndex, endIndex } = virtualScroll.value;
+        // 下方区域末端钳制到窗口最后一行（endIndex 可能超出数据长度）
+        const regionEnd = Math.min(endIndex, startIndex + data.length - 1);
+        const columns = virtualX_columnPart.value;
+
+        // 跨界 rowspan 的锚点只可能在视口上方保留行与视口行内，收集其去重结束行
+        const endsSet = new Set<number>();
+        const anchorRowEnd = Math.min(data.length - 1, viewportEndIndex - startIndex);
+        for (let rowOffset = 0; rowOffset <= anchorRowEnd; rowOffset++) {
+            const row = data[rowOffset];
+            if (!row) continue;
+            const absRowIndex = startIndex + rowOffset;
+            for (let colIdx = 0; colIdx < columns.length; colIdx++) {
+                const col = columns[colIdx];
+                if (!col.mergeCells) continue;
+                const leafIndex = col.__LF_S__ ?? colIdx;
+                const { rowspan } = mergeCellsCache.getMergeCellsResult(row, col, absRowIndex, leafIndex);
+                if (rowspan <= 1) continue;
+                const spanEnd = absRowIndex + rowspan - 1;
+                if (spanEnd > viewportEndIndex) endsSet.add(Math.min(spanEnd, regionEnd));
+            }
+        }
+
+        // 兜底：未收集到跨界结束行时保持单段（与合并前行为一致）
+        if (!endsSet.size) return [{ count: belowCount }];
+
+        const ends = Array.from(endsSet).sort((a, b) => a - b);
+        const segments: { count: number }[] = [];
+        let prev = viewportEndIndex;
+        for (let i = 0; i < ends.length; i++) {
+            const count = ends[i] - prev;
+            if (count > 0) segments.push({ count });
+            prev = ends[i];
+        }
+        if (regionEnd > prev) segments.push({ count: regionEnd - prev });
+        return segments;
+    });
+
+    let wrapperCacheGen = 0;
+
+    watch(
+        [
+            virtual_dataSourcePart,
+            tableHeaderLast,
+            aboveEmptyBlocks,
+            belowPhSegments,
+            () => virtualScroll.value.viewportEndIndex,
+            belowViewportRowCount,
+        ],
+        () => {
+            wrapperCacheGen++;
+        },
+    );
 
     /**
      * 数据/列真正变化时才清空 mergeCells 结果缓存。
@@ -65,9 +190,6 @@ export function useMergeCells(
         buildHiddenCellMap();
     });
 
-    /** 是否存在合并列（仅依赖列配置，跨滚动帧缓存，不随数据/滚动重算） */
-    const hasMergeColumn = computed(() => tableHeaderLast.value.some(col => !!col.mergeCells));
-
     /**
      * Pre-build hiddenCellMap and hoverRowMap before rendering to avoid
      * a two-render cycle (null → populated) that causes visual flicker.
@@ -204,21 +326,34 @@ export function useMergeCells(
         // 渲染传入的是切片内相对索引，统一换算为绝对行索引后再调用 mergeCells，
         // 保证与 buildHiddenCellMap / aboveViewportColumnMap 的入参及缓存键一致
         const absRowIndex = virtualScroll.value.startIndex + rowIndex;
-        const { colspan, rowspan } = mergeCellsCache.getMergeCellsResult(row, col, absRowIndex, colIndex);
-
-        if (colspan === 1 && rowspan === 1) return;
-
-        const rowKey = rowKeyGen(row);
         const colKey = colKeyGen.value(col);
-        const mergedCellKey = pureCellKeyGen(rowKey, colKey);
 
-        for (let i = rowIndex; i < rowIndex + rowspan; i++) {
-            const targetRow = virtual_dataSourcePart.value[i];
-            if (!targetRow) break;
-            hideCells(rowKeyGen(targetRow), colKey, colspan, i === rowIndex, mergedCellKey);
+        // 返回值记忆化：命中时跳过 getMergeCellsResult、rowspan 修正循环与对象分配。
+        // hideCells 为幂等写入（buildHiddenCellMap 已在渲染前按相同输入构建），命中时跳过安全。
+        let rowCache = wrapperCache.get(row);
+        if (!rowCache) {
+            rowCache = new Map();
+            wrapperCache.set(row, rowCache);
         }
+        const hit = rowCache.get(colKey);
+        if (hit && hit.absRowIndex === absRowIndex && hit.gen === wrapperCacheGen) return hit.result;
 
-        return { colspan, rowspan: adjustRowspanForMergedRows(absRowIndex, rowspan) };
+        const { colspan, rowspan } = mergeCellsCache.getMergeCellsResult(row, col, absRowIndex, colIndex);
+
+        let result: { colspan?: number; rowspan?: number } | undefined;
+        if (colspan === 1 && rowspan === 1) {
+            result = void 0;
+        } else {
+            const mergedCellKey = pureCellKeyGen(rowKeyGen(row), colKey);
+            for (let i = rowIndex; i < rowIndex + rowspan; i++) {
+                const targetRow = virtual_dataSourcePart.value[i];
+                if (!targetRow) break;
+                hideCells(rowKeyGen(targetRow), colKey, colspan, i === rowIndex, mergedCellKey);
+            }
+            result = { colspan, rowspan: adjustRowspanForMergedRows(absRowIndex, rowspan) };
+        }
+        rowCache.set(colKey, { absRowIndex, gen: wrapperCacheGen, result });
+        return result;
     }
 
     /**
@@ -383,103 +518,6 @@ export function useMergeCells(
         return map;
     });
 
-    /** 空合并段列表（start 为绝对行索引）。禁止合并时返回共享空数组 */
-    const EMPTY_BLOCKS: { start: number; count: number }[] = [];
-
-    /** 空下方占位段列表。无下方合并行时返回共享空数组 */
-    const EMPTY_SEGMENTS: { count: number }[] = [];
-
-    /**
-     * 视口上方连续「无 td」空行段（行数 >= 2 才成段；单行保留独立 tr）。
-     * 空行判定与渲染保持一致：aboveViewportColumnMap 中列结果为空且非展开行。
-     * 供模板合并渲染（StkTable aboveRenderParts）与 rowspan 属性修正共用。
-     */
-    const aboveEmptyBlocks = computed<{ start: number; count: number }[]>(() => {
-        if (!canMergeEmptyRows.value) return EMPTY_BLOCKS;
-        const data = virtual_dataSourcePart.value;
-        const { startIndex, viewportStartIndex } = virtualScroll.value;
-        const aboveCount = Math.min(data.length, Math.max(0, viewportStartIndex - startIndex));
-        if (aboveCount <= 0) return EMPTY_BLOCKS;
-        const colMap = aboveViewportColumnMap.value;
-
-        const isEmptyRow = (row: PrivateRowDT): boolean => {
-            // 展开行有独立行高且渲染内容，不能参与合并
-            if (!row || row.__EXP_R__) return false;
-            const cols = colMap.get(rowKeyGen(row));
-            // 仅当映射中明确为空列结果时才算空行；缺失（异常）时保留原渲染
-            return cols !== void 0 && cols.length === 0;
-        };
-
-        const blocks: { start: number; count: number }[] = [];
-        let runStart = -1;
-        const flushRun = (endExclusive: number) => {
-            if (endExclusive - runStart >= 2) {
-                blocks.push({ start: startIndex + runStart, count: endExclusive - runStart });
-            }
-            runStart = -1;
-        };
-        for (let i = 0; i < aboveCount; i++) {
-            if (isEmptyRow(data[i])) {
-                if (runStart < 0) runStart = i;
-                continue;
-            }
-            if (runStart >= 0) flushRun(i);
-        }
-        if (runStart >= 0) flushRun(aboveCount);
-        return blocks.length ? blocks : EMPTY_BLOCKS;
-    });
-
-    /**
-     * 视口下方占位段：把 [viewportEndIndex+1, endIndex] 按跨界 rowspan 的
-     * 去重结束行切分为多段，每段渲染一个占位 tr。
-     *
-     * 单个占位 tr 无法表达多个 rowspan 的不同逻辑结束位置（不规律合并下
-     * 多个单元格会塌缩到同一 tr 底边，滚动时高度跳动）；按结束行切段后，
-     * 每个单元格的修正 rowspan 恰好止于包含其逻辑结束行的段。
-     * 超长 rowspan 场景只有一个结束行（= 区域末端），仍只产生 1 段，不增加 DOM。
-     */
-    const belowPhSegments = computed<{ count: number }[]>(() => {
-        const belowCount = belowViewportRowCount.value;
-        if (belowCount <= 0) return EMPTY_SEGMENTS;
-        const data = virtual_dataSourcePart.value;
-        const { startIndex, viewportEndIndex, endIndex } = virtualScroll.value;
-        // 下方区域末端钳制到窗口最后一行（endIndex 可能超出数据长度）
-        const regionEnd = Math.min(endIndex, startIndex + data.length - 1);
-        const columns = virtualX_columnPart.value;
-
-        // 跨界 rowspan 的锚点只可能在视口上方保留行与视口行内，收集其去重结束行
-        const endsSet = new Set<number>();
-        const anchorRowEnd = Math.min(data.length - 1, viewportEndIndex - startIndex);
-        for (let rowOffset = 0; rowOffset <= anchorRowEnd; rowOffset++) {
-            const row = data[rowOffset];
-            if (!row) continue;
-            const absRowIndex = startIndex + rowOffset;
-            for (let colIdx = 0; colIdx < columns.length; colIdx++) {
-                const col = columns[colIdx];
-                if (!col.mergeCells) continue;
-                const leafIndex = col.__LF_S__ ?? colIdx;
-                const { rowspan } = mergeCellsCache.getMergeCellsResult(row, col, absRowIndex, leafIndex);
-                if (rowspan <= 1) continue;
-                const spanEnd = absRowIndex + rowspan - 1;
-                if (spanEnd > viewportEndIndex) endsSet.add(Math.min(spanEnd, regionEnd));
-            }
-        }
-
-        // 兜底：未收集到跨界结束行时保持单段（与合并前行为一致）
-        if (!endsSet.size) return [{ count: belowCount }];
-
-        const ends = Array.from(endsSet).sort((a, b) => a - b);
-        const segments: { count: number }[] = [];
-        let prev = viewportEndIndex;
-        for (let i = 0; i < ends.length; i++) {
-            const count = ends[i] - prev;
-            if (count > 0) segments.push({ count });
-            prev = ends[i];
-        }
-        if (regionEnd > prev) segments.push({ count: regionEnd - prev });
-        return segments;
-    });
-
     function updateActiveMergedCells(clear?: boolean, rowKey?: UniqKey) {
         if (!rowActiveProp.value.enabled) return;
         if (clear) {

package/src/StkTable/useSorter.ts

@@ -13,11 +13,12 @@ const SORT_SWITCH_ORDER: Order[] = [null, 'desc', 'asc'] as const;
  * 排序 Hook
  * 管理表格排序状态和相关操作
  * @param props 表格 props
- * @param colKeyGen 列 key 生成函数
+ * @param colKeyGen 列 key 生成函数 
  * @param tableHeaderLast 表头最后一行（叶子节点）
  * @param dataSourceCopy 数据源副本 ref
  * @param initDataSource 初始化数据源函数
  * @param emits 事件发射函数
+ * @param onDataSourceChange 数据源变化后的刷新回调（重算虚拟滚动等，见 #80）
  * @returns 排序相关状态和方法
  */
 export function useSorter<DT extends Record<string, any>>(
@@ -27,6 +28,7 @@ export function useSorter<DT extends Record<string, any>>(
     tableHeaderLast: Ref<StkTableColumn<DT>[]>,
     dataSourceCopy: Ref<DT[]>,
     initDataSource: (data?: DT[], option?: { forceSort?: boolean }) => void,
+    onDataSourceChange: () => void,
 ) {
     /** 多列排序状态数组 */
     const sortStates = ref<SortState<DT>[]>([]);
@@ -182,6 +184,8 @@ export function useSorter<DT extends Record<string, any>>(
 
         if (!props.sortRemote) {
             initDataSource();
+            // #80：排序后数据窗口需重算，否则残留 startIndex/endIndex 会“吃掉”数据
+            onDataSourceChange();
         }
 
         emits('sort-change', col, order, toRaw(dataSourceCopy.value), sortConfig);
@@ -220,6 +224,8 @@ export function useSorter<DT extends Record<string, any>>(
         if (newOption.sort && dataSourceCopy.value?.length) {
             if (!props.sortRemote || newOption.force) {
                 initDataSource(props.dataSource, { forceSort: newOption.force });
+                // #80：与 onColumnSort 一致，排序后重算虚拟滚动窗口
+                onDataSourceChange();
             }
         }
 
@@ -243,6 +249,8 @@ export function useSorter<DT extends Record<string, any>>(
     function resetSorter() {
         sortStates.value = [];
         initDataSource();
+        // #80：重置后同样重算虚拟滚动窗口
+        onDataSourceChange();
     }
 
     /**

package/src/StkTable/useVirtualScroll.ts

@@ -21,7 +21,11 @@ export type VirtualScrollStore = {
     rowHeight: number;
     /** 表格定位上边距 */
     offsetTop: number;
-    /** 纵向滚动条位置，用于判断是横向滚动还是纵向 */
+    /**
+     * 纵向滚动条位置，用于判断是横向滚动还是纵向。
+     * 静默字段：非 relative 模式下写入不触发 triggerRef（滚动窗口未变的帧零重渲染），
+     * 不得在响应式上下文（computed/模板/watch）中依赖此字段。
+     */
     scrollTop: number;
     /** 总滚动高度 */
     scrollHeight: number;
@@ -43,7 +47,10 @@ export type VirtualScrollXStore = {
     endIndex: number;
     /** 表格定位左边距 */
     offsetLeft: number;
-    /** 横向滚动位置，用于判断是横向滚动还是纵向 */
+    /**
+     * 横向滚动位置，用于判断是横向滚动还是纵向。
+     * 静默字段：非 relative 模式下写入不触发 triggerRef，不得在响应式上下文中依赖此字段。
+     */
     scrollLeft: number;
 };
 
@@ -91,6 +98,10 @@ function useColWidthCache<T extends { fixed?: StkTableColumn<PrivateRowDT>['fixe
 /** vue2 优化滚动回收延时 */
 const VUE2_SCROLL_TIMEOUT_MS = 200;
 
+/** 静默字段常量（模块级复用，避免每次滚动帧分配数组）；relative 模式不静默（见 assignVs 注释） */
+const SILENT_Y_KEYS: ['scrollTop'] = ['scrollTop'];
+const SILENT_X_KEYS: ['scrollLeft'] = ['scrollLeft'];
+
 /**
  * 合并单元格可视范围修正的最大迭代次数。
  * 合法（不重叠）的合并配置最多 2 轮即收敛（1 轮扩展 + 1 轮验证）；
@@ -115,6 +126,8 @@ export function useVirtualScroll(
     getMaxRowSpanValue: () => number,
     scrollbarOptions: Ref<Required<ScrollbarOptions>>,
     isExperimentalScrollY: Ref<boolean | undefined>,
+    /** relative 固定模式的样式（useFixedStyle）以响应式方式依赖 scrollTop/scrollLeft，该模式下保留滚动位置的响应式触发 */
+    isRelativeMode: Ref<boolean>,
     /** mergeCells 结果共享缓存（与 useMergeCells 共用，避免重复调用用户回调） */
     mergeCellsCache: MergeCellsCache,
 ) {
@@ -538,15 +551,20 @@ export function useVirtualScroll(
      * shallowRef 内部属性变更不会触发响应式，必须手动 triggerRef；但无条件触发会让
      * 「值未变」的调用也强制整表重渲染（每帧滚动多付 1~5ms 渲染成本）。
      * 本函数恢复 Vue 深响应式 ref 的 hasChanged 语义，滚动重算回到 0.02ms 级。
+     *
+     * silentKeys：写入 store 但不参与 triggerRef 判定的字段。滚动位置（scrollTop/scrollLeft）
+     * 每帧必变且模板不直接消费，静默写入使「滚动窗口（startIndex/endIndex）未变」的帧
+     * 完全跳过组件重渲染（消费方均在滚动处理函数中即时读取 .value）。
+     * relative 固定模式例外：useFixedStyle 的样式计算响应式依赖滚动位置，该模式下不静默。
      */
-    function assignVs<T extends object>(ref: ShallowRef<T>, patch: Partial<T>) {
+    function assignVs<T extends object>(ref: ShallowRef<T>, patch: Partial<T>, silentKeys?: (keyof T)[]) {
         const store = ref.value;
         let changed = false;
         for (const key in patch) {
             const k = key as keyof T;
             if (store[k] !== patch[k]) {
                 store[k] = patch[k] as T[keyof T];
-                changed = true;
+                if (!silentKeys?.includes(k)) changed = true;
             }
         }
         if (changed) triggerRef(ref);
@@ -736,16 +754,21 @@ export function useVirtualScroll(
         }
         vsValue.scrollTop = sTop;
 
-        assignVs(virtualScroll, vsValue);
+        // relative 模式固定表头样式响应式依赖 scrollTop，保留触发；其余模式静默写入
+        assignVs(virtualScroll, vsValue, isRelativeMode.value ? undefined : SILENT_Y_KEYS);
 
         if (!virtual_on.value) {
             // github #34 init
+            // endIndex 重置为最后一行而非 0：virtual_on=false 时虽不参与切片（全量渲染），
+            // 但若后续数据变多而未被重算（如旧版筛选/排序路径，见 #80），残留 endIndex=0
+            // 会使 slice(startIndex, 0+1) 只渲染 1 行；指向末行可让残留窗口覆盖全量数据。
+            const lastIdx = Math.max(0, dataLength - 1);
             assignVs(virtualScroll, {
                 startIndex: 0,
-                endIndex: 0,
+                endIndex: lastIdx,
                 offsetTop: 0,
                 viewportStartIndex: 0,
-                viewportEndIndex: 0,
+                viewportEndIndex: lastIdx,
             });
             return;
         }
@@ -864,8 +887,9 @@ export function useVirtualScroll(
         endIndex = Math.min(endIndex, dataLength);
 
         if (startIndex >= endIndex) {
-            // fallback
-            startIndex = endIndex - pageSize;
+            // fallback（#80：scrollTop 残留超出新数据长度时 endIndex 被钳到 dataLength，
+            // 需回退到末页窗口；钳非负防 pageSize 并常时产生负 startIndex → 负 offsetTop）
+            startIndex = Math.max(0, endIndex - pageSize);
         }
 
         if (vue2ScrollYTimeout) {
@@ -958,13 +982,16 @@ export function useVirtualScroll(
             window.clearTimeout(vue2ScrollXTimeout);
         }
 
+        // relative 模式固定列样式响应式依赖 scrollLeft，保留触发；其余模式静默写入
+        const silentXKeys = isRelativeMode.value ? undefined : SILENT_X_KEYS;
+
         // <= 等于是因为初始化时要赋值
         if (!props.optimizeVue2Scroll || sLeft <= scrollLeft) {
             // 向左滚动
-            assignVs(virtualScrollX, { startIndex, endIndex, offsetLeft, scrollLeft: sLeft });
+            assignVs(virtualScrollX, { startIndex, endIndex, offsetLeft, scrollLeft: sLeft }, silentXKeys);
         } else {
             // vue2 向右滚动优化
-            assignVs(virtualScrollX, { endIndex, scrollLeft: sLeft });
+            assignVs(virtualScrollX, { endIndex, scrollLeft: sLeft }, silentXKeys);
             vue2ScrollXTimeout = window.setTimeout(() => {
                 assignVs(virtualScrollX, { startIndex, offsetLeft });
             }, VUE2_SCROLL_TIMEOUT_MS);

package/lib/src/StkTable/features/useAreaSelection.bak.d.ts

@@ -1,25 +0,0 @@
-import { Ref, ShallowRef } from 'vue';
-import { AreaSelectionConfig, AreaSelectionRange, CellKeyGen, ColKeyGen, StkTableColumn, UniqKey, AreaSelectionSetterRange, AreaSelectionSetterOption } from '../types';
-import { VirtualScrollStore, VirtualScrollXStore } from '../useVirtualScroll';
-
-/**
- * 单元格区域选择功能
- * 支持鼠标拖拽选择、键盘导航、复制粘贴等功能
- * en: Cell area selection feature with mouse drag, keyboard navigation, copy-paste, etc.
- */
-export declare function useAreaSelection<DT extends Record<string, any>>(props: any, emits: any, tableContainerRef: Ref<HTMLDivElement | undefined>, dataSourceCopy: ShallowRef<DT[]>, tableHeaderLast: ShallowRef<StkTableColumn<DT>[]>, colKeyGen: ColKeyGen, cellKeyGen: CellKeyGen, scrollTo: (top: number | null, left: number | null) => void, virtualScroll: Ref<VirtualScrollStore>, virtualScrollX: Ref<VirtualScrollXStore>, getRowIndex: (row: DT) => number, getColumnIndex: (col: StkTableColumn<DT>) => number): {
-    config: import('vue').ComputedRef<AreaSelectionConfig>;
-    isSelecting: Ref<boolean, boolean>;
-    getClass: (cellKey: string, absoluteRowIndex: number, colKey: UniqKey) => string[];
-    getRowClass: (absoluteRowIndex: number) => string[];
-    get: () => {
-        rows: DT[];
-        cols: StkTableColumn<DT>[];
-        ranges: AreaSelectionRange[];
-    };
-    set: (ranges?: AreaSelectionSetterRange<DT>, option?: AreaSelectionSetterOption) => AreaSelectionRange[];
-    clear: () => void;
-    copy: () => string;
-    onMD: (e: MouseEvent) => void;
-};
-export declare const useAreaSelectionName = "useAreaSelection";

package/lib/test/StkTable.browser.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/autoHeightStripe.repro.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/autoRowHeightVirtualScroll.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/defaultSort.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/insertToOrderedArray.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/perf/scrollPerf.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/rowMergeVirtualScroll.repro.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/scrollTo.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/setSorter.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/setTreeExpandParents.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/trReuse.repro.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/test/utils/DragResize.d.ts

@@ -1,28 +0,0 @@
-export default class DragResize {
-    /**
-     *
-     * @param {HTMLElement} el
-     */
-    constructor(el: HTMLElement);
-    buttonSize: {
-        width: number;
-        height: number;
-    };
-    /** @type {ResizeObserver} */
-    resizeObserver: ResizeObserver;
-    /** @type {DOMRect} */
-    targetDOMRect: DOMRect;
-    /** @type {{left:number,top:number}} */
-    resizeButtonStyle: {
-        left: number;
-        top: number;
-    };
-    el: HTMLElement;
-    initData(): void;
-    createResizeButton(): void;
-    resizeButton: HTMLElement | undefined;
-    /** 监听元素大小改变 */
-    onResize(): void;
-    addButtonHoverStyle(): void;
-    addEvent(): void;
-}

package/lib/test/utils/h.d.ts

@@ -1,10 +0,0 @@
-/**
- * createElement function
- * h(tag[, text[,children]])
- * h(tag[, attrs[,children]])
- * h(tag[, children])
- * @param {String} tag 标签名称，支持tag#id.class emmet写法，暂支持id ,class
- * @param {Object | String | Number | Array<HTMLElement>} attrs 传Object为属性，传String为textContent，传数组为children
- * @param {Array<HTMLElement>} children
- */
-export default function h(tag: string, attrs: Object | string | number | Array<HTMLElement>, children: Array<HTMLElement>): HTMLElement;