@ckeditor/ckeditor5-core 40.0.0 → 40.2.0

package/src/editor/editorconfig.js

@@ -1,5 +1,5 @@
-/**
- * @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 {};
+/**
+ * @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.d.ts

@@ -1,15 +1,15 @@
-/**
- * @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 type { default as Editor } from '../editor';
-import type { ElementApi } from './elementapimixin';
-/**
- * Checks if the editor is initialized on a `<textarea>` element that belongs to a form. If yes, it updates the editor's element
- * content before submitting the form.
- *
- * This helper requires the {@link module:core/editor/utils/elementapimixin~ElementApi ElementApi interface}.
- *
- * @param editor Editor instance.
- */
-export default function attachToForm(editor: Editor & ElementApi): void;
+/**
+ * @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 type { default as Editor } from '../editor';
+import type { ElementApi } from './elementapimixin';
+/**
+ * Checks if the editor is initialized on a `<textarea>` element that belongs to a form. If yes, it updates the editor's element
+ * content before submitting the form.
+ *
+ * This helper requires the {@link module:core/editor/utils/elementapimixin~ElementApi ElementApi interface}.
+ *
+ * @param editor Editor instance.
+ */
+export default function attachToForm(editor: Editor & ElementApi): void;

package/src/editor/utils/attachtoform.js

@@ -1,57 +1,57 @@
-/**
- * @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/utils/attachtoform
- */
-import { isFunction } from 'lodash-es';
-import { CKEditorError } from '@ckeditor/ckeditor5-utils';
-/**
- * Checks if the editor is initialized on a `<textarea>` element that belongs to a form. If yes, it updates the editor's element
- * content before submitting the form.
- *
- * This helper requires the {@link module:core/editor/utils/elementapimixin~ElementApi ElementApi interface}.
- *
- * @param editor Editor instance.
- */
-export default function attachToForm(editor) {
-    if (!isFunction(editor.updateSourceElement)) {
-        /**
-         * The editor passed to `attachToForm()` must implement the
-         * {@link module:core/editor/utils/elementapimixin~ElementApi} interface.
-         *
-         * @error attachtoform-missing-elementapi-interface
-         */
-        throw new CKEditorError('attachtoform-missing-elementapi-interface', editor);
-    }
-    const sourceElement = editor.sourceElement;
-    // Only when replacing a textarea which is inside of a form element.
-    if (isTextArea(sourceElement) && sourceElement.form) {
-        let originalSubmit;
-        const form = sourceElement.form;
-        const onSubmit = () => editor.updateSourceElement();
-        // Replace the original form#submit() to call a custom submit function first.
-        // Check if #submit is a function because the form might have an input named "submit".
-        if (isFunction(form.submit)) {
-            originalSubmit = form.submit;
-            form.submit = () => {
-                onSubmit();
-                originalSubmit.apply(form);
-            };
-        }
-        // Update the replaced textarea with data before each form#submit event.
-        form.addEventListener('submit', onSubmit);
-        // Remove the submit listener and revert the original submit method on
-        // editor#destroy.
-        editor.on('destroy', () => {
-            form.removeEventListener('submit', onSubmit);
-            if (originalSubmit) {
-                form.submit = originalSubmit;
-            }
-        });
-    }
-}
-function isTextArea(sourceElement) {
-    return !!sourceElement && sourceElement.tagName.toLowerCase() === 'textarea';
-}
+/**
+ * @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/utils/attachtoform
+ */
+import { isFunction } from 'lodash-es';
+import { CKEditorError } from '@ckeditor/ckeditor5-utils';
+/**
+ * Checks if the editor is initialized on a `<textarea>` element that belongs to a form. If yes, it updates the editor's element
+ * content before submitting the form.
+ *
+ * This helper requires the {@link module:core/editor/utils/elementapimixin~ElementApi ElementApi interface}.
+ *
+ * @param editor Editor instance.
+ */
+export default function attachToForm(editor) {
+    if (!isFunction(editor.updateSourceElement)) {
+        /**
+         * The editor passed to `attachToForm()` must implement the
+         * {@link module:core/editor/utils/elementapimixin~ElementApi} interface.
+         *
+         * @error attachtoform-missing-elementapi-interface
+         */
+        throw new CKEditorError('attachtoform-missing-elementapi-interface', editor);
+    }
+    const sourceElement = editor.sourceElement;
+    // Only when replacing a textarea which is inside of a form element.
+    if (isTextArea(sourceElement) && sourceElement.form) {
+        let originalSubmit;
+        const form = sourceElement.form;
+        const onSubmit = () => editor.updateSourceElement();
+        // Replace the original form#submit() to call a custom submit function first.
+        // Check if #submit is a function because the form might have an input named "submit".
+        if (isFunction(form.submit)) {
+            originalSubmit = form.submit;
+            form.submit = () => {
+                onSubmit();
+                originalSubmit.apply(form);
+            };
+        }
+        // Update the replaced textarea with data before each form#submit event.
+        form.addEventListener('submit', onSubmit);
+        // Remove the submit listener and revert the original submit method on
+        // editor#destroy.
+        editor.on('destroy', () => {
+            form.removeEventListener('submit', onSubmit);
+            if (originalSubmit) {
+                form.submit = originalSubmit;
+            }
+        });
+    }
+}
+function isTextArea(sourceElement) {
+    return !!sourceElement && sourceElement.tagName.toLowerCase() === 'textarea';
+}

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

