ckeditor5-elements-core 49.0.0-alpha.0 → 49.0.0-alpha.4

package/README.md

@@ -1,8 +1,8 @@
 # ckeditor5-elements-core
 
 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.
+`ElementCommand`), and their buttons (`ElementOrPositionButtonView`, `ElementButtonView`). The menus of commands are in
+`ckeditor5-elements-menu`.
 
 ## Installation
 

package/dist/elementOrPositionButtonView.d.ts

@@ -10,11 +10,17 @@ export interface ElementOrPositionButtonViewOptions {
      */
     withText?: boolean;
     /**
-     * The position or element the button acts on. Without it, the button follows the command state for the selection
-     * and executes the command for the selection.
+     * The position or element the button acts on, or a function that returns it, e.g. the element of a floating
+     * toolbar, which changes as the selection moves. The function is called whenever the button updates or is clicked;
+     * when it returns `null`, the button is disabled. Without a target, the button follows the command state for the
+     * selection and executes the command for the selection.
      */
-    target?: ElementOrPosition;
+    target?: ElementOrPositionTarget;
 }
+/**
+ * The target of a button: a position or an element, or a function that returns one (or `null`).
+ */
+export type ElementOrPositionTarget = ElementOrPosition | (() => ElementOrPosition | null);
 /**
  * A button that reflects an {@link ElementOrPositionCommand} and executes it when clicked.
  *
@@ -34,7 +40,7 @@ export default class ElementOrPositionButtonView extends ButtonView {
     /**
      * The position or element the button acts on, if any.
      */
