@ckeditor/ckeditor5-core 35.3.2 → 36.0.0

package/LICENSE.md

@@ -2,7 +2,7 @@ Software License Agreement
 ==========================
 
 **CKEditor 5 core editor architecture** – https://github.com/ckeditor/ckeditor5-core <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/lang/translations/ug.po

@@ -18,27 +18,27 @@ msgstr ""
 
 msgctxt "Label for the Cancel button."
 msgid "Cancel"
-msgstr "ئىناۋەتسىز"
+msgstr "ۋاز كەچ"
 
 msgctxt "The label used by a button next to the color palette in the color picker that removes the color (resets it to an empty value, example usages in font color or table properties)."
 msgid "Remove color"
-msgstr "رەڭنى چىقىرىۋېتىش"
+msgstr "رەڭنى چىقىرىۋەت"
 
 msgctxt "The label used by a button next to the color palette in the color picker that restores the default value if the default table properties are specified."
 msgid "Restore default"
-msgstr ""
+msgstr "كۆڭۈلدىكىگە قايتۇر"
 
 msgctxt "Label for the Save button."
 msgid "Save"
-msgstr "ساقلاش"
+msgstr "ساقلا"
 
 msgctxt "Label of a toolbar button which reveals more toolbar items."
 msgid "Show more items"
-msgstr ""
+msgstr "تېخىمۇ كۆپ تۈرنى كۆرسەت"
 
 msgctxt "Label for an ‘X of Y’ status of a typical next/previous navigation. For instance, ‘Page 5 of 20’ or 'Search result 5 of 20'."
 msgid "%0 of %1"
-msgstr ""
+msgstr "%0 / %1"
 
 msgctxt "A generic error message displayed on upload failure. The file name is concatenated to this text."
 msgid "Cannot upload file:"
@@ -46,4 +46,4 @@ msgstr "يۈكلەشكە بولمايدىغان ھۆججەت:"
 
 msgctxt "Accessible label of the specific editing area of the editor acting as a root of the entire application."
 msgid "Rich Text Editor. Editing area: %0"
