@canvas-components/list-table 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
+var utils = require('@canvas-components/utils');
 var barcode = require('@canvas-components/barcode');
 var chart = require('@canvas-components/chart');
 var qrcode = require('@canvas-components/qrcode');
-var utils = require('@canvas-components/utils');
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -70,13 +70,8 @@ var DebugManager = class {
     console.info(`[ListTable Debug] ${label}`, payload);
   }
 };
-
-// src/domain/columns/column-key.ts
-function stringifyColumnDataIndex(dataIndex) {
-  return Array.isArray(dataIndex) ? dataIndex.map((item) => String(item)).join(".") : String(dataIndex);
-}
 function resolveColumnKey(column) {
-  return column.key?.trim() || stringifyColumnDataIndex(column.dataIndex);
+  return column.key?.trim() || utils.stringifyDataIndex(column.dataIndex);
 }
 function ensureColumnKeysInPlace(columns) {
   columns.forEach((column) => {
@@ -329,6 +324,7 @@ function normalizeColumn(column, depth, parentKey) {
     minWidth: Number(column.minWidth) || DEFAULT_MIN_WIDTH,
     maxWidth: Number(column.maxWidth) || DEFAULT_MAX_WIDTH,
     align: column.align ?? "left",
+    headerAlign: column.headerAlign,
     fixed: column.fixed,
     hidden: column.hidden,
     ellipsis: column.ellipsis,
@@ -348,6 +344,7 @@ function normalizeColumn(column, depth, parentKey) {
     cellType: column.cellType,
     cellStyle: column.cellStyle,
     moneyFormat: column.moneyFormat,
+    dataFormat: column.dataFormat,
     headerStyle: column.headerStyle,
     summary: column.summary,
     summaryTitle: column.summaryTitle,
@@ -583,15 +580,28 @@ function cloneColumns(columns) {
     children: column.children ? cloneColumns(column.children) : void 0
   }));
 }
+function applyInitialColumnVisibility(columns) {
+  columns.forEach((column) => {
+    if (column.hidden === void 0 && column.initialHide) {
+      column.hidden = true;
+    }
+    if (column.children?.length) {
+      applyInitialColumnVisibility(column.children);
+    }
+  });
+}
 function replaceColumns(target, source) {
   target.splice(0, target.length, ...cloneColumns(source));
 }
 function buildHeaderSettingsItems(columns) {
   ensureColumnKeysInPlace(columns);
   const totalVisibleLeafCount = countVisibleLeafColumns(columns);
-  return columns.map(
-    (column) => buildHeaderSettingsItem(column, totalVisibleLeafCount, false)
-  );
+  return columns.flatMap((column) => {
+    if (column.hideInSetting) {
+      return [];
+    }
+    return [buildHeaderSettingsItem(column, totalVisibleLeafCount, false)];
+  });
 }
 function setHeaderColumnVisible(columns, columnKey, visible) {
   if (!visible) {
@@ -651,9 +661,7 @@ function resolveCollapsedHeaderColumnMarkers(params) {
   if (visibleLeafKeys.length === 0) {
     return [];
   }
-  const leafIndexMap = new Map(
-    allLeafKeys.map((key, index) => [key, index])
-  );
+  const leafIndexMap = new Map(allLeafKeys.map((key, index) => [key, index]));
   const markers = [];
   let previousVisibleIndex = -1;
   visibleLeafKeys.forEach((columnKey) => {
@@ -719,19 +727,87 @@ function restoreAllHiddenHeaderColumns(columns) {
   });
   return updated;
 }
+function getColumnPresentationConfig(columns, columnKey) {
+  const column = findColumnNode(columns, columnKey);
+  if (!column) {
+    return null;
+  }
+  const bodyColumn = column.children?.length ? collectLeafColumns([column])[0] : column;
+  return {
+    headerHorizontal: column.headerAlign ?? column.align ?? "left",
+    headerVertical: column.headerStyle?.verticalAlign ?? "middle",
+    bodyHorizontal: bodyColumn?.align ?? "left",
+    bodyVertical: bodyColumn?.cellStyle?.verticalAlign ?? "middle",
+    dataFormat: column.dataFormat ?? "default",
+    dataFormatAvailable: !column.children?.length && !column.render && (column.cellType == null || column.cellType === "text" || column.cellType === "money")
+  };
+}
+function setColumnAlignment(params) {
+  const column = findColumnNode(params.columns, params.columnKey);
+  if (!column) {
+    return false;
+  }
+  const targets = params.area === "body" && column.children?.length ? collectLeafColumns([column]) : [column];
+  targets.forEach((target) => {
+    if (params.area === "header") {
+      if (params.axis === "horizontal") {
+        target.headerAlign = params.value;
+      } else {
+        target.headerStyle = {
+          ...target.headerStyle,
+          verticalAlign: params.value
+        };
+      }
+      return;
+    }
+    if (params.axis === "horizontal") {
+      target.align = params.value;
+    } else {
+      target.cellStyle = {
+        ...target.cellStyle,
+        verticalAlign: params.value
+      };
+    }
+  });
+  return true;
+}
+function setColumnDataFormat(columns, columnKey, dataFormat) {
+  const column = findColumnNode(columns, columnKey);
+  if (!column || column.children?.length || column.render) {
+    return false;
+  }
+  column.dataFormat = dataFormat === "default" ? void 0 : dataFormat;
+  return true;
+}
+function findColumnNode(columns, columnKey) {
+  for (const column of columns) {
+    if (resolveColumnKey(column) === columnKey) {
+      return column;
+    }
+    if (column.children?.length) {
+      const child = findColumnNode(column.children, columnKey);
+      if (child) {
+        return child;
+      }
+    }
+  }
+  return null;
+}
 function buildHeaderSettingsItem(column, totalVisibleLeafCount, parentHidden) {
   const hidden = parentHidden || !!column.hidden;
-  const children = column.children?.map(
+  const children = column.children?.filter((child) => !child.hideInSetting).map(
     (child) => buildHeaderSettingsItem(child, totalVisibleLeafCount, hidden)
   );
   const leafCount = countLeafColumns([column]);
   const visibleLeafCount = hidden ? 0 : countVisibleLeafColumns([column]);
   const checked = leafCount > 0 && visibleLeafCount === leafCount;
   const indeterminate = visibleLeafCount > 0 && visibleLeafCount < leafCount;
-  const disabled = visibleLeafCount > 0 && visibleLeafCount >= totalVisibleLeafCount;
+  const disabled = column.disableHide && checked || visibleLeafCount > 0 && visibleLeafCount >= totalVisibleLeafCount;
   return {
     key: resolveColumnKey(column),
-    title: String(column.title ?? resolveColumnKey(column)),
+    title: String(
+      column.settingTitle ?? column.title ?? resolveColumnKey(column)
+    ),
     checked,
     indeterminate,
     disabled,
@@ -741,6 +817,9 @@ function buildHeaderSettingsItem(column, totalVisibleLeafCount, parentHidden) {
 function setColumnVisible(columns, columnKey, visible, ancestors = []) {
   for (const column of columns) {
     if (column.key === columnKey) {
+      if (!visible && column.disableHide) {
+        return false;
+      }
       ancestors.forEach((item) => {
         item.hidden = false;
       });
@@ -748,12 +827,10 @@ function setColumnVisible(columns, columnKey, visible, ancestors = []) {
       return true;
     }
     if (column.children?.length) {
-      const updated = setColumnVisible(
-        column.children,
-        columnKey,
-        visible,
-        [...ancestors, column]
-      );
+      const updated = setColumnVisible(column.children, columnKey, visible, [
+        ...ancestors,
+        column
+      ]);
       if (updated) {
         return true;
       }
@@ -762,6 +839,9 @@ function setColumnVisible(columns, columnKey, visible, ancestors = []) {
   return false;
 }
 function setSubtreeVisible(column, visible) {
+  if (!visible && column.disableHide) {
+    return;
+  }
   column.hidden = !visible;
   column.children?.forEach((child) => {
     setSubtreeVisible(child, visible);
@@ -1603,27 +1683,6 @@ function clampPageNumber(page, totalPages) {
   }
   return Math.min(Math.max(1, Math.floor(page)), totalPages);
 }
-
-// src/domain/data/get-value-by-data-index.ts
-function getValueByDataIndex(record, dataIndex) {
-  if (dataIndex == null) {
-    return void 0;
-  }
-  const path = Array.isArray(dataIndex) ? dataIndex : [dataIndex];
-  let current = record;
-  for (const key of path) {
-    if (current == null) {
-      return void 0;
-    }
-    if (typeof current !== "object" && !Array.isArray(current)) {
-      return void 0;
-    }
-    current = current[key];
-  }
-  return current;
-}
-
-// src/domain/rows/row-selection.ts
 var maximumTreeDepthCache = /* @__PURE__ */ new WeakMap();
 var ROW_SELECTION_COLUMN_KEY = "__row_selection__";
 var EXPAND_COLUMN_KEY = "__row_expand__";
@@ -1655,7 +1714,7 @@ function getRowKey(options, record, index) {
     return rowKey(record, index);
   }
   if (rowKey != null) {
-    const resolved = getValueByDataIndex(record, rowKey);
+    const resolved = utils.getValueByDataIndex(record, rowKey);
     if (typeof resolved === "string" || typeof resolved === "number") {
       return resolved;
     }
@@ -3711,8 +3770,6 @@ function resolveLinkTextDecoration(content, hovered = false) {
   }
   return shouldDrawUnderline(content.underline, hovered) ? "underline" : "none";
 }
-
-// src/rendering/cell-content/draw-nested-table-content.ts
 var DEFAULT_COLUMN_WIDTH2 = 140;
 var TABLE_PADDING_X = 12;
 function drawBodyNestedTableContent(params) {
@@ -3826,7 +3883,7 @@ function drawBodyNestedTableContent(params) {
       }
       drawNestedTableText({
         ctx,
-        text: String(getValueByDataIndex(record, column.dataIndex) ?? ""),
+        text: String(utils.getValueByDataIndex(record, column.dataIndex) ?? ""),
         x: cellX,
         y: rowY,
         width: columnWidth,
@@ -3932,25 +3989,20 @@ function isNestedTableColumnHighlighted(content, column, columnIndex, highlight)
     return true;
   }
   return content.highlightColumnDataIndexes?.some(
-    (dataIndex) => isSameDataIndex(dataIndex, column.dataIndex)
-  ) === true || highlight?.columnDataIndex === serializeDataIndex(column.dataIndex) || highlight?.columnIndex === columnIndex;
+    (dataIndex) => utils.isSameDataIndex(dataIndex, column.dataIndex)
+  ) === true || highlight?.columnDataIndex === utils.stringifyDataIndex(column.dataIndex) || highlight?.columnIndex === columnIndex;
 }
 function resolveNestedTableRowKey(content, record, rowIndex) {
   if (typeof content.rowKey === "function") {
     return content.rowKey(record, rowIndex);
   }
   if (content.rowKey != null) {
-    const value = getValueByDataIndex(record, content.rowKey);
+    const value = utils.getValueByDataIndex(record, content.rowKey);
     return typeof value === "string" || typeof value === "number" ? value : void 0;
   }
   const fallbackKey = record.key;
   return typeof fallbackKey === "string" || typeof fallbackKey === "number" ? fallbackKey : rowIndex;
 }
-function isSameDataIndex(left, right) {
-  const leftPath = Array.isArray(left) ? left : [left];
-  const rightPath = Array.isArray(right) ? right : [right];
-  return leftPath.length === rightPath.length && leftPath.every((key, index) => key === rightPath[index]);
-}
 function pushNestedTableDescriptor(params) {
   const { column, columnIndex, content, drawParams, record, rect, rowIndex } = params;
   const rowKey = record != null && typeof rowIndex === "number" ? resolveNestedTableRowKey(content, record, rowIndex) : void 0;
@@ -3963,14 +4015,11 @@ function pushNestedTableDescriptor(params) {
     contentKey: "nested-table",
     nestedRowKey: rowKey,
     nestedRowIndex: rowIndex,
-    nestedColumnDataIndex: serializeDataIndex(column.dataIndex),
+    nestedColumnDataIndex: utils.stringifyDataIndex(column.dataIndex),
     nestedColumnIndex: columnIndex,
     cursor: "pointer"
   });
 }
-function serializeDataIndex(dataIndex) {
-  return (Array.isArray(dataIndex) ? dataIndex : [dataIndex]).map((item) => String(item)).join(".");
-}
 function drawNestedTableText(params) {
   const {
     align = "left",
@@ -5185,8 +5234,6 @@ function applyTextContentStyle(ctx, content, fallbackColor, theme) {
   ctx.textBaseline = "alphabetic";
   ctx.textAlign = "left";
 }
-
-// src/features/editing/editing-utils.ts
 function canEditCell(column, context) {
   if (!column || column.key === ROW_SELECTION_COLUMN_KEY || column.key === EXPAND_COLUMN_KEY) {
     return false;
@@ -5271,7 +5318,7 @@ function resolveNextEditableCell(params) {
   }
   const editableColumns = leafColumns.filter(
     (column) => canEditCell(column, {
-      value: column.dataIndex == null ? void 0 : getValueByDataIndex(currentRecord, column.dataIndex),
+      value: column.dataIndex == null ? void 0 : utils.getValueByDataIndex(currentRecord, column.dataIndex),
       record: currentRecord,
       rowIndex
     })
@@ -5348,9 +5395,13 @@ function resolveColumnFormItemProps(column, context) {
 var CONTENT_HORIZONTAL_PADDING = 12;
 var CONTENT_GAP = 8;
 var CONTENT_VERTICAL_PADDING = 6;
+var THOUSANDS_NUMBER_FORMAT = new Intl.NumberFormat("zh-CN", {
+  useGrouping: true,
+  maximumFractionDigits: 20
+});
 function resolveBodyCellContents(params) {
   const { record, rowIndex, column } = params;
-  const value = getValueByDataIndex(record, column.dataIndex);
+  const value = utils.getValueByDataIndex(record, column.dataIndex);
   const rendered = column.render?.(value, record, rowIndex, column);
   if (rendered != null) {
     return normalizeCellContents(rendered);
@@ -5361,6 +5412,14 @@ function resolveBodyCellContents(params) {
     record,
     rowIndex
   });
+  if (column.dataFormat && column.dataFormat !== "default") {
+    return [
+      {
+        type: "text",
+        text: formattedText ?? formatListTableDataValue(value, column.dataFormat)
+      }
+    ];
+  }
   if (column.cellType === "checkbox" || column.cellType === "radio" || column.cellType === "switch") {
     return [
       {
@@ -5521,6 +5580,26 @@ function formatMoneyValue(value, options) {
   const formattedDecimal = decimalText != null && decimalText.length > 0 ? `.${decimalText}` : "";
   return `${sign}${symbol}${formattedInteger}${formattedDecimal}`;
 }
+function formatListTableDataValue(value, dataFormat) {
+  if (dataFormat === "number") {
+    const numericValue = parseMoneyNumber(value);
+    return numericValue == null ? String(value ?? "") : String(numericValue);
+  }
+  if (dataFormat === "thousands") {
+    const numericValue = parseMoneyNumber(value);
+    if (numericValue == null) {
+      return String(value ?? "");
+    }
+    return THOUSANDS_NUMBER_FORMAT.format(numericValue);
+  }
+  if (dataFormat === "money") {
+    return formatMoneyValue(value, {
+      thousandsSeparator: true,
+      decimalPlaces: 2
+    });
+  }
+  return String(value ?? "");
+}
 function parseMoneyNumber(value) {
   if (typeof value === "number") {
     return Number.isFinite(value) ? value : null;
@@ -6658,7 +6737,7 @@ function buildBodyContentsPlainText(contents) {
     if (content.type === "table") {
       return content.dataSource.map(
         (record) => content.columns.map(
-          (column) => String(getValueByDataIndex(record, column.dataIndex) ?? "")
+          (column) => String(utils.getValueByDataIndex(record, column.dataIndex) ?? "")
         ).join(" ")
       ).join(" ");
     }
@@ -6745,7 +6824,7 @@ function resolveStickyLineStartX(params) {
   const preferredX = resolveLineStartX(rect, lineWidth, align);
   const minX = visibleRect.x;
   const maxX = visibleRect.x + Math.max(visibleRect.width - lineWidth, 0);
-  return clamp(preferredX, minX, maxX);
+  return utils.clamp(preferredX, minX, maxX);
 }
 function intersectRects(left, right) {
   const x = Math.max(left.x, right.x);
@@ -6762,9 +6841,6 @@ function intersectRects(left, right) {
     height: maxY - y
   };
 }
-function clamp(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
 
 // src/services/cell-content-action-service.ts
 function emitBodyCellContentClick(params) {
@@ -6794,7 +6870,7 @@ function emitBodyCellContentClick(params) {
     record,
     rowIndex: result.rowIndex,
     column,
-    value: getValueByDataIndex(record, column.dataIndex),
+    value: utils.getValueByDataIndex(record, column.dataIndex),
     contentIndex,
     nativeEvent: event
   };
@@ -6980,30 +7056,20 @@ function resolveBodyContentIndex(result, contents) {
   }
   return void 0;
 }
-
-// src/domain/layout/geometry.ts
-function clamp2(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
-function isPointInRect2(x, y, rect) {
-  return x >= rect.x && x <= rect.x + rect.width && y >= rect.y && y <= rect.y + rect.height;
-}
-
-// src/domain/layout/scrollbar.ts
 function isPointInScrollbar(x, y, scrollbar) {
-  return isPointInRect2(x, y, scrollbar.decreaseButton) || isPointInRect2(x, y, scrollbar.increaseButton) || isPointInRect2(x, y, scrollbar.track) || isPointInRect2(x, y, scrollbar.thumb);
+  return utils.isPointInRect(x, y, scrollbar.decreaseButton) || utils.isPointInRect(x, y, scrollbar.increaseButton) || utils.isPointInRect(x, y, scrollbar.track) || utils.isPointInRect(x, y, scrollbar.thumb);
 }
 function resolveScrollbarRole(x, y, scrollbar) {
-  if (isPointInRect2(x, y, scrollbar.thumb)) {
+  if (utils.isPointInRect(x, y, scrollbar.thumb)) {
     return "thumb";
   }
-  if (isPointInRect2(x, y, scrollbar.decreaseButton)) {
+  if (utils.isPointInRect(x, y, scrollbar.decreaseButton)) {
     return "decrease-button";
   }
-  if (isPointInRect2(x, y, scrollbar.increaseButton)) {
+  if (utils.isPointInRect(x, y, scrollbar.increaseButton)) {
     return "increase-button";
   }
-  if (isPointInRect2(x, y, scrollbar.track)) {
+  if (utils.isPointInRect(x, y, scrollbar.track)) {
     return "track";
   }
   return void 0;
@@ -7102,8 +7168,6 @@ function scaleRectByZoom(rect, zoom) {
     height: rect.height * safeZoom
   };
 }
-
-// src/domain/columns/header-reorder.ts
 function resolveHeaderReorderTarget(pointerX, siblings, getBounds) {
   if (siblings.length === 0) {
     return null;
@@ -7130,7 +7194,7 @@ function resolveHeaderReorderTarget(pointerX, siblings, getBounds) {
       }
     }
   }
-  targetSiblingIndex = clamp2(targetSiblingIndex, 0, siblings.length);
+  targetSiblingIndex = utils.clamp(targetSiblingIndex, 0, siblings.length);
   const targetIndicatorX = resolveTargetIndicatorX(
     siblings,
     targetSiblingIndex,
@@ -7721,8 +7785,6 @@ function createListTableAnimationRuntime() {
     carouselScrollAnimation: null
   };
 }
-
-// src/features/scroll/scroll-feature.ts
 var WHEEL_DELTA_MODE_PIXEL = 0;
 var WHEEL_DELTA_MODE_LINE = 1;
 var WHEEL_DELTA_MODE_PAGE = 2;
@@ -7817,7 +7879,7 @@ function stepScrollbarScroll(params) {
   if (area === "horizontal-scrollbar") {
     return {
       ...current,
-      left: clamp2(
+      left: utils.clamp(
         current.left + direction * horizontalStep,
         0,
         viewport.maxScrollLeft
@@ -7826,7 +7888,7 @@ function stepScrollbarScroll(params) {
   }
   return {
     ...current,
-    top: clamp2(
+    top: utils.clamp(
       current.top + direction * rowHeight,
       0,
       viewport.maxScrollTop
@@ -7836,7 +7898,7 @@ function stepScrollbarScroll(params) {
 function jumpScrollbarScroll(params) {
   const { current, axis, pointerValue, track, thumb, viewport } = params;
   if (axis === "horizontal") {
-    const nextThumbX = clamp2(
+    const nextThumbX = utils.clamp(
       pointerValue - thumb.width / 2,
       track.x,
       track.x + track.width - thumb.width
@@ -7847,7 +7909,7 @@ function jumpScrollbarScroll(params) {
       left: ratio2 * viewport.maxScrollLeft
     };
   }
-  const nextThumbY = clamp2(
+  const nextThumbY = utils.clamp(
     pointerValue - thumb.height / 2,
     track.y,
     track.y + track.height - thumb.height
@@ -7860,7 +7922,7 @@ function jumpScrollbarScroll(params) {
 }
 function dragScrollbarScroll(params) {
   const { current, dragging, pointerValue } = params;
-  const nextThumbValue = clamp2(
+  const nextThumbValue = utils.clamp(
     pointerValue - dragging.pointerOffset,
     dragging.trackStart,
     dragging.trackStart + dragging.trackLength - dragging.thumbLength
@@ -7924,7 +7986,7 @@ function resolveVerticalCarouselScroll(params) {
   return {
     nextScroll: {
       ...current,
-      top: clamp2(current.top + Math.max(rowHeight, 1), 0, maxScrollTop)
+      top: utils.clamp(current.top + Math.max(rowHeight, 1), 0, maxScrollTop)
     },
     animate: true,
     shouldStop: false
@@ -7951,7 +8013,7 @@ function resolveHorizontalCarouselScroll(params) {
   return {
     nextScroll: {
       ...current,
-      left: clamp2(nextLeft, 0, maxScrollLeft)
+      left: utils.clamp(nextLeft, 0, maxScrollLeft)
     },
     animate: true,
     shouldStop: false
@@ -7962,7 +8024,7 @@ function resolveColumnBoundaries(columns, maxScrollLeft) {
   let offset = 0;
   columns.forEach((column) => {
     offset += Math.max(column.width, 0);
-    boundaries.push(clamp2(offset, 0, maxScrollLeft));
+    boundaries.push(utils.clamp(offset, 0, maxScrollLeft));
   });
   return Array.from(new Set(boundaries)).filter((value) => value > 0);
 }
@@ -9246,74 +9308,321 @@ var ListTableCarouselController = class {
     });
   }
 };
-function getCellClipboardText(record, rowIndex, column) {
-  const value = getValueByDataIndex(record, column.dataIndex);
-  const rendered = column.render?.(value, record, rowIndex, column);
-  if (rendered != null) {
-    return renderResultToClipboardText(rendered);
+var SUMMARY_ASYNC_BATCH_SIZE = 2e3;
+var SUMMARY_ASYNC_FRAME_BUDGET = 8;
+async function computeSummaryValuesAsync(params) {
+  const { rows, columns, signal } = params;
+  const summaryValues = /* @__PURE__ */ new Map();
+  const accumulators = [];
+  columns.forEach((column) => {
+    const accumulator = createSummaryAccumulator(column);
+    if (accumulator) {
+      accumulators.push(accumulator);
+    }
+  });
+  columns.forEach((column) => {
+    if (column.summaryTitle != null) {
+      summaryValues.set(column.key, column.summaryTitle);
+    }
+  });
+  if (accumulators.length === 0) {
+    return summaryValues;
   }
-  if (column.cellType === "checkbox" || column.cellType === "radio") {
-    return String(Boolean(value));
+  for (let startIndex = 0; startIndex < rows.length; ) {
+    if (signal?.aborted) {
+      throw new Error("summary computation aborted");
+    }
+    const frameStart = now();
+    let endIndex = startIndex;
+    while (endIndex < rows.length) {
+      if (signal?.aborted) {
+        throw new Error("summary computation aborted");
+      }
+      const batchEndIndex = Math.min(
+        endIndex + SUMMARY_ASYNC_BATCH_SIZE,
+        rows.length
+      );
+      for (let rowIndex = endIndex; rowIndex < batchEndIndex; rowIndex += 1) {
+        const record = rows[rowIndex];
+        if (!record) {
+          continue;
+        }
+        accumulators.forEach((item) => {
+          updateSummaryAccumulator(item, record);
+        });
+      }
+      endIndex = batchEndIndex;
+      if (endIndex >= rows.length) {
+        break;
+      }
+      if (now() - frameStart >= SUMMARY_ASYNC_FRAME_BUDGET) {
+        break;
+      }
+    }
+    if (endIndex < rows.length) {
+      await yieldToMainThread();
+    }
+    startIndex = endIndex;
   }
-  return resolveFormattedCellText({
+  accumulators.forEach((item) => {
+    summaryValues.set(
+      item.column.key,
+      finalizeSummaryValue(item, rows)
+    );
+  });
+  return summaryValues;
+}
+function createSummaryAccumulator(column) {
+  const config = resolveSummaryConfig(column);
+  if (!config) {
+    return null;
+  }
+  return {
     column,
-    value,
-    record,
-    rowIndex
-  }) ?? String(value ?? "");
+    config,
+    type: config.type ?? "sum",
+    valueCount: 0,
+    numericCount: 0,
+    sum: 0,
+    min: null,
+    max: null,
+    uniqueValues: /* @__PURE__ */ new Set()
+  };
 }
-function createListTableSelectionCopyText(params) {
-  const columns = params.columns.filter(
-    (column2) => column2.key !== ROW_SELECTION_COLUMN_KEY && column2.key !== EXPAND_COLUMN_KEY
+function updateSummaryAccumulator(item, record) {
+  if (item.column.summaryTitle != null) {
+    return;
+  }
+  if (item.type === "rowCount" || item.type === "mergedRowCount") {
+    return;
+  }
+  const rawValue = normalizeSummaryValue(
+    getColumnRawValue(record, item.column, item.config)
   );
-  const columnRange = params.rangeHighlight.selectedColumnRange;
-  const rowRange = params.rangeHighlight.selectedRowRange;
-  const cellRange = params.rangeHighlight.selectedCellRange;
-  if (cellRange) {
-    const selectedColumns2 = params.columns.filter(
-      (column2, index) => index >= cellRange.startColumnIndex && index <= cellRange.endColumnIndex && column2.key !== ROW_SELECTION_COLUMN_KEY && column2.key !== EXPAND_COLUMN_KEY
-    );
-    return params.rows.slice(cellRange.startRowIndex, cellRange.endRowIndex + 1).map(
-      (record2, offset) => selectedColumns2.map(
-        (column2) => getCellClipboardText(
-          record2,
-          cellRange.startRowIndex + offset,
-          column2
-        )
-      ).join(" ")
-    ).join("\n");
+  if (rawValue == null) {
+    return;
   }
-  const mode = params.highlightMode ?? (rowRange && columnRange ? "cross" : rowRange ? "row" : "column");
-  const selectedColumns = columnRange ? params.columns.filter(
-    (column2, index) => index >= columnRange.start && index <= columnRange.end
-  ).filter(
-    (column2) => column2.key !== ROW_SELECTION_COLUMN_KEY && column2.key !== EXPAND_COLUMN_KEY
-  ) : columns;
-  rowRange ? Math.max(rowRange.start, 0) : 0;
-  rowRange ? Math.min(rowRange.end, params.rows.length - 1) : params.rows.length - 1;
-  if (mode === "column" && columnRange && params.selection.rowIndex == null) {
-    return params.rows.map(
-      (record2, rowIndex2) => selectedColumns.map((column2) => getCellClipboardText(record2, rowIndex2, column2)).join(" ")
-    ).join("\n");
+  item.valueCount += 1;
+  if (item.type === "unionCount") {
+    item.uniqueValues.add(String(rawValue));
+    return;
   }
-  const { rowIndex, columnKey } = params.selection;
-  const record = rowIndex == null ? void 0 : params.rows[rowIndex];
-  const column = columns.find((item) => item.key === columnKey);
-  return record && column && rowIndex != null ? getCellClipboardText(record, rowIndex, column) : null;
+  if (item.type === "count") {
+    return;
+  }
+  const numericValue = toNumber(rawValue);
+  if (numericValue == null) {
+    return;
+  }
+  item.numericCount += 1;
+  item.sum += numericValue;
+  item.min = item.min == null ? numericValue : Math.min(item.min, numericValue);
+  item.max = item.max == null ? numericValue : Math.max(item.max, numericValue);
 }
-function createListTableRangeCopyText(params) {
-  return createListTableSelectionCopyText({
-    rows: params.rows,
-    columns: params.columns,
-    selection: { rowIndex: null, columnKey: null },
-    rangeHighlight: {
-      selectedCellRange: {
-        startRowIndex: Math.max(
-          Math.min(params.startRowIndex, params.endRowIndex),
-          0
-        ),
-        endRowIndex: Math.min(
-          Math.max(params.startRowIndex, params.endRowIndex),
+function finalizeSummaryValue(item, rows) {
+  if (item.column.summaryTitle != null) {
+    return item.column.summaryTitle;
+  }
+  if (item.type === "rowCount") {
+    return formatSummaryOutput(item, String(rows.length), rows);
+  }
+  if (item.type === "mergedRowCount") {
+    return formatSummaryOutput(item, String(countMergedRows(rows)), rows);
+  }
+  if (item.type === "count") {
+    return formatSummaryOutput(item, String(item.valueCount), rows);
+  }
+  if (item.type === "unionCount") {
+    return formatSummaryOutput(item, String(item.uniqueValues.size), rows);
+  }
+  if (item.numericCount === 0) {
+    if (item.type === "min" || item.type === "max") {
+      return formatSummaryOutput(item, "", rows);
+    }
+    return formatSummaryOutput(item, "0", rows);
+  }
+  let result = item.sum;
+  if (item.type === "avg") {
+    result = item.sum / item.numericCount;
+  } else if (item.type === "min") {
+    result = item.min ?? 0;
+  } else if (item.type === "max") {
+    result = item.max ?? 0;
+  }
+  const rounded = roundByPrecision(result, item.config.precision);
+  const formatted = formatNumber(rounded, item.config.precision);
+  return formatSummaryOutput(item, formatted, rows);
+}
+function resolveSummaryConfig(column) {
+  if (column.summary == null) {
+    return null;
+  }
+  if (column.summary === true) {
+    return { type: "sum" };
+  }
+  if (column.summary === false) {
+    return null;
+  }
+  return { type: "sum", ...column.summary };
+}
+function getColumnRawValue(record, column, config) {
+  if (config.valueGetter) {
+    return config.valueGetter(record);
+  }
+  const sortValue = column.sortValueGetter?.(record);
+  if (sortValue != null && sortValue !== "") {
+    return sortValue;
+  }
+  const filterValue = column.filterValueGetter?.(record);
+  if (filterValue != null && filterValue !== "") {
+    return filterValue;
+  }
+  return utils.getValueByDataIndex(record, column.dataIndex);
+}
+function normalizeSummaryValue(value) {
+  if (value == null || value === "") {
+    return null;
+  }
+  if (typeof value === "number" || typeof value === "string") {
+    return value;
+  }
+  return null;
+}
+function toNumber(value) {
+  if (value == null) {
+    return null;
+  }
+  if (typeof value === "number") {
+    return Number.isNaN(value) ? null : value;
+  }
+  const parsed = Number(String(value).trim());
+  return Number.isNaN(parsed) ? null : parsed;
+}
+function roundByPrecision(value, precision) {
+  if (precision == null) {
+    return value;
+  }
+  return Number(value.toFixed(precision));
+}
+function formatNumber(value, precision) {
+  if (precision != null) {
+    return value.toFixed(precision);
+  }
+  if (Number.isInteger(value)) {
+    return String(value);
+  }
+  return value.toFixed(2);
+}
+function formatSummaryOutput(item, value, rows) {
+  if (item.config.formatter) {
+    return item.config.formatter(
+      value,
+      rows,
+      item.column
+    );
+  }
+  return value;
+}
+function countMergedRows(rows) {
+  return rows.reduce((count, record) => {
+    if (record == null || typeof record !== "object") {
+      return count + 1;
+    }
+    const rowSpan = record.rowSpan;
+    if (typeof rowSpan !== "number") {
+      return count + 1;
+    }
+    return rowSpan > 0 ? count + 1 : count;
+  }, 0);
+}
+function yieldToMainThread() {
+  return new Promise((resolve) => {
+    if (typeof requestAnimationFrame === "function") {
+      requestAnimationFrame(() => resolve());
+      return;
+    }
+    setTimeout(resolve, 0);
+  });
+}
+function now() {
+  if (typeof performance !== "undefined" && typeof performance.now === "function") {
+    return performance.now();
+  }
+  return Date.now();
+}
+
+// src/services/clipboard-service.ts
+function getCellClipboardText(record, rowIndex, column) {
+  const value = utils.getValueByDataIndex(record, column.dataIndex);
+  const rendered = column.render?.(value, record, rowIndex, column);
+  if (rendered != null) {
+    return renderResultToClipboardText(rendered);
+  }
+  if (column.dataFormat && column.dataFormat !== "default") {
+    return formatListTableDataValue(value, column.dataFormat);
+  }
+  if (column.cellType === "checkbox" || column.cellType === "radio") {
+    return String(Boolean(value));
+  }
+  return resolveFormattedCellText({
+    column,
+    value,
+    record,
+    rowIndex
+  }) ?? String(value ?? "");
+}
+function createListTableSelectionCopyText(params) {
+  const columns = params.columns.filter(
+    (column2) => column2.key !== ROW_SELECTION_COLUMN_KEY && column2.key !== EXPAND_COLUMN_KEY
+  );
+  const columnRange = params.rangeHighlight.selectedColumnRange;
+  const rowRange = params.rangeHighlight.selectedRowRange;
+  const cellRange = params.rangeHighlight.selectedCellRange;
+  if (cellRange) {
+    const selectedColumns2 = params.columns.filter(
+      (column2, index) => index >= cellRange.startColumnIndex && index <= cellRange.endColumnIndex && column2.key !== ROW_SELECTION_COLUMN_KEY && column2.key !== EXPAND_COLUMN_KEY
+    );
+    return params.rows.slice(cellRange.startRowIndex, cellRange.endRowIndex + 1).map(
+      (record2, offset) => selectedColumns2.map(
+        (column2) => getCellClipboardText(
+          record2,
+          cellRange.startRowIndex + offset,
+          column2
+        )
+      ).join(" ")
+    ).join("\n");
+  }
+  const mode = params.highlightMode ?? (rowRange && columnRange ? "cross" : rowRange ? "row" : "column");
+  const selectedColumns = columnRange ? params.columns.filter(
+    (column2, index) => index >= columnRange.start && index <= columnRange.end
+  ).filter(
+    (column2) => column2.key !== ROW_SELECTION_COLUMN_KEY && column2.key !== EXPAND_COLUMN_KEY
+  ) : columns;
+  rowRange ? Math.max(rowRange.start, 0) : 0;
+  rowRange ? Math.min(rowRange.end, params.rows.length - 1) : params.rows.length - 1;
+  if (mode === "column" && columnRange && params.selection.rowIndex == null) {
+    return params.rows.map(
+      (record2, rowIndex2) => selectedColumns.map((column2) => getCellClipboardText(record2, rowIndex2, column2)).join(" ")
+    ).join("\n");
+  }
+  const { rowIndex, columnKey } = params.selection;
+  const record = rowIndex == null ? void 0 : params.rows[rowIndex];
+  const column = columns.find((item) => item.key === columnKey);
+  return record && column && rowIndex != null ? getCellClipboardText(record, rowIndex, column) : null;
+}
+function createListTableRangeCopyText(params) {
+  return createListTableSelectionCopyText({
+    rows: params.rows,
+    columns: params.columns,
+    selection: { rowIndex: null, columnKey: null },
+    rangeHighlight: {
+      selectedCellRange: {
+        startRowIndex: Math.max(
+          Math.min(params.startRowIndex, params.endRowIndex),
+          0
+        ),
+        endRowIndex: Math.min(
+          Math.max(params.startRowIndex, params.endRowIndex),
           Math.max(params.rows.length - 1, 0)
         ),
         startColumnIndex: Math.max(
@@ -9412,10 +9721,31 @@ async function exportAllRowsTxtContent(params) {
   });
 }
 async function exportAllRowsXlsxContent(params) {
+  const columns = params.columns.filter(
+    (column) => column.key !== ROW_SELECTION_COLUMN_KEY
+  );
+  const rows = params.rows.map((record, rowIndex) => ({
+    type: "data",
+    record,
+    rowIndex
+  }));
+  if (params.includeSummary) {
+    rows.push({
+      type: "summary",
+      values: await computeSummaryValuesAsync({
+        rows: params.rows,
+        columns
+      })
+    });
+  }
   await utils.exportTableToXlsx({
-    fileName: buildTableExportFileName("xlsx"),
-    rows: params.rows,
-    columns: buildExportColumns(params.columns),
+    fileName: params.fileName?.trim() || buildTableExportFileName("xlsx"),
+    rows,
+    columns: columns.map((column) => ({
+      key: column.key,
+      title: column.title ?? column.key,
+      value: (row) => row.type === "summary" ? row.values.get(column.key) ?? "" : getCellClipboardText(row.record, row.rowIndex, column)
+    })),
     sheetName: "TableData"
   });
 }
@@ -9668,11 +9998,12 @@ var ListTableContentActionController = class {
   /**
    * 异步导出全部原始数据为 XLSX。
    */
-  exportXlsx() {
+  exportXlsx(options) {
     this.startExportTask(
       () => exportAllRowsXlsxContent({
         rows: this.options.getOptions().dataSource,
-        columns: this.options.getLeafColumns()
+        columns: this.options.getLeafColumns(),
+        ...options
       }),
       "\u6B63\u5728\u5BFC\u51FA XLSX\u2026"
     );
@@ -9832,7 +10163,7 @@ async function validateTableCells(params) {
       continue;
     }
     visited.add(stateKey);
-    const value = column.dataIndex == null ? void 0 : getValueByDataIndex(record, column.dataIndex);
+    const value = column.dataIndex == null ? void 0 : utils.getValueByDataIndex(record, column.dataIndex);
     const message = await validateCellValue(column, {
       value,
       record,
@@ -9891,7 +10222,7 @@ function resolveValidationTargetsForChange(params) {
       return;
     }
     const dependencies = resolveFormItemProps(column, {
-      value: column.dataIndex == null ? void 0 : getValueByDataIndex(record, column.dataIndex),
+      value: column.dataIndex == null ? void 0 : utils.getValueByDataIndex(record, column.dataIndex),
       record,
       rowIndex
     })?.dependencies;
@@ -9986,7 +10317,7 @@ function openCellEditingSession(params) {
   if (!column || !record) {
     return null;
   }
-  const currentValue = column.dataIndex == null ? void 0 : getValueByDataIndex(record, column.dataIndex);
+  const currentValue = column.dataIndex == null ? void 0 : utils.getValueByDataIndex(record, column.dataIndex);
   if (!canEditCell(column, {
     value: currentValue,
     record,
@@ -10518,8 +10849,6 @@ var ListTableEditingController = class {
     this.validationMessages = /* @__PURE__ */ new Map();
   }
 };
-
-// src/features/column-resize/column-resize-feature.ts
 function startColumnResizeDrag(params) {
   const { options, leafColumns, columnKey, pointerX } = params;
   for (const leaf of leafColumns) {
@@ -10541,7 +10870,7 @@ function updateColumnResizeDrag(params) {
   const { dragging, pointerX, leafColumns, options } = params;
   const dx = pointerX - dragging.startX;
   const nextWidth = Math.round(
-    clamp2(dragging.startWidth + dx, dragging.minWidth, dragging.maxWidth)
+    utils.clamp(dragging.startWidth + dx, dragging.minWidth, dragging.maxWidth)
   );
   const column = leafColumns.find((item) => item.key === dragging.columnKey);
   if (!column || column.width === nextWidth) {
@@ -10679,6 +11008,14 @@ function createListTableContextMenuActions(params) {
     onChangeSummaryPrecision: params.onChangeSummaryPrecision ? (columnKey, precision) => {
       params.hideMenu();
       params.onChangeSummaryPrecision?.(columnKey, precision);
+    } : void 0,
+    onChangeAlignment: params.onChangeAlignment ? (columnKey, area, axis, value) => {
+      params.hideMenu();
+      params.onChangeAlignment?.(columnKey, area, axis, value);
+    } : void 0,
+    onChangeDataFormat: params.onChangeDataFormat ? (columnKey, dataFormat) => {
+      params.hideMenu();
+      params.onChangeDataFormat?.(columnKey, dataFormat);
     } : void 0
   };
 }
@@ -10715,7 +11052,10 @@ function buildListTableContextMenuConfig(params) {
   const enableReset = enabledFeatures.has("reset");
   const enableDensity = enabledFeatures.has("density");
   const enableZoom = enabledFeatures.has("zoom");
+  const enableAlignment = enabledFeatures.has("alignment");
+  const enableDataFormat = enabledFeatures.has("dataFormat");
   const enableColumnVisibility = enabledFeatures.has("columnVisibility");
+  const presentation = isHeaderArea ? getColumnPresentationConfig(columns, columnKey) : null;
   const headerItems = isHeaderArea && (enableColumnVisibility || enableColumnCollapse) ? buildHeaderSettingsItems(columns) : void 0;
   const currentColumnItem = headerItems ? findHeaderColumnItem(headerItems, columnKey) : null;
   const canToggleCurrentColumn = enableColumnCollapse && isHeaderArea && !isSelectionColumn && currentColumnItem != null && !currentColumnItem.disabled;
@@ -10726,7 +11066,7 @@ function buildListTableContextMenuConfig(params) {
   };
   if (isSummaryArea && !isSelectionColumn && actions.onChangeSummaryType) {
     const column = findSummaryColumn(columns, columnKey);
-    const summary = resolveSummaryConfig(column?.summary);
+    const summary = resolveSummaryConfig2(column?.summary);
     summaryConfig.summaryColumnKey = columnKey;
     summaryConfig.summaryType = summary?.type ?? "sum";
     summaryConfig.summaryPrecision = summary?.precision;
@@ -10805,11 +11145,20 @@ function buildListTableContextMenuConfig(params) {
     onChangeDensity: enableDensity ? actions.onChangeDensity : void 0,
     onChangeZoom: enableZoom ? actions.onChangeZoom : void 0,
     onToggleColumn: enableColumnVisibility && isHeaderArea ? actions.onToggleColumn : void 0,
+    alignment: enableAlignment && presentation ? {
+      headerHorizontal: presentation.headerHorizontal,
+      headerVertical: presentation.headerVertical,
+      bodyHorizontal: presentation.bodyHorizontal,
+      bodyVertical: presentation.bodyVertical
+    } : void 0,
+    onChangeAlignment: enableAlignment && isHeaderArea && actions.onChangeAlignment ? (area, axis, value) => actions.onChangeAlignment?.(columnKey, area, axis, value) : void 0,
+    dataFormat: enableDataFormat && presentation?.dataFormatAvailable ? presentation.dataFormat : void 0,
+    onChangeDataFormat: enableDataFormat && presentation?.dataFormatAvailable && actions.onChangeDataFormat ? (dataFormat) => actions.onChangeDataFormat?.(columnKey, dataFormat) : void 0,
     onClose: actions.onClose,
     ...summaryConfig
   };
 }
-function resolveSummaryConfig(summary) {
+function resolveSummaryConfig2(summary) {
   if (summary === true) {
     return { type: "sum" };
   }
@@ -10840,6 +11189,8 @@ var DEFAULT_CONTEXT_MENU_FEATURES = [
   "reset",
   "density",
   "zoom",
+  "alignment",
+  "dataFormat",
   "columnVisibility"
 ];
 function resolveEnabledContextMenuFeatures(contextMenu) {
@@ -10898,7 +11249,7 @@ function resolveColumnFilterValue(record, column) {
   if (column.filterValueGetter) {
     return column.filterValueGetter(record);
   }
-  const value = getValueByDataIndex(record, column.dataIndex);
+  const value = utils.getValueByDataIndex(record, column.dataIndex);
   if (value !== void 0) {
     return value;
   }
@@ -10932,7 +11283,7 @@ function resolveColumnFilterOptionValue(record, column) {
     return serializeFilterOptionValue(column.filterOptionValueGetter(record));
   }
   if (column.filterOptions?.length) {
-    const rawValue = getValueByDataIndex(record, column.dataIndex) ?? record[column.key];
+    const rawValue = utils.getValueByDataIndex(record, column.dataIndex) ?? record[column.key];
     if (rawValue !== void 0) {
       return serializeFilterOptionValue(rawValue);
     }
@@ -11247,7 +11598,7 @@ async function filterRowsAsync(params) {
       }
     }
     if (endIndex < rows.length) {
-      await yieldToMainThread();
+      await yieldToMainThread2();
     }
   }
   return result;
@@ -11315,7 +11666,7 @@ async function getColumnFilterOptionsAsync(params) {
       optionCountMap.set(value, (optionCountMap.get(value) ?? 0) + 1);
     }
     if (endIndex < dataSource.length) {
-      await yieldToMainThread();
+      await yieldToMainThread2();
     }
   }
   const optionItems = explicitOptions.length > 0 ? explicitOptions.map((item) => ({
@@ -11351,7 +11702,7 @@ async function getColumnFilterOptionsAsync(params) {
     ...optionItems
   ];
 }
-function yieldToMainThread() {
+function yieldToMainThread2() {
   return new Promise((resolve) => {
     setTimeout(resolve, 0);
   });
@@ -11584,6 +11935,8 @@ function showHeaderContextMenu(params) {
     onToggleSummary,
     onChangeSummaryType,
     onChangeSummaryPrecision,
+    onChangeAlignment,
+    onChangeDataFormat,
     summaryVisible,
     getSelectionRange,
     onCopySelection,
@@ -11658,6 +12011,8 @@ function showHeaderContextMenu(params) {
         onToggleSummary,
         onChangeSummaryType,
         onChangeSummaryPrecision,
+        onChangeAlignment,
+        onChangeDataFormat,
         onCopySelection,
         onCopyCustomSelection
       })
@@ -12041,8 +12396,6 @@ function moveRowDrag(params) {
 function endRowDragSession() {
   return createIdleRowDragSession();
 }
-
-// src/features/row-drag/row-drag-insertion.ts
 function resolveRowDragInsertionPosition(params) {
   const bodyTop = Math.max(params.bodyTop, 0);
   const bodyBottom = Math.max(params.bodyBottom, bodyTop);
@@ -12059,15 +12412,15 @@ function resolveRowDragInsertionPosition(params) {
   for (const row of rowRects) {
     if (params.pointerY <= (row.top + row.bottom) / 2) {
       return {
-        insertIndex: clamp3(row.rowIndex, 0, rowCount),
-        indicatorY: clamp3(row.top, bodyTop, bodyBottom)
+        insertIndex: utils.clamp(row.rowIndex, 0, rowCount),
+        indicatorY: utils.clamp(row.top, bodyTop, bodyBottom)
       };
     }
   }
   const lastRow = rowRects[rowRects.length - 1];
   return {
-    insertIndex: clamp3(lastRow.rowIndex + 1, 0, rowCount),
-    indicatorY: clamp3(lastRow.bottom, bodyTop, bodyBottom)
+    insertIndex: utils.clamp(lastRow.rowIndex + 1, 0, rowCount),
+    indicatorY: utils.clamp(lastRow.bottom, bodyTop, bodyBottom)
   };
 }
 function resolveVisibleRowRects(descriptors) {
@@ -12090,9 +12443,6 @@ function resolveVisibleRowRects(descriptors) {
   }
   return Array.from(rows.values());
 }
-function clamp3(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
 
 // src/services/row-drag-bus.ts
 var RowDragBus = class {
@@ -12678,8 +13028,8 @@ var ListTableRowDragController = class {
     const pointer = this.potentialPointer ?? fallbackPointer;
     return {
       dataUrl,
-      grabOffsetX: clamp4((pointer.x - rect.x) * zoom, 0, rect.width * zoom),
-      grabOffsetY: clamp4((pointer.y - rect.y) * zoom, 0, rect.height * zoom)
+      grabOffsetX: utils.clamp((pointer.x - rect.x) * zoom, 0, rect.width * zoom),
+      grabOffsetY: utils.clamp((pointer.y - rect.y) * zoom, 0, rect.height * zoom)
     };
   }
   showPreview(capture, clientX, clientY) {
@@ -12916,9 +13266,6 @@ function structuredCloneSafe(value) {
     return value;
   }
 }
-function clamp4(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
 function resolveValidZoom(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 1;
 }
@@ -13280,7 +13627,7 @@ var ListTableEventController = class {
         (item) => item.key === result.columnKey
       );
       const record = this.host.getDisplayData()[result.rowIndex];
-      const value = column && record && column.dataIndex != null ? getValueByDataIndex(record, column.dataIndex) : void 0;
+      const value = column && record && column.dataIndex != null ? utils.getValueByDataIndex(record, column.dataIndex) : void 0;
       if (!record || !shouldOpenCellEditorOnClick(column, 2, {
         value,
         record,
@@ -13429,19 +13776,55 @@ var ListTableEventController = class {
           this.host.render();
         },
         onChangeSummaryType: (columnKey, type) => {
-          updateSummaryColumn(this.host.options.columns, columnKey, (summary) => ({
-            ...summary,
-            type
-          }));
+          updateSummaryColumn(
+            this.host.options.columns,
+            columnKey,
+            (summary) => ({
+              ...summary,
+              type
+            })
+          );
           this.host.refreshRuntimeColumns();
           this.host.persistColumnConfig();
           this.host.render();
         },
         onChangeSummaryPrecision: (columnKey, precision) => {
-          updateSummaryColumn(this.host.options.columns, columnKey, (summary) => ({
-            ...summary,
-            precision
-          }));
+          updateSummaryColumn(
+            this.host.options.columns,
+            columnKey,
+            (summary) => ({
+              ...summary,
+              precision
+            })
+          );
+          this.host.refreshRuntimeColumns();
+          this.host.persistColumnConfig();
+          this.host.render();
+        },
+        onChangeAlignment: (columnKey, area, axis, value) => {
+          const updated = setColumnAlignment({
+            columns: this.host.options.columns,
+            columnKey,
+            area,
+            axis,
+            value
+          });
+          if (!updated) {
+            return;
+          }
+          this.host.refreshRuntimeColumns();
+          this.host.persistColumnConfig();
+          this.host.render();
+        },
+        onChangeDataFormat: (columnKey, dataFormat) => {
+          const updated = setColumnDataFormat(
+            this.host.options.columns,
+            columnKey,
+            dataFormat
+          );
+          if (!updated) {
+            return;
+          }
           this.host.refreshRuntimeColumns();
           this.host.persistColumnConfig();
           this.host.render();
@@ -13611,7 +13994,7 @@ var ListTableEventController = class {
           (item) => item.key === result.columnKey
         );
         const record = this.host.getDisplayData()[result.rowIndex];
-        const value = column && record && column.dataIndex != null ? getValueByDataIndex(record, column.dataIndex) : void 0;
+        const value = column && record && column.dataIndex != null ? utils.getValueByDataIndex(record, column.dataIndex) : void 0;
         if (record && shouldOpenCellEditorOnClick(column, 1, {
           value,
           record,
@@ -13816,7 +14199,7 @@ var ListTableEventController = class {
     const columnKey = this.host.selection.columnKey;
     const column = this.host.leafColumns.find((item) => item.key === columnKey);
     const record = this.host.getDisplayData()[rowIndex];
-    const value = column && record && column.dataIndex != null ? getValueByDataIndex(record, column.dataIndex) : void 0;
+    const value = column && record && column.dataIndex != null ? utils.getValueByDataIndex(record, column.dataIndex) : void 0;
     if (!column || !record || !canEditCell(column, { value, record, rowIndex })) {
       return;
     }
@@ -13908,7 +14291,10 @@ var ListTableEventController = class {
     const width = snapshot?.width ?? this.host.canvasElement.width;
     const position = {
       x: Math.min(Math.max(pointer.x, 0), Math.max(width - 1, 0)),
-      y: Math.min(Math.max(pointer.y, bodyTop + 1), Math.max(bodyBottom - 1, bodyTop + 1))
+      y: Math.min(
+        Math.max(pointer.y, bodyTop + 1),
+        Math.max(bodyBottom - 1, bodyTop + 1)
+      )
     };
     const result = this.host.resolvePointerHit(position.x, position.y);
     if (result.area !== "body" && result.area !== "body-content" || typeof result.rowIndex !== "number" || !result.columnKey) {
@@ -14893,6 +15279,27 @@ function applyStoredColumnConfig(columns, storedColumns) {
       if (stored) {
         col.width = stored.width;
         col.hidden = !!stored.hidden;
+        if ("align" in stored) {
+          col.align = stored.align;
+        }
+        if ("headerAlign" in stored) {
+          col.headerAlign = stored.headerAlign;
+        }
+        if ("verticalAlign" in stored) {
+          col.cellStyle = {
+            ...col.cellStyle,
+            verticalAlign: stored.verticalAlign
+          };
+        }
+        if ("headerVerticalAlign" in stored) {
+          col.headerStyle = {
+            ...col.headerStyle,
+            verticalAlign: stored.headerVerticalAlign
+          };
+        }
+        if ("dataFormat" in stored) {
+          col.dataFormat = stored.dataFormat;
+        }
         if (stored.fixed) {
           col.fixed = stored.fixed;
         } else {
@@ -14926,6 +15333,11 @@ function buildStoredColumnConfig(columns, sortState, filterState, zoom, summaryR
         width: col.width ?? 160,
         fixed: col.fixed,
         hidden: !!col.hidden,
+        ...col.align ? { align: col.align } : null,
+        ...col.cellStyle?.verticalAlign ? { verticalAlign: col.cellStyle.verticalAlign } : null,
+        ...col.headerAlign ? { headerAlign: col.headerAlign } : null,
+        ...col.headerStyle?.verticalAlign ? { headerVerticalAlign: col.headerStyle.verticalAlign } : null,
+        ...col.dataFormat ? { dataFormat: col.dataFormat } : null,
         summary: col.summary === true ? { type: "sum" } : col.summary ? {
           type: col.summary.type,
           precision: col.summary.precision
@@ -15245,7 +15657,7 @@ function buildHeaderNode(column, leafColumns, maxDepth) {
       rowSpan: 1,
       leafStartIndex,
       leafEndIndex,
-      align: column.align ?? "left",
+      align: column.headerAlign ?? column.align ?? "left",
       fixed: column.fixed,
       style: column.headerStyle,
       column,
@@ -15263,7 +15675,7 @@ function buildHeaderNode(column, leafColumns, maxDepth) {
     rowSpan: maxDepth - column.depth + 1,
     leafStartIndex: leafIndex,
     leafEndIndex: leafIndex,
-    align: column.align ?? "left",
+    align: column.headerAlign ?? column.align ?? "left",
     fixed: column.fixed,
     style: column.headerStyle,
     column,
@@ -15410,8 +15822,6 @@ function computeScrollbarLayout(params) {
   }
   return layout;
 }
-
-// src/domain/layout/compute-viewport.ts
 function computeViewport(params) {
   const bodyHeight = Math.max(
     params.bodyHeight ?? params.height - params.headerHeight,
@@ -15441,15 +15851,12 @@ function computeViewport(params) {
   return {
     viewport,
     scroll: {
-      left: clamp5(params.scroll.left, 0, resolvedMaxScrollLeft),
-      top: clamp5(params.scroll.top, 0, resolvedMaxScrollTop)
+      left: utils.clamp(params.scroll.left, 0, resolvedMaxScrollLeft),
+      top: utils.clamp(params.scroll.top, 0, resolvedMaxScrollTop)
     },
     centerVisibleWidth
   };
 }
-function clamp5(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
 
 // src/domain/rows/body-layout.ts
 function resolveBodyLayout(params) {
@@ -16550,7 +16957,7 @@ function resolveSummaryTextX(params) {
   const maxX = visibleRect.x + visibleRect.width - padding;
   const preferredX = getAlignedTextX(rect, align, padding);
   if (align === "center") {
-    return clamp6(preferredX, minX, maxX);
+    return utils.clamp(preferredX, minX, maxX);
   }
   if (align === "right") {
     return Math.max(Math.min(preferredX, maxX), minX);
@@ -16592,9 +16999,6 @@ function intersectRects2(left, right) {
     height: maxY - y
   };
 }
-function clamp6(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
 function isIndexInHighlightRange2(index, range) {
   return Boolean(range && index >= range.start && index <= range.end);
 }
@@ -17306,7 +17710,7 @@ function buildMergedBodyCells(rows, columns, mergeCell, rowIndexMap) {
       if (!column || covered.has(coverKey)) {
         continue;
       }
-      const value = getValueByDataIndex(record, column.dataIndex);
+      const value = utils.getValueByDataIndex(record, column.dataIndex);
       const spanConfig = spanConfigMap.get(getCellCoverKey(rowIndex, column.key)) ?? column.onCell?.(value, record, sourceRowIndex, column);
       const hasExplicitRowSpan = hasExplicitSpan(spanConfig, "rowSpan");
       const hasExplicitColSpan = hasExplicitSpan(spanConfig, "colSpan");
@@ -17397,7 +17801,7 @@ function buildSpanConfigMap(rows, columns, rowIndexMap) {
   rows.forEach((record, rowIndex) => {
     const sourceRowIndex = rowIndexMap?.[rowIndex] ?? rowIndex;
     columns.forEach((column) => {
-      const value = getValueByDataIndex(record, column.dataIndex);
+      const value = utils.getValueByDataIndex(record, column.dataIndex);
       spanConfigMap.set(
         getCellCoverKey(rowIndex, column.key),
         column.onCell?.(value, record, sourceRowIndex, column)
@@ -17479,7 +17883,7 @@ function buildAutoColSpanMap(rows, columns, keys, spanConfigMap) {
         columnIndex += 1;
         continue;
       }
-      const currentValue = getValueByDataIndex(record, column.dataIndex);
+      const currentValue = utils.getValueByDataIndex(record, column.dataIndex);
       let colSpan = 1;
       for (let index = columnIndex + 1; index < columns.length; index += 1) {
         if (!targetColumnIndexes.has(index)) {
@@ -17493,7 +17897,7 @@ function buildAutoColSpanMap(rows, columns, keys, spanConfigMap) {
         if (hasExplicitSpan(spanConfigMap.get(nextCellKey), "colSpan")) {
           break;
         }
-        const nextValue = getValueByDataIndex(record, nextColumn.dataIndex);
+        const nextValue = utils.getValueByDataIndex(record, nextColumn.dataIndex);
         if (!isSameMergeValue(currentValue, nextValue)) {
           break;
         }
@@ -17519,7 +17923,7 @@ function getTargetMergeColumns(columns, keys) {
     return [];
   }
   return columns.filter(
-    (column) => keys.some((key) => isSameDataIndex2(column.dataIndex, key))
+    (column) => keys.some((key) => utils.isSameDataIndex(column.dataIndex, key))
   );
 }
 function getCellCoverKey(rowIndex, columnKey) {
@@ -17538,7 +17942,7 @@ function getMergeGroupKey(record, keys) {
   if (!keys?.length) {
     return "";
   }
-  return keys.map((key) => normalizeMergeValue(getValueByDataIndex(record, key))).join("|");
+  return keys.map((key) => normalizeMergeValue(utils.getValueByDataIndex(record, key))).join("|");
 }
 function normalizeMergeValue(value) {
   if (value == null) {
@@ -17552,14 +17956,6 @@ function normalizeMergeValue(value) {
 function isSameMergeValue(left, right) {
   return normalizeMergeValue(left) === normalizeMergeValue(right);
 }
-function isSameDataIndex2(left, right) {
-  const leftPath = Array.isArray(left) ? left : [left];
-  const rightPath = Array.isArray(right) ? right : [right];
-  if (leftPath.length !== rightPath.length) {
-    return false;
-  }
-  return leftPath.every((key, index) => key === rightPath[index]);
-}
 function getMergedCellWidth(columns, startIndex, colSpan) {
   let width = 0;
   for (let index = startIndex; index < startIndex + colSpan; index += 1) {
@@ -18324,8 +18720,6 @@ function isDragSourceColumn3(column, dragReorder) {
   }
   return column.leafIndex >= dragReorder.sourceLeafStartIndex && column.leafIndex <= dragReorder.sourceLeafEndIndex;
 }
-
-// src/rendering/primitives/header-text-layout.ts
 var ACTION_GAP = 4;
 var ACTION_SIZE = 14;
 var ACTION_PADDING_INLINE = 10;
@@ -18417,16 +18811,13 @@ function getStickyTextX(rect, visibleRect, align, padding) {
   const maxX = visibleRect.x + visibleRect.width - padding;
   const preferredX = getAlignedTextX2(rect, align, padding);
   if (align === "center") {
-    return clamp7(preferredX, minX, maxX);
+    return utils.clamp(preferredX, minX, maxX);
   }
   if (align === "right") {
     return Math.max(Math.min(preferredX, maxX), minX);
   }
   return Math.min(Math.max(preferredX, minX), maxX);
 }
-function clamp7(value, min, max) {
-  return Math.min(Math.max(value, min), max);
-}
 
 // src/rendering/primitives/draw-header.ts
 var ACTION_GAP2 = 4;
@@ -18546,7 +18937,13 @@ function drawHeaderCell(params, cell, clipRect) {
     }),
     contentInsetEnd: cell.node.children.length === 0 && collapseMarkerSet.hasRightMarker ? COLLAPSE_TRIGGER_WIDTH / 2 + COLLAPSE_TRIGGER_GAP + ACTION_PADDING_INLINE2 : 0
   });
-  const textY = rect.y + rect.height / 2;
+  const textY = resolveHeaderContentCenterY(
+    rect,
+    titleContent,
+    theme.fontSize,
+    cell.node.style?.paddingBlock ?? 6,
+    cell.node.style?.verticalAlign
+  );
   ctx.textAlign = textLayout.align;
   if (params.rowSelection?.columnKey === cell.node.key && cell.node.children.length === 0) {
     descriptors.push({
@@ -18596,6 +18993,21 @@ function drawHeaderCell(params, cell, clipRect) {
   }
   ctx.restore();
 }
+function resolveHeaderContentCenterY(rect, contents, fontSize, paddingBlock, verticalAlign) {
+  const contentHeight = Math.max(
+    fontSize,
+    ...contents.map(
+      (content) => content.type === "img" ? Math.max(content.height ?? content.width ?? fontSize, 1) : fontSize
+    )
+  );
+  if (verticalAlign === "top") {
+    return rect.y + paddingBlock + contentHeight / 2;
+  }
+  if (verticalAlign === "bottom") {
+    return rect.y + rect.height - paddingBlock - contentHeight / 2;
+  }
+  return rect.y + rect.height / 2;
+}
 function measureHeaderContentWidth(ctx, contents) {
   const gap = 4;
   return contents.reduce(
@@ -20790,250 +21202,6 @@ var ListTableSelectionController = class {
   }
 };
 
-// src/services/summary-service.ts
-var SUMMARY_ASYNC_BATCH_SIZE = 2e3;
-var SUMMARY_ASYNC_FRAME_BUDGET = 8;
-async function computeSummaryValuesAsync(params) {
-  const { rows, columns, signal } = params;
-  const summaryValues = /* @__PURE__ */ new Map();
-  const accumulators = [];
-  columns.forEach((column) => {
-    const accumulator = createSummaryAccumulator(column);
-    if (accumulator) {
-      accumulators.push(accumulator);
-    }
-  });
-  columns.forEach((column) => {
-    if (column.summaryTitle != null) {
-      summaryValues.set(column.key, column.summaryTitle);
-    }
-  });
-  if (accumulators.length === 0) {
-    return summaryValues;
-  }
-  for (let startIndex = 0; startIndex < rows.length; ) {
-    if (signal?.aborted) {
-      throw new Error("summary computation aborted");
-    }
-    const frameStart = now();
-    let endIndex = startIndex;
-    while (endIndex < rows.length) {
-      if (signal?.aborted) {
-        throw new Error("summary computation aborted");
-      }
-      const batchEndIndex = Math.min(
-        endIndex + SUMMARY_ASYNC_BATCH_SIZE,
-        rows.length
-      );
-      for (let rowIndex = endIndex; rowIndex < batchEndIndex; rowIndex += 1) {
-        const record = rows[rowIndex];
-        if (!record) {
-          continue;
-        }
-        accumulators.forEach((item) => {
-          updateSummaryAccumulator(item, record);
-        });
-      }
-      endIndex = batchEndIndex;
-      if (endIndex >= rows.length) {
-        break;
-      }
-      if (now() - frameStart >= SUMMARY_ASYNC_FRAME_BUDGET) {
-        break;
-      }
-    }
-    if (endIndex < rows.length) {
-      await yieldToMainThread2();
-    }
-    startIndex = endIndex;
-  }
-  accumulators.forEach((item) => {
-    summaryValues.set(
-      item.column.key,
-      finalizeSummaryValue(item, rows)
-    );
-  });
-  return summaryValues;
-}
-function createSummaryAccumulator(column) {
-  const config = resolveSummaryConfig2(column);
-  if (!config) {
-    return null;
-  }
-  return {
-    column,
-    config,
-    type: config.type ?? "sum",
-    valueCount: 0,
-    numericCount: 0,
-    sum: 0,
-    min: null,
-    max: null,
-    uniqueValues: /* @__PURE__ */ new Set()
-  };
-}
-function updateSummaryAccumulator(item, record) {
-  if (item.column.summaryTitle != null) {
-    return;
-  }
-  if (item.type === "rowCount" || item.type === "mergedRowCount") {
-    return;
-  }
-  const rawValue = normalizeSummaryValue(
-    getColumnRawValue(record, item.column, item.config)
-  );
-  if (rawValue == null) {
-    return;
-  }
-  item.valueCount += 1;
-  if (item.type === "unionCount") {
-    item.uniqueValues.add(String(rawValue));
-    return;
-  }
-  if (item.type === "count") {
-    return;
-  }
-  const numericValue = toNumber(rawValue);
-  if (numericValue == null) {
-    return;
-  }
-  item.numericCount += 1;
-  item.sum += numericValue;
-  item.min = item.min == null ? numericValue : Math.min(item.min, numericValue);
-  item.max = item.max == null ? numericValue : Math.max(item.max, numericValue);
-}
-function finalizeSummaryValue(item, rows) {
-  if (item.column.summaryTitle != null) {
-    return item.column.summaryTitle;
-  }
-  if (item.type === "rowCount") {
-    return formatSummaryOutput(item, String(rows.length), rows);
-  }
-  if (item.type === "mergedRowCount") {
-    return formatSummaryOutput(item, String(countMergedRows(rows)), rows);
-  }
-  if (item.type === "count") {
-    return formatSummaryOutput(item, String(item.valueCount), rows);
-  }
-  if (item.type === "unionCount") {
-    return formatSummaryOutput(item, String(item.uniqueValues.size), rows);
-  }
-  if (item.numericCount === 0) {
-    if (item.type === "min" || item.type === "max") {
-      return formatSummaryOutput(item, "", rows);
-    }
-    return formatSummaryOutput(item, "0", rows);
-  }
-  let result = item.sum;
-  if (item.type === "avg") {
-    result = item.sum / item.numericCount;
-  } else if (item.type === "min") {
-    result = item.min ?? 0;
-  } else if (item.type === "max") {
-    result = item.max ?? 0;
-  }
-  const rounded = roundByPrecision(result, item.config.precision);
-  const formatted = formatNumber(rounded, item.config.precision);
-  return formatSummaryOutput(item, formatted, rows);
-}
-function resolveSummaryConfig2(column) {
-  if (column.summary == null) {
-    return null;
-  }
-  if (column.summary === true) {
-    return { type: "sum" };
-  }
-  if (column.summary === false) {
-    return null;
-  }
-  return { type: "sum", ...column.summary };
-}
-function getColumnRawValue(record, column, config) {
-  if (config.valueGetter) {
-    return config.valueGetter(record);
-  }
-  const sortValue = column.sortValueGetter?.(record);
-  if (sortValue != null && sortValue !== "") {
-    return sortValue;
-  }
-  const filterValue = column.filterValueGetter?.(record);
-  if (filterValue != null && filterValue !== "") {
-    return filterValue;
-  }
-  return getValueByDataIndex(record, column.dataIndex);
-}
-function normalizeSummaryValue(value) {
-  if (value == null || value === "") {
-    return null;
-  }
-  if (typeof value === "number" || typeof value === "string") {
-    return value;
-  }
-  return null;
-}
-function toNumber(value) {
-  if (value == null) {
-    return null;
-  }
-  if (typeof value === "number") {
-    return Number.isNaN(value) ? null : value;
-  }
-  const parsed = Number(String(value).trim());
-  return Number.isNaN(parsed) ? null : parsed;
-}
-function roundByPrecision(value, precision) {
-  if (precision == null) {
-    return value;
-  }
-  return Number(value.toFixed(precision));
-}
-function formatNumber(value, precision) {
-  if (precision != null) {
-    return value.toFixed(precision);
-  }
-  if (Number.isInteger(value)) {
-    return String(value);
-  }
-  return value.toFixed(2);
-}
-function formatSummaryOutput(item, value, rows) {
-  if (item.config.formatter) {
-    return item.config.formatter(
-      value,
-      rows,
-      item.column
-    );
-  }
-  return value;
-}
-function countMergedRows(rows) {
-  return rows.reduce((count, record) => {
-    if (record == null || typeof record !== "object") {
-      return count + 1;
-    }
-    const rowSpan = record.rowSpan;
-    if (typeof rowSpan !== "number") {
-      return count + 1;
-    }
-    return rowSpan > 0 ? count + 1 : count;
-  }, 0);
-}
-function yieldToMainThread2() {
-  return new Promise((resolve) => {
-    if (typeof requestAnimationFrame === "function") {
-      requestAnimationFrame(() => resolve());
-      return;
-    }
-    setTimeout(resolve, 0);
-  });
-}
-function now() {
-  if (typeof performance !== "undefined" && typeof performance.now === "function") {
-    return performance.now();
-  }
-  return Date.now();
-}
-
 // src/domain/summary/summary-interaction.ts
 function isSummaryInteractionActive(params) {
   const now2 = params.now ?? Date.now();
@@ -21842,6 +22010,7 @@ var ListTableCore = class {
     __publicField(this, "debugManager");
     this.container = container;
     this.options = options;
+    applyInitialColumnVisibility(options.columns);
     ensureColumnKeysInPlace(options.columns);
     this.domHost = new ListTableDomHost();
     this.canvasHost = new ListTableCanvasHost();
@@ -21887,6 +22056,7 @@ var ListTableCore = class {
    */
   updateOptions(options) {
     this.animationController.stopCarouselScroll();
+    applyInitialColumnVisibility(options.columns);
     ensureColumnKeysInPlace(options.columns);
     if (options.expandable?.expandedRowKeys !== void 0 && !areSameRowKeySet(
       this.storeFacade.expandedRowKeys,
@@ -21940,8 +22110,8 @@ var ListTableCore = class {
   /**
    * 异步导出全部原始数据为 XLSX。
    */
-  exportXlsx() {
-    this.contentActionController.exportXlsx();
+  exportXlsx(options) {
+    this.contentActionController.exportXlsx(options);
   }
   /**
    * 滚动到指定行。
@@ -22062,8 +22232,8 @@ var ListTable = class {
   /**
    * 异步导出全部原始数据为 XLSX。
    */
-  exportXlsx() {
-    this.core?.exportXlsx();
+  exportXlsx(options) {
+    this.core?.exportXlsx(options);
   }
   /**
    * 滚动到指定行。