ckeditor5-elements-core 49.0.0-alpha.2 → 49.0.0-alpha.4

package/README.md

@@ -1,8 +1,8 @@
 # ckeditor5-elements-core
 
 The base of CKEditor 5 Elements: commands that act on a position or an element (`ElementOrPositionCommand`,
-`ElementCommand`), their buttons (`ElementOrPositionButtonView`, `ElementButtonView`), and the `ElementMenu` plugin, which
-shows the menus of the context menu, the breadcrumbs and quick insert.
+`ElementCommand`), and their buttons (`ElementOrPositionButtonView`, `ElementButtonView`). The menus of commands are in
+`ckeditor5-elements-menu`.
 
 ## Installation
 

package/dist/index.d.ts

@@ -1,19 +1,15 @@
 /**
- * The base of the element commands, their buttons and menus: `ElementOrPositionCommand` (a command for a position or
- * an element, with its title, icon and state for any target), `ElementCommand` (toggles an element), their button
- * views, and `ElementMenu` (menus of commands, submenus and separators, used by the context menu, the breadcrumbs and
- * quick insert).
+ * The base of the element commands and their buttons: `ElementOrPositionCommand` (a command for a position or an
+ * element, with its title, icon and state for any target), `ElementCommand` (toggles an element), and their button
+ * views. The menus of commands are in `ckeditor5-elements-menu`.
  *
  * @module ckeditor5-elements-core
  */
 import './singleCopyGuard.js';
-export { default as ElementMenu, type ElementMenuConfig, type ElementMenuItem, type ElementMenuShowOptions, type ElementSubmenu } from './elementMenu.js';
 export { default as ElementOrPositionCommand, type ElementOrPosition } from './elementOrPositionCommand.js';
 export { default as ElementCommand } from './elementCommand.js';
-export { default as ElementOrPositionButtonView, type ElementOrPositionButtonViewOptions, type ElementOrPositionTarget } from './elementOrPositionButtonView.js';
+export { default as ElementOrPositionButtonView, bindButtonToCommand, type ElementOrPositionButtonViewOptions, type ElementOrPositionTarget } from './elementOrPositionButtonView.js';
 export { default as ElementButtonView } from './elementButtonView.js';
-export { default as ElementMenuView } from './elementMenuView.js';
 export { getElementAtSelection, isInDocument, isStandalone, selectNewElement } from './utils.js';
 export { findPlugin, getElementsAround, matchesElement, type ElementMatcher } from './matching.js';
-import './augmentation.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EACN,OAAO,IAAI,WAAW,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EACN,OAAO,IAAI,2BAA2B,EACtC,KAAK,kCAAkC,EACvC,KAAK,uBAAuB,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnG,OAAO,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EACN,OAAO,IAAI,2BAA2B,EACtC,mBAAmB,EACnB,KAAK,kCAAkC,EACvC,KAAK,uBAAuB,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,23 +1,18 @@
 /**
- * The base of the element commands, their buttons and menus: `ElementOrPositionCommand` (a command for a position or
- * an element, with its title, icon and state for any target), `ElementCommand` (toggles an element), their button
- * views, and `ElementMenu` (menus of commands, submenus and separators, used by the context menu, the breadcrumbs and
- * quick insert).
+ * The base of the element commands and their buttons: `ElementOrPositionCommand` (a command for a position or an
+ * element, with its title, icon and state for any target), `ElementCommand` (toggles an element), and their button
+ * views. The menus of commands are in `ckeditor5-elements-menu`.
  *
  * @module ckeditor5-elements-core
  */
 import './singleCopyGuard.js';
-// Plugins.
-export { default as ElementMenu } from './elementMenu.js';
 // Commands.
 export { default as ElementOrPositionCommand } from './elementOrPositionCommand.js';
 export { default as ElementCommand } from './elementCommand.js';
 // Views.
-export { default as ElementOrPositionButtonView } from './elementOrPositionButtonView.js';
+export { default as ElementOrPositionButtonView, bindButtonToCommand } from './elementOrPositionButtonView.js';
 export { default as ElementButtonView } from './elementButtonView.js';
-export { default as ElementMenuView } from './elementMenuView.js';
 // Utils.
 export { getElementAtSelection, isInDocument, isStandalone, selectNewElement } from './utils.js';
 export { findPlugin, getElementsAround, matchesElement } from './matching.js';
