@a3s-lab/office 0.36.0 → 0.37.0

package/dist/core.js

@@ -5,7 +5,7 @@ import { OFFICE_COLLABORATION_PROTOCOL as WORK_OFFICE_COLLABORATION_PROTOCOL, Of
 import { directChildren, OoxmlPackage as work_ooxml_package_OoxmlPackage, parseXml, firstDescendant, directChild, descendants, createArtifact as createWorkArtifact, xmlContainsAnyElement, createOfficeId as createWorkId, attribute as work_ooxml_package_attribute } from "./4121.js";
 import { fileNameWithoutExtension, work_file_download_downloadBlob, mountWorkLiveDocumentCapture, importWorkDocumentFile, moveWorkSourceBlob, materializeWorkDocumentContent as work_document_model_codec_materializeWorkDocumentContent, createWorkDocumentModel, work_file_download_safeFileName, documentPageSurfaceGeometryForElement, registerSourceBlob as rememberWorkSourceBlob, documentModelForContent, readSourceBlob as readWorkSourceBlob, createWorkDocumentExtensions, positionWorkLiveDocumentCapture, createWorkDocumentBlob } from "./4174.js";
 import { normalizeSpreadsheetPrintTitleRows, sparseMatrixColumnCount, normalizeSpreadsheetPrintArea, parseSpreadsheetPrintTitles, isValidSpreadsheetDefinedName, formatSpreadsheetCellRanges, stripSpreadsheetSheetQualifier, editableSpreadsheetFormula, sparseArrayEntries, qualifySpreadsheetRange, refreshSpreadsheetPivotTables, parseSpreadsheetCellRanges, normalizeSpreadsheetPrintTitleColumns } from "./8715.js";
-import { xlsxColorMatches, xlsxRichTextCellText, spreadsheetCellValueWithDiagonalBorder, xlsxRichTextStyleOrigins, normalizeSpreadsheetDataValidationErrorStyle, directXlsxAlignment, applyImportedXlsxRichText, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, xlsxStyleCollectionIndex, spreadsheetExplicitTextOrientationFromCell, sheetHasXlsxRichTextCells, activeXlsxNativeFill, readXlsxRichTextCells, normalizeSpreadsheetDateValidationBoundary, createXlsxRichTextReadContext, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, writeXlsxRichTextCells, activeXlsxSemanticColorOrigin, xlsxNativeFillSemanticColors, normalizeSpreadsheetTableCalculatedFormula, spreadsheetUnderlineCellValueFromSheetJs } from "./3266.js";
+import { xlsxColorMatches, xlsxRichTextCellText, spreadsheetCellValueWithDiagonalBorder, xlsxRichTextStyleOrigins, normalizeSpreadsheetDataValidationErrorStyle, directXlsxAlignment, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, applyImportedXlsxRichText, xlsxStyleCollectionIndex, sheetHasXlsxRichTextCells, spreadsheetExplicitTextOrientationFromCell, activeXlsxNativeFill, readXlsxRichTextCells, normalizeSpreadsheetDateValidationBoundary, createXlsxRichTextReadContext, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, normalizeSpreadsheetTableTotalsLabel, activeXlsxSemanticColorOrigin, writeXlsxRichTextCells, xlsxNativeFillSemanticColors, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, spreadsheetUnderlineCellValueFromSheetJs } from "./3266.js";
 import { freezeImportedSpreadsheetCell, readXlsxGradientFill, withXlsxPatternFill, xlsxCellStyleOriginSemanticColors, setXlsxToggleChild, withXlsxCellStyleOrigin, normalizeSpreadsheetConditionalVisualOptions, xlsxColorElementMatchesOrigin, withXlsxGradientFill, ensureXlsxStyleCollection, xlsxCellStyleOrigin, xlsxSemanticColorOriginKey, readXlsxPatternFill, isSpreadsheetConditionalComparisonOperator, registerImportedSpreadsheetMatrix, defaultSpreadsheetConditionalIconThresholds, readXlsxSemanticColorOrigin, setXlsxUnderlineChild, xlsxGradientFillFallbackColor, setXlsxColorChild, createXlsxColorResolver, resolveXlsxColor, setXlsxBorderLine, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, defaultXlsxBorder, prepareXlsxSemanticPalette, importedSheetProtectionAuthority, defaultSpreadsheetColorScaleThresholds, xlsxRgbColor, writeXlsxAlignment, xlsxGradientFillKey, applyXlsxSemanticColorOrigin, spreadsheetConditionalComparisonNeedsUpperValue, sheetHasProtectionState, xlsxWorksheetCellEntries, isSpreadsheetConditionalIconSetName, setXlsxValueChild, defaultXlsxFill, spreadsheetConditionalThresholdsEqual, spreadsheetConditionalIconSetCount } from "./9333.js";
 import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, readXlsxWorksheetCharts, createXlsxFormulaCell, patchXlsxWorksheetDrawings, readXlsxWorksheetImages, writeXlsxProtection, xlsxWorksheetChartsToSheet, readXlsxFormulaFeaturesFromPackage, emptySpreadsheetWorksheetCompatibilitySummary, createSpreadsheetFormulaMetadata, createXlsxErrorCell, xlsxWorksheetImagesToSheet, readXlsxProtection, patchXlsxFormulaFeatures, patchXlsxPivotTables, writeXlsxPageSetup, XlsxCellProtectionWriter, applyImportedXlsxPivotTables, readXlsxPageSetup } from "./4166.js";
 import { WorkFileImportController, materializeWorkFileSource } from "./9356.js";
