@a3s-lab/office 0.36.0 → 0.37.0

package/dist/0~spreadsheet-editor.js

@@ -6,7 +6,7 @@ import { Fragment as external_react_Fragment, cloneElement, memo, useCallback, u
 import { convertSpanToShareString, genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
 import { freezeImportedSpreadsheetCell, normalizeXlsxSemanticColorOrigin, spreadsheetMatrixProfile, withXlsxPatternFill, withoutEditableRange, normalizeSpreadsheetConditionalVisualOptions, xlsxSemanticColorMatchesValue, withXlsxGradientFill, effectiveSpreadsheetPageSetup, attachSpreadsheetShownCommentCells, normalizeXlsxPatternFill, withEditableRange, sameSpreadsheetHistoryValue, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, xlsxPatternFillTypes, sheetProtectionAuthority, normalizeXlsxGradientFill, xlsxGradientFillFallbackColor, editableRangeCellCount, unlockedCellCount, registerDerivedSpreadsheetMatrix, editableRangeRequiresCredentials, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, normalizeSheetProtectionAuthority, withSheetProtection, spreadsheetProtectionKey, defaultSpreadsheetColorScaleThresholds, protectedSheetCount, SPREADSHEET_CONDITIONAL_ICON_SETS, withSheetSelectionPermissions, spreadsheetConditionalComparisonNeedsUpperValue, drawSpreadsheetConditionalIcon, spreadsheetConditionalThresholdsEqual } from "./9333.js";
 import { workSpreadsheetChartSupportsGrouping, spreadsheetFormulaRangesForSelection, createSpreadsheetChartFromSelection, normalizeWorkSpreadsheetDataLabelPosition, normalizeSpreadsheetPrintTitleColumns, normalizeSpreadsheetPrintTitleRows, formulaHasStructuredReference, normalizeWorkSpreadsheetErrorBars, defaultPivotValueCaption, workSpreadsheetChartSupportsBarSpacing, normalizeWorkSpreadsheetChartGrouping, spreadsheetGridSize, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetScatterStyle, cloneSparseMatrix, spreadsheetPivotAggregationLabel, workSpreadsheetChartAxisIsCategoryAxis, reconcileSpreadsheetChartPreviews, normalizeWorkSpreadsheetChartAxes, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetChartLegendPosition, spreadsheetChartCount, workSpreadsheetChartTypeLabel, sparseArrayEntries, normalizeWorkSpreadsheetTrendline, effectiveSpreadsheetCalculationSettings, spreadsheetPivotIntersects, normalizeWorkSpreadsheetDataLabels, spreadsheetPivotOutputContains, normalizeSpreadsheetPrintArea, spreadsheetCellAddress, formatSpreadsheetCellRanges, normalizeWorkSpreadsheetChartLayout, spreadsheetFormulaRangeForCell, workSpreadsheetChartAxisIsValueAxis, normalizeWorkSpreadsheetChartSmoothLines, spreadsheetPivotFilterValueKey, normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetChartSeriesStyle, volatileSpreadsheetFormulaFunctions, sparseArrayIndexes, normalizeWorkSpreadsheetBubbleSizeRepresents, workSpreadsheetChartSupportsTrendlines, normalizeWorkSpreadsheetChartLegendOverlay, parseSpreadsheetChartReference, workSpreadsheetChartGroupingIsStacked, normalizeWorkSpreadsheetChartGapWidth, workSpreadsheetChartSupportsSmoothLines, refreshSpreadsheetPivotTables, createSpreadsheetPivotFromSelection, reconcileSpreadsheetPivots, spreadsheetPivotCount, sparseMatrixColumnCount, workSpreadsheetChartSupportsErrorBars, formulaHasExternalReference, isValidSpreadsheetDefinedName, spreadsheetPivotValidation, deleteSpreadsheetPivotTable, workSpreadsheetChartAxisDefaultLabelPosition, workSpreadsheetChartSupportsSeriesAnalysis, parseSpreadsheetCellRanges, spreadsheetPivotFilterItems, spreadsheetPivotFields, normalizeWorkSpreadsheetChartOverlap, spreadsheetFormulaRangeConflict, spreadsheetSheetsWithChartPreviews, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetChartAxisShowsMajorGridlinesByDefault, workSpreadsheetChartSupportsAxes, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetRadarStyle } from "./8715.js";
-import { reconcileSpreadsheetTableCalculatedColumns, spreadsheetTextOrientationFromChoice, xlsxRichTextCellText, isSpreadsheetTextOrientationId, spreadsheetTextOrientationFromAngle, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, normalizeSpreadsheetDataValidationErrorStyle, normalizeXlsxRichTextEditSource, normalizeXlsxRichTextColor, isHighSurrogate, xlsxNativeFillCellKeys, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, boundedSpreadsheetDataValidationText, normalizeXlsxRichTextCell, activeXlsxNativeFill, spreadsheetUnderlineStyle, normalizeSpreadsheetDateValidationBoundary, deleteXlsxNativeFills, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, normalizeXlsxRichTextRun, spreadsheetDiagonalBorderFromCellValue, sameXlsxRichTextRunStyle, isLowSurrogate, spreadsheetTextOrientationFromCell, coalesceXlsxRichTextRuns, patchSpreadsheetRichTextFontRuns, fillSpreadsheetTableCalculatedColumns, validXlsxRichText, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, isSpreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell } from "./3266.js";
+import { reconcileSpreadsheetTableCalculatedColumns, isSpreadsheetTextOrientationId, spreadsheetTextOrientationFromChoice, xlsxRichTextCellText, spreadsheetTextOrientationFromAngle, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, normalizeSpreadsheetDataValidationErrorStyle, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, spreadsheetTableTotalsFunctionLabel, withDefaultSpreadsheetTableTotalsLabel, normalizeXlsxRichTextEditSource, spreadsheetTableTotalsColumnPatch, normalizeXlsxRichTextColor, isHighSurrogate, xlsxNativeFillCellKeys, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, SPREADSHEET_TABLE_TOTALS_FUNCTIONS, boundedSpreadsheetDataValidationText, normalizeXlsxRichTextCell, activeXlsxNativeFill, spreadsheetUnderlineStyle, normalizeSpreadsheetDateValidationBoundary, deleteXlsxNativeFills, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, normalizeXlsxRichTextRun, spreadsheetDiagonalBorderFromCellValue, sameXlsxRichTextRunStyle, isLowSurrogate, spreadsheetTableTotalsRowHasContent, reconcileSpreadsheetTableTotalsColumns, spreadsheetTextOrientationFromCell, coalesceXlsxRichTextRuns, fillSpreadsheetTableCalculatedColumns, synchronizeSpreadsheetTableTotalsRow, validXlsxRichText, patchSpreadsheetRichTextFontRuns, isSpreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell } from "./3266.js";
 import { moveOfficeMenuFocus, stepOfficeZoom, useOfficeRemoteParticipants, Popover, Dialog, officePresenceColor, useOfficePublishPresenceLocation, button_Button, icon_button_IconButton, moveOfficeGridMenuFocus, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom } from "./0~8136.js";
 import { isOfficeKernelSpreadsheetError, normalizeCssColor, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, createOfficeId as createWorkId } from "./4121.js";
 import { useOfficeTaskPaneEscape, OfficeCheckbox, CommittedOfficeNumberField, useOfficeDialog, useOfficeTaskPaneModal, createOfficeKernelClient, officeFontFamilies, CollectionState, OfficeNumberField, handleOfficeTaskPaneKeyDown } from "./0~7048.js";
@@ -3770,6 +3770,7 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
         let tables = source.tables;
         const reconcileColumns = new Set();
         const calculatedColumnRows = new Map();
+        const editedTotalsColumns = new Map();
         if (!operations.length) for (const table of tables)reconcileColumns.add(table.id);
         for (const operation of sheetOperations){
             const structure = spreadsheetTableStructureChangeFromOperation(operation);
@@ -3797,7 +3798,17 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
             const coordinate = spreadsheetCellCoordinateFromOperation(operation);
             if (!coordinate) continue;
             const table = tables.find((candidate)=>spreadsheetTableContainsCell(candidate, coordinate.row, coordinate.column));
-            if (table) reconcileColumns.add(table.id);
+            if (table) {
+                reconcileColumns.add(table.id);
+                if (table.totalsRow && coordinate.row === table.range.row[1]) {
+                    const offset = coordinate.column - table.range.column[0];
+                    if (offset >= 0 && offset < table.columns.length) {
+                        const offsets = editedTotalsColumns.get(table.id) ?? new Set();
+                        offsets.add(offset);
+                        editedTotalsColumns.set(table.id, offsets);
+                    }
+                }
+            }
         }
         const updates = [];
         const readCell = spreadsheetSheetCellReader(sheet);
@@ -3808,7 +3819,11 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
                 ...table,
                 columns
             });
