@univerjs/sheets 0.24.0 → 0.25.0-insiders.20260608-e4336f7

package/lib/cjs/facade.js

@@ -5,7 +5,26 @@ let _univerjs_sheets = require("@univerjs/sheets");
 let _univerjs_engine_formula = require("@univerjs/engine-formula");
 let _univerjs_protocol = require("@univerjs/protocol");
 
-//#region \0@oxc-project+runtime@0.129.0/helpers/typeof.js
+//#region src/facade/const.ts
+/**
+* Copyright 2023-present DreamNum Co., Ltd.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+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.134.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -16,7 +35,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/toPrimitive.js
+//#region \0@oxc-project+runtime@0.134.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -29,14 +48,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.134.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.129.0/helpers/defineProperty.js
+//#region \0@oxc-project+runtime@0.134.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -47,7 +66,7 @@ function _defineProperty(e, r, t) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
+//#region \0@oxc-project+runtime@0.134.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -55,7 +74,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
+//#region \0@oxc-project+runtime@0.134.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);
@@ -74,13 +93,13 @@ function __decorate(decorators, target, key, desc) {
 */
 function getDefinedNameFieldName(unitId, localeService, definedNamesService) {
 	const definedNameMap = definedNamesService.getDefinedNameMap(unitId);
-	if (definedNameMap == null) return localeService.t("definedName.defaultName") + 1;
+	if (definedNameMap == null) return localeService.t("sheets.definedName.defaultName") + 1;
 	const count = Array.from(Object.values(definedNameMap)).length + 1;
-	const name = localeService.t("definedName.defaultName") + count;
+	const name = localeService.t("sheets.definedName.defaultName") + count;
 	if (definedNamesService.getValueByName(unitId, name) == null) return name;
 	let i = count + 1;
 	while (true) {
-		const newName = localeService.t("definedName.defaultName") + i;
+		const newName = localeService.t("sheets.definedName.defaultName") + i;
 		if (definedNamesService.getValueByName(unitId, newName) == null) return newName;
 		i++;
 	}
@@ -580,7 +599,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A10:B11');
 	* fRange.activate();
 	* const fSelection = fWorksheet.getSelection();
@@ -598,7 +618,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fSelection = fWorksheet.getSelection();
 	* const activeRangeList = fSelection.getActiveRangeList();
 	* activeRangeList.forEach((range) => {
@@ -617,7 +638,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A10:B11');
 	* fRange.activate();
 	* const fSelection = fWorksheet.getSelection();
@@ -638,10 +660,11 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fSelection = fWorksheet.getSelection();
 	* const activeSheet = fSelection.getActiveSheet();
-	* console.log(activeSheet.equalTo(fWorksheet)); // true
+	* console.log(activeSheet.equalTo(fWorksheet));
 	* ```
 	*/
 	getActiveSheet() {
@@ -655,7 +678,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A10:B11');
 	* fRange.activate();
 	* const cell = fWorksheet.getRange('B11');
@@ -706,7 +730,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // make sure the active cell is A1 and selection is A1:B2
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.activate();
@@ -1051,7 +1076,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Update the ranges to A1:C3 for the first rule
 	* if (rules.length > 0) {
@@ -1087,7 +1113,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Remove the first protection rule
 	* if (rules.length > 0) {
@@ -1126,7 +1153,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* // First, create a protection rule
 	* const rule = await fRange.getRangePermission().protect({ name: 'My Range', allowEdit: true });
@@ -1164,7 +1192,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows editing
 	* if (rules.length > 0) {
@@ -1191,7 +1220,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows editing
 	* const rule = rules[0];
@@ -1209,7 +1239,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows viewing
 	* const rule = rules[0];
@@ -1227,7 +1258,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows managing collaborators
 	* const rule = rules[0];
@@ -1245,7 +1277,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows deleting the rule
 	* const rule = rules[0];
@@ -1263,7 +1296,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Get the permission snapshot of the first rule
 	* if (rules.length > 0) {
@@ -1313,7 +1347,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* if (fWorksheet.getWorksheetPermission().isProtected()) {
 	*   console.log('Worksheet is protected');
 	* }
@@ -1330,7 +1365,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	*
 	* // Create worksheet protection with collaborators
@@ -1408,7 +1444,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().unprotect();
 	* ```
 	*/
@@ -1433,7 +1470,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setMode('readOnly');
 	* ```
 	*/
@@ -1473,7 +1511,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setReadOnly();
 	* ```
 	*/
@@ -1486,7 +1525,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setEditable();
 	* ```
 	*/
@@ -1502,7 +1542,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	* await permission.setPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow, false);
 	* ```
@@ -1537,7 +1578,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* if (fWorksheet.getWorksheetPermission().canEdit()) {
 	*   console.log('Worksheet is editable');
 	* }
@@ -1554,7 +1596,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Check if cell C3 can be edited
 	* const fRange = fWorksheet.getRange('C3');
 	* const canEdit = fWorksheet.getWorksheetPermission().canEditCell(fRange.getRow(), fRange.getColumn());
@@ -1578,7 +1621,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* if (fWorksheet.getWorksheetPermission().canView()) {
 	*   console.log('Worksheet is viewable');
 	* }
@@ -1594,7 +1638,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Check if cell C3 can be viewed
 	* const fRange = fWorksheet.getRange('C3');
 	* const canView = fWorksheet.getWorksheetPermission().canViewCell(fRange.getRow(), fRange.getColumn());
@@ -1619,7 +1664,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	* const canInsertRow = permission.getPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow);
 	* console.log(canInsertRow);
@@ -1639,7 +1685,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const snapshot = fWorksheet.getWorksheetPermission().getSnapshot();
 	* console.log(snapshot);
 	* ```
@@ -1658,7 +1705,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @returns {Promise<void>} A promise that resolves when the configuration is applied.
 	* @example
 	* ```ts
-	* const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
+	* const worksheet = univerAPI.getActiveWorkbook()?.getSheetByName('Sheet1');
+	* if (!worksheet) return;
 	* const permission = worksheet?.getWorksheetPermission();
 	* await permission?.applyConfig({
 	*   mode: 'readOnly',
@@ -1689,7 +1737,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().protectRanges([
 	*   {
 	*     ranges: [fWorksheet.getRange('A1:B2')],
@@ -1778,7 +1827,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const worksheetPermission = fWorksheet.getWorksheetPermission();
 	* const rules = await worksheetPermission.listRangeProtectionRules();
 	* // Unprotect the first rule as an example
@@ -1804,7 +1854,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* console.log(rules);
 	* ```
@@ -1823,7 +1874,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get debug info for cell C3
 	* const fRange = fWorksheet.getRange('C3');
 	* const debugInfo = await fWorksheet.getWorksheetPermission().debugCellPermission(fRange.getRow(), fRange.getColumn());
@@ -1983,7 +2035,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 			* @returns This sheet, for chaining
 			* @example
 			* ```ts
-			* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+			* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+			* if (!fWorkSheet) return;
 			* fWorkSheet.setActiveSelection(fWorkSheet.getRange('A10:B10'));
 			* ```
 			*/
@@ -2002,7 +2055,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {Worksheet} The worksheet instance.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const sheet = fWorksheet.getSheet();
 	* console.log(sheet);
 	* ```
@@ -2015,7 +2069,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {Injector} The injector instance.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const injector = fWorksheet.getInject();
 	* console.log(injector);
 	* ```
@@ -2028,7 +2083,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {Workbook} The workbook instance.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const workbook = fWorksheet.getWorkbook();
 	* console.log(workbook);
 	* ```
@@ -2041,7 +2097,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {string} The id of the worksheet.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const sheetId = fWorksheet.getSheetId();
 	* console.log(sheetId);
 	* ```
@@ -2054,7 +2111,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {string} The name of the worksheet.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const sheetName = fWorksheet.getSheetName();
 	* console.log(sheetName);
 	* ```
@@ -2067,7 +2125,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FSelection} return the current selections of the worksheet or null if there is no selection.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const selection = fWorksheet.getSelection();
 	* console.log(selection);
 	* ```
@@ -2082,7 +2141,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IStyleData} Default style of the worksheet.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const defaultStyle = fWorksheet.getDefaultStyle();
 	* console.log(defaultStyle);
 	* ```
@@ -2097,7 +2157,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {(Nullable<IStyleData> | string)} The default style of the worksheet row name or style data
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get default style for row 0 (1)
 	* const rowStyle = fWorksheet.getRowDefaultStyle(0);
 	* console.log(rowStyle);
@@ -2116,7 +2177,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {(Nullable<IStyleData> | string)} The default style of the worksheet column name or style data
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get default style for column 0 (A)
 	* const colStyle = fWorksheet.getColumnDefaultStyle(0);
 	* console.log(colStyle);
@@ -2134,7 +2196,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setDefaultStyle('default');
 	* // or
 	* // fWorksheet.setDefaultStyle({fs: 12, ff: 'Arial'});
@@ -2159,7 +2222,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setColumnDefaultStyle(0, 'default');
 	* // or
 	* // fWorksheet.setColumnDefaultStyle(0, {fs: 12, ff: 'Arial'});
@@ -2182,7 +2246,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowDefaultStyle(0, 'default');
 	* // or
 	* // fWorksheet.setRowDefaultStyle(0, {fs: 12, ff: 'Arial'});
@@ -2236,7 +2301,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number} The maximum columns count of the sheet
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const totalColumns = fWorksheet.getMaxColumns();
 	* console.log(`Sheet has ${totalColumns} columns`);
 	* ```
@@ -2249,7 +2315,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number}The maximum rows count of the sheet
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const totalRows = fWorksheet.getMaxRows();
 	* console.log(`Sheet has ${totalRows} rows`);
 	* ```
@@ -2263,7 +2330,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a row after the third row
 	* fWorksheet.insertRowAfter(2);
 	* // Insert a row after the first row
@@ -2279,7 +2347,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a row before the third row
 	* fWorksheet.insertRowBefore(2);
 	* // Insert a row before the first row
@@ -2296,7 +2365,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 rows before the third row
 	* fWorksheet.insertRows(2, 3);
 	* // Insert 1 row before the first row
@@ -2313,7 +2383,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 rows after the third row
 	* fWorksheet.insertRowsAfter(2, 3);
 	* // Insert 1 row after the first row
@@ -2350,7 +2421,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 rows before the third row
 	* fWorksheet.insertRowsBefore(2, 3);
 	* // Insert 1 row before the first row
@@ -2386,7 +2458,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete the third row
 	* fWorksheet.deleteRow(2);
 	* // Delete the first row
@@ -2403,7 +2476,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete 3 rows at row index 2 (rows 3-5)
 	* fWorksheet.deleteRows(2, 3);
 	* // Delete 1 row at row index 0 (first row)
@@ -2430,7 +2504,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete rows at index 2, and range from index 4 to 6 (rows 3, 5-7)
 	* fWorksheet.deleteRowsByPoints([2, [4, 6]]);
 	* ```
@@ -2448,7 +2523,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Move 3 rows at row index 2 (rows 3-5) to row index 0
 	* const rowSpec1 = fWorksheet.getRange('3:5');
 	* fWorksheet.moveRows(rowSpec1, 0);
@@ -2483,7 +2559,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide 3 rows starting from row index 1 (rows 2-4)
 	* const row1 = fWorksheet.getRange('2:4');
 	* fWorksheet.hideRow(row1);
@@ -2510,7 +2587,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide 3 rows starting from row index 1 (rows 2-4)
 	* fWorksheet.hideRows(1, 3);
 	* // Hide single row at index 0 (first row)
@@ -2540,7 +2618,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Unhide 3 rows starting from row index 1 (rows 2-4)
 	* const row1 = fWorksheet.getRange('2:4');
 	* fWorksheet.unhideRow(row1);
@@ -2567,7 +2646,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Show 3 rows starting from row index 1 (rows 2-4)
 	* fWorksheet.showRows(1, 3);
 	* // Show single row at index 0 (first row)
@@ -2598,7 +2678,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Set the height of the second row to 30 pixels
 	* fWorksheet.setRowHeight(1, 30);
 	* // Set the height of the first row to 20 pixels
@@ -2615,7 +2696,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.autoFitRow(24);
 	* ```
 	*/
@@ -2651,7 +2733,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowHeights(1, 10, 30);
 	* ```
 	*/
@@ -2693,7 +2776,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the value of the cell A1 to 'Hello, Univer!', set the font size to 30 and font weight to bold
 	* const fRange = fWorksheet.getRange('A1');
@@ -2713,7 +2797,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowAutoHeight(1, 10);
 	* ```
 	*/
@@ -2739,7 +2824,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const ranges = [
 	* { startRow: 1, endRow: 10, startColumn: 0, endColumn: 10 },
 	* { startRow: 11, endRow: 20, startColumn: 0, endColumn: 10 },
@@ -2765,7 +2851,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowHeightsForced(1, 10, 30);
 	* ```
 	*/
@@ -2792,11 +2879,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setRowCustom({ 0: { key: 'value' } });
 	* ```
 	*/
 	setRowCustom(custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		const unitId = this._workbook.getUnitId();
 		const subUnitId = this._worksheet.getSheetId();
 		const rowData = {};
@@ -2815,7 +2904,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a column after column C
 	* fWorksheet.insertColumnAfter(2);
 	* // Insert a column after column A
@@ -2831,7 +2921,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a column before column C
 	* fWorksheet.insertColumnBefore(2);
 	* // Insert a column before column A
@@ -2848,7 +2939,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 columns before column C
 	* fWorksheet.insertColumns(2, 3);
 	* // Insert 1 column before column A
@@ -2865,7 +2957,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 columns after column C
 	* fWorksheet.insertColumnsAfter(2, 3);
 	* // Insert 1 column after column A
@@ -2902,7 +2995,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 columns before column C
 	* fWorksheet.insertColumnsBefore(2, 3);
 	* // Insert 1 column before column A
@@ -2938,7 +3032,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete column C
 	* fWorksheet.deleteColumn(2);
 	* // Delete column A
@@ -2955,7 +3050,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete 3 columns at column index 2 (columns C, D, E)
 	* fWorksheet.deleteColumns(2, 3);
 	* // Delete 1 column at column index 0 (column A)
@@ -2982,7 +3078,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete columns at index 2, and range from index 4 to 6 (columns C, E-G)
 	* fWorksheet.deleteColumnsByPoints([2, [4, 6]]);
 	* ```
@@ -3000,7 +3097,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Move columns C, D, E to column index 2 (columns B, C, D)
 	* const columnSpec1 = fWorksheet.getRange('C:E');
 	* fWorksheet.moveColumns(columnSpec1, 1);
@@ -3035,7 +3133,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide columns C, D, E
 	* const column1 = fWorksheet.getRange('C:E');
 	* fWorksheet.hideColumn(column1);
@@ -3062,7 +3161,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide columns C, D, E
 	* fWorksheet.hideColumns(2, 3);
 	* // Hide column A
@@ -3092,7 +3192,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Unhide columns C, D, E
 	* const column1 = fWorksheet.getRange('C:E');
 	* fWorksheet.unhideColumn(column1);
@@ -3119,7 +3220,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Unhide columns C, D, E
 	* fWorksheet.showColumns(2, 3);
 	* // Unhide column A
@@ -3150,7 +3252,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Set width of column B to 100 pixels
 	* fWorksheet.setColumnWidth(1, 100);
 	* ```
@@ -3166,7 +3269,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Set width of columns B-D (index 1-3) to 100 pixels
 	* fWorksheet.setColumnWidths(1, 3, 100);
 	* ```
@@ -3195,7 +3299,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the long text value in cell A1
 	* const fRange = fWorksheet.getRange('A1');
@@ -3217,11 +3322,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setColumnCustom({ 0: { key: 'value' } });
 	* ```
 	*/
 	setColumnCustom(custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		const unitId = this._workbook.getUnitId();
 		const subUnitId = this._worksheet.getSheetId();
 		const columnData = {};
@@ -3239,7 +3346,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange[]} All the merged cells in the worksheet
 	* @example
 	* ```ts
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get all merged ranges in the sheet
 	* const mergedData = fWorksheet.getMergeData();
 	* // Process each merged range
@@ -3256,7 +3364,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange[]} all merged cells
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get all merged ranges in the sheet
 	* const mergedRanges = fWorksheet.getMergedRanges();
 	* // Process each merged range
@@ -3275,7 +3384,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange|undefined} The merged cell data, or undefined if the cell is not merged
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const merge = fWorkSheet.getCellMergeData(0, 0);
 	* if (merge) {
 	*   console.log('Merged range:', merge.getA1Notation());
@@ -3291,7 +3401,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange | null} the active range
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get the currently active range
 	* const activeRange = fWorksheet.getActiveRange();
 	* if (activeRange) {
@@ -3308,7 +3419,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setActiveRange(fWorkSheet.getRange('A10:B10'));
 	* ```
 	*/
@@ -3323,7 +3435,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange | null} The active cell
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* console.log(fWorkSheet.getActiveCell().getA1Notation());
 	* ```
 	*/
@@ -3337,7 +3450,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Freeze first 3 rows and 2 columns
 	* fWorksheet.setFreeze({
 	*   startRow: 3,
@@ -3360,7 +3474,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Cancel freeze
 	* fWorksheet.cancelFreeze();
 	* ```
@@ -3377,7 +3492,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IFreeze} The freeze state of the current sheet
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get the freeze state of the current sheet
 	* const freeze = fWorksheet.getFreeze();
 	* console.log(freeze);
@@ -3437,7 +3553,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number} The number of frozen columns, returns 0 if no columns are frozen.
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the number of frozen columns
 	* const frozenColumns = fWorkSheet.getFrozenColumns();
 	* console.log(frozenColumns);
@@ -3453,7 +3570,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number} The number of frozen rows. returns 0 if no rows are frozen.
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the number of frozen rows
 	* const frozenRows = fWorkSheet.getFrozenRows();
 	* console.log(frozenRows);
@@ -3469,7 +3587,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IRowRange} The range of the frozen rows.
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the range of the frozen rows
 	* const frozenRows = fWorkSheet.getFrozenRowRange();
 	* console.log(frozenRows);
@@ -3487,7 +3606,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IColumnRange} The range of the frozen columns.
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the range of the frozen columns
 	* const frozenColumns = fWorkSheet.getFrozenColumnRange();
 	* console.log(frozenColumns);
@@ -3505,7 +3625,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {boolean} True if the sheet's gridlines are hidden; otherwise false.
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // check if the gridlines are hidden
 	* if (fWorkSheet.hasHiddenGridLines()) {
 	*    console.log('Gridlines are hidden');
@@ -3521,7 +3642,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} Returns the current worksheet instance for method chaining
 	* @example
 	* ``` ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // hide the gridlines
 	* fWorkSheet.setHiddenGridlines(true);
 	* ```
@@ -3540,7 +3662,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} Returns the current worksheet instance for method chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // set the gridlines color to red
 	* fWorkSheet.setGridLinesColor('#ff0000');
 	* ```
@@ -3559,7 +3682,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // get the gridlines color of the sheet
 	* console.log(fWorkSheet.getGridLinesColor());
 	* ```
