@ckeditor/ckeditor5-utils 34.0.0 → 35.0.0

package/src/priorities.js

@@ -1,44 +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
- */
-
-/**
- * @module utils/priorities
- */
-
-/**
- * String representing a priority value.
- *
- * @typedef {'highest'|'high'|'normal'|'low'|'lowest'} module:utils/priorities~PriorityString
- */
-
-/**
- * Provides group of constants to use instead of hardcoding numeric priority values.
- *
- * @namespace
- */
-const priorities = {
-	/**
-	 * Converts a string with priority name to it's numeric value. If `Number` is given, it just returns it.
-	 *
-	 * @static
-	 * @param {module:utils/priorities~PriorityString|Number} priority Priority to convert.
-	 * @returns {Number} Converted priority.
-	 */
-	get( priority ) {
-		if ( typeof priority != 'number' ) {
-			return this[ priority ] || this.normal;
-		} else {
-			return priority;
-		}
-	},
-
-	highest: 100000,
-	high: 1000,
-	normal: 0,
-	low: -1000,
-	lowest: -100000
-};
-
-export default priorities;

package/src/spy.js

@@ -1,25 +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
- */
-
-/**
- * @module utils/spy
- */
-
-/**
- * Creates a spy function (ala Sinon.js) that can be used to inspect call to it.
- *
- * The following are the present features:
- *
- * * spy.called: property set to `true` if the function has been called at least once.
- *
- * @returns {Function} The spy function.
- */
-function spy() {
-	return function spy() {
-		spy.called = true;
-	};
-}
-
-export default spy;

package/src/toarray.js

@@ -1,18 +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
- */
-
-/**
- * @module utils/toarray
- */
-
-/**
- * Transforms any value to an array. If the provided value is already an array, it is returned unchanged.
- *
- * @param {*} data The value to transform to an array.
- * @returns {Array} An array created from data.
- */
-export default function toArray( data ) {
-	return Array.isArray( data ) ? data : [ data ];
-}

package/src/tomap.js

@@ -1,29 +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
- */
-
-/**
- * @module utils/tomap
- */
-
-import objectToMap from './objecttomap';
-import isIterable from './isiterable';
-
-/**
- * Transforms object or iterable to map. Iterable needs to be in the format acceptable by the `Map` constructor.
- *
- *		map = toMap( { 'foo': 1, 'bar': 2 } );
- *		map = toMap( [ [ 'foo', 1 ], [ 'bar', 2 ] ] );
- *		map = toMap( anotherMap );
- *
- * @param {Object|Iterable} data Object or iterable to transform.
- * @returns {Map} Map created from data.
- */
-export default function toMap( data ) {
-	if ( isIterable( data ) ) {
-		return new Map( data );
-	} else {
-		return objectToMap( data );
-	}
-}

package/src/translation-service.js