@@ -1,75 +1,75 @@
-/**
- * @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/utils/dataapimixin
- */
-import type Editor from '../editor';
-import type { Constructor, Mixed } from '@ckeditor/ckeditor5-utils';
-/**
- * Implementation of the {@link module:core/editor/utils/dataapimixin~DataApi}.
- */
-export default function DataApiMixin<Base extends Constructor<Editor>>(base: Base): Mixed<Base, DataApi>;
-/**
- * Interface defining editor methods for setting and getting data to and from the editor's main root element
- * using the {@link module:core/editor/editor~Editor#data data pipeline}.
- *
- * This interface is not a part of the {@link module:core/editor/editor~Editor} class because one may want to implement
- * an editor with multiple root elements, in which case the methods for setting and getting data will need to be implemented
- * differently.
- */
-export interface DataApi {
-    /**
-     * Sets the data in the editor.
-     *
-     * ```ts
-     * editor.setData( '<p>This is editor!</p>' );
-     * ```
-     *
-     * If your editor implementation uses multiple roots, you should pass an object with keys corresponding
-     * to the editor root names and values equal to the data that should be set in each root:
-     *
-     * ```ts
-     * editor.setData( {
-     *     header: '<p>Content for header part.</p>',
-     *     content: '<p>Content for main part.</p>',
-     *     footer: '<p>Content for footer part.</p>'
-     * } );
-     * ```
-     *
-     * By default the editor accepts HTML. This can be controlled by injecting a different data processor.
-     * See the {@glink features/markdown Markdown output} guide for more details.
-     *
-     * @param data Input data.
-     */
-    setData(data: string | Record<string, string>): void;
-    /**
-     * Gets the data from the editor.
-     *
-     * ```ts
-     * editor.getData(); // -> '<p>This is editor!</p>'
-     * ```
-     *
-     * If your editor implementation uses multiple roots, you should pass root name as one of the options:
-     *
-     * ```ts
-     * editor.getData( { rootName: 'header' } ); // -> '<p>Content for header part.</p>'
-     * ```
-     *
-     * By default, the editor outputs HTML. This can be controlled by injecting a different data processor.
-     * See the {@glink features/markdown Markdown output} guide for more details.
-     *
-     * A warning is logged when you try to retrieve data for a detached root, as most probably this is a mistake. A detached root should
-     * be treated like it is removed, and you should not save its data. Note, that the detached root data is always an empty string.
-     *
-     * @param options Additional configuration for the retrieved data.
-     * Editor features may introduce more configuration options that can be set through this parameter.
-     * @param options.rootName Root name. Default to `'main'`.
-     * @param options.trim Whether returned data should be trimmed. This option is set to `'empty'` by default,
-     * which means that whenever editor content is considered empty, an empty string is returned. To turn off trimming
-     * use `'none'`. In such cases exact content will be returned (for example `'<p>&nbsp;</p>'` for an empty editor).
-     * @returns Output data.
-     */
-    getData(options?: Record<string, unknown>): string;
-}
+/**
+ * @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/utils/dataapimixin
+ */
+import type Editor from '../editor';
+import type { Constructor, Mixed } from '@ckeditor/ckeditor5-utils';
+/**
+ * Implementation of the {@link module:core/editor/utils/dataapimixin~DataApi}.
+ */
+export default function DataApiMixin<Base extends Constructor<Editor>>(base: Base): Mixed<Base, DataApi>;
+/**
+ * Interface defining editor methods for setting and getting data to and from the editor's main root element
+ * using the {@link module:core/editor/editor~Editor#data data pipeline}.
+ *
+ * This interface is not a part of the {@link module:core/editor/editor~Editor} class because one may want to implement
+ * an editor with multiple root elements, in which case the methods for setting and getting data will need to be implemented
+ * differently.
+ */
+export interface DataApi {
+    /**
+     * Sets the data in the editor.
+     *
+     * ```ts
+     * editor.setData( '<p>This is editor!</p>' );
+     * ```
+     *
+     * If your editor implementation uses multiple roots, you should pass an object with keys corresponding
+     * to the editor root names and values equal to the data that should be set in each root:
+     *
+     * ```ts
+     * editor.setData( {
+     *     header: '<p>Content for header part.</p>',
+     *     content: '<p>Content for main part.</p>',
+     *     footer: '<p>Content for footer part.</p>'
+     * } );
+     * ```
+     *
+     * By default the editor accepts HTML. This can be controlled by injecting a different data processor.
+     * See the {@glink features/markdown Markdown output} guide for more details.
+     *
+     * @param data Input data.
+     */
+    setData(data: string | Record<string, string>): void;
+    /**
+     * Gets the data from the editor.
+     *
+     * ```ts
+     * editor.getData(); // -> '<p>This is editor!</p>'
+     * ```
+     *
+     * If your editor implementation uses multiple roots, you should pass root name as one of the options:
+     *
+     * ```ts
+     * editor.getData( { rootName: 'header' } ); // -> '<p>Content for header part.</p>'
+     * ```
+     *
+     * By default, the editor outputs HTML. This can be controlled by injecting a different data processor.
+     * See the {@glink features/markdown Markdown output} guide for more details.
+     *
+     * A warning is logged when you try to retrieve data for a detached root, as most probably this is a mistake. A detached root should
+     * be treated like it is removed, and you should not save its data. Note, that the detached root data is always an empty string.
+     *
+     * @param options Additional configuration for the retrieved data.
+     * Editor features may introduce more configuration options that can be set through this parameter.
+     * @param options.rootName Root name. Default to `'main'`.
+     * @param options.trim Whether returned data should be trimmed. This option is set to `'empty'` by default,
+     * which means that whenever editor content is considered empty, an empty string is returned. To turn off trimming
+     * use `'none'`. In such cases exact content will be returned (for example `'<p>&nbsp;</p>'` for an empty editor).
+     * @returns Output data.
+     */
+    getData(options?: Record<string, unknown>): string;
+}

