ckeditor5-elements-menu 0.0.0-stage → 49.0.0

package/dist/elementMenu.js

@@ -0,0 +1,140 @@
+import { ContextualBalloon, DropdownMenuRootListView, KeystrokeHandler, Notification, Plugin, clickOutsideHandler } from 'ckeditor5';
+import { isInDocument } from 'ckeditor5-elements-core';
+import ElementMenuView from './elementMenuView.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 view = new ElementMenuView(this.editor.locale, this.editor.ui.view.body, config(element, this.editor), element);
+        if (view.isEmpty) {
+            view.destroy();
+            return false;
+        }
+        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 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

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

package/dist/elementMenuView.d.ts

@@ -0,0 +1,40 @@
+import { DropdownMenuRootListView, type BodyCollection, type Locale } from 'ckeditor5';
+import { type ElementOrPosition } from 'ckeditor5-elements-core';
+import { type ElementMenuItem } from './elementMenu.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.
+ *
+ * Missing items are skipped, and submenus without items, and separators at the start or the end, or repeated ones.
+ * 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;
+    /**
+     * Whether the menu has no items: all were missing.
+     */
+    readonly isEmpty: boolean;
+    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

@@ -0,0 +1 @@
+{"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,EAAiD,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAChH,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,kBAAkB,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,wBAAwB;IACpE;;OAEG;IACH,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAE1C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IAErD;;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;IAoB1B;;;OAGG;IACa,MAAM,IAAI,IAAI;IAqC9B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;CASlB"}

package/dist/elementMenuView.js

@@ -0,0 +1,143 @@
+import { DropdownMenuRootListView, ListSeparatorView } from 'ckeditor5';
+import { ElementOrPositionCommand, bindButtonToCommand } from 'ckeditor5-elements-core';
+import {} from './elementMenu.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.
+ *
+ * Missing items are skipped, and submenus without items, and separators at the start or the end, or repeated ones.
+ * 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.
+     */
+    target;
+    /**
+     * Whether the menu has no items: all were missing.
+     */
+    isEmpty;
+    _commands;
+    _submenus;
+    /**
+     * The positions of the separators in each list, by the id of the submenu (`''` for the menu itself).
+     */
+    _separators;
+    constructor(locale, bodyCollection, items, target) {
+        const maps = { commands: new Map(), submenus: new Map(), separators: new Map() };
+        const menuItems = cleanItems(items);
+        super(locale, bodyCollection, createDefinitions(menuItems, '', maps));
+        this.target = target;
+        this.isEmpty = !menuItems.length;
+        this._commands = maps.commands;
+        this._submenus = maps.submenus;
+        this._separators = maps.separators;
+        this.menuPanelClass = 'ck-elements-menu__panel';
+        this.extendTemplate({
+            attributes: { class: 'ck-elements-menu' },
+            on: { contextmenu: this.bindTemplate.to(preventDefault) }
+        });
+    }
+    /**
+     * Renders the menu: CKEditor builds it from the definitions; then the buttons are connected to the commands, and the
+     * separators are added.
+     */
+    render() {
+        super.render();
+        for (const button of this.buttons) {
+            const command = this._commands.get(button.id);
+            if (command) {
+                bindButtonToCommand(button, command, { withText: true, target: this.target });
+                // A toggleable button with a checkable role tells assistive technology whether it is "on" with `aria-checked`.
+                button.role = command.isToggleable ? 'menuitemcheckbox' : 'menuitem';
+            }
+        }
+        for (const menu of this.menus) {
+            const submenu = this._submenus.get(menu.id);
+            if (submenu) {
+                menu.buttonView.icon = submenu.icon;
+                menu.isEnabled = this._isEnabled(submenu);
+            }
+            // The panels of nested menus are not inside the menu.
+            if (menu.panelView.element) {
+                this.listenTo(menu.panelView.element, 'contextmenu', (evt, domEvent) => {
+                    preventDefault(domEvent);
+                });
+            }
+        }
+        this._addSeparators('', this);
+        for (const menu of this.menus) {
+            this._addSeparators(menu.id, menu.listView);
+        }
+    }
+    _addSeparators(id, list) {
+        for (const position of this._separators.get(id) ?? []) {
+            const separator = new ListSeparatorView(this.locale);
+            separator.extendTemplate({ attributes: { role: 'separator' } });
+            list.items.add(separator, position);
+        }
+    }
+    _isEnabled(item) {
+        if (item === '|') {
+            return false;
+        }
+        return item instanceof ElementOrPositionCommand
+            ? item.getState(this.target).isEnabled
+            : item.items.some(child => this._isEnabled(child));
+    }
+}
+/**
+ * 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;
+}
+/**
+ * Creates CKEditor's menu definitions for the items. The ids are paths of positions (e.g. `'2.0'`). Collects the
+ * commands and submenus by id, and the positions of the separators by the id of their submenu.
+ */
+function createDefinitions(items, parentId, maps) {
+    const definitions = [];
+    let position = 0;
+    for (const item of items) {
+        const id = parentId ? `${parentId}.${String(position)}` : String(position);
+        if (item === '|') {
+            maps.separators.set(parentId, [...(maps.separators.get(parentId) ?? []), position]);
+        }
+        else if (item instanceof ElementOrPositionCommand) {
+            maps.commands.set(id, item);
+            definitions.push({ id, label: item.title });
+        }
+        else {
+            maps.submenus.set(id, item);
+            definitions.push({ id, menu: item.title, children: createDefinitions(item.items, id, maps) });
+        }
+        position++;
+    }
+    return definitions;
+}
+function preventDefault(domEvent) {
+    domEvent.preventDefault();
+}
+//# sourceMappingURL=elementMenuView.js.map

