@univerjs-pro/sheets-pivot 1.1.0 → 1.3.0

package/lib/locale/zh-HK.js

@@ -1 +1 @@
-function _0x1759(_0x31c1d4,_0x473f1d){_0x31c1d4=_0x31c1d4-0x65;const _0x7b53ac=_0x7b53();let _0x1759e5=_0x7b53ac[_0x31c1d4];return _0x1759e5;}const _0x26ea74=_0x1759;function _0x7b53(){const _0x18603e=['{0}-{1}-{2}','（空白）','計數項：','母體標準差項：','最小值項：','{0}','{0}\x20{1}','年-季','小時-分鐘','5101yPdzdw','標準差項：','{0}-{1}','6785680QPCbWk','Q{0}','年-月','10654380chYfmd','變異數項：','最大值項：','2943000ccjJie','1274634nNQDcq','12DSIqsV','總和項：','1500114GRUAWt','（其他）','806516XHPIqa','平均值項：','506tETooE','列標籤','{0}-Q{1}'];_0x7b53=function(){return _0x18603e;};return _0x7b53();}(function(_0x38edc5,_0x104d7c){const _0x327d77=_0x1759,_0xfb4c7f=_0x38edc5();while(!![]){try{const _0x7e64d1=parseInt(_0x327d77(0x76))/0x1*(parseInt(_0x327d77(0x6a))/0x2)+-parseInt(_0x327d77(0x81))/0x3*(parseInt(_0x327d77(0x68))/0x4)+-parseInt(_0x327d77(0x79))/0x5+-parseInt(_0x327d77(0x80))/0x6+parseInt(_0x327d77(0x66))/0x7+parseInt(_0x327d77(0x7f))/0x8+parseInt(_0x327d77(0x7c))/0x9;if(_0x7e64d1===_0x104d7c)break;else _0xfb4c7f['push'](_0xfb4c7f['shift']());}catch(_0xbf830){_0xfb4c7f['push'](_0xfb4c7f['shift']());}}}(_0x7b53,0xa620b));const e={'sheets-pivot':{'sheet':'工作表','blankValue':_0x26ea74(0x6e),'otherValue':_0x26ea74(0x67),'columnName':'欄\x20','subTotalText':'小計','grandTotalText':'總計','valueText':'值','rowLabels':_0x26ea74(0x6b),'columnLabels':'欄標籤','averageName':_0x26ea74(0x69),'countName':_0x26ea74(0x6f),'countNumsName':'數值計數項：','maxName':_0x26ea74(0x7e),'minName':_0x26ea74(0x71),'productName':'乘積項：','stdDevName':_0x26ea74(0x77),'stdDevpName':_0x26ea74(0x70),'sumName':_0x26ea74(0x65),'varName':_0x26ea74(0x7d),'varpName':'母體變異數項：','subTotal':'小計','grandTotal':'總計','value':'值','blank':'空白','other':'其他','renderText':{'valueField':'{0}{1}','subtotal':'{0}\x20{1}','grandTotal':_0x26ea74(0x73),'multipleGrandTotal':_0x26ea74(0x72),'subtotalWithValue':_0x26ea74(0x73)},'emptyPivot':{'filter':'篩選','row':'列','column':'欄','values':'值'},'dateGroup':{'year':'年','month':'月','day':'日','date':'日','hour':'小時','minute':'分鐘','hourMinute':_0x26ea74(0x75),'quarter':'季','monthDate':'月-日','yearQuarter':_0x26ea74(0x74),'yearMonth':_0x26ea74(0x7b),'yearMonthDate':'年-月-日'},'cellDateGroupDisplay':{'minute':'{0}','hour':_0x26ea74(0x72),'hourMinute':'{0}:{1}','date':_0x26ea74(0x72),'month':_0x26ea74(0x72),'monthDate':_0x26ea74(0x78),'quarter':_0x26ea74(0x7a),'year':_0x26ea74(0x72),'yearMonth':_0x26ea74(0x78),'yearMonthDate':_0x26ea74(0x6d),'yearQuarter':_0x26ea74(0x6c)}}};export{e as default};
+function _0x3d67(_0x4b438e,_0x506c61){_0x4b438e=_0x4b438e-0x16b;const _0x14cee2=_0x14ce();let _0x3d67ba=_0x14cee2[_0x4b438e];return _0x3d67ba;}const _0x397f8b=_0x3d67;(function(_0x590b1f,_0x5c2fc8){const _0x148a98=_0x3d67,_0x2f58a5=_0x590b1f();while(!![]){try{const _0x684d58=-parseInt(_0x148a98(0x18b))/0x1*(parseInt(_0x148a98(0x18c))/0x2)+-parseInt(_0x148a98(0x17a))/0x3*(parseInt(_0x148a98(0x16b))/0x4)+parseInt(_0x148a98(0x177))/0x5+-parseInt(_0x148a98(0x184))/0x6+-parseInt(_0x148a98(0x188))/0x7+-parseInt(_0x148a98(0x170))/0x8+parseInt(_0x148a98(0x16e))/0x9*(parseInt(_0x148a98(0x18a))/0xa);if(_0x684d58===_0x5c2fc8)break;else _0x2f58a5['push'](_0x2f58a5['shift']());}catch(_0x1890af){_0x2f58a5['push'](_0x2f58a5['shift']());}}}(_0x14ce,0xacbf1));const e={'sheets-pivot':{'sheet':'工作表','blankValue':_0x397f8b(0x178),'otherValue':'（其他）','columnName':'欄\x20','subTotalText':'小計','grandTotalText':'總計','valueText':'值','rowLabels':'列標籤','columnLabels':_0x397f8b(0x16d),'averageName':'平均值項：','countName':_0x397f8b(0x179),'countNumsName':_0x397f8b(0x16f),'maxName':_0x397f8b(0x17e),'minName':'最小值項：','productName':'乘積項：','stdDevName':'標準差項：','stdDevpName':_0x397f8b(0x171),'sumName':_0x397f8b(0x174),'varName':'變異數項：','varpName':_0x397f8b(0x17d),'subTotal':'小計','grandTotal':'總計','value':'值','blank':'空白','other':'其他','renderText':{'valueField':_0x397f8b(0x16c),'subtotal':'{0}\x20{1}','grandTotal':_0x397f8b(0x172),'multipleGrandTotal':_0x397f8b(0x182),'subtotalWithValue':_0x397f8b(0x172)},'emptyPivot':{'filter':'篩選','row':'列','column':'欄','values':'值'},'dateGroup':{'second':'秒','year':'年','month':'月','day':'日','date':'日','hour':'小時','minute':'分鐘','hourMinute':_0x397f8b(0x189),'quarter':'季','monthDate':_0x397f8b(0x175),'yearQuarter':'年-季','yearMonth':_0x397f8b(0x17f),'yearMonthDate':_0x397f8b(0x181)},'numberGroupRange':_0x397f8b(0x185),'numberGroupClosedRange':_0x397f8b(0x183),'numberGroupBefore':_0x397f8b(0x173),'numberGroupAfter':_0x397f8b(0x176),'cellDateGroupDisplay':{'second':_0x397f8b(0x182),'before':'之前','after':'之後','dayRange':_0x397f8b(0x180),'minute':_0x397f8b(0x182),'hour':_0x397f8b(0x182),'hourMinute':_0x397f8b(0x17b),'date':_0x397f8b(0x182),'month':_0x397f8b(0x182),'monthDate':_0x397f8b(0x17c),'quarter':'Q{0}','year':_0x397f8b(0x182),'yearMonth':'{0}-{1}','yearMonthDate':_0x397f8b(0x187),'yearQuarter':_0x397f8b(0x186)}}};function _0x14ce(){const _0x46718b=['年-月','{0}\x20–\x20{1}','年-月-日','{0}','{0}\x20–\x20≤{1}','6882798qDmQvf','{0}\x20–\x20<{1}','{0}-Q{1}','{0}-{1}-{2}','2453598pygNQF','小時-分鐘','10420lPpwEa','3rKZufc','713798zgBUZq','37788JZnQOp','{0}{1}','欄標籤','25938mKIMCu','數值計數項：','1918368EfYSjF','母體標準差項：','{0}\x20{1}','<{0}','總和項：','月-日','>{0}','5255720IFwkXD','（空白）','計數項：','171AQtzio','{0}:{1}','{0}-{1}','母體變異數項：','最大值項：'];_0x14ce=function(){return _0x46718b;};return _0x14ce();}export{e as default};

