@univerjs-pro/engine-formula 1.0.3 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -69,6 +69,7 @@ export declare class DependencyEngine {
69
69
  private _tarjanEpoch;
70
70
  private readonly _propQueue;
71
71
  private readonly _dirtyList;
72
+ private _calculationGraphNodeMask;
72
73
  private _activeNodeCount;
73
74
  private _dirtyNodeCount;
74
75
  private _directPointIndex;
@@ -237,7 +238,10 @@ export declare class DependencyEngine {
237
238
  */
238
239
  getCalculationOrder(options?: {
239
240
  detectCycles?: boolean;
241
+ circularOnly?: boolean;
240
242
  }): ICalculationOrderResult;
243
+ markIterationSettingsChanged(unitIds: string[]): void;
244
+ private _getNodeUnitId;
241
245
  clearCalculatedDirty(indices: CalcNodeIndex[]): void;
242
246
  private _compactDirtyList;
243
247
  clearAllDirty(): void;
@@ -37,13 +37,13 @@ export declare class FormulaDependencyProGenerator extends FormulaDependencyGene
37
37
  clearCachedCalculationNodeData(): void;
38
38
  clearCachedCalculationTree(): void;
39
39
  getCachedCalculationNodeData(nodeIndex: number): IFormulaCalculationNodeData | undefined;
40
- getCalculationOrder(): import("./dependency-engine/types").ICalculationOrderResult;
40
+ getCalculationOrder(circularOnly?: boolean): import("./dependency-engine/types").ICalculationOrderResult;
41
41
  getSharedFormulaCompressionMetrics(): ISharedFormulaCompressionMetrics;
42
42
  hasDynamicDepsByIndex(nodeIndex: number): boolean;
43
43
  refreshDynamicDepsByIndex(nodeIndex: number, resolver: IDynamicResolver): boolean;
44
44
  hasUncalculatedDirtyPrecedentByIndex(nodeIndex: number, calculatedNodeIndices: ReadonlySet<number>): boolean;
45
45
  getAllDependencyJson(): Promise<IFormulaDependencyTreeJson[]>;
46
- generatePro(isCalculateTreeModel?: boolean): Promise<{
46
+ generatePro(isCalculateTreeModel?: boolean, circularOnly?: boolean): Promise<{
47
47
  calculationOrderResult: import("./dependency-engine/types").ICalculationOrderResult;
48
48
  dependencyTree: Map<number, IFormulaCalculationTree>;
49
49
  }>;
@@ -14,6 +14,8 @@ export type { IFormulaLastValue } from './models/formula-last-value';
14
14
  export { HOST_EXTERNAL_REFERENCE_SCHEMA_VERSION, HostExternalReferenceModel, normalizeHostExternalReferenceQualifier, UNIVER_EXTERNAL_REFERENCE_PLUGIN, } from './models/host-external-reference.model';
15
15
  export type { HostExternalReferenceBindingResult, IHostExternalReference, IHostExternalReferenceResource, } from './models/host-external-reference.model';
16
16
  export { UniverProFormulaEnginePlugin } from './plugin';
17
+ export type { CalculateFormulaProService } from './services/calculate-formula.service';
18
+ export type { DependencyManagerProService } from './services/dependency-manager.service';
17
19
  export { ExternalCacheReferenceDataProvider } from './services/external-cache-reference-data.provider';
18
20
  export { ExternalReferencePrefetchPlanner } from './services/external-reference-prefetch-planner';
19
21
  export { ExternalReferencePrefetchService } from './services/external-reference-prefetch.service';
@@ -7,16 +7,19 @@ export declare class CalculateFormulaProService extends CalculateFormulaService
7
7
  private readonly _externalReferenceDataLoader;
8
8
  private _dynamicRuntimeRanges;
9
9
  private _runtimeExternalDataLoaded;
10
+ private _calculateCircularOnly;
10
11
  constructor(configService: IConfigService, lexer: Lexer, currentConfigService: IFormulaCurrentConfigService, runtimeService: IFormulaRuntimeService, formulaDependencyGenerator: IFormulaDependencyGenerator, interpreter: Interpreter, astTreeBuilder: AstTreeBuilder, _externalReferenceDataLoader: IFormulaExternalReferenceDataLoader);
11
12
  execute(formulaDatasetConfig: IFormulaDatasetConfig): Promise<void>;
12
- protected _executeStep(cycleReferenceCount?: number): Promise<true | undefined>;
13
- protected _apply(isArrayFormulaState?: boolean, cycleReferenceCount?: number): Promise<import("@univerjs/engine-formula").IAllRuntimeData | undefined>;
13
+ /** Discover base-revision dependencies and cached cycles without executing a circular iteration. */
14
+ initializeChangesetDependencies(config: IFormulaDatasetConfig): Promise<IFormulaCalculationTree[]>;
15
+ protected _executeStep(): Promise<true | undefined>;
16
+ protected _apply(isArrayFormulaState?: boolean): Promise<import("@univerjs/engine-formula").IAllRuntimeData | undefined>;
17
+ private _clearPlannedCircularReferenceCells;
14
18
  private _setFormulaExecuteStage;
15
19
  private _setTotalFormulasToCalculate;
16
20
  private _shouldRescheduleAfterDynamicChange;
17
- protected _forEachCalculationPlanTree(calculationOrderResult: Pick<ICalculationOrderResult, 'calculationForest'>, dependencyTree: Map<CalcNodeIndex, IFormulaCalculationTree>, cycleReferenceCount: number, visitor: (tree: IFormulaCalculationTree, nodeIndex: CalcNodeIndex, cycleIndex?: number, shouldPreserveCycleTree?: boolean) => Promise<boolean | void>): Promise<void>;
18
- private _calculationPlanHasSelfReference;
19
- protected _getCalculationPlanTreeCount(calculationOrderResult: Pick<ICalculationOrderResult, 'calculationForest'>, dependencyTree: Map<CalcNodeIndex, IFormulaCalculationTree>, cycleReferenceCount: number): number;
21
+ protected _forEachCalculationPlanTree(calculationOrderResult: Pick<ICalculationOrderResult, 'calculationForest'>, dependencyTree: Map<CalcNodeIndex, IFormulaCalculationTree>, visitor: (tree: IFormulaCalculationTree, nodeIndex: CalcNodeIndex, cycleIndex?: number, shouldPreserveCycleTree?: boolean) => Promise<boolean | void>): Promise<void>;
22
+ protected _getCalculationPlanTreeCount(calculationOrderResult: Pick<ICalculationOrderResult, 'calculationForest'>, dependencyTree: Map<CalcNodeIndex, IFormulaCalculationTree>): number;
20
23
  protected _getDynamicResolver(): IDynamicResolver | undefined;
21
24
  private _refreshDynamicDepsAfterCalculate;
22
25
  private _collectAddressFunctionRuntimeReferences;
@@ -31,6 +31,7 @@ export declare class DependencyManagerProService extends DependencyManagerBaseSe
31
31
  markIndicesChanged(indices: number[], options?: {
32
32
  onlySelf?: boolean;
33
33
  }): void;
34
+ markIterationSettingsChanged(unitIds: string[]): void;
34
35
  markRangesChanged(ranges: IUnitRange[], options?: {
35
36
  includeFormulaCells?: boolean;
36
37
  coalesce?: boolean;
@@ -40,6 +41,8 @@ export declare class DependencyManagerProService extends DependencyManagerBaseSe
40
41
  markDirtySheetNames(dirtyNameMap: IDirtyUnitSheetNameMap): void;
41
42
  markAllDirty(): void;
42
43
  clearCalculatedDirty(indices: number[]): void;
44
+ clearAllDirty(): void;
45
+ invalidateFormulaCell(unitId: string, sheetId: string, row: number, column: number): void;
43
46
  hasDynamicDeps(node: ICalcNodeRef): boolean;
44
47
  hasDynamicDepsByIndex(nodeIndex: number): boolean;
45
48
  refreshDynamicDeps(node: ICalcNodeRef, resolver: IDynamicResolver): boolean;
@@ -50,5 +53,6 @@ export declare class DependencyManagerProService extends DependencyManagerBaseSe
50
53
  prepareDynamicDependencies(resolver: IDynamicResolver): boolean;
51
54
  getCalculationOrder(options?: {
52
55
  detectCycles?: boolean;
56
+ circularOnly?: boolean;
53
57
  }): import("../engine/dependency-engine/types").ICalculationOrderResult;
54
58
  }
package/lib/umd/facade.js CHANGED
@@ -1 +1 @@
1
- function _0x12fd(){var _0x14f623=['1673931lylqGT','amd','3JOMHMZ','removeExternalReference','buildReference','unitId','toStringTag','Module','1075302vjqJSm','extend','object','4429988JwFaBh','_commandService','UniverProEngineFormulaFacade','SHEET_RANGE','24ZHoVeK','FEnum','FFormula','@univerjs/engine-formula/facade','UNIVER_BASE','70NBPMjW','UniverEngineFormulaFacade','Formula\x20reference\x20authoring\x20requires\x20stable\x20Host\x20and\x20Source\x20Unit\x20IDs.','UniverInstanceType','function','formulaQualifier','6630435JXkMdg','UNIVER_SHEET','Failed\x20to\x20bind\x20external\x20formula\x20reference\x20\x22','9872022oorMhV','258032GmEAnp','kind','defineProperty','UniverCoreFacade','@univerjs/core','syncExecuteCommand','upsertExternalReference','3687341MzPSCV','FormulaReferenceType'];_0x12fd=function(){return _0x14f623;};return _0x12fd();}function _0x1797(_0x17f5ff,_0x52ff3f){_0x17f5ff=_0x17f5ff-0x132;var _0x12fd05=_0x12fd();var _0x1797d2=_0x12fd05[_0x17f5ff];return _0x1797d2;}(function(_0x2ccfbf,_0x5632b1){var _0x43c657=_0x1797,_0x27616c=_0x2ccfbf();while(!![]){try{var _0x4fc8b2=parseInt(_0x43c657(0x148))/0x1+-parseInt(_0x43c657(0x13f))/0x2+parseInt(_0x43c657(0x14a))/0x3*(-parseInt(_0x43c657(0x153))/0x4)+parseInt(_0x43c657(0x13b))/0x5+-parseInt(_0x43c657(0x13e))/0x6+-parseInt(_0x43c657(0x146))/0x7*(-parseInt(_0x43c657(0x157))/0x8)+-parseInt(_0x43c657(0x150))/0x9*(parseInt(_0x43c657(0x135))/0xa);if(_0x4fc8b2===_0x5632b1)break;else _0x27616c['push'](_0x27616c['shift']());}catch(_0xf5bce0){_0x27616c['push'](_0x27616c['shift']());}}}(_0x12fd,0xd279f),function(_0x502131,_0xd1df30){var _0x58d4c2=_0x1797;typeof exports==_0x58d4c2(0x152)&&typeof module<'u'?_0xd1df30(exports,require('@univerjs/engine-formula/facade'),require('@univerjs-pro/engine-formula'),require('@univerjs/core/facade'),require('@univerjs/core')):typeof define==_0x58d4c2(0x139)&&define[_0x58d4c2(0x149)]?define(['exports',_0x58d4c2(0x133),'@univerjs-pro/engine-formula','@univerjs/core/facade',_0x58d4c2(0x143)],_0xd1df30):(_0x502131=typeof globalThis<'u'?globalThis:_0x502131||self,_0xd1df30(_0x502131[_0x58d4c2(0x155)]={},_0x502131[_0x58d4c2(0x136)],_0x502131['UniverProEngineFormula'],_0x502131[_0x58d4c2(0x142)],_0x502131['UniverCore']));}(this,function(_0x8a7407,_0x222c0a,_0x5a4a49,_0x571131,_0x31f218){var _0x4c9141=_0x1797;Object[_0x4c9141(0x141)](_0x8a7407,Symbol[_0x4c9141(0x14e)],{'value':_0x4c9141(0x14f)});var _0x1c0955=class extends _0x571131['FEnum']{get[_0x4c9141(0x147)](){var _0x2078cd=_0x4c9141;return _0x5a4a49[_0x2078cd(0x147)];}};_0x571131[_0x4c9141(0x158)]['extend'](_0x1c0955);var _0x1d74d4=class extends _0x222c0a['FFormula']{[_0x4c9141(0x14c)](_0x4bcf47){var _0x4dd930=_0x4c9141;let {hostUnitId:_0x299132,unit:_0x4c505b,target:_0x3aafdf}=_0x4bcf47;if(!_0x299132||!_0x4c505b[_0x4dd930(0x14d)])throw Error(_0x4dd930(0x137));if(_0x4c505b[_0x4dd930(0x14d)]!==_0x299132&&!this['_commandService'][_0x4dd930(0x144)](_0x5a4a49['UpsertHostExternalReferenceCommand']['id'],{'unitId':_0x299132,'qualifier':_0x4c505b[_0x4dd930(0x13a)],'sourceUnitId':_0x4c505b[_0x4dd930(0x14d)],'sourceUnitType':_0x3aafdf[_0x4dd930(0x140)]===_0x5a4a49[_0x4dd930(0x147)][_0x4dd930(0x156)]?_0x31f218[_0x4dd930(0x138)][_0x4dd930(0x13c)]:_0x31f218[_0x4dd930(0x138)][_0x4dd930(0x134)]}))throw Error(_0x4dd930(0x13d)+_0x4c505b[_0x4dd930(0x13a)]+'\x22.');return(0x0,_0x5a4a49['buildFormulaReference'])(_0x4bcf47);}[_0x4c9141(0x145)](_0x49165b){var _0x1cd0ca=_0x4c9141;return this[_0x1cd0ca(0x154)]['syncExecuteCommand'](_0x5a4a49['UpsertHostExternalReferenceCommand']['id'],_0x49165b);}[_0x4c9141(0x14b)](_0x7d60fb){var _0x1e3384=_0x4c9141;return this['_commandService'][_0x1e3384(0x144)](_0x5a4a49['RemoveHostExternalReferenceCommand']['id'],_0x7d60fb);}};_0x222c0a[_0x4c9141(0x132)][_0x4c9141(0x151)](_0x1d74d4),Object[_0x4c9141(0x141)](_0x8a7407,_0x4c9141(0x132),{'enumerable':!0x0,'get':function(){var _0x41ee77=_0x4c9141;return _0x222c0a[_0x41ee77(0x132)];}});}));
1
+ function _0x555e(_0x45fef6,_0x220e6c){_0x45fef6=_0x45fef6-0x7c;var _0x13a56b=_0x13a5();var _0x555eab=_0x13a56b[_0x45fef6];return _0x555eab;}(function(_0x516222,_0x48dfe2){var _0x5c80b0=_0x555e,_0x52b475=_0x516222();while(!![]){try{var _0x586b0b=-parseInt(_0x5c80b0(0x7f))/0x1*(-parseInt(_0x5c80b0(0x84))/0x2)+parseInt(_0x5c80b0(0x99))/0x3*(-parseInt(_0x5c80b0(0x9f))/0x4)+parseInt(_0x5c80b0(0x95))/0x5*(parseInt(_0x5c80b0(0x7d))/0x6)+parseInt(_0x5c80b0(0x89))/0x7+-parseInt(_0x5c80b0(0x85))/0x8+-parseInt(_0x5c80b0(0x9d))/0x9*(parseInt(_0x5c80b0(0x8f))/0xa)+-parseInt(_0x5c80b0(0x8e))/0xb;if(_0x586b0b===_0x48dfe2)break;else _0x52b475['push'](_0x52b475['shift']());}catch(_0x4ad536){_0x52b475['push'](_0x52b475['shift']());}}}(_0x13a5,0x918c9),function(_0x2d3c0e,_0xbd2d26){var _0x860358=_0x555e;typeof exports==_0x860358(0x8d)&&typeof module<'u'?_0xbd2d26(exports,require('@univerjs/engine-formula/facade'),require('@univerjs-pro/engine-formula'),require('@univerjs/core/facade'),require('@univerjs/core')):typeof define==_0x860358(0x91)&&define['amd']?define([_0x860358(0x9c),'@univerjs/engine-formula/facade',_0x860358(0x82),'@univerjs/core/facade',_0x860358(0x83)],_0xbd2d26):(_0x2d3c0e=typeof globalThis<'u'?globalThis:_0x2d3c0e||self,_0xbd2d26(_0x2d3c0e[_0x860358(0x92)]={},_0x2d3c0e[_0x860358(0x96)],_0x2d3c0e[_0x860358(0x94)],_0x2d3c0e[_0x860358(0xa2)],_0x2d3c0e[_0x860358(0x86)]));}(this,function(_0x23db3a,_0x265fd2,_0x3d9745,_0x273100,_0xe0a3e2){var _0x56376c=_0x555e;Object[_0x56376c(0x9b)](_0x23db3a,Symbol['toStringTag'],{'value':_0x56376c(0x9e)});var _0x573fa5=class extends _0x273100[_0x56376c(0x90)]{get[_0x56376c(0xa0)](){var _0x303859=_0x56376c;return _0x3d9745[_0x303859(0xa0)];}};_0x273100[_0x56376c(0x90)][_0x56376c(0x93)](_0x573fa5);var _0x202f42=class extends _0x265fd2[_0x56376c(0x97)]{[_0x56376c(0x8b)](_0x240101){var _0x3ff7ed=_0x56376c;let {hostUnitId:_0x51a464,unit:_0xa6d2f3,target:_0x13334a}=_0x240101;if(!_0x51a464||!_0xa6d2f3['unitId'])throw Error('Formula\x20reference\x20authoring\x20requires\x20stable\x20Host\x20and\x20Source\x20Unit\x20IDs.');if(_0xa6d2f3[_0x3ff7ed(0x9a)]!==_0x51a464&&!this['_commandService']['syncExecuteCommand'](_0x3d9745['UpsertHostExternalReferenceCommand']['id'],{'unitId':_0x51a464,'qualifier':_0xa6d2f3[_0x3ff7ed(0x80)],'sourceUnitId':_0xa6d2f3[_0x3ff7ed(0x9a)],'sourceUnitType':_0x13334a[_0x3ff7ed(0x98)]===_0x3d9745['FormulaReferenceType']['SHEET_RANGE']?_0xe0a3e2[_0x3ff7ed(0x8c)][_0x3ff7ed(0x87)]:_0xe0a3e2[_0x3ff7ed(0x8c)][_0x3ff7ed(0x81)]}))throw Error(_0x3ff7ed(0x7e)+_0xa6d2f3[_0x3ff7ed(0x80)]+'\x22.');return(0x0,_0x3d9745['buildFormulaReference'])(_0x240101);}[_0x56376c(0x8a)](_0x6f9caa){var _0x56939d=_0x56376c;return this['_commandService']['syncExecuteCommand'](_0x3d9745[_0x56939d(0x7c)]['id'],_0x6f9caa);}['removeExternalReference'](_0x2bf828){var _0x3cd4e1=_0x56376c;return this[_0x3cd4e1(0xa1)][_0x3cd4e1(0x88)](_0x3d9745[_0x3cd4e1(0xa3)]['id'],_0x2bf828);}};_0x265fd2['FFormula'][_0x56376c(0x93)](_0x202f42),Object[_0x56376c(0x9b)](_0x23db3a,_0x56376c(0x97),{'enumerable':!0x0,'get':function(){var _0x239bf5=_0x56376c;return _0x265fd2[_0x239bf5(0x97)];}});}));function _0x13a5(){var _0x35ebdb=['1112297jJpcUn','formulaQualifier','UNIVER_BASE','@univerjs-pro/engine-formula','@univerjs/core','2EyiZYp','3213792ZvMQWc','UniverCore','UNIVER_SHEET','syncExecuteCommand','1012081yYYTIW','upsertExternalReference','buildReference','UniverInstanceType','object','1939014lxzzLh','10dNRsHG','FEnum','function','UniverProEngineFormulaFacade','extend','UniverProEngineFormula','10mtSHEJ','UniverEngineFormulaFacade','FFormula','kind','6PidEdL','unitId','defineProperty','exports','4181283oanwnT','Module','102464YrheGw','FormulaReferenceType','_commandService','UniverCoreFacade','RemoveHostExternalReferenceCommand','UpsertHostExternalReferenceCommand','1299318dbectg','Failed\x20to\x20bind\x20external\x20formula\x20reference\x20\x22'];_0x13a5=function(){return _0x35ebdb;};return _0x13a5();}