package/dist/elementMenuView.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Element menus: `ElementMenu` shows the menu of an element, built from commands, submenus and separators, and the
+ * features that open it: the element context menu (a right-click, Shift+F10 or the menu key), the breadcrumbs (the
+ * element path at the selection, clickable with a menu) and quick insert (search and insert the elements allowed at a
+ * position).
+ *
+ * @module ckeditor5-elements-menu
+ */
+export { default as ElementMenu, type ElementMenuConfig, type ElementMenuItem, type ElementMenuShowOptions, type ElementSubmenu } from './elementMenu.js';
+export { default as ElementContextMenu } from './contextMenu/elementContextMenu.js';
+export { default as ElementBreadcrumbs, type ElementBreadcrumbsConfig } from './breadcrumbs/elementBreadcrumbs.js';
+export { default as ElementQuickInsert, type ElementQuickInsertConfig } from './quickInsert/elementQuickInsert.js';
+export { default as QuickInsertCommand } from './quickInsert/quickInsertCommand.js';
+export { default as QuickInsertPositionCommand, type QuickInsertPlacement } from './quickInsert/quickInsertPositionCommand.js';
+export { default as ElementMenuView } from './elementMenuView.js';
+export { default as BreadcrumbsView, type BreadcrumbsViewExecuteEvent, type BreadcrumbsViewOptions } from './breadcrumbs/breadcrumbsView.js';
+export { default as BreadcrumbItemView, type BreadcrumbItem, type BreadcrumbItemViewOptions } from './breadcrumbs/breadcrumbItemView.js';
+export { default as BreadcrumbLabelView } from './breadcrumbs/breadcrumbLabelView.js';
+export { default as QuickInsertView } from './quickInsert/quickInsertView.js';
+export { default as QuickInsertListView, type QuickInsertItem } from './quickInsert/quickInsertListView.js';
+export { default as ContextMenuObserver, type ViewDocumentContextMenuEvent } from './contextMenu/contextMenuObserver.js';
+export { insertAfterIcon, insertBeforeIcon, insertIcon } from './quickInsert/icons.js';
+import './augmentation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACN,OAAO,IAAI,WAAW,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACnH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAGnH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EACN,OAAO,IAAI,0BAA0B,EACrC,KAAK,oBAAoB,EACzB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACN,OAAO,IAAI,eAAe,EAC1B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,OAAO,IAAI,kBAAkB,EAC7B,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAG5G,OAAO,EACN,OAAO,IAAI,mBAAmB,EAC9B,KAAK,4BAA4B,EACjC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * Element menus: `ElementMenu` shows the menu of an element, built from commands, submenus and separators, and the
+ * features that open it: the element context menu (a right-click, Shift+F10 or the menu key), the breadcrumbs (the
+ * element path at the selection, clickable with a menu) and quick insert (search and insert the elements allowed at a
+ * position).
+ *
+ * @module ckeditor5-elements-menu
+ */
+// Plugins.
+export { default as ElementMenu } from './elementMenu.js';
+export { default as ElementContextMenu } from './contextMenu/elementContextMenu.js';
+export { default as ElementBreadcrumbs } from './breadcrumbs/elementBreadcrumbs.js';
+export { default as ElementQuickInsert } from './quickInsert/elementQuickInsert.js';
+// Commands.
+export { default as QuickInsertCommand } from './quickInsert/quickInsertCommand.js';
+export { default as QuickInsertPositionCommand } from './quickInsert/quickInsertPositionCommand.js';
+// Views.
+export { default as ElementMenuView } from './elementMenuView.js';
+export { default as BreadcrumbsView } from './breadcrumbs/breadcrumbsView.js';
+export { default as BreadcrumbItemView } from './breadcrumbs/breadcrumbItemView.js';
+export { default as BreadcrumbLabelView } from './breadcrumbs/breadcrumbLabelView.js';
+export { default as QuickInsertView } from './quickInsert/quickInsertView.js';
+export { default as QuickInsertListView } from './quickInsert/quickInsertListView.js';
+// Observers.
+export { default as ContextMenuObserver } from './contextMenu/contextMenuObserver.js';
+// Icons.
+export { insertAfterIcon, insertBeforeIcon, insertIcon } from './quickInsert/icons.js';
+import './augmentation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,WAAW;AACX,OAAO,EACN,OAAO,IAAI,WAAW,EAKtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAiC,MAAM,qCAAqC,CAAC;AACnH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAiC,MAAM,qCAAqC,CAAC;AAEnH,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EACN,OAAO,IAAI,0BAA0B,EAErC,MAAM,6CAA6C,CAAC;AAErD,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACN,OAAO,IAAI,eAAe,EAG1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,OAAO,IAAI,kBAAkB,EAG7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAwB,MAAM,sCAAsC,CAAC;AAE5G,aAAa;AACb,OAAO,EACN,OAAO,IAAI,mBAAmB,EAE9B,MAAM,sCAAsC,CAAC;AAE9C,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,mBAAmB,CAAC"}