-    readonly target: ElementOrPosition | undefined;
+    readonly target: ElementOrPositionTarget | undefined;
     constructor(locale: Locale | undefined, command: ElementOrPositionCommand, options?: ElementOrPositionButtonViewOptions);
 }
 /**

package/dist/elementOrPositionButtonView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elementOrPositionButtonView.d.ts","sourceRoot":"","sources":["../src/elementOrPositionButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kCAAkC;IAClD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,UAAU;IAClE;;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,OAAO,GAAE,kCAAuC;CASjD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,wBAAwB,EACjC,EAAE,QAAgB,EAAE,MAAM,EAAE,GAAE,kCAAuC,GACnE,IAAI,CAwCN"}
+{"version":3,"file":"elementOrPositionButtonView.d.ts","sourceRoot":"","sources":["../src/elementOrPositionButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kCAAkC;IAClD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,UAAU;IAClE;;OAEG;IACH,SAAgB,OAAO,EAAE,wBAAwB,CAAC;IAElD;;OAEG;IACH,SAAgB,MAAM,EAAE,uBAAuB,GAAG,SAAS,CAAC;gBAG3D,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,wBAAwB,EACjC,OAAO,GAAE,kCAAuC;CASjD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,wBAAwB,EACjC,EAAE,QAAgB,EAAE,MAAM,EAAE,GAAE,kCAAuC,GACnE,IAAI,CAiDN"}

package/dist/elementOrPositionButtonView.js

@@ -41,9 +41,11 @@ export function bindButtonToCommand(button, command, { withText = false, target
     else {
         button.bind('tooltip').to(command, 'tooltip');
     }
+    const getTarget = typeof target === 'function' ? target : () => target ?? null;
     if (target) {
         const updateState = () => {
-            const { isEnabled, isOn } = command.getState(target);
+            const current = getTarget();
+            const { isEnabled, isOn } = current ? command.getState(current) : { isEnabled: false, isOn: false };
             button.isEnabled = isEnabled;
             button.isOn = isOn;
         };
@@ -58,7 +60,11 @@ export function bindButtonToCommand(button, command, { withText = false, target
     button.on('execute', () => {
         // Focus first: focusing reads the DOM selection, which would override a selection set by the command.
         editor.editing.view.focus();
-        const result = target ? command.executeFor(target) : command.execute();
+        const current = getTarget();
+        if (target && !current) {
+            return;
+        }
+        const result = current ? command.executeFor(current) : command.execute();
         if (result instanceof Promise) {
             result.catch((error) => {
                 reportError(command, error);

package/dist/elementOrPositionButtonView.js.map

@@ -1 +1 @@
-{"version":3,"file":"elementOrPositionButtonView.js","sourceRoot":"","sources":["../src/elementOrPositionButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAElE,OAAO,EAA0B,MAAM,+BAA+B,CAAC;AAkBvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,UAAU;IAClE;;OAEG;IACa,OAAO,CAA2B;IAElD;;OAEG;IACa,MAAM,CAAgC;IAEtD,YACC,MAA0B,EAC1B,OAAiC,EACjC,UAA8C,EAAE;QAEhD,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAE7B,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAClC,MAAkB,EAClB,OAAiC,EACjC,EAAE,QAAQ,GAAG,KAAK,EAAE,MAAM,KAAyC,EAAE;IAErE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE1D,IAAI,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACxB,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,GAAS,EAAE;YAC9B,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAErD,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;YAC7B,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC,CAAC;QAEF,WAAW,EAAE,CAAC;QACd,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,EAAE,WAAW,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,sGAAsG;QACtG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAEvE,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC/B,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACJ,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,OAAiC,EAAE,KAAc;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC;IACb,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACpG,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,0BAA0B,EAAE,OAAO,CAAC,KAAK,CAAC;QAC1D,SAAS,EAAE,gBAAgB;KAC3B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"elementOrPositionButtonView.js","sourceRoot":"","sources":["../src/elementOrPositionButtonView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAElE,OAAO,EAA0B,MAAM,+BAA+B,CAAC;AAyBvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,UAAU;IAClE;;OAEG;IACa,OAAO,CAA2B;IAElD;;OAEG;IACa,MAAM,CAAsC;IAE5D,YACC,MAA0B,EAC1B,OAAiC,EACjC,UAA8C,EAAE;QAEhD,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAE7B,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAClC,MAAkB,EAClB,OAAiC,EACjC,EAAE,QAAQ,GAAG,KAAK,EAAE,MAAM,KAAyC,EAAE;IAErE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE1D,IAAI,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACxB,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAA6B,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC;IAEzG,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,GAAS,EAAE;YAC9B,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;YAC5B,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAEpG,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;YAC7B,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC,CAAC;QAEF,WAAW,EAAE,CAAC;QACd,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,EAAE,WAAW,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,sGAAsG;QACtG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAE5B,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;QAE5B,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO;QACR,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAEzE,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC/B,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACJ,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,OAAiC,EAAE,KAAc;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC;IACb,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACpG,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,0BAA0B,EAAE,OAAO,CAAC,KAAK,CAAC;QAC1D,SAAS,EAAE,gBAAgB;KAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,18 +1,15 @@
 /**
- * The base of the element commands, their buttons and menus: `ElementOrPositionCommand` (a command for a position or
- * an element, with its title, icon and state for any target), `ElementCommand` (toggles an element), their button
- * views, and `ElementMenu` (menus of commands, submenus and separators, used by the context menu, the breadcrumbs and
- * quick insert).
+ * The base of the element commands and their buttons: `ElementOrPositionCommand` (a command for a position or an
+ * element, with its title, icon and state for any target), `ElementCommand` (toggles an element), and their button
+ * views. The menus of commands are in `ckeditor5-elements-menu`.
  *
  * @module ckeditor5-elements-core
  */
 import './singleCopyGuard.js';
-export { default as ElementMenu, type ElementMenuConfig, type ElementMenuItem, type ElementMenuShowOptions, type ElementSubmenu } from './elementMenu.js';
 export { default as ElementOrPositionCommand, type ElementOrPosition } from './elementOrPositionCommand.js';
 export { default as ElementCommand } from './elementCommand.js';
-export { default as ElementOrPositionButtonView, type ElementOrPositionButtonViewOptions } from './elementOrPositionButtonView.js';
+export { default as ElementOrPositionButtonView, bindButtonToCommand, type ElementOrPositionButtonViewOptions, type ElementOrPositionTarget } from './elementOrPositionButtonView.js';
 export { default as ElementButtonView } from './elementButtonView.js';
