ckeditor5-elements-actions 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,36 @@
-# Temporary Holding Version
+# ckeditor5-elements-actions
 
-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.
+Element actions for CKEditor 5 Elements: `ElementActions` registers `moveElementUp`, `moveElementDown`,
+`duplicateElement` and `deleteElement`, which move an element within its parent, insert an empty copy of it after it, or
+delete it.
+
+## Installation
+
+This package is part of `ckeditor5-elements`. Install the whole package to use it:
+
+```sh
+npm install ckeditor5 ckeditor5-elements
+```
+
+## Usage
+
+```ts
+import { ElementActions, ElementContextMenu } from 'ckeditor5-elements';
+import 'ckeditor5-elements/index.css';
+
+// In the editor config:
+plugins: [..., ElementActions, ElementContextMenu],
+elementContextMenu: (element, editor) => [
+	editor.commands.get('moveElementUp'),
+	editor.commands.get('moveElementDown'),
+	'|',
+	editor.commands.get('duplicateElement'),
+	editor.commands.get('deleteElement')
+]
+```
+
+See the [Actions guide](https://ivankild.github.io/ckeditor5-elements/guide/actions) of the documentation.
+
+## License
+
+MIT

package/dist/augmentation.d.ts

@@ -0,0 +1,13 @@
+import type { ElementActions, ElementDeleteCommand, ElementDuplicateCommand, ElementMoveCommand } from './index.js';
+declare module 'ckeditor5' {
+    interface PluginsMap {
+        [ElementActions.pluginName]: ElementActions;
+    }
+    interface CommandsMap {
+        moveElementUp: ElementMoveCommand;
+        moveElementDown: ElementMoveCommand;
+        duplicateElement: ElementDuplicateCommand;
+        deleteElement: ElementDeleteCommand;
+    }
+}
+//# 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,cAAc,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpH,OAAO,QAAQ,WAAW,CAAC;IAC1B,UAAU,UAAU;QACnB,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;KAC5C;IAED,UAAU,WAAW;QACpB,aAAa,EAAE,kBAAkB,CAAC;QAClC,eAAe,EAAE,kBAAkB,CAAC;QACpC,gBAAgB,EAAE,uBAAuB,CAAC;QAC1C,aAAa,EAAE,oBAAoB,CAAC;KACpC;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/elementActions.d.ts

@@ -0,0 +1,18 @@
+import { Plugin } from 'ckeditor5';
+/**
+ * Registers commands that act on an element: `moveElementUp`, `moveElementDown`, `duplicateElement` and
+ * `deleteElement`.
+ *
+ * ```ts
+ * editor.execute('duplicateElement'); // The element at the selection.
+ * editor.commands.get('moveElementUp').executeFor(element); // The given element.
+ * ```
+ *
+ * The commands have titles and icons, so they can be menu items (e.g. in the `elementContextMenu` config of
+ * `ElementContextMenu`) and buttons.
+ */
+export default class ElementActions extends Plugin {
+    static get pluginName(): 'ElementActions';
+    init(): void;
+}
+//# sourceMappingURL=elementActions.d.ts.map

package/dist/elementActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementActions.d.ts","sourceRoot":"","sources":["../src/elementActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKnC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,MAAM;IACjD,WAAkB,UAAU,IAAI,gBAAgB,CAE/C;IAEM,IAAI,IAAI,IAAI;CAQnB"}

package/dist/elementActions.js

@@ -0,0 +1,29 @@
+import { Plugin } from 'ckeditor5';
+import ElementDeleteCommand from './elementDeleteCommand.js';
+import ElementDuplicateCommand from './elementDuplicateCommand.js';
+import ElementMoveCommand from './elementMoveCommand.js';
+/**
+ * Registers commands that act on an element: `moveElementUp`, `moveElementDown`, `duplicateElement` and
+ * `deleteElement`.
+ *
+ * ```ts
+ * editor.execute('duplicateElement'); // The element at the selection.
+ * editor.commands.get('moveElementUp').executeFor(element); // The given element.
+ * ```
+ *
+ * The commands have titles and icons, so they can be menu items (e.g. in the `elementContextMenu` config of
+ * `ElementContextMenu`) and buttons.
+ */
+export default class ElementActions extends Plugin {
+    static get pluginName() {
+        return 'ElementActions';
+    }
+    init() {
+        const editor = this.editor;
+        editor.commands.add('moveElementUp', new ElementMoveCommand(editor, 'up'));
+        editor.commands.add('moveElementDown', new ElementMoveCommand(editor, 'down'));
+        editor.commands.add('duplicateElement', new ElementDuplicateCommand(editor));
+        editor.commands.add('deleteElement', new ElementDeleteCommand(editor));
+    }
+}
+//# sourceMappingURL=elementActions.js.map

package/dist/elementActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementActions.js","sourceRoot":"","sources":["../src/elementActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,oBAAoB,MAAM,2BAA2B,CAAC;AAC7D,OAAO,uBAAuB,MAAM,8BAA8B,CAAC;AACnE,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,MAAM;IAC1C,MAAM,KAAK,UAAU;QAC3B,OAAO,gBAAyB,CAAC;IAClC,CAAC;IAEM,IAAI;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;CACD"}

package/dist/elementDeleteCommand.d.ts

@@ -0,0 +1,19 @@
+import { type Editor } from 'ckeditor5';
+import { ElementOrPositionCommand, type ElementOrPosition } from 'ckeditor5-elements-core';
+/**
+ * Deletes an element. When it was the only element in its parent, e.g. in a note, the parent gets an empty paragraph
+ * with the selection, so that it can still be written in.
+ *
+ * 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}). The command is disabled for parts of a structure, such as table
+ * cells.
+ */
+export default class ElementDeleteCommand extends ElementOrPositionCommand {
+    constructor(editor: Editor);
+    /**
+     * Deletes the element.
+     */
+    execute(elementOrPosition?: ElementOrPosition): void;
+    protected _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean;
+}
+//# sourceMappingURL=elementDeleteCommand.d.ts.map

package/dist/elementDeleteCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementDeleteCommand.d.ts","sourceRoot":"","sources":["../src/elementDeleteCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAgB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGzG;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,wBAAwB;gBAC7D,MAAM,EAAE,MAAM;IAO1B;;OAEG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;cA4BjD,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;CAMhF"}

package/dist/elementDeleteCommand.js

@@ -0,0 +1,47 @@
+import {} from 'ckeditor5';
+import { ElementOrPositionCommand, isStandalone } from 'ckeditor5-elements-core';
+import { deleteIcon } from './icons.js';
+/**
+ * Deletes an element. When it was the only element in its parent, e.g. in a note, the parent gets an empty paragraph
+ * with the selection, so that it can still be written in.
+ *
+ * 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}). The command is disabled for parts of a structure, such as table
+ * cells.
+ */
+export default class ElementDeleteCommand extends ElementOrPositionCommand {
+    constructor(editor) {
+        super(editor);
+        this.title = editor.t('Delete');
+        this.icon = deleteIcon;
+    }
+    /**
+     * Deletes the element.
+     */
+    execute(elementOrPosition) {
+        const model = this.editor.model;
+        const element = this._getElement(elementOrPosition);
+        if (!element || !this._isEnabledFor(element)) {
+            return;
+        }
+        model.change(writer => {
+            const parent = element.parent;
+            writer.remove(element);
+            // The root gets a paragraph from the editor itself.
+            if (parent?.is('element') &&
+                !parent.is('rootElement') &&
+                parent.isEmpty &&
+                model.schema.checkChild(parent, 'paragraph')) {
+                const paragraph = writer.createElement('paragraph');
+                writer.append(paragraph, parent);
+                writer.setSelection(paragraph, 0);
+            }
+        });
+    }
+    _isEnabledFor(elementOrPosition) {
+        const model = this.editor.model;
+        const element = this._getElement(elementOrPosition);
+        return !!element && isStandalone(model.schema, element) && model.canEditAt(element);
+    }
+}
+//# sourceMappingURL=elementDeleteCommand.js.map

package/dist/elementDeleteCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementDeleteCommand.js","sourceRoot":"","sources":["../src/elementDeleteCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAA0B,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,wBAAwB;IACzE,YAAY,MAAc;QACzB,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACxB,CAAC;IAED;;OAEG;IACa,OAAO,CAAC,iBAAqC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,OAAO;QACR,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAE9B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEvB,oDAAoD;YACpD,IACC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;gBACrB,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC;gBACzB,MAAM,CAAC,OAAO;gBACd,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,EAC3C,CAAC;gBACF,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;gBAEpD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACnC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAEkB,aAAa,CAAC,iBAAqC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAEpD,OAAO,CAAC,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrF,CAAC;CACD"}

package/dist/elementDuplicateCommand.d.ts

@@ -0,0 +1,22 @@
+import { type Editor } from 'ckeditor5';
+import { ElementOrPositionCommand, type ElementOrPosition } from 'ckeditor5-elements-core';
+/**
+ * Duplicates an element: inserts the same element, empty, after it, and puts the selection in it: in the copy of an
+ * element that holds text, or in a new paragraph in the copy of an element that holds blocks.
+ *
+ * The copy has the same name and attributes. A list item gets a new list item id, so it is a new list item, not a second
+ * block of the same one. Objects, e.g. an image or a table, are copied with their content, as they cannot be empty.
+ *
+ * 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}). The command is disabled for parts of a structure, such as table
+ * cells.
+ */
+export default class ElementDuplicateCommand extends ElementOrPositionCommand {
+    constructor(editor: Editor);
+    /**
+     * Inserts the copy of the element after it.
+     */
+    execute(elementOrPosition?: ElementOrPosition): void;
+    protected _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean;
+}
+//# sourceMappingURL=elementDuplicateCommand.d.ts.map

package/dist/elementDuplicateCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementDuplicateCommand.d.ts","sourceRoot":"","sources":["../src/elementDuplicateCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EACN,wBAAwB,EAGxB,KAAK,iBAAiB,EACtB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,wBAAwB;gBAChE,MAAM,EAAE,MAAM;IAO1B;;OAEG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;cAoBjD,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;CAYhF"}

package/dist/elementDuplicateCommand.js

@@ -0,0 +1,49 @@
+import { uid } from 'ckeditor5';
+import { ElementOrPositionCommand, isStandalone, selectNewElement } from 'ckeditor5-elements-core';
+import { duplicateIcon } from './icons.js';
+/**
+ * Duplicates an element: inserts the same element, empty, after it, and puts the selection in it: in the copy of an
+ * element that holds text, or in a new paragraph in the copy of an element that holds blocks.
+ *
+ * The copy has the same name and attributes. A list item gets a new list item id, so it is a new list item, not a second
+ * block of the same one. Objects, e.g. an image or a table, are copied with their content, as they cannot be empty.
+ *
+ * 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}). The command is disabled for parts of a structure, such as table
+ * cells.
+ */
+export default class ElementDuplicateCommand extends ElementOrPositionCommand {
+    constructor(editor) {
+        super(editor);
+        this.title = editor.t('Duplicate');
+        this.icon = duplicateIcon;
+    }
+    /**
+     * Inserts the copy of the element after it.
+     */
+    execute(elementOrPosition) {
+        const model = this.editor.model;
+        const element = this._getElement(elementOrPosition);
+        if (!element || !this._isEnabledFor(element)) {
+            return;
+        }
+        model.change(writer => {
+            const copy = writer.cloneElement(element, model.schema.isObject(element));
+            if (copy.hasAttribute('listItemId')) {
+                writer.setAttribute('listItemId', uid(), copy);
+            }
+            writer.insert(copy, writer.createPositionAfter(element));
+            selectNewElement(writer, copy);
+        });
+    }
+    _isEnabledFor(elementOrPosition) {
+        const model = this.editor.model;
+        const element = this._getElement(elementOrPosition);
+        if (!element || !isStandalone(model.schema, element)) {
+            return false;
+        }
+        const position = model.createPositionAfter(element);
+        return model.canEditAt(position) && model.schema.checkChild(position, element);
+    }
+}
+//# sourceMappingURL=elementDuplicateCommand.js.map

package/dist/elementDuplicateCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementDuplicateCommand.js","sourceRoot":"","sources":["../src/elementDuplicateCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAe,MAAM,WAAW,CAAC;AAC7C,OAAO,EACN,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAEhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,wBAAwB;IAC5E,YAAY,MAAc;QACzB,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;IAED;;OAEG;IACa,OAAO,CAAC,iBAAqC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,OAAO;QACR,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAE1E,IAAI,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;YAED,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;YACzD,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACJ,CAAC;IAEkB,aAAa,CAAC,iBAAqC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAEpD,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEpD,OAAO,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACD"}

package/dist/elementMoveCommand.d.ts

@@ -0,0 +1,32 @@
+import { type Editor } from 'ckeditor5';
+import { ElementOrPositionCommand, type ElementOrPosition } from 'ckeditor5-elements-core';
+/**
+ * Where the element moves.
+ */
+export type ElementMoveDirection = 'up' | 'down';
+/**
+ * Moves an element up or down: swaps it with the element before or after it, in the same parent. The selection stays
+ * in the 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}). The command is disabled when there is no element before it (up) or
+ * after it (down), e.g. for the first element of a note, and for parts of a structure, such as table cells.
+ */
+export default class ElementMoveCommand extends ElementOrPositionCommand {
+    /**
+     * Where the element moves.
+     */
+    readonly direction: ElementMoveDirection;
+    constructor(editor: Editor, direction: ElementMoveDirection);
+    /**
+     * Moves the element up or down.
+     */
+    execute(elementOrPosition?: ElementOrPosition): void;
+    protected _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean;
+    /**
+     * Returns the element the element swaps with: the one before it (up) or after it (down), if it is an element.
+     */
+    private _getSibling;
+    private _canMove;
+}
+//# sourceMappingURL=elementMoveCommand.d.ts.map

package/dist/elementMoveCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementMoveCommand.d.ts","sourceRoot":"","sources":["../src/elementMoveCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAgB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGzG;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,MAAM,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;IACvE;;OAEG;IACH,SAAgB,SAAS,EAAE,oBAAoB,CAAC;gBAEpC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB;IAQ3D;;OAEG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;cAkBjD,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAOhF;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,QAAQ;CAKhB"}

package/dist/elementMoveCommand.js

@@ -0,0 +1,59 @@
+import {} from 'ckeditor5';
+import { ElementOrPositionCommand, isStandalone } from 'ckeditor5-elements-core';
+import { moveDownIcon, moveUpIcon } from './icons.js';
+/**
+ * Moves an element up or down: swaps it with the element before or after it, in the same parent. The selection stays
+ * in the 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}). The command is disabled when there is no element before it (up) or
+ * after it (down), e.g. for the first element of a note, and for parts of a structure, such as table cells.
+ */
+export default class ElementMoveCommand extends ElementOrPositionCommand {
+    /**
+     * Where the element moves.
+     */
+    direction;
+    constructor(editor, direction) {
+        super(editor);
+        this.direction = direction;
+        this.title = direction === 'up' ? editor.t('Move up') : editor.t('Move down');
+        this.icon = direction === 'up' ? moveUpIcon : moveDownIcon;
+    }
+    /**
+     * Moves the element up or down.
+     */
+    execute(elementOrPosition) {
+        const element = this._getElement(elementOrPosition);
+        const sibling = element && this._getSibling(element);
+        if (!element || !sibling || !this._canMove(element, sibling)) {
+            return;
+        }
+        this.editor.model.change(writer => {
+            // Either way, the selection stays in the element: it moves with the element, or the sibling moves past it.
+            if (this.direction === 'up') {
+                writer.move(writer.createRangeOn(element), writer.createPositionBefore(sibling));
+            }
+            else {
+                writer.move(writer.createRangeOn(sibling), writer.createPositionBefore(element));
+            }
+        });
+    }
+    _isEnabledFor(elementOrPosition) {
+        const element = this._getElement(elementOrPosition);
+        const sibling = element && this._getSibling(element);
+        return !!element && !!sibling && this._canMove(element, sibling);
+    }
+    /**
+     * Returns the element the element swaps with: the one before it (up) or after it (down), if it is an element.
+     */
+    _getSibling(element) {
+        const sibling = this.direction === 'up' ? element.previousSibling : element.nextSibling;
+        return sibling?.is('element') ? sibling : null;
+    }
+    _canMove(element, sibling) {
+        const model = this.editor.model;
+        return isStandalone(model.schema, element) && model.canEditAt(element) && model.canEditAt(sibling);
+    }
+}
+//# sourceMappingURL=elementMoveCommand.js.map

package/dist/elementMoveCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementMoveCommand.js","sourceRoot":"","sources":["../src/elementMoveCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAA0B,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAOtD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;IACvE;;OAEG;IACa,SAAS,CAAuB;IAEhD,YAAY,MAAc,EAAE,SAA+B;QAC1D,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;IAC5D,CAAC;IAED;;OAEG;IACa,OAAO,CAAC,iBAAqC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YAC9D,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACjC,2GAA2G;YAC3G,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;YAClF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAEkB,aAAa,CAAC,iBAAqC;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAErD,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,OAAqB;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAExF,OAAO,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IAEO,QAAQ,CAAC,OAAqB,EAAE,OAAqB;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAEhC,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpG,CAAC;CACD"}

package/dist/icons.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The icons of the element actions, in the style of the CKEditor 5 icons (20×20).
+ */
+/**
+ * Move up: an arrow up, above a block.
+ */
+export declare const moveUpIcon: string;
+/**
+ * Move down: a block, above an arrow down.
+ */
+export declare const moveDownIcon: string;
+/**
+ * Duplicate: a block, above a new block.
+ */
+export declare const duplicateIcon: string;
+/**
+ * Delete: CKEditor's own remove icon.
+ */
+export declare const deleteIcon: string;
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,QAGkC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,YAAY,QAGyC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,aAAa,QAIJ,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,UAAU,QAAa,CAAC"}

package/dist/icons.js

@@ -0,0 +1,28 @@
+import { IconRemove } from 'ckeditor5';
+/**
+ * The icons of the element actions, in the style of the CKEditor 5 icons (20×20).
+ */
+/**
+ * Move up: an arrow up, above a block.
+ */
+export const moveUpIcon = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+    'M10 1.5l3.75 3.75-1.05 1.05-1.95-1.95V8.5h-1.5V4.35L7.3 6.3 6.25 5.25zM3.5 11h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 ' +
+    '1 0 0 1-1-1v-5a1 1 0 0 1 1-1zm.5 1.5v4h12v-4z"/></svg>';
+/**
+ * Move down: a block, above an arrow down.
+ */
+export const moveDownIcon = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+    'M3.5 2h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM10 18.5l-3.75-3.75 ' +
+    '1.05-1.05 1.95 1.95V11.5h1.5v4.15l1.95-1.95 1.05 1.05z"/></svg>';
+/**
+ * Duplicate: a block, above a new block.
+ */
+export const duplicateIcon = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+    'M3.5 2h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM3.5 11h13a1 1 0 0 1 1 ' +
+    '1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1v-5a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM9.25 13h1.5v.75h.75v1.5h-.75V16h-1.5v-.75H8.5' +
+    'v-1.5h.75z"/></svg>';
+/**
+ * Delete: CKEditor's own remove icon.
+ */
+export const deleteIcon = IconRemove;
+//# sourceMappingURL=icons.js.map

package/dist/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GACtB,2FAA2F;IAC3F,uHAAuH;IACvH,wDAAwD,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GACxB,2FAA2F;IAC3F,gHAAgH;IAChH,iEAAiE,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GACzB,2FAA2F;IAC3F,mHAAmH;IACnH,qHAAqH;IACrH,qBAAqB,CAAC;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Element actions: move an element up or down, duplicate it, or delete it.
+ *
+ * @module ckeditor5-elements-actions
+ */
+export { default as ElementActions } from './elementActions.js';
+export { default as ElementMoveCommand, type ElementMoveDirection } from './elementMoveCommand.js';
+export { default as ElementDuplicateCommand } from './elementDuplicateCommand.js';
+export { default as ElementDeleteCommand } from './elementDeleteCommand.js';
+export { deleteIcon, duplicateIcon, moveDownIcon, moveUpIcon } from './icons.js';
+import './augmentation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAG5E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * Element actions: move an element up or down, duplicate it, or delete it.
+ *
+ * @module ckeditor5-elements-actions
+ */
+// Plugins.
+export { default as ElementActions } from './elementActions.js';
+// Commands.
+export { default as ElementMoveCommand } from './elementMoveCommand.js';
+export { default as ElementDuplicateCommand } from './elementDuplicateCommand.js';
+export { default as ElementDeleteCommand } from './elementDeleteCommand.js';
+// Icons.
+export { deleteIcon, duplicateIcon, moveDownIcon, moveUpIcon } from './icons.js';
+import './augmentation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAA6B,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "ckeditor5-elements-actions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "49.0.0-alpha.2",
+  "description": "Element actions for CKEditor 5: move an element up or down, duplicate it, or delete it.",
+  "keywords": [
+    "ckeditor",
+    "ckeditor5",
+    "ckeditor 5",
+    "ckeditor5-feature",
+    "ckeditor5-plugin"
+  ],
+  "license": "MIT",
+  "author": "Ivan Kildyushov",
+  "homepage": "https://ivankild.github.io/ckeditor5-elements/guide/actions",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ivankild/ckeditor5-elements.git",
+    "directory": "packages/ckeditor5-elements-actions"
+  },
+  "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"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "ckeditor5-elements-core": "49.0.0-alpha.2"
+  },
+  "peerDependencies": {
+    "ckeditor5": "^49.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build"
+  }
 }