-            if (table.headerRow) for (const [offset, column] of calculatedColumns.entries()){
+            const reconciledColumns = reconcileSpreadsheetTableTotalsColumns(sheet, {
+                ...table,
+                columns: calculatedColumns
+            }, editedTotalsColumns.get(table.id));
+            if (table.headerRow) for (const [offset, column] of reconciledColumns.entries()){
                 const cellColumn = table.range.column[0] + offset;
                 if (spreadsheetCellText(readCell(table.range.row[0], cellColumn)) !== column.name) updates.push({
                     column: cellColumn,
@@ -3816,9 +3831,9 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
                     row: table.range.row[0]
                 });
             }
-            return sameSpreadsheetTableColumns(table.columns, calculatedColumns) ? table : {
+            return sameSpreadsheetTableColumns(table.columns, reconciledColumns) ? table : {
                 ...table,
-                columns: calculatedColumns
+                columns: reconciledColumns
             };
         });
         let withCalculatedColumns = sheet;
@@ -3829,8 +3844,13 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
             ]);
         }
         const withHeaders = stampSpreadsheetTableHeaderCells(withCalculatedColumns, updates);
+        let withTotals = withHeaders;
+        for (const table of tables){
+            const previous = source.tables.find((candidate)=>candidate.id === table.id);
+            withTotals = synchronizeSpreadsheetTableTotalsRow(withTotals, previous, table);
+        }
         return {
-            ...withHeaders,
+            ...withTotals,
             tables: tables.length ? tables : void 0
         };
     });
