@univerjs/docs 0.25.1 → 1.0.0-alpha.1

package/lib/types/facade/f-document-paragraph.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import type { Injector, IParagraph, IParagraphStyle } from '@univerjs/core';
+import type { FDocumentBody, IFDocumentBodyEdit, IFDocumentTextRange } from './f-document-body';
+import type { IFDocumentElementInfo } from './f-document-element';
+import { FDocumentElement } from './f-document-element';
+interface IFDocumentParagraphMixin {
+    asParagraph(): FDocumentParagraph;
+}
+/**
+ * Resolved paragraph metadata in the the document body.
+ */
+export interface IFDocumentResolvedParagraph {
+    /** The underlying paragraph snapshot object. */
+    paragraph: IParagraph;
+    /** The current paragraph index in the body paragraph list. */
+    paragraphIndex: number;
+    /** The inclusive start offset of the paragraph text. */
+    startOffset: number;
+    /** The exclusive end offset of the paragraph text, before the paragraph break. */
+    endOffset: number;
+}
+/**
+ * A paragraph facade wrapper.
+ *
+ * Paragraph identity is backed by the persisted `paragraphId`. The id is
+ * re-resolved before each method call, so insertions before this paragraph do
+ * not break the wrapper.
+ *
+ * @hideconstructor
+ */
+export declare class FDocumentParagraph extends FDocumentElement {
+    protected readonly body: FDocumentBody;
+    protected readonly bodyEdit: IFDocumentBodyEdit;
+    protected readonly info: IFDocumentElementInfo;
+    protected readonly injector: Injector;
+    constructor(body: FDocumentBody, bodyEdit: IFDocumentBodyEdit, info: IFDocumentElementInfo, injector: Injector);
+    /**
+     * Get the persisted paragraph id.
+     * @returns {string} The paragraph id.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   console.log(paragraph.getParagraphId());
+     * }
+     * ```
+     */
+    getParagraphId(): string;
+    /**
+     * Get the resolved paragraph info for this wrapper.
+     * @returns {IFDocumentResolvedParagraph} The resolved paragraph info, including the paragraph object, its index, and its text range.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   console.log(paragraph.getResolvedParagraphInfo());
+     * }
+     * ```
+     */
+    getResolvedParagraphInfo(): IFDocumentResolvedParagraph;
+    /**
+     * Get the current text range occupied by this paragraph.
+     * @returns {IFDocumentTextRange} The paragraph text range, excluding the trailing paragraph break.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   const range = paragraph.getRange();
+     *   fDocumentBody.setTextStyle(range, { bl: 1 });
+     * }
+     * ```
+     */
+    getRange(): IFDocumentTextRange;
+    /**
+     * Get this paragraph's plain text.
+     * @returns {string} The paragraph text without the trailing paragraph break.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   console.log(paragraph.getText());
+     * }
+     * ```
+     */
+    getText(): string;
+    /**
+     * Replace this paragraph's plain text.
+     * @param {string} text The replacement text. Do not include the paragraph break.
+     * @returns {boolean} `true` if the paragraph text was replaced.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   const success = paragraph.setText('Updated title');
+     *   console.log(success ? 'Text updated' : 'Failed to update text');
+     * }
+     * ```
+     */
+    setText(text: string): boolean;
+    /**
+     * Append plain text before this paragraph's trailing paragraph break.
+     * @param {string} text The plain text to append.
+     * @returns {boolean} `true` if the text was appended.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   const success = paragraph.appendText(' Appended text');
+     *   console.log(success ? 'Text appended' : 'Failed to append text');
+     * }
+     * ```
+     */
+    appendText(text: string): boolean;
+    /**
+     * Apply paragraph style to a paragraph handle or text range.
+     * @param {IParagraphStyle} style The Univer paragraph style patch.
+     * @returns {boolean} `true` if the style was applied.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   paragraph.setStyle({ horizontalAlign: 2 });
+     * }
+     * ```
+     */
+    setStyle(style: IParagraphStyle): boolean;
+    /**
+     * Check whether this paragraph is a bullet, ordered, or checklist item.
+     * @returns {boolean} `true` if the paragraph has list metadata.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   console.log(paragraph.isListItem() ? 'This is a list item' : 'This is not a list item');
+     * }
+     * ```
+     */
+    isListItem(): boolean;
+    /**
+     * Check whether this paragraph is a task/checklist item.
+     * @returns {boolean} `true` if this paragraph is an unchecked or checked task item.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   console.log(paragraph.isTask() ? 'This is a task item' : 'This is not a task item');
+     * }
+     * ```
+     */
+    isTask(): boolean;
+    /**
+     * Set the checked state of this task/checklist paragraph.
+     * @param {boolean} checked Whether the task item should be checked.
+     * @returns {boolean} `true` if the task state was updated, or `false` if this paragraph is not a task item.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *
+     *   if (paragraph.isTask()) {
+     *     const success = paragraph.setTaskChecked(true);
+     *     console.log(success ? 'Task checked' : 'Failed to check task');
+     *   }
+     * }
+     * ```
+     */
+    setTaskChecked(checked: boolean): boolean;
+    private _preserveExplicitParagraphIds;
+}
+export declare class FDocumentParagraphMixin extends FDocumentElement {
+    asParagraph(): FDocumentParagraph;
+}
+declare module '@univerjs/docs/facade' {
+    interface FDocumentElement extends IFDocumentParagraphMixin {
+    }
+}
+export {};