@@ -1,216 +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
- */
-
-/* globals window */
-
-/**
- * @module utils/translation-service
- */
-
-import CKEditorError from './ckeditorerror';
-
-/* istanbul ignore else */
-if ( !window.CKEDITOR_TRANSLATIONS ) {
-	window.CKEDITOR_TRANSLATIONS = {};
-}
-
-/**
- * Adds translations to existing ones or overrides the existing translations. These translations will later
- * be available for the {@link module:utils/locale~Locale#t `t()`} function.
- *
- * The `translations` is an object which consists of `messageId: translation` pairs. Note that the message ID can be
- * either constructed from the message string or from the message ID if it was passed
- * (this happens rarely and mostly for short messages or messages with placeholders).
- * Since the editor displays only the message string, the message ID can be found either in the source code or in the
- * built translations for another language.
- *
- *		add( 'pl', {
- *			'Cancel': 'Anuluj',
- *			'IMAGE': 'obraz', // Note that the `IMAGE` comes from the message ID, while the string can be `image`.
- *		} );
- *
- * If the message is supposed to support various plural forms, make sure to provide an array with the singular form and all plural forms:
- *
- *		add( 'pl', {
- *	 		'Add space': [ 'Dodaj spację', 'Dodaj %0 spacje', 'Dodaj %0 spacji' ]
- * 		} );
- *
- * You should also specify the third argument (the `getPluralForm()` function) that will be used to determine the plural form if no
- * language file was loaded for that language. All language files coming from CKEditor 5 sources will have this option set, so
- * these plural form rules will be reused by other translations added to the registered languages. The `getPluralForm()` function
- * can return either a Boolean or a number.
- *
- * 		add( 'en', {
- *	 		// ... Translations.
- * 		}, n => n !== 1 );
- * 		add( 'pl', {
- *	 		// ... Translations.
- * 		}, n => n == 1 ? 0 : n % 10 >= 2 && n % 10 <= 4 && ( n % 100 < 10 || n % 100 >= 20 ) ? 1 : 2 );
- *
- * All translations extend the global `window.CKEDITOR_TRANSLATIONS` object. An example of this object can be found below:
- *
- * 		{
- * 			pl: {
- *				dictionary: {
- *					'Cancel': 'Anuluj',
- *					'Add space': [ 'Dodaj spację', 'Dodaj %0 spacje', 'Dodaj %0 spacji' ]
- *				},
- *				// A function that returns the plural form index.
- *				getPluralForm: n => n !==1
- *			}
- *			// Other languages.
- *		}
- *
- * If you cannot import this function from this module (e.g. because you use a CKEditor 5 build), you can
- * still add translations by extending the global `window.CKEDITOR_TRANSLATIONS` object by using a function like
- * the one below:
- *
- *		function addTranslations( language, translations, getPluralForm ) {
- *			if ( !window.CKEDITOR_TRANSLATIONS ) {
- *				window.CKEDITOR_TRANSLATIONS = {};
- *			}
-
- *			if ( !window.CKEDITOR_TRANSLATIONS[ language ] ) {
- *				window.CKEDITOR_TRANSLATIONS[ language ] = {};
- *			}
- *
- *			const languageTranslations = window.CKEDITOR_TRANSLATIONS[ language ];
- *
- * 			languageTranslations.dictionary = languageTranslations.dictionary || {};
- * 			languageTranslations.getPluralForm = getPluralForm || languageTranslations.getPluralForm;
- *
- *			// Extend the dictionary for the given language.
- *			Object.assign( languageTranslations.dictionary, translations );
- *		}
- *
- * @param {String} language Target language.
- * @param {Object.<String,*>} translations An object with translations which will be added to the dictionary.
- * For each message ID the value should be either a translation or an array of translations if the message
- * should support plural forms.
- * @param {Function} getPluralForm A function that returns the plural form index (a number).
- */
-export function add( language, translations, getPluralForm ) {
-	if ( !window.CKEDITOR_TRANSLATIONS[ language ] ) {
-		window.CKEDITOR_TRANSLATIONS[ language ] = {};
-	}
-
-	const languageTranslations = window.CKEDITOR_TRANSLATIONS[ language ];
-
-	languageTranslations.dictionary = languageTranslations.dictionary || {};
-	languageTranslations.getPluralForm = getPluralForm || languageTranslations.getPluralForm;
-
-	Object.assign( languageTranslations.dictionary, translations );
-}
-
-/**
- * **Note:** This method is internal, use {@link module:utils/locale~Locale#t the `t()` function} instead to translate
- * the editor UI parts.
- *
- * This function is responsible for translating messages to the specified language. It uses translations added perviously
- * by {@link module:utils/translation-service~add} (a translations dictionary and the `getPluralForm()` function
- * to provide accurate translations of plural forms).
- *
- * When no translation is defined in the dictionary or the dictionary does not exist, this function returns
- * the original message string or the message plural depending on the number of elements.
- *
- *		translate( 'pl', { string: 'Cancel' } ); // 'Cancel'
- *
- * The third optional argument is the number of elements, based on which the single form or one of the plural forms
- * should be picked when the message is supposed to support various plural forms.
- *
- * 		translate( 'en', { string: 'Add a space', plural: 'Add %0 spaces' }, 1 ); // 'Add a space'
- * 		translate( 'en', { string: 'Add a space', plural: 'Add %0 spaces' }, 3 ); // 'Add %0 spaces'
- *
- * The message should provide an ID using the `id` property when the message strings are not unique and their
- * translations should be different.
- *
- *		translate( 'en', { string: 'image', id: 'ADD_IMAGE' } );
- *		translate( 'en', { string: 'image', id: 'AN_IMAGE' } );
- *
- * @protected
- * @param {String} language Target language.
- * @param {module:utils/translation-service~Message} message A message that will be translated.
- * @param {Number} [quantity] The number of elements for which a plural form should be picked from the target language dictionary.
- * @returns {String} Translated sentence.
- */
-export function _translate( language, message, quantity = 1 ) {
-	if ( typeof quantity !== 'number' ) {
-		/**
-		 * An incorrect value was passed to the translation function. This was probably caused
-		 * by an incorrect message interpolation of a plural form. Note that for messages supporting plural forms
-		 * the second argument of the `t()` function should always be a number or an array with a number as the first element.
-		 *
-		 * @error translation-service-quantity-not-a-number
-		 */
-		throw new CKEditorError( 'translation-service-quantity-not-a-number', null, { quantity } );
-	}
-
-	const numberOfLanguages = getNumberOfLanguages();
-
-	if ( numberOfLanguages === 1 ) {
-		// Override the language to the only supported one.
-		// This can't be done in the `Locale` class, because the translations comes after the `Locale` class initialization.
-		language = Object.keys( window.CKEDITOR_TRANSLATIONS )[ 0 ];
-	}
-
-	const messageId = message.id || message.string;
-
-	if ( numberOfLanguages === 0 || !hasTranslation( language, messageId ) ) {
-		if ( quantity !== 1 ) {
-			// Return the default plural form that was passed in the `message.plural` parameter.
-			return message.plural;
-		}
-
-		return message.string;
-	}
-
-	const dictionary = window.CKEDITOR_TRANSLATIONS[ language ].dictionary;
-	const getPluralForm = window.CKEDITOR_TRANSLATIONS[ language ].getPluralForm || ( n => n === 1 ? 0 : 1 );
-
-	if ( typeof dictionary[ messageId ] === 'string' ) {
-		return dictionary[ messageId ];
-	}
-
-	const pluralFormIndex = Number( getPluralForm( quantity ) );
-
-	// Note: The `translate` function is not responsible for replacing `%0, %1, ...` with values.
-	return dictionary[ messageId ][ pluralFormIndex ];
-}
-
-/**
- * Clears dictionaries for test purposes.
- *
- * @protected
- */
-export function _clear() {
-	window.CKEDITOR_TRANSLATIONS = {};
-}
-
-// Checks whether the dictionary exists and translation in that dictionary exists.
-function hasTranslation( language, messageId ) {
-	return (
-		!!window.CKEDITOR_TRANSLATIONS[ language ] &&
-		!!window.CKEDITOR_TRANSLATIONS[ language ].dictionary[ messageId ]
-	);
-}
-
-function getNumberOfLanguages() {
-	return Object.keys( window.CKEDITOR_TRANSLATIONS ).length;
-}
-
-/**
- * The internationalization message interface. A message that implements this interface can be passed to the `t()` function
- * to be translated to the target UI language.
- *
- * @typedef {Object} module:utils/translation-service~Message
- *
- * @property {String} string The message string to translate. Acts as a default translation if the translation for a given language
- * is not defined. When the message is supposed to support plural forms, the string should be the English singular form of the message.
- * @property {String} [id] The message ID. If passed, the message ID is taken from this property instead of the `message.string`.
- * This property is useful when various messages share the same message string, for example, the `editor` string in `in the editor`
- * and `my editor` sentences.
- * @property {String} [plural] The plural form of the message. This property should be skipped when a message is not supposed
- * to support plural forms. Otherwise it should always be set to a string with the English plural form of the message.
- */

