@univerjs/sheets 0.21.0 → 0.21.1

package/lib/es/facade.js

@@ -1,7 +1,7 @@
-import { BooleanNumber, CanceledError, DEFAULT_STYLES, Dimension, Direction, HorizontalAlign, IAuthzIoService, ICommandService, ILogService, IPermissionService, IResourceLoaderService, IUniverInstanceService, Inject, Injector, LocaleService, ObjectMatrix, PermissionService, RANGE_TYPE, Rectangle, RedoCommand, RichTextValue, TextStyleValue, Tools, UndoCommand, UniverInstanceType, VerticalAlign, WrapStrategy, cellToRange, covertCellValue, covertCellValues, generateIntervalsByPoints, generateRandomId, isNullCell, mergeWorksheetSnapshotWithDefault, toDisposable } from "@univerjs/core";
+import { BooleanNumber, CanceledError, DEFAULT_STYLES, Dimension, Direction, HorizontalAlign, IAuthzIoService, ICommandService, ILogService, IPermissionService, IResourceLoaderService, IUniverInstanceService, Inject, Injector, LocaleService, ObjectMatrix, RANGE_TYPE, Rectangle, RedoCommand, RichTextValue, TextStyleValue, Tools, UndoCommand, UniverInstanceType, VerticalAlign, WrapStrategy, cellToRange, covertCellValue, covertCellValues, generateIntervalsByPoints, generateRandomId, isNullCell, mergeWorksheetSnapshotWithDefault, toDisposable } from "@univerjs/core";
 import { FBase, FBaseInitialable, FEnum, FEventName, FUniver } from "@univerjs/core/facade";
