@univerjs/sheets 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/locale/zh-CN.js

@@ -17,7 +17,7 @@ const locale = { sheets: {
 		nameSheetConflict: "名称与工作表名称冲突",
 		formulaOrRefStringEmpty: "公式或引用字符串不能为空",
 		nameConflict: "名称与函数名称冲突",
-		defaultName: "DefinedName"
+		defaultName: "定义名称"
 	},
 	permission: { dialog: {
 		autoFillErr: "该范围已被保护，目前无自动填充权限。如需自动填充，请联系创建者。",

package/lib/locale/zh-HK.js

@@ -17,7 +17,7 @@ const locale = { sheets: {
 		nameSheetConflict: "名稱與工作表名稱衝突",
 		formulaOrRefStringEmpty: "公式或引用字串不能為空",
 		nameConflict: "名稱與函數名稱衝突",
-		defaultName: "DefinedName"
+		defaultName: "定義名稱"
 	},
 	permission: { dialog: {
 		autoFillErr: "範圍已被保護，目前無自動填入權限。如需自動填充，請聯絡建立者。 ",

package/lib/locale/zh-TW.js

@@ -17,7 +17,7 @@ const locale = { sheets: {
 		nameSheetConflict: "名稱與工作表名稱衝突",
 		formulaOrRefStringEmpty: "公式或引用字串不能為空",
 		nameConflict: "名稱與函數名稱衝突",
-		defaultName: "DefinedName"
+		defaultName: "定義名稱"
 	},
 	permission: { dialog: {
 		autoFillErr: "範圍已被保護，目前無自動填入權限。如需自動填充，請聯絡建立者。 ",

package/lib/types/basics/cell-type.d.ts

@@ -13,8 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { CellValue, ICellData, Nullable, Styles } from '@univerjs/core';
+import type { CellValue, ICellData, IDocumentData, Nullable, Styles } from '@univerjs/core';
 import { CellValueType } from '@univerjs/core';
+export declare function isCellImage(documentData: Nullable<IDocumentData>): boolean;
 /**
  * Get cell value type by style, new value and old value.
  * If the new value contains t, then take t directly. In other cases, we need to dynamically determine based on actual data and styles

package/lib/types/basics/selection.d.ts

@@ -161,12 +161,3 @@ export declare function convertPrimaryWithCoordToPrimary(primaryWithCoord: ICell
     endRow: number;
     endColumn: number;
 };
-/**
- * @deprecated Use worksheet.getCellInfoInMergeData or SpreadsheetSkeleton.getCellByIndex instead
- * Convert the coordinates of a single cell into a selection data.
- * @param row Specified Row Coordinate
- * @param column Specified Column Coordinate
- * @param mergeData  Obtain the data of merged cells through the worksheet object.
- * @returns ISelectionWithStyle
- */
-export declare function transformCellDataToSelectionData(row: number, column: number, mergeData: IRange[]): Nullable<ISelectionWithStyle>;

package/lib/types/commands/commands/remove-row-col.command.d.ts

@@ -19,6 +19,8 @@ export interface IRemoveRowColCommandParams extends Partial<ISheetCommandSharedP
     range: IRange;
 }
 export interface IRemoveRowColCommandInterceptParams extends IRemoveRowColCommandParams {
+    unitId: string;
+    subUnitId: string;
     ranges?: IRange[];
 }
 export interface IRemoveRowByRangeCommandParams {

package/lib/types/commands/utils/selection-command-util.d.ts

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IAccessor } from '@univerjs/core';
+import type { IAccessor, IRange } from '@univerjs/core';
 import { SheetsSelectionsService } from '../../services/selections/selection.service';
+export declare function hasOverlappingRanges(ranges: readonly IRange[]): boolean;
 export declare function getSelectionsService(accessor: IAccessor, fromCurrentSelection?: boolean): SheetsSelectionsService;

package/lib/types/facade/f-worksheet.d.ts

@@ -309,7 +309,7 @@ export declare class FWorksheet extends FBaseInitialable {
     getMaxRows(): number;
     /**
      * 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 existing row after which the new row should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
      * @returns {FWorksheet} This sheet, for chaining.
      * @example
      * ```typescript
@@ -324,7 +324,7 @@ export declare class FWorksheet extends FBaseInitialable {
     insertRowAfter(afterPosition: number): FWorksheet;
     /**
      * 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 existing row before which the new row should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
      * @returns {FWorksheet} This sheet, for chaining.
      * @example
      * ```typescript
@@ -339,8 +339,8 @@ export declare class FWorksheet extends FBaseInitialable {
     insertRowBefore(beforePosition: number): FWorksheet;
     /**
      * Inserts one or more consecutive blank rows in a sheet starting at the specified location.
-     * @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.
+     * @param {number} rowIndex - The existing row before which rows are inserted. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
+     * @param {number} numRows - The positive number of rows to insert.
      * @returns {FWorksheet} This sheet, for chaining.
      * @example
      * ```typescript
@@ -355,8 +355,8 @@ export declare class FWorksheet extends FBaseInitialable {
     insertRows(rowIndex: number, numRows?: number): FWorksheet;
     /**
      * Inserts a number of rows after the given row position.
-     * @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.
+     * @param {number} afterPosition - The existing row after which the new rows should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
+     * @param {number} howMany - The positive number of rows to insert.
      * @returns {FWorksheet} This sheet, for chaining.
      * @example
      * ```typescript
@@ -371,8 +371,8 @@ export declare class FWorksheet extends FBaseInitialable {
     insertRowsAfter(afterPosition: number, howMany: number): FWorksheet;
     /**
      * Inserts a number of rows before the given row position.
-     * @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.
+     * @param {number} beforePosition - The existing row before which the new rows should be added. The index is zero-based and must be between 0 and `getMaxRows() - 1`.
+     * @param {number} howMany - The positive number of rows to insert.
      * @returns {FWorksheet} This sheet, for chaining.
      * @example
      * ```typescript
@@ -1525,7 +1525,8 @@ export declare class FWorksheet extends FBaseInitialable {
      */
     getColumnCustomMetadata(index: number): CustomData | undefined;
     /**
-     * Appends a row to the bottom of the current data region in the sheet. If a cell's content begins with =, it's interpreted as a formula.
+     * Appends a row to the bottom of the current data region in the sheet. If the destination row is already within the worksheet capacity,
+     * this method writes into that row without increasing `getMaxRows()`. If a cell's content begins with =, it's interpreted as a formula.
      * @param {CellValue[]} rowContents - An array of values for the new row.
      * @returns {FWorksheet} Returns the current worksheet instance for method chaining.
      * @example

package/lib/types/facade/index.d.ts

@@ -19,7 +19,6 @@ export * from './f-enum';
 export * from './f-event';
 export { FRange } from './f-range';
 export { FSelection } from './f-selection';
-export type { FSheetEmbedUnitFacadeMapAugmentation } from './f-types';
 export type * from './f-univer';
 export { FWorkbook } from './f-workbook';
 export { FWorksheet } from './f-worksheet';

package/lib/types/index.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 export type { ICellOverGridPosition, ISheetOverGridPosition } from './basics/cell-position';
-export { checkCellValueType } from './basics/cell-type';
+export { checkCellValueType, isCellImage } from './basics/cell-type';
 export { COMMAND_LISTENER_SKELETON_CHANGE, COMMAND_LISTENER_VALUE_CHANGE, getSkeletonChangedEffectedRange, getValueChangedEffectedRange, SheetSkeletonChangeType, SheetValueChangeType, } from './basics/const/command-listener-const';
 export type { CommandListenerSkeletonChange, CommandListenerValueChange } from './basics/const/command-listener-const';
 export { validateDefinedName } from './basics/defined-name-utils';

package/lib/types/models/range-protection-render.model.d.ts

@@ -15,13 +15,13 @@
  */
 import type { IRange } from '@univerjs/core';
 import type { UnitAction } from '@univerjs/protocol';
-import { IPermissionService } from '@univerjs/core';
+import { Disposable, IPermissionService } from '@univerjs/core';
 import { RangeProtectionRuleModel } from './range-protection-rule.model';
 export type ICellPermission = Record<UnitAction, boolean> & {
     ruleId?: string;
     ranges?: IRange[];
 };
-export declare class RangeProtectionRenderModel {
+export declare class RangeProtectionRenderModel extends Disposable {
     private _selectionProtectionRuleModel;
     private _permissionService;
     private _cache;
@@ -30,4 +30,5 @@ export declare class RangeProtectionRenderModel {
     private _createKey;
     getCellInfo(unitId: string, subUnitId: string, row: number, col: number): ICellPermission[];
     clear(): void;
+    dispose(): void;
 }

package/lib/types/services/ref-range/ref-range.service.d.ts

@@ -38,6 +38,8 @@ export declare class RefRangeService extends Disposable {
         MERGE_UNDO: import("@univerjs/core").IInterceptor<IMutationInfo<object>[], null>;
     }>;
     private _watchRanges;
+    private _watchRangesListener;
+    private _watchRangeRevision;
     constructor(_commandService: ICommandService, _sheetInterceptorService: SheetInterceptorService, _univerInstanceService: IUniverInstanceService, _selectionManagerService: SheetsSelectionsService);
     watchRange(unitId: string, subUnitId: string, range: IRange, callback: WatchRangeCallback, skipIntersects?: boolean): IDisposable;
     private _refRangeManagerMap;

package/lib/types/services/selections/selection-data-model.d.ts

@@ -52,12 +52,6 @@ export declare class WorkbookSelectionModel extends Disposable {
      */
     setSelections(sheetId: string, selectionDatas: ISelectionWithStyle[] | undefined, type: SelectionMoveType): void;
     getCurrentSelections(): Readonly<ISelectionWithStyle[]>;
-    /**
-     * @deprecated use `getSelectionsOfWorksheet` instead.
-     * @param sheetId
-     * @returns
-     */
-    getSelectionOfWorksheet(sheetId: string): ISelectionWithStyle[];
     getSelectionsOfWorksheet(sheetId: string): ISelectionWithStyle[];
     getLastSelectionPrimaryCellOfWorksheet(sheetId: string): Nullable<ISelectionCell>;
     setSelectionsOfWorksheet(sheetId: string, selections: ISelectionWithStyle[]): void;

package/lib/types/services/selections/selection.service.d.ts

@@ -78,12 +78,6 @@ export declare class SheetsSelectionsService extends RxDisposable {
     setSelections(selectionDatas: ISelectionWithStyle[], type?: SelectionMoveType): void;
     setSelections(unitId: string, worksheetId: string, selectionDatas: ISelectionWithStyle[], type?: SelectionMoveType): void;
     clearCurrentSelections(): void;
-    /**
-     * Determine whether multiple current selections overlap
-     *
-     * @deprecated this should be extracted to an pure function
-     */
-    isOverlapping(): boolean;
     protected _getCurrentSelections(): ISelectionWithStyle[];
     getWorkbookSelections(unitId: string): WorkbookSelectionModel;
     protected _workbookSelections: Map<string, WorkbookSelectionModel>;