@univerjs/docs 1.0.0-beta.0 → 1.0.0-beta.2

package/lib/facade.js

@@ -1,6 +1,6 @@
 import { BooleanNumber, ColumnSeparatorType, DashStyleType, DataStreamTreeTokenType, DocumentFlavor, ICommandService, IResourceLoaderService, IUniverInstanceService, Inject, Injector, JSONX, PageOrientType, PresetListType, RESTORE_INSERTED_PARAGRAPH_IDS, RedoCommand, SectionType, TextX, TextXActionType, Tools, UndoCommand, UniverInstanceType, UpdateDocsAttributeType, createParagraphId, createSectionId, generateRandomId, getParagraphContentStartOffset, getRichTextEditPath, getSectionHeaderFooterReferenceKey, regexp, resolveSectionHeaderFooterReference } from "@univerjs/core";
 import { FBaseInitialable, FEnum, FUniver } from "@univerjs/core/facade";
-import { CreateHeaderFooterCommand, DeleteDocumentSectionBreakCommand, HeaderFooterType, InsertDocumentColumnBreakCommand, InsertDocumentSectionBreakCommand, RichTextEditingMutation, SetSectionHeaderFooterLinkCommand, UpdateDocumentParagraphStyleCommand, UpdateDocumentSectionCommand, createSectionColumnProperties, generateParagraphs, getEffectiveSectionPageSetup, getSectionContentWidth, getTopLevelSectionBreaks } from "@univerjs/docs";
+import { CreateHeaderFooterCommand, DeleteDocumentSectionBreakCommand, HeaderFooterType, InsertDocumentColumnBreakCommand, InsertDocumentSectionBreakCommand, InsertTextCommand, RichTextEditingMutation, SetDocumentNameCommand, SetSectionHeaderFooterLinkCommand, UpdateDocumentParagraphStyleCommand, UpdateDocumentSectionCommand, createSectionColumnProperties, generateParagraphs, getEffectiveSectionPageSetup, getSectionContentWidth, getTopLevelSectionBreaks } from "@univerjs/docs";
 
 //#region src/facade/utils.ts
 function cloneParagraphStyle(paragraphStyle) {
@@ -32,31 +32,24 @@ function buildPlainTextInsertBody(dataStream, options = {}) {
 	if (paragraphs.length > 0) body.paragraphs = paragraphs;
 	return body;
 }
-function replaceBodyRange(range, insertBody, docDataModel, injector) {
+function replaceBodyRange(range, insertBody, docDataModel, commandService) {
 	const { startOffset, endOffset, segmentId } = range;
-	const textX = new TextX();
-	if (startOffset > 0) textX.push({
-		t: TextXActionType.RETAIN,
-		len: startOffset
-	});
-	if (endOffset > startOffset) textX.push({
-		t: TextXActionType.DELETE,
-		len: endOffset - startOffset
-	});
-	if (insertBody.dataStream.length > 0) textX.push({
-		t: TextXActionType.INSERT,
-		body: insertBody,
-		len: insertBody.dataStream.length
-	});
-	const actions = JSONX.getInstance().editOp(textX.serialize(), getRichTextEditPath(docDataModel, segmentId));
-	const result = injector.get(ICommandService).syncExecuteCommand(RichTextEditingMutation.id, {
+	const result = commandService.syncExecuteCommand(InsertTextCommand.id, {
 		unitId: docDataModel.getUnitId(),
+		body: insertBody,
+		range: {
+			startOffset,
+			endOffset,
+			collapsed: startOffset === endOffset,
+			segmentId
+		},
 		segmentId,
-		actions,
+		debounce: false,
 		textRanges: [],
+		noNeedSetTextRange: true,
 		isEditing: false
 	});
-	return Boolean((result === null || result === void 0 ? void 0 : result.actions) && result.actions.length > 0);
+	return Boolean(result);
 }
 function retainBodyRange(range, updateBody, coverType, docDataModel, injector) {
 	var _updateBody$textRuns, _docDataModel$getSelf;
@@ -97,23 +90,34 @@ function stripBlockTokens(text) {
 	return Array.from(text).map((char) => char === DataStreamTreeTokenType.PARAGRAPH ? "\n" : char).filter((char) => char !== DataStreamTreeTokenType.BLOCK_START && char !== DataStreamTreeTokenType.BLOCK_END && char !== DataStreamTreeTokenType.SECTION_BREAK).join("").replace(/\n$/, "");
 }
 
+//#endregion
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.140.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-text-range.ts
-/**
-* Facade wrapper for reading and styling a fixed document text range.
-*
-* Offsets are fixed when the wrapper is created. Create a new range after edits
-* that insert or remove content before it.
-* @hideconstructor
-*/
-var FDocumentTextRange = class extends FBaseInitialable {
-	constructor(_document, _startOffset, _endOffset, _segmentId, _injector) {
+let FDocumentTextRange = class FDocumentTextRange extends FBaseInitialable {
+	constructor(_document, _startOffset, _endOffset, _segmentId, _injector, _commandService) {
 		super(_injector);
 		this._document = _document;
 		this._startOffset = _startOffset;
 		this._endOffset = _endOffset;
 		this._segmentId = _segmentId;
 		this._injector = _injector;
+		this._commandService = _commandService;
 		this._validateRange();
 	}
 	/**
@@ -232,7 +236,7 @@ var FDocumentTextRange = class extends FBaseInitialable {
 	* ```
 	*/
 	setText(text) {
-		return replaceBodyRange(this.getRange(), buildPlainTextInsertBody(text), this._document.getDocumentDataModel(), this._injector);
+		return replaceBodyRange(this.getRange(), buildPlainTextInsertBody(text), this._document.getDocumentDataModel(), this._commandService);
 	}
 	_validateRange() {
 		const bodyLength = this._document.getBody(this._segmentId).dataStream.length;
@@ -259,27 +263,11 @@ var FDocumentTextRange = class extends FBaseInitialable {
 		return segments;
 	}
 };
+FDocumentTextRange = __decorate([__decorateParam(5, ICommandService)], FDocumentTextRange);
 function isDeepEqual(left, right) {
 	return JSON.stringify(left) === JSON.stringify(right);
 }
 
-//#endregion
-//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.140.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-paragraph.ts
 let FDocumentParagraph = class FDocumentParagraph extends FBaseInitialable {
@@ -477,7 +465,7 @@ let FDocumentParagraph = class FDocumentParagraph extends FBaseInitialable {
 			startOffset,
 			endOffset,
 			segmentId: this._segmentId
-		}, buildPlainTextInsertBody(text), this._document.getDocumentDataModel(), this._injector);
+		}, buildPlainTextInsertBody(text), this._document.getDocumentDataModel(), this._commandService);
 	}
 	/**
 	* Append plain text before this paragraph's trailing paragraph break.
@@ -1335,6 +1323,24 @@ let FDocument = class FDocument extends FBaseInitialable {
 		return this._documentDataModel.getTitle() || "";
 	}
 	/**
+	* Set the document name.
+	* @param {string} name The new document name.
+	* @returns {FDocument} The current document for chaining.
+	*
+	* @example
+	* ```ts
+	* const document = univerAPI.getActiveDocument();
+	* document?.setName('Quarterly Report');
+	* ```
+	*/
+	setName(name) {
+		this._commandService.syncExecuteCommand(SetDocumentNameCommand.id, {
+			unitId: this.id,
+			name
+		});
+		return this;
+	}
+	/**
 	* Returns the document's explicit layout flavor.
 	*
 	* Use this method when all three states matter. Do not infer a Traditional
@@ -1491,7 +1497,7 @@ let FDocument = class FDocument extends FBaseInitialable {
 			startOffset: index,
 			endOffset: index,
 			segmentId
-		}, buildPlainTextInsertBody(text), this._documentDataModel, this._injector);
+		}, buildPlainTextInsertBody(text), this._documentDataModel, this._commandService);
 	}
 	/**
 	* Returns document-level header/footer switches and margins. Margin values use 96-DPI layout pixels.
@@ -1712,7 +1718,7 @@ let FDocument = class FDocument extends FBaseInitialable {
 		}, {
 			dataStream: DataStreamTreeTokenType.PARAGRAPH,
 			paragraphs
-		}, this._documentDataModel, this._injector) ? this.getParagraph(paragraphId, segmentId) : null;
+		}, this._documentDataModel, this._commandService) ? this.getParagraph(paragraphId, segmentId) : null;
 	}
 	/**
 	* Get all paragraphs in the document body or header/footer body by the segment id.
@@ -1825,7 +1831,7 @@ let FDocument = class FDocument extends FBaseInitialable {
 			startOffset: offset,
 			endOffset: offset,
 			segmentId
-		}, buildPlainTextInsertBody(`${text}\r`), this._documentDataModel, this._injector)) throw new Error("Failed to insert paragraph.");
+		}, buildPlainTextInsertBody(`${text}\r`), this._documentDataModel, this._commandService)) throw new Error("Failed to insert paragraph.");
 		const { paragraphs = [] } = this.getBody(segmentId);
 		const paragraph = paragraphs[index];
 		if (!paragraph) throw new Error("Failed to insert paragraph.");
@@ -1867,7 +1873,7 @@ let FDocument = class FDocument extends FBaseInitialable {
 	deleteRange(range) {
 		const normalizedRange = this._normalizeDeleteRange(range);
 		if (normalizedRange.startOffset >= normalizedRange.endOffset) return false;
-		return replaceBodyRange(normalizedRange, { dataStream: "" }, this._documentDataModel, this._injector);
+		return replaceBodyRange(normalizedRange, { dataStream: "" }, this._documentDataModel, this._commandService);
 	}
 	_createFDocumentParagraph(paragraphId, segmentId = "") {
 		return this._injector.createInstance(FDocumentParagraph, this, paragraphId, segmentId, this._injector);

package/lib/index.js

@@ -348,6 +348,7 @@ const RichTextEditingMutation = {
 		if (documentDataModel == null) throw new Error(`DocumentDataModel not found for unitId: ${unitId}`);
 		const docSelectionManagerService = accessor.get(DocSelectionManagerService);
 		const docRanges = docSelectionManagerService.getDocRanges() ?? [];
+		const selectionInfo = docSelectionManagerService.getSelectionInfo();
 		const disabled = !!documentDataModel.getSnapshot().disabled;
 		if (JSONX.isNoop(actions) || actions && actions.length === 0 || disabled) return {
 			unitId,
@@ -378,11 +379,15 @@ const RichTextEditingMutation = {
 			debounce,
 			redoState: {
 				actions,
-				textRanges
+				textRanges,
+				options: params.options,
+				isEditing
 			},
 			undoState: {
 				actions: undoActions,
-				textRanges: prevTextRanges ?? docRanges
+				textRanges: prevTextRanges ?? docRanges,
+				options: selectionInfo === null || selectionInfo === void 0 ? void 0 : selectionInfo.options,
+				isEditing: selectionInfo === null || selectionInfo === void 0 ? void 0 : selectionInfo.isEditing
 			},
 			isCompositionEnd,
 			isSync,
@@ -408,59 +413,63 @@ const InsertTextCommand = {
 	handler: (accessor, params) => {
 		var _docDataModel$getSelf;
 		const commandService = accessor.get(ICommandService);
-		const { range, segmentId, body, unitId, cursorOffset } = params;
+		const { range, segmentId, body, unitId, cursorOffset, debounce = true, textRanges, noNeedSetTextRange, isEditing } = 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 rangeSegmentId = "segmentId" in range ? range.segmentId : void 0;
+		const rangeSegmentId = "segmentId" in range && typeof range.segmentId === "string" ? range.segmentId : void 0;
 		const targetSegmentId = segmentId ?? rangeSegmentId ?? (activeRange === null || activeRange === void 0 ? void 0 : activeRange.segmentId) ?? "";
 		const originBody = (_docDataModel$getSelf = docDataModel.getSelfOrHeaderFooterModel(targetSegmentId)) === null || _docDataModel$getSelf === void 0 ? void 0 : _docDataModel$getSelf.getBody();
 		if (originBody == null) return false;
 		const { startOffset, collapsed } = range;
 		const cursorMove = cursorOffset ?? body.dataStream.length;
-		const textRanges = [{
+		const mutationTextRanges = 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,
+				segmentId: targetSegmentId,
 				actions: [],
-				textRanges,
-				debounce: true
+				textRanges: mutationTextRanges,
+				debounce,
+				noNeedSetTextRange,
+				isEditing
 			}
 		};
-		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);
+		doMutation.params.actions = buildInsertTextActions(docDataModel, originBody, range, body, targetSegmentId);
 		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
 		return Boolean(result);
 	}
 };
+function buildInsertTextActions(documentDataModel, originBody, range, insertBody, segmentId) {
+	const { startOffset, endOffset, collapsed } = range;
+	const textX = new TextX();
+	if (collapsed) {
+		if (startOffset > 0) textX.push({
+			t: TextXActionType.RETAIN,
+			len: startOffset
+		});
+		textX.push({
+			t: TextXActionType.INSERT,
+			body: insertBody,
+			len: insertBody.dataStream.length
+		});
+	} else textX.push(...BuildTextUtils.selection.delete([range], originBody, 0, insertBody));
+	const textActions = JSONX.getInstance().editOp(textX.serialize(), getRichTextEditPath(documentDataModel, segmentId));
+	return collapsed ? textActions : appendRemovedDrawingActions(textActions, documentDataModel, originBody, startOffset, endOffset);
+}
+function appendRemovedDrawingActions(textActions, documentDataModel, body, startOffset, endOffset) {
+	return [textActions, ...BuildTextUtils.drawing.remove(documentDataModel.getSnapshot(), [{
+		startOffset,
+		endOffset,
+		collapsed: false
+	}], body)].reduce((accumulator, action) => JSONX.compose(accumulator, action));
+}
 /**
 * The command to delete text, mainly used in BACKSPACE and DELETE when collapsed is true. ONLY handle collapsed range!!!
 */
@@ -487,6 +496,7 @@ const DeleteTextCommand = {
 			id: RichTextEditingMutation.id,
 			params: {
 				unitId,
+				segmentId,
 				actions: [],
 				textRanges: [{
 					startOffset: start,
@@ -505,7 +515,7 @@ const DeleteTextCommand = {
 			collapsed: false
 		}], body));
 		const path = getRichTextEditPath(docDataModel, segmentId);
-		doMutation.params.actions = jsonX.editOp(textX.serialize(), path);
+		doMutation.params.actions = appendRemovedDrawingActions(jsonX.editOp(textX.serialize(), path), docDataModel, body, start, end + 1);
 		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
 		return Boolean(result);
 	}
@@ -737,6 +747,53 @@ const SetDocumentDefaultParagraphStyleCommand = {
 	}
 };
 
+//#endregion
+//#region src/commands/mutations/docs-rename.mutation.ts
+const DocsRenameMutation = {
+	id: "doc.mutation.rename-doc",
+	type: CommandType.MUTATION,
+	handler: (accessor, params) => {
+		const doc = accessor.get(IUniverInstanceService).getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
+		if (!doc) return false;
+		doc.setName(params.name);
+		return true;
+	}
+};
+
+//#endregion
+//#region src/commands/commands/set-document-name.command.ts
+const SetDocumentNameCommand = {
+	id: "doc.command.set-name",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		if (!params) return false;
+		const document = accessor.get(IUniverInstanceService).getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
+		if (!document) return false;
+		const commandService = accessor.get(ICommandService);
+		const redoParams = {
+			unitId: params.unitId,
+			name: params.name
+		};
+		const undoParams = {
+			unitId: params.unitId,
+			name: document.getTitle() || ""
+		};
+		if (!commandService.syncExecuteCommand(DocsRenameMutation.id, redoParams)) return false;
+		accessor.get(IUndoRedoService).pushUndoRedo({
+			unitID: params.unitId,
+			redoMutations: [{
+				id: DocsRenameMutation.id,
+				params: redoParams
+			}],
+			undoMutations: [{
+				id: DocsRenameMutation.id,
+				params: undoParams
+			}]
+		});
+		return true;
+	}
+};
+
 //#endregion
 //#region src/utils/sections.ts
 /** Returns document-level section breaks, excluding table-cell and modern-column sentinels. */
@@ -1146,7 +1203,7 @@ const InsertDocumentColumnBreakCommand = {
 				rangeId: `docx-break-${generateRandomId()}`,
 				rangeType: CustomRangeType.CUSTOM,
 				wholeEntity: true,
-				properties: { docxBreakType: DocxBreakType.COLUMN }
+				properties: { breakType: DocxBreakType.COLUMN }
 			}]
 		});
 		return executeSectionTextX(context.commandService, context.documentDataModel, textX, InsertDocumentColumnBreakCommand.id);
