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

package/lib/facade.js

@@ -4,7 +4,26 @@ import { AddRangeProtectionMutation, AddWorksheetProtectionMutation, AppendRowCo
 import { FormulaDataModel, IDefinedNamesService, IFunctionService, ISuperTableService, deserializeRangeWithSheet, serializeRange, serializeRangeWithSheet } from "@univerjs/engine-formula";
 import { ObjectScope, UnitAction, UnitObject as UnitObject$1, UnitRole } from "@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) {
@@ -15,7 +34,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];
@@ -28,14 +47,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,
@@ -46,7 +65,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);
@@ -54,7 +73,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);
@@ -73,13 +92,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++;
 	}
@@ -579,7 +598,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();
@@ -597,7 +617,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) => {
@@ -616,7 +637,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();
@@ -637,10 +659,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() {
@@ -654,7 +677,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');
@@ -705,7 +729,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();
@@ -1050,7 +1075,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) {
@@ -1086,7 +1112,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) {
@@ -1125,7 +1152,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 });
@@ -1163,7 +1191,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) {
@@ -1190,7 +1219,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];
@@ -1208,7 +1238,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];
@@ -1226,7 +1257,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];
@@ -1244,7 +1276,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];
@@ -1262,7 +1295,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) {
@@ -1312,7 +1346,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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');
 	* }
@@ -1329,7 +1364,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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
@@ -1407,7 +1443,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().unprotect();
 	* ```
 	*/
@@ -1432,7 +1469,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setMode('readOnly');
 	* ```
 	*/
@@ -1472,7 +1510,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setReadOnly();
 	* ```
 	*/
@@ -1485,7 +1524,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setEditable();
 	* ```
 	*/
@@ -1501,7 +1541,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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);
 	* ```
@@ -1536,7 +1577,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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');
 	* }
@@ -1553,7 +1595,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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());
@@ -1577,7 +1620,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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');
 	* }
@@ -1593,7 +1637,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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());
@@ -1618,7 +1663,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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);
@@ -1638,7 +1684,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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);
 	* ```
@@ -1657,7 +1704,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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',
@@ -1688,7 +1736,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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')],
@@ -1777,7 +1826,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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
@@ -1803,7 +1853,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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);
 	* ```
@@ -1822,7 +1873,8 @@ let FWorksheetPermission = class FWorksheetPermission extends FBase {
 	* @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());
@@ -1982,7 +2034,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 			* @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'));
 			* ```
 			*/
@@ -2001,7 +2054,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2014,7 +2068,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2027,7 +2082,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2040,7 +2096,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2053,7 +2110,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2066,7 +2124,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2081,7 +2140,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -2096,7 +2156,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -2115,7 +2176,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -2133,7 +2195,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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'});
@@ -2158,7 +2221,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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'});
@@ -2181,7 +2245,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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'});
@@ -2235,7 +2300,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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`);
 	* ```
@@ -2248,7 +2314,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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`);
 	* ```
@@ -2262,7 +2329,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2278,7 +2346,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2295,7 +2364,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2312,7 +2382,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2349,7 +2420,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2385,7 +2457,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2402,7 +2475,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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)
@@ -2429,7 +2503,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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]]);
 	* ```
@@ -2447,7 +2522,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -2482,7 +2558,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -2509,7 +2586,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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)
@@ -2539,7 +2617,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -2566,7 +2645,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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)
@@ -2597,7 +2677,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2614,7 +2695,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
 	*/
@@ -2650,7 +2732,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
 	*/
@@ -2692,7 +2775,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
@@ -2712,7 +2796,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
 	*/
@@ -2738,7 +2823,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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 },
@@ -2764,7 +2850,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
 	*/
@@ -2791,11 +2878,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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 = {};
@@ -2814,7 +2903,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2830,7 +2920,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2847,7 +2938,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2864,7 +2956,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2901,7 +2994,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2937,7 +3031,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -2954,7 +3049,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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)
@@ -2981,7 +3077,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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]]);
 	* ```
