@lensui/lens-table 0.1.1 → 0.1.3

package/README.md

@@ -88,16 +88,17 @@ export function Example() {
 | `rows`                       | `Row[]`                                                                            | 必填              | 表格数据。组件不会直接修改数据，编辑后通过事件通知外部更新。                                                                            |
 | `rowKey`                     | `keyof Row \| ((row, index) => string \| number)`                                    | `id`            | 行唯一标识。默认读取每行的`id` 字段；如果数据不是 `id` 主键，请显式传入字段名或函数。                                               |
 | `width`                      | `number \| string`                                                                  | `100%`          | 表格宽度。数字按像素处理，字符串可传`100%`、`80vw` 等。                                                                             |
-| `height`                     | `number \| string`                                                                  | `100%`          | 表格高度。默认继承父容器高度；如果父容器没有可计算高度，则回落到`480px`。                                                             |
-| `autoHeight`                 | `boolean`                                                                          | `false`         | 是否按真实内容高度收缩表格。开启后数据较少时使用 `表头 + 行数 * 行高 + 合计行` 的高度，数据较多时不超过 `height`。                  |
-| `rowHeight`                  | `number`                                                                           | `40`            | 每行高度，固定行高用于高性能虚拟滚动。                                                                                                  |
-| `headerHeight`               | `number`                                                                           | `44`            | 表头高度，单位 px。                                                                                                                     |
+| `height`                     | `number \| string`                                                                  | `100%`          | 表格最大高度。默认继承父容器高度；如果父容器没有可计算高度，则回落到`480px`。数据较少时默认按真实内容高度收缩，数据较多时不超过该高度。 |
+| `layout`                     | `{ rowHeight?: number; headerHeight?: number }`                                    | `{ rowHeight: 36, headerHeight: 40 }` | 表格布局尺寸配置。推荐把行高、表头高度等样式相关参数放在这里；自定义多行表头会以 `headerHeight` 为最小高度自动撑开。              |
+| `rowHeight`                  | `number`                                                                           | `36`            | 已兼容保留，建议改用 `layout.rowHeight`。                                                                                                  |
+| `headerHeight`               | `number`                                                                           | `40`            | 已兼容保留，建议改用 `layout.headerHeight`。                                                                                              |
 | `fixedHeader`                | `boolean`                                                                          | `true`          | 表头是否固定在顶部。                                                                                                                    |
 | `locale`                     | `'zh-CN' \| 'en-US' \| LocaleConfig`                                                 | `'zh-CN'`       | 国际化配置。传字符串时使用内置中英文文案；传对象时可通过`language` 指定语言，并通过 `labels` 覆盖文案。                             |
-| `verticalBorderless`         | `boolean`                                                                          | `false`         | 是否弱化竖向边框。开启后隐藏单元格之间的竖线，但保留横向分隔线。                                                                        |
+| `borderless`                 | `boolean`                                                                          | `false`         | 是否弱化竖向边框。开启后隐藏单元格之间的竖线，但保留横向分隔线。                                                                        |
+| `verticalBorderless`         | `boolean`                                                                          | `false`         | 已兼容保留，建议改用 `borderless`。                                                                                                      |
 | `striped`                    | `boolean \| string`                                                                 | `false`         | 是否显示斑马纹行背景。传`true` 使用主题变量，传颜色字符串可自定义斑马纹颜色，例如 `'#f6faff'`。                                     |
 | `highlight`                  | `{ editedCells?: boolean \| string; insertedRows?: boolean \| string }`             | `{}`            | 高亮反馈配置。`editedCells` 控制编辑过的单元格底色，`insertedRows` 控制乐观插入行底色；传 `true` 使用默认色，传颜色字符串可自定义。   |
-| `cellSpans`                  | `Array<{ rowKey?: GridKey; rowIndex?: number; columnKey: string; rowSpan?: number; colSpan?: number }>` | `[]`            | 合并主体单元格配置。推荐使用 `rowKey` 定位；横向合并会限制在同一个固定列分区内，工具列不会参与合并。                                  |
+| `cellSpans`                  | `TableCellSpan[] \| ((ctx) => TableCellSpan \| { rowSpan?: number; colSpan?: number } \| null)` | `[]`            | 合并主体单元格配置。可传数组，也可传函数按单元格生成规则。推荐使用 `rowKey` 定位；横向合并会限制在同一个固定列分区内，工具列不会参与合并。 |
 | `loading`                    | `boolean`                                                                          | `false`         | 显示加载态。                                                                                                                            |
 | `loadingContent`             | `ReactNode`                                                                        | -                 | 自定义加载内容。传入后，首次加载和刷新加载不再区分，都会统一展示这个内容。                                                              |
 | `virtualized`                | `boolean \| { enabled?: boolean; overscan?: number }`                               | `true`          | 虚拟渲染配置。传`false` 时渲染全部行列；传对象时可通过 `enabled` 开关，并用 `overscan` 配置可见范围外的缓冲行列数量，默认 `4`。 |
@@ -169,6 +170,19 @@ export function Example() {
 />
 ```
 
+也可以传函数按单元格声明规则。函数返回值会默认使用当前单元格作为锚点，因此只需要返回跨度：
+
+```tsx
+<Table
+  columns={columns}
+  rows={rows}
+  cellSpans={({ rowIndex, column }) => {
+    if (column.key === 'department' && rowIndex % 3 === 0) return { rowSpan: 2 };
+    return null;
+  }}
+/>
+```
+
 `rowKey` 优先于 `rowIndex`，在排序、过滤或插入删除行后更稳定。被合并覆盖的单元格不会单独绘制或命中，点击覆盖区域会选中合并区域的锚点单元格。横向合并不会跨越固定左列、滚动列、固定右列这三个区域；如果声明跨区，组件会自动收缩到当前区域内。
 
 ## Column 参数
@@ -177,6 +191,7 @@ export function Example() {
 | -------------- | -------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------- |
 | `key`        | `string`                                                                 | 必填                 | 列唯一标识。排序、筛选、选择、编辑回调都使用它。                                            |
 | `title`      | `string`                                                                 | 必填                 | 表头展示文本。                                                                              |
+| `renderHeader` | `(column) => ReactNode`                                                | -                    | 自定义表头 React 内容。多行内容会自动撑开表头高度；`title` 仍用于 tooltip、拖拽预览和回退文本。 |
 | `dataIndex`  | `keyof Row`                                                              | -                    | 从行数据中读取和写入的字段。工具列可不传。                                                  |
 | `width`      | `number`                                                                 | `140`              | 列宽，单位 px。最小宽度由内部布局保护。                                                     |
 | `fixed`      | `'left' \| 'right'`                                                       | -                    | 固定列位置。左/右固定列会覆盖滚动列并显示阴影。                                             |

package/dist/index.cjs

@@ -814,8 +814,9 @@ function buildColumnMetrics(columns, columnDraggableOrOptions = false) {
   });
   const viewportWidth = options.viewportWidth ?? 0;
   if (viewportWidth <= left || columns.length === 0) return metrics;
-  const stretchable = columns.map((column, index) => ({ column, index })).filter(({ column }) => column.fixed !== "right" && !column.rowSelection && !column.rowDragHandle && !column.rowNumber);
-  const targets = stretchable.length > 0 ? stretchable : columns.map((column, index) => ({ column, index })).filter(({ column }) => column.fixed !== "right");
+  const unsetWidthStretchable = columns.map((column, index) => ({ column, index })).filter(({ column }) => column.width === void 0 && column.fixed === void 0 && !column.rowSelection && !column.rowDragHandle && !column.rowNumber);
+  const dataStretchable = columns.map((column, index) => ({ column, index })).filter(({ column }) => column.fixed === void 0 && !column.rowSelection && !column.rowDragHandle && !column.rowNumber);
+  const targets = unsetWidthStretchable.length > 0 ? unsetWidthStretchable : dataStretchable.length > 0 ? dataStretchable : [];
   if (targets.length === 0) return metrics;
   const extra = viewportWidth - left;
   const baseTotal = targets.reduce((sum, { index }) => sum + metrics[index].width, 0);
@@ -1069,7 +1070,7 @@ function paintGrid(options) {
       if (!verticalBorderless) ctx.fillRect(x + metric.width - 1, headerY, 1, headerHeight);
       ctx.fillRect(x, headerY + headerHeight - 1, metric.width, 1);
       const column = columns[columnIndex];
-      if (!column.rowSelection && !column.rowDragHandle && !column.rowNumber && column.title) {
+      if (!column.rowSelection && !column.rowDragHandle && !column.rowNumber && !column.renderHeader && column.title) {
         ctx.font = "600 13px Inter, ui-sans-serif, system-ui, sans-serif";
         const titleWidth = ctx.measureText(column.title).width;
         const visibleActions = getVisibleHeaderActions(column, metric.width, columnDraggable, titleWidth);
@@ -1328,12 +1329,14 @@ function Table({
   rowKey,
   width = "100%",
   height = "100%",
-  autoHeight = false,
-  rowHeight = 36,
-  headerHeight = 40,
+  autoHeight = true,
+  layout,
+  rowHeight: rowHeightProp,
+  headerHeight: headerHeightProp,
   fixedHeader = true,
   locale = "zh-CN",
-  verticalBorderless = false,
+  borderless,
+  verticalBorderless,
   striped = false,
   highlight,
   cellSpans = [],
@@ -1375,8 +1378,13 @@ function Table({
   style,
   ariaLabel = "Data grid"
 }) {
+  const rowHeight = layout?.rowHeight ?? rowHeightProp ?? 36;
+  const baseHeaderHeight = layout?.headerHeight ?? headerHeightProp ?? 40;
   const { language, labels } = (0, import_react5.useMemo)(() => resolveGridLocale(locale), [locale]);
-  const hasVerticalBorders = !verticalBorderless;
+  const customHeaderContentRefs = (0, import_react5.useRef)(/* @__PURE__ */ new Map());
+  const [measuredHeaderHeight, setMeasuredHeaderHeight] = (0, import_react5.useState)(0);
+  const headerHeight = Math.max(baseHeaderHeight, measuredHeaderHeight);
+  const hasVerticalBorders = !(borderless ?? verticalBorderless ?? false);
   const hasStripedRows = Boolean(striped);
   const stripedColor = typeof striped === "string" ? striped : void 0;
   const editedCellsHighlight = highlight?.editedCells ?? false;
@@ -1440,7 +1448,7 @@ function Table({
   const hoveredRowIndexRef = (0, import_react5.useRef)(null);
   const [viewport, setViewport] = (0, import_react5.useState)({ width: 0, height: typeof height === "number" ? height : FALLBACK_HEIGHT });
   const [horizontalScrollbarHeight, setHorizontalScrollbarHeight] = (0, import_react5.useState)(0);
-  const resolvedHeight = viewport.height || FALLBACK_HEIGHT;
+  const resolvedHeight = typeof height === "number" ? height : viewport.height || FALLBACK_HEIGHT;
   const [scrollPosition, setScrollPosition] = (0, import_react5.useState)({ left: 0, top: 0 });
   const scrollRef = (0, import_react5.useRef)({ left: 0, top: 0 });
   const [selection, setSelection] = useControllableValue(selectedCell, defaultSelectedCell, onSelectedCellChange);
@@ -1482,6 +1490,28 @@ function Table({
     if (headerTooltipTimerRef.current !== null) clearTimeout(headerTooltipTimerRef.current);
     if (cellTooltipTimerRef.current !== null) clearTimeout(cellTooltipTimerRef.current);
   }, []);
+  const measureCustomHeaderHeight = (0, import_react5.useCallback)(() => {
+    let nextHeight = 0;
+    customHeaderContentRefs.current.forEach((node) => {
+      nextHeight = Math.max(nextHeight, Math.ceil(node.scrollHeight) + 16);
+    });
+    setMeasuredHeaderHeight((current) => current === nextHeight ? current : nextHeight);
+  }, []);
+  (0, import_react5.useLayoutEffect)(() => {
+    const activeCustomHeaderKeys = new Set(columns.filter((column) => column.renderHeader).map((column) => column.key));
+    customHeaderContentRefs.current.forEach((_, key) => {
+      if (!activeCustomHeaderKeys.has(key)) customHeaderContentRefs.current.delete(key);
+    });
+    if (customHeaderContentRefs.current.size === 0) {
+      setMeasuredHeaderHeight(0);
+      return;
+    }
+    measureCustomHeaderHeight();
+    if (typeof ResizeObserver === "undefined") return;
+    const observer = new ResizeObserver(measureCustomHeaderHeight);
+    customHeaderContentRefs.current.forEach((node) => observer.observe(node));
+    return () => observer.disconnect();
+  }, [columns, measureCustomHeaderHeight, viewport.width]);
   const [filterEditor, setFilterEditor] = (0, import_react5.useState)(null);
   const [contextMenu, setContextMenu] = (0, import_react5.useState)(null);
   const [insertCounts, setInsertCounts] = (0, import_react5.useState)({ before: 1, after: 1 });
@@ -1490,6 +1520,7 @@ function Table({
   const [insertBusy, setInsertBusy] = (0, import_react5.useState)(false);
   const [deleteBusy, setDeleteBusy] = (0, import_react5.useState)(false);
   const [toast, setToast] = (0, import_react5.useState)(null);
+  const [resizeGuideX, setResizeGuideX] = (0, import_react5.useState)(null);
   const [hoveredHeaderAction, setHoveredHeaderAction] = (0, import_react5.useState)(null);
   const [visibleHeaderTooltip, setVisibleHeaderTooltip] = (0, import_react5.useState)(null);
   const [hoveredCellTooltip, setHoveredCellTooltip] = (0, import_react5.useState)(null);
@@ -1588,14 +1619,15 @@ function Table({
   }, [columns, metrics]);
   const hasRowSelectionColumn = (0, import_react5.useMemo)(() => columns.some((column) => column.rowSelection), [columns]);
   const rowSelectionMode = typeof rowSelection === "object" ? rowSelection.mode ?? "multiple" : "multiple";
-  const hasSummaryRow = (0, import_react5.useMemo)(() => summaryEnabled && columns.some((column) => Boolean(column.summary)), [columns, summaryEnabled]);
+  const hasSummaryRow = (0, import_react5.useMemo)(() => rows.length > 0 && summaryEnabled && columns.some((column) => Boolean(column.summary)), [columns, rows.length, summaryEnabled]);
   const topSummaryHeight = hasSummaryRow && summaryPosition === "top" ? rowHeight : 0;
   const bottomSummaryHeight = hasSummaryRow && summaryPosition === "bottom" ? rowHeight : 0;
   const bodyTop = headerHeight + topSummaryHeight;
   const bodyContentHeight = rows.length === 0 ? EMPTY_BODY_HEIGHT : contentHeight;
   const realContentHeight = bodyTop + bodyContentHeight + bottomSummaryHeight + (contentWidth > viewport.width ? horizontalScrollbarHeight : 0);
   const effectiveHeight = autoHeight ? Math.max(bodyTop + bottomSummaryHeight, Math.min(resolvedHeight, realContentHeight)) : resolvedHeight;
-  const bodyViewportHeight = Math.max(0, effectiveHeight - (fixedHeader ? headerHeight : 0) - topSummaryHeight);
+  const renderHeight = Math.max(0, effectiveHeight - bottomSummaryHeight);
+  const bodyViewportHeight = Math.max(0, renderHeight - (fixedHeader ? headerHeight : 0) - topSummaryHeight);
   const [summaryState, setSummaryState] = (0, import_react5.useState)(() => ({ columns: null, rows: null, values: /* @__PURE__ */ new Map(), pending: false }));
   const summaryPending = hasSummaryRow && (loading || summaryState.pending || summaryState.columns !== columns || summaryState.rows !== rows);
   const summaryValues = hasSummaryRow && summaryState.columns === columns && summaryState.rows === rows ? summaryState.values : /* @__PURE__ */ new Map();
@@ -1642,14 +1674,30 @@ function Table({
     rowIndexByKeyRef.current.set(key, index);
     return key;
   }, [getDataRowKey]);
+  const resolvedCellSpans = (0, import_react5.useMemo)(() => {
+    if (Array.isArray(cellSpans)) return cellSpans;
+    const spans = [];
+    rows.forEach((row, rowIndex) => {
+      columns.forEach((column, columnIndex) => {
+        const span = cellSpans({ row, rowIndex, column, columnIndex, rows, columns });
+        if (!span) return;
+        spans.push({
+          rowIndex,
+          columnKey: column.key,
+          ...span
+        });
+      });
+    });
+    return spans;
+  }, [cellSpans, columns, rows]);
   const cellSpanLookup = (0, import_react5.useMemo)(() => {
-    if (cellSpans.length === 0) return createEmptyCellSpanLookup();
+    if (resolvedCellSpans.length === 0) return createEmptyCellSpanLookup();
     const rowIndexByKey = /* @__PURE__ */ new Map();
     rows.forEach((row, index) => rowIndexByKey.set(getRowKey(row, index), index));
     const columnIndexByKey = new Map(columns.map((column, index) => [column.key, index]));
     const lookup = createEmptyCellSpanLookup();
     const occupied = /* @__PURE__ */ new Set();
-    for (const span of cellSpans) {
+    for (const span of resolvedCellSpans) {
       const rowIndex = span.rowKey !== void 0 ? rowIndexByKey.get(span.rowKey) : span.rowIndex;
       const columnIndex = columnIndexByKey.get(span.columnKey);
       if (rowIndex === void 0 || columnIndex === void 0) continue;
@@ -1685,7 +1733,7 @@ function Table({
       }
     }
     return lookup;
-  }, [cellSpans, columns, getRowKey, rows]);
+  }, [columns, getRowKey, resolvedCellSpans, rows]);
   const selectedRowKeySet = (0, import_react5.useMemo)(() => new Set(rowKeys), [rowKeys]);
   const selectedColumnKeySet = (0, import_react5.useMemo)(() => new Set(columnKeys), [columnKeys]);
   const insertedRowKeySet = (0, import_react5.useMemo)(() => insertedRowKeys, [insertedRowKeys]);
@@ -1732,7 +1780,7 @@ function Table({
     if (!canvas || viewport.width <= 0) return;
     const ratio = Math.min(window.devicePixelRatio || 1, 2);
     const physicalWidth = Math.round(viewport.width * ratio);
-    const physicalHeight = Math.round(effectiveHeight * ratio);
+    const physicalHeight = Math.round(renderHeight * ratio);
     if (canvas.width !== physicalWidth) canvas.width = physicalWidth;
     if (canvas.height !== physicalHeight) canvas.height = physicalHeight;
     const context = canvas.getContext("2d");
@@ -1755,8 +1803,8 @@ function Table({
     const scroll = scrollRef.current;
     const rowScrollTop = fixedHeader ? scroll.top : Math.max(0, scroll.top - bodyTop);
     const range = isVirtualized ? getViewportRange(scroll.left, rowScrollTop, viewport.width, bodyViewportHeight, rows.length, rowHeight, metrics, virtualOverscan) : { rowStart: 0, rowEnd: rows.length, columnStart: 0, columnEnd: columns.length };
-    paintGrid({ context, width: viewport.width, height: effectiveHeight, pixelRatio: ratio, scrollLeft: scroll.left, scrollTop: scroll.top, rowHeight, headerHeight, bodyTop, suppressLastRowBottomBorder: bottomSummaryHeight > 0, suppressFrameBottomBorder: bottomSummaryHeight > 0, fixedHeader, verticalBorderless: !hasVerticalBorders, striped: hasStripedRows, columnDraggable, sortState, filterValues, hoveredHeaderAction: hoveredHeaderActionRef.current, rows, columns, metrics, range, selection, editing, hoveredRowIndex: hoveredRowIndexRef.current, selectionRange, selectedRowKeys: selectedRowKeySet, selectedColumnKeys: selectedColumnKeySet, cellSpans: cellSpanLookup.covered, maxRowSpan: cellSpanLookup.maxRowSpan, highlightEditedCells: highlightsEditedCells, highlightInsertedRows: highlightsInsertedRows, insertedRowKeys: insertedRowKeySet, editedCellKeys, cellAnnotations, getRowKey, rowDragPreview, colors: themeColors });
-  }, [bodyTop, bodyViewportHeight, bottomSummaryHeight, cellAnnotations, cellSpanLookup, columnDraggable, columns, editedCellHighlightColor, editedCellKeys, editing, effectiveHeight, filterValues, fixedHeader, getRowKey, hasStripedRows, hasVerticalBorders, headerHeight, highlightsEditedCells, highlightsInsertedRows, insertedRowHighlightColor, insertedRowKeySet, isVirtualized, metrics, rowDragPreview, rowHeight, rows, selectedColumnKeySet, selectedRowKeySet, selection, selectionRange, sortState, stripedColor, viewport.width, virtualOverscan]);
+    paintGrid({ context, width: viewport.width, height: renderHeight, pixelRatio: ratio, scrollLeft: scroll.left, scrollTop: scroll.top, rowHeight, headerHeight, bodyTop, suppressLastRowBottomBorder: bottomSummaryHeight > 0, suppressFrameBottomBorder: bottomSummaryHeight > 0, fixedHeader, verticalBorderless: !hasVerticalBorders, striped: hasStripedRows, columnDraggable, sortState, filterValues, hoveredHeaderAction: hoveredHeaderActionRef.current, rows, columns, metrics, range, selection, editing, hoveredRowIndex: hoveredRowIndexRef.current, selectionRange, selectedRowKeys: selectedRowKeySet, selectedColumnKeys: selectedColumnKeySet, cellSpans: cellSpanLookup.covered, maxRowSpan: cellSpanLookup.maxRowSpan, highlightEditedCells: highlightsEditedCells, highlightInsertedRows: highlightsInsertedRows, insertedRowKeys: insertedRowKeySet, editedCellKeys, cellAnnotations, getRowKey, rowDragPreview, colors: themeColors });
+  }, [bodyTop, bodyViewportHeight, bottomSummaryHeight, cellAnnotations, cellSpanLookup, columnDraggable, columns, editedCellHighlightColor, editedCellKeys, editing, renderHeight, filterValues, fixedHeader, getRowKey, hasStripedRows, hasVerticalBorders, headerHeight, highlightsEditedCells, highlightsInsertedRows, insertedRowHighlightColor, insertedRowKeySet, isVirtualized, metrics, rowDragPreview, rowHeight, rows, selectedColumnKeySet, selectedRowKeySet, selection, selectionRange, sortState, stripedColor, viewport.width, virtualOverscan]);
   const scheduleDraw = (0, import_react5.useCallback)(() => {
     if (frameRef.current === null) frameRef.current = requestAnimationFrame(draw);
   }, [draw]);
@@ -1865,14 +1913,14 @@ function Table({
         const horizontalStart = column.fixed === void 0 ? fixedWidth : 0;
         const horizontalEnd = column.fixed === void 0 ? viewport.width - rightFixedWidth : viewport.width;
         const verticalStart = fixedHeader ? bodyTop : 0;
-        if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= effectiveHeight) {
+        if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= renderHeight) {
           focus.style.display = "none";
         } else {
           const borderWidth = 2;
           const left = Math.round(Math.max(rawLeft - borderWidth, horizontalStart - 1));
           const right = Math.round(Math.min(rawRight + 1, horizontalEnd, viewport.width));
           const top = Math.round(Math.max(rawTop - borderWidth, verticalStart - 1));
-          const bottom = Math.round(Math.min(rawBottom + 1, effectiveHeight));
+          const bottom = Math.round(Math.min(rawBottom + 1, renderHeight));
           focus.style.display = "block";
           focus.style.left = `${left}px`;
           focus.style.top = `${top}px`;
@@ -1897,7 +1945,7 @@ function Table({
     setHoveredCellTooltip(null);
     scheduleDraw();
     setEditing(null);
-  }, [bodyTop, columns, effectiveHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedOffsets, rightFixedWidth, rowHeight, rows, scheduleDraw, selection, selectionRange, viewport.width]);
+  }, [bodyTop, columns, renderHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedOffsets, rightFixedWidth, rowHeight, rows, scheduleDraw, selection, selectionRange, viewport.width]);
   const locateColumn = (0, import_react5.useCallback)((clientX) => {
     const canvas = canvasRef.current;
     if (!canvas) return -1;
@@ -1938,6 +1986,16 @@ function Table({
     }
     return closest;
   }, [columnResizable, columns, getDisplayedColumnLeft, metrics]);
+  const findResizeNeighbor = (0, import_react5.useCallback)((columnIndex) => {
+    const resizedColumn = columns[columnIndex];
+    for (let index = columnIndex + 1; index < columns.length; index += 1) {
+      const column = columns[index];
+      if (column.rowSelection || column.rowDragHandle || column.rowNumber) continue;
+      if (resizedColumn?.fixed && column.fixed !== resizedColumn.fixed) return -1;
+      return index;
+    }
+    return -1;
+  }, [columns]);
   const locateHeaderAction = (0, import_react5.useCallback)((clientX, columnIndex) => {
     if (columnIndex < 0 || !canvasRef.current) return null;
     const column = columns[columnIndex];
@@ -2485,13 +2543,13 @@ function Table({
       const rowTop = (fixedHeader ? 0 : bodyTop) + rowIndex * rowHeight;
       const rowBottom = rowTop + rowHeight * (span?.rowSpan ?? 1);
       const cellWidth = getCellDisplayWidth(columnIndex, span?.colSpan ?? 1);
-      const visibleRowHeight = fixedHeader ? effectiveHeight - bodyTop : effectiveHeight;
+      const visibleRowHeight = fixedHeader ? renderHeight - bodyTop : renderHeight;
       if (rowTop < scroller.scrollTop) scroller.scrollTop = rowTop;
       if (rowBottom > scroller.scrollTop + visibleRowHeight) scroller.scrollTop = rowBottom - visibleRowHeight;
       if (columns[columnIndex].fixed === void 0 && metric.left < scroller.scrollLeft + fixedWidth) scroller.scrollLeft = Math.max(0, metric.left - fixedWidth);
       if (columns[columnIndex].fixed === void 0 && metric.left + cellWidth > scroller.scrollLeft + viewport.width - rightFixedWidth) scroller.scrollLeft = metric.left + cellWidth - viewport.width + rightFixedWidth;
     }
-  }, [beginEdit, bodyTop, columns, editing, effectiveHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedWidth, rowHeight, rows, selection, setSelection, viewport.width]);
+  }, [beginEdit, bodyTop, columns, editing, renderHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedWidth, rowHeight, rows, selection, setSelection, viewport.width]);
   const editorStyle = (0, import_react5.useMemo)(() => {
     if (!editing) return void 0;
     const metric = metrics[editing.columnIndex];
@@ -2516,26 +2574,48 @@ function Table({
     if (resizeIndex >= 0) {
       event.preventDefault();
       event.currentTarget.setPointerCapture(event.pointerId);
-      columnDragRef.current = { type: "resize", columnIndex: resizeIndex, startX: event.clientX, startWidth: metrics[resizeIndex].width };
+      const neighborIndex = findResizeNeighbor(resizeIndex);
+      const startGuideX = getDisplayedColumnLeft(resizeIndex) + metrics[resizeIndex].width;
+      columnDragRef.current = {
+        type: "resize",
+        columnIndex: resizeIndex,
+        startX: event.clientX,
+        startWidth: metrics[resizeIndex].width,
+        startGuideX,
+        neighborIndex,
+        startNeighborWidth: neighborIndex >= 0 ? metrics[neighborIndex].width : 0
+      };
       suppressClickRef.current = true;
-      setDragGuide(getDisplayedColumnLeft(resizeIndex) + metrics[resizeIndex].width);
+      setResizeGuideX(startGuideX);
       return;
     }
-  }, [fixedHeader, getDisplayedColumnLeft, headerHeight, locateResizeHandle, metrics, setDragGuide]);
+  }, [findResizeNeighbor, fixedHeader, getDisplayedColumnLeft, headerHeight, locateResizeHandle, metrics]);
   const handleColumnPointerMove = (0, import_react5.useCallback)((event) => {
     const drag = columnDragRef.current;
     if (!drag) return;
-    const width2 = Math.max(getMinimumColumnWidth(columns[drag.columnIndex], columnDraggable), Math.round(drag.startWidth + event.clientX - drag.startX));
-    onColumnResize?.(columns[drag.columnIndex].key, width2);
-    setDragGuide(getDisplayedColumnLeft(drag.columnIndex) + width2);
-  }, [columnDraggable, columns, getDisplayedColumnLeft, onColumnResize, setDragGuide]);
+    const column = columns[drag.columnIndex];
+    const minWidth = getMinimumColumnWidth(column, columnDraggable);
+    let delta = Math.round(event.clientX - drag.startX);
+    if (drag.neighborIndex >= 0) {
+      const neighbor = columns[drag.neighborIndex];
+      const minNeighborWidth = getMinimumColumnWidth(neighbor, columnDraggable);
+      delta = Math.max(minWidth - drag.startWidth, Math.min(drag.startNeighborWidth - minNeighborWidth, delta));
+      onColumnResize?.(column.key, drag.startWidth + delta);
+      onColumnResize?.(neighbor.key, drag.startNeighborWidth - delta);
+      setResizeGuideX(drag.startGuideX + delta);
+      return;
+    }
+    const width2 = Math.max(minWidth, Math.round(drag.startWidth + delta));
+    onColumnResize?.(column.key, width2);
+    setResizeGuideX(drag.startGuideX + width2 - drag.startWidth);
+  }, [columnDraggable, columns, onColumnResize]);
   const handleColumnPointerUp = (0, import_react5.useCallback)((event) => {
     const drag = columnDragRef.current;
     if (!drag) return;
     if (event.currentTarget.hasPointerCapture(event.pointerId)) event.currentTarget.releasePointerCapture(event.pointerId);
     columnDragRef.current = null;
-    setDragGuide(null);
-  }, [setDragGuide]);
+    setResizeGuideX(null);
+  }, []);
   const queueSortStateChange = (0, import_react5.useCallback)((next) => {
     setDisplaySortState(next);
     if (sortDebounceRef.current !== null) clearTimeout(sortDebounceRef.current);
@@ -2715,7 +2795,7 @@ function Table({
       type: "cell",
       ...cell,
       left: Math.min(Math.max(0, clientX - root.left), Math.max(0, viewport.width - 190)),
-      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, effectiveHeight - 350))
+      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, renderHeight - 350))
     });
     onCellContextMenu?.({ ...cell, row: rows[cell.rowIndex], clientX, clientY });
   };
@@ -2726,7 +2806,7 @@ function Table({
       type: "header",
       columnIndex,
       left: Math.min(Math.max(0, clientX - root.left), Math.max(0, viewport.width - 180)),
-      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, effectiveHeight - 68))
+      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, renderHeight - 68))
     });
   };
   const getRowDragOffset = (rowIndex) => {
@@ -2942,6 +3022,35 @@ function Table({
         column.key
       );
     }
+    if (column.renderHeader) {
+      const visibleActions = getVisibleHeaderActions(column, metrics[columnIndex].width, columnDraggable, measureHeaderTitleWidth(columnIndex));
+      const actionWidth = (Number(visibleActions.drag) + Number(visibleActions.filter) + Number(visibleActions.sort)) * 18;
+      return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+        "div",
+        {
+          className: "rvg-header-title is-custom",
+          style: {
+            left,
+            top: fixedHeader ? 0 : -currentScrollTop,
+            width: Math.max(0, metrics[columnIndex].width - actionWidth),
+            height: headerHeight,
+            justifyContent: column.align === "right" ? "flex-end" : column.align === "center" ? "center" : "flex-start",
+            textAlign: column.align === "right" ? "right" : column.align === "center" ? "center" : "left"
+          },
+          children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+            "span",
+            {
+              ref: (node) => {
+                if (node) customHeaderContentRefs.current.set(column.key, node);
+                else customHeaderContentRefs.current.delete(column.key);
+              },
+              children: column.renderHeader(column)
+            }
+          )
+        },
+        column.key
+      );
+    }
     return null;
   };
   const rangeHandlePosition = (() => {
@@ -2956,7 +3065,7 @@ function Table({
     const horizontalStart = column.fixed === void 0 ? fixedWidth : 0;
     const horizontalEnd = column.fixed === void 0 ? viewport.width - rightFixedWidth : viewport.width;
     const verticalStart = fixedHeader ? bodyTop : 0;
-    if (rawLeft <= horizontalStart || rawLeft > horizontalEnd || rawTop <= verticalStart || rawTop > effectiveHeight) return null;
+    if (rawLeft <= horizontalStart || rawLeft > horizontalEnd || rawTop <= verticalStart || rawTop > renderHeight) return null;
     return { left: rawLeft, top: rawTop, bounds };
   })();
   const selectionOutlineStyle = (() => {
@@ -2973,12 +3082,12 @@ function Table({
     const horizontalStart = column.fixed === void 0 ? fixedWidth : 0;
     const horizontalEnd = column.fixed === void 0 ? viewport.width - rightFixedWidth : viewport.width;
     const verticalStart = fixedHeader ? bodyTop : 0;
-    if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= effectiveHeight) return null;
+    if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= renderHeight) return null;
     const borderWidth = 2;
     const left = Math.round(Math.max(rawLeft - borderWidth, horizontalStart - 1));
     const right = Math.round(Math.min(rawRight + 1, horizontalEnd, viewport.width));
     const top = Math.round(Math.max(rawTop - borderWidth, verticalStart - 1));
-    const bottom = Math.round(Math.min(rawBottom + 1, effectiveHeight));
+    const bottom = Math.round(Math.min(rawBottom + 1, renderHeight));
     return {
       left,
       top,
@@ -3093,8 +3202,10 @@ function Table({
   const renderSummaryCell = (columnIndex, left) => {
     const column = columns[columnIndex];
     const isUtility = column.rowSelection || column.rowDragHandle || column.rowNumber;
-    const summaryContent = summaryValues.has(column.key) ? summaryValues.get(column.key) : summaryEmptyValue;
-    const content = column.rowNumber ? language === "zh-CN" ? "\u5408\u8BA1" : "Total" : summaryPending ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "rvg-summary-skeleton" }) : summaryContent;
+    const hasSummaryValue = summaryValues.has(column.key);
+    const summaryContent = hasSummaryValue ? summaryValues.get(column.key) : summaryEmptyValue;
+    const showSummarySkeleton = Boolean(column.summary) && summaryPending;
+    const content = columnIndex === 0 ? language === "zh-CN" ? "\u5408\u8BA1" : "Total" : showSummarySkeleton ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "rvg-summary-skeleton" }) : summaryContent;
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       "div",
       {
@@ -3125,7 +3236,7 @@ function Table({
         {
           ref: canvasRef,
           className: "rvg-canvas",
-          style: { width: viewport.width, height: effectiveHeight },
+          style: { width: viewport.width, height: renderHeight },
           onMouseMove: (event) => {
             if (columnDragRef.current) return;
             const rect = event.currentTarget.getBoundingClientRect();
@@ -3303,7 +3414,7 @@ function Table({
           onContextMenu: handleContextMenu
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "rvg-text-layer", style: { width: viewport.width, height: effectiveHeight, marginTop: -effectiveHeight }, onContextMenu: handleContextMenu, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "rvg-text-layer", style: { width: viewport.width, height: renderHeight, marginTop: -renderHeight }, onContextMenu: handleContextMenu, children: [
         /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-text-scroll-clip", style: { left: fixedWidth, right: rightFixedWidth }, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
           "div",
           {
@@ -3327,7 +3438,7 @@ function Table({
         columns.map((column, columnIndex) => column.fixed === "left" ? renderHeaderTitle(columnIndex, metrics[columnIndex].left) : null),
         columns.map((column, columnIndex) => column.fixed === "right" ? renderHeaderTitle(columnIndex, viewport.width - (rightFixedOffsets.get(columnIndex) ?? 0) - metrics[columnIndex].width) : null)
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-spacer", style: { width: contentWidth, height: contentHeight + bodyTop, marginTop: -effectiveHeight } })
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-spacer", style: { width: contentWidth, height: contentHeight + bodyTop, marginTop: -renderHeight } })
     ] }),
     hasSummaryRow && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
       "div",
@@ -3643,6 +3754,13 @@ function Table({
     ] }) }),
     toast && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: `rvg-toast is-${toast.type}`, role: "status", children: toast.message }),
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { ref: dragGuideRef, className: "rvg-column-guide" }),
+    resizeGuideX !== null && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+      "div",
+      {
+        className: "rvg-column-guide is-resizing",
+        style: { display: "block", transform: `translateX(${Math.round(resizeGuideX)}px)` }
+      }
+    ),
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { ref: rowDragGuideRef, className: "rvg-row-guide" }),
     filterEditor && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { ref: filterRef, className: "rvg-filter", style: { left: filterEditor.left, top: filterEditor.top }, children: [
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
@@ -3691,7 +3809,7 @@ function Table({
     rows.length === 0 && !loading && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-empty", style: { top: bodyTop }, children: emptyContent ?? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DefaultEmptyState, { label: labels.empty }) }),
     loading && hasCustomLoading && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-custom-loading", "aria-label": labels.refreshing, children: loadingContent }),
     loading && !hasCustomLoading && !hasCompletedLoadRef.current && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "rvg-initial-loading", style: { top: headerHeight }, "aria-label": labels.initialLoading, children: [
-      Array.from({ length: Math.ceil((effectiveHeight - headerHeight) / rowHeight) }, (_, rowIndex) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-loading-row", style: { height: rowHeight }, children: columns.map((column, columnIndex) => {
+      Array.from({ length: Math.ceil((renderHeight - headerHeight) / rowHeight) }, (_, rowIndex) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rvg-loading-row", style: { height: rowHeight }, children: columns.map((column, columnIndex) => {
         const left = getDisplayedColumnLeft(columnIndex);
         const columnWidth = metrics[columnIndex].width;
         if (left + columnWidth <= 0 || left >= viewport.width) return null;

package/dist/index.css

@@ -150,6 +150,15 @@
   white-space: nowrap;
   user-select: text;
 }
+.rvg-header-title.is-custom {
+  overflow: visible;
+  white-space: normal;
+}
+.rvg-header-title.is-custom > span {
+  overflow: visible;
+  white-space: normal;
+  text-overflow: clip;
+}
 .rvg-row-drag-icon {
   position: absolute;
   display: grid;
@@ -1154,14 +1163,18 @@
   z-index: 6;
   background: var(--rvg-color-bg);
 }
+.rvg-choice-editor {
+  line-height: 1;
+}
 .rvg-time-editor {
   position: absolute;
   z-index: 6;
   display: flex;
-  padding: 0 28px 0 8px;
+  padding: 0 28px 0 9px;
   align-items: center;
   gap: 3px;
   background: var(--rvg-color-bg);
+  line-height: 1;
 }
 .rvg-time-field-group {
   display: contents;
@@ -1169,6 +1182,7 @@
 .rvg-time-editor input {
   min-width: 0;
   height: 100%;
+  transform: translateY(-1px);
   flex: 1;
   padding: 0;
   border: 0;
@@ -1180,17 +1194,18 @@
     ui-sans-serif,
     system-ui,
     sans-serif;
-  line-height: 1;
+  line-height: normal;
 }
 .rvg-native-editor {
   position: absolute;
   z-index: 6;
   display: flex;
-  padding: 0 8px;
+  padding: 0 9px;
   align-items: center;
   gap: 6px;
   overflow: hidden;
   background: var(--rvg-color-bg);
+  line-height: 1;
 }
 .rvg-native-editor.has-clear {
   padding-right: 32px;
@@ -1198,18 +1213,20 @@
 .rvg-native-editor input {
   min-width: 0;
   width: 100%;
-  height: 20px;
+  height: 100%;
   padding: 0;
+  transform: translateY(-1px);
   flex: 1;
   border: 0;
   outline: 0;
   background: transparent;
   color: var(--rvg-color-text);
   font:
-    13px/20px Inter,
+    13px Inter,
     ui-sans-serif,
     system-ui,
     sans-serif;
+  line-height: normal;
   box-sizing: border-box;
 }
 .rvg-native-editor span {
@@ -1448,13 +1465,14 @@
 }
 .rvg-choice-editor [data-part=trigger] {
   padding: 0 28px 0 9px;
+  line-height: 1;
 }
 .rvg-date-value {
-  padding-top: 0;
-  padding-bottom: 2px;
+  padding: 0 8px 2px 9px;
 }
 .rvg-choice-editor [data-part=value-text] {
   min-width: 0;
+  transform: translateY(-1px);
   overflow: hidden;
   font: inherit;
   line-height: normal;

package/dist/index.d.cts

@@ -116,6 +116,12 @@ interface TableHighlightConfig {
     /** Highlight rows inserted optimistically through the built-in insert action. Pass a color string to customize the fill. Defaults to false. */
     insertedRows?: boolean | string;
 }
+interface TableLayoutConfig {
+    /** Fixed body row height in pixels. Defaults to 36. */
+    rowHeight?: number;
+    /** Header height in pixels. Defaults to 40. */
+    headerHeight?: number;
+}
 interface TableCellSpan {
     /** Row index in the current rows array. Prefer rowKey when row order can change. */
     rowIndex?: number;
@@ -128,6 +134,16 @@ interface TableCellSpan {
     /** Number of columns covered by the merged cell. Defaults to 1. */
     colSpan?: number;
 }
+interface TableCellSpanRuleContext<Row extends object> {
+    row: Row;
+    rowIndex: number;
+    column: GridColumn<Row>;
+    columnIndex: number;
+    rows: Row[];
+    columns: GridColumn<Row>[];
+}
+type TableCellSpanRule<Row extends object> = (context: TableCellSpanRuleContext<Row>) => TableCellSpan | Omit<TableCellSpan, 'rowIndex' | 'rowKey' | 'columnKey'> | false | null | undefined;
+type TableCellSpans<Row extends object> = TableCellSpan[] | TableCellSpanRule<Row>;
 interface TableResolvedCellSpan {
     rowIndex: number;
     columnIndex: number;
@@ -149,6 +165,8 @@ interface GridColumn<Row> {
     key: string;
     /** Header label painted in the text layer. */
     title: string;
+    /** Custom React content rendered in the header DOM overlay. */
+    renderHeader?: (column: GridColumn<Row>) => ReactNode;
     /** Row field used as this column's cell value. Omit for utility columns. */
     dataIndex?: keyof Row;
     /** Preferred column width in pixels. Layout helpers enforce minimums. */
@@ -282,20 +300,26 @@ interface TableProps<Row extends object> {
     width?: number | string;
     /** Grid height. Defaults to 100%; falls back to 480px when the parent has no height. */
     height?: number | string;
-    /** Shrink the grid to its real content height when there are fewer rows than the configured height can display. */
+    /** Shrink the grid to its real content height when there are fewer rows than the configured max height can display. Defaults to true. */
     autoHeight?: boolean;
+    /** Layout and sizing configuration. Prefer this over rowHeight/headerHeight for new code. */
+    layout?: TableLayoutConfig;
+    /** @deprecated Use layout.rowHeight instead. */
     rowHeight?: number;
+    /** @deprecated Use layout.headerHeight instead. */
     headerHeight?: number;
     fixedHeader?: boolean;
     locale?: TableLocaleConfig;
-    /** Hide vertical grid lines while keeping horizontal row separators. */
+    /** Hide vertical grid lines while keeping horizontal row separators. Prefer borderless for new code. */
+    borderless?: boolean;
+    /** @deprecated Use borderless instead. */
     verticalBorderless?: boolean;
     /** Paint alternating row backgrounds. Pass a color string to customize the stripe color. */
     striped?: boolean | string;
     /** Visual highlight feedback configuration. All entries default to false. */
     highlight?: TableHighlightConfig;
     /** Merged body cell configuration. Utility columns are ignored and horizontal spans are limited to the same fixed column region. */
-    cellSpans?: TableCellSpan[];
+    cellSpans?: TableCellSpans<Row>;
     loading?: boolean;
     /** Custom loading content. When provided, it is used for both initial loading and refresh loading. */
     loadingContent?: ReactNode;
@@ -348,7 +372,7 @@ interface ViewportRange {
     columnEnd: number;
 }
 
-declare function Table<Row extends object>({ columns: sourceColumns, rows: sourceRows, rowKey, width, height, autoHeight, rowHeight, headerHeight, fixedHeader, locale, verticalBorderless, striped, highlight, cellSpans, loading, loadingContent, virtualized, tooltip, summary, rowNumber, selectedCell, defaultSelectedCell, onSelectedCellChange, rangeSelection, rowSelection, selectedRowKeys, defaultSelectedRowKeys, onSelectedRowKeysChange, columnSelection, selectedColumnKeys, defaultSelectedColumnKeys, onSelectedColumnKeysChange, columnDraggable, columnResizable, onColumnOrderChange, onColumnResize, rowDraggable, onRowOrderChange, onInsertRows, onDeleteRows, sortState, onSortStateChange, filterValues, onFilterValuesChange, onCellChange, onCellContextMenu, contextMenu: contextMenuConfig, emptyContent, className, style, ariaLabel, }: TableProps<Row>): react.JSX.Element;
+declare function Table<Row extends object>({ columns: sourceColumns, rows: sourceRows, rowKey, width, height, autoHeight, layout, rowHeight: rowHeightProp, headerHeight: headerHeightProp, fixedHeader, locale, borderless, verticalBorderless, striped, highlight, cellSpans, loading, loadingContent, virtualized, tooltip, summary, rowNumber, selectedCell, defaultSelectedCell, onSelectedCellChange, rangeSelection, rowSelection, selectedRowKeys, defaultSelectedRowKeys, onSelectedRowKeysChange, columnSelection, selectedColumnKeys, defaultSelectedColumnKeys, onSelectedColumnKeysChange, columnDraggable, columnResizable, onColumnOrderChange, onColumnResize, rowDraggable, onRowOrderChange, onInsertRows, onDeleteRows, sortState, onSortStateChange, filterValues, onFilterValuesChange, onCellChange, onCellContextMenu, contextMenu: contextMenuConfig, emptyContent, className, style, ariaLabel, }: TableProps<Row>): react.JSX.Element;
 
 type LayoutColumn<Row> = GridColumn<Row> & {
     rowSelection?: boolean;
@@ -395,4 +419,4 @@ declare function hitTestColumn(metrics: ColumnMetric[], contentX: number): numbe
 
 type TableFilterValues = Record<string, string>;
 
-export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type DeleteRowsEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSortState, type InsertRowsEvent, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type GridCellPosition as TableCellPosition, type TableCellSpan, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type DeleteRowsEvent as TableDeleteRowsEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type InsertRowsEvent as TableInsertRowsEvent, type GridKey as TableKey, type TableLabels, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableResolvedCellSpan, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };
+export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type DeleteRowsEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSortState, type InsertRowsEvent, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type DeleteRowsEvent as TableDeleteRowsEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type InsertRowsEvent as TableInsertRowsEvent, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableResolvedCellSpan, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };

package/dist/index.d.ts

@@ -116,6 +116,12 @@ interface TableHighlightConfig {
     /** Highlight rows inserted optimistically through the built-in insert action. Pass a color string to customize the fill. Defaults to false. */
     insertedRows?: boolean | string;
 }
+interface TableLayoutConfig {
+    /** Fixed body row height in pixels. Defaults to 36. */
+    rowHeight?: number;
+    /** Header height in pixels. Defaults to 40. */
+    headerHeight?: number;
+}
 interface TableCellSpan {
     /** Row index in the current rows array. Prefer rowKey when row order can change. */
     rowIndex?: number;
@@ -128,6 +134,16 @@ interface TableCellSpan {
     /** Number of columns covered by the merged cell. Defaults to 1. */
     colSpan?: number;
 }
+interface TableCellSpanRuleContext<Row extends object> {
+    row: Row;
+    rowIndex: number;
+    column: GridColumn<Row>;
+    columnIndex: number;
+    rows: Row[];
+    columns: GridColumn<Row>[];
+}
+type TableCellSpanRule<Row extends object> = (context: TableCellSpanRuleContext<Row>) => TableCellSpan | Omit<TableCellSpan, 'rowIndex' | 'rowKey' | 'columnKey'> | false | null | undefined;
+type TableCellSpans<Row extends object> = TableCellSpan[] | TableCellSpanRule<Row>;
 interface TableResolvedCellSpan {
     rowIndex: number;
     columnIndex: number;
@@ -149,6 +165,8 @@ interface GridColumn<Row> {
     key: string;
     /** Header label painted in the text layer. */
     title: string;
+    /** Custom React content rendered in the header DOM overlay. */
+    renderHeader?: (column: GridColumn<Row>) => ReactNode;
     /** Row field used as this column's cell value. Omit for utility columns. */
     dataIndex?: keyof Row;
     /** Preferred column width in pixels. Layout helpers enforce minimums. */
@@ -282,20 +300,26 @@ interface TableProps<Row extends object> {
     width?: number | string;
     /** Grid height. Defaults to 100%; falls back to 480px when the parent has no height. */
     height?: number | string;
-    /** Shrink the grid to its real content height when there are fewer rows than the configured height can display. */
+    /** Shrink the grid to its real content height when there are fewer rows than the configured max height can display. Defaults to true. */
     autoHeight?: boolean;
+    /** Layout and sizing configuration. Prefer this over rowHeight/headerHeight for new code. */
+    layout?: TableLayoutConfig;
+    /** @deprecated Use layout.rowHeight instead. */
     rowHeight?: number;
+    /** @deprecated Use layout.headerHeight instead. */
     headerHeight?: number;
     fixedHeader?: boolean;
     locale?: TableLocaleConfig;
-    /** Hide vertical grid lines while keeping horizontal row separators. */
+    /** Hide vertical grid lines while keeping horizontal row separators. Prefer borderless for new code. */
+    borderless?: boolean;
+    /** @deprecated Use borderless instead. */
     verticalBorderless?: boolean;
     /** Paint alternating row backgrounds. Pass a color string to customize the stripe color. */
     striped?: boolean | string;
     /** Visual highlight feedback configuration. All entries default to false. */
     highlight?: TableHighlightConfig;
     /** Merged body cell configuration. Utility columns are ignored and horizontal spans are limited to the same fixed column region. */
-    cellSpans?: TableCellSpan[];
+    cellSpans?: TableCellSpans<Row>;
     loading?: boolean;
     /** Custom loading content. When provided, it is used for both initial loading and refresh loading. */
     loadingContent?: ReactNode;
@@ -348,7 +372,7 @@ interface ViewportRange {
     columnEnd: number;
 }
 
-declare function Table<Row extends object>({ columns: sourceColumns, rows: sourceRows, rowKey, width, height, autoHeight, rowHeight, headerHeight, fixedHeader, locale, verticalBorderless, striped, highlight, cellSpans, loading, loadingContent, virtualized, tooltip, summary, rowNumber, selectedCell, defaultSelectedCell, onSelectedCellChange, rangeSelection, rowSelection, selectedRowKeys, defaultSelectedRowKeys, onSelectedRowKeysChange, columnSelection, selectedColumnKeys, defaultSelectedColumnKeys, onSelectedColumnKeysChange, columnDraggable, columnResizable, onColumnOrderChange, onColumnResize, rowDraggable, onRowOrderChange, onInsertRows, onDeleteRows, sortState, onSortStateChange, filterValues, onFilterValuesChange, onCellChange, onCellContextMenu, contextMenu: contextMenuConfig, emptyContent, className, style, ariaLabel, }: TableProps<Row>): react.JSX.Element;
+declare function Table<Row extends object>({ columns: sourceColumns, rows: sourceRows, rowKey, width, height, autoHeight, layout, rowHeight: rowHeightProp, headerHeight: headerHeightProp, fixedHeader, locale, borderless, verticalBorderless, striped, highlight, cellSpans, loading, loadingContent, virtualized, tooltip, summary, rowNumber, selectedCell, defaultSelectedCell, onSelectedCellChange, rangeSelection, rowSelection, selectedRowKeys, defaultSelectedRowKeys, onSelectedRowKeysChange, columnSelection, selectedColumnKeys, defaultSelectedColumnKeys, onSelectedColumnKeysChange, columnDraggable, columnResizable, onColumnOrderChange, onColumnResize, rowDraggable, onRowOrderChange, onInsertRows, onDeleteRows, sortState, onSortStateChange, filterValues, onFilterValuesChange, onCellChange, onCellContextMenu, contextMenu: contextMenuConfig, emptyContent, className, style, ariaLabel, }: TableProps<Row>): react.JSX.Element;
 
 type LayoutColumn<Row> = GridColumn<Row> & {
     rowSelection?: boolean;
@@ -395,4 +419,4 @@ declare function hitTestColumn(metrics: ColumnMetric[], contentX: number): numbe
 
 type TableFilterValues = Record<string, string>;
 
-export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type DeleteRowsEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSortState, type InsertRowsEvent, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type GridCellPosition as TableCellPosition, type TableCellSpan, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type DeleteRowsEvent as TableDeleteRowsEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type InsertRowsEvent as TableInsertRowsEvent, type GridKey as TableKey, type TableLabels, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableResolvedCellSpan, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };
+export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type DeleteRowsEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSortState, type InsertRowsEvent, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type DeleteRowsEvent as TableDeleteRowsEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type InsertRowsEvent as TableInsertRowsEvent, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableResolvedCellSpan, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };

package/dist/index.js

@@ -784,8 +784,9 @@ function buildColumnMetrics(columns, columnDraggableOrOptions = false) {
   });
   const viewportWidth = options.viewportWidth ?? 0;
   if (viewportWidth <= left || columns.length === 0) return metrics;
-  const stretchable = columns.map((column, index) => ({ column, index })).filter(({ column }) => column.fixed !== "right" && !column.rowSelection && !column.rowDragHandle && !column.rowNumber);
-  const targets = stretchable.length > 0 ? stretchable : columns.map((column, index) => ({ column, index })).filter(({ column }) => column.fixed !== "right");
+  const unsetWidthStretchable = columns.map((column, index) => ({ column, index })).filter(({ column }) => column.width === void 0 && column.fixed === void 0 && !column.rowSelection && !column.rowDragHandle && !column.rowNumber);
+  const dataStretchable = columns.map((column, index) => ({ column, index })).filter(({ column }) => column.fixed === void 0 && !column.rowSelection && !column.rowDragHandle && !column.rowNumber);
+  const targets = unsetWidthStretchable.length > 0 ? unsetWidthStretchable : dataStretchable.length > 0 ? dataStretchable : [];
   if (targets.length === 0) return metrics;
   const extra = viewportWidth - left;
   const baseTotal = targets.reduce((sum, { index }) => sum + metrics[index].width, 0);
@@ -1039,7 +1040,7 @@ function paintGrid(options) {
       if (!verticalBorderless) ctx.fillRect(x + metric.width - 1, headerY, 1, headerHeight);
       ctx.fillRect(x, headerY + headerHeight - 1, metric.width, 1);
       const column = columns[columnIndex];
-      if (!column.rowSelection && !column.rowDragHandle && !column.rowNumber && column.title) {
+      if (!column.rowSelection && !column.rowDragHandle && !column.rowNumber && !column.renderHeader && column.title) {
         ctx.font = "600 13px Inter, ui-sans-serif, system-ui, sans-serif";
         const titleWidth = ctx.measureText(column.title).width;
         const visibleActions = getVisibleHeaderActions(column, metric.width, columnDraggable, titleWidth);
@@ -1298,12 +1299,14 @@ function Table({
   rowKey,
   width = "100%",
   height = "100%",
-  autoHeight = false,
-  rowHeight = 36,
-  headerHeight = 40,
+  autoHeight = true,
+  layout,
+  rowHeight: rowHeightProp,
+  headerHeight: headerHeightProp,
   fixedHeader = true,
   locale = "zh-CN",
-  verticalBorderless = false,
+  borderless,
+  verticalBorderless,
   striped = false,
   highlight,
   cellSpans = [],
@@ -1345,8 +1348,13 @@ function Table({
   style,
   ariaLabel = "Data grid"
 }) {
+  const rowHeight = layout?.rowHeight ?? rowHeightProp ?? 36;
+  const baseHeaderHeight = layout?.headerHeight ?? headerHeightProp ?? 40;
   const { language, labels } = useMemo(() => resolveGridLocale(locale), [locale]);
-  const hasVerticalBorders = !verticalBorderless;
+  const customHeaderContentRefs = useRef2(/* @__PURE__ */ new Map());
+  const [measuredHeaderHeight, setMeasuredHeaderHeight] = useState4(0);
+  const headerHeight = Math.max(baseHeaderHeight, measuredHeaderHeight);
+  const hasVerticalBorders = !(borderless ?? verticalBorderless ?? false);
   const hasStripedRows = Boolean(striped);
   const stripedColor = typeof striped === "string" ? striped : void 0;
   const editedCellsHighlight = highlight?.editedCells ?? false;
@@ -1410,7 +1418,7 @@ function Table({
   const hoveredRowIndexRef = useRef2(null);
   const [viewport, setViewport] = useState4({ width: 0, height: typeof height === "number" ? height : FALLBACK_HEIGHT });
   const [horizontalScrollbarHeight, setHorizontalScrollbarHeight] = useState4(0);
-  const resolvedHeight = viewport.height || FALLBACK_HEIGHT;
+  const resolvedHeight = typeof height === "number" ? height : viewport.height || FALLBACK_HEIGHT;
   const [scrollPosition, setScrollPosition] = useState4({ left: 0, top: 0 });
   const scrollRef = useRef2({ left: 0, top: 0 });
   const [selection, setSelection] = useControllableValue(selectedCell, defaultSelectedCell, onSelectedCellChange);
@@ -1452,6 +1460,28 @@ function Table({
     if (headerTooltipTimerRef.current !== null) clearTimeout(headerTooltipTimerRef.current);
     if (cellTooltipTimerRef.current !== null) clearTimeout(cellTooltipTimerRef.current);
   }, []);
+  const measureCustomHeaderHeight = useCallback2(() => {
+    let nextHeight = 0;
+    customHeaderContentRefs.current.forEach((node) => {
+      nextHeight = Math.max(nextHeight, Math.ceil(node.scrollHeight) + 16);
+    });
+    setMeasuredHeaderHeight((current) => current === nextHeight ? current : nextHeight);
+  }, []);
+  useLayoutEffect2(() => {
+    const activeCustomHeaderKeys = new Set(columns.filter((column) => column.renderHeader).map((column) => column.key));
+    customHeaderContentRefs.current.forEach((_, key) => {
+      if (!activeCustomHeaderKeys.has(key)) customHeaderContentRefs.current.delete(key);
+    });
+    if (customHeaderContentRefs.current.size === 0) {
+      setMeasuredHeaderHeight(0);
+      return;
+    }
+    measureCustomHeaderHeight();
+    if (typeof ResizeObserver === "undefined") return;
+    const observer = new ResizeObserver(measureCustomHeaderHeight);
+    customHeaderContentRefs.current.forEach((node) => observer.observe(node));
+    return () => observer.disconnect();
+  }, [columns, measureCustomHeaderHeight, viewport.width]);
   const [filterEditor, setFilterEditor] = useState4(null);
   const [contextMenu, setContextMenu] = useState4(null);
   const [insertCounts, setInsertCounts] = useState4({ before: 1, after: 1 });
@@ -1460,6 +1490,7 @@ function Table({
   const [insertBusy, setInsertBusy] = useState4(false);
   const [deleteBusy, setDeleteBusy] = useState4(false);
   const [toast, setToast] = useState4(null);
+  const [resizeGuideX, setResizeGuideX] = useState4(null);
   const [hoveredHeaderAction, setHoveredHeaderAction] = useState4(null);
   const [visibleHeaderTooltip, setVisibleHeaderTooltip] = useState4(null);
   const [hoveredCellTooltip, setHoveredCellTooltip] = useState4(null);
@@ -1558,14 +1589,15 @@ function Table({
   }, [columns, metrics]);
   const hasRowSelectionColumn = useMemo(() => columns.some((column) => column.rowSelection), [columns]);
   const rowSelectionMode = typeof rowSelection === "object" ? rowSelection.mode ?? "multiple" : "multiple";
-  const hasSummaryRow = useMemo(() => summaryEnabled && columns.some((column) => Boolean(column.summary)), [columns, summaryEnabled]);
+  const hasSummaryRow = useMemo(() => rows.length > 0 && summaryEnabled && columns.some((column) => Boolean(column.summary)), [columns, rows.length, summaryEnabled]);
   const topSummaryHeight = hasSummaryRow && summaryPosition === "top" ? rowHeight : 0;
   const bottomSummaryHeight = hasSummaryRow && summaryPosition === "bottom" ? rowHeight : 0;
   const bodyTop = headerHeight + topSummaryHeight;
   const bodyContentHeight = rows.length === 0 ? EMPTY_BODY_HEIGHT : contentHeight;
   const realContentHeight = bodyTop + bodyContentHeight + bottomSummaryHeight + (contentWidth > viewport.width ? horizontalScrollbarHeight : 0);
   const effectiveHeight = autoHeight ? Math.max(bodyTop + bottomSummaryHeight, Math.min(resolvedHeight, realContentHeight)) : resolvedHeight;
-  const bodyViewportHeight = Math.max(0, effectiveHeight - (fixedHeader ? headerHeight : 0) - topSummaryHeight);
+  const renderHeight = Math.max(0, effectiveHeight - bottomSummaryHeight);
+  const bodyViewportHeight = Math.max(0, renderHeight - (fixedHeader ? headerHeight : 0) - topSummaryHeight);
   const [summaryState, setSummaryState] = useState4(() => ({ columns: null, rows: null, values: /* @__PURE__ */ new Map(), pending: false }));
   const summaryPending = hasSummaryRow && (loading || summaryState.pending || summaryState.columns !== columns || summaryState.rows !== rows);
   const summaryValues = hasSummaryRow && summaryState.columns === columns && summaryState.rows === rows ? summaryState.values : /* @__PURE__ */ new Map();
@@ -1612,14 +1644,30 @@ function Table({
     rowIndexByKeyRef.current.set(key, index);
     return key;
   }, [getDataRowKey]);
+  const resolvedCellSpans = useMemo(() => {
+    if (Array.isArray(cellSpans)) return cellSpans;
+    const spans = [];
+    rows.forEach((row, rowIndex) => {
+      columns.forEach((column, columnIndex) => {
+        const span = cellSpans({ row, rowIndex, column, columnIndex, rows, columns });
+        if (!span) return;
+        spans.push({
+          rowIndex,
+          columnKey: column.key,
+          ...span
+        });
+      });
+    });
+    return spans;
+  }, [cellSpans, columns, rows]);
   const cellSpanLookup = useMemo(() => {
-    if (cellSpans.length === 0) return createEmptyCellSpanLookup();
+    if (resolvedCellSpans.length === 0) return createEmptyCellSpanLookup();
     const rowIndexByKey = /* @__PURE__ */ new Map();
     rows.forEach((row, index) => rowIndexByKey.set(getRowKey(row, index), index));
     const columnIndexByKey = new Map(columns.map((column, index) => [column.key, index]));
     const lookup = createEmptyCellSpanLookup();
     const occupied = /* @__PURE__ */ new Set();
-    for (const span of cellSpans) {
+    for (const span of resolvedCellSpans) {
       const rowIndex = span.rowKey !== void 0 ? rowIndexByKey.get(span.rowKey) : span.rowIndex;
       const columnIndex = columnIndexByKey.get(span.columnKey);
       if (rowIndex === void 0 || columnIndex === void 0) continue;
@@ -1655,7 +1703,7 @@ function Table({
       }
     }
     return lookup;
-  }, [cellSpans, columns, getRowKey, rows]);
+  }, [columns, getRowKey, resolvedCellSpans, rows]);
   const selectedRowKeySet = useMemo(() => new Set(rowKeys), [rowKeys]);
   const selectedColumnKeySet = useMemo(() => new Set(columnKeys), [columnKeys]);
   const insertedRowKeySet = useMemo(() => insertedRowKeys, [insertedRowKeys]);
@@ -1702,7 +1750,7 @@ function Table({
     if (!canvas || viewport.width <= 0) return;
     const ratio = Math.min(window.devicePixelRatio || 1, 2);
     const physicalWidth = Math.round(viewport.width * ratio);
-    const physicalHeight = Math.round(effectiveHeight * ratio);
+    const physicalHeight = Math.round(renderHeight * ratio);
     if (canvas.width !== physicalWidth) canvas.width = physicalWidth;
     if (canvas.height !== physicalHeight) canvas.height = physicalHeight;
     const context = canvas.getContext("2d");
@@ -1725,8 +1773,8 @@ function Table({
     const scroll = scrollRef.current;
     const rowScrollTop = fixedHeader ? scroll.top : Math.max(0, scroll.top - bodyTop);
     const range = isVirtualized ? getViewportRange(scroll.left, rowScrollTop, viewport.width, bodyViewportHeight, rows.length, rowHeight, metrics, virtualOverscan) : { rowStart: 0, rowEnd: rows.length, columnStart: 0, columnEnd: columns.length };
-    paintGrid({ context, width: viewport.width, height: effectiveHeight, pixelRatio: ratio, scrollLeft: scroll.left, scrollTop: scroll.top, rowHeight, headerHeight, bodyTop, suppressLastRowBottomBorder: bottomSummaryHeight > 0, suppressFrameBottomBorder: bottomSummaryHeight > 0, fixedHeader, verticalBorderless: !hasVerticalBorders, striped: hasStripedRows, columnDraggable, sortState, filterValues, hoveredHeaderAction: hoveredHeaderActionRef.current, rows, columns, metrics, range, selection, editing, hoveredRowIndex: hoveredRowIndexRef.current, selectionRange, selectedRowKeys: selectedRowKeySet, selectedColumnKeys: selectedColumnKeySet, cellSpans: cellSpanLookup.covered, maxRowSpan: cellSpanLookup.maxRowSpan, highlightEditedCells: highlightsEditedCells, highlightInsertedRows: highlightsInsertedRows, insertedRowKeys: insertedRowKeySet, editedCellKeys, cellAnnotations, getRowKey, rowDragPreview, colors: themeColors });
-  }, [bodyTop, bodyViewportHeight, bottomSummaryHeight, cellAnnotations, cellSpanLookup, columnDraggable, columns, editedCellHighlightColor, editedCellKeys, editing, effectiveHeight, filterValues, fixedHeader, getRowKey, hasStripedRows, hasVerticalBorders, headerHeight, highlightsEditedCells, highlightsInsertedRows, insertedRowHighlightColor, insertedRowKeySet, isVirtualized, metrics, rowDragPreview, rowHeight, rows, selectedColumnKeySet, selectedRowKeySet, selection, selectionRange, sortState, stripedColor, viewport.width, virtualOverscan]);
+    paintGrid({ context, width: viewport.width, height: renderHeight, pixelRatio: ratio, scrollLeft: scroll.left, scrollTop: scroll.top, rowHeight, headerHeight, bodyTop, suppressLastRowBottomBorder: bottomSummaryHeight > 0, suppressFrameBottomBorder: bottomSummaryHeight > 0, fixedHeader, verticalBorderless: !hasVerticalBorders, striped: hasStripedRows, columnDraggable, sortState, filterValues, hoveredHeaderAction: hoveredHeaderActionRef.current, rows, columns, metrics, range, selection, editing, hoveredRowIndex: hoveredRowIndexRef.current, selectionRange, selectedRowKeys: selectedRowKeySet, selectedColumnKeys: selectedColumnKeySet, cellSpans: cellSpanLookup.covered, maxRowSpan: cellSpanLookup.maxRowSpan, highlightEditedCells: highlightsEditedCells, highlightInsertedRows: highlightsInsertedRows, insertedRowKeys: insertedRowKeySet, editedCellKeys, cellAnnotations, getRowKey, rowDragPreview, colors: themeColors });
+  }, [bodyTop, bodyViewportHeight, bottomSummaryHeight, cellAnnotations, cellSpanLookup, columnDraggable, columns, editedCellHighlightColor, editedCellKeys, editing, renderHeight, filterValues, fixedHeader, getRowKey, hasStripedRows, hasVerticalBorders, headerHeight, highlightsEditedCells, highlightsInsertedRows, insertedRowHighlightColor, insertedRowKeySet, isVirtualized, metrics, rowDragPreview, rowHeight, rows, selectedColumnKeySet, selectedRowKeySet, selection, selectionRange, sortState, stripedColor, viewport.width, virtualOverscan]);
   const scheduleDraw = useCallback2(() => {
     if (frameRef.current === null) frameRef.current = requestAnimationFrame(draw);
   }, [draw]);
@@ -1835,14 +1883,14 @@ function Table({
         const horizontalStart = column.fixed === void 0 ? fixedWidth : 0;
         const horizontalEnd = column.fixed === void 0 ? viewport.width - rightFixedWidth : viewport.width;
         const verticalStart = fixedHeader ? bodyTop : 0;
-        if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= effectiveHeight) {
+        if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= renderHeight) {
           focus.style.display = "none";
         } else {
           const borderWidth = 2;
           const left = Math.round(Math.max(rawLeft - borderWidth, horizontalStart - 1));
           const right = Math.round(Math.min(rawRight + 1, horizontalEnd, viewport.width));
           const top = Math.round(Math.max(rawTop - borderWidth, verticalStart - 1));
-          const bottom = Math.round(Math.min(rawBottom + 1, effectiveHeight));
+          const bottom = Math.round(Math.min(rawBottom + 1, renderHeight));
           focus.style.display = "block";
           focus.style.left = `${left}px`;
           focus.style.top = `${top}px`;
@@ -1867,7 +1915,7 @@ function Table({
     setHoveredCellTooltip(null);
     scheduleDraw();
     setEditing(null);
-  }, [bodyTop, columns, effectiveHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedOffsets, rightFixedWidth, rowHeight, rows, scheduleDraw, selection, selectionRange, viewport.width]);
+  }, [bodyTop, columns, renderHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedOffsets, rightFixedWidth, rowHeight, rows, scheduleDraw, selection, selectionRange, viewport.width]);
   const locateColumn = useCallback2((clientX) => {
     const canvas = canvasRef.current;
     if (!canvas) return -1;
@@ -1908,6 +1956,16 @@ function Table({
     }
     return closest;
   }, [columnResizable, columns, getDisplayedColumnLeft, metrics]);
+  const findResizeNeighbor = useCallback2((columnIndex) => {
+    const resizedColumn = columns[columnIndex];
+    for (let index = columnIndex + 1; index < columns.length; index += 1) {
+      const column = columns[index];
+      if (column.rowSelection || column.rowDragHandle || column.rowNumber) continue;
+      if (resizedColumn?.fixed && column.fixed !== resizedColumn.fixed) return -1;
+      return index;
+    }
+    return -1;
+  }, [columns]);
   const locateHeaderAction = useCallback2((clientX, columnIndex) => {
     if (columnIndex < 0 || !canvasRef.current) return null;
     const column = columns[columnIndex];
@@ -2455,13 +2513,13 @@ function Table({
       const rowTop = (fixedHeader ? 0 : bodyTop) + rowIndex * rowHeight;
       const rowBottom = rowTop + rowHeight * (span?.rowSpan ?? 1);
       const cellWidth = getCellDisplayWidth(columnIndex, span?.colSpan ?? 1);
-      const visibleRowHeight = fixedHeader ? effectiveHeight - bodyTop : effectiveHeight;
+      const visibleRowHeight = fixedHeader ? renderHeight - bodyTop : renderHeight;
       if (rowTop < scroller.scrollTop) scroller.scrollTop = rowTop;
       if (rowBottom > scroller.scrollTop + visibleRowHeight) scroller.scrollTop = rowBottom - visibleRowHeight;
       if (columns[columnIndex].fixed === void 0 && metric.left < scroller.scrollLeft + fixedWidth) scroller.scrollLeft = Math.max(0, metric.left - fixedWidth);
       if (columns[columnIndex].fixed === void 0 && metric.left + cellWidth > scroller.scrollLeft + viewport.width - rightFixedWidth) scroller.scrollLeft = metric.left + cellWidth - viewport.width + rightFixedWidth;
     }
-  }, [beginEdit, bodyTop, columns, editing, effectiveHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedWidth, rowHeight, rows, selection, setSelection, viewport.width]);
+  }, [beginEdit, bodyTop, columns, editing, renderHeight, fixedHeader, fixedWidth, getCellDisplayWidth, getCellSpan, getRowKey, metrics, rightFixedWidth, rowHeight, rows, selection, setSelection, viewport.width]);
   const editorStyle = useMemo(() => {
     if (!editing) return void 0;
     const metric = metrics[editing.columnIndex];
@@ -2486,26 +2544,48 @@ function Table({
     if (resizeIndex >= 0) {
       event.preventDefault();
       event.currentTarget.setPointerCapture(event.pointerId);
-      columnDragRef.current = { type: "resize", columnIndex: resizeIndex, startX: event.clientX, startWidth: metrics[resizeIndex].width };
+      const neighborIndex = findResizeNeighbor(resizeIndex);
+      const startGuideX = getDisplayedColumnLeft(resizeIndex) + metrics[resizeIndex].width;
+      columnDragRef.current = {
+        type: "resize",
+        columnIndex: resizeIndex,
+        startX: event.clientX,
+        startWidth: metrics[resizeIndex].width,
+        startGuideX,
+        neighborIndex,
+        startNeighborWidth: neighborIndex >= 0 ? metrics[neighborIndex].width : 0
+      };
       suppressClickRef.current = true;
-      setDragGuide(getDisplayedColumnLeft(resizeIndex) + metrics[resizeIndex].width);
+      setResizeGuideX(startGuideX);
       return;
     }
-  }, [fixedHeader, getDisplayedColumnLeft, headerHeight, locateResizeHandle, metrics, setDragGuide]);
+  }, [findResizeNeighbor, fixedHeader, getDisplayedColumnLeft, headerHeight, locateResizeHandle, metrics]);
   const handleColumnPointerMove = useCallback2((event) => {
     const drag = columnDragRef.current;
     if (!drag) return;
-    const width2 = Math.max(getMinimumColumnWidth(columns[drag.columnIndex], columnDraggable), Math.round(drag.startWidth + event.clientX - drag.startX));
-    onColumnResize?.(columns[drag.columnIndex].key, width2);
-    setDragGuide(getDisplayedColumnLeft(drag.columnIndex) + width2);
-  }, [columnDraggable, columns, getDisplayedColumnLeft, onColumnResize, setDragGuide]);
+    const column = columns[drag.columnIndex];
+    const minWidth = getMinimumColumnWidth(column, columnDraggable);
+    let delta = Math.round(event.clientX - drag.startX);
+    if (drag.neighborIndex >= 0) {
+      const neighbor = columns[drag.neighborIndex];
+      const minNeighborWidth = getMinimumColumnWidth(neighbor, columnDraggable);
+      delta = Math.max(minWidth - drag.startWidth, Math.min(drag.startNeighborWidth - minNeighborWidth, delta));
+      onColumnResize?.(column.key, drag.startWidth + delta);
+      onColumnResize?.(neighbor.key, drag.startNeighborWidth - delta);
+      setResizeGuideX(drag.startGuideX + delta);
+      return;
+    }
+    const width2 = Math.max(minWidth, Math.round(drag.startWidth + delta));
+    onColumnResize?.(column.key, width2);
+    setResizeGuideX(drag.startGuideX + width2 - drag.startWidth);
+  }, [columnDraggable, columns, onColumnResize]);
   const handleColumnPointerUp = useCallback2((event) => {
     const drag = columnDragRef.current;
     if (!drag) return;
     if (event.currentTarget.hasPointerCapture(event.pointerId)) event.currentTarget.releasePointerCapture(event.pointerId);
     columnDragRef.current = null;
-    setDragGuide(null);
-  }, [setDragGuide]);
+    setResizeGuideX(null);
+  }, []);
   const queueSortStateChange = useCallback2((next) => {
     setDisplaySortState(next);
     if (sortDebounceRef.current !== null) clearTimeout(sortDebounceRef.current);
@@ -2685,7 +2765,7 @@ function Table({
       type: "cell",
       ...cell,
       left: Math.min(Math.max(0, clientX - root.left), Math.max(0, viewport.width - 190)),
-      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, effectiveHeight - 350))
+      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, renderHeight - 350))
     });
     onCellContextMenu?.({ ...cell, row: rows[cell.rowIndex], clientX, clientY });
   };
@@ -2696,7 +2776,7 @@ function Table({
       type: "header",
       columnIndex,
       left: Math.min(Math.max(0, clientX - root.left), Math.max(0, viewport.width - 180)),
-      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, effectiveHeight - 68))
+      top: Math.min(Math.max(0, clientY - root.top), Math.max(0, renderHeight - 68))
     });
   };
   const getRowDragOffset = (rowIndex) => {
@@ -2912,6 +2992,35 @@ function Table({
         column.key
       );
     }
+    if (column.renderHeader) {
+      const visibleActions = getVisibleHeaderActions(column, metrics[columnIndex].width, columnDraggable, measureHeaderTitleWidth(columnIndex));
+      const actionWidth = (Number(visibleActions.drag) + Number(visibleActions.filter) + Number(visibleActions.sort)) * 18;
+      return /* @__PURE__ */ jsx7(
+        "div",
+        {
+          className: "rvg-header-title is-custom",
+          style: {
+            left,
+            top: fixedHeader ? 0 : -currentScrollTop,
+            width: Math.max(0, metrics[columnIndex].width - actionWidth),
+            height: headerHeight,
+            justifyContent: column.align === "right" ? "flex-end" : column.align === "center" ? "center" : "flex-start",
+            textAlign: column.align === "right" ? "right" : column.align === "center" ? "center" : "left"
+          },
+          children: /* @__PURE__ */ jsx7(
+            "span",
+            {
+              ref: (node) => {
+                if (node) customHeaderContentRefs.current.set(column.key, node);
+                else customHeaderContentRefs.current.delete(column.key);
+              },
+              children: column.renderHeader(column)
+            }
+          )
+        },
+        column.key
+      );
+    }
     return null;
   };
   const rangeHandlePosition = (() => {
@@ -2926,7 +3035,7 @@ function Table({
     const horizontalStart = column.fixed === void 0 ? fixedWidth : 0;
     const horizontalEnd = column.fixed === void 0 ? viewport.width - rightFixedWidth : viewport.width;
     const verticalStart = fixedHeader ? bodyTop : 0;
-    if (rawLeft <= horizontalStart || rawLeft > horizontalEnd || rawTop <= verticalStart || rawTop > effectiveHeight) return null;
+    if (rawLeft <= horizontalStart || rawLeft > horizontalEnd || rawTop <= verticalStart || rawTop > renderHeight) return null;
     return { left: rawLeft, top: rawTop, bounds };
   })();
   const selectionOutlineStyle = (() => {
@@ -2943,12 +3052,12 @@ function Table({
     const horizontalStart = column.fixed === void 0 ? fixedWidth : 0;
     const horizontalEnd = column.fixed === void 0 ? viewport.width - rightFixedWidth : viewport.width;
     const verticalStart = fixedHeader ? bodyTop : 0;
-    if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= effectiveHeight) return null;
+    if (rawRight <= horizontalStart || rawLeft >= horizontalEnd || rawBottom <= verticalStart || rawTop >= renderHeight) return null;
     const borderWidth = 2;
     const left = Math.round(Math.max(rawLeft - borderWidth, horizontalStart - 1));
     const right = Math.round(Math.min(rawRight + 1, horizontalEnd, viewport.width));
     const top = Math.round(Math.max(rawTop - borderWidth, verticalStart - 1));
-    const bottom = Math.round(Math.min(rawBottom + 1, effectiveHeight));
+    const bottom = Math.round(Math.min(rawBottom + 1, renderHeight));
     return {
       left,
       top,
@@ -3063,8 +3172,10 @@ function Table({
   const renderSummaryCell = (columnIndex, left) => {
     const column = columns[columnIndex];
     const isUtility = column.rowSelection || column.rowDragHandle || column.rowNumber;
-    const summaryContent = summaryValues.has(column.key) ? summaryValues.get(column.key) : summaryEmptyValue;
-    const content = column.rowNumber ? language === "zh-CN" ? "\u5408\u8BA1" : "Total" : summaryPending ? /* @__PURE__ */ jsx7("span", { className: "rvg-summary-skeleton" }) : summaryContent;
+    const hasSummaryValue = summaryValues.has(column.key);
+    const summaryContent = hasSummaryValue ? summaryValues.get(column.key) : summaryEmptyValue;
+    const showSummarySkeleton = Boolean(column.summary) && summaryPending;
+    const content = columnIndex === 0 ? language === "zh-CN" ? "\u5408\u8BA1" : "Total" : showSummarySkeleton ? /* @__PURE__ */ jsx7("span", { className: "rvg-summary-skeleton" }) : summaryContent;
     return /* @__PURE__ */ jsx7(
       "div",
       {
@@ -3095,7 +3206,7 @@ function Table({
         {
           ref: canvasRef,
           className: "rvg-canvas",
-          style: { width: viewport.width, height: effectiveHeight },
+          style: { width: viewport.width, height: renderHeight },
           onMouseMove: (event) => {
             if (columnDragRef.current) return;
             const rect = event.currentTarget.getBoundingClientRect();
@@ -3273,7 +3384,7 @@ function Table({
           onContextMenu: handleContextMenu
         }
       ),
-      /* @__PURE__ */ jsxs7("div", { className: "rvg-text-layer", style: { width: viewport.width, height: effectiveHeight, marginTop: -effectiveHeight }, onContextMenu: handleContextMenu, children: [
+      /* @__PURE__ */ jsxs7("div", { className: "rvg-text-layer", style: { width: viewport.width, height: renderHeight, marginTop: -renderHeight }, onContextMenu: handleContextMenu, children: [
         /* @__PURE__ */ jsx7("div", { className: "rvg-text-scroll-clip", style: { left: fixedWidth, right: rightFixedWidth }, children: /* @__PURE__ */ jsxs7(
           "div",
           {
@@ -3297,7 +3408,7 @@ function Table({
         columns.map((column, columnIndex) => column.fixed === "left" ? renderHeaderTitle(columnIndex, metrics[columnIndex].left) : null),
         columns.map((column, columnIndex) => column.fixed === "right" ? renderHeaderTitle(columnIndex, viewport.width - (rightFixedOffsets.get(columnIndex) ?? 0) - metrics[columnIndex].width) : null)
       ] }),
-      /* @__PURE__ */ jsx7("div", { className: "rvg-spacer", style: { width: contentWidth, height: contentHeight + bodyTop, marginTop: -effectiveHeight } })
+      /* @__PURE__ */ jsx7("div", { className: "rvg-spacer", style: { width: contentWidth, height: contentHeight + bodyTop, marginTop: -renderHeight } })
     ] }),
     hasSummaryRow && /* @__PURE__ */ jsxs7(
       "div",
@@ -3613,6 +3724,13 @@ function Table({
     ] }) }),
     toast && /* @__PURE__ */ jsx7("div", { className: `rvg-toast is-${toast.type}`, role: "status", children: toast.message }),
     /* @__PURE__ */ jsx7("div", { ref: dragGuideRef, className: "rvg-column-guide" }),
+    resizeGuideX !== null && /* @__PURE__ */ jsx7(
+      "div",
+      {
+        className: "rvg-column-guide is-resizing",
+        style: { display: "block", transform: `translateX(${Math.round(resizeGuideX)}px)` }
+      }
+    ),
     /* @__PURE__ */ jsx7("div", { ref: rowDragGuideRef, className: "rvg-row-guide" }),
     filterEditor && /* @__PURE__ */ jsxs7("div", { ref: filterRef, className: "rvg-filter", style: { left: filterEditor.left, top: filterEditor.top }, children: [
       /* @__PURE__ */ jsx7(
@@ -3661,7 +3779,7 @@ function Table({
     rows.length === 0 && !loading && /* @__PURE__ */ jsx7("div", { className: "rvg-empty", style: { top: bodyTop }, children: emptyContent ?? /* @__PURE__ */ jsx7(DefaultEmptyState, { label: labels.empty }) }),
     loading && hasCustomLoading && /* @__PURE__ */ jsx7("div", { className: "rvg-custom-loading", "aria-label": labels.refreshing, children: loadingContent }),
     loading && !hasCustomLoading && !hasCompletedLoadRef.current && /* @__PURE__ */ jsxs7("div", { className: "rvg-initial-loading", style: { top: headerHeight }, "aria-label": labels.initialLoading, children: [
-      Array.from({ length: Math.ceil((effectiveHeight - headerHeight) / rowHeight) }, (_, rowIndex) => /* @__PURE__ */ jsx7("div", { className: "rvg-loading-row", style: { height: rowHeight }, children: columns.map((column, columnIndex) => {
+      Array.from({ length: Math.ceil((renderHeight - headerHeight) / rowHeight) }, (_, rowIndex) => /* @__PURE__ */ jsx7("div", { className: "rvg-loading-row", style: { height: rowHeight }, children: columns.map((column, columnIndex) => {
         const left = getDisplayedColumnLeft(columnIndex);
         const columnWidth = metrics[columnIndex].width;
         if (left + columnWidth <= 0 || left >= viewport.width) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensui/lens-table",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "A lightweight, canvas-rendered React table component for LensUI.",
   "type": "module",
   "main": "./dist/index.cjs",