@ckeditor/ckeditor5-utils 41.1.0 → 41.3.0-alpha.0

package/dist/types/spy.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license Copyright (c) 2003-2024, 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 The spy function.
+ */
+declare function spy(): {
+    (): void;
+    called?: boolean;
+};
+export default spy;

package/dist/types/toarray.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license Copyright (c) 2003-2024, 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.
+ *
+ * @label MUTABLE
+ * @param data The value to transform to an array.
+ * @returns An array created from data.
+ */
+export default function toArray<T>(data: ArrayOrItem<T>): Array<T>;
+/**
+ * Transforms any value to an array. If the provided value is already an array, it is returned unchanged.
+ *
+ * @label IMMUTABLE
+ * @param data The value to transform to an array.
+ * @returns An array created from data.
+ */
+export default function toArray<T>(data: ReadonlyArrayOrItem<T>): ReadonlyArray<T>;
+export type ArrayOrItem<T> = T | Array<T>;
+export type ReadonlyArrayOrItem<T> = T | ReadonlyArray<T>;

package/dist/types/tomap.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * 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 default function toMap<T>(data: {
+    readonly [key: string]: T;
+} | Iterable<readonly [string, T]> | null | undefined): Map<string, T>;

package/dist/types/translation-service.d.ts

@@ -0,0 +1,174 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module utils/translation-service
+ */
+import type { Translations } from './locale.js';
+import { type ArrayOrItem } from './toarray.js';
+declare global {
+    var CKEDITOR_TRANSLATIONS: 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 declare function add(language: string, translations: {
+    readonly [messageId: string]: string | ReadonlyArray<string>;
+}, getPluralForm?: (n: number) => number): void;
+/**
+ * **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 declare function _translate(language: string, message: Message, quantity?: number, translations?: Translations): string;
+/**
+ * Clears dictionaries for test purposes.
+ *
+ * @internal
+ */
+export declare function _clear(): void;
+/**
+ * If array then merge objects which are inside otherwise return given object.
+ *
+ * @internal
+ * @param translations Translations passed in editor config.
+ */
+export declare function _unifyTranslations(translations?: ArrayOrItem<Translations>): Translations | undefined;
+/**
+ * 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.
+ */
+export interface Message {
+    /**
+     * 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.
+     */
+    readonly string: string;
+    /**
+     * 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.
+     */
+    readonly id?: string;
+    /**
+     * 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.
+     */
+    readonly plural?: string;
+}

package/dist/types/uid.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * 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 default function uid(): string;

package/dist/types/unicode.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license Copyright (c) 2003-2024, 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 character Character to check.
+ */
+export declare function isCombiningMark(character: string): boolean;
+/**
+ * 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 declare function isHighSurrogateHalf(character: string): boolean;
+/**
+ * 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 declare function isLowSurrogateHalf(character: string): boolean;
+/**
+ * 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 declare function isInsideSurrogatePair(string: string, offset: number): boolean;
+/**
+ * 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 declare function isInsideCombinedSymbol(string: string, offset: number): boolean;
+/**
+ * Checks whether given offset in a string is inside multi-character emoji sequence.
+ *
+ * @param string String to check.
+ * @param offset Offset to check.
+ */
+export declare function isInsideEmojiSequence(string: string, offset: number): boolean;

package/dist/types/verifylicense.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * Possible states of the key after verification.
+ */
+export type VerifiedKeyStatus = 'VALID' | 'INVALID';
+/**
+ * Checks whether the given string contains information that allows you to verify the license status.
+ *
+ * @param token The string to check.
+ * @returns String that represents the state of given `token` parameter.
+ */
+export default function verifyLicense(token: string | undefined): VerifiedKeyStatus;

package/dist/types/version.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+declare const version = "41.3.0-alpha.0";
+export default version;
+export declare const releaseDate: Date;
+declare global {
+    var CKEDITOR_VERSION: string;
+}

package/dist/types/wait.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @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 default function wait(timeout: number, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-utils",
-  "version": "41.1.0",
+  "version": "41.3.0-alpha.0",
   "description": "Miscellaneous utilities used by CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -24,6 +24,7 @@
     "directory": "packages/ckeditor5-utils"
   },
   "files": [
+    "dist",
     "lang",
     "src/**/*.js",
     "src/**/*.d.ts",

package/src/index.d.ts

@@ -45,7 +45,7 @@ export { default as remove } from './dom/remove.js';
 export * from './dom/scroll.js';
 export * from './keyboard.js';
 export * from './language.js';
-export { default as Locale, type LocaleTranslate } from './locale.js';
+export { default as Locale, type LocaleTranslate, type Translations } from './locale.js';
 export { default as Collection, type CollectionAddEvent, type CollectionChangeEvent, type CollectionRemoveEvent } from './collection.js';
 export { default as first } from './first.js';
 export { default as FocusTracker } from './focustracker.js';

package/src/keyboard.js

@@ -15,6 +15,13 @@ const modifiersToGlyphsNonMac = {
     alt: 'Alt+',
     shift: 'Shift+'
 };
+const keyCodesToGlyphs = {
+    37: '←',
+    38: '↑',
+    39: '→',
+    40: '↓',
+    9: '⇥'
+};
 /**
  * An object with `keyName => keyCode` pairs for a set of known keys.
  *
@@ -29,7 +36,16 @@ const modifiersToGlyphsNonMac = {
  * * `ctrl`, `cmd`, `shift`, `alt`.
  */
 export const keyCodes = generateKnownKeyCodes();
-const keyCodeNames = Object.fromEntries(Object.entries(keyCodes).map(([name, code]) => [code, name.charAt(0).toUpperCase() + name.slice(1)]));
+const keyCodeNames = Object.fromEntries(Object.entries(keyCodes).map(([name, code]) => {
+    let prettyKeyName;
+    if (code in keyCodesToGlyphs) {
+        prettyKeyName = keyCodesToGlyphs[code];
+    }
+    else {
+        prettyKeyName = name.charAt(0).toUpperCase() + name.slice(1);
+    }
+    return [code, prettyKeyName];
+}));
 /**
  * Converts a key name or {@link module:utils/keyboard~KeystrokeInfo keystroke info} into a key code.
  *
@@ -211,9 +227,19 @@ function generateKnownKeyCodes() {
         keyCodes['f' + (code - 111)] = code;
     }
     // other characters
-    for (const char of '`-=[];\',./\\') {
-        keyCodes[char] = char.charCodeAt(0);
-    }
+    Object.assign(keyCodes, {
+        '\'': 222,
+        ',': 108,
+        '-': 109,
+        '.': 110,
+        '/': 111,
+        ';': 186,
+        '=': 187,
+        '[': 219,
+        '\\': 220,
+        ']': 221,
+        '`': 223
+    });
     return keyCodes;
 }
 function splitKeystrokeText(keystroke) {

package/src/locale.d.ts

@@ -2,6 +2,10 @@
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
+/**
+ * @module utils/locale
+ */
+import { type ArrayOrItem } from './toarray.js';
 import { type Message } from './translation-service.js';
 import { type LanguageDirection } from './language.js';
 /**
@@ -83,6 +87,10 @@ export default class Locale {
      * ```
      */
     readonly t: LocaleTranslate;
+    /**
+     * Object that contains translations.
+     */
+    translations?: Translations;
     /**
      * Creates a new instance of the locale class. Learn more about
      * {@glink features/ui-language configuring the language of the editor}.
@@ -93,10 +101,12 @@ export default class Locale {
      * @param options.contentLanguage The editor content language code in the
      * [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format. If not specified, the same as `options.language`.
      * See {@link #contentLanguage}.
+     * @param translations Translations passed as a editor config parameter.
      */
-    constructor({ uiLanguage, contentLanguage }?: {
+    constructor({ uiLanguage, contentLanguage, translations }?: {
         readonly uiLanguage?: string;
         readonly contentLanguage?: string;
+        readonly translations?: ArrayOrItem<Translations>;
     });
     /**
      * The editor UI language code in the [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format.
@@ -118,3 +128,14 @@ export default class Locale {
  * For messages supporting plural forms the first value will determine the plural form.
  */
 export type LocaleTranslate = (message: string | Message, values?: number | string | ReadonlyArray<number | string>) => string;
+/**
+ * Translations object definition.
+ */
+export type Translations = {
+    [language: string]: {
+        dictionary: {
+            [messageId: string]: string | ReadonlyArray<string>;
+        };
+        getPluralForm?: (n: number) => number;
+    };
+};

package/src/locale.js

@@ -7,7 +7,7 @@
  */
 /* globals console */
 import toArray from './toarray.js';
-import { _translate } from './translation-service.js';
+import { _translate, _unifyTranslations } from './translation-service.js';
 import { getLanguageDirection } from './language.js';
 /**
  * Represents the localization services.
@@ -23,12 +23,14 @@ export default class Locale {
      * @param options.contentLanguage The editor content language code in the
      * [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format. If not specified, the same as `options.language`.
      * See {@link #contentLanguage}.
+     * @param translations Translations passed as a editor config parameter.
      */
-    constructor({ uiLanguage = 'en', contentLanguage } = {}) {
+    constructor({ uiLanguage = 'en', contentLanguage, translations } = {}) {
         this.uiLanguage = uiLanguage;
         this.contentLanguage = contentLanguage || this.uiLanguage;
         this.uiLanguageDirection = getLanguageDirection(this.uiLanguage);
         this.contentLanguageDirection = getLanguageDirection(this.contentLanguage);
+        this.translations = _unifyTranslations(translations);
         this.t = (message, values) => this._t(message, values);
     }
     /**
@@ -62,7 +64,7 @@ export default class Locale {
         }
         const hasPluralForm = !!message.plural;
         const quantity = hasPluralForm ? values[0] : 1;
-        const translatedString = _translate(this.uiLanguage, message, quantity);
+        const translatedString = _translate(this.uiLanguage, message, quantity, this.translations);
         return interpolateString(translatedString, values);
     }
 }

package/src/translation-service.d.ts

@@ -2,15 +2,13 @@
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
+/**
+ * @module utils/translation-service
+ */
+import type { Translations } from './locale.js';
+import { type ArrayOrItem } from './toarray.js';
 declare global {
-    var CKEDITOR_TRANSLATIONS: {
-        [language: string]: {
-            dictionary: {
-                [messageId: string]: string | ReadonlyArray<string>;
-            };
-            getPluralForm?: (n: number) => number;
-        };
-    };
+    var CKEDITOR_TRANSLATIONS: Translations;
 }
 /**
  * Adds translations to existing ones or overrides the existing translations. These translations will later
@@ -135,15 +133,23 @@ export declare function add(language: string, translations: {
  * @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 declare function _translate(language: string, message: Message, quantity?: number): string;
+export declare function _translate(language: string, message: Message, quantity?: number, translations?: Translations): string;
 /**
  * Clears dictionaries for test purposes.
  *
  * @internal
  */
 export declare function _clear(): void;
+/**
+ * If array then merge objects which are inside otherwise return given object.
+ *
+ * @internal
+ * @param translations Translations passed in editor config.
+ */
+export declare function _unifyTranslations(translations?: ArrayOrItem<Translations>): Translations | undefined;
 /**
  * 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.

package/src/translation-service.js

@@ -2,12 +2,9 @@
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-/* eslint-disable no-var */
-/**
- * @module utils/translation-service
- */
 import CKEditorError from './ckeditorerror.js';
 import global from './dom/global.js';
+import { merge } from 'lodash-es';
 /* istanbul ignore else -- @preserve */
 if (!global.window.CKEDITOR_TRANSLATIONS) {
     global.window.CKEDITOR_TRANSLATIONS = {};
@@ -141,9 +138,10 @@ export function add(language, translations, getPluralForm) {
  * @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) {
+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
@@ -154,22 +152,23 @@ export function _translate(language, message, quantity = 1) {
          */
         throw new CKEditorError('translation-service-quantity-not-a-number', null, { quantity });
     }
-    const numberOfLanguages = getNumberOfLanguages();
+    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(global.window.CKEDITOR_TRANSLATIONS)[0];
+        language = Object.keys(normalizedTranslations)[0];
     }
     const messageId = message.id || message.string;
-    if (numberOfLanguages === 0 || !hasTranslation(language, messageId)) {
+    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 = global.window.CKEDITOR_TRANSLATIONS[language].dictionary;
-    const getPluralForm = global.window.CKEDITOR_TRANSLATIONS[language].getPluralForm || (n => n === 1 ? 0 : 1);
+    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;
@@ -184,15 +183,27 @@ export function _translate(language, message, quantity = 1) {
  * @internal
  */
 export function _clear() {
-    global.window.CKEDITOR_TRANSLATIONS = {};
+    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) {
-    return (!!global.window.CKEDITOR_TRANSLATIONS[language] &&
-        !!global.window.CKEDITOR_TRANSLATIONS[language].dictionary[messageId]);
+function hasTranslation(language, messageId, translations) {
+    return !!translations[language] && !!translations[language].dictionary[messageId];
 }
-function getNumberOfLanguages() {
-    return Object.keys(global.window.CKEDITOR_TRANSLATIONS).length;
+function getNumberOfLanguages(translations) {
+    return Object.keys(translations).length;
 }

package/src/version.d.ts

@@ -2,7 +2,7 @@
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-declare const version = "41.1.0";
+declare const version = "41.3.0-alpha.0";
 export default version;
 export declare const releaseDate: Date;
 declare global {