@univerjs-pro/sheets-pivot 1.0.0-rc.0 → 1.0.1

package/lib/locale/zh-TW.js

@@ -1 +1 @@
-const _0xcb9037=_0x3db2;function _0x4fb1(){const _0x5a43b3=['60sIufiz','（其他）','{0}','{0}:{1}','年-季','1956tQSzVv','61266RHfVci','7QysnPT','{0}\x20{1}','工作表','6725235spjKDN','月-日','Q{0}','計數項：','6226472rhwmeq','小時-分鐘','2835160VtvuiO','母體變異數項：','1037555IHNwZp','變異數項：','{0}-{1}-{2}','2692oOWhIV','平均值項：','1963566QcGRbe','乘積項：','{0}-Q{1}','年-月-日','（空白）','85YrVsnS','數值計數項：','欄標籤','最大值項：','母體標準差項：','{0}-{1}'];_0x4fb1=function(){return _0x5a43b3;};return _0x4fb1();}(function(_0x23b26e,_0x585482){const _0x5cc221=_0x3db2,_0x5517e3=_0x23b26e();while(!![]){try{const _0x106160=parseInt(_0x5cc221(0x187))/0x1+parseInt(_0x5cc221(0x18a))/0x2*(-parseInt(_0x5cc221(0x17a))/0x3)+-parseInt(_0x5cc221(0x185))/0x4+-parseInt(_0x5cc221(0x16f))/0x5*(-parseInt(_0x5cc221(0x17b))/0x6)+-parseInt(_0x5cc221(0x17c))/0x7*(parseInt(_0x5cc221(0x183))/0x8)+-parseInt(_0x5cc221(0x16a))/0x9*(-parseInt(_0x5cc221(0x175))/0xa)+parseInt(_0x5cc221(0x17f))/0xb;if(_0x106160===_0x585482)break;else _0x5517e3['push'](_0x5517e3['shift']());}catch(_0xe68955){_0x5517e3['push'](_0x5517e3['shift']());}}}(_0x4fb1,0xbb3a0));const e={'sheets-pivot':{'sheet':_0xcb9037(0x17e),'blankValue':_0xcb9037(0x16e),'otherValue':_0xcb9037(0x176),'columnName':'欄\x20','subTotalText':'小計','grandTotalText':'總計','valueText':'值','rowLabels':'列標籤','columnLabels':_0xcb9037(0x171),'averageName':_0xcb9037(0x18b),'countName':_0xcb9037(0x182),'countNumsName':_0xcb9037(0x170),'maxName':_0xcb9037(0x172),'minName':'最小值項：','productName':_0xcb9037(0x16b),'stdDevName':'標準差項：','stdDevpName':_0xcb9037(0x173),'sumName':'總和項：','varName':_0xcb9037(0x188),'varpName':_0xcb9037(0x186),'subTotal':'小計','grandTotal':'總計','value':'值','blank':'空白','other':'其他','renderText':{'valueField':'{0}{1}','subtotal':'{0}\x20{1}','grandTotal':_0xcb9037(0x17d),'multipleGrandTotal':'{0}','subtotalWithValue':_0xcb9037(0x17d)},'emptyPivot':{'filter':'篩選','row':'列','column':'欄','values':'值'},'dateGroup':{'year':'年','month':'月','day':'日','date':'日','hour':'小時','minute':'分鐘','hourMinute':_0xcb9037(0x184),'quarter':'季','monthDate':_0xcb9037(0x180),'yearQuarter':_0xcb9037(0x179),'yearMonth':'年-月','yearMonthDate':_0xcb9037(0x16d)},'cellDateGroupDisplay':{'minute':'{0}','hour':_0xcb9037(0x177),'hourMinute':_0xcb9037(0x178),'date':_0xcb9037(0x177),'month':_0xcb9037(0x177),'monthDate':_0xcb9037(0x174),'quarter':_0xcb9037(0x181),'year':_0xcb9037(0x177),'yearMonth':_0xcb9037(0x174),'yearMonthDate':_0xcb9037(0x189),'yearQuarter':_0xcb9037(0x16c)}}};function _0x3db2(_0x318cb6,_0xc86ac6){_0x318cb6=_0x318cb6-0x16a;const _0x4fb17a=_0x4fb1();let _0x3db2c7=_0x4fb17a[_0x318cb6];return _0x3db2c7;}export{e as default};
+const _0x51c14d=_0x5c5f;function _0x5c5f(_0x184027,_0x53d471){_0x184027=_0x184027-0x134;const _0x47b43c=_0x47b4();let _0x5c5f25=_0x47b43c[_0x184027];return _0x5c5f25;}(function(_0x1e727c,_0x281a80){const _0x3ef36b=_0x5c5f,_0x3df9af=_0x1e727c();while(!![]){try{const _0x4a958e=parseInt(_0x3ef36b(0x13e))/0x1+parseInt(_0x3ef36b(0x150))/0x2*(parseInt(_0x3ef36b(0x14b))/0x3)+-parseInt(_0x3ef36b(0x143))/0x4*(parseInt(_0x3ef36b(0x145))/0x5)+parseInt(_0x3ef36b(0x14f))/0x6+parseInt(_0x3ef36b(0x140))/0x7+-parseInt(_0x3ef36b(0x141))/0x8+parseInt(_0x3ef36b(0x135))/0x9;if(_0x4a958e===_0x281a80)break;else _0x3df9af['push'](_0x3df9af['shift']());}catch(_0x1ec578){_0x3df9af['push'](_0x3df9af['shift']());}}}(_0x47b4,0x97289));const e={'sheets-pivot':{'sheet':'工作表','blankValue':_0x51c14d(0x151),'otherValue':'（其他）','columnName':'欄\x20','subTotalText':'小計','grandTotalText':'總計','valueText':'值','rowLabels':_0x51c14d(0x13c),'columnLabels':_0x51c14d(0x154),'averageName':_0x51c14d(0x147),'countName':_0x51c14d(0x13d),'countNumsName':_0x51c14d(0x14e),'maxName':_0x51c14d(0x138),'minName':'最小值項：','productName':_0x51c14d(0x152),'stdDevName':'標準差項：','stdDevpName':_0x51c14d(0x142),'sumName':_0x51c14d(0x148),'varName':_0x51c14d(0x14a),'varpName':_0x51c14d(0x146),'subTotal':'小計','grandTotal':'總計','value':'值','blank':'空白','other':'其他','renderText':{'valueField':_0x51c14d(0x13a),'subtotal':'{0}\x20{1}','grandTotal':_0x51c14d(0x13f),'multipleGrandTotal':_0x51c14d(0x139),'subtotalWithValue':_0x51c14d(0x13f)},'emptyPivot':{'filter':'篩選','row':'列','column':'欄','values':'值'},'dateGroup':{'year':'年','month':'月','day':'日','date':'日','hour':'小時','minute':'分鐘','hourMinute':_0x51c14d(0x137),'quarter':'季','monthDate':_0x51c14d(0x14c),'yearQuarter':_0x51c14d(0x134),'yearMonth':'年-月','yearMonthDate':_0x51c14d(0x13b)},'cellDateGroupDisplay':{'minute':_0x51c14d(0x139),'hour':_0x51c14d(0x139),'hourMinute':_0x51c14d(0x144),'date':_0x51c14d(0x139),'month':_0x51c14d(0x139),'monthDate':_0x51c14d(0x149),'quarter':_0x51c14d(0x153),'year':'{0}','yearMonth':'{0}-{1}','yearMonthDate':_0x51c14d(0x14d),'yearQuarter':_0x51c14d(0x136)}}};export{e as default};function _0x47b4(){const _0x1d8861=['平均值項：','總和項：','{0}-{1}','變異數項：','42AlnLbs','月-日','{0}-{1}-{2}','數值計數項：','3042roGMNu','64656rGWbTV','（空白）','乘積項：','Q{0}','欄標籤','年-季','7611003KziFvY','{0}-Q{1}','小時-分鐘','最大值項：','{0}','{0}{1}','年-月-日','列標籤','計數項：','228550ejwrdi','{0}\x20{1}','2311750rIDWcR','9865504zitngx','母體標準差項：','20932uTbJoc','{0}:{1}','5pPmFsV','母體變異數項：'];_0x47b4=function(){return _0x1d8861;};return _0x47b4();}

