@veltra/desktop 1.0.8 → 1.0.9

package/dist/components/table/table-row.js

@@ -2,21 +2,68 @@ import _sfc_main from "../icon/icon.js";
 import _sfc_main$1 from "../button/button.js";
 import { TableDIKey } from "./di.js";
 import _sfc_main$2 from "./table-cell.js";
-import { createVNode, defineComponent, inject, isVNode, mergeProps } from "vue";
-import { bem } from "@veltra/utils";
+import { createVNode, defineComponent, inject, isVNode, mergeProps, onUnmounted } from "vue";
 import { ArrowRight } from "@veltra/icons/normal";
 //#region src/components/table/table-row.tsx
+/**
+* A3：行修饰类组合静态查找表。
+*
+* 位模式：bit2 = isCurrent, bit1 = checked, bit0 = expanded。
+* 与 `bem.is('...')` 对于 `'current' | 'checked' | 'expanded'` 的输出完全等价，
+* 直接从 index 读字符串，消除每行渲染期间的字符串拼接和 3 次 bem.is 调用。
+*
+* 放在模块顶层使所有 TableRow 实例共享一份引用（不会随 setup 重建）。
+*/
 function _isSlot(s) {
 	return typeof s === "function" || Object.prototype.toString.call(s) === "[object Object]" && !isVNode(s);
 }
