@univerjs/sheets 1.0.0-alpha.8 → 1.0.0-beta.1

package/lib/cjs/locale/ar-SA.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "سيؤدي الاستمرار في الدمج إلى الاحتفاظ بقيمة الخلية العلوية اليسرى فقط، وسيتم تجاهل القيم الأخرى. هل أنت متأكد من الاستمرار؟",
 		cancel: "إلغاء الدمج",
 		confirm: "الاستمرار في الدمج",
-		warning: "تحذير",
-		dismantleMergeCellWarning: "سيؤدي هذا إلى تقسيم بعض الخلايا المدمجة. هل تريد الاستمرار؟"
+		warning: "تحذير"
 	} }
 } };
 

package/lib/cjs/locale/ca-ES.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Continuar la fusió només conservarà el valor de la cel·la superior esquerra, descartant els altres valors. Estàs segur de continuar?",
 		cancel: "Cancel·lar fusió",
 		confirm: "Continuar fusió",
-		warning: "Avís",
-		dismantleMergeCellWarning: "Això dividirà algunes cel·les fusionades. Vols continuar?"
+		warning: "Avís"
 	} }
 } };
 

package/lib/cjs/locale/de-DE.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Beim Fortfahren mit dem Zusammenführen bleibt nur der Wert der oberen linken Zelle erhalten, andere Werte werden verworfen. Möchten Sie wirklich fortfahren?",
 		cancel: "Zusammenführen abbrechen",
 		confirm: "Zusammenführen fortsetzen",
-		warning: "Warnung",
-		dismantleMergeCellWarning: "Dadurch werden einige verbundene Zellen aufgeteilt. Möchten Sie fortfahren?"
+		warning: "Warnung"
 	} }
 } };
 

package/lib/cjs/locale/en-US.js

@@ -58,8 +58,7 @@ const locale = { sheets: {
 		title: "Continue merging would only keep the upper-left cell value, discard other values. Are you sure to continue?",
 		cancel: "Cancel merging",
 		confirm: "Continue merging",
-		warning: "Warning",
-		dismantleMergeCellWarning: "This will cause some merged cells to be split. Do you want to continue?"
+		warning: "Warning"
 	} }
 } };
 

package/lib/cjs/locale/es-ES.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Continuar la fusión solo conservará el valor de la celda superior izquierda, descartando los otros valores. ¿Estás seguro de continuar?",
 		cancel: "Cancelar fusión",
 		confirm: "Continuar fusión",
-		warning: "Advertencia",
-		dismantleMergeCellWarning: "Esto dividirá algunas celdas fusionadas. ¿Quieres continuar?"
+		warning: "Advertencia"
 	} }
 } };
 

package/lib/cjs/locale/fa-IR.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "ادغام ادامه‌دار فقط مقدار سلول بالا-چپ را حفظ می‌کند و سایر مقادیر را حذف می‌کند. آیا مطمئن هستید که ادامه می‌دهید؟",
 		cancel: "لغو ادغام",
 		confirm: "ادغام ادامه‌دار",
-		warning: "هشدار",
-		dismantleMergeCellWarning: "این باعث تقسیم برخی سلول‌های ادغام‌شده می‌شود. آیا می‌خواهید ادامه دهید؟"
+		warning: "هشدار"
 	} }
 } };
 

package/lib/cjs/locale/fr-FR.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Continuer la fusion ne conservera que la valeur de la cellule en haut à gauche, en supprimant les autres valeurs. Êtes-vous sûr de vouloir continuer ?",
 		cancel: "Annuler la fusion",
 		confirm: "Continuer la fusion",
-		warning: "Avertissement",
-		dismantleMergeCellWarning: "Cela divisera certaines cellules fusionnées. Voulez-vous continuer ?"
+		warning: "Avertissement"
 	} }
 } };
 

package/lib/cjs/locale/id-ID.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Melanjutkan penggabungan hanya akan menyimpan nilai sel kiri atas, membuang nilai lainnya. Apakah Anda yakin ingin melanjutkan?",
 		cancel: "Batalkan penggabungan",
 		confirm: "Lanjutkan penggabungan",
