ckeditor5-elements-menu 49.0.0-alpha.4 → 49.0.0

package/dist/quickInsert/{quickInsert.d.ts → elementQuickInsert.d.ts}

@@ -3,9 +3,9 @@ import type { ElementOrPosition } from 'ckeditor5-elements-core';
 import ElementMenu from '../elementMenu.js';
 import { type QuickInsertItem } from './quickInsertListView.js';
 /**
- * The configuration of the {@link QuickInsert} plugin.
+ * The configuration of the {@link ElementQuickInsert} plugin.
  */
-export interface QuickInsertConfig {
+export interface ElementQuickInsertConfig {
     /**
      * Labels of the elements, by model name. Elements without a label are listed by their model name.
      */
@@ -22,7 +22,7 @@ export interface QuickInsertConfig {
 }
 /**
  * Opens a menu with a search field and the elements allowed at the selection, on Alt+Enter (Option+Enter on macOS; see
- * {@link QuickInsertConfig.keystroke}). Choosing an element inserts it with the `quickInsert` command.
+ * {@link ElementQuickInsertConfig.keystroke}). Choosing an element inserts it with the `quickInsert` command.
  *
  * The menu is shown by the `ElementMenu` plugin. The `quickInsertBefore` and `quickInsertAfter` commands (see
  * {@link QuickInsertPositionCommand}) open it for the position before or after an element; list them in the
@@ -30,9 +30,9 @@ export interface QuickInsertConfig {
  *
  * The menu closes when the document changes while it is open, so it never inserts at an outdated position.
  */
-export default class QuickInsert extends Plugin {
+export default class ElementQuickInsert extends Plugin {
     static get requires(): readonly [typeof ElementMenu];
-    static get pluginName(): 'QuickInsert';
+    static get pluginName(): 'ElementQuickInsert';
     constructor(editor: Editor);
     init(): void;
     /**
@@ -40,6 +40,11 @@ export default class QuickInsert extends Plugin {
      * selection), with their labels.
      */
     getItems(elementOrPosition?: ElementOrPosition): QuickInsertItem[];
+    /**
+     * Whether an element can be inserted at the target (a position, the position before an element, or the selection),
+     * as {@link getItems} lists them: it stops at the first one, e.g. for whether a command is enabled.
+     */
+    hasItems(elementOrPosition?: ElementOrPosition): boolean;
     /**
      * Opens the menu for inserting at the target (a position, the position before an element, or the selection), next
      * to the given DOM target. By default, the menu is next to the element, or the selection.
@@ -48,10 +53,5 @@ export default class QuickInsert extends Plugin {
      * show the menu next to.
      */
     open(elementOrPosition?: ElementOrPosition, domTarget?: RectSource): boolean;
-    /**
-     * Returns the DOM element of the element, or the DOM range of the selection.
-     */
-    private _getDomTarget;
-    private _getDomElement;
 }
-//# sourceMappingURL=quickInsert.d.ts.map
+//# sourceMappingURL=elementQuickInsert.d.ts.map

package/dist/quickInsert/elementQuickInsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementQuickInsert.d.ts","sourceRoot":"","sources":["../../src/quickInsert/elementQuickInsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAiC,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAG5C,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,MAAM;IACrD,WAAkB,QAAQ,IAAI,SAAS,CAAC,OAAO,WAAW,CAAC,CAE1D;IAED,WAAkB,UAAU,IAAI,oBAAoB,CAEnD;gBAEW,MAAM,EAAE,MAAM;IAMnB,IAAI,IAAI,IAAI;IAqBnB;;;OAGG;IACI,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,eAAe,EAAE;IAWzE;;;OAGG;IACI,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAM/D;;;;;;OAMG;IACI,IAAI,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO;CA0BnF"}

package/dist/quickInsert/{quickInsert.js → elementQuickInsert.js}

@@ -1,4 +1,5 @@
 import { Plugin } from 'ckeditor5';
+import { getDomTarget } from '../domTarget.js';
 import ElementMenu from '../elementMenu.js';
 import QuickInsertCommand from './quickInsertCommand.js';
 import QuickInsertPositionCommand from './quickInsertPositionCommand.js';
@@ -6,7 +7,7 @@ import {} from './quickInsertListView.js';
 import QuickInsertView from './quickInsertView.js';
 /**
  * Opens a menu with a search field and the elements allowed at the selection, on Alt+Enter (Option+Enter on macOS; see
- * {@link QuickInsertConfig.keystroke}). Choosing an element inserts it with the `quickInsert` command.
+ * {@link ElementQuickInsertConfig.keystroke}). Choosing an element inserts it with the `quickInsert` command.
  *
  * The menu is shown by the `ElementMenu` plugin. The `quickInsertBefore` and `quickInsertAfter` commands (see
  * {@link QuickInsertPositionCommand}) open it for the position before or after an element; list them in the
@@ -14,23 +15,23 @@ import QuickInsertView from './quickInsertView.js';
  *
  * The menu closes when the document changes while it is open, so it never inserts at an outdated position.
  */
-export default class QuickInsert extends Plugin {
+export default class ElementQuickInsert extends Plugin {
     static get requires() {
         return [ElementMenu];
     }
     static get pluginName() {
-        return 'QuickInsert';
+        return 'ElementQuickInsert';
     }
     constructor(editor) {
         super(editor);
-        editor.config.define('quickInsert', { labels: {}, exclude: [], keystroke: 'Alt+Enter' });
+        editor.config.define('elementQuickInsert', { labels: {}, exclude: [], keystroke: 'Alt+Enter' });
     }
     init() {
         const editor = this.editor;
-        const keystroke = editor.config.get('quickInsert')?.keystroke;
+        const keystroke = editor.config.get('elementQuickInsert')?.keystroke;
         editor.commands.add('quickInsert', new QuickInsertCommand(editor));
-        editor.commands.add('quickInsertBefore', new QuickInsertPositionCommand(editor, 'before'));
-        editor.commands.add('quickInsertAfter', new QuickInsertPositionCommand(editor, 'after'));
+        editor.commands.add('quickInsertBefore', new QuickInsertPositionCommand(editor, 'before', this));
+        editor.commands.add('quickInsertAfter', new QuickInsertPositionCommand(editor, 'after', this));
         if (keystroke) {
             editor.keystrokes.set(keystroke, (data, cancel) => {
                 if (this.open()) {
@@ -47,7 +48,7 @@ export default class QuickInsert extends Plugin {
      * selection), with their labels.
      */
     getItems(elementOrPosition) {
-        const config = this.editor.config.get('quickInsert');
+        const config = this.editor.config.get('elementQuickInsert');
         const labels = config?.labels ?? {};
         const command = this.editor.commands.get('quickInsert');
         return (command?.getAllowedElements(elementOrPosition, config?.exclude) ?? []).map(name => ({
@@ -55,6 +56,14 @@ export default class QuickInsert extends Plugin {
             label: labels[name] ?? name
         }));
     }
+    /**
+     * Whether an element can be inserted at the target (a position, the position before an element, or the selection),
+     * as {@link getItems} lists them: it stops at the first one, e.g. for whether a command is enabled.
+     */
+    hasItems(elementOrPosition) {
+        const command = this.editor.commands.get('quickInsert');
+        return !!command?.hasAllowedElements(elementOrPosition, this.editor.config.get('elementQuickInsert')?.exclude);
+    }
     /**
      * Opens the menu for inserting at the target (a position, the position before an element, or the selection), next
      * to the given DOM target. By default, the menu is next to the element, or the selection.
@@ -66,7 +75,7 @@ export default class QuickInsert extends Plugin {
         const editor = this.editor;
         const command = editor.commands.get('quickInsert');
         const position = command?.getInsertPosition(elementOrPosition);
-        const menuTarget = domTarget ?? this._getDomTarget(elementOrPosition);
+        const menuTarget = domTarget ?? getDomTarget(editor, elementOrPosition);
         if (!command || !position || !menuTarget || !command.getState(position).isEnabled) {
             return false;
         }
@@ -83,24 +92,5 @@ export default class QuickInsert extends Plugin {
         });
         return true;
     }
-    /**
-     * Returns the DOM element of the element, or the DOM range of the selection.
-     */
-    _getDomTarget(elementOrPosition) {
-        const editing = this.editor.editing;
-        if (elementOrPosition && !elementOrPosition.is('position')) {
-            return this._getDomElement(elementOrPosition);
-        }
-        const viewRange = elementOrPosition
-            ? editing.view.createRange(editing.mapper.toViewPosition(elementOrPosition))
-            : editing.view.document.selection.getFirstRange();
-        return viewRange && editing.view.domConverter.viewRangeToDom(viewRange);
-    }
-    _getDomElement(element) {
-        const editing = this.editor.editing;
-        const viewElement = editing.mapper.toViewElement(element);
-        const domElement = viewElement && editing.view.domConverter.mapViewToDom(viewElement);
-        return domElement instanceof HTMLElement ? domElement : null;
-    }
 }
-//# sourceMappingURL=quickInsert.js.map
+//# sourceMappingURL=elementQuickInsert.js.map

package/dist/quickInsert/elementQuickInsert.js.map

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

package/dist/quickInsert/quickInsertCommand.d.ts

@@ -1,14 +1,15 @@
 import { type Editor, type ModelPosition } from 'ckeditor5';
 import { ElementOrPositionCommand, type ElementOrPosition } from 'ckeditor5-elements-core';
 /**
- * Inserts an element by its model name at a position, or opens the quick insert menu for that position.
+ * Inserts an element by its model name at a position: what the quick insert menu does, when an element is chosen. The
+ * menu itself is opened by the `ElementQuickInsert` plugin, with its `open()`.
  *
  * The target comes first, as in every {@link ElementOrPositionCommand}: a position, an element (meaning the position
  * before it), or none (the selection).
  *
  * ```ts
  * editor.execute('quickInsert', position, 'heading1'); // Inserts a heading at the position.
- * editor.execute('quickInsert'); // Opens the quick insert menu at the selection.
+ * editor.execute('quickInsert', undefined, 'softBreak'); // Inserts a line break at the selection.
  * ```
  *
  * Only elements that the schema allows at exactly that position are inserted (see {@link getAllowedElements}):
@@ -24,15 +25,23 @@ export default class QuickInsertCommand extends ElementOrPositionCommand {
      * were registered. Generic items (such as `$text` or `$block`) and the excluded names are skipped.
      */
     getAllowedElements(elementOrPosition?: ElementOrPosition, exclude?: readonly string[]): string[];
+    /**
+     * Whether an element is allowed at exactly the position (or the selection), as {@link getAllowedElements} returns
+     * them: it stops at the first one.
+     */
+    hasAllowedElements(elementOrPosition?: ElementOrPosition, exclude?: readonly string[]): boolean;
     /**
      * Returns the position where elements are inserted for the target: the position, the position before the element,
      * or the selection.
      */
     getInsertPosition(elementOrPosition?: ElementOrPosition): ModelPosition | null;
     /**
-     * Inserts the element named `name` at the target, when the schema allows it there. Without a name, opens the quick
-     * insert menu for the target (requires the `QuickInsert` plugin).
+     * Inserts the element named `name` at the target, when the schema allows it there.
+     */
+    execute(elementOrPosition: ElementOrPosition | undefined, name: string): void;
+    /**
+     * Yields the names of the elements allowed at exactly the position (or the selection), one by one.
      */
-    execute(elementOrPosition?: ElementOrPosition, name?: string): void;
+    private _getAllowedElements;
 }
 //# sourceMappingURL=quickInsertCommand.d.ts.map

package/dist/quickInsert/quickInsertCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quickInsertCommand.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsertCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAoB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG7G;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;gBAC3D,MAAM,EAAE,MAAM;IAO1B;;;OAGG;IACI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE;IAc3G;;;OAGG;IACI,iBAAiB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI;IAIrF;;;OAGG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;CAyBnF"}
+{"version":3,"file":"quickInsertCommand.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsertCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAoB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG7G;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;gBAC3D,MAAM,EAAE,MAAM;IAO1B;;;OAGG;IACI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE;IAI3G;;;OAGG;IACI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO;IAI1G;;;OAGG;IACI,iBAAiB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI;IAIrF;;OAEG;IACa,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgB7F;;OAEG;IACH,OAAO,CAAE,mBAAmB;CAmB5B"}

package/dist/quickInsert/quickInsertCommand.js

@@ -2,14 +2,15 @@ import {} from 'ckeditor5';
 import { ElementOrPositionCommand, selectNewElement } from 'ckeditor5-elements-core';
 import { insertIcon } from './icons.js';
 /**
- * Inserts an element by its model name at a position, or opens the quick insert menu for that position.
+ * Inserts an element by its model name at a position: what the quick insert menu does, when an element is chosen. The
+ * menu itself is opened by the `ElementQuickInsert` plugin, with its `open()`.
  *
  * The target comes first, as in every {@link ElementOrPositionCommand}: a position, an element (meaning the position
  * before it), or none (the selection).
  *
  * ```ts
  * editor.execute('quickInsert', position, 'heading1'); // Inserts a heading at the position.
- * editor.execute('quickInsert'); // Opens the quick insert menu at the selection.
+ * editor.execute('quickInsert', undefined, 'softBreak'); // Inserts a line break at the selection.
  * ```
  *
  * Only elements that the schema allows at exactly that position are inserted (see {@link getAllowedElements}):
@@ -29,12 +30,14 @@ export default class QuickInsertCommand extends ElementOrPositionCommand {
      * were registered. Generic items (such as `$text` or `$block`) and the excluded names are skipped.
      */
     getAllowedElements(elementOrPosition, exclude = []) {
-        const target = this._getPosition(elementOrPosition);
-        if (!target) {
-            return [];
-        }
-        const schema = this.editor.model.schema;
-        return Object.keys(schema.getDefinitions()).filter(name => !name.startsWith('$') && !exclude.includes(name) && schema.checkChild(target, name));
+        return Array.from(this._getAllowedElements(elementOrPosition, exclude));
+    }
+    /**
+     * Whether an element is allowed at exactly the position (or the selection), as {@link getAllowedElements} returns
+     * them: it stops at the first one.
+     */
+    hasAllowedElements(elementOrPosition, exclude = []) {
+        return !this._getAllowedElements(elementOrPosition, exclude).next().done;
     }
     /**
      * Returns the position where elements are inserted for the target: the position, the position before the element,
@@ -44,17 +47,9 @@ export default class QuickInsertCommand extends ElementOrPositionCommand {
         return this._getPosition(elementOrPosition);
     }
     /**
-     * Inserts the element named `name` at the target, when the schema allows it there. Without a name, opens the quick
-     * insert menu for the target (requires the `QuickInsert` plugin).
+     * Inserts the element named `name` at the target, when the schema allows it there.
      */
     execute(elementOrPosition, name) {
-        if (name === undefined) {
-            const plugins = this.editor.plugins;
-            if (plugins.has('QuickInsert')) {
-                plugins.get('QuickInsert').open(elementOrPosition);
-            }
-            return;
-        }
         const model = this.editor.model;
         const target = this._getPosition(elementOrPosition);
         if (!target || !model.canEditAt(target) || !model.schema.checkChild(target, name)) {
@@ -66,5 +61,21 @@ export default class QuickInsertCommand extends ElementOrPositionCommand {
             selectNewElement(writer, element);
         });
     }
+    /**
+     * Yields the names of the elements allowed at exactly the position (or the selection), one by one.
+     */
+    *_getAllowedElements(elementOrPosition, exclude) {
+        const target = this._getPosition(elementOrPosition);
+        if (!target) {
+            return;
+        }
+        const schema = this.editor.model.schema;
+        const excluded = new Set(exclude);
+        for (const name of Object.keys(schema.getDefinitions())) {
+            if (!name.startsWith('$') && !excluded.has(name) && schema.checkChild(target, name)) {
+                yield name;
+            }
+        }
+    }
 }
 //# sourceMappingURL=quickInsertCommand.js.map

package/dist/quickInsert/quickInsertCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"quickInsertCommand.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsertCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAA0B,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;IACvE,YAAY,MAAc;QACzB,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,kBAAkB,CAAC,iBAAqC,EAAE,UAA6B,EAAE;QAC/F,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QAExC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,MAAM,CACjD,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAC3F,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,iBAAiB,CAAC,iBAAqC;QAC7D,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACa,OAAO,CAAC,iBAAqC,EAAE,IAAa;QAC3E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAEpC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACpD,CAAC;YAED,OAAO;QACR,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACnF,OAAO;QACR,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAE3C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}
+{"version":3,"file":"quickInsertCommand.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsertCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAA0B,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;IACvE,YAAY,MAAc;QACzB,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,kBAAkB,CAAC,iBAAqC,EAAE,UAA6B,EAAE;QAC/F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACI,kBAAkB,CAAC,iBAAqC,EAAE,UAA6B,EAAE;QAC/F,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACI,iBAAiB,CAAC,iBAAqC;QAC7D,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACa,OAAO,CAAC,iBAAgD,EAAE,IAAY;QACrF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACnF,OAAO;QACR,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAE3C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,CAAC,mBAAmB,CAC3B,iBAAgD,EAChD,OAA0B;QAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO;QACR,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;gBACrF,MAAM,IAAI,CAAC;YACZ,CAAC;QACF,CAAC;IACF,CAAC;CACD"}

package/dist/quickInsert/quickInsertPositionCommand.d.ts

@@ -1,5 +1,6 @@
 import { type Editor } from 'ckeditor5';
 import { ElementOrPositionCommand, type ElementOrPosition } from 'ckeditor5-elements-core';
+import type ElementQuickInsert from './elementQuickInsert.js';
 /**
  * Where the quick insert menu inserts, relative to the element.
  */
@@ -10,14 +11,18 @@ export type QuickInsertPlacement = 'before' | 'after';
  * The element is the given one, the parent of the given position, or the selected element or the parent of the
  * selection (see {@link ElementOrPositionCommand}). Enabled when something can be inserted at that position.
  *
- * Requires the `QuickInsert` plugin, which registers it as `quickInsertBefore` and `quickInsertAfter`.
+ * The `ElementQuickInsert` plugin registers it as `quickInsertBefore` and `quickInsertAfter`, for its menu.
  */
 export default class QuickInsertPositionCommand extends ElementOrPositionCommand {
     /**
      * Where the quick insert menu inserts, relative to the element.
      */
     readonly placement: QuickInsertPlacement;
-    constructor(editor: Editor, placement: QuickInsertPlacement);
+    /**
+     * The plugin whose menu the command opens.
+     */
+    private readonly _quickInsert;
+    constructor(editor: Editor, placement: QuickInsertPlacement, quickInsert: ElementQuickInsert);
     /**
      * Opens the quick insert menu for the position before or after the element, next to the element.
      */

package/dist/quickInsert/quickInsertPositionCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quickInsertPositionCommand.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsertPositionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAsB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG3F;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,0BAA2B,SAAQ,wBAAwB;IAC/E;;OAEG;IACH,SAAgB,SAAS,EAAE,oBAAoB,CAAC;gBAEpC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB;IAQ3D;;OAEG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;cAejD,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAYhF,OAAO,CAAC,kBAAkB;CAU1B"}
+{"version":3,"file":"quickInsertPositionCommand.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsertPositionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAsB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAG9D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,0BAA2B,SAAQ,wBAAwB;IAC/E;;OAEG;IACH,SAAgB,SAAS,EAAE,oBAAoB,CAAC;IAEhD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;gBAEtC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,kBAAkB;IAS5F;;OAEG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;cASjD,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAMhF,OAAO,CAAC,kBAAkB;CAU1B"}

package/dist/quickInsert/quickInsertPositionCommand.js

@@ -1,5 +1,6 @@
 import {} from 'ckeditor5';
 import { ElementOrPositionCommand } from 'ckeditor5-elements-core';
+import { getDomTarget } from '../domTarget.js';
 import { insertAfterIcon, insertBeforeIcon } from './icons.js';
 /**
  * Opens the quick insert menu for the position before or after an element, next to that element.
@@ -7,16 +8,21 @@ import { insertAfterIcon, insertBeforeIcon } from './icons.js';
  * The element is the given one, the parent of the given position, or the selected element or the parent of the
  * selection (see {@link ElementOrPositionCommand}). Enabled when something can be inserted at that position.
  *
- * Requires the `QuickInsert` plugin, which registers it as `quickInsertBefore` and `quickInsertAfter`.
+ * The `ElementQuickInsert` plugin registers it as `quickInsertBefore` and `quickInsertAfter`, for its menu.
  */
 export default class QuickInsertPositionCommand extends ElementOrPositionCommand {
     /**
      * Where the quick insert menu inserts, relative to the element.
      */
     placement;
-    constructor(editor, placement) {
+    /**
+     * The plugin whose menu the command opens.
+     */
+    _quickInsert;
+    constructor(editor, placement, quickInsert) {
         super(editor);
         this.placement = placement;
+        this._quickInsert = quickInsert;
         this.title = placement === 'before' ? editor.t('Insert before') : editor.t('Insert after');
         this.icon = placement === 'before' ? insertBeforeIcon : insertAfterIcon;
     }
@@ -24,23 +30,15 @@ export default class QuickInsertPositionCommand extends ElementOrPositionCommand
      * Opens the quick insert menu for the position before or after the element, next to the element.
      */
     execute(elementOrPosition) {
-        const editor = this.editor;
         const element = this._getElement(elementOrPosition);
         const position = this._getInsertPosition(elementOrPosition);
-        if (!element || !position) {
-            return;
+        if (element && position) {
+            this._quickInsert.open(position, getDomTarget(this.editor, element) ?? undefined);
         }
-        const viewElement = editor.editing.mapper.toViewElement(element);
-        const domElement = viewElement && editor.editing.view.domConverter.mapViewToDom(viewElement);
-        editor.plugins.get('QuickInsert').open(position, domElement ?? undefined);
     }
     _isEnabledFor(elementOrPosition) {
         const position = this._getInsertPosition(elementOrPosition);
-        const plugins = this.editor.plugins;
-        return (!!position &&
-            this.editor.model.canEditAt(position) &&
-            plugins.has('QuickInsert') &&
-            plugins.get('QuickInsert').getItems(position).length > 0);
+        return !!position && this.editor.model.canEditAt(position) && this._quickInsert.hasItems(position);
     }
     _getInsertPosition(elementOrPosition) {
         const element = this._getElement(elementOrPosition);

package/dist/quickInsert/quickInsertPositionCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"quickInsertPositionCommand.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsertPositionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAA0B,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO/D;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,0BAA2B,SAAQ,wBAAwB;IAC/E;;OAEG;IACa,SAAS,CAAuB;IAEhD,YAAY,MAAc,EAAE,SAA+B;QAC1D,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,CAAC;IAED;;OAEG;IACa,OAAO,CAAC,iBAAqC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAE5D,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3B,OAAO;QACR,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,WAAW,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QAE7F,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,SAAS,CAAC,CAAC;IAC3E,CAAC;IAEkB,aAAa,CAAC,iBAAqC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAEpC,OAAO,CACN,CAAC,CAAC,QAAQ;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CACxD,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,iBAAqC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/G,CAAC;CACD"}
+{"version":3,"file":"quickInsertPositionCommand.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsertPositionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAA0B,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO/D;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,0BAA2B,SAAQ,wBAAwB;IAC/E;;OAEG;IACa,SAAS,CAAuB;IAEhD;;OAEG;IACc,YAAY,CAAqB;IAElD,YAAY,MAAc,EAAE,SAA+B,EAAE,WAA+B;QAC3F,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,CAAC;IAED;;OAEG;IACa,OAAO,CAAC,iBAAqC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAE5D,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC,CAAC;QACnF,CAAC;IACF,CAAC;IAEkB,aAAa,CAAC,iBAAqC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAE5D,OAAO,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpG,CAAC;IAEO,kBAAkB,CAAC,iBAAqC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/G,CAAC;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ckeditor5-elements-menu",
-  "version": "49.0.0-alpha.4",
+  "version": "49.0.0",
   "description": "Element menus for CKEditor 5: the menu of an element, built from commands, and the element context menu, breadcrumbs and quick insert that open it.",
   "keywords": [
     "ckeditor",
@@ -41,7 +41,10 @@
     "*.css"
   ],
   "dependencies": {
-    "ckeditor5-elements-core": "49.0.0-alpha.4"
+    "ckeditor5-elements-core": "49.0.0"
+  },
+  "devDependencies": {
+    "ckeditor5-elements-actions": "49.0.0"
   },
   "peerDependencies": {
     "ckeditor5": "^49.0.0"

package/src/augmentation.ts

@@ -1,12 +1,12 @@
 import type {
-	Breadcrumbs,
-	BreadcrumbsConfig,
+	ElementBreadcrumbs,
+	ElementBreadcrumbsConfig,
 	ElementContextMenu,
 	ElementMenu,
 	ElementMenuConfig,
-	QuickInsert,
+	ElementQuickInsert,
 	QuickInsertCommand,
-	QuickInsertConfig,
+	ElementQuickInsertConfig,
 	QuickInsertPositionCommand
 } from './index.js';
 
@@ -14,8 +14,8 @@ declare module 'ckeditor5' {
 	interface PluginsMap {
 		[ElementMenu.pluginName]: ElementMenu;
 		[ElementContextMenu.pluginName]: ElementContextMenu;
-		[Breadcrumbs.pluginName]: Breadcrumbs;
-		[QuickInsert.pluginName]: QuickInsert;
+		[ElementBreadcrumbs.pluginName]: ElementBreadcrumbs;
+		[ElementQuickInsert.pluginName]: ElementQuickInsert;
 	}
 
 	interface CommandsMap {
@@ -32,13 +32,13 @@ declare module 'ckeditor5' {
 		elementContextMenu?: ElementMenuConfig;
 
 		/**
-		 * The configuration of the {@link Breadcrumbs} plugin.
+		 * The configuration of the {@link ElementBreadcrumbs} plugin.
 		 */
-		breadcrumbs?: BreadcrumbsConfig;
+		elementBreadcrumbs?: ElementBreadcrumbsConfig;
 
 		/**
-		 * The configuration of the {@link QuickInsert} plugin.
+		 * The configuration of the {@link ElementQuickInsert} plugin.
 		 */
-		quickInsert?: QuickInsertConfig;
+		elementQuickInsert?: ElementQuickInsertConfig;
 	}
 }

package/src/breadcrumbs/{breadcrumbs.ts → elementBreadcrumbs.ts}

@@ -24,9 +24,9 @@ const SLOW_CONVERSION_TIME = 10;
 const THROTTLE_TIME = 250;
 
 /**
- * The configuration of the {@link Breadcrumbs} plugin.
+ * The configuration of the {@link ElementBreadcrumbs} plugin.
  */
-export interface BreadcrumbsConfig {
+export interface ElementBreadcrumbsConfig {
 	/**
 	 * Returns the items of the menu that opens when a breadcrumb is clicked, for the element of the breadcrumb: the
 	 * same items as in the `elementContextMenu` option (commands, submenus and `'|'` separators), so one callback can
@@ -48,18 +48,19 @@ interface DataView {
  * Shows the data view structure at the current selection (the elements of the editor data, as in `getData()`), e.g.
  * `aside.note › p`, `ul › li` or `figure.table › table › tbody › tr › td`.
  *
- * Text attributes such as `<strong>` are skipped. The selected element, e.g. an image, is the innermost item.
+ * Inline elements are items, as any element. CKEditor's text attributes, marks on the text such as its `<strong>`, are
+ * skipped. The selected element, e.g. an image, is the innermost item.
  *
  * Place them in a toolbar as the `breadcrumbs` component, or anywhere else using a view from {@link createView}.
  *
- * Clicking is configured only by the `breadcrumbs.menu` editor config option (see {@link BreadcrumbsConfig}): with it,
+ * Clicking is configured only by the `elementBreadcrumbs.menu` editor config option (see {@link ElementBreadcrumbsConfig}): with it,
  * the items are buttons that open the menu of their element, with `ElementMenu`, as the context menu does; without it,
  * they are labels.
  *
  * The data view is converted again only when elements change, not when typing or moving the cursor. For a large
  * document, that happens at most every 250 ms.
  */
-export default class Breadcrumbs extends Plugin {
+export default class ElementBreadcrumbs extends Plugin {
 	/**
 	 * The elements at the current selection, from the outermost to the innermost one.
 	 *
@@ -72,8 +73,8 @@ export default class Breadcrumbs extends Plugin {
 	private _isConversionSlow = false;
 	private _conversionTimeout: ReturnType<typeof setTimeout> | null = null;
 
-	public static get pluginName(): 'Breadcrumbs' {
-		return 'Breadcrumbs' as const;
+	public static get pluginName(): 'ElementBreadcrumbs' {
+		return 'ElementBreadcrumbs' as const;
 	}
 
 	public static get requires(): readonly [typeof ElementMenu] {
@@ -109,7 +110,7 @@ export default class Breadcrumbs extends Plugin {
 	 * Creates a breadcrumbs view that follows {@link items}.
 	 */
 	public createView(locale: Locale = this.editor.locale): BreadcrumbsView {
-		const isClickable = typeof this.editor.config.get('breadcrumbs')?.menu === 'function';
+		const isClickable = typeof this.editor.config.get('elementBreadcrumbs')?.menu === 'function';
 		const view = new BreadcrumbsView(locale, { isClickable });
 
 		view.setItems(this.items);
@@ -234,7 +235,7 @@ export default class Breadcrumbs extends Plugin {
 	}
 
 	private _openMenu(item: BreadcrumbItemView): void {
-		const menuItems = this.editor.config.get('breadcrumbs')?.menu;
+		const menuItems = this.editor.config.get('elementBreadcrumbs')?.menu;
 		const element = item.modelElement;
 
 		if (!menuItems || !item.element || !element || !isInDocument(element)) {

package/src/contextMenu/elementContextMenu.ts

@@ -1,5 +1,6 @@
 import { Plugin, type ModelElement, type RectSource, type ViewElement } from 'ckeditor5';
-import { getElementAtSelection, isInDocument } from 'ckeditor5-elements-core';
+import { getElementAtSelection, getElementsAround, isInDocument } from 'ckeditor5-elements-core';
+import { getDomTarget } from '../domTarget.js';
 import ElementMenu from '../elementMenu.js';
 import ContextMenuObserver, { type ViewDocumentContextMenuEvent } from './contextMenuObserver.js';
 
@@ -80,17 +81,10 @@ export default class ElementContextMenu extends Plugin {
 	 * Returns `false` when there is no such element or no items.
 	 */
 	public openAtSelection(): boolean {
-		const editing = this.editor.editing;
-		const selection = this.editor.model.document.selection;
-		const selectedElement = selection.getSelectedElement();
-		const element = getElementAtSelection(selection);
-		const viewElement = selectedElement && editing.mapper.toViewElement(selectedElement);
-		const viewRange = editing.view.document.selection.getFirstRange();
-		const target = viewElement
-			? editing.view.domConverter.mapViewToDom(viewElement)
-			: viewRange && editing.view.domConverter.viewRangeToDom(viewRange);
-
-		if (!element || !isInDocument(element) || !(target instanceof HTMLElement || target instanceof Range)) {
+		const element = getElementAtSelection(this.editor.model.document.selection);
+		const target = getDomTarget(this.editor);
+
+		if (!element || !isInDocument(element) || !target) {
 			return false;
 		}
 
@@ -101,14 +95,8 @@ export default class ElementContextMenu extends Plugin {
 	 * Returns the closest model element mapped to the given view element or its ancestors, skipping the root.
 	 */
 	public getModelElement(viewElement: ViewElement): ModelElement | null {
-		const mapper = this.editor.editing.mapper;
-
-		for (let node: ViewElement | null = viewElement; node; node = node.parent?.is('element') ? node.parent : null) {
-			const element = mapper.toModelElement(node);
-
-			if (element) {
-				return element.is('rootElement') ? null : element;
-			}
+		for (const { element } of getElementsAround(this.editor.editing.mapper, viewElement)) {
+			return element;
 		}
 
 		return null;

package/src/domTarget.ts

@@ -0,0 +1,27 @@
+import { ModelPosition, type Editor } from 'ckeditor5';
+import type { ElementOrPosition } from 'ckeditor5-elements-core';
+
+/**
+ * Returns what a menu for the target is shown next to: the DOM element of an element, or the DOM range of a position.
+ * Without a target, the ones of the selection: its selected element, or its range. `null` when it is not rendered.
+ */
+export function getDomTarget(editor: Editor, target?: ElementOrPosition): HTMLElement | Range | null {
+	const { mapper, view } = editor.editing;
+
+	if (target instanceof ModelPosition) {
+		return view.domConverter.viewRangeToDom(view.createRange(mapper.toViewPosition(target)));
+	}
+
+	const element = target ?? editor.model.document.selection.getSelectedElement();
+
+	if (element) {
+		const viewElement = mapper.toViewElement(element);
+		const domElement = viewElement && view.domConverter.mapViewToDom(viewElement);
+
+		return domElement instanceof HTMLElement ? domElement : null;
+	}
+
+	const viewRange = view.document.selection.getFirstRange();
+
+	return viewRange ? view.domConverter.viewRangeToDom(viewRange) : null;
+}