package/src/augmentation.ts

@@ -0,0 +1,14 @@
+import type { ElementActions, ElementDeleteCommand, ElementDuplicateCommand, ElementMoveCommand } from './index.js';
+
+declare module 'ckeditor5' {
+	interface PluginsMap {
+		[ElementActions.pluginName]: ElementActions;
+	}
+
+	interface CommandsMap {
+		moveElementUp: ElementMoveCommand;
+		moveElementDown: ElementMoveCommand;
+		duplicateElement: ElementDuplicateCommand;
+		deleteElement: ElementDeleteCommand;
+	}
+}

package/src/elementActions.ts

@@ -0,0 +1,31 @@
+import { Plugin } from 'ckeditor5';
+import ElementDeleteCommand from './elementDeleteCommand.js';
+import ElementDuplicateCommand from './elementDuplicateCommand.js';
+import ElementMoveCommand from './elementMoveCommand.js';
+
+/**
+ * Registers commands that act on an element: `moveElementUp`, `moveElementDown`, `duplicateElement` and
+ * `deleteElement`.
+ *
+ * ```ts
+ * editor.execute('duplicateElement'); // The element at the selection.
+ * editor.commands.get('moveElementUp').executeFor(element); // The given element.
+ * ```
+ *
+ * The commands have titles and icons, so they can be menu items (e.g. in the `elementContextMenu` config of
+ * `ElementContextMenu`) and buttons.
+ */
+export default class ElementActions extends Plugin {
+	public static get pluginName(): 'ElementActions' {
+		return 'ElementActions' as const;
+	}
+
+	public init(): void {
+		const editor = this.editor;
+
+		editor.commands.add('moveElementUp', new ElementMoveCommand(editor, 'up'));
+		editor.commands.add('moveElementDown', new ElementMoveCommand(editor, 'down'));
+		editor.commands.add('duplicateElement', new ElementDuplicateCommand(editor));
+		editor.commands.add('deleteElement', new ElementDeleteCommand(editor));
+	}
+}

