@univerjs/docs 0.24.0 → 0.25.0-insiders.20260604-29ebbff

package/lib/facade.js

@@ -0,0 +1,299 @@
+import { ICommandService, IResourceLoaderService, IUniverInstanceService, Inject, Injector, RedoCommand, UndoCommand, UniverInstanceType } from "@univerjs/core";
+import { FBaseInitialable, FUniver } from "@univerjs/core/facade";
+import { InsertTextCommand } from "@univerjs/docs";
+
+//#region \0@oxc-project+runtime@0.133.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.133.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.133.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.133.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.133.0/helpers/esm/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/facade/f-document.ts
+let FDocument = class FDocument extends FBaseInitialable {
+	constructor(_documentDataModel, _injector, _univerInstanceService, _resourceLoaderService, _commandService) {
+		super(_injector);
+		this._documentDataModel = _documentDataModel;
+		this._injector = _injector;
+		this._univerInstanceService = _univerInstanceService;
+		this._resourceLoaderService = _resourceLoaderService;
+		this._commandService = _commandService;
+		_defineProperty(this, "id", void 0);
+		this.id = this._documentDataModel.getUnitId();
+	}
+	/**
+	* Get the document data model of the document.
+	* @returns {DocumentDataModel} The document data model.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* const documentDataModel = fDocument.getDocumentDataModel();
+	* console.log(documentDataModel);
+	* ```
+	*/
+	getDocumentDataModel() {
+		return this._documentDataModel;
+	}
+	dispose() {
+		super.dispose();
+	}
+	/**
+	* Get the document id.
+	* @returns {string} The document id.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* const unitId = fDocument.getId();
+	* console.log(unitId);
+	* ```
+	*/
+	getId() {
+		return this.id;
+	}
+	/**
+	* Get the document name.
+	* @returns {string} The document name.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* const name = fDocument.getName();
+	* console.log(name);
+	* ```
+	*/
+	getName() {
+		return this._documentDataModel.getTitle() || "";
+	}
+	/**
+	* Save the document snapshot data, including the document content and resource data, etc.
+	* @returns {IDocumentData} The document snapshot data.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* const snapshot = fDocument.save();
+	* console.log(snapshot);
+	* ```
+	*/
+	save() {
+		return this._resourceLoaderService.saveUnit(this._documentDataModel.getUnitId());
+	}
+	/**
+	* Undo the last operation in the document.
+	* @returns {Promise<boolean>} A promise that resolves to true if the undo operation was successful, or false if it failed.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* await fDocument.undo();
+	* ```
+	*/
+	undo() {
+		this._univerInstanceService.focusUnit(this.id);
+		return this._commandService.executeCommand(UndoCommand.id);
+	}
+	/**
+	* Redo the last undone operation in the document.
+	* @returns {Promise<boolean>} A promise that resolves to true if the redo operation was successful, or false if it failed.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* await fDocument.redo();
+	* ```
+	*/
+	redo() {
+		this._univerInstanceService.focusUnit(this.id);
+		return this._commandService.executeCommand(RedoCommand.id);
+	}
+	/**
+	* 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 {Promise<boolean>} A promise that resolves to true if the text was successfully appended, or false if it failed.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* await fDocument.appendText('Hello, world!');
+	* ```
+	*/
+	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: ""
+		});
+	}
+	/**
+	* 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 {Promise<boolean>} A promise that resolves to true if the text was successfully inserted, or false if it failed.
+	* @example
+	*
+	* // Insert text at a specific range in the document body
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* await fDocument.insertText('Hello, world!', {
+	*   startOffset: 5,
+	*   endOffset: 5,
+	*   segmentId: '',
+	*   cursorOffset: 13,
+	* });
+	* ```
+	*
+	* // Insert text at the beginning of a header or footer segment
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* const snapshot = fDocument.save();
+	* const { headers, footers } = snapshot;
+	*
+	* if (headers) {
+	*   for (const headerId in headers) {
+	*     if (headerId === 'target-header-id') {
+	*       await fDocument.insertText('Hello, header!', {
+	*         startOffset: 0,
+	*         endOffset: 0,
+	*         segmentId: headerId,
+	*       });
+	*     }
+	*   }
+	* }
+	*
+	* if (footers) {
+	*   for (const footerId in footers) {
+	*     if (footerId === 'target-footer-id') {
+	*       await fDocument.insertText('Hello, footer!', {
+	*         startOffset: 0,
+	*         endOffset: 0,
+	*         segmentId: footerId,
+	*       });
+	*     }
+	*   }
+	* }
+	* ```
+	*/
+	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
+		};
+		return this._commandService.executeCommand(InsertTextCommand.id, {
+			unitId,
+			body: { dataStream: text },
+			range: activeRange,
+			segmentId,
+			...options.cursorOffset == null ? {} : { cursorOffset: options.cursorOffset }
+		});
+	}
+	/**
+	* 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 {Promise<boolean>} A promise that resolves to true if the paragraphs were successfully inserted, or false if it failed.
+	* @example
+	* ```typescript
+	* const fDocument = univerAPI.getActiveDocument();
+	* await fDocument.insertParagraph('Hello, world! This is a new paragraph.', {
+	*   startOffset: 5,
+	*   endOffset: 5,
+	* });
+	* ```
+	*/
+	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
+		});
+	}
+};
+FDocument = __decorate([
+	__decorateParam(1, Inject(Injector)),
+	__decorateParam(2, IUniverInstanceService),
+	__decorateParam(3, Inject(IResourceLoaderService)),
+	__decorateParam(4, ICommandService)
+], FDocument);
+
+//#endregion
+//#region src/facade/f-univer.ts
+var FUniverDocsUIMixin = class extends FUniver {
+	createDocument(data) {
+		const document = this._injector.get(IUniverInstanceService).createUnit(UniverInstanceType.UNIVER_DOC, data);
+		return this._injector.createInstance(FDocument, document);
+	}
+	getActiveDocument() {
+		const document = this._univerInstanceService.getCurrentUnitOfType(UniverInstanceType.UNIVER_DOC);
+		if (!document) return null;
+		return this._injector.createInstance(FDocument, document);
+	}
+	getDocument(id) {
+		const document = this._univerInstanceService.getUnit(id, UniverInstanceType.UNIVER_DOC);
+		if (!document) return null;
+		return this._injector.createInstance(FDocument, document);
+	}
+};
+FUniver.extend(FUniverDocsUIMixin);
+
+//#endregion
+export { FDocument };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, Disposable, DisposableCollection, ICommandService, IConfigService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, Plugin, RxDisposable, UniverInstanceType, composeInterceptors, createInterceptorKey, isInternalEditorID, merge, remove, toDisposable } from "@univerjs/core";
+import { BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DeleteDirection, Disposable, DisposableCollection, ICommandService, IConfigService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, Plugin, RxDisposable, TextX, TextXActionType, UniverInstanceType, composeInterceptors, createInterceptorKey, getRichTextEditPath, isInternalEditorID, merge, remove, toDisposable } from "@univerjs/core";
 import { DocumentSkeleton, DocumentViewModel, IRenderManagerService, NORMAL_TEXT_SELECTION_PLUGIN_STYLE } from "@univerjs/engine-render";
 import { BehaviorSubject, Subject, takeUntil } from "rxjs";
 
