@a3s-lab/office 0.35.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 { spreadsheetTextOrientationFromChoice, isSpreadsheetTextOrientationId, xlsxRichTextCellText, spreadsheetTextOrientationFromAngle, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, normalizeSpreadsheetDataValidationErrorStyle, normalizeXlsxRichTextEditSource, normalizeXlsxRichTextColor, isHighSurrogate, xlsxNativeFillCellKeys, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, boundedSpreadsheetDataValidationText, normalizeSpreadsheetDateValidationBoundary, normalizeXlsxRichTextCell, activeXlsxNativeFill, spreadsheetUnderlineStyle, deleteXlsxNativeFills, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, normalizeXlsxRichTextRun, spreadsheetDiagonalBorderFromCellValue, sameXlsxRichTextRunStyle, isLowSurrogate, spreadsheetTextOrientationFromCell, coalesceXlsxRichTextRuns, patchSpreadsheetRichTextFontRuns, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, validXlsxRichText, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, 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";
@@ -3769,12 +3769,23 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
         const sheetOperations = operations.filter((operation)=>operation.id === source.id);
         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);
             if (structure) {
+                transformCalculatedColumnRows(calculatedColumnRows, structure);
                 const transformed = [];
                 for (const table of tables){
+                    if ('row' === structure.axis && 'insert' === structure.kind) {
+                        const insertedRows = rowsInsertedIntoSpreadsheetTableBody(table, structure);
+                        if (insertedRows.length) {
+                            const rows = calculatedColumnRows.get(table.id) ?? new Set();
+                            for (const row of insertedRows)rows.add(row);
+                            calculatedColumnRows.set(table.id, rows);
+                        }
+                    }
                     const next = transformSpreadsheetTableStructure(table, structure);
                     if (next) {
                         transformed.push(next);
@@ -3786,15 +3797,33 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
             }
             const coordinate = spreadsheetCellCoordinateFromOperation(operation);
             if (!coordinate) continue;
-            const table = tables.find((candidate)=>candidate.headerRow && candidate.range.row[0] === coordinate.row && coordinate.column >= candidate.range.column[0] && coordinate.column <= candidate.range.column[1]);
-            if (table) reconcileColumns.add(table.id);
+            const table = tables.find((candidate)=>spreadsheetTableContainsCell(candidate, coordinate.row, coordinate.column));
+            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);
         tables = tables.map((table)=>{
             if (!reconcileColumns.has(table.id)) return table;
             const columns = canonicalSpreadsheetTableColumns(table, readCell);
-            if (table.headerRow) for (const [offset, column] of columns.entries()){
+            const calculatedColumns = reconcileSpreadsheetTableCalculatedColumns(sheet, {
+                ...table,
+                columns
+            });
+            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,
@@ -3802,14 +3831,26 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
                     row: table.range.row[0]
                 });
             }
-            return sameSpreadsheetTableColumns(table.columns, columns) ? table : {
+            return sameSpreadsheetTableColumns(table.columns, reconciledColumns) ? table : {
                 ...table,
-                columns
+                columns: reconciledColumns
             };
         });
-        const withHeaders = stampSpreadsheetTableHeaderCells(sheet, updates);
+        let withCalculatedColumns = sheet;
+        for (const table of tables){
+            const rows = calculatedColumnRows.get(table.id);
+            if (rows?.size) withCalculatedColumns = fillSpreadsheetTableCalculatedColumns(withCalculatedColumns, table, [
+                ...rows
+            ]);
+        }
+        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
         };
     });
@@ -3870,6 +3911,39 @@ function transformSpreadsheetTableStructure(table, change) {
         filters: filtersAfterSpreadsheetTableColumnDeletion(table.filters, transformed.offset, removed)
     };
 }