-msgstr ""
+msgstr "مول تېكىست تەھرىرلىگۈچ. تەھرىرلەش رايونى: %0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-core",
-  "version": "35.3.2",
+  "version": "36.0.0",
   "description": "The core architecture of CKEditor 5 – the best browser-based rich text editor.",
   "keywords": [
     "wysiwyg",
@@ -23,25 +23,25 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-engine": "^35.3.2",
-    "@ckeditor/ckeditor5-ui": "^35.3.2",
-    "@ckeditor/ckeditor5-utils": "^35.3.2",
+    "@ckeditor/ckeditor5-engine": "^36.0.0",
+    "@ckeditor/ckeditor5-utils": "^36.0.0",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-autoformat": "^35.3.2",
-    "@ckeditor/ckeditor5-basic-styles": "^35.3.2",
-    "@ckeditor/ckeditor5-block-quote": "^35.3.2",
-    "@ckeditor/ckeditor5-editor-classic": "^35.3.2",
-    "@ckeditor/ckeditor5-essentials": "^35.3.2",
-    "@ckeditor/ckeditor5-heading": "^35.3.2",
-    "@ckeditor/ckeditor5-image": "^35.3.2",
-    "@ckeditor/ckeditor5-indent": "^35.3.2",
-    "@ckeditor/ckeditor5-link": "^35.3.2",
-    "@ckeditor/ckeditor5-list": "^35.3.2",
-    "@ckeditor/ckeditor5-media-embed": "^35.3.2",
-    "@ckeditor/ckeditor5-paragraph": "^35.3.2",
-    "@ckeditor/ckeditor5-table": "^35.3.2",
+    "@ckeditor/ckeditor5-autoformat": "^36.0.0",
+    "@ckeditor/ckeditor5-basic-styles": "^36.0.0",
+    "@ckeditor/ckeditor5-block-quote": "^36.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^36.0.0",
+    "@ckeditor/ckeditor5-essentials": "^36.0.0",
+    "@ckeditor/ckeditor5-heading": "^36.0.0",
+    "@ckeditor/ckeditor5-image": "^36.0.0",
+    "@ckeditor/ckeditor5-indent": "^36.0.0",
+    "@ckeditor/ckeditor5-link": "^36.0.0",
+    "@ckeditor/ckeditor5-list": "^36.0.0",
+    "@ckeditor/ckeditor5-media-embed": "^36.0.0",
+    "@ckeditor/ckeditor5-paragraph": "^36.0.0",
+    "@ckeditor/ckeditor5-table": "^36.0.0",
+    "@ckeditor/ckeditor5-ui": "^36.0.0",
     "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"

package/src/command.js

@@ -1,28 +1,31 @@
 /**
- * @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
  */
-import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
 /**
- * The base class for CKEditor commands.
+ * @module core/command
+ */
+import { ObservableMixin } from '@ckeditor/ckeditor5-utils';
+/**
+ * Base class for the CKEditor commands.
  *
- * Commands are the main way to manipulate editor contents and state. They are mostly used by UI elements (or by other
- * commands) to make changes in the model. Commands are available in every part of code that has access to
+ * Commands are the main way to manipulate the editor contents and state. They are mostly used by UI elements (or by other
+ * commands) to make changes in the model. Commands are available in every part of the code that has access to
  * the {@link module:core/editor/editor~Editor editor} instance.
  *
  * Instances of registered commands can be retrieved from {@link module:core/editor/editor~Editor#commands `editor.commands`}.
  * The easiest way to execute a command is through {@link module:core/editor/editor~Editor#execute `editor.execute()`}.
  *
- * By default, commands are disabled when the editor is in {@link module:core/editor/editor~Editor#isReadOnly read-only} mode
+ * By default, commands are disabled when the editor is in the {@link module:core/editor/editor~Editor#isReadOnly read-only} mode
  * but commands with the {@link module:core/command~Command#affectsData `affectsData`} flag set to `false` will not be disabled.
  *
  * @mixes module:utils/observablemixin~ObservableMixin
  */
-export default class Command extends Observable {
+export default class Command extends ObservableMixin() {
     /**
      * Creates a new `Command` instance.
      *
-     * @param {module:core/editor/editor~Editor} editor Editor on which this command will be used.
+     * @param {module:core/editor/editor~Editor} editor The editor on which this command will be used.
      */
     constructor(editor) {
         super();
@@ -34,14 +37,14 @@ export default class Command extends Observable {
          */
         this.editor = editor;
         /**
-         * The value of the command. A concrete command class should define what it represents for it.
+         * The value of the command. A given command class should define what it represents for it.
          *
          * For example, the `'bold'` command's value indicates whether the selection starts in a bolded text.
-         * And the value of the `'link'` command may be an object with links details.
+         * And the value of the `'link'` command may be an object with link details.
          *
          * It is possible for a command to have no value (e.g. for stateless actions such as `'uploadImage'`).
          *
-         * A concrete command class should control this value by overriding the {@link #refresh `refresh()`} method.
+         * A given command class should control this value by overriding the {@link #refresh `refresh()`} method.
          *
          * @observable
          * @readonly
@@ -52,9 +55,9 @@ export default class Command extends Observable {
          * Flag indicating whether a command is enabled or disabled.
          * A disabled command will do nothing when executed.
          *
-         * A concrete command class should control this value by overriding the {@link #refresh `refresh()`} method.
+         * A given command class should control this value by overriding the {@link #refresh `refresh()`} method.
          *
-         * It is possible to disable a command from "outside". For instance, in your integration you may want to disable
+         * It is possible to disable a command "from outside". For instance, in your integration you may want to disable
          * a certain set of commands for the time being. To do that, you can use the fact that `isEnabled` is observable
          * and it fires the `set:isEnabled` event every time anyone tries to modify its value:
          *
@@ -149,7 +152,7 @@ export default class Command extends Observable {
      * Disables the command.
      *
      * Command may be disabled by multiple features or algorithms (at once). When disabling a command, unique id should be passed
-     * (e.g. feature name). The same identifier should be used when {@link #clearForceDisabled enabling back} the command.
+     * (e.g. the feature name). The same identifier should be used when {@link #clearForceDisabled enabling back} the command.
      * The command becomes enabled only after all features {@link #clearForceDisabled enabled it back}.
      *
      * Disabling and enabling a command:

package/src/commandcollection.js

@@ -1,11 +1,11 @@
 /**
- * @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
  */
 /**
  * @module core/commandcollection
  */
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
+import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Collection of commands. Its instance is available in {@link module:core/editor/editor~Editor#commands `editor.commands`}.
  */

package/src/context.js

@@ -1,21 +1,18 @@
 /**
- * @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
  */
 /**
  * @module core/context
  */
-import Config from '@ckeditor/ckeditor5-utils/src/config';
-import Collection from '@ckeditor/ckeditor5-utils/src/collection';
+import { Config, Collection, CKEditorError, Locale } from '@ckeditor/ckeditor5-utils';
 import PluginCollection from './plugincollection';
-import Locale from '@ckeditor/ckeditor5-utils/src/locale';
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
 /**
  * Provides a common, higher-level environment for solutions that use multiple {@link module:core/editor/editor~Editor editors}
  * or plugins that work outside the editor. Use it instead of {@link module:core/editor/editor~Editor.create `Editor.create()`}
  * in advanced application integrations.
  *
- * All configuration options passed to a context will be used as default options for editor instances initialized in that context.
+ * All configuration options passed to a context will be used as default options for the editor instances initialized in that context.
  *
  * {@link module:core/contextplugin~ContextPlugin Context plugins} passed to a context instance will be shared among all
  * editor instances initialized in this context. These will be the same plugin instances for all the editors.
@@ -33,7 +30,7 @@ import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
  * enable and configure them using the context.
  *
  * If you are using only a single editor on each page, use {@link module:core/editor/editor~Editor.create `Editor.create()`} instead.
- * In such case, a context instance will be created by the editor instance in a transparent way.
+ * In such a case, a context instance will be created by the editor instance in a transparent way.
  *
  * See {@link module:core/context~Context.create `Context.create()`} for usage examples.
  */

package/src/contextplugin.js

@@ -1,11 +1,11 @@
 /**
- * @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
  */
 /**
  * @module core/contextplugin
  */
-import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
+import { ObservableMixin } from '@ckeditor/ckeditor5-utils';
 /**
  * The base class for {@link module:core/context~Context} plugin classes.
  *
@@ -23,7 +23,7 @@ import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
  * @implements module:core/plugin~PluginInterface
  * @mixes module:utils/observablemixin~ObservableMixin
  */
-export default class ContextPlugin extends Observable {
+export default class ContextPlugin extends ObservableMixin() {
     /**
      * Creates a new plugin instance.
      *

package/src/editingkeystrokehandler.js

@@ -1,11 +1,11 @@
 /**
- * @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
  */
 /**
  * @module core/editingkeystrokehandler
  */
-import KeystrokeHandler from '@ckeditor/ckeditor5-utils/src/keystrokehandler';
+import { KeystrokeHandler } from '@ckeditor/ckeditor5-utils';
 /**
  * A keystroke handler for editor editing. Its instance is available
  * in {@link module:core/editor/editor~Editor#keystrokes} so plugins

package/src/editor/editor.js

@@ -1,22 +1,16 @@
 /**
- * @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
  */
 /**
  * @module core/editor/editor
  */
+import { Config, CKEditorError, ObservableMixin } from '@ckeditor/ckeditor5-utils';
+import { Conversion, DataController, EditingController, Model, StylesProcessor } from '@ckeditor/ckeditor5-engine';
 import Context from '../context';
-import Config from '@ckeditor/ckeditor5-utils/src/config';
-import EditingController from '@ckeditor/ckeditor5-engine/src/controller/editingcontroller';
 import PluginCollection from '../plugincollection';
 import CommandCollection from '../commandcollection';
-import DataController from '@ckeditor/ckeditor5-engine/src/controller/datacontroller';
-import Conversion from '@ckeditor/ckeditor5-engine/src/conversion/conversion';
-import Model from '@ckeditor/ckeditor5-engine/src/model/model';
 import EditingKeystrokeHandler from '../editingkeystrokehandler';
-import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
-import { StylesProcessor } from '@ckeditor/ckeditor5-engine/src/view/stylesmap';
 /**
  * The class representing a basic, generic editor.
  *
@@ -38,7 +32,7 @@ import { StylesProcessor } from '@ckeditor/ckeditor5-engine/src/view/stylesmap';
  * @abstract
  * @mixes module:utils/observablemixin~ObservableMixin
  */
-export default class Editor extends Observable {
+export default class Editor extends ObservableMixin() {
     /**
      * Creates a new instance of the editor class.
      *

package/src/editor/editorconfig.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
  */
 export {};

package/src/editor/utils/attachtoform.js

@@ -1,9 +1,9 @@
 /**
- * @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
  */
 import { isFunction } from 'lodash-es';
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
+import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * @module core/editor/utils/attachtoform
  */

package/src/editor/utils/dataapimixin.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/editor/utils/elementapimixin.js

@@ -1,10 +1,9 @@
 /**
- * @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
  */
 /* eslint-disable @typescript-eslint/explicit-module-boundary-types */
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
-import setDataInElement from '@ckeditor/ckeditor5-utils/src/dom/setdatainelement';
+import { CKEditorError, setDataInElement } from '@ckeditor/ckeditor5-utils';
 /**
  * @module core/editor/utils/elementapimixin
  */

package/src/editor/utils/securesourceelement.js

@@ -1,8 +1,8 @@
 /**
- * @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
  */
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
+import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * @module core/editor/utils/securesourceelement
  */

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
  */
 /**
@@ -11,7 +11,6 @@ export { default as MultiCommand } from './multicommand';
 export { default as Context } from './context';
 export { default as ContextPlugin } from './contextplugin';
 export { default as Editor } from './editor/editor';
-export { default as EditorUI } from './editor/editorui';
 export { default as attachToForm } from './editor/utils/attachtoform';
 export { default as DataApiMixin } from './editor/utils/dataapimixin';
 export { default as ElementApiMixin } from './editor/utils/elementapimixin';

package/src/multicommand.js

@@ -1,9 +1,9 @@
 /**
- * @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
  */
 import Command from './command';
-import insertToPriorityArray from '@ckeditor/ckeditor5-utils/src/inserttopriorityarray';
+import { insertToPriorityArray } from '@ckeditor/ckeditor5-utils';
 /**
  * @module core/multicommand
  */
@@ -12,7 +12,7 @@ import insertToPriorityArray from '@ckeditor/ckeditor5-utils/src/inserttopriorit
  *
  * This command is used to proxy multiple commands. The multi-command is enabled when
  * at least one of its registered child commands is enabled.
- * When executing a multi-command the first enabled command with highest priority will be executed.
+ * When executing a multi-command, the first enabled command with highest priority will be executed.
  *
  *		const multiCommand = new MultiCommand( editor );
  *
@@ -69,7 +69,7 @@ export default class MultiCommand extends Command {
      */
     registerChildCommand(command, options = {}) {
         insertToPriorityArray(this._childCommandsDefinitions, { command, priority: options.priority || 'normal' });
-        // Change multi command enabled state when one of registered commands changes state.
+        // Change multi-command enabled state when one of registered commands changes state.
         command.on('change:isEnabled', () => this._checkEnabled());
         this._checkEnabled();
     }

package/src/pendingactions.js

@@ -1,14 +1,12 @@
 /**
- * @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
  */
 /**
  * @module core/pendingactions
  */
 import ContextPlugin from './contextplugin';
-import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
-import Collection from '@ckeditor/ckeditor5-utils/src/collection';
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
+import { CKEditorError, Collection, ObservableMixin } from '@ckeditor/ckeditor5-utils';
 /**
  * The list of pending editor actions.
  *
@@ -45,7 +43,7 @@ import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
  *
  * This plugin is used by features like {@link module:upload/filerepository~FileRepository} to register their ongoing actions
  * and by features like {@link module:autosave/autosave~Autosave} to detect whether there are any ongoing actions.
- * Read more about saving the data in the {@glink installation/advanced/saving-data Saving and getting data} guide.
+ * Read more about saving the data in the {@glink installation/getting-started/getting-and-setting-data Saving and getting data} guide.
  *
  * @extends module:core/contextplugin~ContextPlugin
  */
@@ -95,7 +93,7 @@ export default class PendingActions extends ContextPlugin {
              */
             throw new CKEditorError('pendingactions-add-invalid-message', this);
         }
-        const action = new Observable();
+        const action = new (ObservableMixin())();
         action.set('message', message);
         this._actions.add(action);
         this.hasAny = true;
@@ -111,7 +109,7 @@ export default class PendingActions extends ContextPlugin {
         this.hasAny = !!this._actions.length;
     }
     /**
-     * Returns the first action from the list or null when list is empty
+     * Returns the first action from the list or null if the list is empty
      *
      * returns {Object|null} The pending action object.
      */

package/src/plugin.js

@@ -1,19 +1,19 @@
 /**
- * @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
  */
 /* eslint-disable @typescript-eslint/no-invalid-void-type */
 /**
  * @module core/plugin
  */
-import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
+import { ObservableMixin } from '@ckeditor/ckeditor5-utils';
 /**
  * The base class for CKEditor plugin classes.
  *
  * @implements module:core/plugin~PluginInterface
  * @mixes module:utils/observablemixin~ObservableMixin
  */
-export default class Plugin extends Observable {
+export default class Plugin extends ObservableMixin() {
     /**
      * @inheritDoc
      */

package/src/plugincollection.js

@@ -1,18 +1,17 @@
 /**
- * @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
  */
 /**
  * @module core/plugincollection
  */
-import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
-import { Emitter } from '@ckeditor/ckeditor5-utils/src/emittermixin';
+import { CKEditorError, EmitterMixin } from '@ckeditor/ckeditor5-utils';
 /**
  * Manages a list of CKEditor plugins, including loading, resolving dependencies and initialization.
  *
  * @mixes module:utils/emittermixin~EmitterMixin
  */
-export default class PluginCollection extends Emitter {
+export default class PluginCollection extends EmitterMixin() {
     /**
      * Creates an instance of the plugin collection class.
      * Allows loading and initializing plugins and their dependencies.

package/src/editor/editorui.js

@@ -1,474 +0,0 @@
-/**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-import ComponentFactory from '@ckeditor/ckeditor5-ui/src/componentfactory';
-import FocusTracker from '@ckeditor/ckeditor5-utils/src/focustracker';
-import TooltipManager from '@ckeditor/ckeditor5-ui/src/tooltipmanager';
-import { Observable } from '@ckeditor/ckeditor5-utils/src/observablemixin';
-import isVisible from '@ckeditor/ckeditor5-utils/src/dom/isvisible';
-/**
- * A class providing the minimal interface that is required to successfully bootstrap any editor UI.
- *
- * @mixes module:utils/emittermixin~EmitterMixin
- */
-export default class EditorUI extends Observable {
-    /**
-     * Creates an instance of the editor UI class.
-     *
-     * @param {module:core/editor/editor~Editor} editor The editor instance.
-     */
-    constructor(editor) {
-        super();
-        /**
-         * The editor that the UI belongs to.
-         *
-         * @readonly
-         * @member {module:core/editor/editor~Editor} #editor
-         */
-        this.editor = editor;
-        /**
-         * An instance of the {@link module:ui/componentfactory~ComponentFactory}, a registry used by plugins
-         * to register factories of specific UI components.
-         *
-         * @readonly
-         * @member {module:ui/componentfactory~ComponentFactory} #componentFactory
-         */
-        this.componentFactory = new ComponentFactory(editor);
-        /**
-         * Stores the information about the editor UI focus and propagates it so various plugins and components
-         * are unified as a focus group.
-         *
-         * @readonly
-         * @member {module:utils/focustracker~FocusTracker} #focusTracker
-         */
-        this.focusTracker = new FocusTracker();
-        /**
-         * Manages the tooltips displayed on mouseover and focus across the UI.
-         *
-         * @readonly
-         * @member {module:ui/tooltipmanager~TooltipManager}
-         */
-        this.tooltipManager = new TooltipManager(editor);
-        /**
-         * Stores viewport offsets from every direction.
-         *
-         * Viewport offset can be used to constrain balloons or other UI elements into an element smaller than the viewport.
-         * This can be useful if there are any other absolutely positioned elements that may interfere with editor UI.
-         *
-         * Example `editor.ui.viewportOffset` returns:
-         *
-         * ```js
-         * {
-         * 	top: 50,
-         * 	right: 50,
-         * 	bottom: 50,
-         * 	left: 50
-         * }
-         * ```
-         *
-         * This property can be overriden after editor already being initialized:
-         *
-         * ```js
-         * editor.ui.viewportOffset = {
-         * 	top: 100,
-         * 	right: 0,
-         * 	bottom: 0,
-         * 	left: 0
-         * };
-         * ```
-         *
-         * @observable
-         * @member {Object} #viewportOffset
-         */
-        this.set('viewportOffset', this._readViewportOffsetFromConfig());
-        /**
-         * Indicates the UI is ready. Set `true` after {@link #event:ready} event is fired.
-         *
-         * @readonly
-         * @default false
-         * @member {Boolean} #isReady
-         */
-        this.isReady = false;
-        this.once('ready', () => {
-            this.isReady = true;
-        });
-        /**
-         * Stores all editable elements used by the editor instance.
-         *
-         * @private
-         * @member {Map.<String,HTMLElement>}
-         */
-        this._editableElementsMap = new Map();
-        /**
-         * All available & focusable toolbars.
-         *
-         * @private
-         * @type {Array.<module:core/editor/editorui~FocusableToolbarDefinition>}
-         */
-        this._focusableToolbarDefinitions = [];
-        // Informs UI components that should be refreshed after layout change.
-        this.listenTo(editor.editing.view.document, 'layoutChanged', () => this.update());
-        this._initFocusTracking();
-    }
-    /**
-     * The main (outermost) DOM element of the editor UI.
-     *
-     * For example, in {@link module:editor-classic/classiceditor~ClassicEditor} it is a `<div>` which
-     * wraps the editable element and the toolbar. In {@link module:editor-inline/inlineeditor~InlineEditor}
-     * it is the editable element itself (as there is no other wrapper). However, in
-     * {@link module:editor-decoupled/decouplededitor~DecoupledEditor} it is set to `null` because this editor does not
-     * come with a single "main" HTML element (its editable element and toolbar are separate).
-     *
-     * This property can be understood as a shorthand for retrieving the element that a specific editor integration
-     * considers to be its main DOM element.
-     *
-     * @readonly
-     * @member {HTMLElement|null} #element
-     */
-    get element() {
-        return null;
-    }
-    /**
-     * Fires the {@link module:core/editor/editorui~EditorUI#event:update `update`} event.
-     *
-     * This method should be called when the editor UI (e.g. positions of its balloons) needs to be updated due to
-     * some environmental change which CKEditor 5 is not aware of (e.g. resize of a container in which it is used).
-     */
-    update() {
-        this.fire('update');
-    }
-    /**
-     * Destroys the UI.
-     */
-    destroy() {
-        this.stopListening();
-        this.focusTracker.destroy();
-        this.tooltipManager.destroy(this.editor);
-        // Clean–up the references to the CKEditor instance stored in the native editable DOM elements.
-        for (const domElement of this._editableElementsMap.values()) {
-            domElement.ckeditorInstance = null;
-        }
-        this._editableElementsMap = new Map();
-        this._focusableToolbarDefinitions = [];
-    }
-    /**
-     * Stores the native DOM editable element used by the editor under a unique name.
-     *
-     * Also, registers the element in the editor to maintain the accessibility of the UI. When the user is editing text in a focusable
-     * editable area, they can use the <kbd>Alt</kbd> + <kbd>F10</kbd> keystroke to navigate over editor toolbars. See {@link #addToolbar}.
-     *
-     * @param {String} rootName The unique name of the editable element.
-     * @param {HTMLElement} domElement The native DOM editable element.
-     */
-    setEditableElement(rootName, domElement) {
-        this._editableElementsMap.set(rootName, domElement);
-        // Put a reference to the CKEditor instance in the editable native DOM element.
-        // It helps 3rd–party software (browser extensions, other libraries) access and recognize
-        // CKEditor 5 instances (editing roots) and use their API (there is no global editor
-        // instance registry).
-        if (!domElement.ckeditorInstance) {
-            domElement.ckeditorInstance = this.editor;
-        }
-        // Register the element so it becomes available for Alt+F10 and Esc navigation.
-        this.focusTracker.add(domElement);
-        const setUpKeystrokeHandler = () => {
-            // The editing view of the editor is already listening to keystrokes from DOM roots (see: KeyObserver).
-            // Do not duplicate listeners.
-            if (this.editor.editing.view.getDomRoot(rootName)) {
-                return;
-            }
-            this.editor.keystrokes.listenTo(domElement);
-        };
-        // For editable elements set by features after EditorUI is ready (e.g. source editing).
-        if (this.isReady) {
-            setUpKeystrokeHandler();
-        }
-        // For editable elements set while the editor is being created (e.g. DOM roots).
-        else {
-            this.once('ready', setUpKeystrokeHandler);
-        }
-    }
-    /**
-     * Returns the editable editor element with the given name or null if editable does not exist.
-     *
-     * @param {String} [rootName=main] The editable name.
-     * @returns {HTMLElement|undefined}
-     */
-    getEditableElement(rootName = 'main') {
-        return this._editableElementsMap.get(rootName);
-    }
-    /**
-     * Returns array of names of all editor editable elements.
-     *
-     * @returns {Iterable.<String>}
-     */
-    getEditableElementsNames() {
-        return this._editableElementsMap.keys();
-    }
-    /**
-     * Adds a toolbar to the editor UI. Used primarily to maintain the accessibility of the UI.
-     *
-     * Focusable toolbars can be accessed (focused) by users by pressing the <kbd>Alt</kbd> + <kbd>F10</kbd> keystroke.
-     * Successive keystroke presses navigate over available toolbars.
-     *
-     * @param {module:ui/toolbar/toolbarview~ToolbarView} toolbarView A instance of the toolbar to be registered.
-     * @param {Object} [options]
-     * @param {Boolean} [options.isContextual] Set `true` if the toolbar is attached to the content of the editor. Such toolbar takes
-     * a precedence over other toolbars when a user pressed <kbd>Alt</kbd> + <kbd>F10</kbd>.
-     * @param {Function} [options.beforeFocus] Specify a callback executed before the toolbar instance DOM element gains focus
-     * upon the <kbd>Alt</kbd> + <kbd>F10</kbd> keystroke.
-     * @param {Function} [options.afterBlur] Specify a callback executed after the toolbar instance DOM element loses focus upon
-     * <kbd>Esc</kbd> keystroke but before the focus goes back to the {@link #setEditableElement editable element}.
-     */
-    addToolbar(toolbarView, options = {}) {
-        if (toolbarView.isRendered) {
-            this.focusTracker.add(toolbarView.element);
-            this.editor.keystrokes.listenTo(toolbarView.element);
-        }
-        else {
-            toolbarView.once('render', () => {
-                this.focusTracker.add(toolbarView.element);
-                this.editor.keystrokes.listenTo(toolbarView.element);
-            });
-        }
-        this._focusableToolbarDefinitions.push({ toolbarView, options });
-    }
-    /**
-     * Stores all editable elements used by the editor instance.
-     *
-     * @protected
-     * @deprecated
-     * @member {Map.<String,HTMLElement>}
-     */
-    get _editableElements() {
-        /**
-         * The {@link module:core/editor/editorui~EditorUI#_editableElements `EditorUI#_editableElements`} property has been
-         * deprecated and will be removed in the near future. Please use {@link #setEditableElement `setEditableElement()`} and
-         * {@link #getEditableElement `getEditableElement()`} methods instead.
-         *
-         * @error editor-ui-deprecated-editable-elements
-         * @param {module:core/editor/editorui~EditorUI} editorUI Editor UI instance the deprecated property belongs to.
-         */
-        console.warn('editor-ui-deprecated-editable-elements: ' +
-            'The EditorUI#_editableElements property has been deprecated and will be removed in the near future.', { editorUI: this });
-        return this._editableElementsMap;
-    }
-    /**
-     * Returns viewport offsets object:
-     *
-     * ```js
-     * {
-     * 	top: Number,
-     * 	right: Number,
-     * 	bottom: Number,
-     * 	left: Number
-     * }
-     * ```
-     *
-     * Only top property is currently supported.
-     *
-     * @private
-     * @return {Object}
-     */
-    _readViewportOffsetFromConfig() {
-        const editor = this.editor;
-        const viewportOffsetConfig = editor.config.get('ui.viewportOffset');
-        if (viewportOffsetConfig) {
-            return viewportOffsetConfig;
-        }
-        // Not present in EditorConfig type, because it's legacy. Hence the `as` expression.
-        const legacyOffsetConfig = editor.config.get('toolbar.viewportTopOffset');
-        // Fall back to deprecated toolbar config.
-        if (legacyOffsetConfig) {
-            /**
-             * The {@link module:core/editor/editorconfig~EditorConfig#toolbar `EditorConfig#toolbar.viewportTopOffset`}
-             * property has been deprecated and will be removed in the near future. Please use
-             * {@link module:core/editor/editorconfig~EditorConfig#ui `EditorConfig#ui.viewportOffset`} instead.
-             *
-             * @error editor-ui-deprecated-viewport-offset-config
-             */
-            console.warn('editor-ui-deprecated-viewport-offset-config: ' +
-                'The `toolbar.vieportTopOffset` configuration option is deprecated. ' +
-                'It will be removed from future CKEditor versions. Use `ui.viewportOffset.top` instead.');
-            return { top: legacyOffsetConfig };
-        }
-        // More keys to come in the future.
-        return { top: 0 };
-    }
-    /**
-     * Starts listening for <kbd>Alt</kbd> + <kbd>F10</kbd> and <kbd>Esc</kbd> keystrokes in the context of focusable
-     * {@link #setEditableElement editable elements} and {@link #addToolbar toolbars}
-     * to allow users navigate across the UI.
-     *
-     * @private
-     */
-    _initFocusTracking() {
-        const editor = this.editor;
-        const editingView = editor.editing.view;
-        let lastFocusedForeignElement;
-        let candidateDefinitions;
-        // Focus the next focusable toolbar on <kbd>Alt</kbd> + <kbd>F10</kbd>.
-        editor.keystrokes.set('Alt+F10', (data, cancel) => {
-            const focusedElement = this.focusTracker.focusedElement;
-            // Focus moved out of a DOM element that
-            // * is not a toolbar,
-            // * does not belong to the editing view (e.g. source editing).
-            if (Array.from(this._editableElementsMap.values()).includes(focusedElement) &&
-                !Array.from(editingView.domRoots.values()).includes(focusedElement)) {
-                lastFocusedForeignElement = focusedElement;
-            }
-            const currentFocusedToolbarDefinition = this._getCurrentFocusedToolbarDefinition();
-            // * When focusing a toolbar for the first time, set the array of definitions for successive presses of Alt+F10.
-            // This ensures, the navigation works always the same and no pair of toolbars takes over
-            // (e.g. image and table toolbars when a selected image is inside a cell).
-            // * It could be that the focus went to the toolbar by clicking a toolbar item (e.g. a dropdown). In this case,
-            // there were no candidates so they must be obtained (#12339).
-            if (!currentFocusedToolbarDefinition || !candidateDefinitions) {
-                candidateDefinitions = this._getFocusableCandidateToolbarDefinitions();
-            }
-            // In a single Alt+F10 press, check all candidates but if none were focused, don't go any further.
-            // This prevents an infinite loop.
-            for (let i = 0; i < candidateDefinitions.length; i++) {
-                const candidateDefinition = candidateDefinitions.shift();
-                // Put the first definition to the back of the array. This allows circular navigation over all toolbars
-                // on successive presses of Alt+F10.
-                candidateDefinitions.push(candidateDefinition);
-                // Don't focus the same toolbar again. If you did, this would move focus from the nth focused toolbar item back to the
-                // first item as per ToolbarView#focus() if the user navigated inside the toolbar.
-                if (candidateDefinition !== currentFocusedToolbarDefinition &&
-                    this._focusFocusableCandidateToolbar(candidateDefinition)) {
-                    // Clean up after a current visible toolbar when switching to the next one.
-                    if (currentFocusedToolbarDefinition && currentFocusedToolbarDefinition.options.afterBlur) {
-                        currentFocusedToolbarDefinition.options.afterBlur();
-                    }
-                    break;
-                }
-            }
-            cancel();
-        });
-        // Blur the focused toolbar on <kbd>Esc</kbd> and bring the focus back to its origin.
-        editor.keystrokes.set('Esc', (data, cancel) => {
-            const focusedToolbarDef = this._getCurrentFocusedToolbarDefinition();
-            if (!focusedToolbarDef) {
-                return;
-            }
-            // Bring focus back to where it came from before focusing the toolbar:
-            // 1. If it came from outside the engine view (e.g. source editing), move it there.
-            if (lastFocusedForeignElement) {
-                lastFocusedForeignElement.focus();
-                lastFocusedForeignElement = null;
-            }
-            // 2. There are two possibilities left:
-            //   2.1. It could be that the focus went from an editable element in the view (root or nested).
-            //   2.2. It could be the focus went straight to the toolbar before even focusing the editing area.
-            // In either case, just focus the view editing. The focus will land where it belongs.
-            else {
-                editor.editing.view.focus();
-            }
-            // Clean up after the toolbar if there is anything to do there.
-            if (focusedToolbarDef.options.afterBlur) {
-                focusedToolbarDef.options.afterBlur();
-            }
-            cancel();
-        });
-    }
-    /**
-     * Returns definitions of toolbars that could potentially be focused, sorted by their importance for the user.
-     *
-     * Focusable toolbars candidates are either:
-     * * already visible,
-     * * have `beforeFocus()` set in their {@link module:core/editor/editorui~FocusableToolbarDefinition definition} that suggests that
-     * they might show up when called. Keep in mind that determining whether a toolbar will show up (and become focusable) is impossible
-     * at this stage because it depends on its implementation, that in turn depends on the editing context (selection).
-     *
-     * **Note**: Contextual toolbars take precedence over regular toolbars.
-     *
-     * @private
-     * @returns {Array.<module:core/editor/editorui~FocusableToolbarDefinition>}
-     */
-    _getFocusableCandidateToolbarDefinitions() {
-        const definitions = [];
-        for (const toolbarDef of this._focusableToolbarDefinitions) {
-            const { toolbarView, options } = toolbarDef;
-            if (isVisible(toolbarView.element) || options.beforeFocus) {
-                definitions.push(toolbarDef);
-            }
-        }
-        // Contextual and already visible toolbars have higher priority. If both are true, the toolbar will always focus first.
-        // For instance, a selected widget toolbar vs inline editor toolbar: both are visible but the widget toolbar is contextual.
-        definitions.sort((defA, defB) => getToolbarDefinitionWeight(defA) - getToolbarDefinitionWeight(defB));
-        return definitions;
-    }
-    /**
-     * Returns a definition of the toolbar that is currently visible and focused (one of its children has focus).
-     *
-     * `null` is returned when no toolbar is currently focused.
-     *
-     * @private
-     * @returns {module:core/editor/editorui~FocusableToolbarDefinition|null}
-     */
-    _getCurrentFocusedToolbarDefinition() {
-        for (const definition of this._focusableToolbarDefinitions) {
-            if (definition.toolbarView.element && definition.toolbarView.element.contains(this.focusTracker.focusedElement)) {
-                return definition;
-            }
-        }
-        return null;
-    }
-    /**
-     * Focuses a focusable toolbar candidate using its definition.
-     *
-     * @private
-     * @param {module:core/editor/editorui~FocusableToolbarDefinition} candidateToolbarDefinition A definition of the toolbar to focus.
-     * @returns {Boolean} `true` when the toolbar candidate was focused. `false` otherwise.
-     */
-    _focusFocusableCandidateToolbar(candidateToolbarDefinition) {
-        const { toolbarView, options: { beforeFocus } } = candidateToolbarDefinition;
-        if (beforeFocus) {
-            beforeFocus();
-        }
-        // If it didn't show up after beforeFocus(), it's not focusable at all.
-        if (!isVisible(toolbarView.element)) {
-            return false;
-        }
-        toolbarView.focus();
-        return true;
-    }
-}
-/**
- * An instance of a focusable toolbar view.
- *
- * @member {module:ui/toolbar/toolbarview~ToolbarView} #toolbarView
- */
-/**
- * Options of a focusable toolbar view:
- *
- * * `isContextual`: Marks the higher priority toolbar. For example when there are 2 visible toolbars,
- * it allows to distinguish which toolbar should be focused first after the `alt+f10` keystroke
- * * `beforeFocus`: A callback executed before the `ToolbarView` gains focus upon the `Alt+F10` keystroke.
- * * `afterBlur`: A callback executed after `ToolbarView` loses focus upon `Esc` keystroke but before the focus goes back to the `origin`.
- *
- * @member {Object} #options
- */
-// Returns a number (weight) for a toolbar definition. Visible toolbars have a higher priority and so do
-// contextual toolbars (displayed in the context of a content, for instance, an image toolbar).
-//
-// A standard invisible toolbar is the heaviest. A visible contextual toolbar is the lightest.
-//
-// @private
-// @param {module:core/editor/editorui~FocusableToolbarDefinition} toolbarDef A toolbar definition to be weighted.
-// @returns {Number}
-function getToolbarDefinitionWeight(toolbarDef) {
-    const { toolbarView, options } = toolbarDef;
-    let weight = 10;
-    // Prioritize already visible toolbars. They should get focused first.
-    if (isVisible(toolbarView.element)) {
-        weight--;
-    }
-    // Prioritize contextual toolbars. They are displayed at the selection.
-    if (options.isContextual) {
-        weight--;
-    }
-    return weight;
-}