@ckeditor/ckeditor5-core 47.3.0 → 47.4.0-alpha.1

package/src/editingkeystrokehandler.js

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

package/src/editor/editor.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { Config, type Locale, type LocaleTranslate } from '@ckeditor/ckeditor5-utils';
@@ -243,6 +243,14 @@ export declare abstract class Editor extends /* #__PURE__ */ Editor_base {
      * A set of lock IDs for the {@link #isReadOnly} getter.
      */
     protected readonly _readOnlyLocks: Set<symbol | string>;
+    /**
+     * `Editor` class is commonly put in `config.plugins` array.
+     *
+     * This property helps with better error detection.
+     *
+     * @internal
+     */
+    static get _throwErrorWhenUsedAsAPlugin(): true;
     /**
      * Creates a new instance of the editor class.
      *

package/src/editor/editor.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
@@ -220,6 +220,17 @@ export class Editor extends /* #__PURE__ */ ObservableMixin() {
      * A set of lock IDs for the {@link #isReadOnly} getter.
      */
     _readOnlyLocks;
+    /**
+     * `Editor` class is commonly put in `config.plugins` array.
+     *
+     * This property helps with better error detection.
+     *
+     * @internal
+     */
+    static get _throwErrorWhenUsedAsAPlugin() {
+        return true;
+    }
+    ;
     /**
      * Creates a new instance of the editor class.
      *
@@ -229,6 +240,19 @@ export class Editor extends /* #__PURE__ */ ObservableMixin() {
      */
     constructor(config = {}) {
         super();
+        if (typeof config !== 'object' || Array.isArray(config)) {
+            /**
+             * Editor configuration must be an object.
+             *
+             * A common cause of this error is passing an Editor class (for example
+             * `ClassicEditor`) in the `config.plugins` array. In such case, the editor
+             * constructor is called with an Editor or Context instance instead of
+             * the configuration object.
+             *
+             * @error editor-config-invalid-type
+             */
+            throw new CKEditorError('editor-config-invalid-type');
+        }
         if ('sanitizeHtml' in config) {
             /**
              * Configuration property `config.sanitizeHtml` was removed in CKEditor version 43.1.0 and is no longer supported.

package/src/editor/editorconfig.d.ts

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

package/src/editor/editorconfig.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 export {};

package/src/editor/utils/attachtoform.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import type { Editor } from '../editor.js';

package/src/editor/utils/attachtoform.js

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

package/src/editor/utils/editorusagedata.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { type Editor } from '../editor.js';

package/src/editor/utils/editorusagedata.js

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

package/src/editor/utils/elementapimixin.d.ts

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

package/src/editor/utils/elementapimixin.js

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

package/src/editor/utils/securesourceelement.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import type { Editor } from '../editor.js';

package/src/editor/utils/securesourceelement.js

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

package/src/index.d.ts

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

package/src/index.js

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

package/src/multicommand.d.ts

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

package/src/multicommand.js

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

package/src/pendingactions.d.ts

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

package/src/pendingactions.js

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

package/src/plugin.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { type Editor } from './editor/editor.js';

package/src/plugin.js

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

package/src/plugincollection.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import type { LoadedPlugins, PluginClassConstructor, PluginConstructor, PluginInterface } from './plugin.js';

package/src/plugincollection.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
@@ -139,7 +139,7 @@ export class PluginCollection extends /* #__PURE__ */ EmitterMixin() {
      *   * Both plugins must not depend on other plugins.
      * @returns A promise which gets resolved once all plugins are loaded and available in the collection.
      */
-    init(plugins, pluginsToRemove = [], pluginsSubstitutions = []) {
+    async init(plugins, pluginsToRemove = [], pluginsSubstitutions = []) {
         // Plugin initialization procedure consists of 2 main steps:
         // 1) collecting all available plugin constructors,
         // 2) verification whether all required plugins can be instantiated.
@@ -163,9 +163,9 @@ export class PluginCollection extends /* #__PURE__ */ EmitterMixin() {
         const pluginConstructors = [...getPluginConstructors(pluginsToLoad)];
         substitutePlugins(pluginConstructors, pluginsSubstitutions);
         const pluginInstances = loadPlugins(pluginConstructors);
-        return initPlugins(pluginInstances, 'init')
-            .then(() => initPlugins(pluginInstances, 'afterInit'))
-            .then(() => pluginInstances);
+        await initPlugins(pluginInstances, 'init');
+        await initPlugins(pluginInstances, 'afterInit');
+        return pluginInstances;
         function isPluginConstructor(plugin) {
             return typeof plugin === 'function';
         }
@@ -235,11 +235,29 @@ export class PluginCollection extends /* #__PURE__ */ EmitterMixin() {
                     that._availablePlugins.get(plugin) || plugin;
             })
                 .forEach(plugin => {
+                checkPluginConstructor(plugin);
                 checkMissingPlugin(plugin, parentPluginConstructor);
                 checkContextPlugin(plugin, parentPluginConstructor);
                 checkRemovedPlugin(plugin, parentPluginConstructor);
             });
         }
+        function checkPluginConstructor(plugin) {
+            if (typeof plugin !== 'function') {
+                return;
+            }
+            if (plugin._throwErrorWhenUsedAsAPlugin) {
+                /**
+                 * The provided class constructor is not a plugin.
+                 *
+                 * This error is usually caused by passing an editor, context, or command
+                 * constructor in the `config.plugins` array.
+                 *
+                 * @param {String} name The name of the provided constructor.
+                 * @error plugincollection-plugin-invalid-constructor
+                 */
+                throw new CKEditorError('plugincollection-plugin-invalid-constructor', context, { name: plugin.name });
+            }
+        }
         function checkMissingPlugin(plugin, parentPluginConstructor) {
             if (isPluginConstructor(plugin)) {
                 return;

package/src/typings.d.ts

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

package/src/typings.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 export {};

package/theme/core.css

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