stk-table-vue 1.2.0 → 1.2.2

package/lib/{Dropdown-Bq4DxXYJ.js → Dropdown-D40QlY91.js}

@@ -1,12 +1,12 @@
 /**
  * name: stk-table-vue
- * version: v1.2.0
+ * version: v1.2.2
  * description: High performance realtime virtual table for vue3 and vue2.7
  * author: japlus
  * homepage: https://ja-plus.github.io/stk-table-vue/
  * license: MIT
  */
-import { t as StkTable_default } from "./StkTable-yOz9wkCz.js";
+import { t as StkTable_default } from "./StkTable-g_qwf6BE.js";
 import { createElementBlock, createElementVNode, createVNode, defineComponent, h, nextTick, normalizeClass, normalizeStyle, onMounted, onUnmounted, openBlock, reactive, ref, withModifiers } from "vue";
 //#region src/StkTable/custom-cells/FilterCell/Dropdown/index.vue?vue&type=script&setup=true&lang.ts
 var DROPDOWN_DEFAULT_WIDTH = 300;

package/lib/{StkTable-yOz9wkCz.js → StkTable-g_qwf6BE.js}

@@ -1,6 +1,6 @@
 /**
  * name: stk-table-vue
- * version: v1.2.0
+ * version: v1.2.2
  * description: High performance realtime virtual table for vue3 and vue2.7
  * author: japlus
  * homepage: https://ja-plus.github.io/stk-table-vue/
@@ -1646,8 +1646,6 @@ function useFixedStyle(props, isRelativeMode, getFixedColPosition, virtualScroll
 		if ((tagType === TagType.TD || tagType === TagType.TF) && !fixed) return "";
 		const { headerRowHeight, rowHeight } = props;
 		const isFixedLeft = fixed === "left";
-		const { scrollLeft, scrollWidth, offsetLeft, containerWidth } = virtualScrollX.value;
-		const scrollRight = scrollWidth - containerWidth - scrollLeft;
 		let style = "";
 		if (tagType === TagType.TH) if (!isRelativeMode.value) {
 			if (depth) style += `top:${depth * (headerRowHeight ?? rowHeight)}px;`;
@@ -1657,8 +1655,12 @@ function useFixedStyle(props, isRelativeMode, getFixedColPosition, virtualScroll
 			const lr = getFixedColPosition.value(col) + "px";
 			if (isFixedLeft) style += `left:${lr};`;
 			else style += `right:${lr};`;
-		} else if (isFixedLeft) style += `left:${scrollLeft - (virtualX_on.value ? offsetLeft : 0)}px;`;
-		else style += `right:${Math.max(scrollRight - (virtualX_on.value ? virtualX_offsetRight.value : 0), 0)}px;`;
+		} 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 style += `right:${Math.max(scrollRight - (virtualX_on.value ? virtualX_offsetRight.value : 0), 0)}px;`;
+		}
 		return style;
 	}
 	return getFixedStyle;
@@ -2145,6 +2147,109 @@ function useMergeCells(rowActiveProp, tableHeaderLast, rowKeyGen, colKeyGen, vir
 	const activeMergedCells = ref(/* @__PURE__ */ new Set());
 	/** column index cache */
 	let colIndexCache = null;
