@univerjs-pro/boards-ui 1.0.0-alpha.6 → 1.0.0-alpha.8

package/lib/types/menu/board-contextmenu.d.ts

@@ -2,6 +2,10 @@ export declare enum BoardContainerContextMenuPosition {
     CONTAINER = "board.contextMenu.container",
     CHILD = "board.contextMenu.container-child"
 }
+export declare enum BoardElementContextMenuPosition {
+    ELEMENT = "board.contextMenu.element",
+    SELECTION = "board.contextMenu.selection"
+}
 export declare enum BoardSwimlaneLaneContextMenuPosition {
     LANE = "board.contextMenu.swimlane-lane"
 }

package/lib/types/menu/board-element-contextmenu.menu.d.ts

@@ -0,0 +1,41 @@
+import type { IAccessor } from '@univerjs/core';
+import type { IMenuButtonItem, IMenuItem } from '@univerjs/ui';
+export declare const BOARD_CONTEXT_MENU_ARRANGE_ID = "board.menu.arrange";
+export declare const BOARD_CONTEXT_MENU_ALIGN_ID = "board.menu.align";
+export declare const BOARD_CONTEXT_MENU_ORGANIZE_ID = "board.menu.organize";
+export declare const BOARD_CONTEXT_MENU_DUPLICATE_ID = "board.menu.duplicate-selection";
+export declare const BOARD_CONTEXT_MENU_TOGGLE_LOCK_ID = "board.menu.toggle-selection-lock";
+export declare const BOARD_CONTEXT_MENU_WRAP_IN_CONTAINER_ID = "board.menu.wrap-selection-in-container";
+export declare const BOARD_CONTEXT_MENU_BRING_TO_FRONT_ID = "board.menu.arrange.front";
+export declare const BOARD_CONTEXT_MENU_BRING_FORWARD_ID = "board.menu.arrange.forward";
+export declare const BOARD_CONTEXT_MENU_SEND_BACKWARD_ID = "board.menu.arrange.backward";
+export declare const BOARD_CONTEXT_MENU_SEND_TO_BACK_ID = "board.menu.arrange.back";
+export declare const BOARD_CONTEXT_MENU_ALIGN_LEFT_ID = "board.menu.align.left";
+export declare const BOARD_CONTEXT_MENU_ALIGN_CENTER_ID = "board.menu.align.center";
+export declare const BOARD_CONTEXT_MENU_ALIGN_RIGHT_ID = "board.menu.align.right";
+export declare const BOARD_CONTEXT_MENU_ALIGN_TOP_ID = "board.menu.align.top";
+export declare const BOARD_CONTEXT_MENU_ALIGN_MIDDLE_ID = "board.menu.align.middle";
+export declare const BOARD_CONTEXT_MENU_ALIGN_BOTTOM_ID = "board.menu.align.bottom";
+export declare const BOARD_CONTEXT_MENU_DISTRIBUTE_HORIZONTALLY_ID = "board.menu.distribute.horizontal";
+export declare const BOARD_CONTEXT_MENU_DISTRIBUTE_VERTICALLY_ID = "board.menu.distribute.vertical";
+export declare function BoardContextMenuCopyFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuCutFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuDuplicateFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuArrangeFactory(accessor?: IAccessor): IMenuItem;
+export declare function BoardContextMenuBringToFrontFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuBringForwardFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuSendBackwardFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuSendToBackFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuAlignFactory(accessor?: IAccessor): IMenuItem;
+export declare function BoardContextMenuAlignLeftFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuAlignCenterFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuAlignRightFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuAlignTopFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuAlignMiddleFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuAlignBottomFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuDistributeHorizontallyFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuDistributeVerticallyFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuOrganizeFactory(accessor?: IAccessor): IMenuItem;
+export declare function BoardContextMenuWrapInContainerFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuToggleLockFactory(accessor?: IAccessor): IMenuButtonItem;
+export declare function BoardContextMenuDeleteFactory(accessor?: IAccessor): IMenuButtonItem;

package/lib/types/menu/board-element-contextmenu.schema.d.ts

@@ -0,0 +1,2 @@
+import type { MenuSchemaType } from '@univerjs/ui';
+export declare const boardElementContextMenuSchema: MenuSchemaType;

package/lib/types/render-adapters/board-element-render-adapter.d.ts

@@ -1,6 +1,7 @@
+import type { IShapeFormulaPresentation } from '@univerjs-pro/shape-editor';
+import type { BaseObject } from '@univerjs/engine-render';
 import type { IBoardElementData } from '@univerjs-pro/boards';
 import type { IImageIoService, LocaleService } from '@univerjs/core';