-import './augmentation.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,sBAAsB,CAAC;AAE9B,WAAW;AACX,OAAO,EACN,OAAO,IAAI,WAAW,EAKtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAA0B,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,SAAS;AACT,OAAO,EACN,OAAO,IAAI,2BAA2B,EAGtC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAElE,SAAS;AACT,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC;AAEnG,OAAO,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAA0B,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,SAAS;AACT,OAAO,EACN,OAAO,IAAI,2BAA2B,EACtC,mBAAmB,EAGnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,SAAS;AACT,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC"}

package/dist/singleCopyGuard.js

@@ -1,7 +1,7 @@
 /**
  * Fails when this package is loaded twice, e.g. because two versions of it are installed: `ckeditor5-elements` of one
- * version, and a feature package of another. Two copies would register two different `ElementMenu` plugins (which
- * CKEditor refuses), and the commands of one copy would not be menu items for the other.
+ * version, and a feature package of another. Two copies would have two different `ElementOrPositionCommand` classes,
+ * and the commands of one copy would not be menu items for the menus of the other, which recognize them by class.
  *
  * It is the counterpart of CKEditor's `ckeditor-duplicated-modules` error. Like CKEditor's packages, this package
  * declares no `sideEffects` in its `package.json`, so bundlers keep this module, which exports nothing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ckeditor5-elements-core",
-  "version": "49.0.0-alpha.2",
+  "version": "49.0.0-alpha.4",
   "description": "The base of the element commands, buttons and menus for CKEditor 5: ElementOrPositionCommand, ElementCommand, their button views, and ElementMenu.",
   "keywords": [
     "ckeditor",
@@ -28,13 +28,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./index.css": "./theme/elementMenu.css",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "src",
-    "theme",
     "README.md"
   ],
   "peerDependencies": {

package/src/index.ts

@@ -1,23 +1,13 @@
 /**
- * The base of the element commands, their buttons and menus: `ElementOrPositionCommand` (a command for a position or
- * an element, with its title, icon and state for any target), `ElementCommand` (toggles an element), their button
- * views, and `ElementMenu` (menus of commands, submenus and separators, used by the context menu, the breadcrumbs and
- * quick insert).
+ * The base of the element commands and their buttons: `ElementOrPositionCommand` (a command for a position or an
+ * element, with its title, icon and state for any target), `ElementCommand` (toggles an element), and their button
+ * views. The menus of commands are in `ckeditor5-elements-menu`.
  *
  * @module ckeditor5-elements-core
  */
 
 import './singleCopyGuard.js';
 
-// Plugins.
-export {
-	default as ElementMenu,
-	type ElementMenuConfig,
-	type ElementMenuItem,
-	type ElementMenuShowOptions,
-	type ElementSubmenu
-} from './elementMenu.js';
-
 // Commands.
 export { default as ElementOrPositionCommand, type ElementOrPosition } from './elementOrPositionCommand.js';
 export { default as ElementCommand } from './elementCommand.js';
@@ -25,14 +15,12 @@ export { default as ElementCommand } from './elementCommand.js';
 // Views.
 export {
 	default as ElementOrPositionButtonView,
+	bindButtonToCommand,
 	type ElementOrPositionButtonViewOptions,
 	type ElementOrPositionTarget
 } from './elementOrPositionButtonView.js';
 export { default as ElementButtonView } from './elementButtonView.js';
-export { default as ElementMenuView } from './elementMenuView.js';
 
 // Utils.
 export { getElementAtSelection, isInDocument, isStandalone, selectNewElement } from './utils.js';
 export { findPlugin, getElementsAround, matchesElement, type ElementMatcher } from './matching.js';
-
-import './augmentation.js';

package/src/singleCopyGuard.ts

