@ckeditor/ckeditor5-engine 36.0.0 → 36.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "36.0.0",
+  "version": "36.0.1",
   "description": "The editing engine of CKEditor 5 – the best browser-based rich text editor.",
   "keywords": [
     "wysiwyg",
@@ -23,30 +23,30 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-utils": "^36.0.0",
+    "@ckeditor/ckeditor5-utils": "^36.0.1",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-basic-styles": "^36.0.0",
-    "@ckeditor/ckeditor5-block-quote": "^36.0.0",
-    "@ckeditor/ckeditor5-clipboard": "^36.0.0",
-    "@ckeditor/ckeditor5-cloud-services": "^36.0.0",
-    "@ckeditor/ckeditor5-core": "^36.0.0",
-    "@ckeditor/ckeditor5-editor-classic": "^36.0.0",
-    "@ckeditor/ckeditor5-enter": "^36.0.0",
-    "@ckeditor/ckeditor5-essentials": "^36.0.0",
-    "@ckeditor/ckeditor5-heading": "^36.0.0",
-    "@ckeditor/ckeditor5-image": "^36.0.0",
-    "@ckeditor/ckeditor5-link": "^36.0.0",
-    "@ckeditor/ckeditor5-list": "^36.0.0",
-    "@ckeditor/ckeditor5-mention": "^36.0.0",
-    "@ckeditor/ckeditor5-paragraph": "^36.0.0",
-    "@ckeditor/ckeditor5-table": "^36.0.0",
-    "@ckeditor/ckeditor5-theme-lark": "^36.0.0",
-    "@ckeditor/ckeditor5-typing": "^36.0.0",
-    "@ckeditor/ckeditor5-ui": "^36.0.0",
-    "@ckeditor/ckeditor5-undo": "^36.0.0",
-    "@ckeditor/ckeditor5-widget": "^36.0.0",
+    "@ckeditor/ckeditor5-basic-styles": "^36.0.1",
+    "@ckeditor/ckeditor5-block-quote": "^36.0.1",
+    "@ckeditor/ckeditor5-clipboard": "^36.0.1",
+    "@ckeditor/ckeditor5-cloud-services": "^36.0.1",
+    "@ckeditor/ckeditor5-core": "^36.0.1",
+    "@ckeditor/ckeditor5-editor-classic": "^36.0.1",
+    "@ckeditor/ckeditor5-enter": "^36.0.1",
+    "@ckeditor/ckeditor5-essentials": "^36.0.1",
+    "@ckeditor/ckeditor5-heading": "^36.0.1",
+    "@ckeditor/ckeditor5-image": "^36.0.1",
+    "@ckeditor/ckeditor5-link": "^36.0.1",
+    "@ckeditor/ckeditor5-list": "^36.0.1",
+    "@ckeditor/ckeditor5-mention": "^36.0.1",
+    "@ckeditor/ckeditor5-paragraph": "^36.0.1",
+    "@ckeditor/ckeditor5-table": "^36.0.1",
+    "@ckeditor/ckeditor5-theme-lark": "^36.0.1",
+    "@ckeditor/ckeditor5-typing": "^36.0.1",
+    "@ckeditor/ckeditor5-ui": "^36.0.1",
+    "@ckeditor/ckeditor5-undo": "^36.0.1",
+    "@ckeditor/ckeditor5-widget": "^36.0.1",
     "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"

package/src/view/datatransfer.js

@@ -6,26 +6,29 @@
  * A facade over the native [`DataTransfer`](https://developer.mozilla.org/en-US/docs/Web/API/DataTransfer) object.
  */
 export default class DataTransfer {
-    constructor(nativeDataTransfer) {
-        /**
-         * The array of files created from the native `DataTransfer#files` or `DataTransfer#items`.
-         *
-         * @readonly
-         * @member {Array.<File>} #files
-         */
-        this.files = getFiles(nativeDataTransfer);
-        /**
-         * The native DataTransfer object.
-         *
-         * @private
-         * @member {DataTransfer} #_native
-         */
+    /**
+     * @param nativeDataTransfer The native [`DataTransfer`](https://developer.mozilla.org/en-US/docs/Web/API/DataTransfer) object.
+     * @param options.cacheFiles Whether `files` list should be initialized in the constructor.
+     */
+    constructor(nativeDataTransfer, options = {}) {
+        // We should store references to the File instances in case someone would like to process this files
+        // outside the event handler. Files are stored only for `drop` and `paste` events because they are not usable
+        // in other events and are generating a huge delay on Firefox while dragging.
+        // See https://github.com/ckeditor/ckeditor5/issues/13366.
+        this._files = options.cacheFiles ? getFiles(nativeDataTransfer) : null;
         this._native = nativeDataTransfer;
     }
+    /**
+     * The array of files created from the native `DataTransfer#files` or `DataTransfer#items`.
+     */
+    get files() {
+        if (!this._files) {
+            this._files = getFiles(this._native);
+        }
+        return this._files;
+    }
     /**
      * Returns an array of available native content types.
-     *
-     * @returns {Array.<String>}
      */
     get types() {
         return this._native.types;
@@ -33,10 +36,11 @@ export default class DataTransfer {
     /**
      * Gets the data from the data transfer by its MIME type.
      *
-     *		dataTransfer.getData( 'text/plain' );
+     * ```ts
+     * dataTransfer.getData( 'text/plain' );
+     * ```
      *
-     * @param {String} type The MIME type. E.g. `text/html` or `text/plain`.
-     * @returns {String}
+     * @param type The MIME type. E.g. `text/html` or `text/plain`.
      */
     getData(type) {
         return this._native.getData(type);
@@ -44,16 +48,13 @@ export default class DataTransfer {
     /**
      * Sets the data in the data transfer.
      *
-     * @param {String} type The MIME type. E.g. `text/html` or `text/plain`.
-     * @param {String} data
+     * @param type The MIME type. E.g. `text/html` or `text/plain`.
      */
     setData(type, data) {
         this._native.setData(type, data);
     }
     /**
      * The effect that is allowed for a drag operation.
-     *
-     * @param {String} value
      */
     set effectAllowed(value) {
         this._native.effectAllowed = value;
@@ -63,8 +64,6 @@ export default class DataTransfer {
     }
     /**
      * The actual drop effect.
-     *
-     * @param {String} value
      */
     set dropEffect(value) {
         this._native.dropEffect = value;
@@ -74,8 +73,6 @@ export default class DataTransfer {
     }
     /**
      * Whether the dragging operation was canceled.
-     *
-     * @returns {Boolean}
      */
     get isCanceled() {
         return this._native.dropEffect == 'none' || !!this._native.mozUserCancelled;