-export { default as ElementMenuView } from './elementMenuView.js';
-export { isInDocument } from './utils.js';
-import './augmentation.js';
+export { getElementAtSelection, isInDocument, isStandalone, selectNewElement } from './utils.js';
+export { findPlugin, getElementsAround, matchesElement, type ElementMatcher } from './matching.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EACN,OAAO,IAAI,WAAW,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EACN,OAAO,IAAI,2BAA2B,EACtC,KAAK,kCAAkC,EACvC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EACN,OAAO,IAAI,2BAA2B,EACtC,mBAAmB,EACnB,KAAK,kCAAkC,EACvC,KAAK,uBAAuB,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,22 +1,18 @@
 /**
- * The base of the element commands, their buttons and menus: `ElementOrPositionCommand` (a command for a position or
- * an element, with its title, icon and state for any target), `ElementCommand` (toggles an element), their button
- * views, and `ElementMenu` (menus of commands, submenus and separators, used by the context menu, the breadcrumbs and
- * quick insert).
+ * The base of the element commands and their buttons: `ElementOrPositionCommand` (a command for a position or an
+ * element, with its title, icon and state for any target), `ElementCommand` (toggles an element), and their button
+ * views. The menus of commands are in `ckeditor5-elements-menu`.
  *
  * @module ckeditor5-elements-core
  */
 import './singleCopyGuard.js';
-// Plugins.
-export { default as ElementMenu } from './elementMenu.js';
 // Commands.
 export { default as ElementOrPositionCommand } from './elementOrPositionCommand.js';
 export { default as ElementCommand } from './elementCommand.js';
 // Views.
-export { default as ElementOrPositionButtonView } from './elementOrPositionButtonView.js';
+export { default as ElementOrPositionButtonView, bindButtonToCommand } from './elementOrPositionButtonView.js';
 export { default as ElementButtonView } from './elementButtonView.js';
-export { default as ElementMenuView } from './elementMenuView.js';
 // Utils.
-export { isInDocument } from './utils.js';
-import './augmentation.js';
+export { getElementAtSelection, isInDocument, isStandalone, selectNewElement } from './utils.js';
+export { findPlugin, getElementsAround, matchesElement } from './matching.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,sBAAsB,CAAC;AAE9B,WAAW;AACX,OAAO,EACN,OAAO,IAAI,WAAW,EAKtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAA0B,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,SAAS;AACT,OAAO,EACN,OAAO,IAAI,2BAA2B,EAEtC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAElE,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAA0B,MAAM,+BAA+B,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,SAAS;AACT,OAAO,EACN,OAAO,IAAI,2BAA2B,EACtC,mBAAmB,EAGnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,SAAS;AACT,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC"}

package/dist/matching.d.ts

@@ -0,0 +1,24 @@
+import type { Editor, Mapper, ModelElement, ViewElement } from 'ckeditor5';
+/**
+ * Matches model elements: the name of a model element (e.g. `'imageBlock'`), or a function that returns whether it is for
+ * the given element (e.g. `element => element.hasAttribute('linkHref')`).
+ */
+export type ElementMatcher = string | ((element: ModelElement) => boolean);
+/**
+ * Returns whether the matcher is for the element.
+ */
+export declare function matchesElement(matcher: ElementMatcher, element: ModelElement): boolean;
+/**
+ * Returns the model elements of a view element and its ancestors, the innermost first, with their view elements. The view
+ * elements that are not converted from model elements, and roots, are skipped.
+ */
+export declare function getElementsAround(mapper: Mapper, viewElement: ViewElement): Generator<{
+    element: ModelElement;
+    viewElement: ViewElement;
+}>;
+/**
+ * Returns the plugin of the name when it is loaded and fits the guard, `null` otherwise. The features use it to work with
+ * another feature without depending on it: they look the plugin up by name, and check it against the interface they use.
+ */
+export declare function findPlugin<T extends object>(editor: Editor, name: string, isPlugin: (plugin: object) => plugin is T): T | null;
+//# sourceMappingURL=matching.d.ts.map

package/dist/matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.d.ts","sourceRoot":"","sources":["../src/matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC;AAE3E;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAEtF;AAED;;;GAGG;AACH,wBAAiB,iBAAiB,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACtB,SAAS,CAAC;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,CAQhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC,GACvC,CAAC,GAAG,IAAI,CAIV"}

package/dist/matching.js