-		warning: "Peringatan",
-		dismantleMergeCellWarning: "Ini akan menyebabkan beberapa sel gabungan terpisah. Apakah Anda ingin melanjutkan?"
+		warning: "Peringatan"
 	} }
 } };
 

package/lib/cjs/locale/it-IT.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Continuando l'unione verrà mantenuto solo il valore della cella in alto a sinistra, scartando gli altri valori. Continuare?",
 		cancel: "Annulla unione",
 		confirm: "Continua unione",
-		warning: "Avviso",
-		dismantleMergeCellWarning: "Questo comporterà la divisione di alcune celle unite. Continuare?"
+		warning: "Avviso"
 	} }
 } };
 

package/lib/cjs/locale/ja-JP.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "結合を続行すると、左上のセルの値のみが保持され、他の値は破棄されます。続行しますか？",
 		cancel: "結合をキャンセル",
 		confirm: "結合を続行",
-		warning: "警告",
-		dismantleMergeCellWarning: "これにより、一部の結合セルが分割されます。続行しますか？"
+		warning: "警告"
 	} }
 } };
 

package/lib/cjs/locale/ko-KR.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "병합을 계속하면 왼쪽 상단 셀의 값만 유지되고 다른 값은 삭제됩니다. 계속하시겠습니까?",
 		cancel: "병합 취소",
 		confirm: "병합 계속",
-		warning: "경고",
-		dismantleMergeCellWarning: "일부 병합된 셀이 분할됩니다. 계속하시겠습니까?"
+		warning: "경고"
 	} }
 } };
 

package/lib/cjs/locale/pl-PL.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Kontynuowanie scalania spowoduje zachowanie tylko wartości komórki w lewym górnym rogu, pozostałe wartości zostaną odrzucone. Czy na pewno chcesz kontynuować?",
 		cancel: "Anuluj scalanie",
 		confirm: "Kontynuuj scalanie",
-		warning: "Ostrzeżenie",
-		dismantleMergeCellWarning: "Spowoduje to rozdzielenie niektórych scalonych komórek. Czy chcesz kontynuować?"
+		warning: "Ostrzeżenie"
 	} }
 } };
 

package/lib/cjs/locale/pt-BR.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Continuar a mesclagem manterá apenas o valor da célula superior esquerda, descartando os outros valores. Tem certeza de que deseja continuar?",
 		cancel: "Cancelar mesclagem",
 		confirm: "Continuar mesclagem",
-		warning: "Aviso",
-		dismantleMergeCellWarning: "Isso fará com que algumas células mescladas sejam divididas. Deseja continuar?"
+		warning: "Aviso"
 	} }
 } };
 

package/lib/cjs/locale/ru-RU.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Продолжение объединения сохранит только значение верхней левой ячейки, остальные значения будут удалены. Вы уверены, что хотите продолжить?",
 		cancel: "Отменить объединение",
 		confirm: "Продолжить объединение",
-		warning: "Предупреждение",
-		dismantleMergeCellWarning: "Это приведет к разделению некоторых объединенных ячеек. Вы хотите продолжить?"
+		warning: "Предупреждение"
 	} }
 } };
 

package/lib/cjs/locale/sk-SK.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Pokračovanie v zlúčení zachová iba hodnotu hornej ľavej bunky, ostatné hodnoty sa zahodia. Ste si istí, že chcete pokračovať?",
 		cancel: "Zrušiť zlúčenie",
 		confirm: "Pokračovať v zlúčení",
-		warning: "Varovanie",
-		dismantleMergeCellWarning: "To spôsobí rozdelenie niektorých zlúčených buniek. Chcete pokračovať?"
+		warning: "Varovanie"
 	} }
 } };
 

package/lib/cjs/locale/vi-VN.js

@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "Tiếp tục hợp nhất chỉ giữ lại giá trị của ô trên cùng bên trái, loại bỏ các giá trị khác. Bạn có chắc chắn muốn tiếp tục không?",
 		cancel: "Hủy hợp nhất",
 		confirm: "Tiếp tục hợp nhất",
-		warning: "Cảnh báo",
-		dismantleMergeCellWarning: "Điều này sẽ khiến một số ô đã hợp nhất bị tách ra. Bạn có muốn tiếp tục không?"
+		warning: "Cảnh báo"
 	} }
 } };
 