@@ -3574,7 +3698,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // set the tab color to red
 	* fWorkSheet.setTabColor('#ff0000');
 	* ```
@@ -3594,7 +3719,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // get the tab color of the sheet
 	* console.log(fWorkSheet.getTabColor());
 	* ```
@@ -3608,7 +3734,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // hide the active sheet
 	* fWorkSheet.hideSheet();
 	* ```
@@ -3661,7 +3788,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // set the sheet name to 'Sheet1'
 	* fWorkSheet.setName('NewSheet1');
 	* ```
@@ -3695,7 +3823,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // get the position of the active sheet
 	* const position = fWorkSheet.getIndex();
 	* console.log(position);
@@ -3713,7 +3842,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // clear the sheet of content and formatting information
 	* fWorkSheet.clear();
 	* // clear the sheet of content only
@@ -3746,7 +3876,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // clear the sheet of content only
 	* fWorkSheet.clearContents();
 	* ```
@@ -3774,7 +3905,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // clear the sheet of formatting only
 	* fWorkSheet.clearFormats();
 	* ```
@@ -3803,7 +3935,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Assume the sheet is a empty sheet
 	* const cellRange = fWorkSheet.getRange('J50');
 	* cellRange.setValue('Hello World');
@@ -3820,7 +3953,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Assume the sheet is a empty sheet
 	* const cellRange = fWorkSheet.getRange('J50');
 	* cellRange.setValue('Hello World');
