@ckeditor/ckeditor5-utils 47.6.1 → 48.0.0-alpha.1

package/src/splicearray.js

@@ -1,37 +0,0 @@
-/**
- * @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
- */
-/**
- * @module utils/splicearray
- */
-/**
- * Splices one array into another. To be used instead of `Array.prototype.splice` for better
- * performance and because the latter may throw "Maximum call stack size exceeded" error when
- * passing huge number of items to insert.
- *
- * ```ts
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 0 );	// [ 3, 4, 1, 2 ]
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 1 );	// [ 1, 3, 4, 2 ]
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 2 );	// [ 1, 2, 3, 4 ]
- * spliceArray( [ 1, 2 ], [],       0 );	// [ 1, 2 ]
- * ```
- *
- * @param targetArray Array to be spliced.
- * @param insertArray Array of elements to be inserted to target.
- * @param index Index at which nodes should be inserted.
- *
- * @returns New spliced array.
- */
-export function spliceArray(targetArray, insertArray, index) {
-    const originalLength = targetArray.length;
-    const insertLength = insertArray.length;
-    // Shift elements in the target array to make space for insertArray
-    for (let i = originalLength - 1; i >= index; i--) {
-        targetArray[i + insertLength] = targetArray[i];
-    }
-    // Copy elements from insertArray into the target array
-    for (let i = 0; i < insertLength; i++) {
-        targetArray[index + i] = insertArray[i];
-    }
-}

package/src/spy.js

@@ -1,21 +0,0 @@
-/**
- * @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
- */
-/**
- * @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 The spy function.
- */
-export function spy() {
-    return function spy() {
-        spy.called = true;
-    };
-}

package/src/toarray.js