+function spreadsheetTableContainsCell(table, row, column) {
+    return row >= table.range.row[0] && row <= table.range.row[1] && column >= table.range.column[0] && column <= table.range.column[1];
+}
+function rowsInsertedIntoSpreadsheetTableBody(table, change) {
+    if ('row' !== change.axis) return [];
+    const transformed = transformSpreadsheetTableAxisForInsertion(table.range.row, change);
+    if (!transformed.inside) return [];
+    const insertion = change.index + ('rightbottom' === change.direction ? 1 : 0);
+    const bodyStart = table.range.row[0] + Number(table.headerRow);
+    if (insertion < bodyStart) return [];
+    return Array.from({
+        length: change.count
+    }, (_, offset)=>insertion + offset);
+}
+function transformCalculatedColumnRows(rowsByTable, change) {
+    if ('row' !== change.axis || !rowsByTable.size) return;
+    if ('insert' === change.kind) {
+        const insertion = change.index + ('rightbottom' === change.direction ? 1 : 0);
+        for (const [tableId, rows] of rowsByTable){
+            const next = new Set();
+            for (const row of rows)next.add(row >= insertion ? row + change.count : row);
+            rowsByTable.set(tableId, next);
+        }
+        return;
+    }
+    const count = change.end - change.start + 1;
+    for (const [tableId, rows] of rowsByTable){
+        const next = new Set();
+        for (const row of rows)if (row < change.start) next.add(row);
+        else if (row > change.end) next.add(row - count);
+        rowsByTable.set(tableId, next);
+    }
+}
 function transformSpreadsheetTableAxisForInsertion(axis, change) {
     const start = axis[0] ?? 0;
     const end = axis[1] ?? start;
@@ -3967,6 +4041,7 @@ function canonicalSpreadsheetTableColumns(table, readCell) {
         }
         observed.add(candidate.toLocaleLowerCase());
         return {
+            ...table.columns[offset] ?? {},
             name: candidate
         };
     });
@@ -4092,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);
+    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));
@@ -9324,7 +9399,8 @@ function createSpreadsheetTableDialogSource(content, target) {
         sheetName: sheet.name,
         value: {
             headerRow: request.headerRow,
-            rangeReference
+            rangeReference,
+            totalsRow: false
         }
     };
 }
@@ -9336,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');
@@ -9361,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,
@@ -9378,27 +9485,38 @@ function applySpreadsheetTable(content, request) {
         family: 'medium',
         number: 2
     };
-    const table = {
+    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,
         showRowStripes: 'none' !== style.family,
         showColumnStripes: false
     };
+    const table = {
+        ...tableWithoutCalculatedColumns,
+        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
         ]
     });
@@ -9416,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
     });
 }
