@univerjs/engine-formula 0.13.0-insiders.20251218-2062647 → 0.13.0-insiders.20251223-857805c

package/lib/es/facade.js

@@ -1,15 +1,15 @@
-import { FBase as C, FUniver as f } from "@univerjs/core/facade";
-import { Inject as c, ICommandService as _, Injector as h, IConfigService as v } from "@univerjs/core";
-import { LexerTreeBuilder as g, IFunctionService as E, IDefinedNamesService as T, ISuperTableService as x, SetTriggerFormulaCalculationStartMutation as F, SetFormulaCalculationStopMutation as y, SetFormulaCalculationStartMutation as R, SetFormulaCalculationNotificationMutation as d, GlobalComputingStatusService as b, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT as w, SetFormulaCalculationResultMutation as D, SetFormulaStringBatchCalculationResultMutation as M, SetFormulaStringBatchCalculationMutation as I, SetFormulaDependencyCalculationResultMutation as N, SetFormulaDependencyCalculationMutation as P, SetCellFormulaDependencyCalculationResultMutation as B, SetCellFormulaDependencyCalculationMutation as L, SetQueryFormulaDependencyResultMutation as p, SetQueryFormulaDependencyMutation as S, ENGINE_FORMULA_RETURN_DEPENDENCY_TREE as A, SetQueryFormulaDependencyAllResultMutation as O, SetQueryFormulaDependencyAllMutation as U } from "@univerjs/engine-formula";
-import { firstValueFrom as j, race as Q, filter as q, timer as G, map as z } from "rxjs";
-var V = Object.getOwnPropertyDescriptor, Y = (e, t, i, r) => {
-  for (var n = r > 1 ? void 0 : r ? V(t, i) : t, a = e.length - 1, o; a >= 0; a--)
+import { FBase as h, FUniver as S } from "@univerjs/core/facade";
+import { Inject as c, ICommandService as _, Injector as v, IConfigService as g } from "@univerjs/core";
+import { LexerTreeBuilder as x, SetFormulaCalculationStartMutation as d, SetFormulaCalculationStopMutation as E, SetFormulaCalculationNotificationMutation as p, GlobalComputingStatusService as F, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT as T, SetFormulaCalculationResultMutation as y, SetFormulaStringBatchCalculationResultMutation as w, SetFormulaStringBatchCalculationMutation as R, SetFormulaDependencyCalculationResultMutation as M, SetFormulaDependencyCalculationMutation as b, SetCellFormulaDependencyCalculationResultMutation as D, SetCellFormulaDependencyCalculationMutation as I, SetQueryFormulaDependencyResultMutation as f, SetQueryFormulaDependencyMutation as C } from "@univerjs/engine-formula";
+import { firstValueFrom as P, race as B, filter as L, timer as N, map as O } from "rxjs";
+var A = Object.getOwnPropertyDescriptor, j = (e, t, i, r) => {
+  for (var n = r > 1 ? void 0 : r ? A(t, i) : t, a = e.length - 1, o; a >= 0; a--)
     (o = e[a]) && (n = o(n) || n);
   return n;
 }, u = (e, t) => (i, r) => t(i, r, e);
-let m = class extends C {
-  constructor(e, t, i, r, n, a, o) {
-    super(), this._commandService = e, this._injector = t, this._lexerTreeBuilder = i, this._configService = r, this._functionService = n, this._definedNamesService = a, this._superTableService = o, this._initialize();
+let m = class extends h {
+  constructor(e, t, i, r) {
+    super(), this._commandService = e, this._injector = t, this._lexerTreeBuilder = i, this._configService = r, this._initialize();
   }
   /**
    * @ignore
@@ -66,7 +66,7 @@ let m = class extends C {
    * ```
    */
   executeCalculation() {
-    this._commandService.executeCommand(F.id, { commands: [], forceCalculation: !0 }, { onlyLocal: !0 });
+    this._commandService.executeCommand(d.id, { commands: [], forceCalculation: !0 }, { onlyLocal: !0 });
   }
   /**
    * Stop the calculation of the formula.
@@ -78,7 +78,7 @@ let m = class extends C {
    * ```
    */
   stopCalculation() {
-    this._commandService.executeCommand(y.id, {});
+    this._commandService.executeCommand(E.id, {});
   }
   /**
    * Listening calculation starts.
@@ -95,7 +95,7 @@ let m = class extends C {
    */
   calculationStart(e) {
     return this._commandService.onCommandExecuted((t) => {
-      if (t.id === R.id) {
+      if (t.id === d.id) {
         const i = t.params;
         e(i.forceCalculation);
       }
@@ -116,7 +116,7 @@ let m = class extends C {
    */
   calculationEnd(e) {
     return this._commandService.onCommandExecuted((t) => {
-      if (t.id !== d.id)
+      if (t.id !== p.id)
         return;
       const i = t.params;
       i.functionsExecutedState !== void 0 && e(i.functionsExecutedState);
@@ -139,10 +139,10 @@ let m = class extends C {
    * ```
    */
   whenComputingCompleteAsync(e) {
-    const t = this._injector.get(b);
-    return t.computingStatus ? Promise.resolve(!0) : j(Q(
-      t.computingStatus$.pipe(q((i) => i)),
-      G(e != null ? e : 3e4).pipe(z(() => !1))
+    const t = this._injector.get(F);
+    return t.computingStatus ? Promise.resolve(!0) : P(B(
+      t.computingStatus$.pipe(L((i) => i)),
+      N(e != null ? e : 3e4).pipe(O(() => !1))
     ));
   }
   /**
@@ -173,7 +173,7 @@ let m = class extends C {
    */
   calculationProcessing(e) {
     return this._commandService.onCommandExecuted((t) => {
-      if (t.id !== d.id)
+      if (t.id !== p.id)
         return;
       const i = t.params;
       i.stageInfo !== void 0 && e(i.stageInfo);
@@ -192,7 +192,7 @@ let m = class extends C {
    * ```
    */
   setMaxIteration(e) {
-    this._configService.setConfig(w, e);
+    this._configService.setConfig(T, e);
   }
   /**
    * Listens for the moment when formula-calculation results are applied.
@@ -219,7 +219,7 @@ let m = class extends C {
    */
   calculationResultApplied(e) {
     return this._commandService.onCommandExecuted((t) => {
-      if (t.id !== D.id)
+      if (t.id !== y.id)
         return;
       const i = t.params;
       i !== void 0 && requestIdleCallback(() => {
@@ -344,7 +344,7 @@ let m = class extends C {
   executeFormulas(e, t = 3e4) {
     return new Promise((i, r) => {
       const n = this._commandService.onCommandExecuted((o) => {
-        if (o.id !== M.id)
+        if (o.id !== w.id)
           return;
         const s = o.params;
         clearTimeout(a), n.dispose(), s.result != null ? i(s.result) : r(new Error("Formula batch calculation returned no result"));
@@ -352,7 +352,7 @@ let m = class extends C {
         n.dispose(), r(new Error("Formula batch calculation timeout"));
       }, t);
       this._commandService.executeCommand(
-        I.id,
+        R.id,
         { formulas: e },
         { onlyLocal: !0 }
       );
@@ -382,7 +382,7 @@ let m = class extends C {
   getAllDependencyTrees(e = 3e4) {
     return new Promise((t, i) => {
       const r = this._commandService.onCommandExecuted((a) => {
-        if (a.id !== N.id)
+        if (a.id !== M.id)
           return;
         const o = a.params;
         clearTimeout(n), r.dispose(), o.result != null ? t(o.result) : t([]);
@@ -390,7 +390,7 @@ let m = class extends C {
         r.dispose(), i(new Error("Formula dependency calculation timeout"));
       }, e);
       this._commandService.executeCommand(
-        P.id,
+        b.id,
         void 0,
         { onlyLocal: !0 }
       );
@@ -433,7 +433,7 @@ let m = class extends C {
   getCellDependencyTree(e, t = 3e4) {
     return new Promise((i, r) => {
       const n = this._commandService.onCommandExecuted((o) => {
-        if (o.id !== B.id)
+        if (o.id !== D.id)
           return;
         const s = o.params;
         clearTimeout(a), n.dispose(), i(s.result);
@@ -441,7 +441,7 @@ let m = class extends C {
         n.dispose(), r(new Error("Cell dependency calculation timeout"));
       }, t);
       this._commandService.executeCommand(
-        L.id,
+        I.id,
         e,
         { onlyLocal: !0 }
       );
@@ -481,7 +481,7 @@ let m = class extends C {
   getRangeDependents(e, t = 3e4) {
     return new Promise((i, r) => {
       const n = this._commandService.onCommandExecuted((o) => {
-        if (o.id !== p.id)
+        if (o.id !== f.id)
           return;
         const s = o.params;
         clearTimeout(a), n.dispose(), s.result != null ? i(s.result) : i([]);
@@ -489,7 +489,7 @@ let m = class extends C {
         n.dispose(), r(new Error("Range dependents calculation timeout"));
       }, t);
       this._commandService.executeCommand(
-        S.id,
+        C.id,
         { unitRanges: e },
         { onlyLocal: !0 }
       );
@@ -533,7 +533,7 @@ let m = class extends C {
   getInRangeFormulas(e, t = 3e4) {
     return new Promise((i, r) => {
       const n = this._commandService.onCommandExecuted((o) => {
-        if (o.id !== p.id)
+        if (o.id !== f.id)
           return;
         const s = o.params;
         clearTimeout(a), n.dispose(), s.result != null ? i(s.result) : i([]);
@@ -541,207 +541,25 @@ let m = class extends C {
         n.dispose(), r(new Error("In-range formulas calculation timeout"));
       }, t);
       this._commandService.executeCommand(
-        S.id,
+        C.id,
         { unitRanges: e, isInRange: !0 },
         { onlyLocal: !0 }
       );
     });
   }
-  /**
-   * Enable or disable emitting formula dependency trees after each formula calculation.
-   *
-   * When enabled, the formula engine will emit the dependency trees produced by
-   * each completed formula calculation through the internal command system.
-   * Consumers can obtain the result by listening for the corresponding
-   * calculation-result command.
-   *
-   * When disabled, dependency trees will not be emitted.
-   *
-   * This option only controls whether dependency trees are exposed.
-   * It does not affect formula calculation behavior.
-   *
-   * @param {boolean} value
-   *        Whether to emit formula dependency trees after calculation.
-   *        - `true`: Emit dependency trees after each calculation.
-   *        - `false`: Do not emit dependency trees (default behavior).
-   *
-   * @example
-   * ```ts
-   * const formulaEngine = univerAPI.getFormula();
-   *
-   * // Enable dependency tree emission
-   * formulaEngine.setFormulaReturnDependencyTree(true);
-   *
-   * // Listen for dependency trees produced by formula calculation
-   * const trees = await new Promise<IFormulaDependencyTreeJson[]>((resolve, reject) => {
-   *   const timer = setTimeout(() => {
-   *     disposable.dispose();
-   *     reject(new Error('Timeout waiting for formula dependency trees'));
-   *   }, 30_000);
-   *
-   *   const disposable = commandService.onCommandExecuted((command) => {
-   *     if (command.id !== SetFormulaDependencyCalculationResultMutation.id) {
-   *       return;
-   *     }
-   *
-   *     clearTimeout(timer);
-   *     disposable.dispose();
-   *
-   *     const params = command.params as ISetFormulaDependencyCalculationResultMutation;
-   *     resolve(params.result ?? []);
-   *   });
-   * });
-   *
-   * console.log('Dependency trees:', trees);
-   * ```
-   */
-  setFormulaReturnDependencyTree(e) {
-    this._configService.setConfig(A, e);
-  }
-  /**
-   * Parse a formula string and return its **formula expression tree**.
-   *
-   * This API analyzes the syntactic structure of a formula and builds an
-   * expression tree that reflects how the formula is composed (functions,
-   * operators, ranges, and nested expressions), without performing calculation
-   * or dependency evaluation.
-   *
-   * The returned tree is suitable for:
-   * - Formula structure visualization
-   * - Explaining complex formulas (e.g. LET / LAMBDA)
-   * - Debugging or inspecting formula composition
-   * - Building advanced formula tooling
-   *
-   * ---
-   *
-   * @example
-   * ```ts
-   * const formulaEngine = univerAPI.getFormula();
-   *
-   * const formula = '=LET(x,SUM(A1,B1,A1:B10),y,OFFSET(A1:B10,0,1),SUM(x,y)+x)+1';
-   *
-   * const exprTree = formulaEngine.getFormulaExpressTree(formula);
-   *
-   * console.log(exprTree);
-   * ```
-   *
-   * Example output (simplified):
-   *
-   * ```json
-   * {
-   *   "value": "let(x,sum(A1,B1,A1:B10),y,offset(A1:B10,0,1),sum(x,y)+x)+1",
-   *   "children": [
-   *     {
-   *       "value": "let(x,sum(A1,B1,A1:B10),y,offset(A1:B10,0,1),sum(x,y)+x)",
-   *       "children": [
-   *         {
-   *           "value": "sum(A1,B1,A1:B10)",
-   *           "children": [
-   *             {
-   *               "value": "A1:B10",
-   *               "children": []
-   *             }
-   *           ]
-   *         },
-   *         {
-   *           "value": "offset(A1:B10,0,1)",
-   *           "children": [
-   *             {
-   *               "value": "A1:B10",
-   *               "children": []
-   *             }
-   *           ]
-   *         }
-   *       ]
-   *     }
-   *   ]
-   * }
-   * ```
-   *
-   * @param formulaString The formula string to parse (with or without leading `=`)
-   * @returns A formula expression tree describing the hierarchical structure of the formula
-   */
-  getFormulaExpressTree(e, t) {
-    return this._lexerTreeBuilder.getFormulaExprTree(e, t, this._functionService.hasExecutor.bind(this._functionService), this._definedNamesService.getValueByName.bind(this._definedNamesService), this._superTableService.getTable.bind(this._superTableService));
-  }
-  /**
-   * Retrieve **both**:
-   * 1) the full dependency trees of all formulas that **depend on** the specified ranges, and
-   * 2) the dependency trees of all formulas that **physically reside inside** the specified ranges.
-   *
-   * This is a convenience API that combines the behaviors of
-   * `getRangeDependents` and `getInRangeFormulas` into a single call.
-   *
-   * Internally, it triggers a local dependency-calculation command once and
-   * resolves when both result sets are available, avoiding duplicate
-   * calculations and event listeners.
-   *
-   * @param unitRanges An array of workbook/sheet ranges to query. Each range
-   *   includes:
-   *   - `unitId`  The workbook ID.
-   *   - `sheetId` The sheet ID.
-   *   - `range`   The zero-based row/column boundaries.
-   *
-   * @param {number} [timeout]
-   *        Optional timeout in milliseconds. If the dependency calculation does
-   *        not complete within this period, the promise will be rejected.
-   *
-   * @returns {Promise<IFormulaDependentsAndInRangeResults>}
-   *          A promise that resolves with an object containing:
-   *          - `dependents`: Dependency trees of all formulas that depend on the
-   *            specified ranges (upstream consumers).
-   *          - `inRanges`: Dependency trees of all formulas whose definitions
-   *            are located inside the specified ranges.
-   *
-   * @example
-   * ```ts
-   * const formulaEngine = univerAPI.getFormula();
-   *
-   * const result = await formulaEngine.getRangeDependentsAndInRangeFormulas([
-   *   {
-   *     unitId: 'workbook1',
-   *     sheetId: 'sheet1',
-   *     range: { startRow: 0, endRow: 9, startColumn: 0, endColumn: 1 },
-   *   },
-   * ]);
-   *
-   * console.log('Dependent formulas:', result.dependents);
-   * console.log('Formulas inside range:', result.inRanges);
-   * ```
-   */
-  getRangeDependentsAndInRangeFormulas(e, t = 3e4) {
-    return new Promise((i, r) => {
-      const n = this._commandService.onCommandExecuted((o) => {
-        if (o.id !== O.id)
-          return;
-        const s = o.params;
-        clearTimeout(a), n.dispose(), s.result != null ? i(s.result) : i({ dependents: [], inRanges: [] });
-      }), a = setTimeout(() => {
-        n.dispose(), r(new Error("Range dependents calculation timeout"));
-      }, t);
-      this._commandService.executeCommand(
-        U.id,
-        { unitRanges: e },
-        { onlyLocal: !0 }
-      );
-    });
-  }
 };
-m = Y([
+m = j([
   u(0, c(_)),
-  u(1, c(h)),
-  u(2, c(g)),
-  u(3, v),
-  u(4, E),
-  u(5, T),
-  u(6, x)
+  u(1, c(v)),
+  u(2, c(x)),
+  u(3, g)
 ], m);
-class W extends f {
+class U extends S {
   getFormula() {
     return this._injector.createInstance(m);
   }
 }
-f.extend(W);
+S.extend(U);
 export {
   m as FFormula
 };