@ckeditor/ckeditor5-utils 48.2.0 → 48.3.0-alpha.1

package/dist/translation-service.d.ts

@@ -1,174 +1,174 @@
 /**
- * @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
- */
+* @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/translation-service
- */
-import type { Translations } from './locale.js';
-import { type ArrayOrItem } from './toarray.js';
+* @module utils/translation-service
+*/
+import type { Translations } from "./locale.js";
+import { type ArrayOrItem } from "./toarray.js";
 declare global {
-    var CKEDITOR_TRANSLATIONS: Translations;
+	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 = {};
- * 	}
+* 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).
- */
+* 	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>;
+	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.
- */
+* **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
- */
+* 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.
- */
+* 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.
- */
+* 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;
+	/**
+	* 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/uid.d.ts

@@ -1,15 +1,15 @@
 /**
- * @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
- */
+* @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
+*/
 /**
- * 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.
- */
+* 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 declare function uid(): string;

package/dist/unicode.d.ts

@@ -1,54 +1,54 @@
 /**
- * @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.
- */
+* @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 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.
- */
+* 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.
- */
+* 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.
- */
+* 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.
- */
+* 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.
- */
+* 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/version.d.ts

@@ -1,9 +1,9 @@
 /**
- * @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 declare const version = "48.2.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 declare const version = "48.3.0-alpha.1";
 export declare const releaseDate: Date;
 declare global {
-    var CKEDITOR_VERSION: string;
+	var CKEDITOR_VERSION: string;
 }

package/dist/wait.d.ts

@@ -1,16 +1,16 @@
 /**
- * @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
- */
+* @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
- */
+* @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.
- */
+* 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 declare function wait(timeout: number, options?: {
-    signal?: AbortSignal;
+	signal?: AbortSignal;
 }): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-utils",
-  "version": "48.2.0",
+  "version": "48.3.0-alpha.1",
   "description": "Miscellaneous utilities used by CKEditor 5.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -25,7 +25,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-ui": "48.2.0",
+    "@ckeditor/ckeditor5-ui": "48.3.0-alpha.1",
     "es-toolkit": "1.45.1"
   },
   "files": [

package/dist/index.css.map

@@ -1 +0,0 @@
-{"version":3,"sources":["index.css"],"names":[],"mappings":";;;;;;AAEA,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC","file":"index.css.map","sourcesContent":["\n\n/*# sourceMappingURL=index.css.map */"]}