package/src/elementDeleteCommand.ts

@@ -0,0 +1,58 @@
+import { type Editor } from 'ckeditor5';
+import { ElementOrPositionCommand, isStandalone, type ElementOrPosition } from 'ckeditor5-elements-core';
+import { deleteIcon } from './icons.js';
+
+/**
+ * Deletes an element. When it was the only element in its parent, e.g. in a note, the parent gets an empty paragraph
+ * with the selection, so that it can still be written in.
+ *
+ * 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}). The command is disabled for parts of a structure, such as table
+ * cells.
+ */
+export default class ElementDeleteCommand extends ElementOrPositionCommand {
+	constructor(editor: Editor) {
+		super(editor);
+
+		this.title = editor.t('Delete');
+		this.icon = deleteIcon;
+	}
+
+	/**
+	 * Deletes the element.
+	 */
+	public override execute(elementOrPosition?: ElementOrPosition): void {
+		const model = this.editor.model;
+		const element = this._getElement(elementOrPosition);
+
+		if (!element || !this._isEnabledFor(element)) {
+			return;
+		}
+
+		model.change(writer => {
+			const parent = element.parent;
+
+			writer.remove(element);
+
+			// The root gets a paragraph from the editor itself.
+			if (
+				parent?.is('element') &&
+				!parent.is('rootElement') &&
+				parent.isEmpty &&
+				model.schema.checkChild(parent, 'paragraph')
+			) {
+				const paragraph = writer.createElement('paragraph');
+
+				writer.append(paragraph, parent);
+				writer.setSelection(paragraph, 0);
+			}
+		});
+	}
+
+	protected override _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean {
+		const model = this.editor.model;
+		const element = this._getElement(elementOrPosition);
+
+		return !!element && isStandalone(model.schema, element) && model.canEditAt(element);
+	}
+}