package/src/uid.js

@@ -1,59 +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
- */
-
-/**
- * @module utils/uid
- */
-
-// A hash table of hex numbers to avoid using toString() in uid() which is costly.
-// [ '00', '01', '02', ..., 'fe', 'ff' ]
-const HEX_NUMBERS = new Array( 256 ).fill()
-	.map( ( val, index ) => ( '0' + ( index ).toString( 16 ) ).slice( -2 ) );
-
-/**
- * Returns a unique id. The id starts with an "e" character and a randomly generated string of
- * 32 alphanumeric characters.
- *
- * **Note**: The characters the unique id is built from correspond to the hex number notation
- * (from "0" to "9", from "a" to "f"). In other words, each id corresponds to an "e" followed
- * by 16 8-bit numbers next to each other.
- *
- * @returns {String} An unique id string.
- */
-export default function uid() {
-	// Let's create some positive random 32bit integers first.
-	//
-	// 1. Math.random() is a float between 0 and 1.
-	// 2. 0x100000000 is 2^32 = 4294967296.
-	// 3. >>> 0 enforces integer (in JS all numbers are floating point).
-	//
-	// For instance:
-	//		Math.random() * 0x100000000 = 3366450031.853859
-	// but
-	//		Math.random() * 0x100000000 >>> 0 = 3366450031.
-	const r1 = Math.random() * 0x100000000 >>> 0;
-	const r2 = Math.random() * 0x100000000 >>> 0;
-	const r3 = Math.random() * 0x100000000 >>> 0;
-	const r4 = Math.random() * 0x100000000 >>> 0;
-
-	// Make sure that id does not start with number.
-	return 'e' +
-		HEX_NUMBERS[ r1 >> 0 & 0xFF ] +
-		HEX_NUMBERS[ r1 >> 8 & 0xFF ] +
-		HEX_NUMBERS[ r1 >> 16 & 0xFF ] +
-		HEX_NUMBERS[ r1 >> 24 & 0xFF ] +
-		HEX_NUMBERS[ r2 >> 0 & 0xFF ] +
-		HEX_NUMBERS[ r2 >> 8 & 0xFF ] +
-		HEX_NUMBERS[ r2 >> 16 & 0xFF ] +
-		HEX_NUMBERS[ r2 >> 24 & 0xFF ] +
-		HEX_NUMBERS[ r3 >> 0 & 0xFF ] +
-		HEX_NUMBERS[ r3 >> 8 & 0xFF ] +
-		HEX_NUMBERS[ r3 >> 16 & 0xFF ] +
-		HEX_NUMBERS[ r3 >> 24 & 0xFF ] +
-		HEX_NUMBERS[ r4 >> 0 & 0xFF ] +
-		HEX_NUMBERS[ r4 >> 8 & 0xFF ] +
-		HEX_NUMBERS[ r4 >> 16 & 0xFF ] +
-		HEX_NUMBERS[ r4 >> 24 & 0xFF ];
-}