@@ -2999,7 +3096,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3034,7 +3132,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3061,7 +3160,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -3091,7 +3191,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3118,7 +3219,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -3149,7 +3251,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -3165,7 +3268,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -3194,7 +3298,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
@@ -3216,11 +3321,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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 = {};
@@ -3238,7 +3345,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -3255,7 +3363,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -3274,7 +3383,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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());
@@ -3290,7 +3400,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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) {
@@ -3307,7 +3418,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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'));
 	* ```
 	*/
@@ -3322,7 +3434,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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());
 	* ```
 	*/
@@ -3336,7 +3449,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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,
@@ -3359,7 +3473,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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();
 	* ```
@@ -3376,7 +3491,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3436,7 +3552,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3452,7 +3569,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3468,7 +3586,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3486,7 +3605,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3504,7 +3624,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
@@ -3520,7 +3641,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	* ```
@@ -3539,7 +3661,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
 	* ```
@@ -3558,7 +3681,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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());
 	* ```
@@ -3573,7 +3697,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
 	* ```
@@ -3593,7 +3718,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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());
 	* ```
@@ -3607,7 +3733,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // hide the active sheet
 	* fWorkSheet.hideSheet();
 	* ```
@@ -3660,7 +3787,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
 	* ```
@@ -3694,7 +3822,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -3712,7 +3841,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -3745,7 +3875,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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();
 	* ```
@@ -3773,7 +3904,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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();
 	* ```
@@ -3802,7 +3934,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
@@ -3819,7 +3952,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
@@ -3835,7 +3969,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
@@ -3853,7 +3988,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* ```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.
 	* ```
 	*/
@@ -3868,7 +4004,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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');
 	* ```
 	*/
@@ -3882,7 +4019,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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());
 	* ```
@@ -3897,11 +4035,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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;
 	}
@@ -3911,12 +4051,14 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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();
 	}
 	/**
@@ -3927,11 +4069,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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;
 	}
@@ -3943,11 +4087,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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;
 	}
@@ -3958,12 +4104,14 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	}
 	/**
@@ -3973,12 +4121,14 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
 	}
 	/**
@@ -3990,7 +4140,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* // 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']);
 	* ```
 	*/
@@ -4020,7 +4171,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -4041,7 +4193,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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);
@@ -4061,7 +4214,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* @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
@@ -4115,7 +4269,8 @@ let FRangePermission = class FRangePermission extends FBase {
 	* @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();
@@ -4132,7 +4287,8 @@ let FRangePermission = class FRangePermission extends FBase {
 	* @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',
@@ -4202,7 +4358,8 @@ let FRangePermission = class FRangePermission extends FBase {
 	* @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);
@@ -4224,7 +4381,8 @@ let FRangePermission = class FRangePermission extends FBase {
 	* @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);
@@ -4249,7 +4407,7 @@ FRangePermission = __decorate([
 //#region src/facade/f-range.ts
 var _FRange, _FRange2;
 let FRange = _FRange = class FRange extends FBaseInitialable {
-	constructor(_workbook, _worksheet, _range, _injector, _commandService, _formulaDataModel) {
+	constructor(_workbook, _worksheet, _range, _injector, _commandService, _formulaDataModel, _logService) {
 		super(_injector);
 		this._workbook = _workbook;
 		this._worksheet = _worksheet;
@@ -4257,6 +4415,7 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 		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)}`);
@@ -4268,7 +4427,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4282,7 +4442,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4296,7 +4457,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4310,7 +4472,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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;
@@ -4326,7 +4489,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
 	* ```
@@ -4340,7 +4504,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
 	* ```
@@ -4354,7 +4519,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
 	* ```
@@ -4368,7 +4534,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
 	* ```
@@ -4382,7 +4549,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4396,7 +4564,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4410,7 +4579,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
@@ -4435,7 +4605,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4456,7 +4627,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4477,7 +4649,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4498,7 +4671,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4519,7 +4693,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4542,7 +4717,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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,
@@ -4567,7 +4743,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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,
@@ -4606,7 +4783,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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([
 	*   [
@@ -4667,7 +4845,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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([
 	*   [
@@ -4727,7 +4906,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4742,7 +4922,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4756,7 +4937,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4779,7 +4961,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4797,7 +4980,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4813,7 +4997,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4828,7 +5013,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4842,7 +5028,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4857,7 +5044,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4883,7 +5071,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4897,7 +5086,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	*/
@@ -4915,7 +5105,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4929,7 +5120,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4943,7 +5135,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4957,7 +5150,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4971,7 +5165,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -4985,13 +5180,15 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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(),
@@ -5007,7 +5204,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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' }],
@@ -5017,6 +5215,7 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```
 	*/
 	setCustomMetaDatas(datas) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		const params = {
 			unitId: this._workbook.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
@@ -5032,13 +5231,15 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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;
 	}
@@ -5048,12 +5249,14 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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;
@@ -5068,7 +5271,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5092,7 +5296,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -5108,7 +5313,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
 	* ```
@@ -5126,7 +5332,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5150,7 +5357,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5166,7 +5374,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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);
 	* ```
@@ -5186,7 +5395,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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);
 	*
@@ -5211,7 +5421,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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);
 	*
@@ -5242,7 +5453,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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));
 	*
@@ -5278,7 +5490,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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));
 	*
