@a3s-lab/office 0.35.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, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, applyImportedXlsxRichText, xlsxStyleCollectionIndex, spreadsheetExplicitTextOrientationFromCell, sheetHasXlsxRichTextCells, activeXlsxNativeFill, readXlsxRichTextCells, normalizeSpreadsheetDateValidationBoundary, createXlsxRichTextReadContext, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, writeXlsxRichTextCells, activeXlsxSemanticColorOrigin, xlsxNativeFillSemanticColors, 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";
@@ -2700,9 +2700,27 @@ function parseXlsxTable(document1, partPath) {
     if (!name || !range || !columnsElement) return null;
     const columns = directChildren(columnsElement, 'tableColumn').flatMap((column)=>{
         const columnName = work_ooxml_package_attribute(column, 'name');
-        return null === columnName ? [] : [
+        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
+                name: columnName,
+                ...calculatedFormula ? {
+                    calculatedFormula
+                } : {},
+                ...normalizedTotalsFunction ? {
+                    totalsFunction: normalizedTotalsFunction
+                } : {},
+                ...totalsLabel && !totalsFormula ? {
+                    totalsLabel
+                } : {},
+                ...totalsFormula ? {
+                    totalsFormula
+                } : {}
             }
         ];
     });
@@ -2742,7 +2760,26 @@ function xlsxTableXml(table, tableId, namespace) {
     ]);
     const displayName = table.displayName?.trim() || table.name;
     const filter = table.headerRow ? xlsxTableAutoFilterXml(table.filters, reference, table.totalsRow) : '';
