@univerjs/docs 1.0.0-alpha.7 → 1.0.0-alpha.8

package/lib/es/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();
@@ -133,16 +138,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 +150,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 +200,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) {
@@ -862,6 +852,178 @@ 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) {
+	var _body$paragraphs;
+	const matches = ((_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _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) {
+	var _paragraph$paragraphS;
+	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$paragraphS = paragraph.paragraphStyle) !== null && _paragraph$paragraphS !== void 0 ? _paragraph$paragraphS : {}),
+				...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 _params$segmentId, _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 = params.segmentId) !== null && _params$segmentId !== void 0 ? _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) {
+	var _ref;
+	return (_ref = sectionValue !== null && sectionValue !== void 0 ? sectionValue : documentValue) !== null && _ref !== void 0 ? _ref : 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) {
+	var _section$pageNumberSt;
+	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$pageNumberSt = section === null || section === void 0 ? void 0 : section.pageNumberStart) !== null && _section$pageNumberSt !== void 0 ? _section$pageNumberSt : 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 !== 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/commands/commands/update-document-section.command.ts
 const UpdateDocumentSectionCommand = {
@@ -880,6 +1042,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 +1090,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 _params$config, _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 = params.config) !== null && _params$config !== void 0 ? _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 +1164,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.at(-1)) return false;
 		const textX = new TextX();
 		textX.retain(section.startIndex);
 		textX.delete(1);
@@ -970,6 +1182,39 @@ 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) {
+	var _section$pageSize, _ref, _section$marginTop, _ref2, _section$marginBottom, _ref3, _section$marginLeft, _ref4, _section$marginRight, _section$columnProper;
+	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 = section.pageSize) !== null && _section$pageSize !== void 0 ? _section$pageSize : documentStyle.pageSize;
+	const marginTop = (_ref = (_section$marginTop = section.marginTop) !== null && _section$marginTop !== void 0 ? _section$marginTop : documentStyle.marginTop) !== null && _ref !== void 0 ? _ref : 0;
+	const marginBottom = (_ref2 = (_section$marginBottom = section.marginBottom) !== null && _section$marginBottom !== void 0 ? _section$marginBottom : documentStyle.marginBottom) !== null && _ref2 !== void 0 ? _ref2 : 0;
+	const marginLeft = (_ref3 = (_section$marginLeft = section.marginLeft) !== null && _section$marginLeft !== void 0 ? _section$marginLeft : documentStyle.marginLeft) !== null && _ref3 !== void 0 ? _ref3 : 0;
+	const marginRight = (_ref4 = (_section$marginRight = section.marginRight) !== null && _section$marginRight !== void 0 ? _section$marginRight : documentStyle.marginRight) !== null && _ref4 !== void 0 ? _ref4 : 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$columnProper = section.columnProperties) !== null && _section$columnProper !== void 0 ? _section$columnProper : [];
+	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, {
@@ -1150,7 +1395,7 @@ function composeActions(actions) {
 //#endregion
 //#region package.json
 var name = "@univerjs/docs";
-var version = "1.0.0-alpha.7";
+var version = "1.0.0-alpha.8";
 
 //#endregion
 //#region src/commands/mutations/docs-rename.mutation.ts
@@ -1228,7 +1473,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);
 			}
 		}));
 	}
@@ -1452,6 +1697,82 @@ 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) {
+				var _replacement$replacea;
+				characters.push({
+					startOffset: replacement.startOffset,
+					endOffset: replacement.endOffset,
+					replaceable: (_replacement$replacea = replacement.replaceable) !== null && _replacement$replacea !== void 0 ? _replacement$replacea : 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 +1796,10 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			CreateHeaderFooterCommand,
 			SetDocumentDefaultParagraphStyleCommand,
 			SetSectionHeaderFooterLinkCommand,
+			UpdateDocumentParagraphStyleCommand,
 			UpdateDocumentSectionCommand,
 			InsertDocumentSectionBreakCommand,
+			InsertDocumentColumnBreakCommand,
 			DeleteDocumentSectionBreakCommand,
 			RichTextEditingMutation,
 			DocsRenameMutation,
@@ -1492,6 +1815,7 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			[DocStateChangeManagerService],
 			[DocBlockMoveValidatorService],
 			[DocContentInsertService],
+			[DocTextResolverService],
 			[DocCustomRangeController]
 		].forEach((d) => this._injector.add(d));
 	}
@@ -1745,22 +2069,6 @@ 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) {
@@ -1846,4 +2154,4 @@ function normalizeTextRange(textRange) {
 }
 
 //#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 };