@@ -1,7 +1,7 @@
 /**
  * Fails when this package is loaded twice, e.g. because two versions of it are installed: `ckeditor5-elements` of one
- * version, and a feature package of another. Two copies would register two different `ElementMenu` plugins (which
- * CKEditor refuses), and the commands of one copy would not be menu items for the other.
+ * version, and a feature package of another. Two copies would have two different `ElementOrPositionCommand` classes,
+ * and the commands of one copy would not be menu items for the menus of the other, which recognize them by class.
  *
  * It is the counterpart of CKEditor's `ckeditor-duplicated-modules` error. Like CKEditor's packages, this package
  * declares no `sideEffects` in its `package.json`, so bundlers keep this module, which exports nothing.

package/dist/augmentation.d.ts

@@ -1,7 +0,0 @@
-import type { ElementMenu } from './index.js';
-declare module 'ckeditor5' {
-    interface PluginsMap {
-        [ElementMenu.pluginName]: ElementMenu;
-    }
-}
-//# sourceMappingURL=augmentation.d.ts.map

package/dist/augmentation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"augmentation.d.ts","sourceRoot":"","sources":["../src/augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,QAAQ,WAAW,CAAC;IAC1B,UAAU,UAAU;QACnB,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;KACtC;CACD"}

package/dist/augmentation.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=augmentation.js.map

package/dist/augmentation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"augmentation.js","sourceRoot":"","sources":["../src/augmentation.ts"],"names":[],"mappings":""}

package/dist/elementMenu.d.ts

@@ -1,93 +0,0 @@
-import { ContextualBalloon, Notification, Plugin, type Editor, type FocusableView, type ModelElement, type RectSource } from 'ckeditor5';
-import ElementOrPositionCommand from './elementOrPositionCommand.js';
-/**
- * A submenu of an element menu. Missing items are skipped, as in the menu.
- */
-export interface ElementSubmenu {
-    title: string;
-    /**
-     * The icon (SVG string) shown next to the title.
-     */
-    icon?: string;
-    items: (ElementMenuItem | null | undefined)[];
-}
-/**
- * An item of an element menu:
- *
- * * a command, shown as a button with its `title` and `icon`, enabled and "on" according to its
- *   {@link ElementOrPositionCommand#getState state} for the element,
- * * a submenu,
- * * `'|'`, a separator. Separators at the start or the end of a menu, and repeated ones, are not shown, so a group of
- *   items can start with one.
- */
-export type ElementMenuItem = ElementOrPositionCommand | ElementSubmenu | '|';
-/**
- * Returns the items of the menu of the given element, e.g. as the `elementContextMenu` or `breadcrumbs.menu` editor
- * config option. Missing items (e.g. commands that are not registered) are skipped. No items means no menu.
- */
-export type ElementMenuConfig = (element: ModelElement, editor: Editor) => (ElementMenuItem | null | undefined)[];
-/**
- * The options of {@link ElementMenu#open} and {@link ElementMenu#show}.
- */
-export interface ElementMenuShowOptions {
-    /**
-     * The accessible name of the menu of an element (see {@link ElementMenu#open}). Defaults to "Element menu".
-     */
-    label?: string;
-    /**
-     * Called when the document data changes while the menu is open. When it returns `true`, the menu closes, e.g.
-     * because the element it is for was removed.
-     */
-    isObsolete?: () => boolean;
-    /**
-     * What gets the focus when the menu is closed with Esc, e.g. the button that opened the menu. Defaults to the editor.
-     */
-    returnFocusTo?: {
-        focus(): void;
-    };
-    /**
-     * Called when the menu closes, for any reason: Esc, a click outside, an executed item, or another menu replacing it.
-     */
-    onHide?: () => void;
-}
-/**
- * Shows menus in a balloon: the menu of an element, built from commands, submenus and separators (see {@link open}),
- * or any view, e.g. the quick insert search (see {@link show}).
- *
- * The element context menu, the breadcrumbs and quick insert show their menus with it. The menu of an element is
- * CKEditor's dropdown menu (see {@link ElementMenuView}).
- *
- * Executing an item closes the menu. Esc and clicking outside close it too; Esc returns the focus to the editor, or to
- * {@link ElementMenuShowOptions.returnFocusTo}.
- */
-export default class ElementMenu extends Plugin {
-    /**
-     * The view in the open menu, if any.
-     */
-    view: FocusableView | null;
-    private _keystrokes;
-    private _isObsolete;
-    private _onHide;
-    static get requires(): readonly [typeof ContextualBalloon, typeof Notification];
-    static get pluginName(): 'ElementMenu';
-    init(): void;
-    /**
-     * Opens the menu of the element next to the target (e.g. a button, or a `DOMRect` in viewport coordinates), with
-     * the items from the config callback. The menu closes when the element is removed.
-     *
-     * Returns `false` when there are no items.
-     */
-    open(element: ModelElement, target: RectSource, config: ElementMenuConfig, { label, isObsolete, ...options }?: ElementMenuShowOptions): boolean;
-    /**
-     * Shows the view (e.g. a menu) next to the target (e.g. a button, or a `DOMRect` in viewport coordinates), and
-     * focuses it. The menu closes when the view, or an item of CKEditor's dropdown menu in it, fires `execute`.
-     */
-    show(view: FocusableView, target: RectSource, { isObsolete, returnFocusTo, onHide }?: ElementMenuShowOptions): void;
-    /**
-     * Hides the open menu, if any.
-     */
-    hide(): void;
-    destroy(): void;
-    private get _balloon();
-}
-//# sourceMappingURL=elementMenu.d.ts.map

