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

package/lib/locale/zh-TW.js

@@ -14,23 +14,30 @@ const locale = { "docs-ui": {
 		textColor: { main: "文字顏色" },
 		fillColor: { main: "文字背景色" },
 		table: {
-			main: "Table",
-			insert: "Insert Table",
-			colCount: "Column count",
-			rowCount: "Row count"
+			main: "表格",
+			insert: "插入表格",
+			colCount: "欄數",
+			rowCount: "列數"
 		},
 		resetColor: "重置顏色",
 		order: "有序列表",
 		unorder: "無序列表",
 		checklist: "任務列表",
-		documentFlavor: "现代模式",
+		documentFlavor: "現代模式",
 		alignLeft: "左對齊",
 		alignCenter: "居中對齊",
 		alignRight: "右對齊",
 		alignJustify: "兩端對齊",
-		horizontalLine: "Horizontal line",
+		horizontalLine: "水平線",
 		headerFooter: "頁眉頁腳",
 		pageSetup: "頁面設置",
+		breaks: "分隔符",
+		columnBreak: "分欄符",
+		sectionBreakNextPage: "分節符（下一頁）",
+		sectionBreakContinuous: "分節符（連續）",
+		sectionBreakNextColumn: "分節符（下一欄）",
+		sectionBreakEvenPage: "分節符（偶數頁）",
+		sectionBreakOddPage: "分節符（奇數頁）",
 		heading: {
 			tooltip: "標題",
 			normal: "普通文字",
@@ -78,42 +85,48 @@ const locale = { "docs-ui": {
 	doc: {
 		blockMenu: { dragBlock: "拖曳區塊" },
 		menu: {
-			paragraphSetting: "Paragraph Setting",
-			sectionSetting: "Section Settings"
+			paragraphSetting: "段落設定",
+			sectionSetting: "節設定"
 		},
 		slider: {
-			paragraphSetting: "Paragraph Setting",
-			sectionSetting: "Section Settings"
+			paragraphSetting: "段落設定",
+			sectionSetting: "節設定"
 		},
 		paragraphSetting: {
-			alignment: "Alignment",
-			indentation: "Indentation",
-			left: "Left",
-			right: "Right",
-			firstLine: "First Line",
-			hanging: "Hanging",
-			spacing: "Spacing",
-			before: "Before",
-			after: "After",
-			lineSpace: "Line Space",
-			multiSpace: "Multi Space",
-			atLeast: "At Least (px)",
-			exactly: "Exactly (px)",
-			fixedValue: "Fixed Value(px)"
+			alignment: "對齊方式",
+			indentation: "縮排",
+			left: "左",
+			right: "右",
+			firstLine: "第一行",
+			hanging: "凸排",
+			spacing: "間距",
+			before: "段前",
+			after: "段後",
+			lineSpace: "行距",
+			multiSpace: "多倍行距",
+			atLeast: "至少 (px)",
+			exactly: "固定值 (px)",
+			fixedValue: "固定值 (px)"
 		},
 		sectionSetting: {
-			selectedSections: "{0} sections selected",
-			columnCount: "Column count",
-			columnGap: "Column gap",
-			columnSeparator: "Separator",
-			none: "None",
-			betweenColumns: "Between columns",
-			sectionStart: "Section start",
-			unspecified: "Unspecified",
-			continuous: "Continuous",
-			nextPage: "Next page",
-			evenPage: "Even page",
-			oddPage: "Odd page"
+			selectedSections: "已選取 {0} 個節",
+			multipleValues: "多個值",
+			columnCount: "欄數",
+			columnGap: "欄間距",
+			columnSeparator: "分隔線",
+			none: "無",
+			betweenColumns: "欄之間",
+			sectionStart: "節起始位置",
+			unspecified: "未指定",
+			continuous: "接續本頁",
+			nextColumn: "下一欄",
+			nextPage: "下一頁",
+			evenPage: "偶數頁",
+			oddPage: "奇數頁",
+			pageSetup: "頁面設定",
+			pageWidth: "頁面寬度",
+			pageHeight: "頁面高度",
+			pageNumberStart: "起始頁碼"
 		}
 	},
 	rightClick: {
@@ -139,7 +152,7 @@ const locale = { "docs-ui": {
 		noBackground: "無背景色"
 	},
 	"page-settings": {
-		"document-setting": "文檔設置",
+		"document-setting": "文件設定",
 		mode: "模式",
 		"modern-mode": "現代模式",
 		"classic-mode": "經典模式",

package/lib/types/basics/component-tools.d.ts

@@ -13,20 +13,18 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { DocumentDataModel, IUniverInstanceService, Nullable } from '@univerjs/core';
-import type { DocBackground, Documents, Engine, IRenderContext, IRenderManagerService, Scene } from '@univerjs/engine-render';
+import type { DocumentDataModel, Nullable } from '@univerjs/core';
+import type { DocBackground, Documents, Engine, IRender, IRenderContext, IRenderManagerService, Scene } from '@univerjs/engine-render';
 export interface IDocObjectParam {
     document: Documents;
     docBackground: DocBackground;
     scene: Scene;
     engine: Engine;
 }
-export declare function neoGetDocObject(renderContext: IRenderContext<DocumentDataModel>): {
+export declare function neoGetDocObject(renderContext: IRender | IRenderContext<DocumentDataModel>): {
     document: Documents;
     docBackground: DocBackground;
     scene: Scene;
     engine: Engine;
 };
-/** @deprecated After migrating to `RenderUnit`, use `neoGetDocObject` instead. */
-export declare function getDocObject(univerInstanceService: IUniverInstanceService, renderManagerService: IRenderManagerService): Nullable<IDocObjectParam>;
 export declare function getDocObjectById(unitId: string, renderManagerService: IRenderManagerService): Nullable<IDocObjectParam>;

package/lib/types/basics/doc-custom-range-chrome.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ThemeService } from '@univerjs/core';
+import type { UniverRenderingContext } from '@univerjs/engine-render';
+export declare const DOC_CUSTOM_RANGE_CHROME_RADIUS = 1;
+export declare const DOC_CUSTOM_RANGE_CHROME_BACKGROUND_ALPHA = 0.07;
+export interface IDocCustomRangeChromeRect {
+    bottom: number;
+    left: number;
+    right: number;
+    top: number;
+}
+export interface IDocCustomRangeChromeTheme {
+    background: string;
+    border: string;
+}
+export declare function resolveDocCustomRangeChromeTheme(themeService: ThemeService): IDocCustomRangeChromeTheme;
+export declare function drawDocCustomRangeChrome(ctx: Pick<UniverRenderingContext, 'beginPath' | 'fill' | 'fillStyle' | 'lineWidth' | 'restore' | 'roundRect' | 'save' | 'stroke' | 'strokeStyle'>, rect: IDocCustomRangeChromeRect, theme: IDocCustomRangeChromeTheme): void;

package/lib/types/commands/commands/break-line.command.d.ts

@@ -16,9 +16,13 @@
 import type { ICommand, IParagraphBorder, ITextRangeParam } from '@univerjs/core';
 import { generateParagraphs } from '@univerjs/docs';
 export { generateParagraphs };
+export declare enum BreakLineInsertionMode {
+    SplitParagraph = "split-paragraph",
+    InsertGap = "insert-gap"
+}
 interface IBreakLineCommandParams {
     horizontalLine?: IParagraphBorder;
-    insertionMode?: 'split-paragraph' | 'insert-gap';
+    insertionMode?: BreakLineInsertionMode;
     textRange?: ITextRangeParam;
 }
 export declare const BreakLineCommand: ICommand<IBreakLineCommandParams>;

package/lib/types/commands/commands/clipboard.inner.command.d.ts

@@ -15,10 +15,12 @@
  */
 import type { DocumentDataModel, ICommand, IDocumentData, ITextRange, JSONXActions, Nullable } from '@univerjs/core';
 import type { DocumentViewModel, IRectRangeWithStyle, ITextRangeWithStyle } from '@univerjs/engine-render';
+import type { IDocClipboardPasteCustomRangeMapping } from '../../services/clipboard/doc-paste-mutation-adapter.service';
 export interface IInnerPasteCommandParams {
     segmentId: string;
     doc: Partial<IDocumentData>;
     textRanges: ITextRangeWithStyle[];
+    customRangeMappings?: IDocClipboardPasteCustomRangeMapping[];
 }
 export declare const InnerPasteCommand: ICommand<IInnerPasteCommandParams>;
 export declare function getCutActionsFromDocRanges(textRanges: Readonly<Nullable<ITextRangeWithStyle[]>>, rectRanges: Readonly<Nullable<IRectRangeWithStyle[]>>, docDataModel: DocumentDataModel, viewModel: DocumentViewModel, segmentId: string): JSONXActions;

package/lib/types/commands/commands/doc-horizontal-line.command.d.ts

@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 import type { ICommand, ITextRangeParam } from '@univerjs/core';
+import { BreakLineInsertionMode } from './break-line.command';
 interface IHorizontalCommandParams {
-    insertionMode?: 'split-paragraph' | 'insert-gap';
+    insertionMode?: BreakLineInsertionMode;
     insertRange?: ITextRangeParam;
 }
 export declare const HorizontalLineCommand: ICommand<IHorizontalCommandParams>;

package/lib/types/commands/commands/replace-content.command.d.ts

@@ -26,19 +26,6 @@ export interface IReplaceSnapshotCommandParams {
 }
 export declare const ReplaceSnapshotCommand: ICommand<IReplaceSnapshotCommandParams>;
 export declare function buildReplaceSnapshotActions(previousSnapshot: IDocumentData, snapshot: IDocumentData): JSONXActions | null;
-interface IReplaceContentCommandParams {
-    unitId: string;
-    body: IDocumentBody;
-    textRanges: ITextRangeWithStyle[];
-    segmentId?: string;
-    options: {
-        [key: string]: boolean;
-    };
-}
-/**
- * @deprecated please use ReplaceSnapshotCommand instead.
- */
-export declare const ReplaceContentCommand: ICommand<IReplaceContentCommandParams>;
 interface ICoverContentCommandParams {
     unitId: string;
     body: IDocumentBody;
@@ -53,5 +40,14 @@ export interface IReplaceSelectionCommandParams {
     textRanges?: ITextRangeWithStyle[];
 }
 export declare const ReplaceSelectionCommand: ICommand<IReplaceSelectionCommandParams>;
-export declare const ReplaceTextRunsCommand: ICommand<IReplaceContentCommandParams>;
+interface IReplaceTextRunsCommandParams {
+    unitId: string;
+    body: IDocumentBody;
+    textRanges: ITextRangeWithStyle[];
+    segmentId?: string;
+    options: {
+        [key: string]: boolean;
+    };
+}
+export declare const ReplaceTextRunsCommand: ICommand<IReplaceTextRunsCommandParams>;
 export {};

package/lib/types/commands/operations/insert-break.operation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ICommand, SectionType } from '@univerjs/core';
+export interface IInsertDocumentSectionBreakOperationParams {
+    sectionType: SectionType;
+}
+export declare const InsertDocumentColumnBreakOperation: ICommand;
+export declare const InsertDocumentSectionBreakOperation: ICommand<IInsertDocumentSectionBreakOperationParams>;

package/lib/types/controllers/doc-move-cursor.controller.d.ts

@@ -67,5 +67,4 @@ export declare class DocMoveCursorController extends Disposable {
     private _getDistanceToColumnGroupColumn;
     private _isColumnGroupContentPage;
     private _scrollToFocusNodePosition;
-    private _getDocObject;
 }

package/lib/types/controllers/doc-section-setting.controller.d.ts

@@ -14,11 +14,14 @@
  * limitations under the License.
  */
 import { Disposable } from '@univerjs/core';
+import { DocSelectionManagerService } from '@univerjs/docs';
 import { ISidebarService } from '@univerjs/ui';
 export declare class DocSectionSettingController extends Disposable {
     private readonly _sidebarService;
+    private readonly _selectionManager;
     private readonly _panelId;
-    constructor(_sidebarService: ISidebarService);
+    constructor(_sidebarService: ISidebarService, _selectionManager: DocSelectionManagerService);
     openPanel(): void;
     closePanel(): void;
+    navigateToSectionEnd(unitId: string, sectionStart: number, sectionEnd: number): void;
 }

package/lib/types/controllers/render-controllers/doc-paragraph-placeholder.render-controller.d.ts

@@ -14,11 +14,15 @@
  * limitations under the License.
  */
 import type { DocumentDataModel, IDocumentBody, Nullable } from '@univerjs/core';
-import type { IDocumentSkeletonPage, IRenderContext, IRenderModule } from '@univerjs/engine-render';
+import type { IDocumentSkeletonPage, IRenderContext, IRenderModule, UniverRenderingContext } from '@univerjs/engine-render';
 import type { IUniverDocsUIConfig } from '../../config/config';
 import { Disposable, IConfigService, LocaleService } from '@univerjs/core';
 import { DocSelectionManagerService } from '@univerjs/docs';
 export interface IParagraphPlaceholderLayout {
+    clipBottom?: number;
+    clipLeft?: number;
+    clipRight?: number;
+    clipTop?: number;
     fontFamily: string;
     fontSize: number;
     fontWeight: string;
@@ -36,6 +40,10 @@ interface IParagraphPlaceholderLocale {
     listItem: string;
     normalText: string;
 }
+interface IParagraphPlaceholderLayoutOptions {
+    docsLeft?: number;
+    unitId?: string;
+}
 export declare class DocParagraphPlaceholderRenderController extends Disposable implements IRenderModule {
     private readonly _context;
     private readonly _localeService;
@@ -47,5 +55,6 @@ export declare class DocParagraphPlaceholderRenderController extends Disposable
     private _getLocale;
 }
 export declare function shouldRenderParagraphPlaceholder(documentModel: DocumentDataModel, unitId: string, config?: Nullable<IUniverDocsUIConfig>): boolean;
-export declare function getParagraphPlaceholderLayouts(page: IDocumentSkeletonPage, body: IDocumentBody, locale: IParagraphPlaceholderLocale, pageLeft?: number, pageTop?: number, activeOffset?: number): IParagraphPlaceholderLayout[];
+export declare function getParagraphPlaceholderLayouts(page: IDocumentSkeletonPage, body: IDocumentBody, locale: IParagraphPlaceholderLocale, pageLeft?: number, pageTop?: number, activeOffset?: number, options?: IParagraphPlaceholderLayoutOptions): IParagraphPlaceholderLayout[];
+export declare function drawParagraphPlaceholders(ctx: UniverRenderingContext, placeholders: IParagraphPlaceholderLayout[]): void;
 export {};

package/lib/types/embed-docs-custom-block-bleed.d.ts

@@ -21,8 +21,10 @@ export interface IDocsCustomBlockBleedViewport {
     virtualWidth: number;
 }
 export interface IDocsCustomBlockBleedViewportHint {
+    authoritativeContentWidth?: boolean;
     bleedLeft?: number;
     bleedWidth?: number;
+    viewScale?: number;
 }
 export declare function createDefaultDocsTableLikeCustomBlockBleedViewport(): IDocsCustomBlockBleedViewport;
 export declare function resolveDocsTableLikeCustomBlockBleedViewport(root: HTMLElement, contentWidth: number, hint?: IDocsCustomBlockBleedViewportHint): IDocsCustomBlockBleedViewport;

package/lib/types/embed-host-anchor.d.ts

@@ -39,6 +39,8 @@ export interface IDocsCustomBlockLayoutViewport {
     height: number;
     layoutWidth?: number;
     offsetLeft?: number;
+    pageContentWidth?: number;
+    viewScale?: number;
     viewportHeight?: number;
     width: number;
 }

package/lib/types/index.d.ts

@@ -15,8 +15,10 @@
  */
 import './global.css';
 export type { IDocObjectParam } from './basics/component-tools';
-export { getDocObject, getDocObjectById, neoGetDocObject } from './basics/component-tools';
+export { getDocObjectById, neoGetDocObject } from './basics/component-tools';
 export { addCustomDecorationBySelectionFactory, addCustomDecorationFactory, deleteCustomDecorationFactory, } from './basics/custom-decoration-factory';
+export { DOC_CUSTOM_RANGE_CHROME_BACKGROUND_ALPHA, DOC_CUSTOM_RANGE_CHROME_RADIUS, drawDocCustomRangeChrome, resolveDocCustomRangeChromeTheme, } from './basics/doc-custom-range-chrome';
+export type { IDocCustomRangeChromeRect, IDocCustomRangeChromeTheme, } from './basics/doc-custom-range-chrome';
 export * from './basics/docs-view-key';
 export { hasParagraphInTable } from './basics/paragraph';
 export { AfterSpaceCommand, EnterCommand, TabCommand } from './commands/commands/auto-format.command';
@@ -31,7 +33,7 @@ export { getCutActionsFromDocRanges } from './commands/commands/clipboard.inner.
 export { buildMoveDocBlockActions, MoveDocBlockCommand } from './commands/commands/doc-block-move.command';
 export type { IMoveDocBlockCommandParams } from './commands/commands/doc-block-move.command';
 export { DeleteCurrentParagraphCommand, DeleteCustomBlockCommand, DeleteLeftCommand, DeleteRightCommand, MergeTwoParagraphCommand, } from './commands/commands/doc-delete.command';
-export type { IDeleteCurrentParagraphCommandParams, IDeleteCustomBlockParams } from './commands/commands/doc-delete.command';
+export type { IDeleteCurrentParagraphCommandParams, IDeleteCustomBlockParams, } from './commands/commands/doc-delete.command';
 export { getCursorWhenDelete } from './commands/commands/doc-delete.command';
 export { HorizontalLineCommand } from './commands/commands/doc-horizontal-line.command';
 export { DocSelectAllCommand } from './commands/commands/doc-select-all.command';
@@ -44,7 +46,7 @@ export { BulletListCommand, ChangeListNestingLevelCommand, ChangeListTypeCommand
 export { ChangeListNestingLevelType } from './commands/commands/list.command';
 export { AlignCenterCommand, AlignJustifyCommand, AlignLeftCommand, AlignOperationCommand, AlignRightCommand, } from './commands/commands/paragraph-align.command';
 export { ReplaceTextRunsCommand } from './commands/commands/replace-content.command';
-export { CoverContentCommand, ReplaceContentCommand, ReplaceSelectionCommand, ReplaceSnapshotCommand, } from './commands/commands/replace-content.command';
+export { CoverContentCommand, ReplaceSelectionCommand, ReplaceSnapshotCommand, } from './commands/commands/replace-content.command';
 export type { IReplaceSelectionCommandParams, IReplaceSnapshotCommandParams, } from './commands/commands/replace-content.command';
 export { SetDocZoomRatioCommand } from './commands/commands/set-doc-zoom-ratio.command';
 export { SetParagraphNamedStyleCommand } from './commands/commands/set-heading.command';
@@ -73,7 +75,7 @@ export { DocRenderController } from './controllers/render-controllers/doc.render
 export { DocUIController } from './controllers/ui.controller';
 export { createDefaultDocsTableLikeCustomBlockBleedViewport, resolveDocsTableLikeCustomBlockBleedViewport, resolveDocsTableLikeCustomBlockContentHeight, resolveDocsTableLikeCustomBlockContentWidth, } from './embed-docs-custom-block-bleed';
 export type { IDocsCustomBlockBleedViewport, IDocsCustomBlockBleedViewportHint } from './embed-docs-custom-block-bleed';
-export { collectDocsTableLikeEmbedChildUnitIds, createDocsCustomBlockSizeRefreshScheduler, shouldRefreshDocsCustomBlockSizeForCommand } from './embed-docs-custom-block-refresh';
+export { collectDocsTableLikeEmbedChildUnitIds, createDocsCustomBlockSizeRefreshScheduler, shouldRefreshDocsCustomBlockSizeForCommand, } from './embed-docs-custom-block-refresh';
 export { scrollDocsTableLikeCustomBlockLive } from './embed-docs-custom-block-scroll';
 export type { IDocsTableLikeCustomBlockScrollOptions } from './embed-docs-custom-block-scroll';
 export { resolveDocsCustomBlockRenderViewport } from './embed-host-anchor';
@@ -84,15 +86,14 @@ export { menuSchema as DocsUIMenuSchema } from './menu/schema';
 export { UniverDocsUIPlugin } from './plugin';
 export * from './services';
 export { IDocClipboardService } from './services/clipboard/clipboard.service';
-export type { IDocClipboardHook } from './services/clipboard/clipboard.service';
+export type { IDocClipboardCopyContentContext, IDocClipboardHook, IDocClipboardPasteContext, } from './services/clipboard/clipboard.service';
 export { DocClipboardPasteAdapterService, IDocClipboardPasteAdapterService, } from './services/clipboard/doc-paste-mutation-adapter.service';
-export type { IDocClipboardPasteAdapter, IDocClipboardPasteBlockRangeMapping, IDocClipboardPasteCustomBlockMapping, IDocClipboardPasteMutationInfoParams, IDocClipboardPasteMutationInfos, } from './services/clipboard/doc-paste-mutation-adapter.service';
+export type { IDocClipboardPasteAdapter, IDocClipboardPasteBlockRangeMapping, IDocClipboardPasteCustomBlockMapping, IDocClipboardPasteCustomRangeMapping, IDocClipboardPasteMutationInfoParams, IDocClipboardPasteMutationInfos, } from './services/clipboard/doc-paste-mutation-adapter.service';
 export { convertBodyToHtml } from './services/clipboard/udm-to-html/convertor';
 export { DocHtmlExportService } from './services/clipboard/udm-to-html/doc-html-export.service';
 export type { DocHtmlExportTransformer } from './services/clipboard/udm-to-html/doc-html-export.service';
 export { DocAutoFormatService } from './services/doc-auto-format.service';
-export { DOC_EMBED_INTERACTION_BOUNDARY_OWNER_ATTRIBUTE, IDocEmbedInteractionBoundaryService, IDocEmbedRuntimeFocusCoordinator } from './services/doc-embed-integration.service';
-export type { IDocEmbedInteractionBoundaryService as IDocEmbedInteractionBoundaryServiceType, IDocEmbedRuntimeFocusCoordinator as IDocEmbedRuntimeFocusCoordinatorType } from './services/doc-embed-integration.service';
+export { DOC_EMBED_INTERACTION_BOUNDARY_OWNER_ATTRIBUTE, IDocEmbedInteractionBoundaryService, IDocEmbedRuntimeFocusCoordinator, } from './services/doc-embed-integration.service';
 export { DocEventManagerService, getListMarkerFallbackBound, getListParagraphContextMenuHit, } from './services/doc-event-manager.service';
 export type { IBulletBound, IMutiPageParagraphBound } from './services/doc-event-manager.service';
 export { DocIMEInputManagerService } from './services/doc-ime-input-manager.service';
@@ -112,7 +113,7 @@ export type { IEditorInputConfig } from './services/selection/doc-selection-rend
 export { DocSelectionRenderService } from './services/selection/doc-selection-render.service';
 export type { IDocRange } from './services/selection/range-interface';
 export { convertPositionsToRectRanges, RectRange } from './services/selection/rect-range';
-export { getCanvasOffsetByEngine } from './services/selection/selection-utils';
+export { getCanvasOffsetByEngine, getTextRangeFromCharIndex } from './services/selection/selection-utils';
 export { getAnchorBounding, getLineBounding, TEXT_RANGE_LAYER_INDEX, TextRange } from './services/selection/text-range';
 export { whenDocAndEditorFocused } from './shortcuts/utils';
 export { DOC_VERTICAL_PADDING } from './types/const/padding';
@@ -120,5 +121,3 @@ export { createEditorUndoRedoKeyboardConfig, executeEditorUndoRedoCommand, useEd
 export type { ICreateEditorUndoRedoKeyboardConfigOptions, IExecuteEditorUndoRedoCommandOptions, IKeyboardEventConfig, } from './views/rich-text-editor/hooks';
 export { RichTextEditor } from './views/RichTextEditor';
 export type { IRichTextEditorProps } from './views/RichTextEditor';
-export { createDocsCustomBlockInsertMutation, createDocsCustomBlockRemoveMutation, createEmbedDocsCustomBlockData, createInsertCustomBlockActions, createRemoveCustomBlockActions, EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY, isSheetLikeDocsCustomBlockChildType, resolveDocsCustomBlockSize } from '@univerjs/docs';
-export type { IDocsCustomBlockMutationParams, IEmbedDocsCustomBlockData } from '@univerjs/docs';

package/lib/types/locale/en-US.d.ts

@@ -50,6 +50,13 @@ declare const locale: {
             horizontalLine: string;
             headerFooter: string;
             pageSetup: string;
+            breaks: string;
+            columnBreak: string;
+            sectionBreakNextPage: string;
+            sectionBreakContinuous: string;
+            sectionBreakNextColumn: string;
+            sectionBreakEvenPage: string;
+            sectionBreakOddPage: string;
             heading: {
                 tooltip: string;
                 normal: string;
@@ -124,6 +131,7 @@ declare const locale: {
             };
             sectionSetting: {
                 selectedSections: string;
+                multipleValues: string;
                 columnCount: string;
                 columnGap: string;
                 columnSeparator: string;
@@ -132,9 +140,14 @@ declare const locale: {
                 sectionStart: string;
                 unspecified: string;
                 continuous: string;
+                nextColumn: string;
                 nextPage: string;
                 evenPage: string;
                 oddPage: string;
+                pageSetup: string;
+                pageWidth: string;
+                pageHeight: string;
+                pageNumberStart: string;
             };
         };
         rightClick: {

package/lib/types/menu/menu.d.ts

@@ -41,6 +41,19 @@ export declare const FLOAT_TOOLBAR_MENU_POSITION = "doc.menu.float-toolbar";
 export declare function FloatTextStyleMenuItemFactory(accessor: IAccessor): IMenuSelectorItem<LocaleKey, string | number>;
 export declare function TextColorSelectorMenuItemFactory(accessor: IAccessor): IMenuSelectorItem<LocaleKey, string, string | undefined>;
 export declare function HeaderFooterMenuItemFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare const DOC_BREAKS_MENU_ID = "doc.menu.breaks";
+export declare const DOC_SECTION_BREAK_NEXT_PAGE_MENU_ID = "doc.menu.section-break.next-page";
+export declare const DOC_SECTION_BREAK_CONTINUOUS_MENU_ID = "doc.menu.section-break.continuous";
+export declare const DOC_SECTION_BREAK_NEXT_COLUMN_MENU_ID = "doc.menu.section-break.next-column";
+export declare const DOC_SECTION_BREAK_EVEN_PAGE_MENU_ID = "doc.menu.section-break.even-page";
+export declare const DOC_SECTION_BREAK_ODD_PAGE_MENU_ID = "doc.menu.section-break.odd-page";
+export declare function BreaksMenuFactory(accessor: IAccessor): IMenuItem<LocaleKey>;
+export declare function InsertColumnBreakMenuFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare function InsertNextPageSectionBreakMenuFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare function InsertContinuousSectionBreakMenuFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare function InsertNextColumnSectionBreakMenuFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare function InsertEvenPageSectionBreakMenuFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare function InsertOddPageSectionBreakMenuFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
 export declare const TableIcon = "GridIcon";
 export declare const TABLE_MENU_ID = "doc.menu.table";
 export declare function TableMenuFactory(accessor: IAccessor): IMenuItem<LocaleKey>;

package/lib/types/menu/paragraph-menu.d.ts

@@ -18,7 +18,7 @@ import type { IMenuButtonItem, IMenuItem, IMenuSelectorItem } from '@univerjs/ui
 import type { LocaleKey } from '../locale/types';
 export declare const TEXT_COLORS: string[];
 export declare const TEXT_COLOR_SWATCH_ICONS: readonly ["DocParagraphTextColorSwatchIcon.0", "DocParagraphTextColorSwatchIcon.1", "DocParagraphTextColorSwatchIcon.2", "DocParagraphTextColorSwatchIcon.3", "DocParagraphTextColorSwatchIcon.4", "DocParagraphTextColorSwatchIcon.5", "DocParagraphTextColorSwatchIcon.6"];
-export declare const BACKGROUND_COLOR_SWATCH_ICONS: readonly ["DocParagraphBackgroundColorSwatchIcon.0", "DocParagraphBackgroundColorSwatchIcon.1", "DocParagraphBackgroundColorSwatchIcon.2", "DocParagraphBackgroundColorSwatchIcon.3", "DocParagraphBackgroundColorSwatchIcon.4", "DocParagraphBackgroundColorSwatchIcon.5", "DocParagraphBackgroundColorSwatchIcon.6", "DocParagraphBackgroundColorSwatchIcon.7", "DocParagraphBackgroundColorSwatchIcon.8", "DocParagraphBackgroundColorSwatchIcon.9", "DocParagraphBackgroundColorSwatchIcon.10", "DocParagraphBackgroundColorSwatchIcon.11", "DocParagraphBackgroundColorSwatchIcon.12", "DocParagraphBackgroundColorSwatchIcon.13", "DocParagraphBackgroundColorSwatchIcon.14", "DocParagraphBackgroundColorSwatchIcon.15"];
+export declare const BACKGROUND_COLOR_SWATCH_ICONS: readonly ["DocParagraphBackgroundColorSwatchIcon.0", "DocParagraphBackgroundColorSwatchIcon.1", "DocParagraphBackgroundColorSwatchIcon.2", "DocParagraphBackgroundColorSwatchIcon.3", "DocParagraphBackgroundColorSwatchIcon.4", "DocParagraphBackgroundColorSwatchIcon.5", "DocParagraphBackgroundColorSwatchIcon.6", "DocParagraphBackgroundColorSwatchIcon.7", "DocParagraphBackgroundColorSwatchIcon.8", "DocParagraphBackgroundColorSwatchIcon.9", "DocParagraphBackgroundColorSwatchIcon.10", "DocParagraphBackgroundColorSwatchIcon.11", "DocParagraphBackgroundColorSwatchIcon.12", "DocParagraphBackgroundColorSwatchIcon.13", "DocParagraphBackgroundColorSwatchIcon.14"];
 export declare function H1HeadingMenuItemFactory(accessor: IAccessor): IMenuItem<LocaleKey>;
 export declare function H2HeadingMenuItemFactory(accessor: IAccessor): IMenuItem<LocaleKey>;
 export declare function H3HeadingMenuItemFactory(accessor: IAccessor): IMenuItem<LocaleKey>;

package/lib/types/services/clipboard/clipboard.service.d.ts

@@ -24,11 +24,20 @@ export interface IClipboardPropertyItem {
 export interface IDocClipboardCopyDocDataContext {
     sourceDocuments: IDocumentData[];
 }
+export interface IDocClipboardCopyContentContext {
+    body: IDocumentBody;
+    segmentId?: string;
+    unitId: string;
+}
+export interface IDocClipboardPasteContext {
+    documentData: Partial<IDocumentData>;
+    targetUnitId: string;
+}
 export interface IDocClipboardHook {
     onCopyDocData?(doc: Partial<IDocumentData>, context: IDocClipboardCopyDocDataContext): Partial<IDocumentData>;
     onCopyProperty?(start: number, end: number): IClipboardPropertyItem;
-    onCopyContent?(start: number, end: number): string;
-    onBeforePaste?: (body: IDocumentBody) => IDocumentBody;
+    onCopyContent?(start: number, end: number, context: IDocClipboardCopyContentContext): string;
+    onBeforePaste?: (body: IDocumentBody, context: IDocClipboardPasteContext) => IDocumentBody;
     onBeforePasteImage?: (file: File) => Promise<{
         source: string;
         imageSourceType: ImageSourceType;

package/lib/types/services/clipboard/doc-paste-mutation-adapter.service.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IDisposable, IDocumentBlockRange, IDocumentBody, IDocumentData, IDrawingParam, IMutationInfo } from '@univerjs/core';
+import type { ICustomRange, IDisposable, IDocumentBlockRange, IDocumentBody, IDocumentData, IDrawingParam, IMutationInfo } from '@univerjs/core';
 export interface IDocClipboardPasteCustomBlockMapping {
     sourceBlockId: string;
     targetBlockId: string;
@@ -24,6 +24,10 @@ export interface IDocClipboardPasteBlockRangeMapping {
     sourceBlockRange: IDocumentBlockRange;
     targetBlockRange: IDocumentBlockRange;
 }
+export interface IDocClipboardPasteCustomRangeMapping {
+    sourceRange: ICustomRange;
+    targetRange: ICustomRange;
+}
 export interface IDocClipboardPasteMutationInfoParams {
     unitId: string;
     segmentId: string;
@@ -31,6 +35,7 @@ export interface IDocClipboardPasteMutationInfoParams {
     sourceBody: IDocumentBody;
     targetBody: IDocumentBody;
     blockRangeMappings: IDocClipboardPasteBlockRangeMapping[];
+    customRangeMappings?: IDocClipboardPasteCustomRangeMapping[];
     customBlockMappings: IDocClipboardPasteCustomBlockMapping[];
 }
 export interface IDocClipboardPasteMutationInfos {

package/lib/types/services/editor/editor-manager.service.d.ts

@@ -23,7 +23,9 @@ import { IRenderManagerService } from '@univerjs/engine-render';
 import { Editor } from './editor';
 export interface IEditorRenderConfig {
     canvasStyle: IEditorCanvasStyle;
+    preserveHostFocus?: boolean;
     scrollBar?: boolean;
+    backScrollOffset?: number;
 }
 export interface IEditorSetValueParam {
     editorUnitId: string;

package/lib/types/services/editor/editor.d.ts

@@ -55,6 +55,8 @@ export interface IEditorCanvasStyle {
 }
 export interface IEditorConfigParams {
     initialSnapshot: IDocumentData;
+    /** Keep the globally focused unit on the editor's host while this editor receives input focus. */
+    preserveHostFocus?: boolean;
     cancelDefaultResizeListener?: boolean;
     canvasStyle?: IEditorCanvasStyle;
     autofocus?: boolean;
@@ -91,11 +93,11 @@ export declare class Editor extends Disposable implements IEditor {
     private _listenSelection;
     isFocus(): boolean;
     /**
-     * @deprecated use `IEditorService.focus` as instead. this is for internal usage.
+     * Focus the input element directly. This is for internal usage.
      */
     focus(): void;
     /**
-     * @deprecated use `IEditorService.blur` as instead. this is for internal usage.
+     * Blur the input element directly. This is for internal usage.
      */
     blur(): void;
     select(): void;
@@ -109,15 +111,12 @@ export declare class Editor extends Disposable implements IEditor {
     replaceText(text: string, resetCursor?: boolean | ITextRangeWithStyle[]): void;
     clearUndoRedoHistory(): void;
     dispose(): void;
-    /**
-     * @deprecated use getEditorId.
-     */
-    get editorUnitId(): string | undefined;
-    /**
-     * @deprecated @TODO: @JOCS remove this in the future.
-     */
-    get params(): IEditorOptions;
     get cancelDefaultResizeListener(): boolean | undefined;
+    getRenderConfig(): {
+        backScrollOffset?: number | undefined;
+        canvasStyle: IEditorCanvasStyle;
+        scrollBar: boolean | undefined;
+    };
     get render(): IRender;
     isReadOnly(): boolean;
     getBoundingClientRect(): DOMRect;
@@ -125,22 +124,6 @@ export declare class Editor extends Disposable implements IEditor {
     isVisible(): boolean | undefined;
     getSkeleton(): import("@univerjs/engine-render").DocumentSkeleton | undefined;
     isSheetEditor(): boolean;
-    /**
-     * @deprecated use getDocumentData.
-     */
-    getValue(): string;
-    /**
-     * @deprecated use getDocumentData.
-     */
-    getBody(): import("@univerjs/core").IDocumentBody | undefined;
-    /**
-     * @deprecated.
-     */
-    update(param: Partial<IEditorOptions>): void;
-    /**
-     * @deprecated.
-     */
-    updateCanvasStyle(): void;
     private _getDocDataModel;
     private _getEditorId;
 }