@@ -3836,7 +3970,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Assume the sheet is a empty sheet
 	* const cellRange = fWorkSheet.getRange('J50');
 	* cellRange.setValue('Hello World');
@@ -3854,7 +3989,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	* const sheets = fWorkbook.getSheets();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* console.log(fWorkSheet.equalTo(sheets[0])); // true, if the active sheet is the first sheet.
 	* ```
 	*/
@@ -3869,7 +4005,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* // The code below inserts a defined name
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.insertDefinedName('MyDefinedName', 'Sheet1!$A$1');
 	* ```
 	*/
@@ -3883,7 +4020,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* // The code below gets all the defined names in the worksheet
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const definedNames = fWorksheet.getDefinedNames();
 	* console.log(definedNames, definedNames[0]?.getFormulaOrRefString());
 	* ```
@@ -3898,11 +4036,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setCustomMetadata({ key: 'value' });
 	* ```
 	*/
 	setCustomMetadata(custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		this._worksheet.setCustomMetadata(custom);
 		return this;
 	}
@@ -3912,12 +4052,14 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const custom = fWorkSheet.getCustomMetadata();
 	* console.log(custom);
 	* ```
 	*/
 	getCustomMetadata() {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		return this._worksheet.getCustomMetadata();
 	}
 	/**
@@ -3928,11 +4070,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setRowCustomMetadata(0, { key: 'value' });
 	* ```
 	*/
 	setRowCustomMetadata(index, custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		this._worksheet.getRowManager().setCustomMetadata(index, custom);
 		return this;
 	}