package/dist/elementMenu.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"elementMenu.d.ts","sourceRoot":"","sources":["../src/elementMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EAGjB,YAAY,EACZ,MAAM,EAEN,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,MAAM,WAAW,CAAC;AAEnB,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,EAAE,CAAC,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,wBAAwB,GAAG,cAAc,GAAG,GAAG,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;AAElH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;IAElC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,MAAM;IAC9C;;OAEG;IACI,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAEzC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,OAAO,CAA6B;IAE5C,WAAkB,QAAQ,IAAI,SAAS,CAAC,OAAO,iBAAiB,EAAE,OAAO,YAAY,CAAC,CAGrF;IAED,WAAkB,UAAU,IAAI,aAAa,CAE5C;IAEM,IAAI,IAAI,IAAI;IAQnB;;;;;OAKG;IACI,IAAI,CACV,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,iBAAiB,EACzB,EAAE,KAAqC,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,GAAE,sBAA2B,GAC5F,OAAO;IAmBV;;;OAGG;IACI,IAAI,CACV,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,UAAU,EAClB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,GAAE,sBAA2B,GAChE,IAAI;IAqDP;;OAEG;IACI,IAAI,IAAI,IAAI;IAuBH,OAAO,IAAI,IAAI;IAK/B,OAAO,KAAK,QAAQ,GAEnB;CACD"}

package/dist/elementMenu.js

@@ -1,163 +0,0 @@
-import { ContextualBalloon, DropdownMenuRootListView, KeystrokeHandler, Notification, Plugin, clickOutsideHandler } from 'ckeditor5';
-import ElementMenuView from './elementMenuView.js';
-import ElementOrPositionCommand from './elementOrPositionCommand.js';
-import { isInDocument } from './utils.js';
-/**
- * Shows menus in a balloon: the menu of an element, built from commands, submenus and separators (see {@link open}),
- * or any view, e.g. the quick insert search (see {@link show}).
- *
- * The element context menu, the breadcrumbs and quick insert show their menus with it. The menu of an element is
- * CKEditor's dropdown menu (see {@link ElementMenuView}).
- *
- * Executing an item closes the menu. Esc and clicking outside close it too; Esc returns the focus to the editor, or to
- * {@link ElementMenuShowOptions.returnFocusTo}.
- */
-export default class ElementMenu extends Plugin {
-    /**
-     * The view in the open menu, if any.
-     */
-    view = null;
-    _keystrokes = null;
-    _isObsolete = null;
-    _onHide = null;
-    static get requires() {
-        // The buttons of the menu report failed commands with notifications.
-        return [ContextualBalloon, Notification];
-    }
-    static get pluginName() {
-        return 'ElementMenu';
-    }
-    init() {
-        this.listenTo(this.editor.model.document, 'change:data', () => {
-            if (this._isObsolete?.()) {
-                this.hide();
-            }
-        });
-    }
-    /**
-     * Opens the menu of the element next to the target (e.g. a button, or a `DOMRect` in viewport coordinates), with
-     * the items from the config callback. The menu closes when the element is removed.
-     *
-     * Returns `false` when there are no items.
-     */
-    open(element, target, config, { label = this.editor.t('Element menu'), isObsolete, ...options } = {}) {
-        const items = cleanItems(config(element, this.editor));
-        if (!items.length) {
-            return false;
-        }
-        const view = new ElementMenuView(this.editor.locale, this.editor.ui.view.body, items, element);
-        view.ariaLabel = label;
-        this.show(view, target, {
-            ...options,
-            isObsolete: () => !isInDocument(element) || !!isObsolete?.()
-        });
-        return true;
-    }
-    /**
-     * Shows the view (e.g. a menu) next to the target (e.g. a button, or a `DOMRect` in viewport coordinates), and
-     * focuses it. The menu closes when the view, or an item of CKEditor's dropdown menu in it, fires `execute`.
-     */
-    show(view, target, { isObsolete, returnFocusTo, onHide } = {}) {
-        this.hide();
-        const close = () => {
-            // The item may have opened another menu already (e.g. "Insert before" opens quick insert).
-            if (this.view === view) {
-                this.hide();
-            }
-        };
-        this.listenTo(view, 'execute', close);
-        this.listenTo(view, 'menu:execute', close);
-        clickOutsideHandler({
-            emitter: view,
-            activator: () => this._balloon.visibleView === view,
-            // The open nested menus are in panels outside the balloon.
-            contextElements: () => [this._balloon.view.element, ...getOpenPanels(view)].filter(element => !!element),
-            callback: () => {
-                this.hide();
-            }
-        });
-        this._balloon.add({
-            view,
-            position: { target },
-            withArrow: false,
-            singleViewMode: true,
-            // Views that other plugins add to the balloon meanwhile (e.g. an element toolbar, when the selection moves
-            // into its element) go to their own stack, so they do not cover the menu.
-            stackId: 'elementMenu'
-        });
-        const keystrokes = new KeystrokeHandler();
-        // Esc in a nested menu closes only that menu.
-        keystrokes.set('Esc', (data, cancel) => {
-            this.hide();
-            (returnFocusTo ?? this.editor.editing.view).focus();
-            cancel();
-        });
-        if (view.element) {
-            keystrokes.listenTo(view.element);
-        }
-        this.view = view;
-        this._keystrokes = keystrokes;
-        this._isObsolete = isObsolete ?? null;
-        this._onHide = onHide ?? null;
-        view.focus();
-    }
-    /**
-     * Hides the open menu, if any.
-     */
-    hide() {
-        const view = this.view;
-        const onHide = this._onHide;
-        if (!view) {
-            return;
-        }
-        this._keystrokes?.destroy();
-        this.view = null;
-        this._keystrokes = null;
-        this._isObsolete = null;
-        this._onHide = null;
-        this.stopListening(view);
-        if (this._balloon.hasView(view)) {
-            this._balloon.remove(view);
-        }
-        view.destroy();
-        onHide?.();
-    }
-    destroy() {
-        this.hide();
-        super.destroy();
-    }
-    get _balloon() {
-        return this.editor.plugins.get(ContextualBalloon);
-    }
-}
-/**
- * Returns the items without missing ones, submenus without items, and separators at the start or the end, or
- * repeated ones.
- */
-function cleanItems(items) {
-    const result = [];
-    for (const item of items) {
-        const cleaned = item === '|' || item instanceof ElementOrPositionCommand || !item ? item : cleanSubmenu(item);
-        if (!cleaned || (cleaned === '|' && (!result.length || result.at(-1) === '|'))) {
-            continue;
-        }
-        result.push(cleaned);
-    }
-    if (result.at(-1) === '|') {
-        result.pop();
-    }
-    return result;
-}
-function cleanSubmenu(submenu) {
-    const items = cleanItems(submenu.items);
-    return items.length ? { ...submenu, items } : null;
-}
-/**
- * Returns the panels of the open nested menus of CKEditor's dropdown menu.
- */
-function getOpenPanels(view) {
-    return view instanceof DropdownMenuRootListView
-        ? view.menus.filter(menu => menu.isOpen).map(menu => menu.panelView.element)
-        : [];
-}
-//# sourceMappingURL=elementMenu.js.map