@@ -5313,7 +5526,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
@@ -5335,7 +5549,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
@@ -5357,7 +5572,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5378,7 +5594,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5399,7 +5616,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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' } } }],
@@ -5424,7 +5642,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5455,7 +5674,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5486,7 +5706,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5546,7 +5767,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5572,7 +5794,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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);
 	* ```
@@ -5598,7 +5821,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5626,7 +5850,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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());
@@ -5634,7 +5859,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	*
 	* ```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 });
@@ -5656,7 +5882,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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.
@@ -5668,7 +5895,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	*
 	* ```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 });
@@ -5691,7 +5919,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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.
@@ -5703,7 +5932,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	*
 	* ```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 });
@@ -5722,7 +5952,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
@@ -5739,7 +5970,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
@@ -5764,7 +5996,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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);
@@ -5785,7 +6018,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
@@ -5823,7 +6057,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
 	* ```
@@ -5841,7 +6076,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
@@ -5893,7 +6129,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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   |
@@ -5935,7 +6172,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5957,7 +6195,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
 	* ```
@@ -5976,7 +6215,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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');
@@ -5999,7 +6239,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
@@ -6026,7 +6267,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
@@ -6047,7 +6289,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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();
@@ -6068,7 +6311,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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],
@@ -6127,7 +6371,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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],
@@ -6190,7 +6435,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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:
 	* //  |     |     |
@@ -6260,7 +6506,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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
 	*
@@ -6292,7 +6539,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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
 	*
@@ -6322,7 +6570,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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)'
@@ -6338,7 +6587,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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)'],
@@ -6356,7 +6606,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* @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();
 	*
@@ -6391,7 +6642,8 @@ let FRange = _FRange = class FRange extends FBaseInitialable {
 	* ```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)
@@ -6443,7 +6695,8 @@ _FRange2._enableManualInit();
 FRange = _FRange = __decorate([
 	__decorateParam(3, Inject(Injector)),
 	__decorateParam(4, ICommandService),
-	__decorateParam(5, Inject(FormulaDataModel))
+	__decorateParam(5, Inject(FormulaDataModel)),
+	__decorateParam(6, ILogService)
 ], FRange);
 
 //#endregion
@@ -6779,7 +7032,7 @@ FWorkbookPermission = __decorate([
 //#endregion
 //#region src/facade/f-workbook.ts
 let FWorkbook = class FWorkbook extends 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;
@@ -6789,7 +7042,6 @@ let FWorkbook = class FWorkbook extends 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();
@@ -6872,21 +7124,6 @@ let FWorkbook = class FWorkbook extends 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
@@ -6894,6 +7131,7 @@ let FWorkbook = class FWorkbook extends 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);
 	* ```
 	*/
@@ -7238,7 +7476,9 @@ let FWorkbook = class FWorkbook extends 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);
 	* ```
 	*/
@@ -7316,7 +7556,8 @@ let FWorkbook = class FWorkbook extends 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);
 	* ```
@@ -7356,42 +7597,6 @@ let FWorkbook = class FWorkbook extends 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
@@ -7414,7 +7619,8 @@ let FWorkbook = class FWorkbook extends 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);
 	* ```
 	*/
@@ -7695,6 +7901,7 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 	* ```
 	*/
 	setCustomMetadata(custom) {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		this._workbook.setCustomMetadata(custom);
 		return this;
 	}