package/src/editor/utils/dataapimixin.js

@@ -1,24 +1,24 @@
-/**
- * @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
- */
-/**
- * Implementation of the {@link module:core/editor/utils/dataapimixin~DataApi}.
- */
-export default function DataApiMixin(base) {
-    class Mixin extends base {
-        setData(data) {
-            this.data.set(data);
-        }
-        getData(options) {
-            return this.data.get(options);
-        }
-    }
-    return Mixin;
-}
-// Backward compatibility with `mix`.
-{
-    const mixin = DataApiMixin(Object);
-    DataApiMixin.setData = mixin.prototype.setData;
-    DataApiMixin.getData = mixin.prototype.getData;
-}
+/**
+ * @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
+ */
+/**
+ * Implementation of the {@link module:core/editor/utils/dataapimixin~DataApi}.
+ */
+export default function DataApiMixin(base) {
+    class Mixin extends base {
+        setData(data) {
+            this.data.set(data);
+        }
+        getData(options) {
+            return this.data.get(options);
+        }
+    }
+    return Mixin;
+}
+// Backward compatibility with `mix`.
+{
+    const mixin = DataApiMixin(Object);
+    DataApiMixin.setData = mixin.prototype.setData;
+    DataApiMixin.getData = mixin.prototype.getData;
+}

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