package/dist/quickInsert/elementQuickInsert.d.ts

@@ -0,0 +1,57 @@
+import { Plugin, type Editor, type RectSource } from 'ckeditor5';
+import type { ElementOrPosition } from 'ckeditor5-elements-core';
+import ElementMenu from '../elementMenu.js';
+import { type QuickInsertItem } from './quickInsertListView.js';
+/**
+ * The configuration of the {@link ElementQuickInsert} plugin.
+ */
+export interface ElementQuickInsertConfig {
+    /**
+     * Labels of the elements, by model name. Elements without a label are listed by their model name.
+     */
+    labels?: Record<string, string>;
+    /**
+     * Model names of the elements that are never listed.
+     */
+    exclude?: string[];
+    /**
+     * The keystroke that opens the menu at the selection, e.g. `'Ctrl+Space'`. Defaults to `'Alt+Enter'`
+     * (Option+Enter on macOS). `false` registers no keystroke.
+     */
+    keystroke?: string | false;
+}
+/**
+ * Opens a menu with a search field and the elements allowed at the selection, on Alt+Enter (Option+Enter on macOS; see
+ * {@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
+ * `elementContextMenu` config, e.g. as an "Insert" submenu.
+ *
+ * The menu closes when the document changes while it is open, so it never inserts at an outdated position.
+ */
+export default class ElementQuickInsert extends Plugin {
+    static get requires(): readonly [typeof ElementMenu];
+    static get pluginName(): 'ElementQuickInsert';
+    constructor(editor: Editor);
+    init(): void;
+    /**
+     * Returns the elements that can be inserted at the target (a position, the position before an element, or the
+     * 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.
+     *
+     * Returns `false` when nothing can be inserted at the target because it cannot be edited, or there is nothing to
+     * show the menu next to.
+     */
+    open(elementOrPosition?: ElementOrPosition, domTarget?: RectSource): boolean;
+}
+//# 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/elementQuickInsert.js

