@univerjs/docs 1.0.0-alpha.1 → 1.0.0-alpha.2

package/lib/index.js

@@ -1,4 +1,4 @@
-import { BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DeleteDirection, Disposable, DisposableCollection, ICommandService, IConfigService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, Optional, Plugin, RedoCommandId, RxDisposable, TextX, TextXActionType, UndoCommandId, UniverInstanceType, composeInterceptors, createIdentifier, createInterceptorKey, getRichTextEditPath, isInternalEditorID, merge, remove, toDisposable } from "@univerjs/core";
+import { BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DeleteDirection, Disposable, DisposableCollection, DocumentFlavor, ICommandService, IConfigService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, Optional, Plugin, RedoCommandId, RxDisposable, TextX, TextXActionType, UndoCommandId, UniverInstanceType, composeInterceptors, createIdentifier, createInterceptorKey, createParagraphId, generateRandomId, getRichTextEditPath, isInternalEditorID, merge, remove, toDisposable } from "@univerjs/core";
 import { DocumentSkeleton, DocumentViewModel, IRenderManagerService, NORMAL_TEXT_SELECTION_PLUGIN_STYLE } from "@univerjs/engine-render";
 import { BehaviorSubject, Subject, takeUntil } from "rxjs";
 
@@ -386,14 +386,14 @@ const InsertTextCommand = {
 	id: "doc.command.insert-text",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _activeRange$segmentI;
+		var _docDataModel$getSelf, _activeRange$segmentI;
 		const commandService = accessor.get(ICommandService);
 		const { range, segmentId, body, unitId, cursorOffset } = params;
 		const docSelectionManagerService = accessor.get(DocSelectionManagerService);
 		const docDataModel = accessor.get(IUniverInstanceService).getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (docDataModel == null) return false;
 		const activeRange = docSelectionManagerService.getActiveTextRange();
-		const originBody = docDataModel.getSelfOrHeaderFooterModel((_activeRange$segmentI = activeRange === null || activeRange === void 0 ? void 0 : activeRange.segmentId) !== null && _activeRange$segmentI !== void 0 ? _activeRange$segmentI : "").getBody();
+		const originBody = (_docDataModel$getSelf = docDataModel.getSelfOrHeaderFooterModel((_activeRange$segmentI = activeRange === null || activeRange === void 0 ? void 0 : activeRange.segmentId) !== null && _activeRange$segmentI !== void 0 ? _activeRange$segmentI : "")) === null || _docDataModel$getSelf === void 0 ? void 0 : _docDataModel$getSelf.getBody();
 		if (originBody == null) return false;
 		const { startOffset, collapsed } = range;
 		const cursorMove = cursorOffset !== null && cursorOffset !== void 0 ? cursorOffset : body.dataStream.length;
@@ -446,12 +446,12 @@ const DeleteTextCommand = {
 	id: "doc.command.delete-text",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _body$customRanges;
+		var _docDataModel$getSelf2, _body$customRanges;
 		const commandService = accessor.get(ICommandService);
 		const univerInstanceService = accessor.get(IUniverInstanceService);
 		const { range, segmentId, unitId, direction, len = 1 } = params;
 		const docDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
-		const body = docDataModel === null || docDataModel === void 0 ? void 0 : docDataModel.getSelfOrHeaderFooterModel(segmentId).getBody();
+		const body = docDataModel === null || docDataModel === void 0 || (_docDataModel$getSelf2 = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf2 === void 0 ? void 0 : _docDataModel$getSelf2.getBody();
 		if (docDataModel == null || body == null) return false;
 		const { startOffset } = range;
 		let start = direction === DeleteDirection.LEFT ? startOffset - len : startOffset;
@@ -499,7 +499,7 @@ const UpdateTextCommand = {
 	handler: (accessor, params) => {
 		const { range, segmentId, updateBody, coverType, unitId, textRanges } = params;
 		const commandService = accessor.get(ICommandService);
-		const docDataModel = accessor.get(IUniverInstanceService).getCurrentUniverDocInstance();
+		const docDataModel = accessor.get(IUniverInstanceService).getCurrentUnitOfType(UniverInstanceType.UNIVER_DOC);
 		if (docDataModel == null) return false;
 		const doMutation = {
 			id: RichTextEditingMutation.id,
@@ -529,10 +529,141 @@ const UpdateTextCommand = {
 	}
 };
 
+//#endregion
+//#region src/commands/commands/create-header-footer.command.ts
+let HeaderFooterType = /* @__PURE__ */ function(HeaderFooterType) {
+	HeaderFooterType[HeaderFooterType["FIRST_PAGE_HEADER"] = 0] = "FIRST_PAGE_HEADER";
+	HeaderFooterType[HeaderFooterType["FIRST_PAGE_FOOTER"] = 1] = "FIRST_PAGE_FOOTER";
+	HeaderFooterType[HeaderFooterType["DEFAULT_HEADER"] = 2] = "DEFAULT_HEADER";
+	HeaderFooterType[HeaderFooterType["DEFAULT_FOOTER"] = 3] = "DEFAULT_FOOTER";
+	HeaderFooterType[HeaderFooterType["EVEN_PAGE_HEADER"] = 4] = "EVEN_PAGE_HEADER";
+	HeaderFooterType[HeaderFooterType["EVEN_PAGE_FOOTER"] = 5] = "EVEN_PAGE_FOOTER";
+	return HeaderFooterType;
+}({});
+function getEmptyHeaderFooterBody() {
+	return {
+		dataStream: "\r\n",
+		textRuns: [{
+			st: 0,
+			ed: 0,
+			ts: { fs: 9 }
+		}],
+		customBlocks: [],
+		paragraphs: [{
+			startIndex: 0,
+			paragraphId: createParagraphId(/* @__PURE__ */ new Set()),
+			paragraphStyle: {
+				spaceAbove: { v: 0 },
+				lineSpacing: 1.5,
+				spaceBelow: { v: 0 }
+			}
+		}],
+		sectionBreaks: [{ startIndex: 1 }]
+	};
+}
+function createHeaderFooterAction(segmentId, createType, documentStyle, actions, createMode = "single") {
+	const jsonX = JSONX.getInstance();
+	const ID_LEN = 6;
+	const firstSegmentId = segmentId !== null && segmentId !== void 0 ? segmentId : generateRandomId(ID_LEN);
+	const isHeader = createType === 2 || createType === 0 || createType === 4;
+	const insertAction = jsonX.insertOp([isHeader ? "headers" : "footers", firstSegmentId], {
+		[isHeader ? "headerId" : "footerId"]: firstSegmentId,
+		body: getEmptyHeaderFooterBody()
+	});
+	actions.push(insertAction);
+	let key = "defaultHeaderId";
+	let pairKey = "defaultFooterId";
+	switch (createType) {
+		case 2:
+			key = "defaultHeaderId";
+			pairKey = "defaultFooterId";
+			break;
+		case 3:
+			key = "defaultFooterId";
+			pairKey = "defaultHeaderId";
+			break;
+		case 0:
+			key = "firstPageHeaderId";
+			pairKey = "firstPageFooterId";
+			break;
+		case 1:
+			key = "firstPageFooterId";
+			pairKey = "firstPageHeaderId";
+			break;
+		case 4:
+			key = "evenPageHeaderId";
+			pairKey = "evenPageFooterId";
+			break;
+		case 5:
+			key = "evenPageFooterId";
+			pairKey = "evenPageHeaderId";
+			break;
+		default: throw new Error(`Unknown header footer type: ${createType}`);
+	}
+	const linkedSegmentIds = [[key, firstSegmentId]];
+	if (createMode === "pair" && pairKey != null) {
+		const secondSegmentId = generateRandomId(ID_LEN);
+		const insertPairAction = jsonX.insertOp([isHeader ? "footers" : "headers", secondSegmentId], {
+			[isHeader ? "footerId" : "headerId"]: secondSegmentId,
+			body: getEmptyHeaderFooterBody()
+		});
+		actions.push(insertPairAction);
+		linkedSegmentIds.push([pairKey, secondSegmentId]);
+	}
+	for (const [k, id] of linkedSegmentIds) if (documentStyle[k] != null) {
+		const replaceAction = jsonX.replaceOp(["documentStyle", k], documentStyle[k], id);
+		actions.push(replaceAction);
+	} else {
+		const insertAction = jsonX.insertOp(["documentStyle", k], id);
+		actions.push(insertAction);
+	}
+	return actions;
+}
+const CreateHeaderFooterCommand = {
+	id: "doc.command.create-header-footer",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		const commandService = accessor.get(ICommandService);
+		const univerInstanceService = accessor.get(IUniverInstanceService);
+		const { unitId, segmentId, createType, headerFooterProps, createMode = "single" } = params;
+		const docDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
+		if (docDataModel == null) return false;
+		const { documentStyle } = docDataModel.getSnapshot();
+		if (documentStyle.documentFlavor === DocumentFlavor.MODERN) return false;
+		const rawActions = [];
+		const jsonX = JSONX.getInstance();
+		if (createType != null) createHeaderFooterAction(segmentId, createType, documentStyle, rawActions, createMode);
+		if (headerFooterProps != null) Object.keys(headerFooterProps).forEach((key) => {
+			const value = headerFooterProps[key];
+			const oldValue = documentStyle[key];
+			if (value === oldValue) return;
+			const action = oldValue === void 0 ? jsonX.insertOp(["documentStyle", key], value) : jsonX.replaceOp(["documentStyle", key], oldValue, value);
+			rawActions.push(action);
+		});
+		if (rawActions.length === 0) return false;
+		const doMutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId,
+				actions: rawActions.reduce((acc, cur) => JSONX.compose(acc, cur), null),
+				textRanges: [{
+					startOffset: 0,
+					endOffset: 0,
+					collapsed: true
+				}],
+				debounce: true
+			}
+		};
+		if ((headerFooterProps === null || headerFooterProps === void 0 ? void 0 : headerFooterProps.marginFooter) != null || (headerFooterProps === null || headerFooterProps === void 0 ? void 0 : headerFooterProps.marginHeader) != null) doMutation.params.noNeedSetTextRange = true;
+		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
+		return Boolean(result);
+	}
+};
+
 //#endregion
 //#region package.json
 var name = "@univerjs/docs";
-var version = "1.0.0-alpha.1";
+var version = "1.0.0-alpha.2";
 
 //#endregion
 //#region src/commands/mutations/docs-rename.mutation.ts
@@ -724,7 +855,7 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 	_initialize() {
 		this.disposeWithMe(this._commandService.beforeCommandExecuted((command) => {
 			if (command.id === UndoCommandId || command.id === RedoCommandId) {
-				const univerDoc = this._univerInstanceService.getCurrentUniverDocInstance();
+				const univerDoc = this._univerInstanceService.getCurrentUnitOfType(UniverInstanceType.UNIVER_DOC);
 				if (univerDoc == null) return;
 				const unitId = univerDoc.getUnitId();
 				this._pushHistory(unitId);
@@ -854,6 +985,7 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			InsertTextCommand,
 			DeleteTextCommand,
 			UpdateTextCommand,
+			CreateHeaderFooterCommand,
 			RichTextEditingMutation,
 			DocsRenameMutation,
 			SetTextSelectionsOperation
@@ -983,7 +1115,7 @@ function addCustomRangeFactory(accessor, param, body) {
 	return doMutation;
 }
 function addCustomRangeBySelectionFactory(accessor, param) {
-	var _selections$;
+	var _selections$, _documentDataModel$ge;
 	const { rangeId, rangeType, wholeEntity, properties, unitId, selections: propSelection } = param;
 	const docSelectionManagerService = accessor.get(DocSelectionManagerService);
 	const univerInstanceService = accessor.get(IUniverInstanceService);
@@ -995,7 +1127,7 @@ function addCustomRangeBySelectionFactory(accessor, param) {
 	if (!(selections === null || selections === void 0 ? void 0 : selections.length)) return false;
 	const documentDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 	if (!documentDataModel) return false;
-	const body = documentDataModel.getSelfOrHeaderFooterModel(segmentId).getBody();
+	const body = (_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.getBody();
 	if (!body) return false;
 	const textX = BuildTextUtils.customRange.add({
 		ranges: selections,
@@ -1092,4 +1224,17 @@ function replaceSelectionFactory(accessor, params) {
 }
 
 //#endregion
-export { DOC_INTERCEPTOR_POINT, DeleteTextCommand, DocBlockMoveValidatorService, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateChangeManagerService, DocStateEmitService, IDocStateChangeInterceptorService, InsertTextCommand, RichTextEditingMutation, SetTextSelectionsOperation, UniverDocsPlugin, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, deleteCustomRangeFactory, replaceSelectionFactory };
+//#region src/utils/util.ts
+function consumeContentInsertRange(accessor, unitId) {
+	try {
+		return accessor.get(DocContentInsertService).consumeInsertRange(unitId);
+	} catch {
+		return null;
+	}
+}
+function isHeaderFooterSelection(range) {
+	return Boolean(range === null || range === void 0 ? void 0 : range.segmentId);
+}
+
+//#endregion
+export { CreateHeaderFooterCommand, DOC_INTERCEPTOR_POINT, DeleteTextCommand, DocBlockMoveValidatorService, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateChangeManagerService, DocStateEmitService, HeaderFooterType, IDocStateChangeInterceptorService, InsertTextCommand, RichTextEditingMutation, SetTextSelectionsOperation, UniverDocsPlugin, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, consumeContentInsertRange, deleteCustomRangeFactory, isHeaderFooterSelection, replaceSelectionFactory };

package/lib/types/commands/commands/create-header-footer.command.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 { BooleanNumber, ICommand, IDocumentBody, JSONXActions } from '@univerjs/core';
+export declare enum HeaderFooterType {
+    FIRST_PAGE_HEADER = 0,
+    FIRST_PAGE_FOOTER = 1,
+    DEFAULT_HEADER = 2,
+    DEFAULT_FOOTER = 3,
+    EVEN_PAGE_HEADER = 4,
+    EVEN_PAGE_FOOTER = 5
+}
+export interface IHeaderFooterProps {
+    marginHeader?: number;
+    marginFooter?: number;
+    useFirstPageHeaderFooter?: BooleanNumber;
+    evenAndOddHeaders?: BooleanNumber;
+}
+export type HeaderFooterCreateMode = 'single' | 'pair';
+export interface ICreateHeaderFooterCommandParams {
+    unitId: string;
+    createType?: HeaderFooterType;
+    segmentId?: string;
+    headerFooterProps?: IHeaderFooterProps;
+    createMode?: HeaderFooterCreateMode;
+}
+export declare function getEmptyHeaderFooterBody(): IDocumentBody;
+export declare function createHeaderFooterAction(segmentId: string | undefined, createType: HeaderFooterType, documentStyle: IHeaderFooterProps, actions: JSONXActions, createMode?: HeaderFooterCreateMode): JSONXActions;
+export declare const CreateHeaderFooterCommand: ICommand<ICreateHeaderFooterCommandParams>;

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

@@ -14,16 +14,12 @@
  * 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;
-}
+import type { FDocument } from './f-document';
+import type { IFDocumentTextRange } from './utils';
 /**
  * Resolved paragraph metadata in the the document body.
  */
-export interface IFDocumentResolvedParagraph {
+export interface IFDocumentParagraphInfo {
     /** The underlying paragraph snapshot object. */
     paragraph: IParagraph;
     /** The current paragraph index in the body paragraph list. */
@@ -42,58 +38,55 @@ export interface IFDocumentResolvedParagraph {
  *
  * @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);
+export declare class FDocumentParagraph {
+    private readonly _document;
+    private readonly _paragraphId;
+    private readonly _segmentId;
+    private readonly _injector;
+    constructor(_document: FDocument, _paragraphId: string, _segmentId: string | undefined, _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());
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.getId());
      * ```
      */
-    getParagraphId(): string;
+    getId(): 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.
+     * Get the segment id of this paragraph.
+     * The main body paragraphs have an empty string segment id.
+     * The header and footer paragraphs have a non-empty string segment id.
+     * @returns {string} The segment 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.getResolvedParagraphInfo());
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.getSegmentId());
      * ```
      */
-    getResolvedParagraphInfo(): IFDocumentResolvedParagraph;
+    getSegmentId(): string;
+    /**
+     * Get this paragraph's metadata.
+     * @returns {IFDocumentParagraphInfo} The paragraph info.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.getInfo());
+     * ```
+     */
+    getInfo(): IFDocumentParagraphInfo;
     /**
      * 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 });
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.getRange());
      * ```
      */
     getRange(): IFDocumentTextRange;
@@ -103,13 +96,8 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @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());
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.getText());
      * ```
      */
     getText(): string;
@@ -120,14 +108,9 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @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');
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * paragraph?.setText('New text');
+     * console.log(paragraph?.getText());
      * ```
      */
     setText(text: string): boolean;
@@ -138,14 +121,9 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @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');
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * paragraph?.appendText(' Appended text');
+     * console.log(paragraph?.getText());
      * ```
      */
     appendText(text: string): boolean;
@@ -156,13 +134,18 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @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 });
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * paragraph?.setText('Styled text');
+     * paragraph?.setStyle({
+     *   textStyle: {
+     *     cl: {
+     *       rgb: '#FF0000',
+     *     },
+     *     fs: 14,
+     *   },
+     *   horizontalAlign: 2,
+     * });
+     * console.log(paragraph?.getInfo().paragraph.paragraphStyle);
      * ```
      */
     setStyle(style: IParagraphStyle): boolean;
@@ -172,13 +155,8 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @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');
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.isListItem());
      * ```
      */
     isListItem(): boolean;
@@ -188,13 +166,8 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @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');
-     * }
+     * const paragraph = fDocument.getParagraphs()[0];
+     * console.log(paragraph?.isTask());
      * ```
      */
     isTask(): boolean;
@@ -205,27 +178,27 @@ export declare class FDocumentParagraph extends FDocumentElement {
      * @example
      * ```ts
      * const fDocument = univerAPI.getActiveDocument();
-     * const fDocumentBody = fDocument.getBody();
-     * const element = fDocumentBody.getElement(0);
-     *
-     * if (element?.isParagraph()) {
-     *   const paragraph = element.asParagraph();
+     * const paragraph = fDocument.getParagraphs()[0];
      *
-     *   if (paragraph.isTask()) {
-     *     const success = paragraph.setTaskChecked(true);
-     *     console.log(success ? 'Task checked' : 'Failed to check task');
-     *   }
+     * if (paragraph.isTask()) {
+     *   const success = paragraph.setTaskChecked(true);
+     *   console.log(success ? 'Task checked' : 'Failed to check task');
      * }
      * ```
      */
     setTaskChecked(checked: boolean): boolean;
+    /**
+     * Remove this paragraph.
+     * @returns {boolean} `true` if the paragraph was removed.
+     * @example
+     * ```ts
+     * const fDocument = univerAPI.getActiveDocument();
+     * const paragraph = fDocument.getParagraphs()[0];
+     * const success = paragraph?.remove();
+     * console.log(success ? 'Paragraph removed' : 'Failed to remove paragraph');
+     * ```
+     */
+    remove(): boolean;
     private _preserveExplicitParagraphIds;
 }
-export declare class FDocumentParagraphMixin extends FDocumentElement {
-    asParagraph(): FDocumentParagraph;
-}
-declare module '@univerjs/docs/facade' {
-    interface FDocumentElement extends IFDocumentParagraphMixin {
-    }
-}
-export {};
+export declare function isParagraphFacade(value: unknown): value is FDocumentParagraph;