@@ -1,7 +0,0 @@
-/**
- * @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 function toArray(data) {
-    return Array.isArray(data) ? data : [data];
-}

package/src/tomap.js

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

package/src/translation-service.js

@@ -1,209 +0,0 @@
-/**
- * @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 { CKEditorError } from './ckeditorerror.js';
-import { global } from './dom/global.js';
-import { merge } from 'es-toolkit/compat';
-/* istanbul ignore else -- @preserve */
-if (!global.window.CKEDITOR_TRANSLATIONS) {
-    global.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.
- *
- * ```ts
- * 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:
- *
- * ```ts
- * 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.
- *
- * ```ts
- * 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:
- *
- * ```ts
- * {
- * 	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 ? 0 : n % 10 >= 2 && n % 10 <= 4 && ( n % 100 < 10 || n % 100 >= 20 ) ? 1 : 2 );
- * 	}
- * 	// 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:
- *
- * ```ts
- * function addTranslations( language, translations, getPluralForm ) {
- * 	if ( !global.window.CKEDITOR_TRANSLATIONS ) {
- * 		global.window.CKEDITOR_TRANSLATIONS = {};
- * 	}
-
- * 	if ( !global.window.CKEDITOR_TRANSLATIONS[ language ] ) {
- * 		global.window.CKEDITOR_TRANSLATIONS[ language ] = {};
- * 	}
- *
- * 	const languageTranslations = global.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 language Target language.
- * @param 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 getPluralForm A function that returns the plural form index (a number).
- */
-export function add(language, translations, getPluralForm) {
-    if (!global.window.CKEDITOR_TRANSLATIONS[language]) {
-        global.window.CKEDITOR_TRANSLATIONS[language] = {};
-    }
-    const languageTranslations = global.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.
- *
- * ```ts
- * 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.
- *
- * ```ts
- * 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.
- *
- * ```ts
- * translate( 'en', { string: 'image', id: 'ADD_IMAGE' } );
- * translate( 'en', { string: 'image', id: 'AN_IMAGE' } );
- * ```
- *
- * @internal
- * @param language Target language.
- * @param message A message that will be translated.
- * @param quantity The number of elements for which a plural form should be picked from the target language dictionary.
- * @param translations Translations passed in editor config, if not provided use the global `window.CKEDITOR_TRANSLATIONS`.
- * @returns Translated sentence.
- */
-export function _translate(language, message, quantity = 1, translations) {
-    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 normalizedTranslations = translations || global.window.CKEDITOR_TRANSLATIONS;
-    const numberOfLanguages = getNumberOfLanguages(normalizedTranslations);
-    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(normalizedTranslations)[0];
-    }
-    const messageId = message.id || message.string;
-    if (numberOfLanguages === 0 || !hasTranslation(language, messageId, normalizedTranslations)) {
-        if (quantity !== 1) {
-            // Return the default plural form that was passed in the `message.plural` parameter.
-            return message.plural;
-        }
-        return message.string;
-    }
-    const dictionary = normalizedTranslations[language].dictionary;
-    const getPluralForm = normalizedTranslations[language].getPluralForm || (n => n === 1 ? 0 : 1);
-    const translation = dictionary[messageId];
-    if (typeof translation === 'string') {
-        return translation;
-    }
-    const pluralFormIndex = Number(getPluralForm(quantity));
-    // Note: The `translate` function is not responsible for replacing `%0, %1, ...` with values.
-    return translation[pluralFormIndex];
-}
-/**
- * Clears dictionaries for test purposes.
- *
- * @internal
- */
-export function _clear() {
-    if (global.window.CKEDITOR_TRANSLATIONS) {
-        global.window.CKEDITOR_TRANSLATIONS = {};
-    }
-}
-/**
- * If array then merge objects which are inside otherwise return given object.
- *
- * @internal
- * @param translations Translations passed in editor config.
- */
-export function _unifyTranslations(translations) {
-    return Array.isArray(translations) ?
-        translations.reduce((acc, translation) => merge(acc, translation)) :
-        translations;
-}
-/**
- * Checks whether the dictionary exists and translation in that dictionary exists.
- */
-function hasTranslation(language, messageId, translations) {
-    return !!translations[language] && !!translations[language].dictionary[messageId];
-}
-function getNumberOfLanguages(translations) {
-    return Object.keys(translations).length;
-}

package/src/uid.js

@@ -1,45 +0,0 @@
-/**
- * @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
- */
-/**
- * @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((_, 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 An unique id string.
- */
-export function uid() {
-    // Let's create some positive random 32bit integers first.
-    const [r1, r2, r3, r4] = crypto.getRandomValues(new Uint32Array(4));
-    // 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,85 +0,0 @@
-/**
- * @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
- */
-/**
- * Set of utils to handle unicode characters.
- *
- * @module utils/unicode
- */
-/**
- * Checks whether given `character` is a combining mark.
- *
- * @param character Character to check.
- */
-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 character Character to check.
- */
-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 character Character to check.
- */
-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 to check.
- * @param offset Offset to check.
- */
-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 to check.
- * @param offset Offset to check.
- */
-export function isInsideCombinedSymbol(string, offset) {
-    return isCombiningMark(string.charAt(offset));
-}
-const EMOJI_PATTERN = /* #__PURE__ */ buildEmojiRegexp();
-/**
- * Checks whether given offset in a string is inside multi-character emoji sequence.
- *
- * @param string String to check.
- * @param offset Offset to check.
- */
-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,177 +0,0 @@
-/**
- * @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
- */
-/**
- * @module utils/version
- */
-import { CKEditorError } from './ckeditorerror.js';
-export const version = '47.6.1';
-// The second argument is not a month. It is `monthIndex` and starts from `0`.
-export const releaseDate = new Date(2026, 2, 11);
-/* istanbul ignore next -- @preserve */
-if (globalThis.CKEDITOR_VERSION) {
-    /**
-     * This error is thrown when, due to a mistake in the way CKEditor 5 was installed,
-     * imported, or initialized, some of its modules were evaluated and executed twice.
-     * Duplicate modules inevitably lead to runtime errors and increased bundle size.
-     *
-     * # Check dependency versions
-     *
-     * First, make sure that you use the latest version of all CKEditor 5 dependencies.
-     * Depending on the installation method, you should check the versions of the `ckeditor5`,
-     * `ckeditor5-premium-features`, or `@ckeditor/ckeditor5-<NAME>` packages. If you cannot update
-     * to the latest version, ensure that all the CKEditor&nbsp;5 packages are
-     * in the same version.
-     *
-     * If you use third-party plugins, make sure to update them, too. If they are incompatible
-     * with the version of CKEditor&nbsp;5 you use, you may need to downgrade the CKEditor&nbsp;5 packages
-     * (which we do not recommend). Ask the plugin's author to upgrade the dependencies,
-     * or fork their project and update it yourself.
-     *
-     * # Check imports
-     *
-     * The next step is to look at how you import CKEditor&nbsp;5 into your project.
-     *
-     * **The {@glink updating/nim-migration/migration-to-new-installation-methods new installation methods}
-     * are designed to prevent module duplication, so if you are not using them yet, you should consider
-     * updating your project**. However, several legacy installation methods are still supported for backward
-     * compatibility, and mixing them may result in module duplication.
-     *
-     * These are the most common import methods of the CKEditor&nbsp;5 packages.
-     *
-     * - **New installation methods (NIM)** &ndash; Imports from the `ckeditor5` and `ckeditor5-premium-features` packages.
-     * - **Optimized build** for the new installation methods &ndash; Imports from the `@ckeditor/ckeditor5-<NAME>/dist/index.js`.
-     * - **Predefined builds** (no longer supported) &ndash; Imports from the `@ckeditor/ckeditor5-build-<NAME>` packages.
-     * - **Default imports** (legacy) &ndash; Imports from the `@ckeditor/ckeditor5-<NAME>` packages (default export).
-     * - **`src`** (legacy) &ndash; Imports from the `@ckeditor/ckeditor5-<NAME>/src/*`.
-     * - **DLL builds** (legacy) &ndash; Imports from the `ckeditor5/build/<NAME>` and `@ckeditor/ckeditor5-<NAME>/build/*`.
-     *
-     * The best way to avoid duplicate modules is to avoid mixing these installation methods. For example, if you use imports
-     * specific to the optimized build, you should use them for all CKEditor&nbsp;5 packages. In addition, since
-     * the DLL builds already include the core of the editor, they cannot be used with other types of imports.
-     *
-     * Here is a matrix showing which installation methods are compatible with each other:
-     *
-     * |                  | NIM | Optimized build | Predefined builds | Default imports | `src` | DLL builds |
-     * |------------------|-----|-----------------|-------------------|-----------------|-------|------------|
-     * | NIM              | ✅  | ✅              | ❌                | ❌              | ❌    | ❌         |
-     * | Optimized builds | ✅  | ✅              | ❌                | ❌              | ❌    | ❌         |
-     * | Predefined build | ❌  | ❌              | ✅                | ❌              | ❌    | ❌         |
-     * | Default imports  | ❌  | ❌              | ❌                | ✅              | ✅    | ❌         |
-     * | `src`            | ❌  | ❌              | ❌                | ✅              | ✅    | ❌         |
-     * | DLL builds       | ❌  | ❌              | ❌                | ❌              | ❌    | ✅         |
-     *
-     * If you use any third-party plugins, make sure the way you import them is compatible with
-     * the way you import CKEditor&nbsp;5.
-     *
-     * <details>
-     * <summary>New installation methods and optimized builds</summary>
-     *
-     * If you use the {@glink updating/nim-migration/migration-to-new-installation-methods new installation methods},
-     * you should only import { code } from the `ckeditor5` and `ckeditor5-premium-features` packages.
-     * Do not import { code } from the `@ckeditor/ckeditor5-<NAME>` packages unless you follow
-     * the {@glink getting-started/setup/optimizing-build-size Optimizing build size} guide and the imports from
-     * the `@ckeditor/ckeditor5-<NAME>` packages end with `/dist/index.js`.
-     *
-     * If you use a CDN, ensure that some files are not included twice in your project.
-     *
-     * Examples of valid and invalid import paths:
-     *
-     * ```js
-     * import { ClassicEditor, Highlight } from 'ckeditor5'; // ✅
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ✅
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
-     * import '@ckeditor/ckeditor5-highlight/build/highlight.js'; // ❌
-     * ```
-     * </details>
-     *
-     * <details>
-     * <summary>(Deprecated) Predefined builds</summary>
-     *
-     * **As of April, 2025 predefined build are no longer supported. Please refer to the
-     * {@glink getting-started/index Quick Start} guide
-     * to choose one of the modern installation and integration methods available**.
-     *
-     * If you use the predefined builds, you cannot import any additional plugins.
-     * These builds already include the editor's core and selected plugins and importing additional
-     * ones will cause some modules to be bundled and loaded twice.
-     *
-     * Examples of valid and invalid import paths:
-     *
-     * ```js
-     * import { ClassicEditor } from '@ckeditor/ckeditor5-build-classic'; // ✅
-     * import { Highlight } from 'ckeditor5'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/src/highlight'; // ❌
-     * import '@ckeditor/ckeditor5-highlight/build/highlight'; // ❌
-     * ```
-     *
-     * If you are missing some features from the list of plugins, you should switch to the
-     * {@glink updating/nim-migration/migration-to-new-installation-methods new installation methods}
-     * which do not have this limitation.
-     * </details>
-     *
-     * <details>
-     * <summary>(Legacy) Default imports and `src` imports</summary>
-     *
-     * If you use the {@glink getting-started/legacy/installation-methods/quick-start-other legacy customized installation}
-     * method, you should only import { code from the `@ckeditor/ckeditor5-<NAME>` packages. While you can import code } from
-     * the `@ckeditor/ckeditor5-<NAME>/src/*` files, it is not recommended as it can make migration to the new installation
-     * methods more difficult.
-     *
-     * If you use this installation method, you should not import { code } from the `ckeditor5` or `ckeditor5-premium-features` packages.
-     *
-     * Examples of valid and invalid import paths:
-     *
-     * ```js
-     * import { ClassicEditor } from '@ckeditor/ckeditor5-editor-classic'; // ✅
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ✅
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ✅ (not recommended)
-     * import { Highlight } from 'ckeditor5'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ❌
-     * import '@ckeditor/ckeditor5-highlight/build/highlight'; // ❌
-     * ```
-     * </details>
-     *
-     * <details>
-     * <summary>(Legacy) DLL builds</summary>
-     *
-     * If you are using the {@glink getting-started/legacy/advanced/alternative-setups/dll-builds legacy DLL builds},
-     * you should not import any non-DLL modules.
-     *
-     * Examples of valid and invalid import paths:
-     *
-     * ```js
-     * import 'ckeditor5/build/ckeditor5-dll.js';// ✅
-     * import '@ckeditor/ckeditor5-editor-classic/build/editor-classic.js';// ✅
-     * import '@ckeditor/ckeditor5-highlight/build/highlight.js';// ✅
-     * import { Highlight } from 'ckeditor5'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
-     * import { Highlight } from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ❌
-     * ```
-     * </details>
-     *
-     * # Reinstall `node_modules`
-     *
-     * Usually, npm and other package managers deduplicate all packages - for example, `ckeditor5` is only installed once
-     * in `node_modules/`. However, it is known to fail to do so occasionally.
-     *
-     * To rule out this possibility, you can try the following:
-     *
-     * 1. Remove the `node_modules` directory.
-     * 2. Remove the `package-lock.json`, `yarn.lock`, or `pnpm-lock.yaml` files (depending on the package manager used).
-     * 3. Run `npm install` to reinstall all packages.
-     * 4. Run `npm ls` to check how many times packages like `@ckeditor/ckeditor5-core` are installed.
-     * If they are installed more than once, verify which package causes that.
-     *
-     * @error ckeditor-duplicated-modules
-     */
-    throw new CKEditorError('ckeditor-duplicated-modules', null);
-}
-else {
-    globalThis.CKEDITOR_VERSION = version;
-}

package/src/wait.js

@@ -1,29 +0,0 @@
-/**
- * @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
- */
-/**
- * @module utils/wait
- */
-/**
- * Returns a promise that is resolved after the specified time.
- *
- * @param timeout The time in milliseconds to wait.
- * @param options.signal A signal to abort the waiting.
- */
-export function wait(timeout, options = {}) {
-    return new Promise((resolve, reject) => {
-        const signal = options.signal || (new AbortController()).signal;
-        signal.throwIfAborted();
-        const timer = setTimeout(timeoutHandler, timeout);
-        signal.addEventListener('abort', abortHandler, { once: true });
-        function timeoutHandler() {
-            signal.removeEventListener('abort', abortHandler);
-            resolve();
-        }
-        function abortHandler() {
-            clearTimeout(timer);
-            reject(signal.reason);
-        }
-    });
-}