@ckeditor/ckeditor5-clipboard 35.4.0 → 36.0.0

package/LICENSE.md

@@ -2,7 +2,7 @@ Software License Agreement
 ==========================
 
 **CKEditor 5 clipboard feature** – https://github.com/ckeditor/ckeditor5-clipboard <br>
-Copyright (c) 2003-2022, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
+Copyright (c) 2003-2023, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
 
 Licensed under the terms of [GNU General Public License Version 2 or later](http://www.gnu.org/licenses/gpl.html).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-clipboard",
-  "version": "35.4.0",
+  "version": "36.0.0",
   "description": "Clipboard integration feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,30 +12,30 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "^35.4.0",
-    "@ckeditor/ckeditor5-engine": "^35.4.0",
-    "@ckeditor/ckeditor5-utils": "^35.4.0",
-    "@ckeditor/ckeditor5-widget": "^35.4.0",
+    "@ckeditor/ckeditor5-core": "^36.0.0",
+    "@ckeditor/ckeditor5-engine": "^36.0.0",
+    "@ckeditor/ckeditor5-utils": "^36.0.0",
+    "@ckeditor/ckeditor5-widget": "^36.0.0",
     "lodash-es": "^4.17.11"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-alignment": "^35.4.0",
-    "@ckeditor/ckeditor5-basic-styles": "^35.4.0",
-    "@ckeditor/ckeditor5-block-quote": "^35.4.0",
-    "@ckeditor/ckeditor5-cloud-services": "^35.4.0",
-    "@ckeditor/ckeditor5-code-block": "^35.4.0",
-    "@ckeditor/ckeditor5-easy-image": "^35.4.0",
-    "@ckeditor/ckeditor5-editor-classic": "^35.4.0",
-    "@ckeditor/ckeditor5-enter": "^35.4.0",
-    "@ckeditor/ckeditor5-horizontal-line": "^35.4.0",
-    "@ckeditor/ckeditor5-image": "^35.4.0",
-    "@ckeditor/ckeditor5-link": "^35.4.0",
-    "@ckeditor/ckeditor5-page-break": "^35.4.0",
-    "@ckeditor/ckeditor5-paragraph": "^35.4.0",
-    "@ckeditor/ckeditor5-paste-from-office": "^35.4.0",
-    "@ckeditor/ckeditor5-remove-format": "^35.4.0",
-    "@ckeditor/ckeditor5-table": "^35.4.0",
-    "@ckeditor/ckeditor5-typing": "^35.4.0",
+    "@ckeditor/ckeditor5-alignment": "^36.0.0",
+    "@ckeditor/ckeditor5-basic-styles": "^36.0.0",
+    "@ckeditor/ckeditor5-block-quote": "^36.0.0",
+    "@ckeditor/ckeditor5-cloud-services": "^36.0.0",
+    "@ckeditor/ckeditor5-code-block": "^36.0.0",
+    "@ckeditor/ckeditor5-easy-image": "^36.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^36.0.0",
+    "@ckeditor/ckeditor5-enter": "^36.0.0",
+    "@ckeditor/ckeditor5-horizontal-line": "^36.0.0",
+    "@ckeditor/ckeditor5-image": "^36.0.0",
+    "@ckeditor/ckeditor5-link": "^36.0.0",
+    "@ckeditor/ckeditor5-page-break": "^36.0.0",
+    "@ckeditor/ckeditor5-paragraph": "^36.0.0",
+    "@ckeditor/ckeditor5-paste-from-office": "^36.0.0",
+    "@ckeditor/ckeditor5-remove-format": "^36.0.0",
+    "@ckeditor/ckeditor5-table": "^36.0.0",
+    "@ckeditor/ckeditor5-typing": "^36.0.0",
     "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"

package/src/clipboard.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -18,8 +18,6 @@ import PastePlainText from './pasteplaintext';
  * * {@link module:clipboard/clipboardpipeline~ClipboardPipeline}
  * * {@link module:clipboard/dragdrop~DragDrop}
  * * {@link module:clipboard/pasteplaintext~PastePlainText}
- *
- * @extends module:core/plugin~Plugin
  */
 export default class Clipboard extends Plugin {
     /**

package/src/clipboardobserver.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -28,8 +28,6 @@ import { DataTransfer, DomEventObserver } from '@ckeditor/ckeditor5-engine';
  * To make it available, it needs to be added to {@link module:engine/view/document~Document} by using
  * the {@link module:engine/view/view~View#addObserver `View#addObserver()`} method. Alternatively, you can load the
  * {@link module:clipboard/clipboard~Clipboard} plugin which adds this observer automatically (because it uses it).
- *
- * @extends module:engine/view/observer/domeventobserver~DomEventObserver
  */
 export default class ClipboardObserver extends DomEventObserver {
     constructor(view) {
@@ -89,193 +87,3 @@ function getDropViewRange(view, domEvent) {
     }
     return null;
 }
-/**
- * Fired as a continuation of the {@link #event:paste} and {@link #event:drop} events.
- *
- * It is a part of the {@glink framework/guides/deep-dive/clipboard#input-pipeline clipboard input pipeline}.
- *
- * This event carries a `dataTransfer` object which comes from the clipboard and whose content should be processed
- * and inserted into the editor.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:clipboard/clipboardobserver~ClipboardObserver
- * @see module:clipboard/clipboard~Clipboard
- * @event module:engine/view/document~Document#event:clipboardInput
- * @param {Object} data The event data.
- * @param {module:engine/view/datatransfer~DataTransfer} data.dataTransfer Data transfer instance.
- * @param {'paste'|'drop'} method Whether the event was triggered by a paste or drop operation.
- * @param {module:engine/view/element~Element} target The tree view element representing the target.
- * @param {Array.<module:engine/view/range~Range>} data.targetRanges Ranges which are the target of the operation
- * (usually – into which the content should be inserted).
- * If the clipboard input was triggered by a paste operation, this property is not set. If by a drop operation,
- * then it is the drop position (which can be different than the selection at the moment of drop).
- */
-/**
- * Fired when the user drags the content over one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:dragover
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * Fired when the user dropped the content into one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:drop
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- * @param {module:engine/view/range~Range} dropRange The position into which the content is dropped.
- */
-/**
- * Fired when the user pasted the content into one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:paste
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * Fired when the user copied the content from one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:clipboard/clipboardobserver~ClipboardObserver
- * @event module:engine/view/document~Document#event:copy
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * Fired when the user cut the content from one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:clipboard/clipboardobserver~ClipboardObserver
- * @event module:engine/view/document~Document#event:cut
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * The value of the {@link module:engine/view/document~Document#event:paste},
- * {@link module:engine/view/document~Document#event:copy} and {@link module:engine/view/document~Document#event:cut} events.
- *
- * In order to access the clipboard data, use the `dataTransfer` property.
- *
- * @class module:clipboard/clipboardobserver~ClipboardEventData
- * @extends module:engine/view/observer/domeventdata~DomEventData
- */
-/**
- * The data transfer instance.
- *
- * @readonly
- * @member {module:engine/view/datatransfer~DataTransfer} module:clipboard/clipboardobserver~ClipboardEventData#dataTransfer
- */
-/**
- * Fired as a continuation of the {@link #event:dragover} event.
- *
- * It is a part of the {@glink framework/guides/deep-dive/clipboard#input-pipeline clipboard input pipeline}.
- *
- * This event carries a `dataTransfer` object which comes from the clipboard and whose content should be processed
- * and inserted into the editor.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:clipboard/clipboardobserver~ClipboardObserver
- * @see module:clipboard/clipboard~Clipboard
- * @event module:engine/view/document~Document#event:dragging
- * @param {Object} data The event data.
- * @param {module:engine/view/datatransfer~DataTransfer} data.dataTransfer The data transfer instance.
- * @param {module:engine/view/element~Element} target The tree view element representing the target.
- * @param {Array.<module:engine/view/range~Range>} data.targetRanges Ranges which are the target of the operation
- * (usually – into which the content should be inserted).
- * It is the drop position (which can be different than the selection at the moment of drop).
- */
-/**
- * Fired when the user starts dragging the content in one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:dragstart
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * Fired when the user ended dragging the content.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:dragend
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * Fired when the user drags the content into one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:dragenter
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */
-/**
- * Fired when the user drags the content out of one of the editing roots of the editor.
- *
- * Introduced by {@link module:clipboard/clipboardobserver~ClipboardObserver}.
- *
- * **Note**: This event is not available by default. To make it available, {@link module:clipboard/clipboardobserver~ClipboardObserver}
- * needs to be added to the {@link module:engine/view/document~Document} by using the {@link module:engine/view/view~View#addObserver}
- * method. This is usually done by the {@link module:clipboard/clipboard~Clipboard} plugin, but if for some reason it is not loaded,
- * the observer must be added manually.
- *
- * @see module:engine/view/document~Document#event:clipboardInput
- * @event module:engine/view/document~Document#event:dragleave
- * @param {module:clipboard/clipboardobserver~ClipboardEventData} data The event data.
- */

package/src/clipboardpipeline.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -110,8 +110,6 @@ import viewToPlainText from './utils/viewtoplaintext';
  *    on the current selection.
  *
  * Read more about the clipboard integration in the {@glink framework/guides/deep-dive/clipboard clipboard deep-dive guide}.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class ClipboardPipeline extends Plugin {
     /**
@@ -132,8 +130,6 @@ export default class ClipboardPipeline extends Plugin {
     }
     /**
      * The clipboard paste pipeline.
-     *
-     * @private
      */
     _setupPasteDrop() {
         const editor = this.editor;
@@ -209,8 +205,6 @@ export default class ClipboardPipeline extends Plugin {
     }
     /**
      * The clipboard copy/cut pipeline.
-     *
-     * @private
      */
     _setupCopyCut() {
         const editor = this.editor;

package/src/dragdrop.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -95,8 +95,6 @@ import '../theme/clipboard.css';
  * The drag and drop feature. It works on top of the {@link module:clipboard/clipboardpipeline~ClipboardPipeline}.
  *
  * Read more about the clipboard integration in the {@glink framework/guides/deep-dive/clipboard clipboard deep-dive guide}.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class DragDrop extends Plugin {
     /**
@@ -117,49 +115,11 @@ export default class DragDrop extends Plugin {
     init() {
         const editor = this.editor;
         const view = editor.editing.view;
-        /**
-         * The live range over the original content that is being dragged.
-         *
-         * @private
-         * @type {module:engine/model/liverange~LiveRange}
-         */
         this._draggedRange = null;
-        /**
-         * The UID of current dragging that is used to verify if the drop started in the same editor as the drag start.
-         *
-         * **Note**: This is a workaround for broken 'dragend' events (they are not fired if the source text node got removed).
-         *
-         * @private
-         * @type {String}
-         */
         this._draggingUid = '';
-        /**
-         * The reference to the model element that currently has a `draggable` attribute set (it is set while dragging).
-         *
-         * @private
-         * @type {module:engine/model/element~Element}
-         */
         this._draggableElement = null;
-        /**
-         * A throttled callback updating the drop marker.
-         *
-         * @private
-         * @type {Function}
-         */
         this._updateDropMarkerThrottled = throttle(targetRange => this._updateDropMarker(targetRange), 40);
-        /**
-         * A delayed callback removing the drop marker.
-         *
-         * @private
-         * @type {Function}
-         */
         this._removeDropMarkerDelayed = delay(() => this._removeDropMarker(), 40);
-        /**
-         * A delayed callback removing draggable attributes.
-         *
-         * @private
-         * @type {Function}
-         */
         this._clearDraggableAttributesDelayed = delay(() => this._clearDraggableAttributes(), 40);
         view.addObserver(ClipboardObserver);
         view.addObserver(MouseObserver);
@@ -200,8 +160,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Drag and drop events handling.
-     *
-     * @private
      */
     _setupDragging() {
         const editor = this.editor;
@@ -306,8 +264,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Integration with the `clipboardInput` event.
-     *
-     * @private
      */
     _setupClipboardInputIntegration() {
         const editor = this.editor;
@@ -348,8 +304,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Integration with the `contentInsertion` event of the clipboard pipeline.
-     *
-     * @private
      */
     _setupContentInsertionIntegration() {
         const clipboardPipeline = this.editor.plugins.get(ClipboardPipeline);
@@ -377,8 +331,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Adds listeners that add the `draggable` attribute to the elements while the mouse button is down so the dragging could start.
-     *
-     * @private
      */
     _setupDraggableAttributeHandling() {
         const editor = this.editor;
@@ -425,8 +377,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Removes the `draggable` attribute from the element that was used for dragging.
-     *
-     * @private
      */
     _clearDraggableAttributes() {
         const editing = this.editor.editing;
@@ -440,8 +390,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Creates downcast conversion for the drop target marker.
-     *
-     * @private
      */
     _setupDropMarker() {
         const editor = this.editor;
@@ -472,8 +420,7 @@ export default class DragDrop extends Plugin {
     /**
      * Updates the drop target marker to the provided range.
      *
-     * @private
-     * @param {module:engine/model/range~Range} targetRange The range to set the marker to.
+     * @param targetRange The range to set the marker to.
      */
     _updateDropMarker(targetRange) {
         const editor = this.editor;
@@ -495,8 +442,6 @@ export default class DragDrop extends Plugin {
     }
     /**
      * Removes the drop target marker.
-     *
-     * @private
      */
     _removeDropMarker() {
         const model = this.editor.model;
@@ -511,8 +456,7 @@ export default class DragDrop extends Plugin {
     /**
      * Deletes the dragged content from its original range and clears the dragging state.
      *
-     * @private
-     * @param {Boolean} moved Whether the move succeeded.
+     * @param moved Whether the move succeeded.
      */
     _finalizeDragging(moved) {
         const editor = this.editor;
@@ -534,12 +478,9 @@ export default class DragDrop extends Plugin {
         this._draggedRange = null;
     }
 }
-// Returns fixed selection range for given position and target element.
-//
-// @param {module:core/editor/editor~Editor} editor
-// @param {Array.<module:engine/view/range~Range>} targetViewRanges
-// @param {module:engine/view/element~Element} targetViewElement
-// @returns {module:engine/model/range~Range|null}
+/**
+ * Returns fixed selection range for given position and target element.
+ */
 function findDropTargetRange(editor, targetViewRanges, targetViewElement) {
     const model = editor.model;
     const mapper = editor.editing.mapper;
@@ -581,11 +522,9 @@ function findDropTargetRange(editor, targetViewRanges, targetViewElement) {
     // so a nested editable, but view target position was directly in the `<figure>` element).
     return findDropTargetRangeOnAncestorObject(editor, targetModelPosition.parent);
 }
-// Returns fixed selection range for a given position and a target element if it is over the widget but not over its nested editable.
-//
-// @param {module:core/editor/editor~Editor} editor
-// @param {module:engine/view/element~Element} targetViewElement
-// @returns {module:engine/model/range~Range|null}
+/**
+ * Returns fixed selection range for a given position and a target element if it is over the widget but not over its nested editable.
+ */
 function findDropTargetRangeOnWidget(editor, targetViewElement) {
     const model = editor.model;
     const mapper = editor.editing.mapper;
@@ -604,23 +543,18 @@ function findDropTargetRangeOnWidget(editor, targetViewElement) {
     }
     return null;
 }
-// Returns fixed selection range inside a model element.
-//
-// @param {module:core/editor/editor~Editor} editor
-// @param {module:engine/model/element~Element} targetModelElement
-// @returns {module:engine/model/range~Range}
+/**
+ * Returns fixed selection range inside a model element.
+ */
 function findDropTargetRangeInElement(editor, targetModelElement) {
     const model = editor.model;
     const schema = model.schema;
     const positionAtElementStart = model.createPositionAt(targetModelElement, 0);
     return schema.getNearestSelectionRange(positionAtElementStart, 'forward');
 }
-// Returns fixed selection range for a given position and a target element if the drop is between blocks.
-//
-// @param {module:core/editor/editor~Editor} editor
-// @param {module:engine/model/position~Position} targetModelPosition
-// @param {module:engine/model/element~Element} targetModelElement
-// @returns {module:engine/model/range~Range|null}
+/**
+ * Returns fixed selection range for a given position and a target element if the drop is between blocks.
+ */
 function findDropTargetRangeBetweenBlocks(editor, targetModelPosition, targetModelElement) {
     const model = editor.model;
     // Check if target is between blocks.
@@ -641,11 +575,9 @@ function findDropTargetRangeBetweenBlocks(editor, targetModelPosition, targetMod
     }
     return null;
 }
-// Returns a selection range on the ancestor object.
-//
-// @param {module:core/editor/editor~Editor} editor
-// @param {module:engine/model/element~Element} element
-// @returns {module:engine/model/range~Range}
+/**
+ * Returns a selection range on the ancestor object.
+ */
 function findDropTargetRangeOnAncestorObject(editor, element) {
     const model = editor.model;
     let currentElement = element;
@@ -658,11 +590,9 @@ function findDropTargetRangeOnAncestorObject(editor, element) {
     /* istanbul ignore next */
     return null;
 }
-// Returns the closest model element for the specified view element.
-//
-// @param {module:core/editor/editor~Editor} editor
-// @param {module:engine/view/element~Element} element
-// @returns {module:engine/model/element~Element}
+/**
+ * Returns the closest model element for the specified view element.
+ */
 function getClosestMappedModelElement(editor, element) {
     const mapper = editor.editing.mapper;
     const view = editor.editing.view;
@@ -675,20 +605,22 @@ function getClosestMappedModelElement(editor, element) {
     const viewElement = mapper.findMappedViewAncestor(viewPosition);
     return mapper.toModelElement(viewElement);
 }
-// Returns the drop effect that should be a result of dragging the content.
-// This function is handling a quirk when checking the effect in the 'drop' DOM event.
+/**
+ * Returns the drop effect that should be a result of dragging the content.
+ * This function is handling a quirk when checking the effect in the 'drop' DOM event.
+ */
 function getFinalDropEffect(dataTransfer) {
     if (env.isGecko) {
         return dataTransfer.dropEffect;
     }
     return ['all', 'copyMove'].includes(dataTransfer.effectAllowed) ? 'move' : 'copy';
 }
-// Returns a function wrapper that will trigger a function after a specified wait time.
-// The timeout can be canceled by calling the cancel function on the returned wrapped function.
-//
-// @param {Function} func The function to wrap.
-// @param {Number} wait The timeout in ms.
-// @returns {Function}
+/**
+ * Returns a function wrapper that will trigger a function after a specified wait time.
+ * The timeout can be canceled by calling the cancel function on the returned wrapped function.
+ * @param func The function to wrap.
+ * @param wait The timeout in ms.
+ */
 function delay(func, wait) {
     let timer;
     function delayed(...args) {
@@ -700,10 +632,9 @@ function delay(func, wait) {
     };
     return delayed;
 }
-// Returns a widget element that should be dragged.
-//
-// @param {module:engine/view/element~Element} target
-// @returns {module:engine/view/element~Element}
+/**
+ * Returns a widget element that should be dragged.
+ */
 function findDraggableWidget(target) {
     // This is directly an editable so not a widget for sure.
     if (target.is('editableElement')) {

package/src/index.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**

package/src/pasteplaintext.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -12,8 +12,6 @@ import ClipboardPipeline from './clipboardpipeline';
  * The plugin detects the user's intention to paste plain text.
  *
  * For example, it detects the <kbd>Ctrl/Cmd</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> keystroke.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class PastePlainText extends Plugin {
     /**
@@ -69,11 +67,9 @@ export default class PastePlainText extends Plugin {
         });
     }
 }
-// Returns true if specified `documentFragment` represents a plain text.
-//
-// @param {module:engine/view/documentfragment~DocumentFragment} documentFragment
-// @param {module:engine/model/schema~Schema} schema
-// @returns {Boolean}
+/**
+ * Returns true if specified `documentFragment` represents a plain text.
+ */
 function isPlainTextFragment(documentFragment, schema) {
     if (documentFragment.childCount > 1) {
         return false;

package/src/utils/normalizeclipboarddata.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -9,8 +9,8 @@
  * Removes some popular browser quirks out of the clipboard data (HTML).
  * Removes all HTML comments. These are considered an internal thing and it makes little sense if they leak into the editor data.
  *
- * @param {String} data The HTML data to normalize.
- * @returns {String} Normalized HTML.
+ * @param data The HTML data to normalize.
+ * @returns Normalized HTML.
  */
 export default function normalizeClipboardData(data) {
     return data

package/src/utils/plaintexttohtml.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
@@ -8,8 +8,8 @@
 /**
  * Converts plain text to its HTML-ized version.
  *
- * @param {String} text The plain text to convert.
- * @returns {String} HTML generated from the plain text.
+ * @param text The plain text to convert.
+ * @returns HTML generated from the plain text.
  */
 export default function plainTextToHtml(text) {
     text = text

package/src/utils/viewtoplaintext.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 // Elements which should not have empty-line padding.
@@ -9,8 +9,8 @@ const smallPaddingElements = ['figcaption', 'li'];
 /**
  * Converts {@link module:engine/view/item~Item view item} and all of its children to plain text.
  *
- * @param {module:engine/view/item~Item} viewItem View item to convert.
- * @returns {String} Plain text representation of `viewItem`.
+ * @param viewItem View item to convert.
+ * @returns Plain text representation of `viewItem`.
  */
 export default function viewToPlainText(viewItem) {
     let text = '';

package/theme/clipboard.css

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */