@ckeditor/ckeditor5-core 35.4.0 → 36.0.1

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.4.0",
+  "version": "36.0.1",
   "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.4.0",
-    "@ckeditor/ckeditor5-ui": "^35.4.0",
-    "@ckeditor/ckeditor5-utils": "^35.4.0",
+    "@ckeditor/ckeditor5-engine": "^36.0.1",
+    "@ckeditor/ckeditor5-utils": "^36.0.1",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-autoformat": "^35.4.0",
-    "@ckeditor/ckeditor5-basic-styles": "^35.4.0",
-    "@ckeditor/ckeditor5-block-quote": "^35.4.0",
-    "@ckeditor/ckeditor5-editor-classic": "^35.4.0",
-    "@ckeditor/ckeditor5-essentials": "^35.4.0",
-    "@ckeditor/ckeditor5-heading": "^35.4.0",
-    "@ckeditor/ckeditor5-image": "^35.4.0",
-    "@ckeditor/ckeditor5-indent": "^35.4.0",
-    "@ckeditor/ckeditor5-link": "^35.4.0",
-    "@ckeditor/ckeditor5-list": "^35.4.0",
-    "@ckeditor/ckeditor5-media-embed": "^35.4.0",
-    "@ckeditor/ckeditor5-paragraph": "^35.4.0",
-    "@ckeditor/ckeditor5-table": "^35.4.0",
+    "@ckeditor/ckeditor5-autoformat": "^36.0.1",
+    "@ckeditor/ckeditor5-basic-styles": "^36.0.1",
+    "@ckeditor/ckeditor5-block-quote": "^36.0.1",
+    "@ckeditor/ckeditor5-editor-classic": "^36.0.1",
+    "@ckeditor/ckeditor5-essentials": "^36.0.1",
+    "@ckeditor/ckeditor5-heading": "^36.0.1",
+    "@ckeditor/ckeditor5-image": "^36.0.1",
+    "@ckeditor/ckeditor5-indent": "^36.0.1",
+    "@ckeditor/ckeditor5-link": "^36.0.1",
+    "@ckeditor/ckeditor5-list": "^36.0.1",
+    "@ckeditor/ckeditor5-media-embed": "^36.0.1",
+    "@ckeditor/ckeditor5-paragraph": "^36.0.1",
+    "@ckeditor/ckeditor5-table": "^36.0.1",
+    "@ckeditor/ckeditor5-ui": "^36.0.1",
     "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"

package/src/command.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/commandcollection.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/context.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/contextplugin.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/editingkeystrokehandler.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/editor.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/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,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
  */
 import { isFunction } from 'lodash-es';

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,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
  */
 /* eslint-disable @typescript-eslint/explicit-module-boundary-types */

package/src/editor/utils/securesourceelement.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
  */
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';

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,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
  */
 import Command from './command';

package/src/pendingactions.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
  */
 /**
@@ -43,7 +43,7 @@ import { CKEditorError, Collection, ObservableMixin } from '@ckeditor/ckeditor5-
  *
  * 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
  */

package/src/plugin.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
  */
 /* eslint-disable @typescript-eslint/no-invalid-void-type */

package/src/plugincollection.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/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
- */
-// TODO: can't import it from `@ckeditor/ckeditor5-ui` because of indirect circular dependency
-// between `@ckeditor/ckeditor5-{ui,core}/src/index.ts`.
-import ComponentFactory from '@ckeditor/ckeditor5-ui/src/componentfactory';
-import TooltipManager from '@ckeditor/ckeditor5-ui/src/tooltipmanager';
-import { ObservableMixin, isVisible, FocusTracker } from '@ckeditor/ckeditor5-utils';
-/**
- * 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 ObservableMixin() {
-    /**
-     * 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;
-}