-import { AddRangeProtectionMutation, AddWorksheetProtectionMutation, AppendRowCommand, AutoFillCommand, COMMAND_LISTENER_VALUE_CHANGE, CancelFrozenCommand, ClearSelectionAllCommand, ClearSelectionContentCommand, ClearSelectionFormatCommand, CopySheetCommand, DeleteRangeMoveLeftCommand, DeleteRangeMoveUpCommand, DeleteRangeProtectionMutation, DeleteWorksheetProtectionMutation, DeleteWorksheetRangeThemeStyleCommand, EditStateEnum, InsertColByRangeCommand, InsertRangeMoveDownCommand, InsertRangeMoveRightCommand, InsertRowByRangeCommand, InsertSheetCommand, MoveColsCommand, MoveRowsCommand, RangeProtectionPermissionDeleteProtectionPoint, RangeProtectionPermissionEditPoint, RangeProtectionPermissionManageCollaPoint, RangeProtectionPermissionViewPoint, RangeProtectionRuleModel, RangeThemeStyle, RegisterWorksheetRangeThemeStyleCommand, RemoveColByRangeCommand, RemoveDefinedNameCommand, RemoveRowByRangeCommand, RemoveSheetCommand, RemoveWorksheetMergeCommand, SCOPE_WORKBOOK_VALUE_DEFINED_NAME, SetBorderBasicCommand, SetColDataCommand, SetColHiddenCommand, SetColWidthCommand, SetDefinedNameCommand, SetFrozenCommand, SetGridlinesColorCommand, SetHorizontalTextAlignCommand, SetRangeCustomMetadataCommand, SetRangeProtectionMutation, SetRangeValuesCommand, SetRangeValuesMutation, SetRowDataCommand, SetRowHeightCommand, SetRowHiddenCommand, SetSelectionsOperation, SetSpecificColsVisibleCommand, SetSpecificRowsVisibleCommand, SetStyleCommand, SetTabColorCommand, SetTabColorMutation, SetTextRotationCommand, SetTextWrapCommand, SetVerticalTextAlignCommand, SetWorkbookNameCommand, SetWorksheetActiveOperation, SetWorksheetColumnCountCommand, SetWorksheetDefaultStyleMutation, SetWorksheetHideCommand, SetWorksheetHideMutation, SetWorksheetNameCommand, SetWorksheetOrderCommand, SetWorksheetOrderMutation, SetWorksheetRangeThemeStyleCommand, SetWorksheetRowCountCommand, SetWorksheetRowIsAutoHeightCommand, SetWorksheetRowIsAutoHeightMutation, SetWorksheetShowCommand, SheetRangeThemeService, SheetSkeletonChangeType, SheetValueChangeType, SheetsFreezeSyncController, SheetsSelectionsService, SplitDelimiterEnum, SplitTextToColumnsCommand, ToggleGridlinesCommand, UnitObject, UnregisterWorksheetRangeThemeStyleCommand, ViewStateEnum, WorkbookCommentPermission, WorkbookCopyPermission, WorkbookCopySheetPermission, WorkbookCreateProtectPermission, WorkbookCreateSheetPermission, WorkbookDeleteColumnPermission, WorkbookDeleteRowPermission, WorkbookDeleteSheetPermission, WorkbookDuplicatePermission, WorkbookEditablePermission, WorkbookExportPermission, WorkbookHideSheetPermission, WorkbookInsertColumnPermission, WorkbookInsertRowPermission, WorkbookManageCollaboratorPermission, WorkbookMoveSheetPermission, WorkbookPrintPermission, WorkbookRecoverHistoryPermission, WorkbookRenameSheetPermission, WorkbookSharePermission, WorkbookViewHistoryPermission, WorkbookViewPermission, WorksheetCopyPermission, WorksheetDeleteColumnPermission, WorksheetDeleteProtectionPermission, WorksheetDeleteRowPermission, WorksheetEditExtraObjectPermission, WorksheetEditPermission, WorksheetFilterPermission, WorksheetInsertColumnPermission, WorksheetInsertHyperlinkPermission, WorksheetInsertRowPermission, WorksheetManageCollaboratorPermission, WorksheetPivotTablePermission, WorksheetProtectionPointModel, WorksheetProtectionRuleModel, WorksheetSelectProtectedCellsPermission, WorksheetSelectUnProtectedCellsPermission, WorksheetSetCellStylePermission, WorksheetSetCellValuePermission, WorksheetSetColumnStylePermission, WorksheetSetRowStylePermission, WorksheetSortPermission, WorksheetViewPermission, addMergeCellsUtil, copyRangeStyles, getAddMergeMutationRangeByType, getAllWorksheetPermissionPoint, getAllWorksheetPermissionPointByPointPanel, getNextPrimaryCell, getPrimaryForRange, getValueChangedEffectedRange } from "@univerjs/sheets";
-import { FormulaDataModel, IDefinedNamesService, deserializeRangeWithSheet, serializeRange, serializeRangeWithSheet } from "@univerjs/engine-formula";
+import { AddRangeProtectionMutation, AddWorksheetProtectionMutation, AppendRowCommand, AutoFillCommand, COMMAND_LISTENER_VALUE_CHANGE, CancelFrozenCommand, ClearSelectionAllCommand, ClearSelectionContentCommand, ClearSelectionFormatCommand, CopySheetCommand, DeleteRangeMoveLeftCommand, DeleteRangeMoveUpCommand, DeleteRangeProtectionMutation, DeleteWorksheetProtectionMutation, DeleteWorksheetRangeThemeStyleCommand, EditStateEnum, InsertColByRangeCommand, InsertRangeMoveDownCommand, InsertRangeMoveRightCommand, InsertRowByRangeCommand, InsertSheetCommand, MoveColsCommand, MoveRowsCommand, RangeProtectionPermissionDeleteProtectionPoint, RangeProtectionPermissionEditPoint, RangeProtectionPermissionManageCollaPoint, RangeProtectionPermissionViewPoint, RangeProtectionRuleModel, RangeThemeStyle, RegisterWorksheetRangeThemeStyleCommand, RemoveColByRangeCommand, RemoveDefinedNameCommand, RemoveRowByRangeCommand, RemoveSheetCommand, RemoveWorksheetMergeCommand, SCOPE_WORKBOOK_VALUE_DEFINED_NAME, SetBorderBasicCommand, SetColDataCommand, SetColHiddenCommand, SetColWidthCommand, SetDefinedNameCommand, SetFrozenCommand, SetGridlinesColorCommand, SetHorizontalTextAlignCommand, SetRangeCustomMetadataCommand, SetRangeProtectionMutation, SetRangeValuesCommand, SetRangeValuesMutation, SetRowDataCommand, SetRowHeightCommand, SetRowHiddenCommand, SetSelectionsOperation, SetSpecificColsVisibleCommand, SetSpecificRowsVisibleCommand, SetStyleCommand, SetTabColorCommand, SetTabColorMutation, SetTextRotationCommand, SetTextWrapCommand, SetVerticalTextAlignCommand, SetWorkbookNameCommand, SetWorksheetActiveOperation, SetWorksheetColumnCountCommand, SetWorksheetDefaultStyleMutation, SetWorksheetHideCommand, SetWorksheetHideMutation, SetWorksheetNameCommand, SetWorksheetOrderCommand, SetWorksheetOrderMutation, SetWorksheetRangeThemeStyleCommand, SetWorksheetRowCountCommand, SetWorksheetRowIsAutoHeightCommand, SetWorksheetRowIsAutoHeightMutation, SetWorksheetShowCommand, SheetRangeThemeService, SheetSkeletonChangeType, SheetValueChangeType, SheetsFreezeSyncController, SheetsSelectionsService, SplitDelimiterEnum, SplitTextToColumnsCommand, ToggleGridlinesCommand, UnitObject, UnregisterWorksheetRangeThemeStyleCommand, ViewStateEnum, WorkbookCommentPermission, WorkbookCopyPermission, WorkbookCopySheetPermission, WorkbookCreateProtectPermission, WorkbookCreateSheetPermission, WorkbookDeleteColumnPermission, WorkbookDeleteRowPermission, WorkbookDeleteSheetPermission, WorkbookDuplicatePermission, WorkbookEditablePermission, WorkbookExportPermission, WorkbookHideSheetPermission, WorkbookInsertColumnPermission, WorkbookInsertRowPermission, WorkbookManageCollaboratorPermission, WorkbookMoveSheetPermission, WorkbookPrintPermission, WorkbookRecoverHistoryPermission, WorkbookRenameSheetPermission, WorkbookSharePermission, WorkbookViewHistoryPermission, WorkbookViewPermission, WorksheetCopyPermission, WorksheetDeleteColumnPermission, WorksheetDeleteProtectionPermission, WorksheetDeleteRowPermission, WorksheetEditExtraObjectPermission, WorksheetEditPermission, WorksheetFilterPermission, WorksheetInsertColumnPermission, WorksheetInsertHyperlinkPermission, WorksheetInsertRowPermission, WorksheetManageCollaboratorPermission, WorksheetPivotTablePermission, WorksheetProtectionPointModel, WorksheetProtectionRuleModel, WorksheetSelectProtectedCellsPermission, WorksheetSelectUnProtectedCellsPermission, WorksheetSetCellStylePermission, WorksheetSetCellValuePermission, WorksheetSetColumnStylePermission, WorksheetSetRowStylePermission, WorksheetSortPermission, WorksheetViewPermission, addMergeCellsUtil, copyRangeStyles, getAddMergeMutationRangeByType, getAllWorksheetPermissionPoint, getAllWorksheetPermissionPointByPointPanel, getNextPrimaryCell, getPrimaryForRange, getValueChangedEffectedRange, validateDefinedName } from "@univerjs/sheets";
+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.124.0/helpers/typeof.js
@@ -84,15 +84,14 @@ function getDefinedNameFieldName(unitId, localeService, definedNamesService) {
 		i++;
 	}
 }