package/lib/locale/zh-TW.js

@@ -1 +1 @@
-function _0x21cd(){const _0x14f504=['{0}\x20{1}','271516vxcSxJ','3oLnrNw','列標籤','768620grWGtI','33QExNXv','總和項：','{0}','（空白）','1122669gvItgj','{0}-Q{1}','（其他）','工作表','786180dbZNGr','數值計數項：','7Cwuxce','最大值項：','平均值項：','年-季','20dTccue','欄標籤','年-月','Q{0}','3359632LMxUUL','{0}{1}','435159evXBlz','計數項：','變異數項：','{0}-{1}','{0}:{1}','小時-分鐘','484130yFSIQX','乘積項：'];_0x21cd=function(){return _0x14f504;};return _0x21cd();}const _0x222f70=_0x4dc4;function _0x4dc4(_0x37b4de,_0x1d5bd4){_0x37b4de=_0x37b4de-0x159;const _0x21cdc1=_0x21cd();let _0x4dc4d8=_0x21cdc1[_0x37b4de];return _0x4dc4d8;}(function(_0x1706fb,_0x3e9849){const _0x2059b8=_0x4dc4,_0x229b41=_0x1706fb();while(!![]){try{const _0x15dfbc=-parseInt(_0x2059b8(0x170))/0x1+-parseInt(_0x2059b8(0x179))/0x2+-parseInt(_0x2059b8(0x159))/0x3*(-parseInt(_0x2059b8(0x15b))/0x4)+-parseInt(_0x2059b8(0x16a))/0x5*(-parseInt(_0x2059b8(0x164))/0x6)+-parseInt(_0x2059b8(0x166))/0x7*(-parseInt(_0x2059b8(0x16e))/0x8)+-parseInt(_0x2059b8(0x160))/0x9+parseInt(_0x2059b8(0x176))/0xa*(-parseInt(_0x2059b8(0x15c))/0xb);if(_0x15dfbc===_0x3e9849)break;else _0x229b41['push'](_0x229b41['shift']());}catch(_0xe40732){_0x229b41['push'](_0x229b41['shift']());}}}(_0x21cd,0x481a4));const e={'sheets-pivot':{'sheet':_0x222f70(0x163),'blankValue':_0x222f70(0x15f),'otherValue':_0x222f70(0x162),'columnName':'欄\x20','subTotalText':'小計','grandTotalText':'總計','valueText':'值','rowLabels':_0x222f70(0x15a),'columnLabels':_0x222f70(0x16b),'averageName':_0x222f70(0x168),'countName':_0x222f70(0x171),'countNumsName':_0x222f70(0x165),'maxName':_0x222f70(0x167),'minName':'最小值項：','productName':_0x222f70(0x177),'stdDevName':'標準差項：','stdDevpName':'母體標準差項：','sumName':_0x222f70(0x15d),'varName':_0x222f70(0x172),'varpName':'母體變異數項：','subTotal':'小計','grandTotal':'總計','value':'值','blank':'空白','other':'其他','renderText':{'valueField':_0x222f70(0x16f),'subtotal':_0x222f70(0x178),'grandTotal':_0x222f70(0x178),'multipleGrandTotal':_0x222f70(0x15e),'subtotalWithValue':'{0}\x20{1}'},'emptyPivot':{'filter':'篩選','row':'列','column':'欄','values':'值'},'dateGroup':{'year':'年','month':'月','day':'日','date':'日','hour':'小時','minute':'分鐘','hourMinute':_0x222f70(0x175),'quarter':'季','monthDate':'月-日','yearQuarter':_0x222f70(0x169),'yearMonth':_0x222f70(0x16c),'yearMonthDate':'年-月-日'},'cellDateGroupDisplay':{'minute':_0x222f70(0x15e),'hour':_0x222f70(0x15e),'hourMinute':_0x222f70(0x174),'date':'{0}','month':'{0}','monthDate':_0x222f70(0x173),'quarter':_0x222f70(0x16d),'year':_0x222f70(0x15e),'yearMonth':_0x222f70(0x173),'yearMonthDate':'{0}-{1}-{2}','yearQuarter':_0x222f70(0x161)}}};export{e as default};
+const _0x2e0ea1=_0xaa21;(function(_0x4f9d90,_0x33b24c){const _0x5b37e8=_0xaa21,_0x3192a4=_0x4f9d90();while(!![]){try{const _0x5e0482=-parseInt(_0x5b37e8(0x199))/0x1*(-parseInt(_0x5b37e8(0x181))/0x2)+-parseInt(_0x5b37e8(0x196))/0x3+parseInt(_0x5b37e8(0x193))/0x4*(parseInt(_0x5b37e8(0x188))/0x5)+-parseInt(_0x5b37e8(0x177))/0x6*(-parseInt(_0x5b37e8(0x186))/0x7)+parseInt(_0x5b37e8(0x18d))/0x8+parseInt(_0x5b37e8(0x197))/0x9*(-parseInt(_0x5b37e8(0x17e))/0xa)+parseInt(_0x5b37e8(0x180))/0xb*(parseInt(_0x5b37e8(0x194))/0xc);if(_0x5e0482===_0x33b24c)break;else _0x3192a4['push'](_0x3192a4['shift']());}catch(_0x2fe6b2){_0x3192a4['push'](_0x3192a4['shift']());}}}(_0x3d1e,0x417dc));const e={'sheets-pivot':{'sheet':_0x2e0ea1(0x183),'blankValue':_0x2e0ea1(0x182),'otherValue':_0x2e0ea1(0x19b),'columnName':'欄\x20','subTotalText':'小計','grandTotalText':'總計','valueText':'值','rowLabels':_0x2e0ea1(0x185),'columnLabels':_0x2e0ea1(0x178),'averageName':'平均值項：','countName':'計數項：','countNumsName':_0x2e0ea1(0x18c),'maxName':'最大值項：','minName':'最小值項：','productName':_0x2e0ea1(0x18b),'stdDevName':_0x2e0ea1(0x198),'stdDevpName':_0x2e0ea1(0x192),'sumName':_0x2e0ea1(0x190),'varName':_0x2e0ea1(0x17a),'varpName':'母體變異數項：','subTotal':'小計','grandTotal':'總計','value':'值','blank':'空白','other':'其他','renderText':{'valueField':'{0}{1}','subtotal':_0x2e0ea1(0x18e),'grandTotal':_0x2e0ea1(0x18e),'multipleGrandTotal':'{0}','subtotalWithValue':_0x2e0ea1(0x18e)},'emptyPivot':{'filter':'篩選','row':'列','column':'欄','values':'值'},'dateGroup':{'second':'秒','year':'年','month':'月','day':'日','date':'日','hour':'小時','minute':'分鐘','hourMinute':_0x2e0ea1(0x195),'quarter':'季','monthDate':_0x2e0ea1(0x17f),'yearQuarter':_0x2e0ea1(0x189),'yearMonth':_0x2e0ea1(0x18a),'yearMonthDate':_0x2e0ea1(0x179)},'numberGroupRange':_0x2e0ea1(0x187),'numberGroupClosedRange':_0x2e0ea1(0x17b),'numberGroupBefore':_0x2e0ea1(0x19a),'numberGroupAfter':_0x2e0ea1(0x17c),'cellDateGroupDisplay':{'second':'{0}','before':'之前','after':'之後','dayRange':_0x2e0ea1(0x184),'minute':'{0}','hour':_0x2e0ea1(0x176),'hourMinute':_0x2e0ea1(0x191),'date':'{0}','month':_0x2e0ea1(0x176),'monthDate':_0x2e0ea1(0x17d),'quarter':_0x2e0ea1(0x18f),'year':'{0}','yearMonth':_0x2e0ea1(0x17d),'yearMonthDate':'{0}-{1}-{2}','yearQuarter':'{0}-Q{1}'}}};function _0xaa21(_0x4d80a2,_0x273295){_0x4d80a2=_0x4d80a2-0x176;const _0x3d1e82=_0x3d1e();let _0xaa2126=_0x3d1e82[_0x4d80a2];return _0xaa2126;}function _0x3d1e(){const _0x275aa0=['{0}\x20{1}','Q{0}','總和項：','{0}:{1}','母體標準差項：','340ipqotX','108EaafDl','小時-分鐘','1102383rtPuNt','4692078godNtp','標準差項：','8725yjKDkN','<{0}','（其他）','{0}','6WNIOWW','欄標籤','年-月-日','變異數項：','{0}\x20–\x20≤{1}','>{0}','{0}-{1}','10uAIiDi','月-日','148126revKiF','82wVFfAw','（空白）','工作表','{0}\x20–\x20{1}','列標籤','536627CiQqTD','{0}\x20–\x20<{1}','28645QtQOrS','年-季','年-月','乘積項：','數值計數項：','916080LKFvYi'];_0x3d1e=function(){return _0x275aa0;};return _0x3d1e();}export{e as default};

