[IMP] pivots: implement pivot table styles

With this commit, we don't need to manually create a dynamic table
to a pivot to have a style applied. Instead we can add a style in the
pivot definition, and dynamic tables will automatically be created on
the dynamic pivot formulas.

Those new pivot styles are better than traditional tables styles because:
- they are directly linked to the pivot, taking into account the
number of headers, the presence of totals, etc.
- they are automatically added on `=PIVOT()` formulas, without the need to
create a dynamic table first.
- they are more powerful than the old table styles, they can have a
style for the sub-headers, the measure headers, etc.

Task: 4552232

Author: hokolomopo

packages/o-spreadsheet-engine/src/constants.ts

@@ -250,7 +250,7 @@ export const NEWLINE = "\n";
 export const FONT_SIZES: number[] = [6, 7, 8, 9, 10, 11, 12, 14, 18, 24, 36];
 
 // Pivot
-export const PIVOT_TABLE_CONFIG = {
+export const PIVOT_STATIC_TABLE_CONFIG = {
   hasFilters: false,
   totalRow: false,
   firstColumn: true,
@@ -261,6 +261,7 @@ export const PIVOT_TABLE_CONFIG = {
   styleId: "TableStyleMedium5",
   automaticAutofill: false,
 };
+export const PIVOT_INSERT_TABLE_STYLE_ID = "PivotTableStyleMedium12";
 export const PIVOT_INDENT = 15;
 export const PIVOT_COLLAPSE_ICON_SIZE = 12;
 export const PIVOT_MAX_NUMBER_OF_CELLS = 1e5;

packages/o-spreadsheet-engine/src/functions/module_lookup.ts

@@ -957,15 +957,14 @@ export const PIVOT = {
       headerRows++;
     }
     const pivotTitle = this.getters.getPivotName(pivotId);
-    const tableHeight = Math.min(headerRows + pivotStyle.numberOfRows, cells[0].length);
-    if (tableHeight === 0) {
+    const { numberOfCols, numberOfRows } = table.getPivotTableDimensions(pivotStyle);
+    if (numberOfRows === 0) {
       return [[{ value: pivotTitle }]];
     }
-    const tableWidth = Math.min(1 + pivotStyle.numberOfColumns, cells.length);
     const result: Matrix<FunctionResultObject> = [];
-    for (const col of range(0, tableWidth)) {
+    for (const col of range(0, numberOfCols)) {
       result[col] = [];
-      for (const row of range(0, tableHeight)) {
+      for (const row of range(0, numberOfRows)) {
         const pivotCell = cells[col][row];
         switch (pivotCell.type) {
           case "EMPTY":

packages/o-spreadsheet-engine/src/helpers/pivot/pivot_helpers.ts

@@ -40,6 +40,10 @@ export const DEFAULT_PIVOT_STYLE: Required<PivotStyle> = {
   displayMeasuresRow: true,
   numberOfRows: Number.MAX_VALUE,
   numberOfColumns: Number.MAX_VALUE,
+  tableStyleId: "None",
+  bandedRows: false,
+  bandedColumns: false,
+  hasFilters: false,
 };
 
 const AGGREGATOR_NAMES = {
@@ -489,5 +493,15 @@ export function getPivotStyleFromFnArgs(
       ? toBoolean(includeMeasuresRowArg)
       : style?.displayMeasuresRow ?? DEFAULT_PIVOT_STYLE.displayMeasuresRow;
 
-  return { numberOfRows, numberOfColumns, displayTotals, displayColumnHeaders, displayMeasuresRow };
+  return {
+    numberOfRows,
+    numberOfColumns,
+    displayTotals,
+    displayColumnHeaders,
+    displayMeasuresRow,
+    tableStyleId: style?.tableStyleId || DEFAULT_PIVOT_STYLE.tableStyleId,
+    bandedRows: style?.bandedRows ?? DEFAULT_PIVOT_STYLE.bandedRows,
+    bandedColumns: style?.bandedColumns ?? DEFAULT_PIVOT_STYLE.bandedColumns,
+    hasFilters: style?.hasFilters ?? DEFAULT_PIVOT_STYLE.hasFilters,
+  };
 }

packages/o-spreadsheet-engine/src/helpers/pivot/table_spreadsheet_pivot.ts

@@ -418,6 +418,27 @@ export class SpreadsheetPivotTable {
     }
     return this.rows.filter((row) => row.indent === depth + 1).map((row) => this.getDomain(row));
   }
+
+  getPivotTableDimensions(pivotStyle: Required<PivotStyle>) {
+    const cells = this.getPivotCells(pivotStyle);
+    let headerRows = 0;
+    if (pivotStyle.displayColumnHeaders) {
+      headerRows = this.columns.length - 1;
+    }
+    if (pivotStyle.displayMeasuresRow) {
+      headerRows++;
+    }
+
+    return {
+      numberOfCols: Math.min(1 + pivotStyle.numberOfColumns, cells.length),
+      numberOfRows: Math.min(headerRows + pivotStyle.numberOfRows, cells[0].length),
+      headerRows,
+    };
+  }
+
+  getNumberOfRowGroupBys() {
+    return Math.max(...this.rows.map((row) => row.fields.length));
+  }
 }
 
 export const EMPTY_PIVOT_CELL = { type: "EMPTY" } as const;