@canvas-components/list-table 0.2.1 → 0.2.2

package/dist/index.js

@@ -1,4 +1,4 @@
-import { stringifyDataIndex, getValueByDataIndex, clamp, copyTextSync, copyText, exportTableToXlsx, isSameDataIndex, exportTableToTxt, exportTableToCsv, downloadJsonFile, mapRowsToExportRecords, copyJson, copyRows, isPointInRect as isPointInRect$1 } from '@canvas-components/utils';
+import { stringifyDataIndex, getValueByDataIndex, clamp, copyTextSync, copyText, exportTableToXlsx, exportTableToTxt, exportTableToCsv, downloadJsonFile, mapRowsToExportRecords, copyJson, copyRows, isSameDataIndex, isPointInRect as isPointInRect$1 } from '@canvas-components/utils';
 import { drawBarcodeToCanvas } from '@canvas-components/barcode';
 import { drawCanvasChartToCanvas, getCanvasChartRenderer, resolveCanvasChartTooltipText } from '@canvas-components/chart';
 import { drawQrCodeToCanvas } from '@canvas-components/qrcode';
@@ -322,6 +322,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,
@@ -341,6 +342,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,
@@ -576,15 +578,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) {
@@ -644,9 +659,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) => {
@@ -712,19 +725,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,
@@ -734,6 +815,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;
       });
@@ -741,12 +825,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;
       }
@@ -755,6 +837,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);
@@ -5308,6 +5393,10 @@ 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);
@@ -5321,6 +5410,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 [
       {
@@ -5481,6 +5578,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;
@@ -9189,116 +9306,363 @@ 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
-  );
-  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");
+function updateSummaryAccumulator(item, record) {
+  if (item.column.summaryTitle != 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");
+  if (item.type === "rowCount" || item.type === "mergedRowCount") {
+    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;
-}
-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(
-          Math.min(params.startColumnIndex, params.endColumnIndex),
-          0
-        ),
-        endColumnIndex: Math.min(
-          Math.max(params.startColumnIndex, params.endColumnIndex),
-          Math.max(params.columns.length - 1, 0)
-        )
-      }
-    }
-  });
-}
-async function copyBodyCellContent(params) {
-  const { rows, columns, rowIndex, columnKey } = params;
-  const record = rows[rowIndex];
-  const column = columns.find((item) => item.key === columnKey);
-  if (!record || !column) {
+  const rawValue = normalizeSummaryValue(
+    getColumnRawValue(record, item.column, item.config)
+  );
+  if (rawValue == null) {
     return;
   }
-  try {
-    await copyText(getCellClipboardText(record, rowIndex, column));
-  } catch (error) {
-    console.error("[ListTable] Failed to copy cell:", error);
+  item.valueCount += 1;
+  if (item.type === "unionCount") {
+    item.uniqueValues.add(String(rawValue));
+    return;
   }
-}
-async function copyHeaderCellContent(params) {
-  const headerNode = findHeaderNodeByKey(params.headerTree, params.columnKey);
-  try {
-    await copyText(headerNode?.title ?? params.columnKey);
-  } catch (error) {
-    console.error("[ListTable] Failed to copy header cell:", error);
+  if (item.type === "count") {
+    return;
   }
-}
-async function copyColumnContent(params) {
-  const { rows, columns, columnKey } = params;
-  const column = columns.find((item) => item.key === columnKey);
-  if (!column) {
+  const numericValue = toNumber(rawValue);
+  if (numericValue == null) {
     return;
   }
-  const values = rows.map((record, rowIndex) => [
+  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 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 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 = 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(
+          Math.min(params.startColumnIndex, params.endColumnIndex),
+          0
+        ),
+        endColumnIndex: Math.min(
+          Math.max(params.startColumnIndex, params.endColumnIndex),
+          Math.max(params.columns.length - 1, 0)
+        )
+      }
+    }
+  });
+}
+async function copyBodyCellContent(params) {
+  const { rows, columns, rowIndex, columnKey } = params;
+  const record = rows[rowIndex];
+  const column = columns.find((item) => item.key === columnKey);
+  if (!record || !column) {
+    return;
+  }
+  try {
+    await copyText(getCellClipboardText(record, rowIndex, column));
+  } catch (error) {
+    console.error("[ListTable] Failed to copy cell:", error);
+  }
+}
+async function copyHeaderCellContent(params) {
+  const headerNode = findHeaderNodeByKey(params.headerTree, params.columnKey);
+  try {
+    await copyText(headerNode?.title ?? params.columnKey);
+  } catch (error) {
+    console.error("[ListTable] Failed to copy header cell:", error);
+  }
+}
+async function copyColumnContent(params) {
+  const { rows, columns, columnKey } = params;
+  const column = columns.find((item) => item.key === columnKey);
+  if (!column) {
+    return;
+  }
+  const values = rows.map((record, rowIndex) => [
     getCellClipboardText(record, rowIndex, column)
   ]);
   try {
@@ -9355,10 +9719,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 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"
   });
 }
@@ -9611,11 +9996,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"
     );
