@univerjs/sheets 1.0.3 → 1.1.0

package/lib/cjs/facade.js

@@ -24,7 +24,7 @@ let _univerjs_protocol = require("@univerjs/protocol");
 const SHEETS_CUSTOM_FIELD_WARNING_MESSAGE = "[Facade]: The sheets custom field is not recommended for external use. Use it at your own risk.";
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -35,7 +35,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -48,14 +48,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPropertyKey.js
 function toPropertyKey(t) {
 	var i = toPrimitive(t, "string");
 	return "symbol" == _typeof(i) ? i : i + "";
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/defineProperty.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -66,7 +66,7 @@ function _defineProperty(e, r, t) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -74,7 +74,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -6546,6 +6546,7 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* Returns a copy of the range expanded `Direction.UP` and `Direction.DOWN` if the specified dimension is `Dimension.ROWS`, or `Direction.NEXT` and `Direction.PREVIOUS` if the dimension is `Dimension.COLUMNS`.
 	* The expansion of the range is based on detecting data next to the range that is organized like a table.
 	* The expanded range covers all adjacent cells with data in them along the specified dimension including the table boundaries.
+	* Cells connected only diagonally do not cause the range to expand.
 	* If the original range is surrounded by empty cells along the specified dimension, the range itself is returned.
 	* @param {Dimension} [dimension] - The dimension along which to expand the range. If not provided, the range will be expanded in both dimensions.
 	* @returns {FRange} The range's data region or a range covering each column or each row spanned by the original range.
@@ -6566,7 +6567,7 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* fWorksheet.getRange('D3').setValue(100);
 	* fWorksheet.getRange('C4').setValue(100);
 	*
-	* // Get C3 data region along the rows dimension, the range will be C2:D4
+	* // Get C3 data region along the rows dimension, the range will be C2:C4
 	* const range = fWorksheet.getRange('C3').getDataRegion(univerAPI.Enum.Dimension.ROWS);
 	* console.log(range.getA1Notation()); // C2:C4
 	*
@@ -6580,41 +6581,43 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```
 	*/
 	getDataRegion(dimension) {
-		const { startRow, startColumn, endRow, endColumn } = this._range;
+		let { startRow, startColumn, endRow, endColumn } = this._range;
 		const maxRows = this._worksheet.getMaxRows();
 		const maxColumns = this._worksheet.getMaxColumns();
 		const cellMatrix = this._worksheet.getCellMatrix();
-		let newStartRow = startRow;
-		let newStartColumn = startColumn;
-		let newEndRow = endRow;
-		let newEndColumn = endColumn;
-		if (dimension !== _univerjs_core.Dimension.COLUMNS) {
-			let topRowHasValue = false;
-			let bottomRowHasValue = false;
-			for (let c = startColumn; c <= endColumn; c++) {
-				if (startRow > 0 && !(0, _univerjs_core.isNullCell)(cellMatrix.getValue(startRow - 1, c))) topRowHasValue = true;
-				if (endRow < maxRows - 1 && !(0, _univerjs_core.isNullCell)(cellMatrix.getValue(endRow + 1, c))) bottomRowHasValue = true;
-				if (topRowHasValue && bottomRowHasValue) break;
+		const rowHasData = (row) => {
+			for (let c = startColumn; c <= endColumn; c++) if (!(0, _univerjs_core.isNullCell)(cellMatrix.getValue(row, c))) return true;
+			return false;
+		};
+		const columnHasData = (column) => {
+			for (let r = startRow; r <= endRow; r++) if (!(0, _univerjs_core.isNullCell)(cellMatrix.getValue(r, column))) return true;
+			return false;
+		};
+		let expanded = true;
+		while (expanded) {
+			expanded = false;
+			while (dimension !== _univerjs_core.Dimension.COLUMNS && startRow > 0 && rowHasData(startRow - 1)) {
+				startRow--;
+				expanded = true;
 			}
-			if (topRowHasValue) newStartRow = startRow - 1;
-			if (bottomRowHasValue) newEndRow = endRow + 1;
-		}
-		if (dimension !== _univerjs_core.Dimension.ROWS) {
-			let leftColumnHasValue = false;
-			let rightColumnHasValue = false;
-			for (let r = startRow; r <= endRow; r++) {
-				if (startColumn > 0 && !(0, _univerjs_core.isNullCell)(cellMatrix.getValue(r, startColumn - 1))) leftColumnHasValue = true;
-				if (endColumn < maxColumns - 1 && !(0, _univerjs_core.isNullCell)(cellMatrix.getValue(r, endColumn + 1))) rightColumnHasValue = true;
-				if (leftColumnHasValue && rightColumnHasValue) break;
+			while (dimension !== _univerjs_core.Dimension.COLUMNS && endRow < maxRows - 1 && rowHasData(endRow + 1)) {
+				endRow++;
+				expanded = true;
+			}
+			while (dimension !== _univerjs_core.Dimension.ROWS && startColumn > 0 && columnHasData(startColumn - 1)) {
+				startColumn--;
+				expanded = true;
+			}
+			while (dimension !== _univerjs_core.Dimension.ROWS && endColumn < maxColumns - 1 && columnHasData(endColumn + 1)) {
+				endColumn++;
+				expanded = true;
 			}
-			if (leftColumnHasValue) newStartColumn = startColumn - 1;
-			if (rightColumnHasValue) newEndColumn = endColumn + 1;
 		}
 		return this._injector.createInstance(_FRange, this._workbook, this._worksheet, {
-			startRow: newStartRow,
-			startColumn: newStartColumn,
-			endRow: newEndRow,
-			endColumn: newEndColumn
+			startRow,
+			startColumn,
+			endRow,
+			endColumn
 		});
 	}
 	/**
@@ -8111,6 +8114,43 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	removeStyles(styleKeys) {
 		this._workbook.removeStyles(styleKeys);
 	}
+	/**
+	* Get the workbook's iterative calculation settings.
+	* Missing or invalid settings use the defaults: iteration disabled, 100 iterations and a maximum change of 0.001.
+	* @returns {IWorkbookCalculationSettings} A copy of the normalized workbook calculation settings.
+	* @example
+	* ```ts
+	* const fWorkbook = univerAPI.getActiveWorkbook();
+	* const settings = fWorkbook.getCalculationSettings();
+	* console.log(settings.iterativeCalculation, settings.maxIterations, settings.maxChange);
+	* ```
+	*/
+	getCalculationSettings() {
+		return this._workbook.getCalculationSettings();
+	}
+	/**
+	* Set iterative calculation settings for the entire workbook through an undoable command.
+	* @param {IWorkbookCalculationSettings} settings The complete calculation settings.
+	* Set `iterativeCalculation` to enable or disable iterative evaluation of circular references.
+	* `maxIterations` must be an integer from 1 to 32767, and `maxChange` must be a finite positive number.
+	* @returns {boolean} Whether the settings command succeeded. Returns false if the workbook cannot be edited or found.
+	* @example
+	* ```ts
+	* const fWorkbook = univerAPI.getActiveWorkbook();
+	* const success = fWorkbook.setCalculationSettings({
+	*     iterativeCalculation: true,
+	*     maxIterations: 100,
+	*     maxChange: 0.001,
+	* });
+	* console.log('Calculation settings updated:', success);
+	* ```
+	*/
+	setCalculationSettings(settings) {
+		return this._commandService.syncExecuteCommand(_univerjs_sheets.SetWorkbookCalculationSettingsCommand.id, {
+			unitId: this.id,
+			settings
+		});
+	}
 };
 FWorkbook = __decorate([
 	__decorateParam(1, (0, _univerjs_core.Inject)(_univerjs_core.Injector)),
@@ -8591,13 +8631,13 @@ var FSheetsEventNameMixin = class extends _univerjs_core_facade.FEventName {
 _univerjs_core_facade.FEventName.extend(FSheetsEventNameMixin);
 
 //#endregion
-Object.defineProperty(exports, 'FRange', {
+Object.defineProperty(exports, "FRange", {
   enumerable: true,
   get: function () {
     return FRange;
   }
 });
-Object.defineProperty(exports, 'FSelection', {
+Object.defineProperty(exports, "FSelection", {
   enumerable: true,
   get: function () {
     return FSelection;
@@ -8605,19 +8645,19 @@ Object.defineProperty(exports, 'FSelection', {
 });
 exports.FSheetsEnumMixin = FSheetsEnumMixin;
 exports.FSheetsEventNameMixin = FSheetsEventNameMixin;
-Object.defineProperty(exports, 'FWorkbook', {
+Object.defineProperty(exports, "FWorkbook", {
   enumerable: true,
   get: function () {
     return FWorkbook;
   }
 });
-Object.defineProperty(exports, 'FWorkbookPermission', {
+Object.defineProperty(exports, "FWorkbookPermission", {
   enumerable: true,
   get: function () {
     return FWorkbookPermission;
   }
 });
-Object.defineProperty(exports, 'FWorksheet', {
+Object.defineProperty(exports, "FWorksheet", {
   enumerable: true,
   get: function () {
     return FWorksheet;