package/lib/cjs/locale/zh-CN.js

@@ -18,7 +18,7 @@ const locale = { sheets: {
 		nameSheetConflict: "名称与工作表名称冲突",
 		formulaOrRefStringEmpty: "公式或引用字符串不能为空",
 		nameConflict: "名称与函数名称冲突",
-		defaultName: "DefinedName"
+		defaultName: "定义名称"
 	},
 	permission: { dialog: {
 		autoFillErr: "该范围已被保护，目前无自动填充权限。如需自动填充，请联系创建者。",
@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "继续合并将只保留左上角单元格的值，丢弃其他值。您确定要继续吗？",
 		cancel: "取消合并",
 		confirm: "继续合并",
-		warning: "警告",
-		dismantleMergeCellWarning: "这将导致一些合并单元格被拆分。您要继续吗？"
+		warning: "警告"
 	} }
 } };
 

package/lib/cjs/locale/zh-HK.js

@@ -18,7 +18,7 @@ const locale = { sheets: {
 		nameSheetConflict: "名稱與工作表名稱衝突",
 		formulaOrRefStringEmpty: "公式或引用字串不能為空",
 		nameConflict: "名稱與函數名稱衝突",
-		defaultName: "DefinedName"
+		defaultName: "定義名稱"
 	},
 	permission: { dialog: {
 		autoFillErr: "範圍已被保護，目前無自動填入權限。如需自動填充，請聯絡建立者。 ",
@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "繼續合併將只保留左上角儲存格的值，捨棄其他值。您確定要繼續嗎？",
 		cancel: "取消合併",
 		confirm: "繼續合併",
-		warning: "警告",
-		dismantleMergeCellWarning: "這將導致一些合併儲存格被拆分。您要繼續嗎？"
+		warning: "警告"
 	} }
 } };
 

package/lib/cjs/locale/zh-TW.js