package/lib/types/facade/f-document-table.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import type { ICustomTable, Injector } from '@univerjs/core';
+import type { FDocumentBody, IFDocumentBodyEdit } from './f-document-body';
+import type { IFDocumentElementInfo } from './f-document-element';
+import { FDocumentElement } from './f-document-element';
+interface IFDocumentTableMixin {
+    asTable(): FDocumentTable;
+}
+/**
+ * A facade wrapper for document top-level tables.
+ * @hideconstructor
+ */
+export declare class FDocumentTable extends FDocumentElement {
+    protected readonly body: FDocumentBody;
+    protected readonly bodyEdit: IFDocumentBodyEdit;
+    protected readonly info: IFDocumentElementInfo;
+    protected readonly injector: Injector;
+    constructor(body: FDocumentBody, bodyEdit: IFDocumentBodyEdit, info: IFDocumentElementInfo, injector: Injector);
+    /**
+     * Get the table marker.
+     * @returns {ICustomTable} The table marker.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * const element = fDocumentBody.getElement(0);
+     *
+     * if (element?.isTable()) {
+     *   const table = element.asTable();
+     *   console.log(table.getTable());
+     * }
+     * ```
+     */
+    getTable(): ICustomTable;
+}
+export declare class FDocumentTableMixin extends FDocumentElement {
+    asTable(): FDocumentTable;
+}
+declare module '@univerjs/docs/facade' {
+    interface FDocumentElement extends IFDocumentTableMixin {
+    }
+}
+export {};

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

@@ -0,0 +1,123 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import type { DocumentDataModel, IDocumentData } from '@univerjs/core';
+import { ICommandService, Injector, IResourceLoaderService, IUniverInstanceService } from '@univerjs/core';
+import { FBaseInitialable } from '@univerjs/core/facade';
+import { FDocumentBody } from './f-document-body';
+/**
+ * Facade API object bounded to a document. It provides a set of methods to interact with the document.
+ * @hideconstructor
+ */
+export declare class FDocument extends FBaseInitialable {
+    private readonly _documentDataModel;
+    protected readonly _injector: Injector;
+    protected readonly _univerInstanceService: IUniverInstanceService;
+    protected readonly _resourceLoaderService: IResourceLoaderService;
+    private readonly _commandService;
+    readonly id: string;
+    constructor(_documentDataModel: DocumentDataModel, _injector: Injector, _univerInstanceService: IUniverInstanceService, _resourceLoaderService: IResourceLoaderService, _commandService: ICommandService);
+    /**
+     * Get the document data model of the document.
+     * @returns {DocumentDataModel} The document data model.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const documentDataModel = fDocument.getDocumentDataModel();
+     * console.log(documentDataModel);
+     * ```
+     */
+    getDocumentDataModel(): DocumentDataModel;
+    /**
+     * Get the document body facade.
+     *
+     * The returned body facade provides synchronous Google Docs-like element APIs
+     * for reading and editing top-level document body elements. Paragraph elements
+     * use their persisted `paragraphId` values. Persisted elements, such as tables
+     * and custom blocks, use their existing ids.
+     *
+     * @returns {FDocumentBody} The document body API instance.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const fDocumentBody = fDocument.getBody();
+     * console.log(fDocumentBody.getBody());
+     *
+     * const element = fDocumentBody.getElement(0);
+     * if (element.isParagraph()) {
+     *   const paragraph = element.asParagraph();
+     *   paragraph.appendText(' updated');
+     *   console.log(paragraph.getText());
+     * }
+     * ```
+     */
+    getBody(): FDocumentBody;
+    dispose(): void;
+    /**
+     * Get the document id.
+     * @returns {string} The document id.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const unitId = fDocument.getId();
+     * console.log(unitId);
+     * ```
+     */
+    getId(): string;
+    /**
+     * Get the document name.
+     * @returns {string} The document name.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const name = fDocument.getName();
+     * console.log(name);
+     * ```
+     */
+    getName(): string;
+    /**
+     * Save the document snapshot data, including the document content and resource data, etc.
+     * @returns {IDocumentData} The document snapshot data.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const snapshot = fDocument.save();
+     * console.log(snapshot);
+     * ```
+     */
+    save(): IDocumentData;
+    /**
+     * Undo the last operation in the document.
+     * @returns {boolean} `true` if the undo operation was successful, or `false` if it failed.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const success = fDocument.undo();
+     * console.log(success);
+     * ```
+     */
+    undo(): boolean;
+    /**
+     * Redo the last undone operation in the document.
+     * @returns {boolean} `true` if the redo operation was successful, or `false` if it failed.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * const success = fDocument.redo();
+     * console.log(success);
+     * ```
+     */
+    redo(): boolean;
+}

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