+	/** 空合并段列表（start 为绝对行索引）。禁止合并时返回共享空数组 */
+	const EMPTY_BLOCKS = [];
+	/** 空下方占位段列表。无下方合并行时返回共享空数组 */
+	const EMPTY_SEGMENTS = [];
+	/**
+	* mergeCellsWrapper 返回值记忆化缓存（WeakMap<行对象, Map<colKey, 结果>>）。
+	* 签名 = 绝对行索引 + 代际（wrapperCacheGen）：窗口/列/视口修正（上方空行段、
+	* 下方占位段、viewportEndIndex、下方行数）任一变化即整体失效。
+	*/
+	const wrapperCache = /* @__PURE__ */ new WeakMap();
+	/** 是否存在合并列（仅依赖列配置，跨滚动帧缓存，不随数据/滚动重算） */
+	const hasMergeColumn = computed(() => tableHeaderLast.value.some((col) => !!col.mergeCells));
+	/**
+	* 视口上方连续「无 td」空行段（行数 >= 2 才成段；单行保留独立 tr）。
+	* 空行判定与渲染保持一致：aboveViewportColumnMap 中列结果为空且非展开行。
+	* 供模板合并渲染（StkTable aboveRenderParts）与 rowspan 属性修正共用。
+	*/
+	const aboveEmptyBlocks = computed(() => {
+		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) => {
+			if (!row || row.__EXP_R__) return false;
+			const cols = colMap.get(rowKeyGen(row));
+			return cols !== void 0 && cols.length === 0;
+		};
+		const blocks = [];
+		let runStart = -1;
+		const flushRun = (endExclusive) => {
+			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(() => {
+		const belowCount = belowViewportRowCount.value;
+		if (belowCount <= 0) return EMPTY_SEGMENTS;
+		const data = virtual_dataSourcePart.value;
+		const { startIndex, viewportEndIndex, endIndex } = virtualScroll.value;
+		const regionEnd = Math.min(endIndex, startIndex + data.length - 1);
+		const columns = virtualX_columnPart.value;
+		const endsSet = /* @__PURE__ */ new Set();
+		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 = [];
+		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 结果缓存。
 	* 缓存键为绝对索引且命中时校验行引用同一性，滚动换窗（virtual_dataSourcePart 变化）
@@ -2159,8 +2264,6 @@ function useMergeCells(rowActiveProp, tableHeaderLast, rowKeyGen, colKeyGen, vir
 	watch([virtual_dataSourcePart, tableHeaderLast], () => {
 		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.
@@ -2260,20 +2363,35 @@ function useMergeCells(rowActiveProp, tableHeaderLast, rowKeyGen, colKeyGen, vir
 	function mergeCellsWrapper(row, col, rowIndex, colIndex) {
 		if (!col.mergeCells) return;
 		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);
+		let rowCache = wrapperCache.get(row);
+		if (!rowCache) {
+			rowCache = /* @__PURE__ */ new Map();
+			wrapperCache.set(row, rowCache);
 		}
-		return {
-			colspan,
-			rowspan: adjustRowspanForMergedRows(absRowIndex, rowspan)
-		};
+		const hit = rowCache.get(colKey);
+		if (hit && hit.absRowIndex === absRowIndex && hit.gen === wrapperCacheGen) return hit.result;
+		const { colspan, rowspan } = mergeCellsCache.getMergeCellsResult(row, col, absRowIndex, colIndex);
+		let result;
+		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;
 	}
 	/**
 	* 渲染用 rowspan 修正：合并占位 tr 代表 N 个逻辑行，但在 DOM 中只算 1 行，
@@ -2395,90 +2513,6 @@ function useMergeCells(rowActiveProp, tableHeaderLast, rowKeyGen, colKeyGen, vir
 		}
 		return map;
 	});
-	/** 空合并段列表（start 为绝对行索引）。禁止合并时返回共享空数组 */
-	const EMPTY_BLOCKS = [];
-	/** 空下方占位段列表。无下方合并行时返回共享空数组 */
-	const EMPTY_SEGMENTS = [];
-	/**
-	* 视口上方连续「无 td」空行段（行数 >= 2 才成段；单行保留独立 tr）。
-	* 空行判定与渲染保持一致：aboveViewportColumnMap 中列结果为空且非展开行。
-	* 供模板合并渲染（StkTable aboveRenderParts）与 rowspan 属性修正共用。
-	*/
-	const aboveEmptyBlocks = computed(() => {
-		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) => {
-			if (!row || row.__EXP_R__) return false;
-			const cols = colMap.get(rowKeyGen(row));
-			return cols !== void 0 && cols.length === 0;
-		};
-		const blocks = [];
-		let runStart = -1;
-		const flushRun = (endExclusive) => {
-			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(() => {
-		const belowCount = belowViewportRowCount.value;
-		if (belowCount <= 0) return EMPTY_SEGMENTS;
-		const data = virtual_dataSourcePart.value;
-		const { startIndex, viewportEndIndex, endIndex } = virtualScroll.value;
-		const regionEnd = Math.min(endIndex, startIndex + data.length - 1);
-		const columns = virtualX_columnPart.value;
-		const endsSet = /* @__PURE__ */ new Set();
-		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 = [];
-		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, rowKey) {
 		if (!rowActiveProp.value.enabled) return;
 		if (clear) {
@@ -2785,14 +2819,15 @@ var SORT_SWITCH_ORDER = [
 * 排序 Hook
 * 管理表格排序状态和相关操作
 * @param props 表格 props
-* @param colKeyGen 列 key 生成函数
+* @param colKeyGen 列 key 生成函数 
 * @param tableHeaderLast 表头最后一行（叶子节点）
 * @param dataSourceCopy 数据源副本 ref
 * @param initDataSource 初始化数据源函数
 * @param emits 事件发射函数
+* @param onDataSourceChange 数据源变化后的刷新回调（重算虚拟滚动等，见 #80）
 * @returns 排序相关状态和方法
 */
-function useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, initDataSource) {
+function useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, initDataSource, onDataSourceChange) {
 	/** 多列排序状态数组 */
 	const sortStates = ref([]);
 	/** 是否启用多列排序 */
@@ -2922,7 +2957,10 @@ function useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, ini
 			...col.sortConfig
 		};
 		const order = updateSortState(col, sortConfig);
-		if (!props.sortRemote) initDataSource();
+		if (!props.sortRemote) {
+			initDataSource();
+			onDataSourceChange();
+		}
 		emits("sort-change", col, order, toRaw(dataSourceCopy.value), sortConfig);
 	}
 	/**
@@ -2950,7 +2988,10 @@ function useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, ini
 			}, newOption.append && isMultiSort.value ? 1 : 0);
 		} else sortStates.value = [];
 		if (newOption.sort && ((_dataSourceCopy$value = dataSourceCopy.value) === null || _dataSourceCopy$value === void 0 ? void 0 : _dataSourceCopy$value.length)) {
-			if (!props.sortRemote || newOption.force) initDataSource(props.dataSource, { forceSort: newOption.force });
+			if (!props.sortRemote || newOption.force) {
+				initDataSource(props.dataSource, { forceSort: newOption.force });
+				onDataSourceChange();
+			}
 		}
 		if (!newOption.silent) {
 			if (!column) column = newOption.sortOption || tableHeaderLast.value.find((it) => colKeyGenValue(it) === colKey);
@@ -2965,6 +3006,7 @@ function useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, ini
 	function resetSorter() {
 		sortStates.value = [];
 		initDataSource();
+		onDataSourceChange();
 	}
 	/**
 	* 处理默认排序
@@ -3613,6 +3655,9 @@ function useColWidthCache(getColWidth) {
 }
 /** vue2 优化滚动回收延时 */
 var VUE2_SCROLL_TIMEOUT_MS = 200;
+/** 静默字段常量（模块级复用，避免每次滚动帧分配数组）；relative 模式不静默（见 assignVs 注释） */
+var SILENT_Y_KEYS = ["scrollTop"];
+var SILENT_X_KEYS = ["scrollLeft"];
 /**
 * 合并单元格可视范围修正的最大迭代次数。
 * 合法（不重叠）的合并配置最多 2 轮即收敛（1 轮扩展 + 1 轮验证）；
@@ -3623,7 +3668,7 @@ var MAX_MERGE_RANGE_EXPAND_ITERATIONS = 8;
 * virtual scroll
 * @returns
 */
-function useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, tableHeaderLast, tableHeaders, rowKeyGen, maxRowSpan, getMaxRowSpanValue, scrollbarOptions, isExperimentalScrollY, mergeCellsCache) {
+function useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, tableHeaderLast, tableHeaders, rowKeyGen, maxRowSpan, getMaxRowSpanValue, scrollbarOptions, isExperimentalScrollY, isRelativeMode, mergeCellsCache) {
 	const tableHeaderHeight = computed(() => props.headerRowHeight * tableHeaders.value.length);
 	const virtualScroll = shallowRef({
 		containerHeight: 0,
@@ -3982,15 +4027,20 @@ function useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, table
 	* shallowRef 内部属性变更不会触发响应式，必须手动 triggerRef；但无条件触发会让
 	* 「值未变」的调用也强制整表重渲染（每帧滚动多付 1~5ms 渲染成本）。
 	* 本函数恢复 Vue 深响应式 ref 的 hasChanged 语义，滚动重算回到 0.02ms 级。
+	*
+	* silentKeys：写入 store 但不参与 triggerRef 判定的字段。滚动位置（scrollTop/scrollLeft）
+	* 每帧必变且模板不直接消费，静默写入使「滚动窗口（startIndex/endIndex）未变」的帧
+	* 完全跳过组件重渲染（消费方均在滚动处理函数中即时读取 .value）。
+	* relative 固定模式例外：useFixedStyle 的样式计算响应式依赖滚动位置，该模式下不静默。
 	*/
-	function assignVs(ref, patch) {
+	function assignVs(ref, patch, silentKeys) {
 		const store = ref.value;
 		let changed = false;
 		for (const key in patch) {
 			const k = key;
 			if (store[k] !== patch[k]) {
 				store[k] = patch[k];
-				changed = true;
+				if (!(silentKeys === null || silentKeys === void 0 ? void 0 : silentKeys.includes(k))) changed = true;
 			}
 		}
 		if (changed) triggerRef(ref);
@@ -4142,14 +4192,15 @@ function useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, table
 			}
 		}
 		vsValue.scrollTop = sTop;
-		assignVs(virtualScroll, vsValue);
+		assignVs(virtualScroll, vsValue, isRelativeMode.value ? void 0 : SILENT_Y_KEYS);
 		if (!virtual_on.value) {
+			const lastIdx = Math.max(0, dataLength - 1);
 			assignVs(virtualScroll, {
 				startIndex: 0,
-				endIndex: 0,
+				endIndex: lastIdx,
 				offsetTop: 0,
 				viewportStartIndex: 0,
-				viewportEndIndex: 0
+				viewportEndIndex: lastIdx
 			});
 			return;
 		}
@@ -4228,7 +4279,7 @@ function useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, table
 		}
 		startIndex = Math.max(0, startIndex);
 		endIndex = Math.min(endIndex, dataLength);
-		if (startIndex >= endIndex) startIndex = endIndex - pageSize;
+		if (startIndex >= endIndex) startIndex = Math.max(0, endIndex - pageSize);
 		if (vue2ScrollYTimeout) window.clearTimeout(vue2ScrollYTimeout);
 		let offsetTop = 0;
 		if (autoRowHeight || hasExpandCol.value) offsetTop = autoRowHeightTop;
@@ -4305,17 +4356,18 @@ function useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, table
 		}
 		endIndex = Math.min(endIndex, headerLength);
 		if (vue2ScrollXTimeout) window.clearTimeout(vue2ScrollXTimeout);
+		const silentXKeys = isRelativeMode.value ? void 0 : SILENT_X_KEYS;
 		if (!props.optimizeVue2Scroll || sLeft <= scrollLeft) assignVs(virtualScrollX, {
 			startIndex,
 			endIndex,
 			offsetLeft,
 			scrollLeft: sLeft
-		});
+		}, silentXKeys);
 		else {
 			assignVs(virtualScrollX, {
 				endIndex,
 				scrollLeft: sLeft
-			});
+			}, silentXKeys);
 			vue2ScrollXTimeout = window.setTimeout(() => {
 				assignVs(virtualScrollX, {
 					startIndex,
@@ -4703,7 +4755,7 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 			return (_props$experimental = props.experimental) === null || _props$experimental === void 0 ? void 0 : _props$experimental.scrollY;
 		});
 		const rowKeyGenCache = /* @__PURE__ */ new WeakMap();
-		const [sortStates, sortCol, onColumnSort, setSorter, resetSorter, getSortColumns, dealDefaultSorter, getColumnSortState, sortData] = useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, initDataSource);
+		const [sortStates, sortCol, onColumnSort, setSorter, resetSorter, getSortColumns, dealDefaultSorter, getColumnSortState, sortData] = useSorter(props, emits, colKeyGen, tableHeaderLast, dataSourceCopy, initDataSource, onDataSourceChange);
 		const [isSRBRActive] = useScrollRowByRow(props, tableContainerRef);
 		const [onThDragStart, onThDragOver, onThDrop, isHeaderDraggable] = useThDrag(props, emits, colKeyGen);
 		const [onTrDragStart, onTrDragEnter, onTrDragOver, onTrDrop, onTrDragEnd] = useTrDrag(props, emits, dataSourceCopy);
@@ -4714,7 +4766,7 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 		* 且可跨滚动帧复用（数据/列变化时才清空）。
 		*/
 		const mergeCellsCache = createMergeCellsCache();
-		const [virtualScroll, virtualScrollX, virtual_on, virtual_dataSourcePart, virtual_offsetBottom, virtualX_on, virtualX_offsetRight, tableHeaderHeight, initVirtualScroll, initVirtualScrollY, initVirtualScrollX, updateVirtualScrollY, updateVirtualScrollX, setAutoHeight, clearAllAutoHeight, getRowsHeight, clearColWidthCache, virtualX_tableHeaders, expandRowColspan, theadVirtualX, virtualX_columnPart, virtualX_expandColSegments, getRowHeightCacheInfo] = useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, tableHeaderLast, tableHeaders, rowKeyGen, maxRowSpan, getMaxRowSpanValue, scrollbarOptions, isExperimentalScrollY, mergeCellsCache);
+		const [virtualScroll, virtualScrollX, virtual_on, virtual_dataSourcePart, virtual_offsetBottom, virtualX_on, virtualX_offsetRight, tableHeaderHeight, initVirtualScroll, initVirtualScrollY, initVirtualScrollX, updateVirtualScrollY, updateVirtualScrollX, setAutoHeight, clearAllAutoHeight, getRowsHeight, clearColWidthCache, virtualX_tableHeaders, expandRowColspan, theadVirtualX, virtualX_columnPart, virtualX_expandColSegments, getRowHeightCacheInfo] = useVirtualScroll(props, tableContainerRef, trRef, dataSourceCopy, tableHeaderLast, tableHeaders, rowKeyGen, maxRowSpan, getMaxRowSpanValue, scrollbarOptions, isExperimentalScrollY, isRelativeMode, mergeCellsCache);
 		/** requestAnimationFrame throttled version of updateVirtualScrollY for smoother wheel scrolling */
 		const rafUpdateVirtualScrollYForWheel = rafThrottle(updateVirtualScrollY);
 		const [scrollbar, showScrollbar, onVerticalScrollbarMouseDown, onHorizontalScrollbarMouseDown, updateCustomScrollbar] = useScrollbar(props, tableContainerRef, virtualScroll, virtualScrollX, updateVirtualScrollY, scrollbarOptions, isExperimentalScrollY);
@@ -4871,6 +4923,7 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 			dealDefaultSorter();
 		});
 		async function onDataSourceChange() {
+			updateMaxRowSpan();
 			await nextTick();
 			initVirtualScrollY();
 			updateCustomScrollbar();
@@ -4885,7 +4938,10 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 		function setFilter(status, option) {
 			status = status || {};
 			filterStatus.value = status;
-			if (!(option === null || option === void 0 ? void 0 : option.remote)) initDataSource();
+			if (!(option === null || option === void 0 ? void 0 : option.remote)) {
+				initDataSource();
+				onDataSourceChange();
+			}
 			if (!(option === null || option === void 0 ? void 0 : option.silent)) emits("filter-change", status);
 		}
 		function filterDataSource(dataSource) {
@@ -5097,11 +5153,11 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 				title: getHeaderTitle(col),
 				class: [
 					col.sorter ? "sortable" : "",
-					isSorted && "sorter-" + (sortState === null || sortState === void 0 ? void 0 : sortState.order),
+					isSorted ? "sorter-" + (sortState === null || sortState === void 0 ? void 0 : 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(" ")
 			};
 		}
 		function getTFProps(col) {
@@ -5114,7 +5170,7 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 					fixedColClassMap.value.get(colKey),
 					col.type === "seq" ? "seq-column" : "",
 					col.align === "center" ? "text-c" : col.align === "right" ? "text-r" : ""
-				]
+				].filter(Boolean).join(" ")
 			};
 		}
 		function getTDProps(row, col, rowIndex, colIndex) {
@@ -5136,7 +5192,7 @@ var StkTable_default = /* @__PURE__ */ defineComponent({
 			return {
 				"data-col-key": colKey,
 				style: cellStyleMap.value[TagType.TD].get(colKey),
-				class: classList,
+				class: classList.filter(Boolean).join(" "),
 				...mergeCellsWrapper(row, col, rowIndex, col.__LF_S__ ?? 0)
 			};
 		}

package/lib/src/StkTable/useSorter.d.ts

@@ -10,11 +10,12 @@ import { Order, SortOption, SortState, StkTableColumn, UniqKey } from './types/i
  * @param dataSourceCopy 数据源副本 ref
  * @param initDataSource 初始化数据源函数
  * @param emits 事件发射函数
+ * @param onDataSourceChange 数据源变化后的刷新回调（重算虚拟滚动等，见 #80）
  * @returns 排序相关状态和方法
  */
 export declare function useSorter<DT extends Record<string, any>>(props: any, emits: any, colKeyGen: Ref<(col: StkTableColumn<DT>) => string>, tableHeaderLast: Ref<StkTableColumn<DT>[]>, dataSourceCopy: Ref<DT[]>, initDataSource: (data?: DT[], option?: {
     forceSort?: boolean;
-}) => void): readonly [Ref<{
+}) => void, onDataSourceChange: () => void): readonly [Ref<{
     key?: any;
     dataIndex: import('vue').UnwrapRef<keyof DT & string>;
     sortField?: import('vue').UnwrapRef<keyof DT> | undefined;

package/lib/src/StkTable/useVirtualScroll.d.ts

@@ -17,7 +17,11 @@ export type VirtualScrollStore = {
     rowHeight: number;
     /** 表格定位上边距 */
     offsetTop: number;
-    /** 纵向滚动条位置，用于判断是横向滚动还是纵向 */
+    /**
+     * 纵向滚动条位置，用于判断是横向滚动还是纵向。
+     * 静默字段：非 relative 模式下写入不触发 triggerRef（滚动窗口未变的帧零重渲染），
+     * 不得在响应式上下文（computed/模板/watch）中依赖此字段。
+     */
     scrollTop: number;
     /** 总滚动高度 */
     scrollHeight: number;
@@ -39,7 +43,10 @@ export type VirtualScrollXStore = {
     endIndex: number;
     /** 表格定位左边距 */
     offsetLeft: number;
-    /** 横向滚动位置，用于判断是横向滚动还是纵向 */
+    /**
+     * 横向滚动位置，用于判断是横向滚动还是纵向。
+     * 静默字段：非 relative 模式下写入不触发 triggerRef，不得在响应式上下文中依赖此字段。
+     */
     scrollLeft: number;
 };
 /**
@@ -49,6 +56,8 @@ export type VirtualScrollXStore = {
 export declare function useVirtualScroll(props: any, tableContainerRef: Ref<HTMLElement | undefined>, trRef: Ref<HTMLTableRowElement[] | undefined>, dataSourceCopy: ShallowRef<PrivateRowDT[]>, tableHeaderLast: ShallowRef<PrivateStkTableColumn<PrivateRowDT>[]>, tableHeaders: ShallowRef<PrivateStkTableColumn<PrivateRowDT>[][]>, rowKeyGen: RowKeyGen, maxRowSpan: Map<UniqKey, number>, 
 /** 全局最大 rowspan（限定跨界修正扫描范围用） */
 getMaxRowSpanValue: () => number, scrollbarOptions: Ref<Required<ScrollbarOptions>>, isExperimentalScrollY: Ref<boolean | undefined>, 
+/** relative 固定模式的样式（useFixedStyle）以响应式方式依赖 scrollTop/scrollLeft，该模式下保留滚动位置的响应式触发 */
+isRelativeMode: Ref<boolean>, 
 /** mergeCells 结果共享缓存（与 useMergeCells 共用，避免重复调用用户回调） */
 mergeCellsCache: MergeCellsCache): readonly [ShallowRef<VirtualScrollStore, VirtualScrollStore>, ShallowRef<VirtualScrollXStore, VirtualScrollXStore>, import('vue').ComputedRef<any>, import('vue').ComputedRef<PrivateRowDT[]>, import('vue').ComputedRef<number>, import('vue').ComputedRef<any>, import('vue').ComputedRef<number>, import('vue').ComputedRef<number>, (height?: number) => void, (height?: number) => void, () => void, (sTop?: number) => void, (sLeft?: number) => void, (rowKey: UniqKey, height?: number | null) => void, () => void, (count: number) => number, () => void, import('vue').ComputedRef<PrivateStkTableColumn<PrivateRowDT>[][]>, import('vue').ComputedRef<number>, import('vue').ComputedRef<{
     startIndex: number;

package/lib/stk-table-vue.js

@@ -1,12 +1,12 @@
 /**
  * name: stk-table-vue
- * version: v1.2.0
+ * version: v1.2.2
  * description: High performance realtime virtual table for vue3 and vue2.7
  * author: japlus
  * homepage: https://ja-plus.github.io/stk-table-vue/
  * license: MIT
  */
-import { a as insertToOrderedArray, i as binarySearch, n as registerFeature, o as strCompare, r as useAreaSelection, s as tableSort, t as StkTable_default } from "./StkTable-yOz9wkCz.js";
+import { a as insertToOrderedArray, i as binarySearch, n as registerFeature, o as strCompare, r as useAreaSelection, s as tableSort, t as StkTable_default } from "./StkTable-g_qwf6BE.js";
 import { Fragment, computed, createApp, createBlock, createElementBlock, createElementVNode, createTextVNode, defineComponent, getCurrentInstance, h, markRaw, nextTick, normalizeClass, openBlock, ref, renderSlot, resolveDynamicComponent, toDisplayString, watch, withModifiers } from "vue";
 //#region src/StkTable/custom-cells/FilterCell/Dropdown/index.ts
 var DropdownIns = null;
@@ -15,7 +15,7 @@ async function getDropdownIns() {
 		const div = document.createElement("div");
 		div.classList.add("stk-filter-dropdown-wrapper");
 		document.body.appendChild(div);
-		DropdownIns = createApp(await import("./Dropdown-Bq4DxXYJ.js").then((module) => module.default)).mount(div);
+		DropdownIns = createApp(await import("./Dropdown-D40QlY91.js").then((module) => module.default)).mount(div);
 	}
 	return DropdownIns;
 }