ckeditor5-elements-menu 0.0.0-stage → 49.0.0

package/dist/quickInsert/quickInsertCommand.d.ts

@@ -0,0 +1,47 @@
+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: 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', undefined, 'softBreak'); // Inserts a line break 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[];
+    /**
+     * 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.
+     */
+    execute(elementOrPosition: ElementOrPosition | undefined, name: string): void;
+    /**
+     * Yields the names of the elements allowed at exactly the position (or the selection), one by one.
+     */
+    private _getAllowedElements;
+}
+//# 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;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,81 @@
+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: 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', undefined, 'softBreak'); // Inserts a line break 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 = []) {
+        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,
+     * or the selection.
+     */
+    getInsertPosition(elementOrPosition) {
+        return this._getPosition(elementOrPosition);
+    }
+    /**
+     * Inserts the element named `name` at the target, when the schema allows it there.
+     */
+    execute(elementOrPosition, name) {
+        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);
+        });
+    }
+    /**
+     * 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

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

package/dist/quickInsert/quickInsertListView.js

@@ -0,0 +1,44 @@
+import { ButtonView, ListItemView, ListView } from 'ckeditor5';
+/**
+ * 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 {
+    _entries;
+    constructor(locale, items) {
+        super(locale);
+        this.role = 'listbox';
+        this._entries = items.map(item => {
+            const view = new ListItemView(locale);
+            const button = new ButtonView(locale);
+            button.set({ label: item.label, withText: true, role: 'option' });
+            button.on('execute', () => {
+                this.fire('execute', { value: item.name });
+            });
+            view.children.add(button);
+            return { item, view, button };
+        });
+        this.items.addMany(this._entries.map(entry => entry.view));
+    }
+    /**
+     * Shows only the items whose label or name matches the expression. `null` shows all items.
+     */
+    filter(regExp) {
+        let resultsCount = 0;
+        for (const { item, view } of this._entries) {
+            view.isVisible = !regExp || regExp.test(item.label) || regExp.test(item.name);
+            if (view.isVisible) {
+                resultsCount++;
+            }
+        }
+        return { resultsCount, totalItemsCount: this._entries.length };
+    }
+    /**
+     * Returns the first item that is not filtered out.
+     */
+    getFirstVisibleItem() {
+        return this._entries.find(entry => entry.view.isVisible)?.item ?? null;
+    }
+}
+//# sourceMappingURL=quickInsertListView.js.map

package/dist/quickInsert/quickInsertListView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickInsertListView.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsertListView.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,YAAY,EACZ,QAAQ,EAIR,MAAM,WAAW,CAAC;AAUnB;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,QAAQ;IACvC,QAAQ,CAAsE;IAE/F,YAAY,MAAc,EAAE,KAAiC;QAC5D,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QAEtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAChC,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAEtC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACzB,IAAI,CAAC,IAAI,CAA2B,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAE1B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,MAAqB;QAClC,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5C,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE9E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,YAAY,EAAE,CAAC;YAChB,CAAC;QACF,CAAC;QAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChE,CAAC;IAED;;OAEG;IACI,mBAAmB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACxE,CAAC;CACD"}

package/dist/quickInsert/quickInsertPositionCommand.d.ts

@@ -0,0 +1,33 @@
+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.
+ */
+export type QuickInsertPlacement = 'before' | 'after';
+/**
+ * Opens the quick insert menu for the position before or after an element, next to that element.
+ *
+ * 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.
+ *
+ * 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;
+    /**
+     * 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.
+     */
+    execute(elementOrPosition?: ElementOrPosition): void;
+    protected _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean;
+    private _getInsertPosition;
+}
+//# sourceMappingURL=quickInsertPositionCommand.d.ts.map

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

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