@@ -9577,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,
@@ -9617,6 +9771,7 @@ function tableError(code) {
         'invalid-name': '表格名称必须是有效且不类似单元格引用的标识符。',
         'invalid-range': '表格至少需要一行数据。',
         'invalid-style': '表格样式身份无效。',
+        'invalid-totals': '汇总行函数、标签或公式无效。',
         'merged-range': '请先取消表格区域内的合并单元格。',
         'name-conflict': '表格名称已被其他表格或名称使用。',
         'out-of-bounds': '表格区域超出当前工作表边界。',
@@ -9624,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,
@@ -9632,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',
@@ -9684,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) {
@@ -10444,9 +10615,9 @@ function createSpreadsheetFormulaDiagnostics(content, { summary, locations }) {
     });
     if (summary.structuredReferenceCells) diagnostics.push({
         code: 'formula.structured-references',
-        severity: 'warning',
+        severity: 'info',
         title: '结构化引用',
-        message: `${summary.structuredReferenceCells} 个公式使用表格结构化引用；公式会原样保存，但当前计算引擎不解析 Excel 表对象。`,
+        message: `${summary.structuredReferenceCells} 个公式使用表格结构化引用；浏览器内核支持有界表名、显示名称、连续列范围以及常见标题、数据、汇总和当前行选择。不连续、外部或高级形式会保留公式与缓存值，交由兼容应用重算。`,
         locations: locations.structured
     });
     if (summary.unsupportedFunctions.length) diagnostics.push({
@@ -13548,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",
@@ -13617,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), [
@@ -21908,10 +22308,15 @@ function compileSpreadsheetKernelWorkbook(sheets, fallbackCells = []) {
         cellCount += cells.length;
         sheetIds.add(id);
         sheetNames.add(normalizedName);
+        const tables = spreadsheetKernelTables(sheet.tables);
+        if (null === tables) return null;
         sourceSheets.push({
             id,
             name,
-            cells
+            cells,
+            ...tables.length ? {
+                tables
+            } : {}
         });
     }
     const compiled = sourceSheets.map((sheet)=>({
@@ -21954,7 +22359,8 @@ function spreadsheetKernelSourceState(sheets) {
         sourceCells,
         structureKey: JSON.stringify(sheets.map((sheet)=>({
                 id: sheet.id,
-                name: sheet.name
+                name: sheet.name,
+                tables: sheet.tables ?? []
             })))
     };
 }
@@ -21972,7 +22378,18 @@ function spreadsheetStructureKey(sheets) {
         names.add(normalizedName);
         structure.push({
             id,
-            name
+            name,
+            tables: (sheet.tables ?? []).map((table)=>({
+                    name: table.name,
+                    displayName: table.displayName,
+                    startRow: table.range.row[0],
+                    endRow: table.range.row[1],
+                    startColumn: table.range.column[0],
+                    endColumn: table.range.column[1],
+                    columns: table.columns.map((column)=>column.name),
+                    headerRow: table.headerRow,
+                    totalsRow: table.totalsRow
+                }))
         });
     }
     return JSON.stringify(structure);
@@ -22055,6 +22472,49 @@ function spreadsheetKernelInputCell(cell, fallback) {
     const { formula: _formula, ...cachedCell } = cell;
     return cachedCell;
 }
+function spreadsheetKernelTables(tables) {
+    if (!tables?.length) return [];
+    const names = new Map();
+    const ranges = [];
+    for (const [tableIndex, table] of tables.entries()){
+        const [startRow, endRow] = table.range.row;
+        const [startColumn, endColumn] = table.range.column;
+        if (!table.name?.trim() || utf8ByteLength(table.name) > SPREADSHEET_KERNEL_MAX_IDENTIFIER_BYTES || void 0 !== table.displayName && (!table.displayName.trim() || utf8ByteLength(table.displayName) > SPREADSHEET_KERNEL_MAX_IDENTIFIER_BYTES) || !isSpreadsheetCoordinateIndex(startRow, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS) || !isSpreadsheetCoordinateIndex(endRow, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS) || !isSpreadsheetCoordinateIndex(startColumn, 16384) || !isSpreadsheetCoordinateIndex(endColumn, 16384) || startRow > endRow || startColumn > endColumn || table.columns.length !== endColumn - startColumn + 1) return null;
+        for (const alias of [
+            table.name,
+            table.displayName
+        ]){
+            if (!alias) continue;
+            const normalized = alias.toLocaleLowerCase();
+            const previous = names.get(normalized);
+            if (void 0 !== previous && previous !== tableIndex) return null;
+            names.set(normalized, tableIndex);
+        }
+        const columnNames = new Set();
+        for (const column of table.columns){
+            if (!column.name?.trim() || utf8ByteLength(column.name) > SPREADSHEET_KERNEL_MAX_IDENTIFIER_BYTES) return null;
+            const normalized = column.name.toLocaleLowerCase();
+            if (columnNames.has(normalized)) return null;
+            columnNames.add(normalized);
+        }
+        const next = {
+            name: table.name,
+            ...table.displayName ? {
+                displayName: table.displayName
+            } : {},
+            startRow,
+            endRow,
+            startColumn,
+            endColumn,
+            columns: table.columns.map((column)=>column.name),
+            headerRow: Boolean(table.headerRow),
+            totalsRow: Boolean(table.totalsRow)
+        };
+        if (ranges.some((previous)=>next.startRow <= previous.endRow && next.endRow >= previous.startRow && next.startColumn <= previous.endColumn && next.endColumn >= previous.startColumn)) return null;
+        ranges.push(next);
+    }
+    return ranges;
+}
 function spreadsheetSheetsWithKernelChanges(sheets, changes) {
     const changesBySheet = new Map();
     for (const change of changes.values()){
@@ -22313,7 +22773,7 @@ function spreadsheetCalculationOps(sheets, calculatedCells) {
     });
 }
 function sameSpreadsheetStructure(previous, current) {
-    return previous.length === current.length && previous.every((sheet, index)=>sheet.id === current[index]?.id && sheet.name === current[index]?.name);
+    return previous.length === current.length && previous.every((sheet, index)=>sheet.id === current[index]?.id && sheet.name === current[index]?.name && JSON.stringify(sheet.tables ?? []) === JSON.stringify(current[index]?.tables ?? []));
 }
 function cellWithCalculatedValue(cell, value) {
     const next = {
@@ -25266,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: "启用汇总行"
                 })
             ]
         })
@@ -25353,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{
@@ -25374,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;