ckeditor5-elements-core 0.0.0-stage → 49.0.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ivan Kildyushov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# ckeditor5-elements-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The base of CKEditor 5 Elements: commands that act on a position or an element (`ElementOrPositionCommand`,
+`ElementCommand`), their buttons (`ElementOrPositionButtonView`, `ElementButtonView`), and the `ElementMenu` plugin, which
+shows the menus of the context menu, the breadcrumbs and quick insert.
+
+## Installation
+
+This package is part of `ckeditor5-elements`. Install the whole package to use it:
+
+```sh
+npm install ckeditor5 ckeditor5-elements
+```
+
+## Usage
+
+```ts
+import { ElementButtonView, ElementCommand } from 'ckeditor5-elements';
+
+class CalloutCommand extends ElementCommand {
+	constructor(editor) {
+		super(editor);
+
+		this.elementName = 'callout';
+		this.set({ title: 'Callout', icon: calloutIcon });
+	}
+}
+
+editor.commands.add('callout', new CalloutCommand(editor));
+editor.ui.componentFactory.add('callout', locale => new ElementButtonView(locale, editor.commands.get('callout')));
+```
+
+See the [Commands guide](https://ivankild.github.io/ckeditor5-elements/guide/commands) of the documentation.
+
+## License
+
+MIT

package/dist/augmentation.d.ts

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

package/dist/augmentation.d.ts.map

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

package/dist/augmentation.js

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

package/dist/augmentation.js.map

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

package/dist/elementButtonView.d.ts

@@ -0,0 +1,14 @@
+import { type Locale } from 'ckeditor5';
+import type ElementCommand from './elementCommand.js';
+import ElementOrPositionButtonView, { type ElementOrPositionButtonViewOptions } from './elementOrPositionButtonView.js';
+/**
+ * A button that reflects an {@link ElementCommand}, including whether it is "on", and executes it when clicked.
+ */
+export default class ElementButtonView extends ElementOrPositionButtonView {
+    /**
+     * The command this button reflects.
+     */
+    readonly command: ElementCommand;
+    constructor(locale: Locale | undefined, command: ElementCommand, options?: ElementOrPositionButtonViewOptions);
+}
+//# sourceMappingURL=elementButtonView.d.ts.map

package/dist/elementButtonView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementButtonView.d.ts","sourceRoot":"","sources":["../src/elementButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,2BAA2B,EAAE,EAAE,KAAK,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAExH;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,2BAA2B;IACzE;;OAEG;IACH,SAAwB,OAAO,EAAE,cAAc,CAAC;gBAEpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,kCAAuC;CAOjH"}

package/dist/elementButtonView.js

@@ -0,0 +1,14 @@
+import {} from 'ckeditor5';
+import ElementOrPositionButtonView, {} from './elementOrPositionButtonView.js';
+/**
+ * A button that reflects an {@link ElementCommand}, including whether it is "on", and executes it when clicked.
+ */
+export default class ElementButtonView extends ElementOrPositionButtonView {
+    constructor(locale, command, options = {}) {
+        super(locale, command, options);
+        if (!options.target) {
+            this.bind('isOn').to(command, 'isOn');
+        }
+    }
+}
+//# sourceMappingURL=elementButtonView.js.map

package/dist/elementButtonView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementButtonView.js","sourceRoot":"","sources":["../src/elementButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,MAAM,WAAW,CAAC;AAExC,OAAO,2BAA2B,EAAE,EAA2C,MAAM,kCAAkC,CAAC;AAExH;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,2BAA2B;IAMzE,YAAY,MAA0B,EAAE,OAAuB,EAAE,UAA8C,EAAE;QAChH,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAEhC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;IACF,CAAC;CACD"}

package/dist/elementCommand.d.ts

@@ -0,0 +1,69 @@
+import { type Editor, type ModelDocumentFragment, type ModelElement, type ModelNode, type ModelWriter } from 'ckeditor5';
+import ElementOrPositionCommand, { type ElementOrPosition } from './elementOrPositionCommand.js';
+/**
+ * A command that toggles an element.
+ *
+ * Both {@link refresh} and {@link execute} accept an optional position or element. When it is
+ * absent, it is taken from the current selection (see {@link ElementOrPositionCommand}).
+ *
+ * The command toggles: it unwraps the closest matching element, or wraps the target with a new one.
+ * It is enabled only when the toggle is allowed by the schema and the target is editable.
+ */
+export default class ElementCommand extends ElementOrPositionCommand {
+    /**
+     * Whether the command is "on" (e.g. the element is active at the given position).
+     *
+     * @observable
+     */
+    isOn: boolean;
+    /**
+     * The name of the model element this command matches, wraps with and unwraps.
+     */
+    elementName: string;
+    /**
+     * The attributes the model element must have to be matched. Also set on newly created elements.
+     */
+    elementAttributes: Record<string, unknown>;
+    constructor(editor: Editor);
+    refresh(elementOrPosition?: ElementOrPosition): void;
+    /**
+     * Checks whether the given node is an element handled by this command: it is named {@link elementName}
+     * and has all {@link elementAttributes} with the same values.
+     */
+    isElement(node: ModelNode | ModelDocumentFragment): boolean;
+    /**
+     * Unwraps the closest element that satisfies {@link isElement}. If there is none,
+     * wraps the given element (or the position's parent) with a new element.
+     */
+    execute(elementOrPosition?: ElementOrPosition): void;
+    /**
+     * Creates the element used for wrapping.
+     */
+    protected _createElement(writer: ModelWriter): ModelElement;
+    /**
+     * Enabled when the target can be edited and the toggle is allowed by the schema.
+     */
+    protected _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean;
+    /**
+     * "On" when the target is (in) a matching element.
+     */
+    protected _isOnFor(elementOrPosition?: ElementOrPosition): boolean;
+    /**
+     * Returns the element that would be wrapped: the given element, or the position's parent. Never a root.
+     */
+    private _getNodeToWrap;
+    /**
+     * Whether the schema allows the new element in place of the node to wrap, and the node inside the new element.
+     */
+    private _canWrap;
+    /**
+     * Whether the schema allows all children of the element in its parent.
+     */
+    private _canUnwrap;
+    /**
+     * Returns the closest element that satisfies {@link isElement}: the element itself or its ancestor,
+     * or the position's parent or its ancestor. Root elements are skipped, as they cannot be unwrapped.
+     */
+    private _findElement;
+}
+//# sourceMappingURL=elementCommand.d.ts.map

package/dist/elementCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementCommand.d.ts","sourceRoot":"","sources":["../src/elementCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,wBAAwB,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEjG;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,wBAAwB;IACnE;;;;OAIG;IACY,IAAI,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACI,WAAW,SAAa;IAE/B;;OAEG;IACI,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;gBAE3C,MAAM,EAAE,MAAM;IAOV,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAKpE;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,GAAG,OAAO;IAQlE;;;OAGG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAsBpE;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY;IAI3D;;OAEG;cACgB,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAWhF;;OAEG;cACgB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAM3E;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAapB"}

package/dist/elementCommand.js

@@ -0,0 +1,133 @@
+import {} from 'ckeditor5';
+import ElementOrPositionCommand, {} from './elementOrPositionCommand.js';
+/**
+ * A command that toggles an element.
+ *
+ * Both {@link refresh} and {@link execute} accept an optional position or element. When it is
+ * absent, it is taken from the current selection (see {@link ElementOrPositionCommand}).
+ *
+ * The command toggles: it unwraps the closest matching element, or wraps the target with a new one.
+ * It is enabled only when the toggle is allowed by the schema and the target is editable.
+ */
+export default class ElementCommand extends ElementOrPositionCommand {
+    /**
+     * The name of the model element this command matches, wraps with and unwraps.
+     */
+    elementName = 'element';
+    /**
+     * The attributes the model element must have to be matched. Also set on newly created elements.
+     */
+    elementAttributes = {};
+    constructor(editor) {
+        super(editor);
+        this.set('isOn', false);
+        this.isToggleable = true;
+    }
+    refresh(elementOrPosition) {
+        this.isOn = this._isOnFor(elementOrPosition);
+        super.refresh(elementOrPosition);
+    }
+    /**
+     * Checks whether the given node is an element handled by this command: it is named {@link elementName}
+     * and has all {@link elementAttributes} with the same values.
+     */
+    isElement(node) {
+        if (!node.is('element', this.elementName)) {
+            return false;
+        }
+        return Object.entries(this.elementAttributes).every(([key, value]) => node.getAttribute(key) === value);
+    }
+    /**
+     * Unwraps the closest element that satisfies {@link isElement}. If there is none,
+     * wraps the given element (or the position's parent) with a new element.
+     */
+    execute(elementOrPosition) {
+        const model = this.editor.model;
+        const target = this._getElementOrPosition(elementOrPosition);
+        if (!target || !model.canEditAt(target)) {
+            return;
+        }
+        const element = this._findElement(target);
+        const nodeToWrap = this._getNodeToWrap(target);
+        model.change(writer => {
+            if (element) {
+                if (this._canUnwrap(element)) {
+                    writer.unwrap(element);
+                }
+            }
+            else if (nodeToWrap && this._canWrap(target)) {
+                writer.wrap(writer.createRangeOn(nodeToWrap), this._createElement(writer));
+            }
+        });
+    }
+    /**
+     * Creates the element used for wrapping.
+     */
+    _createElement(writer) {
+        return writer.createElement(this.elementName, this.elementAttributes);
+    }
+    /**
+     * Enabled when the target can be edited and the toggle is allowed by the schema.
+     */
+    _isEnabledFor(elementOrPosition) {
+        const target = this._getElementOrPosition(elementOrPosition);
+        const element = target && this._findElement(target);
+        return (!!target &&
+            this.editor.model.canEditAt(target) &&
+            (element ? this._canUnwrap(element) : this._canWrap(target)));
+    }
+    /**
+     * "On" when the target is (in) a matching element.
+     */
+    _isOnFor(elementOrPosition) {
+        const target = this._getElementOrPosition(elementOrPosition);
+        return !!target && !!this._findElement(target);
+    }
+    /**
+     * Returns the element that would be wrapped: the given element, or the position's parent. Never a root.
+     */
+    _getNodeToWrap(elementOrPosition) {
+        const node = elementOrPosition.is('position') ? elementOrPosition.parent : elementOrPosition;
+        return node.is('element') && !node.is('rootElement') ? node : null;
+    }
+    /**
+     * Whether the schema allows the new element in place of the node to wrap, and the node inside the new element.
+     */
+    _canWrap(elementOrPosition) {
+        const node = this._getNodeToWrap(elementOrPosition);
+        if (!node) {
+            return false;
+        }
+        const model = this.editor.model;
+        const ancestors = node.getAncestors().filter(ancestor => ancestor.is('element'));
+        return (model.schema.checkChild(model.createPositionBefore(node), this.elementName) &&
+            model.schema.checkChild([...ancestors, this.elementName], node));
+    }
+    /**
+     * Whether the schema allows all children of the element in its parent.
+     */
+    _canUnwrap(element) {
+        const model = this.editor.model;
+        if (!element.parent) {
+            return false;
+        }
+        const position = model.createPositionBefore(element);
+        return Array.from(element.getChildren()).every(child => model.schema.checkChild(position, child));
+    }
+    /**
+     * Returns the closest element that satisfies {@link isElement}: the element itself or its ancestor,
+     * or the position's parent or its ancestor. Root elements are skipped, as they cannot be unwrapped.
+     */
+    _findElement(elementOrPosition) {
+        const ancestors = elementOrPosition.is('position')
+            ? elementOrPosition.getAncestors()
+            : elementOrPosition.getAncestors({ includeSelf: true });
+        for (const node of ancestors.reverse()) {
+            if (node.is('element') && !node.is('rootElement') && this.isElement(node)) {
+                return node;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=elementCommand.js.map

package/dist/elementCommand.js.map

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

package/dist/elementMenu.d.ts

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

package/dist/elementMenu.d.ts.map

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

package/dist/elementMenu.js

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

package/dist/elementMenu.js.map

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

package/dist/elementMenuItemButtonView.d.ts

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

package/dist/elementMenuItemButtonView.d.ts.map

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