package/lib/types/commands/command/group-command-util.d.ts

@@ -0,0 +1,12 @@
+import type { IFieldsCollectionJSON } from '@univerjs-pro/engine-pivot';
+import type { IAccessor } from '@univerjs/core';
+import type { IPivotDisplayBaseInfo, IPivotTableConfig } from '../../const/type';
+interface IGroupCommandContext {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+    currentConfig: IPivotTableConfig;
+    currentCollection: IFieldsCollectionJSON;
+}
+export declare function applyPivotGroupPreview(accessor: IAccessor, context: IGroupCommandContext, preview: IPivotDisplayBaseInfo): Promise<boolean>;
+export {};

package/lib/types/commands/command/set-pivot-excel-date-group.command.d.ts

@@ -0,0 +1,10 @@
+import type { IExcelDateGrouping } from '@univerjs-pro/engine-pivot';
+import type { ICommand } from '@univerjs/core';
+export interface ISetPivotExcelDateGroupCommandParams {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+    tableFieldId: string;
+    grouping: IExcelDateGrouping;
+}
+export declare const SetPivotExcelDateGroupCommand: ICommand<ISetPivotExcelDateGroupCommandParams>;

package/lib/types/commands/command/set-pivot-filter.command.d.ts

@@ -20,6 +20,8 @@ export interface ISetPivotFilterCommandParams {
      * @property {string[]} items  The items to set the filter. Those items will be checked in the pivot table.
      */
     items: string[];
+    /** Aggregate Pivot items that contain both selected and unselected typed source values. */
+    partialItems?: string[];
     /**
      * @property {boolean} isAll  The flag to set all items. True means all items, false means only the items in the items array.
      */

package/lib/types/commands/command/set-pivot-manual-groups.command.d.ts

@@ -0,0 +1,10 @@
+import type { IManualGroup } from '@univerjs-pro/engine-pivot';
+import type { ICommand } from '@univerjs/core';
+export interface ISetPivotManualGroupsCommandParams {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+    sourceFieldId: string;
+    groups: IManualGroup[];
+}
+export declare const SetPivotManualGroupsCommand: ICommand<ISetPivotManualGroupsCommandParams>;

package/lib/types/commands/command/set-pivot-number-group.command.d.ts

@@ -0,0 +1,10 @@
+import type { INumberGrouping } from '@univerjs-pro/engine-pivot';
+import type { ICommand } from '@univerjs/core';
+export interface ISetPivotNumberGroupCommandParams {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+    tableFieldId: string;
+    grouping: INumberGrouping;
+}
+export declare const SetPivotNumberGroupCommand: ICommand<ISetPivotNumberGroupCommandParams>;

package/lib/types/commands/command/util.d.ts

@@ -1,6 +1,12 @@
 import type { IPivotTableChangeSet } from '@univerjs-pro/engine-pivot';
-import type { IAccessor, ICommandService, IMutationInfo } from '@univerjs/core';
+import type { IAccessor, ICommandInfo, ICommandService, IMutationInfo } from '@univerjs/core';
 import type { IPivotPerformCheckParams } from '../../const/type';
+export interface IMutationPairGroup {
+    redos: ICommandInfo[];
+    undos: ICommandInfo[];
+    reverse: boolean;
+}
+export declare function executeWithRollback(groups: IMutationPairGroup[], commandService: ICommandService): boolean;
 interface IPivotHostInfo {
     pivotTableId: string;
     unitId: string;

package/lib/types/commands/mutations/pivot-data-communication.mutation.d.ts

@@ -1,5 +1,7 @@
 import type { IMutation } from '@univerjs/core';
-import type { IGetPivotDataLocalMutationParams, ISendInitPivotTextLocalMutationParams, ISendPivotConfigLocalMutationParams, ISendPivotDataLocalMutationParams, ISendPivotViewLocalMutationParams } from '../../const/type';
+import type { IGetPivotDataLocalMutationParams, IInitializePivotRuntimeParams, IPivotRuntimeInitializedParams, ISendInitPivotTextLocalMutationParams, ISendPivotConfigLocalMutationParams, ISendPivotDataLocalMutationParams, ISendPivotViewLocalMutationParams } from '../../const/type';
+export declare const InitializePivotRuntimeLocalMutation: IMutation<IInitializePivotRuntimeParams>;
+export declare const PivotRuntimeInitializedLocalMutation: IMutation<IPivotRuntimeInitializedParams>;
 export declare const GetPivotDataLocalMutation: IMutation<IGetPivotDataLocalMutationParams>;
 export declare const SendPivotDataLocalMutation: IMutation<ISendPivotDataLocalMutationParams>;
 export declare const SendPivotViewLocalMutation: IMutation<ISendPivotViewLocalMutationParams>;

package/lib/types/config/config.d.ts

@@ -1,4 +1,4 @@
-import { PivotDateGroupFieldDateSystemEnum } from '@univerjs-pro/engine-pivot';
+import { DateSystem } from '@univerjs/core';
 export declare const SHEETS_PIVOT_PLUGIN_CONFIG_KEY = "sheets-pivot.config";
 export declare const configSymbol: unique symbol;
 export interface IUniverSheetsPivotConfig {
@@ -16,6 +16,6 @@ export interface IUniverSheetsPivotConfig {
     /**
      * Define the date system used for pivot date grouping calculations. The default value is Date1900.
      */
-    dateSystem?: PivotDateGroupFieldDateSystemEnum;
+    dateSystem?: DateSystem;
 }
 export declare const defaultPluginConfig: IUniverSheetsPivotConfig;

package/lib/types/const/const.d.ts

@@ -1,4 +1,4 @@
-import type { IPivotViewCellData, IPivotViewValueType, PivotView, PivotViewItem } from '@univerjs-pro/engine-pivot';
+import type { IPivotTableDateGroupInfo, IPivotTableNumberGroupInfo, IPivotViewCellData, IPivotViewValueType, PivotView, PivotViewItem } from '@univerjs-pro/engine-pivot';
 import type { Injector, IRange } from '@univerjs/core';
 import type enUS from '../locale/en-US';
 import type { IAdjustPivotTableRes, IPivotTableConfig, IThemeStyle } from './type';
@@ -60,6 +60,8 @@ export declare const defaultEmptyPivotDataCellStyle: {
 };
 export declare const defaultThemeStyle: IThemeStyle;
 export declare function getDateGroupDisplayArgs(dateType: PivotDateGroupFieldDateTypeEnum, dateStr: string): string[] | undefined;
+export declare function getExcelDateGroupStr(injector: Injector, group: IPivotTableDateGroupInfo, key: number, dateSystem: DateSystem): string;
+export declare function getNumberGroupStr(injector: Injector, group: IPivotTableNumberGroupInfo, key: number | string): string;
 export declare const generatorAdjustPositionData: (injector: Injector, data: PivotView, pivotTableConfig: IPivotTableConfig, textInfo: Record<string, string>, direction?: "ltr" | "rtl", dateSystem?: DateSystem) => IAdjustPivotTableRes;
 export declare function transFromCellValue(cellData: IPivotViewCellData, isValue: boolean, format: string | undefined, textInfo: Record<string, string>, multipleGrandTotalLabel?: string, subtotalLabel?: string, dateSystem?: DateSystem): IPivotViewValueType;
 export declare function formatPivotRenderText(textInfo: Record<string, string>, templateKey: string, fallbackTemplate: string, ...args: unknown[]): string;
@@ -90,7 +92,12 @@ export declare enum PivotDisplayDataType {
     ResetPivotTable = "resetPivotTable",
     SetOption = "setOption",
     SetPivotLayout = "setPivotLayout",
-    SetPivotDateGroup = "setPivotDateGroup"
+    SetPivotDateGroup = "setPivotDateGroup",
+    SetPivotExcelDateGroup = "setPivotExcelDateGroup",
+    SetPivotNumberGroup = "setPivotNumberGroup",
+    SetPivotManualGroups = "setPivotManualGroups",
+    ManualGroupMembers = "manualGroupMembers",
+    NumberGroupDefaults = "numberGroupDefaults"
 }
 export declare const defaultTextInfo: {
     'sheets-pivot.blankValue': string;

package/lib/types/const/type.d.ts

@@ -1,4 +1,4 @@
-import type { DataField, FieldsCollection, IBaseGroupFieldJSON, IDataFieldManagerBaseJSON, IFieldsCollectionJSON, ILabelViewHeaderMapItem, IPivotTableChangeSet, IPivotTableFilterInfo, IPivotTableLabelFieldJSON, IPivotTableOptions, IPivotTableShowDataAsInfo, IPivotTableSnapshot, IPivotTableSortInfo, IPivotTableValueFieldJSON, IPivotTableValueFilter, IPivotViewInfo, IPivotViewJSON, IPivotViewValueType, PivotCellStyleTypeEnum, PivotDataFieldDataTypeEnum, PivotDateGroupFieldDateTypeEnum, PivotLayoutTypeEnum, PivotSubtotalTypeEnum, PivotTableChangeTypeEnum, PivotTableFiledAreaEnum, PivotTableValuePositionEnum, PivotView } from '@univerjs-pro/engine-pivot';
+import type { DataField, FieldsCollection, IBaseGroupFieldJSON, IDataFieldManagerBaseJSON, IExcelDateGrouping, IFieldsCollectionJSON, ILabelViewHeaderMapItem, IManualGroup, INumberGrouping, IPivotTableChangeSet, IPivotTableFilterInfo, IPivotTableLabelFieldJSON, IPivotTableOptions, IPivotTableShowDataAsInfo, IPivotTableSnapshot, IPivotTableSortInfo, IPivotTableValueFieldJSON, IPivotTableValueFilter, IPivotViewInfo, IPivotViewJSON, IPivotViewValueType, PivotCellStyleTypeEnum, PivotDataFieldDataTypeEnum, PivotDateGroupFieldDateTypeEnum, PivotLayoutTypeEnum, PivotSubtotalTypeEnum, PivotTableChangeTypeEnum, PivotTableFiledAreaEnum, PivotTableValuePositionEnum, PivotView } from '@univerjs-pro/engine-pivot';
 import type { CellValueType, ICellData, IRange, IStyleData, IUndoRedoCommandInfosByInterceptor, IUnitRangeName, Nullable, ObjectMatrix } from '@univerjs/core';
 import type { PivotDisplayDataType, PositionType } from './const';
 export interface IPivotPerformCheckParams {
@@ -6,8 +6,28 @@ export interface IPivotPerformCheckParams {
     view: PivotView;
     isEmpty: boolean;
 }
+export interface IPivotManualFilterCoordinationParams {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+    tableFieldId: string;
+    items: string[];
+    partialItems?: string[];
+    isAll?: boolean;
+}
+export interface IPivotManualFilterCoordinationResult {
+    handled: boolean;
+    result: boolean;
+}
 export declare const PIVOT_PERFORM_CHECK: import("@univerjs/core").IAsyncInterceptor<boolean, IPivotPerformCheckParams>;
+export declare const PIVOT_MANUAL_FILTER_COORDINATION: import("@univerjs/core").IAsyncInterceptor<IPivotManualFilterCoordinationResult, IPivotManualFilterCoordinationParams>;
 export declare const PIVOT_MUTATION_GENERATE: import("@univerjs/core").IInterceptor<IUndoRedoCommandInfosByInterceptor, IPivotPerformCheckParams>;
+export declare const PIVOT_FIELD_REMOVE_COORDINATION: import("@univerjs/core").IInterceptor<string[], {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+    fieldIds: string[];
+}>;
 export interface IPivotTableConfigChangeInfo {
     unitId: string;
     subUnitId: string;
@@ -27,6 +47,11 @@ export interface IPivotReportScope {
     unitId: string;
     subUnitId: string;
 }
+export interface IPivotCollectionChange {
+    /** Workbook owning the source collections, which can differ from the report's target workbook. */
+    unitId: string;
+    pivotTableIds: readonly string[];
+}
 export interface ICollectionChangeInfo {
     token: string;
     type: CollectionChangeEnum;
@@ -42,6 +67,7 @@ export interface IAddPivotTableParams {
 export interface IUpdatePivotTableSourceRangeMutationParams {
     pivotTableId: string;
     pivotCacheId?: string;
+    preserveCacheId?: boolean;
     deleteIds: string[];
     collectionJSON: IFieldsCollectionJSON;
     dataRangeInfo: IUnitRangeNameWithSubUnitId;
@@ -109,6 +135,8 @@ export interface ISetPivotOptionMutationParams {
     subUnitId: string;
     pivotTableId: string;
     options: IPivotTableOptions;
+    /** Changeset options are complete snapshots; direct mutation callers still apply patches. */
+    replace?: boolean;
 }
 export interface ISetPivotLayoutMutationParams {
     unitId: string;
@@ -210,6 +238,8 @@ export interface IPivotCellPositionInfo {
     sheetName?: string;
 }
 export interface IPivotTableConfig {
+    /** User-facing report name. Missing legacy values are normalized to an empty string. */
+    name?: string;
     targetCellInfo: IPivotCellPositionInfo;
     sourceRangeInfo: IUnitRangeNameWithSubUnitId;
     pivotCacheId?: string;
@@ -269,6 +299,7 @@ export interface IDataFieldManagerJSON extends IDataFieldManagerBaseJSON {
 export interface ISheetsPivotCacheSnapshot {
     pivotCacheId: string;
     sourceRangeInfo: IUnitRangeNameWithSubUnitId;
+    retainedSource?: boolean;
 }
 export interface IPivotTableJson {
     dataFieldManagerConfig: Record<string, IDataFieldManagerJSON>;
@@ -359,6 +390,9 @@ export interface IPivotDisplayFilterInfo {
     pivotTableId: string;
     items: string[];
     itemTypes: PivotDataFieldDataTypeEnum[];
+    itemLabels?: Record<string, string>;
+    checkedItems?: string[];
+    partialItems?: string[];
     filterInfo: IPivotTableFilterInfo | undefined;
     sortInfo: IPivotTableSortInfo | undefined;
     format: string | undefined;
@@ -389,6 +423,7 @@ export interface IGetMovePivotFieldDataParams {
 }
 export interface IGetRemovePivotFieldDataParams {
     fieldIds: string[];
+    retainFilterFieldIds?: string[];
 }
 export type IGetPivotCollapseDataParams = {
     tableFieldId: string;
@@ -405,6 +440,7 @@ export type IGetPivotCollapseDataParams = {
 export interface IGetPivotFilterDataParams {
     tableFieldId: string;
     items: string[];
+    partialItems?: string[];
     isAll?: boolean;
 }
 export interface IGetPivotValueFilterDataParams {
@@ -435,6 +471,18 @@ export interface IGetPivotDateGroupParams {
     tableFieldId: string;
     dateType: PivotDateGroupFieldDateTypeEnum;
 }
+export interface IGetPivotExcelDateGroupParams {
+    tableFieldId: string;
+    grouping: IExcelDateGrouping;
+}
+export interface IGetPivotNumberGroupParams {
+    tableFieldId: string;
+    grouping: INumberGrouping;
+}
+export interface IGetPivotManualGroupsParams {
+    sourceFieldId: string;
+    groups: IManualGroup[];
+}
 export interface IGetPivotDrillDownDataParams {
     tuple: string[][];
 }
@@ -478,6 +526,20 @@ export interface IGetPivotDataLocalMutationParams extends IPivotLocalMutationBas
         setOptions?: IGetPivotOptionParams;
         setPivotLayout?: IGetPivotLayoutParams;
         setPivotDateGroup?: IGetPivotDateGroupParams;
+        setPivotExcelDateGroup?: IGetPivotExcelDateGroupParams;
+        setPivotNumberGroup?: IGetPivotNumberGroupParams;
+        setPivotManualGroups?: IGetPivotManualGroupsParams;
+        manualGroupMembers?: {
+            sourceFieldId: string;
+            paths: Array<{
+                path: string;
+                memberKey?: string;
+                tupleKey?: string;
+            }>;
+        };
+        numberGroupDefaults?: {
+            tableFieldId: string;
+        };
     };
 }
 export interface IPivotDisplayResult {
@@ -503,8 +565,17 @@ export interface IPivotDisplayResult {
     setPivotOption?: IPivotDisplayBaseInfo;
     setPivotLayout?: IPivotDisplayBaseInfo;
     setPivotDateGroup?: IPivotDisplayBaseInfo;
+    setPivotExcelDateGroup?: IPivotDisplayBaseInfo;
+    setPivotNumberGroup?: IPivotDisplayBaseInfo;
+    setPivotManualGroups?: IPivotDisplayBaseInfo;
+    manualGroupMembers?: {
+        members: IManualGroup['members'];
+        error?: 'invalidSelection' | 'ambiguousMember';
+    };
+    numberGroupDefaults?: INumberGrouping;
 }
 export interface IPivotUpdatePivotSourceInfo {
+    pivotCacheId: string;
     view: IPivotViewJSON;
     changesets: IPivotTableChangeSet[];
     isEmpty: boolean;
@@ -512,8 +583,10 @@ export interface IPivotUpdatePivotSourceInfo {
     collectionConfig: IFieldsCollectionJSON;
     oldCollectionConfig: IFieldsCollectionJSON;
     deleteIds?: string[];
+    createdFieldIds: string[];
 }
 export interface IPivotAddPivotTableInfo {
+    pivotCacheId: string;
     view: IPivotViewJSON;
     isEmpty: boolean;
     fieldsConfig: IPivotTableSnapshot;
@@ -532,29 +605,45 @@ export interface IPivotDisplayBaseInfo {
     isEmpty: boolean;
     pivotTableConfig: IPivotTableConfig;
     shouldBeAddedGroupJSON?: IBaseGroupFieldJSON;
+    addedGroupJSON?: IBaseGroupFieldJSON[];
+    removedGroupJSON?: IBaseGroupFieldJSON[];
 }
 export interface ISendPivotViewItemLocalParams extends IPivotLocalMutationBaseParams {
+    runtimeId?: string;
     view: IPivotViewJSON;
     pivotConfig: IPivotTableConfig;
     type: PivotTableOperationEnum;
 }
 export interface ISendPivotViewLocalMutationParams {
+    runtimeIds?: Record<string, string>;
     single?: ISendPivotViewItemLocalParams;
     batch?: ISendPivotViewItemLocalParams[];
     collectionConfig?: Record<string, IDataFieldManagerJSON>;
+    pivotCacheConfigs?: IPivotTableJson['pivotCacheConfigs'];
 }
 export interface ISendPivotConfigLocalMutationParams {
+    runtimeId?: string;
+    runtimeIds?: Record<string, string>;
     unitId: string;
     subUnitId: string;
     oldSubUnitId: string;
     pivotTableId: string;
     pivotTableConfig: IPivotTableConfig;
     collectionConfig: IDataFieldManagerJSON;
+    pivotCacheConfigs?: IPivotTableJson['pivotCacheConfigs'];
 }
 export interface ISendInitPivotTextLocalMutationParams {
     textInfo: Record<string, string>;
     direction: 'ltr' | 'rtl';
 }
+export interface IInitializePivotRuntimeParams {
+    unitId: string;
+    runtimeId: string;
+    sequence: number;
+}
+export interface IPivotRuntimeInitializedParams extends IInitializePivotRuntimeParams {
+    error?: 'calculation-failed';
+}
 export interface ISendPivotDataLocalMutationParams extends IPivotLocalMutationBaseParams {
     version: string;
     result: IPivotDisplayResult;
@@ -585,6 +674,7 @@ export interface IPivotPanelTableListItemBase {
     format?: string;
     subTotalType?: PivotSubtotalTypeEnum;
     showDataAs?: IPivotTableShowDataAsInfo;
+    filterInfo?: IPivotTableFilterInfo;
 }
 export interface IPivotPanelSourceList {
     id: string;
@@ -601,6 +691,7 @@ export interface IPivotPanelDataInfo {
     columnFields: IPivotPanelTableListItemBase[];
     valueFields: IPivotPanelTableListItemBase[];
     filterFields: IPivotPanelTableListItemBase[];
+    hiddenFields?: IPivotPanelTableListItemBase[];
     positionInfo: IPivotTableConfig['targetCellInfo'];
 }
 export interface ICurrentDataMatrix {

package/lib/types/controllers/sheets-pivot-ref-range.controller.d.ts

@@ -14,6 +14,8 @@ export declare class SheetsPivotRefRangeController extends Disposable {
     private readonly _sheetInterceptorService;
     disposableCollection: DisposableCollection;
     constructor(_injector: Injector, _refRangeService: RefRangeService, _commandService: ICommandService, _univerInstanceService: IUniverInstanceService, _sheetsPivotTableConfigModel: SheetsPivotTableConfigModel, _sheetsPivotTableAdaptorModel: SheetsPivotTableAdaptorModel, _sheetInterceptorService: SheetInterceptorService);
+    private _getStructureMutations;
+    private _getRemovedFieldMutations;
     private _onRefRangeChange;
     private _refRangeHandle;
     getRefRangeMutationsByMoveRange(params: IMoveRangeCommandParams, unitId: string, subUnitId: string): {

package/lib/types/controllers/sheets-pivot-rpc.controller.d.ts

@@ -1,4 +1,4 @@
-import { Disposable, ICommandService } from '@univerjs/core';
+import { Disposable, ICommandService, IConfigService, IUniverInstanceService } from '@univerjs/core';
 import { IActiveDirtyManagerService } from '@univerjs/engine-formula';
 import { SheetsPivotTableConfigModel } from '../models/sheets-pivot-config-model';
 import { SheetsPivotTableAdaptorModel } from '../models/sheets-pivot-table-adaptor-model';
@@ -9,7 +9,14 @@ export declare class SheetsPivotRPCController extends Disposable {
     private readonly _sheetsPivotTableAdaptorModel;
     private readonly _sheetsPivotTableConfigModel;
     readonly _activeDirtyManagerService: IActiveDirtyManagerService;
-    constructor(_commandService: ICommandService, _sheetsPivotRpcService: SheetsPivotRPCService, _sheetsPivotTableAdaptorModel: SheetsPivotTableAdaptorModel, _sheetsPivotTableConfigModel: SheetsPivotTableConfigModel, _activeDirtyManagerService: IActiveDirtyManagerService);
+    private readonly _configService;
+    private readonly _univerInstanceService;
+    private readonly _initializations;
+    private _runtimeSequence;
+    constructor(_commandService: ICommandService, _sheetsPivotRpcService: SheetsPivotRPCService, _sheetsPivotTableAdaptorModel: SheetsPivotTableAdaptorModel, _sheetsPivotTableConfigModel: SheetsPivotTableConfigModel, _activeDirtyManagerService: IActiveDirtyManagerService, _configService: IConfigService, _univerInstanceService: IUniverInstanceService);
+    private _initRuntimeLifecycle;
+    private _initializeRuntime;
+    dispose(): void;
     private _initDataSendListener;
     /**
      * - register dirty service, used to mark the pivot table view dirty

package/lib/types/facade/f-enum.d.ts

@@ -1,5 +1,6 @@
-import { PivotCallbackEnum, PivotCellStyleTypeEnum, PivotDataFieldDataTypeEnum, PivotDataFieldSortOperatorEnum, PivotDataFieldSortTypeEnum, PivotDataFieldTypeEnum, PivotDateGroupFieldDateSystemEnum, PivotDateGroupFieldDateTypeEnum, PivotFilterTypeEnum, PivotLayoutTypeEnum, PivotShowAsBaseItemTypeEnum, PivotShowAsTypeEnum, PivotSubtotalPositionEnum, PivotSubtotalTypeEnum, PivotTableChangeTypeEnum, PivotTableFiledAreaEnum, PivotTableValuePositionEnum, PivotViewCellValueTypeEnum, ST_PivotFilterOperatorEnum } from '@univerjs-pro/engine-pivot';
+import { PivotCallbackEnum, PivotCellStyleTypeEnum, PivotDataFieldDataTypeEnum, PivotDataFieldSortOperatorEnum, PivotDataFieldSortTypeEnum, PivotDataFieldTypeEnum, PivotDateGroupFieldDateTypeEnum, PivotDateGroupingMode, PivotExcelDateGroupUnit, PivotFilterTypeEnum, PivotLayoutTypeEnum, PivotShowAsBaseItemTypeEnum, PivotShowAsTypeEnum, PivotSubtotalPositionEnum, PivotSubtotalTypeEnum, PivotTableChangeTypeEnum, PivotTableFiledAreaEnum, PivotTableValuePositionEnum, PivotViewCellValueTypeEnum, ST_PivotFilterOperatorEnum } from '@univerjs-pro/engine-pivot';
 import { PositionType } from '@univerjs-pro/sheets-pivot';
+import { DateSystem } from '@univerjs/core';
 /**
  * @ignore
  */
@@ -50,6 +51,14 @@ export interface IFSheetsPivotEnumMixin {
      * Represents the date type of the pivot date group field. {@link PivotDateGroupFieldDateTypeEnum}
      */
     PivotDateGroupFieldDateTypeEnum: typeof PivotDateGroupFieldDateTypeEnum;
+    /**
+     * Represents the pivot table date grouping mode. {@link PivotDateGroupingMode}
+     */
+    PivotDateGroupingMode: typeof PivotDateGroupingMode;
+    /**
+     * Represents a calendar unit for Excel-style date grouping. {@link PivotExcelDateGroupUnit}
+     */
+    PivotExcelDateGroupUnit: typeof PivotExcelDateGroupUnit;
     /**
      * Represents the show-as calculation type of a pivot value field. {@link PivotShowAsTypeEnum}
      */
@@ -75,9 +84,9 @@ export interface IFSheetsPivotEnumMixin {
      */
     PivotDataFieldTypeEnum: typeof PivotDataFieldTypeEnum;
     /**
-     * Represents the date system used by pivot date group fields. {@link PivotDateGroupFieldDateSystemEnum}
+     * Represents the date system used by pivot date group fields. {@link DateSystem}
      */
-    PivotDateGroupFieldDateSystemEnum: typeof PivotDateGroupFieldDateSystemEnum;
+    DateSystem: typeof DateSystem;
     /**
      * Represents the pivot cell style type generated by the pivot view. {@link PivotCellStyleTypeEnum}
      */

package/lib/types/facade/f-generic-pivot-table.d.ts

@@ -1,4 +1,4 @@
-import type { IDataFieldValue, IPivotTableOptions, IPivotViewValueType, PivotLayoutTypeEnum, PivotTable, PivotTableLabelField, PivotTableValueField } from '@univerjs-pro/engine-pivot';
+import type { IDataFieldValue, IPivotTableOptions, IPivotTableRecordFilter, IPivotViewValueType, PivotLayoutTypeEnum, PivotTable, PivotTableLabelField, PivotTableValueField } from '@univerjs-pro/engine-pivot';
 import type { Injector } from '@univerjs/core';
 import type { IDataFieldDataArray, IDimensionInfo, IFGenericPivotFilterOptions, IPivotTableCubeConfig, IPivotTableValueOptions } from './type';
 import { DataFieldManager, PivotDataFieldDataTypeEnum, PivotTableFiledAreaEnum } from '@univerjs-pro/engine-pivot';
@@ -286,6 +286,7 @@ export declare class FGenericPivotTable {
     remove(): void;
 }
 export declare class DefaultDataFieldManager extends DataFieldManager {
+    compileRecordFilter(filter: IPivotTableRecordFilter): (value: IDataFieldValue) => boolean;
     getRangeData(data: IDataFieldDataArray): {
         header: string[];
         data: IDataFieldValue[][];

package/lib/types/facade/f-pivot-table.d.ts

@@ -1,4 +1,4 @@
-import type { IPivotTableLabelFieldJSON, IPivotTableOptions, IPivotTableShowDataAsInfo, IPivotTableSortInfo, IPivotTableValueFieldJSON, IPivotTableValueFilter, IValueFilterInfoItem, PivotDataFieldDataTypeEnum, PivotDateGroupFieldDateTypeEnum, PivotSubtotalTypeEnum, PivotTableValuePositionEnum } from '@univerjs-pro/engine-pivot';
+import type { IExcelDateGrouping, IManualGroup, INumberGrouping, IPivotTableLabelFieldJSON, IPivotTableOptions, IPivotTableShowDataAsInfo, IPivotTableSortInfo, IPivotTableValueFieldJSON, IPivotTableValueFilter, IValueFilterInfoItem, PivotDataFieldDataTypeEnum, PivotDateGroupFieldDateTypeEnum, PivotDateGroupingMode, PivotSubtotalTypeEnum, PivotTableValuePositionEnum } from '@univerjs-pro/engine-pivot';
 import type { IPivotTableConfig, IPivotTableMatrixInfo, IUnitRangeNameWithSubUnitId } from '@univerjs-pro/sheets-pivot';
 import type { Injector, IRange, Nullable } from '@univerjs/core';
 import { PivotLayoutTypeEnum, PivotTableFiledAreaEnum } from '@univerjs-pro/engine-pivot';
@@ -162,6 +162,21 @@ export declare class FPivotTable extends FBase {
      * ```
      */
     getOptions(): IPivotTableOptions | undefined;
+    /**
+     * @description Get the effective date grouping mode of the pivot table. The mode defaults to legacy when not configured.
+     * @returns {PivotDateGroupingMode|undefined} The date grouping mode, or undefined if the pivot table no longer exists.
+     *
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
+     * const fPivotTable = fWorkbook.getPivotTableByCell(fWorkbook.getId(), fWorksheet.getSheetId(), 0, 8);
+     * const mode = fPivotTable?.getDateGroupingMode();
+     * console.log(mode === univerAPI.Enum.PivotDateGroupingMode.ExcelLike);
+     * ```
+     */
+    getDateGroupingMode(): PivotDateGroupingMode | undefined;
     /**
      * @description Get the pivot table layout type.
      * @returns {PivotLayoutTypeEnum|undefined} The layout type, or undefined if the pivot table no longer exists.
@@ -236,6 +251,21 @@ export declare class FPivotTable extends FBase {
      * ```
      */
     setOptions(options: IPivotTableOptions): Promise<boolean>;
+    /**
+     * @description Set the pivot table date grouping mode through the option command. Switching modes clears existing date groups.
+     * @param {PivotDateGroupingMode} mode The date grouping mode to set.
+     * @returns {Promise<boolean>} Whether the date grouping mode was set successfully.
+     *
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
+     * const fPivotTable = fWorkbook.getPivotTableByCell(fWorkbook.getId(), fWorksheet.getSheetId(), 0, 8);
+     * await fPivotTable?.setDateGroupingMode(univerAPI.Enum.PivotDateGroupingMode.ExcelLike);
+     * ```
+     */
+    setDateGroupingMode(mode: PivotDateGroupingMode): Promise<boolean>;
     /**
      * @description Set the pivot table layout type through command. It keeps undo/redo, collaboration and render update paths consistent with panel operations.
      * @param {PivotLayoutTypeEnum} layout The layout type to set.
@@ -904,6 +934,76 @@ export declare class FPivotTable extends FBase {
      * ```
      */
     setDateGroupType(tableFieldId: string, dateType: PivotDateGroupFieldDateTypeEnum): Promise<boolean>;
+    /**
+     * @description Group a date label field by Excel-style calendar units. The pivot table must use Excel-like date grouping mode.
+     * @param {string} tableFieldId The source label field id.
+     * @param {IExcelDateGrouping} grouping The date units and range settings.
+     * @returns {Promise<boolean>} Whether the date group was set successfully.
+     *
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
+     * const fPivotTable = fWorkbook.getPivotTableByCell(fWorkbook.getId(), fWorksheet.getSheetId(), 0, 8);
+     * const rowIds = fPivotTable?.getFieldIdsByArea(univerAPI.Enum.PivotTableFiledAreaEnum.Row);
+     * if (rowIds?.length) {
+     *   await fPivotTable?.setExcelDateGroup(rowIds[0], {
+     *     units: [univerAPI.Enum.PivotExcelDateGroupUnit.Year, univerAPI.Enum.PivotExcelDateGroupUnit.Month],
+     *     autoStart: true,
+     *     autoEnd: true,
+     *   });
+     * }
+     * ```
+     */
+    setExcelDateGroup(tableFieldId: string, grouping: IExcelDateGrouping): Promise<boolean>;
+    /**
+     * @description Group a numeric label field into intervals.
+     * @param {string} tableFieldId The source label field id.
+     * @param {INumberGrouping} grouping The numeric range and interval settings.
+     * @returns {Promise<boolean>} Whether the number group was set successfully.
+     *
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
+     * const fPivotTable = fWorkbook.getPivotTableByCell(fWorkbook.getId(), fWorksheet.getSheetId(), 0, 8);
+     * const rowIds = fPivotTable?.getFieldIdsByArea(univerAPI.Enum.PivotTableFiledAreaEnum.Row);
+     * if (rowIds?.length) {
+     *   await fPivotTable?.setNumberGroup(rowIds[0], { autoStart: true, autoEnd: true, interval: 10 });
+     * }
+     * ```
+     */
+    setNumberGroup(tableFieldId: string, grouping: INumberGrouping): Promise<boolean>;
+    /**
+     * @description Replace the manual member groups of one source field. Pass an empty array to remove all manual groups.
+     * Each group keeps its stable `id` when renamed; members retain their value types even when displayed labels match.
+     * @param {string} sourceFieldId The original source field id, not the derived group or table field id.
+     * @param {IManualGroup[]} groups The complete next set of groups, each with an id, name, and at least two source members.
+     * @returns {Promise<boolean>} Whether the manual groups were updated successfully.
+     *
+     * @example
+     * ```ts
+     * import { RecordValueType } from '@univerjs/core';
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
+     * const fPivotTable = fWorkbook.getPivotTableByCell(fWorkbook.getId(), fWorksheet.getSheetId(), 0, 8);
+     * const sourceFieldId = fPivotTable?.getSourceFieldsInfo().find((field) => field.name === 'Region')?.id;
+     * if (sourceFieldId) {
+     *   await fPivotTable?.setManualGroups(sourceFieldId, [{
+     *     id: 'north',
+     *     name: 'North',
+     *     members: [
+     *       { type: RecordValueType.String, value: 'East' },
+     *       { type: RecordValueType.String, value: 'West' },
+     *     ],
+     *   }]);
+     * }
+     * ```
+     */
+    setManualGroups(sourceFieldId: string, groups: IManualGroup[]): Promise<boolean>;
     /**
      * @description Collapse or expand a pivot table item by the cell position through command.
      * @param {number} row - The row index of the pivot item cell.