@@ -1386,20 +1443,7 @@ function composeActions(actions) {
 //#endregion
 //#region package.json
 var name = "@univerjs/docs";
-var version = "1.0.0-beta.0";
-
-//#endregion
-//#region src/commands/mutations/docs-rename.mutation.ts
-const DocsRenameMutation = {
-	id: "doc.mutation.rename-doc",
-	type: CommandType.MUTATION,
-	handler: (accessor, params) => {
-		const doc = accessor.get(IUniverInstanceService).getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
-		if (!doc) return false;
-		doc.setName(params.name);
-		return true;
-	}
-};
+var version = "1.0.0-beta.2";
 
 //#endregion
 //#region src/config/config.ts
@@ -1570,6 +1614,9 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 		this._historyStateCache.set(unitId, cache.history);
 		this._changeStateCache.set(unitId, cache.collaboration);
 	}
+	clearHistory(unitId) {
+		this._historyStateCache.delete(unitId);
+	}
 	_setChangeState(changeState) {
 		this._cacheChangeState(changeState, "history");
 		this._cacheChangeState(changeState, "collaboration");
@@ -1602,6 +1649,8 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 		if (type === "history" && (trigger === RedoCommandId || trigger === UndoCommandId)) return;
 		const stateCache = type === "history" ? this._historyStateCache : this._changeStateCache;
 		const cb = type === "history" ? this._pushHistory.bind(this) : this._emitChangeState.bind(this);
+		const pendingStates = stateCache.get(unitId);
+		if ((pendingStates === null || pendingStates === void 0 ? void 0 : pendingStates.length) && pendingStates[pendingStates.length - 1].segmentId !== changeState.segmentId) cb(unitId);
 		if (stateCache.has(unitId)) {
 			const cacheStates = stateCache.get(unitId);
 			cacheStates === null || cacheStates === void 0 || cacheStates.push(changeState);
@@ -1630,12 +1679,18 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 		const redoParams = {
 			unitId,
 			actions: cacheStates.reduce((acc, cur) => JSONX.compose(acc, cur.redoState.actions), null),
-			textRanges: lastState.redoState.textRanges
+			textRanges: lastState.redoState.textRanges,
+			segmentId: lastState.segmentId,
+			options: lastState.redoState.options,
+			isEditing: lastState.redoState.isEditing
 		};
 		const undoParams = {
 			unitId,
 			actions: cacheStates.reverse().reduce((acc, cur) => JSONX.compose(acc, cur.undoState.actions), null),
-			textRanges: firstState.undoState.textRanges
+			textRanges: firstState.undoState.textRanges,
+			segmentId: firstState.segmentId,
+			options: firstState.undoState.options,
+			isEditing: firstState.undoState.isEditing
 		};
 		undoRedoService.pushUndoRedo({
 			unitID: unitId,
@@ -1664,12 +1719,18 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 			redoState: {
 				unitId,
 				actions: cacheStates.reduce((acc, cur) => JSONX.compose(acc, cur.redoState.actions), null),
-				textRanges: lastState.redoState.textRanges
+				textRanges: lastState.redoState.textRanges,
+				segmentId: lastState.segmentId,
+				options: lastState.redoState.options,
+				isEditing: lastState.redoState.isEditing
 			},
 			undoState: {
 				unitId,
 				actions: cacheStates.reverse().reduce((acc, cur) => JSONX.compose(acc, cur.undoState.actions), null),
-				textRanges: firstState.undoState.textRanges
+				textRanges: firstState.undoState.textRanges,
+				segmentId: firstState.segmentId,
+				options: firstState.undoState.options,
+				isEditing: firstState.undoState.isEditing
 			},
 			segmentId,
 			noHistory,
@@ -1782,6 +1843,7 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			UpdateTextCommand,
 			CreateHeaderFooterCommand,
 			SetDocumentDefaultParagraphStyleCommand,
+			SetDocumentNameCommand,
 			SetSectionHeaderFooterLinkCommand,
 			UpdateDocumentParagraphStyleCommand,
 			UpdateDocumentSectionCommand,
@@ -2133,4 +2195,4 @@ function normalizeTextRange(textRange) {
 }
 
 //#endregion
-export { CreateHeaderFooterCommand, DOC_INTERCEPTOR_POINT, DOC_SELECTION_OPTION_PRESERVE_CARET, DeleteDocumentSectionBreakCommand, DeleteTextCommand, DocBlockMoveValidatorService, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateChangeManagerService, DocStateEmitService, DocTextResolverService, EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY, HeaderFooterType, IDocStateChangeInterceptorService, InsertDocumentColumnBreakCommand, InsertDocumentSectionBreakCommand, InsertTextCommand, RichTextEditingMutation, SetDocumentDefaultParagraphStyleCommand, SetSectionHeaderFooterLinkCommand, SetTextSelectionsOperation, UniverDocsPlugin, UpdateDocumentParagraphStyleCommand, UpdateDocumentSectionCommand, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, buildDocTransform, consumeContentInsertRange, createDocsCustomBlockDrawing, createDocsCustomBlockInsertMutation, createDocsCustomBlockRemoveMutation, createEmbedDocsCustomBlockData, createInsertCustomBlockActions, createRemoveCustomBlockActions, createSectionColumnProperties, deleteCustomRangeFactory, docDrawingPositionToTransform, generateParagraphs, getContentInsertRange, getEffectiveSectionPageSetup, getSectionContentWidth, getTopLevelSectionBreaks, isEmbedDocsCustomBlockData, isHeaderFooterSelection, isSheetLikeDocsCustomBlockChildType, normalizeTextRange, replaceSelectionFactory, resolveDocsCustomBlockSize, shouldUseInlineTextSelectionForDocsCustomBlockDrawing, transformToDocDrawingPosition };
+export { CreateHeaderFooterCommand, DOC_INTERCEPTOR_POINT, DOC_SELECTION_OPTION_PRESERVE_CARET, DeleteDocumentSectionBreakCommand, DeleteTextCommand, DocBlockMoveValidatorService, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateChangeManagerService, DocStateEmitService, DocTextResolverService, EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY, HeaderFooterType, IDocStateChangeInterceptorService, InsertDocumentColumnBreakCommand, InsertDocumentSectionBreakCommand, InsertTextCommand, RichTextEditingMutation, SetDocumentDefaultParagraphStyleCommand, SetDocumentNameCommand, SetSectionHeaderFooterLinkCommand, SetTextSelectionsOperation, UniverDocsPlugin, UpdateDocumentParagraphStyleCommand, UpdateDocumentSectionCommand, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, buildDocTransform, consumeContentInsertRange, createDocsCustomBlockDrawing, createDocsCustomBlockInsertMutation, createDocsCustomBlockRemoveMutation, createEmbedDocsCustomBlockData, createInsertCustomBlockActions, createRemoveCustomBlockActions, createSectionColumnProperties, deleteCustomRangeFactory, docDrawingPositionToTransform, generateParagraphs, getContentInsertRange, getEffectiveSectionPageSetup, getSectionContentWidth, getTopLevelSectionBreaks, isEmbedDocsCustomBlockData, isHeaderFooterSelection, isSheetLikeDocsCustomBlockChildType, normalizeTextRange, replaceSelectionFactory, resolveDocsCustomBlockSize, shouldUseInlineTextSelectionForDocsCustomBlockDrawing, transformToDocDrawingPosition };

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

@@ -13,7 +13,7 @@
  * 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 { ICommand, IDocumentBody, IDocumentData, ITextRange, Nullable, UpdateDocsAttributeType } from '@univerjs/core';
 import type { ITextRangeWithStyle } from '@univerjs/engine-render';
 import { DeleteDirection } from '@univerjs/core';
 export interface IInsertTextCommandParams {
@@ -22,6 +22,10 @@ export interface IInsertTextCommandParams {
     range: ITextRange;
     segmentId?: string;
     cursorOffset?: number;
+    debounce?: boolean;
+    textRanges?: Nullable<ITextRangeWithStyle[]>;
+    noNeedSetTextRange?: boolean;
+    isEditing?: boolean;
 }
 /**
  * The command to insert text. The changed range could be non-collapsed, mainly use in line break and normal input.

package/lib/types/commands/commands/set-document-name.command.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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 } from '@univerjs/core';
+export interface ISetDocumentNameCommandParams {
+    unitId: string;
+    name: string;
+}
+export declare const SetDocumentNameCommand: ICommand<ISetDocumentNameCommandParams>;

package/lib/types/commands/mutations/docs-rename.mutation.d.ts

@@ -13,9 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { ICommand } from '@univerjs/core';
+import type { IMutation } from '@univerjs/core';
 export interface IDocsRenameMutationParams {
     name: string;
     unitId: string;
 }
-export declare const DocsRenameMutation: ICommand;
+export declare const DocsRenameMutation: IMutation<IDocsRenameMutationParams>;

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

@@ -16,6 +16,7 @@
 import type { Injector, ITextStyle } from '@univerjs/core';
 import type { FDocument } from './f-document';
 import type { IFDocumentTextRange } from './utils';
+import { ICommandService } from '@univerjs/core';
 import { FBaseInitialable } from '@univerjs/core/facade';
 /** A clipped text-style run in document offsets. */
 export interface IFDocumentTextStyleRun {
@@ -48,7 +49,8 @@ export declare class FDocumentTextRange extends FBaseInitialable {
     protected readonly _endOffset: number;
     protected readonly _segmentId: string;
     protected readonly _injector: Injector;
-    constructor(_document: FDocument, _startOffset: number, _endOffset: number, _segmentId: string, _injector: Injector);
+    private readonly _commandService;
+    constructor(_document: FDocument, _startOffset: number, _endOffset: number, _segmentId: string, _injector: Injector, _commandService: ICommandService);
     /**
      * Returns the serializable document range.
      * @example

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

@@ -132,6 +132,18 @@ export declare class FDocument extends FBaseInitialable {
      * ```
      */
     getName(): string;
+    /**
+     * Set the document name.
+     * @param {string} name The new document name.
+     * @returns {FDocument} The current document for chaining.
+     *
+     * @example
+     * ```ts
+     * const document = univerAPI.getActiveDocument();
+     * document?.setName('Quarterly Report');
+     * ```
+     */
+    setName(name: string): this;
     /**
      * Returns the document's explicit layout flavor.
      *

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

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import type { DocumentDataModel, IDocumentBody, Injector, IParagraphStyle, UpdateDocsAttributeType } from '@univerjs/core';
+import { ICommandService } from '@univerjs/core';
 export interface IBuildPlainTextInsertBodyOptions {
     paragraphStyle?: IParagraphStyle;
     removeLeadingParagraphBreak?: boolean;
@@ -33,6 +34,6 @@ export declare function getRemovedLeadingParagraphBreakLength(dataStream: string
 export declare function getNormalizedPlainTextCursorOffset(dataStream: string, cursorOffset: number, removeLeadingParagraphBreak?: boolean): number;
 export declare function getParagraphStyleAtOffset(body: IDocumentBody, offset: number): IParagraphStyle | undefined;
 export declare function buildPlainTextInsertBody(dataStream: string, options?: IBuildPlainTextInsertBodyOptions): IDocumentBody;
-export declare function replaceBodyRange(range: IFDocumentTextRange, insertBody: IDocumentBody, docDataModel: DocumentDataModel, injector: Injector): boolean;
+export declare function replaceBodyRange(range: IFDocumentTextRange, insertBody: IDocumentBody, docDataModel: DocumentDataModel, commandService: ICommandService): boolean;
 export declare function retainBodyRange(range: IFDocumentTextRange, updateBody: IDocumentBody, coverType: UpdateDocsAttributeType, docDataModel: DocumentDataModel, injector: Injector): boolean;
 export declare function stripBlockTokens(text: string): string;

package/lib/types/index.d.ts

@@ -19,6 +19,8 @@ export { CreateHeaderFooterCommand, HeaderFooterType } from './commands/commands
 export type { HeaderFooterCreateMode, ICreateHeaderFooterCommandParams, IHeaderFooterProps, } from './commands/commands/create-header-footer.command';
 export { SetDocumentDefaultParagraphStyleCommand } from './commands/commands/set-document-default-paragraph-style.command';
 export type { IDocumentDefaultParagraphStylePatch, ISetDocumentDefaultParagraphStyleCommandParams, } from './commands/commands/set-document-default-paragraph-style.command';
+export { SetDocumentNameCommand } from './commands/commands/set-document-name.command';
+export type { ISetDocumentNameCommandParams } from './commands/commands/set-document-name.command';
 export { SetSectionHeaderFooterLinkCommand } from './commands/commands/set-section-header-footer-link.command';
 export type { ISetSectionHeaderFooterLinkCommandParams } from './commands/commands/set-section-header-footer-link.command';
 export { UpdateDocumentParagraphStyleCommand } from './commands/commands/update-document-paragraph-style.command';

package/lib/types/services/doc-state-change-manager.service.d.ts

@@ -43,6 +43,7 @@ export declare class DocStateChangeManagerService extends RxDisposable {
         collaboration: IDocStateChangeParams[];
     };
     setStateCache(unitId: string, cache: IStateCache): void;
+    clearHistory(unitId: string): void;
     private _setChangeState;
     private _initialize;
     private _listenDocStateChange;

package/lib/types/services/doc-state-emit.service.d.ts

@@ -19,6 +19,10 @@ import { RxDisposable } from '@univerjs/core';
 interface IDocChangeState {
     actions: JSONXActions;
     textRanges: Nullable<ITextRangeWithStyle[]>;
+    options?: {
+        [key: string]: boolean;
+    };
+    isEditing?: boolean;
 }
 export interface IDocStateChangeParams {
     commandId: string;