+const ROW_MOD_CLASS = [
+	"",
+	"is-expanded",
+	"is-checked",
+	"is-checked is-expanded",
+	"is-current",
+	"is-current is-expanded",
+	"is-current is-checked",
+	"is-current is-checked is-expanded"
+];
+function rowModCls(row) {
+	return ROW_MOD_CLASS[(row.isCurrent ? 4 : 0) | (row.checked ? 2 : 0) | (row.expanded ? 1 : 0)];
+}
 const UTableRow = defineComponent({
 	name: "TableRow",
-	props: ["row"],
+	props: {
+		row: {
+			type: Object,
+			required: true
+		},
+		index: {
+			type: Number,
+			required: true
+		}
+	},
 	setup(props) {
-		const { row } = props;
-		const { cls, columnConfig, getColumnSlotsNode, toggleTreeRowExpand, getCellCtx, handleRowClick, handleCellClick, tableProps, measureElement } = inject(TableDIKey);
+		const { cls, columnConfig, getColumnSlotsNode, toggleTreeRowExpand, getCellCtx, handleRowClick, handleCellClick, tableProps, measureElement, getCellClass } = inject(TableDIKey);
+		const rowBaseCls = cls.e("row");
+		const expandToggleCls = cls.e("expand-toggle");
+		const expandSpaceCls = cls.e("expand-space");
+		const measureRefCache = /* @__PURE__ */ new Map();
+		const getMeasureRef = (index) => {
+			let ref = measureRefCache.get(index);
+			if (ref === void 0) {
+				ref = (el) => {
+					measureElement(index, el);
+				};
+				measureRefCache.set(index, ref);
+			}
+			return ref;
+		};
+		onUnmounted(() => {
+			measureRefCache.clear();
+		});
 		const { columns, expandColumn } = columnConfig;
 		return () => {
+			const { row } = props;
 			const _expandColumn = expandColumn.value;
 			let expandCell = null;
 			if (_expandColumn) {
@@ -25,13 +72,13 @@ const UTableRow = defineComponent({
 				if (!cellSpan || cellSpan.colspan && cellSpan.rowspan) {
 					const marginLeft = tableProps.tree ? (row.depth - 1) * 14 : 0;
 					expandCell = createVNode(_sfc_main$2, mergeProps({
-						"column": _expandColumn,
+						"cellClass": getCellClass(_expandColumn),
 						"left": _expandColumn.style.left,
 						"right": _expandColumn.style.right,
 						"key": row.uid + _expandColumn.key
 					}, tableProps.mergeCell?.(expandCtx)), { default: () => [!row.isLeaf || tableProps.expandable && !row.isExpandRow ? createVNode(_sfc_main$1, {
 						"text": true,
-						"class": cls.e("expand-toggle"),
+						"class": expandToggleCls,
 						"type": "primary",
 						"size": "small",
 						"circle": true,
@@ -41,19 +88,17 @@ const UTableRow = defineComponent({
 						},
 						"style": `margin-left: ${marginLeft}px`
 					}, { default: () => [createVNode(_sfc_main, null, { default: () => [createVNode(ArrowRight, null, null)] })] }) : createVNode("i", {
-						"class": cls.e("expand-space"),
+						"class": expandSpaceCls,
 						"style": `margin-left: ${marginLeft}px`
 					}, null), getColumnSlotsNode(expandCtx)] });
 				}
 			}
+			const mod = rowModCls(row);
+			const rowCls = mod ? rowBaseCls + " " + mod : rowBaseCls;
 			return createVNode("tr", {
-				"class": [
-					cls.e("row"),
-					bem.is("expanded", row.expanded),
-					bem.is("checked", row.checked)
-				],
+				"class": rowCls,
 				"onClick": (e) => handleRowClick(row, e),
-				"ref": measureElement,
+				"ref": getMeasureRef(props.index),
 				"key": row.uid
 			}, [expandCell, columns.value.map((column) => {
 				const cellCtx = getCellCtx(row, column);
@@ -61,7 +106,7 @@ const UTableRow = defineComponent({
 				if (cellSpan && (!cellSpan.colspan || !cellSpan.rowspan)) return null;
 				const cellNode = getColumnSlotsNode(cellCtx);
 				return createVNode(_sfc_main$2, mergeProps({
-					"column": column,
+					"cellClass": getCellClass(column),
 					"left": column.style.left,
 					"right": column.style.right,
 					"key": row.uid + column.key,
@@ -73,10 +118,24 @@ const UTableRow = defineComponent({
 });
 const UExpandTableRow = defineComponent({
 	name: "ExpandTableRow",
-	props: ["row"],
+	props: {
+		row: {
+			type: Object,
+			required: true
+		},
+		index: {
+			type: Number,
+			required: true
+		}
+	},
 	setup(props) {
 		const { getExpandRowSlotsNode, cls, measureElement, columnConfig } = inject(TableDIKey);
 		const { leafColumns } = columnConfig;
+		const rowBaseCls = cls.e("row");
+		const cellCls = cls.e("cell");
+		const measureRef = (el) => {
+			measureElement(props.index, el);
+		};
 		return () => {
 			const { row } = props;
 			const node = getExpandRowSlotsNode({
@@ -86,11 +145,11 @@ const UExpandTableRow = defineComponent({
 				rowData: row.data
 			});
 			return createVNode("tr", {
-				"class": cls.e("row"),
-				"ref": measureElement
+				"class": rowBaseCls,
+				"ref": measureRef
 			}, [createVNode("td", {
 				"colspan": leafColumns.value.length,
-				"class": cls.e("cell")
+				"class": cellCls
 			}, [node])]);
 		};
 	}

package/dist/components/table/table-row.js.map

@@ -1 +1 @@
-{"version":3,"file":"table-row.js","names":["ArrowRight","bem","defineComponent","DefineComponent","VNodeRef","inject","JSX","TableRow","ITableRow","UButton","UIcon","TableDIKey","UTabelCell","_isSlot","s","Object","prototype","toString","call","_isVNode","UTableRow","row","name","props","setup","cls","columnConfig","getColumnSlotsNode","toggleTreeRowExpand","getCellCtx","handleRowClick","handleCellClick","tableProps","measureElement","columns","expandColumn","_expandColumn","value","expandCell","Element","expandCtx","cellSpan","mergeCell","colspan","rowspan","marginLeft","tree","depth","_createVNode","_mergeProps","style","left","right","uid","key","default","isLeaf","expandable","isExpandRow","e","stopPropagation","is","expanded","checked","map","column","cellCtx","cellNode","UExpandTableRow","getExpandRowSlotsNode","leafColumns","node","index","rowData","data","length"],"sources":["../../../src/components/table/table-row.tsx"],"sourcesContent":["import { ArrowRight } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { defineComponent, type DefineComponent, type VNodeRef } from 'vue'\nimport { inject } from 'vue'\nimport type { JSX } from 'vue/jsx-runtime'\n\nimport type { TableRow as ITableRow } from '../../types'\nimport { UButton } from '../button'\nimport { UIcon } from '../icon'\nimport { TableDIKey } from './di'\nimport UTabelCell from './table-cell.vue'\n\nexport const UTableRow: DefineComponent<{ row: ITableRow }> = defineComponent({\n  name: 'TableRow',\n\n  props: ['row'],\n\n  setup(props) {\n    const { row } = props\n\n    const {\n      cls,\n      columnConfig,\n      getColumnSlotsNode,\n      toggleTreeRowExpand,\n      getCellCtx,\n      handleRowClick,\n      handleCellClick,\n      tableProps,\n      measureElement\n    } = inject(TableDIKey)!\n\n    const { columns, expandColumn } = columnConfig\n\n    return () => {\n      const _expandColumn = expandColumn.value\n\n      let expandCell: JSX.Element | null = null\n      if (_expandColumn) {\n        const expandCtx = getCellCtx(row, _expandColumn)\n        const cellSpan = tableProps.mergeCell?.(expandCtx)\n\n        if (!cellSpan || (cellSpan.colspan && cellSpan.rowspan)) {\n          const marginLeft = tableProps.tree ? (row.depth - 1) * 14 : 0\n          expandCell = (\n            <UTabelCell\n              column={_expandColumn}\n              left={_expandColumn.style.left}\n              right={_expandColumn.style.right}\n              key={row.uid + _expandColumn.key}\n              {...tableProps.mergeCell?.(expandCtx)}\n            >\n              {!row.isLeaf || (tableProps.expandable && !row.isExpandRow) ? (\n                <UButton\n                  text\n                  class={cls.e('expand-toggle')}\n                  type='primary'\n                  size='small'\n                  circle\n                  onClick={(e) => {\n                    e.stopPropagation()\n                    toggleTreeRowExpand(row)\n                  }}\n                  style={`margin-left: ${marginLeft}px`}\n                >\n                  <UIcon>\n                    <ArrowRight />\n                  </UIcon>\n                </UButton>\n              ) : (\n                <i class={cls.e('expand-space')} style={`margin-left: ${marginLeft}px`}></i>\n              )}\n\n              {getColumnSlotsNode(expandCtx)}\n            </UTabelCell>\n          )\n        }\n      }\n\n      return (\n        <tr\n          class={[cls.e('row'), bem.is('expanded', row.expanded), bem.is('checked', row.checked)]}\n          onClick={(e) => handleRowClick(row, e)}\n          ref={measureElement as VNodeRef}\n          key={row.uid}\n        >\n          {expandCell}\n\n          {columns.value.map((column) => {\n            const cellCtx = getCellCtx(row, column)\n            const cellSpan = tableProps.mergeCell?.(cellCtx)\n            if (cellSpan && (!cellSpan.colspan || !cellSpan.rowspan)) {\n              return null\n            }\n\n            const cellNode = getColumnSlotsNode(cellCtx)\n\n            return (\n              <UTabelCell\n                column={column}\n                left={column.style.left}\n                right={column.style.right}\n                key={row.uid + column.key}\n                // @ts-ignore\n                onClick={(e) => handleCellClick(row, column, e)}\n                {...cellSpan}\n              >\n                {cellNode}\n              </UTabelCell>\n            )\n          })}\n        </tr>\n      )\n    }\n  }\n})\n\nexport const UExpandTableRow = defineComponent({\n  name: 'ExpandTableRow',\n  props: ['row'],\n  setup(props) {\n    const { getExpandRowSlotsNode, cls, measureElement, columnConfig } = inject(TableDIKey)!\n    const { leafColumns } = columnConfig\n\n    return () => {\n      const { row } = props\n      const node = getExpandRowSlotsNode({\n        row,\n        index: row.index,\n        columns: leafColumns.value,\n        rowData: row.data\n      })\n      return (\n        <tr class={cls.e('row')} ref={measureElement as VNodeRef}>\n          <td colspan={leafColumns.value.length} class={cls.e('cell')}>\n            {node}\n          </td>\n        </tr>\n      )\n    }\n  }\n})\n"],"mappings":"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"}
+{"version":3,"file":"table-row.js","names":["ArrowRight","defineComponent","DefineComponent","inject","onUnmounted","JSX","TableRow","ITableRow","UButton","UIcon","TableDIKey","UTabelCell","_isSlot","s","Object","prototype","toString","call","_isVNode","ROW_MOD_CLASS","const","rowModCls","row","i","isCurrent","checked","expanded","UTableRow","index","name","props","type","required","Number","setup","cls","columnConfig","getColumnSlotsNode","toggleTreeRowExpand","getCellCtx","handleRowClick","handleCellClick","tableProps","measureElement","getCellClass","rowBaseCls","e","expandToggleCls","expandSpaceCls","measureRefCache","Map","el","getMeasureRef","ref","get","undefined","Element","set","clear","columns","expandColumn","_expandColumn","value","expandCell","expandCtx","cellSpan","mergeCell","colspan","rowspan","marginLeft","tree","depth","_createVNode","_mergeProps","style","left","right","uid","key","default","isLeaf","expandable","isExpandRow","stopPropagation","mod","rowCls","map","column","cellCtx","cellNode","UExpandTableRow","getExpandRowSlotsNode","leafColumns","cellCls","measureRef","node","rowData","data","length"],"sources":["../../../src/components/table/table-row.tsx"],"sourcesContent":["import { ArrowRight } from '@veltra/icons/normal'\nimport { defineComponent, type DefineComponent } from 'vue'\nimport { inject, onUnmounted } from 'vue'\nimport type { JSX } from 'vue/jsx-runtime'\n\nimport type { TableRow as ITableRow } from '../../types'\nimport { UButton } from '../button'\nimport { UIcon } from '../icon'\nimport { TableDIKey } from './di'\nimport UTabelCell from './table-cell.vue'\n\n/**\n * A3：行修饰类组合静态查找表。\n *\n * 位模式：bit2 = isCurrent, bit1 = checked, bit0 = expanded。\n * 与 `bem.is('...')` 对于 `'current' | 'checked' | 'expanded'` 的输出完全等价，\n * 直接从 index 读字符串，消除每行渲染期间的字符串拼接和 3 次 bem.is 调用。\n *\n * 放在模块顶层使所有 TableRow 实例共享一份引用（不会随 setup 重建）。\n */\nconst ROW_MOD_CLASS: readonly string[] = [\n  '',\n  'is-expanded',\n  'is-checked',\n  'is-checked is-expanded',\n  'is-current',\n  'is-current is-expanded',\n  'is-current is-checked',\n  'is-current is-checked is-expanded'\n] as const\n\nfunction rowModCls(row: ITableRow): string {\n  const i = (row.isCurrent ? 4 : 0) | (row.checked ? 2 : 0) | (row.expanded ? 1 : 0)\n  return ROW_MOD_CLASS[i]!\n}\n\nexport const UTableRow: DefineComponent<{ row: ITableRow; index: number }> = defineComponent({\n  name: 'TableRow',\n\n  props: {\n    row: { type: Object as () => ITableRow, required: true },\n    index: { type: Number, required: true }\n  },\n\n  setup(props) {\n    const {\n      cls,\n      columnConfig,\n      getColumnSlotsNode,\n      toggleTreeRowExpand,\n      getCellCtx,\n      handleRowClick,\n      handleCellClick,\n      tableProps,\n      measureElement,\n      getCellClass\n    } = inject(TableDIKey)!\n\n    // A1：把 cls.e('row') / cls.e('expand-toggle') 等静态字符串提升到 setup 一次性计算，\n    // 避免每次 render 重新走 `cls.e` 拼接。\n    const rowBaseCls = cls.e('row')\n    const expandToggleCls = cls.e('expand-toggle')\n    const expandSpaceCls = cls.e('expand-space')\n\n    // A2：measureRef 按 index 缓存闭包。\n    // 行虚拟化下，同一 TableRow 实例的 props.index 大多稳定，但在虚拟化重排或展开行切换时\n    // 仍会发生变化；把 (index) → refFn 缓存起来，既保证引用稳定（利于 Vue 的 ref diff），\n    // 又避免在未来可能的\"同实例跨 index 复用\"情形下重复分配闭包。\n    const measureRefCache = new Map<number, (el: unknown) => void>()\n    const getMeasureRef = (index: number): ((el: unknown) => void) => {\n      let ref = measureRefCache.get(index)\n      if (ref === undefined) {\n        ref = (el: unknown) => {\n          measureElement(index, el as Element | null)\n        }\n        measureRefCache.set(index, ref)\n      }\n      return ref\n    }\n    onUnmounted(() => {\n      measureRefCache.clear()\n    })\n\n    const { columns, expandColumn } = columnConfig\n\n    return () => {\n      const { row } = props\n      const _expandColumn = expandColumn.value\n\n      let expandCell: JSX.Element | null = null\n      if (_expandColumn) {\n        const expandCtx = getCellCtx(row, _expandColumn)\n        const cellSpan = tableProps.mergeCell?.(expandCtx)\n\n        if (!cellSpan || (cellSpan.colspan && cellSpan.rowspan)) {\n          const marginLeft = tableProps.tree ? (row.depth - 1) * 14 : 0\n          expandCell = (\n            <UTabelCell\n              cellClass={getCellClass(_expandColumn)}\n              left={_expandColumn.style.left}\n              right={_expandColumn.style.right}\n              key={row.uid + _expandColumn.key}\n              {...tableProps.mergeCell?.(expandCtx)}\n            >\n              {!row.isLeaf || (tableProps.expandable && !row.isExpandRow) ? (\n                <UButton\n                  text\n                  class={expandToggleCls}\n                  type='primary'\n                  size='small'\n                  circle\n                  onClick={(e) => {\n                    e.stopPropagation()\n                    toggleTreeRowExpand(row)\n                  }}\n                  style={`margin-left: ${marginLeft}px`}\n                >\n                  <UIcon>\n                    <ArrowRight />\n                  </UIcon>\n                </UButton>\n              ) : (\n                <i class={expandSpaceCls} style={`margin-left: ${marginLeft}px`}></i>\n              )}\n\n              {getColumnSlotsNode(expandCtx)}\n            </UTabelCell>\n          )\n        }\n      }\n\n      // A3：行 class 由 base + 3-bit 组合查找产出，避免 Vue 的 class 数组归一化开销。\n      const mod = rowModCls(row)\n      const rowCls = mod ? rowBaseCls + ' ' + mod : rowBaseCls\n\n      return (\n        <tr\n          class={rowCls}\n          onClick={(e) => handleRowClick(row, e)}\n          ref={getMeasureRef(props.index)}\n          key={row.uid}\n        >\n          {expandCell}\n\n          {columns.value.map((column) => {\n            const cellCtx = getCellCtx(row, column)\n            const cellSpan = tableProps.mergeCell?.(cellCtx)\n            if (cellSpan && (!cellSpan.colspan || !cellSpan.rowspan)) {\n              return null\n            }\n\n            const cellNode = getColumnSlotsNode(cellCtx)\n\n            return (\n              <UTabelCell\n                cellClass={getCellClass(column)}\n                left={column.style.left}\n                right={column.style.right}\n                key={row.uid + column.key}\n                // @ts-ignore\n                onClick={(e) => handleCellClick(row, column, e)}\n                {...cellSpan}\n              >\n                {cellNode}\n              </UTabelCell>\n            )\n          })}\n        </tr>\n      )\n    }\n  }\n})\n\nexport const UExpandTableRow = defineComponent({\n  name: 'ExpandTableRow',\n  props: {\n    row: { type: Object as () => ITableRow, required: true },\n    index: { type: Number, required: true }\n  },\n  setup(props) {\n    const { getExpandRowSlotsNode, cls, measureElement, columnConfig } = inject(TableDIKey)!\n    const { leafColumns } = columnConfig\n\n    const rowBaseCls = cls.e('row')\n    const cellCls = cls.e('cell')\n\n    const measureRef = (el: unknown) => {\n      measureElement(props.index, el as Element | null)\n    }\n\n    return () => {\n      const { row } = props\n      const node = getExpandRowSlotsNode({\n        row,\n        index: row.index,\n        columns: leafColumns.value,\n        rowData: row.data\n      })\n      return (\n        <tr class={rowBaseCls} ref={measureRef}>\n          <td colspan={leafColumns.value.length} class={cellCls}>\n            {node}\n          </td>\n        </tr>\n      )\n    }\n  }\n})\n"],"mappings":"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"}

package/dist/components/table/table.js

@@ -9,10 +9,21 @@ import { useColumns } from "./use-columns.js";
 import { useFixedColumns } from "./use-fixed-columns.js";
 import { useRows } from "./use-rows.js";
 import { useTable } from "./use-table.js";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createVNode, defineComponent, nextTick, normalizeClass, normalizeStyle, openBlock, provide, renderList, renderSlot, shallowRef, toRef, unref, useSlots, useTemplateRef, watch, withCtx } from "vue";
-import { bem, setStyles, withUnit } from "@veltra/utils";
-import { useFallbackProps, useVirtual } from "@veltra/compositions";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createTextVNode, createVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, provide, renderList, renderSlot, shallowRef, toDisplayString, toRef, unref, useSlots, useTemplateRef, watch, withCtx } from "vue";
+import { bem, withUnit } from "@veltra/utils";
+import { useFallbackProps, useVirtualizer } from "@veltra/compositions";
 //#region src/components/table/table.vue
+const _hoisted_1 = {
+	key: 0,
+	"aria-hidden": "true"
+};
+const _hoisted_2 = ["colspan"];
+const _hoisted_3 = {
+	key: 1,
+	"aria-hidden": "true"
+};
+const _hoisted_4 = ["colspan"];
+const LENGTH_DELTA_RATIO_TO_RESET_SCROLL = .5;
 const _sfc_main = /* @__PURE__ */ defineComponent({
 	name: "Table",
 	__name: "table",
@@ -60,9 +71,14 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 		const slots = useSlots();
 		const cls = bem("table");
 		const { size } = useFallbackProps([props], { size: "default" });
+		const scrollRef = shallowRef();
+		const beforeSpacerRef = useTemplateRef("beforeSpacerRef");
+		const afterSpacerRef = useTemplateRef("afterSpacerRef");
+		const isScrollingRelay = shallowRef(false);
 		const { rows, toggleTreeRowExpand, allExpanded, toggleAllTreeRowExpand, rowForest, handleRowClick, handleCellClick, getRowByData } = useRows({
 			props,
-			emit
+			emit,
+			isScrolling: isScrollingRelay
 		});
 		const { createCheckColumn, createSelectColumn, clearChecked, clearSelected, checkedRows } = useCheck({
 			size,
@@ -80,39 +96,47 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 			cls
 		});
 		const { leafColumns } = columnConfig;
-		const { handleScroll, leftFixed, rightFixed } = useFixedColumns();
+		const { handleScroll, leftFixed, rightFixed } = useFixedColumns({ isScrolling: isScrollingRelay });
 		const { getColumnSlotsNode, getExpandRowSlotsNode, getHeaderSlotsNode, getCellClass, getCellCtx, getHeaderCellClass } = useTable({
 			props,
 			cls,
 			leftFixed,
 			rightFixed
 		});
-		const scrollRef = shallowRef();
 		const { showResizeLine, resizeLineRef, colgroupRef } = useColResize({
 			scrollRef,
 			leafColumns
 		});
-		const virtualCtx = useVirtual({
+		const { virtualizer, items, isScrolling } = useVirtualizer({
 			count: computed(() => rows.value.length),
-			scrollEl: computed(() => scrollRef.value?.containerRef ?? null),
-			estimateSize: () => 52,
-			virtualThreshold: toRef(props, "virtualThreshold")
+			scrollEl: () => scrollRef.value?.containerRef ?? null,
+			beforeEl: beforeSpacerRef,
+			afterEl: afterSpacerRef,
+			estimateSize: () => 41,
+			getItemKey: (i) => rows.value[i]?.uid ?? i
+		});
+		const virtualEnabled = computed(() => {
+			const t = props.virtualThreshold;
+			return t ? rows.value.length > t : true;
 		});
-		const { virtualList, totalHeight, virtualEnabled } = virtualCtx;
-		const spaceHeight = computed(() => {
-			if (virtualList.value.length) return totalHeight.value - virtualList.value[virtualList.value.length - 1].end + virtualList.value[0].start;
-			return totalHeight.value;
+		watch(isScrolling, (v) => {
+			isScrollingRelay.value = v;
 		});
-		const spaceRef = shallowRef();
-		watch(spaceHeight, (spaceHeight) => {
-			nextTick(() => {
-				spaceRef.value && setStyles(spaceRef.value, { height: spaceHeight ? `${spaceHeight}px` : void 0 });
-			});
-		}, { immediate: true });
-		const tableBodyRef = useTemplateRef("tableBody");
-		watch(() => props.data, () => {
-			tableBodyRef.value?.setBodyTransform(0);
-			scrollRef.value?.scrollTo({ y: 0 });
+		/**
+		* E1：数据替换时的条件置顶。
+		*
+		* 旧实现无差别地 `scrollTo({ y: 0 })`，在「行内增删 / 排序 / 单行更新」等
+		* 场景会把用户当前阅读位置跳走；仅在「翻页 / 显著数据集替换」时才需要复位。
+		*
+		* 判定阈值：|Δlen| / max(newLen, oldLen) ≥ 0.5，即行数变化量超过更大侧的一半时视为显著变化。
+		* 选择 0.5 是因为典型的分页/搜索场景会带来 50% 以上的行数差（通常完全替换数据集），
+		* 而行内追加 / 删除个位数通常只带来 <5% 的变化；两者区分度足够宽。
+		*/
+		watch(() => props.data, (next, prev) => {
+			const nextLen = next?.length ?? 0;
+			const prevLen = prev?.length ?? 0;
+			const denom = Math.max(nextLen, prevLen, 1);
+			if (Math.abs(nextLen - prevLen) / denom >= LENGTH_DELTA_RATIO_TO_RESET_SCROLL) scrollRef.value?.scrollTo({ y: 0 });
 		});
 		provide(TableDIKey, {
 			tableProps: props,
@@ -130,7 +154,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 			getCellCtx,
 			getHeaderCellClass,
 			toggleTreeRowExpand,
-			...virtualCtx
+			virtualList: items,
+			virtualEnabled,
+			measureElement: (index, el) => virtualizer.measureElement(index, el)
 		});
 		const tableFootRef = useTemplateRef("tableFoot");
 		__expose({
@@ -155,6 +181,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 				onScroll: unref(handleScroll)
 			}, {
 				default: withCtx(() => [
+					createTextVNode(toDisplayString(console.log(1)) + " ", 1),
 					createElementVNode("table", { class: normalizeClass(unref(cls).e("wrap")) }, [
 						createElementVNode("colgroup", {
 							ref_key: "colgroupRef",
@@ -170,7 +197,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 							}, null, 6);
 						}), 128))], 512),
 						createVNode(unref(TableHead)),
-						createVNode(_sfc_main$2, { ref: "tableBody" }, createSlots({
+						createCommentVNode("\n        虚拟滚动上占位：替代 tbody transform，避免 table-layout: fixed 下列宽抖动。\n        高度由 useVirtualizer 命令式写入 `style.height`，不经过模板响应式绑定，\n        因此滚动窗口变化不会引起表格模板重渲染。\n      "),
+						virtualEnabled.value ? (openBlock(), createElementBlock("tbody", _hoisted_1, [createElementVNode("tr", {
+							ref_key: "beforeSpacerRef",
+							ref: beforeSpacerRef
+						}, [createElementVNode("td", {
+							colspan: unref(leafColumns).length,
+							style: {
+								"padding": "0",
+								"border": "none"
+							}
+						}, null, 8, _hoisted_2)], 512)])) : createCommentVNode("v-if", true),
+						createVNode(_sfc_main$2, null, createSlots({
 							default: withCtx(() => [renderSlot(_ctx.$slots, "body", {
 								columns: unref(leafColumns),
 								rows: unref(rows)
@@ -180,14 +218,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
 							name: "empty",
 							fn: withCtx(() => [renderSlot(_ctx.$slots, "empty")]),
 							key: "0"
-						} : void 0]), 1536),
-						createCommentVNode(" 占用空间，用来撑开表格高度 "),
-						unref(virtualEnabled) ? (openBlock(), createElementBlock("tbody", {
-							key: 0,
-							ref_key: "spaceRef",
-							ref: spaceRef,
-							style: { width: "1px" }
-						}, null, 512)) : createCommentVNode("v-if", true),
+						} : void 0]), 1024),
+						createCommentVNode(" 虚拟滚动下占位（高度由 useVirtualizer 命令式写入） "),
+						virtualEnabled.value ? (openBlock(), createElementBlock("tbody", _hoisted_3, [createElementVNode("tr", {
+							ref_key: "afterSpacerRef",
+							ref: afterSpacerRef
+						}, [createElementVNode("td", {
+							colspan: unref(leafColumns).length,
+							style: {
+								"padding": "0",
+								"border": "none"
+							}
+						}, null, 8, _hoisted_4)], 512)])) : createCommentVNode("v-if", true),
 						createVNode(_sfc_main$3, { ref: "tableFoot" }, {
 							default: withCtx(() => [renderSlot(_ctx.$slots, "foot", {
 								columns: unref(leafColumns),

package/dist/components/table/table.js.map

@@ -1 +1 @@
-{"version":3,"file":"table.js","names":[],"sources":["../../../src/components/table/table.vue"],"sourcesContent":["<template>\n  <u-scroll\n    :class=\"[\n      cls.b,\n      cls.m(size),\n      bem.is('border', border),\n      bem.is('all-expanded', allExpanded),\n      bem.is('text-ellipsis', textEllipsis)\n    ]\"\n    ref=\"scrollRef\"\n    :content-class=\"cls.e('content')\"\n    @scroll=\"handleScroll\"\n  >\n    <table :class=\"cls.e('wrap')\">\n      <colgroup ref=\"colgroupRef\">\n        <col\n          v-for=\"column of leafColumns\"\n          :key=\"column.key\"\n          :class=\"column.fixed\"\n          :style=\"{\n            width: withUnit(column.width, 'px'),\n            minWidth: withUnit(column.minWidth, 'px')\n          }\"\n        />\n      </colgroup>\n      <UTableHead />\n\n      <u-table-body ref=\"tableBody\">\n        <slot name=\"body\" :columns=\"leafColumns\" :rows=\"rows\" />\n\n        <template #empty v-if=\"slots.empty\">\n          <slot name=\"empty\" />\n        </template>\n      </u-table-body>\n\n      <!-- 占用空间，用来撑开表格高度 -->\n      <tbody v-if=\"virtualEnabled\" ref=\"spaceRef\" :style=\"{ width: '1px' }\"></tbody>\n\n      <u-table-foot ref=\"tableFoot\">\n        <slot name=\"foot\" :columns=\"leafColumns\" :rows=\"rows\" />\n      </u-table-foot>\n    </table>\n\n    <slot name=\"append\" />\n\n    <div v-if=\"showResizeLine\" :class=\"cls.e('resize-line')\" ref=\"resizeLineRef\"></div>\n\n    <!-- <u-tip v-if=\"textEllipsis\" ref=\"tip\"> </u-tip> -->\n  </u-scroll>\n</template>\n\n<script lang=\"ts\" setup>\nimport { useFallbackProps, useVirtual } from '@veltra/compositions'\nimport { bem, setStyles, withUnit } from '@veltra/utils'\nimport { computed, nextTick, provide, shallowRef, toRef, useTemplateRef, watch } from 'vue'\n\nimport type {\n  TableProps,\n  TableEmits,\n  _TableExposed,\n  TableColumnSlotsScope,\n  ComponentSize,\n  ScrollExposed,\n  TableRowSlotsScope\n} from '../../types'\nimport { UScroll } from '../scroll'\nimport { TableDIKey } from './di'\nimport type { ColumnNode } from './node/col'\nimport type { TableRowNode } from './node/row'\nimport UTableBody from './table-body.vue'\nimport UTableFoot from './table-foot.vue'\n// import { UTip } from '../tip'\nimport UTableHead from './table-head'\nimport { useCheck } from './use-check'\nimport { useColResize } from './use-col-resize'\nimport { useColumns } from './use-columns'\nimport { useFixedColumns } from './use-fixed-columns'\nimport { useRows } from './use-rows'\nimport { useTable } from './use-table'\n\ndefineOptions({ name: 'Table' })\n\nconst props = withDefaults(defineProps<TableProps>(), {\n  tree: false,\n  stripe: true,\n  textOverflow: 'line-break',\n  virtualThreshold: 80\n})\nconst emit = defineEmits<TableEmits>()\n\nconst slots = defineSlots<{\n  [key: `column:${string}`]: (props: TableColumnSlotsScope) => any\n  [key: `header:${string}`]: (props: { column: ColumnNode }) => any\n  'row:expand'?: (props: TableRowSlotsScope) => any\n  foot?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  body?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  empty?: () => any\n  append?: () => any\n}>()\n\nconst cls = bem('table')\n\nconst { size } = useFallbackProps([props], { size: 'default' as ComponentSize })\n\n// 行\nconst {\n  rows,\n  toggleTreeRowExpand,\n  allExpanded,\n  toggleAllTreeRowExpand,\n  rowForest,\n  handleRowClick,\n  handleCellClick,\n  getRowByData\n} = useRows({ props, emit })\n\n// 选中\nconst { createCheckColumn, createSelectColumn, clearChecked, clearSelected, checkedRows } =\n  useCheck({ size, props, rows, rowForest, emit, cls })\n\n// 列\nconst columnConfig = useColumns({\n  props,\n  createCheckColumn,\n  createSelectColumn,\n  toggleAllTreeRowExpand,\n  cls\n})\n\nconst { leafColumns } = columnConfig\n\nconst { handleScroll, leftFixed, rightFixed } = useFixedColumns()\n\n// 在表格中提供的通用方法和属性\nconst {\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass\n} = useTable({ props, cls, leftFixed, rightFixed })\n\nconst scrollRef = shallowRef<ScrollExposed>()\n\nconst { showResizeLine, resizeLineRef, colgroupRef } = useColResize({ scrollRef, leafColumns })\n\nconst virtualCtx = useVirtual({\n  count: computed(() => rows.value.length),\n  scrollEl: computed(() => scrollRef.value?.containerRef ?? null),\n  estimateSize: () => 52,\n  virtualThreshold: toRef(props, 'virtualThreshold')\n})\n\nconst { virtualList, totalHeight, virtualEnabled } = virtualCtx\n\nconst spaceHeight = computed(() => {\n  if (virtualList.value.length) {\n    return (\n      totalHeight.value -\n      virtualList.value[virtualList.value.length - 1]!.end +\n      virtualList.value[0]!.start\n    )\n  }\n  return totalHeight.value\n})\n\nconst spaceRef = shallowRef<HTMLElement>()\n\nwatch(\n  spaceHeight,\n  (spaceHeight) => {\n    nextTick(() => {\n      spaceRef.value &&\n        setStyles(spaceRef.value, { height: spaceHeight ? `${spaceHeight}px` : undefined })\n    })\n  },\n  { immediate: true }\n)\n\nconst tableBodyRef = useTemplateRef('tableBody')\nwatch(\n  () => props.data,\n  () => {\n    tableBodyRef.value?.setBodyTransform(0)\n    scrollRef.value?.scrollTo({ y: 0 })\n  }\n)\n\n// const tipRef = useTemplateRef('tip')\n\nprovide(TableDIKey, {\n  tableProps: props,\n  tableSlots: slots,\n  cls,\n  rows,\n  checkedRows,\n  columnConfig,\n  handleRowClick,\n  handleCellClick,\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass,\n  // tipRef,\n  toggleTreeRowExpand,\n  ...virtualCtx\n})\n\nconst tableFootRef = useTemplateRef('tableFoot')\n\ndefineExpose<_TableExposed>({\n  el: toRef(() => scrollRef.value?.el),\n  clearChecked,\n  clearSelected,\n  getRowByData,\n  getSummaryRow: () => tableFootRef.value!.getSummaryRow()\n})\n</script>\n"],"mappings":"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"}
+{"version":3,"file":"table.js","names":[],"sources":["../../../src/components/table/table.vue"],"sourcesContent":["<template>\n  <u-scroll\n    :class=\"[\n      cls.b,\n      cls.m(size),\n      bem.is('border', border),\n      bem.is('all-expanded', allExpanded),\n      bem.is('text-ellipsis', textEllipsis)\n    ]\"\n    ref=\"scrollRef\"\n    :content-class=\"cls.e('content')\"\n    @scroll=\"handleScroll\"\n  >\n    {{ console.log(1) }}\n    <table :class=\"cls.e('wrap')\">\n      <colgroup ref=\"colgroupRef\">\n        <col\n          v-for=\"column of leafColumns\"\n          :key=\"column.key\"\n          :class=\"column.fixed\"\n          :style=\"{\n            width: withUnit(column.width, 'px'),\n            minWidth: withUnit(column.minWidth, 'px')\n          }\"\n        />\n      </colgroup>\n      <UTableHead />\n\n      <!--\n        虚拟滚动上占位：替代 tbody transform，避免 table-layout: fixed 下列宽抖动。\n        高度由 useVirtualizer 命令式写入 `style.height`，不经过模板响应式绑定，\n        因此滚动窗口变化不会引起表格模板重渲染。\n      -->\n      <tbody v-if=\"virtualEnabled\" aria-hidden=\"true\">\n        <tr ref=\"beforeSpacerRef\">\n          <td :colspan=\"leafColumns.length\" style=\"padding: 0; border: none\"></td>\n        </tr>\n      </tbody>\n\n      <u-table-body>\n        <slot name=\"body\" :columns=\"leafColumns\" :rows=\"rows\" />\n\n        <template #empty v-if=\"slots.empty\">\n          <slot name=\"empty\" />\n        </template>\n      </u-table-body>\n\n      <!-- 虚拟滚动下占位（高度由 useVirtualizer 命令式写入） -->\n      <tbody v-if=\"virtualEnabled\" aria-hidden=\"true\">\n        <tr ref=\"afterSpacerRef\">\n          <td :colspan=\"leafColumns.length\" style=\"padding: 0; border: none\"></td>\n        </tr>\n      </tbody>\n\n      <u-table-foot ref=\"tableFoot\">\n        <slot name=\"foot\" :columns=\"leafColumns\" :rows=\"rows\" />\n      </u-table-foot>\n    </table>\n\n    <slot name=\"append\" />\n\n    <div v-if=\"showResizeLine\" :class=\"cls.e('resize-line')\" ref=\"resizeLineRef\"></div>\n\n    <!-- <u-tip v-if=\"textEllipsis\" ref=\"tip\"> </u-tip> -->\n  </u-scroll>\n</template>\n\n<script lang=\"ts\" setup>\nimport { useFallbackProps, useVirtualizer } from '@veltra/compositions'\nimport { bem, withUnit } from '@veltra/utils'\nimport { computed, provide, shallowRef, toRef, useTemplateRef, watch } from 'vue'\n\nimport type {\n  TableProps,\n  TableEmits,\n  _TableExposed,\n  TableColumnSlotsScope,\n  ComponentSize,\n  ScrollExposed,\n  TableRowSlotsScope\n} from '../../types'\nimport { UScroll } from '../scroll'\nimport { TableDIKey } from './di'\nimport type { ColumnNode } from './node/col'\nimport type { TableRowNode } from './node/row'\nimport UTableBody from './table-body.vue'\nimport UTableFoot from './table-foot.vue'\n// import { UTip } from '../tip'\nimport UTableHead from './table-head'\nimport { useCheck } from './use-check'\nimport { useColResize } from './use-col-resize'\nimport { useColumns } from './use-columns'\nimport { useFixedColumns } from './use-fixed-columns'\nimport { useRows } from './use-rows'\nimport { useTable } from './use-table'\n\ndefineOptions({ name: 'Table' })\n\nconst props = withDefaults(defineProps<TableProps>(), {\n  tree: false,\n  stripe: true,\n  textOverflow: 'line-break',\n  virtualThreshold: 80\n})\nconst emit = defineEmits<TableEmits>()\n\nconst slots = defineSlots<{\n  [key: `column:${string}`]: (props: TableColumnSlotsScope) => any\n  [key: `header:${string}`]: (props: { column: ColumnNode }) => any\n  'row:expand'?: (props: TableRowSlotsScope) => any\n  foot?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  body?: (props: { columns: ColumnNode[]; rows: TableRowNode[] }) => any\n  empty?: () => any\n  append?: () => any\n}>()\n\nconst cls = bem('table')\n\nconst { size } = useFallbackProps([props], { size: 'default' as ComponentSize })\n\nconst scrollRef = shallowRef<ScrollExposed>()\n\n// 占位 tr 的 DOM 句柄；交给 useVirtualizer 直接命令式写 style.height。\nconst beforeSpacerRef = useTemplateRef<HTMLElement>('beforeSpacerRef')\nconst afterSpacerRef = useTemplateRef<HTMLElement>('afterSpacerRef')\n\n// 行（useRows / useFixedColumns 需要 isScrolling，而虚拟化 hook 又依赖 rows.length；\n// 先用中继占位，下方 isScrolling 到位后 watch 回灌）。\nconst isScrollingRelay = shallowRef(false)\n\nconst {\n  rows,\n  toggleTreeRowExpand,\n  allExpanded,\n  toggleAllTreeRowExpand,\n  rowForest,\n  handleRowClick,\n  handleCellClick,\n  getRowByData\n} = useRows({ props, emit, isScrolling: isScrollingRelay })\n\nconst { createCheckColumn, createSelectColumn, clearChecked, clearSelected, checkedRows } =\n  useCheck({ size, props, rows, rowForest, emit, cls })\n\nconst columnConfig = useColumns({\n  props,\n  createCheckColumn,\n  createSelectColumn,\n  toggleAllTreeRowExpand,\n  cls\n})\n\nconst { leafColumns } = columnConfig\n\nconst { handleScroll, leftFixed, rightFixed } = useFixedColumns({\n  isScrolling: isScrollingRelay\n})\n\nconst {\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass\n} = useTable({ props, cls, leftFixed, rightFixed })\n\nconst { showResizeLine, resizeLineRef, colgroupRef } = useColResize({ scrollRef, leafColumns })\n\nconst { virtualizer, items, isScrolling } = useVirtualizer({\n  count: computed(() => rows.value.length),\n  scrollEl: () => scrollRef.value?.containerRef ?? null,\n  beforeEl: beforeSpacerRef,\n  afterEl: afterSpacerRef,\n  estimateSize: () => 41,\n  // 注意：getItemKey 在构造期一次性写入底层 Virtualizer；闭包每次读的是当前 rows.value，\n  // rows 引用整体替换后 key 仍有效（无需再 setOptions）。\n  getItemKey: (i) => rows.value[i]?.uid ?? i\n})\n\nconst virtualEnabled = computed(() => {\n  const t = props.virtualThreshold\n  return t ? rows.value.length > t : true\n})\n\n// 把虚拟化 isScrolling 回灌到中继，供 useRows / useFixedColumns 读取。\nwatch(isScrolling, (v) => {\n  isScrollingRelay.value = v\n})\n\n/**\n * E1：数据替换时的条件置顶。\n *\n * 旧实现无差别地 `scrollTo({ y: 0 })`，在「行内增删 / 排序 / 单行更新」等\n * 场景会把用户当前阅读位置跳走；仅在「翻页 / 显著数据集替换」时才需要复位。\n *\n * 判定阈值：|Δlen| / max(newLen, oldLen) ≥ 0.5，即行数变化量超过更大侧的一半时视为显著变化。\n * 选择 0.5 是因为典型的分页/搜索场景会带来 50% 以上的行数差（通常完全替换数据集），\n * 而行内追加 / 删除个位数通常只带来 <5% 的变化；两者区分度足够宽。\n */\nconst LENGTH_DELTA_RATIO_TO_RESET_SCROLL = 0.5\n\nwatch(\n  () => props.data,\n  (next, prev) => {\n    const nextLen = next?.length ?? 0\n    const prevLen = prev?.length ?? 0\n    const denom = Math.max(nextLen, prevLen, 1)\n    const ratio = Math.abs(nextLen - prevLen) / denom\n    if (ratio >= LENGTH_DELTA_RATIO_TO_RESET_SCROLL) {\n      scrollRef.value?.scrollTo({ y: 0 })\n    }\n  }\n)\n\n// const tipRef = useTemplateRef('tip')\n\nprovide(TableDIKey, {\n  tableProps: props,\n  tableSlots: slots,\n  cls,\n  rows,\n  checkedRows,\n  columnConfig,\n  handleRowClick,\n  handleCellClick,\n  getColumnSlotsNode,\n  getExpandRowSlotsNode,\n  getHeaderSlotsNode,\n  getCellClass,\n  getCellCtx,\n  getHeaderCellClass,\n  // tipRef,\n  toggleTreeRowExpand,\n  virtualList: items,\n  virtualEnabled,\n  measureElement: (index, el) => virtualizer.measureElement(index, el)\n})\n\nconst tableFootRef = useTemplateRef('tableFoot')\n\ndefineExpose<_TableExposed>({\n  el: toRef(() => scrollRef.value?.el),\n  clearChecked,\n  clearSelected,\n  getRowByData,\n  getSummaryRow: () => tableFootRef.value!.getSummaryRow()\n})\n</script>\n"],"mappings":"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"}

package/dist/components/table/use-fixed-columns.js

@@ -1,22 +1,41 @@
-import { ref } from "vue";
+import { ref, watch } from "vue";
 import { debounce } from "@cat-kit/core";
 //#region src/components/table/use-fixed-columns.ts
 /**
 * 固定列
 * @returns
 */
-function useFixedColumns() {
+function useFixedColumns(options = {}) {
+	const { isScrolling } = options;
 	const leftFixed = ref(false);
 	const rightFixed = ref(false);
+	let pendingLeft = null;
+	let pendingRight = null;
+	const applyImmediate = (nextLeft, nextRight) => {
+		if (nextLeft !== leftFixed.value) leftFixed.value = nextLeft;
+		if (nextRight !== rightFixed.value) rightFixed.value = nextRight;
+		pendingLeft = null;
+		pendingRight = null;
+	};
+	const handleScroll = debounce((e) => {
+		const nextLeft = e.x > 0;
+		const nextRight = !(e.cw + e.x + 1 >= e.sw);
+		if (isScrolling?.value) {
+			pendingLeft = nextLeft;
+			pendingRight = nextRight;
+			return;
+		}
+		applyImmediate(nextLeft, nextRight);
+	}, 50);
+	if (isScrolling) watch(isScrolling, (v) => {
+		if (v) return;
+		if (pendingLeft === null && pendingRight === null) return;
+		applyImmediate(pendingLeft ?? leftFixed.value, pendingRight ?? rightFixed.value);
+	});
 	return {
 		leftFixed,
 		rightFixed,
-		handleScroll: debounce((e) => {
-			if (e.x > 0) leftFixed.value = true;
-			else leftFixed.value = false;
-			if (e.cw + e.x + 1 >= e.sw) rightFixed.value = false;
-			else rightFixed.value = true;
-		}, 50)
+		handleScroll
 	};
 }
 //#endregion

package/dist/components/table/use-fixed-columns.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-fixed-columns.js","names":[],"sources":["../../../src/components/table/use-fixed-columns.ts"],"sourcesContent":["import { debounce } from '@cat-kit/core'\nimport { type ShallowRef, ref } from 'vue'\n\nimport type { ScrollPosition } from '../../types'\n\ninterface UseColumnFixedReturned {\n  leftFixed: ShallowRef<boolean>\n  rightFixed: ShallowRef<boolean>\n  handleScroll: (e: Required<ScrollPosition>) => void\n}\n\n/**\n * 固定列\n * @returns\n */\nexport function useFixedColumns(): UseColumnFixedReturned {\n  const leftFixed = ref(false)\n  const rightFixed = ref(false)\n\n  const handleScroll = debounce((e: Required<ScrollPosition>) => {\n    if (e.x > 0) {\n      leftFixed.value = true\n    } else {\n      leftFixed.value = false\n    }\n\n    // 精度修正\n    if (e.cw + e.x + 1 >= e.sw) {\n      rightFixed.value = false\n    } else {\n      rightFixed.value = true\n    }\n  }, 50)\n\n  return { leftFixed, rightFixed, handleScroll }\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,kBAA0C;CACxD,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,aAAa,IAAI,MAAM;AAiB7B,QAAO;EAAE;EAAW;EAAY,cAfX,UAAU,MAAgC;AAC7D,OAAI,EAAE,IAAI,EACR,WAAU,QAAQ;OAElB,WAAU,QAAQ;AAIpB,OAAI,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,GACtB,YAAW,QAAQ;OAEnB,YAAW,QAAQ;KAEpB,GAAG;EAEwC"}
+{"version":3,"file":"use-fixed-columns.js","names":[],"sources":["../../../src/components/table/use-fixed-columns.ts"],"sourcesContent":["import { debounce } from '@cat-kit/core'\nimport { type ShallowRef, type Ref, ref, watch } from 'vue'\n\nimport type { ScrollPosition } from '../../types'\n\ninterface UseColumnFixedReturned {\n  leftFixed: ShallowRef<boolean>\n  rightFixed: ShallowRef<boolean>\n  handleScroll: (e: Required<ScrollPosition>) => void\n}\n\ninterface Options {\n  /**\n   * D1：滚动中 (`true`) 暂缓 `leftFixed` / `rightFixed` 的切换，滚动结束后\n   * 一次性补算。\n   *\n   * 背景：固定列的阴影是通过在 cell 上切换 `is-last-fixed` / `is-first-fixed`\n   * 等 class 实现的，这些 class 会穿透到 `useTable.getCellClass` 的缓存键，\n   * 任何一次切换都会让全表的单元格类名失效重算。滚动本身并不需要实时更新阴影，\n   * 因此把切换推迟到 `isScrolling` 归零时做一次即可。\n   *\n   * 未传入时退化到旧行为（实时切换）。\n   */\n  isScrolling?: Ref<boolean>\n}\n\n/**\n * 固定列\n * @returns\n */\nexport function useFixedColumns(options: Options = {}): UseColumnFixedReturned {\n  const { isScrolling } = options\n\n  const leftFixed = ref(false)\n  const rightFixed = ref(false)\n\n  let pendingLeft: boolean | null = null\n  let pendingRight: boolean | null = null\n\n  const applyImmediate = (nextLeft: boolean, nextRight: boolean): void => {\n    if (nextLeft !== leftFixed.value) leftFixed.value = nextLeft\n    if (nextRight !== rightFixed.value) rightFixed.value = nextRight\n    pendingLeft = null\n    pendingRight = null\n  }\n\n  const handleScroll = debounce((e: Required<ScrollPosition>) => {\n    const nextLeft = e.x > 0\n    // 精度修正：浏览器滚动条最后 1px 的误差\n    const nextRight = !(e.cw + e.x + 1 >= e.sw)\n\n    if (isScrolling?.value) {\n      pendingLeft = nextLeft\n      pendingRight = nextRight\n      return\n    }\n\n    applyImmediate(nextLeft, nextRight)\n  }, 50)\n\n  if (isScrolling) {\n    watch(isScrolling, (v) => {\n      if (v) return\n      if (pendingLeft === null && pendingRight === null) return\n      applyImmediate(pendingLeft ?? leftFixed.value, pendingRight ?? rightFixed.value)\n    })\n  }\n\n  return { leftFixed, rightFixed, handleScroll }\n}\n"],"mappings":";;;;;;;AA8BA,SAAgB,gBAAgB,UAAmB,EAAE,EAA0B;CAC7E,MAAM,EAAE,gBAAgB;CAExB,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,aAAa,IAAI,MAAM;CAE7B,IAAI,cAA8B;CAClC,IAAI,eAA+B;CAEnC,MAAM,kBAAkB,UAAmB,cAA6B;AACtE,MAAI,aAAa,UAAU,MAAO,WAAU,QAAQ;AACpD,MAAI,cAAc,WAAW,MAAO,YAAW,QAAQ;AACvD,gBAAc;AACd,iBAAe;;CAGjB,MAAM,eAAe,UAAU,MAAgC;EAC7D,MAAM,WAAW,EAAE,IAAI;EAEvB,MAAM,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE;AAExC,MAAI,aAAa,OAAO;AACtB,iBAAc;AACd,kBAAe;AACf;;AAGF,iBAAe,UAAU,UAAU;IAClC,GAAG;AAEN,KAAI,YACF,OAAM,cAAc,MAAM;AACxB,MAAI,EAAG;AACP,MAAI,gBAAgB,QAAQ,iBAAiB,KAAM;AACnD,iBAAe,eAAe,UAAU,OAAO,gBAAgB,WAAW,MAAM;GAChF;AAGJ,QAAO;EAAE;EAAW;EAAY;EAAc"}

package/dist/components/table/use-rows.js

@@ -4,7 +4,7 @@ import { Forest, o } from "@cat-kit/core";
 import { useModel as useModel$1 } from "@veltra/compositions";
 //#region src/components/table/use-rows.ts
 function useRows(options) {
-	const { props, emit } = options;
+	const { props, emit, isScrolling } = options;
 	/** 所有可见的行 */
 	const rows = shallowRef([]);
 	/** 数据行， 不包括展开和折叠的行 */
@@ -145,7 +145,7 @@ function useRows(options) {
 		}
 	}
 	function handleRowClick(row, e) {
-		currentRow.value = currentRow.value === row ? void 0 : row;
+		if (!isScrolling?.value) currentRow.value = currentRow.value === row ? void 0 : row;
 		emit("row-click", row, e);
 	}
 	function handleCellClick(row, column, e) {

package/dist/components/table/use-rows.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-rows.js","names":["useModel"],"sources":["../../../src/components/table/use-rows.ts"],"sourcesContent":["import { Forest, o } from '@cat-kit/core'\nimport { useModel } from '@veltra/compositions'\nimport { shallowRef, watch, type ShallowRef } from 'vue'\n\nimport type { TableColumn, TableEmits, TableProps, TableRow } from '../../types'\nimport { TableRowNode } from './node/row'\n\ninterface Options {\n  props: TableProps\n  emit: TableEmits\n}\n\ninterface UseRowsReturned {\n  /** 所有的行森林（树形数据） */\n  rowForest: ShallowRef<Forest<Record<string, unknown>, any> | undefined>\n  /** 当前可见的展平行列表 */\n  rows: ShallowRef<TableRowNode[]>\n  /** 切换树形行节点的展开/折叠 */\n  toggleTreeRowExpand: (node: TableRow) => void\n  /** 是否全部展开 */\n  allExpanded: ShallowRef<boolean>\n  /** 切换全部展开/折叠 */\n  toggleAllTreeRowExpand: () => void\n  /** 行点击处理 */\n  handleRowClick: (row: TableRow, e: MouseEvent) => void\n  /** 单元格点击处理 */\n  handleCellClick: (row: TableRow, column: TableColumn, e: MouseEvent) => void\n  /** 根据原始数据对象获取对应的 TableRow */\n  getRowByData: (data: Record<string, any>) => TableRow | undefined\n}\n\nexport function useRows(options: Options): UseRowsReturned {\n  const { props, emit } = options\n\n  // --- 状态定义 ---\n\n  /** 所有可见的行 */\n  const rows = shallowRef<TableRowNode[]>([])\n  /** 数据行， 不包括展开和折叠的行 */\n  const dataRows = shallowRef<TableRowNode[]>([])\n  /** 行森林（数据结构树） */\n  const rowForest = shallowRef<Forest<Record<string, unknown>, any>>()\n  /** 树形节点是否全部展开 */\n  const allExpanded = shallowRef(props.defaultExpandAll ?? false)\n\n  /** 当前高亮的行 */\n  const currentRow = useModel({\n    props,\n    emit,\n    propName: 'current',\n    shallow: true,\n    local: () => !!props.highlightCurrent\n  })\n\n  // --- 行字典维护 (性能优化) ---\n\n  /**\n   * 用于优化增删改时的性能。\n   * 原理：Vue 的组件在属性发生改变时会重新渲染，通过 WeakMap 缓存 data -> TableRow 的映射，\n   * 可以在数据更新时复用已有的 TableRowNode 实例，避免重复创建和 DOM 抖动。\n   */\n  let rowDicts = new WeakMap<Record<string, any>, TableRowNode>()\n  let tempRowDicts: null | WeakMap<Record<string, any>, TableRowNode> = null\n  let uidSeed = 0\n\n  /** 获取行唯一标识 */\n  const getRowUID = props.rowKey\n    ? (rowData: Record<string, any>) => rowData && o(rowData).get(props.rowKey!)\n    : () => uidSeed++\n\n  /** 创建或复用 TableRow 实例 */\n  const createRow = (\n    data: Record<string, any>,\n    index: number,\n    depth = 0,\n    parent?: TableRowNode\n  ) => {\n    const existRow = data ? rowDicts.get(data) : undefined\n    if (existRow) {\n      existRow.index = index\n      existRow.depth = depth\n      existRow.parent = parent\n      return existRow\n    }\n    return new TableRowNode({ data, index, depth, parent, uid: getRowUID(data) })\n  }\n\n  // --- 行处理逻辑 ---\n\n  /** 处理常规扁平列表 */\n  function getDataRows(data: Record<string, any>[]): TableRowNode[] {\n    let i = data.length\n    const result = Array.from({ length: i }) as TableRowNode[]\n    tempRowDicts = new WeakMap()\n\n    while (i--) {\n      const dataItem = data[i]!\n      const row = createRow(dataItem, i)\n      result[i] = row\n      tempRowDicts.set(dataItem, row)\n    }\n\n    rowDicts = tempRowDicts\n    tempRowDicts = null\n    return result\n  }\n\n  function expandDataRows(): void {\n    const result: TableRowNode[] = []\n    let i = -1\n    while (++i < dataRows.value.length) {\n      const row = dataRows.value[i]!\n      result.push(row)\n      if (row.expanded) {\n        result.push(row.copy())\n      }\n    }\n    rows.value = result\n  }\n\n  /** 处理树形森林结构 */\n  function getRowForest(data: Record<string, any>[]): Forest<Record<string, unknown>, any> {\n    tempRowDicts = new WeakMap()\n    const childrenKey = typeof props.tree === 'string' ? props.tree : 'children'\n    const ret = new Forest<Record<string, unknown>, any>({\n      data,\n      childrenKey,\n      createNode(val, index, depth, _forest, parent) {\n        const row = createRow(val, index, depth, parent)\n        if (props.defaultExpandAll) {\n          row.expanded = true\n        }\n        val && tempRowDicts!.set(val, row)\n        return row\n      }\n    })\n\n    rowDicts = tempRowDicts\n    tempRowDicts = null\n    return ret\n  }\n\n  /** 展平树形结构为可见行列表 */\n  function updateFlattedRows(): void {\n    if (!rowForest.value) return\n    rows.value = rowForest.value.flattenVisible((n) => n.expanded)\n  }\n\n  // --- 副作用监听 ---\n\n  // 监听当前行切换，维护 isCurrent 状态\n  watch(\n    () => currentRow.value,\n    (row, oldRow) => {\n      if (oldRow) oldRow.isCurrent = false\n      if (row) row.isCurrent = true\n    }\n  )\n\n  // 同步状态给外部\n  watch(rows, (rows) => emit('update:rows', rows))\n  watch(rowForest, (forest) => emit('update:forest', forest))\n\n  // 核心：监听原始数据变化，重新构建行列表或树\n  watch(\n    [() => props.data, () => props.tree, () => props.defaultExpandAll],\n    ([data, tree]) => {\n      if (!data?.length) {\n        rows.value = []\n        rowDicts = new WeakMap()\n        rowForest.value = undefined\n        return\n      }\n\n      if (!tree) {\n        rowForest.value = undefined\n        dataRows.value = getDataRows(data)\n        rows.value = dataRows.value\n      } else {\n        dataRows.value = []\n        rowForest.value = getRowForest(data)\n        updateFlattedRows()\n      }\n    },\n    { immediate: true }\n  )\n\n  // --- 交互方法 ---\n\n  function toggleTreeRowExpand(node: TableRow): void {\n    node.expanded = !node.expanded\n\n    if (props.tree) {\n      return updateFlattedRows()\n    }\n    if (props.expandable) {\n      expandDataRows()\n    }\n  }\n\n  function toggleAllTreeRowExpand(): void {\n    allExpanded.value = !allExpanded.value\n    if (props.tree) {\n      rowForest.value?.dfs((node) => {\n        node.expanded = allExpanded.value\n      })\n      updateFlattedRows()\n      return\n    }\n    if (props.expandable) {\n      dataRows.value.forEach((row) => {\n        row.expanded = allExpanded.value\n      })\n      expandDataRows()\n      return\n    }\n  }\n\n  function handleRowClick(row: TableRow, e: MouseEvent): void {\n    currentRow.value = currentRow.value === row ? undefined : row\n    emit('row-click', row, e)\n  }\n\n  function handleCellClick(row: TableRow, column: TableColumn, e: MouseEvent): void {\n    emit('cell-click', row, column, e)\n  }\n\n  function getRowByData(data: Record<string, any>): TableRow | undefined {\n    return rowDicts.get(data)\n  }\n\n  return {\n    rowForest,\n    rows,\n    allExpanded,\n    toggleTreeRowExpand,\n    toggleAllTreeRowExpand,\n    handleRowClick,\n    handleCellClick,\n    getRowByData\n  }\n}\n"],"mappings":";;;;;AA+BA,SAAgB,QAAQ,SAAmC;CACzD,MAAM,EAAE,OAAO,SAAS;;CAKxB,MAAM,OAAO,WAA2B,EAAE,CAAC;;CAE3C,MAAM,WAAW,WAA2B,EAAE,CAAC;;CAE/C,MAAM,YAAY,YAAkD;;CAEpE,MAAM,cAAc,WAAW,MAAM,oBAAoB,MAAM;;CAG/D,MAAM,aAAaA,WAAS;EAC1B;EACA;EACA,UAAU;EACV,SAAS;EACT,aAAa,CAAC,CAAC,MAAM;EACtB,CAAC;;;;;;CASF,IAAI,2BAAW,IAAI,SAA4C;CAC/D,IAAI,eAAkE;CACtE,IAAI,UAAU;;CAGd,MAAM,YAAY,MAAM,UACnB,YAAiC,WAAW,EAAE,QAAQ,CAAC,IAAI,MAAM,OAAQ,SACpE;;CAGV,MAAM,aACJ,MACA,OACA,QAAQ,GACR,WACG;EACH,MAAM,WAAW,OAAO,SAAS,IAAI,KAAK,GAAG,KAAA;AAC7C,MAAI,UAAU;AACZ,YAAS,QAAQ;AACjB,YAAS,QAAQ;AACjB,YAAS,SAAS;AAClB,UAAO;;AAET,SAAO,IAAI,aAAa;GAAE;GAAM;GAAO;GAAO;GAAQ,KAAK,UAAU,KAAK;GAAE,CAAC;;;CAM/E,SAAS,YAAY,MAA6C;EAChE,IAAI,IAAI,KAAK;EACb,MAAM,SAAS,MAAM,KAAK,EAAE,QAAQ,GAAG,CAAC;AACxC,iCAAe,IAAI,SAAS;AAE5B,SAAO,KAAK;GACV,MAAM,WAAW,KAAK;GACtB,MAAM,MAAM,UAAU,UAAU,EAAE;AAClC,UAAO,KAAK;AACZ,gBAAa,IAAI,UAAU,IAAI;;AAGjC,aAAW;AACX,iBAAe;AACf,SAAO;;CAGT,SAAS,iBAAuB;EAC9B,MAAM,SAAyB,EAAE;EACjC,IAAI,IAAI;AACR,SAAO,EAAE,IAAI,SAAS,MAAM,QAAQ;GAClC,MAAM,MAAM,SAAS,MAAM;AAC3B,UAAO,KAAK,IAAI;AAChB,OAAI,IAAI,SACN,QAAO,KAAK,IAAI,MAAM,CAAC;;AAG3B,OAAK,QAAQ;;;CAIf,SAAS,aAAa,MAAmE;AACvF,iCAAe,IAAI,SAAS;EAE5B,MAAM,MAAM,IAAI,OAAqC;GACnD;GACA,aAHkB,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;GAIhE,WAAW,KAAK,OAAO,OAAO,SAAS,QAAQ;IAC7C,MAAM,MAAM,UAAU,KAAK,OAAO,OAAO,OAAO;AAChD,QAAI,MAAM,iBACR,KAAI,WAAW;AAEjB,WAAO,aAAc,IAAI,KAAK,IAAI;AAClC,WAAO;;GAEV,CAAC;AAEF,aAAW;AACX,iBAAe;AACf,SAAO;;;CAIT,SAAS,oBAA0B;AACjC,MAAI,CAAC,UAAU,MAAO;AACtB,OAAK,QAAQ,UAAU,MAAM,gBAAgB,MAAM,EAAE,SAAS;;AAMhE,aACQ,WAAW,QAChB,KAAK,WAAW;AACf,MAAI,OAAQ,QAAO,YAAY;AAC/B,MAAI,IAAK,KAAI,YAAY;GAE5B;AAGD,OAAM,OAAO,SAAS,KAAK,eAAe,KAAK,CAAC;AAChD,OAAM,YAAY,WAAW,KAAK,iBAAiB,OAAO,CAAC;AAG3D,OACE;QAAO,MAAM;QAAY,MAAM;QAAY,MAAM;EAAiB,GACjE,CAAC,MAAM,UAAU;AAChB,MAAI,CAAC,MAAM,QAAQ;AACjB,QAAK,QAAQ,EAAE;AACf,8BAAW,IAAI,SAAS;AACxB,aAAU,QAAQ,KAAA;AAClB;;AAGF,MAAI,CAAC,MAAM;AACT,aAAU,QAAQ,KAAA;AAClB,YAAS,QAAQ,YAAY,KAAK;AAClC,QAAK,QAAQ,SAAS;SACjB;AACL,YAAS,QAAQ,EAAE;AACnB,aAAU,QAAQ,aAAa,KAAK;AACpC,sBAAmB;;IAGvB,EAAE,WAAW,MAAM,CACpB;CAID,SAAS,oBAAoB,MAAsB;AACjD,OAAK,WAAW,CAAC,KAAK;AAEtB,MAAI,MAAM,KACR,QAAO,mBAAmB;AAE5B,MAAI,MAAM,WACR,iBAAgB;;CAIpB,SAAS,yBAA+B;AACtC,cAAY,QAAQ,CAAC,YAAY;AACjC,MAAI,MAAM,MAAM;AACd,aAAU,OAAO,KAAK,SAAS;AAC7B,SAAK,WAAW,YAAY;KAC5B;AACF,sBAAmB;AACnB;;AAEF,MAAI,MAAM,YAAY;AACpB,YAAS,MAAM,SAAS,QAAQ;AAC9B,QAAI,WAAW,YAAY;KAC3B;AACF,mBAAgB;AAChB;;;CAIJ,SAAS,eAAe,KAAe,GAAqB;AAC1D,aAAW,QAAQ,WAAW,UAAU,MAAM,KAAA,IAAY;AAC1D,OAAK,aAAa,KAAK,EAAE;;CAG3B,SAAS,gBAAgB,KAAe,QAAqB,GAAqB;AAChF,OAAK,cAAc,KAAK,QAAQ,EAAE;;CAGpC,SAAS,aAAa,MAAiD;AACrE,SAAO,SAAS,IAAI,KAAK;;AAG3B,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"use-rows.js","names":["useModel"],"sources":["../../../src/components/table/use-rows.ts"],"sourcesContent":["import { Forest, o } from '@cat-kit/core'\nimport { useModel } from '@veltra/compositions'\nimport { shallowRef, watch, type Ref, type ShallowRef } from 'vue'\n\nimport type { TableColumn, TableEmits, TableProps, TableRow } from '../../types'\nimport { TableRowNode } from './node/row'\n\ninterface Options {\n  props: TableProps\n  emit: TableEmits\n  /**\n   * D2：滚动中 (`true`) 跳过 `currentRow` 高亮写入。\n   *\n   * 行点击处理会通过 `currentRow` watcher 把 `isCurrent` 切换到新行 / 旧行上，\n   * 触发对应 `<tr>` 的 class 重绘。在滚动期间 (移动端/触控板惯性滚动常见)\n   * 意外点击不应改变高亮，因此直接跳过；滚动结束后的正常点击仍会生效。\n   */\n  isScrolling?: Ref<boolean>\n}\n\ninterface UseRowsReturned {\n  /** 所有的行森林（树形数据） */\n  rowForest: ShallowRef<Forest<Record<string, unknown>, any> | undefined>\n  /** 当前可见的展平行列表 */\n  rows: ShallowRef<TableRowNode[]>\n  /** 切换树形行节点的展开/折叠 */\n  toggleTreeRowExpand: (node: TableRow) => void\n  /** 是否全部展开 */\n  allExpanded: ShallowRef<boolean>\n  /** 切换全部展开/折叠 */\n  toggleAllTreeRowExpand: () => void\n  /** 行点击处理 */\n  handleRowClick: (row: TableRow, e: MouseEvent) => void\n  /** 单元格点击处理 */\n  handleCellClick: (row: TableRow, column: TableColumn, e: MouseEvent) => void\n  /** 根据原始数据对象获取对应的 TableRow */\n  getRowByData: (data: Record<string, any>) => TableRow | undefined\n}\n\nexport function useRows(options: Options): UseRowsReturned {\n  const { props, emit, isScrolling } = options\n\n  // --- 状态定义 ---\n\n  /** 所有可见的行 */\n  const rows = shallowRef<TableRowNode[]>([])\n  /** 数据行， 不包括展开和折叠的行 */\n  const dataRows = shallowRef<TableRowNode[]>([])\n  /** 行森林（数据结构树） */\n  const rowForest = shallowRef<Forest<Record<string, unknown>, any>>()\n  /** 树形节点是否全部展开 */\n  const allExpanded = shallowRef(props.defaultExpandAll ?? false)\n\n  /** 当前高亮的行 */\n  const currentRow = useModel({\n    props,\n    emit,\n    propName: 'current',\n    shallow: true,\n    local: () => !!props.highlightCurrent\n  })\n\n  // --- 行字典维护 (性能优化) ---\n\n  /**\n   * 用于优化增删改时的性能。\n   * 原理：Vue 的组件在属性发生改变时会重新渲染，通过 WeakMap 缓存 data -> TableRow 的映射，\n   * 可以在数据更新时复用已有的 TableRowNode 实例，避免重复创建和 DOM 抖动。\n   */\n  let rowDicts = new WeakMap<Record<string, any>, TableRowNode>()\n  let tempRowDicts: null | WeakMap<Record<string, any>, TableRowNode> = null\n  let uidSeed = 0\n\n  /** 获取行唯一标识 */\n  const getRowUID = props.rowKey\n    ? (rowData: Record<string, any>) => rowData && o(rowData).get(props.rowKey!)\n    : () => uidSeed++\n\n  /** 创建或复用 TableRow 实例 */\n  const createRow = (\n    data: Record<string, any>,\n    index: number,\n    depth = 0,\n    parent?: TableRowNode\n  ) => {\n    const existRow = data ? rowDicts.get(data) : undefined\n    if (existRow) {\n      existRow.index = index\n      existRow.depth = depth\n      existRow.parent = parent\n      return existRow\n    }\n    return new TableRowNode({ data, index, depth, parent, uid: getRowUID(data) })\n  }\n\n  // --- 行处理逻辑 ---\n\n  /** 处理常规扁平列表 */\n  function getDataRows(data: Record<string, any>[]): TableRowNode[] {\n    let i = data.length\n    const result = Array.from({ length: i }) as TableRowNode[]\n    tempRowDicts = new WeakMap()\n\n    while (i--) {\n      const dataItem = data[i]!\n      const row = createRow(dataItem, i)\n      result[i] = row\n      tempRowDicts.set(dataItem, row)\n    }\n\n    rowDicts = tempRowDicts\n    tempRowDicts = null\n    return result\n  }\n\n  function expandDataRows(): void {\n    const result: TableRowNode[] = []\n    let i = -1\n    while (++i < dataRows.value.length) {\n      const row = dataRows.value[i]!\n      result.push(row)\n      if (row.expanded) {\n        result.push(row.copy())\n      }\n    }\n    rows.value = result\n  }\n\n  /** 处理树形森林结构 */\n  function getRowForest(data: Record<string, any>[]): Forest<Record<string, unknown>, any> {\n    tempRowDicts = new WeakMap()\n    const childrenKey = typeof props.tree === 'string' ? props.tree : 'children'\n    const ret = new Forest<Record<string, unknown>, any>({\n      data,\n      childrenKey,\n      createNode(val, index, depth, _forest, parent) {\n        const row = createRow(val, index, depth, parent)\n        if (props.defaultExpandAll) {\n          row.expanded = true\n        }\n        val && tempRowDicts!.set(val, row)\n        return row\n      }\n    })\n\n    rowDicts = tempRowDicts\n    tempRowDicts = null\n    return ret\n  }\n\n  /** 展平树形结构为可见行列表 */\n  function updateFlattedRows(): void {\n    if (!rowForest.value) return\n    rows.value = rowForest.value.flattenVisible((n) => n.expanded)\n  }\n\n  // --- 副作用监听 ---\n\n  // 监听当前行切换，维护 isCurrent 状态\n  watch(\n    () => currentRow.value,\n    (row, oldRow) => {\n      if (oldRow) oldRow.isCurrent = false\n      if (row) row.isCurrent = true\n    }\n  )\n\n  // 同步状态给外部\n  watch(rows, (rows) => emit('update:rows', rows))\n  watch(rowForest, (forest) => emit('update:forest', forest))\n\n  // 核心：监听原始数据变化，重新构建行列表或树\n  watch(\n    [() => props.data, () => props.tree, () => props.defaultExpandAll],\n    ([data, tree]) => {\n      if (!data?.length) {\n        rows.value = []\n        rowDicts = new WeakMap()\n        rowForest.value = undefined\n        return\n      }\n\n      if (!tree) {\n        rowForest.value = undefined\n        dataRows.value = getDataRows(data)\n        rows.value = dataRows.value\n      } else {\n        dataRows.value = []\n        rowForest.value = getRowForest(data)\n        updateFlattedRows()\n      }\n    },\n    { immediate: true }\n  )\n\n  // --- 交互方法 ---\n\n  function toggleTreeRowExpand(node: TableRow): void {\n    node.expanded = !node.expanded\n\n    if (props.tree) {\n      return updateFlattedRows()\n    }\n    if (props.expandable) {\n      expandDataRows()\n    }\n  }\n\n  function toggleAllTreeRowExpand(): void {\n    allExpanded.value = !allExpanded.value\n    if (props.tree) {\n      rowForest.value?.dfs((node) => {\n        node.expanded = allExpanded.value\n      })\n      updateFlattedRows()\n      return\n    }\n    if (props.expandable) {\n      dataRows.value.forEach((row) => {\n        row.expanded = allExpanded.value\n      })\n      expandDataRows()\n      return\n    }\n  }\n\n  function handleRowClick(row: TableRow, e: MouseEvent): void {\n    // D2：滚动中的点击（多为惯性滚动误触）不应改变 currentRow 高亮。\n    if (!isScrolling?.value) {\n      currentRow.value = currentRow.value === row ? undefined : row\n    }\n    emit('row-click', row, e)\n  }\n\n  function handleCellClick(row: TableRow, column: TableColumn, e: MouseEvent): void {\n    emit('cell-click', row, column, e)\n  }\n\n  function getRowByData(data: Record<string, any>): TableRow | undefined {\n    return rowDicts.get(data)\n  }\n\n  return {\n    rowForest,\n    rows,\n    allExpanded,\n    toggleTreeRowExpand,\n    toggleAllTreeRowExpand,\n    handleRowClick,\n    handleCellClick,\n    getRowByData\n  }\n}\n"],"mappings":"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"}

package/dist/components/table/use-table.js

@@ -1,4 +1,4 @@
-import { useSlots } from "vue";
+import { useSlots, watch } from "vue";
 import { o } from "@cat-kit/core";
 import { bem } from "@veltra/utils";
 //#region src/components/table/use-table.ts
@@ -33,11 +33,33 @@ function useTable(options) {
 		if (column.fixed) classList.push(bem.is("fixed-" + column.fixed));
 		return classList.join(" ");
 	};
+	/**
+	* B1: 单元格类名按 ColumnNode 身份缓存。
+	*
+	* 对同一列，类名只取决于 (column.fixed, column.isLastFixed, column.isFirstFixed,
+	* column.align, leftFixed, rightFixed)。其中前四个绑定在 ColumnNode 实例上，
+	* 后两个在 leftFixed/rightFixed 变化时失效缓存即可。用 WeakMap 以 ColumnNode
+	* 为键可避免字符串 key 的拼接/哈希开销，且列树重建时节点随 GC 自动释放。
+	*/
+	let cellClassCache = /* @__PURE__ */ new WeakMap();
+	let headerCellClassCache = /* @__PURE__ */ new WeakMap();
+	watch([leftFixed, rightFixed], () => {
+		cellClassCache = /* @__PURE__ */ new WeakMap();
+		headerCellClassCache = /* @__PURE__ */ new WeakMap();
+	});
 	const getCellClass = (column) => {
-		return getCommonClassName(column) + ` ${bem.is(column.align)}`;
+		const cached = cellClassCache.get(column);
+		if (cached !== void 0) return cached;
+		const result = getCommonClassName(column) + ` ${bem.is(column.align)}`;
+		cellClassCache.set(column, result);
+		return result;
 	};
 	const getHeaderCellClass = (column) => {
-		return getCommonClassName(column) + ` ${bem.is(column.headerAlign)}`;
+		const cached = headerCellClassCache.get(column);
+		if (cached !== void 0) return cached;
+		const result = getCommonClassName(column) + ` ${bem.is(column.headerAlign)}`;
+		headerCellClassCache.set(column, result);
+		return result;
 	};
 	const getCellCtx = (row, column) => {
 		const rowData = row.data;