@@ -3944,11 +4088,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setColumnCustomMetadata(0, { key: 'value' });
 	* ```
 	*/
 	setColumnCustomMetadata(index, custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		this._worksheet.getColumnManager().setCustomMetadata(index, custom);
 		return this;
 	}
@@ -3959,12 +4105,14 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const custom = fWorkSheet.getRowCustomMetadata(0);
 	* console.log(custom);
 	* ```
 	*/
 	getRowCustomMetadata(index) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		return this._worksheet.getRowManager().getCustomMetadata(index);
 	}
 	/**
@@ -3974,12 +4122,14 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const custom = fWorkSheet.getColumnCustomMetadata(0);
 	* console.log(custom);
 	* ```
 	*/
 	getColumnCustomMetadata(index) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		return this._worksheet.getColumnManager().getCustomMetadata(index);
 	}
 	/**
@@ -3991,7 +4141,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* // Appends a new row with 4 columns to the bottom of the current
 	* // data region in the sheet containing the values in the array.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.appendRow([1, 'Hello Univer', true, '=A1']);
 	* ```
 	*/
@@ -4021,7 +4172,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	*
 	* // Set the number of rows in the worksheet to 40
 	* fWorkSheet.setRowCount(40);
@@ -4042,7 +4194,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	*
 	* // Set the number of columns in the worksheet to 10
 	* fWorkSheet.setColumnCount(10);
@@ -4062,7 +4215,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheetPermission} - The WorksheetPermission instance.
 	* @example
 	* ```ts
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	*
 	* // Set worksheet to read-only mode
@@ -4116,7 +4270,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* // Check if the A1:B2 range is protected
 	* const isProtected = fRange.getRangePermission().isProtected();
@@ -4133,7 +4288,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const rule = await fRange.getRangePermission().protect({
 	*   name: 'My protected range',
@@ -4203,7 +4359,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const result = await fRange.getRangePermission().unprotect();
 	* console.log(result);
@@ -4225,7 +4382,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const rules = await fRange.getRangePermission().listRules();
 	* console.log(rules);
@@ -4250,7 +4408,7 @@ FRangePermission = __decorate([
 //#region src/facade/f-range.ts
 var _FRange, _FRange2;
 let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialable {
-	constructor(_workbook, _worksheet, _range, _injector, _commandService, _formulaDataModel) {
+	constructor(_workbook, _worksheet, _range, _injector, _commandService, _formulaDataModel, _logService) {
 		super(_injector);
 		this._workbook = _workbook;
 		this._worksheet = _worksheet;
@@ -4258,6 +4416,7 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 		this._injector = _injector;
 		this._commandService = _commandService;
 		this._formulaDataModel = _formulaDataModel;
+		this._logService = _logService;
 		const maxRows = this._worksheet.getRowCount();
 		const maxColumns = this._worksheet.getColumnCount();
 		if (this._range.startRow < 0 || this._range.startColumn < 0 || this._range.endRow >= maxRows || this._range.endColumn >= maxColumns) throw new Error(`Range is out of bounds. Max rows: ${maxRows}, Max columns: ${maxColumns}, Given range: ${JSON.stringify(this._range)}`);
@@ -4269,7 +4428,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getUnitId());
 	* ```
@@ -4283,7 +4443,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getSheetName());
 	* ```
@@ -4297,7 +4458,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getSheetId());
 	* ```
@@ -4311,7 +4473,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const range = fRange.getRange();
 	* const { startRow, startColumn, endRow, endColumn } = range;
@@ -4327,7 +4490,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getRow()); // 0
 	* ```
@@ -4341,7 +4505,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getLastRow()); // 1
 	* ```
@@ -4355,7 +4520,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getColumn()); // 0
 	* ```
@@ -4369,7 +4535,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getLastColumn()); // 1
 	* ```
@@ -4383,7 +4550,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWidth());
 	* ```
@@ -4397,7 +4565,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getHeight());
 	* ```
@@ -4411,7 +4580,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.isMerged());
 	* // merge cells A1:B2
@@ -4436,7 +4606,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellStyleData());
 	* ```
@@ -4457,7 +4628,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFontFamily());
 	* ```
@@ -4478,7 +4650,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFontSize());
 	* ```
@@ -4499,7 +4672,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellStyle());
 	* ```
@@ -4520,7 +4694,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellStyles());
 	* ```
@@ -4543,7 +4718,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValueForCell({
 	*   v: 0.2,
@@ -4568,7 +4744,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValueForCell({
 	*   v: 0.2,
@@ -4607,7 +4784,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [
@@ -4668,7 +4846,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [
@@ -4728,7 +4907,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellData());
 	* ```
@@ -4743,7 +4923,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellDatas());
 	* ```
@@ -4757,7 +4938,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellDataGrid());
 	* ```
@@ -4780,7 +4962,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getRichTextValue());
 	* ```
@@ -4798,7 +4981,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getRichTextValues());
 	* ```
@@ -4814,7 +4998,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValueAndRichTextValue());
 	* ```
@@ -4829,7 +5014,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValueAndRichTextValues());
 	* ```
@@ -4843,7 +5029,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFormula());
 	* ```
@@ -4858,7 +5045,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFormulas());
 	* ```
@@ -4884,7 +5072,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWrap());
 	* ```
@@ -4898,7 +5087,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWraps());
 	*/
@@ -4916,7 +5106,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWrapStrategy());
 	* ```
@@ -4930,7 +5121,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getHorizontalAlignment());
 	* ```
@@ -4944,7 +5136,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getHorizontalAlignments());
 	* ```
@@ -4958,7 +5151,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getVerticalAlignment());
 	* ```
@@ -4972,7 +5166,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getVerticalAlignments());
 	* ```
@@ -4986,13 +5181,15 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setCustomMetaData({ key: 'value' });
 	* console.log(fRange.getCustomMetaData());
 	* ```
 	*/
 	setCustomMetaData(data) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		const params = {
 			unitId: this._workbook.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
@@ -5008,7 +5205,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setCustomMetaDatas([
 	*   [{ key: 'value' }, { key: 'value2' }],
@@ -5018,6 +5216,7 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```
 	*/
 	setCustomMetaDatas(datas) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		const params = {
 			unitId: this._workbook.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
@@ -5033,13 +5232,15 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCustomMetaData());
 	* ```
 	*/
 	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;
 	}
@@ -5049,12 +5250,14 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCustomMetaDatas());
 	* ```
 	*/
 	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;
@@ -5069,7 +5272,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setBorder(univerAPI.Enum.BorderType.ALL, univerAPI.Enum.BorderStyleTypes.THIN, '#ff0000');
 	* ```
@@ -5093,7 +5297,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getBackground());
 	* ```
@@ -5109,7 +5314,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getBackgrounds());
 	* ```
@@ -5127,7 +5333,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setBackgroundColor('red');
 	* ```
