@univerjs/docs 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/index.js

@@ -1,4 +1,4 @@
-import { AlignTypeH, BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DataStreamTreeTokenType, DeleteDirection, Disposable, DisposableCollection, DocumentFlavor, DrawingTypeEnum, ICommandService, IConfigService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, MemoryCursor, ObjectRelativeFromH, ObjectRelativeFromV, Optional, PAGE_SIZE, PaperType, Plugin, PositionedObjectLayoutType, RedoCommandId, RxDisposable, TextX, TextXActionType, Tools, UndoCommandId, UniverInstanceType, UpdateDocsAttributeType, composeInterceptors, containsInteriorInsertionOffset, createIdentifier, createInterceptorKey, createParagraphId, createSectionId, generateRandomId, getBlockRangeInterval, getColumnGroupRangeInterval, getRichTextEditPath, getSectionHeaderFooterReferenceKey, getTableRangeInterval, isInternalEditorID, merge, remove, resolveSectionHeaderFooterReference, toDisposable, validateDocBodyStructure } from "@univerjs/core";
+import { AlignTypeH, BuildTextUtils, ColumnSeparatorType, CommandType, CustomRangeType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DataStreamTreeTokenType, DeleteDirection, Disposable, DisposableCollection, DocumentFlavor, DocxBreakType, DrawingTypeEnum, ICommandService, IConfigService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, MemoryCursor, ObjectRelativeFromH, ObjectRelativeFromV, Optional, PAGE_SIZE, PageOrientType, PaperType, Plugin, PositionedObjectLayoutType, RESTORE_INSERTED_PARAGRAPH_IDS, RedoCommandId, RxDisposable, SectionType, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN, TextX, TextXActionType, Tools, UndoCommandId, UniverInstanceType, UpdateDocsAttributeType, composeInterceptors, containsInteriorInsertionOffset, createIdentifier, createInterceptorKey, createParagraphId, createSectionId, generateRandomId, getBlockRangeInterval, getColumnGroupRangeInterval, getParagraphContentStartOffset, getRichTextEditPath, getSectionHeaderFooterReferenceKey, getTableRangeInterval, isInternalEditorID, merge, remove, resolveSectionHeaderFooterReference, toDisposable, validateDocBodyStructure } 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.137.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.140.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.137.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.140.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.137.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.140.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
+//#region \0@oxc-project+runtime@0.140.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.137.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.140.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.137.0/helpers/esm/decorate.js
+//#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);
@@ -72,6 +72,11 @@ function __decorate(decorators, target, key, desc) {
 
 //#endregion
 //#region src/services/doc-selection-manager.service.ts
+/**
+* Keeps a programmatically restored collapsed caret from being promoted back
+* into a neighboring whole-entity selection by feature-specific UI.
+*/
+const DOC_SELECTION_OPTION_PRESERVE_CARET = "preserveCaret";
 let DocSelectionManagerService = class DocSelectionManagerService extends RxDisposable {
 	constructor(_commandService, _univerInstanceService) {
 		super();
@@ -118,9 +123,8 @@ let DocSelectionManagerService = class DocSelectionManagerService extends RxDisp
 		return (_this$_getTextRanges2 = this._getTextRanges(params)) === null || _this$_getTextRanges2 === void 0 ? void 0 : _this$_getTextRanges2.rectRanges;
 	}
 	getDocRanges(params = this._currentSelection) {
-		var _this$getTextRanges, _this$getRectRanges;
-		const textRanges = (_this$getTextRanges = this.getTextRanges(params)) !== null && _this$getTextRanges !== void 0 ? _this$getTextRanges : [];
-		const rectRanges = (_this$getRectRanges = this.getRectRanges(params)) !== null && _this$getRectRanges !== void 0 ? _this$getRectRanges : [];
+		const textRanges = this.getTextRanges(params) ?? [];
+		const rectRanges = this.getRectRanges(params) ?? [];
 		return [...textRanges, ...rectRanges].filter((range) => range.startOffset != null && range.endOffset != null).sort((a, b) => {
 			if (a.startOffset > b.startOffset) return 1;
 			else if (a.startOffset < b.startOffset) return -1;
@@ -133,16 +137,6 @@ let DocSelectionManagerService = class DocSelectionManagerService extends RxDisp
 		const { textRanges } = selectionInfo;
 		return textRanges.find((textRange) => textRange.isActive);
 	}
-	/**
-	*
-	* @deprecated
-	*/
-	getActiveRectRange() {
-		const selectionInfo = this._getTextRanges(this._currentSelection);
-		if (selectionInfo == null) return;
-		const { rectRanges } = selectionInfo;
-		return rectRanges.find((rectRange) => rectRange.isActive);
-	}
 	__TEST_ONLY_add(textRanges, isEditing = true) {
 		if (this._currentSelection == null) return;
 		this._addByParam({
@@ -155,12 +149,6 @@ let DocSelectionManagerService = class DocSelectionManagerService extends RxDisp
 			style: NORMAL_TEXT_SELECTION_PLUGIN_STYLE
 		});
 	}
-	/**
-	* @deprecated pls use replaceDocRanges.
-	*/
-	replaceTextRanges(docRanges, isEditing = true, options) {
-		return this.replaceDocRanges(docRanges, this._currentSelection, isEditing, options);
-	}
 	replaceDocRanges(docRanges, params = this._currentSelection, isEditing = true, options) {
 		if (params == null) return;
 		const { unitId, subUnitId } = params;
@@ -211,14 +199,15 @@ let DocSelectionManagerService = class DocSelectionManagerService extends RxDisp
 	_refresh(param) {
 		const allTextSelectionInfo = this._getTextRanges(param);
 		if (allTextSelectionInfo == null) return;
-		const { textRanges, rectRanges } = allTextSelectionInfo;
+		const { textRanges, rectRanges, options } = allTextSelectionInfo;
 		const docRanges = [...textRanges, ...rectRanges];
 		const { unitId, subUnitId } = param;
 		this._refreshSelection$.next({
 			unitId,
 			subUnitId,
 			docRanges,
-			isEditing: false
+			isEditing: false,
+			options
 		});
 	}
 	_replaceByParam(insertParam) {
@@ -268,6 +257,13 @@ let DocSkeletonManagerService = class DocSkeletonManagerService extends RxDispos
 	getViewModel() {
 		return this._docViewModel;
 	}
+	recalculate() {
+		const skeleton = this._skeleton;
+		skeleton.calculate();
+		this._currentSkeletonBefore$.next(skeleton);
+		this._currentSkeleton$.next(skeleton);
+		return skeleton;
+	}
 	_init() {
 		const documentDataModel = this._context.unit;
 		this._update(documentDataModel);
@@ -280,10 +276,7 @@ let DocSkeletonManagerService = class DocSkeletonManagerService extends RxDispos
 			this._context.unit = documentDataModel;
 		} else if (!this._docViewModel) this._docViewModel = this._buildDocViewModel(documentDataModel);
 		if (!this._skeleton) this._skeleton = this._buildSkeleton(this._docViewModel);
-		const skeleton = this._skeleton;
-		skeleton.calculate();
-		this._currentSkeletonBefore$.next(skeleton);
-		this._currentSkeleton$.next(skeleton);
+		this.recalculate();
 		this._currentViewModel$.next(this._docViewModel);
 	}
 	_buildSkeleton(documentViewModel) {
@@ -344,7 +337,7 @@ const RichTextEditingMutation = {
 	id: RichTextEditingMutationId,
 	type: CommandType.MUTATION,
 	handler: (accessor, params, options) => {
-		var _renderManagerService, _docSelectionManagerS;
+		var _renderManagerService;
 		const { unitId, segmentId = "", actions, textRanges, prevTextRanges, trigger, noHistory, isCompositionEnd, noNeedSetTextRange, debounce, isEditing = true, isSync: paramsIsSync, syncer } = params;
 		const isSync = paramsIsSync || (options === null || options === void 0 ? void 0 : options.fromCollab) || (options === null || options === void 0 ? void 0 : options.fromChangeset);
 		const univerInstanceService = accessor.get(IUniverInstanceService);
@@ -354,7 +347,7 @@ const RichTextEditingMutation = {
 		const documentViewModel = (_renderManagerService = renderManagerService.getRenderUnitById(unitId)) === null || _renderManagerService === void 0 ? void 0 : _renderManagerService.with(DocSkeletonManagerService).getViewModel();
 		if (documentDataModel == null) throw new Error(`DocumentDataModel not found for unitId: ${unitId}`);
 		const docSelectionManagerService = accessor.get(DocSelectionManagerService);
-		const docRanges = (_docSelectionManagerS = docSelectionManagerService.getDocRanges()) !== null && _docSelectionManagerS !== void 0 ? _docSelectionManagerS : [];
+		const docRanges = docSelectionManagerService.getDocRanges() ?? [];
 		const disabled = !!documentDataModel.getSnapshot().disabled;
 		if (JSONX.isNoop(actions) || actions && actions.length === 0 || disabled) return {
 			unitId,
@@ -389,7 +382,7 @@ const RichTextEditingMutation = {
 			},
 			undoState: {
 				actions: undoActions,
-				textRanges: prevTextRanges !== null && prevTextRanges !== void 0 ? prevTextRanges : docRanges
+				textRanges: prevTextRanges ?? docRanges
 			},
 			isCompositionEnd,
 			isSync,
@@ -413,7 +406,7 @@ const InsertTextCommand = {
 	id: "doc.command.insert-text",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _ref, _ref2, _docDataModel$getSelf;
+		var _docDataModel$getSelf;
 		const commandService = accessor.get(ICommandService);
 		const { range, segmentId, body, unitId, cursorOffset } = params;
 		const docSelectionManagerService = accessor.get(DocSelectionManagerService);
@@ -421,11 +414,11 @@ const InsertTextCommand = {
 		if (docDataModel == null) return false;
 		const activeRange = docSelectionManagerService.getActiveTextRange();
 		const rangeSegmentId = "segmentId" in range ? range.segmentId : void 0;
-		const targetSegmentId = (_ref = (_ref2 = segmentId !== null && segmentId !== void 0 ? segmentId : rangeSegmentId) !== null && _ref2 !== void 0 ? _ref2 : activeRange === null || activeRange === void 0 ? void 0 : activeRange.segmentId) !== null && _ref !== void 0 ? _ref : "";
+		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 !== null && cursorOffset !== void 0 ? cursorOffset : body.dataStream.length;
+		const cursorMove = cursorOffset ?? body.dataStream.length;
 		const textRanges = [{
 			startOffset: startOffset + cursorMove,
 			endOffset: startOffset + cursorMove,
@@ -594,7 +587,7 @@ function getEmptyHeaderFooterBody() {
 function createHeaderFooterAction(segmentId, createType, headerFooterConfig, actions, createMode = "single", configPath = ["documentStyle"]) {
 	const jsonX = JSONX.getInstance();
 	const ID_LEN = 6;
-	const firstSegmentId = segmentId !== null && segmentId !== void 0 ? segmentId : generateRandomId(ID_LEN);
+	const firstSegmentId = segmentId ?? generateRandomId(ID_LEN);
 	const isHeader = createType === 2 || createType === 0 || createType === 4;
 	const insertAction = jsonX.insertOp([isHeader ? "headers" : "footers", firstSegmentId], {
 		[isHeader ? "headerId" : "footerId"]: firstSegmentId,
@@ -653,7 +646,7 @@ const CreateHeaderFooterCommand = {
 	id: "doc.command.create-header-footer",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _body$sectionBreaks$f, _body$sectionBreaks, _body$sectionBreaks2;
+		var _body$sectionBreaks, _body$sectionBreaks2;
 		const commandService = accessor.get(ICommandService);
 		const univerInstanceService = accessor.get(IUniverInstanceService);
 		const { unitId, segmentId, createType, headerFooterProps, createMode = "single", sectionId } = params;
@@ -663,10 +656,10 @@ const CreateHeaderFooterCommand = {
 		if (documentStyle.documentFlavor === DocumentFlavor.MODERN) return false;
 		const rawActions = [];
 		const jsonX = JSONX.getInstance();
-		const sectionIndex = sectionId == null ? -1 : (_body$sectionBreaks$f = body === null || body === void 0 || (_body$sectionBreaks = body.sectionBreaks) === null || _body$sectionBreaks === void 0 ? void 0 : _body$sectionBreaks.findIndex((section) => section.sectionId === sectionId)) !== null && _body$sectionBreaks$f !== void 0 ? _body$sectionBreaks$f : -1;
+		const sectionIndex = sectionId == null ? -1 : (body === null || body === void 0 || (_body$sectionBreaks = body.sectionBreaks) === null || _body$sectionBreaks === void 0 ? void 0 : _body$sectionBreaks.findIndex((section) => section.sectionId === sectionId)) ?? -1;
 		const sectionBreak = sectionIndex < 0 ? void 0 : body === null || body === void 0 || (_body$sectionBreaks2 = body.sectionBreaks) === null || _body$sectionBreaks2 === void 0 ? void 0 : _body$sectionBreaks2[sectionIndex];
 		if (sectionId != null && !sectionBreak) return false;
-		const headerFooterConfig = sectionBreak !== null && sectionBreak !== void 0 ? sectionBreak : documentStyle;
+		const headerFooterConfig = sectionBreak ?? documentStyle;
 		const configPath = sectionId == null ? ["documentStyle"] : [
 			"body",
 			"sectionBreaks",
@@ -748,8 +741,7 @@ const SetDocumentDefaultParagraphStyleCommand = {
 //#region src/utils/sections.ts
 /** Returns document-level section breaks, excluding table-cell and modern-column sentinels. */
 function getTopLevelSectionBreaks(body) {
-	var _body$sectionBreaks;
-	const sectionBreakByIndex = new Map(((_body$sectionBreaks = body.sectionBreaks) !== null && _body$sectionBreaks !== void 0 ? _body$sectionBreaks : []).map((sectionBreak) => [sectionBreak.startIndex, sectionBreak]));
+	const sectionBreakByIndex = new Map((body.sectionBreaks ?? []).map((sectionBreak) => [sectionBreak.startIndex, sectionBreak]));
 	const result = [];
 	let tableCellDepth = 0;
 	let columnDepth = 0;
@@ -773,7 +765,7 @@ const SetSectionHeaderFooterLinkCommand = {
 	id: "doc.command.set-section-header-footer-link",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _snapshot$body$sectio, _snapshot$body$sectio2;
+		var _snapshot$body$sectio;
 		if (!params) return false;
 		const instanceService = accessor.get(IUniverInstanceService);
 		const commandService = accessor.get(ICommandService);
@@ -783,7 +775,7 @@ const SetSectionHeaderFooterLinkCommand = {
 		const sections = getTopLevelSectionBreaks(snapshot.body);
 		const sectionIndex = sections.findIndex((section) => section.sectionId === params.sectionId);
 		if (sectionIndex <= 0) return false;
-		const storageIndex = (_snapshot$body$sectio = (_snapshot$body$sectio2 = snapshot.body.sectionBreaks) === null || _snapshot$body$sectio2 === void 0 ? void 0 : _snapshot$body$sectio2.findIndex((item) => item.sectionId === params.sectionId)) !== null && _snapshot$body$sectio !== void 0 ? _snapshot$body$sectio : -1;
+		const storageIndex = ((_snapshot$body$sectio = snapshot.body.sectionBreaks) === null || _snapshot$body$sectio === void 0 ? void 0 : _snapshot$body$sectio.findIndex((item) => item.sectionId === params.sectionId)) ?? -1;
 		if (storageIndex < 0) return false;
 		const context = {
 			snapshot,
@@ -841,7 +833,7 @@ function buildUnlinkActions(context, kind, requestedSegmentId) {
 	const explicitSegmentId = sections[sectionIndex][key];
 	if (typeof explicitSegmentId === "string" && explicitSegmentId) return null;
 	const sourceSegmentId = resolveSectionHeaderFooterReference(snapshot.documentStyle, sections, sectionIndex - 1, key).segmentId;
-	const segmentId = requestedSegmentId !== null && requestedSegmentId !== void 0 ? requestedSegmentId : generateRandomId(6);
+	const segmentId = requestedSegmentId ?? generateRandomId(6);
 	const resources = kind === "header" ? snapshot.headers : snapshot.footers;
 	if (resources === null || resources === void 0 ? void 0 : resources[segmentId]) return null;
 	const source = sourceSegmentId ? resources === null || resources === void 0 ? void 0 : resources[sourceSegmentId] : void 0;
@@ -862,6 +854,174 @@ function buildUnlinkActions(context, kind, requestedSegmentId) {
 	], segmentId)];
 }
 
+//#endregion
+//#region src/commands/commands/update-document-paragraph-style.command.ts
+function isValidParams(params) {
+	return Boolean((params === null || params === void 0 ? void 0 : params.unitId) && params.paragraphId && Number.isInteger(params.startOffset) && Number.isInteger(params.endOffset) && params.startOffset >= 0 && params.endOffset >= params.startOffset && params.style && Object.keys(params.style).length > 0);
+}
+function getCurrentParagraph(body, params) {
+	const matches = (body.paragraphs ?? []).filter((paragraph) => paragraph.paragraphId === params.paragraphId);
+	if (matches.length !== 1) return null;
+	const paragraph = matches[0];
+	return getParagraphContentStartOffset(body, paragraph) === params.startOffset && paragraph.startIndex === params.endOffset && body.dataStream[params.endOffset] === "\r" ? paragraph : null;
+}
+function createParagraphStyleTextX(body, paragraph, params) {
+	const textX = new TextX();
+	const initializesTextRuns = Boolean(params.style.textStyle && params.startOffset < params.endOffset && body.textRuns == null);
+	if (params.startOffset > 0) textX.push({
+		t: TextXActionType.RETAIN,
+		len: params.startOffset
+	});
+	if (params.style.textStyle && params.startOffset < params.endOffset && !initializesTextRuns) textX.push({
+		t: TextXActionType.RETAIN,
+		len: params.endOffset - params.startOffset,
+		coverType: UpdateDocsAttributeType.COVER,
+		body: {
+			dataStream: "",
+			textRuns: [{
+				st: 0,
+				ed: params.endOffset - params.startOffset,
+				ts: Tools.deepClone(params.style.textStyle)
+			}]
+		}
+	});
+	else if (params.startOffset < params.endOffset) textX.push({
+		t: TextXActionType.RETAIN,
+		len: params.endOffset - params.startOffset
+	});
+	const paragraphBody = {
+		dataStream: "",
+		paragraphs: [{
+			...Tools.deepClone(paragraph),
+			startIndex: 0,
+			paragraphStyle: {
+				...Tools.deepClone(paragraph.paragraphStyle ?? {}),
+				...Tools.deepClone(params.style)
+			}
+		}]
+	};
+	Object.defineProperty(paragraphBody, RESTORE_INSERTED_PARAGRAPH_IDS, {
+		value: true,
+		enumerable: true
+	});
+	textX.push({
+		t: TextXActionType.RETAIN,
+		len: 1,
+		coverType: UpdateDocsAttributeType.REPLACE,
+		body: paragraphBody
+	});
+	return {
+		textX,
+		initializesTextRuns
+	};
+}
+const UpdateDocumentParagraphStyleCommand = {
+	id: "doc.command.update-paragraph-style",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		var _documentDataModel$ge;
+		if (!isValidParams(params)) return false;
+		const instanceService = accessor.get(IUniverInstanceService);
+		const commandService = accessor.get(ICommandService);
+		const documentDataModel = instanceService.getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
+		const segmentId = params.segmentId ?? "";
+		const body = documentDataModel === null || documentDataModel === void 0 || (_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.getBody();
+		if (!documentDataModel || !body) return false;
+		const paragraph = getCurrentParagraph(body, params);
+		if (!paragraph) return false;
+		const { textX, initializesTextRuns } = createParagraphStyleTextX(body, paragraph, params);
+		const jsonX = JSONX.getInstance();
+		const path = getRichTextEditPath(documentDataModel, segmentId);
+		let actions = jsonX.editOp(textX.serialize(), path);
+		if (initializesTextRuns) {
+			const initializeTextRunsActions = jsonX.replaceOp([...path, "textRuns"], void 0, [{
+				st: params.startOffset,
+				ed: params.endOffset,
+				ts: Tools.deepClone(params.style.textStyle)
+			}]);
+			actions = JSONX.compose(initializeTextRunsActions, actions);
+		}
+		return Boolean(commandService.syncExecuteCommand(RichTextEditingMutation.id, {
+			unitId: params.unitId,
+			segmentId,
+			actions,
+			textRanges: null,
+			noNeedSetTextRange: true,
+			isEditing: false,
+			trigger: UpdateDocumentParagraphStyleCommand.id
+		}));
+	}
+};
+
+//#endregion
+//#region src/utils/section-columns.ts
+function resolveSectionValue(sectionValue, documentValue, fallback) {
+	return sectionValue ?? documentValue ?? fallback;
+}
+function getEffectivePageSize(documentStyle, section) {
+	var _section$pageSize, _documentStyle$pageSi, _section$pageSize2, _documentStyle$pageSi2;
+	const fallback = PAGE_SIZE[PaperType.A4];
+	return {
+		width: resolveSectionValue(section === null || section === void 0 || (_section$pageSize = section.pageSize) === null || _section$pageSize === void 0 ? void 0 : _section$pageSize.width, documentStyle === null || documentStyle === void 0 || (_documentStyle$pageSi = documentStyle.pageSize) === null || _documentStyle$pageSi === void 0 ? void 0 : _documentStyle$pageSi.width, fallback.width),
+		height: resolveSectionValue(section === null || section === void 0 || (_section$pageSize2 = section.pageSize) === null || _section$pageSize2 === void 0 ? void 0 : _section$pageSize2.height, documentStyle === null || documentStyle === void 0 || (_documentStyle$pageSi2 = documentStyle.pageSize) === null || _documentStyle$pageSi2 === void 0 ? void 0 : _documentStyle$pageSi2.height, fallback.height)
+	};
+}
+function getEffectiveMargins(documentStyle, section) {
+	return {
+		top: resolveSectionValue(section === null || section === void 0 ? void 0 : section.marginTop, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginTop, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN),
+		bottom: resolveSectionValue(section === null || section === void 0 ? void 0 : section.marginBottom, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginBottom, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN),
+		left: resolveSectionValue(section === null || section === void 0 ? void 0 : section.marginLeft, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginLeft, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN),
+		right: resolveSectionValue(section === null || section === void 0 ? void 0 : section.marginRight, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginRight, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN)
+	};
+}
+function assertPositivePageSetup(pageSize, contentSize) {
+	if (![
+		pageSize.width,
+		pageSize.height,
+		contentSize.width,
+		contentSize.height
+	].every((value) => Number.isFinite(value) && value > 0)) throw new RangeError("Effective section page setup must leave a positive content area and use finite positive page dimensions.");
+}
+/** Resolves nominal traditional page geometry without requiring a renderer. */
+function getEffectiveSectionPageSetup(documentStyle, section) {
+	const pageSize = getEffectivePageSize(documentStyle, section);
+	const margins = getEffectiveMargins(documentStyle, section);
+	const contentSize = {
+		width: getSectionContentWidth(documentStyle, section),
+		height: pageSize.height - margins.top - margins.bottom
+	};
+	assertPositivePageSetup(pageSize, contentSize);
+	const pageNumberStart = (section === null || section === void 0 ? void 0 : section.pageNumberStart) ?? (documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.pageNumberStart);
+	return {
+		pageSize,
+		pageOrient: resolveSectionValue(section === null || section === void 0 ? void 0 : section.pageOrient, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.pageOrient, PageOrientType.PORTRAIT),
+		margins,
+		contentSize,
+		...pageNumberStart == null ? {} : { pageNumberStart }
+	};
+}
+/** Returns the usable horizontal layout width for a traditional section. */
+function getSectionContentWidth(documentStyle, section) {
+	var _section$pageSize3, _documentStyle$pageSi3;
+	const pageWidth = resolveSectionValue(section === null || section === void 0 || (_section$pageSize3 = section.pageSize) === null || _section$pageSize3 === void 0 ? void 0 : _section$pageSize3.width, documentStyle === null || documentStyle === void 0 || (_documentStyle$pageSi3 = documentStyle.pageSize) === null || _documentStyle$pageSi3 === void 0 ? void 0 : _documentStyle$pageSi3.width, PAGE_SIZE[PaperType.A4].width);
+	return Math.max(0, pageWidth - resolveSectionValue(section === null || section === void 0 ? void 0 : section.marginLeft, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginLeft, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN) - resolveSectionValue(section === null || section === void 0 ? void 0 : section.marginRight, documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginRight, TRADITIONAL_DOCUMENT_DEFAULT_MARGIN));
+}
+/** Creates explicit OOXML section columns from a count, gap, and optional widths. */
+function createSectionColumnProperties(documentStyle, section, columnCount, gap, widths) {
+	if (columnCount <= 1) return [];
+	const safeGap = Math.max(0, gap);
+	const contentWidth = getSectionContentWidth(documentStyle, section);
+	const availableWidth = Math.max(0, contentWidth - safeGap * (columnCount - 1));
+	if (widths) {
+		if (widths.some((width) => !Number.isFinite(width) || width < 0)) throw new RangeError("Section column widths must be finite and non-negative.");
+		if (widths.reduce((sum, width) => sum + width, 0) > availableWidth) throw new RangeError("Section columns exceed the available page content width.");
+	}
+	return (widths ?? Array.from({ length: columnCount }, () => availableWidth / columnCount)).map((width, index) => ({
+		width: Math.max(0, width),
+		paddingEnd: index === columnCount - 1 ? 0 : safeGap
+	}));
+}
+
 //#endregion
 //#region src/commands/commands/update-document-section.command.ts
 const UpdateDocumentSectionCommand = {
@@ -880,6 +1040,11 @@ const UpdateDocumentSectionCommand = {
 		const selectedIds = new Set(updates.keys());
 		const sections = getTopLevelSectionBreaks(body).filter((section) => selectedIds.has(section.sectionId)).sort((left, right) => left.startIndex - right.startIndex);
 		if (sections.length !== selectedIds.size) return false;
+		const documentStyle = documentDataModel.getDocumentStyle();
+		if (sections.some((section) => !isValidSectionConfig({
+			...section,
+			...updates.get(section.sectionId)
+		}, documentStyle))) return false;
 		const cursor = new MemoryCursor();
 		const textX = new TextX();
 		for (const section of sections) {
@@ -923,25 +1088,70 @@ const InsertDocumentSectionBreakCommand = {
 	id: "doc.command.insert-section-break",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _body$sectionBreaks, _body$tables, _body$columnGroups, _body$blockRanges, _params$config;
+		var _body$sectionBreaks;
 		if (!params) return false;
 		const context = getTraditionalDocumentContext(accessor, params.unitId);
-		if (!context || !params.sectionId || !Number.isInteger(params.offset)) return false;
+		if (!context || !params.sectionId || !Number.isInteger(params.offset) || params.nextSectionType != null && !isValidEnumValue(SectionType, params.nextSectionType)) return false;
 		const { body, documentDataModel, commandService } = context;
-		if (params.offset < 0 || params.offset > body.dataStream.length || ((_body$sectionBreaks = body.sectionBreaks) === null || _body$sectionBreaks === void 0 ? void 0 : _body$sectionBreaks.some((section) => section.sectionId === params.sectionId)) || ((_body$tables = body.tables) === null || _body$tables === void 0 ? void 0 : _body$tables.some((range) => containsInteriorInsertionOffset(getTableRangeInterval(range), params.offset))) || ((_body$columnGroups = body.columnGroups) === null || _body$columnGroups === void 0 ? void 0 : _body$columnGroups.some((range) => containsInteriorInsertionOffset(getColumnGroupRangeInterval(range), params.offset))) || ((_body$blockRanges = body.blockRanges) === null || _body$blockRanges === void 0 ? void 0 : _body$blockRanges.some((range) => containsInteriorInsertionOffset(getBlockRangeInterval(range), params.offset)))) return false;
+		const insertedSection = {
+			...Tools.deepClone(params.config ?? {}),
+			sectionId: params.sectionId,
+			startIndex: params.offset
+		};
+		if (!isValidTopLevelInsertionOffset(body, params.offset) || ((_body$sectionBreaks = body.sectionBreaks) === null || _body$sectionBreaks === void 0 ? void 0 : _body$sectionBreaks.some((section) => section.sectionId === params.sectionId)) || !isValidSectionConfig(insertedSection, documentDataModel.getDocumentStyle())) return false;
+		const nextSection = params.nextSectionType == null ? void 0 : getTopLevelSectionBreaks(body).find((section) => section.startIndex >= params.offset);
+		if (params.nextSectionType != null && !nextSection) return false;
 		const textX = new TextX();
 		textX.retain(params.offset);
 		textX.insert(1, {
 			dataStream: DataStreamTreeTokenType.SECTION_BREAK,
 			sectionBreaks: [{
-				...Tools.deepClone((_params$config = params.config) !== null && _params$config !== void 0 ? _params$config : {}),
-				sectionId: params.sectionId,
+				...insertedSection,
 				startIndex: 0
 			}]
 		});
+		if (nextSection && params.nextSectionType != null) {
+			textX.retain(nextSection.startIndex - params.offset);
+			textX.push({
+				t: TextXActionType.RETAIN,
+				len: 1,
+				coverType: UpdateDocsAttributeType.REPLACE,
+				body: {
+					dataStream: "",
+					sectionBreaks: [{
+						...Tools.deepClone(nextSection),
+						sectionType: params.nextSectionType,
+						startIndex: 0
+					}]
+				}
+			});
+		}
 		return executeSectionTextX(commandService, documentDataModel, textX, InsertDocumentSectionBreakCommand.id);
 	}
 };
+const InsertDocumentColumnBreakCommand = {
+	id: "doc.command.insert-column-break",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		if (!params) return false;
+		const context = getTraditionalDocumentContext(accessor, params.unitId);
+		if (!context || !isValidTopLevelInsertionOffset(context.body, params.offset)) return false;
+		const textX = new TextX();
+		textX.retain(params.offset);
+		textX.insert(1, {
+			dataStream: DataStreamTreeTokenType.COLUMN_BREAK,
+			customRanges: [{
+				startIndex: 0,
+				endIndex: 0,
+				rangeId: `docx-break-${generateRandomId()}`,
+				rangeType: CustomRangeType.CUSTOM,
+				wholeEntity: true,
+				properties: { docxBreakType: DocxBreakType.COLUMN }
+			}]
+		});
+		return executeSectionTextX(context.commandService, context.documentDataModel, textX, InsertDocumentColumnBreakCommand.id);
+	}
+};
 const DeleteDocumentSectionBreakCommand = {
 	id: "doc.command.delete-section-break",
 	type: CommandType.COMMAND,
@@ -952,7 +1162,7 @@ const DeleteDocumentSectionBreakCommand = {
 		const sections = getTopLevelSectionBreaks(context.body);
 		if (sections.length <= 1) return false;
 		const section = sections.find((item) => item.sectionId === params.sectionId);
-		if (!section) return false;
+		if (!section || section === sections[sections.length - 1]) return false;
 		const textX = new TextX();
 		textX.retain(section.startIndex);
 		textX.delete(1);
@@ -970,6 +1180,38 @@ function getTraditionalDocumentContext(accessor, unitId) {
 		commandService: accessor.get(ICommandService)
 	};
 }
+function isValidTopLevelInsertionOffset(body, offset) {
+	var _body$tables, _body$columnGroups, _body$blockRanges;
+	return Number.isInteger(offset) && offset >= 0 && offset <= body.dataStream.length && !((_body$tables = body.tables) === null || _body$tables === void 0 ? void 0 : _body$tables.some((range) => containsInteriorInsertionOffset(getTableRangeInterval(range), offset))) && !((_body$columnGroups = body.columnGroups) === null || _body$columnGroups === void 0 ? void 0 : _body$columnGroups.some((range) => containsInteriorInsertionOffset(getColumnGroupRangeInterval(range), offset))) && !((_body$blockRanges = body.blockRanges) === null || _body$blockRanges === void 0 ? void 0 : _body$blockRanges.some((range) => containsInteriorInsertionOffset(getBlockRangeInterval(range), offset)));
+}
+function isValidSectionConfig(section, documentStyle) {
+	if (section.sectionType != null && !isValidEnumValue(SectionType, section.sectionType)) return false;
+	if (section.pageOrient != null && !isValidEnumValue(PageOrientType, section.pageOrient)) return false;
+	if (section.columnSeparatorType != null && !isValidEnumValue(ColumnSeparatorType, section.columnSeparatorType)) return false;
+	if (section.pageNumberStart != null && (!Number.isInteger(section.pageNumberStart) || section.pageNumberStart < 1)) return false;
+	if (section.pageSize && (!isPositiveFinite(section.pageSize.width) || !isPositiveFinite(section.pageSize.height))) return false;
+	if ([
+		section.marginTop,
+		section.marginBottom,
+		section.marginLeft,
+		section.marginRight
+	].some((margin) => margin != null && (!Number.isFinite(margin) || margin < 0))) return false;
+	const pageSize = section.pageSize ?? documentStyle.pageSize;
+	const marginTop = section.marginTop ?? documentStyle.marginTop ?? 0;
+	const marginBottom = section.marginBottom ?? documentStyle.marginBottom ?? 0;
+	const marginLeft = section.marginLeft ?? documentStyle.marginLeft ?? 0;
+	const marginRight = section.marginRight ?? documentStyle.marginRight ?? 0;
+	if ((pageSize === null || pageSize === void 0 ? void 0 : pageSize.width) != null && marginLeft + marginRight >= pageSize.width || (pageSize === null || pageSize === void 0 ? void 0 : pageSize.height) != null && marginTop + marginBottom >= pageSize.height) return false;
+	const columns = section.columnProperties ?? [];
+	if (columns.some(({ width, paddingEnd }) => !Number.isFinite(width) || !Number.isFinite(paddingEnd) || width < 0 || paddingEnd < 0)) return false;
+	return columns.reduce((sum, { width, paddingEnd }) => sum + width + paddingEnd, 0) <= getSectionContentWidth(documentStyle, section);
+}
+function isPositiveFinite(value) {
+	return value != null && Number.isFinite(value) && value > 0;
+}
+function isValidEnumValue(enumObject, value) {
+	return Object.values(enumObject).includes(value);
+}
 function executeSectionTextX(commandService, documentDataModel, textX, trigger) {
 	const actions = JSONX.getInstance().editOp(textX.serialize(), getRichTextEditPath(documentDataModel));
 	return Boolean(commandService.syncExecuteCommand(RichTextEditingMutation.id, {
@@ -1036,7 +1278,6 @@ function createRemoveCustomBlockActions(params) {
 	return composeActions([toBodyEditActions(textX, params.segmentId), createDrawingRemoveActions(params)]);
 }
 function createDocsCustomBlockDrawing(params) {
-	var _params$componentKey;
 	const size = resolveDocsCustomBlockSize(params.childType);
 	const isInline = params.interactionMode === "inline";
 	return {
@@ -1044,7 +1285,7 @@ function createDocsCustomBlockDrawing(params) {
 		subUnitId: params.unitId,
 		drawingId: params.blockId,
 		drawingType: DrawingTypeEnum.DRAWING_DOM,
-		componentKey: (_params$componentKey = params.componentKey) !== null && _params$componentKey !== void 0 ? _params$componentKey : EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY,
+		componentKey: params.componentKey ?? "UniverEmbedDocsCustomBlock",
 		data: createEmbedDocsCustomBlockData(params),
 		title: params.blockId,
 		description: "Univer embedded unit custom block",
@@ -1082,15 +1323,14 @@ function isSheetLikeDocsCustomBlockChildType(childType) {
 	return childType === UniverInstanceType.UNIVER_SHEET || childType === UniverInstanceType.UNIVER_BASE;
 }
 function createEmbedDocsCustomBlockData(params) {
-	var _params$embedId, _params$interactionMo;
 	return {
 		version: 1,
-		embedId: (_params$embedId = params.embedId) !== null && _params$embedId !== void 0 ? _params$embedId : params.blockId,
+		embedId: params.embedId ?? params.blockId,
 		hostUnitId: params.unitId,
 		hostAnchorId: params.blockId,
 		childUnitId: params.childUnitId,
 		childType: params.childType,
-		interactionMode: (_params$interactionMo = params.interactionMode) !== null && _params$interactionMo !== void 0 ? _params$interactionMo : "block"
+		interactionMode: params.interactionMode ?? "block"
 	};
 }
 function isEmbedDocsCustomBlockData(data) {
@@ -1117,40 +1357,36 @@ function createRichTextMutation(unitId, segmentId, actions) {
 	};
 }
 function toBodyEditActions(textX, segmentId) {
-	const action = JSONX.getInstance().editOp(textX.serialize(), segmentId ? [
+	return JSONX.getInstance().editOp(textX.serialize(), segmentId ? [
 		"headers",
 		segmentId,
 		"body"
-	] : ["body"]);
-	return action !== null && action !== void 0 ? action : [];
+	] : ["body"]) ?? [];
 }
 function createDrawingInsertActions(params) {
-	var _jsonX$insertOp, _jsonX$insertOp2, _params$drawingOrderI;
 	if (params.segmentId) return [];
 	const jsonX = JSONX.getInstance();
 	const drawing = createDocsCustomBlockDrawing(params);
-	return composeActions([(_jsonX$insertOp = jsonX.insertOp(["drawings", params.blockId], drawing)) !== null && _jsonX$insertOp !== void 0 ? _jsonX$insertOp : [], (_jsonX$insertOp2 = jsonX.insertOp(["drawingsOrder", (_params$drawingOrderI = params.drawingOrderIndex) !== null && _params$drawingOrderI !== void 0 ? _params$drawingOrderI : 0], params.blockId)) !== null && _jsonX$insertOp2 !== void 0 ? _jsonX$insertOp2 : []]);
+	return composeActions([jsonX.insertOp(["drawings", params.blockId], drawing) ?? [], jsonX.insertOp(["drawingsOrder", params.drawingOrderIndex ?? 0], params.blockId) ?? []]);
 }
 function createDrawingRemoveActions(params) {
-	var _jsonX$removeOp, _jsonX$removeOp2, _params$drawingOrderI2;
 	if (params.segmentId) return [];
 	const jsonX = JSONX.getInstance();
 	const drawing = createDocsCustomBlockDrawing(params);
-	return composeActions([(_jsonX$removeOp = jsonX.removeOp(["drawings", params.blockId], drawing)) !== null && _jsonX$removeOp !== void 0 ? _jsonX$removeOp : [], (_jsonX$removeOp2 = jsonX.removeOp(["drawingsOrder", (_params$drawingOrderI2 = params.drawingOrderIndex) !== null && _params$drawingOrderI2 !== void 0 ? _params$drawingOrderI2 : 0], params.blockId)) !== null && _jsonX$removeOp2 !== void 0 ? _jsonX$removeOp2 : []]);
+	return composeActions([jsonX.removeOp(["drawings", params.blockId], drawing) ?? [], jsonX.removeOp(["drawingsOrder", params.drawingOrderIndex ?? 0], params.blockId) ?? []]);
 }
 function composeActions(actions) {
 	return actions.reduce((composed, action) => {
-		var _JSONX$compose;
 		if (!action || JSONX.isNoop(action) || action.length === 0) return composed;
 		if (!composed || JSONX.isNoop(composed) || composed.length === 0) return action;
-		return (_JSONX$compose = JSONX.compose(composed, action)) !== null && _JSONX$compose !== void 0 ? _JSONX$compose : [];
+		return JSONX.compose(composed, action) ?? [];
 	}, []);
 }
 
 //#endregion
 //#region package.json
 var name = "@univerjs/docs";
-var version = "1.0.0-alpha.7";
+var version = "1.0.0-beta.0";
 
 //#endregion
 //#region src/commands/mutations/docs-rename.mutation.ts
@@ -1228,7 +1464,7 @@ let DocCustomRangeController = class DocCustomRangeController extends Disposable
 				const doc = this._univerInstanceService.getUnit(unitId);
 				if (!doc) return;
 				const transformedRanges = ranges.map((range) => this._transformCustomRange(doc, range));
-				if (transformedRanges.some((range, i) => ranges[i] !== range)) this._textSelectionManagerService.replaceTextRanges(transformedRanges, isEditing);
+				if (transformedRanges.some((range, i) => ranges[i] !== range)) this._textSelectionManagerService.replaceDocRanges(transformedRanges, void 0, isEditing);
 			}
 		}));
 	}
@@ -1325,10 +1561,9 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 		this._listenDocStateChange();
 	}
 	getStateCache(unitId) {
-		var _this$_historyStateCa, _this$_changeStateCac;
 		return {
-			history: (_this$_historyStateCa = this._historyStateCache.get(unitId)) !== null && _this$_historyStateCa !== void 0 ? _this$_historyStateCa : [],
-			collaboration: (_this$_changeStateCac = this._changeStateCache.get(unitId)) !== null && _this$_changeStateCac !== void 0 ? _this$_changeStateCac : []
+			history: this._historyStateCache.get(unitId) ?? [],
+			collaboration: this._changeStateCache.get(unitId) ?? []
 		};
 	}
 	setStateCache(unitId, cache) {
@@ -1352,9 +1587,9 @@ let DocStateChangeManagerService = class DocStateChangeManagerService extends Rx
 	}
 	_listenDocStateChange() {
 		this._docStateEmitService.docStateChangeParams$.pipe(takeUntil(this.dispose$)).subscribe((changeStateInfo) => {
-			var _this$_docStateChange, _this$_docStateChange2;
+			var _this$_docStateChange;
 			if (changeStateInfo == null) return;
-			const interceptedChangeStateInfo = (_this$_docStateChange = (_this$_docStateChange2 = this._docStateChangeInterceptorService) === null || _this$_docStateChange2 === void 0 ? void 0 : _this$_docStateChange2.transformChangeStateInfo(changeStateInfo)) !== null && _this$_docStateChange !== void 0 ? _this$_docStateChange : changeStateInfo;
+			const interceptedChangeStateInfo = ((_this$_docStateChange = this._docStateChangeInterceptorService) === null || _this$_docStateChange === void 0 ? void 0 : _this$_docStateChange.transformChangeStateInfo(changeStateInfo)) ?? changeStateInfo;
 			if (interceptedChangeStateInfo == null) return;
 			if (interceptedChangeStateInfo.isSync) return;
 			const { isCompositionEnd: _isCompositionEnd, isSync: _isSync, syncer: _syncer, ...changeState } = interceptedChangeStateInfo;
@@ -1452,6 +1687,79 @@ DocStateChangeManagerService = __decorate([
 	__decorateParam(4, Optional(IDocStateChangeInterceptorService))
 ], DocStateChangeManagerService);
 
+//#endregion
+//#region src/services/doc-text-resolver.service.ts
+/**
+* Builds a consumer-facing text projection while retaining a mapping back to
+* the native document offsets.
+*
+* Consumers such as find/replace can search the projected text and then use
+* `characters` to focus the native object that supplied a matching character.
+* Resolvers must return half-open, non-overlapping replacements.
+*/
+var DocTextResolverService = class extends Disposable {
+	constructor(..._args) {
+		super(..._args);
+		_defineProperty(this, "_resolvers", /* @__PURE__ */ new Set());
+		_defineProperty(this, "_textChanged$", new Subject());
+		_defineProperty(this, "textChanged$", this._textChanged$.asObservable());
+	}
+	register(resolver) {
+		this._resolvers.add(resolver);
+		return toDisposable(() => this._resolvers.delete(resolver));
+	}
+	notifyTextChanged(unitId) {
+		this._textChanged$.next(unitId);
+	}
+	resolve(unitId, body) {
+		const replacements = this._collectReplacements(unitId, body);
+		const characters = [];
+		let text = "";
+		let sourceOffset = 0;
+		for (const replacement of replacements) {
+			const sourceText = body.dataStream.slice(sourceOffset, replacement.startOffset);
+			text += sourceText;
+			for (let index = sourceOffset; index < replacement.startOffset; index += 1) characters.push({
+				startOffset: index,
+				endOffset: index + 1,
+				replaceable: true
+			});
+			text += replacement.text;
+			for (let index = 0; index < replacement.text.length; index += 1) characters.push({
+				startOffset: replacement.startOffset,
+				endOffset: replacement.endOffset,
+				replaceable: replacement.replaceable ?? false
+			});
+			sourceOffset = replacement.endOffset;
+		}
+		text += body.dataStream.slice(sourceOffset);
+		for (let index = sourceOffset; index < body.dataStream.length; index += 1) characters.push({
+			startOffset: index,
+			endOffset: index + 1,
+			replaceable: true
+		});
+		return {
+			characters,
+			text
+		};
+	}
+	_collectReplacements(unitId, body) {
+		const candidates = [...this._resolvers].flatMap((resolver) => resolver.resolve(unitId, body)).filter((replacement) => Number.isInteger(replacement.startOffset) && Number.isInteger(replacement.endOffset) && replacement.startOffset >= 0 && replacement.endOffset > replacement.startOffset && replacement.endOffset <= body.dataStream.length).sort((left, right) => left.startOffset - right.startOffset || right.endOffset - left.endOffset);
+		const replacements = [];
+		let previousEnd = -1;
+		for (const candidate of candidates) {
+			if (candidate.startOffset < previousEnd) continue;
+			replacements.push(candidate);
+			previousEnd = candidate.endOffset;
+		}
+		return replacements;
+	}
+	dispose() {
+		this._textChanged$.complete();
+		super.dispose();
+	}
+};
+
 //#endregion
 //#region src/plugin.ts
 let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
@@ -1475,8 +1783,10 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			CreateHeaderFooterCommand,
 			SetDocumentDefaultParagraphStyleCommand,
 			SetSectionHeaderFooterLinkCommand,
+			UpdateDocumentParagraphStyleCommand,
 			UpdateDocumentSectionCommand,
 			InsertDocumentSectionBreakCommand,
+			InsertDocumentColumnBreakCommand,
 			DeleteDocumentSectionBreakCommand,
 			RichTextEditingMutation,
 			DocsRenameMutation,
@@ -1492,6 +1802,7 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			[DocStateChangeManagerService],
 			[DocBlockMoveValidatorService],
 			[DocContentInsertService],
+			[DocTextResolverService],
 			[DocCustomRangeController]
 		].forEach((d) => this._injector.add(d));
 	}
@@ -1547,10 +1858,7 @@ let DocInterceptorService = class DocInterceptorService extends Disposable {
 		if (!this._interceptorsByName.has(key)) this._interceptorsByName.set(key, []);
 		const interceptors = this._interceptorsByName.get(key);
 		interceptors.push(interceptor);
-		this._interceptorsByName.set(key, interceptors.sort((a, b) => {
-			var _b$priority, _a$priority;
-			return ((_b$priority = b.priority) !== null && _b$priority !== void 0 ? _b$priority : 0) - ((_a$priority = a.priority) !== null && _a$priority !== void 0 ? _a$priority : 0);
-		}));
+		this._interceptorsByName.set(key, interceptors.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0)));
 		return this.disposeWithMe(toDisposable(() => remove(this._interceptorsByName.get(key), interceptor)));
 	}
 	fetchThroughInterceptors(name) {
@@ -1561,19 +1869,17 @@ let DocInterceptorService = class DocInterceptorService extends Disposable {
 		const disposableCollection = new DisposableCollection();
 		disposableCollection.add(viewModel.registerCustomRangeInterceptor({
 			getCustomRange: (index) => {
-				var _viewModel$getDataMod;
 				return this.fetchThroughInterceptors(DOC_INTERCEPTOR_POINT.CUSTOM_RANGE)(viewModel.getCustomRangeRaw(index), {
 					index,
 					unitId: viewModel.getDataModel().getUnitId(),
-					customRanges: (_viewModel$getDataMod = viewModel.getDataModel().getCustomRanges()) !== null && _viewModel$getDataMod !== void 0 ? _viewModel$getDataMod : []
+					customRanges: viewModel.getDataModel().getCustomRanges() ?? []
 				});
 			},
 			getCustomDecoration: (index) => {
-				var _viewModel$getDataMod2;
 				return this.fetchThroughInterceptors(DOC_INTERCEPTOR_POINT.CUSTOM_DECORATION)(viewModel.getCustomDecorationRaw(index), {
 					index,
 					unitId: viewModel.getDataModel().getUnitId(),
-					customDecorations: (_viewModel$getDataMod2 = viewModel.getDataModel().getCustomDecorations()) !== null && _viewModel$getDataMod2 !== void 0 ? _viewModel$getDataMod2 : []
+					customDecorations: viewModel.getDataModel().getCustomDecorations() ?? []
 				});
 			}
 		}));
@@ -1611,7 +1917,7 @@ function addCustomRangeBySelectionFactory(accessor, param) {
 	const { rangeId, rangeType, wholeEntity, properties, unitId, selections: propSelection } = param;
 	const docSelectionManagerService = accessor.get(DocSelectionManagerService);
 	const univerInstanceService = accessor.get(IUniverInstanceService);
-	const selections = propSelection !== null && propSelection !== void 0 ? propSelection : docSelectionManagerService.getTextRanges({
+	const selections = propSelection ?? docSelectionManagerService.getTextRanges({
 		unitId,
 		subUnitId: unitId
 	});
@@ -1694,8 +2000,7 @@ function generateParagraphs(dataStream, prevParagraph, borderBottom, existingPar
 			if (prevParagraph.paragraphStyle.headingId) paragraph.paragraphStyle.headingId = generateRandomId(6);
 		}
 		if (borderBottom) {
-			var _paragraph$paragraphS;
-			(_paragraph$paragraphS = paragraph.paragraphStyle) !== null && _paragraph$paragraphS !== void 0 || (paragraph.paragraphStyle = {});
+			paragraph.paragraphStyle ??= {};
 			paragraph.paragraphStyle.borderBottom = Tools.deepClone(borderBottom);
 			paragraph.paragraphStyle.spaceBelow = { v: 10 };
 		}
@@ -1706,7 +2011,7 @@ function generateParagraphs(dataStream, prevParagraph, borderBottom, existingPar
 //#endregion
 //#region src/utils/replace-selection-factory.ts
 function replaceSelectionFactory(accessor, params) {
-	var _params$selection, _docDataModel$getSelf, _params$selection2, _params$textRanges;
+	var _params$selection, _docDataModel$getSelf;
 	const { unitId, body: insertBody, doc } = params;
 	let docDataModel = doc;
 	if (!docDataModel) docDataModel = accessor.get(IUniverInstanceService).getUnit(unitId);
@@ -1715,9 +2020,9 @@ function replaceSelectionFactory(accessor, params) {
 	const body = (_docDataModel$getSelf = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf === void 0 ? void 0 : _docDataModel$getSelf.getBody();
 	if (!body) return false;
 	const docSelectionManagerService = accessor.get(DocSelectionManagerService);
-	const selection = (_params$selection2 = params.selection) !== null && _params$selection2 !== void 0 ? _params$selection2 : docSelectionManagerService.getActiveTextRange();
+	const selection = params.selection ?? docSelectionManagerService.getActiveTextRange();
 	if (!selection || !body) return false;
-	const textRanges = (_params$textRanges = params.textRanges) !== null && _params$textRanges !== void 0 ? _params$textRanges : [{
+	const textRanges = params.textRanges ?? [{
 		startOffset: selection.startOffset + insertBody.dataStream.length,
 		endOffset: selection.startOffset + insertBody.dataStream.length,
 		collapsed: true,
@@ -1745,26 +2050,9 @@ function replaceSelectionFactory(accessor, params) {
 	return doMutation;
 }
 
-//#endregion
-//#region src/utils/section-columns.ts
-/** Creates explicit OOXML section columns from a count, gap, and optional widths. */
-function createSectionColumnProperties(documentStyle, section, columnCount, gap, widths) {
-	var _ref, _section$pageSize$wid, _section$pageSize, _documentStyle$pageSi, _ref2, _section$marginLeft, _ref3, _section$marginRight;
-	if (columnCount <= 1) return [];
-	const safeGap = Math.max(0, gap);
-	const pageWidth = (_ref = (_section$pageSize$wid = section === null || section === void 0 || (_section$pageSize = section.pageSize) === null || _section$pageSize === void 0 ? void 0 : _section$pageSize.width) !== null && _section$pageSize$wid !== void 0 ? _section$pageSize$wid : documentStyle === null || documentStyle === void 0 || (_documentStyle$pageSi = documentStyle.pageSize) === null || _documentStyle$pageSi === void 0 ? void 0 : _documentStyle$pageSi.width) !== null && _ref !== void 0 ? _ref : PAGE_SIZE[PaperType.A4].width;
-	const contentWidth = Math.max(0, pageWidth - ((_ref2 = (_section$marginLeft = section === null || section === void 0 ? void 0 : section.marginLeft) !== null && _section$marginLeft !== void 0 ? _section$marginLeft : documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginLeft) !== null && _ref2 !== void 0 ? _ref2 : 72) - ((_ref3 = (_section$marginRight = section === null || section === void 0 ? void 0 : section.marginRight) !== null && _section$marginRight !== void 0 ? _section$marginRight : documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.marginRight) !== null && _ref3 !== void 0 ? _ref3 : 72));
-	const availableWidth = Math.max(0, contentWidth - safeGap * (columnCount - 1));
-	return (widths !== null && widths !== void 0 ? widths : Array.from({ length: columnCount }, () => availableWidth / columnCount)).map((width, index) => ({
-		width: Math.max(0, width),
-		paddingEnd: index === columnCount - 1 ? 0 : safeGap
-	}));
-}
-
 //#endregion
 //#region src/utils/transform-position.ts
 function buildDocTransform(width, height, position) {
-	var _position$left, _position$top;
 	return {
 		size: {
 			width,
@@ -1772,11 +2060,11 @@ function buildDocTransform(width, height, position) {
 		},
 		positionH: {
 			relativeFrom: ObjectRelativeFromH.PAGE,
-			posOffset: (_position$left = position === null || position === void 0 ? void 0 : position.left) !== null && _position$left !== void 0 ? _position$left : 0
+			posOffset: (position === null || position === void 0 ? void 0 : position.left) ?? 0
 		},
 		positionV: {
 			relativeFrom: ObjectRelativeFromV.PARAGRAPH,
-			posOffset: (_position$top = position === null || position === void 0 ? void 0 : position.top) !== null && _position$top !== void 0 ? _position$top : 0
+			posOffset: (position === null || position === void 0 ? void 0 : position.top) ?? 0
 		},
 		angle: 0
 	};
@@ -1822,7 +2110,7 @@ function consumeContentInsertRange(accessor, unitId) {
 }
 function getContentInsertRange(accessor, unitId) {
 	var _accessor$get$getCurr;
-	const _unitId = unitId !== null && unitId !== void 0 ? unitId : (_accessor$get$getCurr = accessor.get(IUniverInstanceService).getCurrentUnitOfType(UniverInstanceType.UNIVER_DOC)) === null || _accessor$get$getCurr === void 0 ? void 0 : _accessor$get$getCurr.getUnitId();
+	const _unitId = unitId ?? ((_accessor$get$getCurr = accessor.get(IUniverInstanceService).getCurrentUnitOfType(UniverInstanceType.UNIVER_DOC)) === null || _accessor$get$getCurr === void 0 ? void 0 : _accessor$get$getCurr.getUnitId());
 	if (!_unitId) return null;
 	const insertRange = consumeContentInsertRange(accessor, _unitId);
 	if (!insertRange) return null;
@@ -1835,15 +2123,14 @@ function isHeaderFooterSelection(range) {
 	return Boolean(range === null || range === void 0 ? void 0 : range.segmentId);
 }
 function normalizeTextRange(textRange) {
-	var _textRange$endOffset, _textRange$collapsed, _textRange$segmentId;
-	const endOffset = (_textRange$endOffset = textRange.endOffset) !== null && _textRange$endOffset !== void 0 ? _textRange$endOffset : textRange.startOffset;
+	const endOffset = textRange.endOffset ?? textRange.startOffset;
 	return {
 		...textRange,
 		endOffset,
-		collapsed: (_textRange$collapsed = textRange.collapsed) !== null && _textRange$collapsed !== void 0 ? _textRange$collapsed : textRange.startOffset === endOffset,
-		segmentId: (_textRange$segmentId = textRange.segmentId) !== null && _textRange$segmentId !== void 0 ? _textRange$segmentId : ""
+		collapsed: textRange.collapsed ?? textRange.startOffset === endOffset,
+		segmentId: textRange.segmentId ?? ""
 	};
 }
 
 //#endregion
-export { CreateHeaderFooterCommand, DOC_INTERCEPTOR_POINT, DeleteDocumentSectionBreakCommand, DeleteTextCommand, DocBlockMoveValidatorService, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateChangeManagerService, DocStateEmitService, EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY, HeaderFooterType, IDocStateChangeInterceptorService, InsertDocumentSectionBreakCommand, InsertTextCommand, RichTextEditingMutation, SetDocumentDefaultParagraphStyleCommand, SetSectionHeaderFooterLinkCommand, SetTextSelectionsOperation, UniverDocsPlugin, UpdateDocumentSectionCommand, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, buildDocTransform, consumeContentInsertRange, createDocsCustomBlockDrawing, createDocsCustomBlockInsertMutation, createDocsCustomBlockRemoveMutation, createEmbedDocsCustomBlockData, createInsertCustomBlockActions, createRemoveCustomBlockActions, createSectionColumnProperties, deleteCustomRangeFactory, docDrawingPositionToTransform, generateParagraphs, getContentInsertRange, 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, 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 };