@@ -1,31 +1,35 @@
-/**
- * @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/utils/elementapimixin
- */
-import { type Constructor, type Mixed } from '@ckeditor/ckeditor5-utils';
-import type Editor from '../editor';
-/**
- * Implementation of the {@link module:core/editor/utils/elementapimixin~ElementApi}.
- */
-export default function ElementApiMixin<Base extends Constructor<Editor>>(base: Base): Mixed<Base, ElementApi>;
-/**
- * Interface describing an editor that replaced a DOM element (was "initialized on an element").
- *
- * Such an editor should provide a method to
- * {@link module:core/editor/utils/elementapimixin~ElementApi#updateSourceElement update the replaced element with the current data}.
- */
-export interface ElementApi {
-    /**
-     * The element on which the editor has been initialized.
-     *
-     * @readonly
-     */
-    sourceElement: HTMLElement | undefined;
-    /**
-     * Updates the {@link #sourceElement editor source element}'s content with the data.
-     */
-    updateSourceElement(data?: string): void;
-}
+/**
+ * @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/utils/elementapimixin
+ */
+import { type Constructor, type Mixed } from '@ckeditor/ckeditor5-utils';
+import type Editor from '../editor';
+/**
+ * Implementation of the {@link module:core/editor/utils/elementapimixin~ElementApi}.
+ */
+export default function ElementApiMixin<Base extends Constructor<Editor>>(base: Base): Mixed<Base, ElementApi>;
+/**
+ * Interface describing an editor that replaced a DOM element (was "initialized on an element").
+ *
+ * Such an editor should provide a method to
+ * {@link module:core/editor/utils/elementapimixin~ElementApi#updateSourceElement update the replaced element with the current data}.
+ */
+export interface ElementApi {
+    /**
+     * The element on which the editor has been initialized.
+     *
+     * @readonly
+     */
+    sourceElement: HTMLElement | undefined;
+    /**
+     * Updates the {@link #sourceElement editor source element}'s content with the data if the
+     * {@link module:core/editor/editorconfig~EditorConfig#updateSourceElementOnDestroy `updateSourceElementOnDestroy`}
+     * configuration option is set to `true`.
+     *
+     * @param data Data that the {@link #sourceElement editor source element} should be updated with.
+     */
+    updateSourceElement(data?: string): void;
+}

package/src/editor/utils/elementapimixin.js

@@ -1,42 +1,43 @@
-/**
- * @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/utils/elementapimixin
- */
-import { CKEditorError, setDataInElement } from '@ckeditor/ckeditor5-utils';
-/**
- * Implementation of the {@link module:core/editor/utils/elementapimixin~ElementApi}.
- */
-export default function ElementApiMixin(base) {
-    class Mixin extends base {
-        updateSourceElement(data = this.data.get()) {
-            if (!this.sourceElement) {
-                /**
-                 * Cannot update the source element of a detached editor.
-                 *
-                 * The {@link module:core/editor/utils/elementapimixin~ElementApi#updateSourceElement `updateSourceElement()`}
-                 * method cannot be called if you did not pass an element to `Editor.create()`.
-                 *
-                 * @error editor-missing-sourceelement
-                 */
-                throw new CKEditorError('editor-missing-sourceelement', this);
-            }
-            const shouldUpdateSourceElement = this.config.get('updateSourceElementOnDestroy');
-            const isSourceElementTextArea = this.sourceElement instanceof HTMLTextAreaElement;
-            // The data returned by the editor might be unsafe, so we want to prevent rendering
-            // unsafe content inside the source element different than <textarea>, which is considered
-            // secure. This behaviour could be changed by setting the `updateSourceElementOnDestroy`
-            // configuration option to `true`.
-            if (!shouldUpdateSourceElement && !isSourceElementTextArea) {
-                setDataInElement(this.sourceElement, '');
-                return;
-            }
-            setDataInElement(this.sourceElement, data);
-        }
-    }
-    return Mixin;
-}
-// Backward compatibility with `mix`.
-ElementApiMixin.updateSourceElement = ElementApiMixin(Object).prototype.updateSourceElement;
+/**
+ * @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/utils/elementapimixin
+ */
+import { CKEditorError, setDataInElement } from '@ckeditor/ckeditor5-utils';
+/**
+ * Implementation of the {@link module:core/editor/utils/elementapimixin~ElementApi}.
+ */
+export default function ElementApiMixin(base) {
+    class Mixin extends base {
+        updateSourceElement(data) {
+            if (!this.sourceElement) {
+                /**
+                 * Cannot update the source element of a detached editor.
+                 *
+                 * The {@link module:core/editor/utils/elementapimixin~ElementApi#updateSourceElement `updateSourceElement()`}
+                 * method cannot be called if you did not pass an element to `Editor.create()`.
+                 *
+                 * @error editor-missing-sourceelement
+                 */
+                throw new CKEditorError('editor-missing-sourceelement', this);
+            }
+            const shouldUpdateSourceElement = this.config.get('updateSourceElementOnDestroy');
+            const isSourceElementTextArea = this.sourceElement instanceof HTMLTextAreaElement;
+            // The data returned by the editor might be unsafe, so we want to prevent rendering
+            // unsafe content inside the source element different than <textarea>, which is considered
+            // secure. This behavior could be changed by setting the `updateSourceElementOnDestroy`
+            // configuration option to `true`.
+            if (!shouldUpdateSourceElement && !isSourceElementTextArea) {
+                setDataInElement(this.sourceElement, '');
+                return;
+            }
+            const dataToSet = typeof data === 'string' ? data : this.data.get();
+            setDataInElement(this.sourceElement, dataToSet);
+        }
+    }
+    return Mixin;
+}
+// Backward compatibility with `mix`.
+ElementApiMixin.updateSourceElement = ElementApiMixin(Object).prototype.updateSourceElement;

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

