@univerjs/core 0.2.6 → 0.2.8

package/lib/types/common/const.d.ts

@@ -15,7 +15,7 @@
  */
 export declare const DOCS_NORMAL_EDITOR_UNIT_ID_KEY = "__INTERNAL_EDITOR__DOCS_NORMAL";
 export declare const DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY = "__INTERNAL_EDITOR__DOCS_FORMULA_BAR";
-export declare const DOCS_ZEN_EDITOR_UNIT_ID_KEY = "__defaultDocumentZenEditorSpecialUnitId_20231218__";
+export declare const DOCS_ZEN_EDITOR_UNIT_ID_KEY = "__INTERNAL_EDITOR__ZEN_EDITOR";
 export declare const DEFAULT_EMPTY_DOCUMENT_VALUE = "\r\n";
 export declare function createInternalEditorID(id: string): string;
 export declare function isInternalEditorID(id: string): boolean;

package/lib/types/common/equal.d.ts

@@ -1,5 +1,4 @@
 import { IRange, IUnitRange } from '../types/interfaces';
-
 /**
  * Copyright 2023-present DreamNum Inc.
  *

package/lib/types/common/error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare class CustomCommandExecutionError extends Error {
+    constructor(message: string);
+}

package/lib/types/common/interceptor.d.ts

@@ -1,5 +1,4 @@
 import { Nullable } from './type-util';
-
 export type InterceptorHandler<M = unknown, C = unknown> = (value: Nullable<M>, context: C, next: (value: Nullable<M>) => Nullable<M>) => Nullable<M>;
 export interface IInterceptor<M, C> {
     priority?: number;

package/lib/types/common/unit.d.ts

@@ -1,9 +1,11 @@
 import { UniverType } from '@univerjs/protocol';
+import { Observable } from 'rxjs';
 import { Disposable } from '../shared';
-
 export { UniverType as UniverInstanceType } from '@univerjs/protocol';
 export type UnitType = UniverType | number;
 export declare abstract class UnitModel<_D = object, T extends UnitType = UnitType> extends Disposable {
     abstract readonly type: T;
     abstract getUnitId(): string;
+    abstract name$: Observable<string>;
+    abstract setName(name: string): void;
 }

package/lib/types/docs/data-model/document-data-model.d.ts

@@ -1,10 +1,10 @@
+import { BehaviorSubject } from 'rxjs';
 import { Nullable } from '../../shared';
 import { IDocumentBody, IDocumentData, IDocumentRenderConfig, IDocumentStyle, IDrawings } from '../../types/interfaces/i-document-data';
 import { IPaddingData } from '../../types/interfaces/i-style-data';
 import { UnitModel, UniverInstanceType } from '../../common/unit';
 import { SliceBodyType } from './text-x/utils';
 import { JSONXActions } from './json-x/json-x';
-
 export declare const DEFAULT_DOC: {
     id: string;
     documentStyle: {};
@@ -18,8 +18,11 @@ interface IDrawingUpdateConfig {
 declare class DocumentDataModelSimple extends UnitModel<IDocumentData, UniverInstanceType.UNIVER_DOC> {
     type: UniverInstanceType.UNIVER_DOC;
     getUnitId(): string;
+    protected readonly _name$: BehaviorSubject<string>;
+    name$: import('rxjs').Observable<string>;
     protected snapshot: IDocumentData;
     constructor(snapshot: Partial<IDocumentData>);
+    setName(name: string): void;
     get drawings(): IDrawings | undefined;
     get documentStyle(): IDocumentStyle;
     get lists(): import('../../types/interfaces/i-document-data').ILists | undefined;
@@ -41,10 +44,7 @@ export declare class DocumentDataModel extends DocumentDataModelSimple {
     private _unitId;
     headerModelMap: Map<string, DocumentDataModel>;
     footerModelMap: Map<string, DocumentDataModel>;
-    private _name$;
-    readonly name$: import('rxjs').Observable<string>;
     constructor(snapshot: Partial<IDocumentData>);
-    setName(name: string): void;
     dispose(): void;
     getDrawings(): IDrawings | undefined;
     getDrawingsOrder(): string[] | undefined;

package/lib/types/docs/data-model/empty-snapshot.d.ts

@@ -1,4 +1,3 @@
 import { LocaleType } from '../../types/enum/locale-type';
 import { IDocumentData } from '../../types/interfaces';
-
 export declare function getEmptySnapshot(unitID?: string, locale?: LocaleType, title?: string): IDocumentData;

package/lib/types/docs/data-model/json-x/json-x.d.ts

@@ -2,7 +2,6 @@ import { Doc, JSONOp, Path } from 'ot-json1';
 import { IDocumentBody, IDocumentData } from '../../../types/interfaces';
 import { TPriority } from '../text-x/text-x';
 import { TextXAction } from '../text-x/action-types';
-
 import * as json1 from 'ot-json1';
 export interface ISubType {
     name: string;
@@ -25,7 +24,8 @@ export declare class JSONX {
         [k: string]: Doc;
     } | null | undefined;
     static compose(thisActions: JSONOp, otherActions: JSONOp): JSONOp;
-    static transform(_thisActions: JSONOp, _otherActions: JSONOp, _priority: TPriority): void;
+    static transform(thisActions: JSONOp, otherActions: JSONOp, priority: TPriority): json1.JSONOpList | null | undefined;
+    static transformPosition(thisActions: JSONOp, index: number, priority?: TPriority): number;
     static invertWithDoc(actions: JSONOp, doc: IDocumentData): JSONOp;
     static isNoop(actions: JSONOp): boolean;
     private static _instance;

package/lib/types/docs/data-model/preset-list-type.d.ts

@@ -1,10 +1,59 @@
 import { IListData } from '../../types/interfaces/i-document-data';
-
+export declare enum QuickListType {
+    ORDER_LIST_QUICK_1 = "1.",
+    ORDER_LIST_QUICK_2 = "a)",
+    ORDER_LIST_QUICK_3 = "a.",
+    ORDER_LIST_QUICK_4 = "i.",
+    ORDER_LIST_QUICK_5 = "A.",
+    ORDER_LIST_QUICK_6 = "I.",
+    ORDER_LIST_QUICK_7 = "01."
+}
 export declare enum PresetListType {
     BULLET_LIST = "BULLET_LIST",
-    ORDER_LIST = "ORDER_LIST"
+    BULLET_LIST_1 = "BULLET_LIST_1",
+    BULLET_LIST_2 = "BULLET_LIST_2",
+    BULLET_LIST_3 = "BULLET_LIST_3",
+    BULLET_LIST_4 = "BULLET_LIST_4",
+    BULLET_LIST_5 = "BULLET_LIST_5",
+    /**
+     * 1 a i
+     */
+    ORDER_LIST = "ORDER_LIST",
+    /**
+     * 1) a) i)
+     */
+    ORDER_LIST_1 = "ORDER_LIST_1",
+    /**
+     * 1. 1.1. 1.1.1.
+     */
+    ORDER_LIST_2 = "ORDER_LIST_2",
+    /**
+     * A a i
+     */
+    ORDER_LIST_3 = "ORDER_LIST_3",
+    /**
+     * A 1 i
+     */
+    ORDER_LIST_4 = "ORDER_LIST_4",
+    /**
+     * 01 a i
+     */
+    ORDER_LIST_5 = "ORDER_LIST_5",
+    ORDER_LIST_QUICK_2 = "ORDER_LIST_QUICK_2",
+    ORDER_LIST_QUICK_3 = "ORDER_LIST_QUICK_3",
+    ORDER_LIST_QUICK_4 = "ORDER_LIST_QUICK_4",
+    ORDER_LIST_QUICK_5 = "ORDER_LIST_QUICK_5",
+    ORDER_LIST_QUICK_6 = "ORDER_LIST_QUICK_6",
+    CHECK_LIST = "CHECK_LIST",
+    CHECK_LIST_CHECKED = "CHECK_LIST_CHECKED"
 }
