@univerjs/docs 1.0.0-alpha.2 → 1.0.0-alpha.3

package/lib/es/index.js

@@ -1,4 +1,4 @@
-import { BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DeleteDirection, Disposable, DisposableCollection, DocumentFlavor, ICommandService, IConfigService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, LocaleService, Optional, Plugin, RedoCommandId, RxDisposable, TextX, TextXActionType, UndoCommandId, UniverInstanceType, composeInterceptors, createIdentifier, createInterceptorKey, createParagraphId, generateRandomId, getRichTextEditPath, isInternalEditorID, merge, remove, toDisposable } from "@univerjs/core";
+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 { DocumentSkeleton, DocumentViewModel, IRenderManagerService, NORMAL_TEXT_SELECTION_PLUGIN_STYLE } from "@univerjs/engine-render";
 import { BehaviorSubject, Subject, takeUntil } from "rxjs";
 
@@ -315,6 +315,27 @@ var DocStateEmitService = class extends RxDisposable {
 //#endregion
 //#region src/commands/mutations/core-editing.mutation.ts
 const RichTextEditingMutationId = "doc.mutation.rich-text-editing";
+function getSegmentType(documentDataModel, segmentId) {
+	if (!segmentId) return "body";
+	const { headers, footers } = documentDataModel.getSnapshot();
+	if (headers === null || headers === void 0 ? void 0 : headers[segmentId]) return "header";
+	if (footers === null || footers === void 0 ? void 0 : footers[segmentId]) return "footer";
+	return "body";
+}
+function assertValidDocBodyStructure(documentDataModel, segmentId) {
+	const segmentModel = documentDataModel.getSelfOrHeaderFooterModel(segmentId);
+	const body = segmentModel === null || segmentModel === void 0 ? void 0 : segmentModel.getBody();
+	if (!body) return;
+	const segmentType = getSegmentType(documentDataModel, segmentId);
+	const issues = validateDocBodyStructure(body, {
+		segmentType,
+		segmentId: segmentId || void 0
+	});
+	if (!issues.length) return;
+	const detail = issues.map((issue) => `${issue.code}${issue.index == null ? "" : `@${issue.index}`}`).join(", ");
+	const segmentLabel = segmentId ? `${segmentType} ${segmentId}` : segmentType;
+	throw new Error(`[DocStructure] ${segmentLabel}: ${detail}`);
+}
 /**
 * The core mutator to change rich text actions. The execution result would be undo mutation params. Could be directly
 * send to undo redo service (will be used by the triggering command).
@@ -342,6 +363,12 @@ const RichTextEditingMutation = {
 		};
 		const undoActions = JSONX.invertWithDoc(actions, documentDataModel.getSnapshot());
 		documentDataModel.apply(actions);
+		try {
+			assertValidDocBodyStructure(documentDataModel, segmentId);
+		} catch (error) {
+			documentDataModel.apply(undoActions);
+			throw error;
+		}
 		documentViewModel === null || documentViewModel === void 0 || documentViewModel.reset(documentDataModel);
 		if (!noNeedSetTextRange && textRanges && trigger != null && !isSync) queueMicrotask(() => {
 			docSelectionManagerService.replaceDocRanges(textRanges, {
@@ -386,14 +413,16 @@ const InsertTextCommand = {
 	id: "doc.command.insert-text",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _docDataModel$getSelf, _activeRange$segmentI;
+		var _ref, _ref2, _docDataModel$getSelf;
 		const commandService = accessor.get(ICommandService);
 		const { range, segmentId, body, unitId, cursorOffset } = params;
 		const docSelectionManagerService = accessor.get(DocSelectionManagerService);
 		const docDataModel = accessor.get(IUniverInstanceService).getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (docDataModel == null) return false;
 		const activeRange = docSelectionManagerService.getActiveTextRange();
-		const originBody = (_docDataModel$getSelf = docDataModel.getSelfOrHeaderFooterModel((_activeRange$segmentI = activeRange === null || activeRange === void 0 ? void 0 : activeRange.segmentId) !== null && _activeRange$segmentI !== void 0 ? _activeRange$segmentI : "")) === null || _docDataModel$getSelf === void 0 ? void 0 : _docDataModel$getSelf.getBody();
+		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 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;
@@ -476,14 +505,12 @@ const DeleteTextCommand = {
 		};
 		const textX = new TextX();
 		const jsonX = JSONX.getInstance();
-		textX.push({
-			t: TextXActionType.RETAIN,
-			len: start - 0
-		});
-		textX.push({
-			t: TextXActionType.DELETE,
-			len: end - start + 1
-		});
+		textX.push(...BuildTextUtils.selection.delete([{
+			...range,
+			startOffset: start,
+			endOffset: end + 1,
+			collapsed: false
+		}], body));
 		const path = getRichTextEditPath(docDataModel, segmentId);
 		doMutation.params.actions = jsonX.editOp(textX.serialize(), path);
 		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
@@ -558,10 +585,13 @@ function getEmptyHeaderFooterBody() {
 				spaceBelow: { v: 0 }
 			}
 		}],
-		sectionBreaks: [{ startIndex: 1 }]
+		sectionBreaks: [{
+			sectionId: createSectionId(/* @__PURE__ */ new Set()),
+			startIndex: 1
+		}]
 	};
 }