@@ -1,17 +1,17 @@
-/**
- * @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 type { default as Editor } from '../editor';
-/**
- * Marks the source element on which the editor was initialized. This prevents other editor instances from using this element.
- *
- * Running multiple editor instances on the same source element causes various issues and it is
- * crucial this helper is called as soon as the source element is known to prevent collisions.
- *
- * @param editor Editor instance.
- * @param sourceElement Element to bind with the editor instance.
- */
-export default function secureSourceElement(editor: Editor, sourceElement: HTMLElement & {
-    ckeditorInstance?: Editor;
-}): void;
+/**
+ * @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 type { default as Editor } from '../editor';
+/**
+ * Marks the source element on which the editor was initialized. This prevents other editor instances from using this element.
+ *
+ * Running multiple editor instances on the same source element causes various issues and it is
+ * crucial this helper is called as soon as the source element is known to prevent collisions.
+ *
+ * @param editor Editor instance.
+ * @param sourceElement Element to bind with the editor instance.
+ */
+export default function secureSourceElement(editor: Editor, sourceElement: HTMLElement & {
+    ckeditorInstance?: Editor;
+}): void;

package/src/editor/utils/securesourceelement.js

@@ -1,35 +1,35 @@
-/**
- * @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/utils/securesourceelement
- */
-import { CKEditorError } from '@ckeditor/ckeditor5-utils';
-/**
- * Marks the source element on which the editor was initialized. This prevents other editor instances from using this element.
- *
- * Running multiple editor instances on the same source element causes various issues and it is
- * crucial this helper is called as soon as the source element is known to prevent collisions.
- *
- * @param editor Editor instance.
- * @param sourceElement Element to bind with the editor instance.
- */
-export default function secureSourceElement(editor, sourceElement) {
-    if (sourceElement.ckeditorInstance) {
-        /**
-         * A DOM element used to create the editor (e.g.
-         * {@link module:editor-inline/inlineeditor~InlineEditor.create `InlineEditor.create()`})
-         * has already been used to create another editor instance. Make sure each editor is
-         * created with an unique DOM element.
-         *
-         * @error editor-source-element-already-used
-         * @param element DOM element that caused the collision.
-         */
-        throw new CKEditorError('editor-source-element-already-used', editor);
-    }
-    sourceElement.ckeditorInstance = editor;
-    editor.once('destroy', () => {
-        delete sourceElement.ckeditorInstance;
-    });
-}
+/**
+ * @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/utils/securesourceelement
+ */
+import { CKEditorError } from '@ckeditor/ckeditor5-utils';
+/**
+ * Marks the source element on which the editor was initialized. This prevents other editor instances from using this element.
+ *
+ * Running multiple editor instances on the same source element causes various issues and it is
+ * crucial this helper is called as soon as the source element is known to prevent collisions.
+ *
+ * @param editor Editor instance.
+ * @param sourceElement Element to bind with the editor instance.
+ */
+export default function secureSourceElement(editor, sourceElement) {
+    if (sourceElement.ckeditorInstance) {
+        /**
+         * A DOM element used to create the editor (e.g.
+         * {@link module:editor-inline/inlineeditor~InlineEditor.create `InlineEditor.create()`})
+         * has already been used to create another editor instance. Make sure each editor is
+         * created with an unique DOM element.
+         *
+         * @error editor-source-element-already-used
+         * @param element DOM element that caused the collision.
+         */
+        throw new CKEditorError('editor-source-element-already-used', editor);
+    }
+    sourceElement.ckeditorInstance = editor;
+    editor.once('destroy', () => {
+        delete sourceElement.ckeditorInstance;
+    });
+}