@univerjs/docs-ui 0.23.0 → 0.24.0-insiders.20260528-29f582d

package/lib/cjs/facade.js

@@ -100,22 +100,53 @@ let FDocument = class FDocument {
 	* @param text - The text to be added to the end of this text region.
 	*/
 	appendText(text) {
-		const unitId = this.id;
 		const { body } = this.getSnapshot();
 		if (!body) throw new Error("The document body is empty");
 		const lastPosition = body.dataStream.length - 2;
-		const activeRange = {
+		return this.insertText(text, {
 			startOffset: lastPosition,
 			endOffset: lastPosition,
-			collapsed: true,
 			segmentId: ""
+		});
+	}
+	/**
+	* Inserts text at the provided document range. Defaults to appending before the final section break.
+	* @param text - The text to insert.
+	* @param options - Optional target range, segment id, and cursor offset.
+	*/
+	insertText(text, options = {}) {
+		var _options$startOffset, _options$endOffset, _options$segmentId;
+		const unitId = this.id;
+		const { body } = this.getSnapshot();
+		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 { segmentId } = activeRange;
 		return this._commandService.executeCommand(_univerjs_docs_ui.InsertCommand.id, {
 			unitId,
 			body: { dataStream: text },
 			range: activeRange,
-			segmentId
+			segmentId,
+			...options.cursorOffset == null ? {} : { cursorOffset: options.cursorOffset }
+		});
+	}
+	/**
+	* Inserts one or more plain-text paragraphs at the provided document range.
+	* @param text - Paragraph text. Newlines are normalized to document paragraph separators.
+	* @param options - Optional target range, segment id, and cursor offset.
+	*/
+	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
 		});
 	}
 	/**
@@ -154,7 +185,7 @@ var FUniverDocsUIMixin = class extends _univerjs_core_facade.FUniver {
 		return this._injector.createInstance(FDocument, document);
 	}
 	getActiveDocument() {
-		const document = this._univerInstanceService.getCurrentUnitForType(_univerjs_core.UniverInstanceType.UNIVER_DOC);
+		const document = this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_DOC);
 		if (!document) return null;
 		return this._injector.createInstance(FDocument, document);
 	}