@univerjs/ui 0.25.0 → 1.0.0-alpha.0

package/lib/types/common/component-manager.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IDisposable } from '@univerjs/core';
-import { Disposable } from '@univerjs/core';
+import { Disposable, ILogService } from '@univerjs/core';
 import { createElement, useEffect, useRef } from 'react';
 type ComponentFramework = string;
 export interface IComponentOptions {
@@ -27,11 +27,10 @@ export interface IComponent<T = any> {
 export type ComponentType<T = any> = any;
 export type ComponentList = Map<string, IComponent>;
 export declare class ComponentManager extends Disposable {
+    private readonly _logService?;
     private _components;
-    private _componentsReverse;
-    constructor();
+    constructor(_logService?: ILogService | undefined);
     register(name: string, component: ComponentType, options?: IComponentOptions): IDisposable;
-    getKey(component: ComponentType): string | undefined;
     reactUtils: {
         createElement: typeof createElement;
         useEffect: typeof useEffect;

package/lib/types/common/icon-manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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 { ComponentType, CSSProperties, ForwardRefExoticComponent, MouseEventHandler, RefAttributes } from 'react';
+import { Disposable, ILogService } from '@univerjs/core';
+/**
+ * Extra color channels consumed by Univer icon components.
+ */
+export interface IIconExtendProps {
+    colorChannel1: string;
+}
+/**
+ * Common props that IconManager-managed icons receive when rendered by UI components.
+ */
+export interface IIconProps {
+    className?: string;
+    style?: CSSProperties;
+    extend?: IIconExtendProps;
+    onClick?: MouseEventHandler<SVGSVGElement>;
+}
+/**
+ * React component type accepted by IconManager.
+ */
+export type IconType = ComponentType<IIconProps> | ForwardRefExoticComponent<IIconProps & RefAttributes<SVGElement>>;
+/**
+ * Icon name to icon component map used for batch registration.
+ */
+export type IconMap = Record<string, IconType>;
+/**
+ * Runtime icon registry storage.
+ */
+export type IconList = Map<string, IconType>;
+/**
+ * Registers and resolves toolbar/menu icons by name.
+ *
+ * `get()` is render-safe and returns an empty icon when the name is missing. Use `has()`
+ * when the caller needs to know whether an icon was actually registered.
+ */
+export declare class IconManager extends Disposable {
+    private readonly _logService;
+    private _icons;
+    constructor(_logService: ILogService);
+    /**
+     * Check whether an icon name is currently registered.
+     *
+     * Prefer this for existence checks because `get()` always returns a renderable icon.
+     */
+    has(name: string): boolean;
+    private _register;
+    /**
+     * Register one icon by name.
+     *
+     * The returned disposable removes this registration when disposed.
+     */
+    register(name: string, icon: IconType): IDisposable;
+    /**
+     * Register a batch of icons.
+     *
+     * The returned disposable removes every icon registered by this call when disposed.
+     */
+    register(icons: IconMap): IDisposable;
+    /**
+     * Resolve an icon by name.
+     *
+     * Missing names are reported through the log service and return an empty component so
+     * render paths can safely use the result as `<Icon />`.
+     */
+    get(name: string): IconType;
+    /**
+     * Remove an icon registration if it exists.
+     */
+    delete(name: string): void;
+}

package/lib/types/common/index.d.ts

@@ -14,4 +14,5 @@
  * limitations under the License.
  */
 export * from './component-manager';
+export * from './icon-manager';
 export * from './z-index-manager';

package/lib/types/controllers/components.controller.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 { Disposable } from '@univerjs/core';
+import { ComponentManager, IconManager } from '../common';
+export declare class ComponentsController extends Disposable {
+    private readonly _componentManager;
+    private readonly _iconManager;
+    constructor(_componentManager: ComponentManager, _iconManager: IconManager);
+    private _registerIcons;
+    private _registerComponents;
+}

package/lib/types/controllers/menus/menus.d.ts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import type { IAccessor } from '@univerjs/core';
+import type { LocaleKey } from '../../locale/types';
 import type { IMenuButtonItem } from '../../services/menu/menu';
-export declare function UndoMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
-export declare function RedoMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
+export declare function UndoMenuItemFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;
+export declare function RedoMenuItemFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey>;

package/lib/types/controllers/shortcut-display/menu.d.ts

@@ -13,5 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { LocaleKey } from '../../locale/types';
 import type { IMenuButtonItem } from '../../services/menu/menu';
-export declare function ShortcutPanelMenuItemFactory(): IMenuButtonItem;
+export declare function ShortcutPanelMenuItemFactory(): IMenuButtonItem<LocaleKey>;

package/lib/types/controllers/shortcut-display/shortcut-panel.controller.d.ts

@@ -13,8 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Disposable, ICommandService, Injector } from '@univerjs/core';
-import { ComponentManager } from '../../common/component-manager';
+import { Disposable, ICommandService } from '@univerjs/core';
 import { IMenuManagerService } from '../../services/menu/menu-manager.service';
 import { IShortcutService } from '../../services/shortcut/shortcut.service';
 /**
@@ -22,5 +21,5 @@ import { IShortcutService } from '../../services/shortcut/shortcut.service';
  */
 export declare class ShortcutPanelController extends Disposable {
     private readonly _menuManagerService;
-    constructor(injector: Injector, componentManager: ComponentManager, shortcutService: IShortcutService, _menuManagerService: IMenuManagerService, commandService: ICommandService);
+    constructor(shortcutService: IShortcutService, _menuManagerService: IMenuManagerService, commandService: ICommandService);
 }

package/lib/types/controllers/ui/ui-desktop.controller.d.ts

@@ -26,7 +26,6 @@ export declare class DesktopUIController extends SingleUnitUIController {
     private readonly _config;
     private readonly _componentManager;
     constructor(_config: IUniverUIConfig, injector: Injector, lifecycleService: LifecycleService, renderManagerService: IRenderManagerService, layoutService: ILayoutService, instanceService: IUniverInstanceService, menuManagerService: IMenuManagerService, uiPartsService: IUIPartsService, _componentManager: ComponentManager);
-    private _registerComponents;
     dispose(): void;
     bootstrap(callback: (contentElement: HTMLElement, containerElement: HTMLElement) => void): IDisposable;
     private _initBuiltinComponents;

package/lib/types/controllers/ui/ui-mobile.controller.d.ts

@@ -29,6 +29,5 @@ export declare class MobileUIController extends SingleUnitUIController implement
     constructor(_config: IUniverUIConfig, injector: Injector, lifecycleService: LifecycleService, renderManagerService: IRenderManagerService, layoutService: ILayoutService, instanceService: IUniverInstanceService, menuManagerService: IMenuManagerService, uiPartsService: IUIPartsService, _componentManager: ComponentManager);
     dispose(): void;
     bootstrap(callback: (contentElement: HTMLElement, containerElement: HTMLElement) => void): IDisposable;
-    private _registerComponents;
     private _initBuiltinComponents;
 }

package/lib/types/index.d.ts

@@ -18,71 +18,72 @@ export { ToggleShortcutPanelOperation } from './commands/operations/toggle-short
 export * from './common';
 export { getHeaderFooterMenuHiddenObservable, getMenuHiddenObservable } from './common/menu-hidden-observable';
 export { mergeMenuConfigs } from './common/menu-merge-configs';
-export * from './components';
-export { COLOR_PICKER_COMPONENT } from './components/color-picker/interface';
-export { FontFamily } from './components/font-family/FontFamily';
-export { FontFamilyItem } from './components/font-family/FontFamilyItem';
-export { FONT_FAMILY_COMPONENT, FONT_FAMILY_ITEM_COMPONENT, type IFontFamilyProps } from './components/font-family/interface';
-export { FontSize } from './components/font-size/FontSize';
-export { FONT_SIZE_COMPONENT, FONT_SIZE_LIST, HEADING_LIST } from './components/font-size/interface';
-export * from './components/hooks';
-export { type INotificationOptions } from './components/notification/Notification';
-export { ProgressBar } from './components/progress-bar/ProgressBar';
-export { type IUniverUIConfig, UI_PLUGIN_CONFIG_KEY } from './config/config';
+export { UI_PLUGIN_CONFIG_KEY } from './config/config';
+export type { IUniverUIConfig } from './config/config';
 export { UNI_DISABLE_CHANGING_FOCUS_KEY } from './const';
 export { ErrorController } from './controllers/error/error.controller';
 export { CopyShortcutItem, CutShortcutItem, RedoShortcutItem, SharedController, UndoShortcutItem, } from './controllers/shared-shortcut.controller';
 export { ShortcutPanelController } from './controllers/shortcut-display/shortcut-panel.controller';
 export { DesktopUIController } from './controllers/ui/ui-desktop.controller';
 export { SingleUnitUIController } from './controllers/ui/ui-shared.controller';
-export { IUIController, type IWorkbenchOptions } from './controllers/ui/ui.controller';
+export { IUIController } from './controllers/ui/ui.controller';
+export type { IWorkbenchOptions } from './controllers/ui/ui.controller';
 export { menuSchema as UIMenuSchema } from './menu/schema';
 export { UniverMobileUIPlugin } from './mobile-plugin';
 export { DISABLE_AUTO_FOCUS_KEY, UniverUIPlugin } from './plugin';
 export { DesktopBeforeCloseService, IBeforeCloseService } from './services/before-close/before-close.service';
 export { BrowserClipboardService, FILE__BMP_CLIPBOARD_MIME_TYPE, FILE__JPEG_CLIPBOARD_MIME_TYPE, FILE__WEBP_CLIPBOARD_MIME_TYPE, FILE_PNG_CLIPBOARD_MIME_TYPE, FILE_SVG_XML_CLIPBOARD_MIME_TYPE, HTML_CLIPBOARD_MIME_TYPE, IClipboardInterfaceService, imageMimeTypeSet, PLAIN_TEXT_CLIPBOARD_MIME_TYPE, } from './services/clipboard/clipboard-interface.service';
 export { supportClipboardAPI } from './services/clipboard/clipboard-utils';
-export { CopyCommand, CutCommand, PasteCommand, SheetPasteShortKeyCommandName } from './services/clipboard/clipboard.command';
+export { CopyCommand, CutCommand, PasteCommand, SheetPasteShortKeyCommandName, } from './services/clipboard/clipboard.command';
 export { DesktopConfirmService } from './services/confirm/desktop-confirm.service';
 export { ContextMenuHostService, IContextMenuHostService } from './services/contextmenu/contextmenu-host.service';
-export { ContextMenuService, type IContextMenuHandler, IContextMenuService } from './services/contextmenu/contextmenu.service';
+export { ContextMenuService, IContextMenuService } from './services/contextmenu/contextmenu.service';
+export type { IContextMenuHandler } from './services/contextmenu/contextmenu.service';
 export { DesktopDialogService } from './services/dialog/desktop-dialog.service';
 export { IDialogService } from './services/dialog/dialog.service';
-export { CanvasFloatDomService, type IFloatDom, type IFloatDomLayout } from './services/dom/canvas-dom-layer.service';
-export { type IFontConfig, IFontService } from './services/font.service';
+export { CanvasFloatDomService } from './services/dom/canvas-dom-layer.service';
+export type { IFloatDom, IFloatDomLayout } from './services/dom/canvas-dom-layer.service';
+export { FontService, IFontService } from './services/font.service';
+export type { IFontConfig } from './services/font.service';
 export { DesktopGalleryService } from './services/gallery/desktop-gallery.service';
 export { IGalleryService } from './services/gallery/gallery.service';
 export { DesktopLayoutService, ILayoutService } from './services/layout/layout.service';
 export { DesktopLocalFileService } from './services/local-file/desktop-local-file.service';
-export { ILocalFileService, type IOpenFileOptions } from './services/local-file/local-file.service';
+export { ILocalFileService } from './services/local-file/local-file.service';
+export type { IOpenFileOptions } from './services/local-file/local-file.service';
 export { DesktopLocalStorageService } from './services/local-storage/local-storage.service';
-export { type ICustomComponentProps, type IDisplayMenuItem, type IMenuButtonItem, type IMenuItem, type IMenuItemFactory, type IMenuSelectorItem, type IValueOption, type MenuConfig, type MenuItemDefaultValueType, MenuItemType, } from './services/menu/menu';
-export { IMenuManagerService, MenuManagerService, type MenuSchemaType } from './services/menu/menu-manager.service';
+export { MenuItemType } from './services/menu/menu';
+export type { ICustomComponentProps, IDisplayMenuItem, IMenuButtonItem, IMenuItem, IMenuItemFactory, IMenuSelectorItem, IValueOption, MenuConfig, MenuItemConfig, MenuItemDefaultValueType, } from './services/menu/menu';
+export { IMenuManagerService, MenuManagerService } from './services/menu/menu-manager.service';
+export type { MenuSchemaType } from './services/menu/menu-manager.service';
 export { type IMenuSchema } from './services/menu/menu-manager.service';
 export { ContextMenuGroup, ContextMenuPosition, MenuManagerPosition, RibbonDataGroup, RibbonFormulasGroup, RibbonInsertGroup, RibbonOthersGroup, RibbonPosition, RibbonStartGroup, RibbonViewGroup, } from './services/menu/types';
-export { MockMessageService } from './services/message/__testing__/mock-message.service';
+export { MockMessageService } from './services/message/__tests__/mock-message.service';
 export { DesktopMessageService } from './services/message/desktop-message.service';
 export { IMessageService } from './services/message/message.service';
 export { DesktopNotificationService } from './services/notification/desktop-notification.service';
 export { INotificationService } from './services/notification/notification.service';
 export { BuiltInUIPart, IUIPartsService, UIPartsService } from './services/parts/parts.service';
 export { IPlatformService, PlatformService } from './services/platform/platform.service';
-export { CanvasPopupService, ICanvasPopupService, type IPopup } from './services/popup/canvas-popup.service';
+export { CanvasPopupService, ICanvasPopupService } from './services/popup/canvas-popup.service';
+export type { IPopup } from './services/popup/canvas-popup.service';
 export { DesktopRibbonService, IRibbonService } from './services/ribbon/ribbon.service';
 export { KeyCode, MetaKeys } from './services/shortcut/keycode';
 export { ShortcutPanelService } from './services/shortcut/shortcut-panel.service';
-export { type IShortcutItem, IShortcutService, ShortcutService } from './services/shortcut/shortcut.service';
+export { IShortcutService, ShortcutService } from './services/shortcut/shortcut.service';
+export type { IShortcutItem } from './services/shortcut/shortcut.service';
 export { DesktopSidebarService } from './services/sidebar/desktop-sidebar.service';
 export { useSidebarClick } from './services/sidebar/hooks/use-sidebar-click';
 export { ILeftSidebarService, ISidebarService } from './services/sidebar/sidebar.service';
 export { ThemeSwitcherService } from './services/theme-switcher/theme-switcher.service';
-export { DesktopZenZoneService } from './services/zen-zone/desktop-zen-zone.service';
-export { IZenZoneService } from './services/zen-zone/zen-zone.service';
 export * from './utils';
-export { ComponentContainer, type IComponentContainerProps, useComponentsOfPart } from './views/components/ComponentContainer';
+export { COLOR_PICKER_COMPONENT } from './views/color-picker/interface';
+export { ComponentContainer, useComponentsOfPart } from './views/components/ComponentContainer';
+export type { IComponentContainerProps } from './views/components/ComponentContainer';
 export type { IConfirmChildrenProps } from './views/components/confirm-part/interface';
 export { type IConfirmPartMethodOptions } from './views/components/confirm-part/interface';
-export { AnchoredContextMenu, type IContextMenuAnchorRect } from './views/components/context-menu/AnchoredContextMenu';
+export { AnchoredContextMenu } from './views/components/context-menu/AnchoredContextMenu';
+export type { IContextMenuAnchorRect } from './views/components/context-menu/AnchoredContextMenu';
 export { DesktopContextMenu as ContextMenu } from './views/components/context-menu/ContextMenu';
 export { ContextMenuPanel } from './views/components/context-menu/ContextMenuPanel';
 export { MobileContextMenu } from './views/components/context-menu/MobileContextMenu';
@@ -91,10 +92,21 @@ export { FloatDomSingle } from './views/components/dom/FloatDom';
 export { FloatDom } from './views/components/dom/FloatDom';
 export { PrintFloatDomSingle } from './views/components/dom/Print';
 export { CanvasPopup, SingleCanvasPopup } from './views/components/popup/CanvasPopup';
-export { RectPopup, type RectPopupDirection } from './views/components/popup/RectPopup';
+export { RectPopup } from './views/components/popup/RectPopup';
+export type { RectPopupDirection } from './views/components/popup/RectPopup';
 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 ISidebarMethodOptions, Sidebar } from './views/components/sidebar/Sidebar';
-export { ZenZone } from './views/components/zen-zone/ZenZone';
+export { Sidebar } from './views/components/sidebar/Sidebar';
+export type { ISidebarMethodOptions } from './views/components/sidebar/Sidebar';
+export { FontFamily } from './views/font-family/FontFamily';
+export { FontFamilyItem } from './views/font-family/FontFamilyItem';
+export { FONT_FAMILY_COMPONENT, FONT_FAMILY_ITEM_COMPONENT } from './views/font-family/interface';
+export type { IFontFamilyProps } from './views/font-family/interface';
+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';
+export * from './views/index';
+export { type INotificationOptions } from './views/notification/Notification';
+export { ProgressBar } from './views/progress-bar/ProgressBar';

package/lib/types/locale/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 { LocaleLeafKeys } from '@univerjs/core';
+import type enUS from './en-US';
+export type LocaleKey = LocaleLeafKeys<typeof enUS>;

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

@@ -20,14 +20,18 @@ 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 interface IMenuSchema {
     key: string;
     order: number;
     title?: string;
     contextual?: boolean;
     item?: IMenuItem;
+    headerActionItem?: IMenuItem;
     children?: IMenuSchema[];
     quickLayout?: ContextMenuQuickLayout;
+    quickColumns?: number;
+    quickLayoutVariant?: ContextMenuQuickLayoutVariant;
     tiny?: boolean;
 }
 export interface IMenuManagerService {
@@ -39,10 +43,14 @@ export interface IMenuManagerService {
 }
 export type MenuSchemaType = {
     order?: number;
+    replace?: boolean;
     menuItemFactory?: (accessor: IAccessor) => IMenuItem;
+    headerActionMenuItemFactory?: (accessor: IAccessor) => IMenuItem;
     title?: string;
     contextual?: boolean;
     quickLayout?: ContextMenuQuickLayout;
+    quickColumns?: number;
+    quickLayoutVariant?: ContextMenuQuickLayoutVariant;
     tiny?: boolean;
 } | {
     [key: string]: MenuSchemaType;

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

@@ -26,7 +26,13 @@ export declare enum MenuItemType {
     /** Submenus have to specific features and do not invoke commands. */
     SUBITEMS = 3
 }
-interface IMenuItemBase<V> {
+type MenuLabel = string | {
+    name: string;
+    hoverable?: boolean;
+    selectable?: boolean;
+    props?: Record<string, any>;
+};
+interface IMenuItemBase<TLocaleKey extends string, TValue> {
     /** ID of the menu item. Normally it should be the same as the ID of the command that it would invoke.  */
     id: string;
     /**
@@ -35,47 +41,35 @@ interface IMenuItemBase<V> {
      */
     commandId?: string;
     subId?: string;
-    title?: string;
+    title?: TLocaleKey;
     description?: string;
     icon?: string | Observable<string>;
-    tooltip?: string;
+    tooltip?: TLocaleKey;
     slot?: boolean;
     type: MenuItemType;
     /**
      * Custom label component id.
      */
-    label?: string | {
-        name: string;
-        hoverable?: boolean;
-        selectable?: boolean;
-        props?: Record<string, any>;
-    };
+    label?: MenuLabel;
     hidden$?: Observable<boolean>;
     disabled$?: Observable<boolean>;
     params?: any | Function;
     /** On observable value that should emit the value of the corresponding selection component. */
-    value$?: Observable<V>;
+    value$?: Observable<TValue>;
 }
-export interface IMenuButtonItem<V = undefined> extends IMenuItemBase<V> {
+export interface IMenuButtonItem<TLocaleKey extends string = string, TValue = undefined> extends IMenuItemBase<TLocaleKey, TValue> {
     type: MenuItemType.BUTTON;
     activated$?: Observable<boolean>;
 }
-export interface IValueOption<T = undefined> {
+export interface IValueOption<TLocaleKey extends string = string, TValue = undefined> {
     id?: string;
     value?: string | number;
-    value$?: Observable<T>;
+    value$?: Observable<TValue>;
     params?: any;
     slot?: boolean;
-    label?: string | {
-        name: string;
-        hoverable?: boolean;
-        selectable?: boolean;
-        props?: Record<string, string | number | Array<{
-            [x: string | number]: string;
-        }>>;
-    };
+    label?: MenuLabel;
     icon?: string;
-    tooltip?: string;
+    tooltip?: TLocaleKey;
     style?: object;
     disabled?: boolean;
     commandId?: string;
@@ -84,7 +78,7 @@ export interface ICustomComponentProps<T> {
     value: T;
     onChange: (v: T) => void;
 }
-export interface IMenuSelectorItem<V = MenuItemDefaultValueType, T = undefined> extends IMenuItemBase<V> {
+export interface IMenuSelectorItem<TLocaleKey extends string = string, TValue = MenuItemDefaultValueType, TOptionValue = undefined> extends IMenuItemBase<TLocaleKey, TValue> {
     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,
@@ -93,22 +87,22 @@ export interface IMenuSelectorItem<V = MenuItemDefaultValueType, T = undefined>
      */
     selectionsCommandId?: string;
     /** Options or IDs of registered components. */
-    selections?: Array<IValueOption<T>> | Observable<Array<IValueOption<T>>>;
+    selections?: Array<IValueOption<TLocaleKey, TOptionValue>> | Observable<Array<IValueOption<TLocaleKey, TOptionValue>>>;
     /** If `type` is `MenuItemType.BUTTON_SELECTOR`, this determines if the button is activated. */
     activated$?: Observable<boolean>;
 }
-export declare function isMenuSelectorItem<T extends MenuItemDefaultValueType>(v: IMenuItem): v is IMenuSelectorItem<T>;
-export declare function isMenuButtonSelectorItem<T extends MenuItemDefaultValueType>(v: IMenuItem): v is IMenuSelectorItem<T>;
 export type MenuItemDefaultValueType = string | number | undefined;
-export type IMenuItem = IMenuButtonItem<MenuItemDefaultValueType> | IMenuSelectorItem<MenuItemDefaultValueType, any>;
-export type IDisplayMenuItem<T extends IMenuItem> = T & {
+export type IMenuItem<TLocaleKey extends string = string> = IMenuButtonItem<TLocaleKey, MenuItemDefaultValueType> | IMenuSelectorItem<TLocaleKey, MenuItemDefaultValueType, any>;
+export declare function isMenuSelectorItem<T extends MenuItemDefaultValueType, TLocaleKey extends string = string>(v: IMenuItem<TLocaleKey>): v is IMenuSelectorItem<TLocaleKey, T, any>;
+export declare function isMenuButtonSelectorItem<T extends MenuItemDefaultValueType, TLocaleKey extends string = string>(v: IMenuItem<TLocaleKey>): v is IMenuSelectorItem<TLocaleKey, T, any>;
+export type IDisplayMenuItem<T extends IMenuItem = IMenuItem> = T & {
     shortcut?: string;
 };
-export type MenuItemConfig = Partial<Omit<IMenuItem, 'id' | 'subId' | 'value$' | 'hidden$' | 'disabled$' | 'activated$' | 'icon$'> & {
+export type MenuItemConfig<TLocaleKey extends string = string> = Partial<Omit<IMenuItem<TLocaleKey>, 'id' | 'subId' | 'value$' | 'hidden$' | 'disabled$' | 'activated$' | 'icon$'> & {
     hidden?: boolean;
     disabled?: boolean;
     activated?: boolean;
 }>;
-export type MenuConfig = Record<string, MenuItemConfig>;
-export type IMenuItemFactory = (accessor: IAccessor, menuConfig?: MenuConfig) => IMenuItem;
+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 {};

package/lib/types/services/notification/desktop-notification.service.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IDisposable } from '@univerjs/core';
-import type { INotificationOptions } from '../../components/notification/Notification';
+import type { INotificationOptions } from '../../views/notification/Notification';
 import type { INotificationService } from './notification.service';
 import { Disposable, Injector } from '@univerjs/core';
 import { IUIPartsService } from '../parts/parts.service';

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IDisposable } from '@univerjs/core';
-import type { INotificationOptions } from '../../components/notification/Notification';
+import type { INotificationOptions } from '../../views/notification/Notification';
 export declare const INotificationService: import("@wendellhu/redi").IdentifierDecorator<INotificationService>;
 export interface INotificationService {
     show(params: INotificationOptions): IDisposable;

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

@@ -23,6 +23,8 @@ export declare enum KeyCode {
     CTRL = 17,
     ESC = 27,
     SPACE = 32,
+    END = 35,
+    HOME = 36,
     ARROW_LEFT = 37,
     ARROW_UP = 38,
     ARROW_RIGHT = 39,

package/lib/types/utils/storage-driver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+interface IStorageDriver {
+    getItem<T>(key: string): Promise<T | null>;
+    setItem<T>(key: string, value: T): Promise<T>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    key(index: number): Promise<string | null>;
+    keys(): Promise<string[]>;
+    iterate<T, U>(iteratee: (value: T, key: string, iterationNumber: number) => U): Promise<U>;
+}
+export declare const browserStorage: IStorageDriver;
+export {};

package/lib/types/{components/common-label/index.d.ts → views/CommonLabel.d.ts}

@@ -20,5 +20,5 @@ export interface ICommonLabelProps {
         label: string;
     }[];
 }
-export declare const CommonLabel: (props: ICommonLabelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommonLabel: (props: ICommonLabelProps) => import("react").JSX.Element;
 export declare const COMMON_LABEL_COMPONENT = "UI_PLUGIN_COMMON_LABEL_COMPONENT";

package/lib/types/{components/heading-item/index.d.ts → views/HeadingItem.d.ts}

@@ -17,5 +17,5 @@ import type { NamedStyleType } from '@univerjs/core';
 export declare const HeadingItem: (props: {
     value: NamedStyleType;
     text: string;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;
 export declare const HEADING_ITEM_COMPONENT = "UI_COMPONENT_HEADING_ITEM";

package/lib/types/views/components/confirm-part/ConfirmPart.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare function ConfirmPart(): import("react/jsx-runtime").JSX.Element[];
+export declare function ConfirmPart(): import("react").JSX.Element[];

package/lib/types/views/components/confirm-part/interface.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IConfirmProps } from '@univerjs/design';
-import type { ICustomLabelProps } from '../../../components/custom-label/CustomLabel';
+import type { ICustomLabelProps } from '../../custom-label/CustomLabel';
 export interface IConfirmChildrenProps {
     hooks: {
         beforeConfirm?: () => Record<string, any>;

package/lib/types/views/components/context-menu/AnchoredContextMenu.d.ts

@@ -29,4 +29,4 @@ export interface IAnchoredContextMenuProps {
     onRequestClose: () => void;
     onOptionSelect?: (option: IValueOption) => void;
 }
-export declare function AnchoredContextMenu(props: IAnchoredContextMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnchoredContextMenu(props: IAnchoredContextMenuProps): import("react").JSX.Element;

package/lib/types/views/components/context-menu/ContextMenu.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare function DesktopContextMenu(): import("react/jsx-runtime").JSX.Element;
+export declare function DesktopContextMenu(): import("react").JSX.Element;