package/lib/types/commands/command/set-pivot-collapse-by-field.command.d.ts

@@ -0,0 +1,8 @@
+import type { ICommand } from '@univerjs/core';
+import type { IPivotCollapseTarget } from './set-pivot-collapse.command';
+export type ISetPivotCollapseByFieldCommandParams = IPivotCollapseTarget;
+/**
+ * Sets collapse state using the semantic PivotTable field and item identity.
+ * This is used by projections such as PivotChart that do not own a sheet cell.
+ */
+export declare const SetPivotCollapseByFieldCommand: ICommand<ISetPivotCollapseByFieldCommandParams>;

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

@@ -1,4 +1,5 @@
-import type { ICommand } from '@univerjs/core';
+import type { IAccessor, ICommand } from '@univerjs/core';
+import type { IGetPivotCollapseDataParams } from '../../const/type';
 export interface ISetPivotCollapseCommandParams {
     /**
      * @property {string} unitId  The unit id of workbook which the pivot table belongs to.
@@ -21,4 +22,10 @@ export interface ISetPivotCollapseCommandParams {
      */
     collapse: boolean;
 }
+export type IPivotCollapseTarget = IGetPivotCollapseDataParams & {
+    unitId: string;
+    subUnitId: string;
+    pivotTableId: string;
+};
 export declare const SetPivotCollapseCommand: ICommand<ISetPivotCollapseCommandParams>;
