@univerjs/sheets 0.5.5 → 0.6.0-alpha.0

package/lib/es/facade.js

@@ -1,27 +1,27 @@
 var Ge = Object.defineProperty;
 var qe = (r, e, t) => e in r ? Ge(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
 var b = (r, e, t) => qe(r, typeof e != "symbol" ? e + "" : e, t);
-import { Inject as u, Injector as y, IAuthzIoService as Ne, LocaleService as Te, ICommandService as l, IPermissionService as ae, generateRandomId as Me, FBase as de, Rectangle as M, HorizontalAlign as U, VerticalAlign as P, isFormulaString as Ke, isCellV as Ye, isICellData as Je, ObjectMatrix as W, Tools as Qe, RANGE_TYPE as _, FBaseInitialable as ce, TextStyleValue as le, RichTextValue as E, BooleanNumber as g, WrapStrategy as Y, Dimension as me, ILogService as De, Direction as D, IResourceLoaderService as Xe, mergeWorksheetSnapshotWithDefault as Ze, UndoCommand as et, RedoCommand as tt, toDisposable as Ae, UniverInstanceType as p, IUniverInstanceService as J, FUniver as Be, CanceledError as nt, FEnum as rt, FEventName as We } from "@univerjs/core";
-import { WorksheetProtectionRuleModel as Fe, RangeProtectionRuleModel as je, WorksheetProtectionPointModel as Oe, SetDefinedNameCommand as Q, SCOPE_WORKBOOK_VALUE_DEFINED_NAME as X, RemoveDefinedNameCommand as st, PermissionPointsDefinitions as it, WorkbookEditablePermission as Le, UnitObject as x, AddWorksheetProtectionMutation as ot, DeleteWorksheetProtectionMutation as ht, getAllWorksheetPermissionPoint as at, getAllWorksheetPermissionPointByPointPanel as _e, SetWorksheetPermissionPointsMutation as dt, AddRangeProtectionMutation as ct, DeleteRangeProtectionMutation as ut, SetRangeProtectionMutation as gt, WorksheetEditPermission as lt, WorksheetViewPermission as mt, SetBorderBasicCommand as _t, SetStyleCommand as I, SetRangeValuesCommand as N, SetTextWrapCommand as Z, SetVerticalTextAlignCommand as kt, SetHorizontalTextAlignCommand as St, addMergeCellsUtil as H, getAddMergeMutationRangeByType as ke, RemoveWorksheetMergeCommand as wt, SplitTextToColumnsCommand as Ct, SetWorksheetRangeThemeStyleCommand as ft, DeleteWorksheetRangeThemeStyleCommand as vt, SheetRangeThemeService as Ve, getPrimaryForRange as ee, SetSelectionsOperation as He, getNextPrimaryCell as It, SheetsSelectionsService as ze, SetWorksheetDefaultStyleMutation as bt, SetColDataCommand as Se, SetRowDataCommand as we, copyRangeStyles as A, InsertRowByRangeCommand as Ce, RemoveRowByRangeCommand as Rt, MoveRowsCommand as pt, SetRowHiddenCommand as fe, SetSpecificRowsVisibleCommand as ve, SetWorksheetRowIsAutoHeightMutation as yt, SetRowHeightCommand as Ie, SetWorksheetRowIsAutoHeightCommand as be, InsertColByRangeCommand as Re, RemoveColByRangeCommand as Et, MoveColsCommand as Ut, SetColHiddenCommand as pe, SetSpecificColsVisibleCommand as ye, SetColWidthCommand as Pt, SetFrozenCommand as z, CancelFrozenCommand as xt, ToggleGridlinesCommand as te, SetGridlinesColorCommand as ne, SetTabColorCommand as re, SetRangeValuesMutation as Ee, SetWorksheetHideCommand as se, SetWorksheetShowCommand as Nt, SetWorksheetNameCommand as ie, ClearSelectionAllCommand as Tt, ClearSelectionContentCommand as Mt, ClearSelectionFormatCommand as Dt, InsertSheetCommand as T, SetWorksheetActiveOperation as $, RemoveSheetCommand as oe, CopySheetCommand as At, SetWorksheetOrderCommand as he, RegisterWorksheetRangeThemeStyleCommand as Bt, UnregisterWorksheetRangeThemeStyleCommand as Wt, SetWorksheetActivateCommand as Ue, COMMAND_LISTENER_VALUE_CHANGE as Ft, getValueChangedEffectedRange as jt, SheetValueChangeType as Ot, SheetSkeletonChangeType as Lt } from "@univerjs/sheets";
-import { IDefinedNamesService as $e, serializeRange as ue, FormulaDataModel as Vt, serializeRangeWithSheet as Ht, deserializeRangeWithSheet as zt } from "@univerjs/engine-formula";
-var $t = Object.defineProperty, Gt = Object.getOwnPropertyDescriptor, qt = (r, e, t, n) => {
-  for (var s = n > 1 ? void 0 : n ? Gt(e, t) : e, i = r.length - 1, o; i >= 0; i--)
+import { Inject as u, Injector as y, IAuthzIoService as Ne, LocaleService as Te, ICommandService as m, IPermissionService as he, generateRandomId as Me, FBase as de, Rectangle as M, HorizontalAlign as U, VerticalAlign as P, isFormulaString as Ke, isCellV as Ye, isICellData as Je, ObjectMatrix as W, Tools as Qe, RANGE_TYPE as _, FBaseInitialable as ce, TextStyleValue as me, RichTextValue as E, BooleanNumber as g, WrapStrategy as Y, Dimension as le, ILogService as De, Direction as D, IResourceLoaderService as Xe, mergeWorksheetSnapshotWithDefault as Ze, UndoCommand as et, RedoCommand as tt, toDisposable as Ae, UniverInstanceType as p, IUniverInstanceService as J, FUniver as Be, CanceledError as nt, FEnum as rt, FEventName as We } from "@univerjs/core";
+import { WorksheetProtectionRuleModel as Fe, RangeProtectionRuleModel as je, WorksheetProtectionPointModel as Oe, SetDefinedNameCommand as Q, SCOPE_WORKBOOK_VALUE_DEFINED_NAME as X, RemoveDefinedNameCommand as st, PermissionPointsDefinitions as it, WorkbookEditablePermission as Le, UnitObject as x, AddWorksheetProtectionMutation as ot, DeleteWorksheetProtectionMutation as at, getAllWorksheetPermissionPoint as ht, getAllWorksheetPermissionPointByPointPanel as _e, SetWorksheetPermissionPointsMutation as dt, AddRangeProtectionMutation as ct, DeleteRangeProtectionMutation as ut, SetRangeProtectionMutation as gt, WorksheetEditPermission as mt, WorksheetViewPermission as lt, SetBorderBasicCommand as _t, SetStyleCommand as I, SetRangeValuesCommand as N, SetTextWrapCommand as Z, SetVerticalTextAlignCommand as St, SetHorizontalTextAlignCommand as kt, addMergeCellsUtil as H, getAddMergeMutationRangeByType as Se, RemoveWorksheetMergeCommand as wt, SplitTextToColumnsCommand as Ct, SetWorksheetRangeThemeStyleCommand as ft, DeleteWorksheetRangeThemeStyleCommand as vt, SheetRangeThemeService as Ve, getPrimaryForRange as ee, SetSelectionsOperation as He, getNextPrimaryCell as It, SheetsSelectionsService as ze, SetWorksheetDefaultStyleMutation as bt, SetColDataCommand as ke, SetRowDataCommand as we, copyRangeStyles as A, InsertRowByRangeCommand as Ce, RemoveRowByRangeCommand as Rt, MoveRowsCommand as pt, SetRowHiddenCommand as fe, SetSpecificRowsVisibleCommand as ve, SetWorksheetRowIsAutoHeightMutation as yt, SetRowHeightCommand as Ie, SetWorksheetRowIsAutoHeightCommand as be, InsertColByRangeCommand as Re, RemoveColByRangeCommand as Et, MoveColsCommand as Ut, SetColHiddenCommand as pe, SetSpecificColsVisibleCommand as ye, SetColWidthCommand as Pt, SetFrozenCommand as z, CancelFrozenCommand as xt, ToggleGridlinesCommand as te, SetGridlinesColorCommand as ne, SetTabColorCommand as re, SetRangeValuesMutation as Ee, SetWorksheetHideCommand as se, SetWorksheetShowCommand as Nt, SetWorksheetNameCommand as ie, ClearSelectionAllCommand as Tt, ClearSelectionContentCommand as Mt, ClearSelectionFormatCommand as Dt, InsertSheetCommand as T, SetWorksheetActiveOperation as $, RemoveSheetCommand as oe, CopySheetCommand as At, SetWorksheetOrderCommand as ae, RegisterWorksheetRangeThemeStyleCommand as Bt, UnregisterWorksheetRangeThemeStyleCommand as Wt, RangeThemeStyle as Ft, SetWorksheetActivateCommand as Ue, COMMAND_LISTENER_VALUE_CHANGE as jt, getValueChangedEffectedRange as Ot, SheetValueChangeType as Lt, SheetSkeletonChangeType as Vt } from "@univerjs/sheets";
+import { IDefinedNamesService as $e, serializeRange as ue, FormulaDataModel as Ht, serializeRangeWithSheet as zt, deserializeRangeWithSheet as $t } from "@univerjs/engine-formula";
+var Gt = Object.defineProperty, qt = Object.getOwnPropertyDescriptor, Kt = (r, e, t, n) => {
+  for (var s = n > 1 ? void 0 : n ? qt(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
-  return n && s && $t(e, t, s), s;
+  return n && s && Gt(e, t, s), s;
 }, w = (r, e) => (t, n) => e(t, n, r);
-function Kt(r, e, t) {
+function Yt(r, e, t) {
   const n = t.getDefinedNameMap(r);
   if (n == null)
     return e.t("definedName.defaultName") + 1;
   const i = Array.from(Object.values(n)).length + 1, o = e.t("definedName.defaultName") + i;
   if (t.getValueByName(r, o) == null)
     return o;
-  let h = i + 1;
+  let a = i + 1;
   for (; ; ) {
-    const a = e.t("definedName.defaultName") + h;
-    if (t.getValueByName(r, a) == null)
-      return a;
-    h++;
+    const h = e.t("definedName.defaultName") + a;
+    if (t.getValueByName(r, h) == null)
+      return h;
+    a++;
   }
 }
 class V {
@@ -42,8 +42,8 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *    .setName('MyDefinedName')
-   *  .build();
+   *   .setName('MyDefinedName')
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -58,9 +58,9 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *  .setFormula('SUM(Sheet1!$A$1)')
-   * .setName('MyDefinedName')
-   * .build();
+   *   .setFormula('SUM(Sheet1!$A$1)')
+   *   .setName('MyDefinedName')
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -75,8 +75,8 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *  .setRef('Sheet1!$A$1')
-   * .build();
+   *   .setRef('Sheet1!$A$1')
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -94,8 +94,8 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *  .setRefByRange(1, 3, 2, 5)
-   * .build();
+   *   .setRefByRange(1, 3, 2, 5)
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -115,8 +115,8 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *  .setComment('This is a comment')
-   * .build();
+   *   .setComment('This is a comment')
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -131,8 +131,8 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *  .setHidden(true)
-   * .build();
+   *   .setHidden(true)
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -146,9 +146,9 @@ class V {
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
    * const definedNameBuilder = univerAPI.newDefinedName()
-   *  .setRef('Sheet1!$A$1')
-   *  .setName('MyDefinedName')
-   *  .build();
+   *   .setRef('Sheet1!$A$1')
+   *   .setName('MyDefinedName')
+   *   .build();
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
@@ -160,11 +160,11 @@ class V {
   }
 }
 let F = class extends de {
-  constructor(r, e, t, n, s, i, o, h, a, d) {
-    super(), this._definedNameParam = r, this._injector = e, this._commandService = t, this._permissionService = n, this._worksheetProtectionRuleModel = s, this._rangeProtectionRuleModel = i, this._worksheetProtectionPointRuleModel = o, this._authzIoService = h, this._localeService = a, this._definedNamesService = d;
+  constructor(r, e, t, n, s, i, o, a, h, d) {
+    super(), this._definedNameParam = r, this._injector = e, this._commandService = t, this._permissionService = n, this._worksheetProtectionRuleModel = s, this._rangeProtectionRuleModel = i, this._worksheetProtectionPointRuleModel = o, this._authzIoService = a, this._localeService = h, this._definedNamesService = d;
   }
   _apply() {
-    this._definedNameParam.name === "" && (this._definedNameParam.name = Kt(this._definedNameParam.unitId, this._localeService, this._definedNamesService)), this._commandService.syncExecuteCommand(Q.id, this._definedNameParam);
+    this._definedNameParam.name === "" && (this._definedNameParam.name = Yt(this._definedNameParam.unitId, this._localeService, this._definedNamesService)), this._commandService.syncExecuteCommand(Q.id, this._definedNameParam);
   }
   /**
    * Gets the name of the defined name.
@@ -372,10 +372,10 @@ let F = class extends de {
     return r.load(this._definedNameParam), r;
   }
 };
-F = qt([
+F = Kt([
   w(1, u(y)),
-  w(2, l),
-  w(3, ae),
+  w(2, m),
+  w(3, he),
   w(4, u(Fe)),
   w(5, u(je)),
   w(6, u(Oe)),
@@ -383,27 +383,43 @@ F = qt([
   w(8, u(Te)),
   w(9, $e)
 ], F);
-var Yt = Object.defineProperty, Jt = Object.getOwnPropertyDescriptor, Qt = (r, e, t, n) => {
-  for (var s = n > 1 ? void 0 : n ? Jt(e, t) : e, i = r.length - 1, o; i >= 0; i--)
+var Jt = Object.defineProperty, Qt = Object.getOwnPropertyDescriptor, Xt = (r, e, t, n) => {
+  for (var s = n > 1 ? void 0 : n ? Qt(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
-  return n && s && Yt(e, t, s), s;
+  return n && s && Jt(e, t, s), s;
 }, R = (r, e) => (t, n) => e(t, n, r);
 let j = class extends de {
-  constructor(e, t, n, s, i, o, h) {
+  constructor(e, t, n, s, i, o, a) {
     super();
+    /**
+     * Permission point definition, can read the point constructor want to modify from here
+     */
     b(this, "permissionPointsDefinition", it);
+    /**
+     * An observable object used to monitor permission change events within a range, thereby triggering corresponding subsequent processing.
+     */
     b(this, "rangeRuleChangedAfterAuth$");
+    /**
+     * An observable object used to monitor permission change events within a worksheet, thereby triggering corresponding subsequent processing.
+     */
     b(this, "sheetRuleChangedAfterAuth$");
-    this._injector = e, this._commandService = t, this._permissionService = n, this._worksheetProtectionRuleModel = s, this._rangeProtectionRuleModel = i, this._worksheetProtectionPointRuleModel = o, this._authzIoService = h, this.rangeRuleChangedAfterAuth$ = this._rangeProtectionRuleModel.ruleRefresh$, this.sheetRuleChangedAfterAuth$ = this._worksheetProtectionRuleModel.ruleRefresh$;
+    this._injector = e, this._commandService = t, this._permissionService = n, this._worksheetProtectionRuleModel = s, this._rangeProtectionRuleModel = i, this._worksheetProtectionPointRuleModel = o, this._authzIoService = a, this.rangeRuleChangedAfterAuth$ = this._rangeProtectionRuleModel.ruleRefresh$, this.sheetRuleChangedAfterAuth$ = this._worksheetProtectionRuleModel.ruleRefresh$;
   }
   /**
    * Configures a specific permission point for a workbook.
-   *
    * This function sets or updates a permission point for a workbook identified by `unitId`.
    * It creates a new permission point if it does not already exist, and updates the point with the provided value.
    * @param {string} unitId - The unique identifier of the workbook for which the permission is being set.
    * @param {WorkbookPermissionPointConstructor} FPointClass - The constructor function for creating a permission point instance. Other point constructors can See the [permission-point documentation](https://github.com/dream-num/univer/tree/dev/packages/sheets/src/services/permission/permission-point) for more details.
    * @param {boolean} value - The boolean value to determine whether the permission point is enabled or disabled.
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * permission.setWorkbookPermissionPoint(unitId, permission.permissionPointsDefinition.WorkbookEditablePermission, false)
+   * ```
    */
   setWorkbookPermissionPoint(e, t, n) {
     const s = new t(e);
@@ -413,15 +429,39 @@ let j = class extends de {
    * This function is used to set whether the workbook can be edited
    * @param {string} unitId - The unique identifier of the workbook for which the permission is being set.
    * @param {boolean} value - A value that controls whether the workbook can be edited
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * permission.setWorkbookEditPermission(unitId, false);
+   * ```
    */
   setWorkbookEditPermission(e, t) {
     this.setWorkbookPermissionPoint(e, Le, t);
   }
   /**
    * This function is used to add a base permission for a worksheet.
+   * Note that after adding, only the background mask of the permission module will be rendered. If you want to modify the function permissions,
+   * you need to modify the permission points with the permissionId returned by this function.
    * @param {string} unitId - The unique identifier of the workbook for which the permission is being set.
    * @param {string} subUnitId - The unique identifier of the worksheet for which the permission is being set.
    * @returns {Promise<string | undefined>} - Returns the `permissionId` if the permission is successfully added. If the operation fails or no result is returned, it resolves to `undefined`.
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * // Note that there will be no permission changes after this step is completed. It only returns an ID for subsequent permission changes.
+   * // For details, please see the example of the **`setWorksheetPermissionPoint`** API.
+   * const permissionId = await permission.addWorksheetBasePermission(unitId, subUnitId)
+   * // Can still edit and read it.
+   * console.log('debugger', permissionId)
+   * ```
    */
   async addWorksheetBasePermission(e, t) {
     if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).length > 0)
@@ -452,12 +492,22 @@ let j = class extends de {
    * Delete the entire table protection set for the worksheet and reset the point permissions of the worksheet to true
    * @param {string} unitId - The unique identifier of the workbook for which the permission is being set.
    * @param {string} subUnitId - The unique identifier of the worksheet for which the permission is being set.
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * permission.removeWorksheetPermission(unitId, subUnitId);
+   * ```
    */
   removeWorksheetPermission(e, t) {
-    this._commandService.syncExecuteCommand(ht.id, {
+    this._commandService.syncExecuteCommand(at.id, {
       unitId: e,
       subUnitId: t
-    }), [...at(), ..._e()].forEach((n) => {
+    }), [...ht(), ..._e()].forEach((n) => {
       const s = new n(e, t);
       this._permissionService.updatePermissionPoint(s.id, !0);
     }), this._worksheetProtectionPointRuleModel.deleteRule(e, t);
@@ -471,11 +521,22 @@ let j = class extends de {
    *    See the [permission-point documentation](https://github.com/dream-num/univer/tree/dev/packages/sheets/src/services/permission/permission-point) for more details.
    * @param {boolean} value - The new permission value to be set for the worksheet.
    * @returns {Promise<string | undefined>} - Returns the `permissionId` if the permission point is successfully set or created. If no permission is set, it resolves to `undefined`.
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * const permissionId = await permission.addWorksheetBasePermission(unitId, subUnitId)
+   * // After this line of code , the worksheet will no longer be editable
+   * permission.setWorksheetPermissionPoint(unitId, subUnitId, permission.permissionPointsDefinition.WorksheetEditPermission, false);
    */
   async setWorksheetPermissionPoint(e, t, n, s) {
     const i = this._worksheetProtectionRuleModel.getRule(e, t);
     let o;
-    if (n === lt || n === mt)
+    if (n === mt || n === lt)
       if (i)
         o = i.permissionId;
       else {
@@ -494,17 +555,36 @@ let j = class extends de {
           name: "",
           scope: void 0
         }
-      }), this._commandService.syncExecuteCommand(dt.id, { unitId: e, subUnitId: t, permissionId: o }));
+      }), this._commandService.syncExecuteCommand(dt.id, { unitId: e, subUnitId: t, rule: { unitId: e, subUnitId: t, permissionId: o } }));
     }
-    const a = new n(e, t);
-    return this._permissionService.getPermissionPoint(a.id) || this._permissionService.addPermissionPoint(a), this._permissionService.updatePermissionPoint(a.id, s), o;
+    const h = new n(e, t);
+    return this._permissionService.getPermissionPoint(h.id) || this._permissionService.addPermissionPoint(h), this._permissionService.updatePermissionPoint(h.id, s), o;
   }
   /**
    * Adds a range protection to the worksheet.
+   * Note that after adding, only the background mask of the permission module will be rendered. If you want to modify the function permissions,
+   * you need to modify the permission points with the permissionId returned by this function.
    * @param {string} unitId - The unique identifier of the workbook.
    * @param {string} subUnitId - The unique identifier of the worksheet.
-   * @param {IRange[]} ranges - The ranges to be protected.
+   * @param {FRange[]} ranges - The ranges to be protected.
    * @returns {Promise<{ permissionId: string, ruleId: string } | undefined>} - Returns an object containing the `permissionId` and `ruleId` if the range protection is successfully added. If the operation fails or no result is returned, it resolves to `undefined`. permissionId is used to stitch permission point ID，ruleId is used to store permission rules
+   *
+   * @example
+   * ```typescript
+   *const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * const range = worksheet.getRange(0,0,2,2);
+   * const ranges = [];
+   * ranges.push(range);
+   * // Note that there will be no permission changes after this step is completed. It only returns an ID for subsequent permission changes.
+   * // For details, please see the example of the **`setRangeProtectionPermissionPoint`** API.
+   * const res = await permission.addRangeBaseProtection(unitId, subUnitId, ranges);
+   * const {permissionId, ruleId} = res;
+   * console.log('debugger', permissionId, ruleId);
+   * ```
    */
   async addRangeBaseProtection(e, t, n) {
     const s = await this._authzIoService.create({
@@ -518,7 +598,7 @@ let j = class extends de {
     }), i = `ruleId_${Me(6)}`;
     if (this._worksheetProtectionRuleModel.getRule(e, t))
       throw new Error("sheet protection cannot intersect with range protection");
-    if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).some((c) => c.ranges.some((v) => n.some((k) => M.intersects(k, v)))))
+    if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).some((c) => c.ranges.some((v) => n.some((S) => M.intersects(S.getRange(), v)))))
       throw new Error("range protection cannot intersect");
     if (this._commandService.syncExecuteCommand(ct.id, {
       unitId: e,
@@ -528,7 +608,7 @@ let j = class extends de {
         unitType: x.SelectRange,
         unitId: e,
         subUnitId: t,
-        ranges: n,
+        ranges: n.map((c) => c.getRange()),
         id: i
       }]
     }))
@@ -542,6 +622,21 @@ let j = class extends de {
    * @param {string} unitId - The unique identifier of the workbook.
    * @param {string} subUnitId - The unique identifier of the worksheet.
    * @param {string[]} ruleIds - The rule IDs of the range protection to be removed.
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * const range = worksheet.getRange(0,0,2,2);
+   * const ranges = [];
+   * ranges.push(range);
+   * const res = await permission.addRangeBaseProtection(unitId, subUnitId, ranges);
+   * const ruleId = res.ruleId;
+   * permission.removeRangeProtection(unitId, subUnitId, [ruleId]);
+   * ```
    */
   removeRangeProtection(e, t, n) {
     this._commandService.syncExecuteCommand(ut.id, {
@@ -549,8 +644,8 @@ let j = class extends de {
       subUnitId: t,
       ruleIds: n
     }) && this._rangeProtectionRuleModel.getSubunitRuleList(e, t).length === 0 && (this._worksheetProtectionPointRuleModel.deleteRule(e, t), [..._e()].forEach((o) => {
-      const h = new o(e, t);
-      this._permissionService.updatePermissionPoint(h.id, h.value);
+      const a = new o(e, t);
+      this._permissionService.updatePermissionPoint(a.id, a.value);
     }));
   }
   /**
@@ -561,6 +656,24 @@ let j = class extends de {
    * @param {RangePermissionPointConstructor} FPointClass - The constructor for the range permission point class.
    *    See the [permission-point documentation](https://github.com/dream-num/univer/tree/dev/packages/sheets/src/services/permission/permission-point) for more details.
    * @param {boolean} value - The new permission value to be set for the range (e.g., true for allowing access, false for restricting access).
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * const range = worksheet.getRange(0, 0, 2, 2);
+   * const ranges = [];
+   * ranges.push(range);
+   * // Note that there will be no permission changes after this step is completed. It only returns an ID for subsequent permission changes.
+   * // For details, please see the example of the **`setRangeProtectionPermissionPoint`** API.
+   * const res = await permission.addRangeBaseProtection(unitId, subUnitId, ranges);
+   * const {permissionId, ruleId} = res;
+   * // After passing the following line of code, the range set above will become uneditable
+   * permission.setRangeProtectionPermissionPoint(unitId,subUnitId,permissionId, permission.permissionPointsDefinition.RangeProtectionPermissionEditPoint, false);
+   * ```
    */
   setRangeProtectionPermissionPoint(e, t, n, s, i) {
     const o = new s(e, t, n);
@@ -576,11 +689,27 @@ let j = class extends de {
    * @param {string} subUnitId - The unique identifier of the worksheet within the workbook.
    * @param {string} ruleId - The ruleId of the range protection rule that is being updated.
    * @param {IRange[]} ranges - The array of new ranges to be set for the range protection rule.
+   *
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook();
+   * const permission = workbook.getPermission();
+   * const unitId = workbook.getId();
+   * const worksheet = workbook.getActiveSheet();
+   * const subUnitId = worksheet.getSheetId();
+   * const range = worksheet.getRange(0, 0, 2, 2);
+   * const ranges = [];
+   * ranges.push(range);
+   * const res = await permission.addRangeBaseProtection(unitId, subUnitId, ranges);
+   * const {permissionId, ruleId} = res;
+   * const newRange = worksheet.getRange(3, 3, 2, 2);
+   * permission.setRangeProtectionRanges(unitId, subUnitId, ruleId, [newRange]);
+   * ```
    */
   setRangeProtectionRanges(e, t, n, s) {
     const i = this._rangeProtectionRuleModel.getRule(e, t, n);
     if (i) {
-      if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).filter((a) => a.id !== n).some((a) => a.ranges.some((d) => s.some((c) => M.intersects(c, d)))))
+      if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).filter((h) => h.id !== n).some((h) => h.ranges.some((d) => s.some((c) => M.intersects(c.getRange(), d)))))
         throw new Error("range protection cannot intersect");
       this._commandService.syncExecuteCommand(gt.id, {
         unitId: e,
@@ -588,22 +717,22 @@ let j = class extends de {
         ruleId: n,
         rule: {
           ...i,
-          ranges: s
+          ranges: s.map((h) => h.getRange())
         }
       });
     }
   }
 };
-j = Qt([
+j = Xt([
   R(0, u(y)),
-  R(1, l),
-  R(2, ae),
+  R(1, m),
+  R(2, he),
   R(3, u(Fe)),
   R(4, u(je)),
   R(5, u(Oe)),
   R(6, u(Ne))
 ], j);
-function Xt(r) {
+function Zt(r) {
   switch (r) {
     case "left":
       return U.LEFT;
@@ -615,7 +744,7 @@ function Xt(r) {
       throw new Error(`Invalid horizontal alignment: ${r}`);
   }
 }
-function Zt(r) {
+function en(r) {
   switch (r) {
     case U.LEFT:
       return "left";
@@ -627,7 +756,7 @@ function Zt(r) {
       throw new Error(`Invalid horizontal alignment: ${r}`);
   }
 }
-function en(r) {
+function tn(r) {
   switch (r) {
     case "top":
       return P.TOP;
@@ -639,7 +768,7 @@ function en(r) {
       throw new Error(`Invalid vertical alignment: ${r}`);
   }
 }
-function tn(r) {
+function nn(r) {
   switch (r) {
     case P.TOP:
       return "top";
@@ -665,12 +794,12 @@ function O(r) {
 function Pe(r, e) {
   const t = new W(), { startRow: n, startColumn: s, endRow: i, endColumn: o } = e;
   if (Qe.isArray(r))
-    for (let h = 0; h <= i - n; h++)
-      for (let a = 0; a <= o - s; a++)
-        t.setValue(h + n, a + s, O(r[h][a]));
+    for (let a = 0; a <= i - n; a++)
+      for (let h = 0; h <= o - s; h++)
+        t.setValue(a + n, h + s, O(r[a][h]));
   else
-    new W(r).forValue((a, d, c) => {
-      t.setValue(a, d, O(c));
+    new W(r).forValue((h, d, c) => {
+      t.setValue(h, d, O(c));
     });
   return t.getMatrix();
 }
@@ -692,12 +821,12 @@ function q(r, e) {
     rangeType: _.COLUMN
   };
 }
-var nn = Object.defineProperty, rn = Object.getOwnPropertyDescriptor, sn = (r, e, t, n) => {
-  for (var s = n > 1 ? void 0 : n ? rn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
+var rn = Object.defineProperty, sn = Object.getOwnPropertyDescriptor, on = (r, e, t, n) => {
+  for (var s = n > 1 ? void 0 : n ? sn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
-  return n && s && nn(e, t, s), s;
+  return n && s && rn(e, t, s), s;
 }, K = (r, e) => (t, n) => e(t, n, r);
-let S = class extends ce {
+let k = class extends ce {
   constructor(r, e, t, n, s, i) {
     super(n), this._workbook = r, this._worksheet = e, this._range = t, this._injector = n, this._commandService = s, this._formulaDataModel = i;
   }
@@ -707,9 +836,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getUnitId()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getUnitId()
    * ```
    */
   getUnitId() {
@@ -721,9 +850,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getSheetName()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getSheetName()
    * ```
    */
   getSheetName() {
@@ -735,9 +864,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getSheetId()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getSheetId()
    * ```
    */
   getSheetId() {
@@ -749,9 +878,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getRange()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getRange()
    * ```
    */
   getRange() {
@@ -763,9 +892,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getRow()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getRow()
    * ```
    */
   getRow() {
@@ -777,9 +906,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getColumn()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getColumn()
    * ```
    */
   getColumn() {
@@ -791,9 +920,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getWidth()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getWidth()
    * ```
    */
   getWidth() {
@@ -805,9 +934,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getHeight()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getHeight()
    * ```
    */
   getHeight() {
@@ -819,9 +948,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .isMerged()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .isMerged()
    * ```
    */
   isMerged() {
@@ -834,9 +963,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCellStyleData()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCellStyleData()
    * ```
    */
   getCellStyleData() {
@@ -850,14 +979,14 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCellStyle()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCellStyle()
    * ```
    */
   getCellStyle() {
     const r = this.getCellStyleData();
-    return r ? le.create(r) : null;
+    return r ? me.create(r) : null;
   }
   /**
    * Returns the cell styles for the cells in the range.
@@ -865,9 +994,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCellStyles()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCellStyles()
    * ```
    */
   getCellStyles() {
@@ -875,7 +1004,7 @@ let S = class extends ce {
     return r.map((t) => t.map((n) => {
       if (!n) return null;
       const s = e.getStyleByCell(n);
-      return s ? le.create(s) : null;
+      return s ? me.create(s) : null;
     }));
   }
   getValue(r) {
@@ -883,13 +1012,13 @@ let S = class extends ce {
     return r ? this.getValueAndRichTextValue() : (t = (e = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) == null ? void 0 : e.v) != null ? t : null;
   }
   getValues(r) {
-    var o, h;
+    var o, a;
     r && this.getValueAndRichTextValues();
     const { startRow: e, endRow: t, startColumn: n, endColumn: s } = this._range, i = [];
-    for (let a = e; a <= t; a++) {
+    for (let h = e; h <= t; h++) {
       const d = [];
       for (let c = n; c <= s; c++)
-        d.push((h = (o = this._worksheet.getCell(a, c)) == null ? void 0 : o.v) != null ? h : null);
+        d.push((a = (o = this._worksheet.getCell(h, c)) == null ? void 0 : o.v) != null ? a : null);
       i.push(d);
     }
     return i;
@@ -900,9 +1029,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCellData()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCellData()
    * ```
    */
   getCellData() {
@@ -915,9 +1044,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCellDatas()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCellDatas()
    * ```
    */
   getCellDatas() {
@@ -929,17 +1058,17 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCellDataGrid()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCellDataGrid()
    * ```
    */
   getCellDataGrid() {
     const { startRow: r, endRow: e, startColumn: t, endColumn: n } = this._range, s = [];
     for (let i = r; i <= e; i++) {
       const o = [];
-      for (let h = t; h <= n; h++)
-        o.push(this._worksheet.getCellRaw(i, h));
+      for (let a = t; a <= n; a++)
+        o.push(this._worksheet.getCellRaw(i, a));
       s.push(o);
     }
     return s;
@@ -952,9 +1081,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getRichTextValue()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getRichTextValue()
    * ```
    */
   getRichTextValue() {
@@ -969,9 +1098,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getRichTextValues()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getRichTextValues()
    * ```
    */
   getRichTextValues() {
@@ -985,9 +1114,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getValueAndRichTextValue()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getValueAndRichTextValue()
    * ```
    */
   getValueAndRichTextValue() {
@@ -1000,9 +1129,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getValueAndRichTextValues()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getValueAndRichTextValues()
    * ```
    */
   getValueAndRichTextValues() {
@@ -1014,20 +1143,20 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getFormulas()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getFormulas()
    * ```
    */
   getFormulas() {
     const r = [], { startRow: e, endRow: t, startColumn: n, endColumn: s } = this._range, i = this._worksheet.getSheetId(), o = this._workbook.getUnitId();
-    for (let h = e; h <= t; h++) {
-      const a = [];
+    for (let a = e; a <= t; a++) {
+      const h = [];
       for (let d = n; d <= s; d++) {
-        const c = this._formulaDataModel.getFormulaStringByCell(h, d, i, o);
-        a.push(c || "");
+        const c = this._formulaDataModel.getFormulaStringByCell(a, d, i, o);
+        h.push(c || "");
       }
-      r.push(a);
+      r.push(h);
     }
     return r;
   }
@@ -1037,9 +1166,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getWrap()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getWrap()
    * ```
    */
   getWrap() {
@@ -1051,9 +1180,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getWrapStrategy()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getWrapStrategy()
    * ```
    */
   getWrapStrategy() {
@@ -1065,13 +1194,13 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getHorizontalAlignment()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getHorizontalAlignment()
    * ```
    */
   getHorizontalAlignment() {
-    return Zt(this._worksheet.getRange(this._range).getHorizontalAlignment());
+    return en(this._worksheet.getRange(this._range).getHorizontalAlignment());
   }
   /**
    * Returns the vertical alignment for the top left cell of the range.
@@ -1079,13 +1208,13 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getVerticalAlignment()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getVerticalAlignment()
    * ```
    */
   getVerticalAlignment() {
-    return tn(this._worksheet.getRange(this._range).getVerticalAlignment());
+    return nn(this._worksheet.getRange(this._range).getVerticalAlignment());
   }
   /**
    * Set custom meta data for first cell in current range.
@@ -1093,9 +1222,9 @@ let S = class extends ce {
    * @returns {FRange} This range, for chaining
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setCustomMetaData({ key: 'value' });
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setCustomMetaData({ key: 'value' });
    * ```
    */
   setCustomMetaData(r) {
@@ -1109,9 +1238,9 @@ let S = class extends ce {
    * @returns {FRange} This range, for chaining
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setCustomMetaDatas([[{ key: 'value' }]]);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setCustomMetaDatas([[{ key: 'value' }]]);
    * ```
    */
   setCustomMetaDatas(r) {
@@ -1123,9 +1252,9 @@ let S = class extends ce {
    * @example
    * ```
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCustomMetaData()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCustomMetaData()
    * ```
    */
   getCustomMetaData() {
@@ -1139,9 +1268,9 @@ let S = class extends ce {
    * @example
    * ```
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .getCustomMetaDatas()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .getCustomMetaDatas()
    * ```
    */
   getCustomMetaDatas() {
@@ -1159,9 +1288,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setBorder(BorderType.ALL, BorderStyleType.THIN, '#ff0000');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setBorder(BorderType.ALL, BorderStyleType.THIN, '#ff0000');
    * ```
    */
   setBorder(r, e, t) {
@@ -1183,9 +1312,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setBackgroundColor('red')
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setBackgroundColor('red')
    * ```
    */
   setBackgroundColor(r) {
@@ -1219,9 +1348,9 @@ let S = class extends ce {
    * @returns {FRange} This range, for chaining
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setValue(1);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setValue(1);
    * ```
    */
   setValue(r) {
@@ -1241,9 +1370,9 @@ let S = class extends ce {
    * @returns {FRange} This range, for chaining
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setValueForCell(1);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setValueForCell(1);
    * ```
    */
   setValueForCell(r) {
@@ -1269,9 +1398,9 @@ let S = class extends ce {
    * @example
    * ```
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setRichTextValueForCell(new RichTextValue().insertText('Hello'));
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setRichTextValueForCell(new RichTextValue().insertText('Hello'));
    * ```
    */
   setRichTextValueForCell(r) {
@@ -1295,10 +1424,10 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI
-   *  .getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setRichTextValues([[new RichTextValue().insertText('Hello')]]);
+   *   .getActiveWorkbook()
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setRichTextValues([[new RichTextValue().insertText('Hello')]]);
    * ```
    */
   setRichTextValues(r) {
@@ -1318,9 +1447,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setWrap(true);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setWrap(true);
    * ```
    */
   setWrap(r) {
@@ -1338,9 +1467,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setWrapStrategy(WrapStrategy.WRAP);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setWrapStrategy(WrapStrategy.WRAP);
    * ```
    */
   setWrapStrategy(r) {
@@ -1358,17 +1487,17 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setVerticalAlignment('top');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setVerticalAlignment('top');
    * ```
    */
   setVerticalAlignment(r) {
-    return this._commandService.syncExecuteCommand(kt.id, {
+    return this._commandService.syncExecuteCommand(St.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      value: en(r)
+      value: tn(r)
     }), this;
   }
   /**
@@ -1378,17 +1507,17 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setHorizontalAlignment('left');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setHorizontalAlignment('left');
    * ```
    */
   setHorizontalAlignment(r) {
-    return this._commandService.syncExecuteCommand(St.id, {
+    return this._commandService.syncExecuteCommand(kt.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      value: Xt(r)
+      value: Zt(r)
     }), this;
   }
   /**
@@ -1398,9 +1527,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setValues([[1, 2], [3, 4]]);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setValues([[1, 2], [3, 4]]);
    * ```
    */
   setValues(r) {
@@ -1419,9 +1548,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontWeight('bold');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontWeight('bold');
    * ```
    */
   setFontWeight(r) {
@@ -1452,9 +1581,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontStyle('italic');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontStyle('italic');
    * ```
    */
   setFontStyle(r) {
@@ -1485,9 +1614,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontLine('underline');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontLine('underline');
    * ```
    */
   setFontLine(r) {
@@ -1518,9 +1647,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontLine('underline');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontLine('underline');
    * ```
    */
   _setFontUnderline(r) {
@@ -1559,9 +1688,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontFamily('Arial');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontFamily('Arial');
    * ```
    */
   setFontFamily(r) {
@@ -1583,9 +1712,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontSize(12);
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontSize(12);
    * ```
    */
   setFontSize(r) {
@@ -1607,9 +1736,9 @@ let S = class extends ce {
    * @example
    * ```ts
    * univerAPI.getActiveWorkbook()
-   *  .getActiveSheet()
-   *  .getActiveRange()
-   *  .setFontColor('#ff0000');
+   *   .getActiveSheet()
+   *   .getActiveRange()
+   *   .setFontColor('#ff0000');
    * ```
    */
   setFontColor(r) {
@@ -1659,7 +1788,7 @@ let S = class extends ce {
    * ```
    */
   mergeAcross(r = !0) {
-    const e = ke([this._range], me.ROWS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
+    const e = Se([this._range], le.ROWS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
     return H(this._injector, t, n, e, r), this;
   }
   /**
@@ -1677,7 +1806,7 @@ let S = class extends ce {
    * ```
    */
   mergeVertically(r = !0) {
-    const e = ke([this._range], me.COLUMNS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
+    const e = Se([this._range], le.COLUMNS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
     return H(this._injector, t, n, e, r), this;
   }
   /**
@@ -1730,14 +1859,14 @@ let S = class extends ce {
    * const fWorksheet = fWorkbook.getActiveSheet();
    * const fRange = fWorksheet.getRange('A1:B2');
    * fRange.forEach((row, col, cell) => {
-   *    console.log(row, col, cell);
+   *   console.log(row, col, cell);
    * });
    * ```
    */
   forEach(r) {
     const { startColumn: e, startRow: t, endColumn: n, endRow: s } = this._range;
-    this._worksheet.getMatrixWithMergedCells(t, e, s, n).forValue((i, o, h) => {
-      r(i, o, h);
+    this._worksheet.getMatrixWithMergedCells(t, e, s, n).forValue((i, o, a) => {
+      r(i, o, a);
     });
   }
   /**
@@ -1752,7 +1881,7 @@ let S = class extends ce {
    * ```
    */
   getA1Notation(r) {
-    return r ? Ht(this._worksheet.getName(), this._range) : ue(this._range);
+    return r ? zt(this._worksheet.getName(), this._range) : ue(this._range);
   }
   /**
    * Sets the specified range as the active range, with the top left cell in the range as the current cell.
@@ -1886,16 +2015,16 @@ let S = class extends ce {
     });
   }
 };
-S = sn([
+k = on([
   K(3, u(y)),
-  K(4, l),
-  K(5, u(Vt))
-], S);
-var on = Object.defineProperty, hn = Object.getOwnPropertyDescriptor, an = (r, e, t, n) => {
+  K(4, m),
+  K(5, u(Ht))
+], k);
+var an = Object.defineProperty, hn = Object.getOwnPropertyDescriptor, dn = (r, e, t, n) => {
   for (var s = n > 1 ? void 0 : n ? hn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
-  return n && s && on(e, t, s), s;
-}, dn = (r, e) => (t, n) => e(t, n, r);
+  return n && s && an(e, t, s), s;
+}, cn = (r, e) => (t, n) => e(t, n, r);
 let L = class {
   constructor(r, e, t, n) {
     this._workbook = r, this._worksheet = e, this._selections = t, this._injector = n;
@@ -1914,7 +2043,7 @@ let L = class {
    */
   getActiveRange() {
     const r = this._selections.find((e) => !!e.primary);
-    return r ? this._injector.createInstance(S, this._workbook, this._worksheet, r.range) : null;
+    return r ? this._injector.createInstance(k, this._workbook, this._worksheet, r.range) : null;
   }
   /**
    * Represents the active selection list in the sheet.
@@ -1929,7 +2058,7 @@ let L = class {
    * ```
    */
   getActiveRangeList() {
-    return this._selections.map((r) => this._injector.createInstance(S, this._workbook, this._worksheet, r.range));
+    return this._selections.map((r) => this._injector.createInstance(k, this._workbook, this._worksheet, r.range));
   }
   /**
    * Represents the current select cell in the sheet.
@@ -1961,7 +2090,7 @@ let L = class {
    */
   getActiveSheet() {
     const r = this._injector.createInstance(f, this._workbook);
-    return this._injector.createInstance(m, r, this._workbook, this._worksheet);
+    return this._injector.createInstance(l, r, this._workbook, this._worksheet);
   }
   /**
    * Update the primary cell in the selection. if the primary cell not exists in selections, add it to the selections and clear the old selections.
@@ -1978,7 +2107,7 @@ let L = class {
    * ```
    */
   updatePrimaryCell(r) {
-    const e = this._injector.get(l);
+    const e = this._injector.get(m);
     let t = [], n = !1;
     for (const { range: i, style: o } of this._selections)
       M.contains(i, r.getRange()) ? (t.push({
@@ -2022,18 +2151,18 @@ let L = class {
     if (!this._selections.find((n) => !!n.primary))
       return null;
     const t = It(this._selections.concat(), r, this._worksheet);
-    return t ? this._injector.createInstance(S, this._workbook, this._worksheet, t) : null;
+    return t ? this._injector.createInstance(k, this._workbook, this._worksheet, t) : null;
   }
 };
-L = an([
-  dn(3, u(y))
+L = dn([
+  cn(3, u(y))
 ], L);
-var cn = Object.defineProperty, un = Object.getOwnPropertyDescriptor, gn = (r, e, t, n) => {
-  for (var s = n > 1 ? void 0 : n ? un(e, t) : e, i = r.length - 1, o; i >= 0; i--)
+var un = Object.defineProperty, gn = Object.getOwnPropertyDescriptor, mn = (r, e, t, n) => {
+  for (var s = n > 1 ? void 0 : n ? gn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
-  return n && s && cn(e, t, s), s;
+  return n && s && un(e, t, s), s;
 }, B = (r, e) => (t, n) => e(t, n, r);
-let m = class extends ce {
+let l = class extends ce {
   /**
    * Creates a new worksheet facade instance
    * @param {FWorkbook} _fWorkbook - The facade workbook instance
@@ -2044,7 +2173,7 @@ let m = class extends ce {
    * @param {ILogService} _logService - The log service
    * @param {ICommandService} _commandService - The command service
    */
-  constructor(e, t, n, s, i, o, h) {
+  constructor(e, t, n, s, i, o, a) {
     super(s);
     /**
      * Sets the active selection region for this sheet.
@@ -2058,7 +2187,7 @@ let m = class extends ce {
      * ```
      */
     b(this, "setActiveSelection", this.setActiveRange);
-    this._fWorkbook = e, this._workbook = t, this._worksheet = n, this._injector = s, this._selectionManagerService = i, this._logService = o, this._commandService = h;
+    this._fWorkbook = e, this._workbook = t, this._worksheet = n, this._injector = s, this._selectionManagerService = i, this._logService = o, this._commandService = a;
   }
   /**
    * Returns the worksheet
@@ -2219,7 +2348,7 @@ let m = class extends ce {
         }
       }
     };
-    return this._commandService.syncExecuteCommand(Se.id, i), this;
+    return this._commandService.syncExecuteCommand(ke.id, i), this;
   }
   /**
    * Set the default style of the worksheet column
@@ -2250,20 +2379,20 @@ let m = class extends ce {
     if (typeof e == "object")
       i = e, o = this._worksheet;
     else if (typeof e == "string") {
-      const { range: h, sheetName: a } = zt(e), d = a ? this._workbook.getSheetBySheetName(a) : this._worksheet;
+      const { range: a, sheetName: h } = $t(e), d = h ? this._workbook.getSheetBySheetName(h) : this._worksheet;
       if (!d)
         throw new Error("Range not found");
       o = d, i = {
-        ...h,
+        ...a,
         unitId: this._workbook.getUnitId(),
         sheetId: o.getSheetId(),
         // Use the current range instead of the future actual range to match Apps Script behavior.
         // Users can create the latest range in real time when needed.
         rangeType: _.NORMAL,
-        startRow: h.rangeType === _.COLUMN ? 0 : h.startRow,
-        endRow: h.rangeType === _.COLUMN ? o.getMaxRows() - 1 : h.endRow,
-        startColumn: h.rangeType === _.ROW ? 0 : h.startColumn,
-        endColumn: h.rangeType === _.ROW ? o.getMaxColumns() - 1 : h.endColumn
+        startRow: a.rangeType === _.COLUMN ? 0 : a.startRow,
+        endRow: a.rangeType === _.COLUMN ? o.getMaxRows() - 1 : a.endRow,
+        startColumn: a.rangeType === _.ROW ? 0 : a.startColumn,
+        endColumn: a.rangeType === _.ROW ? o.getMaxColumns() - 1 : a.endColumn
       };
     } else if (typeof e == "number" && t !== void 0)
       o = this._worksheet, i = {
@@ -2276,7 +2405,7 @@ let m = class extends ce {
       };
     else
       throw new Error("Invalid range specification");
-    return this._injector.createInstance(S, this._workbook, o, i);
+    return this._injector.createInstance(k, this._workbook, o, i);
   }
   /**
    * Returns the current number of columns in the sheet, regardless of content.
@@ -2368,15 +2497,15 @@ let m = class extends ce {
    * ```
    */
   insertRowsAfter(e, t) {
-    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.DOWN, o = e + 1, h = e + t, a = 0, d = this._worksheet.getColumnCount() - 1, c = A(this._worksheet, o, h, a, d, !0, e);
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.DOWN, o = e + 1, a = e + t, h = 0, d = this._worksheet.getColumnCount() - 1, c = A(this._worksheet, o, a, h, d, !0, e);
     return this._commandService.syncExecuteCommand(Ce.id, {
       unitId: n,
       subUnitId: s,
       direction: i,
       range: {
         startRow: o,
-        endRow: h,
-        startColumn: a,
+        endRow: a,
+        startColumn: h,
         endColumn: d
       },
       cellValue: c
@@ -2397,15 +2526,15 @@ let m = class extends ce {
    * ```
    */
   insertRowsBefore(e, t) {
-    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.UP, o = e, h = e + t - 1, a = 0, d = this._worksheet.getColumnCount() - 1, c = A(this._worksheet, o, h, a, d, !0, e - 1);
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.UP, o = e, a = e + t - 1, h = 0, d = this._worksheet.getColumnCount() - 1, c = A(this._worksheet, o, a, h, d, !0, e - 1);
     return this._commandService.syncExecuteCommand(Ce.id, {
       unitId: n,
       subUnitId: s,
       direction: i,
       range: {
         startRow: o,
-        endRow: h,
-        startColumn: a,
+        endRow: a,
+        startColumn: h,
         endColumn: d
       },
       cellValue: c
@@ -2469,7 +2598,7 @@ let m = class extends ce {
    * ```
    */
   moveRows(e, t) {
-    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = G(e.getRange(), this._worksheet), o = i, h = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = G(e.getRange(), this._worksheet), o = i, a = {
       startRow: t,
       endRow: t,
       startColumn: i.startColumn,
@@ -2480,7 +2609,7 @@ let m = class extends ce {
       subUnitId: s,
       range: i,
       fromRange: o,
-      toRange: h
+      toRange: a
     }), this;
   }
   /**
@@ -2647,25 +2776,25 @@ let m = class extends ce {
    */
   setRowHeights(e, t, n) {
     var d;
-    const s = this._workbook.getUnitId(), i = this._worksheet.getSheetId(), o = this._worksheet.getRowManager(), h = [], a = [];
+    const s = this._workbook.getUnitId(), i = this._worksheet.getSheetId(), o = this._worksheet.getRowManager(), a = [], h = [];
     for (let c = e; c < e + t; c++) {
-      const v = ((d = o.getRow(c)) == null ? void 0 : d.ah) || this._worksheet.getConfig().defaultRowHeight, k = {
+      const v = ((d = o.getRow(c)) == null ? void 0 : d.ah) || this._worksheet.getConfig().defaultRowHeight, S = {
         startRow: c,
         endRow: c,
         startColumn: 0,
         endColumn: this._worksheet.getColumnCount() - 1
       };
-      n <= v ? h.push(k) : a.push(k);
+      n <= v ? a.push(S) : h.push(S);
     }
-    return a.length > 0 && this._commandService.syncExecuteCommand(Ie.id, {
+    return h.length > 0 && this._commandService.syncExecuteCommand(Ie.id, {
       unitId: s,
       subUnitId: i,
-      ranges: a,
+      ranges: h,
       value: n
-    }), h.length > 0 && this._commandService.syncExecuteCommand(be.id, {
+    }), a.length > 0 && this._commandService.syncExecuteCommand(be.id, {
       unitId: s,
       subUnitId: i,
-      ranges: h
+      ranges: a
     }), this;
   }
   /**
@@ -2736,9 +2865,9 @@ let m = class extends ce {
    */
   setRowCustom(e) {
     const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = {};
-    for (const [o, h] of Object.entries(e))
+    for (const [o, a] of Object.entries(e))
       s[Number(o)] = {
-        custom: h
+        custom: a
       };
     const i = {
       unitId: t,
@@ -2812,15 +2941,15 @@ let m = class extends ce {
    * ```
    */
   insertColumnsAfter(e, t) {
-    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.RIGHT, o = 0, h = this._worksheet.getRowCount() - 1, a = e + 1, d = e + t, c = A(this._worksheet, o, h, a, d, !1, e);
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.RIGHT, o = 0, a = this._worksheet.getRowCount() - 1, h = e + 1, d = e + t, c = A(this._worksheet, o, a, h, d, !1, e);
     return this._commandService.syncExecuteCommand(Re.id, {
       unitId: n,
       subUnitId: s,
       direction: i,
       range: {
         startRow: o,
-        endRow: h,
-        startColumn: a,
+        endRow: a,
+        startColumn: h,
         endColumn: d
       },
       cellValue: c
@@ -2841,15 +2970,15 @@ let m = class extends ce {
    * ```
    */
   insertColumnsBefore(e, t) {
-    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.LEFT, o = 0, h = this._worksheet.getRowCount() - 1, a = e, d = e + t - 1, c = A(this._worksheet, o, h, a, d, !1, e - 1);
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = D.LEFT, o = 0, a = this._worksheet.getRowCount() - 1, h = e, d = e + t - 1, c = A(this._worksheet, o, a, h, d, !1, e - 1);
     return this._commandService.syncExecuteCommand(Re.id, {
       unitId: n,
       subUnitId: s,
       direction: i,
       range: {
         startRow: o,
-        endRow: h,
-        startColumn: a,
+        endRow: a,
+        startColumn: h,
         endColumn: d
       },
       cellValue: c
@@ -2913,7 +3042,7 @@ let m = class extends ce {
    * ```
    */
   moveColumns(e, t) {
-    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = q(e.getRange(), this._worksheet), o = i, h = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = q(e.getRange(), this._worksheet), o = i, a = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: t,
@@ -2924,7 +3053,7 @@ let m = class extends ce {
       subUnitId: s,
       range: i,
       fromRange: o,
-      toRange: h
+      toRange: a
     }), this;
   }
   /**
@@ -3083,16 +3212,16 @@ let m = class extends ce {
    */
   setColumnCustom(e) {
     const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = {};
-    for (const [o, h] of Object.entries(e))
+    for (const [o, a] of Object.entries(e))
       s[Number(o)] = {
-        custom: h
+        custom: a
       };
     const i = {
       unitId: t,
       subUnitId: n,
       columnData: s
     };
-    return this._commandService.syncExecuteCommand(Se.id, i), this;
+    return this._commandService.syncExecuteCommand(ke.id, i), this;
   }
   // #region merge cells
   /**
@@ -3110,7 +3239,7 @@ let m = class extends ce {
    * ```
    */
   getMergedRanges() {
-    return this._worksheet.getSnapshot().mergeData.map((t) => this._injector.createInstance(S, this._workbook, this._worksheet, t));
+    return this._worksheet.getSnapshot().mergeData.map((t) => this._injector.createInstance(k, this._workbook, this._worksheet, t));
   }
   /**
    * Get the merged cell data of the specified row and column.
@@ -3130,7 +3259,7 @@ let m = class extends ce {
   getCellMergeData(e, t) {
     const s = this._worksheet.getMergedCell(e, t);
     if (s)
-      return this._injector.createInstance(S, this._workbook, this._worksheet, s);
+      return this._injector.createInstance(k, this._workbook, this._worksheet, s);
   }
   // #endregion
   /**
@@ -3442,7 +3571,7 @@ let m = class extends ce {
    * @deprecated use `univerAPI.addEvent(univerAPI.Event.SheetValueChanged, callback)` instead
    */
   onCellDataChange(e) {
-    return this._injector.get(l).onCommandExecuted((n) => {
+    return this._injector.get(m).onCommandExecuted((n) => {
       if (n.id === Ee.id) {
         const s = n.params;
         s.unitId === this._workbook.getUnitId() && s.subUnitId === this._worksheet.getSheetId() && s.cellValue && e(new W(s.cellValue));
@@ -3454,7 +3583,7 @@ let m = class extends ce {
    * @deprecated use `univerAPI.addEvent(univerAPI.Event.SheetValueChanged, callback)` instead
    */
   onBeforeCellDataChange(e) {
-    return this._injector.get(l).beforeCommandExecuted((n) => {
+    return this._injector.get(m).beforeCommandExecuted((n) => {
       if (n.id === Ee.id) {
         const s = n.params;
         s.unitId === this._workbook.getUnitId() && s.subUnitId === this._worksheet.getSheetId() && s.cellValue && e(new W(s.cellValue));
@@ -3473,7 +3602,7 @@ let m = class extends ce {
    * ```
    */
   hideSheet() {
-    const e = this._injector.get(l);
+    const e = this._injector.get(m);
     if (this._workbook.getSheets().filter((i) => i.isSheetHidden() !== g.TRUE).length <= 1)
       throw new Error("Cannot hide the only visible sheet");
     return e.syncExecuteCommand(se.id, {
@@ -3493,7 +3622,7 @@ let m = class extends ce {
    * ```
    */
   showSheet() {
-    return this._injector.get(l).syncExecuteCommand(Nt.id, {
+    return this._injector.get(m).syncExecuteCommand(Nt.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId()
     }), this;
@@ -3564,7 +3693,7 @@ let m = class extends ce {
    */
   clear(e) {
     e && e.contentsOnly && !e.formatOnly && this.clearContents(), e && e.formatOnly && !e.contentsOnly && this.clearFormats();
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = this._injector.get(l), i = {
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = this._injector.get(m), i = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: 0,
@@ -3589,7 +3718,7 @@ let m = class extends ce {
    * ```
    */
   clearContents() {
-    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(l), s = {
+    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(m), s = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: 0,
@@ -3613,7 +3742,7 @@ let m = class extends ce {
    * ```
    */
   clearFormats() {
-    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(l), s = {
+    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(m), s = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: 0,
@@ -3714,7 +3843,7 @@ let m = class extends ce {
    * ```
    */
   equalTo(e) {
-    return e instanceof m ? this._worksheet.getSheetId() === e.getSheetId() && this._workbook.getUnitId() === e.getWorkbook().getUnitId() : !1;
+    return e instanceof l ? this._worksheet.getSheetId() === e.getSheetId() && this._workbook.getUnitId() === e.getWorkbook().getUnitId() : !1;
   }
   /*
   * Insert a defined name for worksheet.
@@ -3834,25 +3963,25 @@ let m = class extends ce {
    * ```
    */
   getMergeData() {
-    return this._worksheet.getMergeData().map((e) => this._injector.createInstance(S, this._workbook, this._worksheet, e));
+    return this._worksheet.getMergeData().map((e) => this._injector.createInstance(k, this._workbook, this._worksheet, e));
   }
 };
-m = gn([
+l = mn([
   B(3, u(y)),
   B(4, u(ze)),
   B(5, u(De)),
-  B(6, l)
-], m);
-var ln = Object.defineProperty, mn = Object.getOwnPropertyDescriptor, _n = (r, e, t, n) => {
-  for (var s = n > 1 ? void 0 : n ? mn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
+  B(6, m)
+], l);
+var ln = Object.defineProperty, _n = Object.getOwnPropertyDescriptor, Sn = (r, e, t, n) => {
+  for (var s = n > 1 ? void 0 : n ? _n(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
   return n && s && ln(e, t, s), s;
 }, C = (r, e) => (t, n) => e(t, n, r);
 let f = class extends ce {
-  constructor(e, t, n, s, i, o, h, a, d, c) {
+  constructor(e, t, n, s, i, o, a, h, d, c) {
     super(t);
     b(this, "id");
-    this._workbook = e, this._injector = t, this._resourceLoaderService = n, this._selectionManagerService = s, this._univerInstanceService = i, this._commandService = o, this._permissionService = h, this._logService = a, this._localeService = d, this._definedNamesService = c, this.id = this._workbook.getUnitId();
+    this._workbook = e, this._injector = t, this._resourceLoaderService = n, this._selectionManagerService = s, this._univerInstanceService = i, this._commandService = o, this._permissionService = a, this._logService = h, this._localeService = d, this._definedNamesService = c, this.id = this._workbook.getUnitId();
   }
   /**
    * Get the Workbook instance.
@@ -3946,7 +4075,7 @@ let f = class extends ce {
    */
   getActiveSheet() {
     const e = this._workbook.getActiveSheet();
-    return this._injector.createInstance(m, this, this._workbook, e);
+    return this._injector.createInstance(l, this, this._workbook, e);
   }
   /**
    * Gets all the worksheets in this workbook
@@ -3959,7 +4088,7 @@ let f = class extends ce {
    * ```
    */
   getSheets() {
-    return this._workbook.getSheets().map((e) => this._injector.createInstance(m, this, this._workbook, e));
+    return this._workbook.getSheets().map((e) => this._injector.createInstance(l, this, this._workbook, e));
   }
   /**
    * Create a new worksheet and returns a handle to it.
@@ -3987,7 +4116,7 @@ let f = class extends ce {
     const i = this._workbook.getActiveSheet();
     if (!i)
       throw new Error("No active sheet found");
-    return this._injector.createInstance(m, this, this._workbook, i);
+    return this._injector.createInstance(l, this, this._workbook, i);
   }
   /**
    * Get a worksheet by sheet id.
@@ -4002,7 +4131,7 @@ let f = class extends ce {
    */
   getSheetBySheetId(e) {
     const t = this._workbook.getSheetBySheetId(e);
-    return t ? this._injector.createInstance(m, this, this._workbook, t) : null;
+    return t ? this._injector.createInstance(l, this, this._workbook, t) : null;
   }
   /**
    * Get a worksheet by sheet name.
@@ -4017,7 +4146,7 @@ let f = class extends ce {
    */
   getSheetByName(e) {
     const t = this._workbook.getSheetBySheetName(e);
-    return t ? this._injector.createInstance(m, this, this._workbook, t) : null;
+    return t ? this._injector.createInstance(l, this, this._workbook, t) : null;
   }
   /**
    * Sets the given worksheet to be the active worksheet in the workbook.
@@ -4063,7 +4192,7 @@ let f = class extends ce {
     const s = this._workbook.getActiveSheet();
     if (!s)
       throw new Error("No active sheet found");
-    return this._injector.createInstance(m, this, this._workbook, s);
+    return this._injector.createInstance(l, this, this._workbook, s);
   }
   /**
    * Deletes the specified worksheet.
@@ -4125,7 +4254,7 @@ let f = class extends ce {
    * // The code below registers a callback that will be triggered before invoking a command targeting the Univer sheet
    * const activeSpreadsheet = univerAPI.getActiveWorkbook();
    * activeSpreadsheet.onBeforeCommandExecute((command) => {
-   *    console.log('Command executed:', command);
+   *   console.log('Command executed:', command);
    * });
    * ```
    */
@@ -4194,7 +4323,7 @@ let f = class extends ce {
     const t = this.getActiveSheet(), n = e.getRange().sheetId || t.getSheetId(), s = n ? this._workbook.getSheetBySheetId(n) : this._workbook.getActiveSheet(!0);
     if (!s)
       throw new Error("No active sheet found");
-    s.getSheetId() !== t.getSheetId() && this.setActiveSheet(this._injector.createInstance(m, this, this._workbook, s));
+    s.getSheetId() !== t.getSheetId() && this.setActiveSheet(this._injector.createInstance(l, this, this._workbook, s));
     const i = {
       unitId: this.getId(),
       subUnitId: n,
@@ -4209,7 +4338,7 @@ let f = class extends ce {
   // could sheet have no active range ?
   getActiveRange() {
     const e = this._workbook.getActiveSheet(), n = this._selectionManagerService.getCurrentSelections().find((s) => !!s.primary);
-    return n ? this._injector.createInstance(S, this._workbook, e, n.range) : null;
+    return n ? this._injector.createInstance(k, this._workbook, e, n.range) : null;
   }
   /**
    * Deletes the currently active sheet.
@@ -4241,7 +4370,7 @@ let f = class extends ce {
     return this._commandService.syncExecuteCommand(At.id, {
       unitId: e.getWorkbook().getUnitId(),
       subUnitId: e.getSheetId()
-    }), this._injector.createInstance(m, this, this._workbook, this._workbook.getActiveSheet());
+    }), this._injector.createInstance(l, this, this._workbook, this._workbook.getActiveSheet());
   }
   /**
    * Duplicates the active sheet.
@@ -4331,7 +4460,7 @@ let f = class extends ce {
    */
   moveSheet(e, t) {
     let n = t;
-    return n < 0 ? n = 0 : n > this._workbook.getSheets().length - 1 && (n = this._workbook.getSheets().length - 1), this._commandService.syncExecuteCommand(he.id, {
+    return n < 0 ? n = 0 : n > this._workbook.getSheets().length - 1 && (n = this._workbook.getSheets().length - 1), this._commandService.syncExecuteCommand(ae.id, {
       unitId: e.getWorkbook().getUnitId(),
       order: n,
       subUnitId: e.getSheetId()
@@ -4475,9 +4604,9 @@ let f = class extends ce {
    * const fWorkbook = univerAPI.getActiveWorkbook();
    * const rangeThemeStyle = new RangeThemeStyle('MyTheme');
    * rangeThemeStyle.setSecondRowStyle({
-   *    bg: {
-   *       rgb: 'rgb(214,231,241)',
-   *    },
+   *   bg: {
+   *     rgb: 'rgb(214,231,241)',
+   *   },
    * });
    * fWorkbook.registerRangeTheme(rangeThemeStyle);
    * ```
@@ -4504,6 +4633,9 @@ let f = class extends ce {
       themeName: e
     });
   }
+  createRangeThemeStyle(e, t) {
+    return new Ft(e, t);
+  }
   /**
    * Set custom metadata of workbook
    * @param {CustomData | undefined} custom custom metadata
@@ -4530,13 +4662,13 @@ let f = class extends ce {
     return this._workbook.getCustomMetadata();
   }
 };
-f = _n([
+f = Sn([
   C(1, u(y)),
   C(2, u(Xe)),
   C(3, u(ze)),
   C(4, J),
-  C(5, l),
-  C(6, ae),
+  C(5, m),
+  C(6, he),
   C(7, De),
   C(8, u(Te)),
   C(9, $e)
@@ -4591,20 +4723,23 @@ class kn extends Be {
       })
     );
   }
+  /**
+   * @ignore
+   */
   // eslint-disable-next-line max-lines-per-function
   _initialize(e) {
-    const t = e.get(l);
+    const t = e.get(m);
     this.disposeWithMe(
       // eslint-disable-next-line max-lines-per-function, complexity
       t.beforeCommandExecuted((n) => {
-        var s, i, o, h;
+        var s, i, o, a;
         switch (n.id) {
           case T.id: {
-            const a = n.params, { unitId: d, index: c, sheet: v } = a || {}, k = d ? this.getUniverSheet(d) : (s = this.getActiveWorkbook) == null ? void 0 : s.call(this);
-            if (!k)
+            const h = n.params, { unitId: d, index: c, sheet: v } = h || {}, S = d ? this.getUniverSheet(d) : (s = this.getActiveWorkbook) == null ? void 0 : s.call(this);
+            if (!S)
               return;
             const ge = {
-              workbook: k,
+              workbook: S,
               index: c,
               sheet: v
             };
@@ -4617,66 +4752,66 @@ class kn extends Be {
           }
           case Ue.id: {
             if (!this._eventListend(this.Event.BeforeActiveSheetChange)) return;
-            const { subUnitId: a, unitId: d } = n.params, c = d ? this.getUniverSheet(d) : (i = this.getActiveWorkbook) == null ? void 0 : i.call(this);
-            if (!c || !a) return;
-            const v = c.getSheetBySheetId(a), k = c.getActiveSheet();
-            if (!v || !k) return;
-            this._fireBeforeActiveSheetChange(c, v, k);
+            const { subUnitId: h, unitId: d } = n.params, c = d ? this.getUniverSheet(d) : (i = this.getActiveWorkbook) == null ? void 0 : i.call(this);
+            if (!c || !h) return;
+            const v = c.getSheetBySheetId(h), S = c.getActiveSheet();
+            if (!v || !S) return;
+            this._fireBeforeActiveSheetChange(c, v, S);
             break;
           }
           case oe.id: {
             if (!this._eventListend(this.Event.BeforeSheetDelete)) return;
-            const a = this.getCommandSheetTarget(n);
-            if (!a) return;
-            const { workbook: d, worksheet: c } = a;
+            const h = this.getCommandSheetTarget(n);
+            if (!h) return;
+            const { workbook: d, worksheet: c } = h;
             this._fireBeforeSheetDelete(d, c);
             break;
           }
-          case he.id: {
+          case ae.id: {
             if (!this._eventListend(this.Event.BeforeSheetMove)) return;
-            const { fromOrder: a, toOrder: d } = n.params, c = this.getCommandSheetTarget(n);
+            const { fromOrder: h, toOrder: d } = n.params, c = this.getCommandSheetTarget(n);
             if (!c) return;
-            this._fireBeforeSheetMove(c.workbook, c.worksheet, d, a);
+            this._fireBeforeSheetMove(c.workbook, c.worksheet, d, h);
             break;
           }
           case ie.id: {
             if (!this._eventListend(this.Event.BeforeSheetNameChange)) return;
-            const { name: a } = n.params, d = this.getCommandSheetTarget(n);
+            const { name: h } = n.params, d = this.getCommandSheetTarget(n);
             if (!d) return;
-            this._fireBeforeSheetNameChange(d.workbook, d.worksheet, a, d.worksheet.getSheetName());
+            this._fireBeforeSheetNameChange(d.workbook, d.worksheet, h, d.worksheet.getSheetName());
             break;
           }
           case re.id: {
             if (!this._eventListend(this.Event.BeforeSheetTabColorChange)) return;
-            const { color: a } = n.params, d = this.getCommandSheetTarget(n);
+            const { color: h } = n.params, d = this.getCommandSheetTarget(n);
             if (!d) return;
-            this._fireBeforeSheetTabColorChange(d.workbook, d.worksheet, a, d.worksheet.getTabColor());
+            this._fireBeforeSheetTabColorChange(d.workbook, d.worksheet, h, d.worksheet.getTabColor());
             break;
           }
           case se.id: {
             if (!this._eventListend(this.Event.BeforeSheetHideChange)) return;
-            const { hidden: a } = n.params, d = this.getCommandSheetTarget(n);
+            const { hidden: h } = n.params, d = this.getCommandSheetTarget(n);
             if (!d) return;
-            this._fireBeforeSheetHideChange(d.workbook, d.worksheet, !!a);
+            this._fireBeforeSheetHideChange(d.workbook, d.worksheet, !!h);
             break;
           }
           case ne.id: {
             if (!this._eventListend(this.Event.BeforeGridlineColorChange)) return;
-            const a = this.getCommandSheetTarget(n);
-            if (!a) return;
+            const h = this.getCommandSheetTarget(n);
+            if (!h) return;
             this.fireEvent(this.Event.BeforeGridlineColorChange, {
-              ...a,
+              ...h,
               color: (o = n.params) == null ? void 0 : o.color
             });
             break;
           }
           case te.id: {
             if (!this._eventListend(this.Event.BeforeGridlineEnableChange)) return;
-            const a = this.getCommandSheetTarget(n);
-            if (!a) return;
+            const h = this.getCommandSheetTarget(n);
+            if (!h) return;
             this.fireEvent(this.Event.BeforeGridlineEnableChange, {
-              ...a,
-              enabled: !!((h = n.params) != null && h.showGridlines)
+              ...h,
+              enabled: !!((a = n.params) != null && a.showGridlines)
             });
             break;
           }
@@ -4686,31 +4821,31 @@ class kn extends Be {
       // eslint-disable-next-line max-lines-per-function, complexity
       t.onCommandExecuted((n) => {
         var s, i;
-        if (Ft.indexOf(n.id) > -1) {
+        if (jt.indexOf(n.id) > -1) {
           if (!this._eventListend(this.Event.SheetValueChanged) || !this.getActiveSheet()) return;
-          const h = jt(n).map(
-            (a) => {
+          const a = Ot(n).map(
+            (h) => {
               var d, c;
-              return (c = (d = this.getWorkbook(a.unitId)) == null ? void 0 : d.getSheetBySheetId(a.subUnitId)) == null ? void 0 : c.getRange(a.range);
+              return (c = (d = this.getWorkbook(h.unitId)) == null ? void 0 : d.getSheetBySheetId(h.subUnitId)) == null ? void 0 : c.getRange(h.range);
             }
           ).filter(Boolean);
-          if (!h.length) return;
+          if (!a.length) return;
           this.fireEvent(this.Event.SheetValueChanged, {
             payload: n,
-            effectedRanges: h
+            effectedRanges: a
           });
           return;
         }
         switch (n.id) {
           case T.id: {
-            const o = n.params, { unitId: h } = o || {}, a = h ? this.getUniverSheet(h) : (s = this.getActiveWorkbook) == null ? void 0 : s.call(this);
-            if (!a)
+            const o = n.params, { unitId: a } = o || {}, h = a ? this.getUniverSheet(a) : (s = this.getActiveWorkbook) == null ? void 0 : s.call(this);
+            if (!h)
               return;
-            const d = a.getActiveSheet();
+            const d = h.getActiveSheet();
             if (!d)
               return;
             const c = {
-              workbook: a,
+              workbook: h,
               worksheet: d
             };
             this.fireEvent(
@@ -4723,43 +4858,43 @@ class kn extends Be {
             if (!this._eventListend(this.Event.ActiveSheetChanged)) return;
             const o = this.getActiveSheet();
             if (!o) return;
-            const { workbook: h, worksheet: a } = o;
-            this._fireActiveSheetChanged(h, a);
+            const { workbook: a, worksheet: h } = o;
+            this._fireActiveSheetChanged(a, h);
             break;
           }
           case oe.id: {
             if (!this._eventListend(this.Event.SheetDeleted)) return;
-            const { subUnitId: o, unitId: h } = n.params, a = h ? this.getUniverSheet(h) : (i = this.getActiveWorkbook) == null ? void 0 : i.call(this);
-            if (!a || !o) return;
-            this._fireSheetDeleted(a, o);
+            const { subUnitId: o, unitId: a } = n.params, h = a ? this.getUniverSheet(a) : (i = this.getActiveWorkbook) == null ? void 0 : i.call(this);
+            if (!h || !o) return;
+            this._fireSheetDeleted(h, o);
             break;
           }
-          case he.id: {
+          case ae.id: {
             if (!this._eventListend(this.Event.SheetMoved)) return;
-            const { toOrder: o } = n.params, h = this.getCommandSheetTarget(n);
-            if (!h) return;
-            this._fireSheetMoved(h.workbook, h.worksheet, o);
+            const { toOrder: o } = n.params, a = this.getCommandSheetTarget(n);
+            if (!a) return;
+            this._fireSheetMoved(a.workbook, a.worksheet, o);
             break;
           }
           case ie.id: {
             if (!this._eventListend(this.Event.SheetNameChanged)) return;
-            const { name: o } = n.params, h = this.getCommandSheetTarget(n);
-            if (!h) return;
-            this._fireSheetNameChanged(h.workbook, h.worksheet, o);
+            const { name: o } = n.params, a = this.getCommandSheetTarget(n);
+            if (!a) return;
+            this._fireSheetNameChanged(a.workbook, a.worksheet, o);
             break;
           }
           case re.id: {
             if (!this._eventListend(this.Event.SheetTabColorChanged)) return;
-            const { color: o } = n.params, h = this.getCommandSheetTarget(n);
-            if (!h) return;
-            this._fireSheetTabColorChanged(h.workbook, h.worksheet, o);
+            const { color: o } = n.params, a = this.getCommandSheetTarget(n);
+            if (!a) return;
+            this._fireSheetTabColorChanged(a.workbook, a.worksheet, o);
             break;
           }
           case se.id: {
             if (!this._eventListend(this.Event.SheetHideChanged)) return;
-            const { hidden: o } = n.params, h = this.getCommandSheetTarget(n);
-            if (!h) return;
-            this._fireSheetHideChanged(h.workbook, h.worksheet, !!o);
+            const { hidden: o } = n.params, a = this.getCommandSheetTarget(n);
+            if (!a) return;
+            this._fireSheetHideChanged(a.workbook, a.worksheet, !!o);
             break;
           }
           case ne.id:
@@ -4905,16 +5040,16 @@ class kn extends Be {
   }
 }
 Be.extend(kn);
-class Sn {
+class wn {
   get SheetValueChangeType() {
-    return Ot;
+    return Lt;
   }
   get SheetSkeletonChangeType() {
-    return Lt;
+    return Vt;
   }
 }
-rt.extend(Sn);
-class wn extends We {
+rt.extend(wn);
+class Cn extends We {
   get SheetCreated() {
     return "SheetCreated";
   }
@@ -4976,27 +5111,27 @@ class wn extends We {
     return "SheetValueChanged";
   }
 }
-We.extend(wn);
-var Cn = Object.defineProperty, fn = Object.getOwnPropertyDescriptor, vn = (r, e, t, n) => {
-  for (var s = n > 1 ? void 0 : n ? fn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
+We.extend(Cn);
+var fn = Object.defineProperty, vn = Object.getOwnPropertyDescriptor, In = (r, e, t, n) => {
+  for (var s = n > 1 ? void 0 : n ? vn(e, t) : e, i = r.length - 1, o; i >= 0; i--)
     (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
-  return n && s && Cn(e, t, s), s;
-}, In = (r, e) => (t, n) => e(t, n, r);
+  return n && s && fn(e, t, s), s;
+}, bn = (r, e) => (t, n) => e(t, n, r);
 let xe = class extends de {
   constructor(r) {
     super(), this._injector = r;
   }
 };
-xe = vn([
-  In(0, u(y))
+xe = In([
+  bn(0, u(y))
 ], xe);
 export {
   j as FPermission,
-  S as FRange,
+  k as FRange,
   L as FSelection,
-  wn as FSheetEventName,
+  Cn as FSheetEventName,
   xe as FSheetHooks,
-  Sn as FSheetsEnum,
+  wn as FSheetsEnum,
   f as FWorkbook,
-  m as FWorksheet
+  l as FWorksheet
 };