@univerjs/ui 0.6.1 → 0.6.2

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

@@ -10,130 +10,367 @@ import { FShortcut } from './f-shortcut';
 export interface IFUniverUIMixin {
     /**
      * Return the URL of the current page.
-     * @returns the [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) object
+     * @returns {URL} the [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) object
+     * @example
+     * ```ts
+     * console.log(univerAPI.getURL());
+     * ```
      */
     getURL(): URL;
     /**
      * Get the Shortcut handler to interact with Univer's shortcut functionalities.
+     * @returns the {@link FShortcut} object
+     * @example
+     * ```ts
+     * const fShortcut = univerAPI.getShortcut();
+     *
+     * // Disable shortcuts of Univer
+     * fShortcut.disableShortcut();
+     *
+     * // Enable shortcuts of Univer
+     * fShortcut.enableShortcut();
+     *
+     * // Trigger a shortcut
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fRange = fWorksheet.getRange('A1');
+     * fRange.activate();
+     * fRange.setValue('Hello Univer');
+     * console.log(fRange.getCellStyle().bold); // false
+     * const pseudoEvent = new KeyboardEvent('keydown', {
+     *   key: 'b',
+     *   ctrlKey: true,
+     *   keyCode: univerAPI.Enum.KeyCode.B
+     * });
+     * const ifShortcutItem = fShortcut.triggerShortcut(pseudoEvent);
+     * if (ifShortcutItem) {
+     *   const commandId = ifShortcutItem.id;
+     *   console.log(fRange.getCellStyle().bold); // true
+     * }
+     * ```
      */
     getShortcut(): FShortcut;
     /**
      * Copy the current selected content of the currently focused unit into your system clipboard.
+     * @returns {Promise<boolean>} whether the copy operation is successful
+     * @example
+     * ```ts
+     * // Prevent failure due to loss of focus when executing copy and paste code in the console,
+     * // this example listens for the cell click event and executes the copy and paste code.
+     * univerAPI.addEvent(univerAPI.Event.CellClicked, async (params) => {
+     *   const fWorkbook = univerAPI.getActiveWorkbook();
+     *   const fWorksheet = fWorkbook.getActiveSheet();
+     *
+     *   // Copy the range A1:B2 to the clipboard
+     *   const fRange = fWorksheet.getRange('A1:B2');
+     *   fRange.activate().setValues([
+     *     [1, 2],
+     *     [3, 4]
+     *   ]);
+     *   await univerAPI.copy();
+     *
+     *   // Paste the copied content to the range C1:D2
+     *   const fRange2 = fWorksheet.getRange('C1');
+     *   fRange2.activate();
+     *   await univerAPI.paste();
+     *
+     *   // Check the pasted content
+     *   console.log(fWorksheet.getRange('C1:D2').getValues()); // [[1, 2], [3, 4]]
+     * });
+     * ```
      */
     copy(): Promise<boolean>;
     /**
      * Paste into the current selected position of the currently focused unit from your system clipboard.
+     * @returns {Promise<boolean>} whether the paste operation is successful
+     * @example
+     * ```ts
+     * // Prevent failure due to loss of focus when executing copy and paste code in the console,
+     * // this example listens for the cell click event and executes the copy and paste code.
+     * univerAPI.addEvent(univerAPI.Event.CellClicked, async (params) => {
+     *   const fWorkbook = univerAPI.getActiveWorkbook();
+     *   const fWorksheet = fWorkbook.getActiveSheet();
+     *
+     *   // Copy the range A1:B2 to the clipboard
+     *   const fRange = fWorksheet.getRange('A1:B2');
+     *   fRange.activate().setValues([
+     *     [1, 2],
+     *     [3, 4]
+     *   ]);
+     *   await univerAPI.copy();
+     *
+     *   // Paste the copied content to the range C1:D2
+     *   const fRange2 = fWorksheet.getRange('C1');
+     *   fRange2.activate();
+     *   await univerAPI.paste();
+     *
+     *   // Check the pasted content
+     *   console.log(fWorksheet.getRange('C1:D2').getValues()); // [[1, 2], [3, 4]]
+     * });
+     * ```
      */
     paste(): Promise<boolean>;
     /**
      * Create a menu build object. You can insert new menus into the UI.
      * @param {IFacadeMenuItem} menuItem the menu item
+     * @returns the {@link FMenu} object
      * @example
      * ```ts
+     * // Univer Icon can be viewed at https://univer.ai/en-US/icons
+     * import { SmileSingle } from '@univerjs/icons'
+     *
+     * // Create a custom menu with an univer icon
+     * univerAPI.registerComponent('custom-menu-icon', SmileSingle);
      * univerAPI.createMenu({
      *   id: 'custom-menu',
+     *   icon: 'custom-menu-icon',
      *   title: 'Custom Menu',
-     *   action: () => {},
+     *   tooltip: 'Custom Menu Tooltip',
+     *   action: () => {
+     *     console.log('Custom Menu Clicked');
+     *   },
+     * }).appendTo('ribbon.start.others');
+     *
+     * // Or
+     * // Create a custom menu with an image icon
+     * univerAPI.registerComponent('custom-menu-icon', () => {
+     *   return <img src="https://avatars.githubusercontent.com/u/61444807?s=48&v=4" alt="" style={{ width: '16px', height: '16px' }} />;
+     * });
+     * univerAPI.createMenu({
+     *   id: 'custom-menu',
+     *   icon: 'custom-menu-icon',
+     *   title: 'Custom Menu',
+     *   tooltip: 'Custom Menu Tooltip',
+     *   action: () => {
+     *     console.log('Custom Menu Clicked');
+     *   },
+     * }).appendTo('ribbon.start.others');
+     *
+     * // Or
+     * // Create a custom menu without an icon
+     * univerAPI.createMenu({
+     *   id: 'custom-menu',
+     *   title: 'Custom Menu',
+     *   tooltip: 'Custom Menu Tooltip',
+     *   action: () => {
+     *     console.log('Custom Menu Clicked');
+     *   },
      * }).appendTo('ribbon.start.others');
      * ```
-     * @returns the {@link FMenu} object
      */
     createMenu(menuItem: IFacadeMenuItem): FMenu;
     /**
      * Create a menu that contains submenus, and later you can append this menu and its submenus to the UI.
-     * @param submenuItem the submenu item
+     * @param {IFacadeSubmenuItem} submenuItem the submenu item
+     * @returns the {@link FSubmenu} object
      * @example
      * ```ts
+     * // Create two leaf menus.
+     * const menu1 = univerAPI.createMenu({
+     *   id: 'submenu-nested-1',
+     *   title: 'Item 1',
+     *   action: () => {
+     *     console.log('Item 1 clicked');
+     *   }
+     * });
+     * const menu2 = univerAPI.createMenu({
+     *   id: 'submenu-nested-2',
+     *   title: 'Item 2',
+     *   action: () => {
+     *     console.log('Item 2 clicked');
+     *   }
+     * });
+     *
+     * // Add the leaf menus to a submenu.
+     * const submenu = univerAPI.createSubmenu({ id: 'submenu-nested', title: 'Nested Submenu' })
+     *   .addSubmenu(menu1)
+     *   .addSeparator()
+     *   .addSubmenu(menu2);
+     *
+     * // Create a root submenu append to the `contextMenu.others` section.
      * univerAPI.createSubmenu({ id: 'custom-submenu', title: 'Custom Submenu' })
-     *   .addSubmenu(univerAPI.createSubmenu({ id: 'submenu-nested', title: 'Nested Submenu' })
-     *     .addSubmenu(univerAPI.createMenu({ id: 'submenu-nested-1', title: 'Item 1', action: () => {} }))
-     *     .addSeparator()
-     *     .addSubmenu(univerAPI.createMenu({ id: 'submenu-nested-2', title: 'Item 2', action: () => {} }))
-     *   )
+     *   .addSubmenu(submenu)
      *   .appendTo('contextMenu.others');
      * ```
-     * @returns the {@link FSubmenu} object
      */
     createSubmenu(submenuItem: IFacadeSubmenuItem): FSubmenu;
     /**
      * Open a sidebar.
-     * @deprecated Please use `openSidebar` instead.
-     * @param params the sidebar options
-     * @returns the disposable object
+     * @deprecated Please use `univerAPI.openSidebar` instead.
+     * @param {ISidebarMethodOptions} params the sidebar options
+     * @returns {IDisposable} the disposable object
      */
     openSiderbar(params: ISidebarMethodOptions): IDisposable;
     /**
      * Open a sidebar.
-     * @deprecated Please use `openSidebar` instead.
-     * @param params the sidebar options
-     * @returns the disposable object
+     * @param {ISidebarMethodOptions} params the sidebar options
+     * @returns {IDisposable} the disposable object
+     * @example
+     * ```ts
+     * univerAPI.openSidebar({
+     *   id: 'mock-sidebar-id',
+     *   width: 300,
+     *   header: {
+     *     label: 'Sidebar Header',
+     *   },
+     *   children: {
+     *     label: 'Sidebar Content',
+     *   },
+     *   footer: {
+     *     label: 'Sidebar Footer',
+     *   },
+     *   onClose: () => {
+     *     console.log('Sidebar closed')
+     *   },
+     * });
+     * ```
      */
     openSidebar(params: ISidebarMethodOptions): IDisposable;
     /**
      * Open a dialog.
-     * @param dialog the dialog options
-     * @returns the disposable object
+     * @param {IDialogPartMethodOptions} dialog the dialog options
+     * @returns {IDisposable} the disposable object
+     * @example
+     * ```ts
+     * import { Button } from '@univerjs/design';
+     *
+     * univerAPI.openDialog({
+     *   id: 'mock-dialog-id',
+     *   width: 500,
+     *   title: {
+     *     label: 'Dialog Title',
+     *   },
+     *   children: {
+     *     label: 'Dialog Content',
+     *   },
+     *   footer: {
+     *     title: (
+     *       <>
+     *         <Button onClick={() => { console.log('Cancel clicked') }}>Cancel</Button>
+     *         <Button type="primary" onClick={() => { console.log('Confirm clicked') }} style={{marginLeft: '10px'}}>Confirm</Button>
+     *       </>
+     *     )
+     *   },
+     *   draggable: true,
+     *   mask: true,
+     *   maskClosable: true,
+     * });
+     * ```
      */
     openDialog(dialog: IDialogPartMethodOptions): IDisposable;
     /**
      * Get the component manager
-     * @returns The component manager
+     * @returns {ComponentManager} The component manager
+     * @example
+     * ```ts
+     * const componentManager = univerAPI.getComponentManager();
+     * console.log(componentManager);
+     * ```
      */
     getComponentManager(): ComponentManager;
     /**
      * Show a message.
+     * @returns {FUniver} the {@link FUniver} instance for chaining
      * @example
      * ```ts
-     * const message = univerAPI.showMessage({ key: 'my-message', content: 'Warning', duration: 0 });
-     *
-     * someAction().then(() => message.dispose());
+     * univerAPI.showMessage({
+     *   content: 'Success',
+     *   type: 'success',
+     *   duration: 3000,
+     * });
      * ```
      */
-    showMessage(options: IMessageProps): void;
+    showMessage(options: IMessageProps): FUniver;
     /**
      * Set the visibility of a built-in UI part.
-     * @param key the built-in UI part
-     * @param visible the visibility
-     * @returns the {@link FUniver} object
+     * @param {BuiltInUIPart} key the built-in UI part
+     * @param {boolean} visible the visibility
+     * @returns the {@link FUniver} instance for chaining
      * example
      * ```ts
-     * univerAPI.setUIVisible(BuiltInUIPart.HEADER, false);
+     * // Hide header, footer, and toolbar
+     * univerAPI.setUIVisible(univerAPI.Enum.BuiltInUIPart.HEADER, false)
+     *   .setUIVisible(univerAPI.Enum.BuiltInUIPart.FOOTER, false)
+     *   .setUIVisible(univerAPI.Enum.BuiltInUIPart.TOOLBAR, false);
+     *
+     * // Show in 3 seconds
+     * setTimeout(() => {
+     *   univerAPI.setUIVisible(univerAPI.Enum.BuiltInUIPart.HEADER, true)
+     *     .setUIVisible(univerAPI.Enum.BuiltInUIPart.FOOTER, true)
+     *     .setUIVisible(univerAPI.Enum.BuiltInUIPart.TOOLBAR, true);
+     * }, 3000);
      * ```
      */
     setUIVisible(key: BuiltInUIPart, visible: boolean): FUniver;
     /**
      * Get the visibility of a built-in UI part.
-     * @param key the built-in UI part
-     * @returns the visibility
-     * example
+     * @param {BuiltInUIPart} key the built-in UI part
+     * @returns {boolean} the visibility
+     * @example
      * ```ts
-     * univerAPI.isUIVisible(BuiltInUIPart.HEADER);
+     * // Hide header
+     * univerAPI.setUIVisible(univerAPI.Enum.BuiltInUIPart.HEADER, false);
+     * console.log(univerAPI.isUIVisible(univerAPI.Enum.BuiltInUIPart.HEADER)); // false
      * ```
      */
     isUIVisible(key: BuiltInUIPart): boolean;
     /**
-     * register an component to a built-in UI part
-     * @param key the built-in UI part
+     * Register an component to a built-in UI part
+     * @param {BuiltInUIPart} key the built-in UI part
      * @param component the react component
      * @example
      * ```ts
-     * univerAPI.registerUIPart(BuiltInUIPart.CUSTOM_HEADER, () => React.createElement('h1', null, 'Custom Header'));
+     * univerAPI.registerUIPart(univerAPI.Enum.BuiltInUIPart.CUSTOM_HEADER, () => React.createElement('h1', null, 'Custom Header'));
      * ```
      */
     registerUIPart(key: BuiltInUIPart, component: any): IDisposable;
     /**
-     * register an component.
-     * @param component
+     * Register an component.
+     * @param {string} name - The name of the component.
+     * @param {ComponentType} component - The component.
+     * @param {IComponentOptions} [options] - The options of the component.
+     * @returns {IDisposable} The disposable object.
      * @example
      * ```ts
-     * univerAPI.registerComponent('my-comp', () => React.createElement('h1', null, 'Custom Header'));
+     * const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     *
+     * // Register a range loading component
+     * const RangeLoading = () => {
+     *   const divStyle = {
+     *     width: '100%',
+     *     height: '100%',
+     *     backgroundColor: '#fff',
+     *     border: '1px solid #ccc',
+     *     boxSizing: 'border-box' as const,
+     *     display: 'flex',
+     *     justifyContent: 'center',
+     *     alignItems: 'center',
+     *     textAlign: 'center' as const,
+     *     transformOrigin: 'top left',
+     *   };
+     *
+     *   return (
+     *     <div style={divStyle}>
+     *       Loading...
+     *     </div>
+     *   );
+     * };
+     * univerAPI.registerComponent('RangeLoading', RangeLoading);
+     *
+     * // Add the range loading component covering the range A1:C3
+     * const range = fWorksheet.getRange('A1:C3');
+     * const disposeable = fWorksheet.addFloatDomToRange(range, { componentKey: 'RangeLoading' }, {}, 'myRangeLoading');
+     *
+     * setTimeout(() => {
+     *   disposeable?.dispose();
+     * }, 2000);
      * ```
      */
     registerComponent(name: string, component: ComponentType, options?: IComponentOptions): IDisposable;
     /**
      * Set a unit as the current unit and render a unit in the workbench's main area. If you have multiple units in Univer,
      * you should call this method to render the unit.
-     * @param unitId Unit to be rendered.
+     * @param {string} unitId Unit to be rendered.
      *
      * @example
      * Let's assume you have created two units, `unit1` and `unit2`. Univer is rendering `unit1` and you want to

package/lib/types/index.d.ts

@@ -73,7 +73,6 @@ export { UNIVER_UI_PLUGIN_NAME } from './ui-plugin';
 export * from './utils';
 export { ComponentContainer, type IComponentContainerProps, useComponentsOfPart } from './views/components/ComponentContainer';
 export { ZenZone } from './views/components/zen-zone/ZenZone';
-export { builtInGlobalComponents } from './views/parts';
 export { type IConfirmPartMethodOptions } from './views/components/confirm-part/interface';
 export { DesktopContextMenu as ContextMenu } from './views/components/context-menu/ContextMenu';
 export { MobileContextMenu } from './views/components/context-menu/MobileContextMenu';

package/lib/types/locale/zh-CN.d.ts

@@ -73,5 +73,8 @@ declare const locale: {
         cancel: string;
     };
     'global-shortcut': string;
+    'zoom-slider': {
+        resetTo: string;
+    };
 };
 export default locale;

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

@@ -24,6 +24,7 @@ interface IMenuItemBase<V> {
     description?: string;
     icon?: string | Observable<string>;
     tooltip?: string;
+    slot?: boolean;
     type: MenuItemType;
     /**
      * Custom label component id.
@@ -31,6 +32,7 @@ interface IMenuItemBase<V> {
     label?: string | {
         name: string;
         hoverable?: boolean;
+        selectable?: boolean;
         props?: Record<string, any>;
     };
     hidden$?: Observable<boolean>;
@@ -46,9 +48,11 @@ export interface IValueOption<T = undefined> {
     id?: string;
     value?: string | number;
     value$?: Observable<T>;
+    slot?: boolean;
     label?: string | {
         name: string;
         hoverable?: boolean;
+        selectable?: boolean;
         props?: Record<string, string | number | Array<{
             [x: string | number]: string;
         }>>;

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

@@ -25,7 +25,7 @@ export interface IShortcutItem<P extends object = object> {
      *
      * @example { binding: KeyCode.ENTER | MetaKeys.ALT }
      */
-    binding: KeyCode | number;
+    binding?: KeyCode | number;
     /**
      * The binding of the shortcut for macOS. If the property is not specified, the default binding would be used.
      */
@@ -89,9 +89,9 @@ export interface IShortcutService {
     /**
      * Get the display string of the shortcut item.
      * @param shortcut - the shortcut item to get the display string.
-     * @returns {string} the display string of the shortcut. For example `Ctrl+Enter`.
+     * @returns {string | null} The display string of the shortcut. For example `Ctrl+Enter`.
      */
-    getShortcutDisplay(shortcut: IShortcutItem): string;
+    getShortcutDisplay(shortcut: IShortcutItem): string | null;
     /**
      * Get the display string of the shortcut of the command.
      * @param id the id of the command to get the shortcut display.
@@ -122,7 +122,7 @@ export declare class ShortcutService extends Disposable implements IShortcutServ
     getAllShortcuts(): IShortcutItem[];
     registerShortcut(shortcut: IShortcutItem): IDisposable;
     getShortcutDisplayOfCommand(id: string): string | null;
-    getShortcutDisplay(shortcut: IShortcutItem): string;
+    getShortcutDisplay(shortcut: IShortcutItem): string | null;
     private _emitShortcutChanged;
     forceEscape(): IDisposable;
     forceDisable(): IDisposable;

package/lib/types/views/components/ribbon/Button/ToolbarButton.d.ts

@@ -1,4 +1,18 @@
-import { default as React } from 'react';
+/**
+ * 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.
+ */
 export interface IBaseToolbarButtonProps {
     children?: React.ReactNode;
     /** Semantic DOM class */

package/lib/types/views/components/ribbon/ToolbarItem.d.ts

@@ -1,7 +1,3 @@
-import { IDropdownLegacyProps } from '@univerjs/design';
 import { IDisplayMenuItem, IMenuItem } from '../../../services/menu/menu';
 import { ITooltipWrapperRef } from './TooltipButtonWrapper';
-import { default as React } from 'react';
-export declare const ToolbarItem: React.ForwardRefExoticComponent<(IDisplayMenuItem<IMenuItem> & {
-    align?: IDropdownLegacyProps["align"];
-}) & React.RefAttributes<ITooltipWrapperRef>>;
+export declare const ToolbarItem: import('react').ForwardRefExoticComponent<IDisplayMenuItem<IMenuItem> & import('react').RefAttributes<ITooltipWrapperRef>>;

package/lib/types/views/components/ribbon/TooltipButtonWrapper.d.ts

@@ -1,10 +1,21 @@
-import { IDropdownOverlayProps, ITooltipProps } from '@univerjs/design';
-import { default as React } from 'react';
+import { ITooltipProps } from '@univerjs/design';
+import { ReactNode } from 'react';
+import { IValueOption } from '../../../services/menu/menu';
 export interface ITooltipWrapperRef {
     el: HTMLSpanElement | null;
 }
-export declare const TooltipWrapper: React.ForwardRefExoticComponent<ITooltipProps & React.RefAttributes<ITooltipWrapperRef>>;
-export declare function DropdownWrapper({ children, overlay, disabled, offset }: IDropdownOverlayProps & {
-    overlay: React.ReactNode;
+export declare const TooltipWrapper: import('react').ForwardRefExoticComponent<ITooltipProps & import('react').RefAttributes<ITooltipWrapperRef>>;
+export declare function DropdownWrapper({ children, overlay, disabled }: {
+    children: ReactNode;
+    overlay: ReactNode;
     disabled?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
+export declare function DropdownMenuWrapper({ menuId, slot, value, options, children, disabled, onOptionSelect, }: {
+    menuId: string;
+    slot?: boolean;
+    value?: string | number;
+    options: IValueOption[];
+    children: ReactNode;
+    disabled?: boolean;
+    onOptionSelect: (option: IValueOption) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/types/views/mobile-workbench/MobileWorkbench.d.ts

@@ -0,0 +1,6 @@
+import { IWorkbenchOptions } from '../../controllers/ui/ui.controller';
+export interface IUniverAppProps extends IWorkbenchOptions {
+    mountContainer: HTMLElement;
+    onRendered?: (container: HTMLElement) => void;
+}
+export declare function MobileWorkbench(props: IUniverAppProps): import("react/jsx-runtime").JSX.Element;

package/lib/umd/facade.js

@@ -1 +1 @@
-(function(i,a){typeof exports=="object"&&typeof module<"u"?a(require("@univerjs/core/facade"),require("@univerjs/engine-render"),require("@univerjs/ui"),require("@univerjs/core")):typeof define=="function"&&define.amd?define(["@univerjs/core/facade","@univerjs/engine-render","@univerjs/ui","@univerjs/core"],a):(i=typeof globalThis<"u"?globalThis:i||self,a(i.UniverCoreFacade,i.UniverEngineRender,i.UniverUi,i.UniverCore))})(this,function(i,a,r,d){"use strict";var x=Object.defineProperty;var F=(i,a,r)=>a in i?x(i,a,{enumerable:!0,configurable:!0,writable:!0,value:r}):i[a]=r;var u=(i,a,r)=>F(i,typeof a!="symbol"?a+"":a,r);var S;var f=Object.getOwnPropertyDescriptor,_=(c,e,t,n)=>{for(var s=n>1?void 0:n?f(e,t):e,o=c.length-1,m;o>=0;o--)(m=c[o])&&(s=m(s)||s);return s},h=(c,e)=>(t,n)=>e(t,n,c);class b extends i.FBase{appendTo(e){const t=typeof e=="string"?e.split("|"):e,n=t.length,s={};let o=s;const m=this.__getSchema();t.forEach((l,U)=>{U===n-1?o[l]=m:o[l]={},o=o[l]}),this._menuManagerService.mergeMenu(s)}}let v=(S=class extends b{constructor(e,t,n,s){super();u(this,"_commandToRegister",new Map);u(this,"_buildingSchema");this._item=e,this._injector=t,this._commandService=n,this._menuManagerService=s;const o=typeof e.action=="string"?e.action:d.Tools.generateRandomId(12);o!==e.action&&this._commandToRegister.set(o,e.action),this._buildingSchema={menuItemFactory:()=>({id:e.id,type:r.MenuItemType.BUTTON,icon:e.icon,title:e.title,tooltip:e.tooltip,commandId:o})},typeof e.order<"u"&&(this._buildingSchema.order=e.order)}__getSchema(){return this._commandToRegister.forEach((e,t)=>{this._commandService.hasCommand(t)||this._commandService.registerCommand({id:t,type:d.CommandType.COMMAND,handler:e})}),{[this._item.id]:this._buildingSchema}}},u(S,"RibbonStartGroup",r.RibbonStartGroup),u(S,"RibbonPosition",r.RibbonPosition),u(S,"MenuManagerPosition",r.MenuManagerPosition),S);v=_([h(1,d.Inject(d.Injector)),h(2,d.ICommandService),h(3,r.IMenuManagerService)],v);let g=class extends b{constructor(e,t,n){super();u(this,"_menuByGroups",[]);u(this,"_submenus",[]);u(this,"_buildingSchema");this._item=e,this._injector=t,this._menuManagerService=n,this._buildingSchema={menuItemFactory:()=>({id:e.id,type:r.MenuItemType.SUBITEMS,icon:e.icon,title:e.title,tooltip:e.tooltip})},typeof e.order<"u"&&(this._buildingSchema.order=e.order)}addSubmenu(e){return this._submenus.push(e),this}addSeparator(){return this._menuByGroups.push(this._submenus),this._submenus=[],this}__getSchema(){const e={};return this.addSeparator(),this._menuByGroups.forEach((t,n)=>{const s={};t.forEach(o=>{Object.assign(s,o.__getSchema())}),e[`${this._item.id}-group-${n}`]=s}),{[this._item.id]:Object.assign(this._buildingSchema,e)}}};g=_([h(1,d.Inject(d.Injector)),h(2,r.IMenuManagerService)],g);var j=Object.getOwnPropertyDescriptor,C=(c,e,t,n)=>{for(var s=n>1?void 0:n?j(e,t):e,o=c.length-1,m;o>=0;o--)(m=c[o])&&(s=m(s)||s);return s},I=(c,e)=>(t,n)=>e(t,n,c);let p=class extends i.FBase{constructor(e,t){super();u(this,"_forceDisableDisposable",null);this._injector=e,this._shortcutService=t}enableShortcut(){var e;return(e=this._forceDisableDisposable)==null||e.dispose(),this._forceDisableDisposable=null,this}disableShortcut(){return this._forceDisableDisposable||(this._forceDisableDisposable=this._shortcutService.forceDisable()),this}dispatchShortcutEvent(e){return this._shortcutService.dispatch(e)}};p=C([I(0,d.Inject(d.Injector)),I(1,r.IShortcutService)],p);class M extends i.FUniver{getURL(){return new URL(window.location.href)}getShortcut(){return this._injector.createInstance(p)}copy(){return this._commandService.syncExecuteCommand(r.CopyCommand.id)}paste(){return this._commandService.syncExecuteCommand(r.PasteCommand.id)}createMenu(e){return this._injector.createInstance(v,e)}createSubmenu(e){return this._injector.createInstance(g,e)}openSiderbar(e){return this._injector.get(r.ISidebarService).open(e)}openSidebar(e){return this.openSiderbar(e)}openDialog(e){const n=this._injector.get(r.IDialogService).open({...e,onClose:()=>{n.dispose()}});return n}getComponentManager(){return this._injector.get(r.ComponentManager)}showMessage(e){return this._injector.get(r.IMessageService).show(e),this}setUIVisible(e,t){return this._injector.get(r.IUIPartsService).setUIVisible(e,t),this}isUIVisible(e){return this._injector.get(r.IUIPartsService).isUIVisible(e)}registerUIPart(e,t){return this._injector.get(r.IUIPartsService).registerComponent(e,()=>r.connectInjector(t,this._injector))}registerComponent(e,t,n){const s=this._injector.get(r.ComponentManager);return this.disposeWithMe(s.register(e,t,n))}setCurrent(e){if(!this._injector.get(a.IRenderManagerService).getRenderById(e))throw new Error("Unit not found");this._univerInstanceService.setCurrentUnitForType(e)}}i.FUniver.extend(M);class y extends i.FHooks{onBeforeCopy(e){return this._injector.get(d.ICommandService).beforeCommandExecuted(n=>{n.id===r.CopyCommand.id&&e()})}onCopy(e){return this._injector.get(d.ICommandService).onCommandExecuted(n=>{n.id===r.CopyCommand.id&&e()})}onBeforePaste(e){return this._injector.get(d.ICommandService).beforeCommandExecuted(n=>{n.id===r.PasteCommand.id&&e()})}onPaste(e){return this._injector.get(d.ICommandService).onCommandExecuted(n=>{(n.id===r.PasteCommand.id||n.id===r.SheetPasteShortKeyCommandName)&&e()})}}i.FHooks.extend(y);class P extends i.FEnum{get BuiltInUIPart(){return r.BuiltInUIPart}}i.FEnum.extend(P)});
+(function(s,d){typeof exports=="object"&&typeof module<"u"?d(require("@univerjs/core/facade"),require("@univerjs/engine-render"),require("@univerjs/ui"),require("@univerjs/core")):typeof define=="function"&&define.amd?define(["@univerjs/core/facade","@univerjs/engine-render","@univerjs/ui","@univerjs/core"],d):(s=typeof globalThis<"u"?globalThis:s||self,d(s.UniverCoreFacade,s.UniverEngineRender,s.UniverUi,s.UniverCore))})(this,function(s,d,r,c){"use strict";var E=Object.defineProperty;var F=(s,d,r)=>d in s?E(s,d,{enumerable:!0,configurable:!0,writable:!0,value:r}):s[d]=r;var u=(s,d,r)=>F(s,typeof d!="symbol"?d+"":d,r);var v;var f=Object.getOwnPropertyDescriptor,I=(a,e,t,n)=>{for(var i=n>1?void 0:n?f(e,t):e,o=a.length-1,h;o>=0;o--)(h=a[o])&&(i=h(i)||i);return i},m=(a,e)=>(t,n)=>e(t,n,a);class b extends s.FBase{appendTo(e){const t=typeof e=="string"?e.split("|"):e,n=t.length,i={};let o=i;const h=this.__getSchema();t.forEach((l,P)=>{P===n-1?o[l]=h:o[l]={},o=o[l]}),this._menuManagerService.mergeMenu(i)}}let g=(v=class extends b{constructor(e,t,n,i){super();u(this,"_commandToRegister",new Map);u(this,"_buildingSchema");this._item=e,this._injector=t,this._commandService=n,this._menuManagerService=i;const o=typeof e.action=="string"?e.action:c.Tools.generateRandomId(12);o!==e.action&&this._commandToRegister.set(o,e.action),this._buildingSchema={menuItemFactory:()=>({id:e.id,type:r.MenuItemType.BUTTON,icon:e.icon,title:e.title,tooltip:e.tooltip,commandId:o})},typeof e.order<"u"&&(this._buildingSchema.order=e.order)}__getSchema(){return this._commandToRegister.forEach((e,t)=>{this._commandService.hasCommand(t)||this._commandService.registerCommand({id:t,type:c.CommandType.COMMAND,handler:e})}),{[this._item.id]:this._buildingSchema}}},u(v,"RibbonStartGroup",r.RibbonStartGroup),u(v,"RibbonPosition",r.RibbonPosition),u(v,"MenuManagerPosition",r.MenuManagerPosition),v);g=I([m(1,c.Inject(c.Injector)),m(2,c.ICommandService),m(3,r.IMenuManagerService)],g);let p=class extends b{constructor(e,t,n){super();u(this,"_menuByGroups",[]);u(this,"_submenus",[]);u(this,"_buildingSchema");this._item=e,this._injector=t,this._menuManagerService=n,this._buildingSchema={menuItemFactory:()=>({id:e.id,type:r.MenuItemType.SUBITEMS,icon:e.icon,title:e.title,tooltip:e.tooltip})},typeof e.order<"u"&&(this._buildingSchema.order=e.order)}addSubmenu(e){return this._submenus.push(e),this}addSeparator(){return this._menuByGroups.push(this._submenus),this._submenus=[],this}__getSchema(){const e={};return this.addSeparator(),this._menuByGroups.forEach((t,n)=>{const i={};t.forEach(o=>{Object.assign(i,o.__getSchema())}),e[`${this._item.id}-group-${n}`]=i}),{[this._item.id]:Object.assign(this._buildingSchema,e)}}};p=I([m(1,c.Inject(c.Injector)),m(2,r.IMenuManagerService)],p);var C=Object.getOwnPropertyDescriptor,j=(a,e,t,n)=>{for(var i=n>1?void 0:n?C(e,t):e,o=a.length-1,h;o>=0;o--)(h=a[o])&&(i=h(i)||i);return i},S=(a,e)=>(t,n)=>e(t,n,a);let _=class extends s.FBase{constructor(e,t,n,i){super();u(this,"_forceDisableDisposable",null);this._injector=e,this._renderManagerService=t,this._univerInstanceService=n,this._shortcutService=i}enableShortcut(){var e;return(e=this._forceDisableDisposable)==null||e.dispose(),this._forceDisableDisposable=null,this}disableShortcut(){return this._forceDisableDisposable||(this._forceDisableDisposable=this._shortcutService.forceDisable()),this}triggerShortcut(e){const t=this._univerInstanceService.getCurrentUnitForType(c.UniverInstanceType.UNIVER_SHEET);if(!t)return;const n=this._renderManagerService.getRenderById(t.getUnitId());return n?(n.engine.getCanvasElement().dispatchEvent(e),this._shortcutService.dispatch(e)):void 0}dispatchShortcutEvent(e){return this._shortcutService.dispatch(e)}};_=j([S(0,c.Inject(c.Injector)),S(1,c.Inject(d.IRenderManagerService)),S(2,c.IUniverInstanceService),S(3,r.IShortcutService)],_);class M extends s.FUniver{getURL(){return new URL(window.location.href)}getShortcut(){return this._injector.createInstance(_)}copy(){return this._commandService.executeCommand(r.CopyCommand.id)}paste(){return this._commandService.executeCommand(r.PasteCommand.id)}createMenu(e){return this._injector.createInstance(g,e)}createSubmenu(e){return this._injector.createInstance(p,e)}openSiderbar(e){return this._injector.get(r.ISidebarService).open(e)}openSidebar(e){return this.openSiderbar(e)}openDialog(e){const n=this._injector.get(r.IDialogService).open({...e,onClose:()=>{n.dispose()}});return n}getComponentManager(){return this._injector.get(r.ComponentManager)}showMessage(e){return this._injector.get(r.IMessageService).show(e),this}setUIVisible(e,t){return this._injector.get(r.IUIPartsService).setUIVisible(e,t),this}isUIVisible(e){return this._injector.get(r.IUIPartsService).isUIVisible(e)}registerUIPart(e,t){return this._injector.get(r.IUIPartsService).registerComponent(e,()=>r.connectInjector(t,this._injector))}registerComponent(e,t,n){const i=this._injector.get(r.ComponentManager);return this.disposeWithMe(i.register(e,t,n))}setCurrent(e){if(!this._injector.get(d.IRenderManagerService).getRenderById(e))throw new Error("Unit not found");this._univerInstanceService.setCurrentUnitForType(e)}}s.FUniver.extend(M);class U extends s.FHooks{onBeforeCopy(e){return this._injector.get(c.ICommandService).beforeCommandExecuted(n=>{n.id===r.CopyCommand.id&&e()})}onCopy(e){return this._injector.get(c.ICommandService).onCommandExecuted(n=>{n.id===r.CopyCommand.id&&e()})}onBeforePaste(e){return this._injector.get(c.ICommandService).beforeCommandExecuted(n=>{n.id===r.PasteCommand.id&&e()})}onPaste(e){return this._injector.get(c.ICommandService).onCommandExecuted(n=>{(n.id===r.PasteCommand.id||n.id===r.SheetPasteShortKeyCommandName)&&e()})}}s.FHooks.extend(U);class y extends s.FEnum{get BuiltInUIPart(){return r.BuiltInUIPart}get KeyCode(){return r.KeyCode}}s.FEnum.extend(y)});