@@ -0,0 +1,64 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import type { IDocumentData } from '@univerjs/core';
+import { FUniver } from '@univerjs/core/facade';
+import { FDocument } from './f-document';
+/**
+ * @ignore
+ */
+export interface IFUniverDocsMixin {
+    /**
+     * Create a new document and get the API handler of that document.
+     * @param {Partial<IDocumentData>} data The snapshot of the document.
+     * @returns {FDocument} The document API instance.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.createUniverDoc({ id: 'document-01', title: 'Document1'  });
+     * console.log(fDocument);
+     * ```
+     */
+    createDocument(data: Partial<IDocumentData>): FDocument;
+    /**
+     * Get the currently focused Univer document.
+     * @returns {FDocument | null} The currently focused Univer document API instance, or null if there is no focused Univer document.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getActiveDocument();
+     * console.log(fDocument);
+     * ```
+     */
+    getActiveDocument(): FDocument | null;
+    /**
+     * Get the document API handler by the document id.
+     * @param {string} id The document id.
+     * @returns {FDocument | null} The document API instance corresponding to the document id, or null if not found.
+     * @example
+     * ```typescript
+     * const fDocument = univerAPI.getDocument('document-01');
+     * console.log(fDocument);
+     * ```
+     */
+    getDocument(id: string): FDocument | null;
+}
+export declare class FUniverDocsMixin extends FUniver implements IFUniverDocsMixin {
+    createDocument(data: Partial<IDocumentData>): FDocument;
+    getActiveDocument(): FDocument | null;
+    getDocument(id: string): FDocument | null;
+}
+declare module '@univerjs/core/facade' {
+    interface FUniver extends IFUniverDocsMixin {
+    }
+}

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

@@ -0,0 +1,23 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import './f-univer';
+export { FDocument } from './f-document';
+export { FDocumentBlockRange } from './f-document-block-range';
+export { FDocumentBody, type IFDocumentTextRange } from './f-document-body';
+export { FDocumentCustomBlock } from './f-document-custom-block';
+export { FDocumentElement } from './f-document-element';
+export { FDocumentParagraph } from './f-document-paragraph';
+export { FDocumentTable } from './f-document-table';

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

@@ -0,0 +1,24 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import type { IDocumentBody, IParagraphStyle } from '@univerjs/core';
+export interface IBuildPlainTextInsertBodyOptions {
+    paragraphStyle?: IParagraphStyle;
+    removeLeadingParagraphBreak?: boolean;
+}
+export declare function getRemovedLeadingParagraphBreakLength(dataStream: string, removeLeadingParagraphBreak?: boolean): number;
+export declare function getNormalizedPlainTextCursorOffset(dataStream: string, cursorOffset: number, removeLeadingParagraphBreak?: boolean): number;
+export declare function getParagraphStyleAtOffset(body: IDocumentBody, offset: number): IParagraphStyle | undefined;
+export declare function buildPlainTextInsertBody(dataStream: string, options?: IBuildPlainTextInsertBodyOptions): IDocumentBody;

package/lib/types/index.d.ts