@@ -12,7 +12,7 @@ const SetTextSelectionsOperation = {
 };
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/typeof.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -23,7 +23,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/toPrimitive.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -36,14 +36,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.133.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.129.0/helpers/defineProperty.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -54,7 +54,7 @@ function _defineProperty(e, r, t) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -62,7 +62,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -376,10 +376,162 @@ const RichTextEditingMutation = {
 	}
 };
 
+//#endregion
+//#region src/commands/commands/core-editing.command.ts
+/**
+* The command to insert text. The changed range could be non-collapsed, mainly use in line break and normal input.
+*/
+const InsertTextCommand = {
+	id: "doc.command.insert-text",
+	type: CommandType.COMMAND,
+	handler: async (accessor, params) => {
+		var _activeRange$segmentI;
+		const commandService = accessor.get(ICommandService);
+		const { range, segmentId, body, unitId, cursorOffset } = params;
+		const docSelectionManagerService = accessor.get(DocSelectionManagerService);
+		const docDataModel = accessor.get(IUniverInstanceService).getUnit(unitId, UniverInstanceType.UNIVER_DOC);
+		if (docDataModel == null) return false;
+		const activeRange = docSelectionManagerService.getActiveTextRange();
+		const originBody = docDataModel.getSelfOrHeaderFooterModel((_activeRange$segmentI = activeRange === null || activeRange === void 0 ? void 0 : activeRange.segmentId) !== null && _activeRange$segmentI !== void 0 ? _activeRange$segmentI : "").getBody();
+		if (originBody == null) return false;
+		const { startOffset, collapsed } = range;
+		const cursorMove = cursorOffset !== null && cursorOffset !== void 0 ? cursorOffset : body.dataStream.length;
+		const textRanges = [{
+			startOffset: startOffset + cursorMove,
+			endOffset: startOffset + cursorMove,
+			style: activeRange === null || activeRange === void 0 ? void 0 : activeRange.style,
+			collapsed
+		}];
+		const doMutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId,
+				actions: [],
+				textRanges,
+				debounce: true
+			}
+		};
+		const textX = new TextX();
+		const jsonX = JSONX.getInstance();
+		if (collapsed) {
+			if (startOffset > 0) textX.push({
+				t: TextXActionType.RETAIN,
+				len: startOffset
+			});
+			textX.push({
+				t: TextXActionType.INSERT,
+				body,
+				len: body.dataStream.length
+			});
+		} else {
+			const dos = BuildTextUtils.selection.delete([range], originBody, 0, body);
+			textX.push(...dos);
+		}
+		doMutation.params.textRanges = [{
+			startOffset: startOffset + cursorMove,
+			endOffset: startOffset + cursorMove,
+			collapsed
+		}];
+		const path = getRichTextEditPath(docDataModel, segmentId);
+		doMutation.params.actions = jsonX.editOp(textX.serialize(), path);
+		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
+		return Boolean(result);
+	}
+};
+/**
+* The command to delete text, mainly used in BACKSPACE and DELETE when collapsed is true. ONLY handle collapsed range!!!
+*/
+const DeleteTextCommand = {
+	id: "doc.command.delete-text",
+	type: CommandType.COMMAND,
+	handler: async (accessor, params) => {
+		var _body$customRanges;
+		const commandService = accessor.get(ICommandService);
+		const univerInstanceService = accessor.get(IUniverInstanceService);
+		const { range, segmentId, unitId, direction, len = 1 } = params;
+		const docDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
+		const body = docDataModel === null || docDataModel === void 0 ? void 0 : docDataModel.getSelfOrHeaderFooterModel(segmentId).getBody();
+		if (docDataModel == null || body == null) return false;
+		const { startOffset } = range;
+		let start = direction === DeleteDirection.LEFT ? startOffset - len : startOffset;
+		let end = direction === DeleteDirection.LEFT ? startOffset - 1 : startOffset + len - 1;
+		const customRange = (_body$customRanges = body.customRanges) === null || _body$customRanges === void 0 ? void 0 : _body$customRanges.find((customRange) => customRange.startIndex <= start && customRange.endIndex >= end);
+		if (customRange === null || customRange === void 0 ? void 0 : customRange.wholeEntity) {
+			start = customRange.startIndex;
+			end = Math.max(end, customRange.endIndex);
+		}
+		const doMutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId,
+				actions: [],
+				textRanges: [{
+					startOffset: start,
+					endOffset: start,
+					collapsed: true
+				}],
+				debounce: true
+			}
+		};
+		const textX = new TextX();
+		const jsonX = JSONX.getInstance();
+		textX.push({
+			t: TextXActionType.RETAIN,
+			len: start - 0
+		});
+		textX.push({
+			t: TextXActionType.DELETE,
+			len: end - start + 1
+		});
+		const path = getRichTextEditPath(docDataModel, segmentId);
+		doMutation.params.actions = jsonX.editOp(textX.serialize(), path);
+		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
+		return Boolean(result);
+	}
+};
+/**
+* The command to update text properties, mainly used in BACKSPACE.
+*/
+const UpdateTextCommand = {
+	id: "doc.command.update-text",
+	type: CommandType.COMMAND,
+	handler: async (accessor, params) => {
+		const { range, segmentId, updateBody, coverType, unitId, textRanges } = params;
+		const commandService = accessor.get(ICommandService);
+		const docDataModel = accessor.get(IUniverInstanceService).getCurrentUniverDocInstance();
+		if (docDataModel == null) return false;
+		const doMutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId,
+				actions: [],
+				textRanges
+			}
+		};
+		const textX = new TextX();
+		const jsonX = JSONX.getInstance();
+		const { startOffset, endOffset } = range;
+		textX.push({
+			t: TextXActionType.RETAIN,
+			len: startOffset
+		});
+		textX.push({
+			t: TextXActionType.RETAIN,
+			body: updateBody,
+			len: endOffset - startOffset,
+			coverType
+		});
+		const path = getRichTextEditPath(docDataModel, segmentId);
+		doMutation.params.actions = jsonX.editOp(textX.serialize(), path);
+		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
+		return Boolean(result);
+	}
+};
+
 //#endregion
 //#region package.json
 var name = "@univerjs/docs";
