@univerjs/engine-formula 1.0.0-alpha.2 → 1.0.0-alpha.3

package/lib/cjs/facade.js

@@ -148,6 +148,8 @@ let FFormula = class FFormula extends _univerjs_core_facade.FBase {
 	}
 	/**
 	* @deprecated Use `onCalculationResultApplied` instead.
+	* @param {number} [timeout] The timeout in milliseconds. Defaults to 30000.
+	* @returns {Promise<boolean>} Whether computing completed before timeout.
 	*/
 	whenComputingCompleteAsync(timeout) {
 		const gcss = this._injector.get(_univerjs_engine_formula.GlobalComputingStatusService);
@@ -156,6 +158,7 @@ let FFormula = class FFormula extends _univerjs_core_facade.FBase {
 	}
 	/**
 	* @deprecated Use `onCalculationResultApplied` instead.
+	* @returns {Promise<void>} A promise that resolves when calculation ends.
 	*/
 	onCalculationEnd() {
 		return new Promise((resolve, reject) => {
@@ -333,11 +336,11 @@ let FFormula = class FFormula extends _univerjs_core_facade.FBase {
 	* 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 {object} param The target cell location.
+	* @param {string} param.unitId The workbook ID.
+	* @param {string} param.sheetId The sheet ID.
+	* @param {number} param.row The zero-based row index.
+	* @param {number} param.column The zero-based column index.
 	*
 	* @param {number} [timeout]
 	*        Optional timeout in milliseconds. If no result is received within this
@@ -593,6 +596,7 @@ let FFormula = class FFormula extends _univerjs_core_facade.FBase {
 	* ```
 	*
 	* @param formulaString The formula string to parse (with or without leading `=`)
+	* @param unitId The workbook unit id used to resolve defined names and tables.
 	* @returns A formula expression tree describing the hierarchical structure of the formula
 	*/
 	getFormulaExpressTree(formulaString, unitId) {