package/src/elementDuplicateCommand.ts

@@ -0,0 +1,64 @@
+import { uid, type Editor } from 'ckeditor5';
+import {
+	ElementOrPositionCommand,
+	isStandalone,
+	selectNewElement,
+	type ElementOrPosition
+} from 'ckeditor5-elements-core';
+import { duplicateIcon } from './icons.js';
+
+/**
+ * Duplicates an element: inserts the same element, empty, after it, and puts the selection in it: in the copy of an
+ * element that holds text, or in a new paragraph in the copy of an element that holds blocks.
+ *
+ * The copy has the same name and attributes. A list item gets a new list item id, so it is a new list item, not a second
+ * block of the same one. Objects, e.g. an image or a table, are copied with their content, as they cannot be empty.
+ *
+ * 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}). The command is disabled for parts of a structure, such as table
+ * cells.
+ */
+export default class ElementDuplicateCommand extends ElementOrPositionCommand {
+	constructor(editor: Editor) {
+		super(editor);
+
+		this.title = editor.t('Duplicate');
+		this.icon = duplicateIcon;
+	}
+
+	/**
+	 * Inserts the copy of the element after it.
+	 */
+	public override execute(elementOrPosition?: ElementOrPosition): void {
+		const model = this.editor.model;
+		const element = this._getElement(elementOrPosition);
+
+		if (!element || !this._isEnabledFor(element)) {
+			return;
+		}
+
+		model.change(writer => {
+			const copy = writer.cloneElement(element, model.schema.isObject(element));
+
+			if (copy.hasAttribute('listItemId')) {
+				writer.setAttribute('listItemId', uid(), copy);
+			}
+
+			writer.insert(copy, writer.createPositionAfter(element));
+			selectNewElement(writer, copy);
+		});
+	}
+
+	protected override _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean {
+		const model = this.editor.model;
+		const element = this._getElement(elementOrPosition);
+
+		if (!element || !isStandalone(model.schema, element)) {
+			return false;
+		}
+
+		const position = model.createPositionAfter(element);
+
+		return model.canEditAt(position) && model.schema.checkChild(position, element);
+	}
+}