-function createHeaderFooterAction(segmentId, createType, documentStyle, actions, createMode = "single") {
+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);
@@ -610,11 +640,11 @@ function createHeaderFooterAction(segmentId, createType, documentStyle, actions,
 		actions.push(insertPairAction);
 		linkedSegmentIds.push([pairKey, secondSegmentId]);
 	}
-	for (const [k, id] of linkedSegmentIds) if (documentStyle[k] != null) {
-		const replaceAction = jsonX.replaceOp(["documentStyle", k], documentStyle[k], id);
+	for (const [k, id] of linkedSegmentIds) if (headerFooterConfig[k] != null) {
+		const replaceAction = jsonX.replaceOp([...configPath, k], headerFooterConfig[k], id);
 		actions.push(replaceAction);
 	} else {
-		const insertAction = jsonX.insertOp(["documentStyle", k], id);
+		const insertAction = jsonX.insertOp([...configPath, k], id);
 		actions.push(insertAction);
 	}
 	return actions;
@@ -623,21 +653,31 @@ const CreateHeaderFooterCommand = {
 	id: "doc.command.create-header-footer",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
+		var _body$sectionBreaks$f, _body$sectionBreaks, _body$sectionBreaks2;
 		const commandService = accessor.get(ICommandService);
 		const univerInstanceService = accessor.get(IUniverInstanceService);
-		const { unitId, segmentId, createType, headerFooterProps, createMode = "single" } = params;
+		const { unitId, segmentId, createType, headerFooterProps, createMode = "single", sectionId } = params;
 		const docDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (docDataModel == null) return false;
-		const { documentStyle } = docDataModel.getSnapshot();
+		const { documentStyle, body } = docDataModel.getSnapshot();
 		if (documentStyle.documentFlavor === DocumentFlavor.MODERN) return false;
 		const rawActions = [];
 		const jsonX = JSONX.getInstance();
-		if (createType != null) createHeaderFooterAction(segmentId, createType, documentStyle, rawActions, createMode);
+		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 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 configPath = sectionId == null ? ["documentStyle"] : [
+			"body",
+			"sectionBreaks",
+			sectionIndex
+		];
+		if (createType != null) createHeaderFooterAction(segmentId, createType, headerFooterConfig, rawActions, createMode, configPath);
 		if (headerFooterProps != null) Object.keys(headerFooterProps).forEach((key) => {
 			const value = headerFooterProps[key];
-			const oldValue = documentStyle[key];
+			const oldValue = headerFooterConfig[key];
 			if (value === oldValue) return;
-			const action = oldValue === void 0 ? jsonX.insertOp(["documentStyle", key], value) : jsonX.replaceOp(["documentStyle", key], oldValue, value);
+			const action = oldValue === void 0 ? jsonX.insertOp([...configPath, key], value) : jsonX.replaceOp([...configPath, key], oldValue, value);
 			rawActions.push(action);
 		});
 		if (rawActions.length === 0) return false;
@@ -660,10 +700,457 @@ const CreateHeaderFooterCommand = {
 	}
 };
 
+//#endregion
+//#region src/commands/commands/set-document-default-paragraph-style.command.ts
+const SetDocumentDefaultParagraphStyleCommand = {
+	id: "doc.command.set-default-paragraph-style",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		if (params == null) return false;
+		const commandService = accessor.get(ICommandService);
+		const documentDataModel = accessor.get(IUniverInstanceService).getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
+		if (documentDataModel == null) return false;
+		const oldStyle = documentDataModel.getSnapshot().documentStyle.defaultParagraphStyle;
+		const jsonX = JSONX.getInstance();
+		const path = ["documentStyle", "defaultParagraphStyle"];
+		const rawActions = [];
+		if (params.defaultParagraphStyle == null) {
+			if (oldStyle != null) rawActions.push(jsonX.removeOp(path, oldStyle));
+		} else if (oldStyle == null) {
+			const newStyle = Object.fromEntries(Object.entries(params.defaultParagraphStyle).filter(([, value]) => value != null).map(([key, value]) => [key, Tools.deepClone(value)]));
+			if (Object.keys(newStyle).length > 0) rawActions.push(jsonX.insertOp(path, newStyle));
+		} else Object.entries(params.defaultParagraphStyle).forEach(([key, value]) => {
+			const oldValue = oldStyle[key];
+			const propertyPath = [...path, key];
+			if (value == null) {
+				if (oldValue != null) rawActions.push(jsonX.removeOp(propertyPath, oldValue));
+			} else if (oldValue == null) rawActions.push(jsonX.insertOp(propertyPath, Tools.deepClone(value)));
+			else rawActions.push(jsonX.replaceOp(propertyPath, oldValue, Tools.deepClone(value)));
+		});
+		const actions = rawActions.reduce((acc, action) => JSONX.compose(acc, action), null);
+		if (rawActions.length === 0 || JSONX.isNoop(actions)) return false;
+		const mutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId: params.unitId,
+				actions,
+				textRanges: null,
+				noNeedSetTextRange: true,
+				debounce: true,
+				isEditing: false
+			}
+		};
+		return Boolean(commandService.syncExecuteCommand(mutation.id, mutation.params));
+	}
+};
+
+//#endregion
+//#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 result = [];
+	let tableCellDepth = 0;
+	let columnDepth = 0;
+	for (let index = 0; index < body.dataStream.length; index++) {
+		const token = body.dataStream[index];
+		if (token === DataStreamTreeTokenType.TABLE_CELL_START) tableCellDepth++;
+		else if (token === DataStreamTreeTokenType.TABLE_CELL_END) tableCellDepth = Math.max(0, tableCellDepth - 1);
+		else if (token === DataStreamTreeTokenType.COLUMN_START) columnDepth++;
+		else if (token === DataStreamTreeTokenType.COLUMN_END) columnDepth = Math.max(0, columnDepth - 1);
+		else if (token === DataStreamTreeTokenType.SECTION_BREAK && tableCellDepth === 0 && columnDepth === 0) {
+			const sectionBreak = sectionBreakByIndex.get(index);
+			if (sectionBreak) result.push(sectionBreak);
+		}
+	}
+	return result;
+}
+
+//#endregion
+//#region src/commands/commands/set-section-header-footer-link.command.ts
+const SetSectionHeaderFooterLinkCommand = {
+	id: "doc.command.set-section-header-footer-link",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		var _snapshot$body$sectio, _snapshot$body$sectio2;
+		if (!params) return false;
+		const instanceService = accessor.get(IUniverInstanceService);
+		const commandService = accessor.get(ICommandService);
+		const documentDataModel = instanceService.getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
+		const snapshot = documentDataModel === null || documentDataModel === void 0 ? void 0 : documentDataModel.getSnapshot();
+		if (!documentDataModel || !(snapshot === null || snapshot === void 0 ? void 0 : snapshot.body) || snapshot.documentStyle.documentFlavor !== DocumentFlavor.TRADITIONAL) return false;
+		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;
+		if (storageIndex < 0) return false;
+		const context = {
+			snapshot,
+			sections,
+			sectionIndex,
+			storageIndex,
+			key: getSectionHeaderFooterReferenceKey(params.kind, params.variant)
+		};
+		const rawActions = params.linkedToPrevious ? buildLinkActions(context, params.kind) : buildUnlinkActions(context, params.kind, params.segmentId);
+		if (!rawActions) return false;
+		const mutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId: params.unitId,
+				actions: rawActions.reduce((actions, action) => JSONX.compose(actions, action), null),
+				textRanges: null,
+				noNeedSetTextRange: true,
+				debounce: true,
+				isEditing: false,
+				trigger: SetSectionHeaderFooterLinkCommand.id
+			}
+		};
+		return Boolean(commandService.syncExecuteCommand(mutation.id, mutation.params));
+	}
+};
+function buildLinkActions(context, kind) {
+	const { snapshot, sections, sectionIndex, storageIndex, key } = context;
+	const section = sections[sectionIndex];
+	const explicitSegmentId = section[key];
+	if (typeof explicitSegmentId !== "string" || !explicitSegmentId) return null;
+	const jsonX = JSONX.getInstance();
+	const actions = [jsonX.removeOp([
+		"body",
+		"sectionBreaks",
+		storageIndex,
+		key
+	], explicitSegmentId)];
+	const referenceKeys = kind === "header" ? [
+		"defaultHeaderId",
+		"firstPageHeaderId",
+		"evenPageHeaderId"
+	] : [
+		"defaultFooterId",
+		"firstPageFooterId",
+		"evenPageFooterId"
+	];
+	const referencedByDocument = referenceKeys.some((referenceKey) => snapshot.documentStyle[referenceKey] === explicitSegmentId);
+	const referencedBySection = sections.some((item) => referenceKeys.some((referenceKey) => !(item.sectionId === section.sectionId && referenceKey === key) && item[referenceKey] === explicitSegmentId));
+	const resources = kind === "header" ? snapshot.headers : snapshot.footers;
+	if (!referencedByDocument && !referencedBySection && (resources === null || resources === void 0 ? void 0 : resources[explicitSegmentId])) actions.push(jsonX.removeOp([kind === "header" ? "headers" : "footers", explicitSegmentId], resources[explicitSegmentId]));
+	return actions;
+}
+function buildUnlinkActions(context, kind, requestedSegmentId) {
+	const { snapshot, sections, sectionIndex, storageIndex, key } = context;
+	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 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;
+	const idKey = kind === "header" ? "headerId" : "footerId";
+	const resource = source ? {
+		...Tools.deepClone(source),
+		[idKey]: segmentId
+	} : {
+		[idKey]: segmentId,
+		body: getEmptyHeaderFooterBody()
+	};
+	const jsonX = JSONX.getInstance();
+	return [jsonX.insertOp([kind === "header" ? "headers" : "footers", segmentId], resource), jsonX.insertOp([
+		"body",
+		"sectionBreaks",
+		storageIndex,
+		key
+	], segmentId)];
+}
+
+//#endregion
+//#region src/commands/commands/update-document-section.command.ts
+const UpdateDocumentSectionCommand = {
+	id: "doc.command.update-section",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		if (!(params === null || params === void 0 ? void 0 : params.updates.length) || params.updates.some(({ sectionId, config }) => !sectionId || Object.keys(config).length === 0)) return false;
+		const instanceService = accessor.get(IUniverInstanceService);
+		const commandService = accessor.get(ICommandService);
+		const documentDataModel = instanceService.getUnit(params.unitId, UniverInstanceType.UNIVER_DOC);
+		if (!documentDataModel || documentDataModel.getDocumentStyle().documentFlavor !== DocumentFlavor.TRADITIONAL) return false;
+		const body = documentDataModel.getBody();
+		if (!body) return false;
+		const updates = new Map(params.updates.map(({ sectionId, config }) => [sectionId, config]));
+		if (updates.size !== params.updates.length) return false;
+		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 cursor = new MemoryCursor();
+		const textX = new TextX();
+		for (const section of sections) {
+			textX.push({
+				t: TextXActionType.RETAIN,
+				len: section.startIndex - cursor.cursor
+			});
+			textX.push({
+				t: TextXActionType.RETAIN,
+				len: 1,
+				coverType: UpdateDocsAttributeType.REPLACE,
+				body: {
+					dataStream: "",
+					sectionBreaks: [{
+						...Tools.deepClone(section),
+						...Tools.deepClone(updates.get(section.sectionId)),
+						sectionId: section.sectionId,
+						startIndex: 0
+					}]
+				}
+			});
+			cursor.moveCursorTo(section.startIndex + 1);
+		}
+		const jsonX = JSONX.getInstance();
+		const mutation = {
+			id: RichTextEditingMutation.id,
+			params: {
+				unitId: params.unitId,
+				actions: jsonX.editOp(textX.serialize(), getRichTextEditPath(documentDataModel)),
+				textRanges: null,
+				noNeedSetTextRange: true,
+				debounce: true,
+				isEditing: false,
+				trigger: UpdateDocumentSectionCommand.id
+			}
+		};
+		return Boolean(commandService.syncExecuteCommand(mutation.id, mutation.params));
+	}
+};
+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;
+		if (!params) return false;
+		const context = getTraditionalDocumentContext(accessor, params.unitId);
+		if (!context || !params.sectionId || !Number.isInteger(params.offset)) 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 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,
+				startIndex: 0
+			}]
+		});
+		return executeSectionTextX(commandService, documentDataModel, textX, InsertDocumentSectionBreakCommand.id);
+	}
+};
+const DeleteDocumentSectionBreakCommand = {
+	id: "doc.command.delete-section-break",
+	type: CommandType.COMMAND,
+	handler: (accessor, params) => {
+		if (!params) return false;
+		const context = getTraditionalDocumentContext(accessor, params.unitId);
+		if (!context || !params.sectionId) return false;
+		const sections = getTopLevelSectionBreaks(context.body);
+		if (sections.length <= 1) return false;
+		const section = sections.find((item) => item.sectionId === params.sectionId);
+		if (!section) return false;
+		const textX = new TextX();
+		textX.retain(section.startIndex);
+		textX.delete(1);
+		return executeSectionTextX(context.commandService, context.documentDataModel, textX, DeleteDocumentSectionBreakCommand.id);
+	}
+};
+function getTraditionalDocumentContext(accessor, unitId) {
+	if (!unitId) return null;
+	const documentDataModel = accessor.get(IUniverInstanceService).getUnit(unitId, UniverInstanceType.UNIVER_DOC);
+	const body = documentDataModel === null || documentDataModel === void 0 ? void 0 : documentDataModel.getBody();
+	if (!documentDataModel || !body || documentDataModel.getDocumentStyle().documentFlavor !== DocumentFlavor.TRADITIONAL) return null;
+	return {
+		body,
+		documentDataModel,
+		commandService: accessor.get(ICommandService)
+	};
+}
+function executeSectionTextX(commandService, documentDataModel, textX, trigger) {
+	const actions = JSONX.getInstance().editOp(textX.serialize(), getRichTextEditPath(documentDataModel));
+	return Boolean(commandService.syncExecuteCommand(RichTextEditingMutation.id, {
+		unitId: documentDataModel.getUnitId(),
+		actions,
+		textRanges: null,
+		noNeedSetTextRange: true,
+		debounce: true,
+		isEditing: false,
+		trigger
+	}));
+}
+
+//#endregion
+//#region src/embed-host-anchor.ts
+const EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY = "UniverEmbedDocsCustomBlock";
+const DEFAULT_CUSTOM_BLOCK_SIZE = {
+	width: 720,
+	height: 360
+};
+const SHEET_LIKE_CUSTOM_BLOCK_SIZE = {
+	width: 960,
+	height: 480
+};
+const SLIDE_CUSTOM_BLOCK_SIZE = {
+	width: 720,
+	height: 405
+};
+function createDocsCustomBlockInsertMutation(params) {
+	return createRichTextMutation(params.unitId, params.segmentId, createInsertCustomBlockActions(params));
+}
+function createDocsCustomBlockRemoveMutation(params) {
+	return createRichTextMutation(params.unitId, params.segmentId, createRemoveCustomBlockActions(params));
+}
+function createInsertCustomBlockActions(params) {
+	const textX = new TextX();
+	if (params.startIndex > 0) textX.push({
+		t: TextXActionType.RETAIN,
+		len: params.startIndex
+	});
+	textX.push({
+		t: TextXActionType.INSERT,
+		body: {
+			dataStream: "\b",
+			customBlocks: [{
+				startIndex: 0,
+				blockId: params.blockId
+			}]
+		},
+		len: 1
+	});
+	return composeActions([toBodyEditActions(textX, params.segmentId), createDrawingInsertActions(params)]);
+}
+function createRemoveCustomBlockActions(params) {
+	const textX = new TextX();
+	if (params.startIndex > 0) textX.push({
+		t: TextXActionType.RETAIN,
+		len: params.startIndex
+	});
+	textX.push({
+		t: TextXActionType.DELETE,
+		len: 1
+	});
+	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 {
+		unitId: params.unitId,
+		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,
+		data: createEmbedDocsCustomBlockData(params),
+		title: params.blockId,
+		description: "Univer embedded unit custom block",
+		layoutType: isInline ? PositionedObjectLayoutType.INLINE : PositionedObjectLayoutType.WRAP_TOP_AND_BOTTOM,
+		allowTransform: false,
+		docTransform: {
+			size: {
+				width: size.width,
+				height: size.height
+			},
+			positionH: {
+				relativeFrom: isInline ? ObjectRelativeFromH.PAGE : ObjectRelativeFromH.COLUMN,
+				...isInline ? { posOffset: 0 } : { align: AlignTypeH.LEFT }
+			},
+			positionV: {
+				relativeFrom: isInline ? ObjectRelativeFromV.PAGE : ObjectRelativeFromV.PARAGRAPH,
+				posOffset: 0
+			},
+			angle: 0
+		},
+		transform: {
+			left: 0,
+			top: 0,
+			width: size.width,
+			height: size.height
+		}
+	};
+}
+function resolveDocsCustomBlockSize(childType) {
+	if (childType === UniverInstanceType.UNIVER_SHEET || childType === UniverInstanceType.UNIVER_BASE) return SHEET_LIKE_CUSTOM_BLOCK_SIZE;
+	if (childType === UniverInstanceType.UNIVER_SLIDE) return SLIDE_CUSTOM_BLOCK_SIZE;
+	return DEFAULT_CUSTOM_BLOCK_SIZE;
+}
+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,
+		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"
+	};
+}
+function isEmbedDocsCustomBlockData(data) {
+	if (!data || typeof data !== "object") return false;
+	const candidate = data;
+	return candidate.version === 1 && typeof candidate.embedId === "string" && typeof candidate.hostAnchorId === "string";
+}
+function shouldUseInlineTextSelectionForDocsCustomBlockDrawing(drawing) {
+	const data = drawing && typeof drawing === "object" ? drawing.data : void 0;
+	if (!isEmbedDocsCustomBlockData(data)) return true;
+	return data.interactionMode === "inline";
+}
+function createRichTextMutation(unitId, segmentId, actions) {
+	return {
+		id: RichTextEditingMutation.id,
+		params: {
+			unitId,
+			segmentId,
+			actions,
+			textRanges: [],
+			isEditing: false,
+			noNeedSetTextRange: true
+		}
+	};
+}
+function toBodyEditActions(textX, segmentId) {
+	const action = JSONX.getInstance().editOp(textX.serialize(), segmentId ? [
+		"headers",
+		segmentId,
+		"body"
+	] : ["body"]);
+	return action !== null && action !== void 0 ? action : [];
+}
+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 : []]);
+}
+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 : []]);
+}
+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 : [];
+	}, []);
+}
+
 //#endregion
 //#region package.json
 var name = "@univerjs/docs";
