@ckeditor/ckeditor5-utils 40.0.0 → 40.2.0

package/src/translation-service.js

@@ -1,198 +1,198 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/* eslint-disable no-var */
-/**
- * @module utils/translation-service
- */
-import CKEditorError from './ckeditorerror';
-import global from './dom/global';
-/* 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.
- * @returns 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(global.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 = global.window.CKEDITOR_TRANSLATIONS[language].dictionary;
-    const getPluralForm = global.window.CKEDITOR_TRANSLATIONS[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() {
-    global.window.CKEDITOR_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 getNumberOfLanguages() {
-    return Object.keys(global.window.CKEDITOR_TRANSLATIONS).length;
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/* eslint-disable no-var */
+/**
+ * @module utils/translation-service
+ */
+import CKEditorError from './ckeditorerror';
+import global from './dom/global';
+/* 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.
+ * @returns 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(global.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 = global.window.CKEDITOR_TRANSLATIONS[language].dictionary;
+    const getPluralForm = global.window.CKEDITOR_TRANSLATIONS[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() {
+    global.window.CKEDITOR_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 getNumberOfLanguages() {
+    return Object.keys(global.window.CKEDITOR_TRANSLATIONS).length;
+}

package/src/uid.d.ts

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

@@ -1,57 +1,57 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module 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 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];
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module 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 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.d.ts

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