@ckeditor/ckeditor5-ui 48.2.0 → 48.3.0-alpha.1

package/dist/menubar/utils.d.ts

@@ -1,471 +1,471 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { type MenuBarMenuView } from './menubarmenuview.js';
-import type { MenuBarView, MenuBarConfig, MenuBarConfigObject, MenuBarConfigAddedGroup, MenuBarConfigAddedMenu, NormalizedMenuBarConfigObject, MenuBarConfigAddedItem } from './menubarview.js';
-import { type ComponentFactory } from '../componentfactory.js';
-import { type Locale, type PositioningFunction } from '@ckeditor/ckeditor5-utils';
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import { type MenuBarMenuView } from "./menubarmenuview.js";
+import type { MenuBarView, MenuBarConfig, MenuBarConfigObject, MenuBarConfigAddedGroup, MenuBarConfigAddedMenu, NormalizedMenuBarConfigObject, MenuBarConfigAddedItem } from "./menubarview.js";
+import { type ComponentFactory } from "../componentfactory.js";
+import { type Locale, type PositioningFunction } from "@ckeditor/ckeditor5-utils";
 /**
- * Behaviors of the {@link module:ui/menubar/menubarview~MenuBarView} component.
- * @internal
- */
+* Behaviors of the {@link module:ui/menubar/menubarview~MenuBarView} component.
+* @internal
+*/
 export declare const MenuBarBehaviors: {
-    /**
-     * When the bar is already open:
-     * * Opens the menu when the user hovers over its button.
-     * * Closes open menu when another menu's button gets hovered.
-     */
-    toggleMenusAndFocusItemsOnHover(menuBarView: MenuBarView): void;
-    /**
-     * Moves between top-level menus using the arrow left and right keys.
-     *
-     * If the menubar has already been open, the arrow keys move focus between top-level menu buttons and open them.
-     * If the menubar is closed, the arrow keys only move focus between top-level menu buttons.
-     */
-    focusCycleMenusOnArrows(menuBarView: MenuBarView): void;
-    /**
-     * Closes the entire sub-menu structure when the bar is closed. This prevents sub-menus from being open if the user
-     * closes the entire bar, and then re-opens some top-level menu.
-     */
-    closeMenusWhenTheBarCloses(menuBarView: MenuBarView): void;
-    /**
-     * Handles the following case:
-     * 1. Hover to open a sub-menu (A). The button has focus.
-     * 2. Press arrow up/down to move focus to another sub-menu (B) button.
-     * 3. Press arrow right to open the sub-menu (B).
-     * 4. The sub-menu (A) should close as it would with `toggleMenusAndFocusItemsOnHover()`.
-     */
-    closeMenuWhenAnotherOnTheSameLevelOpens(menuBarView: MenuBarView): void;
-    /**
-     * Closes the bar when the user clicked outside of it (page body, editor root, etc.).
-     */
-    closeOnClickOutside(menuBarView: MenuBarView): void;
-    /**
-     * Tracks the keyboard focus interaction on the menu bar view. It is used to determine if the nested items
-     * of the menu bar should render focus rings after first interaction with the keyboard.
-     */
-    enableFocusHighlightOnInteraction(menuBarView: MenuBarView): void;
+	/**
+	* When the bar is already open:
+	* * Opens the menu when the user hovers over its button.
+	* * Closes open menu when another menu's button gets hovered.
+	*/
+	toggleMenusAndFocusItemsOnHover(menuBarView: MenuBarView): void;
+	/**
+	* Moves between top-level menus using the arrow left and right keys.
+	*
+	* If the menubar has already been open, the arrow keys move focus between top-level menu buttons and open them.
+	* If the menubar is closed, the arrow keys only move focus between top-level menu buttons.
+	*/
+	focusCycleMenusOnArrows(menuBarView: MenuBarView): void;
+	/**
+	* Closes the entire sub-menu structure when the bar is closed. This prevents sub-menus from being open if the user
+	* closes the entire bar, and then re-opens some top-level menu.
+	*/
+	closeMenusWhenTheBarCloses(menuBarView: MenuBarView): void;
+	/**
+	* Handles the following case:
+	* 1. Hover to open a sub-menu (A). The button has focus.
+	* 2. Press arrow up/down to move focus to another sub-menu (B) button.
+	* 3. Press arrow right to open the sub-menu (B).
+	* 4. The sub-menu (A) should close as it would with `toggleMenusAndFocusItemsOnHover()`.
+	*/
+	closeMenuWhenAnotherOnTheSameLevelOpens(menuBarView: MenuBarView): void;
+	/**
+	* Closes the bar when the user clicked outside of it (page body, editor root, etc.).
+	*/
+	closeOnClickOutside(menuBarView: MenuBarView): void;
+	/**
+	* Tracks the keyboard focus interaction on the menu bar view. It is used to determine if the nested items
+	* of the menu bar should render focus rings after first interaction with the keyboard.
+	*/
+	enableFocusHighlightOnInteraction(menuBarView: MenuBarView): void;
 };
 /**
- * Behaviors of the {@link module:ui/menubar/menubarmenuview~MenuBarMenuView} component.
- * @internal
- */
+* Behaviors of the {@link module:ui/menubar/menubarmenuview~MenuBarMenuView} component.
+* @internal
+*/
 export declare const MenuBarMenuBehaviors: {
-    /**
-     * If the button of the menu is focused, pressing the arrow down key should open the panel and focus it.
-     * This is analogous to the {@link module:ui/dropdown/dropdownview~DropdownView}.
-     */
-    openAndFocusPanelOnArrowDownKey(menuView: MenuBarMenuView): void;
-    /**
-     * Open the menu on the right arrow key press. This allows for navigating to sub-menus using the keyboard.
-     */
-    openOnArrowRightKey(menuView: MenuBarMenuView): void;
-    /**
-     * Opens the menu on its button click. Note that this behavior only opens but never closes the menu (unlike
-     * {@link module:ui/dropdown/dropdownview~DropdownView}).
-     */
-    openOnButtonClick(menuView: MenuBarMenuView): void;
-    /**
-     * Toggles the menu on its button click. This behavior is analogous to {@link module:ui/dropdown/dropdownview~DropdownView}.
-     */
-    toggleOnButtonClick(menuView: MenuBarMenuView): void;
-    /**
-     * Opens the menu and focuses the panel content upon pressing the Enter key.
-     */
-    openAndFocusOnEnterKeyPress(menuView: MenuBarMenuView): void;
-    /**
-     * Closes the menu on the right left key press. This allows for navigating to sub-menus using the keyboard.
-     */
-    closeOnArrowLeftKey(menuView: MenuBarMenuView): void;
-    /**
-     * Closes the menu on the esc key press. This allows for navigating to sub-menus using the keyboard.
-     */
-    closeOnEscKey(menuView: MenuBarMenuView): void;
-    /**
-     * Closes the menu when its parent menu also closed. This prevents from orphaned open menus when the parent menu re-opens.
-     */
-    closeOnParentClose(menuView: MenuBarMenuView): void;
+	/**
+	* If the button of the menu is focused, pressing the arrow down key should open the panel and focus it.
+	* This is analogous to the {@link module:ui/dropdown/dropdownview~DropdownView}.
+	*/
+	openAndFocusPanelOnArrowDownKey(menuView: MenuBarMenuView): void;
+	/**
+	* Open the menu on the right arrow key press. This allows for navigating to sub-menus using the keyboard.
+	*/
+	openOnArrowRightKey(menuView: MenuBarMenuView): void;
+	/**
+	* Opens the menu on its button click. Note that this behavior only opens but never closes the menu (unlike
+	* {@link module:ui/dropdown/dropdownview~DropdownView}).
+	*/
+	openOnButtonClick(menuView: MenuBarMenuView): void;
+	/**
+	* Toggles the menu on its button click. This behavior is analogous to {@link module:ui/dropdown/dropdownview~DropdownView}.
+	*/
+	toggleOnButtonClick(menuView: MenuBarMenuView): void;
+	/**
+	* Opens the menu and focuses the panel content upon pressing the Enter key.
+	*/
+	openAndFocusOnEnterKeyPress(menuView: MenuBarMenuView): void;
+	/**
+	* Closes the menu on the right left key press. This allows for navigating to sub-menus using the keyboard.
+	*/
+	closeOnArrowLeftKey(menuView: MenuBarMenuView): void;
+	/**
+	* Closes the menu on the esc key press. This allows for navigating to sub-menus using the keyboard.
+	*/
+	closeOnEscKey(menuView: MenuBarMenuView): void;
+	/**
+	* Closes the menu when its parent menu also closed. This prevents from orphaned open menus when the parent menu re-opens.
+	*/
+	closeOnParentClose(menuView: MenuBarMenuView): void;
 };
 /**
- * Contains every positioning function used by {@link module:ui/menubar/menubarmenuview~MenuBarMenuView} that decides where the
- * {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#panelView} should be placed.
- *
- * Top-level menu positioning functions:
- *
- *	┌──────┐
- *	│      │
- *	├──────┴────────┐
- *	│               │
- *	│               │
- *	│               │
- *	│            SE │
- *	└───────────────┘
- *
- *	         ┌──────┐
- *	         │      │
- *	┌────────┴──────┤
- *	│               │
- *	│               │
- *	│               │
- *	│ SW            │
- *	└───────────────┘
- *
- *	┌───────────────┐
- *	│ NW            │
- *	│               │
- *	│               │
- *	│               │
- *	└────────┬──────┤
- *	         │      │
- *	         └──────┘
- *
- *	┌───────────────┐
- *	│            NE │
- *	│               │
- *	│               │
- *	│               │
- *	├──────┬────────┘
- *	│      │
- *	└──────┘
- *
- * Sub-menu positioning functions:
- *
- *	┌──────┬───────────────┐
- *	│      │               │
- *	└──────┤               │
- *	       │               │
- *	       │            ES │
- *	       └───────────────┘
- *
- *	┌───────────────┬──────┐
- *	│               │      │
- *	│               ├──────┘
- *	│               │
- *	│ WS            │
- *	└───────────────┘
- *
- *	       ┌───────────────┐
- *	       │            EN │
- *	       │               │
- *	┌──────┤               │
- *	│      │               │
- *	└──────┴───────────────┘
- *
- *	┌───────────────┐
- *	│ WN            │
- *	│               │
- *	│               ├──────┐
- *	│               │      │
- *	└───────────────┴──────┘
- */
+* Contains every positioning function used by {@link module:ui/menubar/menubarmenuview~MenuBarMenuView} that decides where the
+* {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#panelView} should be placed.
+*
+* Top-level menu positioning functions:
+*
+*	┌──────┐
+*	│      │
+*	├──────┴────────┐
+*	│               │
+*	│               │
+*	│               │
+*	│            SE │
+*	└───────────────┘
+*
+*	         ┌──────┐
+*	         │      │
+*	┌────────┴──────┤
+*	│               │
+*	│               │
+*	│               │
+*	│ SW            │
+*	└───────────────┘
+*
+*	┌───────────────┐
+*	│ NW            │
+*	│               │
+*	│               │
+*	│               │
+*	└────────┬──────┤
+*	         │      │
+*	         └──────┘
+*
+*	┌───────────────┐
+*	│            NE │
+*	│               │
+*	│               │
+*	│               │
+*	├──────┬────────┘
+*	│      │
+*	└──────┘
+*
+* Sub-menu positioning functions:
+*
+*	┌──────┬───────────────┐
+*	│      │               │
+*	└──────┤               │
+*	       │               │
+*	       │            ES │
+*	       └───────────────┘
+*
+*	┌───────────────┬──────┐
+*	│               │      │
+*	│               ├──────┘
+*	│               │
+*	│ WS            │
+*	└───────────────┘
+*
+*	       ┌───────────────┐
+*	       │            EN │
+*	       │               │
+*	┌──────┤               │
+*	│      │               │
+*	└──────┴───────────────┘
+*
+*	┌───────────────┐
+*	│ WN            │
+*	│               │
+*	│               ├──────┐
+*	│               │      │
+*	└───────────────┴──────┘
+*/
 /**
- * @internal
- */
+* @internal
+*/
 export declare const MenuBarMenuViewPanelPositioningFunctions: Record<string, PositioningFunction>;
 /**
- * The default items {@link module:core/editor/editorconfig~EditorConfig#menuBar configuration} of the
- * {@link module:ui/menubar/menubarview~MenuBarView} component. It contains names of all menu bar components
- * registered in the {@link module:ui/componentfactory~ComponentFactory component factory} (available in the project).
- *
- * **Note**: Menu bar component names provided by core editor features are prefixed with `menuBar:` in order to distinguish
- * them from components referenced by the {@link module:core/editor/editorconfig~EditorConfig#toolbar toolbar configuration}, for instance,
- * `'menuBar:bold'` is a menu bar button but `'bold'` is a toolbar button.
- *
- * Below is the preset menu bar structure (the default value of `config.menuBar.items` property):
- *
- * ```ts
- * [
- * 	{
- * 		menuId: 'file',
- * 		label: 'File',
- * 		groups: [
- * 			{
- * 				groupId: 'export',
- * 				items: [
- * 					'menuBar:exportPdf',
- * 					'menuBar:exportWord'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'import',
- * 				items: [
- * 					'menuBar:importWord'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'revisionHistory',
- * 				items: [
- * 					'menuBar:revisionHistory'
- * 				]
- * 			}
- * 		]
- * 	},
- * 	{
- * 		menuId: 'edit',
- * 		label: 'Edit',
- * 		groups: [
- * 			{
- * 				groupId: 'undo',
- * 				items: [
- * 					'menuBar:undo',
- * 					'menuBar:redo'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'selectAll',
- * 				items: [
- * 					'menuBar:selectAll'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'findAndReplace',
- * 				items: [
- * 					'menuBar:findAndReplace'
- * 				]
- * 			}
- * 		]
- * 	},
- * 	{
- * 		menuId: 'view',
- * 		label: 'View',
- * 		groups: [
- * 			{
- * 				groupId: 'sourceEditingEnhanced',
- * 				items: [
- * 					'menuBar:sourceEditingEnhanced'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'sourceEditing',
- * 				items: [
- * 					'menuBar:sourceEditing'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'showBlocks',
- * 				items: [
- * 					'menuBar:showBlocks'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'previewMergeFields',
- * 				items: [
- * 					'menuBar:previewMergeFields'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'fullscreen',
- * 				items: [
- * 					'menuBar:fullscreen'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'restrictedEditingException',
- * 				items: [
- * 					'menuBar:restrictedEditingException'
- * 				]
- * 			}
- * 		]
- * 	},
- * 	{
- * 		menuId: 'insert',
- * 		label: 'Insert',
- * 		groups: [
- * 			{
- * 				groupId: 'insertMainWidgets',
- * 				items: [
- * 					'menuBar:insertImage',
- * 					'menuBar:ckbox',
- * 					'menuBar:ckfinder',
- * 					'menuBar:insertTable'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'insertInline',
- * 				items: [
- * 					'menuBar:link',
- * 					'menuBar:insertFootnote',
- * 					'menuBar:bookmark',
- * 					'menuBar:comment',
- * 					'menuBar:insertMergeField',
- * 					'menuBar:emoji'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'insertMinorWidgets',
- * 				items: [
- * 					'menuBar:mediaEmbed',
- * 					'menuBar:insertTemplate',
- * 					'menuBar:blockQuote',
- * 					'menuBar:codeBlock',
- * 					'menuBar:htmlEmbed'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'insertStructureWidgets',
- * 				items: [
- * 					'menuBar:horizontalLine',
- * 					'menuBar:pageBreak',
- * 					'menuBar:tableOfContents'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'restrictedEditing',
- * 				items: [
- * 					'menuBar:restrictedEditing'
- * 				]
- * 			}
- * 		]
- * 	},
- * 	{
- * 		menuId: 'format',
- * 		label: 'Format',
- * 		groups: [
- * 			{
- * 				groupId: 'textAndFont',
- * 				items: [
- * 					{
- * 						menuId: 'text',
- * 						label: 'Text',
- * 						groups: [
- * 							{
- * 								groupId: 'basicStyles',
- * 								items: [
- * 									'menuBar:bold',
- * 									'menuBar:italic',
- * 									'menuBar:underline',
- * 									'menuBar:strikethrough',
- * 									'menuBar:superscript',
- * 									'menuBar:subscript',
- * 									'menuBar:code'
- * 								]
- * 							},
- * 							{
- * 								groupId: 'textPartLanguage',
- * 								items: [
- * 									'menuBar:textPartLanguage'
- * 								]
- * 							}
- * 						]
- * 					},
- * 					{
- * 						menuId: 'font',
- * 						label: 'Font',
- * 						groups: [
- * 							{
- * 								groupId: 'fontProperties',
- * 								items: [
- * 									'menuBar:fontSize',
- * 									'menuBar:fontFamily'
- * 								]
- * 							},
- * 							{
- * 								groupId: 'fontColors',
- * 								items: [
- * 									'menuBar:fontColor',
- * 									'menuBar:fontBackgroundColor'
- * 								]
- * 							},
- * 							{
- * 								groupId: 'highlight',
- * 								items: [
- * 									'menuBar:highlight'
- * 								]
- * 							}
- * 						]
- * 					},
- * 					'menuBar:heading'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'list',
- * 				items: [
- * 					'menuBar:bulletedList',
- * 					'menuBar:numberedList',
- * 					'menuBar:multiLevelList',
- * 					'menuBar:todoList'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'indent',
- * 				items: [
- * 					'menuBar:alignment',
- * 					'menuBar:lineHeight',
- * 					'menuBar:indent',
- * 					'menuBar:outdent'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'caseChange',
- * 				items: [
- * 					'menuBar:caseChange'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'removeFormat',
- * 				items: [
- * 					'menuBar:removeFormat'
- * 				]
- * 			}
- * 		]
- * 	},
- * 	{
- * 		menuId: 'tools',
- * 		label: 'Tools',
- * 		groups: [
- * 			{
- * 				groupId: 'aiTools',
- * 				items: [
- * 					'menuBar:aiAssistant',
- * 					'menuBar:aiCommands',
- * 					'menuBar:toggleAi',
- * 					'menuBar:aiQuickActions'
- * 				]
- * 			},
- * 			{
- * 				groupId: 'tools',
- * 				items: [
- * 					'menuBar:trackChanges',
- * 					'menuBar:commentsArchive'
- * 				]
- * 			}
- * 		]
- * 	},
- * 	{
- * 		menuId: 'help',
- * 		label: 'Help',
- * 		groups: [
- * 			{
- * 				groupId: 'help',
- * 				items: [
- * 					'menuBar:accessibilityHelp'
- * 				]
- * 			}
- * 		]
- * 	}
- * ];
- * ```
- *
- * The menu bar can be customized using the `config.menuBar.removeItems` and `config.menuBar.addItems` properties.
- */
-export declare const DefaultMenuBarItems: MenuBarConfigObject['items'];
+* The default items {@link module:core/editor/editorconfig~EditorConfig#menuBar configuration} of the
+* {@link module:ui/menubar/menubarview~MenuBarView} component. It contains names of all menu bar components
+* registered in the {@link module:ui/componentfactory~ComponentFactory component factory} (available in the project).
+*
+* **Note**: Menu bar component names provided by core editor features are prefixed with `menuBar:` in order to distinguish
+* them from components referenced by the {@link module:core/editor/editorconfig~EditorConfig#toolbar toolbar configuration}, for instance,
+* `'menuBar:bold'` is a menu bar button but `'bold'` is a toolbar button.
+*
+* Below is the preset menu bar structure (the default value of `config.menuBar.items` property):
+*
+* ```ts
+* [
+* 	{
+* 		menuId: 'file',
+* 		label: 'File',
+* 		groups: [
+* 			{
+* 				groupId: 'export',
+* 				items: [
+* 					'menuBar:exportPdf',
+* 					'menuBar:exportWord'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'import',
+* 				items: [
+* 					'menuBar:importWord'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'revisionHistory',
+* 				items: [
+* 					'menuBar:revisionHistory'
+* 				]
+* 			}
+* 		]
+* 	},
+* 	{
+* 		menuId: 'edit',
+* 		label: 'Edit',
+* 		groups: [
+* 			{
+* 				groupId: 'undo',
+* 				items: [
+* 					'menuBar:undo',
+* 					'menuBar:redo'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'selectAll',
+* 				items: [
+* 					'menuBar:selectAll'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'findAndReplace',
+* 				items: [
+* 					'menuBar:findAndReplace'
+* 				]
+* 			}
+* 		]
+* 	},
+* 	{
+* 		menuId: 'view',
+* 		label: 'View',
+* 		groups: [
+* 			{
+* 				groupId: 'sourceEditingEnhanced',
+* 				items: [
+* 					'menuBar:sourceEditingEnhanced'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'sourceEditing',
+* 				items: [
+* 					'menuBar:sourceEditing'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'showBlocks',
+* 				items: [
+* 					'menuBar:showBlocks'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'previewMergeFields',
+* 				items: [
+* 					'menuBar:previewMergeFields'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'fullscreen',
+* 				items: [
+* 					'menuBar:fullscreen'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'restrictedEditingException',
+* 				items: [
+* 					'menuBar:restrictedEditingException'
+* 				]
+* 			}
+* 		]
+* 	},
+* 	{
+* 		menuId: 'insert',
+* 		label: 'Insert',
+* 		groups: [
+* 			{
+* 				groupId: 'insertMainWidgets',
+* 				items: [
+* 					'menuBar:insertImage',
+* 					'menuBar:ckbox',
+* 					'menuBar:ckfinder',
+* 					'menuBar:insertTable'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'insertInline',
+* 				items: [
+* 					'menuBar:link',
+* 					'menuBar:insertFootnote',
+* 					'menuBar:bookmark',
+* 					'menuBar:comment',
+* 					'menuBar:insertMergeField',
+* 					'menuBar:emoji'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'insertMinorWidgets',
+* 				items: [
+* 					'menuBar:mediaEmbed',
+* 					'menuBar:insertTemplate',
+* 					'menuBar:blockQuote',
+* 					'menuBar:codeBlock',
+* 					'menuBar:htmlEmbed'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'insertStructureWidgets',
+* 				items: [
+* 					'menuBar:horizontalLine',
+* 					'menuBar:pageBreak',
+* 					'menuBar:tableOfContents'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'restrictedEditing',
+* 				items: [
+* 					'menuBar:restrictedEditing'
+* 				]
+* 			}
+* 		]
+* 	},
+* 	{
+* 		menuId: 'format',
+* 		label: 'Format',
+* 		groups: [
+* 			{
+* 				groupId: 'textAndFont',
+* 				items: [
+* 					{
+* 						menuId: 'text',
+* 						label: 'Text',
+* 						groups: [
+* 							{
+* 								groupId: 'basicStyles',
+* 								items: [
+* 									'menuBar:bold',
+* 									'menuBar:italic',
+* 									'menuBar:underline',
+* 									'menuBar:strikethrough',
+* 									'menuBar:superscript',
+* 									'menuBar:subscript',
+* 									'menuBar:code'
+* 								]
+* 							},
+* 							{
+* 								groupId: 'textPartLanguage',
+* 								items: [
+* 									'menuBar:textPartLanguage'
+* 								]
+* 							}
+* 						]
+* 					},
+* 					{
+* 						menuId: 'font',
+* 						label: 'Font',
+* 						groups: [
+* 							{
+* 								groupId: 'fontProperties',
+* 								items: [
+* 									'menuBar:fontSize',
+* 									'menuBar:fontFamily'
+* 								]
+* 							},
+* 							{
+* 								groupId: 'fontColors',
+* 								items: [
+* 									'menuBar:fontColor',
+* 									'menuBar:fontBackgroundColor'
+* 								]
+* 							},
+* 							{
+* 								groupId: 'highlight',
+* 								items: [
+* 									'menuBar:highlight'
+* 								]
+* 							}
+* 						]
+* 					},
+* 					'menuBar:heading'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'list',
+* 				items: [
+* 					'menuBar:bulletedList',
+* 					'menuBar:numberedList',
+* 					'menuBar:multiLevelList',
+* 					'menuBar:todoList'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'indent',
+* 				items: [
+* 					'menuBar:alignment',
+* 					'menuBar:lineHeight',
+* 					'menuBar:indent',
+* 					'menuBar:outdent'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'caseChange',
+* 				items: [
+* 					'menuBar:caseChange'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'removeFormat',
+* 				items: [
+* 					'menuBar:removeFormat'
+* 				]
+* 			}
+* 		]
+* 	},
+* 	{
+* 		menuId: 'tools',
+* 		label: 'Tools',
+* 		groups: [
+* 			{
+* 				groupId: 'aiTools',
+* 				items: [
+* 					'menuBar:aiAssistant',
+* 					'menuBar:aiCommands',
+* 					'menuBar:toggleAi',
+* 					'menuBar:aiQuickActions'
+* 				]
+* 			},
+* 			{
+* 				groupId: 'tools',
+* 				items: [
+* 					'menuBar:trackChanges',
+* 					'menuBar:commentsArchive'
+* 				]
+* 			}
+* 		]
+* 	},
+* 	{
+* 		menuId: 'help',
+* 		label: 'Help',
+* 		groups: [
+* 			{
+* 				groupId: 'help',
+* 				items: [
+* 					'menuBar:accessibilityHelp'
+* 				]
+* 			}
+* 		]
+* 	}
+* ];
+* ```
+*
+* The menu bar can be customized using the `config.menuBar.removeItems` and `config.menuBar.addItems` properties.
+*/
+export declare const DefaultMenuBarItems: MenuBarConfigObject["items"];
 /**
- * Performs a cleanup and normalization of the menu bar configuration.
- */
+* Performs a cleanup and normalization of the menu bar configuration.
+*/
 export declare function normalizeMenuBarConfig(config: Readonly<MenuBarConfig>): NormalizedMenuBarConfigObject;
 /**
- * Processes a normalized menu bar config and returns a config clone with the following modifications:
- *
- * * Removed components that are not available in the component factory,
- * * Removed obsolete separators,
- * * Purged empty menus,
- * * Localized top-level menu labels.
- * @internal
- */
+* Processes a normalized menu bar config and returns a config clone with the following modifications:
+*
+* * Removed components that are not available in the component factory,
+* * Removed obsolete separators,
+* * Purged empty menus,
+* * Localized top-level menu labels.
+* @internal
+*/
 export declare function processMenuBarConfig({ normalizedConfig, locale, componentFactory, extraItems }: {
-    normalizedConfig: NormalizedMenuBarConfigObject;
-    locale: Locale;
-    componentFactory: ComponentFactory;
-    extraItems: Array<MenuBarConfigAddedItem | MenuBarConfigAddedGroup | MenuBarConfigAddedMenu>;
+	normalizedConfig: NormalizedMenuBarConfigObject;
+	locale: Locale;
+	componentFactory: ComponentFactory;
+	extraItems: Array<MenuBarConfigAddedItem | MenuBarConfigAddedGroup | MenuBarConfigAddedMenu>;
 }): NormalizedMenuBarConfigObject;