package/src/elementMoveCommand.ts

@@ -0,0 +1,74 @@
+import { type Editor, type ModelElement } from 'ckeditor5';
+import { ElementOrPositionCommand, isStandalone, type ElementOrPosition } from 'ckeditor5-elements-core';
+import { moveDownIcon, moveUpIcon } from './icons.js';
+
+/**
+ * Where the element moves.
+ */
+export type ElementMoveDirection = 'up' | 'down';
+
+/**
+ * Moves an element up or down: swaps it with the element before or after it, in the same parent. The selection stays
+ * in the 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}). The command is disabled when there is no element before it (up) or
+ * after it (down), e.g. for the first element of a note, and for parts of a structure, such as table cells.
+ */
+export default class ElementMoveCommand extends ElementOrPositionCommand {
+	/**
+	 * Where the element moves.
+	 */
+	public readonly direction: ElementMoveDirection;
+
+	constructor(editor: Editor, direction: ElementMoveDirection) {
+		super(editor);
+
+		this.direction = direction;
+		this.title = direction === 'up' ? editor.t('Move up') : editor.t('Move down');
+		this.icon = direction === 'up' ? moveUpIcon : moveDownIcon;
+	}
+
+	/**
+	 * Moves the element up or down.
+	 */
+	public override execute(elementOrPosition?: ElementOrPosition): void {
+		const element = this._getElement(elementOrPosition);
+		const sibling = element && this._getSibling(element);
+
+		if (!element || !sibling || !this._canMove(element, sibling)) {
+			return;
+		}
+
+		this.editor.model.change(writer => {
+			// Either way, the selection stays in the element: it moves with the element, or the sibling moves past it.
+			if (this.direction === 'up') {
+				writer.move(writer.createRangeOn(element), writer.createPositionBefore(sibling));
+			} else {
+				writer.move(writer.createRangeOn(sibling), writer.createPositionBefore(element));
+			}
+		});
+	}
+
+	protected override _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean {
+		const element = this._getElement(elementOrPosition);
+		const sibling = element && this._getSibling(element);
+
+		return !!element && !!sibling && this._canMove(element, sibling);
+	}
+
+	/**
+	 * Returns the element the element swaps with: the one before it (up) or after it (down), if it is an element.
+	 */
+	private _getSibling(element: ModelElement): ModelElement | null {
+		const sibling = this.direction === 'up' ? element.previousSibling : element.nextSibling;
+
+		return sibling?.is('element') ? sibling : null;
+	}
+
+	private _canMove(element: ModelElement, sibling: ModelElement): boolean {
+		const model = this.editor.model;
+
+		return isStandalone(model.schema, element) && model.canEditAt(element) && model.canEditAt(sibling);
+	}
+}

