@univerjs/sheets 0.5.4 → 0.5.5-nightly.202501201336

package/lib/es/facade.js

@@ -1,34 +1,34 @@
-var Ae = Object.defineProperty;
-var Fe = (s, e, t) => e in s ? Ae(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var k = (s, e, t) => Fe(s, typeof e != "symbol" ? e + "" : e, t);
-import { Inject as u, Injector as b, IAuthzIoService as ve, LocaleService as Re, ICommandService as l, IPermissionService as ee, generateRandomId as be, FBase as te, Rectangle as N, HorizontalAlign as y, VerticalAlign as U, isFormulaString as je, isCellV as Oe, isICellData as Ve, ObjectMatrix as A, Tools as Be, RANGE_TYPE as _, FBaseInitialable as ne, RichTextValue as p, BooleanNumber as m, WrapStrategy as oe, Dimension as ie, ILogService as pe, Registry as ye, toDisposable as F, Direction as D, IResourceLoaderService as Le, FEnum as ze, FEventName as se, mergeWorksheetSnapshotWithDefault as $e, UndoCommand as He, RedoCommand as Ge, UniverInstanceType as R, IUniverInstanceService as J, FUniver as Ue, CanceledError as qe } from "@univerjs/core";
-import { WorksheetProtectionRuleModel as Ee, RangeProtectionRuleModel as Pe, WorksheetProtectionPointModel as xe, SetDefinedNameCommand as Q, SCOPE_WORKBOOK_VALUE_DEFINED_NAME as X, RemoveDefinedNameCommand as Ke, PermissionPointsDefinitions as Ye, WorkbookEditablePermission as Ne, UnitObject as E, AddWorksheetProtectionMutation as Je, DeleteWorksheetProtectionMutation as Qe, getAllWorksheetPermissionPoint as Xe, getAllWorksheetPermissionPointByPointPanel as ae, SetWorksheetPermissionPointsMutation as Ze, AddRangeProtectionMutation as et, DeleteRangeProtectionMutation as tt, SetRangeProtectionMutation as nt, WorksheetEditPermission as st, WorksheetViewPermission as rt, SetStyleCommand as f, SetRangeValuesCommand as P, SetTextWrapCommand as he, SetVerticalTextAlignCommand as ot, SetHorizontalTextAlignCommand as it, addMergeCellsUtil as $, getAddMergeMutationRangeByType as ce, RemoveWorksheetMergeCommand as at, SplitTextToColumnsCommand as ht, SetWorksheetRangeThemeStyleCommand as ct, DeleteWorksheetRangeThemeStyleCommand as dt, SheetRangeThemeService as Me, getPrimaryForRange as Z, SetSelectionsOperation as De, getNextPrimaryCell as ut, SheetsSelectionsService as We, SetWorksheetDefaultStyleMutation as mt, SetColDataCommand as de, SetRowDataCommand as ue, copyRangeStyles as W, InsertRowByRangeCommand as me, RemoveRowByRangeCommand as lt, MoveRowsCommand as gt, SetRowHiddenCommand as le, SetSpecificRowsVisibleCommand as ge, SetRowHeightCommand as _e, SetWorksheetRowIsAutoHeightCommand as _t, InsertColByRangeCommand as we, RemoveColByRangeCommand as wt, MoveColsCommand as kt, SetColHiddenCommand as ke, SetSpecificColsVisibleCommand as Se, SetColWidthCommand as St, SetFrozenCommand as H, CancelFrozenCommand as Ct, ToggleGridlinesCommand as It, SetGridlinesColorCommand as ft, SetTabColorCommand as vt, SetRangeValuesMutation as Ce, SetWorksheetHideCommand as Rt, SetWorksheetShowCommand as bt, SetWorksheetNameCommand as pt, ClearSelectionAllCommand as yt, ClearSelectionContentCommand as Ut, ClearSelectionFormatCommand as Et, InsertSheetCommand as x, SetWorksheetActiveOperation as G, RemoveSheetCommand as Pt, CopySheetCommand as xt, SetWorksheetOrderCommand as Nt, RegisterWorksheetRangeThemeStyleCommand as Mt, UnregisterWorksheetRangeThemeStyleCommand as Dt } from "@univerjs/sheets";
-import { IDefinedNamesService as Te, serializeRange as re, FormulaDataModel as Wt, serializeRangeWithSheet as Tt, deserializeRangeWithSheet as At } from "@univerjs/engine-formula";
-var Ft = Object.defineProperty, jt = Object.getOwnPropertyDescriptor, Ot = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? jt(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && Ft(e, t, r), r;
-}, S = (s, e) => (t, n) => e(t, n, s);
-function Vt(s, e, t) {
-  const n = t.getDefinedNameMap(s);
+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--)
+    (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
+  return n && s && $t(e, t, s), s;
+}, w = (r, e) => (t, n) => e(t, n, r);
+function Kt(r, e, t) {
+  const n = t.getDefinedNameMap(r);
   if (n == null)
     return e.t("definedName.defaultName") + 1;
-  const o = Array.from(Object.values(n)).length + 1, i = e.t("definedName.defaultName") + o;
-  if (t.getValueByName(s, i) == null)
-    return i;
-  let a = o + 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;
   for (; ; ) {
-    const h = e.t("definedName.defaultName") + a;
-    if (t.getValueByName(s, h) == null)
-      return h;
-    a++;
+    const a = e.t("definedName.defaultName") + h;
+    if (t.getValueByName(r, a) == null)
+      return a;
+    h++;
   }
 }
-class L {
+class V {
   constructor() {
-    k(this, "_definedNameParam");
+    b(this, "_definedNameParam");
     this._definedNameParam = {
-      id: be(10),
+      id: Me(10),
       unitId: "",
       name: "",
       formulaOrRefString: ""
@@ -99,12 +99,12 @@ class L {
    * workbook.insertDefinedNameBuilder(definedNameBuilder);
    * ```
    */
-  setRefByRange(e, t, n, r) {
-    return this._definedNameParam.formulaOrRefString = re({
+  setRefByRange(e, t, n, s) {
+    return this._definedNameParam.formulaOrRefString = ue({
       startRow: e,
       endRow: e + (n != null ? n : 1) - 1,
       startColumn: t,
-      endColumn: t + (r != null ? r : 1) - 1
+      endColumn: t + (s != null ? s : 1) - 1
     }), this;
   }
   /**
@@ -159,12 +159,12 @@ class L {
     return this._definedNameParam = e, this;
   }
 }
-let j = class extends te {
-  constructor(s, e, t, n, r, o, i, a, h, c) {
-    super(), this._definedNameParam = s, this._injector = e, this._commandService = t, this._permissionService = n, this._worksheetProtectionRuleModel = r, this._rangeProtectionRuleModel = o, this._worksheetProtectionPointRuleModel = i, this._authzIoService = a, this._localeService = h, this._definedNamesService = c;
+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;
   }
   _apply() {
-    this._definedNameParam.name === "" && (this._definedNameParam.name = Vt(this._definedNameParam.unitId, this._localeService, this._definedNamesService)), this._commandService.syncExecuteCommand(Q.id, this._definedNameParam);
+    this._definedNameParam.name === "" && (this._definedNameParam.name = Kt(this._definedNameParam.unitId, this._localeService, this._definedNamesService)), this._commandService.syncExecuteCommand(Q.id, this._definedNameParam);
   }
   /**
    * Gets the name of the defined name.
@@ -189,8 +189,8 @@ let j = class extends te {
    * definedName.setName('NewDefinedName');
    * ```
    */
-  setName(s) {
-    this._definedNameParam.name = s, this._apply();
+  setName(r) {
+    this._definedNameParam.name = r, this._apply();
   }
   /**
    * Sets the formula of the defined name.
@@ -202,8 +202,8 @@ let j = class extends te {
    * definedName.setFormula('SUM(Sheet1!$A$1)');
    * ```
    */
-  setFormula(s) {
-    this._definedNameParam.formulaOrRefString = `=${s}`, this._apply();
+  setFormula(r) {
+    this._definedNameParam.formulaOrRefString = `=${r}`, this._apply();
   }
   /**
    * Sets the reference of the defined name.
@@ -215,8 +215,8 @@ let j = class extends te {
    * definedName.setRef('Sheet1!$A$1');
    * ```
    */
-  setRef(s) {
-    this._definedNameParam.formulaOrRefString = s, this._apply();
+  setRef(r) {
+    this._definedNameParam.formulaOrRefString = r, this._apply();
   }
   /**
    * Gets the reference of the defined name.
@@ -244,10 +244,10 @@ let j = class extends te {
    * definedName.setRefByRange(1, 3, 2, 5);
    * ```
    */
-  setRefByRange(s, e, t, n) {
-    this._definedNameParam.formulaOrRefString = re({
-      startRow: s,
-      endRow: s + (t != null ? t : 1) - 1,
+  setRefByRange(r, e, t, n) {
+    this._definedNameParam.formulaOrRefString = ue({
+      startRow: r,
+      endRow: r + (t != null ? t : 1) - 1,
       startColumn: e,
       endColumn: e + (n != null ? n : 1) - 1
     }), this._apply();
@@ -275,8 +275,8 @@ let j = class extends te {
    * definedName.setComment('This is a comment');
    * ```
    */
-  setComment(s) {
-    this._definedNameParam.comment = s, this._apply();
+  setComment(r) {
+    this._definedNameParam.comment = r, this._apply();
   }
   /**
    * Sets the scope of the defined name to the worksheet.
@@ -289,8 +289,8 @@ let j = class extends te {
    * definedName.setScopeToWorksheet(worksheet);
    * ```
    */
-  setScopeToWorksheet(s) {
-    this._definedNameParam.localSheetId = s.getSheetId(), this._apply();
+  setScopeToWorksheet(r) {
+    this._definedNameParam.localSheetId = r.getSheetId(), this._apply();
   }
   /**
    * Sets the scope of the defined name to the workbook.
@@ -314,8 +314,8 @@ let j = class extends te {
    * definedName.setHidden(true);
    * ```
    */
-  setHidden(s) {
-    this._definedNameParam.hidden = s, this._apply();
+  setHidden(r) {
+    this._definedNameParam.hidden = r, this._apply();
   }
   /**
    * Deletes the defined name.
@@ -327,7 +327,7 @@ let j = class extends te {
    * ```
    */
   delete() {
-    this._commandService.syncExecuteCommand(Ke.id, this._definedNameParam);
+    this._commandService.syncExecuteCommand(st.id, this._definedNameParam);
   }
   /**
    * Gets the local sheet id of the defined name.
@@ -368,33 +368,33 @@ let j = class extends te {
    * ```
    */
   toBuilder() {
-    const s = this._injector.createInstance(L);
-    return s.load(this._definedNameParam), s;
+    const r = this._injector.createInstance(V);
+    return r.load(this._definedNameParam), r;
   }
 };
-j = Ot([
-  S(1, u(b)),
-  S(2, l),
-  S(3, ee),
-  S(4, u(Ee)),
-  S(5, u(Pe)),
-  S(6, u(xe)),
-  S(7, u(ve)),
-  S(8, u(Re)),
-  S(9, Te)
-], j);
-var Bt = Object.defineProperty, Lt = Object.getOwnPropertyDescriptor, zt = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? Lt(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && Bt(e, t, r), r;
-}, v = (s, e) => (t, n) => e(t, n, s);
-let O = class extends te {
-  constructor(e, t, n, r, o, i, a) {
+F = qt([
+  w(1, u(y)),
+  w(2, l),
+  w(3, ae),
+  w(4, u(Fe)),
+  w(5, u(je)),
+  w(6, u(Oe)),
+  w(7, u(Ne)),
+  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--)
+    (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
+  return n && s && Yt(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) {
     super();
-    k(this, "permissionPointsDefinition", Ye);
-    k(this, "rangeRuleChangedAfterAuth$");
-    k(this, "sheetRuleChangedAfterAuth$");
-    this._injector = e, this._commandService = t, this._permissionService = n, this._worksheetProtectionRuleModel = r, this._rangeProtectionRuleModel = o, this._worksheetProtectionPointRuleModel = i, this._authzIoService = a, this.rangeRuleChangedAfterAuth$ = this._rangeProtectionRuleModel.ruleRefresh$, this.sheetRuleChangedAfterAuth$ = this._worksheetProtectionRuleModel.ruleRefresh$;
+    b(this, "permissionPointsDefinition", it);
+    b(this, "rangeRuleChangedAfterAuth$");
+    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$;
   }
   /**
    * Configures a specific permission point for a workbook.
@@ -406,8 +406,8 @@ let O = class extends te {
    * @param {boolean} value - The boolean value to determine whether the permission point is enabled or disabled.
    */
   setWorkbookPermissionPoint(e, t, n) {
-    const r = new t(e);
-    this._permissionService.getPermissionPoint(r.id) || this._permissionService.addPermissionPoint(r), this._permissionService.updatePermissionPoint(r.id, n);
+    const s = new t(e);
+    this._permissionService.getPermissionPoint(s.id) || this._permissionService.addPermissionPoint(s), this._permissionService.updatePermissionPoint(s.id, n);
   }
   /**
    * This function is used to set whether the workbook can be edited
@@ -415,7 +415,7 @@ let O = class extends te {
    * @param {boolean} value - A value that controls whether the workbook can be edited
    */
   setWorkbookEditPermission(e, t) {
-    this.setWorkbookPermissionPoint(e, Ne, t);
+    this.setWorkbookPermissionPoint(e, Le, t);
   }
   /**
    * This function is used to add a base permission for a worksheet.
@@ -426,8 +426,8 @@ let O = class extends te {
   async addWorksheetBasePermission(e, t) {
     if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).length > 0)
       throw new Error("sheet protection cannot intersect with range protection");
-    const r = await this._authzIoService.create({
-      objectType: E.Worksheet,
+    const s = await this._authzIoService.create({
+      objectType: x.Worksheet,
       worksheetObject: {
         collaborators: [],
         unitID: e,
@@ -436,17 +436,17 @@ let O = class extends te {
         scope: void 0
       }
     });
-    if (this._commandService.syncExecuteCommand(Je.id, {
+    if (this._commandService.syncExecuteCommand(ot.id, {
       unitId: e,
       subUnitId: t,
       rule: {
-        permissionId: r,
-        unitType: E.Worksheet,
+        permissionId: s,
+        unitType: x.Worksheet,
         unitId: e,
         subUnitId: t
       }
     }))
-      return r;
+      return s;
   }
   /**
    * Delete the entire table protection set for the worksheet and reset the point permissions of the worksheet to true
@@ -454,12 +454,12 @@ let O = class extends te {
    * @param {string} subUnitId - The unique identifier of the worksheet for which the permission is being set.
    */
   removeWorksheetPermission(e, t) {
-    this._commandService.syncExecuteCommand(Qe.id, {
+    this._commandService.syncExecuteCommand(ht.id, {
       unitId: e,
       subUnitId: t
-    }), [...Xe(), ...ae()].forEach((n) => {
-      const r = new n(e, t);
-      this._permissionService.updatePermissionPoint(r.id, !0);
+    }), [...at(), ..._e()].forEach((n) => {
+      const s = new n(e, t);
+      this._permissionService.updatePermissionPoint(s.id, !0);
     }), this._worksheetProtectionPointRuleModel.deleteRule(e, t);
   }
   /**
@@ -472,21 +472,21 @@ let O = class extends te {
    * @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`.
    */
-  async setWorksheetPermissionPoint(e, t, n, r) {
-    const o = this._worksheetProtectionRuleModel.getRule(e, t);
-    let i;
-    if (n === st || n === rt)
-      if (o)
-        i = o.permissionId;
+  async setWorksheetPermissionPoint(e, t, n, s) {
+    const i = this._worksheetProtectionRuleModel.getRule(e, t);
+    let o;
+    if (n === lt || n === mt)
+      if (i)
+        o = i.permissionId;
       else {
         if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).length > 0)
           throw new Error("sheet protection cannot intersect with range protection");
-        i = await this.addWorksheetBasePermission(e, t);
+        o = await this.addWorksheetBasePermission(e, t);
       }
     else {
-      const d = this._worksheetProtectionPointRuleModel.getRule(e, t);
-      d ? i = d.permissionId : (i = await this._authzIoService.create({
-        objectType: E.Worksheet,
+      const c = this._worksheetProtectionPointRuleModel.getRule(e, t);
+      c ? o = c.permissionId : (o = await this._authzIoService.create({
+        objectType: x.Worksheet,
         worksheetObject: {
           collaborators: [],
           unitID: e,
@@ -494,10 +494,10 @@ let O = class extends te {
           name: "",
           scope: void 0
         }
-      }), this._commandService.executeCommand(Ze.id, { unitId: e, subUnitId: t, permissionId: i }));
+      }), this._commandService.syncExecuteCommand(dt.id, { unitId: e, subUnitId: t, permissionId: o }));
     }
-    const h = new n(e, t);
-    return this._permissionService.getPermissionPoint(h.id) || this._permissionService.addPermissionPoint(h), this._permissionService.updatePermissionPoint(h.id, r), i;
+    const a = new n(e, t);
+    return this._permissionService.getPermissionPoint(a.id) || this._permissionService.addPermissionPoint(a), this._permissionService.updatePermissionPoint(a.id, s), o;
   }
   /**
    * Adds a range protection to the worksheet.
@@ -507,34 +507,34 @@ let O = class extends te {
    * @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
    */
   async addRangeBaseProtection(e, t, n) {
-    const r = await this._authzIoService.create({
-      objectType: E.SelectRange,
+    const s = await this._authzIoService.create({
+      objectType: x.SelectRange,
       selectRangeObject: {
         collaborators: [],
         unitID: e,
         name: "",
         scope: void 0
       }
-    }), o = `ruleId_${be(6)}`;
+    }), 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((d) => d.ranges.some((z) => n.some((M) => N.intersects(M, z)))))
+    if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).some((c) => c.ranges.some((v) => n.some((k) => M.intersects(k, v)))))
       throw new Error("range protection cannot intersect");
-    if (this._commandService.syncExecuteCommand(et.id, {
+    if (this._commandService.syncExecuteCommand(ct.id, {
       unitId: e,
       subUnitId: t,
       rules: [{
-        permissionId: r,
-        unitType: E.SelectRange,
+        permissionId: s,
+        unitType: x.SelectRange,
         unitId: e,
         subUnitId: t,
         ranges: n,
-        id: o
+        id: i
       }]
     }))
       return {
-        permissionId: r,
-        ruleId: o
+        permissionId: s,
+        ruleId: i
       };
   }
   /**
@@ -544,13 +544,13 @@ let O = class extends te {
    * @param {string[]} ruleIds - The rule IDs of the range protection to be removed.
    */
   removeRangeProtection(e, t, n) {
-    this._commandService.syncExecuteCommand(tt.id, {
+    this._commandService.syncExecuteCommand(ut.id, {
       unitId: e,
       subUnitId: t,
       ruleIds: n
-    }) && this._rangeProtectionRuleModel.getSubunitRuleList(e, t).length === 0 && (this._worksheetProtectionPointRuleModel.deleteRule(e, t), [...ae()].forEach((i) => {
-      const a = new i(e, t);
-      this._permissionService.updatePermissionPoint(a.id, a.value);
+    }) && 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);
     }));
   }
   /**
@@ -562,9 +562,9 @@ let O = class extends te {
    *    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).
    */
-  setRangeProtectionPermissionPoint(e, t, n, r, o) {
-    const i = new r(e, t, n);
-    this._permissionService.getPermissionPoint(i.id) || this._permissionService.addPermissionPoint(i), this._permissionService.updatePermissionPoint(i.id, o);
+  setRangeProtectionPermissionPoint(e, t, n, s, i) {
+    const o = new s(e, t, n);
+    this._permissionService.getPermissionPoint(o.id) || this._permissionService.addPermissionPoint(o), this._permissionService.updatePermissionPoint(o.id, i);
   }
   /**
    * Sets the ranges for range protection in a worksheet.
@@ -577,228 +577,328 @@ let O = class extends te {
    * @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.
    */
-  setRangeProtectionRanges(e, t, n, r) {
-    const o = this._rangeProtectionRuleModel.getRule(e, t, n);
-    if (o) {
-      if (this._rangeProtectionRuleModel.getSubunitRuleList(e, t).filter((h) => h.id !== n).some((h) => h.ranges.some((c) => r.some((d) => N.intersects(d, c)))))
+  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)))))
         throw new Error("range protection cannot intersect");
-      this._commandService.syncExecuteCommand(nt.id, {
+      this._commandService.syncExecuteCommand(gt.id, {
         unitId: e,
         subUnitId: t,
         ruleId: n,
         rule: {
-          ...o,
-          ranges: r
+          ...i,
+          ranges: s
         }
       });
     }
   }
 };
-O = zt([
-  v(0, u(b)),
-  v(1, l),
-  v(2, ee),
-  v(3, u(Ee)),
-  v(4, u(Pe)),
-  v(5, u(xe)),
-  v(6, u(ve))
-], O);
-function $t(s) {
-  switch (s) {
+j = Qt([
+  R(0, u(y)),
+  R(1, l),
+  R(2, ae),
+  R(3, u(Fe)),
+  R(4, u(je)),
+  R(5, u(Oe)),
+  R(6, u(Ne))
+], j);
+function Xt(r) {
+  switch (r) {
     case "left":
-      return y.LEFT;
+      return U.LEFT;
     case "center":
-      return y.CENTER;
+      return U.CENTER;
     case "normal":
-      return y.RIGHT;
+      return U.RIGHT;
     default:
-      throw new Error(`Invalid horizontal alignment: ${s}`);
+      throw new Error(`Invalid horizontal alignment: ${r}`);
   }
 }
-function Ht(s) {
-  switch (s) {
-    case y.LEFT:
+function Zt(r) {
+  switch (r) {
+    case U.LEFT:
       return "left";
-    case y.CENTER:
+    case U.CENTER:
       return "center";
-    case y.RIGHT:
+    case U.RIGHT:
       return "normal";
     default:
-      throw new Error(`Invalid horizontal alignment: ${s}`);
+      throw new Error(`Invalid horizontal alignment: ${r}`);
   }
 }
-function Gt(s) {
-  switch (s) {
+function en(r) {
+  switch (r) {
     case "top":
-      return U.TOP;
+      return P.TOP;
     case "middle":
-      return U.MIDDLE;
+      return P.MIDDLE;
     case "bottom":
-      return U.BOTTOM;
+      return P.BOTTOM;
     default:
-      throw new Error(`Invalid vertical alignment: ${s}`);
+      throw new Error(`Invalid vertical alignment: ${r}`);
   }
 }
-function qt(s) {
-  switch (s) {
-    case U.TOP:
+function tn(r) {
+  switch (r) {
+    case P.TOP:
       return "top";
-    case U.MIDDLE:
+    case P.MIDDLE:
       return "middle";
-    case U.BOTTOM:
+    case P.BOTTOM:
       return "bottom";
     default:
-      throw new Error(`Invalid vertical alignment: ${s}`);
+      throw new Error(`Invalid vertical alignment: ${r}`);
   }
 }
-function V(s) {
-  return je(s) ? {
-    f: s
-  } : Oe(s) ? {
-    v: s
-  } : (Ve(s), s);
+function O(r) {
+  return Ke(r) ? {
+    f: r,
+    v: null,
+    p: null
+  } : Ye(r) ? {
+    v: r,
+    p: null,
+    f: null
+  } : (Je(r), r);
 }
-function Ie(s, e) {
-  const t = new A(), { startRow: n, startColumn: r, endRow: o, endColumn: i } = e;
-  if (Be.isArray(s))
-    for (let a = 0; a <= o - n; a++)
-      for (let h = 0; h <= i - r; h++)
-        t.setValue(a + n, h + r, V(s[a][h]));
+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]));
   else
-    new A(s).forValue((h, c, d) => {
-      t.setValue(h, c, V(d));
+    new W(r).forValue((a, d, c) => {
+      t.setValue(a, d, O(c));
     });
   return t.getMatrix();
 }
-function q(s, e) {
+function G(r, e) {
   return {
-    startRow: s.startRow,
-    endRow: s.endRow,
+    startRow: r.startRow,
+    endRow: r.endRow,
     startColumn: 0,
     endColumn: e.getColumnCount() - 1,
     rangeType: _.ROW
   };
 }
-function K(s, e) {
+function q(r, e) {
   return {
     startRow: 0,
     endRow: e.getRowCount() - 1,
-    startColumn: s.startColumn,
-    endColumn: s.endColumn,
+    startColumn: r.startColumn,
+    endColumn: r.endColumn,
     rangeType: _.COLUMN
   };
 }
-var Kt = Object.defineProperty, Yt = Object.getOwnPropertyDescriptor, Jt = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? Yt(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && Kt(e, t, r), r;
-}, Y = (s, e) => (t, n) => e(t, n, s);
-let w = class extends ne {
-  constructor(s, e, t, n, r, o) {
-    super(n), this._workbook = s, this._worksheet = e, this._range = t, this._injector = n, this._commandService = r, this._formulaDataModel = o;
+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--)
+    (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
+  return n && s && nn(e, t, s), s;
+}, K = (r, e) => (t, n) => e(t, n, r);
+let S = 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;
   }
   /**
    * Get the unit ID of the current workbook
-   * @returns The unit ID of the workbook
+   * @returns {string} The unit ID of the workbook
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getUnitId()
+   * ```
    */
   getUnitId() {
     return this._workbook.getUnitId();
   }
   /**
    * Gets the name of the worksheet
-   * @returns The name of the worksheet
+   * @returns {string} The name of the worksheet
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getSheetName()
+   * ```
    */
   getSheetName() {
     return this._worksheet.getName();
   }
   /**
    * Gets the ID of the worksheet
-   * @returns The ID of the worksheet
+   * @returns {string} The ID of the worksheet
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getSheetId()
+   * ```
    */
   getSheetId() {
     return this._worksheet.getSheetId();
   }
   /**
    * Gets the area where the statement is applied
-   * @returns The area where the statement is applied
+   * @returns {IRange} The area where the statement is applied
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getRange()
+   * ```
    */
   getRange() {
     return this._range;
   }
   /**
    * Gets the starting row number of the applied area
-   * @returns The starting row number of the area
+   * @returns {number} The starting row number of the area
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getRow()
+   * ```
    */
   getRow() {
     return this._range.startRow;
   }
   /**
    * Gets the starting column number of the applied area
-   * @returns The starting column number of the area
+   * @returns {number} The starting column number of the area
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getColumn()
+   * ```
    */
   getColumn() {
     return this._range.startColumn;
   }
   /**
    * Gets the width of the applied area
-   * @returns The width of the area
+   * @returns {number} The width of the area
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getWidth()
+   * ```
    */
   getWidth() {
     return this._range.endColumn - this._range.startColumn + 1;
   }
   /**
    * Gets the height of the applied area
-   * @returns The height of the area
+   * @returns {number} The height of the area
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getHeight()
+   * ```
    */
   getHeight() {
     return this._range.endRow - this._range.startRow + 1;
   }
   /**
    * Return range whether this range is merged
-   * @returns if true is merged
+   * @returns {boolean} if true is merged
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .isMerged()
+   * ```
    */
   isMerged() {
-    const { startColumn: s, startRow: e, endColumn: t, endRow: n } = this._range;
-    return this._worksheet.getMergedCellRange(e, s, n, t).some((o) => N.equals(o, this._range));
+    const { startColumn: r, startRow: e, endColumn: t, endRow: n } = this._range;
+    return this._worksheet.getMergedCellRange(e, r, n, t).some((i) => M.equals(i, this._range));
   }
   /**
    * Return first cell style data in this range
    * @returns {IStyleData | null} The cell style data
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getCellStyleData()
+   * ```
    */
   getCellStyleData() {
     var t;
-    const s = this.getCellData(), e = this._workbook.getStyles();
-    return s && e && (t = e.getStyleByCell(s)) != null ? t : null;
+    const r = this.getCellData(), e = this._workbook.getStyles();
+    return r && e && (t = e.getStyleByCell(r)) != null ? t : null;
   }
   /**
-   * Returns the value of the cell at the start of this range.
-   * @returns {CellValue | null} The value of the cell.
+   * Return first cell style in this range
+   * @returns {TextStyleValue | null} The cell style
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getCellStyle()
+   * ```
    */
-  getValue() {
-    var s, e;
-    return (e = (s = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) == null ? void 0 : s.v) != null ? e : null;
+  getCellStyle() {
+    const r = this.getCellStyleData();
+    return r ? le.create(r) : null;
   }
   /**
-   * Returns the rectangular grid of values for this range.
-   * Returns a two-dimensional array of values, indexed by row, then by column.
-   * @returns {Nullable<CellValue>[][]} A two-dimensional array of values.
+   * Returns the cell styles for the cells in the range.
+   * @returns {Array<Array<TextStyleValue | null>>} A two-dimensional array of cell styles.
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getCellStyles()
+   * ```
    */
-  getValues() {
-    var o, i;
-    const { startRow: s, endRow: e, startColumn: t, endColumn: n } = this._range, r = [];
-    for (let a = s; a <= e; a++) {
-      const h = [];
-      for (let c = t; c <= n; c++)
-        h.push((i = (o = this._worksheet.getCell(a, c)) == null ? void 0 : o.v) != null ? i : null);
-      r.push(h);
+  getCellStyles() {
+    const r = this.getCellDatas(), e = this._workbook.getStyles();
+    return r.map((t) => t.map((n) => {
+      if (!n) return null;
+      const s = e.getStyleByCell(n);
+      return s ? le.create(s) : null;
+    }));
+  }
+  getValue(r) {
+    var e, t;
+    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;
+    r && this.getValueAndRichTextValues();
+    const { startRow: e, endRow: t, startColumn: n, endColumn: s } = this._range, i = [];
+    for (let a = e; a <= t; a++) {
+      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);
+      i.push(d);
     }
-    return r;
+    return i;
   }
   /**
    * Return first cell model data in this range
    * @returns {ICellData | null} The cell model data
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
@@ -806,14 +906,14 @@ let w = class extends ne {
    * ```
    */
   getCellData() {
-    var s;
-    return (s = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) != null ? s : null;
+    var r;
+    return (r = this._worksheet.getCell(this._range.startRow, this._range.startColumn)) != null ? r : null;
   }
   /**
-   * Returns the cell data for the cells in the range.
+   * Alias for getCellDataGrid.
    * @returns {Nullable<ICellData>[][]} A two-dimensional array of cell data.
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
@@ -821,26 +921,36 @@ let w = class extends ne {
    * ```
    */
   getCellDatas() {
-    const { startRow: s, endRow: e, startColumn: t, endColumn: n } = this._range, r = [];
-    for (let o = s; o <= e; o++) {
-      const i = [];
-      for (let a = t; a <= n; a++)
-        i.push(this._worksheet.getCellRaw(o, a));
-      r.push(i);
-    }
-    return r;
+    return this.getCellDataGrid();
   }
   /**
-   * @deprecated use `getCellDatas` instead.
+   * Returns the cell data for the cells in the range.
+   * @returns {Nullable<ICellData>[][]} A two-dimensional array of cell data.
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getCellDataGrid()
+   * ```
    */
   getCellDataGrid() {
-    return this.getCellDatas();
+    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));
+      s.push(o);
+    }
+    return s;
   }
   /**
    * Returns the rich text value for the cell at the start of this range.
    * @returns {Nullable<RichTextValue>} The rich text value
+   * @internal
+   * @beta
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
@@ -848,14 +958,16 @@ let w = class extends ne {
    * ```
    */
   getRichTextValue() {
-    const s = this.getCellData();
-    return s != null && s.p ? new p(s.p) : null;
+    const r = this.getCellData();
+    return r != null && r.p ? new E(r.p) : null;
   }
   /**
    * Returns the rich text value for the cells in the range.
    * @returns {Nullable<RichTextValue>[][]} A two-dimensional array of RichTextValue objects.
+   * @internal
+   * @beta
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
@@ -863,13 +975,15 @@ let w = class extends ne {
    * ```
    */
   getRichTextValues() {
-    return this.getCellDataGrid().map((e) => e.map((t) => t != null && t.p ? new p(t.p) : null));
+    return this.getCellDataGrid().map((e) => e.map((t) => t != null && t.p ? new E(t.p) : null));
   }
   /**
    * Returns the value and rich text value for the cell at the start of this range.
    * @returns {Nullable<CellValue | RichTextValue>} The value and rich text value
+   * @internal
+   * @beta
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
@@ -877,14 +991,14 @@ let w = class extends ne {
    * ```
    */
   getValueAndRichTextValue() {
-    const s = this.getCellData();
-    return s != null && s.p ? new p(s.p) : s == null ? void 0 : s.v;
+    const r = this.getCellData();
+    return r != null && r.p ? new E(r.p) : r == null ? void 0 : r.v;
   }
   /**
    * Returns the value and rich text value for the cells in the range.
    * @returns {Nullable<CellValue | RichTextValue>[][]} A two-dimensional array of value and rich text value
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
@@ -892,7 +1006,7 @@ let w = class extends ne {
    * ```
    */
   getValueAndRichTextValues() {
-    return this.getCellDatas().map((e) => e.map((t) => t != null && t.p ? new p(t.p) : t == null ? void 0 : t.v));
+    return this.getCellDatas().map((e) => e.map((t) => t != null && t.p ? new E(t.p) : t == null ? void 0 : t.v));
   }
   /**
    * Returns the formulas (A1 notation) for the cells in the range. Entries in the 2D array are empty strings for cells with no formula.
@@ -906,28 +1020,72 @@ let w = class extends ne {
    * ```
    */
   getFormulas() {
-    const s = [], { startRow: e, endRow: t, startColumn: n, endColumn: r } = this._range, o = this._worksheet.getSheetId(), i = this._workbook.getUnitId();
-    for (let a = e; a <= t; a++) {
-      const h = [];
-      for (let c = n; c <= r; c++) {
-        const d = this._formulaDataModel.getFormulaStringByCell(a, c, o, i);
-        h.push(d || "");
+    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 d = n; d <= s; d++) {
+        const c = this._formulaDataModel.getFormulaStringByCell(h, d, i, o);
+        a.push(c || "");
       }
-      s.push(h);
+      r.push(a);
     }
-    return s;
+    return r;
   }
+  /**
+   * Returns true if the cell wrap is enabled
+   * @returns {boolean} True if the cell wrap is enabled
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getWrap()
+   * ```
+   */
   getWrap() {
-    return this._worksheet.getRange(this._range).getWrap() === m.TRUE;
+    return this._worksheet.getRange(this._range).getWrap() === g.TRUE;
   }
+  /**
+   * Returns the text wrapping strategy for the top left cell of the range.
+   * @returns {WrapStrategy} The text wrapping strategy
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getWrapStrategy()
+   * ```
+   */
   getWrapStrategy() {
     return this._worksheet.getRange(this._range).getWrapStrategy();
   }
+  /**
+   * Returns the horizontal alignment for the top left cell of the range.
+   * @returns {string} The horizontal alignment
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getHorizontalAlignment()
+   * ```
+   */
   getHorizontalAlignment() {
-    return Ht(this._worksheet.getRange(this._range).getHorizontalAlignment());
+    return Zt(this._worksheet.getRange(this._range).getHorizontalAlignment());
   }
+  /**
+   * Returns the vertical alignment for the top left cell of the range.
+   * @returns {string} The vertical alignment
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .getVerticalAlignment()
+   * ```
+   */
   getVerticalAlignment() {
-    return qt(this._worksheet.getRange(this._range).getVerticalAlignment());
+    return tn(this._worksheet.getRange(this._range).getVerticalAlignment());
   }
   /**
    * Set custom meta data for first cell in current range.
@@ -940,9 +1098,9 @@ let w = class extends ne {
    *  .setCustomMetaData({ key: 'value' });
    * ```
    */
-  setCustomMetaData(s) {
+  setCustomMetaData(r) {
     return this.setValue({
-      custom: s
+      custom: r
     });
   }
   /**
@@ -956,8 +1114,8 @@ let w = class extends ne {
    *  .setCustomMetaDatas([[{ key: 'value' }]]);
    * ```
    */
-  setCustomMetaDatas(s) {
-    return this.setValues(s.map((e) => e.map((t) => ({ custom: t }))));
+  setCustomMetaDatas(r) {
+    return this.setValues(r.map((e) => e.map((t) => ({ custom: t }))));
   }
   /**
    * Returns the custom meta data for the cell at the start of this range.
@@ -972,8 +1130,8 @@ let w = class extends ne {
    */
   getCustomMetaData() {
     var e;
-    const s = this.getCellData();
-    return (e = s == null ? void 0 : s.custom) != null ? e : null;
+    const r = this.getCellData();
+    return (e = r == null ? void 0 : r.custom) != null ? e : null;
   }
   /**
    * Returns the custom meta data for the cells in the range.
@@ -992,51 +1150,85 @@ let w = class extends ne {
       return (n = t == null ? void 0 : t.custom) != null ? n : null;
     }));
   }
+  /**
+   * Sets basic border properties for the current range.
+   * @param {BorderType} type The type of border to apply
+   * @param {BorderStyleTypes} style The border style
+   * @param {string} [color] Optional border color in CSS notation
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setBorder(BorderType.ALL, BorderStyleType.THIN, '#ff0000');
+   * ```
+   */
+  setBorder(r, e, t) {
+    return this._commandService.syncExecuteCommand(_t.id, {
+      unitId: this._workbook.getUnitId(),
+      subUnitId: this._worksheet.getSheetId(),
+      value: {
+        type: r,
+        style: e,
+        color: t
+      }
+    }), this;
+  }
   // #region editing
   /**
    * Set background color for current range.
-   * @param color {string}
+   * @param {string} color The background color
+   * @returns {FRange} This range, for chaining
    * @example
-   * ```
+   * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
    *  .getActiveRange()
    *  .setBackgroundColor('red')
    * ```
    */
-  setBackgroundColor(s) {
-    return this._commandService.syncExecuteCommand(f.id, {
+  setBackgroundColor(r) {
+    return this._commandService.syncExecuteCommand(I.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       style: {
         type: "bg",
         value: {
-          rgb: s
+          rgb: r
         }
       }
     }), this;
   }
   /**
    * Set background color for current range.
+   * @param {string} color The background color
+   * @returns {FRange} This range, for chaining
    * @example
    * ```typescript
    * univerAPI.getActiveWorkbook().getActiveSheet().getActiveRange().setBackground('red')
    * ```
-   * @param color {string}
    */
-  setBackground(s) {
-    return this.setBackgroundColor(s), this;
+  setBackground(r) {
+    return this.setBackgroundColor(r), this;
   }
   /**
    * Set new value for current cell, first cell in this range.
    * @param {CellValue | ICellData} value The value can be a number, string, boolean, or standard cell format. If it begins with `=`, it is interpreted as a formula. The value is tiled to all cells in the range.
+   * @returns {FRange} This range, for chaining
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setValue(1);
+   * ```
    */
-  setValue(s) {
-    const e = V(s);
+  setValue(r) {
+    const e = O(r);
     if (!e)
       throw new Error("Invalid value");
-    return this._commandService.syncExecuteCommand(P.id, {
+    return this._commandService.syncExecuteCommand(N.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
@@ -1046,6 +1238,7 @@ let w = class extends ne {
   /**
    * Set new value for current cell, first cell in this range.
    * @param {CellValue | ICellData} value  The value can be a number, string, boolean, or standard cell format. If it begins with `=`, it is interpreted as a formula. The value is tiled to all cells in the range.
+   * @returns {FRange} This range, for chaining
    * ```ts
    * univerAPI.getActiveWorkbook()
    *  .getActiveSheet()
@@ -1053,11 +1246,11 @@ let w = class extends ne {
    *  .setValueForCell(1);
    * ```
    */
-  setValueForCell(s) {
-    const e = V(s);
+  setValueForCell(r) {
+    const e = O(r);
     if (!e)
       throw new Error("Invalid value");
-    return this._commandService.syncExecuteCommand(P.id, {
+    return this._commandService.syncExecuteCommand(N.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: {
@@ -1081,8 +1274,8 @@ let w = class extends ne {
    *  .setRichTextValueForCell(new RichTextValue().insertText('Hello'));
    * ```
    */
-  setRichTextValueForCell(s) {
-    const e = s instanceof p ? s.getData() : s, t = {
+  setRichTextValueForCell(r) {
+    const e = r instanceof E ? r.getData() : r, t = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: {
@@ -1093,7 +1286,7 @@ let w = class extends ne {
       },
       value: { p: e }
     };
-    return this._commandService.syncExecuteCommand(P.id, t), this;
+    return this._commandService.syncExecuteCommand(N.id, t), this;
   }
   /**
    * Set the rich text value for the cells in the range.
@@ -1108,71 +1301,111 @@ let w = class extends ne {
    *  .setRichTextValues([[new RichTextValue().insertText('Hello')]]);
    * ```
    */
-  setRichTextValues(s) {
-    const e = s.map((r) => r.map((o) => o && { p: o instanceof p ? o.getData() : o })), t = Ie(e, this._range), n = {
+  setRichTextValues(r) {
+    const e = r.map((s) => s.map((i) => i && { p: i instanceof E ? i.getData() : i })), t = Pe(e, this._range), n = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       value: t
     };
-    return this._commandService.syncExecuteCommand(P.id, n), this;
+    return this._commandService.syncExecuteCommand(N.id, n), this;
   }
   /**
    * Set the cell wrap of the given range.
    * Cells with wrap enabled (the default) resize to display their full content. Cells with wrap disabled display as much as possible in the cell without resizing or running to multiple lines.
-   * @param isWrapEnabled
+   * @param {boolean} isWrapEnabled Whether to enable wrap
+   * @returns {FRange} this range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setWrap(true);
+   * ```
    */
-  setWrap(s) {
-    return this._commandService.syncExecuteCommand(he.id, {
+  setWrap(r) {
+    return this._commandService.syncExecuteCommand(Z.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      value: s ? oe.WRAP : oe.UNSPECIFIED
+      value: r ? Y.WRAP : Y.UNSPECIFIED
     }), this;
   }
   /**
    * Sets the text wrapping strategy for the cells in the range.
-   * @param strategy
+   * @param {WrapStrategy} strategy The text wrapping strategy
+   * @returns {FRange} this range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setWrapStrategy(WrapStrategy.WRAP);
+   * ```
    */
-  setWrapStrategy(s) {
-    return this._commandService.syncExecuteCommand(he.id, {
+  setWrapStrategy(r) {
+    return this._commandService.syncExecuteCommand(Z.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      value: s
+      value: r
     }), this;
   }
   /**
    * Set the vertical (top to bottom) alignment for the given range (top/middle/bottom).
-   * @param alignment
+   * @param {"top" | "middle" | "bottom"} alignment The vertical alignment
+   * @returns {FRange} this range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setVerticalAlignment('top');
+   * ```
    */
-  setVerticalAlignment(s) {
-    return this._commandService.syncExecuteCommand(ot.id, {
+  setVerticalAlignment(r) {
+    return this._commandService.syncExecuteCommand(kt.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      value: Gt(s)
+      value: en(r)
     }), this;
   }
   /**
    * Set the horizontal (left to right) alignment for the given range (left/center/right).
-   * @param alignment
+   * @param {"left" | "center" | "normal"} alignment The horizontal alignment
+   * @returns {FRange} this range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setHorizontalAlignment('left');
+   * ```
    */
-  setHorizontalAlignment(s) {
-    return this._commandService.syncExecuteCommand(it.id, {
+  setHorizontalAlignment(r) {
+    return this._commandService.syncExecuteCommand(St.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      value: $t(s)
+      value: Xt(r)
     }), this;
   }
   /**
    * Sets a different value for each cell in the range. The value can be a two-dimensional array or a standard range matrix (must match the dimensions of this range), consisting of numbers, strings, Boolean values or Composed of standard cell formats. If a value begins with `=`, it is interpreted as a formula.
-   * @param value
+   * @param {CellValue[][] | IObjectMatrixPrimitiveType<CellValue> | ICellData[][] | IObjectMatrixPrimitiveType<ICellData>} value The value can be a two-dimensional array or a standard range matrix (must match the dimensions of this range), consisting of numbers, strings, Boolean values or Composed of standard cell formats.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setValues([[1, 2], [3, 4]]);
+   * ```
    */
-  setValues(s) {
-    const e = Ie(s, this._range);
-    return this._commandService.syncExecuteCommand(P.id, {
+  setValues(r) {
+    const e = Pe(r, this._range);
+    return this._commandService.syncExecuteCommand(N.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
@@ -1181,15 +1414,23 @@ let w = class extends ne {
   }
   /**
    * Sets the font weight for the given range (normal/bold),
-   * @param fontWeight The font weight, either 'normal' or 'bold'; a null value resets the font weight.
+   * @param {FontWeight|null} fontWeight The font weight, either 'normal' or 'bold'; a null value resets the font weight.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontWeight('bold');
+   * ```
    */
-  setFontWeight(s) {
+  setFontWeight(r) {
     let e;
-    if (s === "bold")
-      e = m.TRUE;
-    else if (s === "normal")
-      e = m.FALSE;
-    else if (s === null)
+    if (r === "bold")
+      e = g.TRUE;
+    else if (r === "normal")
+      e = g.FALSE;
+    else if (r === null)
       e = null;
     else
       throw new Error("Invalid fontWeight");
@@ -1202,19 +1443,27 @@ let w = class extends ne {
       range: this._range,
       style: t
     };
-    return this._commandService.executeCommand(f.id, n), this;
+    return this._commandService.syncExecuteCommand(I.id, n), this;
   }
   /**
    * Sets the font style for the given range ('italic' or 'normal').
-   * @param fontStyle The font style, either 'italic' or 'normal'; a null value resets the font style.
+   * @param {FontStyle|null} fontStyle The font style, either 'italic' or 'normal'; a null value resets the font style.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontStyle('italic');
+   * ```
    */
-  setFontStyle(s) {
+  setFontStyle(r) {
     let e;
-    if (s === "italic")
-      e = m.TRUE;
-    else if (s === "normal")
-      e = m.FALSE;
-    else if (s === null)
+    if (r === "italic")
+      e = g.TRUE;
+    else if (r === "normal")
+      e = g.FALSE;
+    else if (r === null)
       e = null;
     else
       throw new Error("Invalid fontStyle");
@@ -1227,28 +1476,36 @@ let w = class extends ne {
       range: this._range,
       style: t
     };
-    return this._commandService.executeCommand(f.id, n), this;
+    return this._commandService.syncExecuteCommand(I.id, n), this;
   }
   /**
    * Sets the font line style of the given range ('underline', 'line-through', or 'none').
-   * @param fontLine The font line style, either 'underline', 'line-through', or 'none'; a null value resets the font line style.
+   * @param {FontLine|null} fontLine The font line style, either 'underline', 'line-through', or 'none'; a null value resets the font line style.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontLine('underline');
+   * ```
    */
-  setFontLine(s) {
-    if (s === "underline")
+  setFontLine(r) {
+    if (r === "underline")
       this._setFontUnderline({
-        s: m.TRUE
+        s: g.TRUE
       });
-    else if (s === "line-through")
+    else if (r === "line-through")
       this._setFontStrikethrough({
-        s: m.TRUE
+        s: g.TRUE
       });
-    else if (s === "none")
+    else if (r === "none")
       this._setFontUnderline({
-        s: m.FALSE
+        s: g.FALSE
       }), this._setFontStrikethrough({
-        s: m.FALSE
+        s: g.FALSE
       });
-    else if (s === null)
+    else if (r === null)
       this._setFontUnderline(null), this._setFontStrikethrough(null);
     else
       throw new Error("Invalid fontLine");
@@ -1256,90 +1513,123 @@ let w = class extends ne {
   }
   /**
    * Sets the font underline style of the given ITextDecoration
-   * @param value
+   * @param {ITextDecoration|null} value The font underline style of the given ITextDecoration; a null value resets the font underline style
+   * @returns {void}
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontLine('underline');
+   * ```
    */
-  _setFontUnderline(s) {
+  _setFontUnderline(r) {
     const e = {
       type: "ul",
-      value: s
+      value: r
     }, t = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       style: e
     };
-    this._commandService.executeCommand(f.id, t);
+    this._commandService.syncExecuteCommand(I.id, t);
   }
   /**
    * Sets the font strikethrough style of the given ITextDecoration
-   * @param value
+   * @param {ITextDecoration|null} value The font strikethrough style of the given ITextDecoration; a null value resets the font strikethrough style
+   * @returns {void}
    */
-  _setFontStrikethrough(s) {
+  _setFontStrikethrough(r) {
     const e = {
       type: "st",
-      value: s
+      value: r
     }, t = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       style: e
     };
-    this._commandService.executeCommand(f.id, t);
+    this._commandService.syncExecuteCommand(I.id, t);
   }
   /**
    * Sets the font family, such as "Arial" or "Helvetica".
-   * @param fontFamily The font family to set; a null value resets the font family.
+   * @param {string|null} fontFamily The font family to set; a null value resets the font family.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontFamily('Arial');
+   * ```
    */
-  setFontFamily(s) {
+  setFontFamily(r) {
     const e = {
       type: "ff",
-      value: s
+      value: r
     }, t = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       style: e
     };
-    return this._commandService.executeCommand(f.id, t), this;
+    return this._commandService.syncExecuteCommand(I.id, t), this;
   }
   /**
    * Sets the font size, with the size being the point size to use.
-   * @param size A font size in point size. A null value resets the font size.
+   * @param {number|null} size A font size in point size. A null value resets the font size.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontSize(12);
+   * ```
    */
-  setFontSize(s) {
+  setFontSize(r) {
     const e = {
       type: "fs",
-      value: s
+      value: r
     }, t = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       style: e
     };
-    return this._commandService.executeCommand(f.id, t), this;
+    return this._commandService.syncExecuteCommand(I.id, t), this;
   }
   /**
    * Sets the font color in CSS notation (such as '#ffffff' or 'white').
-   * @param color The font color in CSS notation (such as '#ffffff' or 'white'); a null value resets the color.
+   * @param {string|null} color The font color in CSS notation (such as '#ffffff' or 'white'); a null value resets the color.
+   * @returns {FRange} This range, for chaining
+   * @example
+   * ```ts
+   * univerAPI.getActiveWorkbook()
+   *  .getActiveSheet()
+   *  .getActiveRange()
+   *  .setFontColor('#ff0000');
+   * ```
    */
-  setFontColor(s) {
+  setFontColor(r) {
     const t = {
       type: "cl",
-      value: s === null ? null : { rgb: s }
+      value: r === null ? null : { rgb: r }
     }, n = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       style: t
     };
-    return this._commandService.executeCommand(f.id, n), this;
+    return this._commandService.syncExecuteCommand(I.id, n), this;
   }
   // #endregion editing
   //#region Merge cell
   /**
    * Merge cells in a range into one merged cell
-   * @param [defaultMerge] - If true, only the value in the upper left cell is retained.
-   * @returns This range, for chaining
+   * @param {boolean} [defaultMerge] - If true, only the value in the upper left cell is retained.
+   * @returns {FRange} This range, for chaining
    * @example
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
@@ -1350,14 +1640,14 @@ let w = class extends ne {
    * console.log('debugger', isMerged);
    * ```
    */
-  merge(s = !0) {
+  merge(r = !0) {
     const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId();
-    return $(this._injector, e, t, [this._range], s), this;
+    return H(this._injector, e, t, [this._range], r), this;
   }
   /**
    * Merges cells in a range horizontally.
-   * @param [defaultMerge] - If true, only the value in the upper left cell is retained.
-   * @returns This range, for chaining
+   * @param {boolean} [defaultMerge] - If true, only the value in the upper left cell is retained.
+   * @returns {FRange} This range, for chaining
    * @example
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
@@ -1368,14 +1658,14 @@ let w = class extends ne {
    * console.log(allMerge.length); // There will be two merged cells.
    * ```
    */
-  mergeAcross(s = !0) {
-    const e = ce([this._range], ie.ROWS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
-    return $(this._injector, t, n, e, s), this;
+  mergeAcross(r = !0) {
+    const e = ke([this._range], me.ROWS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
+    return H(this._injector, t, n, e, r), this;
   }
   /**
    * Merges cells in a range vertically.
-   * @param [defaultMerge] - If true, only the value in the upper left cell is retained.
-   * @returns This range, for chaining
+   * @param {boolean} [defaultMerge] - If true, only the value in the upper left cell is retained.
+   * @returns {FRange} This range, for chaining
    * @example
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
@@ -1386,9 +1676,9 @@ let w = class extends ne {
    * console.log(allMerge.length); // There will be two merged cells.
    * ```
    */
-  mergeVertically(s = !0) {
-    const e = ce([this._range], ie.COLUMNS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
-    return $(this._injector, t, n, e, s), this;
+  mergeVertically(r = !0) {
+    const e = ke([this._range], me.COLUMNS), t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
+    return H(this._injector, t, n, e, r), this;
   }
   /**
    * Returns true if cells in the current range overlap a merged cell.
@@ -1405,12 +1695,12 @@ let w = class extends ne {
    * ```
    */
   isPartOfMerge() {
-    const { startRow: s, startColumn: e, endRow: t, endColumn: n } = this._range;
-    return this._worksheet.getMergedCellRange(s, e, t, n).length > 0;
+    const { startRow: r, startColumn: e, endRow: t, endColumn: n } = this._range;
+    return this._worksheet.getMergedCellRange(r, e, t, n).length > 0;
   }
   /**
    * Break all horizontally- or vertically-merged cells contained within the range list into individual cells again.
-   * @returns This range, for chaining
+   * @returns {FRange} This range, for chaining
    * @example
    * ```ts
    * const workbook = univerAPI.getActiveWorkbook();
@@ -1426,12 +1716,12 @@ let w = class extends ne {
    * ```
    */
   breakApart() {
-    return this._commandService.executeCommand(at.id, { ranges: [this._range] }), this;
+    return this._commandService.syncExecuteCommand(wt.id, { ranges: [this._range] }), this;
   }
   //#endregion
   /**
    * Iterate cells in this range. Merged cells will be respected.
-   * @param callback the callback function to be called for each cell in the range
+   * @param {Function} callback the callback function to be called for each cell in the range
    * @param {number} callback.row the row number of the cell
    * @param {number} callback.col the column number of the cell
    * @param {ICellData} callback.cell the cell data
@@ -1444,15 +1734,15 @@ let w = class extends ne {
    * });
    * ```
    */
-  forEach(s) {
-    const { startColumn: e, startRow: t, endColumn: n, endRow: r } = this._range;
-    this._worksheet.getMatrixWithMergedCells(t, e, r, n).forValue((o, i, a) => {
-      s(o, i, a);
+  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);
     });
   }
   /**
    * Returns a string description of the range, in A1 notation.
-   * @param withSheet
+   * @param {boolean} [withSheet] - If true, the sheet name is included in the A1 notation.
    * @returns {string} The A1 notation of the range.
    * ```ts
    * const fWorkbook = univerAPI.getActiveWorkbook();
@@ -1461,8 +1751,8 @@ let w = class extends ne {
    * console.log(fRange.getA1Notation()); // A1:B2
    * ```
    */
-  getA1Notation(s) {
-    return s ? Tt(this._worksheet.getName(), this._range) : re(this._range);
+  getA1Notation(r) {
+    return r ? Ht(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.
@@ -1476,7 +1766,7 @@ let w = class extends ne {
    * ```
    */
   activate() {
-    return this._injector.createInstance(I, this._workbook).setActiveRange(this), this;
+    return this._injector.createInstance(f, this._workbook).setActiveRange(this), this;
   }
   /**
    * Sets the specified cell as the current cell.
@@ -1486,8 +1776,8 @@ let w = class extends ne {
    * @description If the range is not a single cell, an error will be thrown.
    */
   activateAsCurrentCell() {
-    const s = this._worksheet.getMergedCell(this._range.startRow, this._range.startColumn);
-    if (s && N.equals(s, this._range) || !s && this._range.startRow === this._range.endRow && this._range.startColumn === this._range.endColumn)
+    const r = this._worksheet.getMergedCell(this._range.startRow, this._range.startColumn);
+    if (r && M.equals(r, this._range) || !r && this._range.startRow === this._range.endRow && this._range.startColumn === this._range.endColumn)
       return this.activate();
     throw new Error("The range is not a single cell");
   }
@@ -1523,14 +1813,14 @@ let w = class extends ne {
    * //  1 | 2 | 3
    * //  4 | 5 | 6
    */
-  splitTextToColumns(s, e, t) {
-    this._commandService.executeCommand(ht.id, {
+  splitTextToColumns(r, e, t) {
+    this._commandService.syncExecuteCommand(Ct.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
       delimiter: e,
       customDelimiter: t,
-      treatMultipleDelimitersAsOne: s
+      treatMultipleDelimitersAsOne: r
     });
   }
   /**
@@ -1544,16 +1834,16 @@ let w = class extends ne {
    * fRange.useThemeStyle('default');
    * ```
    */
-  useThemeStyle(s) {
-    if (s == null) {
+  useThemeStyle(r) {
+    if (r == null) {
       const e = this.getUsedThemeStyle();
       e && this.removeThemeStyle(e);
     } else
-      this._commandService.executeCommand(ct.id, {
+      this._commandService.syncExecuteCommand(ft.id, {
         unitId: this._workbook.getUnitId(),
         subUnitId: this._worksheet.getSheetId(),
         range: this._range,
-        themeName: s
+        themeName: r
       });
   }
   /**
@@ -1567,12 +1857,12 @@ let w = class extends ne {
    * fRange.removeThemeStyle('default');
    * ```
    */
-  removeThemeStyle(s) {
-    this._commandService.executeCommand(dt.id, {
+  removeThemeStyle(r) {
+    this._commandService.syncExecuteCommand(vt.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range,
-      themeName: s
+      themeName: r
     });
   }
   /**
@@ -1589,49 +1879,73 @@ let w = class extends ne {
    * ```
    */
   getUsedThemeStyle() {
-    return this._injector.get(Me).getAppliedRangeThemeStyle({
+    return this._injector.get(Ve).getAppliedRangeThemeStyle({
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       range: this._range
     });
   }
 };
-w = Jt([
-  Y(3, u(b)),
-  Y(4, l),
-  Y(5, u(Wt))
-], w);
-var Qt = Object.defineProperty, Xt = Object.getOwnPropertyDescriptor, Zt = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? Xt(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && Qt(e, t, r), r;
-}, en = (s, e) => (t, n) => e(t, n, s);
-let B = class {
-  constructor(s, e, t, n) {
-    this._workbook = s, this._worksheet = e, this._selections = t, this._injector = n;
+S = sn([
+  K(3, u(y)),
+  K(4, l),
+  K(5, u(Vt))
+], S);
+var on = Object.defineProperty, hn = Object.getOwnPropertyDescriptor, an = (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);
+let L = class {
+  constructor(r, e, t, n) {
+    this._workbook = r, this._worksheet = e, this._selections = t, this._injector = n;
   }
   /**
    * Represents the active selection in the sheet. Which means the selection contains the active cell.
    * @returns {FRange | null} The active selection.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const fSelection = fWorksheet.getSelection();
+   * const activeRange = fSelection.getActiveRange();
+   * console.log(activeRange);
+   * ```
    */
   getActiveRange() {
-    const s = this._selections.find((e) => !!e.primary);
-    return s ? this._injector.createInstance(w, this._workbook, this._worksheet, s.range) : null;
+    const r = this._selections.find((e) => !!e.primary);
+    return r ? this._injector.createInstance(S, this._workbook, this._worksheet, r.range) : null;
   }
   /**
    * Represents the active selection list in the sheet.
    * @returns {FRange[]} The active selection list.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const fSelection = fWorksheet.getSelection();
+   * const activeRangeList = fSelection.getActiveRangeList();
+   * console.log(activeRangeList);
+   * ```
    */
   getActiveRangeList() {
-    return this._selections.map((s) => this._injector.createInstance(w, this._workbook, this._worksheet, s.range));
+    return this._selections.map((r) => this._injector.createInstance(S, this._workbook, this._worksheet, r.range));
   }
   /**
    * Represents the current select cell in the sheet.
    * @returns {ISelectionCell} The current select cell info.Pay attention to the type of the return value.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const fSelection = fWorksheet.getSelection();
+   * const currentCell = fSelection.getCurrentCell();
+   * console.log(currentCell);
+   * ```
    */
   getCurrentCell() {
-    const s = this._selections.find((e) => !!e.primary);
-    return s ? s.primary : null;
+    const r = this._selections.find((e) => !!e.primary);
+    return r ? r.primary : null;
   }
   /**
    * Returns the active sheet in the spreadsheet.
@@ -1646,8 +1960,8 @@ let B = class {
    * ```
    */
   getActiveSheet() {
-    const s = this._injector.createInstance(I, this._workbook);
-    return this._injector.createInstance(g, s, this._workbook, this._worksheet);
+    const r = this._injector.createInstance(f, this._workbook);
+    return this._injector.createInstance(m, 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.
@@ -1663,31 +1977,31 @@ let B = class {
    * console.log(newSelection.getActiveRange().getA1Notation()); // A1
    * ```
    */
-  updatePrimaryCell(s) {
+  updatePrimaryCell(r) {
     const e = this._injector.get(l);
     let t = [], n = !1;
-    for (const { range: o, style: i } of this._selections)
-      N.contains(o, s.getRange()) ? (t.push({
-        range: o,
-        primary: Z(s.getRange(), this._worksheet),
-        style: i
+    for (const { range: i, style: o } of this._selections)
+      M.contains(i, r.getRange()) ? (t.push({
+        range: i,
+        primary: ee(r.getRange(), this._worksheet),
+        style: o
       }), n = !0) : t.push({
-        range: o,
+        range: i,
         primary: null,
-        style: i
+        style: o
       });
     n || (t = [
       {
-        range: s.getRange(),
-        primary: Z(s.getRange(), this._worksheet)
+        range: r.getRange(),
+        primary: ee(r.getRange(), this._worksheet)
       }
     ]);
-    const r = {
+    const s = {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       selections: t
     };
-    return e.syncExecuteCommand(De.id, r), new B(this._workbook, this._worksheet, t, this._injector);
+    return e.syncExecuteCommand(He.id, s), new L(this._workbook, this._worksheet, t, this._injector);
   }
   /**
    *Get the next primary cell in the specified direction. If the primary cell not exists in selections, return null.
@@ -1704,79 +2018,77 @@ let B = class {
    * console.log(nextCell?.getA1Notation()); // B1
    * ```
    */
-  getNextDataRange(s) {
+  getNextDataRange(r) {
     if (!this._selections.find((n) => !!n.primary))
       return null;
-    const t = ut(this._selections.concat(), s, this._worksheet);
-    return t ? this._injector.createInstance(w, this._workbook, this._worksheet, t) : null;
+    const t = It(this._selections.concat(), r, this._worksheet);
+    return t ? this._injector.createInstance(S, this._workbook, this._worksheet, t) : null;
   }
 };
-B = Zt([
-  en(3, u(b))
-], B);
-var tn = Object.defineProperty, nn = Object.getOwnPropertyDescriptor, sn = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? nn(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && tn(e, t, r), r;
-}, T = (s, e) => (t, n) => e(t, n, s);
-let g = class extends ne {
-  constructor(e, t, n, r, o, i, a) {
-    super(r);
-    k(this, "_eventRegistry", /* @__PURE__ */ new Map());
+L = an([
+  dn(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--)
+    (o = r[i]) && (s = (n ? o(e, t, s) : o(s)) || s);
+  return n && s && cn(e, t, s), s;
+}, B = (r, e) => (t, n) => e(t, n, r);
+let m = class extends ce {
+  /**
+   * Creates a new worksheet facade instance
+   * @param {FWorkbook} _fWorkbook - The facade workbook instance
+   * @param {Workbook} _workbook - The workbook instance
+   * @param {Worksheet} _worksheet - The worksheet instance
+   * @param {Injector} _injector - The injector instance
+   * @param {SheetsSelectionsService} _selectionManagerService - The selection manager service
+   * @param {ILogService} _logService - The log service
+   * @param {ICommandService} _commandService - The command service
+   */
+  constructor(e, t, n, s, i, o, h) {
+    super(s);
     /**
      * Sets the active selection region for this sheet.
-     * @param range The range to set as the active selection.
+     * @param range - The range to set as the active selection
+     * @returns This sheet, for chaining
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorkSheet = fWorkbook.getActiveSheet();
+     * fWorkSheet.setActiveRange(fWorkSheet.getRange('A1'));
+     * ```
      */
-    k(this, "setActiveSelection", this.setActiveRange);
-    this._fWorkbook = e, this._workbook = t, this._worksheet = n, this._injector = r, this._selectionManagerService = o, this._logService = i, this._commandService = a;
-  }
-  getSheet() {
-    return this._worksheet;
-  }
-  _ensureEventRegistry(e) {
-    return this._eventRegistry.has(e) || this._eventRegistry.set(e, new ye()), this._eventRegistry.get(e);
+    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;
   }
   /**
-   * Add an event listener
-   * @param event key of event
-   * @param callback callback when event triggered
-   * @returns {Disposable} The Disposable instance, for remove the listener
+   * Returns the worksheet
+   * @returns {Worksheet} The worksheet instance.
    * @example
-   * ```ts
-   * univerAPI.addEvent(univerAPI.event.UnitCreated, (params) => {
-   *     console.log('unit created', params);
-   * });
+   * ```typescript
+   * const sheet = univerAPI.getActiveWorkbook().getActiveSheet().getSheet();
    * ```
    */
-  addEvent(e, t) {
-    return this._ensureEventRegistry(e).add(t), F(() => this._ensureEventRegistry(e).delete(t));
+  getSheet() {
+    return this._worksheet;
   }
   /**
-   * Fire an event, used in internal only.
-   * @param event {string} key of event
-   * @param params {any} params of event
-   * @returns {boolean} should cancel
+   * Returns the injector
+   * @returns {Injector} The injector
    * @example
-   * ```ts
-   * this.fireEvent(univerAPI.event.UnitCreated, params);
+   * ```typescript
+   * const injector = univerAPI.getActiveWorkbook().getActiveSheet().getInject();
    * ```
    */
-  fireEvent(e, t) {
-    var n;
-    return (n = this._eventRegistry.get(e)) == null || n.getData().forEach((r) => {
-      r(t);
-    }), t.cancel;
-  }
-  /**
-   * Returns the injector
-   * @returns The injector
-   */
   getInject() {
     return this._injector;
   }
   /**
    * Returns the workbook
    * @returns {Workbook} The workbook instance.
+   * @example
+   * ```typescript
+   * const workbook = univerAPI.getActiveWorkbook().getWorkbook();
+   * ```
    */
   getWorkbook() {
     return this._workbook;
@@ -1784,6 +2096,11 @@ let g = class extends ne {
   /**
    * Returns the worksheet id.
    * @returns {string} The id of the worksheet.
+   * @example
+   * ```typescript
+   * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+   * const id = sheet.getSheetId();
+   * ```
    */
   getSheetId() {
     return this._worksheet.getSheetId();
@@ -1791,6 +2108,11 @@ let g = class extends ne {
   /**
    * Returns the worksheet name.
    * @returns {string} The name of the worksheet.
+   * @example
+   * ```typescript
+   * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+   * const name = sheet.getSheetName();
+   * ```
    */
   getSheetName() {
     return this._worksheet.getName();
@@ -1798,46 +2120,78 @@ let g = class extends ne {
   /**
    * Represents the selection ranges info of the worksheet.
    * @returns {FSelection} return the current selections of the worksheet or null if there is no selection.
+   * @example
+   * ```typescript
+   * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+   * const selections = sheet.getSelection();
+   * ```
    */
   getSelection() {
     const e = this._selectionManagerService.getCurrentSelections();
-    return e ? this._injector.createInstance(B, this._workbook, this._worksheet, e) : null;
+    return e ? this._injector.createInstance(L, this._workbook, this._worksheet, e) : null;
   }
   // #region rows
   // #region default style
   /**
    * Get the default style of the worksheet
    * @returns {IStyleData} Default style of the worksheet.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * const defaultStyle = sheet.getDefaultStyle();
+   * ```
    */
   getDefaultStyle() {
     return this._worksheet.getDefaultCellStyle();
   }
   /**
    * Get the default style of the worksheet row
-   * @param {number} index The row index
-   * @param {boolean} [keepRaw] If true, return the raw style data maybe the style name or style data, otherwise return the data from row manager
-   * @returns {Nullable<IStyleData> | string} The default style of the worksheet row name or style data
+   * @param {number} index - The row index
+   * @param {boolean} [keepRaw] - If true, return the raw style data maybe the style name or style data, otherwise return the data from row manager
+   * @returns {(Nullable<IStyleData> | string)} The default style of the worksheet row name or style data
+   * @example
+   * ```typescript
+   * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+   * // Get default style for row 0 (1)
+   * const rowStyle = sheet.getRowDefaultStyle(0);
+   * // Get raw style data for row 0
+   * const rawRowStyle = sheet.getRowDefaultStyle(0, true);
+   * ```
    */
   getRowDefaultStyle(e, t = !1) {
     return this._worksheet.getRowStyle(e, t);
   }
   /**
    * Get the default style of the worksheet column
-   * @param {number} index The column index
-   * @param {boolean} [keepRaw] If true, return the raw style data maybe the style name or style data, otherwise return the data from col manager
-   * @returns {Nullable<IStyleData> | string} The default style of the worksheet column name or style data
+   * @param {number} index - The column index
+   * @param {boolean} [keepRaw] - If true, return the raw style data maybe the style name or style data, otherwise return the data from col manager
+   * @returns {(Nullable<IStyleData> | string)} The default style of the worksheet column name or style data
+   * @example
+   * ```typescript
+   * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+   * // Get default style for column 0 (A)
+   * const colStyle = sheet.getColumnDefaultStyle(0);
+   * // Get raw style data for column 0
+   * const rawColStyle = sheet.getColumnDefaultStyle(0, true);
+   * ```
    */
   getColumnDefaultStyle(e, t = !1) {
     return this._worksheet.getColumnStyle(e, t);
   }
   /**
    * Set the default style of the worksheet
-   * @param {StyleDataInfo} style default style
-   * @returns {FWorksheet} This sheet, for chaining.
+   * @param {string} style - The style to set
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * fWorksheet.setDefaultStyle('default');
+   * ```
    */
   setDefaultStyle(e) {
     const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId();
-    return this._commandService.syncExecuteCommand(mt.id, {
+    return this._commandService.syncExecuteCommand(bt.id, {
       unitId: t,
       subUnitId: n,
       defaultStyle: e
@@ -1845,74 +2199,94 @@ let g = class extends ne {
   }
   /**
    * Set the default style of the worksheet row
-   * @param {number} index The row index
-   * @param {string | Nullable<IStyleData>} style The style name or style data
+   * @param {number} index - The row index
+   * @param {string | Nullable<IStyleData>} style - The style name or style data
    * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * fWorksheet.setRowDefaultStyle(0, 'default');
+   * ```
    */
   setColumnDefaultStyle(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = {
       unitId: n,
-      subUnitId: r,
+      subUnitId: s,
       columnData: {
         [e]: {
           s: t
         }
       }
     };
-    return this._commandService.syncExecuteCommand(de.id, o), this;
+    return this._commandService.syncExecuteCommand(Se.id, i), this;
   }
   /**
    * Set the default style of the worksheet column
-   * @param {number} index The column index
-   * @param {string | Nullable<IStyleData>} style The style name or style data
+   * @param {number} index - The column index
+   * @param {string | Nullable<IStyleData>} style - The style name or style data
    * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * fWorksheet.setColumnDefaultStyle(0, 'default');
+   * ```
    */
   setRowDefaultStyle(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = {
       unitId: n,
-      subUnitId: r,
+      subUnitId: s,
       rowData: {
         [e]: {
           s: t
         }
       }
     };
-    return this._commandService.syncExecuteCommand(ue.id, o), this;
-  }
-  getRange(e, t, n, r) {
-    let o, i;
-    if (typeof e == "string") {
-      const { range: a, sheetName: h } = At(e), c = h ? this._workbook.getSheetBySheetName(h) : this._worksheet;
-      if (!c)
+    return this._commandService.syncExecuteCommand(we.id, i), this;
+  }
+  getRange(e, t, n, s) {
+    let i, o;
+    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;
+      if (!d)
         throw new Error("Range not found");
-      i = c, o = {
-        ...a,
+      o = d, i = {
+        ...h,
         unitId: this._workbook.getUnitId(),
-        sheetId: i.getSheetId(),
+        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: a.rangeType === _.COLUMN ? 0 : a.startRow,
-        endRow: a.rangeType === _.COLUMN ? i.getMaxRows() - 1 : a.endRow,
-        startColumn: a.rangeType === _.ROW ? 0 : a.startColumn,
-        endColumn: a.rangeType === _.ROW ? i.getMaxColumns() - 1 : a.endColumn
+        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
       };
     } else if (typeof e == "number" && t !== void 0)
-      i = this._worksheet, o = {
+      o = this._worksheet, i = {
         startRow: e,
         endRow: e + (n != null ? n : 1) - 1,
         startColumn: t,
-        endColumn: t + (r != null ? r : 1) - 1,
+        endColumn: t + (s != null ? s : 1) - 1,
         unitId: this._workbook.getUnitId(),
         sheetId: this._worksheet.getSheetId()
       };
     else
       throw new Error("Invalid range specification");
-    return this._injector.createInstance(w, this._workbook, i, o);
+    return this._injector.createInstance(S, this._workbook, o, i);
   }
   /**
    * Returns the current number of columns in the sheet, regardless of content.
    * @returns {number} The maximum columns count of the sheet
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * const totalColumns = sheet.getMaxColumns();
+   * console.log(`Sheet has ${totalColumns} columns`);
+   * ```
    */
   getMaxColumns() {
     return this._worksheet.getMaxColumns();
@@ -1920,90 +2294,152 @@ let g = class extends ne {
   /**
    * Returns the current number of rows in the sheet, regardless of content.
    * @returns {number}The maximum rows count of the sheet
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * const totalRows = sheet.getMaxRows();
+   * console.log(`Sheet has ${totalRows} rows`);
+   * ```
    */
   getMaxRows() {
     return this._worksheet.getMaxRows();
   }
   /**
    * Inserts a row after the given row position.
-   * @param {number} afterPosition The row after which the new row should be added, starting at 0 for the first row.
+   * @param {number} afterPosition - The row after which the new row should be added, starting at 0 for the first row.
    * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 rows at row index 2 (before the third row)
+   * sheet.insertRowAfter(2);
+   * // Insert 1 row at row index 0 (before the first row)
+   * sheet.insertRowAfter(0);
+   * ```
    */
   insertRowAfter(e) {
     return this.insertRowsAfter(e, 1);
   }
   /**
    * Inserts a row before the given row position.
-   * @param {number} beforePosition The row before which the new row should be added, starting at 0 for the first row.
+   * @param {number} beforePosition - The row before which the new row should be added, starting at 0 for the first row.
    * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 rows at row index 2 (before the third row)
+   * sheet.insertRowBefore(2);
+   * // Insert 1 row at row index 0 (before the first row)
+   * sheet.insertRowBefore(0);
+   * ```
    */
   insertRowBefore(e) {
     return this.insertRowsBefore(e, 1);
   }
   /**
    * Inserts one or more consecutive blank rows in a sheet starting at the specified location.
-   * @param rowIndex The index indicating where to insert a row, starting at 0 for the first row.
-   * @param numRows The number of rows to insert.
-   * @returns This sheet, for chaining.
+   * @param {number} rowIndex - The index indicating where to insert a row, starting at 0 for the first row.
+   * @param {number} numRows - The number of rows to insert.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 rows at row index 2 (before the third row)
+   * sheet.insertRows(2, 3);
+   * // Insert 1 row at row index 0 (before the first row)
+   * sheet.insertRows(0);
+   * ```
    */
   insertRows(e, t = 1) {
     return this.insertRowsBefore(e, t);
   }
   /**
    * Inserts a number of rows after the given row position.
-   * @param afterPosition The row after which the new rows should be added, starting at 0 for the first row.
-   * @param howMany The number of rows to insert.
-   * @returns This sheet, for chaining.
+   * @param {number} afterPosition - The row after which the new rows should be added, starting at 0 for the first row.
+   * @param {number} howMany - The number of rows to insert.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 rows at row index 2 (before the third row)
+   * sheet.insertRowsAfter(2, 3);
+   * // Insert 1 row at row index 0 (before the first row)
+   * sheet.insertRowsAfter(0);
+   * ```
    */
   insertRowsAfter(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = D.DOWN, i = e + 1, a = e + t, h = 0, c = this._worksheet.getColumnCount() - 1, d = W(this._worksheet, i, a, h, c, !0, e);
-    return this._commandService.syncExecuteCommand(me.id, {
+    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);
+    return this._commandService.syncExecuteCommand(Ce.id, {
       unitId: n,
-      subUnitId: r,
-      direction: o,
+      subUnitId: s,
+      direction: i,
       range: {
-        startRow: i,
-        endRow: a,
-        startColumn: h,
-        endColumn: c
+        startRow: o,
+        endRow: h,
+        startColumn: a,
+        endColumn: d
       },
-      cellValue: d
+      cellValue: c
     }), this;
   }
   /**
    * Inserts a number of rows before the given row position.
-   * @param beforePosition The row before which the new rows should be added, starting at 0 for the first row.
-   * @param howMany The number of rows to insert.
-   * @returns This sheet, for chaining.
+   * @param {number} beforePosition - The row before which the new rows should be added, starting at 0 for the first row.
+   * @param {number} howMany - The number of rows to insert.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 rows at row index 2 (before the third row)
+   * sheet.insertRowsBefore(2, 3);
+   * // Insert 1 row at row index 0 (before the first row)
+   * sheet.insertRowsBefore(0);
+   * ```
    */
   insertRowsBefore(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = D.UP, i = e, a = e + t - 1, h = 0, c = this._worksheet.getColumnCount() - 1, d = W(this._worksheet, i, a, h, c, !0, e - 1);
-    return this._commandService.syncExecuteCommand(me.id, {
+    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);
+    return this._commandService.syncExecuteCommand(Ce.id, {
       unitId: n,
-      subUnitId: r,
-      direction: o,
+      subUnitId: s,
+      direction: i,
       range: {
-        startRow: i,
-        endRow: a,
-        startColumn: h,
-        endColumn: c
+        startRow: o,
+        endRow: h,
+        startColumn: a,
+        endColumn: d
       },
-      cellValue: d
+      cellValue: c
     }), this;
   }
   /**
    * Deletes the row at the given row position.
-   * @param rowPosition The position of the row, starting at 0 for the first row.
-   * @returns This sheet, for chaining.
+   * @param {number} rowPosition - The position of the row, starting at 0 for the first row.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Delete 3 rows at row index 2 (rows 3-5)
+   * sheet.deleteRow(2);
+   * // Delete 1 row at row index 0 (first row)
+   * sheet.deleteRow(0);
+   * ```
    */
   deleteRow(e) {
     return this.deleteRows(e, 1);
   }
   /**
    * Deletes a number of rows starting at the given row position.
-   * @param rowPosition The position of the first row to delete, starting at 0 for the first row.
-   * @param howMany The number of rows to delete.
-   * @returns This sheet, for chaining.
+   * @param {number} rowPosition - The position of the first row to delete, starting at 0 for the first row.
+   * @param {number} howMany - The number of rows to delete.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Delete 3 rows at row index 2 (rows 3-5)
+   * sheet.deleteRows(2, 3);
+   * // Delete 1 row at row index 0 (first row)
+   * sheet.deleteRows(0);
+   * ```
    */
   deleteRows(e, t) {
     const n = {
@@ -2012,7 +2448,7 @@ let g = class extends ne {
       startColumn: 0,
       endColumn: this._worksheet.getColumnCount() - 1
     };
-    return this._commandService.syncExecuteCommand(lt.id, {
+    return this._commandService.syncExecuteCommand(Rt.id, {
       range: n,
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId()
@@ -2020,140 +2456,258 @@ let g = class extends ne {
   }
   /**
    * Moves the rows selected by the given range to the position indicated by the destinationIndex. The rowSpec itself does not have to exactly represent an entire row or group of rows to move—it selects all rows that the range spans.
-   * @param rowSpec A range spanning the rows that should be moved.
-   * @param destinationIndex The index that the rows should be moved to. Note that this index is based on the coordinates before the rows are moved. Existing data is shifted down to make room for the moved rows while the source rows are removed from the grid. Therefore, the data may end up at a different index than originally specified. Use 0-index for this method.
-   * @returns This sheet, for chaining.
+   * @param {FRange} rowSpec - A range spanning the rows that should be moved.
+   * @param {number} destinationIndex - The index that the rows should be moved to. Note that this index is based on the coordinates before the rows are moved. Existing data is shifted down to make room for the moved rows while the source rows are removed from the grid. Therefore, the data may end up at a different index than originally specified. Use 0-index for this method.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Move 3 rows at row index 2 (rows 3-5) to row index 0
+   * sheet.moveRows(rowSpec, 0);
+   * // Move 1 row at row index 0 (first row) to row index 2
+   * sheet.moveRows(rowSpec, 2);
+   * ```
    */
   moveRows(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = q(e.getRange(), this._worksheet), i = o, a = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = G(e.getRange(), this._worksheet), o = i, h = {
       startRow: t,
       endRow: t,
-      startColumn: o.startColumn,
-      endColumn: o.endColumn
+      startColumn: i.startColumn,
+      endColumn: i.endColumn
     };
-    return this._commandService.syncExecuteCommand(gt.id, {
+    return this._commandService.syncExecuteCommand(pt.id, {
       unitId: n,
-      subUnitId: r,
-      range: o,
-      fromRange: i,
-      toRange: a
+      subUnitId: s,
+      range: i,
+      fromRange: o,
+      toRange: h
     }), this;
   }
   /**
    * Hides the rows in the given range.
-   * @param row The row range to hide.
-   * @returns This sheet, for chaining.
+   * @param {FRange} row - The row range to hide.
+   * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Hide 3 rows starting from row index 1 (rows 2-4)
+   * sheet.hideRow(1);
+   * // Hide single row at index 0 (first row)
+   * sheet.hideRow(0);
+   * ```
    */
   hideRow(e) {
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), r = q(e.getRange(), this._worksheet);
-    return this._commandService.syncExecuteCommand(le.id, {
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = G(e.getRange(), this._worksheet);
+    return this._commandService.syncExecuteCommand(fe.id, {
       unitId: t,
       subUnitId: n,
-      ranges: [r]
+      ranges: [s]
     }), this;
   }
   /**
-   * Hides one or more consecutive rows starting at the given index. Use 0-index for this method.
-   * @param {number} rowIndex The starting index of the rows to hide.
-   * @param {number} numRows The number of rows to hide.
+   * Hides one or more consecutive rows starting at the given index. Use 0-index for this method
+   * @param {number} rowIndex - The starting index of the rows to hide
+   * @param {number} numRow - The number of rows to hide
    * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Hide 3 rows starting from row index 1 (rows 2-4)
+   * sheet.hideRows(1, 3);
+   * // Hide single row at index 0 (first row)
+   * sheet.hideRows(0);
+   * ```
    */
   hideRows(e, t = 1) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = {
       startRow: e,
       endRow: e + t - 1,
       startColumn: 0,
       endColumn: this._worksheet.getColumnCount() - 1,
       rangeType: _.ROW
     };
-    return this._commandService.syncExecuteCommand(le.id, {
+    return this._commandService.syncExecuteCommand(fe.id, {
       unitId: n,
-      subUnitId: r,
-      ranges: [o]
+      subUnitId: s,
+      ranges: [i]
     }), this;
   }
   /**
    * Make the row in the given range visible.
-   * @param {FRange} row The range to unhide, if hidden.
+   * @param {FRange} row - The range to unhide, if hidden.
    * @returns {FWorksheet} This sheet, for chaining.
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Unhide 3 rows starting from row index 1 (rows 2-4)
+   * sheet.unhideRow(1);
+   * // Unhide single row at index 0 (first row)
+   * sheet.unhideRow(0);
+   * ```
    */
   unhideRow(e) {
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), r = q(e.getRange(), this._worksheet);
-    return this._commandService.syncExecuteCommand(ge.id, {
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = G(e.getRange(), this._worksheet);
+    return this._commandService.syncExecuteCommand(ve.id, {
       unitId: t,
       subUnitId: n,
-      ranges: [r]
+      ranges: [s]
     }), this;
   }
   /**
    * Scrolling sheet to make specific rows visible.
-   * @param {number} rowIndex The starting index of the rows
-   * @param {number} numRows The number of rows
-   * @returns {FWorksheet} This sheet, for chaining.
+   * @param {number} rowIndex - The starting index of the rows
+   * @param {number} numRow - The number of rows
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Show 3 rows starting from row index 1 (rows 2-4)
+   * sheet.showRows(1);
+   * // Show single row at index 0 (first row)
+   * sheet.showRows(0);
+   * ```
    */
   showRows(e, t = 1) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = {
       startRow: e,
       endRow: e + t - 1,
       startColumn: 0,
       endColumn: this._worksheet.getColumnCount() - 1,
       rangeType: _.ROW
     };
-    return this._commandService.syncExecuteCommand(ge.id, {
+    return this._commandService.syncExecuteCommand(ve.id, {
       unitId: n,
-      subUnitId: r,
-      ranges: [o]
+      subUnitId: s,
+      ranges: [i]
     }), this;
   }
   /**
    * Sets the row height of the given row in pixels. By default, rows grow to fit cell contents. If you want to force rows to a specified height, use setRowHeightsForced(startRow, numRows, height).
-   * @param {number} rowPosition The row position to change.
-   * @param {number} height The height in pixels to set it to.
-   * @returns {FWorksheet} This sheet, for chaining.
+   * @param {number} rowPosition - The row position to change.
+   * @param {number} height - The height in pixels to set it to.
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Set the height of the second row to 30 pixels
+   * sheet.setRowHeight(1, 30);
+   * // Set the height of the first row to 20 pixels
+   * sheet.setRowHeight(0, 20);
+   * ```
    */
   setRowHeight(e, t) {
     return this.setRowHeights(e, 1, t);
   }
+  /**
+   * Make certain row wrap and auto height.
+   * @param rowPosition
+   * @param auto
+   * @returns {FWorksheet} this
+   * @example
+   * ```ts
+   const fWorkbook = univerAPI.getActiveWorkbook();
+   const fWorkSheet = fWorkbook.getActiveSheet();
+   fWorkSheet.autoFitRow(24);
+   * ```
+   */
+  autoFitRow(e, t = g.TRUE) {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = [{
+      startRow: e,
+      endRow: e,
+      startColumn: 0,
+      endColumn: this._worksheet.getColumnCount() - 1
+    }];
+    return this._commandService.syncExecuteCommand(Z.id, {
+      unitId: this._workbook.getUnitId(),
+      subUnitId: this._worksheet.getSheetId(),
+      range: i[0],
+      value: Y.WRAP
+    }), this._commandService.syncExecuteCommand(
+      yt.id,
+      {
+        unitId: n,
+        subUnitId: s,
+        ranges: i,
+        autoHeightInfo: t
+      }
+    ), this;
+  }
   /**
    * Sets the height of the given rows in pixels.
    * By default, rows grow to fit cell contents. If you want to force rows to a specified height, use setRowHeightsForced(startRow, numRows, height).
-   * @param {number} startRow The starting row position to change.
-   * @param {number} numRows The number of rows to change.
-   * @param {number} height The height in pixels to set it to.
-   * @returns {FWorksheet} This sheet, for chaining.
+   * @param {number} startRow - The starting row position to change
+   * @param {number} numRows - The number of rows to change
+   * @param {number} height - The height in pixels to set it to
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * sheet.setRowHeights(1, 10, 30);
+   * ```
+   */
+  setRowHeights(e, t, n) {
+    var d;
+    const s = this._workbook.getUnitId(), i = this._worksheet.getSheetId(), o = this._worksheet.getRowManager(), h = [], a = [];
+    for (let c = e; c < e + t; c++) {
+      const v = ((d = o.getRow(c)) == null ? void 0 : d.ah) || this._worksheet.getConfig().defaultRowHeight, k = {
+        startRow: c,
+        endRow: c,
+        startColumn: 0,
+        endColumn: this._worksheet.getColumnCount() - 1
+      };
+      n <= v ? h.push(k) : a.push(k);
+    }
+    return a.length > 0 && this._commandService.syncExecuteCommand(Ie.id, {
+      unitId: s,
+      subUnitId: i,
+      ranges: a,
+      value: n
+    }), h.length > 0 && this._commandService.syncExecuteCommand(be.id, {
+      unitId: s,
+      subUnitId: i,
+      ranges: h
+    }), this;
+  }
+  /**
+   * Sets the height of the given rows to auto.
+   * @param {number} startRow - The starting row position to change
+   * @param {number} numRows - The number of rows to change
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * sheet.setRowAutoHeight(1, 10);
+   * ```
    */
-  setRowHeights(e, t, n) {
-    var c;
-    const r = this._workbook.getUnitId(), o = this._worksheet.getSheetId(), i = this._worksheet.getRowManager(), a = [], h = [];
-    for (let d = e; d < e + t; d++) {
-      const z = ((c = i.getRow(d)) == null ? void 0 : c.ah) || this._worksheet.getConfig().defaultRowHeight, M = {
-        startRow: d,
-        endRow: d,
+  setRowAutoHeight(e, t) {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = [
+      {
+        startRow: e,
+        endRow: e + t - 1,
         startColumn: 0,
         endColumn: this._worksheet.getColumnCount() - 1
-      };
-      n <= z ? a.push(M) : h.push(M);
-    }
-    return h.length > 0 && this._commandService.syncExecuteCommand(_e.id, {
-      unitId: r,
-      subUnitId: o,
-      ranges: h,
-      value: n
-    }), a.length > 0 && this._commandService.syncExecuteCommand(_t.id, {
-      unitId: r,
-      subUnitId: o,
-      ranges: a
+      }
+    ];
+    return this._commandService.syncExecuteCommand(be.id, {
+      unitId: n,
+      subUnitId: s,
+      ranges: i
     }), this;
   }
   /**
    * Sets the height of the given rows in pixels. By default, rows grow to fit cell contents. When you use setRowHeightsForced, rows are forced to the specified height even if the cell contents are taller than the row height.
-   * @param {number} startRow The starting row position to change.
-   * @param {number} numRows The number of rows to change.
-   * @param {number} height The height in pixels to set it to.
-   * @returns {FWorksheet} This sheet, for chaining.
+   * @param {number} startRow - The starting row position to change
+   * @param {number} numRows - The number of rows to change
+   * @param {number} height - The height in pixels to set it to
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * sheet.setRowHeightsForced(1, 10, 30);
+   * ```
    */
   setRowHeightsForced(e, t, n) {
-    const r = this._workbook.getUnitId(), o = this._worksheet.getSheetId(), i = [
+    const s = this._workbook.getUnitId(), i = this._worksheet.getSheetId(), o = [
       {
         startRow: e,
         endRow: e + t - 1,
@@ -2161,113 +2715,175 @@ let g = class extends ne {
         endColumn: this._worksheet.getColumnCount() - 1
       }
     ];
-    return this._commandService.syncExecuteCommand(_e.id, {
-      unitId: r,
-      subUnitId: o,
-      ranges: i,
+    return this._commandService.syncExecuteCommand(Ie.id, {
+      unitId: s,
+      subUnitId: i,
+      ranges: o,
       value: n
     }), this;
   }
   // #endregion
   /**
    * Set custom properties for given rows.
-   * @param custom The custom properties to set.
-   * @returns This sheet, for chaining.
+   * @param {IObjectArrayPrimitiveType<CustomData>} custom - The custom properties to set
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * fWorkSheet.setRowCustom({ key: 'value' });
+   * ```
    */
   setRowCustom(e) {
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), r = {};
-    for (const [i, a] of Object.entries(e))
-      r[Number(i)] = {
-        custom: a
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = {};
+    for (const [o, h] of Object.entries(e))
+      s[Number(o)] = {
+        custom: h
       };
-    const o = {
+    const i = {
       unitId: t,
       subUnitId: n,
-      rowData: r
+      rowData: s
     };
-    return this._commandService.syncExecuteCommand(ue.id, o), this;
+    return this._commandService.syncExecuteCommand(we.id, i), this;
   }
   // #region Column
   /**
    * Inserts a column after the given column position.
-   * @param afterPosition The column after which the new column should be added, starting at 0 for the first column.
-   * @returns This sheet, for chaining.
+   * @param {number} afterPosition - The column after which the new column should be added, starting at 0 for the first column
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 columns at column index 2 (before column C)
+   * sheet.insertColumnAfter(2);
+   * // Insert 1 column at column index 0 (before column A)
+   * sheet.insertColumnAfter(0);
+   * ```
    */
   insertColumnAfter(e) {
     return this.insertColumnsAfter(e, 1);
   }
   /**
    * Inserts a column before the given column position.
-   * @param beforePosition The column before which the new column should be added, starting at 0 for the first column.
-   * @returns This sheet, for chaining.
+   * @param {number} beforePosition - The column before which the new column should be added, starting at 0 for the first column
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 columns at column index 2 (before column C)
+   * sheet.insertColumnBefore(2);
+   * // Insert 1 column at column index 0 (before column A)
+   * sheet.insertColumnBefore(0);
+   * ```
    */
   insertColumnBefore(e) {
     return this.insertColumnsBefore(e, 1);
   }
   /**
    * Inserts one or more consecutive blank columns in a sheet starting at the specified location.
-   * @param columnIndex The index indicating where to insert a column, starting at 0 for the first column.
-   * @param numColumns The number of columns to insert.
-   * @returns This sheet, for chaining.
+   * @param {number} columnIndex - The index indicating where to insert a column, starting at 0 for the first column
+   * @param {number} numColumns - The number of columns to insert
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 columns at column index 2 (before column C)
+   * sheet.insertColumns(2, 3);
+   * // Insert 1 column at column index 0 (before column A)
+   * sheet.insertColumns(0);
+   * ```
    */
   insertColumns(e, t = 1) {
     return this.insertColumnsBefore(e, t);
   }
   /**
    * Inserts a given number of columns after the given column position.
-   * @param afterPosition The column after which the new column should be added, starting at 0 for the first column.
-   * @param howMany The number of columns to insert.
-   * @returns This sheet, for chaining.
+   * @param {number} afterPosition - The column after which the new columns should be added, starting at 0 for the first column
+   * @param {number} howMany - The number of columns to insert
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 columns at column index 2 (before column C)
+   * sheet.insertColumnsAfter(2, 3);
+   * // Insert 1 column at column index 0 (before column A)
+   * sheet.insertColumnsAfter(0, 1);
+   * ```
    */
   insertColumnsAfter(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = D.RIGHT, i = 0, a = this._worksheet.getRowCount() - 1, h = e + 1, c = e + t, d = W(this._worksheet, i, a, h, c, !1, e);
-    return this._commandService.syncExecuteCommand(we.id, {
+    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);
+    return this._commandService.syncExecuteCommand(Re.id, {
       unitId: n,
-      subUnitId: r,
-      direction: o,
+      subUnitId: s,
+      direction: i,
       range: {
-        startRow: i,
-        endRow: a,
-        startColumn: h,
-        endColumn: c
+        startRow: o,
+        endRow: h,
+        startColumn: a,
+        endColumn: d
       },
-      cellValue: d
+      cellValue: c
     }), this;
   }
   /**
    * Inserts a number of columns before the given column position.
-   * @param beforePosition The column before which the new column should be added, starting at 0 for the first column.
-   * @param howMany The number of columns to insert.
-   * @returns This sheet, for chaining.
+   * @param {number} beforePosition - The column before which the new columns should be added, starting at 0 for the first column
+   * @param {number} howMany - The number of columns to insert
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Insert 3 columns at column index 2 (before column C)
+   * sheet.insertColumnsBefore(2, 3);
+   * // Insert 1 column at column index 0 (before column A)
+   * sheet.insertColumnsBefore(0, 1);
+   * ```
    */
   insertColumnsBefore(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = D.LEFT, i = 0, a = this._worksheet.getRowCount() - 1, h = e, c = e + t - 1, d = W(this._worksheet, i, a, h, c, !1, e - 1);
-    return this._commandService.syncExecuteCommand(we.id, {
+    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);
+    return this._commandService.syncExecuteCommand(Re.id, {
       unitId: n,
-      subUnitId: r,
-      direction: o,
+      subUnitId: s,
+      direction: i,
       range: {
-        startRow: i,
-        endRow: a,
-        startColumn: h,
-        endColumn: c
+        startRow: o,
+        endRow: h,
+        startColumn: a,
+        endColumn: d
       },
-      cellValue: d
+      cellValue: c
     }), this;
   }
   /**
    * Deletes the column at the given column position.
-   * @param columnPosition The position of the column, starting at 0 for the first column.
-   * @returns This sheet, for chaining.
+   * @param {number} columnPosition - The position of the column, starting at 0 for the first column
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Delete column C
+   * sheet.deleteColumn(2);
+   * // Delete column A
+   * sheet.deleteColumn(0);
+   * ```
    */
   deleteColumn(e) {
     return this.deleteColumns(e, 1);
   }
   /**
    * Deletes a number of columns starting at the given column position.
-   * @param columnPosition The position of the first column to delete, starting at 0 for the first column.
-   * @param howMany The number of columns to delete.
-   * @returns This sheet, for chaining.
+   * @param {number} columnPosition - The position of the first column to delete, starting at 0 for the first column
+   * @param {number} howMany - The number of columns to delete
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Delete 3 columns at column index 2 (columns C, D, E)
+   * sheet.deleteColumns(2, 3);
+   * // Delete 1 column at column index 0 (column A)
+   * sheet.deleteColumns(0, 1);
+   * ```
    */
   deleteColumns(e, t) {
     const n = {
@@ -2276,7 +2892,7 @@ let g = class extends ne {
       startColumn: e,
       endColumn: e + t - 1
     };
-    return this._commandService.syncExecuteCommand(wt.id, {
+    return this._commandService.syncExecuteCommand(Et.id, {
       range: n,
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId()
@@ -2284,109 +2900,161 @@ let g = class extends ne {
   }
   /**
    * Moves the columns selected by the given range to the position indicated by the destinationIndex. The columnSpec itself does not have to exactly represent an entire column or group of columns to move—it selects all columns that the range spans.
-   * @param columnSpec A range spanning the columns that should be moved.
-   * @param destinationIndex The index that the columns should be moved to. Note that this index is based on the coordinates before the columns are moved. Existing data is shifted right to make room for the moved columns while the source columns are removed from the grid. Therefore, the data may end up at a different index than originally specified. Use 0-index for this method.
-   * @returns This sheet, for chaining.
+   * @param {FRange} columnSpec - A range spanning the columns that should be moved
+   * @param {number} destinationIndex - The index that the columns should be moved to. Note that this index is based on the coordinates before the columns are moved. Existing data is shifted right to make room for the moved columns while the source columns are removed from the grid. Therefore, the data may end up at a different index than originally specified. Use 0-index for this method
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Move columns C, D, E to column index 2 (columns B, C, D)
+   * sheet.moveColumns({ startColumn: 2, endColumn: 4 }, 1);
+   * // Move column A to column index 0 (column A)
+   * sheet.moveColumns({ startColumn: 0, endColumn: 0 }, 0);
+   * ```
    */
   moveColumns(e, t) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = K(e.getRange(), this._worksheet), i = o, a = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = q(e.getRange(), this._worksheet), o = i, h = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: t,
       endColumn: t
     };
-    return this._commandService.syncExecuteCommand(kt.id, {
+    return this._commandService.syncExecuteCommand(Ut.id, {
       unitId: n,
-      subUnitId: r,
-      range: o,
-      fromRange: i,
-      toRange: a
+      subUnitId: s,
+      range: i,
+      fromRange: o,
+      toRange: h
     }), this;
   }
   /**
    * Hides the column or columns in the given range.
-   * @param column The column range to hide.
-   * @returns This sheet, for chaining.
+   * @param {FRange} column - The column range to hide
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Hide columns C, D, E
+   * sheet.hideColumn({ startColumn: 2, endColumn: 4 });
+   * // Hide column A
+   * sheet.hideColumn({ startColumn: 0, endColumn: 0 });
+   * ```
    */
   hideColumn(e) {
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), r = K(e.getRange(), this._worksheet);
-    return this._commandService.syncExecuteCommand(ke.id, {
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = q(e.getRange(), this._worksheet);
+    return this._commandService.syncExecuteCommand(pe.id, {
       unitId: t,
       subUnitId: n,
-      ranges: [r]
+      ranges: [s]
     }), this;
   }
   /**
-   * Hides one or more consecutive columns starting at the given index. Use 0-index for this method.
-   * @param columnIndex The starting index of the columns to hide.
-   * @param numColumns The number of columns to hide.
-   * @returns This sheet, for chaining.
+   * Hides one or more consecutive columns starting at the given index. Use 0-index for this method
+   * @param {number} columnIndex - The starting index of the columns to hide
+   * @param {number} numColumn - The number of columns to hide
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Hide columns C, D, E
+   * sheet.hideColumns(2, 3);
+   * // Hide column A
+   * sheet.hideColumns(0, 1);
+   * ```
    */
   hideColumns(e, t = 1) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: e,
       endColumn: e + t - 1,
       rangeType: _.COLUMN
     };
-    return this._commandService.syncExecuteCommand(ke.id, {
+    return this._commandService.syncExecuteCommand(pe.id, {
       unitId: n,
-      subUnitId: r,
-      ranges: [o]
+      subUnitId: s,
+      ranges: [i]
     }), this;
   }
   /**
    * Show the column in the given range.
-   * @param column The range to unhide, if hidden.
-   * @returns This sheet, for chaining.
+   * @param {FRange} column - The range to unhide, if hidden
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Unhide columns C, D, E
+   * sheet.unhideColumn({ startColumn: 2, endColumn: 4 });
+   * // Unhide column A
+   * sheet.unhideColumn({ startColumn: 0, endColumn: 0 });
+   * ```
    */
   unhideColumn(e) {
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), r = K(e.getRange(), this._worksheet);
-    return this._commandService.syncExecuteCommand(Se.id, {
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = q(e.getRange(), this._worksheet);
+    return this._commandService.syncExecuteCommand(ye.id, {
       unitId: t,
       subUnitId: n,
-      ranges: [r]
+      ranges: [s]
     }), this;
   }
   /**
-   * Show one or more consecutive columns starting at the given index. Use 0-index for this method.
-   * @param columnIndex The starting index of the columns to unhide.
-   * @param numColumns The number of columns to unhide.
-   * @returns This sheet, for chaining.
+   * Show one or more consecutive columns starting at the given index. Use 0-index for this method
+   * @param {number} columnIndex - The starting index of the columns to unhide
+   * @param {number} numColumn - The number of columns to unhide
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Unhide columns C, D, E
+   * sheet.unhideColumns(2, 3);
+   * // Unhide column A
+   * sheet.unhideColumns(0, 1);
+   * ```
    */
   showColumns(e, t = 1) {
-    const n = this._workbook.getUnitId(), r = this._worksheet.getSheetId(), o = {
+    const n = this._workbook.getUnitId(), s = this._worksheet.getSheetId(), i = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: e,
       endColumn: e + t - 1,
       rangeType: _.COLUMN
     };
-    return this._commandService.syncExecuteCommand(Se.id, {
+    return this._commandService.syncExecuteCommand(ye.id, {
       unitId: n,
-      subUnitId: r,
-      ranges: [o]
+      subUnitId: s,
+      ranges: [i]
     }), this;
   }
   /**
    * Sets the width of the given column in pixels.
-   * @param columnPosition The position of the given column to set.
-   * @param width The width in pixels to set it to.
-   * @returns This sheet, for chaining.
+   * @param {number} columnPosition - The position of the given column to set
+   * @param {number} width - The width in pixels to set it to
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Set width of column B to 100 pixels
+   * sheet.setColumnWidth(1, 100);
+   * ```
    */
   setColumnWidth(e, t) {
     return this.setColumnWidths(e, 1, t);
   }
   /**
    * Sets the width of the given columns in pixels.
-   * @param startColumn The starting column position to change.
-   * @param numColumns The number of columns to change.
-   * @param width The width in pixels to set it to.
-   * @returns This sheet, for chaining.
+   * @param {number} startColumn - The starting column position to change
+   * @param {number} numColumn - The number of columns to change
+   * @param {number} width - The width in pixels to set it to
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Set width of columns B-D (index 1-3) to 100 pixels
+   * sheet.setColumnWidths(1, 3, 100);
+   * ```
    */
   setColumnWidths(e, t, n) {
-    const r = this._workbook.getUnitId(), o = this._worksheet.getSheetId(), i = [
+    const s = this._workbook.getUnitId(), i = this._worksheet.getSheetId(), o = [
       {
         startColumn: e,
         endColumn: e + t - 1,
@@ -2394,63 +3062,103 @@ let g = class extends ne {
         endRow: this._worksheet.getRowCount() - 1
       }
     ];
-    return this._commandService.syncExecuteCommand(St.id, {
-      unitId: r,
-      subUnitId: o,
-      ranges: i,
+    return this._commandService.syncExecuteCommand(Pt.id, {
+      unitId: s,
+      subUnitId: i,
+      ranges: o,
       value: n
     }), this;
   }
   // #endregion
   /**
    * Set custom properties for given columns.
-   * @param custom The custom properties to set.
-   * @returns This sheet, for chaining.
+   * @param {IObjectArrayPrimitiveType<CustomData>} custom - The custom properties to set
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * fWorkSheet.setColumnCustom({ 0: { key: 'value' } });
+   * ```
    */
   setColumnCustom(e) {
-    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), r = {};
-    for (const [i, a] of Object.entries(e))
-      r[Number(i)] = {
-        custom: a
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = {};
+    for (const [o, h] of Object.entries(e))
+      s[Number(o)] = {
+        custom: h
       };
-    const o = {
+    const i = {
       unitId: t,
       subUnitId: n,
-      columnData: r
+      columnData: s
     };
-    return this._commandService.syncExecuteCommand(de.id, o), this;
+    return this._commandService.syncExecuteCommand(Se.id, i), this;
   }
   // #region merge cells
   /**
    * Get all merged cells in the current sheet
-   * @returns all merged cells
+   * @returns {FRange[]} all merged cells
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Get all merged ranges in the sheet
+   * const mergedRanges = sheet.getMergedRanges();
+   * // Process each merged range
+   * mergedRanges.forEach(range => {
+   *   console.log(range.getA1Notation());
+   * });
+   * ```
    */
   getMergedRanges() {
-    return this._worksheet.getSnapshot().mergeData.map((t) => this._injector.createInstance(w, this._workbook, this._worksheet, t));
+    return this._worksheet.getSnapshot().mergeData.map((t) => this._injector.createInstance(S, this._workbook, this._worksheet, t));
   }
   /**
    * Get the merged cell data of the specified row and column.
-   * @param {number} row The row index.
-   * @param {number} column The column index.
-   * @returns {FRange|undefined} The merged cell data, or undefined if the cell is not merged.
+   * @param {number} row - The row index
+   * @param {number} column - The column index
+   * @returns {FRange|undefined} The merged cell data, or undefined if the cell is not merged
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * const merge = fWorkSheet.getCellMergeData(0, 0);
+   * if (merge) {
+   *   console.log('Merged range:', merge.getA1Notation());
+   * }
+   * ```
    */
   getCellMergeData(e, t) {
-    const r = this._worksheet.getMergedCell(e, t);
-    if (r)
-      return this._injector.createInstance(w, this._workbook, this._worksheet, r);
+    const s = this._worksheet.getMergedCell(e, t);
+    if (s)
+      return this._injector.createInstance(S, this._workbook, this._worksheet, s);
   }
   // #endregion
   /**
    * Returns the selected range in the active sheet, or null if there is no active range.
-   * @returns the active range
+   * @returns {FRange | null} the active range
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Get the currently active range
+   * const activeRange = sheet.getActiveRange();
+   * if (activeRange) {
+   *   console.log('Active range:', activeRange.getA1Notation());
+   * }
+   * ```
    */
   getActiveRange() {
     return this._fWorkbook.getActiveRange();
   }
   /**
    * Sets the active selection region for this sheet.
-   * @param {FRange} range The range to set as the active selection.
-   * @returns {FWorksheet} This sheet, for chaining.
+   * @param {FRange} range - The range to set as the active selection
+   * @returns {FWorksheet} This sheet, for chaining
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * fWorkSheet.setActiveRange(fWorkSheet.getRange('A1'));
+   * ```
    */
   setActiveRange(e) {
     const { unitId: t, sheetId: n } = e.getRange();
@@ -2460,13 +3168,24 @@ let g = class extends ne {
   }
   /**
    * Sets the frozen state of the current sheet.
-   * @param freeze - the scrolling viewport start range and count of freezed rows and columns.
+   * @param {IFreeze} freeze - the scrolling viewport start range and count of freezed rows and columns.
    * that means if you want to freeze the first 3 rows and 2 columns, you should set freeze as { startRow: 3, startColumn: 2, xSplit: 2, ySplit: 3 }
    * @deprecated use `setFrozenRows` and `setFrozenColumns` instead.
-   * @returns True if the command was successful, false otherwise.
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Freeze first 3 rows and 2 columns
+   * sheet.setFreeze({
+   *   startRow: 3,
+   *   startColumn: 2,
+   *   xSplit: 2,
+   *   ySplit: 3
+   * });
+   * ```
    */
   setFreeze(e) {
-    return this._logService.warn("setFreeze is deprecated, use setFrozenRows and setFrozenColumns instead"), this._commandService.syncExecuteCommand(H.id, {
+    return this._logService.warn("setFreeze is deprecated, use setFrozenRows and setFrozenColumns instead"), this._commandService.syncExecuteCommand(z.id, {
       ...e,
       unitId: this._workbook.getUnitId(),
       subUnitId: this.getSheetId()
@@ -2474,18 +3193,30 @@ let g = class extends ne {
   }
   /**
    * Cancels the frozen state of the current sheet.
-   * @returns True if the command was successful, false otherwise.
+   * @returns {FWorksheet} This worksheet instance for chaining
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Cancel freeze
+   * sheet.cancelFreeze();
+   * ```
    */
   cancelFreeze() {
-    return this._commandService.syncExecuteCommand(Ct.id, {
+    return this._commandService.syncExecuteCommand(xt.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this.getSheetId()
     }), this;
   }
   /**
    * Get the freeze state of the current sheet.
-   * @returns The freeze state of the current sheet.
-   * @deprecated use `getRowFreezeStatus` and `getColumnFreezeStatus` instead.
+   * @returns {IFreeze} The freeze state of the current sheet
+   * @example
+   * ```typescript
+   * const sheet = workbook.getActiveSheet();
+   * // Get the freeze state of the current sheet
+   * const freeze = sheet.getFreeze();
+   * console.log(freeze);
+   * ```
    */
   getFreeze() {
     return this._worksheet.getFreeze();
@@ -2500,10 +3231,10 @@ let g = class extends ne {
         xSplit: n
       });
     } else if (arguments.length === 2) {
-      let [n = 0, r = 0] = e;
-      n > r && ([n, r] = [r, n]), this._commandService.syncExecuteCommand(H.id, {
-        startColumn: r + 1,
-        xSplit: r - n + 1,
+      let [n = 0, s = 0] = e;
+      n > s && ([n, s] = [s, n]), this._commandService.syncExecuteCommand(z.id, {
+        startColumn: s + 1,
+        xSplit: s - n + 1,
         startRow: t.startRow,
         ySplit: t.ySplit,
         unitId: this._workbook.getUnitId(),
@@ -2522,10 +3253,10 @@ let g = class extends ne {
         ySplit: n
       });
     } else if (arguments.length === 2) {
-      let [n = 0, r = 0] = e;
-      n > r && ([n, r] = [r, n]), this._commandService.syncExecuteCommand(H.id, {
-        startRow: r + 1,
-        ySplit: r - n + 1,
+      let [n = 0, s = 0] = e;
+      n > s && ([n, s] = [s, n]), this._commandService.syncExecuteCommand(z.id, {
+        startRow: s + 1,
+        ySplit: s - n + 1,
         startColumn: t.startColumn,
         xSplit: t.xSplit,
         unitId: this._workbook.getUnitId(),
@@ -2536,7 +3267,15 @@ let g = class extends ne {
   }
   /**
    * Get the number of frozen columns.
-   * @returns The number of frozen columns, returns 0 if no columns are frozen.
+   * @returns {number} The number of frozen columns, returns 0 if no columns are frozen.
+   * @example
+   * ```typescript
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * // Get the number of frozen columns
+   * const frozenColumns = fWorkSheet.getFrozenColumns();
+   * console.log(frozenColumns);
+   * ```
    */
   getFrozenColumns() {
     const e = this.getFreeze();
@@ -2544,7 +3283,15 @@ let g = class extends ne {
   }
   /**
    * Get the number of frozen rows.
-   * @returns The number of frozen rows. returns 0 if no rows are frozen.
+   * @returns {number} The number of frozen rows. returns 0 if no rows are frozen.
+   * @example
+   * ```typescript
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * // Get the number of frozen rows
+   * const frozenRows = fWorkSheet.getFrozenRows();
+   * console.log(frozenRows);
+   * ```
    */
   getFrozenRows() {
     const e = this.getFreeze();
@@ -2553,6 +3300,14 @@ let g = class extends ne {
   /**
    * Get freezed rows.
    * @returns {IRowRange} The range of the frozen rows.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * // Get the range of the frozen rows
+   * const frozenRows = fWorkSheet.getFrozenRowRange();
+   * console.log(frozenRows);
+   * ```
    */
   getFrozenRowRange() {
     const e = this._worksheet.getFreeze();
@@ -2564,6 +3319,14 @@ let g = class extends ne {
   /**
    * Get freezed columns
    * @returns {IColumnRange} The range of the frozen columns.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * // Get the range of the frozen columns
+   * const frozenColumns = fWorkSheet.getFrozenColumnRange();
+   * console.log(frozenColumns);
+   * ```
    */
   getFrozenColumnRange() {
     const e = this._worksheet.getFreeze();
@@ -2586,11 +3349,11 @@ let g = class extends ne {
    * ```
    */
   hasHiddenGridLines() {
-    return this._worksheet.getConfig().showGridlines === m.FALSE;
+    return this._worksheet.getConfig().showGridlines === g.FALSE;
   }
   /**
    * Hides or reveals the sheet gridlines.
-   * @param {boolean} hidden If `true`, hide gridlines in this sheet; otherwise show the gridlines.
+   * @param {boolean} hidden - If `true`, hide gridlines in this sheet; otherwise show the gridlines.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
    * ``` ts
@@ -2601,15 +3364,15 @@ let g = class extends ne {
    * ```
    */
   setHiddenGridlines(e) {
-    return this._commandService.executeCommand(It.id, {
+    return this._commandService.syncExecuteCommand(te.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
-      showGridlines: e ? m.FALSE : m.TRUE
+      showGridlines: e ? g.FALSE : g.TRUE
     }), this;
   }
   /**
    * Set the color of the gridlines in the sheet.
-   * @param {string|undefined} color The color to set for the gridlines.Undefined or null to reset to the default color.
+   * @param {string|undefined} color - The color to set for the gridlines.Undefined or null to reset to the default color.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
    * ```ts
@@ -2620,7 +3383,7 @@ let g = class extends ne {
    * ```
    */
   setGridLinesColor(e) {
-    return this._commandService.syncExecuteCommand(ft.id, {
+    return this._commandService.syncExecuteCommand(ne.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       color: e
@@ -2629,13 +3392,20 @@ let g = class extends ne {
   /**
    * Get the color of the gridlines in the sheet.
    * @returns {string | undefined} The color of the gridlines in the sheet or undefined. The default color is 'rgb(214, 216, 219)'.
+   * @example
+   * ```ts
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorkSheet = fWorkbook.getActiveSheet();
+   * // get the gridlines color of the sheet
+   * console.log(fWorkSheet.getGridLinesColor());
+   * ```
    */
   getGridLinesColor() {
     return this._worksheet.getGridlinesColor();
   }
   /**
    * Sets the sheet tab color.
-   * @param {string|null|undefined} color A color code in CSS notation (like '#ffffff' or 'white'), or null to reset the tab color.
+   * @param {string|null|undefined} color - A color code in CSS notation (like '#ffffff' or 'white'), or null to reset the tab color.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
    * ```ts
@@ -2646,7 +3416,7 @@ let g = class extends ne {
    * ```
    */
   setTabColor(e) {
-    return this._commandService.executeCommand(vt.id, {
+    return this._commandService.syncExecuteCommand(re.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       color: e
@@ -2667,51 +3437,27 @@ let g = class extends ne {
   getTabColor() {
     return this._worksheet.getTabColor();
   }
+  // eslint-disable-next-line
   /**
-   * Subscribe to the cell data change event.
-   * @param callback - The callback function to be executed when the cell data changes.
-   * @returns - A disposable object to unsubscribe from the event.
-   * @example
-   * ```ts
-   * const fWorkbook = univerAPI.getActiveWorkbook();
-   * const fWorkSheet = fWorkbook.getActiveSheet();
-   * // subscribe to the cell data change event
-   * const disposable = fWorkSheet.onCellDataChange((cellValue) => {
-   *  console.log(cellValue.toArray());
-   * });
-   * // unsubscribe from the event
-   * disposable.dispose();
-   * ```
+   * @deprecated use `univerAPI.addEvent(univerAPI.Event.SheetValueChanged, callback)` instead
    */
   onCellDataChange(e) {
     return this._injector.get(l).onCommandExecuted((n) => {
-      if (n.id === Ce.id) {
-        const r = n.params;
-        r.unitId === this._workbook.getUnitId() && r.subUnitId === this._worksheet.getSheetId() && r.cellValue && e(new A(r.cellValue));
+      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));
       }
     });
   }
+  // eslint-disable-next-line
   /**
-   * Subscribe to the cell data change event.
-   * @param callback - The callback function to be executed before the cell data changes.
-   * @returns - A disposable object to unsubscribe from the event.
-   * @example
-   * ```ts
-   * const fWorkbook = univerAPI.getActiveWorkbook();
-   * const fWorkSheet = fWorkbook.getActiveSheet();
-   * // subscribe to the cell data change event
-   * const disposable = fWorkSheet.onBeforeCellDataChange((cellValue) => {
-   *   console.log(cellValue.toArray());
-   * });
-   * // unsubscribe from the event
-   * disposable.dispose();
-   * ```
+   * @deprecated use `univerAPI.addEvent(univerAPI.Event.SheetValueChanged, callback)` instead
    */
   onBeforeCellDataChange(e) {
     return this._injector.get(l).beforeCommandExecuted((n) => {
-      if (n.id === Ce.id) {
-        const r = n.params;
-        r.unitId === this._workbook.getUnitId() && r.subUnitId === this._worksheet.getSheetId() && r.cellValue && e(new A(r.cellValue));
+      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));
       }
     });
   }
@@ -2728,9 +3474,9 @@ let g = class extends ne {
    */
   hideSheet() {
     const e = this._injector.get(l);
-    if (this._workbook.getSheets().filter((o) => o.isSheetHidden() !== m.TRUE).length <= 1)
+    if (this._workbook.getSheets().filter((i) => i.isSheetHidden() !== g.TRUE).length <= 1)
       throw new Error("Cannot hide the only visible sheet");
-    return e.syncExecuteCommand(Rt.id, {
+    return e.syncExecuteCommand(se.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId()
     }), this;
@@ -2747,7 +3493,7 @@ let g = class extends ne {
    * ```
    */
   showSheet() {
-    return this._injector.get(l).syncExecuteCommand(bt.id, {
+    return this._injector.get(l).syncExecuteCommand(Nt.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId()
     }), this;
@@ -2757,11 +3503,11 @@ let g = class extends ne {
    * @returns {boolean} True if the sheet is hidden; otherwise, false.
    */
   isSheetHidden() {
-    return this._worksheet.isSheetHidden() === m.TRUE;
+    return this._worksheet.isSheetHidden() === g.TRUE;
   }
   /**
    * Sets the sheet name.
-   * @param {string} name The new name for the sheet.
+   * @param {string} name - The new name for the sheet.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
    * ```ts
@@ -2772,7 +3518,7 @@ let g = class extends ne {
    * ```
    */
   setName(e) {
-    return this._commandService.syncExecuteCommand(pt.id, {
+    return this._commandService.syncExecuteCommand(ie.id, {
       unitId: this._workbook.getUnitId(),
       subUnitId: this._worksheet.getSheetId(),
       name: e
@@ -2780,7 +3526,7 @@ let g = class extends ne {
   }
   /**
    * Activates this sheet. Does not alter the sheet itself, only the parent's notion of the active sheet.
-   * @returns Current sheet, for chaining.
+   * @returns {FWorksheet} Current sheet, for chaining.
    */
   activate() {
     return this._fWorkbook.setActiveSheet(this), this;
@@ -2802,9 +3548,9 @@ let g = class extends ne {
   }
   /**
    * Clears the sheet of content and formatting information.Or Optionally clears only the contents or only the formatting.
-   * @param {IFacadeClearOptions} [options] Options for clearing the sheet. If not provided, the contents and formatting are cleared both.
-   * @param {boolean} [options.contentsOnly] If true, the contents of the sheet are cleared. If false, the contents and formatting are cleared. Default is false.
-   * @param {boolean} [options.formatOnly] If true, the formatting of the sheet is cleared. If false, the contents and formatting are cleared. Default is false.
+   * @param {IFacadeClearOptions} [options] - Options for clearing the sheet. If not provided, the contents and formatting are cleared both.
+   * @param {boolean} [options.contentsOnly] - If true, the contents of the sheet are cleared. If false, the contents and formatting are cleared. Default is false.
+   * @param {boolean} [options.formatOnly] - If true, the formatting of the sheet is cleared. If false, the contents and formatting are cleared. Default is false.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
    * ```ts
@@ -2818,16 +3564,16 @@ let g = class extends ne {
    */
   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(), r = this._injector.get(l), o = {
+    const t = this._workbook.getUnitId(), n = this._worksheet.getSheetId(), s = this._injector.get(l), i = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: 0,
       endColumn: this._worksheet.getColumnCount() - 1
     };
-    return r.syncExecuteCommand(yt.id, {
+    return s.syncExecuteCommand(Tt.id, {
       unitId: t,
       subUnitId: n,
-      ranges: [o],
+      ranges: [i],
       options: e
     }), this;
   }
@@ -2835,7 +3581,7 @@ let g = class extends ne {
    * Clears the sheet of contents, while preserving formatting information.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
-   * ```ts
+   * ```typescript
    * const fWorkbook = univerAPI.getActiveWorkbook();
    * const fWorkSheet = fWorkbook.getActiveSheet();
    * // clear the sheet of content only
@@ -2843,23 +3589,23 @@ let g = class extends ne {
    * ```
    */
   clearContents() {
-    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(l), r = {
+    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(l), s = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: 0,
       endColumn: this._worksheet.getColumnCount() - 1
     };
-    return n.syncExecuteCommand(Ut.id, {
+    return n.syncExecuteCommand(Mt.id, {
       unitId: e,
       subUnitId: t,
-      ranges: [r]
+      ranges: [s]
     }), this;
   }
   /**
    * Clears the sheet of formatting, while preserving contents.
    * @returns {FWorksheet} Returns the current worksheet instance for method chaining
    * @example
-   * ```ts
+   * ```typescript
    * const fWorkbook = univerAPI.getActiveWorkbook();
    * const fWorkSheet = fWorkbook.getActiveSheet();
    * // clear the sheet of formatting only
@@ -2867,16 +3613,16 @@ let g = class extends ne {
    * ```
    */
   clearFormats() {
-    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(l), r = {
+    const e = this._workbook.getUnitId(), t = this._worksheet.getSheetId(), n = this._injector.get(l), s = {
       startRow: 0,
       endRow: this._worksheet.getRowCount() - 1,
       startColumn: 0,
       endColumn: this._worksheet.getColumnCount() - 1
     };
-    return n.syncExecuteCommand(Et.id, {
+    return n.syncExecuteCommand(Dt.id, {
       unitId: e,
       subUnitId: t,
-      ranges: [r]
+      ranges: [s]
     }), this;
   }
   /**
@@ -2957,7 +3703,7 @@ let g = class extends ne {
   }
   /**
    * Judge whether provided FWorksheet is equal to current.
-   * @param {FWorksheet} other the FWorksheet to compare with.
+   * @param {FWorksheet} other - the FWorksheet to compare with.
    * @returns {boolean} true if the FWorksheet is equal to the current FWorksheet, false otherwise.
    * @example
    * ```ts
@@ -2968,12 +3714,12 @@ let g = class extends ne {
    * ```
    */
   equalTo(e) {
-    return e instanceof g ? this._worksheet.getSheetId() === e.getSheetId() && this._workbook.getUnitId() === e.getWorkbook().getUnitId() : !1;
+    return e instanceof m ? this._worksheet.getSheetId() === e.getSheetId() && this._workbook.getUnitId() === e.getWorkbook().getUnitId() : !1;
   }
   /*
   * Insert a defined name for worksheet.
-   * @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
+   * @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
    * @example
    * ```ts
    * // The code below inserts a defined name
@@ -2983,8 +3729,8 @@ let g = class extends ne {
    * ```
    */
   insertDefinedName(e, t) {
-    const r = this._injector.createInstance(L).setName(e).setRef(t).build();
-    r.localSheetId = this.getSheetId(), this._fWorkbook.insertDefinedNameBuilder(r);
+    const s = this._injector.createInstance(V).setName(e).setRef(t).build();
+    s.localSheetId = this.getSheetId(), this._fWorkbook.insertDefinedNameBuilder(s);
   }
   /**
    * Get all the defined names in the worksheet.
@@ -3002,7 +3748,8 @@ let g = class extends ne {
   }
   /**
    * Set custom metadata of worksheet
-   * @param {CustomData | undefined} custom custom metadata
+   * @param {CustomData | undefined} custom - custom metadata
+   * @returns {FWorksheet}
    * @example
    * ```ts
    * const fWorkbook = univerAPI.getActiveWorkbook();
@@ -3015,8 +3762,9 @@ let g = class extends ne {
   }
   /**
    * Set custom metadata of row
-   * @param {number} index row index
-   * @param {CustomData | undefined} custom custom metadata
+   * @param {number} index - row index
+   * @param {CustomData | undefined} custom - custom metadata
+   * @returns {FWorksheet} Current worksheet, for chaining.
    * @example
    * ```ts
    * const fWorkbook = univerAPI.getActiveWorkbook();
@@ -3029,8 +3777,9 @@ let g = class extends ne {
   }
   /**
    * Set custom metadata of column
-   * @param {number} index column index
-   * @param {CustomData | undefined} custom custom metadata
+   * @param {number} index - column index
+   * @param {CustomData | undefined} custom - custom metadata
+   * @returns {FWorksheet} Current worksheet, for chaining.
    * @example
    * ```ts
    * const fWorkbook = univerAPI.getActiveWorkbook();
@@ -3043,7 +3792,7 @@ let g = class extends ne {
   }
   /**
    * Get custom metadata of row
-   * @param {number} index row index
+   * @param {number} index - row index
    * @returns {CustomData | undefined} custom metadata
    * @example
    * ```ts
@@ -3057,7 +3806,7 @@ let g = class extends ne {
   }
   /**
    * Get custom metadata of column
-   * @param {number} index column index
+   * @param {number} index - column index
    * @returns {CustomData | undefined} custom metadata
    * @example
    * ```ts
@@ -3085,74 +3834,38 @@ let g = class extends ne {
    * ```
    */
   getMergeData() {
-    return this._worksheet.getMergeData().map((e) => this._injector.createInstance(w, this._workbook, this._worksheet, e));
+    return this._worksheet.getMergeData().map((e) => this._injector.createInstance(S, this._workbook, this._worksheet, e));
   }
 };
-g = sn([
-  T(3, u(b)),
-  T(4, u(We)),
-  T(5, u(pe)),
-  T(6, l)
-], g);
-var rn = Object.defineProperty, on = Object.getOwnPropertyDescriptor, an = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? on(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && rn(e, t, r), r;
-}, C = (s, e) => (t, n) => e(t, n, s);
-let I = class extends ne {
-  constructor(e, t, n, r, o, i, a, h, c, d) {
+m = gn([
+  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--)
+    (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) {
     super(t);
-    k(this, "id");
-    k(this, "_eventRegistry", /* @__PURE__ */ new Map());
-    this._workbook = e, this._injector = t, this._resourceLoaderService = n, this._selectionManagerService = r, this._univerInstanceService = o, this._commandService = i, this._permissionService = a, this._logService = h, this._localeService = c, this._definedNamesService = d, this.id = this._workbook.getUnitId();
-  }
-  getWorkbook() {
-    return this._workbook;
-  }
-  _ensureEventRegistry(e) {
-    return this._eventRegistry.has(e) || this._eventRegistry.set(e, new ye()), this._eventRegistry.get(e);
+    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();
   }
   /**
-   * Add an event listener
-   * @param event key of event
-   * @param callback callback when event triggered
-   * @returns {Disposable} The Disposable instance, for remove the listener
+   * Get the Workbook instance.
+   * @returns {Workbook} The Workbook instance.
    * @example
    * ```ts
-   * univerAPI.addEvent(univerAPI.event.UnitCreated, (params) => {
-   *     console.log('unit created', params);
-   * });
-   * ```
-   */
-  addEvent(e, t) {
-    return this._ensureEventRegistry(e).add(t), this.addUIEvent(e, t), F(() => this._ensureEventRegistry(e).delete(t));
-  }
-  /**
-   * Fire an event, used in internal only.
-   * @param event {string} key of event
-   * @param params {any} params of event
-   * @returns {boolean} should cancel
-   * @example
-   * ```ts
-   * this.fireEvent(univerAPI.event.UnitCreated, params);
+   * // The code below gets the Workbook instance
+   * const activeSpreadsheet = univerAPI.getActiveWorkbook();
+   * const workbook = activeSpreadsheet.getWorkbook();
    * ```
    */
-  fireEvent(e, t) {
-    var n;
-    return (n = this._eventRegistry.get(e)) == null || n.getData().forEach((r) => {
-      r(t);
-    }), t.cancel;
-  }
-  addUIEvent(e, t) {
-  }
-  get Enum() {
-    return ze.get();
-  }
-  /**
-   * @returns {FEventName} The event name.
-   */
-  get Event() {
-    return se.get();
+  getWorkbook() {
+    return this._workbook;
   }
   /**
    * Get the id of the workbook.
@@ -3183,6 +3896,7 @@ let I = class extends ne {
   /**
    * Set the name of the workbook.
    * @param {string} name The new name of the workbook.
+   * @returns {void}
    * @example
    * ```ts
    * // The code below sets the name of the workbook
@@ -3208,8 +3922,14 @@ let I = class extends ne {
   }
   /**
    * @deprecated use 'save' instead.
-   * @returns {*}  {IWorkbookData} Workbook snapshot data
+   * @returns {IWorkbookData} Workbook snapshot data
    * @memberof FWorkbook
+   * @example
+   * ```ts
+   * // The code below saves the workbook snapshot data
+   * const activeSpreadsheet = univerAPI.getActiveWorkbook();
+   * const snapshot = activeSpreadsheet.getSnapshot();
+   * ```
    */
   getSnapshot() {
     return this._logService.warn("use 'save' instead of 'getSnapshot'"), this.save();
@@ -3226,7 +3946,7 @@ let I = class extends ne {
    */
   getActiveSheet() {
     const e = this._workbook.getActiveSheet();
-    return this._injector.createInstance(g, this, this._workbook, e);
+    return this._injector.createInstance(m, this, this._workbook, e);
   }
   /**
    * Gets all the worksheets in this workbook
@@ -3239,14 +3959,14 @@ let I = class extends ne {
    * ```
    */
   getSheets() {
-    return this._workbook.getSheets().map((e) => this._injector.createInstance(g, this, this._workbook, e));
+    return this._workbook.getSheets().map((e) => this._injector.createInstance(m, this, this._workbook, e));
   }
   /**
    * Create a new worksheet and returns a handle to it.
-   * @param name Name of the new sheet
-   * @param rows How may rows would the new sheet have
-   * @param column How many columns would the new sheet have
-   * @returns The new created sheet
+   * @param {string} name Name of the new sheet
+   * @param {number} rows How many rows would the new sheet have
+   * @param {number} column How many columns would the new sheet have
+   * @returns {FWorksheet} The new created sheet
    * @example
    * ```ts
    * // The code below creates a new sheet
@@ -3255,24 +3975,24 @@ let I = class extends ne {
    * ```
    */
   create(e, t, n) {
-    const r = $e({});
-    r.rowCount = t, r.columnCount = n, r.name = e, r.id = e.toLowerCase().replace(/ /g, "-"), this._commandService.syncExecuteCommand(x.id, {
+    const s = Ze({});
+    s.rowCount = t, s.columnCount = n, s.name = e, s.id = e.toLowerCase().replace(/ /g, "-"), this._commandService.syncExecuteCommand(T.id, {
       unitId: this.id,
       index: this._workbook.getSheets().length,
-      sheet: r
-    }), this._commandService.syncExecuteCommand(G.id, {
+      sheet: s
+    }), this._commandService.syncExecuteCommand($.id, {
       unitId: this.id,
       subUnitId: this._workbook.getSheets()[this._workbook.getSheets().length - 1].getSheetId()
     });
-    const o = this._workbook.getActiveSheet();
-    if (!o)
+    const i = this._workbook.getActiveSheet();
+    if (!i)
       throw new Error("No active sheet found");
-    return this._injector.createInstance(g, this, this._workbook, o);
+    return this._injector.createInstance(m, this, this._workbook, i);
   }
   /**
    * Get a worksheet by sheet id.
-   * @param sheetId The id of the sheet to get.
-   * @returns The worksheet with given sheet id
+   * @param {string} sheetId The id of the sheet to get.
+   * @returns {FWorksheet | null} The worksheet with given sheet id
    * @example
    * ```ts
    * // The code below gets a worksheet by sheet id
@@ -3282,12 +4002,12 @@ let I = class extends ne {
    */
   getSheetBySheetId(e) {
     const t = this._workbook.getSheetBySheetId(e);
-    return t ? this._injector.createInstance(g, this, this._workbook, t) : null;
+    return t ? this._injector.createInstance(m, this, this._workbook, t) : null;
   }
   /**
    * Get a worksheet by sheet name.
-   * @param name The name of the sheet to get.
-   * @returns The worksheet with given sheet name
+   * @param {string} name The name of the sheet to get.
+   * @returns {FWorksheet | null} The worksheet with given sheet name
    * @example
    * ```ts
    * // The code below gets a worksheet by sheet name
@@ -3297,12 +4017,12 @@ let I = class extends ne {
    */
   getSheetByName(e) {
     const t = this._workbook.getSheetBySheetName(e);
-    return t ? this._injector.createInstance(g, this, this._workbook, t) : null;
+    return t ? this._injector.createInstance(m, this, this._workbook, t) : null;
   }
   /**
    * Sets the given worksheet to be the active worksheet in the workbook.
-   * @param sheet The worksheet to set as the active worksheet.
-   * @returns The active worksheet
+   * @param {FWorksheet | string} sheet The worksheet to set as the active worksheet.
+   * @returns {FWorksheet} The active worksheet
    * @example
    * ```ts
    * // The code below sets the given worksheet to be the active worksheet
@@ -3312,16 +4032,16 @@ let I = class extends ne {
    * ```
    */
   setActiveSheet(e) {
-    return this._commandService.syncExecuteCommand(G.id, {
+    return this._commandService.syncExecuteCommand($.id, {
       unitId: this.id,
-      subUnitId: e.getSheetId()
-    }), e;
+      subUnitId: typeof e == "string" ? e : e.getSheetId()
+    }), typeof e == "string" ? this.getSheetBySheetId(e) : e;
   }
   /**
    * Inserts a new worksheet into the workbook.
    * Using a default sheet name. The new sheet becomes the active sheet
-   * @param sheetName - (optional) The name of the new sheet
-   * @returns The new sheet
+   * @param {string} [sheetName] The name of the new sheet
+   * @returns {FWorksheet} The new sheet
    * @example
    * ```ts
    * // The code below inserts a new sheet into the workbook
@@ -3334,20 +4054,20 @@ let I = class extends ne {
    * ```
    */
   insertSheet(e) {
-    e != null ? this._commandService.syncExecuteCommand(x.id, { sheet: { name: e } }) : this._commandService.syncExecuteCommand(x.id);
+    e != null ? this._commandService.syncExecuteCommand(T.id, { sheet: { name: e } }) : this._commandService.syncExecuteCommand(T.id);
     const t = this.id, n = this._workbook.getSheets()[this._workbook.getSheets().length - 1].getSheetId();
-    this._commandService.syncExecuteCommand(G.id, {
+    this._commandService.syncExecuteCommand($.id, {
       unitId: t,
       subUnitId: n
     });
-    const r = this._workbook.getActiveSheet();
-    if (!r)
+    const s = this._workbook.getActiveSheet();
+    if (!s)
       throw new Error("No active sheet found");
-    return this._injector.createInstance(g, this, this._workbook, r);
+    return this._injector.createInstance(m, this, this._workbook, s);
   }
   /**
    * Deletes the specified worksheet.
-   * @param sheet The worksheet to delete.
+   * @param {FWorksheet | string} sheet The worksheet to delete.
    * @returns {boolean} True if the worksheet was deleted, false otherwise.
    * @example
    * ```ts
@@ -3358,8 +4078,8 @@ let I = class extends ne {
    * ```
    */
   deleteSheet(e) {
-    const t = this.id, n = e.getSheetId();
-    return this._commandService.syncExecuteCommand(Pt.id, {
+    const t = this.id, n = typeof e == "string" ? e : e.getSheetId();
+    return this._commandService.syncExecuteCommand(oe.id, {
       unitId: t,
       subUnitId: n
     });
@@ -3376,11 +4096,11 @@ let I = class extends ne {
    * ```
    */
   undo() {
-    return this._univerInstanceService.focusUnit(this.id), this._commandService.syncExecuteCommand(He.id), this;
+    return this._univerInstanceService.focusUnit(this.id), this._commandService.syncExecuteCommand(et.id), this;
   }
   /**
    * Redo the last undone action.
-   * @returns A promise that resolves to true if the redo was successful, false otherwise.
+   * @returns {FWorkbook} A promise that resolves to true if the redo was successful, false otherwise.
    * @example
    * ```ts
    * // The code below redoes the last undone action
@@ -3389,7 +4109,7 @@ let I = class extends ne {
    * ```
    */
   redo() {
-    return this._univerInstanceService.focusUnit(this.id), this._commandService.syncExecuteCommand(Ge.id), this;
+    return this._univerInstanceService.focusUnit(this.id), this._commandService.syncExecuteCommand(tt.id), this;
   }
   /**
    * Callback for command execution.
@@ -3399,7 +4119,7 @@ let I = class extends ne {
   /**
    * Register a callback that will be triggered before invoking a command targeting the Univer sheet.
    * @param {onBeforeCommandExecuteCallback} callback the callback.
-   * @returns A function to dispose the listening.
+   * @returns {IDisposable} A function to dispose the listening.
    * @example
    * ```ts
    * // The code below registers a callback that will be triggered before invoking a command targeting the Univer sheet
@@ -3423,7 +4143,7 @@ let I = class extends ne {
   /**
    * Register a callback that will be triggered when a command is invoked targeting the Univer sheet.
    * @param {onCommandExecutedCallback} callback the callback.
-   * @returns A function to dispose the listening.
+   * @returns {IDisposable} A function to dispose the listening.
    * @example
    * ```ts
    * // The code below registers a callback that will be triggered when a command is invoked targeting the Univer sheet
@@ -3431,6 +4151,7 @@ let I = class extends ne {
    * activeSpreadsheet.onCommandExecuted((command) => {
    *   console.log('Command executed:', command);
    * });
+   * ```
    */
   onCommandExecuted(e) {
     return this._commandService.onCommandExecuted((t) => {
@@ -3446,12 +4167,12 @@ let I = class extends ne {
   /**
    * Register a callback that will be triggered when the selection changes.
    * @param {onSelectionChangeCallback} callback The callback.
-   * @returns A function to dispose the listening
+   * @returns {IDisposable} A function to dispose the listening
    */
   onSelectionChange(e) {
-    return F(
+    return Ae(
       this._selectionManagerService.selectionMoveEnd$.subscribe((t) => {
-        this._univerInstanceService.getCurrentUnitForType(R.UNIVER_SHEET).getUnitId() === this.id && (t != null && t.length ? e(t.map((n) => n.range)) : e([]));
+        this._univerInstanceService.getCurrentUnitForType(p.UNIVER_SHEET).getUnitId() === this.id && (t != null && t.length ? e(t.map((n) => n.range)) : e([]));
       })
     );
   }
@@ -3461,34 +4182,34 @@ let I = class extends ne {
    * @returns {FWorkbook} FWorkbook instance
    */
   setEditable(e) {
-    const t = new Ne(this._workbook.getUnitId());
+    const t = new Le(this._workbook.getUnitId());
     return this._permissionService.getPermissionPoint(t.id) || this._permissionService.addPermissionPoint(t), this._permissionService.updatePermissionPoint(t.id, e), this;
   }
   /**
    * Sets the selection region for active sheet.
-   * @param range The range to set as the active selection.
+   * @param {FRange} range The range to set as the active selection.
    * @returns {FWorkbook} FWorkbook instance
    */
   setActiveRange(e) {
-    const t = this.getActiveSheet(), n = e.getRange().sheetId || t.getSheetId(), r = n ? this._workbook.getSheetBySheetId(n) : this._workbook.getActiveSheet(!0);
-    if (!r)
+    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");
-    r.getSheetId() !== t.getSheetId() && this.setActiveSheet(this._injector.createInstance(g, this, this._workbook, r));
-    const o = {
+    s.getSheetId() !== t.getSheetId() && this.setActiveSheet(this._injector.createInstance(m, this, this._workbook, s));
+    const i = {
       unitId: this.getId(),
       subUnitId: n,
-      selections: [e].map((i) => ({ range: i.getRange(), primary: Z(i.getRange(), r), style: null }))
+      selections: [e].map((o) => ({ range: o.getRange(), primary: ee(o.getRange(), s), style: null }))
     };
-    return this._commandService.syncExecuteCommand(De.id, o), this;
+    return this._commandService.syncExecuteCommand(He.id, i), this;
   }
   /**
    * Returns the selected range in the active sheet, or null if there is no active range.
-   * @returns the active range
+   * @returns {FRange | null} The active range
    */
   // could sheet have no active range ?
   getActiveRange() {
-    const e = this._workbook.getActiveSheet(), n = this._selectionManagerService.getCurrentSelections().find((r) => !!r.primary);
-    return n ? this._injector.createInstance(w, this._workbook, e, n.range) : null;
+    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;
   }
   /**
    * Deletes the currently active sheet.
@@ -3517,17 +4238,16 @@ let I = class extends ne {
    * ```
    */
   duplicateSheet(e) {
-    return this._commandService.syncExecuteCommand(xt.id, {
+    return this._commandService.syncExecuteCommand(At.id, {
       unitId: e.getWorkbook().getUnitId(),
       subUnitId: e.getSheetId()
-    }), this._injector.createInstance(g, this, this._workbook, this._workbook.getActiveSheet());
+    }), this._injector.createInstance(m, this, this._workbook, this._workbook.getActiveSheet());
   }
   /**
    * Duplicates the active sheet.
    * @returns {FWorksheet} The duplicated worksheet
    * @example
    * ```ts
-   * // The code below duplicates the active sheet
    *  const activeSpreadsheet = univerAPI.getActiveWorkbook();
    *  activeSpreadsheet.duplicateActiveSheet();
    * ```
@@ -3538,7 +4258,7 @@ let I = class extends ne {
   }
   /**
    * Get the number of sheets in the workbook.
-   * @returns The number of sheets in the workbook
+   * @returns {number} The number of sheets in the workbook
    * @example
    * ```ts
    * // The code below gets the number of sheets in the workbook
@@ -3611,7 +4331,7 @@ let I = class extends ne {
    */
   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(Nt.id, {
+    return n < 0 ? n = 0 : n > this._workbook.getSheets().length - 1 && (n = this._workbook.getSheets().length - 1), this._commandService.syncExecuteCommand(he.id, {
       unitId: e.getWorkbook().getUnitId(),
       order: n,
       subUnitId: e.getSheetId()
@@ -3637,7 +4357,7 @@ let I = class extends ne {
    * @returns {FPermission} - The PermissionInstance.
    */
   getPermission() {
-    return this._injector.createInstance(O);
+    return this._injector.createInstance(j);
   }
   /**
    * Get the defined name by name.
@@ -3652,7 +4372,7 @@ let I = class extends ne {
    */
   getDefinedName(e) {
     const t = this._definedNamesService.getValueByName(this.id, e);
-    return t ? this._injector.createInstance(j, { ...t, unitId: this.id }) : null;
+    return t ? this._injector.createInstance(F, { ...t, unitId: this.id }) : null;
   }
   /**
    * Get all the defined names in the workbook.
@@ -3666,7 +4386,7 @@ let I = class extends ne {
    */
   getDefinedNames() {
     const e = this._definedNamesService.getDefinedNameMap(this.id);
-    return e ? Object.values(e).map((t) => this._injector.createInstance(j, { ...t, unitId: this.id })) : [];
+    return e ? Object.values(e).map((t) => this._injector.createInstance(F, { ...t, unitId: this.id })) : [];
   }
   /**
    * Insert a defined name.
@@ -3681,8 +4401,8 @@ let I = class extends ne {
    * ```
    */
   insertDefinedName(e, t) {
-    const r = this._injector.createInstance(L).setName(e).setRef(t).build();
-    return r.localSheetId = X, this.insertDefinedNameBuilder(r), this;
+    const s = this._injector.createInstance(V).setName(e).setRef(t).build();
+    return s.localSheetId = X, this.insertDefinedNameBuilder(s), this;
   }
   /**
    * Delete the defined name with the given name.
@@ -3702,6 +4422,7 @@ let I = class extends ne {
   /**
    * Insert a defined name by builder param.
    * @param {ISetDefinedNameMutationParam} param The param to insert the defined name
+   * @returns {void}
    * @example
    * ```ts
    * // The code below inserts a defined name by builder param
@@ -3717,6 +4438,7 @@ let I = class extends ne {
   /**
    * Update the defined name with the given name.
    * @param {ISetDefinedNameMutationParam} param The param to insert the defined name
+   * @returns {void}
    * @example
    * ```ts
    * // The code below updates the defined name with the given name
@@ -3741,11 +4463,12 @@ let I = class extends ne {
    * ```
    */
   getRegisteredRangeThemes() {
-    return this._injector.get(Me).getRegisteredRangeThemes();
+    return this._injector.get(Ve).getRegisteredRangeThemes();
   }
   /**
    * Register a custom range theme style.
-   * @param rangeThemeStyle
+   * @param {RangeThemeStyle} rangeThemeStyle The range theme style to register
+   * @returns {void}
    * @example
    * ```ts
    * // import {RangeThemeStyle} from '@univerjs/sheets';
@@ -3760,14 +4483,15 @@ let I = class extends ne {
    * ```
    */
   registerRangeTheme(e) {
-    this._commandService.syncExecuteCommand(Mt.id, {
+    this._commandService.syncExecuteCommand(Bt.id, {
       unitId: this.getId(),
       rangeThemeStyle: e
     });
   }
   /**
    * Unregister a custom range theme style.
-   * @param themeName
+   * @param {string} themeName The name of the theme to unregister
+   * @returns {void}
    * @example
    * ```ts
    * const fWorkbook = univerAPI.getActiveWorkbook();
@@ -3775,7 +4499,7 @@ let I = class extends ne {
    * ```
    */
   unregisterRangeTheme(e) {
-    this._commandService.syncExecuteCommand(Dt.id, {
+    this._commandService.syncExecuteCommand(Wt.id, {
       unitId: this.getId(),
       themeName: e
     });
@@ -3806,42 +4530,42 @@ let I = class extends ne {
     return this._workbook.getCustomMetadata();
   }
 };
-I = an([
-  C(1, u(b)),
-  C(2, u(Le)),
-  C(3, u(We)),
+f = _n([
+  C(1, u(y)),
+  C(2, u(Xe)),
+  C(3, u(ze)),
   C(4, J),
   C(5, l),
-  C(6, ee),
-  C(7, pe),
-  C(8, u(Re)),
-  C(9, Te)
-], I);
-class hn extends Ue {
+  C(6, ae),
+  C(7, De),
+  C(8, u(Te)),
+  C(9, $e)
+], f);
+class kn extends Be {
   getCommandSheetTarget(e) {
-    var o;
+    var i;
     const t = e.params;
     if (!t) return;
-    const n = t.unitId ? this.getUniverSheet(t.unitId) : (o = this.getActiveWorkbook) == null ? void 0 : o.call(this);
+    const n = t.unitId ? this.getUniverSheet(t.unitId) : (i = this.getActiveWorkbook) == null ? void 0 : i.call(this);
     if (!n)
       return;
-    const r = n.getSheetBySheetId(t.subUnitId || t.sheetId) || n.getActiveSheet();
-    if (r)
-      return { workbook: n, worksheet: r };
+    const s = n.getSheetBySheetId(t.subUnitId || t.sheetId) || n.getActiveSheet();
+    if (s)
+      return { workbook: n, worksheet: s };
   }
   getSheetTarget(e, t) {
     const n = this.getUniverSheet(e);
     if (!n)
       return;
-    const r = n.getSheetBySheetId(t);
-    if (r)
-      return { workbook: n, worksheet: r };
+    const s = n.getSheetBySheetId(t);
+    if (s)
+      return { workbook: n, worksheet: s };
   }
   _initWorkbookEvent(e) {
     const t = e.get(J);
     this.disposeWithMe(
       t.unitDisposed$.subscribe((n) => {
-        this._eventRegistry.get(this.Event.WorkbookDisposed) && n.type === R.UNIVER_SHEET && this.fireEvent(
+        this._eventRegistry.get(this.Event.WorkbookDisposed) && n.type === p.UNIVER_SHEET && this.fireEvent(
           this.Event.WorkbookDisposed,
           {
             unitId: n.getUnitId(),
@@ -3852,59 +4576,142 @@ class hn extends Ue {
       })
     ), this.disposeWithMe(
       t.unitAdded$.subscribe((n) => {
-        if (this._eventRegistry.get(this.Event.WorkbookCreated) && n.type === R.UNIVER_SHEET) {
-          const r = n, o = e.createInstance(I, r);
+        if (this._eventRegistry.get(this.Event.WorkbookCreated) && n.type === p.UNIVER_SHEET) {
+          const s = n, i = e.createInstance(f, s);
           this.fireEvent(
             this.Event.WorkbookCreated,
             {
               unitId: n.getUnitId(),
               type: n.type,
-              workbook: o,
-              unit: o
+              workbook: i,
+              unit: i
             }
           );
         }
       })
     );
   }
+  // eslint-disable-next-line max-lines-per-function
   _initialize(e) {
     const t = e.get(l);
     this.disposeWithMe(
+      // eslint-disable-next-line max-lines-per-function, complexity
       t.beforeCommandExecuted((n) => {
-        var r;
+        var s, i, o, h;
         switch (n.id) {
-          case x.id: {
-            const o = n.params, { unitId: i, index: a, sheet: h } = o || {}, c = i ? this.getUniverSheet(i) : (r = this.getActiveWorkbook) == null ? void 0 : r.call(this);
-            if (!c)
+          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)
               return;
-            const d = {
-              workbook: c,
-              index: a,
-              sheet: h
+            const ge = {
+              workbook: k,
+              index: c,
+              sheet: v
             };
             if (this.fireEvent(
               this.Event.BeforeSheetCreate,
-              d
-            ), d.cancel)
-              throw new qe();
+              ge
+            ), ge.cancel)
+              throw new nt();
+            break;
+          }
+          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);
+            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;
+            this._fireBeforeSheetDelete(d, c);
+            break;
+          }
+          case he.id: {
+            if (!this._eventListend(this.Event.BeforeSheetMove)) return;
+            const { fromOrder: a, toOrder: d } = n.params, c = this.getCommandSheetTarget(n);
+            if (!c) return;
+            this._fireBeforeSheetMove(c.workbook, c.worksheet, d, a);
+            break;
+          }
+          case ie.id: {
+            if (!this._eventListend(this.Event.BeforeSheetNameChange)) return;
+            const { name: a } = n.params, d = this.getCommandSheetTarget(n);
+            if (!d) return;
+            this._fireBeforeSheetNameChange(d.workbook, d.worksheet, a, d.worksheet.getSheetName());
+            break;
+          }
+          case re.id: {
+            if (!this._eventListend(this.Event.BeforeSheetTabColorChange)) return;
+            const { color: a } = n.params, d = this.getCommandSheetTarget(n);
+            if (!d) return;
+            this._fireBeforeSheetTabColorChange(d.workbook, d.worksheet, a, d.worksheet.getTabColor());
+            break;
+          }
+          case se.id: {
+            if (!this._eventListend(this.Event.BeforeSheetHideChange)) return;
+            const { hidden: a } = n.params, d = this.getCommandSheetTarget(n);
+            if (!d) return;
+            this._fireBeforeSheetHideChange(d.workbook, d.worksheet, !!a);
+            break;
+          }
+          case ne.id: {
+            if (!this._eventListend(this.Event.BeforeGridlineColorChange)) return;
+            const a = this.getCommandSheetTarget(n);
+            if (!a) return;
+            this.fireEvent(this.Event.BeforeGridlineColorChange, {
+              ...a,
+              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;
+            this.fireEvent(this.Event.BeforeGridlineEnableChange, {
+              ...a,
+              enabled: !!((h = n.params) != null && h.showGridlines)
+            });
             break;
           }
         }
       })
     ), this.disposeWithMe(
+      // eslint-disable-next-line max-lines-per-function, complexity
       t.onCommandExecuted((n) => {
-        var r;
+        var s, i;
+        if (Ft.indexOf(n.id) > -1) {
+          if (!this._eventListend(this.Event.SheetValueChanged) || !this.getActiveSheet()) return;
+          const h = jt(n).map(
+            (a) => {
+              var d, c;
+              return (c = (d = this.getWorkbook(a.unitId)) == null ? void 0 : d.getSheetBySheetId(a.subUnitId)) == null ? void 0 : c.getRange(a.range);
+            }
+          ).filter(Boolean);
+          if (!h.length) return;
+          this.fireEvent(this.Event.SheetValueChanged, {
+            payload: n,
+            effectedRanges: h
+          });
+          return;
+        }
         switch (n.id) {
-          case x.id: {
-            const o = n.params, { unitId: i } = o || {}, a = i ? this.getUniverSheet(i) : (r = this.getActiveWorkbook) == null ? void 0 : r.call(this);
+          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)
               return;
-            const h = a.getActiveSheet();
-            if (!h)
+            const d = a.getActiveSheet();
+            if (!d)
               return;
             const c = {
               workbook: a,
-              worksheet: h
+              worksheet: d
             };
             this.fireEvent(
               this.Event.SheetCreated,
@@ -3912,47 +4719,202 @@ class hn extends Ue {
             );
             break;
           }
+          case Ue.id: {
+            if (!this._eventListend(this.Event.ActiveSheetChanged)) return;
+            const o = this.getActiveSheet();
+            if (!o) return;
+            const { workbook: h, worksheet: a } = o;
+            this._fireActiveSheetChanged(h, a);
+            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);
+            break;
+          }
+          case he.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);
+            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);
+            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);
+            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);
+            break;
+          }
+          case ne.id:
+          case te.id: {
+            if (!this._eventListend(this.Event.GridlineChanged)) return;
+            const o = this.getCommandSheetTarget(n);
+            if (!o) return;
+            this.fireEvent(this.Event.GridlineChanged, {
+              ...o,
+              enabled: !o.worksheet.hasHiddenGridLines(),
+              color: o.worksheet.getGridLinesColor()
+            });
+            break;
+          }
         }
       })
     ), this._initWorkbookEvent(e);
   }
   createUniverSheet(e) {
-    const n = this._injector.get(J).createUnit(R.UNIVER_SHEET, e);
-    return this._injector.createInstance(I, n);
+    const n = this._injector.get(J).createUnit(p.UNIVER_SHEET, e);
+    return this._injector.createInstance(f, n);
   }
   createWorkbook(e) {
     return this.createUniverSheet(e);
   }
   getActiveWorkbook() {
-    const e = this._univerInstanceService.getCurrentUnitForType(R.UNIVER_SHEET);
-    return e ? this._injector.createInstance(I, e) : null;
+    const e = this._univerInstanceService.getCurrentUnitForType(p.UNIVER_SHEET);
+    return e ? this._injector.createInstance(f, e) : null;
   }
   getActiveUniverSheet() {
     return this.getActiveWorkbook();
   }
   getUniverSheet(e) {
-    const t = this._univerInstanceService.getUnit(e, R.UNIVER_SHEET);
-    return t ? this._injector.createInstance(I, t) : null;
+    const t = this._univerInstanceService.getUnit(e, p.UNIVER_SHEET);
+    return t ? this._injector.createInstance(f, t) : null;
   }
   getWorkbook(e) {
     return this.getUniverSheet(e);
   }
   getPermission() {
-    return this._injector.createInstance(O);
+    return this._injector.createInstance(j);
   }
   onUniverSheetCreated(e) {
-    const t = this._univerInstanceService.getTypeOfUnitAdded$(R.UNIVER_SHEET).subscribe((n) => {
-      const r = this._injector.createInstance(I, n);
-      e(r);
+    const t = this._univerInstanceService.getTypeOfUnitAdded$(p.UNIVER_SHEET).subscribe((n) => {
+      const s = this._injector.createInstance(f, n);
+      e(s);
     });
-    return F(t);
+    return Ae(t);
   }
   newDefinedName() {
-    return this._injector.createInstance(L);
+    return this._injector.createInstance(V);
+  }
+  getActiveSheet() {
+    const e = this.getActiveWorkbook();
+    if (!e)
+      return null;
+    const t = e.getActiveSheet();
+    return t ? { workbook: e, worksheet: t } : null;
+  }
+  _fireBeforeActiveSheetChange(e, t, n) {
+    this.fireEvent(this.Event.BeforeActiveSheetChange, {
+      workbook: e,
+      activeSheet: t,
+      oldActiveSheet: n
+    });
+  }
+  _fireActiveSheetChanged(e, t) {
+    this.fireEvent(this.Event.ActiveSheetChanged, {
+      workbook: e,
+      activeSheet: t
+    });
+  }
+  _fireBeforeSheetDelete(e, t) {
+    this.fireEvent(this.Event.BeforeSheetDelete, {
+      workbook: e,
+      worksheet: t
+    });
+  }
+  _fireSheetDeleted(e, t) {
+    this.fireEvent(this.Event.SheetDeleted, {
+      workbook: e,
+      sheetId: t
+    });
+  }
+  _fireBeforeSheetMove(e, t, n, s) {
+    this.fireEvent(this.Event.BeforeSheetMove, {
+      workbook: e,
+      worksheet: t,
+      newIndex: n,
+      oldIndex: s
+    });
+  }
+  _fireSheetMoved(e, t, n) {
+    this.fireEvent(this.Event.SheetMoved, {
+      workbook: e,
+      worksheet: t,
+      newIndex: n
+    });
+  }
+  _fireBeforeSheetNameChange(e, t, n, s) {
+    this.fireEvent(this.Event.BeforeSheetNameChange, {
+      workbook: e,
+      worksheet: t,
+      newName: n,
+      oldName: s
+    });
+  }
+  _fireSheetNameChanged(e, t, n) {
+    this.fireEvent(this.Event.SheetNameChanged, {
+      workbook: e,
+      worksheet: t,
+      newName: n
+    });
+  }
+  _fireBeforeSheetTabColorChange(e, t, n, s) {
+    this.fireEvent(this.Event.BeforeSheetTabColorChange, {
+      workbook: e,
+      worksheet: t,
+      newColor: n,
+      oldColor: s
+    });
+  }
+  _fireSheetTabColorChanged(e, t, n) {
+    this.fireEvent(this.Event.SheetTabColorChanged, {
+      workbook: e,
+      worksheet: t,
+      newColor: n
+    });
+  }
+  _fireBeforeSheetHideChange(e, t, n) {
+    this.fireEvent(this.Event.BeforeSheetHideChange, {
+      workbook: e,
+      worksheet: t,
+      hidden: n
+    });
+  }
+  _fireSheetHideChanged(e, t, n) {
+    this.fireEvent(this.Event.SheetHideChanged, {
+      workbook: e,
+      worksheet: t,
+      hidden: n
+    });
+  }
+}
+Be.extend(kn);
+class Sn {
+  get SheetValueChangeType() {
+    return Ot;
+  }
+  get SheetSkeletonChangeType() {
+    return Lt;
   }
 }
-Ue.extend(hn);
-class cn extends se {
+rt.extend(Sn);
+class wn extends We {
   get SheetCreated() {
     return "SheetCreated";
   }
@@ -3965,27 +4927,76 @@ class cn extends se {
   get WorkbookDisposed() {
     return "WorkbookDisposed";
   }
+  get GridlineChanged() {
+    return "GridlineChanged";
+  }
+  get BeforeGridlineEnableChange() {
+    return "BeforeGridlineEnableChange";
+  }
+  get BeforeGridlineColorChange() {
+    return "BeforeGridlineColorChange";
+  }
+  get BeforeActiveSheetChange() {
+    return "BeforeActiveSheetChange";
+  }
+  get ActiveSheetChanged() {
+    return "ActiveSheetChanged";
+  }
+  get SheetDeleted() {
+    return "SheetDeleted";
+  }
+  get BeforeSheetDelete() {
+    return "BeforeSheetDelete";
+  }
+  get SheetMoved() {
+    return "SheetMoved";
+  }
+  get BeforeSheetMove() {
+    return "BeforeSheetMove";
+  }
+  get SheetNameChanged() {
+    return "SheetNameChanged";
+  }
+  get BeforeSheetNameChange() {
+    return "BeforeSheetNameChange";
+  }
+  get SheetTabColorChanged() {
+    return "SheetTabColorChanged";
+  }
+  get BeforeSheetTabColorChange() {
+    return "BeforeSheetTabColorChange";
+  }
+  get SheetHideChanged() {
+    return "SheetHideChanged";
+  }
+  get BeforeSheetHideChange() {
+    return "BeforeSheetHideChange";
+  }
+  get SheetValueChanged() {
+    return "SheetValueChanged";
+  }
 }
-se.extend(cn);
-var dn = Object.defineProperty, un = Object.getOwnPropertyDescriptor, mn = (s, e, t, n) => {
-  for (var r = n > 1 ? void 0 : n ? un(e, t) : e, o = s.length - 1, i; o >= 0; o--)
-    (i = s[o]) && (r = (n ? i(e, t, r) : i(r)) || r);
-  return n && r && dn(e, t, r), r;
-}, ln = (s, e) => (t, n) => e(t, n, s);
-let fe = class extends te {
-  constructor(s) {
-    super(), this._injector = s;
+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--)
+    (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);
+let xe = class extends de {
+  constructor(r) {
+    super(), this._injector = r;
   }
 };
-fe = mn([
-  ln(0, u(b))
-], fe);
+xe = vn([
+  In(0, u(y))
+], xe);
 export {
-  O as FPermission,
-  w as FRange,
-  B as FSelection,
-  cn as FSheetEventName,
-  fe as FSheetHooks,
-  I as FWorkbook,
-  g as FWorksheet
+  j as FPermission,
+  S as FRange,
+  L as FSelection,
+  wn as FSheetEventName,
+  xe as FSheetHooks,
+  Sn as FSheetsEnum,
+  f as FWorkbook,
+  m as FWorksheet
 };