-var version = "1.0.0-alpha.2";
+var version = "1.0.0-alpha.3";
 
 //#endregion
 //#region src/commands/mutations/docs-rename.mutation.ts
@@ -986,6 +1473,11 @@ let UniverDocsPlugin = class UniverDocsPlugin extends Plugin {
 			DeleteTextCommand,
 			UpdateTextCommand,
 			CreateHeaderFooterCommand,
+			SetDocumentDefaultParagraphStyleCommand,
+			SetSectionHeaderFooterLinkCommand,
+			UpdateDocumentSectionCommand,
+			InsertDocumentSectionBreakCommand,
+			DeleteDocumentSectionBreakCommand,
 			RichTextEditingMutation,
 			DocsRenameMutation,
 			SetTextSelectionsOperation
@@ -1181,6 +1673,35 @@ function deleteCustomRangeFactory(accessor, params) {
 	return doMutation;
 }
 
+//#endregion
+//#region src/utils/paragraphs.ts
+/** Builds paragraph metadata for inserted paragraph tokens, including horizontal-rule borders. */
+function generateParagraphs(dataStream, prevParagraph, borderBottom, existingParagraphIds = []) {
+	const paragraphs = [];
+	const existingIds = new Set(existingParagraphIds);
+	for (let i = 0, len = dataStream.length; i < len; i++) {
+		if (dataStream[i] !== DataStreamTreeTokenType.PARAGRAPH) continue;
+		paragraphs.push({
+			startIndex: i,
+			paragraphId: createParagraphId(existingIds)
+		});
+	}
+	for (const paragraph of paragraphs) {
+		if (prevParagraph === null || prevParagraph === void 0 ? void 0 : prevParagraph.bullet) paragraph.bullet = Tools.deepClone(prevParagraph.bullet);
+		if (prevParagraph === null || prevParagraph === void 0 ? void 0 : prevParagraph.paragraphStyle) {
+			paragraph.paragraphStyle = Tools.deepClone(prevParagraph.paragraphStyle);
+			delete paragraph.paragraphStyle.borderBottom;
+			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.borderBottom = Tools.deepClone(borderBottom);
+		}
+	}
+	return paragraphs;
+}
+
 //#endregion
 //#region src/utils/replace-selection-factory.ts
 function replaceSelectionFactory(accessor, params) {
@@ -1223,6 +1744,22 @@ 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/util.ts
 function consumeContentInsertRange(accessor, unitId) {
@@ -1237,4 +1774,4 @@ function isHeaderFooterSelection(range) {
 }
 
 //#endregion
-export { CreateHeaderFooterCommand, DOC_INTERCEPTOR_POINT, DeleteTextCommand, DocBlockMoveValidatorService, DocContentInsertService, DocInterceptorService, DocSelectionManagerService, DocSkeletonManagerService, DocStateChangeManagerService, DocStateEmitService, HeaderFooterType, IDocStateChangeInterceptorService, InsertTextCommand, RichTextEditingMutation, SetTextSelectionsOperation, UniverDocsPlugin, UpdateTextCommand, addCustomRangeBySelectionFactory, addCustomRangeFactory, consumeContentInsertRange, deleteCustomRangeFactory, isHeaderFooterSelection, replaceSelectionFactory };
+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, consumeContentInsertRange, createDocsCustomBlockDrawing, createDocsCustomBlockInsertMutation, createDocsCustomBlockRemoveMutation, createEmbedDocsCustomBlockData, createInsertCustomBlockActions, createRemoveCustomBlockActions, createSectionColumnProperties, deleteCustomRangeFactory, generateParagraphs, getTopLevelSectionBreaks, isEmbedDocsCustomBlockData, isHeaderFooterSelection, isSheetLikeDocsCustomBlockChildType, replaceSelectionFactory, resolveDocsCustomBlockSize, shouldUseInlineTextSelectionForDocsCustomBlockDrawing };