package/dist/elementMenu.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"elementMenu.js","sourceRoot":"","sources":["../src/elementMenu.ts"],"names":[],"mappings":"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"}

package/dist/elementMenuItemButtonView.d.ts

@@ -1,24 +0,0 @@
-import { ListItemButtonView, type Locale } from 'ckeditor5';
-import type ElementOrPositionCommand from './elementOrPositionCommand.js';
-import { type ElementOrPosition } from './elementOrPositionCommand.js';
-/**
- * A menu item for an {@link ElementOrPositionCommand}: CKEditor's list item button, labelled with the command title and
- * icon, that reflects and executes the command like {@link ElementOrPositionButtonView}.
- *
- * For a {@link ElementOrPositionCommand#isToggleable toggleable} command, it is a `menuitemcheckbox` with a check mark
- * when the command is "on"; otherwise, a `menuitem`.
- */
-export default class ElementMenuItemButtonView extends ListItemButtonView {
-    /**
-     * The command this item reflects.
-     */
-    readonly command: ElementOrPositionCommand;
-    /**
-     * The position or element the item acts on, if any.
-     */
-    readonly target: ElementOrPosition | undefined;
-    constructor(locale: Locale | undefined, command: ElementOrPositionCommand, { target }?: {
-        target?: ElementOrPosition;
-    });
-}
-//# sourceMappingURL=elementMenuItemButtonView.d.ts.map