@@ -0,0 +1,52 @@
+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.
+ *
+ * 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.
+ *
+ * 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;
+    /**
+     * 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;
+    }
+    /**
+     * Opens the quick insert menu for the position before or after the element, next to the element.
+     */
+    execute(elementOrPosition) {
+        const element = this._getElement(elementOrPosition);
+        const position = this._getInsertPosition(elementOrPosition);
+        if (element && position) {
+            this._quickInsert.open(position, getDomTarget(this.editor, element) ?? undefined);
+        }
+    }
+    _isEnabledFor(elementOrPosition) {
+        const position = this._getInsertPosition(elementOrPosition);
+        return !!position && this.editor.model.canEditAt(position) && this._quickInsert.hasItems(position);
+    }
+    _getInsertPosition(elementOrPosition) {
+        const element = this._getElement(elementOrPosition);
+        const model = this.editor.model;
+        if (!element) {
+            return null;
+        }
+        return this.placement === 'before' ? model.createPositionBefore(element) : model.createPositionAfter(element);
+    }
+}
+//# sourceMappingURL=quickInsertPositionCommand.js.map

package/dist/quickInsert/quickInsertPositionCommand.js.map

@@ -0,0 +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,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/dist/quickInsert/quickInsertView.d.ts

@@ -0,0 +1,20 @@
+import { SearchTextView, type Locale } from 'ckeditor5';
+import QuickInsertListView, { type QuickInsertItem } from './quickInsertListView.js';
+/**
+ * A search field with a filtered list of insertable elements.
+ *
+ * In the search field, Enter chooses the first matching item and the down arrow moves the focus to the list.
+ * Fires `execute` with `{ value: name }` when an item is chosen.
+ */
+export default class QuickInsertView extends SearchTextView {
+    /**
+     * The list of elements.
+     */
+    readonly listView: QuickInsertListView;
+    constructor(locale: Locale, items: readonly QuickInsertItem[]);
+    /**
+     * Renders the view and sets up Enter (choose the first match) and the down arrow (go to the list) in the search field.
+     */
+    render(): void;
+}
+//# sourceMappingURL=quickInsertView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickInsertView.d.ts","sourceRoot":"","sources":["../../src/quickInsert/quickInsertView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiC,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,mBAAmB,EAAE,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAErF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,cAAc;IAC1D;;OAEG;IACH,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;gBAElC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,eAAe,EAAE;IAoB7D;;OAEG;IACa,MAAM,IAAI,IAAI;CAyB9B"}

package/dist/quickInsert/quickInsertView.js

@@ -0,0 +1,52 @@
+import { SearchTextView } from 'ckeditor5';
+import QuickInsertListView, {} from './quickInsertListView.js';
+/**
+ * A search field with a filtered list of insertable elements.
+ *
+ * In the search field, Enter chooses the first matching item and the down arrow moves the focus to the list.
+ * Fires `execute` with `{ value: name }` when an item is chosen.
+ */
+export default class QuickInsertView extends SearchTextView {
+    /**
+     * The list of elements.
+     */
+    listView;
+    constructor(locale, items) {
+        const listView = new QuickInsertListView(locale, items);
+        const t = locale.t;
+        super(locale, {
+            queryView: { label: t('Insert element') },
+            filteredView: listView,
+            infoView: {
+                text: {
+                    notFound: { primary: t('No matching elements') },
+                    noSearchableItems: { primary: t('No elements can be inserted here') }
+                }
+            },
+            class: 'ck-elements-quick-insert'
+        });
+        this.listView = listView;
+        listView.delegate('execute').to(this);
+    }
+    /**
+     * Renders the view and sets up Enter (choose the first match) and the down arrow (go to the list) in the search field.
+     */
+    render() {
+        super.render();
+        const isInQueryField = () => this.focusTracker.focusedElement === this.queryView.element;
+        this.keystrokes.set('enter', (data, cancel) => {
+            const item = isInQueryField() ? this.listView.getFirstVisibleItem() : null;
+            if (item) {
+                this.fire('execute', { value: item.name });
+                cancel();
+            }
+        });
+        this.keystrokes.set('arrowdown', (data, cancel) => {
+            if (isInQueryField()) {
+                this.listView.focusFirst();
+                cancel();
+            }
+        }, { priority: 'high' });
+    }
+}
+//# sourceMappingURL=quickInsertView.js.map