package/src/unicode.js

@@ -1,106 +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
- */
-
-/**
- * Set of utils to handle unicode characters.
- *
- * @module utils/unicode
- */
-
-/**
- * Checks whether given `character` is a combining mark.
- *
- * @param {String} character Character to check.
- * @returns {Boolean}
- */
-export function isCombiningMark( character ) {
-	// eslint-disable-next-line no-misleading-character-class
-	return !!character && character.length == 1 && /[\u0300-\u036f\u1ab0-\u1aff\u1dc0-\u1dff\u20d0-\u20ff\ufe20-\ufe2f]/.test( character );
-}
-
-/**
- * Checks whether given `character` is a high half of surrogate pair.
- *
- * Using UTF-16 terminology, a surrogate pair denotes UTF-16 character using two UTF-8 characters. The surrogate pair
- * consist of high surrogate pair character followed by low surrogate pair character.
- *
- * @param {String} character Character to check.
- * @returns {Boolean}
- */
-export function isHighSurrogateHalf( character ) {
-	return !!character && character.length == 1 && /[\ud800-\udbff]/.test( character );
-}
-
-/**
- * Checks whether given `character` is a low half of surrogate pair.
- *
- * Using UTF-16 terminology, a surrogate pair denotes UTF-16 character using two UTF-8 characters. The surrogate pair
- * consist of high surrogate pair character followed by low surrogate pair character.
- *
- * @param {String} character Character to check.
- * @returns {Boolean}
- */
-export function isLowSurrogateHalf( character ) {
-	return !!character && character.length == 1 && /[\udc00-\udfff]/.test( character );
-}
-
-/**
- * Checks whether given offset in a string is inside a surrogate pair (between two surrogate halves).
- *
- * @param {String} string String to check.
- * @param {Number} offset Offset to check.
- * @returns {Boolean}
- */
-export function isInsideSurrogatePair( string, offset ) {
-	return isHighSurrogateHalf( string.charAt( offset - 1 ) ) && isLowSurrogateHalf( string.charAt( offset ) );
-}
-
-/**
- * Checks whether given offset in a string is between base character and combining mark or between two combining marks.
- *
- * @param {String} string String to check.
- * @param {Number} offset Offset to check.
- * @returns {Boolean}
- */
-export function isInsideCombinedSymbol( string, offset ) {
-	return isCombiningMark( string.charAt( offset ) );
-}
-
-const EMOJI_PATTERN = buildEmojiRegexp();
-
-/**
- * Checks whether given offset in a string is inside multi-character emoji sequence.
- *
- * @param {String} string String to check.
- * @param {Number} offset Offset to check.
- * @returns {Boolean}
- */
-export function isInsideEmojiSequence( string, offset ) {
-	const matches = String( string ).matchAll( EMOJI_PATTERN );
-
-	return Array.from( matches ).some( match => match.index < offset && offset < match.index + match[ 0 ].length );
-}
-
-function buildEmojiRegexp() {
-	const parts = [
-		// Emoji Tag Sequence (ETS)
-		/\p{Emoji}[\u{E0020}-\u{E007E}]+\u{E007F}/u,
-
-		// Emoji Keycap Sequence
-		/\p{Emoji}\u{FE0F}?\u{20E3}/u,
-
-		// Emoji Presentation Sequence
-		/\p{Emoji}\u{FE0F}/u,
-
-		// Single-Character Emoji / Emoji Modifier Sequence
-		/(?=\p{General_Category=Other_Symbol})\p{Emoji}\p{Emoji_Modifier}*/u
-	];
-
-	const flagSequence = /\p{Regional_Indicator}{2}/u.source;
-	const emoji = '(?:' + parts.map( part => part.source ).join( '|' ) + ')';
-	const sequence = `${ flagSequence }|${ emoji }(?:\u{200D}${ emoji })*`;
-
-	return new RegExp( sequence, 'ug' );
-}