@@ -0,0 +1,27 @@
+/**
+ * Returns whether the matcher is for the element.
+ */
+export function matchesElement(matcher, element) {
+    return typeof matcher === 'string' ? element.name === matcher : matcher(element);
+}
+/**
+ * Returns the model elements of a view element and its ancestors, the innermost first, with their view elements. The view
+ * elements that are not converted from model elements, and roots, are skipped.
+ */
+export function* getElementsAround(mapper, viewElement) {
+    for (let node = viewElement; node; node = node.parent?.is('element') ? node.parent : null) {
+        const element = mapper.toModelElement(node);
+        if (element && !element.is('rootElement')) {
+            yield { element, viewElement: node };
+        }
+    }
+}
+/**
+ * Returns the plugin of the name when it is loaded and fits the guard, `null` otherwise. The features use it to work with
+ * another feature without depending on it: they look the plugin up by name, and check it against the interface they use.
+ */
+export function findPlugin(editor, name, isPlugin) {
+    const plugin = editor.plugins.has(name) ? editor.plugins.get(name) : null;
+    return typeof plugin === 'object' && plugin !== null && isPlugin(plugin) ? plugin : null;
+}
+//# sourceMappingURL=matching.js.map

package/dist/matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.js","sourceRoot":"","sources":["../src/matching.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB,EAAE,OAAqB;IAC5E,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,SAAS,CAAC,CAAC,iBAAiB,CACjC,MAAc,EACd,WAAwB;IAExB,KAAK,IAAI,IAAI,GAAuB,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/G,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3C,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACzB,MAAc,EACd,IAAY,EACZ,QAAyC;IAEzC,MAAM,MAAM,GAAY,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnF,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC"}

package/dist/singleCopyGuard.js

@@ -1,7 +1,7 @@
 /**
  * Fails when this package is loaded twice, e.g. because two versions of it are installed: `ckeditor5-elements` of one
- * version, and a feature package of another. Two copies would register two different `ElementMenu` plugins (which
- * CKEditor refuses), and the commands of one copy would not be menu items for the other.
+ * version, and a feature package of another. Two copies would have two different `ElementOrPositionCommand` classes,
+ * and the commands of one copy would not be menu items for the menus of the other, which recognize them by class.
  *
  * It is the counterpart of CKEditor's `ckeditor-duplicated-modules` error. Like CKEditor's packages, this package
  * declares no `sideEffects` in its `package.json`, so bundlers keep this module, which exports nothing.

package/dist/utils.d.ts

@@ -1,7 +1,23 @@
-import type { ModelElement, ModelPosition } from 'ckeditor5';
+import type { ModelDocumentSelection, ModelElement, ModelPosition, ModelSchema, ModelSelection, ModelWriter } from 'ckeditor5';
 /**
  * Whether the element (or position) is in the document. Unlike `element.isAttached()`, removed elements (moved to
  * the graveyard root) do not count, and neither do the elements of detached roots.
  */
 export declare function isInDocument(elementOrPosition: ModelElement | ModelPosition): boolean;
+/**
+ * Returns the element at the selection: the selected element (e.g. an image), or the element with the cursor, i.e. the
+ * parent of the start of the selection. Never a root: `null` when the selection is directly in one.
+ */
+export declare function getElementAtSelection(selection: ModelSelection | ModelDocumentSelection): ModelElement | null;
+/**
+ * Whether the element can be handled as a whole: copied, moved, duplicated or removed. Parts of a structure that cannot
+ * stand alone, such as a table cell, a table row or a caption, cannot: in the schema, they are limit elements that are
+ * not objects.
+ */
+export declare function isStandalone(schema: ModelSchema, element: ModelElement): boolean;
+/**
+ * Puts the selection in a newly inserted element, so that the user can go on: an object is selected; an element that
+ * holds text gets the cursor inside it; an element that holds blocks gets an empty paragraph with the cursor.
+ */
+export declare function selectNewElement(writer: ModelWriter, element: ModelElement): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,iBAAiB,EAAE,YAAY,GAAG,aAAa,GAAG,OAAO,CAIrF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,iBAAiB,EAAE,YAAY,GAAG,aAAa,GAAG,OAAO,CAIrF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,sBAAsB,GAAG,YAAY,GAAG,IAAI,CAI7G;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAEhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAgBjF"}