package/dist/quickInsert/quickInsertView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickInsertView.js","sourceRoot":"","sources":["../../src/quickInsert/quickInsertView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA8C,MAAM,WAAW,CAAC;AACvF,OAAO,mBAAmB,EAAE,EAAwB,MAAM,0BAA0B,CAAC;AAErF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,cAAc;IAC1D;;OAEG;IACa,QAAQ,CAAsB;IAE9C,YAAY,MAAc,EAAE,KAAiC;QAC5D,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QAEnB,KAAK,CAAC,MAAM,EAAE;YACb,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,EAAE;YACzC,YAAY,EAAE,QAAQ;YACtB,QAAQ,EAAE;gBACT,IAAI,EAAE;oBACL,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE;oBAChD,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,kCAAkC,CAAC,EAAE;iBACrE;aACD;YACD,KAAK,EAAE,0BAA0B;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACa,MAAM;QACrB,KAAK,CAAC,MAAM,EAAE,CAAC;QAEf,MAAM,cAAc,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAElG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAE3E,IAAI,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,IAAI,CAA2B,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrE,MAAM,EAAE,CAAC;YACV,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,GAAG,CAClB,WAAW,EACX,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChB,IAAI,cAAc,EAAE,EAAE,CAAC;gBACtB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC3B,MAAM,EAAE,CAAC;YACV,CAAC;QACF,CAAC,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,CACpB,CAAC;IACH,CAAC;CACD"}

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "ckeditor5-elements-menu",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "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",
+    "ckeditor5",
+    "ckeditor 5",
+    "ckeditor5-feature",
+    "ckeditor5-plugin"
+  ],
+  "license": "MIT",
+  "author": "Ivan Kildyushov",
+  "homepage": "https://ivankild.github.io/ckeditor5-elements/guide/context-menu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ivankild/ckeditor5-elements.git",
+    "directory": "packages/ckeditor5-elements-menu"
+  },
+  "bugs": {
+    "url": "https://github.com/ivankild/ckeditor5-elements/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./index.css": "./theme/menu.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "theme",
+    "README.md"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "dependencies": {
+    "ckeditor5-elements-core": "49.0.0"
+  },
+  "devDependencies": {
+    "ckeditor5-elements-actions": "49.0.0"
+  },
+  "peerDependencies": {
+    "ckeditor5": "^49.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build"
+  }
 }

package/src/augmentation.ts

@@ -0,0 +1,44 @@
+import type {
+	ElementBreadcrumbs,
+	ElementBreadcrumbsConfig,
+	ElementContextMenu,
+	ElementMenu,
+	ElementMenuConfig,
+	ElementQuickInsert,
+	QuickInsertCommand,
+	ElementQuickInsertConfig,
+	QuickInsertPositionCommand
+} from './index.js';
+
+declare module 'ckeditor5' {
+	interface PluginsMap {
+		[ElementMenu.pluginName]: ElementMenu;
+		[ElementContextMenu.pluginName]: ElementContextMenu;
+		[ElementBreadcrumbs.pluginName]: ElementBreadcrumbs;
+		[ElementQuickInsert.pluginName]: ElementQuickInsert;
+	}
+
+	interface CommandsMap {
+		quickInsert: QuickInsertCommand;
+		quickInsertBefore: QuickInsertPositionCommand;
+		quickInsertAfter: QuickInsertPositionCommand;
+	}
+
+	interface EditorConfig {
+		/**
+		 * Returns the items (commands, submenus and `'|'` separators) of the context menu of the right-clicked element.
+		 * See {@link ElementContextMenu}.
+		 */
+		elementContextMenu?: ElementMenuConfig;
+
+		/**
+		 * The configuration of the {@link ElementBreadcrumbs} plugin.
+		 */
+		elementBreadcrumbs?: ElementBreadcrumbsConfig;
+
+		/**
+		 * The configuration of the {@link ElementQuickInsert} plugin.
+		 */
+		elementQuickInsert?: ElementQuickInsertConfig;
+	}
+}

package/src/breadcrumbs/breadcrumbItemView.ts