@@ -18,7 +18,7 @@ const locale = { sheets: {
 		nameSheetConflict: "名稱與工作表名稱衝突",
 		formulaOrRefStringEmpty: "公式或引用字串不能為空",
 		nameConflict: "名稱與函數名稱衝突",
-		defaultName: "DefinedName"
+		defaultName: "定義名稱"
 	},
 	permission: { dialog: {
 		autoFillErr: "範圍已被保護，目前無自動填入權限。如需自動填充，請聯絡建立者。 ",
@@ -43,8 +43,7 @@ const locale = { sheets: {
 		title: "繼續合併將只保留左上角儲存格的值，捨棄其他值。您確定要繼續嗎？",
 		cancel: "取消合併",
 		confirm: "繼續合併",
-		warning: "警告",
-		dismantleMergeCellWarning: "這將導致一些合併儲存格被拆分。您要繼續嗎？"
+		warning: "警告"
 	} }
 } };
 

package/lib/es/facade.js

@@ -190,9 +190,9 @@ let FDefinedNameBuilder = class FDefinedNameBuilder {
 	setRefByRange(row, column, numRows, numColumns) {
 		this._definedNameParam.formulaOrRefString = serializeRange({
 			startRow: row,
-			endRow: row + (numRows !== null && numRows !== void 0 ? numRows : 1) - 1,
+			endRow: row + (numRows ?? 1) - 1,
 			startColumn: column,
-			endColumn: column + (numColumns !== null && numColumns !== void 0 ? numColumns : 1) - 1
+			endColumn: column + (numColumns ?? 1) - 1
 		});
 		return this;
 	}
@@ -432,9 +432,9 @@ let FDefinedName = class FDefinedName extends FBase {
 	setRefByRange(row, column, numRows, numColumns) {
 		this._definedNameParam.formulaOrRefString = serializeRange({
 			startRow: row,
-			endRow: row + (numRows !== null && numRows !== void 0 ? numRows : 1) - 1,
+			endRow: row + (numRows ?? 1) - 1,
 			startColumn: column,
-			endColumn: column + (numColumns !== null && numColumns !== void 0 ? numColumns : 1) - 1
+			endColumn: column + (numColumns ?? 1) - 1
 		});
 		this._apply();
 	}
@@ -1618,10 +1618,9 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 		if (!this.canEdit()) return false;
 		const rules = this._rangeProtectionRuleModel.getSubunitRuleList(this._unitId, this._subUnitId);
 		for (const rule of rules) for (const range of rule.ranges) if (row >= range.startRow && row <= range.endRow && col >= range.startColumn && col <= range.endColumn) {
-			var _permission$value;
 			const permissionPoint = new RangeProtectionPermissionEditPoint(this._unitId, this._subUnitId, rule.permissionId);
 			const permission = this._permissionService.getPermissionPoint(permissionPoint.id);
-			return (_permission$value = permission === null || permission === void 0 ? void 0 : permission.value) !== null && _permission$value !== void 0 ? _permission$value : false;
+			return (permission === null || permission === void 0 ? void 0 : permission.value) ?? false;
 		}
 		return true;
 	}
@@ -1660,10 +1659,9 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 		if (!this.canView()) return false;
 		const rules = this._rangeProtectionRuleModel.getSubunitRuleList(this._unitId, this._subUnitId);
 		for (const rule of rules) for (const range of rule.ranges) if (row >= range.startRow && row <= range.endRow && col >= range.startColumn && col <= range.endColumn) {
-			var _permission$value2;
 			const permissionPoint = new RangeProtectionPermissionViewPoint(this._unitId, this._subUnitId, rule.permissionId);
 			const permission = this._permissionService.getPermissionPoint(permissionPoint.id);
-			return (_permission$value2 = permission === null || permission === void 0 ? void 0 : permission.value) !== null && _permission$value2 !== void 0 ? _permission$value2 : false;
+			return (permission === null || permission === void 0 ? void 0 : permission.value) ?? false;
 		}
 		return true;
 	}
@@ -1682,12 +1680,11 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* ```
 	*/
 	getPoint(point) {
-		var _permissionPoint$valu;
 		const PointClass = WORKSHEET_PERMISSION_POINT_MAP[point];
 		if (!PointClass) throw new Error(`Unknown worksheet permission point: ${point}`);
 		const instance = new PointClass(this._unitId, this._subUnitId);
 		const permissionPoint = this._permissionService.getPermissionPoint(instance.id);
-		return (_permissionPoint$valu = permissionPoint === null || permissionPoint === void 0 ? void 0 : permissionPoint.value) !== null && _permissionPoint$valu !== void 0 ? _permissionPoint$valu : true;
+		return (permissionPoint === null || permissionPoint === void 0 ? void 0 : permissionPoint.value) ?? true;
 	}
 	/**
 	* Get a snapshot of all permission points.
@@ -2019,6 +2016,11 @@ function covertToColRange(range, worksheet) {
 //#endregion
 //#region src/facade/f-worksheet.ts
 var _FWorksheet;
+function assertValidRowInsertion(methodName, rowIndex, rowCount, howMany) {
+	if (!Number.isInteger(howMany) || howMany <= 0) throw new RangeError(`${methodName}(): row count ${howMany} must be a positive integer.`);
+	const lastRowIndex = rowCount - 1;
+	if (!Number.isInteger(rowIndex) || rowIndex < 0 || rowIndex > lastRowIndex) throw new RangeError(`${methodName}(): row index ${rowIndex} is out of bounds. The worksheet has ${rowCount} rows; expected an integer from 0 to ${lastRowIndex}. To insert ${howMany} row(s) at the bottom, use insertRowsAfter(${lastRowIndex}, ${howMany}). To resize the worksheet directly, use setRowCount(${rowCount + howMany}).`);
+}
 let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	/**
 	* Creates a new worksheet facade instance
@@ -2299,9 +2301,9 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 			sheet = this._worksheet;
 			range = {
 				startRow: rowOrA1Notation,
-				endRow: rowOrA1Notation + (numRows !== null && numRows !== void 0 ? numRows : 1) - 1,
+				endRow: rowOrA1Notation + (numRows ?? 1) - 1,
 				startColumn: column,
-				endColumn: column + (numColumns !== null && numColumns !== void 0 ? numColumns : 1) - 1,
+				endColumn: column + (numColumns ?? 1) - 1,
 				unitId: this._workbook.getUnitId(),
 				sheetId: this._worksheet.getSheetId()
 			};
@@ -2338,7 +2340,7 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	}
 	/**
 	* Inserts a row after the given row position.
-	* @param {number} afterPosition - The row after which the new row should be added, starting at 0 for the first row.
+	* @param {number} afterPosition - The existing row after which the new row should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
@@ -2355,7 +2357,7 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	}
 	/**
 	* Inserts a row before the given row position.
-	* @param {number} beforePosition - The row before which the new row should be added, starting at 0 for the first row.
+	* @param {number} beforePosition - The existing row before which the new row should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
@@ -2372,8 +2374,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	}
 	/**
 	* Inserts one or more consecutive blank rows in a sheet starting at the specified location.
-	* @param {number} rowIndex - The index indicating where to insert a row, starting at 0 for the first row.
-	* @param {number} numRows - The number of rows to insert.
+	* @param {number} rowIndex - The existing row before which rows are inserted. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
+	* @param {number} numRows - The positive number of rows to insert.
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
@@ -2386,12 +2388,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* ```
 	*/
 	insertRows(rowIndex, numRows = 1) {
+		assertValidRowInsertion("insertRows", rowIndex, this.getMaxRows(), numRows);
 		return this.insertRowsBefore(rowIndex, numRows);
 	}
 	/**
 	* Inserts a number of rows after the given row position.
-	* @param {number} afterPosition - The row after which the new rows should be added, starting at 0 for the first row.
-	* @param {number} howMany - The number of rows to insert.
+	* @param {number} afterPosition - The existing row after which the new rows should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
+	* @param {number} howMany - The positive number of rows to insert.
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
@@ -2404,6 +2407,7 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* ```
 	*/
 	insertRowsAfter(afterPosition, howMany) {
+		assertValidRowInsertion("insertRowsAfter", afterPosition, this.getMaxRows(), howMany);
 		const unitId = this._workbook.getUnitId();
 		const subUnitId = this._worksheet.getSheetId();
 		const direction = Direction.DOWN;
@@ -2428,8 +2432,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	}
 	/**
 	* Inserts a number of rows before the given row position.
-	* @param {number} beforePosition - The row before which the new rows should be added, starting at 0 for the first row.
-	* @param {number} howMany - The number of rows to insert.
+	* @param {number} beforePosition - The existing row before which the new rows should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
+	* @param {number} howMany - The positive number of rows to insert.
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
@@ -2442,6 +2446,7 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* ```
 	*/
 	insertRowsBefore(beforePosition, howMany) {
+		assertValidRowInsertion("insertRowsBefore", beforePosition, this.getMaxRows(), howMany);
 		const unitId = this._workbook.getUnitId();
 		const subUnitId = this._worksheet.getSheetId();
 		const direction = Direction.UP;
@@ -4145,7 +4150,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 		return this._worksheet.getColumnManager().getCustomMetadata(index);
 	}
 	/**
-	* Appends a row to the bottom of the current data region in the sheet. If a cell's content begins with =, it's interpreted as a formula.
+	* Appends a row to the bottom of the current data region in the sheet. If the destination row is already within the worksheet capacity,
+	* this method writes into that row without increasing `getMaxRows()`. If a cell's content begins with =, it's interpreted as a formula.
 	* @param {CellValue[]} rowContents - An array of values for the new row.
 	* @returns {FWorksheet} Returns the current worksheet instance for method chaining.
 	* @example
@@ -4650,8 +4656,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	getFontFamily(type = "row") {
-		var _this$getCellStyleDat, _this$getCellStyleDat2;
-		return (_this$getCellStyleDat = (_this$getCellStyleDat2 = this.getCellStyleData(type)) === null || _this$getCellStyleDat2 === void 0 ? void 0 : _this$getCellStyleDat2.ff) !== null && _this$getCellStyleDat !== void 0 ? _this$getCellStyleDat : null;
+		var _this$getCellStyleDat;
+		return ((_this$getCellStyleDat = this.getCellStyleData(type)) === null || _this$getCellStyleDat === void 0 ? void 0 : _this$getCellStyleDat.ff) ?? null;
 	}
 	/**
 	* Get the font size of the cell.
@@ -4672,8 +4678,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	getFontSize(type = "row") {
-		var _this$getCellStyleDat3, _this$getCellStyleDat4;
-		return (_this$getCellStyleDat3 = (_this$getCellStyleDat4 = this.getCellStyleData(type)) === null || _this$getCellStyleDat4 === void 0 ? void 0 : _this$getCellStyleDat4.fs) !== null && _this$getCellStyleDat3 !== void 0 ? _this$getCellStyleDat3 : null;
+		var _this$getCellStyleDat2;
+		return ((_this$getCellStyleDat2 = this.getCellStyleData(type)) === null || _this$getCellStyleDat2 === void 0 ? void 0 : _this$getCellStyleDat2.fs) ?? null;
 	}
 	/**
 	* Return first cell style in this range.
@@ -4723,9 +4729,9 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 		}));
 	}
 	getValue(includeRichText) {
-		var _this$_worksheet$getC, _this$_worksheet$getC2;
+		var _this$_worksheet$getC;
 		if (includeRichText) return this.getValueAndRichTextValue();
-		return (_this$_worksheet$getC = (_this$_worksheet$getC2 = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) === null || _this$_worksheet$getC2 === void 0 ? void 0 : _this$_worksheet$getC2.v) !== null && _this$_worksheet$getC !== void 0 ? _this$_worksheet$getC : null;
+		return ((_this$_worksheet$getC = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) === null || _this$_worksheet$getC === void 0 ? void 0 : _this$_worksheet$getC.v) ?? null;
 	}
 	/**
 	* Returns the raw value of the top-left cell in the range. Empty cells return `null`.
@@ -4780,8 +4786,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 		for (let r = startRow; r <= endRow; r++) {
 			const row = [];
 			for (let c = startColumn; c <= endColumn; c++) {
-				var _this$_worksheet$getC3, _this$_worksheet$getC4;
-				row.push((_this$_worksheet$getC3 = (_this$_worksheet$getC4 = this._worksheet.getCell(r, c)) === null || _this$_worksheet$getC4 === void 0 ? void 0 : _this$_worksheet$getC4.v) !== null && _this$_worksheet$getC3 !== void 0 ? _this$_worksheet$getC3 : null);
+				var _this$_worksheet$getC2;
+				row.push(((_this$_worksheet$getC2 = this._worksheet.getCell(r, c)) === null || _this$_worksheet$getC2 === void 0 ? void 0 : _this$_worksheet$getC2.v) ?? null);
 			}
 			range.push(row);
 		}
@@ -4913,8 +4919,7 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	getCellData() {
-		var _this$_worksheet$getC5;
-		return (_this$_worksheet$getC5 = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) !== null && _this$_worksheet$getC5 !== void 0 ? _this$_worksheet$getC5 : null;
+		return this._worksheet.getCell(this._range.startRow, this._range.startColumn) ?? null;
 	}
 	/**
 	* Alias for getCellDataGrid.
@@ -5035,8 +5040,7 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	getFormula() {
-		var _this$_formulaDataMod;
-		return (_this$_formulaDataMod = this._formulaDataModel.getFormulaStringByCell(this._range.startRow, this._range.startColumn, this._worksheet.getSheetId(), this._workbook.getUnitId())) !== null && _this$_formulaDataMod !== void 0 ? _this$_formulaDataMod : "";
+		return this._formulaDataModel.getFormulaStringByCell(this._range.startRow, this._range.startColumn, this._worksheet.getSheetId(), this._workbook.getUnitId()) ?? "";
 	}
 	/**
 	* Returns the formulas (A1 notation) for the cells in the range. Entries in the 2D array are empty strings for cells with no formula.
@@ -5082,9 +5086,9 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	}
 	/** Gets whether the top-left cell shrinks its font size to fit the cell width. */
 	getShrinkToFit() {
-		var _this$_worksheet$getC6;
+		var _this$_worksheet$getC3;
 		const { startRow, startColumn } = this._range;
-		return ((_this$_worksheet$getC6 = this._worksheet.getComposedCellStyle(startRow, startColumn)) === null || _this$_worksheet$getC6 === void 0 ? void 0 : _this$_worksheet$getC6.stf) === BooleanNumber.TRUE;
+		return ((_this$_worksheet$getC3 = this._worksheet.getComposedCellStyle(startRow, startColumn)) === null || _this$_worksheet$getC3 === void 0 ? void 0 : _this$_worksheet$getC3.stf) === BooleanNumber.TRUE;
 	}
 	/**
 	* Gets whether text wrapping is enabled for cells in the range.
@@ -5244,10 +5248,9 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	getCustomMetaData() {
-		var _cell$custom;
 		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		const cell = this.getCellData();
-		return (_cell$custom = cell === null || cell === void 0 ? void 0 : cell.custom) !== null && _cell$custom !== void 0 ? _cell$custom : null;
+		return (cell === null || cell === void 0 ? void 0 : cell.custom) ?? null;
 	}
 	/**
 	* Returns the custom meta data for the cells in the range.
@@ -5263,10 +5266,7 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	*/
 	getCustomMetaDatas() {
 		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
-		return this.getCellDataGrid().map((row) => row.map((data) => {
-			var _data$custom;
-			return (_data$custom = data === null || data === void 0 ? void 0 : data.custom) !== null && _data$custom !== void 0 ? _data$custom : null;
-		}));
+		return this.getCellDataGrid().map((row) => row.map((data) => (data === null || data === void 0 ? void 0 : data.custom) ?? null));
 	}
 	/**
 	* Sets basic border properties for the current range.
@@ -5309,9 +5309,9 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	getBackground() {
-		var _style$background$rgb, _style$background;
+		var _style$background;
 		const style = this.getCellStyle();
-		return (_style$background$rgb = style === null || style === void 0 || (_style$background = style.background) === null || _style$background === void 0 ? void 0 : _style$background.rgb) !== null && _style$background$rgb !== void 0 ? _style$background$rgb : DEFAULT_STYLES.bg.rgb;
+		return (style === null || style === void 0 || (_style$background = style.background) === null || _style$background === void 0 ? void 0 : _style$background.rgb) ?? DEFAULT_STYLES.bg.rgb;
 	}
 	/**
 	* Returns the background colors of the cells in the range.
@@ -5327,8 +5327,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	*/
 	getBackgrounds() {
 		return this.getCellStyles().map((row) => row.map((style) => {
-			var _style$background$rgb2, _style$background2;
-			return (_style$background$rgb2 = style === null || style === void 0 || (_style$background2 = style.background) === null || _style$background2 === void 0 ? void 0 : _style$background2.rgb) !== null && _style$background$rgb2 !== void 0 ? _style$background$rgb2 : DEFAULT_STYLES.bg.rgb;
+			var _style$background2;
+			return (style === null || style === void 0 || (_style$background2 = style.background) === null || _style$background2 === void 0 ? void 0 : _style$background2.rgb) ?? DEFAULT_STYLES.bg.rgb;
 		}));
 	}
 	/**
@@ -6870,12 +6870,11 @@ let FWorkbookPermission = class FWorkbookPermission extends FBase {
 	* ```
 	*/
 	getPoint(point) {
-		var _permissionPoint$valu;
 		const PointClass = WORKBOOK_PERMISSION_POINT_MAP[point];
 		if (!PointClass) throw new Error(`Unknown workbook permission point: ${point}`);
 		const instance = new PointClass(this._unitId);
 		const permissionPoint = this._permissionService.getPermissionPoint(instance.id);
-		return (_permissionPoint$valu = permissionPoint === null || permissionPoint === void 0 ? void 0 : permissionPoint.value) !== null && _permissionPoint$valu !== void 0 ? _permissionPoint$valu : true;
+		return (permissionPoint === null || permissionPoint === void 0 ? void 0 : permissionPoint.value) ?? true;
 	}
 	/**
 	* Get a snapshot of all permission points.
@@ -7209,13 +7208,13 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 	* ```
 	*/
 	create(name, rows, columns, options) {
-		var _options$sheet, _options$sheet2, _options$index;
-		const newSheet = mergeWorksheetSnapshotWithDefault(Tools.deepClone((_options$sheet = options === null || options === void 0 ? void 0 : options.sheet) !== null && _options$sheet !== void 0 ? _options$sheet : {}));
+		var _options$sheet;
+		const newSheet = mergeWorksheetSnapshotWithDefault(Tools.deepClone((options === null || options === void 0 ? void 0 : options.sheet) ?? {}));
 		newSheet.name = name;
 		newSheet.rowCount = rows;
 		newSheet.columnCount = columns;
-		newSheet.id = options === null || options === void 0 || (_options$sheet2 = options.sheet) === null || _options$sheet2 === void 0 ? void 0 : _options$sheet2.id;
-		const newSheetIndex = (_options$index = options === null || options === void 0 ? void 0 : options.index) !== null && _options$index !== void 0 ? _options$index : this._workbook.getSheets().length;
+		newSheet.id = options === null || options === void 0 || (_options$sheet = options.sheet) === null || _options$sheet === void 0 ? void 0 : _options$sheet.id;
+		const newSheetIndex = (options === null || options === void 0 ? void 0 : options.index) ?? this._workbook.getSheets().length;
 		this._commandService.syncExecuteCommand(InsertSheetCommand.id, {
 			unitId: this.id,
 			index: newSheetIndex,
@@ -7322,12 +7321,12 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 	* ```
 	*/
 	insertSheet(sheetName, options) {
-		var _options$sheet3, _options$sheet4, _options$index2;
-		const newSheet = mergeWorksheetSnapshotWithDefault(Tools.deepClone((_options$sheet3 = options === null || options === void 0 ? void 0 : options.sheet) !== null && _options$sheet3 !== void 0 ? _options$sheet3 : {}));
+		var _options$sheet2;
+		const newSheet = mergeWorksheetSnapshotWithDefault(Tools.deepClone((options === null || options === void 0 ? void 0 : options.sheet) ?? {}));
 		if (sheetName !== void 0) newSheet.name = sheetName;
 		else delete newSheet.name;
-		newSheet.id = options === null || options === void 0 || (_options$sheet4 = options.sheet) === null || _options$sheet4 === void 0 ? void 0 : _options$sheet4.id;
-		const newSheetIndex = (_options$index2 = options === null || options === void 0 ? void 0 : options.index) !== null && _options$index2 !== void 0 ? _options$index2 : this._workbook.getSheets().length;
+		newSheet.id = options === null || options === void 0 || (_options$sheet2 = options.sheet) === null || _options$sheet2 === void 0 ? void 0 : _options$sheet2.id;
+		const newSheetIndex = (options === null || options === void 0 ? void 0 : options.index) ?? this._workbook.getSheets().length;
 		this._commandService.syncExecuteCommand(InsertSheetCommand.id, {
 			unitId: this.id,
 			index: newSheetIndex,
@@ -8204,12 +8203,11 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeGridlineEnableChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === ToggleGridlinesCommand.id) {
-				var _params$showGridlines;
 				const params = commandInfo.params;
 				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet } = target;
-				const showGridlines = (_params$showGridlines = params.showGridlines) !== null && _params$showGridlines !== void 0 ? _params$showGridlines : !worksheet.hasHiddenGridLines();
+				const showGridlines = params.showGridlines ?? !worksheet.hasHiddenGridLines();
 				const eventParams = {
 					workbook,
 					worksheet,
@@ -8236,12 +8234,12 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetCreated, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === InsertSheetCommand.id) {
-				var _params$sheet, _params$index;
+				var _params$sheet;
 				const params = commandInfo.params;
 				const workbook = (params === null || params === void 0 ? void 0 : params.unitId) ? this.getWorkbook(params.unitId) : this.getActiveWorkbook();
 				if (!workbook) return;
 				const sheets = workbook.getSheets();
-				const worksheet = (params === null || params === void 0 || (_params$sheet = params.sheet) === null || _params$sheet === void 0 ? void 0 : _params$sheet.id) ? workbook.getSheetBySheetId(params.sheet.id) : sheets[(_params$index = params === null || params === void 0 ? void 0 : params.index) !== null && _params$index !== void 0 ? _params$index : sheets.length - 1];
+				const worksheet = (params === null || params === void 0 || (_params$sheet = params.sheet) === null || _params$sheet === void 0 ? void 0 : _params$sheet.id) ? workbook.getSheetBySheetId(params.sheet.id) : sheets[(params === null || params === void 0 ? void 0 : params.index) ?? sheets.length - 1];
 				if (!worksheet) return;
 				const eventParams = {
 					workbook,