@@ -13,15 +13,24 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export { type IRichTextEditingMutationParams, RichTextEditingMutation } from './commands/mutations/core-editing.mutation';
-export { type ISetTextSelectionsOperationParams, SetTextSelectionsOperation } from './commands/operations/text-selection.operation';
+export { DeleteTextCommand, InsertTextCommand, UpdateTextCommand } from './commands/commands/core-editing.command';
+export type { IDeleteTextCommandParams, IInsertTextCommandParams, IUpdateTextCommandParams, } from './commands/commands/core-editing.command';
+export { RichTextEditingMutation } from './commands/mutations/core-editing.mutation';
+export type { IRichTextEditingMutationParams } from './commands/mutations/core-editing.mutation';
+export { SetTextSelectionsOperation } from './commands/operations/text-selection.operation';
+export type { ISetTextSelectionsOperationParams } from './commands/operations/text-selection.operation';
 export type { IUniverDocsConfig } from './config/config';
 export { UniverDocsPlugin } from './plugin';
+export { DocBlockMoveValidatorService } from './services/doc-block-move-validator.service';
+export type { DocBlockMoveTransformer, DocBlockMoveValidator, IDocBlockMoveResult, IDocBlockMoveTransformContext, IDocBlockMoveValidationContext } from './services/doc-block-move-validator.service';
+export { DocContentInsertService } from './services/doc-content-insert.service';
+export type { IDocContentInsertRange } from './services/doc-content-insert.service';
 export { DocInterceptorService } from './services/doc-interceptor/doc-interceptor.service';
 export { DOC_INTERCEPTOR_POINT } from './services/doc-interceptor/interceptor-const';
 export { DocSelectionManagerService } from './services/doc-selection-manager.service';
 export { DocSkeletonManagerService } from './services/doc-skeleton-manager.service';
+export { DocStateChangeManagerService, IDocStateChangeInterceptorService, } from './services/doc-state-change-manager.service';
 export type { IDocStateChangeInfo, IDocStateChangeParams } from './services/doc-state-emit.service';
 export { DocStateEmitService } from './services/doc-state-emit.service';
-export { addCustomRangeBySelectionFactory, addCustomRangeFactory, deleteCustomRangeFactory } from './utils/custom-range-factory';
+export { addCustomRangeBySelectionFactory, addCustomRangeFactory, deleteCustomRangeFactory, } from './utils/custom-range-factory';
 export { replaceSelectionFactory } from './utils/replace-selection-factory';

package/lib/types/services/doc-block-move-validator.service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import type { IDisposable, IDocumentData } from '@univerjs/core';
+import { Disposable } from '@univerjs/core';
+export interface IDocBlockMoveValidationContext {
+    unitId: string;
+    sourceRange: {
+        startOffset: number;
+        endOffset: number;
+    };
+    targetOffset: number;
+}
+export type DocBlockMoveValidator = (context: IDocBlockMoveValidationContext) => boolean;
+export interface IDocBlockMoveResult {
+    nextDocumentData: IDocumentData;
+    movedRange: {
+        startOffset: number;
+        endOffset: number;
+    };
+}
+export interface IDocBlockMoveTransformContext extends IDocBlockMoveValidationContext {
+    previousDocumentData: IDocumentData;
+    result: IDocBlockMoveResult;
+}
+export type DocBlockMoveTransformer = (context: IDocBlockMoveTransformContext) => IDocBlockMoveResult;
+export declare class DocBlockMoveValidatorService extends Disposable {
+    private readonly _validators;
+    private readonly _transformers;
+    registerValidator(validator: DocBlockMoveValidator): IDisposable;
+    registerTransformer(transformer: DocBlockMoveTransformer): IDisposable;
+    canMoveBlock(context: IDocBlockMoveValidationContext): boolean;
+    transformMoveResult(context: IDocBlockMoveTransformContext): IDocBlockMoveResult;
+}

package/lib/types/services/doc-content-insert.service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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.
+ */
+import { Disposable } from '@univerjs/core';
+export interface IDocContentInsertRange {
+    unitId: string;
+    startOffset: number;
+    endOffset: number;
+    segmentId?: string;
+}
+export declare class DocContentInsertService extends Disposable {
+    private _range;
+    setInsertRange(range: IDocContentInsertRange): void;
+    consumeInsertRange(unitId?: string): IDocContentInsertRange | null;
+    clearInsertRange(): void;
+}