@@ -10620,6 +11006,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
   };
 }
@@ -10656,7 +11050,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;
@@ -10667,7 +11064,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;
@@ -10746,11 +11143,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" };
   }
@@ -10781,6 +11187,8 @@ var DEFAULT_CONTEXT_MENU_FEATURES = [
   "reset",
   "density",
   "zoom",
+  "alignment",
+  "dataFormat",
   "columnVisibility"
 ];
 function resolveEnabledContextMenuFeatures(contextMenu) {
@@ -11188,7 +11596,7 @@ async function filterRowsAsync(params) {
       }
     }
     if (endIndex < rows.length) {
-      await yieldToMainThread();
+      await yieldToMainThread2();
     }
   }
   return result;
@@ -11256,7 +11664,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) => ({
@@ -11292,7 +11700,7 @@ async function getColumnFilterOptionsAsync(params) {
     ...optionItems
   ];
 }
-function yieldToMainThread() {
+function yieldToMainThread2() {
   return new Promise((resolve) => {
     setTimeout(resolve, 0);
   });
@@ -11525,6 +11933,8 @@ function showHeaderContextMenu(params) {
     onToggleSummary,
     onChangeSummaryType,
     onChangeSummaryPrecision,
+    onChangeAlignment,
+    onChangeDataFormat,
     summaryVisible,
     getSelectionRange,
     onCopySelection,
@@ -11599,6 +12009,8 @@ function showHeaderContextMenu(params) {
         onToggleSummary,
         onChangeSummaryType,
         onChangeSummaryPrecision,
+        onChangeAlignment,
+        onChangeDataFormat,
         onCopySelection,
         onCopyCustomSelection
       })
@@ -13362,19 +13774,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();
@@ -13841,7 +14289,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) {
@@ -14826,6 +15277,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 {
@@ -14859,6 +15331,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
@@ -15178,7 +15655,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,
@@ -15196,7 +15673,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,
@@ -18458,7 +18935,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({
@@ -18508,6 +18991,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(
@@ -20701,248 +21199,6 @@ var ListTableSelectionController = class {
     this.summarySelected = false;
   }
 };
-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) {
@@ -21752,6 +22008,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();
@@ -21797,6 +22054,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,
@@ -21850,8 +22108,8 @@ var ListTableCore = class {
   /**
    * 异步导出全部原始数据为 XLSX。
    */
-  exportXlsx() {
-    this.contentActionController.exportXlsx();
+  exportXlsx(options) {
+    this.contentActionController.exportXlsx(options);
   }
   /**
    * 滚动到指定行。
@@ -21972,8 +22230,8 @@ var ListTable = class {
   /**
    * 异步导出全部原始数据为 XLSX。
    */
-  exportXlsx() {
-    this.core?.exportXlsx();
+  exportXlsx(options) {
+    this.core?.exportXlsx(options);
   }
   /**
    * 滚动到指定行。