@@ -0,0 +1,74 @@
+import { ButtonView, type Locale, type ModelElement, type ViewElement } from 'ckeditor5';
+
+/**
+ * A single breadcrumb that can be clicked: a button labelled with one element of the data view, e.g. `section.title`.
+ * It opens the menu of its element (`aria-haspopup`), and is `aria-expanded` while the menu is open.
+ */
+export default class BreadcrumbItemView extends ButtonView {
+	/**
+	 * The data view element this item stands for.
+	 */
+	public readonly viewElement: ViewElement;
+
+	/**
+	 * The model element the menu of this item is for.
+	 */
+	public readonly modelElement: ModelElement | null;
+
+	/**
+	 * Whether the menu of this item is open.
+	 *
+	 * @observable
+	 */
+	declare public isExpanded: boolean;
+
+	constructor(
+		locale: Locale | undefined,
+		{ label, viewElement, modelElement }: BreadcrumbItem,
+		{ isCurrent = false }: BreadcrumbItemViewOptions = {}
+	) {
+		super(locale);
+
+		this.viewElement = viewElement;
+		this.modelElement = modelElement;
+
+		this.set({ label, withText: true, isExpanded: false });
+
+		this.extendTemplate({
+			attributes: {
+				class: 'ck-elements-breadcrumbs__item',
+				'aria-haspopup': 'menu',
+				'aria-expanded': this.bindTemplate.to('isExpanded', value => String(value)),
+				...(isCurrent ? { 'aria-current': 'location' } : {})
+			}
+		});
+	}
+}
+
+/**
+ * The options of {@link BreadcrumbItemView} and {@link BreadcrumbLabelView}.
+ */
+export interface BreadcrumbItemViewOptions {
+	/**
+	 * Whether the item is the innermost element (where the cursor is). It is marked with `aria-current="location"`.
+	 */
+	isCurrent?: boolean;
+}
+
+/**
+ * A breadcrumb: an element of the data view, its label, and the model element it belongs to.
+ */
+export interface BreadcrumbItem {
+	label: string;
+
+	/**
+	 * The data view element (as in the editor data, e.g. `getData()`).
+	 */
+	viewElement: ViewElement;
+
+	/**
+	 * The model element of the view element: the mapped one, or for a part of a structure (e.g. a `tbody`), the closest
+	 * mapped ancestor (the table). `null` for list items (`ul`, `li`), which come from block attributes.
+	 */
+	modelElement: ModelElement | null;
+}

package/src/breadcrumbs/breadcrumbLabelView.ts

@@ -0,0 +1,55 @@
+import { View, type Locale, type ModelElement, type ViewElement } from 'ckeditor5';
+import { type BreadcrumbItem, type BreadcrumbItemViewOptions } from './breadcrumbItemView.js';
+
+/**
+ * A single breadcrumb that cannot be clicked: the label of one element of the data view, e.g. `section.title`.
+ *
+ * It can be focused (but is not in the Tab order), so keyboard users can reach it in a toolbar.
+ */
+export default class BreadcrumbLabelView extends View {
+	/**
+	 * The data view element this item stands for.
+	 */
+	public readonly viewElement: ViewElement;
+
+	/**
+	 * The model element of the view element, if any.
+	 */
+	public readonly modelElement: ModelElement | null;
+
+	/**
+	 * The label of the element.
+	 *
+	 * @observable
+	 */
+	declare public label: string;
+
+	constructor(
+		locale: Locale | undefined,
+		{ label, viewElement, modelElement }: BreadcrumbItem,
+		{ isCurrent = false }: BreadcrumbItemViewOptions = {}
+	) {
+		super(locale);
+
+		this.viewElement = viewElement;
+		this.modelElement = modelElement;
+		this.set('label', label);
+
+		this.setTemplate({
+			tag: 'span',
+			attributes: {
+				class: ['ck', 'ck-elements-breadcrumbs__item', 'ck-elements-breadcrumbs__label'],
+				tabindex: '-1',
+				...(isCurrent ? { 'aria-current': 'location' } : {})
+			},
+			children: [{ text: this.bindTemplate.to('label') }]
+		});
+	}
+
+	/**
+	 * Focuses the label.
+	 */
+	public focus(): void {
+		this.element?.focus();
+	}
+}