@@ -5151,7 +5358,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setBackground('red');
 	* ```
@@ -5167,7 +5375,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setTextRotation(45);
 	* ```
@@ -5187,7 +5396,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B2');
 	* fRange.setValue(123);
 	*
@@ -5212,7 +5422,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValueForCell(123);
 	*
@@ -5243,7 +5454,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValue(true));
 	*
@@ -5279,7 +5491,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValue(true));
 	*
@@ -5314,7 +5527,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setWrap(true);
 	* console.log(fRange.getWrap());
@@ -5336,7 +5550,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setWrapStrategy(univerAPI.Enum.WrapStrategy.WRAP);
 	* console.log(fRange.getWrapStrategy());
@@ -5358,7 +5573,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setVerticalAlignment('top');
 	* ```
@@ -5379,7 +5595,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setHorizontalAlignment('left');
 	* ```
@@ -5400,7 +5617,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [1, { v: 2, s: { bg: { rgb: '#ff0000' } } }],
@@ -5425,7 +5643,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontWeight('bold');
 	* ```
@@ -5456,7 +5675,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontStyle('italic');
 	* ```
@@ -5487,7 +5707,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontLine('underline');
 	* ```
@@ -5547,7 +5768,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontFamily('Arial');
 	* ```
@@ -5573,7 +5795,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontSize(24);
 	* ```
@@ -5599,7 +5822,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontColor('#ff0000');
 	* ```
@@ -5627,7 +5851,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.merge();
 	* console.log(fRange.isMerged());
@@ -5635,7 +5860,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	*
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B1:C2');
 	* // Assume A1:B2 is already merged.
 	* fRange.merge({ isForceMerge: true });
@@ -5657,7 +5883,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no merged cells.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.mergeAcross();
 	* // There will be two merged cells. A1:B1 and A2:B2.
@@ -5669,7 +5896,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	*
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B1:C2');
 	* // Assume A1:B2 is already merged.
 	* fRange.mergeAcross({ isForceMerge: true });
@@ -5692,7 +5920,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no merged cells.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.mergeVertically();
 	* // There will be two merged cells. A1:A2 and B1:B2.
@@ -5704,7 +5933,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	*
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B1:C2');
 	* // Assume A1:B2 is already merged.
 	* fRange.mergeVertically({ isForceMerge: true });
@@ -5723,7 +5953,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.merge();
 	* const anchor = fWorksheet.getRange('A1');
@@ -5740,7 +5971,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.merge();
 	* const anchor = fWorksheet.getRange('A1');