@@ -4021,6 +4041,7 @@ function canonicalSpreadsheetTableColumns(table, readCell) {
         }
         observed.add(candidate.toLocaleLowerCase());
         return {
+            ...table.columns[offset] ?? {},
             name: candidate
         };
     });
@@ -4146,7 +4167,7 @@ function truncateSpreadsheetTableColumnName(value, maximum) {
     return Array.from(value).slice(0, maximum).join('');
 }
 function sameSpreadsheetTableColumns(left, right) {
-    return left.length === right.length && left.every((column, index)=>column.name === right[index]?.name && column.calculatedFormula === right[index]?.calculatedFormula);
+    return left.length === right.length && left.every((column, index)=>column.name === right[index]?.name && column.calculatedFormula === right[index]?.calculatedFormula && column.totalsFunction === right[index]?.totalsFunction && column.totalsLabel === right[index]?.totalsLabel && column.totalsFormula === right[index]?.totalsFormula);
 }
 function spreadsheet_table_reconciliation_isRecord(value) {
     return Boolean(value && 'object' == typeof value && !Array.isArray(value));
@@ -9378,7 +9399,8 @@ function createSpreadsheetTableDialogSource(content, target) {
         sheetName: sheet.name,
         value: {
             headerRow: request.headerRow,
-            rangeReference
+            rangeReference,
+            totalsRow: false
         }
     };
 }