@@ -7709,6 +7916,7 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 	* ```
 	*/
 	getCustomMetadata() {
+		this._logService.warn(SHEETS_CUSTOM_FIELD_WARNING_MESSAGE);
 		return this._workbook.getCustomMetadata();
 	}
 	/**
@@ -7735,7 +7943,8 @@ let FWorkbook = class FWorkbook extends 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' }],
@@ -7770,7 +7979,8 @@ let FWorkbook = class FWorkbook extends 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' }],
@@ -7796,62 +8006,52 @@ FWorkbook = __decorate([
 	__decorateParam(5, ICommandService),
 	__decorateParam(6, IPermissionService),
 	__decorateParam(7, ILogService),
-	__decorateParam(8, Inject(LocaleService)),
-	__decorateParam(9, IDefinedNamesService)
+	__decorateParam(8, IDefinedNamesService)
 ], FWorkbook);
 
 //#endregion
 //#region src/facade/f-univer.ts
 var FUniverSheetsMixin = class extends 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(IUniverInstanceService).createUnit(UniverInstanceType.UNIVER_SHEET, data, options);
+		return this._injector.createInstance(FWorkbook, workbook);
+	}
+	getActiveWorkbook() {
+		const workbook = this._univerInstanceService.getCurrentUnitOfType(UniverInstanceType.UNIVER_SHEET);
+		if (!workbook) return null;
+		return this._injector.createInstance(FWorkbook, workbook);
+	}
+	getWorkbook(id) {
+		const workbook = this._univerInstanceService.getUnit(id, 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(IUniverInstanceService);
-		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookDisposed, () => univerInstanceService.unitDisposed$.subscribe((unit) => {
-			if (unit.type === 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 === 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(SheetsFreezeSyncController).setEnabled(enabled);
 	}
 	/**
 	* @ignore
@@ -7861,9 +8061,8 @@ var FUniverSheetsMixin = class extends FUniver {
 		const commandService = injector.get(ICommandService);
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetCreate, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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,
@@ -7876,11 +8075,10 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeActiveSheetChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 = {
@@ -7894,7 +8092,8 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetDelete, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 = {
@@ -7907,14 +8106,16 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetMove, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 CanceledError();
@@ -7922,14 +8123,17 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetNameChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 CanceledError();
@@ -7937,14 +8141,17 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetTabColorChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 CanceledError();
@@ -7952,12 +8159,14 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeSheetHideChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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);
@@ -7966,12 +8175,15 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeGridlineColorChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 CanceledError();
@@ -7979,12 +8191,15 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.BeforeGridlineEnableChange, () => commandService.beforeCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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);
@@ -8008,12 +8223,10 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetCreated, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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
@@ -8023,7 +8236,8 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.ActiveSheetChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 = {
@@ -8035,9 +8249,8 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetDeleted, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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,
@@ -8048,52 +8261,56 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.SheetMoved, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === 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 === 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 === 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 === 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,
@@ -8104,58 +8321,47 @@ var FUniverSheetsMixin = class extends FUniver {
 		})));
 		this.disposeWithMe(this.registerEventHandler(this.Event.GridlineChanged, () => commandService.onCommandExecuted((commandInfo) => {
 			if (commandInfo.id === SetGridlinesColorCommand.id || commandInfo.id === 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(IUniverInstanceService).createUnit(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(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, UniverInstanceType.UNIVER_SHEET);
-		if (!workbook) return null;
-		return this._injector.createInstance(FWorkbook, workbook);
-	}
-	getWorkbook(id) {
-		return this.getUniverSheet(id);
-	}
-	onUniverSheetCreated(callback) {
-		return toDisposable(this._univerInstanceService.getTypeOfUnitAdded$(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(SheetsFreezeSyncController).setEnabled(enabled);
+	_initWorkbookEvent(injector) {
+		const univerInstanceService = injector.get(IUniverInstanceService);
+		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookDisposed, () => univerInstanceService.unitDisposed$.subscribe((unit) => {
+			if (unit.type === 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 === 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);
+			}
+		})));
 	}
 };
 FUniver.extend(FUniverSheetsMixin);
@@ -8269,29 +8475,4 @@ var FSheetsEventNameMixin = class extends FEventName {
 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 FBase {
-	constructor(_injector) {
-		super();
-		this._injector = _injector;
-	}
-};
-FSheetHooks = __decorate([__decorateParam(0, Inject(Injector))], FSheetHooks);
-
-//#endregion
-export { FRange, FSelection, FSheetHooks, FSheetsEnumMixin, FSheetsEventNameMixin, FWorkbook, FWorkbookPermission, FWorksheet };
+export { FRange, FSelection, FSheetsEnumMixin, FSheetsEventNameMixin, FWorkbook, FWorkbookPermission, FWorksheet };