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

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,35 @@
+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.
+ *
+ * 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

@@ -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;;;;;;;;;;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"}

package/dist/elementMenuView.js

@@ -0,0 +1,117 @@
+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.
+ *
+ * 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;
+    _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() };
+        super(locale, bodyCollection, createDefinitions(items, '', maps));
+        this.target = target;
+        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 => !!child && this._isEnabled(child));
+    }
+}
+/**
+ * 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) {
+            continue;
+        }
+        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 Breadcrumbs, type BreadcrumbsConfig } from './breadcrumbs/breadcrumbs.js';
+export { default as QuickInsert, type QuickInsertConfig } from './quickInsert/quickInsert.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,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAG9F,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 Breadcrumbs } from './breadcrumbs/breadcrumbs.js';
+export { default as QuickInsert } from './quickInsert/quickInsert.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,WAAW,EAA0B,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,WAAW,EAA0B,MAAM,8BAA8B,CAAC;AAE9F,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/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"}

package/dist/quickInsert/quickInsert.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 QuickInsert} plugin.
+ */
+export interface QuickInsertConfig {
+    /**
+     * 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 QuickInsertConfig.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 QuickInsert extends Plugin {
+    static get requires(): readonly [typeof ElementMenu];
+    static get pluginName(): 'QuickInsert';
+    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[];
+    /**
+     * 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;
+    /**
+     * Returns the DOM element of the element, or the DOM range of the selection.
+     */
+    private _getDomTarget;
+    private _getDomElement;
+}
+//# sourceMappingURL=quickInsert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickInsert.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAoD,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACnH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAG5C,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;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,WAAY,SAAQ,MAAM;IAC9C,WAAkB,QAAQ,IAAI,SAAS,CAAC,OAAO,WAAW,CAAC,CAE1D;IAED,WAAkB,UAAU,IAAI,aAAa,CAE5C;gBAEW,MAAM,EAAE,MAAM;IAMnB,IAAI,IAAI,IAAI;IAqBnB;;;OAGG;IACI,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,eAAe,EAAE;IAWzE;;;;;;OAMG;IACI,IAAI,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO;IA2BnF;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,cAAc;CAOtB"}

package/dist/quickInsert/quickInsert.js