package/dist/utils.js

@@ -6,4 +6,42 @@ export function isInDocument(elementOrPosition) {
     const root = elementOrPosition.root;
     return root.is('rootElement') && root.rootName !== '$graveyard' && root.isAttached();
 }
+/**
+ * Returns the element at the selection: the selected element (e.g. an image), or the element with the cursor, i.e. the
+ * parent of the start of the selection. Never a root: `null` when the selection is directly in one.
+ */
+export function getElementAtSelection(selection) {
+    const element = selection.getSelectedElement() ?? selection.getFirstPosition()?.parent;
+    return element?.is('element') && !element.is('rootElement') ? element : null;
+}
+/**
+ * Whether the element can be handled as a whole: copied, moved, duplicated or removed. Parts of a structure that cannot
+ * stand alone, such as a table cell, a table row or a caption, cannot: in the schema, they are limit elements that are
+ * not objects.
+ */
+export function isStandalone(schema, element) {
+    return !schema.isLimit(element) || schema.isObject(element);
+}
+/**
+ * Puts the selection in a newly inserted element, so that the user can go on: an object is selected; an element that
+ * holds text gets the cursor inside it; an element that holds blocks gets an empty paragraph with the cursor.
+ */
+export function selectNewElement(writer, element) {
+    const schema = writer.model.schema;
+    if (schema.isObject(element)) {
+        writer.setSelection(element, 'on');
+    }
+    else if (schema.checkChild(element, '$text')) {
+        writer.setSelection(element, 0);
+    }
+    else if (schema.checkChild(element, 'paragraph')) {
+        const paragraph = writer.createElement('paragraph');
+        writer.append(paragraph, element);
+        writer.setSelection(paragraph, 0);
+    }
+    else {
+        // Only objects can be selected as a whole. The selection post-fixer moves it to the closest valid place.
+        writer.setSelection(element, 'after');
+    }
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,iBAA+C;IAC3E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IAEpC,OAAO,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;AACtF,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,iBAA+C;IAC3E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IAEpC,OAAO,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAkD;IACvF,MAAM,OAAO,GAAG,SAAS,CAAC,kBAAkB,EAAE,IAAI,SAAS,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC;IAEvF,OAAO,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,OAAqB;IACtE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,OAAqB;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IAEnC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACP,yGAAyG;QACzG,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ckeditor5-elements-core",
-  "version": "49.0.0-alpha.0",
+  "version": "49.0.0-alpha.4",
   "description": "The base of the element commands, buttons and menus for CKEditor 5: ElementOrPositionCommand, ElementCommand, their button views, and ElementMenu.",
   "keywords": [
     "ckeditor",
@@ -28,17 +28,15 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./index.css": "./theme/elementMenu.css",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "src",
-    "theme",
     "README.md"
   ],
   "peerDependencies": {
-    "ckeditor5": ">=49.0.0"
+    "ckeditor5": "^49.0.0"
   },
   "scripts": {
     "build": "tsc --build"

package/src/elementOrPositionButtonView.ts

@@ -12,12 +12,19 @@ export interface ElementOrPositionButtonViewOptions {
 	withText?: boolean;
 
 	/**
-	 * The position or element the button acts on. Without it, the button follows the command state for the selection
-	 * and executes the command for the selection.
+	 * The position or element the button acts on, or a function that returns it, e.g. the element of a floating
+	 * toolbar, which changes as the selection moves. The function is called whenever the button updates or is clicked;
+	 * when it returns `null`, the button is disabled. Without a target, the button follows the command state for the
+	 * selection and executes the command for the selection.
 	 */
-	target?: ElementOrPosition;
+	target?: ElementOrPositionTarget;
 }
 
+/**
+ * The target of a button: a position or an element, or a function that returns one (or `null`).
+ */
+export type ElementOrPositionTarget = ElementOrPosition | (() => ElementOrPosition | null);
+
 /**
  * A button that reflects an {@link ElementOrPositionCommand} and executes it when clicked.
  *
@@ -38,7 +45,7 @@ export default class ElementOrPositionButtonView extends ButtonView {
 	/**
 	 * The position or element the button acts on, if any.
 	 */
-	public readonly target: ElementOrPosition | undefined;
+	public readonly target: ElementOrPositionTarget | undefined;
 
 	constructor(
 		locale: Locale | undefined,
@@ -74,9 +81,12 @@ export function bindButtonToCommand(
 		button.bind('tooltip').to(command, 'tooltip');
 	}
 
+	const getTarget = typeof target === 'function' ? target : (): ElementOrPosition | null => target ?? null;
+
 	if (target) {
 		const updateState = (): void => {
-			const { isEnabled, isOn } = command.getState(target);
+			const current = getTarget();
+			const { isEnabled, isOn } = current ? command.getState(current) : { isEnabled: false, isOn: false };
 
 			button.isEnabled = isEnabled;
 			button.isOn = isOn;
@@ -94,7 +104,13 @@ export function bindButtonToCommand(
 		// Focus first: focusing reads the DOM selection, which would override a selection set by the command.
 		editor.editing.view.focus();
 
-		const result = target ? command.executeFor(target) : command.execute();
+		const current = getTarget();
+
+		if (target && !current) {
+			return;
+		}
+
+		const result = current ? command.executeFor(current) : command.execute();
 
 		if (result instanceof Promise) {
 			result.catch((error: unknown) => {

package/src/index.ts

@@ -1,23 +1,13 @@
 /**
- * The base of the element commands, their buttons and menus: `ElementOrPositionCommand` (a command for a position or
- * an element, with its title, icon and state for any target), `ElementCommand` (toggles an element), their button
- * views, and `ElementMenu` (menus of commands, submenus and separators, used by the context menu, the breadcrumbs and
- * quick insert).
+ * The base of the element commands and their buttons: `ElementOrPositionCommand` (a command for a position or an
+ * element, with its title, icon and state for any target), `ElementCommand` (toggles an element), and their button
+ * views. The menus of commands are in `ckeditor5-elements-menu`.
  *
  * @module ckeditor5-elements-core
  */
 
 import './singleCopyGuard.js';
 
-// Plugins.
-export {
-	default as ElementMenu,
-	type ElementMenuConfig,
-	type ElementMenuItem,
-	type ElementMenuShowOptions,
-	type ElementSubmenu
-} from './elementMenu.js';
-
 // Commands.
 export { default as ElementOrPositionCommand, type ElementOrPosition } from './elementOrPositionCommand.js';
 export { default as ElementCommand } from './elementCommand.js';
@@ -25,12 +15,12 @@ export { default as ElementCommand } from './elementCommand.js';
 // Views.
 export {
 	default as ElementOrPositionButtonView,
-	type ElementOrPositionButtonViewOptions
+	bindButtonToCommand,
+	type ElementOrPositionButtonViewOptions,
+	type ElementOrPositionTarget
 } from './elementOrPositionButtonView.js';
 export { default as ElementButtonView } from './elementButtonView.js';
-export { default as ElementMenuView } from './elementMenuView.js';
 
 // Utils.
-export { isInDocument } from './utils.js';
-
-import './augmentation.js';
+export { getElementAtSelection, isInDocument, isStandalone, selectNewElement } from './utils.js';
+export { findPlugin, getElementsAround, matchesElement, type ElementMatcher } from './matching.js';

package/src/matching.ts

@@ -0,0 +1,45 @@
+import type { Editor, Mapper, ModelElement, ViewElement } from 'ckeditor5';
+
+/**
+ * Matches model elements: the name of a model element (e.g. `'imageBlock'`), or a function that returns whether it is for
+ * the given element (e.g. `element => element.hasAttribute('linkHref')`).
+ */
+export type ElementMatcher = string | ((element: ModelElement) => boolean);
+
+/**
+ * Returns whether the matcher is for the element.
+ */
+export function matchesElement(matcher: ElementMatcher, element: ModelElement): boolean {
+	return typeof matcher === 'string' ? element.name === matcher : matcher(element);
+}
+
+/**
+ * Returns the model elements of a view element and its ancestors, the innermost first, with their view elements. The view
+ * elements that are not converted from model elements, and roots, are skipped.
+ */
+export function* getElementsAround(
+	mapper: Mapper,
+	viewElement: ViewElement
+): Generator<{ element: ModelElement; viewElement: ViewElement }> {
+	for (let node: ViewElement | null = viewElement; node; node = node.parent?.is('element') ? node.parent : null) {
+		const element = mapper.toModelElement(node);
+
+		if (element && !element.is('rootElement')) {
+			yield { element, viewElement: node };
+		}
+	}
+}
+
+/**
+ * Returns the plugin of the name when it is loaded and fits the guard, `null` otherwise. The features use it to work with
+ * another feature without depending on it: they look the plugin up by name, and check it against the interface they use.
+ */
+export function findPlugin<T extends object>(
+	editor: Editor,
+	name: string,
+	isPlugin: (plugin: object) => plugin is T
+): T | null {
+	const plugin: unknown = editor.plugins.has(name) ? editor.plugins.get(name) : null;
+
+	return typeof plugin === 'object' && plugin !== null && isPlugin(plugin) ? plugin : null;
+}

package/src/singleCopyGuard.ts

@@ -1,7 +1,7 @@
 /**
  * Fails when this package is loaded twice, e.g. because two versions of it are installed: `ckeditor5-elements` of one
- * version, and a feature package of another. Two copies would register two different `ElementMenu` plugins (which
- * CKEditor refuses), and the commands of one copy would not be menu items for the other.
+ * version, and a feature package of another. Two copies would have two different `ElementOrPositionCommand` classes,
+ * and the commands of one copy would not be menu items for the menus of the other, which recognize them by class.
  *
  * It is the counterpart of CKEditor's `ckeditor-duplicated-modules` error. Like CKEditor's packages, this package
  * declares no `sideEffects` in its `package.json`, so bundlers keep this module, which exports nothing.

package/src/utils.ts

@@ -1,4 +1,11 @@
-import type { ModelElement, ModelPosition } from 'ckeditor5';
+import type {
+	ModelDocumentSelection,
+	ModelElement,
+	ModelPosition,
+	ModelSchema,
+	ModelSelection,
+	ModelWriter
+} from 'ckeditor5';
 
 /**
  * Whether the element (or position) is in the document. Unlike `element.isAttached()`, removed elements (moved to
@@ -9,3 +16,44 @@ export function isInDocument(elementOrPosition: ModelElement | ModelPosition): b
 
 	return root.is('rootElement') && root.rootName !== '$graveyard' && root.isAttached();
 }
+
+/**
+ * Returns the element at the selection: the selected element (e.g. an image), or the element with the cursor, i.e. the
+ * parent of the start of the selection. Never a root: `null` when the selection is directly in one.
+ */
+export function getElementAtSelection(selection: ModelSelection | ModelDocumentSelection): ModelElement | null {
+	const element = selection.getSelectedElement() ?? selection.getFirstPosition()?.parent;
+
+	return element?.is('element') && !element.is('rootElement') ? element : null;
+}
+
+/**
+ * Whether the element can be handled as a whole: copied, moved, duplicated or removed. Parts of a structure that cannot
+ * stand alone, such as a table cell, a table row or a caption, cannot: in the schema, they are limit elements that are
+ * not objects.
+ */
+export function isStandalone(schema: ModelSchema, element: ModelElement): boolean {
+	return !schema.isLimit(element) || schema.isObject(element);
+}
+
+/**
+ * Puts the selection in a newly inserted element, so that the user can go on: an object is selected; an element that
+ * holds text gets the cursor inside it; an element that holds blocks gets an empty paragraph with the cursor.
+ */
+export function selectNewElement(writer: ModelWriter, element: ModelElement): void {
+	const schema = writer.model.schema;
+
+	if (schema.isObject(element)) {
+		writer.setSelection(element, 'on');
+	} else if (schema.checkChild(element, '$text')) {
+		writer.setSelection(element, 0);
+	} else if (schema.checkChild(element, 'paragraph')) {
+		const paragraph = writer.createElement('paragraph');
+
+		writer.append(paragraph, element);
+		writer.setSelection(paragraph, 0);
+	} else {
+		// Only objects can be selected as a whole. The selection post-fixer moves it to the closest valid place.
+		writer.setSelection(element, 'after');
+	}
+}

package/dist/augmentation.d.ts

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

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

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

package/dist/augmentation.js.map

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