@ckeditor/ckeditor5-ui 43.0.0 → 43.1.0-alpha.1

package/dist/bindings/clickoutsidehandler.d.ts

@@ -9,7 +9,7 @@
 /**
  * @module ui/bindings/clickoutsidehandler
  */
-import type { DomEmitter } from '@ckeditor/ckeditor5-utils';
+import type { CallbackOptions, DomEmitter } from '@ckeditor/ckeditor5-utils';
 /**
  * Handles clicking **outside** of a specified set of elements, then fires an action.
  *
@@ -23,10 +23,12 @@ import type { DomEmitter } from '@ckeditor/ckeditor5-utils';
  * @param options.contextElements Array of HTML elements or a callback returning an array of HTML elements
  * that determine the scope of the handler. Clicking any of them or their descendants will **not** fire the callback.
  * @param options.callback An action executed by the handler.
+ * @param options.listenerOptions Additional options for the listener (like priority).
  */
-export default function clickOutsideHandler({ emitter, activator, callback, contextElements }: {
+export default function clickOutsideHandler({ emitter, activator, callback, contextElements, listenerOptions }: {
     emitter: DomEmitter;
     activator: () => boolean;
-    contextElements: Array<HTMLElement> | (() => Array<HTMLElement>);
+    contextElements: Array<Element> | (() => Array<Element>);
     callback: () => void;
+    listenerOptions?: CallbackOptions;
 }): void;

package/dist/dropdown/dropdownview.d.ts

@@ -15,6 +15,7 @@ import type { default as DropdownPanelView, PanelPosition } from './dropdownpane
 import type { FocusableView } from '../focuscycler.js';
 import type ListView from '../list/listview.js';
 import type ToolbarView from '../toolbar/toolbarview.js';
+import type DropdownMenuRootListView from './menu/dropdownmenurootlistview.js';
 import { KeystrokeHandler, FocusTracker, type Locale, type PositioningFunction } from '@ckeditor/ckeditor5-utils';
 import '../../theme/components/dropdown/dropdown.css';
 /**
@@ -111,9 +112,16 @@ export default class DropdownView extends View<HTMLDivElement> {
      * A child toolbar of the dropdown located in the
      * {@link module:ui/dropdown/dropdownview~DropdownView#panelView panel}.
      *
-     * **Note**: Only supported when dropdown has list view added using {@link module:ui/dropdown/utils~addToolbarToDropdown}.
+     * **Note**: Only supported when dropdown has a toolbar added using {@link module:ui/dropdown/utils~addToolbarToDropdown}.
      */
     toolbarView?: ToolbarView;
+    /**
+     * A child menu component of the dropdown located
+     * in its {@link module:ui/dropdown/dropdownview~DropdownView#panelView panel}.
+     *
+     * **Note**: Only supported when dropdown has a menu added using {@link module:ui/dropdown/utils~addMenuToDropdown}.
+     */
+    menuView?: DropdownMenuRootListView;
     /**
      * Controls whether the dropdown view is open, i.e. shows or hides the {@link #panelView panel}.
      *
@@ -300,16 +308,21 @@ export default class DropdownView extends View<HTMLDivElement> {
     private static _getOptimalPosition;
 }
 /**
- * Fired when the toolbar button or list item is executed.
+ * Fired when an item inside the dropdown is executed.
+ *
+ * **Note**: Only supported when dropdown was integrated with its child view using one of the helper functions:
+ * {@link module:ui/dropdown/utils~addListToDropdown}, {@link module:ui/dropdown/utils~addToolbarToDropdown}, or
+ * {@link module:ui/dropdown/utils~addMenuToDropdown}.
+ *
+ * When integrated with a list, it fires when a child of one of {@link module:ui/list/listitemview~ListItemView}s
+ * fired `execute` event.
  *
- * For {@link ~DropdownView#listView} It fires when a child of some {@link module:ui/list/listitemview~ListItemView}
- * fired `execute`.
+ * When integrated with a toolbar, it fires when one of the buttons has been {@link module:ui/button/button~Button#event:execute executed}.
  *
- * For {@link ~DropdownView#toolbarView} It fires when one of the buttons has been
- * {@link module:ui/button/button~Button#event:execute executed}.
+ * When integrated with a nested menu, it fires when one of the menu buttons has been executed.
  *
- * **Note**: Only supported when dropdown has list view added using {@link module:ui/dropdown/utils~addListToDropdown}
- * or {@link module:ui/dropdown/utils~addToolbarToDropdown}.
+ * In each case, the event is delegated from the component which fired it. It does not have additional parameters and `event.source` is the
+ * original component.
  *
  * @eventName ~DropdownView#execute
  */

package/dist/dropdown/menu/dropdownmenubehaviors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type DropdownMenuNestedMenuView from './dropdownmenunestedmenuview.js';
+import type DropdownMenuRootListView from './dropdownmenurootlistview.js';
+export declare const DropdownRootMenuBehaviors: {
+    /**
+     * Move focus to a menu item on mouse hover. If it is a button to open a nested menu, open that menu.
+     */
+    toggleMenusAndFocusItemsOnHover(rootList: DropdownMenuRootListView): 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 (if not, there are two open menus).
+     */
+    closeMenuWhenAnotherOnTheSameLevelOpens(rootList: DropdownMenuRootListView): void;
+};
+export declare const DropdownMenuBehaviors: {
+    /**
+     * Open the menu on the right arrow key press (left, in RTL mode). This allows for navigating to sub-menus using the keyboard.
+     */
+    openOnArrowRightKey(menuView: DropdownMenuNestedMenuView): void;
+    /**
+     * Opens the menu on its button click as well as enter and space keys press (if the button is focused).
+     */
+    openOnButtonClick(menuView: DropdownMenuNestedMenuView): void;
+    /**
+     * Opens the menu and focuses the panel content upon pressing the Enter key.
+     */
+    openAndFocusOnEnterKeyPress(menuView: DropdownMenuNestedMenuView): void;
+    /**
+     * Closes the menu on the left key press (right, in RTL mode). This allows for navigating to sub-menus using the keyboard.
+     */
+    closeOnArrowLeftKey(menuView: DropdownMenuNestedMenuView): void;
+    closeOnEscKey(menuView: DropdownMenuNestedMenuView): void;
+    /**
+     * Closes the menu when its parent menu closes. This prevents from leaving orphaned open menus.
+     */
+    closeOnParentClose(menuView: DropdownMenuNestedMenuView, parentMenuView: DropdownMenuNestedMenuView): void;
+};

package/dist/dropdown/menu/dropdownmenubuttonview.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenubuttonview
+ */
+import IconView from '../../icon/iconview.js';
+import ListItemButtonView from '../../button/listitembuttonview.js';
+import type { Locale } from '@ckeditor/ckeditor5-utils';
+import '../../../theme/components/dropdown/menu/dropdownmenubutton.css';
+/**
+ * Represents a view for a dropdown menu button.
+ */
+export default class DropdownMenuButtonView extends ListItemButtonView {
+    /**
+     * An icon that displays an arrow to indicate a direction of the menu.
+     */
+    readonly arrowView: IconView;
+    /**
+     * Creates an instance of the dropdown menu button view.
+     *
+     * @param locale The localization services instance.
+     */
+    constructor(locale: Locale);
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+    /**
+     * Creates the arrow view instance.
+     *
+     * @private
+     */
+    private _createArrowView;
+}

package/dist/dropdown/menu/dropdownmenulistitembuttonview.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenulistitembuttonview
+ */
+import type { Locale } from '@ckeditor/ckeditor5-utils';
+import ButtonView from '../../button/buttonview.js';
+import '../../../theme/components/dropdown/menu/dropdownmenulistitembutton.css';
+/**
+ * Represents a view for a button in a dropdown menu list item.
+ */
+export default class DropdownMenuListItemButtonView extends ButtonView {
+    readonly id: string;
+    constructor(locale: Locale, id: string, label: string);
+}

package/dist/dropdown/menu/dropdownmenulistitemview.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenulistitemview
+ */
+import type { Locale } from '@ckeditor/ckeditor5-utils';
+import type DropdownMenuNestedMenuView from './dropdownmenunestedmenuview.js';
+import ListItemView from '../../list/listitemview.js';
+import DropdownMenuListItemButtonView from './dropdownmenulistitembuttonview.js';
+import '../../../theme/components/dropdown/menu/dropdownmenulistitem.css';
+/**
+ * Represents a view for a single item in a dropdown menu list.
+ */
+export default class DropdownMenuListItemView extends ListItemView {
+    /**
+     * The view representing either a flat item or a nested menu in a dropdown menu list item.
+     */
+    readonly childView: DropdownMenuNestedMenuView | DropdownMenuListItemButtonView;
+    constructor(locale: Locale, parentMenuView: DropdownMenuNestedMenuView | null, childView: DropdownMenuNestedMenuView | DropdownMenuListItemButtonView);
+}

package/dist/dropdown/menu/dropdownmenulistview.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenulistview
+ */
+import type { Locale } from '@ckeditor/ckeditor5-utils';
+import ListView from '../../list/listview.js';
+/**
+ * Represents a dropdown menu list view.
+ */
+export default class DropdownMenuListView extends ListView {
+    /**
+     * Represents whether the dropdown menu list view is visible or not.
+     */
+    isVisible: boolean;
+    /**
+     * Creates an instance of the dropdown menu list view.
+     *
+     * @param locale The localization services instance.
+     */
+    constructor(locale: Locale);
+}

package/dist/dropdown/menu/dropdownmenunestedmenupanelview.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenunestedmenupanelview
+ */
+import type { Locale } from '@ckeditor/ckeditor5-utils';
+import type { FocusableView } from '../../focuscycler.js';
+import BalloonPanelView from '../../panel/balloon/balloonpanelview.js';
+import '../../../theme/components/dropdown/menu/dropdownmenupanel.css';
+/**
+ * Represents the view for the dropdown menu panel.
+ */
+export default class DropdownMenuNestedMenuPanelView extends BalloonPanelView implements FocusableView {
+    /**
+     * Creates an instance of the menu panel view.
+     *
+     * @param locale The localization services instance.
+     */
+    constructor(locale?: Locale);
+    /**
+     * Focuses the first child of the panel (default) or the last one if the `direction` is `-1`.
+     *
+     * @param direction The direction to focus. Default is `1`.
+     */
+    focus(direction?: -1 | 1): void;
+}
+/**
+ * The names of the positions of the {@link module:ui/dropdown/menu/dropdownmenunestedmenupanelview~DropdownMenuNestedMenuPanelView}.
+ *
+ * They are reflected as CSS class suffixes on the panel view element.
+ */
+export type DropdownMenuNestedMenuPanelPosition = 'es' | 'ws' | 'en' | 'wn' | 'w' | 'e';

package/dist/dropdown/menu/dropdownmenunestedmenuview.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenunestedmenuview
+ */
+import { FocusTracker, KeystrokeHandler, type PositioningFunction, type Locale } from '@ckeditor/ckeditor5-utils';
+import type { FocusableView } from '../../focuscycler.js';
+import type BodyCollection from '../../editorui/bodycollection.js';
+import DropdownMenuButtonView from './dropdownmenubuttonview.js';
+import DropdownMenuListView from './dropdownmenulistview.js';
+import View from '../../view.js';
+import DropdownMenuNestedMenuPanelView, { type DropdownMenuNestedMenuPanelPosition } from './dropdownmenunestedmenupanelview.js';
+import '../../../theme/components/dropdown/menu/dropdownmenu.css';
+/**
+ * Represents a nested menu view.
+ */
+export default class DropdownMenuNestedMenuView extends View implements FocusableView {
+    /**
+     * An array of delegated events for the dropdown menu definition controller.
+     * These events are delegated to the dropdown menu element.
+     */
+    static readonly DELEGATED_EVENTS: readonly ["mouseenter", "execute", "change:isOpen"];
+    readonly id: string;
+    /**
+     * Button of the menu view.
+     */
+    readonly buttonView: DropdownMenuButtonView;
+    /**
+     * Panel of the menu. It hosts children of the menu.
+     */
+    readonly panelView: DropdownMenuNestedMenuPanelView;
+    /**
+     * List of nested menu entries.
+     */
+    readonly listView: DropdownMenuListView;
+    /**
+     * Tracks information about the DOM focus in the menu.
+     */
+    readonly focusTracker: FocusTracker;
+    /**
+     * Instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}. It manages
+     * keystrokes of the menu.
+     */
+    readonly keystrokes: KeystrokeHandler;
+    /**
+     * Controls whether the menu is open, i.e. shows or hides the {@link #panelView panel}.
+     *
+     * @observable
+     */
+    isOpen: boolean;
+    /**
+     * Controls whether the menu is enabled, i.e. its {@link #buttonView} can be clicked.
+     *
+     * @observable
+     */
+    isEnabled: boolean;
+    /**
+     * (Optional) The additional CSS class set on the menu {@link #element}.
+     *
+     * @observable
+     */
+    class: string | undefined;
+    /**
+     * The name of the position of the {@link #panelView}, relative to the menu.
+     *
+     * **Note**: The value is updated each time the panel gets {@link #isOpen open}.
+     *
+     * @observable
+     * @default 'w'
+     */
+    panelPosition: DropdownMenuNestedMenuPanelPosition;
+    /**
+     * The parent menu view of the menu. It is `null` for top-level menus.
+     *
+     * @observable
+     * @default null
+     */
+    readonly parentMenuView: DropdownMenuNestedMenuView | null;
+    private _bodyCollection;
+    /**
+     * Creates a new instance of the DropdownMenuView class.
+     *
+     * @param locale
+     * @param bodyCollection
+     * @param id
+     * @param label The label for the dropdown menu button.
+     * @param parentMenuView The parent dropdown menu view, if any.
+     */
+    constructor(locale: Locale, bodyCollection: BodyCollection, id: string, label: string, parentMenuView: DropdownMenuNestedMenuView | null);
+    /**
+     * An array of positioning functions used to determine the position of the dropdown menu panel.
+     * The order of the functions in the array determines the priority of the positions to be tried.
+     * The first function that returns a valid position will be used.
+     *
+     * @returns {Array<PositioningFunction>} An array of positioning functions.
+     * @internal
+     */
+    get _panelPositions(): Array<PositioningFunction>;
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+    /**
+     * @inheritDoc
+     */
+    focus(): void;
+    private _handleParentMenuView;
+    /**
+     * Attach all keyboard behaviors for the menu view.
+     */
+    private _attachBehaviors;
+    /**
+     * Mounts the portal view in the body when the menu is open and removes it when the menu is closed.
+     * Binds keystrokes to the portal view when the menu is open.
+     */
+    private _mountPanelOnOpen;
+    /**
+     * Removes the panel view from the editor's body and removes it from the focus tracker.
+     */
+    private _removePanelFromBody;
+    /**
+     * Adds the panel view to the editor's body and sets up event listeners.
+     */
+    private _addPanelToBody;
+}

package/dist/dropdown/menu/dropdownmenurootlistview.d.ts

@@ -0,0 +1,144 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module ui/dropdown/menu/dropdownmenurootlistview
+ */
+import DropdownMenuListItemButtonView from './dropdownmenulistitembuttonview.js';
+import DropdownMenuNestedMenuView from './dropdownmenunestedmenuview.js';
+import DropdownMenuListView from './dropdownmenulistview.js';
+import type BodyCollection from '../../editorui/bodycollection.js';
+import type { DropdownMenuDefinition } from './utils.js';
+import type { Locale, BaseEvent } from '@ckeditor/ckeditor5-utils';
+/**
+ * Creates and manages a multi-level menu UI structure, suitable to be used inside dropdown components.
+ *
+ * This class creates a menu structure based on {@link module:ui/dropdown/menu/utils~DropdownMenuDefinition declarative definition}
+ * passed in the constructor.
+ *
+ * Below is an example of a simple definition, that describes a menu with two sub-menus (Menu 1, Menu 2) and four buttons in total (Item A,
+ * Item B, Item C, Item D):
+ *
+ * ```js
+ * [
+ * 	{
+ * 		id: 'menu_1',
+ * 		menu: 'Menu 1',
+ * 		children: [
+ * 			{ id: 'menu_1_a', label: 'Item A' },
+ * 			{ id: 'menu_1_b', label: 'Item B' }
+ * 		]
+ * 	},
+ * 	{
+ * 		id: 'menu_2',
+ * 		menu: 'Menu 2',
+ * 		children: [
+ * 			{ id: 'menu_2_c', label: 'Item C' },
+ * 		]
+ * 	},
+ * 	{ id: 'item_d', label: 'Item D' }
+ * ]
+ * ```
+ *
+ * The menu is build using multiple view classes. The most important are:
+ *
+ * * {@link module:ui/dropdown/menu/dropdownmenunestedmenuview~DropdownMenuNestedMenuView `DropdownMenuNestedMenuView`} - "menu" - provides
+ * a panel with a nested menu, and a button which opens the panel,
+ * * {@link module:ui/dropdown/menu/dropdownmenulistitembuttonview~DropdownMenuListItemButtonView `DropdownMenuListItemButtonView`} -
+ * "button" or "leaf button" (as opposed to buttons provided by `DropdownMenuNestedMenuView`) - should trigger some action when pressed.
+ *
+ * Instances of these two classes are created based on the data provided in definitions. They are assigned proper IDs and labels.
+ * Other view classes build a proper DOM structure around menus and buttons.
+ *
+ * The `DropdownMenuNestedMenuView` instances provides panels, which may include further menus or buttons. These panels are added to
+ * a `BodyCollection` view, which means they are appended outside the DOM editor and UI structure.
+ *
+ * When "leaf button" is pressed, it fires `execute` event which is delegated to `DropdownMenuRootListView` as `menu:execute` event. You
+ * can listen to this event to perform an action:
+ *
+ * ```js
+ * rootListView.on( 'menu:execute', evt => {
+ * 	console.log( evt.source.id ); // E.g. will print 'menu_1_a' when 'Item A' is pressed.
+ * } );
+ * ```
+ *
+ * All menus and "leaf" buttons created from the definition can be easily accessed through {@link ~DropdownMenuRootListView#menus `menus`}
+ * and {@link ~DropdownMenuRootListView#buttons `buttons`} properties.
+ *
+ * For performance reasons, the whole menu structure is created only when `DropdownMenuRootListView` is rendered for the first time.
+ *
+ * It is recommended to use this class together with {@link module:ui/dropdown/utils~addMenuToDropdown `addMenuToDropdown()` helper}.
+ */
+export default class DropdownMenuRootListView extends DropdownMenuListView {
+    /**
+     * The CSS class to be applied to nested menu panels in this dropdown menu.
+     *
+     * It is necessary, as the panels are created in body collection, outside editor and UI structure.
+     */
+    menuPanelClass: string | undefined;
+    /**
+     * The definitions object used to create the whole menu structure.
+     */
+    private readonly _definition;
+    /**
+     * Cached array of all menus in the dropdown menu (including nested menus).
+     */
+    private _cachedMenus;
+    /**
+     * Cached array of all buttons in the dropdown menu (including buttons in nested menus).
+     */
+    private _cachedButtons;
+    /**
+     * Editor body collection into which nested menus panels will be appended.
+     */
+    private _bodyCollection;
+    /**
+     * Creates an instance of the DropdownMenuRootListView class.
+     *
+     * @param locale
+     * @param bodyCollection
+     * @param definition The definition object used to create the menu structure.
+     */
+    constructor(locale: Locale, bodyCollection: BodyCollection, definition: DropdownMenuDefinition);
+    /**
+     * Returns the array of all menus in the dropdown menu (including nested menus).
+     */
+    get menus(): Array<DropdownMenuNestedMenuView>;
+    /**
+     * Returns the array of all buttons in the dropdown menu (including buttons in nested menus).
+     *
+     * Note, that this includes only "leaf" buttons, as specified in the definition passed in constructor. Buttons created as a part of
+     * the nested menus, that open nested menus when hovered or pressed, are not included.
+     */
+    get buttons(): Array<DropdownMenuListItemButtonView>;
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+    /**
+     * Closes all nested menus.
+     */
+    closeMenus(): void;
+    /**
+     * Recursively creates the whole view tree structure for the dropdown menu, according to the passed `definitions`.
+     *
+     * @private
+     */
+    private _createStructure;
+}
+/**
+ * Fired when one of the menu buttons is executed (through mouse click or keyboard).
+ *
+ * This event is a delegated `execute` event fired by the pressed button. The `event.source` is the button which was executed.
+ *
+ * @eventName ~DropdownMenuRootListView#menu:execute
+ */
+export interface DropdownMenuRootListViewExecuteEvent extends BaseEvent {
+    name: 'menu:execute';
+    args: [];
+}