package/src/icons.ts

@@ -0,0 +1,35 @@
+import { IconRemove } from 'ckeditor5';
+
+/**
+ * The icons of the element actions, in the style of the CKEditor 5 icons (20×20).
+ */
+
+/**
+ * Move up: an arrow up, above a block.
+ */
+export const moveUpIcon =
+	'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+	'M10 1.5l3.75 3.75-1.05 1.05-1.95-1.95V8.5h-1.5V4.35L7.3 6.3 6.25 5.25zM3.5 11h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 ' +
+	'1 0 0 1-1-1v-5a1 1 0 0 1 1-1zm.5 1.5v4h12v-4z"/></svg>';
+
+/**
+ * Move down: a block, above an arrow down.
+ */
+export const moveDownIcon =
+	'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+	'M3.5 2h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM10 18.5l-3.75-3.75 ' +
+	'1.05-1.05 1.95 1.95V11.5h1.5v4.15l1.95-1.95 1.05 1.05z"/></svg>';
+
+/**
+ * Duplicate: a block, above a new block.
+ */
+export const duplicateIcon =
+	'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path fill-rule="evenodd" d="' +
+	'M3.5 2h13a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM3.5 11h13a1 1 0 0 1 1 ' +
+	'1v5a1 1 0 0 1-1 1h-13a1 1 0 0 1-1-1v-5a1 1 0 0 1 1-1zm.5 1.5v4h12v-4zM9.25 13h1.5v.75h.75v1.5h-.75V16h-1.5v-.75H8.5' +
+	'v-1.5h.75z"/></svg>';
+
+/**
+ * Delete: CKEditor's own remove icon.
+ */
+export const deleteIcon = IconRemove;

package/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Element actions: move an element up or down, duplicate it, or delete it.
+ *
+ * @module ckeditor5-elements-actions
+ */
+
+// Plugins.
+export { default as ElementActions } from './elementActions.js';
+
+// Commands.
+export { default as ElementMoveCommand, type ElementMoveDirection } from './elementMoveCommand.js';
+export { default as ElementDuplicateCommand } from './elementDuplicateCommand.js';
+export { default as ElementDeleteCommand } from './elementDeleteCommand.js';
+
+// Icons.
+export { deleteIcon, duplicateIcon, moveDownIcon, moveUpIcon } from './icons.js';
+
+import './augmentation.js';