@univerjs/ui 1.0.0-rc.0 → 1.0.0

package/lib/locale/ar-SA.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/ar-SA.ts
 const locale = { ui: {
+	clearFormatting: "مسح التنسيق",
+	formatPainter: "نسخ التنسيق",
 	accessibility: {
 		menu: "القائمة",
 		zoom: "التكبير والتصغير",

package/lib/locale/ca-ES.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/ca-ES.ts
 const locale = { ui: {
+	clearFormatting: "Esborra el format",
+	formatPainter: "Copia el format",
 	accessibility: {
 		menu: "Menú",
 		zoom: "Zoom",

package/lib/locale/de-DE.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/de-DE.ts
 const locale = { ui: {
+	clearFormatting: "Formatierung löschen",
+	formatPainter: "Format übertragen",
 	accessibility: {
 		menu: "Menü",
 		zoom: "Zoom",

package/lib/locale/en-US.js

@@ -7372,6 +7372,8 @@ const emojiLocale = {
 * limitations under the License.
 */
 const locale = { ui: {
+	clearFormatting: "Clear formatting",
+	formatPainter: "Format Painter",
 	accessibility: {
 		menu: "Menu",
 		zoom: "Zoom",

package/lib/locale/es-ES.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/es-ES.ts
 const locale = { ui: {
+	clearFormatting: "Borrar formato",
+	formatPainter: "Copiar formato",
 	accessibility: {
 		menu: "Menú",
 		zoom: "Zoom",

package/lib/locale/fa-IR.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/fa-IR.ts
 const locale = { ui: {
+	clearFormatting: "پاک کردن قالب‌بندی",
+	formatPainter: "کپی قالب‌بندی",
 	accessibility: {
 		menu: "منو",
 		zoom: "بزرگ‌نمایی",

package/lib/locale/fr-FR.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/fr-FR.ts
 const locale = { ui: {
+	clearFormatting: "Effacer la mise en forme",
+	formatPainter: "Reproduire la mise en forme",
 	accessibility: {
 		menu: "Menu",
 		zoom: "Zoom",

package/lib/locale/id-ID.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/id-ID.ts
 const locale = { ui: {
+	clearFormatting: "Hapus pemformatan",
+	formatPainter: "Salin Format",
 	accessibility: {
 		menu: "Menu",
 		zoom: "Zoom",

package/lib/locale/it-IT.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/it-IT.ts
 const locale = { ui: {
+	clearFormatting: "Cancella formattazione",
+	formatPainter: "Copia formato",
 	accessibility: {
 		menu: "Menu",
 		zoom: "Zoom",

package/lib/locale/ja-JP.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/ja-JP.ts
 const locale = { ui: {
+	clearFormatting: "書式をクリア",
+	formatPainter: "書式のコピー",
 	accessibility: {
 		menu: "メニュー",
 		zoom: "ズーム",

package/lib/locale/ko-KR.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/ko-KR.ts
 const locale = { ui: {
+	clearFormatting: "서식 지우기",
+	formatPainter: "서식 복사",
 	accessibility: {
 		menu: "메뉴",
 		zoom: "확대/축소",

package/lib/locale/pl-PL.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/pl-PL.ts
 const locale = { ui: {
+	clearFormatting: "Wyczyść formatowanie",
+	formatPainter: "Malarz formatów",
 	accessibility: {
 		menu: "Menu",
 		zoom: "Powiększenie",

package/lib/locale/pt-BR.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/pt-BR.ts
 const locale = { ui: {
+	clearFormatting: "Limpar formatação",
+	formatPainter: "Pincel de Formatação",
 	accessibility: {
 		menu: "Menu",
 		zoom: "Zoom",

package/lib/locale/ru-RU.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/ru-RU.ts
 const locale = { ui: {
+	clearFormatting: "Очистить форматирование",
+	formatPainter: "Формат по образцу",
 	accessibility: {
 		menu: "Меню",
 		zoom: "Масштаб",

package/lib/locale/sk-SK.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/sk-SK.ts
 const locale = { ui: {
+	clearFormatting: "Vymazať formátovanie",
+	formatPainter: "Kopírovať formát",
 	accessibility: {
 		menu: "Ponuka",
 		zoom: "Priblíženie",

package/lib/locale/vi-VN.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/vi-VN.ts
 const locale = { ui: {
+	clearFormatting: "Xóa định dạng",
+	formatPainter: "Sao chép định dạng",
 	accessibility: {
 		menu: "Trình đơn",
 		zoom: "Thu phóng",

package/lib/locale/zh-CN.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/zh-CN.ts
 const locale = { ui: {
+	clearFormatting: "清除格式",
+	formatPainter: "格式刷",
 	accessibility: {
 		menu: "菜单",
 		zoom: "缩放",

package/lib/locale/zh-HK.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/zh-HK.ts
 const locale = { ui: {
+	clearFormatting: "清除格式",
+	formatPainter: "複製格式",
 	accessibility: {
 		menu: "選單",
 		zoom: "縮放",

package/lib/locale/zh-TW.js

@@ -7357,6 +7357,8 @@ const emojiLocale = {
 //#endregion
 //#region src/locale/zh-TW.ts
 const locale = { ui: {
+	clearFormatting: "清除格式",
+	formatPainter: "複製格式",
 	accessibility: {
 		menu: "選單",
 		zoom: "縮放",

package/lib/types/controllers/format-painter.controller.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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, IOperation } from '@univerjs/core';
+import { Disposable, ICommandService, IUniverInstanceService } from '@univerjs/core';
+import { FormatPainterSessionService } from '../services/format-painter/format-painter-session.service';
+import { IShortcutService } from '../services/shortcut/shortcut.service';
+export declare const ActivateFormatPainterOperation: IOperation;
+export declare const ContinuousFormatPainterOperation: IOperation;
+export declare const ClearFormattingCommand: ICommand;
+export declare class FormatPainterController extends Disposable {
+    constructor(session: FormatPainterSessionService, commandService: ICommandService, shortcutService: IShortcutService, instanceService: IUniverInstanceService);
+}

package/lib/types/facade/f-menu-builder.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { MenuSchemaType } from '@univerjs/ui';
+import type { IRibbonGridLayout, MenuSchemaType } from '@univerjs/ui';
 import { ICommandService, Injector } from '@univerjs/core';
 import { FBase } from '@univerjs/core/facade';
 import { IMenuManagerService, MenuManagerPosition, RibbonPosition, RibbonStartGroup } from '@univerjs/ui';
@@ -46,6 +46,8 @@ export interface IFacadeMenuItem {
      * The order of the menu item in the submenu.
      */
     order?: number;
+    /** Placement within a ribbon group when ribbonType is 'grid'. */
+    gridLayout?: IRibbonGridLayout;
 }
 /**
  * @ignore
@@ -71,6 +73,8 @@ export interface IFacadeSubmenuItem {
      * The order of the menu item in the submenu.
      */
     order?: number;
+    /** Placement within a ribbon group when ribbonType is 'grid'. */
+    gridLayout?: IRibbonGridLayout;
 }
 /**
  * @ignore
@@ -125,8 +129,17 @@ export declare class FMenu extends FMenuBase {
     protected readonly _injector: Injector;
     protected readonly _commandService: ICommandService;
     protected readonly _menuManagerService: IMenuManagerService;
+    /**
+     * Built-in group identifiers for placing items on the Start ribbon tab.
+     */
     static RibbonStartGroup: typeof RibbonStartGroup;
+    /**
+     * Built-in ribbon tab identifiers for menu placement.
+     */
     static RibbonPosition: typeof RibbonPosition;
+    /**
+     * Top-level menu placement identifiers for the ribbon and context menu.
+     */
     static MenuManagerPosition: typeof MenuManagerPosition;
     private _commandToRegister;
     private _buildingSchema;

package/lib/types/facade/f-univer.d.ts

@@ -15,7 +15,7 @@
  */
 import type { IDisposable } from '@univerjs/core';
 import type { IMessageProps } from '@univerjs/design';
-import type { BuiltInUIPart, ComponentType, IComponentOptions, IDialogPartMethodOptions, IFontConfig, ISidebarMethodOptions, RibbonType } from '@univerjs/ui';
+import type { BuiltInUIPart, ComponentType, IComponentOptions, IDialogPartMethodOptions, IFontConfig, ISidebarMethodOptions, MenuConfig, RibbonType } from '@univerjs/ui';
 import type { IFacadeMenuItem, IFacadeSubmenuItem } from './f-menu-builder';
 import { FUniver } from '@univerjs/core/facade';
 import { ComponentManager } from '@univerjs/ui';
@@ -135,7 +135,7 @@ export interface IFUniverUIMixin {
      * @param {IFacadeMenuItem} menuItem the menu item
      * @returns the {@link FMenu} object
      * @example
-     * ```ts
+     * ```tsx
      * // Univer Icon can be viewed at https://docs.univer.ai/icons
      * import { SmileIcon } from '@univerjs/icons'
      *
@@ -214,6 +214,29 @@ export interface IFUniverUIMixin {
      * ```
      */
     createSubmenu(submenuItem: IFacadeSubmenuItem): FSubmenu;
+    /**
+     * Merge menu overrides and refresh the UI immediately. Overrides also apply to menus registered later.
+     * Use the same configuration as the UI plugin or preset's `menu` option.
+     * @param {MenuConfig} config Overrides keyed by menu item ID, ribbon tab key, or ribbon group key.
+     * Unspecified properties keep their current values. Lower `order` values come first among siblings.
+     * `gridLayout` applies only to the grid ribbon and uses 1-based positions within a two-row group.
+     * @returns the {@link FUniver} instance for chaining
+     * @example
+     * ```ts
+     * univerAPI.updateMenuConfig({
+     *   'ribbon.insert': { order: -1 },
+     *   'ribbon.start.format': { order: -1 },
+     *   'sheet.command.set-range-bold': {
+     *     order: 0,
+     *     gridLayout: { row: 2, column: 2, showLabel: true, width: 80 },
+     *   },
+     *   'sheet.command.set-range-italic': {
+     *     gridLayout: { row: 2, column: 1 },
+     *   },
+     * });
+     * ```
+     */
+    updateMenuConfig(config: MenuConfig): FUniver;
     /**
      * Open a sidebar.
      * @param {ISidebarMethodOptions} params the sidebar options
@@ -244,7 +267,7 @@ export interface IFUniverUIMixin {
      * @param {IDialogPartMethodOptions} dialog the dialog options
      * @returns {IDisposable} the disposable object
      * @example
-     * ```ts
+     * ```tsx
      * import { Button } from '@univerjs/design';
      *
      * univerAPI.openDialog({
@@ -284,6 +307,7 @@ export interface IFUniverUIMixin {
     /**
      * Show a message.
      * @returns {FUniver} the {@link FUniver} instance for chaining
+     * @param {IMessageProps} options Message content, type, duration, and other display options.
      * @example
      * ```ts
      * univerAPI.showMessage({
@@ -309,7 +333,7 @@ export interface IFUniverUIMixin {
      * @param {BuiltInUIPart} key the built-in UI part
      * @param {boolean} visible the visibility
      * @returns the {@link FUniver} instance for chaining
-     * example
+     * @example
      * ```ts
      * // Hide header, footer, and toolbar
      * univerAPI.setUIVisible(univerAPI.Enum.BuiltInUIPart.HEADER, false)
@@ -354,7 +378,7 @@ export interface IFUniverUIMixin {
      * @param {IComponentOptions} [options] - The options of the component.
      * @returns {IDisposable} The disposable object.
      * @example
-     * ```ts
+     * ```tsx
      * const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
      * if (!fWorksheet) return;
      *
@@ -438,6 +462,7 @@ export declare class FUniverUIMixin extends FUniver implements IFUniverUIMixin {
     paste(): Promise<boolean>;
     createMenu(menuItem: IFacadeMenuItem): FMenu;
     createSubmenu(submenuItem: IFacadeSubmenuItem): FSubmenu;
+    updateMenuConfig(config: MenuConfig): FUniver;
     openSidebar(params: ISidebarMethodOptions): IDisposable;
     openDialog(dialog: IDialogPartMethodOptions): IDisposable;
     getComponentManager(): ComponentManager;

package/lib/types/index.d.ts

@@ -48,6 +48,9 @@ export { CanvasFloatDomPreviewService, CanvasFloatDomService } from './services/
 export type { ICanvasFloatDomPreview, ICanvasFloatDomPreviewRequest, IFloatDom, IFloatDomLayout, } from './services/dom/canvas-dom-layer.service';
 export { FontService, IFontService } from './services/font.service';
 export type { IFontConfig } from './services/font.service';
+export { bindFormatPainterCanvas } from './services/format-painter/format-painter-canvas';
+export { FormatPainterSessionService } from './services/format-painter/format-painter-session.service';
+export type { IFormatPainterTarget } from './services/format-painter/format-painter-session.service';
 export { DesktopGalleryService } from './services/gallery/desktop-gallery.service';
 export { IGalleryService } from './services/gallery/gallery.service';
 export { DesktopLayoutService, ILayoutService } from './services/layout/layout.service';
@@ -87,6 +90,7 @@ export { ThemeSwitcherService } from './services/theme-switcher/theme-switcher.s
 export { UndoRedoGroupService } from './services/undo-redo/undo-redo-group.service';
 export { IWorkbenchService, WorkbenchService } from './services/workbench/workbench.service';
 export * from './utils';
+export { MobileCanvasGesture } from './utils/mobile-canvas-gesture';
 export { COLOR_PICKER_COMPONENT } from './views/color-picker/interface';
 export { ComponentContainer, useComponentsOfPart } from './views/components/ComponentContainer';
 export type { IComponentContainerProps } from './views/components/ComponentContainer';
@@ -98,12 +102,14 @@ export { DesktopContextMenu as ContextMenu } from './views/components/context-me
 export { ContextMenuPanel } from './views/components/context-menu/ContextMenuPanel';
 export { MobileContextMenu } from './views/components/context-menu/MobileContextMenu';
 export { type IDialogPartMethodOptions } from './views/components/dialog-part/interface';
+export type { IMobileDialogPartMethodOptions } from './views/components/dialog-part/MobileDialogPart';
 export { FloatDomSingle } from './views/components/dom/FloatDom';
 export { FloatDom } from './views/components/dom/FloatDom';
 export { PrintFloatDomSingle } from './views/components/dom/Print';
 export { HOVER_TRACK_HOST_CLASS_NAME, HoverTrack } from './views/components/hover-track/HoverTrack';
 export { MobileDrawer } from './views/components/mobile-drawer/MobileDrawer';
 export type { MobileDrawerSnap } from './views/components/mobile-drawer/MobileDrawer';
+export { MobileZoomIndicator } from './views/components/mobile-zoom-indicator/mobile-zoom-indicator';
 export { CanvasPopup, SingleCanvasPopup } from './views/components/popup/CanvasPopup';
 export { RectPopup } from './views/components/popup/RectPopup';
 export type { RectPopupDirection } from './views/components/popup/RectPopup';
@@ -111,6 +117,7 @@ export { useToolbarItemStatus } from './views/components/ribbon/hook';
 export { Ribbon } from './views/components/ribbon/Ribbon';
 export { ToolbarButton } from './views/components/ribbon/ToolbarButton';
 export { ToolbarItem } from './views/components/ribbon/ToolbarItem';
+export type { IMobileSidebarMethodOptions } from './views/components/sidebar/MobileSidebar';
 export { Sidebar } from './views/components/sidebar/Sidebar';
 export type { ISidebarMethodOptions } from './views/components/sidebar/Sidebar';
 export { FONT_FAMILY_COMPONENT, FontFamily } from './views/font-family/FontFamily';
@@ -119,6 +126,7 @@ export { FontFamilyDropdown } from './views/font-family/FontFamilyDropdown';
 export type { IFontFamilyDropdownProps } from './views/font-family/FontFamilyDropdown';
 export { FONT_FAMILY_ITEM_COMPONENT, FontFamilyItem } from './views/font-family/FontFamilyItem';
 export type { IFontFamilyItemProps } from './views/font-family/FontFamilyItem';
+export { MobileFontFamilyDropdown } from './views/font-family/MobileFontFamilyDropdown';
 export { FontSize } from './views/font-size/FontSize';
 export { FONT_SIZE_COMPONENT, FONT_SIZE_LIST, HEADING_LIST } from './views/font-size/interface';
 export * from './views/hooks/index';
@@ -126,6 +134,8 @@ export { preventBrowserZoomInContainers } from './views/hooks/prevent-browser-zo
 export * from './views/index';
 export { MobileMenu } from './views/menu/mobile/MobileMenu';
 export { MobileKeyboardInsetContext } from './views/mobile-workbench/mobile-keyboard-inset-context';
+export { getMobileCanvasPanDelta, useMobileCanvasPanel, useMobileCanvasViewport } from './views/mobile-workbench/MobileCanvasLayout';
+export type { MobilePanelLayout } from './views/mobile-workbench/MobileCanvasLayout';
 export type { INotificationOptions } from './views/notification/Notification';
 export { ObjectPermissionButton, openObjectPermissionDialog } from './views/object-permission/ObjectPermissionButton';
 export type { IObjectPermissionButtonProps } from './views/object-permission/ObjectPermissionButton';

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

@@ -15,6 +15,8 @@
  */
 declare const locale: {
     ui: {
+        clearFormatting: string;
+        formatPainter: string;
         accessibility: {
             menu: string;
             zoom: string;

package/lib/types/menu/format-painter.menu.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 { IAccessor } from '@univerjs/core';
+import type { IMenuButtonItem } from '../services/menu/menu';
+export declare function FormatPainterMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
+export declare function ClearFormattingMenuItemFactory(accessor: IAccessor): IMenuButtonItem;

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

@@ -18,6 +18,7 @@ import type { IMouseEvent } from '@univerjs/engine-render';
 import { Disposable } from '@univerjs/core';
 export interface IContextMenuTriggerContext {
     autoFocus?: boolean;
+    caretAnchor?: boolean;
     unitId?: string;
     subUnitId?: string;
 }

package/lib/types/services/format-painter/format-painter-canvas.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 { IDisposable } from '@univerjs/core';
+import type { FormatPainterSessionService, IFormatPainterTarget } from './format-painter-session.service';
+export declare const FORMAT_PAINTER_CURSOR_CSS = "\n/* Keep the brush visible while the render engine updates its usual object/text cursors. */\ncanvas[data-format-painter=\"available\"] {\n    cursor: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='28' height='28' viewBox='0 0 28 28'%3E%3Cpath d='M2 1v18l4-4 3 7 3-2-3-6h6z' fill='white' stroke='black'/%3E%3Cpath d='m17 13 8-10 2 2-8 10z' fill='white' stroke='black'/%3E%3Cpath d='M17 14c-4 0-2 5-6 6 5 2 10-1 8-5z' fill='black' stroke='white'/%3E%3C/svg%3E\") 2 1, crosshair !important;\n}\ncanvas[data-format-painter=\"unavailable\"] {\n    cursor: not-allowed !important;\n}\n";
+interface IFormatPainterCanvasOptions {
+    adapterId: string;
+    unitId: string;
+    getUnitId?(): string;
+    /** Object painting consumes the gesture before selection/transform handlers run. */
+    intercept: boolean;
+    getTarget(event: PointerEvent): IFormatPainterTarget | null;
+}
+export declare function bindFormatPainterCanvas(canvas: HTMLCanvasElement, session: FormatPainterSessionService, options: IFormatPainterCanvasOptions): IDisposable;
+export {};

package/lib/types/services/format-painter/format-painter-session.service.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 { IDisposable, IRange } from '@univerjs/core';
+import type { Observable } from 'rxjs';
+import { Disposable } from '@univerjs/core';
+export type FormatPainterMode = 'off' | 'once' | 'continuous';
+export interface IFormatPainterTarget {
+    unitId: string;
+    subUnitId?: string;
+    shapeId?: string;
+    range?: IRange;
+}
+export interface IFormatPainterSource {
+    unitId: string;
+    apply(target: IFormatPainterTarget): boolean | Promise<boolean>;
+    onModeChange?(mode: FormatPainterMode): void;
+}
+export interface IFormatPainterAdapter {
+    id: string;
+    priority: number;
+    changes$: Observable<unknown>;
+    /** Claim the editing context even when its selection cannot be sampled. */
+    isActive(): boolean;
+    canStart(): boolean;
+    capture(): IFormatPainterSource | null;
+    clear?(): boolean | Promise<boolean>;
+}
+/** One local interaction session; domain commands retain ownership of persisted formatting. */
+export declare class FormatPainterSessionService extends Disposable {
+    private readonly _adapters;
+    private readonly _state$;
+    readonly state$: Observable<FormatPainterMode>;
+    private _session;
+    private _applying;
+    get mode(): FormatPainterMode;
+    get unitId(): string | undefined;
+    register(adapter: IFormatPainterAdapter): IDisposable;
+    refresh(): void;
+    canStart(): boolean;
+    isActive(adapterId: string): boolean;
+    canClear(): boolean;
+    clearFormatting(): Promise<boolean>;
+    activate(continuous?: boolean): boolean;
+    apply(adapterId: string, target: IFormatPainterTarget): Promise<boolean>;
+    cancel(): void;
+    private _setMode;
+    dispose(): void;
+}

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

@@ -15,19 +15,27 @@
  */
 import type { IAccessor } from '@univerjs/core';
 import type { Observable } from 'rxjs';
-import type { IMenuItem } from './menu';
+import type { IMenuItem, MenuConfig } from './menu';
 import { Disposable, IConfigService, Injector } from '@univerjs/core';
 import { Subject } from 'rxjs';
 export declare const IMenuManagerService: import("@wendellhu/redi").IdentifierDecorator<IMenuManagerService>;
 export type ContextMenuQuickLayout = 'icon' | 'tile';
 export type ContextMenuQuickLayoutVariant = 'default' | 'compact';
+export type MobileMenuLayout = 'grid' | 'list';
 export interface IRibbonGridLayout {
+    /** 1-based row within the ribbon group's two rows. */
     row: number;
+    /** 1-based column within the ribbon group. */
     column: number;
+    /** Number of rows occupied. Defaults to 1; use 2 for a large button. */
     rowSpan?: number;
+    /** Number of columns occupied. Defaults to 1. */
     columnSpan?: number;
+    /** Whether to display the menu title alongside its icon. */
     showLabel?: boolean;
+    /** Width in pixels. */
     width?: number;
+    /** Icon size in pixels. */
     iconSize?: number;
 }
 export interface IMenuSchema {
@@ -41,6 +49,7 @@ export interface IMenuSchema {
     quickLayout?: ContextMenuQuickLayout;
     quickColumns?: number;
     quickLayoutVariant?: ContextMenuQuickLayoutVariant;
+    mobileLayout?: MobileMenuLayout;
     tiny?: boolean;
     gridLayout?: IRibbonGridLayout;
 }
@@ -48,6 +57,7 @@ export interface IMenuManagerService {
     readonly menuChanged$: Observable<void>;
     mergeMenu(source: MenuSchemaType, target?: MenuSchemaType): void;
     appendRootMenu(source: MenuSchemaType): void;
+    updateMenuConfig(config: MenuConfig): void;
     getMenuByPositionKey(position: string): IMenuSchema[];
     getFlatMenuByPositionKey(position: string): IMenuSchema[];
 }
@@ -61,6 +71,7 @@ export type MenuSchemaType = {
     quickLayout?: ContextMenuQuickLayout;
     quickColumns?: number;
     quickLayoutVariant?: ContextMenuQuickLayoutVariant;
+    mobileLayout?: MobileMenuLayout;
     tiny?: boolean;
     gridLayout?: IRibbonGridLayout;
 } | {
@@ -80,6 +91,7 @@ export declare class MenuManagerService extends Disposable implements IMenuManag
      */
     mergeMenu(source: MenuSchemaType, target?: MenuSchemaType): void;
     appendRootMenu(source: MenuSchemaType): void;
+    updateMenuConfig(config: MenuConfig): void;
     createScoped(injector: Injector): IMenuManagerService;
     private _buildMenuSchema;
     /**

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

@@ -15,6 +15,7 @@
  */
 import type { IAccessor } from '@univerjs/core';
 import type { Observable } from 'rxjs';
+import type { IRibbonGridLayout } from './menu-manager.service';
 export type OneOrMany<T> = T | T[];
 export declare enum MenuItemType {
     /** Button style menu item. */
@@ -103,7 +104,12 @@ export type MenuItemConfig<TLocaleKey extends string = string> = Partial<Omit<IM
     hidden?: boolean;
     disabled?: boolean;
     activated?: boolean;
+    /** Display order among sibling menu items, ribbon tabs, or groups. Lower values come first. */
+    order?: number;
+    /** Placement within a ribbon group when ribbonType is 'grid'. Rows and columns start at 1. */
+    gridLayout?: IRibbonGridLayout;
 }>;
+/** Overrides keyed by menu item ID, ribbon tab key, or ribbon group key. */
 export type MenuConfig<TLocaleKey extends string = string> = Record<string, MenuItemConfig<TLocaleKey>>;
 export type IMenuItemFactory<TLocaleKey extends string = string> = (accessor: IAccessor, menuConfig?: MenuConfig<TLocaleKey>) => IMenuItem<TLocaleKey>;
 export {};