package/src/version.js

@@ -1,157 +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
- */
-
-/**
- * @module utils/version
- */
-
-/* globals window, global */
-
-import CKEditorError from './ckeditorerror';
-
-const version = '34.0.0';
-
-export default version;
-
-/* istanbul ignore next */
-const windowOrGlobal = typeof window === 'object' ? window : global;
-
-/* istanbul ignore next */
-if ( windowOrGlobal.CKEDITOR_VERSION ) {
-	/**
-	 * This error is thrown when due to a mistake in how CKEditor 5 was installed or initialized, some
-	 * of its modules were duplicated (evaluated and executed twice). Module duplication leads to inevitable runtime
-	 * errors.
-	 *
-	 * There are many situations in which some modules can be loaded twice. In the worst case scenario,
-	 * you may need to check your project for each of these issues and fix them all.
-	 *
-	 * # Trying to add a plugin to an existing build
-	 *
-	 * If you import an existing CKEditor 5 build and a plugin like this:
-	 *
-	 *		import ClassicEditor from '@ckeditor/ckeditor5-build-classic';
-	 *		import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight';
-	 *
-	 * Then your project loads some CKEditor 5 packages twice. How does it happen?
-	 *
-	 * The build package contains a file which is already compiled with webpack. This means
-	 * that it contains all the necessary code from e.g. `@ckeditor/ckeditor5-engine` and `@ckeditor/ckeditor5-utils`.
-	 *
-	 * However, the `Highlight` plugin imports some of the modules from these packages, too. If you ask webpack to
-	 * build such a project, you will end up with the modules being included (and run) twice — first, because they are
-	 * included inside the build package, and second, because they are required by the `Highlight` plugin.
-	 *
-	 * Therefore, **you must never add plugins to an existing build** unless your plugin has no dependencies.
-	 *
-	 * Adding plugins to a build is done by taking the source version of this build (so, before it was built with webpack)
-	 * and adding plugins there. In this situation, webpack will know that it only needs to load each plugin once.
-	 *
-	 * Read more in the {@glink installation/getting-started/installing-plugins "Installing plugins"} guide.
-	 *
-	 * # Confused an editor build with an editor implementation
-	 *
-	 * This scenario is very similar to the previous one, but has a different origin.
-	 *
-	 * Let's assume that you wanted to use CKEditor 5 from source, as explained in the
-	 * {@glink installation/advanced/alternative-setups/integrating-from-source "Building from source"} section
-	 * or in the {@glink framework/guides/quick-start "Quick start"} guide of CKEditor 5 Framework.
-	 *
-	 * The correct way to do so is to import an editor and plugins and run them together like this:
-	 *
-	 *		import ClassicEditor from '@ckeditor/ckeditor5-editor-classic/src/classiceditor';
-	 *		import Essentials from '@ckeditor/ckeditor5-essentials/src/essentials';
-	 *		import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph';
-	 *		import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold';
-	 *		import Italic from '@ckeditor/ckeditor5-basic-styles/src/italic';
-	 *
-	 *		ClassicEditor
-	 *			.create( document.querySelector( '#editor' ), {
-	 *				plugins: [ Essentials, Paragraph, Bold, Italic ],
-	 *				toolbar: [ 'bold', 'italic' ]
-	 *			} )
-	 *			.then( editor => {
-	 *				console.log( 'Editor was initialized', editor );
-	 *			} )
-	 *			.catch( error => {
-	 *				console.error( error.stack );
-	 *			} );
-	 *
-	 * However, you might have mistakenly imported a build instead of the source `ClassicEditor`. In this case
-	 * your imports will look like this:
-	 *
-	 *		import ClassicEditor from '@ckeditor/ckeditor5-build-classic';
-	 *		import Essentials from '@ckeditor/ckeditor5-essentials/src/essentials';
-	 *		import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph';
-	 *		import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold';
-	 *		import Italic from '@ckeditor/ckeditor5-basic-styles/src/italic';
-	 *
-	 * This creates the same situation as in the previous section because you use a build together with source plugins.
-	 *
-	 * Remember: `@ckeditor/ckeditor5-build-*` packages contain editor builds and `@ckeditor/ckeditor5-editor-*` contain source editors.
-	 *
-	 * # Loading two or more builds on one page
-	 *
-	 * If you use CKEditor 5 builds, you might have loaded two (or more) `ckeditor.js` files on one web page.
-	 * Check your web page for duplicated `<script>` elements or make sure your page builder/bundler includes CKEditor only once.
-	 *
-	 * If you want to use two different types of editors at once, see the
-	 * {@glink installation/advanced/using-two-editors "Using two different editors"}
-	 * section.
-	 *
-	 * # Using outdated packages
-	 *
-	 * Building CKEditor 5 from source requires using multiple npm packages. These packages have their dependencies
-	 * to other packages. If you use the latest version of, for example, `@ckeditor/ckeditor5-editor-classic` with
-	 * an outdated version of `@ckeditor/ckeditor5-image`, npm or yarn will need to install two different versions of
-	 * `@ckeditor/ckeditor5-core` because `@ckeditor/ckeditor5-editor-classic` and `@ckeditor/ckeditor5-image` may require
-	 * different versions of the core package.
-	 *
-	 * The solution to this issue is to update all packages to their latest version. We recommend
-	 * using tools like [`npm-check-updates`](https://www.npmjs.com/package/npm-check-updates) which simplify this process.
-	 *
-	 * # Conflicting version of dependencies
-	 *
-	 * This is a special case of the previous scenario. If you use CKEditor 5 with some third-party plugins,
-	 * it may happen that even if you use the latest versions of the official packages and the latest version of
-	 * these third-party packages, there will be a conflict between some of their dependencies.
-	 *
-	 * Such a problem can be resolved by either downgrading CKEditor 5 packages (which we do not recommend) or
-	 * asking the author of the third-party package to upgrade its depdendencies (or forking their project and doing this yourself).
-	 *
-	 * **Note:** All official CKEditor 5 packages (excluding integrations and `ckeditor5-dev-*` packages) are released in the
-	 * same major version. This is &mdash; in the `x.y.z`, the `x` is the same for all packages. This is the simplest way to check
-	 * whether you use packages coming from the same CKEditor 5 version. You can read more about versioning in the
-	 * {@glink support/versioning-policy Versioning policy} guide.
-	 *
-	 * # Packages were duplicated in `node_modules`
-	 *
-	 * In some situations, especially when calling `npm install` multiple times, it may happen
-	 * that npm will not correctly "deduplicate" packages.
-	 *
-	 * Normally, npm deduplicates all packages so, for example, `@ckeditor/ckeditor5-core` is installed only once in `node_modules/`.
-	 * However, it is known to fail to do so from time to time.
-	 *
-	 * We recommend checking if any of the steps listed below help:
-	 *
-	 * * `rm -rf node_modules && npm install` to make sure you have a clean `node_modules/` directory. This step
-	 * is known to help in most cases.
-	 * * If you use `yarn.lock` or `package-lock.json`, remove it before `npm install`.
-	 * * Check whether all CKEditor 5 packages are up to date and reinstall them
-	 * if you changed anything (`rm -rf node_modules && npm install`).
-	 *
-	 * If all packages are correct and compatible with each other, the steps above are known to help. If not, you may
-	 * try to check with `npm ls` how many times packages like `@ckeditor/ckeditor5-core`, `@ckeditor/ckeditor5-engine` and
-	 *`@ckeditor/ckeditor5-utils` are installed. If more than once, verify which package causes that.
-	 *
-	 * @error ckeditor-duplicated-modules
-	 */
-	throw new CKEditorError(
-		'ckeditor-duplicated-modules',
-		null
-	);
-} else {
-	windowOrGlobal.CKEDITOR_VERSION = version;
-}