@@ -9390,13 +9412,25 @@ function validateSpreadsheetTableRequest(content, request) {
     const sheet = content.sheets.find((candidate)=>candidate.id === request.sheetId);
     if (!sheet) return tableError('sheet-not-found');
     if (sheet.isPivotTable || sheet.pivotTables?.length) return tableError('pivot-table');
-    const range = spreadsheet_cell_range_normalizeSpreadsheetCellRange(request.range);
-    if (!range) return tableError('invalid-range');
+    const bodyRange = spreadsheet_cell_range_normalizeSpreadsheetCellRange(request.range);
+    if (!bodyRange) return tableError('invalid-range');
+    const totalsRow = true === request.totalsRow;
+    const range = totalsRow ? {
+        row: [
+            bodyRange.row[0],
+            bodyRange.row[1] + 1
+        ],
+        column: [
+            ...bodyRange.column
+        ]
+    } : bodyRange;
     const name = request.name.trim();
     if (!validSpreadsheetTableName(name)) return tableError('invalid-name');
     if (spreadsheetTableNameExists(content, name)) return tableError('name-conflict');
     const bounds = spreadsheetSheetBounds(sheet);
-    if (range.row[1] > bounds.lastRow || range.column[1] > bounds.lastColumn) return tableError('out-of-bounds');
+    const configuredRows = Number(sheet.row);
+    const lastAllowedRow = Number.isFinite(configuredRows) && configuredRows > 0 ? bounds.lastRow : Math.max(bounds.lastRow, range.row[1]);
+    if (bodyRange.row[0] > lastAllowedRow || bodyRange.row[1] > lastAllowedRow || bodyRange.column[0] > bounds.lastColumn || bodyRange.column[1] > bounds.lastColumn || range.row[1] >= OFFICE_KERNEL_SPREADSHEET_MAX_ROWS) return tableError('out-of-bounds');
     const height = range.row[1] - range.row[0] + 1;
     if (height <= Number(request.headerRow)) return tableError('invalid-range');
     if (spreadsheet_cell_range_spreadsheetCellRangeArea(range) > 100000) return tableError('range-too-large');
@@ -9415,8 +9449,27 @@ function validateSpreadsheetTableRequest(content, request) {
         number: 2
     };
     if (!validSpreadsheetTableStyle(style)) return tableError('invalid-style');
-    const columns = spreadsheetTableColumnNames(sheet, range, request.headerRow);
+    const columns = spreadsheetTableColumnNames(sheet, bodyRange, request.headerRow);
     if (!columns.length || columns.some((column)=>!validTableColumnName(column))) return tableError('invalid-column-name');
+    const totalsColumns = spreadsheetTableTotalsColumnPatch(columns.map((name)=>({
+            name
+        })), request.totalsColumns);
+    if (!totalsColumns) return tableError('invalid-totals');
+    const candidate = {
+        id: '__validation__',
+        name,
+        range,
+        columns: withDefaultSpreadsheetTableTotalsLabel(totalsColumns, totalsRow),
+        filters: [],
+        headerRow: request.headerRow,
+        totalsRow,
+        style,
+        showFirstColumn: false,
+        showLastColumn: false,
+        showRowStripes: 'none' !== style.family,
+        showColumnStripes: false
+    };
+    if (totalsRow && spreadsheetTableTotalsRowHasContent(sheet, candidate)) return tableError('totals-row-content');
     return {
         columns,
         name,
@@ -9432,16 +9485,19 @@ function applySpreadsheetTable(content, request) {
         family: 'medium',
         number: 2
     };
+    const totalsRow = true === request.totalsRow;
+    const totalsColumns = spreadsheetTableTotalsColumnPatch(validation.columns.map((name)=>({
+            name
+        })), request.totalsColumns);
+    if (!totalsColumns) return null;
     const tableWithoutCalculatedColumns = {
         id: createWorkId('spreadsheet-table'),
         name: validation.name,
         range: cloneRange(validation.range),
-        columns: validation.columns.map((name)=>({
-                name
-            })),
+        columns: withDefaultSpreadsheetTableTotalsLabel(totalsColumns, totalsRow),
         filters: [],
         headerRow: request.headerRow,
-        totalsRow: false,
+        totalsRow,
         style,
         showFirstColumn: false,
         showLastColumn: false,
@@ -9453,10 +9509,14 @@ function applySpreadsheetTable(content, request) {
         columns: reconcileSpreadsheetTableCalculatedColumns(validation.sheet, tableWithoutCalculatedColumns)
     };
     const nextSheet = request.headerRow ? stampSpreadsheetTableHeaders(validation.sheet, validation.range, validation.columns) : validation.sheet;
+    const sizedSheet = ensureSpreadsheetTableRowCapacity(nextSheet, rangeEndRow(table));
+    const synchronizedSheet = synchronizeSpreadsheetTableTotalsRow(sizedSheet, void 0, table, {
+        force: totalsRow
+    });
     return replaceSpreadsheetTableSheet(content, {
-        ...nextSheet,
+        ...synchronizedSheet,
         tables: [
-            ...nextSheet.tables ?? [],
+            ...synchronizedSheet.tables ?? [],
             table
         ]
     });
@@ -9474,20 +9534,46 @@ function updateSpreadsheetTable(content, sheetId, tableId, patch) {
     const showRowStripes = patch.showRowStripes ?? table.showRowStripes;
     const showColumnStripes = patch.showColumnStripes ?? table.showColumnStripes;
     if ('none' === style.family && (showFirstColumn || showLastColumn || showRowStripes || showColumnStripes)) return null;
-    const tables = sheet.tables?.map((candidate)=>candidate.id === tableId ? {
-            ...candidate,
-            name,
-            ...void 0 === patch.name ? {} : {
-                displayName: void 0
-            },
-            style,
-            showFirstColumn,
-            showLastColumn,
-            showRowStripes,
-            showColumnStripes
-        } : candidate);
+    const totalsRow = patch.totalsRow ?? table.totalsRow;
+    const range = cloneRange(table.range);
+    if (totalsRow !== table.totalsRow) range.row[1] += totalsRow ? 1 : -1;
+    if (range.row[0] < 0 || range.row[1] < range.row[0] || range.row[1] >= OFFICE_KERNEL_SPREADSHEET_MAX_ROWS || range.row[1] - range.row[0] + 1 <= Number(table.headerRow) + Number(totalsRow)) return null;
+    const totalsColumns = spreadsheetTableTotalsColumnPatch(table.columns, patch.totalsColumns);
+    if (!totalsColumns) return null;
+    const nextColumns = withDefaultSpreadsheetTableTotalsLabel(totalsColumns, totalsRow);
+    const nextTable = {
+        ...table,
+        name,
+        ...void 0 === patch.name ? {} : {
+            displayName: void 0
+        },
+        range,
+        columns: nextColumns,
+        totalsRow,
+        style,
+        showFirstColumn,
+        showLastColumn,
+        showRowStripes,
+        showColumnStripes
+    };
+    if (totalsRow && !table.totalsRow && spreadsheetTableTotalsRowHasContent(sheet, nextTable)) return null;
+    if (totalsRow && !table.totalsRow) {
+        const totalsGrowthRange = {
+            row: [
+                table.range.row[1] + 1,
+                range.row[1]
+            ],
+            column: [
+                ...range.column
+            ]
+        };
+        if (spreadsheet_cell_range_spreadsheetCellRangeArea(range) > 100000 || spreadsheetTableGrowthConflicts(sheet, tableId, totalsGrowthRange)) return null;
+    }
+    const tables = sheet.tables?.map((candidate)=>candidate.id === tableId ? nextTable : candidate);
+    const sizedSheet = ensureSpreadsheetTableRowCapacity(sheet, rangeEndRow(nextTable));
+    const synchronizedSheet = synchronizeSpreadsheetTableTotalsRow(sizedSheet, table, nextTable);
     return replaceSpreadsheetTableSheet(content, {
-        ...sheet,
+        ...synchronizedSheet,
         tables
     });
 }
@@ -9635,6 +9721,16 @@ function spreadsheetTableIntersectsMerge(sheet, range) {
             ]
         }));
 }