-/**
-* @hideconstructor
-*/
-var FDefinedNameBuilder = class {
-	constructor() {
+let FDefinedNameBuilder = class FDefinedNameBuilder {
+	constructor(unitId, _injector) {
+		this.unitId = unitId;
+		this._injector = _injector;
 		_defineProperty(this, "_definedNameParam", void 0);
 		this._definedNameParam = {
 			id: generateRandomId(10),
-			unitId: "",
+			unitId,
 			name: "",
 			formulaOrRefString: "",
 			localSheetId: SCOPE_WORKBOOK_VALUE_DEFINED_NAME
@@ -105,11 +104,11 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setName(name) {
@@ -123,11 +122,11 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setFormula('SUM(Sheet1!$A$1)')
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setFormula(formula) {
@@ -141,11 +140,11 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setRef(a1Notation) {
@@ -162,11 +161,11 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRefByRange(1, 3, 2, 5) // D2:H3
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setRefByRange(row, column, numRows, numColumns) {
@@ -185,12 +184,12 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .setComment('A reference to A1 cell in Sheet1')
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setComment(comment) {
@@ -207,12 +206,12 @@ var FDefinedNameBuilder = class {
 	* const sheets = fWorkbook.getSheets();
 	*
 	* // Create a defined name and make it available only in the second worksheet
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .setScopeToWorksheet(sheets[1])
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setScopeToWorksheet(worksheet) {
@@ -227,12 +226,12 @@ var FDefinedNameBuilder = class {
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	*
 	* // Create a defined name and make it available in the entire workbook
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .setScopeToWorkbook()
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setScopeToWorkbook() {
@@ -246,12 +245,12 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .setHidden(true)
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	setHidden(hidden) {
@@ -264,15 +263,26 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setName('MyDefinedName')
 	*   .setRef('Sheet1!$A$1')
 	*   .setComment('A reference to A1 cell in Sheet1')
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	build() {
+		const { unitId, name, formulaOrRefString, id } = this._definedNameParam;
+		const validationResult = validateDefinedName(name, {
+			unitId,
+			formulaOrRefString,
+			univerInstanceService: this._injector.get(IUniverInstanceService),
+			definedNamesService: this._injector.get(IDefinedNamesService),
+			superTableService: this._injector.get(ISuperTableService),
+			functionService: this._injector.get(IFunctionService),
+			id
+		});
+		if (typeof validationResult === "string") throw new TypeError(this._injector.get(LocaleService).t(validationResult));
 		return this._definedNameParam;
 	}
 	/**
@@ -282,23 +292,25 @@ var FDefinedNameBuilder = class {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameParam = {
-	*   id: '4TMPceoqg8',
-	*   unitId: fWorkbook.getId(),
-	*   name: 'MyDefinedName',
-	*   formulaOrRefString: 'Sheet1!$A$1',
-	* }
-	* const definedNameBuilder = univerAPI.newDefinedName()
-	*   .load(definedNameParam)
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
+	*   .load({
+	*     id: '4TMPceoqg8',
+	*     name: 'MyDefinedName',
+	*     formulaOrRefString: 'Sheet1!$A$1',
+	*   })
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	load(param) {
-		this._definedNameParam = param;
+		this._definedNameParam = {
+			...this._definedNameParam,
+			...param
+		};
 		return this;
 	}
 };
+FDefinedNameBuilder = __decorate([__decorateParam(1, Inject(Injector))], FDefinedNameBuilder);
 let FDefinedName = class FDefinedName extends FBase {
 	constructor(_definedNameParam, _injector, _commandService, _permissionService, _worksheetProtectionRuleModel, _rangeProtectionRuleModel, _worksheetProtectionPointRuleModel, _authzIoService, _localeService, _definedNamesService) {
 		super();
@@ -524,15 +536,16 @@ let FDefinedName = class FDefinedName extends FBase {
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	* const definedName = fWorkbook.getDefinedNames()[0];
 	* if (!definedName) return;
-	* const definedNameBuilder = definedName
+	* const definedNameParam = definedName
 	*   .toBuilder()
 	*   .setName('NewDefinedName')
 	*   .setFormula('SUM(Sheet1!$A$1)')
 	*   .build();
-	* fWorkbook.updateDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.updateDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	toBuilder() {
+		if (!this._definedNameParam.unitId) throw new Error("unitId is required to convert to FDefinedNameBuilder");
 		const builder = this._injector.createInstance(FDefinedNameBuilder);
 		builder.load(this._definedNameParam);
 		return builder;
@@ -944,7 +957,7 @@ function determineScope(editState, viewState) {
 function handleWorksheetRangePermissionIsEmpty(injector, unitId, subUnitId) {
 	const rangeProtectionRuleModel = injector.get(RangeProtectionRuleModel);
 	const worksheetProtectionPointModel = injector.get(WorksheetProtectionPointModel);
-	const permissionService = injector.get(PermissionService);
+	const permissionService = injector.get(IPermissionService);
 	if (rangeProtectionRuleModel.getSubunitRuleList(unitId, subUnitId).length > 0) return;
 	worksheetProtectionPointModel.deleteRule(unitId, subUnitId);
 	[...getAllWorksheetPermissionPointByPointPanel()].forEach((F) => {
@@ -993,7 +1006,7 @@ async function getListRangeProtectionRules(injector, unitId, subUnitId, options)
 //#endregion
 //#region src/facade/permission/f-range-protection-rule.ts
 let FRangeProtectionRule = class FRangeProtectionRule {
-	constructor(_unitId, _subUnitId, _ruleId, _permissionId, _ranges, _options, _injector, _commandService, _permissionService, _authzIoService, _rangeProtectionRuleModel) {
+	constructor(_unitId, _subUnitId, _ruleId, _permissionId, _ranges, _options, _injector, _permissionService, _authzIoService, _commandService, _rangeProtectionRuleModel) {
 		this._unitId = _unitId;
 		this._subUnitId = _subUnitId;
 		this._ruleId = _ruleId;
@@ -1001,9 +1014,9 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 		this._ranges = _ranges;
 		this._options = _options;
 		this._injector = _injector;
-		this._commandService = _commandService;
 		this._permissionService = _permissionService;
 		this._authzIoService = _authzIoService;
+		this._commandService = _commandService;
 		this._rangeProtectionRuleModel = _rangeProtectionRuleModel;
 	}
 	/**
@@ -1269,9 +1282,9 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 };
 FRangeProtectionRule = __decorate([
 	__decorateParam(6, Inject(Injector)),
-	__decorateParam(7, Inject(ICommandService)),
-	__decorateParam(8, Inject(IPermissionService)),
-	__decorateParam(9, Inject(IAuthzIoService)),
+	__decorateParam(7, IPermissionService),
+	__decorateParam(8, IAuthzIoService),
+	__decorateParam(9, ICommandService),
 	__decorateParam(10, Inject(RangeProtectionRuleModel))
 ], FRangeProtectionRule);
 
@@ -3900,9 +3913,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends FBaseInitialable {
 	* ```
 	*/
 	insertDefinedName(name, formulaOrRefString) {
-		const param = this._injector.createInstance(FDefinedNameBuilder).setName(name).setRef(formulaOrRefString).build();
-		param.localSheetId = this.getSheetId();
-		this._fWorkbook.insertDefinedNameBuilder(param);
+		const definedNameParam = this._injector.createInstance(FDefinedNameBuilder, this._fWorkbook.getId()).setName(name).setRef(formulaOrRefString).setScopeToWorksheet(this).build();
+		this._fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	}
 	/**
 	* Get all the defined names in the worksheet.
@@ -7509,10 +7521,6 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	* const definedName = fWorkbook.getDefinedName('MyDefinedName');
 	* console.log(definedName?.getFormulaOrRefString());
-	*
-	* if (definedName) {
-	*   definedName.setName('NewDefinedName');
-	* }
 	* ```
 	*/
 	getDefinedName(name) {
@@ -7545,41 +7553,22 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 		});
 	}
 	/**
-	* Insert a defined name.
-	* @param {string} name The name of the defined name to insert
-	* @param {string} formulaOrRefString The formula(=sum(A2:b10)) or reference(A1) string of the defined name to insert
-	* @returns {FWorkbook} The current FWorkbook instance
+	* Create a new defined name builder.
+	* @returns {FDefinedNameBuilder} - The defined name builder.
 	* @example
 	* ```ts
-	* // The code below inserts a defined name
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* fWorkbook.insertDefinedName('MyDefinedName', 'Sheet1!$A$1');
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
+	*   .setRef('Sheet1!$A$1')
+	*   .setName('MyDefinedName')
+	*   .setComment('This is a comment');
+	*   .build();
+	* console.log(definedNameParam);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
-	insertDefinedName(name, formulaOrRefString) {
-		const param = this._injector.createInstance(FDefinedNameBuilder).setName(name).setRef(formulaOrRefString).build();
-		param.localSheetId = SCOPE_WORKBOOK_VALUE_DEFINED_NAME;
-		this.insertDefinedNameBuilder(param);
-		return this;
-	}
-	/**
-	* Delete the defined name with the given name.
-	* @param {string} name The name of the defined name to delete
-	* @returns {boolean} true if the defined name was deleted, false otherwise
-	* @example
-	* ```ts
-	* // The code below deletes the defined name with the given name
-	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* fWorkbook.deleteDefinedName('MyDefinedName');
-	* ```
-	*/
-	deleteDefinedName(name) {
-		const definedName = this.getDefinedName(name);
-		if (definedName) {
-			definedName.delete();
-			return true;
-		}
-		return false;
+	newDefinedNameBuilder() {
+		return this._injector.createInstance(FDefinedNameBuilder, this.id);
 	}
 	/**
 	* Insert a defined name by builder param.
@@ -7589,16 +7578,15 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 	* ```ts
 	* // The code below inserts a defined name by builder param
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const definedNameBuilder = univerAPI.newDefinedName()
+	* const definedNameParam = fWorkbook.newDefinedNameBuilder()
 	*   .setRef('Sheet1!$A$1')
 	*   .setName('MyDefinedName')
 	*   .setComment('This is a comment')
 	*   .build();
-	* fWorkbook.insertDefinedNameBuilder(definedNameBuilder);
+	* fWorkbook.insertDefinedNameBuilder(definedNameParam);
 	* ```
 	*/
 	insertDefinedNameBuilder(param) {
-		param.unitId = this.getId();
 		this._commandService.syncExecuteCommand(SetDefinedNameCommand.id, param);
 	}
 	/**
@@ -7626,6 +7614,42 @@ let FWorkbook = class FWorkbook extends FBaseInitialable {
 		this._commandService.syncExecuteCommand(SetDefinedNameCommand.id, param);
 	}
 	/**
+	* Insert a defined name.
+	* @param {string} name The name of the defined name to insert
+	* @param {string} formulaOrRefString The formula(=sum(A2:b10)) or reference(A1) string of the defined name to insert
+	* @returns {FWorkbook} The current FWorkbook instance
+	* @example
+	* ```ts
+	* // The code below inserts a defined name
+	* const fWorkbook = univerAPI.getActiveWorkbook();
+	* fWorkbook.insertDefinedName('MyDefinedName', 'Sheet1!$A$1');
+	* ```
+	*/
+	insertDefinedName(name, formulaOrRefString) {
+		const definedNameParam = this.newDefinedNameBuilder().setName(name).setRef(formulaOrRefString).setScopeToWorkbook().build();
+		this.insertDefinedNameBuilder(definedNameParam);
+		return this;
+	}
+	/**
+	* Delete the defined name with the given name.
+	* @param {string} name The name of the defined name to delete
+	* @returns {boolean} true if the defined name was deleted, false otherwise
+	* @example
+	* ```ts
+	* // The code below deletes the defined name with the given name
+	* const fWorkbook = univerAPI.getActiveWorkbook();
+	* fWorkbook.deleteDefinedName('MyDefinedName');
+	* ```
+	*/
+	deleteDefinedName(name) {
+		const definedName = this.getDefinedName(name);
+		if (definedName) {
+			definedName.delete();
+			return true;
+		}
+		return false;
+	}
+	/**
 	* Gets the registered range themes.
 	* @returns {string[]} The name list of registered range themes.
 	* @example
@@ -7853,7 +7877,8 @@ var FUniverSheetsMixin = class extends FUniver {
 				this.fireEvent(this.Event.WorkbookDisposed, eventParams);
 			}
 		})));
-		this.disposeWithMe(this.registerEventHandler(this.Event.WorkbookCreated, () => univerInstanceService.unitAdded$.subscribe((unit) => {
+		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);
@@ -8154,13 +8179,10 @@ var FUniverSheetsMixin = class extends FUniver {
 		return this.getUniverSheet(id);
 	}
 	onUniverSheetCreated(callback) {
-		return toDisposable(this._univerInstanceService.getTypeOfUnitAdded$(UniverInstanceType.UNIVER_SHEET).subscribe((workbook) => {
-			callback(this._injector.createInstance(FWorkbook, workbook));
+		return toDisposable(this._univerInstanceService.getTypeOfUnitAdded$(UniverInstanceType.UNIVER_SHEET).subscribe((event) => {
+			callback(this._injector.createInstance(FWorkbook, event.unit));
 		}));
 	}
-	newDefinedName() {
-		return this._injector.createInstance(FDefinedNameBuilder);
-	}
 	getActiveSheet() {
 		const workbook = this.getActiveWorkbook();
 		if (!workbook) return null;