@@ -2702,11 +2702,24 @@ function parseXlsxTable(document1, partPath) {
         const columnName = work_ooxml_package_attribute(column, 'name');
         if (null === columnName) return [];
         const calculatedFormula = normalizeSpreadsheetTableCalculatedFormula(directChild(column, 'calculatedColumnFormula')?.textContent);
+        const totalsFunction = spreadsheetTableTotalsFunctionFromOoxml(work_ooxml_package_attribute(column, 'totalsRowFunction'));
+        const totalsLabel = normalizeSpreadsheetTableTotalsLabel(work_ooxml_package_attribute(column, 'totalsRowLabel'));
+        const totalsFormula = normalizeSpreadsheetTableTotalsFormula(directChild(column, 'totalsRowFormula')?.textContent);
+        const normalizedTotalsFunction = totalsFormula ? 'custom' : totalsFunction;
         return [
             {
                 name: columnName,
                 ...calculatedFormula ? {
                     calculatedFormula
+                } : {},
+                ...normalizedTotalsFunction ? {
+                    totalsFunction: normalizedTotalsFunction
+                } : {},
+                ...totalsLabel && !totalsFormula ? {
+                    totalsLabel
+                } : {},
+                ...totalsFormula ? {
+                    totalsFormula
                 } : {}
             }
         ];
@@ -2750,8 +2763,22 @@ function xlsxTableXml(table, tableId, namespace) {
     const columns = table.columns.map((column, index)=>{
         const formula = normalizeSpreadsheetTableCalculatedFormula(column.calculatedFormula);
         const formulaElement = formula ? `<calculatedColumnFormula>${work_xlsx_tables_escapeXml(formula.replace(/^=/, ''))}</calculatedColumnFormula>` : '';
-        const opening = `<tableColumn id="${index + 1}" name="${work_xlsx_tables_escapeXml(column.name)}"`;
-        return formulaElement ? `${opening}>${formulaElement}</tableColumn>` : `${opening}/>`;
+        const totalsFunction = spreadsheetTableTotalsFunctionToOoxml(column.totalsFunction);
+        const totalsLabel = normalizeSpreadsheetTableTotalsLabel(column.totalsLabel);
+        const totalsFormula = normalizeSpreadsheetTableTotalsFormula(column.totalsFormula);
+        const attributes = [
+            `id="${index + 1}"`,
+            `name="${work_xlsx_tables_escapeXml(column.name)}"`,
+            ...totalsFunction ? [
+                `totalsRowFunction="${work_xlsx_tables_escapeXml(totalsFunction)}"`
+            ] : [],
+            ...totalsLabel && !totalsFormula ? [
+                `totalsRowLabel="${work_xlsx_tables_escapeXml(totalsLabel)}"`
+            ] : []
+        ].join(' ');
+        const totalsFormulaElement = totalsFormula ? `<totalsRowFormula>${work_xlsx_tables_escapeXml(totalsFormula.replace(/^=/, ''))}</totalsRowFormula>` : '';
+        const children = `${formulaElement}${totalsFormulaElement}`;
+        return children ? `<tableColumn ${attributes}>${children}</tableColumn>` : `<tableColumn ${attributes}/>`;
     }).join('');
     const styleName = tableStyleName(table.style);
     const style = styleName ? `<tableStyleInfo name="${styleName}" showColumnStripes="${booleanToken(table.showColumnStripes)}" showFirstColumn="${booleanToken(table.showFirstColumn)}" showLastColumn="${booleanToken(table.showLastColumn)}" showRowStripes="${booleanToken(table.showRowStripes)}"/>` : '';

package/dist/internal/features/work/editors/spreadsheet-table-totals.d.ts

@@ -0,0 +1,39 @@
+import type { WorkSpreadsheetSheet, WorkSpreadsheetTable, WorkSpreadsheetTableColumn, WorkSpreadsheetTableTotalsFunction } from '../work-types';
+export declare const MAX_SPREADSHEET_TABLE_TOTALS_FORMULA_LENGTH = 8192;
+export declare const MAX_SPREADSHEET_TABLE_TOTALS_LABEL_LENGTH = 255;
+export declare const DEFAULT_SPREADSHEET_TABLE_TOTALS_LABEL = "Total";
+/** The closed function set exposed by the Table Design totals menu. */
+export declare const SPREADSHEET_TABLE_TOTALS_FUNCTIONS: readonly ["sum", "average", "count", "countNums", "max", "min", "stdDev", "stdDevP", "var", "varP", "custom"];
+export interface SpreadsheetTableTotalsColumnPatch {
+    totalsFormula?: string | null;
+    totalsFunction?: WorkSpreadsheetTableTotalsFunction | null;
+    totalsLabel?: string | null;
+}
+export declare function spreadsheetTableTotalsFunctionLabel(value: WorkSpreadsheetTableTotalsFunction | undefined): string;
+export declare function normalizeSpreadsheetTableTotalsFunction(value: unknown): WorkSpreadsheetTableTotalsFunction | undefined;
+/** Normalize a table totals formula to the editable leading-equals form. */
+export declare function normalizeSpreadsheetTableTotalsFormula(value: unknown): string | undefined;
+export declare function normalizeSpreadsheetTableTotalsLabel(value: unknown): string | undefined;
+export declare function spreadsheetTableTotalsFunctionFromOoxml(value: unknown): WorkSpreadsheetTableTotalsFunction | undefined;
+export declare function spreadsheetTableTotalsFunctionToOoxml(value: WorkSpreadsheetTableTotalsFunction | undefined): string | undefined;
+/**
+ * Returns the formula that should be placed in one totals-row cell. Native
+ * aggregate functions use SUBTOTAL so filtered-out rows stay excluded; a
+ * custom rule uses its explicit formula.
+ */
+export declare function spreadsheetTableTotalsFormula(table: WorkSpreadsheetTable, columnOffset: number): string | undefined;
+export declare function spreadsheetTableTotalsColumnPatch(columns: readonly WorkSpreadsheetTableColumn[], patches: Readonly<Record<string, SpreadsheetTableTotalsColumnPatch>> | readonly (SpreadsheetTableTotalsColumnPatch | null | undefined)[] | undefined): WorkSpreadsheetTableColumn[] | null;
+/** Apply the native default label used when a totals row is first enabled. */
+export declare function withDefaultSpreadsheetTableTotalsLabel(columns: readonly WorkSpreadsheetTableColumn[], totalsRow: boolean): WorkSpreadsheetTableColumn[];
+/** True when a proposed totals row would overwrite a populated cell. */
+export declare function spreadsheetTableTotalsRowHasContent(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable, row?: number): boolean;
+/**
+ * Synchronize totals-row cells after a table metadata change. Explicitly
+ * changed column metadata owns the target cell; untouched manual cells remain
+ * authoritative. The helper works with Fortune's dense and sparse forms.
+ */
+export declare function synchronizeSpreadsheetTableTotalsRow(sheet: WorkSpreadsheetSheet, previousTable: WorkSpreadsheetTable | undefined, nextTable: WorkSpreadsheetTable, options?: {
+    force?: boolean;
+}): WorkSpreadsheetSheet;
+/** Reconcile metadata after a user edits a totals-row cell directly. */
+export declare function reconcileSpreadsheetTableTotalsColumns(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable, editedOffsets?: ReadonlySet<number>): WorkSpreadsheetTableColumn[];

package/dist/internal/features/work/editors/spreadsheet-table.d.ts

@@ -1,6 +1,7 @@
 import type { Selection } from '@fortune-sheet/core';
 import type { WorkSpreadsheetContent, WorkSpreadsheetSheet, WorkSpreadsheetTable, WorkSpreadsheetTableStyle } from '../work-types';
 import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+import { type SpreadsheetTableTotalsColumnPatch } from './spreadsheet-table-totals';
 export { MAX_SPREADSHEET_TABLE_CELLS } from './spreadsheet-table-limits';
 export interface SpreadsheetTableTarget {
     sheetId: string;
@@ -9,6 +10,7 @@ export interface SpreadsheetTableTarget {
 export interface SpreadsheetTableDialogValue {
     headerRow: boolean;
     rangeReference: string;
+    totalsRow?: boolean;
 }
 export interface SpreadsheetTableDialogSource {
     name: string;
@@ -24,6 +26,10 @@ export interface SpreadsheetTableRequest {
     range: SpreadsheetCellRange;
     sheetId: string;
     style?: WorkSpreadsheetTableStyle;
+    /** Create the table with a native totals row appended to the range. */
+    totalsRow?: boolean;
+    /** Initial per-column totals metadata, keyed by zero-based table offset. */
+    totalsColumns?: Readonly<Record<string, SpreadsheetTableTotalsColumnPatch>> | readonly (SpreadsheetTableTotalsColumnPatch | null | undefined)[];
 }
 export type SpreadsheetTableValidation = {
     columns: string[];
@@ -36,7 +42,7 @@ export type SpreadsheetTableValidation = {
     message: string;
     ok: false;
 };
-export type SpreadsheetTableErrorCode = 'auto-filter-overlap' | 'invalid-column-name' | 'invalid-name' | 'invalid-range' | 'invalid-style' | 'merged-range' | 'name-conflict' | 'out-of-bounds' | 'protected-range' | 'pivot-table' | 'range-too-large' | 'sheet-not-found' | 'table-overlap';
+export type SpreadsheetTableErrorCode = 'auto-filter-overlap' | 'invalid-column-name' | 'invalid-name' | 'invalid-range' | 'invalid-style' | 'invalid-totals' | 'merged-range' | 'name-conflict' | 'out-of-bounds' | 'protected-range' | 'pivot-table' | 'range-too-large' | 'sheet-not-found' | 'table-overlap' | 'totals-row-content';
 export interface SpreadsheetTableDesignPatch {
     name?: string;
     showColumnStripes?: boolean;
@@ -44,6 +50,10 @@ export interface SpreadsheetTableDesignPatch {
     showLastColumn?: boolean;
     showRowStripes?: boolean;
     style?: WorkSpreadsheetTableStyle;
+    /** Toggle the native totals row. Enabling appends one row to the table. */
+    totalsRow?: boolean;
+    /** Update per-column totals function, label, or custom formula. */
+    totalsColumns?: Readonly<Record<string, SpreadsheetTableTotalsColumnPatch>> | readonly (SpreadsheetTableTotalsColumnPatch | null | undefined)[];
 }
 export declare function createSpreadsheetTableDialogSource(content: WorkSpreadsheetContent, target: SpreadsheetTableTarget): SpreadsheetTableDialogSource | null;
 export declare function spreadsheetTableRangeFromText(value: string): SpreadsheetCellRange | null;

package/dist/internal/features/work/work-types.d.ts

@@ -241,7 +241,21 @@ export interface WorkSpreadsheetTableColumn {
      * stores the editable form with a leading `=`; XLSX table parts omit it.
      */
     calculatedFormula?: string;
+    /**
+     * Native totals-row aggregation. An omitted value means that the totals
+     * cell is not owned by the table. The controlled model uses camelCase names
+     * while XLSX table parts use their OOXML spellings.
+     */
+    totalsFunction?: WorkSpreadsheetTableTotalsFunction;
+    /** Optional text label rendered in this column's totals-row cell. */
+    totalsLabel?: string;
+    /**
+     * A bounded custom totals-row formula. The controlled model stores the
+     * editable form with a leading `=`; XLSX table parts omit it.
+     */
+    totalsFormula?: string;
 }
+export type WorkSpreadsheetTableTotalsFunction = 'sum' | 'average' | 'count' | 'countNums' | 'max' | 'min' | 'stdDev' | 'stdDevP' | 'var' | 'varP' | 'custom';
 export type WorkSpreadsheetDynamicFilter = 'above-average' | 'below-average' | 'tomorrow' | 'today' | 'yesterday' | 'next-week' | 'this-week' | 'last-week' | 'next-month' | 'this-month' | 'last-month' | 'next-quarter' | 'this-quarter' | 'last-quarter' | 'next-year' | 'this-year' | 'last-year' | 'year-to-date' | 'quarter-1' | 'quarter-2' | 'quarter-3' | 'quarter-4' | 'month-1' | 'month-2' | 'month-3' | 'month-4' | 'month-5' | 'month-6' | 'month-7' | 'month-8' | 'month-9' | 'month-10' | 'month-11' | 'month-12';
 export type WorkSpreadsheetTableFilterCriteria = {
     type: 'values';

package/dist/internal/kernel/office-kernel-spreadsheet-fallback-formula.d.ts

@@ -1,3 +1,14 @@
 export declare const browserScalarFunctionArities: Map<string, readonly [minimum: number, maximum: number]>;
 export declare function normalizeSpreadsheetFunctionName(name: string): string;
+/**
+ * Evaluate the bounded browser implementation of `SUBTOTAL`.
+ *
+ * Fortune delegates unknown functions to Formula.js. Formula.js returns an
+ * undefined value for an unknown function number, which the parser can then
+ * coerce into a boolean. Keeping this small implementation here makes the
+ * JavaScript fallback deterministic and aligned with the Rust kernel. The
+ * calculation request does not carry hidden-row metadata yet, so the 1–11
+ * and 101–111 function-number families intentionally have the same result.
+ */
+export declare function evaluateParserSubtotal(parameters: readonly unknown[]): unknown;
 export declare function normalizeFormulaForFortuneParser(formula: string): string;

package/dist/office-kernel.worker.js

@@ -13727,6 +13727,13 @@
                     1
                 ]
             ],
+            [
+                'SUBTOTAL',
+                [
+                    2,
+                    255
+                ]
+            ],
             [
                 'SUM',
                 [
@@ -13747,6 +13754,90 @@
             while(normalized.startsWith('_XLFN.') || normalized.startsWith('_XLWS.'))normalized = normalized.slice(6);
             return normalized;
         }
+        function evaluateParserSubtotal(parameters) {
+            const codeValue = parserNumericValue(parameters[0]);
+            if (void 0 === codeValue) return 'VALUE!';
+            const code = Math.trunc(codeValue);
+            const values = parameters.slice(1).flatMap((parameter)=>flattenParserValues(parameter));
+            for (const value of values){
+                const error = parserErrorValue(value);
+                if (error) return error;
+            }
+            switch(code){
+                case 1:
+                case 101:
+                    return parserSubtotalNumeric(values, 'average');
+                case 2:
+                case 102:
+                    return values.filter((value)=>'number' == typeof value).length;
+                case 3:
+                case 103:
+                    return values.filter((value)=>null != value).length;
+                case 4:
+                case 104:
+                    return parserSubtotalNumeric(values, 'max');
+                case 5:
+                case 105:
+                    return parserSubtotalNumeric(values, 'min');
+                case 6:
+                case 106:
+                    return parserSubtotalNumeric(values, 'product');
+                case 7:
+                case 107:
+                    return parserSubtotalNumeric(values, 'stddev');
+                case 8:
+                case 108:
+                    return parserSubtotalNumeric(values, 'stddevp');
+                case 9:
+                case 109:
+                    return parserSubtotalNumeric(values, 'sum');
+                case 10:
+                case 110:
+                    return parserSubtotalNumeric(values, 'var');
+                case 11:
+                case 111:
+                    return parserSubtotalNumeric(values, 'varp');
+                default:
+                    return 'VALUE!';
+            }
+        }
+        function parserSubtotalNumeric(values, operation) {
+            const numbers = values.filter((value)=>'number' == typeof value && Number.isFinite(value));
+            const count = numbers.length;
+            const sum = numbers.reduce((total, value)=>total + value, 0);
+            if ('sum' === operation) return finiteParserNumber(sum);
+            if ('average' === operation) return count ? finiteParserNumber(sum / count) : 'DIV/0!';
+            if ('max' === operation) return finiteParserNumber(Math.max(...numbers, 0));
+            if ('min' === operation) return finiteParserNumber(Math.min(...numbers, 0));
+            if ('product' === operation) return finiteParserNumber(count ? numbers.reduce((total, value)=>total * value, 1) : 0);
+            if ('stddev' === operation || 'var' === operation) {
+                if (count < 2) return 'DIV/0!';
+            } else if (0 === count) return 'DIV/0!';
+            const mean = sum / count;
+            const divisor = 'stddev' === operation || 'var' === operation ? count - 1 : count;
+            const variance = numbers.reduce((total, value)=>total + (value - mean) ** 2, 0) / divisor;
+            return finiteParserNumber('stddev' === operation || 'stddevp' === operation ? Math.sqrt(variance) : variance);
+        }
+        function flattenParserValues(value) {
+            if (!Array.isArray(value)) return [
+                value
+            ];
+            return value.flatMap((entry)=>flattenParserValues(entry));
+        }
+        function parserNumericValue(value) {
+            if ('number' == typeof value) return Number.isFinite(value) ? value : void 0;
+            if ('boolean' == typeof value) return value ? 1 : 0;
+            if ('string' != typeof value || !value.trim()) return;
+            const parsed = Number(value);
+            return Number.isFinite(parsed) ? parsed : void 0;
+        }
+        function parserErrorValue(value) {
+            if (value instanceof Error) return value.message.startsWith('#') ? value.message.slice(1) : 'VALUE!';
+            return 'string' == typeof value && value.startsWith('#') ? value.slice(1) : void 0;
+        }
+        function finiteParserNumber(value) {
+            return Number.isFinite(value) ? value : 'NUM!';
+        }
         function normalizeFormulaForFortuneParser(formula) {
             const source = formula.replace(/^=/, '');
             let output = '';
@@ -14608,10 +14699,11 @@
                 let unsupportedFunction;
                 let materializedRangeCells = 0;
                 parser.setFunction('IFERROR', evaluateParserIfError).setFunction('ROW', (parameters)=>parameters.length ? null : coordinate.row + 1).setFunction('COLUMN', (parameters)=>parameters.length ? null : coordinate.column + 1);
-                parser.on('callFunction', (name, parameters)=>{
+                parser.on('callFunction', (name, parameters, done)=>{
                     const normalized = normalizeSpreadsheetFunctionName(name);
                     const arity = browserScalarFunctionArities.get(normalized);
                     if (!arity || parameters.length < arity[0] || parameters.length > arity[1]) unsupportedFunction ??= name.toUpperCase();
+                    if ('SUBTOTAL' === normalized) done(evaluateParserSubtotal(parameters));
                 });
                 parser.on('callCellValue', (cell, _options, done)=>{
                     const dependency = this.resolveCoordinate(indexed.sheet, cell);

package/dist/styles.css

@@ -18364,6 +18364,113 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   min-width: 76px;
 }
 
+.work-spreadsheet-table-totals-root {
+  display: flex;
+}
+
+.work-office-ribbon .work-spreadsheet-table-totals-trigger {
+  min-width: 70px;
+}
+
+.work-spreadsheet-table-totals-menu {
+  border: 1px solid var(--a3s-overlay-border);
+  border-radius: var(--a3s-overlay-radius);
+  background: var(--a3s-overlay-surface);
+  width: min(560px, 100vw - 24px);
+  max-height: min(650px, 100vh - 32px);
+  box-shadow: var(--a3s-shadow-soft);
+  padding: 14px;
+  overflow: auto;
+}
+
+.work-spreadsheet-table-totals-content {
+  gap: 10px;
+  display: grid;
+}
+
+.work-spreadsheet-table-totals-hint {
+  color: var(--a3s-muted);
+  margin: -4px 0 2px;
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.work-spreadsheet-table-totals-columns {
+  gap: 8px;
+  max-height: 440px;
+  padding-right: 2px;
+  display: grid;
+  overflow: auto;
+}
+
+.work-spreadsheet-table-totals-column {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel-soft);
+  border-radius: 7px;
+  grid-template-columns: minmax(92px, 1fr) minmax(100px, 1fr) minmax(100px, 1fr);
+  align-items: end;
+  gap: 7px;
+  padding: 9px;
+  display: grid;
+}
+
+.work-spreadsheet-table-totals-column > strong {
+  color: var(--a3s-ink);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  grid-column: 1 / -1;
+  font-size: 11px;
+  font-weight: 650;
+  overflow: hidden;
+}
+
+.work-spreadsheet-table-totals-column label {
+  gap: 3px;
+  min-width: 0;
+  display: grid;
+}
+
+.work-spreadsheet-table-totals-column label > span {
+  color: var(--a3s-muted);
+  font-size: 9px;
+  line-height: 1;
+}
+
+.work-spreadsheet-table-totals-column select, .work-spreadsheet-table-totals-column input {
+  box-sizing: border-box;
+  border: 1px solid var(--a3s-line-strong);
+  background: var(--a3s-panel);
+  width: 100%;
+  min-width: 0;
+  height: 28px;
+  color: var(--a3s-ink);
+  border-radius: 5px;
+  padding: 0 7px;
+  font-size: 11px;
+}
+
+.work-spreadsheet-table-totals-column select:disabled, .work-spreadsheet-table-totals-column input:disabled {
+  cursor: not-allowed;
+  opacity: .55;
+}
+
+.work-spreadsheet-table-totals-close {
+  border: 1px solid var(--work-spreadsheet-accent, #159469);
+  background: var(--work-spreadsheet-accent, #159469);
+  color: #fff;
+  cursor: pointer;
+  border-radius: 5px;
+  justify-self: end;
+  min-height: 29px;
+  padding: 0 13px;
+  font-size: 11px;
+  font-weight: 650;
+}
+
+.work-spreadsheet-table-totals-close:hover, .work-spreadsheet-table-totals-close:focus-visible {
+  filter: brightness(.94);
+}
+
 .work-spreadsheet-table-style-preview {
   background: #fff;
   border: 1px solid #0f172a29;
@@ -18455,6 +18562,19 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
     padding: 8px;
   }
 
+  .work-spreadsheet-table-totals-menu {
+    width: min(440px, 100vw - 16px);
+    padding: 10px;
+  }
+
+  .work-spreadsheet-table-totals-column {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  .work-spreadsheet-table-totals-column label:last-child {
+    grid-column: 1 / -1;
+  }
+
   .work-spreadsheet-table-style-family > div {
     grid-template-columns: repeat(5, minmax(0, 1fr));
   }

package/docs/latest/en/browser-editor-architecture.md

@@ -1430,8 +1430,14 @@ formulas authored on data rows and totals/header/data selectors. A consistent
 current-row rule is persisted in the table metadata and fills only empty cells
 in newly inserted body rows; manual values and conflicting formulas fail closed.
 Dense and sparse sheet representations use the same path, and native XLSX
-`<calculatedColumnFormula>` metadata round-trips. Complete totals-row
-authoring, slicers, and external/query tables remain open gates.
+`<calculatedColumnFormula>` metadata round-trips. Native totals-row authoring
+now extends the same model: Table Design controls the row and each column's
+label, aggregate, or custom formula; native aggregates map to filter-aware
+`SUBTOTAL` codes; generated cells are reconciled after direct edits, row/column
+changes, and table renames; and `totalsRowFunction`, `totalsRowLabel`, and
+`totalsRowFormula` survive XLSX and Yjs round trips. Occupied, merged,
+protected, overlapping, AutoFilter, unsafe, external, and over-budget targets
+fail closed. Slicers and external/query tables remain open gates.
 
 Exit criteria: scrolling and selection do not scale with total row count;
 incremental recalculation touches only affected dependency subgraphs; XLSX

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -114,6 +114,7 @@
     "playground:visual:spreadsheet-rich-text": "playwright test visual-tests/spreadsheet-rich-text.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-underline": "playwright test visual-tests/spreadsheet-underline.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-table": "playwright test visual-tests/spreadsheet-table.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-table-totals": "playwright test visual-tests/spreadsheet-table-totals.functional.spec.ts --config playwright.config.ts",
     "playground:visual:presentation-animation": "playwright test visual-tests/presentation-animation.functional.spec.ts --config playwright.config.ts",
     "playground:visual:pdf-page-organization": "playwright test visual-tests/pdf-page-organization.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
@@ -178,6 +179,8 @@
     "test:e2e:spreadsheet-underline-styles:check": "a3s-test check tests/e2e/spreadsheet-underline-styles.acl --json",
     "test:e2e:spreadsheet-table": "a3s-test run tests/e2e/spreadsheet-table.acl --json",
     "test:e2e:spreadsheet-table:check": "a3s-test check tests/e2e/spreadsheet-table.acl --json",
+    "test:e2e:spreadsheet-table-totals": "a3s-test run tests/e2e/spreadsheet-table-totals.acl --json",
+    "test:e2e:spreadsheet-table-totals:check": "a3s-test check tests/e2e/spreadsheet-table-totals.acl --json",
     "test:e2e:spreadsheet-cell-fill": "a3s-test run tests/e2e/spreadsheet-cell-fill.acl --json",
     "test:e2e:spreadsheet-cell-fill:check": "a3s-test check tests/e2e/spreadsheet-cell-fill.acl --json",
     "test:e2e:spreadsheet-auto-sum": "a3s-test run tests/e2e/spreadsheet-auto-sum.acl --json",