package/dist/elementMenuItemButtonView.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"elementMenuItemButtonView.d.ts","sourceRoot":"","sources":["../src/elementMenuItemButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,kBAAkB;IACxE;;OAEG;IACH,SAAgB,OAAO,EAAE,wBAAwB,CAAC;IAElD;;OAEG;IACH,SAAgB,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;gBAGrD,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,wBAAwB,EACjC,EAAE,MAAM,EAAE,GAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAO;CAYhD"}

package/dist/elementMenuItemButtonView.js

@@ -1,29 +0,0 @@
-import { ListItemButtonView } from 'ckeditor5';
-import { bindButtonToCommand } from './elementOrPositionButtonView.js';
-import {} from './elementOrPositionCommand.js';
-/**
- * A menu item for an {@link ElementOrPositionCommand}: CKEditor's list item button, labelled with the command title and
- * icon, that reflects and executes the command like {@link ElementOrPositionButtonView}.
- *
- * For a {@link ElementOrPositionCommand#isToggleable toggleable} command, it is a `menuitemcheckbox` with a check mark
- * when the command is "on"; otherwise, a `menuitem`.
- */
-export default class ElementMenuItemButtonView extends ListItemButtonView {
-    /**
-     * The command this item reflects.
-     */
-    command;
-    /**
-     * The position or element the item acts on, if any.
-     */
-    target;
-    constructor(locale, command, { target } = {}) {
-        super(locale);
-        this.command = command;
-        this.target = target;
-        bindButtonToCommand(this, command, { withText: true, target });
-        // A toggleable button with a checkable role tells assistive technology whether it is "on" with `aria-checked`.
-        this.role = command.isToggleable ? 'menuitemcheckbox' : 'menuitem';
-    }
-}
-//# sourceMappingURL=elementMenuItemButtonView.js.map

package/dist/elementMenuItemButtonView.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"elementMenuItemButtonView.js","sourceRoot":"","sources":["../src/elementMenuItemButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAe,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAA0B,MAAM,+BAA+B,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,kBAAkB;IACxE;;OAEG;IACa,OAAO,CAA2B;IAElD;;OAEG;IACa,MAAM,CAAgC;IAEtD,YACC,MAA0B,EAC1B,OAAiC,EACjC,EAAE,MAAM,KAAqC,EAAE;QAE/C,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/D,+GAA+G;QAC/G,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC;IACpE,CAAC;CACD"}

package/dist/elementMenuView.d.ts

@@ -1,35 +0,0 @@
-import { DropdownMenuRootListView, type BodyCollection, type Locale } from 'ckeditor5';
-import { type ElementMenuItem } from './elementMenu.js';
-import { type ElementOrPosition } from './elementOrPositionCommand.js';
-/**
- * The menu of an element: CKEditor's dropdown menu (`DropdownMenuRootListView`), built from commands, submenus and
- * separators.
- *
- * CKEditor builds the menu and handles it: the nested menus (opened on click, hover, or the right arrow; placed where
- * they fit), the keyboard, and right-to-left languages. This view only connects the buttons to the commands: they
- * reflect the command title, icon and {@link ElementOrPositionCommand#getState state} for the target, and execute the
- * command for it. It also adds the separators, which CKEditor's menu definitions do not have.
- *
- * Submenus are enabled when one of their items is. Right-clicking the menu does not open the native context menu.
- */
-export default class ElementMenuView extends DropdownMenuRootListView {
-    /**
-     * The element or position the commands are executed for.
-     */
-    readonly target: ElementOrPosition;
-    private readonly _commands;
-    private readonly _submenus;
-    /**
-     * The positions of the separators in each list, by the id of the submenu (`''` for the menu itself).
-     */
-    private readonly _separators;
-    constructor(locale: Locale, bodyCollection: BodyCollection, items: readonly (ElementMenuItem | null | undefined)[], target: ElementOrPosition);
-    /**
-     * Renders the menu: CKEditor builds it from the definitions; then the buttons are connected to the commands, and the
-     * separators are added.
-     */
-    render(): void;
-    private _addSeparators;
-    private _isEnabled;
-}
-//# sourceMappingURL=elementMenuView.d.ts.map

package/dist/elementMenuView.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"elementMenuView.d.ts","sourceRoot":"","sources":["../src/elementMenuView.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EAExB,KAAK,cAAc,EAGnB,KAAK,MAAM,EACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,kBAAkB,CAAC;AAE7E,OAAiC,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEjG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,wBAAwB;IACpE;;OAEG;IACH,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IAExD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;gBAGnD,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACtD,MAAM,EAAE,iBAAiB;IAkB1B;;;OAGG;IACa,MAAM,IAAI,IAAI;IAqC9B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;CASlB"}