@@ -5765,7 +5997,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @param {ICellData} callback.cell the cell data
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.forEach((row, col, cell) => {
 	*   console.log(row, col, cell);
@@ -5786,7 +6019,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {string} The A1 notation of the range.
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // By default, the A1 notation is returned without the sheet name and without absolute reference types.
 	* const fRange = fWorksheet.getRange('A1:B2');
@@ -5824,7 +6058,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.activate(); // the active cell will be A1
 	* ```
@@ -5842,7 +6077,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the range A1:B2 as the active range, default active cell is A1
 	* const fRange = fWorksheet.getRange('A1:B2');
@@ -5894,7 +6130,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example Show how to split text to columns with custom delimiter
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // A1:A3 has following values:
 	* //     A   |
@@ -5936,7 +6173,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:E20');
 	* fRange.useThemeStyle('default');
 	* ```
@@ -5958,7 +6196,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:E20');
 	* fRange.removeThemeStyle('default');
 	* ```
@@ -5977,7 +6216,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:E20');
 	* console.log(fRange.getUsedThemeStyle()); // undefined
 	* fRange.useThemeStyle('default');
@@ -6000,7 +6240,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const fRange = fWorkSheet.getRange('A1:D10');
 	*
 	* // clear the content and format of the range A1:D10
@@ -6027,7 +6268,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const fRange = fWorkSheet.getRange('A1:D10');
 	*
 	* // clear the content only of the range A1:D10
@@ -6048,7 +6290,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const fRange = fWorkSheet.getRange('A1:D10');
 	* // clear the format only of the range A1:D10
 	* fRange.clearFormat();
@@ -6069,7 +6312,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet empty sheet.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const values = [
 	*   [1, 2, 3, 4],
 	*   [2, 3, 4, 5],
@@ -6128,7 +6372,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet empty sheet.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const values = [
 	*   [1, 2, 3, 4],
 	*   [2, 3, 4, 5],
@@ -6191,7 +6436,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no data.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the range A1:D4 with some values, the range A1:D4 will be:
 	* //  |     |     |
@@ -6261,7 +6507,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no data.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.isBlank()); // true
 	*
@@ -6293,7 +6540,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getA1Notation()); // A1:B2
 	*
@@ -6323,7 +6571,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1');
 	* fRange.setFormula('=SUM(A2:A5)');
 	* console.log(fRange.getFormula()); // '=SUM(A2:A5)'
@@ -6339,7 +6588,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFormulas([
 	*   ['=SUM(A2:A5)', '=SUM(B2:B5)'],
@@ -6357,7 +6607,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRangePermission} - The RangePermission instance.
 	* @example
 	* ```ts
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B10');
 	* const permission = fRange.getRangePermission();
 	*
@@ -6392,7 +6643,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Auto-fill the range D1:D10 based on the data in the range C1:C2
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:A4');
 	*
 	* // Auto-fill without specifying applyType (default behavior)
@@ -6444,7 +6696,8 @@ _FRange2._enableManualInit();
 FRange = _FRange = __decorate([
 	__decorateParam(3, (0, _univerjs_core.Inject)(_univerjs_core.Injector)),
 	__decorateParam(4, _univerjs_core.ICommandService),
-	__decorateParam(5, (0, _univerjs_core.Inject)(_univerjs_engine_formula.FormulaDataModel))
+	__decorateParam(5, (0, _univerjs_core.Inject)(_univerjs_engine_formula.FormulaDataModel)),
+	__decorateParam(6, _univerjs_core.ILogService)
 ], FRange);
 
 //#endregion
@@ -6780,7 +7033,7 @@ FWorkbookPermission = __decorate([
 //#endregion
 //#region src/facade/f-workbook.ts
 let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
-	constructor(_workbook, _injector, _resourceLoaderService, _selectionManagerService, _univerInstanceService, _commandService, _permissionService, _logService, _localeService, _definedNamesService) {
+	constructor(_workbook, _injector, _resourceLoaderService, _selectionManagerService, _univerInstanceService, _commandService, _permissionService, _logService, _definedNamesService) {
 		super(_injector);
 		this._workbook = _workbook;
 		this._injector = _injector;
@@ -6790,7 +7043,6 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 		this._commandService = _commandService;
 		this._permissionService = _permissionService;
 		this._logService = _logService;
-		this._localeService = _localeService;
 		this._definedNamesService = _definedNamesService;
 		_defineProperty(this, "id", void 0);
 		this.id = this._workbook.getUnitId();
@@ -6873,21 +7125,6 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 		return this._resourceLoaderService.saveUnit(this._workbook.getUnitId());
 	}
 	/**
-	* @deprecated use 'save' instead.
-	* @returns {IWorkbookData} Workbook snapshot data
-	* @memberof FWorkbook
-	* @example
-	* ```ts
-	* // The code below saves the workbook snapshot data
-	* const activeSpreadsheet = univerAPI.getActiveWorkbook();
-	* const snapshot = activeSpreadsheet.getSnapshot();
-	* ```
-	*/
-	getSnapshot() {
-		this._logService.warn("use 'save' instead of 'getSnapshot'");
-		return this.save();
-	}
-	/**
 	* Get the active sheet of the workbook.
 	* @returns {FWorksheet} The active sheet of the workbook
 	* @example
@@ -6895,6 +7132,7 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* // The code below gets the active sheet of the workbook
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	* const fWorksheet = fWorkbook.getActiveSheet();
+	* if (!fWorksheet) return;
 	* console.log(fWorksheet);
 	* ```
 	*/
@@ -7239,7 +7477,9 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const range = fWorkbook.getActiveSheet().getRange('A10:B10');
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
+	* const range = fWorksheet.getRange('A10:B10');
 	* fWorkbook.setActiveRange(range);
 	* ```
 	*/
@@ -7317,7 +7557,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* ```ts
 	* // The code below duplicates the given worksheet
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const activeSheet = fWorkbook.getActiveSheet();
+	* const activeSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!activeSheet) return;
 	* const duplicatedSheet = fWorkbook.duplicateSheet(activeSheet);
 	* console.log(duplicatedSheet);
 	* ```
@@ -7357,42 +7598,6 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 		return this._workbook.getSheets().length;
 	}
 	/**
-	* Get the locale of the workbook.
-	* @returns {LocaleType} The locale of the workbook
-	* @example
-	* ```ts
-	* // The code below gets the locale of the workbook
-	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* console.log(fWorkbook.getLocale());
-	* ```
-	*/
-	getLocale() {
-		return this._localeService.getCurrentLocale();
-	}
-	/**
-	* @deprecated use `setSpreadsheetLocale` instead.
-	* @param {LocaleType} locale - The locale to set
-	*/
-	setLocale(locale) {
-		this._localeService.setLocale(locale);
-	}
-	/**
-	* Set the locale of the workbook.
-	* @param {LocaleType} locale The locale to set
-	* @returns {FWorkbook} This workbook, for chaining
-	* @example
-	* ```ts
-	* // The code below sets the locale of the workbook
-	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* fWorkbook.setSpreadsheetLocale(univerAPI.Enum.LocaleType.EN_US);
-	* console.log(fWorkbook.getLocale());
-	* ```
-	*/
-	setSpreadsheetLocale(locale) {
-		this._localeService.setLocale(locale);
-		return this;
-	}
-	/**
 	* Get the URL of the workbook.
 	* @returns {string} The URL of the workbook
 	* @example
@@ -7415,7 +7620,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* ```ts
 	* // The code below moves the sheet to the specified index
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const sheet = fWorkbook.getActiveSheet();
+	* const sheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!sheet) return;
 	* fWorkbook.moveSheet(sheet, 1);
 	* ```
 	*/
@@ -7696,6 +7902,7 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* ```
 	*/
 	setCustomMetadata(custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		this._workbook.setCustomMetadata(custom);
 		return this;
 	}
@@ -7710,6 +7917,7 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* ```
 	*/
 	getCustomMetadata() {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		return this._workbook.getCustomMetadata();
 	}
 	/**
@@ -7736,7 +7944,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* fWorkbook.addStyles(styles);
 	*
 	* // Set values with the new styles
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [{ v: 'Hello', s: 'custom-style-1' }, { v: 'Univer', s: 'custom-style-1' }],
@@ -7771,7 +7980,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* fWorkbook.addStyles(styles);
 	*
 	* // Set values with the new styles
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [{ v: 'Hello', s: 'custom-style-1' }, { v: 'Univer', s: 'custom-style-1' }],
@@ -7797,62 +8007,52 @@ FWorkbook = __decorate([
 	__decorateParam(5, _univerjs_core.ICommandService),
 	__decorateParam(6, _univerjs_core.IPermissionService),
 	__decorateParam(7, _univerjs_core.ILogService),
-	__decorateParam(8, (0, _univerjs_core.Inject)(_univerjs_core.LocaleService)),
-	__decorateParam(9, _univerjs_engine_formula.IDefinedNamesService)
+	__decorateParam(8, _univerjs_engine_formula.IDefinedNamesService)
 ], FWorkbook);
 
 //#endregion
 //#region src/facade/f-univer.ts
 var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
-	getCommandSheetTarget(commandInfo) {
-		var _this$getActiveWorkbo;
-		const params = commandInfo.params;
-		if (!params) return this.getActiveSheet();
-		const workbook = params.unitId ? this.getUniverSheet(params.unitId) : (_this$getActiveWorkbo = this.getActiveWorkbook) === null || _this$getActiveWorkbo === void 0 ? void 0 : _this$getActiveWorkbo.call(this);
-		if (!workbook) return;
-		const worksheet = workbook.getSheetBySheetId(params.subUnitId || params.sheetId) || workbook.getActiveSheet();
-		if (!worksheet) return;
+	createWorkbook(data, options) {
+		const workbook = this._injector.get(_univerjs_core.IUniverInstanceService).createUnit(_univerjs_core.UniverInstanceType.UNIVER_SHEET, data, options);
+		return this._injector.createInstance(FWorkbook, workbook);
+	}
+	getActiveWorkbook() {
+		const workbook = this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
+		if (!workbook) return null;
+		return this._injector.createInstance(FWorkbook, workbook);
+	}
+	getWorkbook(id) {
+		const workbook = this._univerInstanceService.getUnit(id, _univerjs_core.UniverInstanceType.UNIVER_SHEET);
+		if (!workbook) return null;
+		return this._injector.createInstance(FWorkbook, workbook);
+	}
+	getSheetCommandTarget(params = {}) {
+		const { unitId, subUnitId, sheetId } = params;
+		const workbook = unitId ? this.getWorkbook(unitId) : this.getActiveWorkbook();
+		if (!workbook) return null;
+		const sheetIdToFind = subUnitId || sheetId;
+		const worksheet = sheetIdToFind ? workbook.getSheetBySheetId(sheetIdToFind) : workbook.getActiveSheet();
+		if (!worksheet) return null;
 		return {
 			workbook,
-			worksheet
+			worksheet,
+			unitId: workbook.getId(),
+			subUnitId: worksheet.getSheetId()
 		};
 	}
-	getSheetTarget(unitId, subUnitId) {
-		const workbook = this.getUniverSheet(unitId);
-		if (!workbook) return;
-		const worksheet = workbook.getSheetBySheetId(subUnitId);
-		if (!worksheet) return;
+	getActiveSheet() {
+		const workbook = this.getActiveWorkbook();
+		if (!workbook) return null;
+		const worksheet = workbook.getActiveSheet();
+		if (!worksheet) return null;
 		return {
 			workbook,
 			worksheet
 		};
 	}
-	_initWorkbookEvent(injector) {
-		const univerInstanceService = injector.get(_univerjs_core.IUniverInstanceService);
-		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookDisposed, () => univerInstanceService.unitDisposed$.subscribe((unit) => {
-			if (unit.type === _univerjs_core.UniverInstanceType.UNIVER_SHEET) {
-				const eventParams = {
-					unitId: unit.getUnitId(),
-					unitType: unit.type,
-					snapshot: unit.getSnapshot()
-				};
-				this.fireEvent(this.Event.WorkbookDisposed, eventParams);
-			}
-		})));
-		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookCreated, () => univerInstanceService.unitAdded$.subscribe((event) => {
-			const { unit } = event;
-			if (unit.type === _univerjs_core.UniverInstanceType.UNIVER_SHEET) {
-				const workbook = unit;
-				const workbookUnit = injector.createInstance(FWorkbook, workbook);
-				const eventParams = {
-					unitId: unit.getUnitId(),
-					type: unit.type,
-					workbook: workbookUnit,
-					unit: workbookUnit
-				};
-				this.fireEvent(this.Event.WorkbookCreated, eventParams);
-			}
-		})));
+	setFreezeSync(enabled) {
+		this._injector.get(_univerjs_sheets.SheetsFreezeSyncController).setEnabled(enabled);
 	}
 	/**
 	* @ignore
@@ -7862,9 +8062,8 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		const commandService = injector.get(_univerjs_core.ICommandService);
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetCreate, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.InsertSheetCommand.id) {
-				var _this$getActiveWorkbo2;
 				const { unitId, index, sheet } = commandInfo.params || {};
-				const workbook = unitId ? this.getUniverSheet(unitId) : (_this$getActiveWorkbo2 = this.getActiveWorkbook) === null || _this$getActiveWorkbo2 === void 0 ? void 0 : _this$getActiveWorkbo2.call(this);
+				const workbook = unitId ? this.getWorkbook(unitId) : this.getActiveWorkbook();
 				if (!workbook) return;
 				const eventParams = {
 					workbook,
@@ -7877,11 +8076,10 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeActiveSheetChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetActiveOperation.id) {
-				var _this$getActiveWorkbo3;
-				const { subUnitId: sheetId, unitId } = commandInfo.params;
-				const workbook = unitId ? this.getUniverSheet(unitId) : (_this$getActiveWorkbo3 = this.getActiveWorkbook) === null || _this$getActiveWorkbo3 === void 0 ? void 0 : _this$getActiveWorkbo3.call(this);
-				if (!workbook || !sheetId) return;
-				const activeSheet = workbook.getSheetBySheetId(sheetId);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
+				if (!target) return;
+				const { workbook, worksheet: activeSheet } = target;
 				const oldActiveSheet = workbook.getActiveSheet();
 				if (!activeSheet || !oldActiveSheet) return;
 				const eventParams = {
@@ -7895,7 +8093,8 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetDelete, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.RemoveSheetCommand.id) {
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet } = target;
 				const eventParams = {
@@ -7908,14 +8107,16 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetMove, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetOrderMutation.id) {
-				const { fromOrder, toOrder } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
+				const { workbook, worksheet } = target;
+				const { fromOrder: oldIndex, toOrder: newIndex } = params;
 				const eventParams = {
-					workbook: target.workbook,
-					worksheet: target.worksheet,
-					newIndex: toOrder,
-					oldIndex: fromOrder
+					workbook,
+					worksheet,
+					newIndex,
+					oldIndex
 				};
 				this.fireEvent(this.Event.BeforeSheetMove, eventParams);
 				if (eventParams.cancel) throw new _univerjs_core.CanceledError();
@@ -7923,14 +8124,17 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetNameChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetNameCommand.id) {
-				const { name } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
+				const { workbook, worksheet } = target;
+				const oldName = worksheet.getSheetName();
+				const { name: newName } = params;
 				const eventParams = {
-					workbook: target.workbook,
-					worksheet: target.worksheet,
-					newName: name,
-					oldName: target.worksheet.getSheetName()
+					workbook,
+					worksheet,
+					newName,
+					oldName
 				};
 				this.fireEvent(this.Event.BeforeSheetNameChange, eventParams);
 				if (eventParams.cancel) throw new _univerjs_core.CanceledError();
@@ -7938,14 +8142,17 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetTabColorChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetTabColorMutation.id) {
-				const { color } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
+				const { workbook, worksheet } = target;
+				const oldColor = worksheet.getTabColor();
+				const { color: newColor } = params;
 				const eventParams = {
-					workbook: target.workbook,
-					worksheet: target.worksheet,
-					newColor: color,
-					oldColor: target.worksheet.getTabColor()
+					workbook,
+					worksheet,
+					newColor,
+					oldColor
 				};
 				this.fireEvent(this.Event.BeforeSheetTabColorChange, eventParams);
 				if (eventParams.cancel) throw new _univerjs_core.CanceledError();
@@ -7953,12 +8160,14 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetHideChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetHideMutation.id) {
-				const { hidden } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
+				const { workbook, worksheet } = target;
+				const { hidden } = params;
 				const eventParams = {
-					workbook: target.workbook,
-					worksheet: target.worksheet,
+					workbook,
+					worksheet,
 					hidden: Boolean(hidden)
 				};
 				this.fireEvent(this.Event.BeforeSheetHideChange, eventParams);
@@ -7967,12 +8176,15 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeGridlineColorChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetGridlinesColorCommand.id) {
-				var _commandInfo$params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
+				const { workbook, worksheet } = target;
+				const { color } = params;
 				const eventParams = {
-					...target,
-					color: (_commandInfo$params = commandInfo.params) === null || _commandInfo$params === void 0 ? void 0 : _commandInfo$params.color
+					workbook,
+					worksheet,
+					color
 				};
 				this.fireEvent(this.Event.BeforeGridlineColorChange, eventParams);
 				if (eventParams.cancel) throw new _univerjs_core.CanceledError();
@@ -7980,12 +8192,15 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeGridlineEnableChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.ToggleGridlinesCommand.id) {
-				var _showGridlines, _commandInfo$params2;
-				const target = this.getCommandSheetTarget(commandInfo);
+				var _params$showGridlines;
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
-				const showGridlines = (_showGridlines = (_commandInfo$params2 = commandInfo.params) === null || _commandInfo$params2 === void 0 ? void 0 : _commandInfo$params2.showGridlines) !== null && _showGridlines !== void 0 ? _showGridlines : !target.worksheet.hasHiddenGridLines();
+				const { workbook, worksheet } = target;
+				const showGridlines = (_params$showGridlines = params.showGridlines) !== null && _params$showGridlines !== void 0 ? _params$showGridlines : !worksheet.hasHiddenGridLines();
 				const eventParams = {
-					...target,
+					workbook,
+					worksheet,
 					enabled: Boolean(showGridlines)
 				};
 				this.fireEvent(this.Event.BeforeGridlineEnableChange, eventParams);
@@ -8009,12 +8224,10 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetCreated, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.InsertSheetCommand.id) {
-				var _this$getActiveWorkbo4;
-				const { unitId } = commandInfo.params || {};
-				const workbook = unitId ? this.getUniverSheet(unitId) : (_this$getActiveWorkbo4 = this.getActiveWorkbook) === null || _this$getActiveWorkbo4 === void 0 ? void 0 : _this$getActiveWorkbo4.call(this);
-				if (!workbook) return;
-				const worksheet = workbook.getActiveSheet();
-				if (!worksheet) return;
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
+				if (!target) return;
+				const { workbook, worksheet } = target;
 				const eventParams = {
 					workbook,
 					worksheet
@@ -8024,7 +8237,8 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.ActiveSheetChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetActiveOperation.id) {
-				const target = this.getActiveSheet();
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet: activeSheet } = target;
 				const eventParams = {
@@ -8036,9 +8250,8 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetDeleted, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.RemoveSheetCommand.id) {
-				var _this$getActiveWorkbo5;
-				const { subUnitId: sheetId, unitId } = commandInfo.params;
-				const workbook = unitId ? this.getUniverSheet(unitId) : (_this$getActiveWorkbo5 = this.getActiveWorkbook) === null || _this$getActiveWorkbo5 === void 0 ? void 0 : _this$getActiveWorkbo5.call(this);
+				const { unitId, subUnitId: sheetId } = commandInfo.params;
+				const workbook = unitId ? this.getWorkbook(unitId) : this.getActiveWorkbook();
 				if (!workbook || !sheetId) return;
 				const eventParams = {
 					workbook,
@@ -8049,52 +8262,56 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetMoved, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetOrderMutation.id) {
-				const { toOrder: toIndex } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet } = target;
+				const { toOrder: newIndex } = params;
 				const eventParams = {
 					workbook,
 					worksheet,
-					newIndex: toIndex
+					newIndex
 				};
 				this.fireEvent(this.Event.SheetMoved, eventParams);
 			}
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetNameChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetNameCommand.id) {
-				const { name } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet } = target;
+				const { name: newName } = params;
 				const eventParams = {
 					workbook,
 					worksheet,
-					newName: name
+					newName
 				};
 				this.fireEvent(this.Event.SheetNameChanged, eventParams);
 			}
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetTabColorChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetTabColorMutation.id) {
-				const { color } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet } = target;
+				const { color: newColor } = params;
 				const eventParams = {
 					workbook,
 					worksheet,
-					newColor: color
+					newColor
 				};
 				this.fireEvent(this.Event.SheetTabColorChanged, eventParams);
 			}
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetHideChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetWorksheetHideMutation.id) {
-				const { hidden } = commandInfo.params;
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
 				const { workbook, worksheet } = target;
+				const { hidden } = params;
 				const eventParams = {
 					workbook,
 					worksheet,
@@ -8105,58 +8322,47 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.GridlineChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === _univerjs_sheets.SetGridlinesColorCommand.id || commandInfo.id === _univerjs_sheets.ToggleGridlinesCommand.id) {
-				const target = this.getCommandSheetTarget(commandInfo);
+				const params = commandInfo.params;
+				const target = this.getSheetCommandTarget(params);
 				if (!target) return;
+				const { workbook, worksheet } = target;
 				const eventParams = {
-					...target,
-					enabled: !target.worksheet.hasHiddenGridLines(),
-					color: target.worksheet.getGridLinesColor()
+					workbook,
+					worksheet,
+					enabled: !worksheet.hasHiddenGridLines(),
+					color: worksheet.getGridLinesColor()
 				};
 				this.fireEvent(this.Event.GridlineChanged, eventParams);
 			}
 		})));
 		this._initWorkbookEvent(injector);
 	}
-	createUniverSheet(data, options) {
-		const workbook = this._injector.get(_univerjs_core.IUniverInstanceService).createUnit(_univerjs_core.UniverInstanceType.UNIVER_SHEET, data, options);
-		return this._injector.createInstance(FWorkbook, workbook);
-	}
-	createWorkbook(data, options) {
-		return this.createUniverSheet(data, options);
-	}
-	getActiveWorkbook() {
-		const workbook = this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
-		if (!workbook) return null;
-		return this._injector.createInstance(FWorkbook, workbook);
-	}
-	getActiveUniverSheet() {
-		return this.getActiveWorkbook();
-	}
-	getUniverSheet(id) {
-		const workbook = this._univerInstanceService.getUnit(id, _univerjs_core.UniverInstanceType.UNIVER_SHEET);
-		if (!workbook) return null;
-		return this._injector.createInstance(FWorkbook, workbook);
-	}
-	getWorkbook(id) {
-		return this.getUniverSheet(id);
-	}
-	onUniverSheetCreated(callback) {
-		return (0, _univerjs_core.toDisposable)(this._univerInstanceService.getTypeOfUnitAdded$(_univerjs_core.UniverInstanceType.UNIVER_SHEET).subscribe((event) => {
-			callback(this._injector.createInstance(FWorkbook, event.unit));
-		}));
-	}
-	getActiveSheet() {
-		const workbook = this.getActiveWorkbook();
-		if (!workbook) return null;
-		const worksheet = workbook.getActiveSheet();
-		if (!worksheet) return null;
-		return {
-			workbook,
-			worksheet
-		};
-	}
-	setFreezeSync(enabled) {
-		this._injector.get(_univerjs_sheets.SheetsFreezeSyncController).setEnabled(enabled);
+	_initWorkbookEvent(injector) {
+		const univerInstanceService = injector.get(_univerjs_core.IUniverInstanceService);
+		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookDisposed, () => univerInstanceService.unitDisposed$.subscribe((unit) => {
+			if (unit.type === _univerjs_core.UniverInstanceType.UNIVER_SHEET) {
+				const eventParams = {
+					unitId: unit.getUnitId(),
+					unitType: unit.type,
+					snapshot: unit.getSnapshot()
+				};
+				this.fireEvent(this.Event.WorkbookDisposed, eventParams);
+			}
+		})));
+		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookCreated, () => univerInstanceService.unitAdded$.subscribe((event) => {
+			const { unit } = event;
+			if (unit.type === _univerjs_core.UniverInstanceType.UNIVER_SHEET) {
+				const workbook = unit;
+				const workbookUnit = injector.createInstance(FWorkbook, workbook);
+				const eventParams = {
+					unitId: unit.getUnitId(),
+					type: unit.type,
+					workbook: workbookUnit,
+					unit: workbookUnit
+				};
+				this.fireEvent(this.Event.WorkbookCreated, eventParams);
+			}
+		})));
 	}
 };
 _univerjs_core_facade.FUniver.extend(FUniverSheetsMixin);
@@ -8269,31 +8475,6 @@ var FSheetsEventNameMixin = class extends _univerjs_core_facade.FEventName {
 };
 _univerjs_core_facade.FEventName.extend(FSheetsEventNameMixin);
 
-//#endregion
-//#region src/facade/f-sheet-hooks.ts
-/**
-* Copyright 2023-present DreamNum Co., Ltd.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-*     http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-let FSheetHooks = class FSheetHooks extends _univerjs_core_facade.FBase {
-	constructor(_injector) {
-		super();
-		this._injector = _injector;
-	}
-};
-FSheetHooks = __decorate([__decorateParam(0, (0, _univerjs_core.Inject)(_univerjs_core.Injector))], FSheetHooks);
-
 //#endregion
 Object.defineProperty(exports, 'FRange', {
   enumerable: true,
@@ -8307,12 +8488,6 @@ Object.defineProperty(exports, 'FSelection', {
     return FSelection;
   }
 });
-Object.defineProperty(exports, 'FSheetHooks', {
-  enumerable: true,
-  get: function () {
-    return FSheetHooks;
-  }
-});
 exports.FSheetsEnumMixin = FSheetsEnumMixin;
 exports.FSheetsEventNameMixin = FSheetsEventNameMixin;
 Object.defineProperty(exports, 'FWorkbook', {