-export declare const PRESET_LIST_TYPE: {
-    BULLET_LIST: IListData;
-    ORDER_LIST: IListData;
+export declare const PRESET_LIST_TYPE: Record<string, IListData>;
+export declare const QuickListTypeMap: {
+    "1.": PresetListType;
+    "a)": PresetListType;
+    "a.": PresetListType;
+    "i.": PresetListType;
+    "A.": PresetListType;
+    "I.": PresetListType;
+    "01.": PresetListType;
 };

package/lib/types/docs/data-model/replacement.d.ts

@@ -1,3 +1,2 @@
 import { IDocumentBody } from '../../types/interfaces/i-document-data';
-
 export declare function replaceInDocumentBody(body: IDocumentBody, query: string, target: string): IDocumentBody;

package/lib/types/docs/data-model/text-x/__tests__/transform-position.spec.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};

package/lib/types/docs/data-model/text-x/__tests__/transform.spec.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};

package/lib/types/docs/data-model/text-x/action-iterator.d.ts

@@ -1,5 +1,4 @@
 import { TextXAction, TextXActionType } from './action-types';
-
 export declare class ActionIterator {
     private _actions;
     private _index;

package/lib/types/docs/data-model/text-x/action-types.d.ts

@@ -1,6 +1,5 @@
 import { UpdateDocsAttributeType } from '../../../shared/command-enum';
 import { IDocumentBody } from '../../../types/interfaces/i-document-data';
-
 export declare enum TextXActionType {
     RETAIN = "r",
     INSERT = "i",

package/lib/types/docs/data-model/text-x/apply-utils/common.d.ts

@@ -1,5 +1,4 @@
-import { ICustomBlock, ICustomDecoration, ICustomRange, IDocumentBody, IParagraph, ISectionBreak, ITable, ITextRun } from '../../../../types/interfaces';
-
+import { ICustomBlock, ICustomDecoration, ICustomRange, ICustomTable, IDocumentBody, IParagraph, ISectionBreak, ITextRun } from '../../../../types/interfaces';
 export declare function normalizeTextRuns(textRuns: ITextRun[]): ITextRun[];
 /**
  * Inserting styled text content into the current document model.
@@ -28,6 +27,6 @@ export declare function deleteTextRuns(body: IDocumentBody, textLength: number,
 export declare function deleteParagraphs(body: IDocumentBody, textLength: number, currentIndex: number): IParagraph[];
 export declare function deleteSectionBreaks(body: IDocumentBody, textLength: number, currentIndex: number): ISectionBreak[];
 export declare function deleteCustomBlocks(body: IDocumentBody, textLength: number, currentIndex: number): ICustomBlock[];
-export declare function deleteTables(body: IDocumentBody, textLength: number, currentIndex: number): ITable[];
+export declare function deleteTables(body: IDocumentBody, textLength: number, currentIndex: number): ICustomTable[];
 export declare function deleteCustomRanges(body: IDocumentBody, textLength: number, currentIndex: number): ICustomRange[];
 export declare function deleteCustomDecorations(body: IDocumentBody, textLength: number, currentIndex: number, needOffset?: boolean): ICustomDecoration[];

package/lib/types/docs/data-model/text-x/apply-utils/delete-apply.d.ts

@@ -1,3 +1,2 @@
 import { IDocumentBody } from '../../../../types/interfaces';
-
 export declare function updateAttributeByDelete(body: IDocumentBody, textLength: number, currentIndex: number): IDocumentBody;

package/lib/types/docs/data-model/text-x/apply-utils/insert-apply.d.ts

@@ -1,3 +1,2 @@
 import { IDocumentBody } from '../../../../types/interfaces';
-
 export declare function updateAttributeByInsert(body: IDocumentBody, insertBody: IDocumentBody, textLength: number, currentIndex: number): void;

package/lib/types/docs/data-model/text-x/apply-utils/update-apply.d.ts

@@ -1,5 +1,4 @@
 import { UpdateDocsAttributeType } from '../../../../shared';
 import { IDocumentBody, ITextRun } from '../../../../types/interfaces';
-
 export declare function updateAttribute(body: IDocumentBody, updateBody: IDocumentBody, textLength: number, currentIndex: number, coverType: UpdateDocsAttributeType): IDocumentBody;
 export declare function coverTextRuns(updateDataTextRuns: ITextRun[], removeTextRuns: ITextRun[], coverType: UpdateDocsAttributeType): ITextRun[];

package/lib/types/docs/data-model/text-x/apply.d.ts

@@ -1,4 +1,3 @@
 import { IDocumentBody } from '../../../types/interfaces';
 import { TextXAction } from './action-types';
-
 export declare function textXApply(doc: IDocumentBody, actions: TextXAction[]): IDocumentBody;

package/lib/types/docs/data-model/text-x/text-x.d.ts

@@ -1,14 +1,43 @@
 import { UpdateDocsAttributeType } from '../../../shared/command-enum';
 import { IDocumentBody } from '../../../types/interfaces/i-document-data';
 import { TextXAction } from './action-types';
-
 export type TPriority = 'left' | 'right';
 export declare class TextX {
     static id: string;
     static uri: string;
     static apply(doc: IDocumentBody, actions: TextXAction[]): IDocumentBody;
     static compose(thisActions: TextXAction[], otherActions: TextXAction[]): TextXAction[];
-    static transform(_thisActions: TextXAction[], _otherActions: TextXAction[], _priority: TPriority): TextXAction[];
+    /**
+     * |(this↓ \| other→) | **insert** | **retain** | **delete** |
+     * | ---------------- | ---------- | ---------- | ---------- |
+     * |    **insert**    |   Case 1   |   Case 2   |   Case 2   |
+     * |    **retain**    |   Case 1   |   Case 5   |   Case 4   |
+     * |    **delete**    |   Case 1   |   Case 3   |   Case 3   |
+     *
+     * Case 1: When the other action type is an insert operation,
+     *         the insert operation is retained regardless of the type of action this action
+     * Case 2: When this action type is an insert operation and the other action type is a
+     *         non-insert operation, you need to retain the length of this action insert
+     * Case 3: When this action is a delete operation, there are two scenarios:
+     *      1) When other is a delete operation, since it is a delete operation, this has
+     *         already been deleted, so the target does not need to be in delete, and it can
+     *         be continued directly
+     *      2) When other is the retain operation, although this action delete occurs first,
+     *         the delete priority is higher, so the delete operation is retained, and the origin
+     *         delete has been applied, so it is directly continued
+     * Case 4: other is the delete operation, this is the retain operation, and the target delete operation
+     *         is kept
+     * Case 5: When both other and this are retain operations
+     *      1) If the other body attribute does not exist, directly retain length
+     *      2) If the other body property exists, then execute the TransformBody logic to override it
+     */
+    static transform(thisActions: TextXAction[], otherActions: TextXAction[], priority?: TPriority): TextXAction[];
+    static _transform(thisActions: TextXAction[], otherActions: TextXAction[], priority?: TPriority): TextXAction[];
+    /**
+     * Used to transform selection. Why not named transformSelection?
+     * Because Univer Doc supports multiple Selections in one document, user need to encapsulate transformSelections at the application layer.
+     */
+    static transformPosition(thisActions: TextXAction[], index: number, priority?: boolean): number;
     static isNoop(actions: TextXAction[]): boolean;
     static invert(actions: TextXAction[]): TextXAction[];
     static makeInvertible(actions: TextXAction[], doc: IDocumentBody): TextXAction[];

package/lib/types/docs/data-model/text-x/transform-utils.d.ts

@@ -0,0 +1,2 @@
+import { IDocumentBody, IRetainAction } from '@univerjs/core';
+export declare function transformBody(thisAction: IRetainAction, otherAction: IRetainAction, priority?: boolean): IDocumentBody;

package/lib/types/docs/data-model/text-x/utils.d.ts

@@ -1,7 +1,6 @@
 import { UpdateDocsAttributeType } from '../../../shared/command-enum';
 import { ICustomDecoration, IDocumentBody } from '../../../types/interfaces/i-document-data';
 import { IRetainAction } from './action-types';
-
 export declare enum SliceBodyType {
     copy = 0,
     cut = 1

package/lib/types/docs/data-model/types.d.ts

@@ -14,21 +14,21 @@
  * limitations under the License.
  */
 export declare enum DataStreamTreeNodeType {
-    PARAGRAPH = 0,// \r  段落
-    SECTION_BREAK = 1,// \n  章节
-    TABLE = 2,
-    TABLE_ROW = 3,
-    TABLE_CELL = 4,
-    CUSTOM_BLOCK = 5
+    PARAGRAPH = "PARAGRAPH",// \r  段落
+    SECTION_BREAK = "SECTION_BREAK",// \n  章节
+    TABLE = "TABLE",
+    TABLE_ROW = "TABLE_ROW",
+    TABLE_CELL = "TABLE_CELL",
+    CUSTOM_BLOCK = "CUSTOM_BLOCK"
 }
 export declare enum DataStreamTreeTokenType {
     PARAGRAPH = "\r",// 段落
     SECTION_BREAK = "\n",// 章节
     TABLE_START = "\u001A",// 表格开始
-    TABLE_ROW_START = "\u001B",// 表格开始
-    TABLE_CELL_START = "\u001C",// 表格开始
-    TABLE_CELL_END = "\u001D",// 表格开始
-    TABLE_ROW_END = "\u000E",// 表格开始
+    TABLE_ROW_START = "\u001B",// 表格行开始
+    TABLE_CELL_START = "\u001C",// 表格单元格开始
+    TABLE_CELL_END = "\u001D",// 表格单元格结束
+    TABLE_ROW_END = "\u000E",// 表格行结束
     TABLE_END = "\u000F",// 表格结束
     CUSTOM_RANGE_START = "\u001F",// 自定义范围开始
     CUSTOM_RANGE_END = "\u001E",// 自定义范围结束
@@ -40,3 +40,5 @@ export declare enum DataStreamTreeTokenType {
     LETTER = "",
     SPACE = " "
 }
+/** Wrap your stream in a pair of custom range tokens. */
+export declare function makeCustomRangeStream(stream: string): string;

package/lib/types/index.d.ts

@@ -17,6 +17,7 @@ export type { Serializable } from './common/json';
 export { DEFAULT_DOCUMENT_SUB_COMPONENT_ID } from './docs/data-model/subdocument';
 export { type UnitType, UnitModel, UniverInstanceType } from './common/unit';
 export { Registry, RegistryAsMap } from './common/registry';
+export { CustomCommandExecutionError } from './common/error';
 export { Univer } from './univer';
 export { shallowEqual, isRangesEqual, isUnitRangesEqual } from './common/equal';
 export { isNumeric, isSafeNumeric } from './common/number';
@@ -86,7 +87,7 @@ export * from './types/const';
 export * from './types/enum';
 export * from './types/interfaces';
 export { ISnapshotServerService } from './services/snapshot/snapshot-server.service';
-export { transformSnapshotToWorkbookData, transformWorkbookDataToSnapshot, transformDocumentDataToSnapshot, transformSnapshotToDocumentData, generateTemporarySnap, } from './services/snapshot/snapshot-transform';
+export { transformSnapshotToWorkbookData, transformWorkbookDataToSnapshot, transformDocumentDataToSnapshot, transformSnapshotToDocumentData, generateTemporarySnap, generateTempDocumentSnapshot, } from './services/snapshot/snapshot-transform';
 export { textEncoder, textDecoder } from './services/snapshot/snapshot-utils';
 export { type ILogContext } from './services/log/context';
 export { b64DecodeUnicode, b64EncodeUnicode } from './shared/coder';

package/lib/types/observer/observable.d.ts

@@ -1,5 +1,4 @@
 import { Observer as RxObserver, Subscription, Observable, Subject } from 'rxjs';
-
 /**
  * A class serves as a medium between the observable and its observers
  */

package/lib/types/services/__tests__/index.d.ts

@@ -1,6 +1,5 @@
 import { ICommandService, Univer } from '@univerjs/core';
 import { Dependency } from '../../common/di';
-
 export declare const createTestBed: (dependencies?: Dependency[]) => {
     univer: Univer;
     get: {

package/lib/types/services/authz-io/authz-io-local.service.d.ts

@@ -2,7 +2,6 @@ import { IActionInfo, IAllowedRequest, IBatchAllowedResponse, ICollaborator, ICr
 import { IResourceManagerService } from '../resource-manager/type';
 import { UserManagerService } from '../user-manager/user-manager.service';
 import { IAuthzIoService } from './type';
-
 /**
  * Do not use the mock implementation in a production environment as it is a minimal version.
  */
@@ -15,8 +14,8 @@ export declare class AuthzIoLocalService implements IAuthzIoService {
     private _getRole;
     private _initSnapshot;
     create(config: ICreateRequest): Promise<string>;
-    allowed(config: IAllowedRequest): Promise<IActionInfo[]>;
-    batchAllowed(config: IAllowedRequest[]): Promise<IBatchAllowedResponse['objectActions']>;
+    allowed(_config: IAllowedRequest): Promise<IActionInfo[]>;
+    batchAllowed(_config: IAllowedRequest[]): Promise<IBatchAllowedResponse['objectActions']>;
     list(config: IListPermPointRequest): Promise<IPermissionPoint[]>;
     listCollaborators(): Promise<ICollaborator[]>;
     listRoles(): Promise<{

package/lib/types/services/authz-io/type.d.ts

@@ -1,6 +1,5 @@
 import { ILogContext } from '@univerjs/core';
 import { IAllowedRequest, IAllowedResponse, IBatchAllowedResponse, ICreateCollaboratorRequest, ICreateRequest, ICreateResponse, IDeleteCollaboratorRequest, IListCollaboratorRequest, IListCollaboratorResponse, IListPermPointRequest, IListPermPointResponse, IListRolesRequest, IListRolesResponse, IPutCollaboratorsRequest, IUpdateCollaboratorRequest, IUpdatePermPointRequest } from '@univerjs/protocol';
-
 export interface IAuthzIoService {
     create(config: ICreateRequest, context?: ILogContext): Promise<ICreateResponse['objectID']>;
     allowed(config: IAllowedRequest, context?: ILogContext): Promise<IAllowedResponse['actions']>;

package/lib/types/services/command/command.service.d.ts

@@ -2,7 +2,6 @@ import { IAccessor, IDisposable, Injector } from '../../common/di';
 import { Disposable } from '../../shared/lifecycle';
 import { IContextService } from '../context/context.service';
 import { ILogService } from '../log/log.service';
-
 export declare enum CommandType {
     /** Command could generate some operations or mutations. */
     COMMAND = 0,

package/lib/types/services/config/config.service.d.ts

@@ -1,5 +1,4 @@
 import { Nullable } from '../../shared/types';
-
 /**
  * IConfig provides universal configuration for the whole application.
  */

package/lib/types/services/context/context.d.ts

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export declare const FOCUSING_UNIT = "FOCUSING_UNIT";
 export declare const FOCUSING_SHEET = "FOCUSING_SHEET";
 export declare const FOCUSING_DOC = "FOCUSING_DOC";
 export declare const FOCUSING_SLIDE = "FOCUSING_SLIDE";
@@ -21,7 +22,7 @@ export declare const FOCUSING_EDITOR_BUT_HIDDEN = "FOCUSING_EDITOR_BUT_HIDDEN";
 export declare const EDITOR_ACTIVATED = "EDITOR_ACTIVATED";
 export declare const FOCUSING_EDITOR_INPUT_FORMULA = "FOCUSING_EDITOR_INPUT_FORMULA";
 /** The focusing state of the formula editor (Fx bar). */
-export declare const FOCUSING_FORMULA_EDITOR = "FOCUSING_FORMULA_EDITOR";
+export declare const FOCUSING_FX_BAR_EDITOR = "FOCUSING_FX_BAR_EDITOR";
 export declare const FOCUSING_UNIVER_EDITOR = "FOCUSING_UNIVER_EDITOR";
 export declare const FOCUSING_EDITOR_STANDALONE = "FOCUSING_EDITOR_INPUT_FORMULA";
 export declare const FOCUSING_UNIVER_EDITOR_STANDALONE_SINGLE_MODE = "FOCUSING_UNIVER_EDITOR_STANDALONE_SINGLE_MODE";
@@ -29,3 +30,4 @@ export declare const FOCUSING_UNIVER_EDITOR_STANDALONE_SINGLE_MODE = "FOCUSING_U
  * The focusing state of the common drawings.
  */
 export declare const FOCUSING_COMMON_DRAWINGS = "FOCUSING_COMMON_DRAWINGS";
+export declare const FORMULA_EDITOR_ACTIVATED = "FORMULA_EDITOR_ACTIVATED";

package/lib/types/services/context/context.service.d.ts

@@ -1,6 +1,5 @@
 import { Observable } from 'rxjs';
 import { Disposable } from '../../shared/lifecycle';
-
 export interface IContextService {
     readonly contextChanged$: Observable<{
         [key: string]: boolean;

package/lib/types/services/error/error.service.d.ts

@@ -1,5 +1,4 @@
 import { Disposable } from '../../shared/lifecycle';
-
 export interface IError {
     errorKey: string;
 }

package/lib/types/services/instance/instance.service.d.ts

@@ -6,7 +6,15 @@ import { Disposable } from '../../shared/lifecycle';
 import { Workbook } from '../../sheets/workbook';
 import { IContextService } from '../context/context.service';
 import { UnitModel, UnitType, UniverInstanceType } from '../../common/unit';
-
+export type UnitCtor = new (...args: any[]) => UnitModel;
+export interface ICreateUnitOptions {
+    /**
+     * If Univer should make the new unit as current of its type.
+     *
+     * @default true
+     */
+    makeCurrent?: boolean;
+}
 /**
  * IUniverInstanceService holds all the current univer instances and provides a set of
  * methods to add and remove univer instances.
@@ -24,14 +32,16 @@ export interface IUniverInstanceService {
     unitDisposed$: Observable<UnitModel>;
     /** Subscribe to curtain type of units' disposing. */
     getTypeOfUnitDisposed$<T extends UnitModel>(type: UnitType): Observable<T>;
+    /** An observable value that emits the id of the focused unit. */
     focused$: Observable<Nullable<string>>;
+    /** Focus a unit. */
     focusUnit(unitId: string | null): void;
     getFocusedUnit(): Nullable<UnitModel>;
     getCurrentUnitForType<T extends UnitModel>(type: UnitType): Nullable<T>;
     setCurrentUnitForType(unitId: string): void;
     getCurrentTypeOfUnit$<T extends UnitModel>(type: UnitType): Observable<Nullable<T>>;
     /** Create a unit with snapshot info. */
-    createUnit<T, U extends UnitModel>(type: UnitType, data: Partial<T>): U;
+    createUnit<T, U extends UnitModel>(type: UnitType, data: Partial<T>, options?: ICreateUnitOptions): U;
     /** Dispose a unit  */
     disposeUnit(unitId: string): boolean;
     registerCtorForType<T extends UnitModel>(type: UnitType, ctor: new (...args: any[]) => T): IDisposable;
@@ -55,17 +65,16 @@ export declare class UniverInstanceService extends Disposable implements IUniver
     constructor(_injector: Injector, _contextService: IContextService);
     dispose(): void;
     private _createHandler;
-    __setCreateHandler(handler: (type: UnitType, data: unknown, ctor: new (...args: any[]) => UnitModel) => UnitModel): void;
-    createUnit<T, U extends UnitModel>(type: UnitType, data: T): U;
+    __setCreateHandler(handler: (type: UnitType, data: unknown, ctor: UnitCtor, options?: ICreateUnitOptions) => UnitModel): void;
+    createUnit<T, U extends UnitModel>(type: UnitType, data: T, options?: ICreateUnitOptions): U;
     private readonly _ctorByType;
     registerCtorForType<T extends UnitModel>(type: UnitType, ctor: new () => T): IDisposable;
     private _currentUnits;
     private readonly _currentUnits$;
     readonly currentUnits$: Observable<Map<number, Nullable<UnitModel<object, number>>>>;
     getCurrentTypeOfUnit$<T>(type: number): Observable<Nullable<T>>;
-    getCurrentUnitForType<T>(type: UnitType): Nullable<T>;
+    getCurrentUnitForType<T extends UnitModel>(type: UnitType): Nullable<T>;
     setCurrentUnitForType(unitId: string): void;
-    private _removeCurrentUnitForType;
     private readonly _unitAdded$;
     readonly unitAdded$: Observable<UnitModel<object, number>>;
     getTypeOfUnitAdded$<T extends UnitModel<object, number>>(type: UnitType): Observable<T>;
@@ -76,7 +85,7 @@ export declare class UniverInstanceService extends Disposable implements IUniver
      *
      * @param unit The unit to be added.
      */
-    __addUnit(unit: UnitModel): void;
+    __addUnit(unit: UnitModel, options?: ICreateUnitOptions): void;
     private _unitDisposed$;
     readonly unitDisposed$: Observable<UnitModel<object, number>>;
     getTypeOfUnitDisposed$<T extends UnitModel<object, number>>(type: UniverInstanceType): Observable<T>;
@@ -93,5 +102,7 @@ export declare class UniverInstanceService extends Disposable implements IUniver
     getFocusedUnit(): Nullable<UnitModel>;
     getUnitType(unitId: string): UniverInstanceType;
     disposeUnit(unitId: string): boolean;
+    private _tryRemoveCurrentUnitForType;
+    private _tryBlurUnitOnRemoval;
     private _getUnitById;
 }

package/lib/types/services/lifecycle/lifecycle.d.ts

@@ -1,5 +1,4 @@
 import { Ctor, DependencyIdentifier } from '../../common/di';
-
 /**
  * This enum defines multiple lifecycle stages in Univer SDK.
  */

package/lib/types/services/lifecycle/lifecycle.service.d.ts

@@ -3,7 +3,6 @@ import { Injector } from '../../common/di';
 import { Disposable } from '../../shared/lifecycle';
 import { ILogService } from '../log/log.service';
 import { LifecycleStages } from './lifecycle';
-
 /**
  * This service controls the lifecycle of a Univer instance. Other modules can
  * inject this service to read the current lifecycle stage or subscribe to

package/lib/types/services/locale/locale.service.d.ts

@@ -2,7 +2,6 @@ import { Subject } from 'rxjs';
 import { Disposable } from '../../shared/lifecycle';
 import { ILanguagePack, ILocales, LanguageValue } from '../../shared/locale';
 import { LocaleType } from '../../types/enum/locale-type';
-
 /**
  * This service provides i18n and timezone / location features to other modules.
  */

package/lib/types/services/log/log.service.d.ts

@@ -1,5 +1,4 @@
 import { Disposable } from '../../shared/lifecycle';
-
 export declare enum LogLevel {
     SILENT = 0,
     ERROR = 1,

package/lib/types/services/permission/permission.service.d.ts

@@ -1,7 +1,6 @@
 import { Observable, BehaviorSubject } from 'rxjs';
 import { Disposable } from '../../shared';
 import { IPermissionPoint, IPermissionService } from './type';
-
 export declare class PermissionService extends Disposable implements IPermissionService {
     private _permissionPointMap;
     private _permissionPointUpdate$;

package/lib/types/services/permission/type.d.ts

@@ -2,7 +2,6 @@ import { BehaviorSubject, Observable } from 'rxjs';
 import { UnitAction, UnitObject } from '@univerjs/protocol';
 import { Nullable } from '../../common/type-utils';
 import { IRange } from '../../types/interfaces';
-
 export declare enum PermissionStatus {
     INIT = "init",
     FETCHING = "fetching",

package/lib/types/services/plugin/plugin-override.d.ts

@@ -1,5 +1,4 @@
 import { Dependency, DependencyIdentifier, DependencyItem } from '../../common/di';
-
 export type NullableDependencyPair<T> = [DependencyIdentifier<T>, DependencyItem<T> | null];
 /**
  * Overrides the dependencies defined in the plugin. Only dependencies that are identified by `IdentifierDecorator` can be overridden.