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

package/lib/cjs/facade.js

@@ -3,364 +3,243 @@ let _univerjs_core = require("@univerjs/core");
 let _univerjs_core_facade = require("@univerjs/core/facade");
 let _univerjs_docs = require("@univerjs/docs");
 
-//#region src/facade/doc-element-registry.ts
-const PARAGRAPH_REGISTRY_MIGRATION_ERROR = "DocElementRegistry no longer tracks paragraph identity; use paragraphId.";
+//#region src/facade/f-document-element.ts
 /**
-* Error thrown when a facade element key can no longer be resolved uniquely.
-*
-* A stale paragraph usually means the paragraph was deleted, or the document no
-* longer contains exactly one paragraph with the requested `paragraphId`.
-*
-* @example
-* ```ts
-* const doc = univerAPI.getActiveDocument();
-* if (!doc) throw new Error('No active document');
-*
-* const paragraph = doc.getBody().getChild(0).asParagraph();
-* paragraph.removeFromParent();
-*
-* try {
-*     paragraph.getText();
-* } catch (error) {
-*     if (error instanceof DocElementStaleError) {
-*         console.log('The paragraph handle is stale.');
-*     }
-* }
-* ```
-*/
-var DocElementStaleError = class extends Error {
-	/**
-	* Create a stale element error.
-	* @param {string} message The error message.
-	*/
-	constructor(message = "Doc element is stale") {
-		super(message);
-		this.name = "DocElementStaleError";
-	}
-};
-/**
-* @deprecated Paragraph facade identity is now resolved directly from persisted
-* `paragraphId` values. This class remains as a compatibility shell for callers
-* that constructed document facade internals directly.
+* A generic top-level document body element.
 *
-* @hideconstructor
-*/
-var DocElementRegistry = class {
-	/**
-	* @deprecated Paragraph facade identity is now the persisted `paragraphId`.
-	* @throws {Error} Always throws; use `paragraph.paragraphId` instead.
-	*/
-	getParagraphKey(_segmentId, _body, _paragraphIndex) {
-		throw new Error(PARAGRAPH_REGISTRY_MIGRATION_ERROR);
-	}
-	/**
-	* @deprecated Paragraph facade identity is now the persisted `paragraphId`.
-	* @throws {Error} Always throws; resolve paragraph handles by `paragraphId` instead.
-	*/
-	resolveParagraphStartIndex(_segmentId, _key) {
-		throw new Error(PARAGRAPH_REGISTRY_MIGRATION_ERROR);
-	}
-	/**
-	* @deprecated Paragraph facade identity is now the persisted `paragraphId`.
-	* @throws {Error} Always throws; resolve paragraph handles by `paragraphId` instead.
-	*/
-	syncParagraph(_segmentId, _key, _body) {
-		throw new Error(PARAGRAPH_REGISTRY_MIGRATION_ERROR);
-	}
-	/**
-	* @deprecated Paragraph facade identity is now the persisted `paragraphId`.
-	* @throws {Error} Always throws; stale state is detected from live `paragraphId` lookups.
-	*/
-	markStale(_segmentId, _key) {
-		throw new Error(PARAGRAPH_REGISTRY_MIGRATION_ERROR);
-	}
-	/**
-	* @deprecated Paragraph facade identity is now the persisted `paragraphId`.
-	* @throws {Error} Always throws; text edits no longer need registry offset tracking.
-	*/
-	beforeTextEdit(_segmentId, _startOffset, _endOffset, _insertLength) {
-		throw new Error(PARAGRAPH_REGISTRY_MIGRATION_ERROR);
-	}
-};
-
-//#endregion
-//#region src/facade/utils.ts
-function cloneParagraphStyle(paragraphStyle) {
-	return paragraphStyle == null ? paragraphStyle : JSON.parse(JSON.stringify(paragraphStyle));
-}
-function normalizePlainTextDataStream(dataStream) {
-	return dataStream.replace(/\r\n/g, "\r").replace(/\n/g, "\r");
-}
-function getRemovedLeadingParagraphBreakLength(dataStream, removeLeadingParagraphBreak) {
-	const normalized = normalizePlainTextDataStream(dataStream);
-	if (removeLeadingParagraphBreak && normalized.length > 1 && normalized.startsWith("\r")) return 1;
-	return 0;
-}
-function getNormalizedPlainTextCursorOffset(dataStream, cursorOffset, removeLeadingParagraphBreak) {
-	const normalizedPrefixLength = normalizePlainTextDataStream(dataStream.slice(0, cursorOffset)).length;
-	return Math.max(0, normalizedPrefixLength - getRemovedLeadingParagraphBreakLength(dataStream, removeLeadingParagraphBreak));
-}
-function getParagraphStyleAtOffset(body, offset) {
-	var _body$paragraphs, _paragraphs$find;
-	const paragraphs = (_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _body$paragraphs : [];
-	const paragraph = (_paragraphs$find = paragraphs.find((item) => item.startIndex >= offset)) !== null && _paragraphs$find !== void 0 ? _paragraphs$find : paragraphs[paragraphs.length - 1];
-	return paragraph === null || paragraph === void 0 ? void 0 : paragraph.paragraphStyle;
-}
-function buildPlainTextInsertBody(dataStream, options = {}) {
-	const normalizedDataStream = normalizePlainTextDataStream(dataStream).slice(getRemovedLeadingParagraphBreakLength(dataStream, options.removeLeadingParagraphBreak));
-	const body = {
-		dataStream: normalizedDataStream,
-		customDecorations: [],
-		customRanges: [],
-		textRuns: []
-	};
-	const paragraphs = [];
-	const existingParagraphIds = /* @__PURE__ */ new Set();
-	for (let index = 0; index < normalizedDataStream.length; index++) if (normalizedDataStream[index] === "\r") paragraphs.push({
-		startIndex: index,
-		paragraphId: (0, _univerjs_core.createParagraphId)(existingParagraphIds),
-		...options.paragraphStyle == null ? {} : { paragraphStyle: cloneParagraphStyle(options.paragraphStyle) }
-	});
-	if (paragraphs.length > 0) body.paragraphs = paragraphs;
-	return body;
-}
-
-//#endregion
-//#region src/facade/f-doc-block-range.ts
-/**
-* A facade wrapper for document block ranges, such as callout, quote, and code blocks.
+* Use this wrapper when you need to inspect an element type first, navigate to
+* neighboring elements, or cast the element to a more specific facade wrapper.
 *
-* Block range identity is backed by the persisted `IDocumentBlockRange.blockId`,
-* so wrappers can be re-resolved after text is inserted before the block range.
+* Paragraph keys are persisted `paragraphId` values. Tables, block ranges, and
+* custom blocks use their persisted ids.
 *
 * @hideconstructor
 */
-var FDocBlockRange = class {
-	constructor(_body, _key) {
+var FDocumentElement = class extends _univerjs_core_facade.FBase {
+	constructor(_body, _bodyEdit, _info, _injector) {
+		super();
 		this._body = _body;
-		this._key = _key;
+		this._bodyEdit = _bodyEdit;
+		this._info = _info;
+		this._injector = _injector;
 	}
 	/**
 	* Get the document element type.
-	* @returns {'blockRange'} The literal block range element type.
+	* @returns {DocumentBlockType} The element type, such as `paragraph`, `table`, `blockRange`, or `customBlock`.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* console.log(blockRange.getType());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.getType());
 	* ```
 	*/
 	getType() {
-		return "blockRange";
+		return this._info.type;
 	}
 	/**
-	* Get the block range key.
-	* @returns {string} The persisted `blockId` for this block range.
+	* Whether this element is a paragraph.
+	* @returns {boolean} `true` if this element is a paragraph.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* console.log(blockRange.getKey());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.isParagraph());
 	* ```
 	*/
-	getKey() {
-		return this._key;
+	isParagraph() {
+		return this._info.type === _univerjs_core.DocumentBlockType.PARAGRAPH;
 	}
 	/**
-	* Get the parent body facade that owns this block range.
-	* @returns {FDocBody} The document body facade.
+	* Whether this element is a table.
+	* @returns {boolean} `true` if this element is a table.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* console.log(blockRange.getParent().getChildIndex(blockRange));
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.isTable());
 	* ```
 	*/
-	getParent() {
-		return this._body;
+	isTable() {
+		return this._info.type === _univerjs_core.DocumentBlockType.TABLE;
 	}
 	/**
-	* Remove this block range and its content from the parent body.
-	* @returns {boolean} `true` if the block range content was removed.
+	* Whether this element is a block range, such as a callout, quote, or code block.
+	* @returns {boolean} `true` if this element is a block range.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* blockRange.removeFromParent();
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.isBlockRange());
 	* ```
 	*/
-	removeFromParent() {
-		return this._body.removeBlockRange(this._key);
+	isBlockRange() {
+		return this._info.type === _univerjs_core.DocumentBlockType.BLOCK_RANGE;
 	}
 	/**
-	* Get the block range type.
-	* @returns {DocumentBlockRangeType} The block type, such as callout, quote, or code.
+	* Whether this element is a custom block.
+	* @returns {boolean} `true` if this element is a custom block.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* console.log(blockRange.getBlockType());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.isCustomBlock());
 	* ```
 	*/
-	getBlockType() {
-		return this._body.getBlockRange(this._key).blockType;
+	isCustomBlock() {
+		return this._info.type === _univerjs_core.DocumentBlockType.CUSTOM_BLOCK;
 	}
 	/**
-	* Get the plain text inside this block range.
-	* @returns {string} The block range text.
+	* Get the facade key used to resolve this element.
+	* @returns {string} The paragraph `paragraphId` or persisted table/block/custom block id.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* console.log(blockRange.getText());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.getKey());
 	* ```
 	*/
-	getText() {
-		return this._body.getBlockRangeText(this._key);
+	getKey() {
+		return this._info.key;
 	}
 	/**
-	* Replace the plain text inside this block range.
-	* @param {string} text The replacement text.
-	* @returns {boolean} `true` if the block range text was replaced.
+	* Get the parent body facade that owns this element.
+	* @returns {FDocumentBody} The document body facade.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* blockRange.setText('Updated block text');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.getParent());
 	* ```
 	*/
-	setText(text) {
-		return this._body.setBlockRangeText(this._key, text);
+	getParent() {
+		return this._body;
 	}
 	/**
-	* Remove this block range wrapper from the body.
-	*
-	* This currently removes the block range and its content, matching
-	* `removeFromParent()`.
-	*
-	* @returns {boolean} `true` if the block range content was removed.
+	* Get the resolved element info for this wrapper.
+	* @returns {IFDocumentElementInfo} The resolved element info, including type, key, position, and priority.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* blockRange.unwrap();
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.getResolvedInfo());
 	* ```
 	*/
-	unwrap() {
-		return this.removeFromParent();
-	}
-};
-
-//#endregion
-//#region src/facade/f-doc-custom-block.ts
-/**
-* A facade wrapper for a document custom block, such as an embedded drawing or widget.
-*
-* Custom block identity is backed by the persisted `ICustomBlock.blockId`, so the
-* wrapper can be re-resolved after text is inserted before the custom block.
-*
-* @hideconstructor
-*/
-var FDocCustomBlock = class {
-	constructor(_body, _key) {
-		this._body = _body;
-		this._key = _key;
+	getResolvedInfo() {
+		return this._info;
 	}
 	/**
-	* Get the document element type.
-	* @returns {'customBlock'} The literal custom block element type.
+	* Get the next sibling element in the current body order.
+	* @returns {FDocumentElement | null} The next sibling wrapper, or `null` when this is the last child.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* console.log(customBlock.getType());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element?.getNextSibling());
 	* ```
 	*/
-	getType() {
-		return "customBlock";
+	getNextSibling() {
+		return this._createSibling(1);
 	}
 	/**
-	* Get the custom block key.
-	* @returns {string} The persisted `blockId` for this custom block.
+	* Get the previous sibling element in the current body order.
+	* @returns {FDocumentElement | null} The previous sibling wrapper, or `null` when this is the first child.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* console.log(customBlock.getKey());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(1);
+	* console.log(element?.getPreviousSibling());
 	* ```
 	*/
-	getKey() {
-		return this._key;
+	getPreviousSibling() {
+		return this._createSibling(-1);
 	}
 	/**
-	* Get the parent body facade that owns this custom block.
-	* @returns {FDocBody} The document body facade.
+	* Get the sibling element at a relative offset from this element.
+	* @param {number} offset The relative offset from this element. Use `1` for the next sibling, `-1` for the previous sibling, and so on.
+	* @returns {FDocumentElement | null} The sibling wrapper at the specified offset, or `null` when the offset is out of range.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* console.log(customBlock.getParent().getChildIndex(customBlock));
+	* // Get the third sibling after this element
+	* const nextThirdSibling = element?.getSibling(3);
+	* console.log(nextThirdSibling?.getType());
 	* ```
 	*/
-	getParent() {
-		return this._body;
+	getSibling(offset) {
+		return this._createSibling(offset);
 	}
 	/**
-	* Remove this custom block from the parent body.
-	* @returns {boolean} `true` if the custom block placeholder was removed.
+	* Remove this element from its parent body.
+	* @returns {boolean} `true` if the element content was removed.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* customBlock.removeFromParent();
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* const removed = element?.remove();
+	* console.log(removed);
 	* ```
 	*/
-	removeFromParent() {
-		return this._body.removeCustomBlock(this._key);
+	remove() {
+		if (this.isParagraph()) return this._body.removeParagraph(this.asParagraph());
+		if (this.isBlockRange()) return this._body.removeBlockRange(this.asBlockRange());
+		if (this.isTable()) return this._body.removeTable(this.asTable());
+		return this._body.removeCustomBlock(this.asCustomBlock());
 	}
-	/**
-	* Get the persisted custom block id.
-	* @returns {string} The `ICustomBlock.blockId` value.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* console.log(customBlock.getBlockId());
-	* ```
-	*/
-	getBlockId() {
-		return this._body.getCustomBlock(this._key).blockId;
+	_createSibling(offset) {
+		if (offset === 0) throw new Error("Offset cannot be zero.");
+		const index = this._body.getElementIndex(this);
+		return this._body.getElement(index + offset);
 	}
 };
 
 //#endregion
-//#region src/facade/f-doc-paragraph.ts
+//#region src/facade/utils.ts
+function cloneParagraphStyle(paragraphStyle) {
+	return paragraphStyle == null ? paragraphStyle : JSON.parse(JSON.stringify(paragraphStyle));
+}
+function normalizePlainTextDataStream(dataStream) {
+	return dataStream.replace(/\r\n/g, "\r").replace(/\n/g, "\r");
+}
+function getRemovedLeadingParagraphBreakLength(dataStream, removeLeadingParagraphBreak) {
+	const normalized = normalizePlainTextDataStream(dataStream);
+	if (removeLeadingParagraphBreak && normalized.length > 1 && normalized.startsWith("\r")) return 1;
+	return 0;
+}
+function buildPlainTextInsertBody(dataStream, options = {}) {
+	const normalizedDataStream = normalizePlainTextDataStream(dataStream).slice(getRemovedLeadingParagraphBreakLength(dataStream, options.removeLeadingParagraphBreak));
+	const body = {
+		dataStream: normalizedDataStream,
+		customDecorations: [],
+		customRanges: [],
+		textRuns: []
+	};
+	const paragraphs = [];
+	const existingParagraphIds = /* @__PURE__ */ new Set();
+	for (let index = 0; index < normalizedDataStream.length; index++) if (normalizedDataStream[index] === "\r") paragraphs.push({
+		startIndex: index,
+		paragraphId: (0, _univerjs_core.createParagraphId)(existingParagraphIds),
+		...options.paragraphStyle == null ? {} : { paragraphStyle: cloneParagraphStyle(options.paragraphStyle) }
+	});
+	if (paragraphs.length > 0) body.paragraphs = paragraphs;
+	return body;
+}
+
+//#endregion
+//#region src/facade/f-document-paragraph.ts
 /**
 * A paragraph facade wrapper.
 *
@@ -370,100 +249,107 @@ var FDocCustomBlock = class {
 *
 * @hideconstructor
 */
-var FDocParagraph = class {
-	constructor(_body, _key) {
-		this._body = _body;
-		this._key = _key;
-	}
-	/**
-	* Get the document element type.
-	* @returns {'paragraph'} The literal paragraph element type.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.getType());
-	* ```
-	*/
-	getType() {
-		return "paragraph";
-	}
-	/**
-	* Get the persisted paragraph id.
-	* @returns {string} The paragraph id.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.getKey());
-	* ```
-	*/
-	getKey() {
-		return this._key;
+var FDocumentParagraph = class extends FDocumentElement {
+	constructor(body, bodyEdit, info, injector) {
+		super(body, bodyEdit, info, injector);
+		this.body = body;
+		this.bodyEdit = bodyEdit;
+		this.info = info;
+		this.injector = injector;
+		if (this.getType() !== _univerjs_core.DocumentBlockType.PARAGRAPH) throw new Error(`Element type is not a paragraph: ${this.getType()}`);
 	}
 	/**
 	* Get the persisted paragraph id.
 	* @returns {string} The paragraph id.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.getId());
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   console.log(paragraph.getParagraphId());
+	* }
 	* ```
 	*/
-	getId() {
-		return this._key;
+	getParagraphId() {
+		return this.getKey();
 	}
 	/**
-	* Get the parent body facade that owns this paragraph.
-	* @returns {FDocBody} The document body facade.
+	* 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 doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.getParent().getChildIndex(paragraph));
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   console.log(paragraph.getResolvedParagraphInfo());
+	* }
 	* ```
 	*/
-	getParent() {
-		return this._body;
+	getResolvedParagraphInfo() {
+		const { paragraphs = [] } = this._body.getBody();
+		const matches = paragraphs.map((paragraph, paragraphIndex) => ({
+			paragraph,
+			paragraphIndex
+		})).filter(({ paragraph }) => paragraph.paragraphId === this.getKey());
+		if (matches.length === 0) throw new Error(`Document paragraph with id ${this.getKey()} not found`);
+		if (matches.length > 1) throw new Error(`Multiple document paragraphs with id ${this.getKey()} found`);
+		const { paragraph, paragraphIndex } = matches[0];
+		return {
+			paragraph,
+			paragraphIndex,
+			startOffset: paragraphIndex > 0 ? paragraphs[paragraphIndex - 1].startIndex + 1 : 0,
+			endOffset: paragraph.startIndex
+		};
 	}
 	/**
-	* Remove this paragraph from its parent body.
-	* @returns {boolean} `true` if the paragraph was removed.
+	* Get the current text range occupied by this paragraph.
+	* @returns {IFDocumentTextRange} The paragraph text range, excluding the trailing paragraph break.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* paragraph.removeFromParent();
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   const range = paragraph.getRange();
+	*   fDocumentBody.setTextStyle(range, { bl: 1 });
+	* }
 	* ```
 	*/
-	removeFromParent() {
-		return this._body.removeParagraph(this._key);
+	getRange() {
+		const { startOffset, endOffset } = this.getResolvedParagraphInfo();
+		return {
+			startOffset,
+			endOffset,
+			segmentId: this._body.getSegmentId()
+		};
 	}
 	/**
 	* Get this paragraph's plain text.
 	* @returns {string} The paragraph text without the trailing paragraph break.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.getText());
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   console.log(paragraph.getText());
+	* }
 	* ```
 	*/
 	getText() {
-		return this._body.getParagraphText(this._key);
+		const { dataStream } = this._body.getBody();
+		const { startOffset, endOffset } = this.getResolvedParagraphInfo();
+		return dataStream.slice(startOffset, endOffset);
 	}
 	/**
 	* Replace this paragraph's plain text.
@@ -471,15 +357,23 @@ var FDocParagraph = class {
 	* @returns {boolean} `true` if the paragraph text was replaced.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* paragraph.setText('Updated title');
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   const success = paragraph.setText('Updated title');
+	*   console.log(success ? 'Text updated' : 'Failed to update text');
+	* }
 	* ```
 	*/
 	setText(text) {
-		return this._body.setParagraphText(this._key, text);
+		const { startOffset, endOffset } = this.getResolvedParagraphInfo();
+		return this._bodyEdit.replaceRange({
+			startOffset,
+			endOffset
+		}, buildPlainTextInsertBody(text));
 	}
 	/**
 	* Append plain text before this paragraph's trailing paragraph break.
@@ -487,63 +381,95 @@ var FDocParagraph = class {
 	* @returns {boolean} `true` if the text was appended.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* paragraph.appendText(' suffix');
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   const success = paragraph.appendText(' Appended text');
+	*   console.log(success ? 'Text appended' : 'Failed to append text');
+	* }
 	* ```
 	*/
 	appendText(text) {
-		return this._body.appendParagraphText(this._key, text);
+		const { endOffset } = this.getResolvedParagraphInfo();
+		return this._body.insertText(endOffset, text);
 	}
 	/**
-	* Get the current text range occupied by this paragraph.
-	* @returns {IFDocTextRange} The paragraph text range, excluding the trailing paragraph break.
+	* 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 doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* const range = paragraph.getRange();
-	* doc.getBody().setTextStyle(range, { bl: 1 });
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   paragraph.setStyle({ horizontalAlign: 2 });
+	* }
 	* ```
 	*/
-	getRange() {
-		return this._body.getParagraphRange(this._key);
+	setStyle(style) {
+		const { paragraph, endOffset } = this.getResolvedParagraphInfo();
+		const updateBody = {
+			dataStream: "",
+			paragraphs: [{
+				...paragraph,
+				startIndex: 0,
+				paragraphStyle: {
+					...paragraph.paragraphStyle,
+					...style
+				}
+			}]
+		};
+		this._preserveExplicitParagraphIds(updateBody);
+		return this._bodyEdit.retainRange({
+			startOffset: endOffset,
+			endOffset: endOffset + 1
+		}, updateBody, _univerjs_core.UpdateDocsAttributeType.REPLACE);
 	}
 	/**
 	* Check whether this paragraph is a bullet, ordered, or checklist item.
 	* @returns {boolean} `true` if the paragraph has list metadata.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.isListItem());
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   console.log(paragraph.isListItem() ? 'This is a list item' : 'This is not a list item');
+	* }
 	* ```
 	*/
 	isListItem() {
-		return this._body.isListParagraph(this._key);
+		const { paragraph } = this.getResolvedParagraphInfo();
+		return Boolean(paragraph.bullet);
 	}
 	/**
 	* 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 doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* if (paragraph.isTask()) {
-	*     paragraph.setTaskChecked(true);
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   console.log(paragraph.isTask() ? 'This is a task item' : 'This is not a task item');
 	* }
 	* ```
 	*/
 	isTask() {
-		return this._body.isTaskParagraph(this._key);
+		var _paragraph$bullet;
+		const { paragraph } = this.getResolvedParagraphInfo();
+		const listType = (_paragraph$bullet = paragraph.bullet) === null || _paragraph$bullet === void 0 ? void 0 : _paragraph$bullet.listType;
+		return listType === _univerjs_core.PresetListType.CHECK_LIST || listType === _univerjs_core.PresetListType.CHECK_LIST_CHECKED;
 	}
 	/**
 	* Set the checked state of this task/checklist paragraph.
@@ -551,377 +477,196 @@ var FDocParagraph = class {
 	* @returns {boolean} `true` if the task state was updated, or `false` if this paragraph is not a task item.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	*
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
 	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* if (paragraph.isTask()) {
-	*     paragraph.setTaskChecked(false);
+	*   if (paragraph.isTask()) {
+	*     const success = paragraph.setTaskChecked(true);
+	*     console.log(success ? 'Task checked' : 'Failed to check task');
+	*   }
 	* }
 	* ```
 	*/
 	setTaskChecked(checked) {
-		return this._body.setTaskChecked(this._key, checked);
+		if (!this.isTask()) return false;
+		const { paragraph, endOffset } = this.getResolvedParagraphInfo();
+		const bullet = paragraph.bullet;
+		const updateBody = {
+			dataStream: "",
+			paragraphs: [{
+				...paragraph,
+				startIndex: 0,
+				bullet: {
+					...bullet,
+					listType: checked ? _univerjs_core.PresetListType.CHECK_LIST_CHECKED : _univerjs_core.PresetListType.CHECK_LIST
+				}
+			}]
+		};
+		this._preserveExplicitParagraphIds(updateBody);
+		return this._bodyEdit.retainRange({
+			startOffset: endOffset,
+			endOffset: endOffset + 1
+		}, updateBody, _univerjs_core.UpdateDocsAttributeType.REPLACE);
+	}
+	_preserveExplicitParagraphIds(body) {
+		body[_univerjs_core.RESTORE_INSERTED_PARAGRAPH_IDS] = true;
+	}
+};
+var FDocumentParagraphMixin = class extends FDocumentElement {
+	asParagraph() {
+		if (this.getType() !== _univerjs_core.DocumentBlockType.PARAGRAPH) throw new Error(`Element type is not a paragraph: ${this.getType()}`);
+		return this._injector.createInstance(FDocumentParagraph, this._body, this._bodyEdit, this.getResolvedInfo(), this._injector);
 	}
 };
+FDocumentElement.extend(FDocumentParagraphMixin);
 
 //#endregion
-//#region src/facade/f-doc-table.ts
-/**
-* A facade wrapper for a document table marker.
-*
-* Table identity is backed by the persisted `ICustomTable.tableId`, so the
-* wrapper can be re-resolved after text is inserted before the table.
-*
-* @hideconstructor
-*/
-var FDocTable = class {
-	constructor(_body, _key) {
-		this._body = _body;
-		this._key = _key;
-	}
-	/**
-	* Get the document element type.
-	* @returns {'table'} The literal table element type.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* console.log(table.getType());
-	* ```
-	*/
-	getType() {
-		return "table";
-	}
-	/**
-	* Get the table key.
-	* @returns {string} The persisted `tableId` for this table.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* console.log(table.getKey());
-	* ```
-	*/
-	getKey() {
-		return this._key;
-	}
-	/**
-	* Get the parent body facade that owns this table.
-	* @returns {FDocBody} The document body facade.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* console.log(table.getParent().getChildIndex(table));
-	* ```
-	*/
-	getParent() {
-		return this._body;
-	}
-	/**
-	* Remove this table from the parent body.
-	* @returns {boolean} `true` if the table range was removed.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* table.removeFromParent();
-	* ```
-	*/
-	removeFromParent() {
-		return this._body.removeTable(this._key);
-	}
-	/**
-	* Get the persisted table id.
-	* @returns {string} The `ICustomTable.tableId` value.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* console.log(table.getTableId());
-	* ```
-	*/
-	getTableId() {
-		return this._body.getTable(this._key).tableId;
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
 	}
-};
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
 
 //#endregion
-//#region src/facade/f-doc-element.ts
+//#region src/facade/f-document-body.ts
 /**
-* A generic top-level document body element.
-*
-* Use this wrapper when you need to inspect an element type first, navigate to
-* neighboring elements, or cast the element to a more specific facade wrapper.
+* A Facade API object bounded to a document body or header/footer segment.
+* It provides Google Docs-like element access and range editing methods.
 *
-* Paragraph keys are persisted `paragraphId` values. Tables, block ranges, and
+* Paragraph elements use their persisted `paragraphId`. Tables, block ranges, and
 * custom blocks use their persisted ids.
 *
 * @hideconstructor
 */
-var FDocElement = class {
-	constructor(_body, _type, _key) {
-		this._body = _body;
-		this._type = _type;
-		this._key = _key;
-	}
-	/**
-	* Get the document element type.
-	* @returns {FDocElementType} The element type, such as `paragraph`, `table`, `blockRange`, or `customBlock`.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const element = doc.getBody().getChild(0);
-	* console.log(element.getType());
-	* ```
-	*/
-	getType() {
-		return this._type;
-	}
-	/**
-	* Get the facade key used to resolve this element.
-	* @returns {string} The paragraph `paragraphId` or persisted table/block/custom block id.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const element = body.getChild(0);
-	* console.log(element.getKey());
-	* ```
-	*/
-	getKey() {
-		return this._key;
-	}
-	/**
-	* Get the parent body facade that owns this element.
-	* @returns {FDocBody} The document body facade.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const element = doc.getBody().getChild(0);
-	* console.log(element.getParent().getNumChildren());
-	* ```
-	*/
-	getParent() {
-		return this._body;
-	}
-	/**
-	* Get the next sibling element in the current body order.
-	* @returns {FDocElement | null} The next sibling wrapper, or `null` when this is the last child.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const first = doc.getBody().getChild(0);
-	* const next = first.getNextSibling();
-	* console.log(next?.getType());
-	* ```
-	*/
-	getNextSibling() {
-		return this._body.createSibling(this._type, this._key, 1);
-	}
-	/**
-	* Get the previous sibling element in the current body order.
-	* @returns {FDocElement | null} The previous sibling wrapper, or `null` when this is the first child.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const second = doc.getBody().getChild(1);
-	* const previous = second.getPreviousSibling();
-	* console.log(previous?.getType());
-	* ```
-	*/
-	getPreviousSibling() {
-		return this._body.createSibling(this._type, this._key, -1);
-	}
-	/**
-	* Remove this element from its parent body.
-	* @returns {boolean} `true` if the element content was removed.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const element = body.getChild(0);
-	* element.removeFromParent();
-	* ```
-	*/
-	removeFromParent() {
-		if (this._type === "paragraph") return this._body.removeParagraph(this._key);
-		if (this._type === "blockRange") return this._body.removeBlockRange(this._key);
-		if (this._type === "table") return this._body.removeTable(this._key);
-		return this._body.removeCustomBlock(this._key);
-	}
-	/**
-	* Cast this generic element to a paragraph facade.
-	* @returns {FDocParagraph} The paragraph facade wrapper.
-	* @throws {TypeError} If the element is not a paragraph.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(paragraph.getText());
-	* ```
-	*/
-	asParagraph() {
-		this._assertType("paragraph");
-		return new FDocParagraph(this._body, this._key);
-	}
-	/**
-	* Cast this generic element to a table facade.
-	* @returns {FDocTable} The table facade wrapper.
-	* @throws {TypeError} If the element is not a table.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* console.log(table.getTableId());
-	* ```
-	*/
-	asTable() {
-		this._assertType("table");
-		return new FDocTable(this._body, this._key);
+var FDocumentBody = class {
+	constructor(_documentDataModel, _injector, _segmentId = "") {
+		this._documentDataModel = _documentDataModel;
+		this._injector = _injector;
+		this._segmentId = _segmentId;
+		_defineProperty(this, "_bodyEdit", void 0);
+		this._bodyEdit = {
+			replaceRange: this._replaceBodyRange.bind(this),
+			retainRange: this._retainBodyRange.bind(this)
+		};
 	}
 	/**
-	* Cast this generic element to a callout, quote, or code block range facade.
-	* @returns {FDocBlockRange} The block range facade wrapper.
-	* @throws {TypeError} If the element is not a block range.
+	* Get the segment id of this document body facade.
+	* The main body has an empty string segment id.
+	* The header and footer FDocumentBody instances have their respective segment ids.
+	* @returns {string} The segment id of this document body facade.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const blockRange = doc.getBody().getChild(0).asBlockRange();
-	* console.log(blockRange.getBlockType());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* console.log(fDocumentBody.getSegmentId());
 	* ```
 	*/
-	asBlockRange() {
-		this._assertType("blockRange");
-		return new FDocBlockRange(this._body, this._key);
+	getSegmentId() {
+		return this._segmentId;
 	}
 	/**
-	* Cast this generic element to a custom block facade.
-	* @returns {FDocCustomBlock} The custom block facade wrapper.
-	* @throws {TypeError} If the element is not a custom block.
+	* Get the underlying document body snapshot.
+	* @returns {IDocumentBody} The document body snapshot.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* console.log(customBlock.getBlockId());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* console.log(fDocumentBody.getBody());
 	* ```
 	*/
-	asCustomBlock() {
-		this._assertType("customBlock");
-		return new FDocCustomBlock(this._body, this._key);
-	}
-	_assertType(type) {
-		if (this._type !== type) throw new TypeError(`Cannot cast ${this._type} to ${type}.`);
-	}
-};
-
-//#endregion
-//#region src/facade/f-doc-body.ts
-function isRichTextLike(value) {
-	return typeof value === "object" && value !== null && "getData" in value && typeof value.getData === "function";
-}
-const FACADE_TRIGGER = "doc-facade";
-const RESTORE_INSERTED_PARAGRAPH_IDS = "__textXRestoreParagraphIds";
-/**
-* A Facade API object bounded to a document body or header/footer segment.
-* It provides Google Docs-like element access and range editing methods.
-*
-* Paragraph elements use their persisted `paragraphId`. Tables, block ranges, and
-* custom blocks use their persisted ids.
-*
-* @hideconstructor
-*/
-var FDocBody = class {
-	constructor(_documentDataModel, _commandService, _registry, _segmentId = "") {
-		this._documentDataModel = _documentDataModel;
-		this._commandService = _commandService;
-		this._segmentId = _segmentId;
+	getBody() {
+		const body = this._documentDataModel.getSelfOrHeaderFooterModel(this._segmentId).getBody();
+		if (!body) throw new Error("The document body is empty");
+		return body;
 	}
 	/**
-	* Get the number of top-level child elements in the body.
-	* @returns {number} The number of child elements.
+	* Get a list of top-level child elements in the body.
+	* @returns {FDocumentElement[]} The list of top-level document elements.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* console.log(body.getNumChildren());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const elements = fDocumentBody.getElements();
+	* console.log(elements);
 	* ```
 	*/
-	getNumChildren() {
-		return this._getChildren().length;
+	getElements() {
+		return this._getChildren().map((child) => {
+			return this._injector.createInstance(FDocumentElement, this, this._bodyEdit, child, this._injector);
+		});
 	}
 	/**
 	* Get a top-level child element by child index.
 	* @param {number} index The zero-based child index.
-	* @returns {FDocElement} The child element wrapper.
+	* @returns {FDocumentElement} The top-level child element wrapper.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const firstChild = body.getChild(0);
-	* console.log(firstChild.getType());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(element);
 	* ```
 	*/
-	getChild(index) {
-		const child = this._getChildren()[index];
-		if (!child) throw new RangeError(`Child index ${index} is out of range.`);
-		return this._createElement(child.type, child.key);
+	getElement(index) {
+		var _this$getElements$ind;
+		return (_this$getElements$ind = this.getElements()[index]) !== null && _this$getElements$ind !== void 0 ? _this$getElements$ind : null;
 	}
 	/**
 	* Get the current child index of an element handle.
 	* The index is resolved from the element key, so a paragraph handle keeps pointing
 	* to the same paragraph after facade edits insert content before it.
-	* @param {IFDocElementHandle} element The element handle to locate.
+	* @param {FDocumentElement} element The element handle to locate.
 	* @returns {number} The current zero-based child index.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const paragraph = body.getChild(1).asParagraph();
-	* body.insertParagraph(0, 'Intro');
-	* console.log(body.getChildIndex(paragraph));
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* console.log(fDocumentBody.getElementIndex(element));
 	* ```
 	*/
-	getChildIndex(element) {
-		const resolved = this.resolveElement(element.getType(), element.getKey());
-		const index = this._getChildren().findIndex((child) => child.type === resolved.type && child.key === resolved.key);
+	getElementIndex(element) {
+		const { type, key } = element.getResolvedInfo();
+		const index = this._getChildren().findIndex((child) => child.type === type && child.key === key);
 		if (index < 0) throw new Error("Doc element is stale");
 		return index;
 	}
@@ -932,11 +677,9 @@ var FDocBody = class {
 	* @returns {boolean} `true` if the edit was applied.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* body.insertText(0, 'Hello ');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* fDocumentBody.insertText(0, 'Hello ');
 	* ```
 	*/
 	insertText(index, text) {
@@ -946,103 +689,15 @@ var FDocBody = class {
 		}, buildPlainTextInsertBody(text));
 	}
 	/**
-	* Insert a plain-text paragraph before the paragraph at the given paragraph index.
-	* @param {number} index The zero-based paragraph insertion index.
-	* @param {string} text The paragraph text. Defaults to an empty paragraph.
-	* @returns {FDocParagraph} The inserted paragraph wrapper.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const paragraph = body.insertParagraph(0, 'Document title');
-	* paragraph.appendText(' suffix');
-	* ```
-	*/
-	insertParagraph(index, text = "") {
-		var _this$_getBody$paragr;
-		const offset = this._getParagraphInsertOffset(index);
-		if (!this._replaceBodyRange({
-			startOffset: offset,
-			endOffset: offset
-		}, buildPlainTextInsertBody(`${text}\r`))) throw new Error("Failed to insert paragraph.");
-		const paragraphIndex = this._normalizeInsertedParagraphIndex(index);
-		const paragraph = (_this$_getBody$paragr = this._getBody().paragraphs) === null || _this$_getBody$paragr === void 0 ? void 0 : _this$_getBody$paragr[paragraphIndex];
-		return new FDocParagraph(this, this._getParagraphId(paragraph, paragraphIndex));
-	}
-	/**
-	* Append a plain-text paragraph at the end of the body.
-	* @param {string} text The paragraph text. Defaults to an empty paragraph.
-	* @returns {FDocParagraph} The appended paragraph wrapper.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const paragraph = body.appendParagraph('Summary');
-	* console.log(paragraph.getText());
-	* ```
-	*/
-	appendParagraph(text = "") {
-		var _this$_getBody$paragr2, _this$_getBody$paragr3;
-		return this.insertParagraph((_this$_getBody$paragr2 = (_this$_getBody$paragr3 = this._getBody().paragraphs) === null || _this$_getBody$paragr3 === void 0 ? void 0 : _this$_getBody$paragr3.length) !== null && _this$_getBody$paragr2 !== void 0 ? _this$_getBody$paragr2 : 0, text);
-	}
-	/**
-	* Delete a range from the body.
-	* @param {IFDocTextRange} range The text range to delete.
-	* @returns {boolean} `true` if the range was deleted.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* body.deleteRange({ startOffset: 0, endOffset: 5 });
-	* ```
-	*/
-	deleteRange(range) {
-		return this._replaceBodyRange(range, { dataStream: "" });
-	}
-	/**
-	* Replace a range with plain text or rich text body data.
-	* @param {IFDocTextRange} range The text range to replace.
-	* @param {string | IFDocRichTextLike | { body?: IDocumentBody }} value The replacement text or rich-text-like value.
-	* @returns {boolean} `true` if the replacement was applied.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* body.replaceRange({ startOffset: 0, endOffset: 5 }, 'Hello');
-	* ```
-	*/
-	replaceRange(range, value) {
-		let body;
-		if (typeof value === "string") body = buildPlainTextInsertBody(value);
-		else if (isRichTextLike(value)) {
-			var _value$getData$body;
-			body = (_value$getData$body = value.getData().body) !== null && _value$getData$body !== void 0 ? _value$getData$body : { dataStream: "" };
-		} else {
-			var _value$body;
-			body = (_value$body = value.body) !== null && _value$body !== void 0 ? _value$body : { dataStream: "" };
-		}
-		return this._replaceBodyRange(range, body);
-	}
-	/**
 	* Apply text style to a body range.
-	* @param {IFDocTextRange} range The range to style.
+	* @param {IFDocumentTextRange} range The range to style.
 	* @param {ITextStyle} style The Univer text style patch.
 	* @returns {boolean} `true` if the style was applied.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* body.setTextStyle({ startOffset: 0, endOffset: 5 }, { bl: 1 });
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* fDocumentBody.setTextStyle({ startOffset: 0, endOffset: 5 }, { bl: 1 });
 	* ```
 	*/
 	setTextStyle(range, style) {
@@ -1057,525 +712,235 @@ var FDocBody = class {
 		return this._retainBodyRange(range, updateBody, _univerjs_core.UpdateDocsAttributeType.COVER);
 	}
 	/**
-	* Apply paragraph style to a paragraph handle or text range.
-	* @param {FDocElement | FDocParagraph | IFDocTextRange} paragraph The paragraph handle or a range inside the paragraph.
-	* @param {IParagraphStyle} style The Univer paragraph style patch.
-	* @returns {boolean} `true` if the style was applied.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const paragraph = body.getChild(0).asParagraph();
-	* body.setParagraphStyle(paragraph, { horizontalAlign: 2 });
-	* ```
-	*/
-	setParagraphStyle(paragraph, style) {
-		const resolved = paragraph instanceof FDocElement || paragraph instanceof FDocParagraph ? this.resolveParagraph(paragraph.getKey()) : this._findParagraphByRange(paragraph);
-		const updateBody = {
-			dataStream: "",
-			paragraphs: [{
-				...resolved.paragraph,
-				startIndex: 0,
-				paragraphStyle: {
-					...resolved.paragraph.paragraphStyle,
-					...style
-				}
-			}]
-		};
-		this._preserveExplicitParagraphIds(updateBody);
-		return this._retainBodyRange({
-			startOffset: resolved.endOffset,
-			endOffset: resolved.endOffset + 1
-		}, updateBody, _univerjs_core.UpdateDocsAttributeType.REPLACE);
-	}
-	/**
-	* Get the text content of a paragraph by paragraph id.
-	* @param {string} key The paragraph id.
-	* @returns {string} The paragraph text without the trailing paragraph break.
+	* Insert a plain-text paragraph before the paragraph at the given paragraph index.
+	* @param {number} index The zero-based paragraph insertion index.
+	* @param {string} text The paragraph text. Defaults to an empty paragraph.
+	* @returns {FDocumentParagraph} The inserted paragraph wrapper.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(doc.getBody().getParagraphText(paragraph.getKey()));
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const paragraph = fDocumentBody.insertParagraph(0, 'Document title');
+	* paragraph.appendText(' suffix');
 	* ```
 	*/
-	getParagraphText(key) {
-		const resolved = this.resolveParagraph(key);
-		return this._getBody().dataStream.slice(resolved.startOffset, resolved.endOffset);
+	insertParagraph(index, text = "") {
+		var _paragraphs;
+		const offset = this._getParagraphInsertOffset(index);
+		if (!this._replaceBodyRange({
+			startOffset: offset,
+			endOffset: offset
+		}, buildPlainTextInsertBody(`${text}\r`))) throw new Error("Failed to insert paragraph.");
+		const { paragraphs = [] } = this.getBody();
+		const paragraph = paragraphs[index];
+		if (!paragraph) throw new Error("Failed to insert paragraph.");
+		const info = this._resolveParagraphInfo(paragraph, index, (_paragraphs = paragraphs[index - 1]) === null || _paragraphs === void 0 ? void 0 : _paragraphs.startIndex);
+		return this._injector.createInstance(FDocumentParagraph, this, this._bodyEdit, info, this._injector);
 	}
 	/**
-	* Replace the text content of a paragraph by paragraph id.
-	* @param {string} key The paragraph id.
-	* @param {string} text The replacement paragraph text.
-	* @returns {boolean} `true` if the paragraph text was replaced.
+	* Append a plain-text paragraph at the end of the body.
+	* @param {string} text The paragraph text. Defaults to an empty paragraph.
+	* @returns {FDocumentParagraph} The appended paragraph wrapper.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* doc.getBody().setParagraphText(paragraph.getKey(), 'Updated text');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const paragraph = fDocumentBody.appendParagraph('Summary');
+	* console.log(paragraph.getText());
 	* ```
 	*/
-	setParagraphText(key, text) {
-		const resolved = this.resolveParagraph(key);
-		return this.replaceRange({
-			startOffset: resolved.startOffset,
-			endOffset: resolved.endOffset
-		}, text);
+	appendParagraph(text = "") {
+		const { paragraphs = [] } = this.getBody();
+		return this.insertParagraph(paragraphs.length, text);
 	}
 	/**
-	* Append text to a paragraph by paragraph id.
-	* @param {string} key The paragraph id.
-	* @param {string} text The text to append before the paragraph break.
-	* @returns {boolean} `true` if the text was appended.
+	* Delete a range from the body.
+	* @param {IFDocumentTextRange} range The text range to delete.
+	* @returns {boolean} `true` if the range was deleted.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* doc.getBody().appendParagraphText(paragraph.getKey(), ' suffix');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* fDocumentBody.deleteRange({ startOffset: 0, endOffset: 5 });
 	* ```
 	*/
-	appendParagraphText(key, text) {
-		const resolved = this.resolveParagraph(key);
-		return this.insertText(resolved.endOffset, text);
+	deleteRange(range) {
+		return this._replaceBodyRange(range, { dataStream: "" });
 	}
 	/**
 	* Remove a paragraph by paragraph id.
-	* @param {string} key The paragraph id.
+	* @param {FDocumentParagraph} paragraph The paragraph handle to remove.
 	* @returns {boolean} `true` if the paragraph was removed.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* doc.getBody().removeParagraph(paragraph.getKey());
-	* ```
-	*/
-	removeParagraph(key) {
-		const resolved = this.resolveParagraph(key);
-		return this.deleteRange({
-			startOffset: resolved.startOffset,
-			endOffset: resolved.endOffset + 1
-		});
-	}
-	/**
-	* Get a paragraph text range by paragraph id.
-	* @param {string} key The paragraph id.
-	* @returns {IFDocTextRange} The paragraph range excluding the trailing paragraph break.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* const range = doc.getBody().getParagraphRange(paragraph.getKey());
-	* console.log(range.startOffset, range.endOffset);
-	* ```
-	*/
-	getParagraphRange(key) {
-		const resolved = this.resolveParagraph(key);
-		return {
-			startOffset: resolved.startOffset,
-			endOffset: resolved.endOffset,
-			segmentId: this._segmentId
-		};
-	}
-	/**
-	* Check whether a paragraph has list metadata.
-	* @param {string} key The paragraph id.
-	* @returns {boolean} `true` if the paragraph is a list item.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(doc.getBody().isListParagraph(paragraph.getKey()));
-	* ```
-	*/
-	isListParagraph(key) {
-		return Boolean(this.resolveParagraph(key).paragraph.bullet);
-	}
-	/**
-	* Check whether a paragraph is a task/checklist item.
-	* @param {string} key The paragraph id.
-	* @returns {boolean} `true` if the paragraph is an unchecked or checked task item.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* console.log(doc.getBody().isTaskParagraph(paragraph.getKey()));
-	* ```
-	*/
-	isTaskParagraph(key) {
-		var _this$resolveParagrap;
-		const listType = (_this$resolveParagrap = this.resolveParagraph(key).paragraph.bullet) === null || _this$resolveParagrap === void 0 ? void 0 : _this$resolveParagrap.listType;
-		return listType === _univerjs_core.PresetListType.CHECK_LIST || listType === _univerjs_core.PresetListType.CHECK_LIST_CHECKED;
-	}
-	/**
-	* Set the checked state of a task/checklist paragraph.
-	* @param {string} key The paragraph id.
-	* @param {boolean} checked Whether the task should be checked.
-	* @returns {boolean} `true` if the task state was updated, or `false` if the paragraph is not a task item.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* doc.getBody().setTaskChecked(paragraph.getKey(), true);
-	* ```
-	*/
-	setTaskChecked(key, checked) {
-		const resolved = this.resolveParagraph(key);
-		const bullet = resolved.paragraph.bullet;
-		if (!bullet || !this.isTaskParagraph(key)) return false;
-		const updateBody = {
-			dataStream: "",
-			paragraphs: [{
-				...resolved.paragraph,
-				startIndex: 0,
-				bullet: {
-					...bullet,
-					listType: checked ? _univerjs_core.PresetListType.CHECK_LIST_CHECKED : _univerjs_core.PresetListType.CHECK_LIST
-				}
-			}]
-		};
-		this._preserveExplicitParagraphIds(updateBody);
-		return this._retainBodyRange({
-			startOffset: resolved.endOffset,
-			endOffset: resolved.endOffset + 1
-		}, updateBody, _univerjs_core.UpdateDocsAttributeType.REPLACE);
-	}
-	/**
-	* Resolve a paragraph id to its current paragraph metadata.
-	* @param {string} key The paragraph id.
-	* @returns {IFDocResolvedParagraph} The current paragraph metadata.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const paragraph = doc.getBody().getChild(0).asParagraph();
-	* const resolved = doc.getBody().resolveParagraph(paragraph.getKey());
-	* console.log(resolved.paragraphIndex);
-	* ```
-	*/
-	resolveParagraph(key) {
-		var _body$paragraphs;
-		const body = this._getBody();
-		const matches = ((_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _body$paragraphs : []).map((paragraph, paragraphIndex) => ({
-			paragraph,
-			paragraphIndex
-		})).filter(({ paragraph }) => paragraph.paragraphId === key);
-		if (matches.length !== 1) throw new DocElementStaleError(matches.length > 1 ? `Doc paragraph id "${key}" is duplicated.` : `Doc paragraph id "${key}" is stale.`);
-		const { paragraph, paragraphIndex } = matches[0];
-		return {
-			paragraph,
-			paragraphIndex,
-			startOffset: paragraphIndex > 0 ? body.paragraphs[paragraphIndex - 1].startIndex + 1 : 0,
-			endOffset: paragraph.startIndex
-		};
-	}
-	/**
-	* Resolve an element key to its current child metadata.
-	* @param {FDocElementType} type The element type.
-	* @param {string} key The persisted element key.
-	* @returns {object} The current child metadata used by the facade.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const element = doc.getBody().getChild(0);
-	* const resolved = doc.getBody().resolveElement(element.getType(), element.getKey());
-	* console.log(resolved.position);
-	* ```
-	*/
-	resolveElement(type, key) {
-		if (type === "paragraph") return {
-			type,
-			key,
-			position: this.resolveParagraph(key).startOffset,
-			priority: 3
-		};
-		const child = this._getChildren().find((item) => item.type === type && item.key === key);
-		if (!child) throw new Error("Doc element is stale");
-		return child;
-	}
-	/**
-	* Get a callout, quote, or code block range by block id.
-	* @param {string} key The persisted block range id.
-	* @returns {IDocumentBlockRange} The matching block range snapshot.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const block = doc.getBody().getChild(0).asBlockRange();
-	* console.log(doc.getBody().getBlockRange(block.getKey()).blockType);
-	* ```
-	*/
-	getBlockRange(key) {
-		var _this$_getBody$blockR;
-		const blockRange = (_this$_getBody$blockR = this._getBody().blockRanges) === null || _this$_getBody$blockR === void 0 ? void 0 : _this$_getBody$blockR.find((item) => item.blockId === key);
-		if (!blockRange) throw new Error("Doc element is stale");
-		return blockRange;
-	}
-	/**
-	* Get the text inside a callout, quote, or code block range.
-	* @param {string} key The persisted block range id.
-	* @returns {string} The block range text.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const block = doc.getBody().getChild(0).asBlockRange();
-	* console.log(doc.getBody().getBlockRangeText(block.getKey()));
-	* ```
-	*/
-	getBlockRangeText(key) {
-		const blockRange = this.getBlockRange(key);
-		return this._getBody().dataStream.slice(blockRange.startIndex, blockRange.endIndex);
-	}
-	/**
-	* Replace the text inside a callout, quote, or code block range.
-	* @param {string} key The persisted block range id.
-	* @param {string} text The replacement text.
-	* @returns {boolean} `true` if the text was replaced.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const block = doc.getBody().getChild(0).asBlockRange();
-	* doc.getBody().setBlockRangeText(block.getKey(), 'Updated block');
-	* ```
-	*/
-	setBlockRangeText(key, text) {
-		const blockRange = this.getBlockRange(key);
-		const body = buildPlainTextInsertBody(`${text}\r`);
-		body.blockRanges = [{
-			...blockRange,
-			startIndex: 0,
-			endIndex: text.length
-		}];
-		return this.replaceRange({
-			startOffset: blockRange.startIndex,
-			endOffset: blockRange.endIndex + 1
-		}, { body });
-	}
-	/**
-	* Remove a callout, quote, or code block range and its content.
-	* @param {string} key The persisted block range id.
-	* @returns {boolean} `true` if the block range content was removed.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const block = doc.getBody().getChild(0).asBlockRange();
-	* doc.getBody().removeBlockRange(block.getKey());
+	* if (element?.isParagraph()) {
+	*   const paragraph = element.asParagraph();
+	*   const removed = fDocumentBody.removeParagraph(paragraph);
+	*   console.log(removed ? 'Paragraph removed' : 'Failed to remove paragraph');
+	* }
 	* ```
 	*/
-	removeBlockRange(key) {
-		const blockRange = this.getBlockRange(key);
+	removeParagraph(paragraph) {
+		const { startOffset, endOffset } = paragraph.getResolvedParagraphInfo();
 		return this.deleteRange({
-			startOffset: blockRange.startIndex,
-			endOffset: blockRange.endIndex + 1
-		});
-	}
-	/**
-	* Get a table marker by table id.
-	* @param {string} key The persisted table id.
-	* @returns {ICustomTable} The matching table marker.
-	* @example
-	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* console.log(doc.getBody().getTable(table.getTableId()));
-	* ```
-	*/
-	getTable(key) {
-		var _this$_getBody$tables;
-		const table = (_this$_getBody$tables = this._getBody().tables) === null || _this$_getBody$tables === void 0 ? void 0 : _this$_getBody$tables.find((item) => item.tableId === key);
-		if (!table) throw new Error("Doc element is stale");
-		return table;
+			startOffset,
+			endOffset: endOffset + 1
+		});
 	}
 	/**
-	* Remove a table marker and its content range.
-	* @param {string} key The persisted table id.
-	* @returns {boolean} `true` if the table range was removed.
+	* Remove a callout, quote, or code block range and its content.
+	* @param {FDocumentBlockRange} blockRange The block range handle to remove.
+	* @returns {boolean} `true` if the block range content was removed.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const table = doc.getBody().getChild(0).asTable();
-	* doc.getBody().removeTable(table.getTableId());
+	* if (element?.isBlockRange()) {
+	*   const blockRange = element.asBlockRange();
+	*   const removed = fDocumentBody.removeBlockRange(blockRange);
+	*   console.log(removed ? 'Block range removed' : 'Failed to remove block range');
+	* }
 	* ```
 	*/
-	removeTable(key) {
-		const table = this.getTable(key);
+	removeBlockRange(blockRange) {
+		const { startIndex, endIndex } = blockRange.getBlockRange();
 		return this.deleteRange({
-			startOffset: table.startIndex,
-			endOffset: table.endIndex + 1
+			startOffset: startIndex,
+			endOffset: endIndex + 1
 		});
 	}
 	/**
-	* Get a custom block marker by block id.
-	* @param {string} key The persisted custom block id.
-	* @returns {ICustomBlock} The matching custom block marker.
+	* Remove a table marker and its content range.
+	* @returns {boolean} `true` if the table range was removed.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* console.log(doc.getBody().getCustomBlock(customBlock.getBlockId()));
+	* if (element?.isTable()) {
+	*   const table = element.asTable();
+	*   const removed = fDocumentBody.removeTable(table);
+	*   console.log(removed ? 'Table removed' : 'Failed to remove table');
+	* }
 	* ```
 	*/
-	getCustomBlock(key) {
-		var _this$_getBody$custom;
-		const block = (_this$_getBody$custom = this._getBody().customBlocks) === null || _this$_getBody$custom === void 0 ? void 0 : _this$_getBody$custom.find((item) => item.blockId === key);
-		if (!block) throw new Error("Doc element is stale");
-		return block;
+	removeTable(table) {
+		const { startIndex, endIndex } = table.getTable();
+		return this.deleteRange({
+			startOffset: startIndex,
+			endOffset: endIndex + 1
+		});
 	}
 	/**
 	* Remove a custom block marker and its placeholder character.
-	* @param {string} key The persisted custom block id.
+	* @param {FDocumentCustomBlock} customBlock The custom block handle to remove.
 	* @returns {boolean} `true` if the custom block placeholder was removed.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* const customBlock = doc.getBody().getChild(0).asCustomBlock();
-	* doc.getBody().removeCustomBlock(customBlock.getBlockId());
+	* if (element?.isCustomBlock()) {
+	*   const customBlock = element.asCustomBlock();
+	*   const removed = fDocumentBody.removeCustomBlock(customBlock);
+	*   console.log(removed ? 'Custom block removed' : 'Failed to remove custom block');
+	* }
 	* ```
 	*/
-	removeCustomBlock(key) {
-		const block = this.getCustomBlock(key);
+	removeCustomBlock(customBlock) {
+		const { startIndex } = customBlock.getCustomBlock();
 		return this.deleteRange({
-			startOffset: block.startIndex,
-			endOffset: block.startIndex + 1
+			startOffset: startIndex,
+			endOffset: startIndex + 1
 		});
 	}
 	/**
-	* Create a sibling element wrapper relative to the current element key.
-	* @param {FDocElementType} type The current element type.
-	* @param {string} key The current element key.
-	* @param {-1 | 1} direction `-1` for previous sibling, `1` for next sibling.
-	* @returns {FDocElement | null} The sibling wrapper, or `null` if none exists.
+	* Resolve an element key to its current child metadata.
+	* @param {FDocumentElement} element The element handle to resolve.
+	* @returns {IFDocumentElementInfo} The current child metadata used by the facade.
 	* @example
 	* ```ts
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const element = doc.getBody().getChild(0);
-	* const next = doc.getBody().createSibling(element.getType(), element.getKey(), 1);
-	* console.log(next?.getType());
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	* const resolved = fDocumentBody.resolveElement(element);
+	* console.log(resolved);
 	* ```
 	*/
-	createSibling(type, key, direction) {
-		const index = this.getChildIndex(this._createElement(type, key));
-		const child = this._getChildren()[index + direction];
-		return child ? this._createElement(child.type, child.key) : null;
+	resolveElement(element) {
+		const { type, key } = element.getResolvedInfo();
+		const child = this._getChildren().find((item) => item.type === type && item.key === key);
+		if (!child) throw new Error("Doc element is stale");
+		return child;
 	}
 	_getChildren() {
-		var _body$paragraphs$leng, _body$paragraphs2, _body$blockRanges, _body$tables, _body$customBlocks;
-		const body = this._getBody();
+		const { paragraphs, blockRanges, tables, customBlocks } = this.getBody();
 		const children = [];
-		for (let index = 0; index < ((_body$paragraphs$leng = (_body$paragraphs2 = body.paragraphs) === null || _body$paragraphs2 === void 0 ? void 0 : _body$paragraphs2.length) !== null && _body$paragraphs$leng !== void 0 ? _body$paragraphs$leng : 0); index++) {
-			const paragraph = body.paragraphs[index];
+		if (paragraphs) for (let i = 0; i < paragraphs.length; i++) {
+			var _paragraphs2;
+			const paragraph = paragraphs[i];
+			const info = this._resolveParagraphInfo(paragraph, i, (_paragraphs2 = paragraphs[i - 1]) === null || _paragraphs2 === void 0 ? void 0 : _paragraphs2.startIndex);
+			children.push(info);
+		}
+		if (blockRanges) for (let i = 0; i < blockRanges.length; i++) {
+			const blockRange = blockRanges[i];
 			children.push({
-				type: "paragraph",
-				key: this._getParagraphId(paragraph, index),
-				position: index > 0 ? body.paragraphs[index - 1].startIndex + 1 : 0,
-				priority: 3
+				type: _univerjs_core.DocumentBlockType.BLOCK_RANGE,
+				key: blockRange.blockId,
+				position: blockRange.startIndex,
+				priority: 0
+			});
+		}
+		if (tables) for (let i = 0; i < tables.length; i++) {
+			const table = tables[i];
+			children.push({
+				type: _univerjs_core.DocumentBlockType.TABLE,
+				key: table.tableId,
+				position: table.startIndex,
+				priority: 1
+			});
+		}
+		if (customBlocks) for (let i = 0; i < customBlocks.length; i++) {
+			const customBlock = customBlocks[i];
+			children.push({
+				type: _univerjs_core.DocumentBlockType.CUSTOM_BLOCK,
+				key: customBlock.blockId,
+				position: customBlock.startIndex,
+				priority: 2
 			});
 		}
-		(_body$blockRanges = body.blockRanges) === null || _body$blockRanges === void 0 || _body$blockRanges.forEach((blockRange) => children.push({
-			type: "blockRange",
-			key: blockRange.blockId,
-			position: blockRange.startIndex,
-			priority: 0
-		}));
-		(_body$tables = body.tables) === null || _body$tables === void 0 || _body$tables.forEach((table) => children.push({
-			type: "table",
-			key: table.tableId,
-			position: table.startIndex,
-			priority: 1
-		}));
-		(_body$customBlocks = body.customBlocks) === null || _body$customBlocks === void 0 || _body$customBlocks.forEach((customBlock) => children.push({
-			type: "customBlock",
-			key: customBlock.blockId,
-			position: customBlock.startIndex,
-			priority: 2
-		}));
 		return children.sort((a, b) => a.position - b.position || a.priority - b.priority);
 	}
-	_createElement(type, key) {
-		return new FDocElement(this, type, key);
+	_resolveParagraphInfo(paragraph, paragraphIndex, previousParagraphStartIndex) {
+		return {
+			type: _univerjs_core.DocumentBlockType.PARAGRAPH,
+			key: this._getParagraphId(paragraph, paragraphIndex),
+			position: paragraphIndex > 0 ? previousParagraphStartIndex + 1 : 0,
+			priority: 3
+		};
 	}
-	_getBody() {
-		const body = this._documentDataModel.getSelfOrHeaderFooterModel(this._segmentId).getBody();
-		if (!body) throw new Error("The document body is empty");
-		return body;
+	_getParagraphId(paragraph, paragraphIndex) {
+		if (!paragraph) throw new Error(`Paragraph index ${paragraphIndex} is out of range.`);
+		if (!paragraph.paragraphId) throw new Error(`Paragraph at index ${paragraphIndex} is missing paragraphId.`);
+		return paragraph.paragraphId;
 	}
 	_getParagraphInsertOffset(index) {
-		var _body$paragraphs3;
-		const body = this._getBody();
 		if (index <= 0) return 0;
-		const paragraphs = (_body$paragraphs3 = body.paragraphs) !== null && _body$paragraphs3 !== void 0 ? _body$paragraphs3 : [];
-		if (paragraphs.length === 0) return Math.max(0, body.dataStream.length - 1);
+		const { dataStream, paragraphs = [] } = this.getBody();
+		if (paragraphs.length === 0) return Math.max(0, dataStream.length - 1);
 		if (index >= paragraphs.length) return paragraphs[paragraphs.length - 1].startIndex + 1;
 		return paragraphs[index - 1].startIndex + 1;
 	}
-	_normalizeInsertedParagraphIndex(index) {
-		var _this$_getBody$paragr4;
-		const paragraphs = (_this$_getBody$paragr4 = this._getBody().paragraphs) !== null && _this$_getBody$paragr4 !== void 0 ? _this$_getBody$paragr4 : [];
-		return Math.max(0, Math.min(index, paragraphs.length - 1));
-	}
-	_getParagraphId(paragraph, paragraphIndex) {
-		if (!paragraph) throw new RangeError(`Paragraph index ${paragraphIndex} is out of range.`);
-		if (!paragraph.paragraphId) throw new DocElementStaleError(`Paragraph at index ${paragraphIndex} is missing paragraphId.`);
-		return paragraph.paragraphId;
-	}
-	_preserveExplicitParagraphIds(body) {
-		body[RESTORE_INSERTED_PARAGRAPH_IDS] = true;
-	}
-	_findParagraphByRange(range) {
-		var _this$_getBody$paragr5;
-		const paragraphs = (_this$_getBody$paragr5 = this._getBody().paragraphs) !== null && _this$_getBody$paragr5 !== void 0 ? _this$_getBody$paragr5 : [];
-		const paragraphIndex = paragraphs.findIndex((paragraph, index) => {
-			return (index > 0 ? paragraphs[index - 1].startIndex + 1 : 0) <= range.startOffset && range.endOffset <= paragraph.startIndex;
-		});
-		if (paragraphIndex < 0) throw new RangeError("Range does not resolve to a paragraph.");
-		const paragraph = paragraphs[paragraphIndex];
-		return {
-			paragraph,
-			paragraphIndex,
-			startOffset: paragraphIndex > 0 ? paragraphs[paragraphIndex - 1].startIndex + 1 : 0,
-			endOffset: paragraph.startIndex
-		};
-	}
 	_replaceBodyRange(range, insertBody) {
-		const startOffset = range.startOffset;
-		const endOffset = range.endOffset;
+		const { startOffset, endOffset } = range;
 		const textX = new _univerjs_core.TextX();
 		if (startOffset > 0) textX.push({
 			t: _univerjs_core.TextXActionType.RETAIN,
@@ -1594,7 +959,7 @@ var FDocBody = class {
 	}
 	_retainBodyRange(range, body, coverType) {
 		var _body$textRuns;
-		if (((_body$textRuns = body.textRuns) === null || _body$textRuns === void 0 ? void 0 : _body$textRuns.length) && this._getBody().textRuns == null) this._ensureTextRuns();
+		if (((_body$textRuns = body.textRuns) === null || _body$textRuns === void 0 ? void 0 : _body$textRuns.length) && this.getBody().textRuns == null) this._ensureTextRuns();
 		const textX = new _univerjs_core.TextX();
 		if (range.startOffset > 0) textX.push({
 			t: _univerjs_core.TextXActionType.RETAIN,
@@ -1609,73 +974,27 @@ var FDocBody = class {
 		return this._executeTextX(textX);
 	}
 	_ensureTextRuns() {
-		if (this._getBody().textRuns != null) return;
 		const actions = _univerjs_core.JSONX.getInstance().replaceOp([...(0, _univerjs_core.getRichTextEditPath)(this._documentDataModel, this._segmentId), "textRuns"], void 0, []);
-		this._commandService.syncExecuteCommand(_univerjs_docs.RichTextEditingMutation.id, {
+		this._injector.get(_univerjs_core.ICommandService).syncExecuteCommand(_univerjs_docs.RichTextEditingMutation.id, {
 			unitId: this._documentDataModel.getUnitId(),
 			segmentId: this._segmentId,
 			actions,
 			textRanges: [],
-			trigger: FACADE_TRIGGER,
 			isEditing: false
 		});
 	}
 	_executeTextX(textX) {
 		const actions = _univerjs_core.JSONX.getInstance().editOp(textX.serialize(), (0, _univerjs_core.getRichTextEditPath)(this._documentDataModel, this._segmentId));
-		const result = this._commandService.syncExecuteCommand(_univerjs_docs.RichTextEditingMutation.id, {
+		return this._injector.get(_univerjs_core.ICommandService).syncExecuteCommand(_univerjs_docs.RichTextEditingMutation.id, {
 			unitId: this._documentDataModel.getUnitId(),
 			segmentId: this._segmentId,
 			actions,
 			textRanges: [],
-			trigger: FACADE_TRIGGER,
 			isEditing: false
-		});
-		return Boolean(result);
+		}) !== false;
 	}
 };
 
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
-function _typeof(o) {
-	"@babel/helpers - typeof";
-	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
-		return typeof o;
-	} : function(o) {
-		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-	}, _typeof(o);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
-function toPrimitive(t, r) {
-	if ("object" != _typeof(t) || !t) return t;
-	var e = t[Symbol.toPrimitive];
-	if (void 0 !== e) {
-		var i = e.call(t, r || "default");
-		if ("object" != _typeof(i)) return i;
-		throw new TypeError("@@toPrimitive must return a primitive value.");
-	}
-	return ("string" === r ? String : Number)(t);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
-function toPropertyKey(t) {
-	var i = toPrimitive(t, "string");
-	return "symbol" == _typeof(i) ? i : i + "";
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
-function _defineProperty(e, r, t) {
-	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-		value: t,
-		enumerable: !0,
-		configurable: !0,
-		writable: !0
-	}) : e[r] = t, e;
-}
-
 //#endregion
 //#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
@@ -1704,7 +1023,6 @@ let FDocument = class FDocument extends _univerjs_core_facade.FBaseInitialable {
 		this._resourceLoaderService = _resourceLoaderService;
 		this._commandService = _commandService;
 		_defineProperty(this, "id", void 0);
-		_defineProperty(this, "_docElementRegistry", new DocElementRegistry());
 		this.id = this._documentDataModel.getUnitId();
 	}
 	/**
@@ -1728,19 +1046,23 @@ let FDocument = class FDocument extends _univerjs_core_facade.FBaseInitialable {
 	* use their persisted `paragraphId` values. Persisted elements, such as tables
 	* and custom blocks, use their existing ids.
 	*
-	* @returns {FDocBody} The document body API instance.
+	* @returns {FDocumentBody} The document body API instance.
 	* @example
 	* ```typescript
-	* const doc = univerAPI.getActiveDocument();
-	* if (!doc) throw new Error('No active document');
-	*
-	* const body = doc.getBody();
-	* const paragraph = body.getChild(0).asParagraph();
-	* paragraph.appendText(' updated');
+	* 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() {
-		return new FDocBody(this._documentDataModel, this._commandService, this._docElementRegistry);
+		return this._injector.createInstance(FDocumentBody, this._documentDataModel, this._injector);
 	}
 	dispose() {
 		super.dispose();
@@ -1812,168 +1134,275 @@ let FDocument = class FDocument extends _univerjs_core_facade.FBaseInitialable {
 		this._univerInstanceService.focusUnit(this.id);
 		return this._commandService.syncExecuteCommand(_univerjs_core.RedoCommand.id);
 	}
+};
+FDocument = __decorate([
+	__decorateParam(1, (0, _univerjs_core.Inject)(_univerjs_core.Injector)),
+	__decorateParam(2, _univerjs_core.IUniverInstanceService),
+	__decorateParam(3, (0, _univerjs_core.Inject)(_univerjs_core.IResourceLoaderService)),
+	__decorateParam(4, _univerjs_core.ICommandService)
+], FDocument);
+
+//#endregion
+//#region src/facade/f-univer.ts
+var FUniverDocsMixin = class extends _univerjs_core_facade.FUniver {
+	createDocument(data) {
+		const document = this._injector.get(_univerjs_core.IUniverInstanceService).createUnit(_univerjs_core.UniverInstanceType.UNIVER_DOC, data);
+		return this._injector.createInstance(FDocument, document);
+	}
+	getActiveDocument() {
+		const document = this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_DOC);
+		if (!document) return null;
+		return this._injector.createInstance(FDocument, document);
+	}
+	getDocument(id) {
+		const document = this._univerInstanceService.getUnit(id, _univerjs_core.UniverInstanceType.UNIVER_DOC);
+		if (!document) return null;
+		return this._injector.createInstance(FDocument, document);
+	}
+};
+_univerjs_core_facade.FUniver.extend(FUniverDocsMixin);
+
+//#endregion
+//#region src/facade/f-document-block-range.ts
+/**
+* A facade wrapper for document block ranges, such as callout, quote, and code blocks.
+*
+* Block range identity is backed by the persisted `IDocumentBlockRange.blockId`,
+* so wrappers can be re-resolved after text is inserted before the block range.
+*
+* @hideconstructor
+*/
+var FDocumentBlockRange = class extends FDocumentElement {
+	constructor(body, bodyEdit, info, injector) {
+		super(body, bodyEdit, info, injector);
+		this.body = body;
+		this.bodyEdit = bodyEdit;
+		this.info = info;
+		this.injector = injector;
+		if (this.getType() !== _univerjs_core.DocumentBlockType.BLOCK_RANGE) throw new Error(`Element type is not a block range: ${this.getType()}`);
+	}
 	/**
-	* Adds the specified text to the end of this text region.
-	* @param {string} text - The text to be added to the end of this text region.
-	* @return {boolean} `true` if the text was successfully appended, or `false` if it failed.
+	* Get the top-level block range data model.
+	* @returns {IDocumentBlockRange} The block range data model.
 	* @example
-	* ```typescript
+	* ```ts
 	* const fDocument = univerAPI.getActiveDocument();
-	* const success = fDocument.appendText('Hello, world!');
-	* console.log(success);
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	*
+	* if (element?.isBlockRange()) {
+	*   const blockRange = element.asBlockRange();
+	*   console.log(blockRange.getBlockRange());
+	* }
 	* ```
 	*/
-	appendText(text) {
-		const { body } = this.save();
-		if (!body) throw new Error("The document body is empty");
-		const lastPosition = body.dataStream.length - 2;
-		return this.insertText(text, {
-			startOffset: lastPosition,
-			endOffset: lastPosition,
-			segmentId: ""
-		});
+	getBlockRange() {
+		const { blockRanges = [] } = this._body.getBody();
+		const blockRange = blockRanges.find((blockRange) => blockRange.blockId === this.getKey());
+		if (!blockRange) throw new Error(`Block range not found: ${this.getKey()}`);
+		return blockRange;
 	}
 	/**
-	* Inserts text at the provided document range. Defaults to appending before the final section break.
-	* @param {string} text - The text to insert.
-	* @param {IDocumentInsertTextFacadeOptions} options - Optional target range, segment id, and cursor offset.
-	* @returns {boolean} `true` if the text was successfully inserted, or `false` if it failed.
+	* Get the block range type.
+	* @returns {DocumentBlockRangeType} The block type, such as callout, quote, or code.
 	* @example
-	*
-	* // Insert text at a specific range in the document body
-	* ```typescript
+	* ```ts
 	* const fDocument = univerAPI.getActiveDocument();
-	* const success = fDocument.insertText('Hello, world!', {
-	*   startOffset: 5,
-	*   endOffset: 5,
-	*   segmentId: '',
-	*   cursorOffset: 13,
-	* });
-	* console.log(success);
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	*
+	* if (element?.isBlockRange()) {
+	*   const blockRange = element.asBlockRange();
+	*   console.log(blockRange.getBlockType());
+	* }
 	* ```
+	*/
+	getBlockType() {
+		return this.getBlockRange().blockType;
+	}
+	/**
+	* Get the plain text inside this block range.
+	* @returns {string} The block range text.
+	* @example
+	* ```ts
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* // Insert text at the beginning of a header or footer segment
-	* ```typescript
+	* if (element?.isBlockRange()) {
+	*   const blockRange = element.asBlockRange();
+	*   console.log(blockRange.getText());
+	* }
+	* ```
+	*/
+	getText() {
+		const { dataStream } = this._body.getBody();
+		const { startIndex, endIndex } = this.getBlockRange();
+		return dataStream.slice(startIndex, endIndex);
+	}
+	/**
+	* Replace the plain text inside this block range.
+	* @param {string} text The replacement text.
+	* @returns {boolean} `true` if the block range text was replaced.
+	* @example
+	* ```ts
 	* const fDocument = univerAPI.getActiveDocument();
-	* const snapshot = fDocument.save();
-	* const { headers, footers } = snapshot;
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
 	*
-	* if (headers) {
-	*   for (const headerId in headers) {
-	*     if (headerId === 'target-header-id') {
-	*       fDocument.insertText('Hello, header!', {
-	*         startOffset: 0,
-	*         endOffset: 0,
-	*         segmentId: headerId,
-	*       });
-	*     }
-	*   }
+	* if (element?.isBlockRange()) {
+	*   const blockRange = element.asBlockRange();
+	*   blockRange.setText('Updated block text');
+	*   console.log(blockRange.getText());
 	* }
+	* ```
+	*/
+	setText(text) {
+		const blockRange = this.getBlockRange();
+		const { startIndex, endIndex } = blockRange;
+		const updateBody = buildPlainTextInsertBody(`${text}\r`);
+		updateBody.blockRanges = [{
+			...blockRange,
+			startIndex: 0,
+			endIndex: text.length
+		}];
+		return this._bodyEdit.replaceRange({
+			startOffset: startIndex,
+			endOffset: endIndex + 1
+		}, updateBody);
+	}
+	/**
+	* Remove this block range wrapper from the body.
 	*
-	* if (footers) {
-	*   for (const footerId in footers) {
-	*     if (footerId === 'target-footer-id') {
-	*       fDocument.insertText('Hello, footer!', {
-	*         startOffset: 0,
-	*         endOffset: 0,
-	*         segmentId: footerId,
-	*       });
-	*     }
-	*   }
+	* This currently removes the block range and its content, matching
+	* `remove()`.
+	*
+	* @returns {boolean} `true` if the block range content was removed.
+	* @example
+	* ```ts
+	* const fDocument = univerAPI.getActiveDocument();
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	*
+	* if (element?.isBlockRange()) {
+	*   const blockRange = element.asBlockRange();
+	*   const removed = blockRange.unwrap();
+	*   console.log(removed ? 'Block range removed' : 'Failed to remove block range');
 	* }
 	* ```
 	*/
-	insertText(text, options = {}) {
-		var _options$startOffset, _options$endOffset, _options$segmentId;
-		const unitId = this.id;
-		const { body } = this.save();
-		if (!body) throw new Error("The document body is empty");
-		const startOffset = (_options$startOffset = options.startOffset) !== null && _options$startOffset !== void 0 ? _options$startOffset : Math.max(0, body.dataStream.length - 2);
-		const endOffset = (_options$endOffset = options.endOffset) !== null && _options$endOffset !== void 0 ? _options$endOffset : startOffset;
-		const segmentId = (_options$segmentId = options.segmentId) !== null && _options$segmentId !== void 0 ? _options$segmentId : "";
-		const activeRange = {
-			startOffset,
-			endOffset,
-			collapsed: startOffset === endOffset,
-			segmentId
-		};
-		const removeLeadingParagraphBreak = startOffset === 0;
-		const insertBody = buildPlainTextInsertBody(text, {
-			paragraphStyle: getParagraphStyleAtOffset(body, startOffset),
-			removeLeadingParagraphBreak
-		});
-		const cursorOffset = options.cursorOffset == null ? void 0 : getNormalizedPlainTextCursorOffset(text, options.cursorOffset, removeLeadingParagraphBreak);
-		return this._commandService.syncExecuteCommand(_univerjs_docs.InsertTextCommand.id, {
-			unitId,
-			body: insertBody,
-			range: activeRange,
-			segmentId,
-			...cursorOffset == null ? {} : { cursorOffset }
-		});
+	unwrap() {
+		return this.remove();
+	}
+};
+var FDocumentBlockRangeMixin = class extends FDocumentElement {
+	asBlockRange() {
+		if (this.getType() !== _univerjs_core.DocumentBlockType.BLOCK_RANGE) throw new Error(`Element type is not a block range: ${this.getType()}`);
+		return this._injector.createInstance(FDocumentBlockRange, this._body, this._bodyEdit, this.getResolvedInfo(), this._injector);
+	}
+};
+FDocumentElement.extend(FDocumentBlockRangeMixin);
+
+//#endregion
+//#region src/facade/f-document-custom-block.ts
+/**
+* A facade wrapper for document top-level custom blocks.
+* @hideconstructor
+*/
+var FDocumentCustomBlock = class extends FDocumentElement {
+	constructor(body, bodyEdit, info, injector) {
+		super(body, bodyEdit, info, injector);
+		this.body = body;
+		this.bodyEdit = bodyEdit;
+		this.info = info;
+		this.injector = injector;
+		if (this.getType() !== _univerjs_core.DocumentBlockType.CUSTOM_BLOCK) throw new Error(`Element type is not a custom block: ${this.getType()}`);
 	}
 	/**
-	* Inserts one or more plain-text paragraphs at the provided document range.
-	* @param {string} text - The paragraph text to insert. Newlines are normalized to document paragraph separators.
-	* @param {IDocumentInsertTextFacadeOptions} options - Optional target range, segment id, and cursor offset.
-	* @returns {boolean} `true` if the paragraphs were successfully inserted, or `false` if it failed.
+	* Get the custom block marker.
+	* @returns {ICustomBlock} The custom block marker.
 	* @example
-	* ```typescript
+	* ```ts
 	* const fDocument = univerAPI.getActiveDocument();
-	* const success = fDocument.insertParagraph('Hello, world! This is a new paragraph.', {
-	*   startOffset: 5,
-	*   endOffset: 5,
-	* });
-	* console.log(success);
+	* const fDocumentBody = fDocument.getBody();
+	* const element = fDocumentBody.getElement(0);
+	*
+	* if (element?.isCustomBlock()) {
+	*   const customBlock = element.asCustomBlock();
+	*   console.log(customBlock.getCustomBlock());
+	* }
 	* ```
 	*/
-	insertParagraph(text = "", options = {}) {
-		var _options$cursorOffset;
-		const dataStream = `${text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n").join("\r\n")}\r\n`;
-		return this.insertText(dataStream, {
-			...options,
-			cursorOffset: (_options$cursorOffset = options.cursorOffset) !== null && _options$cursorOffset !== void 0 ? _options$cursorOffset : dataStream.length
-		});
+	getCustomBlock() {
+		const { customBlocks = [] } = this._body.getBody();
+		const block = customBlocks.find((item) => item.blockId === this.getKey());
+		if (!block) throw new Error("Doc custom block is stale");
+		return block;
 	}
 };
-FDocument = __decorate([
-	__decorateParam(1, (0, _univerjs_core.Inject)(_univerjs_core.Injector)),
-	__decorateParam(2, _univerjs_core.IUniverInstanceService),
-	__decorateParam(3, (0, _univerjs_core.Inject)(_univerjs_core.IResourceLoaderService)),
-	__decorateParam(4, _univerjs_core.ICommandService)
-], FDocument);
+var FDocumentCustomBlockMixin = class extends FDocumentElement {
+	asCustomBlock() {
+		if (this.getType() !== _univerjs_core.DocumentBlockType.CUSTOM_BLOCK) throw new Error(`Element type is not a custom block: ${this.getType()}`);
+		return this._injector.createInstance(FDocumentCustomBlock, this._body, this._bodyEdit, this.getResolvedInfo(), this._injector);
+	}
+};
+FDocumentElement.extend(FDocumentCustomBlockMixin);
 
 //#endregion
-//#region src/facade/f-univer.ts
-var FUniverDocsMixin = class extends _univerjs_core_facade.FUniver {
-	createDocument(data) {
-		const document = this._injector.get(_univerjs_core.IUniverInstanceService).createUnit(_univerjs_core.UniverInstanceType.UNIVER_DOC, data);
-		return this._injector.createInstance(FDocument, document);
+//#region src/facade/f-document-table.ts
+/**
+* A facade wrapper for document top-level tables.
+* @hideconstructor
+*/
+var FDocumentTable = class extends FDocumentElement {
+	constructor(body, bodyEdit, info, injector) {
+		super(body, bodyEdit, info, injector);
+		this.body = body;
+		this.bodyEdit = bodyEdit;
+		this.info = info;
+		this.injector = injector;
+		if (this.getType() !== _univerjs_core.DocumentBlockType.TABLE) throw new Error(`Element type is not a table: ${this.getType()}`);
 	}
-	getActiveDocument() {
-		const document = this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_DOC);
-		if (!document) return null;
-		return this._injector.createInstance(FDocument, document);
+	/**
+	* 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() {
+		const { tables = [] } = this._body.getBody();
+		const table = tables.find((item) => item.tableId === this.getKey());
+		if (!table) throw new Error("Doc table is stale");
+		return table;
 	}
-	getDocument(id) {
-		const document = this._univerInstanceService.getUnit(id, _univerjs_core.UniverInstanceType.UNIVER_DOC);
-		if (!document) return null;
-		return this._injector.createInstance(FDocument, document);
+};
+var FDocumentTableMixin = class extends FDocumentElement {
+	asTable() {
+		if (this.getType() !== _univerjs_core.DocumentBlockType.TABLE) throw new Error(`Element type is not a table: ${this.getType()}`);
+		return this._injector.createInstance(FDocumentTable, this._body, this._bodyEdit, this.getResolvedInfo(), this._injector);
 	}
 };
-_univerjs_core_facade.FUniver.extend(FUniverDocsMixin);
+FDocumentElement.extend(FDocumentTableMixin);
 
 //#endregion
-exports.DocElementRegistry = DocElementRegistry;
-exports.DocElementStaleError = DocElementStaleError;
-exports.FDocBlockRange = FDocBlockRange;
-exports.FDocBody = FDocBody;
-exports.FDocCustomBlock = FDocCustomBlock;
-exports.FDocElement = FDocElement;
-exports.FDocParagraph = FDocParagraph;
-exports.FDocTable = FDocTable;
 Object.defineProperty(exports, 'FDocument', {
   enumerable: true,
   get: function () {
     return FDocument;
   }
-});
+});
+exports.FDocumentBlockRange = FDocumentBlockRange;
+exports.FDocumentBody = FDocumentBody;
+exports.FDocumentCustomBlock = FDocumentCustomBlock;
+exports.FDocumentElement = FDocumentElement;
+exports.FDocumentParagraph = FDocumentParagraph;
+exports.FDocumentTable = FDocumentTable;