+function spreadsheetTableGrowthConflicts(sheet, tableId, growthRange) {
+    if (spreadsheetTableIntersectsMerge(sheet, growthRange) || (sheet.tables ?? []).some((candidate)=>candidate.id !== tableId && spreadsheetCellRangesIntersect(candidate.range, growthRange)) || !canMutateSpreadsheetCellRanges(sheet, [
+        growthRange
+    ])) return true;
+    const autoFilter = spreadsheet_cell_range_normalizeSpreadsheetCellRange(sheet.filter_select ?? {
+        row: [],
+        column: []
+    });
+    return Boolean(autoFilter && spreadsheetCellRangesIntersect(autoFilter, growthRange));
+}
 function replaceSpreadsheetTableSheet(content, nextSheet) {
     return {
         ...content,
@@ -9675,6 +9771,7 @@ function tableError(code) {
         'invalid-name': '表格名称必须是有效且不类似单元格引用的标识符。',
         'invalid-range': '表格至少需要一行数据。',
         'invalid-style': '表格样式身份无效。',
+        'invalid-totals': '汇总行函数、标签或公式无效。',
         'merged-range': '请先取消表格区域内的合并单元格。',
         'name-conflict': '表格名称已被其他表格或名称使用。',
         'out-of-bounds': '表格区域超出当前工作表边界。',
@@ -9682,7 +9779,8 @@ function tableError(code) {
         'protected-range': '受保护或只读区域不能创建表格。',
         'range-too-large': `一次最多可创建 ${100000..toLocaleString()} 个单元格的表格。`,
         'sheet-not-found': '找不到目标工作表。',
-        'table-overlap': '表格区域不能与其他表格重叠。'
+        'table-overlap': '表格区域不能与其他表格重叠。',
+        'totals-row-content': '汇总行目标单元格已有内容，请先清空后再启用。'
     };
     return {
         code,
@@ -9690,6 +9788,20 @@ function tableError(code) {
         ok: false
     };
 }
+function rangeEndRow(table) {
+    return table.range.row[1];
+}
+function ensureSpreadsheetTableRowCapacity(sheet, lastRow) {
+    if (!Number.isSafeInteger(lastRow) || lastRow < 0) return sheet;
+    const configured = Number(sheet.row);
+    if (!Number.isFinite(configured) || configured <= 0) return sheet;
+    const required = lastRow + 1;
+    if (required <= configured) return sheet;
+    return {
+        ...sheet,
+        row: Math.min(OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, required)
+    };
+}
 function createSpreadsheetTableExtension() {
     return createOfficeEditorExtension({
         name: 'spreadsheetTables',
@@ -9742,7 +9854,8 @@ function updateSpreadsheetTableCommand(context, sheetId, tableId, patch) {
     if (!context.editable) return false;
     const next = updateSpreadsheetTable(context.content, sheetId, tableId, patch);
     if (!next) return false;
-    context.onChange(next);
+    const selection = context.workbook?.getSelection()?.at(-1) ?? (context.selection?.sheetId === sheetId ? context.selection.selection : void 0);
+    context.onChange(spreadsheetContentWithSelection(next, sheetId, selection));
     return true;
 }
 function canConvertSpreadsheetTableToRange(context, sheetId, tableId) {
@@ -13606,6 +13719,16 @@ function SpreadsheetTableDesignRibbon({ can, commands, sheetId, table }) {
                     })
                 ]
             }),
+            /*#__PURE__*/ jsx(WorkOfficeRibbonGroup, {
+                label: "汇总行",
+                priority: "high",
+                children: /*#__PURE__*/ jsx(SpreadsheetTableTotalsMenu, {
+                    can: can,
+                    commands: commands,
+                    sheetId: sheetId,
+                    table: table
+                })
+            }),
             /*#__PURE__*/ jsx(WorkOfficeRibbonGroup, {
                 label: "表格样式",
                 priority: "high",
@@ -13675,6 +13798,225 @@ function SpreadsheetTableDesignRibbon({ can, commands, sheetId, table }) {
         ]
     });
 }
+const totalsFunctionOptions = [
+    {
+        value: 'none',
+        label: '不汇总'
+    },
+    ...SPREADSHEET_TABLE_TOTALS_FUNCTIONS.map((value)=>({
+            value,
+            label: spreadsheetTableTotalsFunctionLabel(value)
+        }))
+];
+function SpreadsheetTableTotalsMenu({ can, commands, sheetId, table }) {
+    const [drafts, setDrafts] = useState({});
+    useEffect(()=>{
+        const next = {};
+        table.columns.forEach((column, offset)=>{
+            next[offset] = {
+                formula: column.totalsFormula ?? '',
+                label: column.totalsLabel ?? ''
+            };
+        });
+        setDrafts(next);
+    }, [
+        table.id,
+        table.columns
+    ]);
+    const patchColumn = (offset, patch)=>{
+        const designPatch = {
+            totalsColumns: {
+                [offset]: patch
+            }
+        };
+        if (!can.updateTable(sheetId, table.id, designPatch) || !commands.updateTable(sheetId, table.id, designPatch)) showToast('汇总行设置无效，请检查函数、标签或公式。', 'error');
+    };
+    const toggleTotalsRow = ()=>{
+        const patch = {
+            totalsRow: !table.totalsRow
+        };
+        if (!can.updateTable(sheetId, table.id, patch) || !commands.updateTable(sheetId, table.id, patch)) showToast(table.totalsRow ? '无法关闭汇总行。' : '汇总行目标区域已有内容，请先清空该行。', 'error');
+    };
+    return /*#__PURE__*/ jsx(Popover, {
+        label: "汇总行",
+        panelLabel: "表格汇总行设置",
+        panelRole: "dialog",
+        portal: true,
+        className: "work-spreadsheet-table-totals-root",
+        panelClassName: "work-spreadsheet-table-totals-menu",
+        placement: "bottom-end",
+        trigger: (triggerProps, { open })=>/*#__PURE__*/ jsxs("button", {
+                ...triggerProps,
+                className: `with-label work-spreadsheet-table-totals-trigger${open || table.totalsRow ? ' active' : ''}`,
+                "aria-pressed": table.totalsRow,
+                title: "设置表格汇总行",
+                children: [
+                    /*#__PURE__*/ jsx(Calculator, {
+                        size: 19
+                    }),
+                    /*#__PURE__*/ jsx("span", {
+                        children: "汇总行"
+                    })
+                ]
+            }),
+        children: (close)=>/*#__PURE__*/ jsxs("div", {
+                className: "work-spreadsheet-table-totals-content",
+                children: [
+                    /*#__PURE__*/ jsx(OfficeCheckbox, {
+                        ariaLabel: "启用汇总行",
+                        checked: table.totalsRow,
+                        disabled: !table.totalsRow && !can.updateTable(sheetId, table.id, {
+                            totalsRow: true
+                        }),
+                        onCheckedChange: ()=>{
+                            toggleTotalsRow();
+                        },
+                        children: "启用汇总行"
+                    }),
+                    /*#__PURE__*/ jsx("p", {
+                        className: "work-spreadsheet-table-totals-hint",
+                        children: "汇总行位于表格末尾，函数会随筛选结果更新。"
+                    }),
+                    /*#__PURE__*/ jsx("div", {
+                        className: "work-spreadsheet-table-totals-columns",
+                        children: table.columns.map((column, offset)=>{
+                            const selected = column.totalsFormula ? 'custom' : column.totalsFunction ?? 'none';
+                            const draft = drafts[offset] ?? {
+                                formula: column.totalsFormula ?? '',
+                                label: column.totalsLabel ?? ''
+                            };
+                            const formulaEnabled = 'custom' === selected;
+                            const labelEnabled = 'none' === selected;
+                            return /*#__PURE__*/ jsxs("div", {
+                                className: "work-spreadsheet-table-totals-column",
+                                children: [
+                                    /*#__PURE__*/ jsx("strong", {
+                                        children: column.name
+                                    }),
+                                    /*#__PURE__*/ jsxs("label", {
+                                        children: [
+                                            /*#__PURE__*/ jsx("span", {
+                                                children: "函数"
+                                            }),
+                                            /*#__PURE__*/ jsx("select", {
+                                                "aria-label": `${column.name} 汇总函数`,
+                                                "data-selected-value": selected,
+                                                disabled: !table.totalsRow,
+                                                value: selected,
+                                                onChange: (event)=>{
+                                                    const value = event.currentTarget.value;
+                                                    if ('none' === value) patchColumn(offset, {
+                                                        totalsFunction: null,
+                                                        totalsFormula: null
+                                                    });
+                                                    else if ('custom' === value) {
+                                                        const formula = draft.formula || `=SUM(${table.name}[${escapeTotalsColumnName(column.name)}])`;
+                                                        setDrafts((current)=>({
+                                                                ...current,
+                                                                [offset]: {
+                                                                    ...draft,
+                                                                    formula
+                                                                }
+                                                            }));
+                                                        patchColumn(offset, {
+                                                            totalsFunction: 'custom',
+                                                            totalsFormula: formula,
+                                                            totalsLabel: null
+                                                        });
+                                                    } else patchColumn(offset, {
+                                                        totalsFunction: value,
+                                                        totalsFormula: null,
+                                                        totalsLabel: null
+                                                    });
+                                                },
+                                                children: totalsFunctionOptions.map((option)=>/*#__PURE__*/ jsx("option", {
+                                                        value: option.value,
+                                                        children: option.label
+                                                    }, option.value))
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ jsxs("label", {
+                                        children: [
+                                            /*#__PURE__*/ jsx("span", {
+                                                children: "标签"
+                                            }),
+                                            /*#__PURE__*/ jsx("input", {
+                                                "aria-label": `${column.name} 汇总标签`,
+                                                disabled: !table.totalsRow || !labelEnabled,
+                                                value: draft.label,
+                                                onChange: (event)=>{
+                                                    const value = event.currentTarget.value;
+                                                    setDrafts((current)=>({
+                                                            ...current,
+                                                            [offset]: {
+                                                                ...draft,
+                                                                label: value
+                                                            }
+                                                        }));
+                                                },
+                                                onBlur: ()=>{
+                                                    if (!labelEnabled) return;
+                                                    patchColumn(offset, {
+                                                        totalsLabel: draft.label.trim() || null
+                                                    });
+                                                },
+                                                onKeyDown: (event)=>{
+                                                    if ('Enter' === event.key) event.currentTarget.blur();
+                                                }
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ jsxs("label", {
+                                        children: [
+                                            /*#__PURE__*/ jsx("span", {
+                                                children: "自定义公式"
+                                            }),
+                                            /*#__PURE__*/ jsx("input", {
+                                                "aria-label": `${column.name} 汇总公式`,
+                                                disabled: !table.totalsRow || !formulaEnabled,
+                                                placeholder: "=SUM(Table[Column])",
+                                                value: draft.formula,
+                                                onChange: (event)=>{
+                                                    const value = event.currentTarget.value;
+                                                    setDrafts((current)=>({
+                                                            ...current,
+                                                            [offset]: {
+                                                                ...draft,
+                                                                formula: value
+                                                            }
+                                                        }));
+                                                },
+                                                onBlur: ()=>{
+                                                    if (!formulaEnabled) return;
+                                                    patchColumn(offset, {
+                                                        totalsFunction: 'custom',
+                                                        totalsFormula: draft.formula.trim() || null
+                                                    });
+                                                },
+                                                onKeyDown: (event)=>{
+                                                    if ('Enter' === event.key) event.currentTarget.blur();
+                                                }
+                                            })
+                                        ]
+                                    })
+                                ]
+                            }, `${table.id}-${offset}`);
+                        })
+                    }),
+                    /*#__PURE__*/ jsx("button", {
+                        type: "button",
+                        className: "work-spreadsheet-table-totals-close",
+                        onClick: close,
+                        children: "完成"
+                    })
+                ]
+            })
+    });
+}
+function escapeTotalsColumnName(value) {
+    return value.replaceAll(']', ']]');
+}
 function SpreadsheetTableNameControl({ can, commands, sheetId, table }) {
     const [name, setName] = useState(table.name);
     useEffect(()=>setName(table.name), [
@@ -25384,6 +25726,15 @@ function SpreadsheetTableDialog({ source, restoreFocusTarget, onApply, onClose,
                                 headerRow
                             })),
                     children: "表包含标题"
+                }),
+                /*#__PURE__*/ jsx(OfficeCheckbox, {
+                    ariaLabel: "启用汇总行",
+                    checked: true === value.totalsRow,
+                    onCheckedChange: (totalsRow)=>setValue((current)=>({
+                                ...current,
+                                totalsRow
+                            })),
+                    children: "启用汇总行"
                 })
             ]
         })
@@ -25471,7 +25822,8 @@ function useSpreadsheetTable({ commandsRef, contentRef, focusGrid, getGridFocusT
                         headerRow: value.headerRow,
                         name: source.name,
                         range,
-                        sheetId: source.sheetId
+                        sheetId: source.sheetId,
+                        totalsRow: true === value.totalsRow
                     }) ?? false;
                     appliedRef.current = handled;
                 } finally{
@@ -25492,7 +25844,8 @@ function spreadsheetTableValidationMessage(content, source, value) {
         headerRow: value.headerRow,
         name: source.name,
         range,
-        sheetId: source.sheetId
+        sheetId: source.sheetId,
+        totalsRow: true === value.totalsRow
     });
 }
 const MAXIMUM_BUFFERED_SPREADSHEET_OPERATIONS = 10001;