-    const columns = table.columns.map((column, index)=>`<tableColumn id="${index + 1}" name="${work_xlsx_tables_escapeXml(column.name)}"/>`).join('');
+    const columns = table.columns.map((column, index)=>{
+        const formula = normalizeSpreadsheetTableCalculatedFormula(column.calculatedFormula);
+        const formulaElement = formula ? `<calculatedColumnFormula>${work_xlsx_tables_escapeXml(formula.replace(/^=/, ''))}</calculatedColumnFormula>` : '';
+        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)}"/>` : '';
     return [

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

@@ -1,7 +1,7 @@
 import { type Op, type Sheet } from '@fortune-sheet/core';
 import type { OfficeKernelSpreadsheetCalculatedCell, OfficeKernelSpreadsheetCoordinate, OfficeKernelSpreadsheetSessionUpdate } from '../../../kernel/office-kernel-protocol';
-import type { SpreadsheetCalculationCommand } from './spreadsheet-command-controller';
 import { type SpreadsheetKernelFallbackCell, type SpreadsheetKernelWorkbook } from './spreadsheet-calculation-projection';
+import type { SpreadsheetCalculationCommand } from './spreadsheet-command-controller';
 export declare function spreadsheetCalculationTargets(workbook: SpreadsheetKernelWorkbook, command: SpreadsheetCalculationCommand): OfficeKernelSpreadsheetCoordinate[] | undefined;
 export declare function spreadsheetCalculationSessionUpdate(previous: SpreadsheetKernelWorkbook | null, current: SpreadsheetKernelWorkbook, baseDocumentRevision: number, forceReplace?: boolean): OfficeKernelSpreadsheetSessionUpdate;
 export declare function spreadsheetCalculationFallbackCells(workbook: SpreadsheetKernelWorkbook, command: SpreadsheetCalculationCommand, includeDataTables?: boolean): SpreadsheetKernelFallbackCell[];

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

@@ -1,7 +1,10 @@
 import type { Op, Sheet } from '@fortune-sheet/core';
 import type { OfficeKernelSpreadsheetCoordinate, OfficeKernelSpreadsheetInputCell, OfficeKernelSpreadsheetInputSheet, OfficeKernelSpreadsheetSessionCellChange } from '../../../kernel/office-kernel-protocol';
-import type { WorkSpreadsheetContent, WorkSpreadsheetFormulaRangeType, WorkSpreadsheetSheet } from '../work-types';
+import type { WorkSpreadsheetContent, WorkSpreadsheetFormulaRangeType, WorkSpreadsheetSheet, WorkSpreadsheetTable } from '../work-types';
 export declare const SPREADSHEET_KERNEL_MAX_PATCH_CELLS = 10000;
+type SpreadsheetKernelSheet = Sheet & {
+    tables?: WorkSpreadsheetTable[];
+};
 export interface SpreadsheetKernelWorkbook {
     fallbackCells: SpreadsheetKernelFallbackCell[];
     sheets: OfficeKernelSpreadsheetInputSheet[];
@@ -34,7 +37,7 @@ export declare function createSpreadsheetKernelWorkbook(content: Pick<WorkSpread
  * snapshot from the updated controlled content.
  */
 export declare function prepareSpreadsheetKernelWorkbook(content: Pick<WorkSpreadsheetContent, 'sheets'>): SpreadsheetKernelWorkbookPreparation;
-export declare function refreshSpreadsheetKernelWorkbook(sheets: readonly Sheet[], fallbackCells: readonly SpreadsheetKernelFallbackCell[]): SpreadsheetKernelWorkbook | null;
+export declare function refreshSpreadsheetKernelWorkbook(sheets: readonly SpreadsheetKernelSheet[], fallbackCells: readonly SpreadsheetKernelFallbackCell[]): SpreadsheetKernelWorkbook | null;
 export declare function projectSpreadsheetKernelWorkbookOperations(previous: SpreadsheetKernelWorkbook, sheets: readonly WorkSpreadsheetSheet[], operations: readonly Op[]): SpreadsheetKernelOperationProjection | null;
 export declare function spreadsheetOperationsMayChangeCalculation(operations: readonly Op[], workbook?: SpreadsheetKernelWorkbook | null): boolean;
 export declare function spreadsheetKernelCellKey(cell: Pick<OfficeKernelSpreadsheetInputCell, 'row' | 'column'>): string;

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

@@ -0,0 +1,42 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetSheet, WorkSpreadsheetTable, WorkSpreadsheetTableColumn } from '../work-types';
+/** Keep calculated-column metadata small enough to cross every editor boundary. */
+export declare const MAX_SPREADSHEET_TABLE_CALCULATED_FORMULA_LENGTH = 8192;
+/**
+ * Normalizes the editable form of a table-column formula. Native table parts
+ * omit the leading `=`, while cell formulas and the calculation kernel keep
+ * it. Unsafe or external formulas are deliberately not treated as automatic
+ * fill rules.
+ */
+export declare function normalizeSpreadsheetTableCalculatedFormula(value: unknown): string | undefined;
+/**
+ * Finds a shared current-row formula already authored in a table column.
+ * Ordinary one-off A1 formulas are intentionally ignored so inserting a row
+ * cannot unexpectedly overwrite a user's manual exception.
+ */
+export declare function inferredSpreadsheetTableCalculatedFormula(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable, columnOffset: number): string | undefined;
+/**
+ * Reconciles declared calculated-column formulas with formulas authored in the
+ * controlled cell matrix. A conflicting column is made manual instead of
+ * guessing which formula should be copied into a new row.
+ */
+export declare function reconcileSpreadsheetTableCalculatedColumns(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable): WorkSpreadsheetTableColumn[];
+/** Returns true only for a formula safe to copy into a new table row. */
+export declare function isSpreadsheetTableCalculatedFormula(value: unknown): value is string;
+/**
+ * Applies calculated-column formulas to newly inserted body rows. The helper
+ * deliberately edits only empty cells; copied values and authored exceptions
+ * remain authoritative. Both Fortune's dense matrix and sparse `celldata`
+ * storage are updated without materializing unrelated rows or columns.
+ */
+export declare function fillSpreadsheetTableCalculatedColumns(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable, rows: readonly number[]): WorkSpreadsheetSheet;
+export declare function spreadsheetTableCellAt(sheet: WorkSpreadsheetSheet, row: number, column: number): Cell | null;
+export declare function spreadsheetTableCellIsEmpty(cell: Cell | null | undefined): boolean;
+/** Copy visual cell metadata without carrying a stale cached formula result. */
+export declare function spreadsheetCellWithCalculatedFormula(source: Cell | null | undefined, formula: string): Cell;
+/** Iterate formula-bearing cells without forcing a dense worksheet matrix. */
+export declare function spreadsheetTableFormulaCells(sheet: WorkSpreadsheetSheet): Array<{
+    cell: Cell;
+    column: number;
+    row: number;
+}>;

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

@@ -236,7 +236,26 @@ export type WorkSpreadsheetTableStyle = {
 };
 export interface WorkSpreadsheetTableColumn {
     name: string;
-}
+    /**
+     * A bounded native table calculated-column formula. The controlled model
+     * 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-protocol.d.ts

@@ -1,6 +1,6 @@
 import { OFFICE_KERNEL_PROTOCOL_VERSION } from './office-kernel-version';
+export type { OfficeKernelSpreadsheetCalculatedCell, OfficeKernelSpreadsheetCalculationIssue, OfficeKernelSpreadsheetCalculationRequest, OfficeKernelSpreadsheetCalculationResult, OfficeKernelSpreadsheetCoordinate, OfficeKernelSpreadsheetError, OfficeKernelSpreadsheetInputCell, OfficeKernelSpreadsheetInputSheet, OfficeKernelSpreadsheetInputTable, OfficeKernelSpreadsheetSessionCalculationRequest, OfficeKernelSpreadsheetSessionCalculationResult, OfficeKernelSpreadsheetSessionCalculationScope, OfficeKernelSpreadsheetSessionCalculationStats, OfficeKernelSpreadsheetSessionCellChange, OfficeKernelSpreadsheetSessionUpdate, OfficeKernelSpreadsheetValue, } from './office-kernel-spreadsheet-protocol';
 export { OFFICE_KERNEL_PROTOCOL_VERSION };
-export type { OfficeKernelSpreadsheetCalculatedCell, OfficeKernelSpreadsheetCalculationIssue, OfficeKernelSpreadsheetCalculationRequest, OfficeKernelSpreadsheetCalculationResult, OfficeKernelSpreadsheetCoordinate, OfficeKernelSpreadsheetError, OfficeKernelSpreadsheetInputCell, OfficeKernelSpreadsheetInputSheet, OfficeKernelSpreadsheetSessionCalculationRequest, OfficeKernelSpreadsheetSessionCalculationResult, OfficeKernelSpreadsheetSessionCalculationScope, OfficeKernelSpreadsheetSessionCalculationStats, OfficeKernelSpreadsheetSessionCellChange, OfficeKernelSpreadsheetSessionUpdate, OfficeKernelSpreadsheetValue, } from './office-kernel-spreadsheet-protocol';
 import type { OfficeKernelSpreadsheetCalculationRequest, OfficeKernelSpreadsheetCalculationResult, OfficeKernelSpreadsheetSessionCalculationRequest, OfficeKernelSpreadsheetSessionCalculationResult } from './office-kernel-spreadsheet-protocol';
 export type OfficeKernelEngine = 'wasm' | 'javascript';
 export interface OfficeKernelPageMetrics {

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/internal/kernel/office-kernel-spreadsheet-protocol.d.ts

@@ -29,10 +29,28 @@ export interface OfficeKernelSpreadsheetInputCell {
     formula?: string;
     value: OfficeKernelSpreadsheetValue;
 }
+/**
+ * The bounded table metadata needed to resolve native structured references.
+ * Ranges are zero-based and inclusive, matching the controlled workbook
+ * model. Styling, filters, and drawing metadata intentionally stay outside
+ * the calculation kernel.
+ */
+export interface OfficeKernelSpreadsheetInputTable {
+    name: string;
+    displayName?: string;
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+    columns: string[];
+    headerRow: boolean;
+    totalsRow: boolean;
+}
 export interface OfficeKernelSpreadsheetInputSheet {
     id: string;
     name: string;
     cells: OfficeKernelSpreadsheetInputCell[];
+    tables?: OfficeKernelSpreadsheetInputTable[];
 }
 export interface OfficeKernelSpreadsheetCalculationRequest {
     protocol: typeof OFFICE_KERNEL_PROTOCOL_VERSION;

package/dist/internal/kernel/office-kernel-spreadsheet-structured-reference.d.ts

@@ -0,0 +1,48 @@
+import type { OfficeKernelSpreadsheetInputSheet } from './office-kernel-spreadsheet-protocol';
+export interface SpreadsheetStructuredRowSelection {
+    all: boolean;
+    headers: boolean;
+    data: boolean;
+    totals: boolean;
+    current: boolean;
+}
+export interface SpreadsheetStructuredReference {
+    tableName?: string;
+    firstColumn?: string;
+    lastColumn?: string;
+    rows: SpreadsheetStructuredRowSelection;
+}
+export interface SpreadsheetStructuredReferenceArea {
+    sheetId: string;
+    sheetName: string;
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+}
+export type SpreadsheetStructuredReferenceErrorKind = 'invalid' | 'unsupported' | 'missing-table' | 'missing-column';
+export declare class SpreadsheetStructuredReferenceError extends Error {
+    readonly kind: SpreadsheetStructuredReferenceErrorKind;
+    constructor(kind: SpreadsheetStructuredReferenceErrorKind, message: string);
+}
+/** Parse one bounded table-reference token using the OOXML column grammar. */
+export declare function parseSpreadsheetStructuredReference(reference: string): SpreadsheetStructuredReference;
+/**
+ * Catalog the semantic tables in a workbook and resolve references to bounded
+ * zero-based rectangular areas. The catalog deliberately contains no cells;
+ * values remain in the calculation evaluator so dependencies stay observable.
+ */
+export declare class SpreadsheetStructuredReferenceCatalog {
+    readonly sheets: readonly OfficeKernelSpreadsheetInputSheet[];
+    private readonly definitions;
+    private readonly byName;
+    private readonly bySheet;
+    constructor(sheets: readonly OfficeKernelSpreadsheetInputSheet[]);
+    resolve(qualifier: string | undefined, reference: string, currentSheet: OfficeKernelSpreadsheetInputSheet, currentColumn: number, currentRow: number): SpreadsheetStructuredReferenceArea[];
+    private resolveTable;
+    private resolveColumns;
+    private resolveRows;
+    private dataRows;
+}
+/** Expand structured tokens to A1 ranges before invoking the scalar parser. */
+export declare function expandSpreadsheetStructuredReferences(formula: string, catalog: SpreadsheetStructuredReferenceCatalog, currentSheet: OfficeKernelSpreadsheetInputSheet, currentRow: number, currentColumn: number): string;