+export declare function executePivotCollapse(accessor: IAccessor, target: IPivotCollapseTarget): Promise<boolean>;

package/lib/types/commands/command/update-value-position.command.d.ts

@@ -1,6 +1,14 @@
 import type { PivotTableValuePositionEnum } from '@univerjs-pro/engine-pivot';
 import type { ICommand } from '@univerjs/core';
 export interface IUpdatePivotValuePositionCommandParams {
+    /**
+     * @property {string} [unitId] The unit id of workbook which the pivot table belongs to.
+     */
+    unitId?: string;
+    /**
+     * @property {string} [subUnitId] The sub unit id of worksheet which the pivot table belongs to.
+     */
+    subUnitId?: string;
     /**
      * @property {string} pivotTableId  The pivot table id.
      */

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

@@ -23,6 +23,10 @@ export declare enum CollectionChangeEnum {
 export type IUnitRangeNameWithSubUnitId = IUnitRangeName & {
     subUnitId: string;
 };
+export interface IPivotReportScope {
+    unitId: string;
+    subUnitId: string;
+}
 export interface ICollectionChangeInfo {
     token: string;
     type: CollectionChangeEnum;
@@ -37,6 +41,7 @@ export interface IAddPivotTableParams {
 }
 export interface IUpdatePivotTableSourceRangeMutationParams {
     pivotTableId: string;
+    pivotCacheId?: string;
     deleteIds: string[];
     collectionJSON: IFieldsCollectionJSON;
     dataRangeInfo: IUnitRangeNameWithSubUnitId;
@@ -172,7 +177,7 @@ export interface ISetPivotCollapseMutation {
     subUnitId: string;
     pivotTableId: string;
     fieldId: string;
-    collapse: boolean;
+    collapse: boolean | Record<string, boolean> | undefined;
     item?: string;
 }
 export interface IAdjustPivotTableRes {
@@ -207,6 +212,7 @@ export interface IPivotCellPositionInfo {
 export interface IPivotTableConfig {
     targetCellInfo: IPivotCellPositionInfo;
     sourceRangeInfo: IUnitRangeNameWithSubUnitId;
+    pivotCacheId?: string;
     themeId?: string;
     fieldsConfig: IPivotTableSnapshot;
     isEmpty: boolean;
@@ -260,9 +266,14 @@ export interface IPivotTableCellData {
 export interface IDataFieldManagerJSON extends IDataFieldManagerBaseJSON {
     dataRanges: Record<string, IUnitRangeName>;
 }
+export interface ISheetsPivotCacheSnapshot {
+    pivotCacheId: string;
+    sourceRangeInfo: IUnitRangeNameWithSubUnitId;
+}
 export interface IPivotTableJson {
     dataFieldManagerConfig: Record<string, IDataFieldManagerJSON>;
     pivotTableConfigs: Record<string, Record<string, Record<string, IPivotTableConfig>>>;
+    pivotCacheConfigs?: Record<string, Record<string, ISheetsPivotCacheSnapshot>>;
 }
 export type IRangePosition = 'row' | 'col' | 'corner' | 'data';
 export interface IPivotRenderCache {
@@ -357,6 +368,7 @@ export interface IGetAddPivotTableDataParams {
         subUnitId: string;
     };
     pivotTableId: string;
+    fieldsConfig?: IPivotTableSnapshot;
 }
 export interface IGetAddPivotTableWithConfigDataParams {
     sourceRangeInfo: IUnitRangeName & {
@@ -378,11 +390,18 @@ export interface IGetMovePivotFieldDataParams {
 export interface IGetRemovePivotFieldDataParams {
     fieldIds: string[];
 }
-export interface IGetPivotCollapseDataParams {
+export type IGetPivotCollapseDataParams = {
     tableFieldId: string;
     collapse: boolean;
-    item: string;
-}
+    item?: string;
+    rowLevelFieldId?: never;
+} | {
+    /** Set the entire row axis depth in one query and changeset collection. */
+    rowLevelFieldId: string;
+    tableFieldId?: never;
+    collapse?: never;
+    item?: never;
+};
 export interface IGetPivotFilterDataParams {
     tableFieldId: string;
     items: string[];

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

@@ -0,0 +1,6 @@
+import { IPivotCacheProviderRegistry } from '@univerjs-pro/pivot-cache';
+import { Disposable } from '@univerjs/core';
+import { SheetsPivotUnitCacheProvider } from '../services/sheets-pivot-unit-cache.provider';
+export declare class SheetsPivotCacheProviderController extends Disposable {
+    constructor(registry: IPivotCacheProviderRegistry, provider: SheetsPivotUnitCacheProvider);
+}

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

@@ -3,6 +3,7 @@ import type { ICurrentDataMatrix, IPivotCellPositionInfo, IUnitRangeNameWithSubU
 import { Disposable, ICommandService, IConfigService, Injector, IUniverInstanceService } from '@univerjs/core';
 import { GlobalComputingStatusService, IFeatureCalculationManagerService } from '@univerjs/engine-formula';
 import { SheetsPivotDataSourceModel } from '../models/sheets-pivot-data-source-model';
+import { SheetsPivotCacheService } from '../services/sheets-pivot-cache.service';
 interface IPivotDirtyViewInfo {
     unitId: string;
     subUnitId: string;
@@ -16,7 +17,8 @@ export declare class PivotCalculatorController extends Disposable {
     private readonly _injector;
     private readonly _univerInstanceService;
     private readonly _configService;
-    constructor(_sheetsPivotDataSourceModel: SheetsPivotDataSourceModel, _featureCalculationManagerService: IFeatureCalculationManagerService, _commandService: ICommandService, _globalComputingSrv: GlobalComputingStatusService, _injector: Injector, _univerInstanceService: IUniverInstanceService, _configService: IConfigService);
+    private readonly _sheetsPivotCacheService;
+    constructor(_sheetsPivotDataSourceModel: SheetsPivotDataSourceModel, _featureCalculationManagerService: IFeatureCalculationManagerService, _commandService: ICommandService, _globalComputingSrv: GlobalComputingStatusService, _injector: Injector, _univerInstanceService: IUniverInstanceService, _configService: IConfigService, _sheetsPivotCacheService: SheetsPivotCacheService);
     private _isAutoDateGroupEnabled;
     private _setDateSystem;
     _init(): void;
@@ -35,6 +37,7 @@ export declare class PivotCalculatorController extends Disposable {
      */
     triggerDirtyFeature(dirtyInfos: IPivotDirtyViewInfo[]): void;
     removeSourceRangeChange(unitId: string, subUnitId: string, token: string): void;
+    handleReportSourceRangeChange(token: string, dataRangeInfo: IUnitRangeNameWithSubUnitId, reportUnitId: string, reportSubUnitId: string): void;
     handleSourceRangeChange(token: string, dataRangeInfo: IUnitRangeNameWithSubUnitId, targetInfo: IPivotCellPositionInfo): void;
     /**
      *  GET the runtime real data from runtime data, it use for refresh the data filed used rightly data

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

@@ -2,6 +2,7 @@ import type { IPivotTableLabelFieldJSON, IPivotTableOptions, IPivotTableShowData
 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';
+import { FBase } from '@univerjs/core/facade';
 interface IPivotTableDataFieldInfo {
     id: string;
     name: string;
@@ -30,7 +31,7 @@ export interface IPivotTableFieldSettingOptions {
  * The facade class for the pivot table.Which uses to setting the pivot table fields configs.
  * @hideconstructor
  */
-export declare class FPivotTable {
+export declare class FPivotTable extends FBase {
     /**
      * @ignore
      */
@@ -43,7 +44,7 @@ export declare class FPivotTable {
      * @ignore
      */
     pivotTableId: string;
-    private _injector;
+    protected readonly _injector: Injector;
     constructor(unitId: string, subUnitId: string, pivotTableId: string, injector: Injector);
     /**
      * @description Get the pivot table config by the pivot table id.

package/lib/types/facade/index.d.ts

@@ -5,6 +5,7 @@ import './f-event';
 import './f-univer';
 export type * from './f-enum';
 export type * from './f-event';
+export { FPivotTable } from './f-pivot-table';
 export type * from './f-pivot-table';
 export type * from './f-workbook';
 export type * from './f-worksheet';

package/lib/types/index.d.ts

@@ -15,6 +15,8 @@ export { RemovePivotFieldCommand } from './commands/command/remove-pivot-field.c
 export type { IRemovePivotFieldCommandParams } from './commands/command/remove-pivot-field.command';
 export { RemovePivotTableCommand } from './commands/command/remove-pivot-table.command';
 export { ResetPivotFieldsConfigCommand } from './commands/command/reset-pivot-fields-config.command';
+export { SetPivotCollapseByFieldCommand } from './commands/command/set-pivot-collapse-by-field.command';
+export type { ISetPivotCollapseByFieldCommandParams } from './commands/command/set-pivot-collapse-by-field.command';
 export { SetPivotCollapseCommand } from './commands/command/set-pivot-collapse.command';
 export type { ISetPivotCollapseCommandParams } from './commands/command/set-pivot-collapse.command';
 export { SetPivotDateGroupCommand } from './commands/command/set-pivot-date-group.command';
@@ -36,6 +38,7 @@ export { UpdatePivotValuePositionCommand } from './commands/command/update-value
 export type { IUpdatePivotValuePositionCommandParams } from './commands/command/update-value-position.command';
 export { AddPivotFieldMutation } from './commands/mutations/add-pivot-field.mutation';
 export { AddPivotTableMutation } from './commands/mutations/add-pivot-table.mutation';
+export { SendPivotViewLocalMutation } from './commands/mutations/pivot-data-communication.mutation';
 export { RemovePivotFieldMutation } from './commands/mutations/remove-pivot-field.mutation';
 export { RemovePivotTableMutation } from './commands/mutations/remove-pivot-table.mutation';
 export { RenamePivotFieldMutation } from './commands/mutations/rename-pivot-field.mutation';
@@ -54,12 +57,15 @@ export { UpdateValuePositionMutation } from './commands/mutations/update-value-p
 export { SHEETS_PIVOT_PLUGIN_CONFIG_KEY } from './config/config';
 export type { IUniverSheetsPivotConfig } from './config/config';
 export { BLANK_ROW_COUNT, getAdjustRangesPosition, PivotDisplayDataType, PositionType, SHEET_PIVOT_TABLE_PLUGIN, } from './const/const';
-export type { IAddPivotTableMutationParams, IPivotCellPositionInfo, IPivotPanelDataInfo, IPivotPanelSourceList, IPivotPanelTableListItemBase, IPivotRangesInfo, IPivotTableAddedEventParams, IPivotTableCellData, IPivotTableConfig, IPivotTableMatrixInfo, IPivotTableMovedEventParams, IPivotTableRemovedEventParams, IPivotTableRenderedEventParams, IPivotViewUpdateInfo, IRemovePivotTableMutationParams, ISetPivotLayoutMutationParams, ISetPivotOptionMutationParams, IUnitRangeNameWithSubUnitId, } from './const/type';
+export type { IAddPivotTableMutationParams, IPivotCellPositionInfo, IPivotPanelDataInfo, IPivotPanelSourceList, IPivotPanelTableListItemBase, IPivotRangesInfo, IPivotReportScope, IPivotTableAddedEventParams, IPivotTableCellData, IPivotTableConfig, IPivotTableMatrixInfo, IPivotTableMovedEventParams, IPivotTableRemovedEventParams, IPivotTableRenderedEventParams, IPivotViewUpdateInfo, IRemovePivotTableMutationParams, ISendPivotViewLocalMutationParams, ISetPivotLayoutMutationParams, ISetPivotOptionMutationParams, IUnitRangeNameWithSubUnitId, } from './const/type';
+export { PivotCalculatorController } from './controllers/sheets-pivot-caculate.controller';
 export { mapPivotSheetColumn, mapPivotSheetRange } from './models/pivot-sheet-projection';
 export { SheetsPivotTableConfigModel } from './models/sheets-pivot-config-model';
+export { SheetsPivotDataSourceModel } from './models/sheets-pivot-data-source-model';
 export { SheetsPivotTableAdaptorModel } from './models/sheets-pivot-table-adaptor-model';
 export { UniverSheetsPivotTablePlugin } from './plugin';
+export { SheetsPivotCacheService } from './services/sheets-pivot-cache.service';
 export { SheetsPivotRPCService } from './services/sheets-pivot-rpc.service';
 export { SheetsPivotTableService } from './services/sheets-pivot-table.service';
 export type { IPivotSheetCellContext, IPivotValueFilterTarget } from './util';
-export { generateSetRangeValueMutations, getEmptyPivotRanges, getPivotAppliedRanges, resolvePivotSheetCell, resolvePivotValueFieldId, resolvePivotValueFilterTarget, unionPivotViewRange, } from './util';
+export { generateSetRangeValueMutations, getDateGroupName, getEmptyPivotRanges, getPivotAppliedRanges, resolvePivotSheetCell, resolvePivotValueFieldId, resolvePivotValueFilterTarget, setPivotDateSystem, unionPivotViewRange, } from './util';

package/lib/types/models/sheets-pivot-data-field-manager.d.ts

@@ -1,7 +1,7 @@
 import type { IDataFieldValue, IFieldsCollectionJSON, PivotSubtotalTypeEnum } from '@univerjs-pro/engine-pivot';
 import type { ICellData, IRange, IUnitRangeName, IUniverInstanceService, Nullable, ObjectMatrix, Styles, Worksheet } from '@univerjs/core';
 import type { IRuntimeUnitDataType } from '@univerjs/engine-formula';
-import type { ICurrentDataMatrix, IDataFieldManagerJSON, IPivotCellPositionInfo, IUnitRangeNameWithSubUnitId, IUpdateInfo } from '../const/type';
+import type { ICurrentDataMatrix, IDataFieldManagerJSON, IPivotCellPositionInfo, IPivotReportScope, IUnitRangeNameWithSubUnitId, IUpdateInfo } from '../const/type';
 import type { SheetsPivotDataSourceModel } from './sheets-pivot-data-source-model';
 import { DataField, DataFieldManager, FieldsCollection } from '@univerjs-pro/engine-pivot';
 interface IFeatureDirtyRangeType {
@@ -14,6 +14,7 @@ export declare class SheetsPivotDataFieldManager extends DataFieldManager {
      * the key is pivot table id, the value is the data range info. those data range is one-to-one with the pivot table
      */
     rangeKeyMap: Record<string, string>;
+    private _reportScopeMap;
     private _univerInstanceService;
     _host: SheetsPivotDataSourceModel;
     constructor(host: SheetsPivotDataSourceModel, univerInstanceService: IUniverInstanceService);
@@ -30,7 +31,7 @@ export declare class SheetsPivotDataFieldManager extends DataFieldManager {
     getDataFieldByRangeKey(rangeKey: string): DataField | undefined;
     setRangeKeyMap(rangeKey: string, dataFieldId: string): void;
     updateRangeKeyMap(oldRangeKey: string, newRangeKey: string): void;
-    addCollectionByJSON(token: string, collectionJSON: IFieldsCollectionJSON, sourceRangeInfo: IUnitRangeNameWithSubUnitId, targetCellInfo: IPivotCellPositionInfo): IUpdateInfo;
+    addCollectionByJSON(token: string, collectionJSON: IFieldsCollectionJSON, sourceRangeInfo: IUnitRangeNameWithSubUnitId, targetCellInfo?: IPivotCellPositionInfo, reportScope?: IPivotReportScope): IUpdateInfo;
     getRangeStartEndInfo(range: IRange, sheet: Worksheet): IRange;
     /**
      * - when add pivot table, we should create a collection with data range first
@@ -41,7 +42,7 @@ export declare class SheetsPivotDataFieldManager extends DataFieldManager {
     _getAutoName(colIndex: number): string;
     uniqueDataFieldName(name: IDataFieldValue, colIndex: number): string;
     getCollection(token: string): FieldsCollection;
-    addCollection(token: string, collection: FieldsCollection, sourceRangeInfo: IUnitRangeNameWithSubUnitId, targetCellInfo: IPivotCellPositionInfo): void;
+    addCollection(token: string, collection: FieldsCollection, sourceRangeInfo: IUnitRangeNameWithSubUnitId, targetCellInfo?: IPivotCellPositionInfo, reportScope?: IPivotReportScope): void;
     handleMoveRange(token: string, sourceRangeInfo: IUnitRangeNameWithSubUnitId): void;
     getPivotDirtyViewInfo(): {
         runtimeCellData: IRuntimeUnitDataType;

package/lib/types/models/sheets-pivot-data-source-model.d.ts

@@ -1,11 +1,13 @@
 import type { DataField, FieldsCollection, IFieldsCollectionJSON, IPivotTableSnapshot, PivotView } from '@univerjs-pro/engine-pivot';
+import type { IPivotCacheHandle } from '@univerjs-pro/pivot-cache';
 import type { IUnitRangeName, Nullable } from '@univerjs/core';
 import type { IMoveRangeMutationParams } from '@univerjs/sheets';
-import type { ICollectionChangeInfo, IDataFieldManagerJSON, IPivotCellPositionInfo, IPivotMutationDirtyViewInfo, IPivotTableConfig, IPivotTableJson, IPivotWorkerItemCache, ISendPivotConfigLocalMutationParams, IUnitRangeNameWithSubUnitId, IUpdateInfo } from '../const/type';
+import type { ICollectionChangeInfo, IDataFieldManagerJSON, IPivotCellPositionInfo, IPivotMutationDirtyViewInfo, IPivotReportScope, IPivotTableConfig, IPivotTableJson, IPivotWorkerItemCache, ISendPivotConfigLocalMutationParams, IUnitRangeNameWithSubUnitId, IUpdateInfo } from '../const/type';
 import type { IViewTranslateCtx } from './view-util';
 import { PivotTable } from '@univerjs-pro/engine-pivot';
 import { Disposable, ICommandService, Injector, IResourceManagerService, IUniverInstanceService, LifecycleService } from '@univerjs/core';
 import { PivotTableOperationEnum } from '../const/type';
+import { SheetsPivotCacheService } from '../services/sheets-pivot-cache.service';
 import { SheetsPivotDataFieldManager } from './sheets-pivot-data-field-manager';
 export declare class SheetsPivotDataSourceModel extends Disposable {
     private readonly _injector;
@@ -13,6 +15,7 @@ export declare class SheetsPivotDataSourceModel extends Disposable {
     readonly _lifecycleService: LifecycleService;
     private readonly _commandService;
     private _resourceManagerService;
+    private readonly _sheetsPivotCacheService;
     private _model;
     private _pivotTableInstanceCache;
     private _viewData;
@@ -37,7 +40,7 @@ export declare class SheetsPivotDataSourceModel extends Disposable {
      * - this property is used to store the dirty pivot table collection which need to be marked dirty when mutations is executed
      */
     private _queryingMap;
-    constructor(_injector: Injector, _univerInstanceService: IUniverInstanceService, _lifecycleService: LifecycleService, _commandService: ICommandService, _resourceManagerService: IResourceManagerService);
+    constructor(_injector: Injector, _univerInstanceService: IUniverInstanceService, _lifecycleService: LifecycleService, _commandService: ICommandService, _resourceManagerService: IResourceManagerService, _sheetsPivotCacheService: SheetsPivotCacheService);
     getTextInfo(): Record<string, string>;
     setTextInfo(textInfo: Record<string, string>, direction: 'ltr' | 'rtl'): void;
     handleMoveRange(params: IMoveRangeMutationParams): void;
@@ -62,6 +65,7 @@ export declare class SheetsPivotDataSourceModel extends Disposable {
     addPivotTable(unitId: string, subUnitId: string, pivotTableId: string, pivotTable: PivotTable, pivotTableConfig: IPivotTableConfig): void;
     removePivotTable(unitId: string, subUnitId: string, pivotTableId: string): void;
     setPivotTable(unitId: string, subUnitId: string, pivotTableId: string, pivotTableConfig: IPivotTableConfig): void;
+    updatePivotTableSourceRange(unitId: string, subUnitId: string, pivotTableId: string, sourceRangeInfo: IUnitRangeNameWithSubUnitId, preferredPivotCacheId?: string): boolean;
     getPivotTableConfig(unitId: string, subUnitId: string, pivotTableId: string): IPivotTableConfig | undefined;
     /**
      * - get the pivot table model json config
@@ -72,8 +76,10 @@ export declare class SheetsPivotDataSourceModel extends Disposable {
      */
     getPivotTableModelConfig(unitId: string, subUnitId: string, pivotTableId: string): IPivotTableSnapshot | undefined;
     getPivotTableInstance(pivotTableId: string): PivotTable | undefined;
+    getPivotCacheId(unitId: string, pivotTableId: string): string | undefined;
+    getPivotCacheHandle(unitId: string, pivotTableId: string): IPivotCacheHandle | undefined;
     deleteUnitId(unitId: string): void;
-    addCollectionByJSON(token: string, collectionJSON: IFieldsCollectionJSON, sourceRangeInfo: IUnitRangeNameWithSubUnitId, targetCellInfo: IPivotCellPositionInfo): IUpdateInfo;
+    addCollectionByJSON(token: string, collectionJSON: IFieldsCollectionJSON, sourceRangeInfo: IUnitRangeNameWithSubUnitId, targetCellInfo?: IPivotCellPositionInfo, reportScope?: IPivotReportScope): IUpdateInfo;
     /**
      * - this function just create a collection with data range info, but wil not add it to the dataFieldManager
      */
@@ -84,6 +90,7 @@ export declare class SheetsPivotDataSourceModel extends Disposable {
     }[], dataRangeInfo: IUnitRangeNameWithSubUnitId): void;
     removeDataField(unitId: string, dataFieldId: string): void;
     removeCollections(unitId: string, token: string): void;
+    syncCollectionConfig(unitId: string): void;
     getSubUnitPivotConfigs(unitId: string, subUnitId: string): Map<string, IPivotTableConfig> | undefined;
     getTargetByPivotId(pivotTableId: string): {
         unitId: string;

package/lib/types/plugin.d.ts

@@ -1,6 +1,6 @@
+import type { IUniverSheetsPivotConfig } from './config/config';
 import { ICommandService, IConfigService, Injector, Plugin, UniverInstanceType } from '@univerjs/core';
 import { DataSyncPrimaryController } from '@univerjs/rpc';
-import type { IUniverSheetsPivotConfig } from './config/config';
 export declare class UniverSheetsPivotTablePlugin extends Plugin {
     private readonly _config;
     readonly _injector: Injector;

package/lib/types/services/sheets-pivot-cache.service.d.ts

@@ -0,0 +1,35 @@
+import type { DataFieldManager } from '@univerjs-pro/engine-pivot';
+import type { IPivotCacheHandle } from '@univerjs-pro/pivot-cache';
+import type { ISheetsPivotCacheSnapshot, IUnitRangeNameWithSubUnitId } from '../const/type';
+import { Disposable, IUniverInstanceService } from '@univerjs/core';
+export interface ISheetsPivotCacheRefreshPayload {
+    dirtyFieldIds: readonly string[];
+    previousFieldNames: Readonly<Record<string, string>>;
+}
+export interface ISheetsPivotCacheRefreshResult extends ISheetsPivotCacheRefreshPayload {
+    pivotCacheId: string;
+    revision: number;
+}
+export declare class SheetsPivotCacheService extends Disposable {
+    private readonly _univerInstanceService;
+    private readonly _cacheById;
+    private readonly _cacheBySourceKey;
+    private readonly _reportBindings;
+    private readonly _refreshCycleCache;
+    constructor(_univerInstanceService: IUniverInstanceService);
+    acquireForReport(reportUnitId: string, reportId: string, sourceRangeInfo: IUnitRangeNameWithSubUnitId, dataFieldManager: DataFieldManager, preferredPivotCacheId?: string): IPivotCacheHandle;
+    releaseReport(reportUnitId: string, reportId: string): void;
+    acquireById(ownerUnitId: string, pivotCacheId: string): IPivotCacheHandle;
+    getReportPivotCacheId(reportUnitId: string, reportId: string): string | undefined;
+    getReportHandle(reportUnitId: string, reportId: string): IPivotCacheHandle | undefined;
+    toJSON(unitId: string): Record<string, ISheetsPivotCacheSnapshot>;
+    fromJSON(unitId: string, snapshots: Record<string, ISheetsPivotCacheSnapshot>, dataFieldManager: DataFieldManager): void;
+    pruneUnreferenced(unitId: string): void;
+    deleteUnitId(unitId: string): void;
+    refreshOnce(pivotCacheId: string, cycleKey: object, refresh: () => ISheetsPivotCacheRefreshPayload): ISheetsPivotCacheRefreshResult;
+    dispose(): void;
+    private _normalizeSource;
+    private _createRecord;
+    private _createHandle;
+    private _deleteRecordIfUnused;
+}

package/lib/types/services/sheets-pivot-unit-cache.provider.d.ts

@@ -0,0 +1,10 @@
+import type { IPivotCacheHandle, IPivotCacheProvider, IPivotCacheReference, IUnitPivotCacheReference } from '@univerjs-pro/pivot-cache';
+import { PivotCacheReferenceKindEnum } from '@univerjs-pro/pivot-cache';
+import { SheetsPivotCacheService } from './sheets-pivot-cache.service';
+export declare class SheetsPivotUnitCacheProvider implements IPivotCacheProvider<IUnitPivotCacheReference> {
+    private readonly _cacheService;
+    readonly kind = PivotCacheReferenceKindEnum.Unit;
+    constructor(_cacheService: SheetsPivotCacheService);
+    isReference(reference: IPivotCacheReference): reference is IUnitPivotCacheReference;
+    acquire(reference: IUnitPivotCacheReference): IPivotCacheHandle;
+}