-var version = "0.24.0";
+var version = "0.25.0-insiders.20260604-29ebbff";
 
 //#endregion
 //#region src/commands/mutations/docs-rename.mutation.ts
@@ -468,6 +620,43 @@ DocCustomRangeController = __decorate([
 	__decorateParam(2, IUniverInstanceService)
 ], DocCustomRangeController);
 
+//#endregion
+//#region src/services/doc-content-insert.service.ts
+/**
+* Copyright 2023-present DreamNum Co., Ltd.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+var DocContentInsertService = class extends Disposable {
+	constructor(..._args) {
+		super(..._args);
+		_defineProperty(this, "_range", null);
+	}
+	setInsertRange(range) {
+		this._range = range;
+	}
+	consumeInsertRange(unitId) {
+		if (!this._range) return null;
+		if (unitId && this._range.unitId !== unitId) return null;
+		const range = this._range;
+		this._range = null;
+		return range;
+	}
+	clearInsertRange() {
+		this._range = null;
+	}
+};
+
 //#endregion
 //#region src/plugin.ts
 let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
@@ -485,6 +674,9 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 	}
 	_initializeCommands() {
 		[
+			InsertTextCommand,
+			DeleteTextCommand,
+			UpdateTextCommand,
 			RichTextEditingMutation,
 			DocsRenameMutation,
 			SetTextSelectionsOperation
@@ -496,6 +688,7 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 		[
 			[DocSelectionManagerService],
 			[DocStateEmitService],
+			[DocContentInsertService],
 			[DocCustomRangeController]
 		].forEach((d) => this._injector.add(d));
 	}
@@ -587,25 +780,6 @@ DocInterceptorService = __decorate([__decorateParam(1, Inject(DocSkeletonManager
 
 //#endregion
 //#region src/utils/custom-range-factory.ts
-/**
-* @deprecated This is a duplication from docs-ui to avoid making too much breaking changes.
-*/
-function getRichTextEditPath(docDataModel, segmentId = "") {
-	if (!segmentId) return ["body"];
-	const { headers, footers } = docDataModel.getSnapshot();
-	if (headers == null && footers == null) throw new Error("Document data model must have headers or footers when update by segment id");
-	if ((headers === null || headers === void 0 ? void 0 : headers[segmentId]) != null) return [
-		"headers",
-		segmentId,
-		"body"
-	];
-	else if ((footers === null || footers === void 0 ? void 0 : footers[segmentId]) != null) return [
-		"footers",
-		segmentId,
-		"body"
-	];
-	else throw new Error("Segment id not found in headers or footers");
-}
 function addCustomRangeFactory(accessor, param, body) {
 	const { unitId, segmentId } = param;
 	const documentDataModel = accessor.get(IUniverInstanceService).getUnit(unitId);
@@ -738,4 +912,4 @@ function replaceSelectionFactory(accessor, params) {
 }
 
 //#endregion
-export { DOC_INTERCEPTOR_POINT, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateEmitService, RichTextEditingMutation, SetTextSelectionsOperation, UniverDocsPlugin, addCustomRangeBySelectionFactory, addCustomRangeFactory, deleteCustomRangeFactory, replaceSelectionFactory };
+export { DOC_INTERCEPTOR_POINT, DeleteTextCommand, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateEmitService, InsertTextCommand, RichTextEditingMutation, SetTextSelectionsOperation, UniverDocsPlugin, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, deleteCustomRangeFactory, replaceSelectionFactory };

package/lib/types/commands/commands/core-editing.command.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ICommand, IDocumentBody, IDocumentData, ITextRange, UpdateDocsAttributeType } from '@univerjs/core';
+import type { ITextRangeWithStyle } from '@univerjs/engine-render';
+import { DeleteDirection } from '@univerjs/core';
+export interface IInsertTextCommandParams {
+    unitId: string;
+    body: IDocumentBody;
+    range: ITextRange;
+    segmentId?: string;
+    cursorOffset?: number;
+}
+/**
+ * The command to insert text. The changed range could be non-collapsed, mainly use in line break and normal input.
+ */
+export declare const InsertTextCommand: ICommand<IInsertTextCommandParams>;
+export interface IDeleteTextCommandParams {
+    unitId: string;
+    range: ITextRange;
+    direction: DeleteDirection;
+    len?: number;
+    segmentId?: string;
+}
+/**
+ * The command to delete text, mainly used in BACKSPACE and DELETE when collapsed is true. ONLY handle collapsed range!!!
+ */
+export declare const DeleteTextCommand: ICommand<IDeleteTextCommandParams>;
+export interface IUpdateTextCommandParams {
+    unitId: string;
+    updateBody: IDocumentBody;
+    range: ITextRange;
+    coverType: UpdateDocsAttributeType;
+    textRanges: ITextRangeWithStyle[];
+    segmentId?: string;
+}
+/**
+ * The command to update text properties, mainly used in BACKSPACE.
+ */
+export declare const UpdateTextCommand: ICommand<IUpdateTextCommandParams>;
+export interface ICoverCommandParams {
+    unitId: string;
+    snapshot?: IDocumentData;
+    clearUndoRedoStack?: boolean;
+}