@univerjs/engine-formula 0.12.4-experimental.20251208-c4b8a44 → 0.12.4

package/lib/es/facade.js

@@ -1,15 +1,15 @@
-import { FBase as p, FUniver as d } from "@univerjs/core/facade";
-import { Inject as c, ICommandService as C, Injector as f, IConfigService as S } from "@univerjs/core";
-import { LexerTreeBuilder as _, SetFormulaCalculationStartMutation as u, SetFormulaCalculationStopMutation as v, SetFormulaCalculationNotificationMutation as m, GlobalComputingStatusService as h, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT as x, SetFormulaStringBatchCalculationMutation as g, SetFormulaStringBatchCalculationResultMutation as F, SetFormulaDependencyCalculationMutation as E, SetFormulaDependencyCalculationResultMutation as y, SetCellFormulaDependencyCalculationMutation as M, SetCellFormulaDependencyCalculationResultMutation as B } from "@univerjs/engine-formula";
-import { firstValueFrom as T, race as I, filter as D, timer as R, map as L } from "rxjs";
-var N = Object.getOwnPropertyDescriptor, O = (e, t, i, r) => {
-  for (var n = r > 1 ? void 0 : r ? N(t, i) : t, a = e.length - 1, l; a >= 0; a--)
-    (l = e[a]) && (n = l(n) || n);
-  return n;
-}, o = (e, t) => (i, r) => t(i, r, e);
-let s = class extends p {
-  constructor(e, t, i, r) {
-    super(), this._commandService = e, this._injector = t, this._lexerTreeBuilder = i, this._configService = r, this._initialize();
+import { FBase as f, FUniver as d } from "@univerjs/core/facade";
+import { Inject as c, ICommandService as p, Injector as _, IConfigService as C } from "@univerjs/core";
+import { LexerTreeBuilder as v, SetFormulaCalculationStartMutation as l, SetFormulaCalculationStopMutation as S, SetFormulaCalculationNotificationMutation as m, GlobalComputingStatusService as x, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT as h } from "@univerjs/engine-formula";
+import { firstValueFrom as g, race as E, filter as F, timer as B, map as I } from "rxjs";
+var T = Object.getOwnPropertyDescriptor, N = (e, t, r, i) => {
+  for (var o = i > 1 ? void 0 : i ? T(t, r) : t, a = e.length - 1, u; a >= 0; a--)
+    (u = e[a]) && (o = u(o) || o);
+  return o;
+}, n = (e, t) => (r, i) => t(r, i, e);
+let s = class extends f {
+  constructor(e, t, r, i) {
+    super(), this._commandService = e, this._injector = t, this._lexerTreeBuilder = r, this._configService = i, this._initialize();
   }
   /**
    * @ignore
@@ -38,8 +38,8 @@ let s = class extends p {
    * console.log(result);
    * ```
    */
-  moveFormulaRefOffset(e, t, i, r) {
-    return this._lexerTreeBuilder.moveFormulaRefOffset(e, t, i, r);
+  moveFormulaRefOffset(e, t, r, i) {
+    return this._lexerTreeBuilder.moveFormulaRefOffset(e, t, r, i);
   }
   /**
    * Resolves the formula string to a 'node' node
@@ -66,7 +66,7 @@ let s = class extends p {
    * ```
    */
   executeCalculation() {
-    this._commandService.executeCommand(u.id, { commands: [], forceCalculation: !0 }, { onlyLocal: !0 });
+    this._commandService.executeCommand(l.id, { commands: [], forceCalculation: !0 }, { onlyLocal: !0 });
   }
   /**
    * Stop the calculation of the formula.
@@ -78,7 +78,7 @@ let s = class extends p {
    * ```
    */
   stopCalculation() {
-    this._commandService.executeCommand(v.id, {});
+    this._commandService.executeCommand(S.id, {});
   }
   /**
    * Listening calculation starts.
@@ -95,9 +95,9 @@ let s = class extends p {
    */
   calculationStart(e) {
     return this._commandService.onCommandExecuted((t) => {
-      if (t.id === u.id) {
-        const i = t.params;
-        e(i.forceCalculation);
+      if (t.id === l.id) {
+        const r = t.params;
+        e(r.forceCalculation);
       }
     });
   }
@@ -118,8 +118,8 @@ let s = class extends p {
     return this._commandService.onCommandExecuted((t) => {
       if (t.id !== m.id)
         return;
-      const i = t.params;
-      i.functionsExecutedState !== void 0 && e(i.functionsExecutedState);
+      const r = t.params;
+      r.functionsExecutedState !== void 0 && e(r.functionsExecutedState);
     });
   }
   /**
@@ -139,10 +139,10 @@ let s = class extends p {
    * ```
    */
   whenComputingCompleteAsync(e) {
-    const t = this._injector.get(h);
-    return t.computingStatus ? Promise.resolve(!0) : T(I(
-      t.computingStatus$.pipe(D((i) => i)),
-      R(e != null ? e : 3e4).pipe(L(() => !1))
+    const t = this._injector.get(x);
+    return t.computingStatus ? Promise.resolve(!0) : g(E(
+      t.computingStatus$.pipe(F((r) => r)),
+      B(e != null ? e : 3e4).pipe(I(() => !1))
     ));
   }
   /**
@@ -151,10 +151,10 @@ let s = class extends p {
    */
   onCalculationEnd() {
     return new Promise((e, t) => {
-      const i = setTimeout(() => {
+      const r = setTimeout(() => {
         t(new Error("Calculation end timeout"));
-      }, 3e4), r = this.calculationEnd(() => {
-        clearTimeout(i), r.dispose(), e();
+      }, 3e4), i = this.calculationEnd(() => {
+        clearTimeout(r), i.dispose(), e();
       });
     });
   }
@@ -175,8 +175,8 @@ let s = class extends p {
     return this._commandService.onCommandExecuted((t) => {
       if (t.id !== m.id)
         return;
-      const i = t.params;
-      i.stageInfo !== void 0 && e(i.stageInfo);
+      const r = t.params;
+      r.stageInfo !== void 0 && e(r.stageInfo);
     });
   }
   /**
@@ -192,167 +192,21 @@ let s = class extends p {
    * ```
    */
   setMaxIteration(e) {
-    this._configService.setConfig(x, e);
-  }
-  /**
-   * Execute a batch of formulas asynchronously and receive computed results.
-   *
-   * Each formula cell is represented as a string array:
-   *   [fullFormula, ...subFormulas]
-   *
-   * Where:
-   *   - fullFormula (index 0) is the complete formula expression written in the cell.
-   *     Example: "=SUM(A1:A10) + SQRT(D7)".
-   *
-   *   - subFormulas (index 1+) are **optional decomposed expressions** extracted from
-   *     the full formula. Each of them can be independently computed by the formula engine.
-   *
-   *     These sub-expressions can include:
-   *       - Single-cell references:  "A2", "B2", "C5"
-   *       - Range references:        "A1:A10"
-   *       - Function calls:          "SQRT(D7)", "ABS(A2-B2)"
-   *       - Any sub-formula that was parsed out of the original formula and can be
-   *         evaluated on its own.
-   *
-   *     The batch execution engine may use these sub-formulas for dependency resolution,
-   *     incremental computation, or performance optimizations.
-   *
-   * @param {IFormulaStringMap} formulas
-   *        Nested structure (unit → sheet → row → column) describing formulas and
-   *        their decomposed sub-expressions.
-   *
-   * @param {(result: IFormulaExecuteResultMap) => void} callback
-   *        Receives the computed value map mirroring the input structure.
-   *
-   * @returns {IDisposable}
-   *          A disposer to stop listening for batch results.
-   *
-   * @example
-   * ```ts
-   * const formulaEngine = univerAPI.getFormula();
-   * const formulas = {
-   *   Book1: {
-   *     Sheet1: {
-   *       2: {
-   *         3: [
-   *           // Full formula:
-   *           "=SUM(A1:A10) + SQRT(D7)",
-   *
-   *           // Decomposed sub-formulas (each one can be evaluated independently):
-   *           "SUM(A1:A10)",   // sub-formula 1
-   *           "SQRT(D7)",      // sub-formula 2
-   *           "A1:A10",        // range reference
-   *           "D7",            // single-cell reference
-   *         ],
-   *       },
-   *       4: {
-   *         5: [
-   *           "=A2 + B2 + SQRT(C5)",
-   *           "A2",
-   *           "B2",
-   *           "SQRT(C5)",
-   *         ],
-   *       }
-   *     },
-   *   },
-   * };
-   *
-   * const disposer = formulaEngine.executeFormulas(formulas, (result) => {
-   *   console.log(result);
-   * });
-   *
-   * ```
-   */
-  executeFormulas(e, t) {
-    this._commandService.executeCommand(g.id, { formulas: e }, { onlyLocal: !0 });
-    const i = this._commandService.onCommandExecuted((r) => {
-      if (r.id !== F.id)
-        return;
-      const n = r.params;
-      n.result != null && t(n.result), i.dispose();
-    });
-  }
-  /**
-   * Retrieve all formula dependency trees that were produced during the latest
-   * dependency-analysis run. This triggers a local dependency-calculation command
-   * and returns the complete set of dependency trees once the calculation finishes.
-   *
-   * @param callback A function invoked with the resulting array of dependency trees.
-   *
-   * @returns {IDisposable} An object that disposes the internal event listener.
-   *
-   * @example
-   * ```ts
-   * const formulaEngine = univerAPI.getFormula();
-   *
-   * // Fetch all dependency trees generated for the current workbook.
-   * const disposable = formulaEngine.getAllDependencyTrees((trees) => {
-   *     console.log('All dependency trees:', trees);
-   * });
-   *
-   * ```
-   */
-  getAllDependencyTrees(e) {
-    this._commandService.executeCommand(E.id, void 0, { onlyLocal: !0 });
-    const t = this._commandService.onCommandExecuted((i) => {
-      if (i.id !== y.id)
-        return;
-      const r = i.params;
-      r.result != null && e(r.result), t.dispose();
-    });
-  }
-  /**
-   * Retrieve the dependency tree of a specific cell. This triggers a local
-   * dependency-calculation command for the given unit, sheet, and cell location,
-   * and returns the computed dependency tree when the calculation is completed.
-   *
-   * @param param The target cell location:
-   *   - `unitId`  The workbook ID.
-   *   - `sheetId` The sheet ID.
-   *   - `row`     The zero-based row index.
-   *   - `column`  The zero-based column index.
-   *
-   * @param callback A function invoked with the resulting dependency tree or
-   * `undefined` if no dependency tree exists for that cell.
-   *
-   * @returns {IDisposable} An object that disposes the internal event listener.
-   *
-   * @example
-   * ```ts
-   * const formulaEngine = univerAPI.getFormula();
-   *
-   * // Query the dependency tree for cell B2 in a specific sheet.
-   * const disposable = formulaEngine.getCellDependencyTree(
-   *     { unitId: 'workbook1', sheetId: 'sheet1', row: 1, column: 1 },
-   *     (tree) => {
-   *         console.log('Cell dependency tree:', tree);
-   *     }
-   * );
-   *
-   * ```
-   */
-  getCellDependencyTree(e, t) {
-    this._commandService.executeCommand(M.id, e, { onlyLocal: !0 });
-    const i = this._commandService.onCommandExecuted((r) => {
-      if (r.id !== B.id)
-        return;
-      const n = r.params;
-      n.result !== void 0 && t(n.result), i.dispose();
-    });
+    this._configService.setConfig(h, e);
   }
 };
-s = O([
-  o(0, c(C)),
-  o(1, c(f)),
-  o(2, c(_)),
-  o(3, S)
+s = N([
+  n(0, c(p)),
+  n(1, c(_)),
+  n(2, c(v)),
+  n(3, C)
 ], s);
-class b extends d {
+class O extends d {
   getFormula() {
     return this._injector.createInstance(s);
   }
 }
-d.extend(b);
+d.extend(O);
 export {
   s as FFormula
 };