-import type { BaseObject } from '@univerjs/engine-render';
 import type { IBoardFocusedSwimlaneLane } from '../services/board-element-state.service';
 export declare const BOARD_ELEMENT_OBJECT_PREFIX = "board-element";
 export interface IBoardElementRenderObjectKey {
@@ -25,6 +26,8 @@ export interface ICreateBoardElementRenderObjectOptions {
     localeService?: LocaleService;
     adapters?: readonly IBoardElementRenderAdapter[];
     focusedSwimlaneLane?: IBoardFocusedSwimlaneLane | null;
+    formulaPresentation?: IShapeFormulaPresentation;
+    animateFormulaPresentation?: boolean;
 }
 export interface ISyncBoardElementRenderObjectOptions {
     adapters?: readonly IBoardElementRenderAdapter[];
@@ -33,6 +36,8 @@ export interface ISyncBoardElementRenderObjectOptions {
     unitId?: string;
     zIndex?: number;
     focusedSwimlaneLane?: IBoardFocusedSwimlaneLane | null;
+    formulaPresentation?: IShapeFormulaPresentation;
+    animateFormulaPresentation?: boolean;
 }
 export interface IBoardElementRenderAdapterContext {
     unitId: string;
@@ -44,6 +49,8 @@ export interface IBoardElementRenderAdapterContext {
     imageIoService?: IImageIoService;
     localeService?: LocaleService;
     focusedSwimlaneLane?: IBoardFocusedSwimlaneLane | null;
+    formulaPresentation?: IShapeFormulaPresentation;
+    animateFormulaPresentation?: boolean;
 }
 export interface IBoardElementRenderAdapter {
     name: string;
@@ -61,5 +68,5 @@ export declare const BOARD_CONNECTOR_ELEMENT_RENDER_ADAPTER: IBoardElementRender
 export declare const BOARD_SHAPE_ELEMENT_RENDER_ADAPTER: IBoardElementRenderAdapter;
 export declare const BOARD_IMAGE_ELEMENT_RENDER_ADAPTER: IBoardElementRenderAdapter;
 export declare const BOARD_ELEMENT_RENDER_ADAPTERS: readonly IBoardElementRenderAdapter[];
-export declare function createBoardElementRenderObject({ unitId, elementDataItem, elementData, zIndex, imageIoService, localeService, adapters, focusedSwimlaneLane, }: ICreateBoardElementRenderObjectOptions): BaseObject | null;
+export declare function createBoardElementRenderObject({ unitId, elementDataItem, elementData, zIndex, imageIoService, localeService, adapters, focusedSwimlaneLane, formulaPresentation, }: ICreateBoardElementRenderObjectOptions): BaseObject | null;
 export declare function syncBoardElementRenderObject(object: BaseObject, elementDataItem: IBoardElementData, options?: ISyncBoardElementRenderObjectOptions): boolean;

package/lib/types/render-objects/board-connector-object.d.ts

@@ -1,8 +1,8 @@
 import type { IBoardConnectorElement, IBoardConnectorPoint, IBoardElementData } from '@univerjs-pro/boards';
-import type { LocaleService } from '@univerjs/core';
+import type { IDocumentData, LocaleService } from '@univerjs/core';
+import { BaseObject } from '@univerjs/engine-render';
 import type { IObjectFullState, IViewportInfo, UniverRenderingContext, Vector2 } from '@univerjs/engine-render';
 import type { IBoardConnectorLabelRect } from '../utils/board-connector-label.util';
-import { BaseObject } from '@univerjs/engine-render';
 import { resolveBoardConnectorPathBounds, resolveBoardConnectorPathCommands, resolveBoardConnectorRoutePoints } from '../utils/board-connector-routing.util';
 export interface IBoardConnectorObjectProps {
     left: number;
@@ -36,9 +36,11 @@ export declare class BoardConnectorObject extends BaseObject {
     getElement(): IBoardConnectorElement;
     setEditing(isEditing: boolean): void;
     getRoutePoints(): IBoardConnectorPoint[];
+    getCachedRoutePoints(): readonly IBoardConnectorPoint[] | null;
     getPathCommands(): import("../utils/board-connector-routing.util").BoardConnectorPathCommand[];
     getLabelPathPoints(): IBoardConnectorPoint[];
     getLabelRect(): IBoardConnectorLabelRect | null;
+    measureLabelNaturalHeight(width: number, documentData?: IDocumentData): number | null;
     isLabelHit(point: IBoardConnectorPoint): boolean;
     private _getRouteCache;
     private _getRenderBounds;
@@ -47,6 +49,7 @@ export declare class BoardConnectorObject extends BaseObject {
     transformByState(option: IObjectFullState): this;
     isHit(coord: Vector2): boolean;
     render(ctx: UniverRenderingContext, _bounds: IViewportInfo): this;
+    private _clipRouteAroundLabel;
     private _drawRoute;
     private _drawRoundedOrthogonalRoute;
     private _drawRouteWithLineJumps;
@@ -55,4 +58,5 @@ export declare class BoardConnectorObject extends BaseObject {
     private _drawMarkers;
     private _resolveEndpointVisualGap;
     private _drawLabel;
+    private _drawLabelFrame;
 }

package/lib/types/render-objects/board-document-text-render.util.d.ts

@@ -56,6 +56,7 @@ export declare function prepareBoardDocumentTextData(documentData: IDocumentData
 export declare function createBoardDocumentTextRenderResources(options: IBoardDocumentTextRenderOptions & {
     documentData: IDocumentData;
 }): IBoardDocumentTextRenderResources;
+export declare function createBoardDocumentTextRenderSignature(options: IBoardDocumentTextRenderOptions, documentData: IDocumentData, localeService: LocaleService): string;
 export declare function shouldClipBoardDocumentTextResources(options: Pick<IBoardDocumentTextRenderOptions, 'clip' | 'wrapStrategy'>, documentData: IDocumentData): boolean;
 export declare function drawBoardDocumentTextResources(ctx: UniverRenderingContext, resources: IBoardDocumentTextRenderResources, left: number, top: number, clip: boolean): void;
 export declare function disposeBoardDocumentTextRenderCache(cache?: IBoardDocumentTextRenderCache): void;

package/lib/types/render-objects/board-selection-marquee-object.d.ts

@@ -2,6 +2,7 @@ import type { IViewportInfo, UniverRenderingContext, Vector2 } from '@univerjs/e
 import type { IBoardSelectionRect } from '../utils/board-selection-geometry.util';
 import { BaseObject } from '@univerjs/engine-render';
 export interface IBoardSelectionMarqueeObjectState {
+    preciseSelection?: boolean;
     rect: IBoardSelectionRect | null;
     zoomRatio?: number;
 }

package/lib/types/render-objects/board-shape-object.d.ts

@@ -1,5 +1,6 @@
 import type { IBoardElementData } from '@univerjs-pro/boards';
 import type { IShapeData, IShapeRect } from '@univerjs-pro/engine-shape';
+import type { IShapeFormulaPresentation } from '@univerjs-pro/shape-editor';
 import type { IImageIoService, LocaleService } from '@univerjs/core';
 import type { IObjectFullState, IViewportInfo, UniverRenderingContext, Vector2 } from '@univerjs/engine-render';
 import { ShapeModel, ShapeTypeEnum } from '@univerjs-pro/engine-shape';
@@ -24,6 +25,8 @@ export interface IBoardShapeObjectProps {
     imageIoService?: IImageIoService;
     focusedLaneId?: string | null;
     focusedTitle?: boolean;
+    formulaPresentation?: IShapeFormulaPresentation;
+    animateFormulaPresentation?: boolean;
 }
 /**
  * Board canvas object for board shape elements.
@@ -42,11 +45,15 @@ export declare class BoardShapeObject extends Shape<IBoardShapeObjectProps> {
     private _fillImage?;
     private _fillImageRequestId;
     private readonly _documentTextRenderCache;
+    private readonly _formulaAnimation;
+    private _formulaPresentation?;
     isDrawingObject: boolean;
     constructor(key: string, config: IBoardShapeObjectProps);
     updateElement(element: IBoardShapeElement): void;
     getElement(): IBoardShapeElement;
     getShapeModel(): ShapeModel;
+    setFormulaPresentation(presentation: IShapeFormulaPresentation | undefined, animate?: boolean): void;
+    private _applyFormulaAutoFitSize;
     measureTextBoxNaturalCrossSize(width: number, height: number): number | null;
     setFocusedLaneId(focusedLaneId: string | null | undefined): void;
     setFocusedTitle(focusedTitle: boolean | null | undefined): void;
@@ -69,6 +76,8 @@ export declare class BoardShapeObject extends Shape<IBoardShapeObjectProps> {
     private _drawSwimlaneLaneTitles;
     private _drawSwimlaneLaneHeaderSeparators;
     private _drawShapeText;
+    private _drawShapeTextLayer;
+    dispose(): void;
     render(mainCtx: UniverRenderingContext, bounds: IViewportInfo): this;
     private _resolveRenderCullingBound;
     getInverseCoord(coord: Vector2): Vector2;

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

@@ -13,6 +13,7 @@ export interface IResolveBoardPasteTargetParentOptions {
     selectedIds: string[];
     focusedId?: string | null;
     hoverId?: string | null;
+    excludedElementIds?: readonly string[];
 }
 export interface IBoardCopySelectionAsImageOptions {
     viewport: {
@@ -43,9 +44,10 @@ export declare class BoardClipboardService {
     getStylePayload(): IBoardElementStylePayload | null;
     createPayload(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, selectedIds: string[]): IBoardClipboardPayload | null;
     createStylePayload(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, sourceId: string | null | undefined): IBoardElementStylePayload | null;
-    createStyleUpdates(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, selectedIds: string[], payload: IBoardElementStylePayload | null | undefined): import("@univerjs-pro/boards").IUpdateBoardElementsOperationItem[];
+    createStyleUpdates(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, selectedIds: string[], payload: IBoardElementStylePayload | null | undefined): import("@univerjs-pro/boards").IUpdateBoardElementsCommandItem[];
     copySelectionAsImage(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, selectedIds: string[], sourceCanvas: HTMLCanvasElement | null | undefined, options: IBoardCopySelectionAsImageOptions): Promise<boolean>;
     resolvePasteTargetParentId(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, options: IResolveBoardPasteTargetParentOptions): string | undefined;
+    private _resolvePasteTargetCandidate;
     private _resolveUnlockedContainerId;
     pastePayload(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, payload: IBoardClipboardPayload | null | undefined, options?: IBoardPastePayloadOptions): Promise<IBoardClipboardPayload | null>;
     private _canPastePayloadIntoContainer;

package/lib/types/services/board-container-rename.service.d.ts

@@ -3,6 +3,7 @@ import { Disposable, IUniverInstanceService } from '@univerjs/core';
 import { BoardDomLayerService } from './board-dom-layer.service';
 import { BoardElementEditService } from './board-element-edit.service';
 import { IBoardElementStateService } from './board-element-state.service';
+import { BoardInteractionSurfaceService } from './board-interaction-surface.service';
 export declare const BOARD_CONTAINER_DEFAULT_TITLE = "Container";
 export declare class BoardContainerRenameService extends Disposable {
     private readonly _domLayerService;
@@ -10,8 +11,10 @@ export declare class BoardContainerRenameService extends Disposable {
     private readonly _elementStateService;
     private readonly _elementService;
     private readonly _instanceService;
+    private readonly _interactionSurfaceService;
     private _popupDisposable;
-    constructor(_domLayerService: BoardDomLayerService, _editService: BoardElementEditService, _elementStateService: IBoardElementStateService, _elementService: IBoardElementService, _instanceService: IUniverInstanceService);
+    private _surfaceDisposable;
+    constructor(_domLayerService: BoardDomLayerService, _editService: BoardElementEditService, _elementStateService: IBoardElementStateService, _elementService: IBoardElementService, _instanceService: IUniverInstanceService, _interactionSurfaceService: BoardInteractionSurfaceService);
     dispose(): void;
     close(): void;
     openFocusedContainerRenamePopup(): boolean;

package/lib/types/services/board-element-edit.service.d.ts

@@ -1,5 +1,6 @@
-import type { BoardConnectorRouting, BoardModel, IBoardConnectorLabel, IBoardConnectorStyle, IBoardSwimlaneData, ICommitBoardContainerTransformOperationParams, IRemoveBoardElementsOperationParams, IRemoveBoardSwimlaneLaneOperationParams, IUpdateBoardElementOperationParams, IUpdateBoardElementsOperationItem, IUpdateBoardElementsOperationParams } from '@univerjs-pro/boards';
-import type { IBoardElementSelectionMoveDelta } from '../utils/board-selection-move.util';
+import type { BoardConnectorRouting, BoardModel, IBoardConnectorLabel, IBoardConnectorStyle, IBoardSwimlaneData, ICommitBoardContainerTransformOperationParams, IRemoveBoardElementsOperationParams, IRemoveBoardSwimlaneLaneOperationParams, IUpdateBoardElementCommandParams, IUpdateBoardElementsCommandItem, IUpdateBoardElementsCommandParams } from '@univerjs-pro/boards';
+import type { BoardContainerMembershipUpdateMode } from '../utils/board-container-membership-update.util';
+import type { IBoardSelectionMoveDelta } from '../utils/board-selection-move.util';
 import type { IBoardElementSelectionResizeResult } from '../utils/board-selection-resize.util';
 import type { IBoardSelectionContext } from './board-element-state.service';
 import { IBoardElementService } from '@univerjs-pro/boards';
@@ -12,8 +13,9 @@ export interface IBoardElementEditSelectionSnapshot {
 }
 export interface IBoardElementMoveSelectedOptions {
     selectedIds: string[];
-    delta: IBoardElementSelectionMoveDelta;
+    delta: IBoardSelectionMoveDelta;
     focusedId?: string | null;
+    membershipMode?: BoardContainerMembershipUpdateMode;
 }
 export interface IBoardElementResizeSelectionOptions {
     selectedIds: string[];
@@ -24,6 +26,10 @@ export interface IBoardElementUpdateSelectedConnectorStyleOptions {
     focusedId?: string | null;
     style: Partial<IBoardConnectorStyle>;
 }
+export interface IBoardElementSwapSelectedConnectorMarkersOptions {
+    selectedIds: string[];
+    focusedId?: string | null;
+}
 export interface IBoardElementUpdateSelectedConnectorRoutingOptions {
     selectedIds: string[];
     focusedId?: string | null;
@@ -68,13 +74,14 @@ export interface IBoardElementRemoveElementsOptions {
     subUnitId: string;
     elementIds: string[];
 }
-export type IBoardElementUpdateElementOptions = IUpdateBoardElementOperationParams;
-export type IBoardElementUpdateElementsOperationItem = IUpdateBoardElementsOperationItem;
+export type IBoardElementUpdateElementOptions = IUpdateBoardElementCommandParams;
+export type IBoardElementUpdateElementsOperationItem = IUpdateBoardElementsCommandItem;
 export interface IBoardElementUpdateElementsOptions {
     unitId: string;
     subUnitId: string;
     updates: IBoardElementUpdateElementsOperationItem[];
     forceCaptureElementIds?: readonly string[];
+    membershipMode?: BoardContainerMembershipUpdateMode;
 }
 export declare class BoardElementEditService {
     private readonly _commandService;
@@ -113,12 +120,13 @@ export declare class BoardElementEditService {
     private _getSwimlaneData;
     commitContainerTransform(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, options: IBoardElementCommitContainerTransformOptions): Promise<boolean>;
     updateSelectedConnectorStyle(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, options: IBoardElementUpdateSelectedConnectorStyleOptions): Promise<boolean>;
+    swapSelectedConnectorMarkers(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, options: IBoardElementSwapSelectedConnectorMarkersOptions): Promise<boolean>;
     updateSelectedConnectorRouting(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, options: IBoardElementUpdateSelectedConnectorRoutingOptions): Promise<boolean>;
     updateSelectedConnectorLabel(boardModel: BoardModel | null | undefined, context: IBoardSelectionContext | null | undefined, options: IBoardElementUpdateSelectedConnectorLabelOptions): Promise<boolean>;
     updateElement(params: IBoardElementUpdateElementOptions, selectionSnapshot?: IBoardElementEditSelectionSnapshot): Promise<boolean>;
-    protected _updateElement(params: IUpdateBoardElementOperationParams, selectionSnapshot?: IBoardElementEditSelectionSnapshot): Promise<boolean>;
+    protected _updateElement(params: IUpdateBoardElementCommandParams, selectionSnapshot?: IBoardElementEditSelectionSnapshot): Promise<boolean>;
     updateElements(params: IBoardElementUpdateElementsOptions, selectionSnapshot?: IBoardElementEditSelectionSnapshot): Promise<boolean>;
-    protected _updateElements(params: IUpdateBoardElementsOperationParams, selectionSnapshot?: IBoardElementEditSelectionSnapshot): Promise<boolean>;
+    protected _updateElements(params: IUpdateBoardElementsCommandParams, selectionSnapshot?: IBoardElementEditSelectionSnapshot): Promise<boolean>;
     private _restoreSelection;
     private _resolveUpdatesWithBoundConnectorRefreshes;
 }

package/lib/types/services/board-element-insert.service.d.ts

@@ -14,6 +14,7 @@ export interface IBoardInsertPendingElementOptions {
 }
 export interface IBoardInsertElementsOptions {
     fitContainerId?: string;
+    captureExistingElements?: boolean;
 }
 export interface IBoardInsertElementAtPointOptions {
     boardModel: BoardModel | null | undefined;

package/lib/types/services/board-embed-integration.service.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Optional host-side bridge supplied by Embed UI.
+ *
+ * Boards UI stays independent of Embed UI while allowing the embed runtime to
+ * prevent the host canvas from reclaiming focus for a child-owned pointer event.
+ */
+export interface IBoardEmbedRuntimeFocusCoordinator {
+    shouldSuppressHostInteraction(unitId: string | undefined, target?: EventTarget | null, event?: Event): boolean;
+}
+export declare const IBoardEmbedRuntimeFocusCoordinator: import("@wendellhu/redi").IdentifierDecorator<IBoardEmbedRuntimeFocusCoordinator>;

package/lib/types/services/board-interaction-surface.service.d.ts

@@ -0,0 +1,16 @@
+import type { IDisposable } from '@univerjs/core';
+import { Disposable } from '@univerjs/core';
+import { IContextMenuHostService } from '@univerjs/ui';
+/** Coordinates mutually exclusive Board interaction surfaces. */
+export declare class BoardInteractionSurfaceService extends Disposable {
+    private readonly _contextMenuHostService;
+    private readonly _interactionSurfaceActive$;
+    private _exclusiveSurfaceId;
+    private readonly _exclusiveSurfaceIds;
+    readonly interactionSurfaceActive$: import("rxjs").Observable<boolean>;
+    constructor(_contextMenuHostService: IContextMenuHostService);
+    get isInteractionSurfaceActive(): boolean;
+    acquireExclusiveSurface(): IDisposable;
+    dispose(): void;
+    private _updateActiveState;
+}

package/lib/types/services/board-mermaid-import.service.d.ts

@@ -16,7 +16,6 @@ export declare const BoardMermaidImportErrorKey: {
 export type BoardMermaidImportErrorKey = typeof BoardMermaidImportErrorKey[keyof typeof BoardMermaidImportErrorKey];
 export declare const MERMAID_CODE_SAMPLES: Record<string, string>;
 export declare const DEFAULT_MERMAID_CODE: string;
-export declare const RENDER_ELEMENT_FAILED_DIAGNOSTIC_KEY = "boards-ui.mermaidImport.diagnostics.renderElementFailed";
 export interface IBoardMermaidImportContext {
     unitId: string;
     subUnitId: string;

package/lib/types/services/board-selection-overlay.service.d.ts

@@ -3,6 +3,8 @@ import { Disposable } from '@univerjs/core';
 export interface IBoardSelectionDraft {
     start: IBoardSelectionPoint;
     current: IBoardSelectionPoint;
+    dragSelection: boolean;
+    preciseSelection: boolean;
 }
 export declare class BoardSelectionOverlayService extends Disposable {
     private readonly _selectionDraft$;

package/lib/types/services/board-selection.service.d.ts

@@ -6,6 +6,7 @@ export interface IBoardPointerSelectionOptions {
     boardModel: BoardModel | null | undefined;
     start: IBoardSelectionPoint;
     end: IBoardSelectionPoint;
+    dragSelection: boolean;
     preciseSelection: boolean;
     invertSelection?: boolean;
 }

package/lib/types/services/board-swimlane-lane-rename.service.d.ts

@@ -3,14 +3,17 @@ import { Disposable, IUniverInstanceService } from '@univerjs/core';
 import { BoardDomLayerService } from './board-dom-layer.service';
 import { BoardElementEditService } from './board-element-edit.service';
 import { IBoardElementStateService } from './board-element-state.service';
+import { BoardInteractionSurfaceService } from './board-interaction-surface.service';
 export declare class BoardSwimlaneLaneRenameService extends Disposable {
     private readonly _domLayerService;
     private readonly _editService;
     private readonly _elementStateService;
     private readonly _elementService;
     private readonly _instanceService;
+    private readonly _interactionSurfaceService;
     private _popupDisposable;
-    constructor(_domLayerService: BoardDomLayerService, _editService: BoardElementEditService, _elementStateService: IBoardElementStateService, _elementService: IBoardElementService, _instanceService: IUniverInstanceService);
+    private _surfaceDisposable;
+    constructor(_domLayerService: BoardDomLayerService, _editService: BoardElementEditService, _elementStateService: IBoardElementStateService, _elementService: IBoardElementService, _instanceService: IUniverInstanceService, _interactionSurfaceService: BoardInteractionSurfaceService);
     dispose(): void;
     close(): void;
     openFocusedLaneRenamePopup(): boolean;

package/lib/types/utils/board-clipboard.util.d.ts

@@ -1,4 +1,4 @@
-import type { IBoardElementData, IUpdateBoardElementsOperationItem } from '@univerjs-pro/boards';
+import type { IBoardElementData, IUpdateBoardElementsCommandItem } from '@univerjs-pro/boards';
 export type BoardClipboardElement = IBoardElementData['element'];
 export interface IBoardClipboardPayload {
     elements: BoardClipboardElement[];
@@ -36,5 +36,5 @@ export interface ICreateBoardElementStyleUpdatesOptions {
 }
 export declare function createBoardElementClipboardPayload(options: ICreateBoardElementClipboardPayloadOptions): IBoardClipboardPayload | null;
 export declare function createBoardElementStylePayload(element: BoardClipboardElement | undefined): IBoardElementStylePayload | null;
-export declare function createBoardElementStyleUpdates(options: ICreateBoardElementStyleUpdatesOptions): IUpdateBoardElementsOperationItem[];
+export declare function createBoardElementStyleUpdates(options: ICreateBoardElementStyleUpdatesOptions): IUpdateBoardElementsCommandItem[];
 export declare function createBoardPasteElementsWithIdMap(options: ICreateBoardPasteElementsOptions): ICreateBoardPasteElementsWithIdMapResult;

package/lib/types/utils/board-connector-marker-anchor.util.d.ts

@@ -1,4 +1,4 @@
-import type { IBoardConnectorData, IBoardConnectorPoint, IBoardElementData } from '@univerjs-pro/boards';
+import type { BoardConnectorRouting, IBoardConnectorData, IBoardConnectorPoint, IBoardElementData } from '@univerjs-pro/boards';
 import type { BoardConnectorPathCommand } from './board-connector-routing.util';
 export interface IBoardConnectorMarkerAnchor {
     point: IBoardConnectorPoint;
@@ -14,4 +14,4 @@ export interface IResolveBoardConnectorMarkerAnchorsOptions {
     endpointGap?: number;
 }
 export declare const BOARD_CONNECTOR_ENDPOINT_VISUAL_GAP = 5;
-export declare function resolveBoardConnectorMarkerAnchors(routing: string, points: readonly IBoardConnectorPoint[], pathCommands: readonly BoardConnectorPathCommand[], options?: IResolveBoardConnectorMarkerAnchorsOptions): IBoardConnectorMarkerAnchors | null;
+export declare function resolveBoardConnectorMarkerAnchors(_routing: BoardConnectorRouting, points: readonly IBoardConnectorPoint[], pathCommands: readonly BoardConnectorPathCommand[], options?: IResolveBoardConnectorMarkerAnchorsOptions): IBoardConnectorMarkerAnchors | null;

package/lib/types/utils/board-connector-quick-connect.util.d.ts

@@ -1,6 +1,7 @@
 import type { BoardConnectorRouting, IBoardConnectorElement, IBoardConnectorEndpoint, IBoardConnectorPoint, IBoardConnectorStyle, IBoardElementData, IBoardShapeElement } from '@univerjs-pro/boards';
 import { ShapeTypeEnum } from '@univerjs-pro/engine-shape';
 export declare const BOARD_QUICK_CONNECT_GAP = 200;
+export declare const BOARD_QUICK_CONNECT_SIBLING_GAP = 40;
 export interface ICreateBoardConnectorQuickConnectElementsOptions {
     sourceEndpoint: IBoardConnectorEndpoint;
     sourcePoint: IBoardConnectorPoint;

package/lib/types/utils/board-connector-routing.util.d.ts

@@ -23,6 +23,14 @@ export type BoardConnectorPathCommand = {
     control2: IBoardConnectorPoint;
     point: IBoardConnectorPoint;
 };
+export interface IBoardConnectorPathEndpointGeometry {
+    point: IBoardConnectorPoint;
+    tangent: IBoardConnectorPoint | null;
+}
+export interface IBoardConnectorPathGeometry {
+    start: IBoardConnectorPathEndpointGeometry;
+    end: IBoardConnectorPathEndpointGeometry;
+}
 export interface IResolveBoardConnectorEndpointPointOptions {
     elementData?: Record<string, IBoardElementData>;
     connectorId?: string;
@@ -46,6 +54,14 @@ export declare function normalizeBoardConnectorEndpointManualRoutePoints(connect
 export declare function resolveBoardConnectorRoutePoints(connectorData: IBoardConnectorData, options?: IResolveBoardConnectorRoutePointsOptions): IBoardConnectorPoint[];
 export declare function resolveBoardConnectorPathCommands(connectorData: IBoardConnectorData, options?: IResolveBoardConnectorRoutePointsOptions): BoardConnectorPathCommand[];
 export declare function resolveBoardConnectorPathBounds(commands: readonly BoardConnectorPathCommand[], fallbackTransform?: IBoardElementTransform): IBoardConnectorRouteBounds;
+/**
+ * Resolves marker-facing endpoint tangents from the final rendered path.
+ *
+ * The start tangent points backward from the route into the start marker; the end tangent points forward from the
+ * route into the end marker. Repeated points and coincident Bézier handles are skipped so callers never need a
+ * routing-specific marker rule or an arbitrary axis fallback.
+ */
+export declare function resolveBoardConnectorPathGeometry(commands: readonly BoardConnectorPathCommand[]): IBoardConnectorPathGeometry | null;
 export declare function trimBoardConnectorPathCommands(commands: readonly BoardConnectorPathCommand[], startTrim: number, endTrim: number): BoardConnectorPathCommand[];
 export declare function hitTestBoardConnectorPath(point: IBoardConnectorPoint, commands: readonly BoardConnectorPathCommand[], tolerance: number): boolean;
 export declare function resolveBoardConnectorRouteBounds(points: readonly IBoardConnectorPoint[], fallbackTransform?: IBoardElementTransform): IBoardConnectorRouteBounds;

package/lib/types/utils/board-container-membership-update.util.d.ts

@@ -1,10 +1,15 @@
-import type { IBoardElementData, IUpdateBoardElementsOperationItem } from '@univerjs-pro/boards';
+import type { IBoardElementData, IUpdateBoardElementsCommandItem } from '@univerjs-pro/boards';
 import type { IBoardElementSpatialIndex } from './board-container-spatial-index.util';
 export interface IResolveBoardContainerMembershipUpdateItemsOptions {
     elementData: Record<string, IBoardElementData>;
     elementOrder?: readonly string[];
-    updates: readonly IUpdateBoardElementsOperationItem[];
+    updates: readonly IUpdateBoardElementsCommandItem[];
     forceCaptureElementIds?: readonly string[];
     spatialIndex?: IBoardElementSpatialIndex;
+    mode?: BoardContainerMembershipUpdateMode;
 }
-export declare function resolveBoardContainerMembershipUpdateItems(options: IResolveBoardContainerMembershipUpdateItemsOptions): IUpdateBoardElementsOperationItem[];
+export declare enum BoardContainerMembershipUpdateMode {
+    Spatial = "spatial",
+    Preserve = "preserve"
+}
+export declare function resolveBoardContainerMembershipUpdateItems(options: IResolveBoardContainerMembershipUpdateItemsOptions): IUpdateBoardElementsCommandItem[];

package/lib/types/utils/board-floating-toolbar-selection.util.d.ts

@@ -0,0 +1,28 @@
+import type { BoardConnectorRouting, IBoardConnectorStyle, IBoardElementData } from '@univerjs-pro/boards';
+import type { IShapeData } from '@univerjs-pro/engine-shape';
+export type BoardFloatingToolbarOwner = 'common' | 'connector' | 'mind-map' | 'none' | 'shape' | 'table';
+export interface IBoardFloatingToolbarSelection {
+    elements: IBoardElementData[];
+    owner: BoardFloatingToolbarOwner;
+}
+export interface IResolveBoardFloatingToolbarSelectionOptions {
+    context: {
+        unitId: string;
+        subUnitId: string;
+    } | null;
+    selectedIds: readonly string[];
+    getElementById: (unitId: string, subUnitId: string, elementId: string) => IBoardElementData | null | undefined;
+}
+/**
+ * Resolves one owner for the selection-level floating toolbar.
+ *
+ * Shape and connector toolbars support field-level batch updates. Other
+ * homogeneous multi-selections use the common toolbar until their commands are
+ * batch-safe, which prevents a type toolbar from silently editing only one item.
+ */
+export declare function resolveBoardFloatingToolbarSelection(options: IResolveBoardFloatingToolbarSelectionOptions): IBoardFloatingToolbarSelection;
+export declare function resolveCommonBoardShapeData(elements: readonly IBoardElementData[]): IShapeData | undefined;
+export declare function resolveChangedBoardShapeDataPatch(previous: IShapeData | undefined, next: IShapeData | undefined): IShapeData | undefined;
+export declare function mergeBoardShapeDataPatch(current: IShapeData, patch: IShapeData): IShapeData;
+export declare function resolveCommonBoardConnectorStyle(elements: readonly IBoardElementData[]): Partial<IBoardConnectorStyle>;
+export declare function resolveCommonBoardConnectorRouting(elements: readonly IBoardElementData[]): BoardConnectorRouting | undefined;

package/lib/types/utils/board-insert.util.d.ts

@@ -11,6 +11,7 @@ export interface IBoardInsertRect {
     height: number;
 }
 export declare function resolveBoardContainerDragInsertRect(start: IBoardInsertPoint, end: IBoardInsertPoint): IBoardInsertRect;
+export declare function resolveBoardPendingInsertDragRect(pendingInsert: IBoardPendingInsert, start: IBoardInsertPoint, end: IBoardInsertPoint): IBoardInsertRect | null;
 export declare function createBoardElementFromPendingInsert(options: {
     pendingInsert: IBoardPendingInsert | null;
     point: IBoardInsertPoint;

package/lib/types/utils/board-selection-interaction.util.d.ts

@@ -11,6 +11,7 @@ export interface IResolveBoardElementDragSelectionOptions {
     elementOrder: string[];
     start: IBoardSelectionPoint;
     end: IBoardSelectionPoint;
+    dragSelection: boolean;
     preciseSelection: boolean;
     spatialIndex?: IBoardElementSpatialIndex;
 }

package/lib/types/utils/board-selection-move.util.d.ts

@@ -8,10 +8,9 @@ export interface IBoardElementSelectionMoveResult {
     element: IBoardElementData['element'];
     transform: IBoardElementData['transform'];
 }
-export type IBoardElementSelectionMoveDelta = IBoardSelectionMoveDelta;
 export interface IResolveBoardElementSelectionMoveOptions {
     selectedIds: string[];
     elementData: Record<string, IBoardElementData>;
-    delta: IBoardElementSelectionMoveDelta;
+    delta: IBoardSelectionMoveDelta;
 }
 export declare function resolveBoardElementSelectionMove(options: IResolveBoardElementSelectionMoveOptions): IBoardElementSelectionMoveResult[];

package/lib/types/utils/board-shape-editor.util.d.ts

@@ -2,6 +2,7 @@ import type { IBoardElementData, IBoardPageElement, IBoardTextElement } from '@u
 import type { IShapeData } from '@univerjs-pro/engine-shape';
 import type { IDocumentData } from '@univerjs/core';
 export declare function isBoardShapeEditableElement(element: IBoardPageElement): boolean;
+export declare function isBoardShapeTextEditableElement(element: IBoardPageElement): boolean;
 export declare function isManagedBoardMindMapNode(elementData: IBoardElementData | undefined): boolean;
 export declare function getBoardElementShapeData(element: IBoardPageElement): IShapeData | null;
 export declare function createBoardTextShapeData(element: IBoardTextElement): IShapeData;

package/lib/types/utils/board-shortcut-preconditions.util.d.ts

@@ -1,3 +1,4 @@
-import type { IContextService } from '@univerjs/core';
+import type { IContextService, IUniverInstanceService } from '@univerjs/core';
 import type { IBoardElementStateService } from '../services/board-element-state.service';
-export declare function isBoardShortcutAvailable(contextService: IContextService, elementStateService: IBoardElementStateService): boolean;
+export declare function isBoardKeyboardOwner(instanceService: IUniverInstanceService, boardUnitId: string): boolean;
+export declare function isBoardShortcutAvailable(contextService: IContextService, elementStateService: IBoardElementStateService, instanceService: IUniverInstanceService): boolean;

package/lib/types/utils/board-viewport.util.d.ts

@@ -1,5 +1,7 @@
-export declare const BOARD_MIN_ZOOM_RATIO = 0.1;
+export declare const BOARD_MIN_ZOOM_RATIO = 0.02;
 export declare const BOARD_MAX_ZOOM_RATIO = 4;
+export declare const BOARD_DEFAULT_ZOOM_RATIO = 1;
+export declare const BOARD_VIEWPORT_FIT_PADDING = 96;
 export interface IBoardViewportPoint {
     x: number;
     y: number;

package/lib/types/views/BoardCanvasView.d.ts

@@ -1 +1,5 @@
-export declare function BoardCanvasView(): import("react").JSX.Element;
+import { IBoardEmbedRuntimeFocusCoordinator } from '../services/board-embed-integration.service';
+export declare function BoardCanvasView(props?: {
+    fitOnMount?: boolean;
+}): import("react").JSX.Element;
+export declare function shouldFocusBoardForPointerEvent(boardUnitId: string | undefined, target: EventTarget | null, event: Event, embedRuntimeFocusCoordinator?: IBoardEmbedRuntimeFocusCoordinator): boolean;

package/lib/types/views/BoardConnectorFloatingToolbar.d.ts

@@ -1,17 +1,14 @@
 import type { IBoardConnectorStyle } from '@univerjs-pro/boards';
 import type { IShapeData } from '@univerjs-pro/engine-shape';
 export declare const BOARD_CONNECTOR_FLOATING_TOOLBAR_KEY = "board.connector.floating-toolbar";
-interface IBoardConnectorFloatingToolbarExtraProps {
-    unitId: string;
-    subUnitId: string;
-    elementId: string;
-}
-interface IBoardConnectorFloatingToolbarProps {
-    popup: {
-        extraProps?: IBoardConnectorFloatingToolbarExtraProps;
-    };
-}
 export declare function connectorStyleToShapeStrokeData(style: IBoardConnectorStyle): IShapeData;
 export declare function shapeStrokeToBoardConnectorStylePatch(shapeData?: IShapeData): Partial<IBoardConnectorStyle>;
-export declare function BoardConnectorFloatingToolbar({ popup }: IBoardConnectorFloatingToolbarProps): import("react").JSX.Element | null;
-export {};
+export declare function BoardConnectorFloatingToolbar({ popup }: {
+    popup: {
+        extraProps?: {
+            unitId: string;
+            subUnitId: string;
+            elementId: string;
+        };
+    };
+}): import("react").JSX.Element | null;

package/lib/types/views/BoardShapeFloatingToolbar.d.ts

@@ -6,6 +6,7 @@ interface IBoardShapeFloatingToolbarExtraProps {
     elementId: string;
     shapeType?: ShapeTypeEnum;
     shapeData?: IShapeData;
+    selectionOnly?: boolean;
 }
 interface IBoardShapeFloatingToolbarProps {
     popup: {