@@ -0,0 +1,106 @@
+import { Plugin } from 'ckeditor5';
+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 QuickInsertConfig.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 QuickInsert extends Plugin {
+    static get requires() {
+        return [ElementMenu];
+    }
+    static get pluginName() {
+        return 'QuickInsert';
+    }
+    constructor(editor) {
+        super(editor);
+        editor.config.define('quickInsert', { labels: {}, exclude: [], keystroke: 'Alt+Enter' });
+    }
+    init() {
+        const editor = this.editor;
+        const keystroke = editor.config.get('quickInsert')?.keystroke;
+        editor.commands.add('quickInsert', new QuickInsertCommand(editor));
+        editor.commands.add('quickInsertBefore', new QuickInsertPositionCommand(editor, 'before'));
+        editor.commands.add('quickInsertAfter', new QuickInsertPositionCommand(editor, 'after'));
+        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('quickInsert');
+        const labels = config?.labels ?? {};
+        const command = this.editor.commands.get('quickInsert');
+        return (command?.getAllowedElements(elementOrPosition, config?.exclude) ?? []).map(name => ({
+            name,
+            label: labels[name] ?? name
+        }));
+    }
+    /**
+     * 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 ?? this._getDomTarget(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;
+    }
+    /**
+     * 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

package/dist/quickInsert/quickInsert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickInsert.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkF,MAAM,WAAW,CAAC;AAEnH,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AACzD,OAAO,0BAA0B,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAwB,MAAM,0BAA0B,CAAC;AAChE,OAAO,eAAe,MAAM,sBAAsB,CAAC;AAuBnD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,MAAM;IACvC,MAAM,KAAK,QAAQ;QACzB,OAAO,CAAC,WAAW,CAAU,CAAC;IAC/B,CAAC;IAEM,MAAM,KAAK,UAAU;QAC3B,OAAO,aAAsB,CAAC;IAC/B,CAAC;IAED,YAAY,MAAc;QACzB,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEM,IAAI;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;QAE9D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3F,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAEzF,IAAI,SAAS,EAAE,CAAC;YACf,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACjD,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjB,MAAM,EAAE,CAAC;gBACV,CAAC;YACF,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC;gBACtC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,iCAAiC,CAAC,EAAE,SAAS,EAAE,CAAC;aAC/E,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,iBAAqC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAExD,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3F,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI;SAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,IAAI,CAAC,iBAAqC,EAAE,SAAsB;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,SAAS,IAAI,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QAEtE,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,CAAC;YACnF,OAAO,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEzE,IAAI,CAAC,EAAE,CAA2B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAC/D,wGAAwG;YACxG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE;YACtD,yEAAyE;YACzE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;SACtB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,iBAAqC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAEpC,IAAI,iBAAiB,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,iBAAiB;YAClC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAC5E,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;QAEnD,OAAO,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC;IAEO,cAAc,CAAC,OAAqB;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QAEtF,OAAO,UAAU,YAAY,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;CACD"}

package/dist/quickInsert/quickInsertCommand.d.ts

@@ -0,0 +1,38 @@
+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.
+ *
+ * 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.
+ * ```
+ *
+ * Only elements that the schema allows at exactly that position are inserted (see {@link getAllowedElements}):
+ * nothing is split to make room, so e.g. a heading cannot be inserted inside a paragraph.
+ *
+ * After inserting, objects are selected; other elements get the selection inside them, in a new paragraph when they
+ * can hold blocks.
+ */
+export default class QuickInsertCommand extends ElementOrPositionCommand {
+    constructor(editor: Editor);
+    /**
+     * Returns the names of the model elements allowed at exactly the position (or the selection), in the order they
+     * were registered. Generic items (such as `$text` or `$block`) and the excluded names are skipped.
+     */
+    getAllowedElements(elementOrPosition?: ElementOrPosition, exclude?: readonly string[]): string[];
+    /**
+     * 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).
+     */
+    execute(elementOrPosition?: ElementOrPosition, name?: string): void;
+}
+//# sourceMappingURL=quickInsertCommand.d.ts.map

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

@@ -0,0 +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"}

package/dist/quickInsert/quickInsertCommand.js

@@ -0,0 +1,70 @@
+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.
+ *
+ * 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.
+ * ```
+ *
+ * Only elements that the schema allows at exactly that position are inserted (see {@link getAllowedElements}):
+ * nothing is split to make room, so e.g. a heading cannot be inserted inside a paragraph.
+ *
+ * After inserting, objects are selected; other elements get the selection inside them, in a new paragraph when they
+ * can hold blocks.
+ */
+export default class QuickInsertCommand extends ElementOrPositionCommand {
+    constructor(editor) {
+        super(editor);
+        this.title = editor.t('Insert element');
+        this.icon = insertIcon;
+    }
+    /**
+     * Returns the names of the model elements allowed at exactly the position (or the selection), in the order they
+     * 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));
+    }
+    /**
+     * Returns the position where elements are inserted for the target: the position, the position before the element,
+     * or the selection.
+     */
+    getInsertPosition(elementOrPosition) {
+        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).
+     */
+    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)) {
+            return;
+        }
+        model.change(writer => {
+            const element = writer.createElement(name);
+            writer.insert(element, target);
+            selectNewElement(writer, element);
+        });
+    }
+}
+//# sourceMappingURL=quickInsertCommand.js.map

package/dist/quickInsert/quickInsertCommand.js.map

@@ -0,0 +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"}

package/dist/quickInsert/quickInsertListView.d.ts

@@ -0,0 +1,29 @@
+import { ListView, type FilteredView, type Locale } from 'ckeditor5';
+/**
+ * An element that can be inserted: its model name and the label shown in the list.
+ */
+export interface QuickInsertItem {
+    name: string;
+    label: string;
+}
+/**
+ * A list of insertable elements that can be filtered by a search query.
+ *
+ * Fires `execute` with `{ value: name }` when an item is chosen.
+ */
+export default class QuickInsertListView extends ListView implements FilteredView {
+    private readonly _entries;
+    constructor(locale: Locale, items: readonly QuickInsertItem[]);
+    /**
+     * Shows only the items whose label or name matches the expression. `null` shows all items.
+     */
+    filter(regExp: RegExp | null): {
+        resultsCount: number;
+        totalItemsCount: number;
+    };
+    /**
+     * Returns the first item that is not filtered out.
+     */
+    getFirstVisibleItem(): QuickInsertItem | null;
+}
+//# sourceMappingURL=quickInsertListView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickInsertListView.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsertListView.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,QAAQ,EACR,KAAK,YAAY,EAEjB,KAAK,MAAM,EACX,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,QAAS,YAAW,YAAY;IAChF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsE;gBAEnF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,eAAe,EAAE;IAsB7D;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IAcvF;;OAEG;IACI,mBAAmB,IAAI,eAAe,GAAG,IAAI;CAGpD"}