@univerjs/ui 0.2.8 → 0.2.9

package/lib/types/index.d.ts

@@ -59,7 +59,7 @@ export { IEditorService, EditorService, Editor } from './services/editor/editor.
 export { TextEditor } from './components/editor/TextEditor';
 export { RangeSelector } from './components/range-selector/RangeSelector';
 export { ProgressBar } from './components/progress-bar/ProgressBar';
-export { type IMenuGroup, useToolbarGroups, useToolbarItemStatus, useToolbarCollapseObserver } from './views/components/doc-bars/hook';
+export { type IMenuGroup, useSimpleToolbarGroups, useToolbarGroups, useToolbarItemStatus, useToolbarCollapseObserver } from './views/components/doc-bars/hook';
 export { mergeMenuConfigs } from './common/menu-merge-configs';
 export { ShortcutPanelController } from './controllers/shortcut-display/shortcut-panel.controller';
 export { ShortcutPanelService } from './services/shortcut/shortcut-panel.service';

package/lib/types/services/dom/canvas-dom-layer.service.d.ts

@@ -19,6 +19,7 @@ export interface IFloatDom {
     onWheel: (evt: WheelEvent) => void;
     props?: Record<string, any>;
     data?: Serializable;
+    unitId: string;
 }
 export declare class CanvasFloatDomService {
     private _domLayerMap;

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

@@ -9,7 +9,8 @@ export declare enum MenuPosition {
     TOOLBAR_DATA = "uiToolbar.data",
     TOOLBAR_VIEW = "uiToolbar.view",
     TOOLBAR_OTHERS = "uiToolbar.others",
-    CONTEXT_MENU = "contextMenu"
+    CONTEXT_MENU = "contextMenu",
+    FOOTER = "footer"
 }
 export declare enum MenuGroup {
     TOOLBAR_HISTORY = 0,
@@ -48,8 +49,10 @@ interface IMenuItemBase<V> {
     icon?: string | Observable<string>;
     tooltip?: string;
     /** The group that the item belongs to. */
+    /** @deprecated group will be removed in the future. */
     group?: MenuGroup;
     /** In what menu should the item display. */
+    /** @deprecated positions will be removed in the future. */
     positions: OneOrMany<MenuPosition | string>;
     type: MenuItemType;
     /**
@@ -92,6 +95,12 @@ export interface ICustomComponentProps<T> {
 }
 export interface IMenuSelectorItem<V = MenuItemDefaultValueType, T = undefined> extends IMenuItemBase<V> {
     type: MenuItemType.SELECTOR | MenuItemType.BUTTON_SELECTOR | MenuItemType.SUBITEMS;
+    /**
+     * If this property is set, changing the value of the selection will trigger the command with this id,
+     * instead of {@link IMenuItemBase.id} or {@link IMenuItemBase.commandId}. At the same title,
+     * clicking the button will trigger IMenuItemBase.id or IMenuItemBase.commandId.
+     */
+    selectionsCommandId?: string;
     /** Options or IDs of registered components. */
     selections?: Array<IValueOption<T>> | Observable<Array<IValueOption<T>>>;
     /** If `type` is `MenuItemType.BUTTON_SELECTOR`, this determines if the button is activated. */

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

@@ -3,30 +3,49 @@ import { Observable } from 'rxjs';
 import { IShortcutService } from '../shortcut/shortcut.service';
 import { IDisplayMenuItem, IMenuItem, MenuConfig, MenuPosition } from './menu';
 export declare const IMenuService: import('@univerjs/core').IdentifierDecorator<IMenuService>;
+/**
+ * Breaking changes to IMenuService are expected in the next version. Use with caution. by @jikkai
+ */
 export interface IMenuService {
     menuChanged$: Observable<void>;
+    /** @deprecated */
     addMenuItem(item: IMenuItem, config: MenuConfig): IDisposable;
+    /** @deprecated */
     setMenuItem(item: IMenuItem): void;
     /** Get menu items for display at a given position or a submenu. */
+    /** @deprecated */
     getMenuItems(position: MenuPosition | string): Array<IDisplayMenuItem<IMenuItem>>;
+    /** @deprecated */
     getMenuItem(id: string): IMenuItem | null;
 }
 export declare class MenuService extends Disposable implements IMenuService {
     private readonly _shortcutService;
+    /** @deprecated */
     private readonly _menuItemMap;
+    /** @deprecated */
     private readonly _menuByPositions;
+    /** @deprecated */
     private readonly _menuConfigs;
     private _menuChanged$;
     menuChanged$: Observable<void>;
     constructor(_shortcutService: IShortcutService);
     dispose(): void;
+    /** @deprecated */
     addMenuItem(item: IMenuItem, config: MenuConfig): IDisposable;
+    /** @deprecated */
     getMenuItems(positions: MenuPosition | string): Array<IDisplayMenuItem<IMenuItem>>;
+    /** @deprecated */
     setMenuItem(item: IMenuItem): void;
+    /** @deprecated */
     getMenuItem(id: string): IMenuItem | null;
+    /** @deprecated */
     setMenuConfigs(id: string, config: MenuConfig): void;
+    /** @deprecated */
     getMenuConfig(id: string): MenuConfig | null;
+    /** @deprecated */
     private _getDisplayMenuItems;
+    /** @deprecated */
     private _appendMenuToPosition;
+    /** @deprecated */
     private _updateMenuItems;
 }

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

@@ -10,7 +10,8 @@ export declare enum BuiltInUIPart {
     CONTENT = "content",
     FOOTER = "footer",
     LEFT_SIDEBAR = "left-sidebar",
-    FLOATING = "floating"
+    FLOATING = "floating",
+    UNIT = "unit"
 }
 export interface IUIPartsService {
     componentRegistered$: Observable<ComponentPartKey>;

package/lib/types/services/popup/canvas-popup.service.d.ts

@@ -1,9 +1,9 @@
-import { Disposable } from '@univerjs/core';
+import { Nullable, Disposable } from '@univerjs/core';
 import { IRectPopupProps } from '@univerjs/design';
 import { IBoundRectNoAngle } from '@univerjs/engine-render';
 import { Observable } from 'rxjs';
 export interface IPopup extends Pick<IRectPopupProps, 'closeOnSelfTarget' | 'direction' | 'excludeOutside' | 'onClickOutside'> {
-    anchorRect: IBoundRectNoAngle;
+    anchorRect: Nullable<IBoundRectNoAngle>;
     anchorRect$: Observable<IBoundRectNoAngle>;
     excludeRects?: IBoundRectNoAngle[];
     excludeRects$?: Observable<IBoundRectNoAngle[]>;

package/lib/types/views/components/doc-bars/hook.d.ts

@@ -14,6 +14,7 @@ export interface IToolbarRenderHookHandler {
     groups: IMenuGroup[];
     groupsByKey: Record<MenuGroup, Array<IDisplayMenuItem<IMenuItem>>>;
 }
+export declare function useSimpleToolbarGroups(category: MenuPositionWithCustom): IDisplayMenuItem<IMenuItem>[];
 /**
  * If your custom toolbar component need to render menu items by their category,
  * you can use this hook to get the toolbar status.

package/lib/types/views/components/dom/FloatDom.d.ts

@@ -1,2 +1,4 @@
 import { default as React } from 'react';
-export declare const FloatDom: () => React.JSX.Element;
+export declare const FloatDom: ({ unitId }: {
+    unitId?: string;
+}) => React.JSX.Element[] | undefined;