@@ -0,0 +1,96 @@
+import { Plugin } from 'ckeditor5';
+import { getDomTarget } from '../domTarget.js';
+import ElementMenu from '../elementMenu.js';
+import QuickInsertCommand from './quickInsertCommand.js';
+import QuickInsertPositionCommand from './quickInsertPositionCommand.js';
+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 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
+ * `elementContextMenu` config, e.g. as an "Insert" submenu.
+ *
+ * The menu closes when the document changes while it is open, so it never inserts at an outdated position.
+ */
+export default class ElementQuickInsert extends Plugin {
+    static get requires() {
+        return [ElementMenu];
+    }
+    static get pluginName() {
+        return 'ElementQuickInsert';
+    }
+    constructor(editor) {
+        super(editor);
+        editor.config.define('elementQuickInsert', { labels: {}, exclude: [], keystroke: 'Alt+Enter' });
+    }
+    init() {
+        const editor = this.editor;
+        const keystroke = editor.config.get('elementQuickInsert')?.keystroke;
+        editor.commands.add('quickInsert', new QuickInsertCommand(editor));
+        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()) {
+                    cancel();
+                }
+            });
+            editor.accessibility.addKeystrokeInfos({
+                keystrokes: [{ label: editor.t('Insert an element at the cursor'), keystroke }]
+            });
+        }
+    }
+    /**
+     * Returns the elements that can be inserted at the target (a position, the position before an element, or the
+     * selection), with their labels.
+     */
+    getItems(elementOrPosition) {
+        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 => ({
+            name,
+            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.
+     *
+     * Returns `false` when nothing can be inserted at the target because it cannot be edited, or there is nothing to
+     * show the menu next to.
+     */
+    open(elementOrPosition, domTarget) {
+        const editor = this.editor;
+        const command = editor.commands.get('quickInsert');
+        const position = command?.getInsertPosition(elementOrPosition);
+        const menuTarget = domTarget ?? getDomTarget(editor, elementOrPosition);
+        if (!command || !position || !menuTarget || !command.getState(position).isEnabled) {
+            return false;
+        }
+        const view = new QuickInsertView(editor.locale, this.getItems(position));
+        view.on('execute', (evt, { value }) => {
+            // Focus first: focusing reads the DOM selection, which would override the selection set by the command.
+            editor.editing.view.focus();
+            command.executeFor(position, value);
+        });
+        // The search field is labelled "Insert element".
+        editor.plugins.get(ElementMenu).show(view, menuTarget, {
+            // The position would be outdated after any change, e.g. by another user.
+            isObsolete: () => true
+        });
+        return true;
+    }
+}
+//# 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/icons.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The icons of the quick insert commands, in the style of the CKEditor 5 icons (20×20).
+ */
+/**
+ * Insert element: CKEditor's own plus icon.
+ */
+export declare const insertIcon: string;
+/**
+ * Insert before: a plus above a block.
+ */
+export declare const insertBeforeIcon: string;
+/**
+ * Insert after: a block above a plus.
+ */
+export declare const insertAfterIcon: string;
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/quickInsert/icons.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,QAAW,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAGsB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,eAAe,QAGmB,CAAC"}

package/dist/quickInsert/icons.js

@@ -0,0 +1,21 @@
+import { IconPlus } from 'ckeditor5';
+/**
+ * The icons of the quick insert commands, in the style of the CKEditor 5 icons (20×20).
+ */
+/**
+ * Insert element: CKEditor's own plus icon.
+ */
+export const insertIcon = IconPlus;
+/**
+ * Insert before: a plus above a block.
+ */
+export const insertBeforeIcon = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+    'M9.25 1.5h1.5v2.75h2.75v1.5h-2.75V8.5h-1.5V5.75H6.5v-1.5h2.75zM3.5 11h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 1 0 0 ' +
+    '1-1-1v-5a1 1 0 0 1 1-1zm.5 1.5v4h12v-4z"/></svg>';
+/**
+ * Insert after: a block above a plus.
+ */
+export const insertAfterIcon = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+    'M3.5 2h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM9.25 11h1.5v2.75h2.75v1.5' +
+    'h-2.75V18h-1.5v-2.75H6.5v-1.5h2.75z"/></svg>';
+//# sourceMappingURL=icons.js.map

package/dist/quickInsert/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/quickInsert/icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC5B,2FAA2F;IAC3F,qHAAqH;IACrH,kDAAkD,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAC3B,2FAA2F;IAC3F,sHAAsH;IACtH,8CAA8C,CAAC"}