@ckeditor/ckeditor5-utils 45.2.1-alpha.9 → 46.0.0-alpha.0

package/dist/index.js

@@ -2,7 +2,7 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { isObject, isString, isPlainObject, cloneDeepWith, isElement as isElement$1, isFunction, merge } from 'es-toolkit/compat';
+import { isObject as isObject$1, isString, isPlainObject, cloneDeepWith, isElement as isElement$1, isFunction, merge } from 'es-toolkit/compat';
 
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
@@ -27,10 +27,10 @@ import { isObject, isString, isPlainObject, cloneDeepWith, isElement as isElemen
  *
  * console.log( global.window.innerWidth );
  * ```
- */ let globalVar; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
+ */ let global; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
 // In some environments window and document API might not be available.
 try {
-    globalVar = {
+    global = {
         window,
         document
     };
@@ -40,16 +40,17 @@ try {
     // We only handle this so loading editor in environments without window and document doesn't fail.
     // For better DX we shouldn't introduce mixed types and require developers to check the type manually.
     // This module should not be used on purpose in any environment outside browser.
-    globalVar = {
+    global = {
         window: {},
         document: {}
     };
 }
-var global = globalVar;
 
 /**
  * Safely returns `userAgent` from browser's navigator API in a lower case.
  * If navigator API is not available it will return an empty string.
+ *
+ * @internal
  */ function getUserAgent() {
     // In some environments navigator API might not be available.
     try {
@@ -82,6 +83,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is running on Macintosh.
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is running on Macintosh or not.
  */ function isMac(userAgent) {
@@ -90,6 +92,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is running on Windows.
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is running on Windows or not.
  */ function isWindows(userAgent) {
@@ -98,6 +101,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is Firefox (Gecko).
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is Firefox or not.
  */ function isGecko(userAgent) {
@@ -106,6 +110,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is Safari.
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is Safari or not.
  */ function isSafari(userAgent) {
@@ -114,6 +119,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is running in iOS.
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is running in iOS or not.
  */ function isiOS(userAgent) {
@@ -123,6 +129,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is Android mobile device.
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is Safari or not.
  */ function isAndroid(userAgent) {
@@ -131,6 +138,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 /**
  * Checks if User Agent represented by the string is Blink engine.
  *
+ * @internal
  * @param userAgent **Lowercase** `navigator.userAgent` string.
  * @returns Whether User Agent is Blink engine or not.
  */ function isBlink(userAgent) {
@@ -142,6 +150,8 @@ const userAgent = /* #__PURE__ */ getUserAgent();
  * Checks if the current environment supports ES2018 Unicode properties like `\p{P}` or `\p{L}`.
  * More information about unicode properties might be found
  * [in Unicode Standard Annex #44](https://www.unicode.org/reports/tr44/#GC_Values_Table).
+ *
+ * @internal
  */ function isRegExpUnicodePropertySupported() {
     let isSupported = false;
     // Feature detection for Unicode properties. Added in ES2018. Currently Firefox does not support it.
@@ -158,6 +168,8 @@ const userAgent = /* #__PURE__ */ getUserAgent();
  * Checks if the user agent has enabled a forced colors mode (e.g. Windows High Contrast mode).
  *
  * Returns `false` in environments where `window` global object is not available.
+ *
+ * @internal
  */ function isMediaForcedColors() {
     return global.window.matchMedia ? global.window.matchMedia('(forced-colors: active)').matches : false;
 }
@@ -165,6 +177,8 @@ const userAgent = /* #__PURE__ */ getUserAgent();
  * Checks if the user enabled "prefers reduced motion" setting in browser.
  *
  * Returns `false` in environments where `window` global object is not available.
+ *
+ * @internal
  */ function isMotionReduced() {
     return global.window.matchMedia ? global.window.matchMedia('(prefers-reduced-motion)').matches : false;
 }
@@ -601,48 +615,58 @@ diff.fastDiff = fastDiff;
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
- * @module utils/mix
+ * @module utils/areconnectedthroughproperties
  */ /**
- * Copies enumerable properties and symbols from the objects given as 2nd+ parameters to the
- * prototype of first object (a constructor).
- *
- * ```
- * class Editor {
- * 	...
- * }
- *
- * const SomeMixin = {
- * 	a() {
- * 		return 'a';
- * 	}
- * };
- *
- * mix( Editor, SomeMixin, ... );
- *
- * new Editor().a(); // -> 'a'
- * ```
- *
- * Note: Properties which already exist in the base class will not be overriden.
- *
- * @deprecated Use mixin pattern, see: https://www.typescriptlang.org/docs/handbook/mixins.html.
- * @param baseClass Class which prototype will be extended.
- * @param mixins Objects from which to get properties.
- */ function mix(baseClass, ...mixins) {
-    mixins.forEach((mixin)=>{
-        const propertyNames = Object.getOwnPropertyNames(mixin);
-        const propertySymbols = Object.getOwnPropertySymbols(mixin);
-        propertyNames.concat(propertySymbols).forEach((key)=>{
-            if (key in baseClass.prototype) {
-                return;
-            }
-            if (typeof mixin == 'function' && (key == 'length' || key == 'name' || key == 'prototype')) {
-                return;
-            }
-            const sourceDescriptor = Object.getOwnPropertyDescriptor(mixin, key);
-            sourceDescriptor.enumerable = false;
-            Object.defineProperty(baseClass.prototype, key, sourceDescriptor);
-        });
-    });
+ * Traverses both structures to find out whether there is a reference that is shared between both structures.
+ */ function areConnectedThroughProperties(obj1, obj2) {
+    if (obj1 === obj2 && isObject(obj1)) {
+        return true;
+    }
+    const subNodes1 = getSubNodes(obj1);
+    const subNodes2 = getSubNodes(obj2);
+    for (const node of subNodes1){
+        if (subNodes2.has(node)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Traverses JS structure and stores all sub-nodes, including the head node.
+ * It walks into each iterable structures with the `try catch` block to omit errors that might be thrown during
+ * tree walking. All primitives, functions and built-ins are skipped.
+ */ function getSubNodes(head) {
+    const nodes = [
+        head
+    ];
+    // Nodes are stored to prevent infinite looping.
+    const subNodes = new Set();
+    while(nodes.length > 0){
+        const node = nodes.shift();
+        if (subNodes.has(node) || shouldNodeBeSkipped(node)) {
+            continue;
+        }
+        subNodes.add(node);
+        // Handle arrays, maps, sets, custom collections that implements `[ Symbol.iterator ]()`, etc.
+        if (node[Symbol.iterator]) {
+            // The custom editor iterators might cause some problems if the editor is crashed.
+            try {
+                nodes.push(...node);
+            } // eslint-disable-next-line no-empty
+            catch  {}
+        } else {
+            nodes.push(...Object.values(node));
+        }
+    }
+    return subNodes;
+}
+function shouldNodeBeSkipped(node) {
+    const type = Object.prototype.toString.call(node);
+    return type === '[object Number]' || type === '[object Boolean]' || type === '[object String]' || type === '[object Symbol]' || type === '[object Function]' || type === '[object Date]' || type === '[object RegExp]' || node === undefined || node === null || // Skip native DOM objects, e.g. Window, nodes, events, etc.
+    node instanceof EventTarget || node instanceof Event;
+}
+function isObject(structure) {
+    return typeof structure === 'object' && structure !== null;
 }
 
 /**
@@ -838,11 +862,18 @@ diff.fastDiff = fastDiff;
 	 * @param data Additional data describing the error. A stringified version of this object
 	 * will be appended to the error message, so the data are quickly visible in the console. The original
 	 * data object will also be later available under the {@link #data} property.
-	 */ constructor(errorName, context, data){
-        super(getErrorMessage(errorName, data));
+	 * @param originalError An optional original error that is being wrapped in the `CKEditorError` instance.
+	 */ constructor(errorName, context, data, originalError){
+        super(getErrorMessage(errorName, data, originalError));
         this.name = 'CKEditorError';
         this.context = context;
         this.data = data;
+        // Wrapping an original error in a CKEditorError instance.
+        if (originalError) {
+            // Restore the original stack trace to make the error look like the original one.
+            // See https://github.com/ckeditor/ckeditor5/issues/5595 for more details.
+            this.stack = originalError.stack;
+        }
     }
     /**
 	 * Checks if the error is of the `CKEditorError` type.
@@ -854,12 +885,12 @@ diff.fastDiff = fastDiff;
 	 * It is useful when combined with the {@link module:watchdog/watchdog~Watchdog} feature, which can restart the editor in case
 	 * of a {@link module:utils/ckeditorerror~CKEditorError} error.
 	 *
-	 * @param err The error to rethrow.
+	 * @param error The error to rethrow.
 	 * @param context An object connected through properties with the editor instance. This context will be used
 	 * by the watchdog to verify which editor should be restarted.
-	 */ static rethrowUnexpectedError(err, context) {
-        if (err.is && err.is('CKEditorError')) {
-            throw err;
+	 */ static rethrowUnexpectedError(error, context) {
+        if (error.is && error.is('CKEditorError')) {
+            throw error;
         }
         /**
 		 * An unexpected error occurred inside the CKEditor 5 codebase. This error will look like the original one
@@ -869,11 +900,7 @@ diff.fastDiff = fastDiff;
 		 * In case of such error (or any {@link module:utils/ckeditorerror~CKEditorError} error) the watchdog should restart the editor.
 		 *
 		 * @error unexpected-error
-		 */ const error = new CKEditorError(err.message, context);
-        // Restore the original stack trace to make the error look like the original one.
-        // See https://github.com/ckeditor/ckeditor5/issues/5595 for more details.
-        error.stack = err.stack;
-        throw error;
+		 */ throw new CKEditorError('unexpected-error', context, undefined, error);
     }
 }
 /**
@@ -930,7 +957,7 @@ diff.fastDiff = fastDiff;
 }
 /**
  * Returns formatted error message.
- */ function getErrorMessage(errorName, data) {
+ */ function getErrorMessage(errorName, data, originalError) {
     const processedObjects = new WeakSet();
     const circularReferencesReplacer = (key, value)=>{
         if (typeof value === 'object' && value !== null) {
@@ -943,7 +970,8 @@ diff.fastDiff = fastDiff;
     };
     const stringifiedData = data ? ` ${JSON.stringify(data, circularReferencesReplacer)}` : '';
     const documentationLink = getLinkToDocumentationMessage(errorName);
-    return errorName + stringifiedData + documentationLink;
+    const originalErrorMessage = originalError ? `\nOriginal error: ${originalError.name}: ${originalError.message}` : '';
+    return errorName + stringifiedData + documentationLink + originalErrorMessage;
 }
 /**
  * Returns formatted console error arguments.
@@ -959,9 +987,9 @@ diff.fastDiff = fastDiff;
     ];
 }
 
-const version = '45.2.1-alpha.9';
+const version = '46.0.0-alpha.0';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2025, 5, 23);
+const releaseDate = new Date(2025, 6, 1);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
 	 * This error is thrown when, due to a mistake in the way CKEditor 5 was installed,
@@ -1021,8 +1049,8 @@ const releaseDate = new Date(2025, 5, 23);
 	 * <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
+	 * 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`.
 	 *
@@ -1033,7 +1061,7 @@ const releaseDate = new Date(2025, 5, 23);
 	 * ```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/src/highlight.js'; // ❌
 	 * import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
 	 * import '@ckeditor/ckeditor5-highlight/build/highlight.js'; // ❌
 	 * ```
@@ -1053,11 +1081,11 @@ const releaseDate = new Date(2025, 5, 23);
 	 * Examples of valid and invalid import paths:
 	 *
 	 * ```js
-	 * import ClassicEditor from '@ckeditor/ckeditor5-build-classic'; // ✅
+	 * 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 { Highlight } from '@ckeditor/ckeditor5-highlight/src/highlight'; // ❌
 	 * import '@ckeditor/ckeditor5-highlight/build/highlight'; // ❌
 	 * ```
 	 *
@@ -1070,18 +1098,18 @@ const releaseDate = new Date(2025, 5, 23);
 	 * <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
+	 * 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.
+	 * 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 '@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'; // ❌
@@ -1103,7 +1131,7 @@ const releaseDate = new Date(2025, 5, 23);
 	 * 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'; // ❌
+	 * import { Highlight } from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ❌
 	 * ```
 	 * </details>
 	 *
@@ -1348,21 +1376,6 @@ function EmitterMixin(base) {
     }
     return Mixin;
 }
-// Backward compatibility with `mix`
-[
-    'on',
-    'once',
-    'off',
-    'listenTo',
-    'stopListening',
-    'fire',
-    'delegate',
-    'stopDelegating',
-    '_addEventListener',
-    '_removeEventListener'
-].forEach((key)=>{
-    EmitterMixin[key] = defaultEmitterClass$1.prototype[key];
-});
 /**
  * Checks if `listeningEmitter` listens to an emitter with given `listenedToEmitterId` and if so, returns that emitter.
  * If not, returns `null`.
@@ -1564,7 +1577,7 @@ function ObservableMixin(base) {
     class Mixin extends base {
         set(name, value) {
             // If the first parameter is an Object, iterate over its properties.
-            if (isObject(name)) {
+            if (isObject$1(name)) {
                 Object.keys(name).forEach((property)=>{
                     this.set(property, name[property]);
                 }, this);
@@ -1752,25 +1765,6 @@ function ObservableMixin(base) {
     }
     return Mixin;
 }
-// Backward compatibility with `mix`
-[
-    'set',
-    'bind',
-    'unbind',
-    'decorate',
-    'on',
-    'once',
-    'off',
-    'listenTo',
-    'stopListening',
-    'fire',
-    'delegate',
-    'stopDelegating',
-    '_addEventListener',
-    '_removeEventListener'
-].forEach((key)=>{
-    ObservableMixin[key] = defaultObservableClass.prototype[key];
-});
 // Init symbol properties needed for the observable mechanism to work.
 function initObservable(observable) {
     // Do nothing if already inited.
@@ -2563,23 +2557,6 @@ function DomEmitterMixin(base) {
     }
     return Mixin;
 }
-// Backward compatibility with `mix`
-[
-    '_getProxyEmitter',
-    '_getAllProxyEmitters',
-    'on',
-    'once',
-    'off',
-    'listenTo',
-    'stopListening',
-    'fire',
-    'delegate',
-    'stopDelegating',
-    '_addEventListener',
-    '_removeEventListener'
-].forEach((key)=>{
-    DomEmitterMixin[key] = defaultEmitterClass.prototype[key];
-});
 /**
  * Creates a ProxyEmitter instance. Such an instance is a bridge between a DOM Node firing events
  * and any Host listening to them. It is backwards compatible with {@link module:utils/emittermixin~Emitter#on}.
@@ -2847,6 +2824,37 @@ function DomEmitterMixin(base) {
     return domRange;
 }
 
+/**
+ * Searches and returns the lowest common ancestor of two given nodes.
+ *
+ * @param nodeA First node.
+ * @param nodeB Second node.
+ * @returns Lowest common ancestor of both nodes or `null` if nodes do not have a common ancestor.
+ */ function getCommonAncestor(nodeA, nodeB) {
+    const ancestorsA = getAncestors(nodeA);
+    const ancestorsB = getAncestors(nodeB);
+    let i = 0;
+    // It does not matter which array is shorter.
+    while(ancestorsA[i] == ancestorsB[i] && ancestorsA[i]){
+        i++;
+    }
+    return i === 0 ? null : ancestorsA[i - 1];
+}
+
+/**
+ * For a given element, returns the nearest ancestor element which CSS position is not "static".
+ *
+ * @param element The native DOM element to be checked.
+ */ function getPositionedAncestor(element) {
+    if (!element || !element.parentNode) {
+        return null;
+    }
+    if (element.offsetParent === global.document.body) {
+        return null;
+    }
+    return element.offsetParent;
+}
+
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
@@ -2869,20 +2877,6 @@ function DomEmitterMixin(base) {
     return Object.prototype.toString.apply(obj) == '[object Range]';
 }
 
-/**
- * For a given element, returns the nearest ancestor element which CSS position is not "static".
- *
- * @param element The native DOM element to be checked.
- */ function getPositionedAncestor(element) {
-    if (!element || !element.parentNode) {
-        return null;
-    }
-    if (element.offsetParent === global.document.body) {
-        return null;
-    }
-    return element.offsetParent;
-}
-
 const rectProperties = [
     'top',
     'right',
@@ -4407,7 +4401,7 @@ const keyCodeNames = /* #__PURE__ */ Object.fromEntries(/* #__PURE__ */ Object.e
     return keyCode == keyCodes.arrowright || keyCode == keyCodes.arrowleft || keyCode == keyCodes.arrowup || keyCode == keyCodes.arrowdown;
 }
 /**
- * Returns the direction in which the {@link module:engine/model/documentselection~DocumentSelection selection}
+ * Returns the direction in which the {@link module:engine/model/documentselection~ModelDocumentSelection selection}
  * will move when the provided arrow key code is pressed considering the language direction of the editor content.
  *
  * For instance, in right–to–left (RTL) content languages, pressing the left arrow means moving the selection right (forward)
@@ -4446,7 +4440,7 @@ const keyCodeNames = /* #__PURE__ */ Object.fromEntries(/* #__PURE__ */ Object.e
     return (env.isMac || env.isiOS) && code == keyCodes.ctrl ? keyCodes.cmd : code;
 }
 /**
- * Determines if the provided key code moves the {@link module:engine/model/documentselection~DocumentSelection selection}
+ * Determines if the provided key code moves the {@link module:engine/model/documentselection~ModelDocumentSelection selection}
  * forward or backward considering the language direction of the editor content.
  *
  * For instance, in right–to–left (RTL) languages, pressing the left arrow means moving forward
@@ -4622,7 +4616,7 @@ function splitKeystrokeText(keystroke) {
  * 	}
  * ```
  *
- * If you cannot import this function from this module (e.g. because you use a CKEditor 5 build), you can
+ * 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:
  *
@@ -4734,6 +4728,15 @@ function splitKeystrokeText(keystroke) {
     // Note: The `translate` function is not responsible for replacing `%0, %1, ...` with values.
     return translation[pluralFormIndex];
 }
+/**
+ * Clears dictionaries for test purposes.
+ *
+ * @internal
+ */ function _clear() {
+    if (global.window.CKEDITOR_TRANSLATIONS) {
+        global.window.CKEDITOR_TRANSLATIONS = {};
+    }
+}
 /**
  * If array then merge objects which are inside otherwise return given object.
  *
@@ -4846,23 +4849,6 @@ function getNumberOfLanguages(translations) {
         this.translations = _unifyTranslations(translations);
         this.t = (message, values)=>this._t(message, values);
     }
-    /**
-	 * The editor UI language code in the [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format.
-	 *
-	 * **Note**: This property was deprecated. Please use {@link #uiLanguage} and {@link #contentLanguage}
-	 * properties instead.
-	 *
-	 * @deprecated
-	 */ get language() {
-        /**
-		 * The {@link module:utils/locale~Locale#language `Locale#language`} property was deprecated and will
-		 * be removed in the near future. Please use the {@link module:utils/locale~Locale#uiLanguage `Locale#uiLanguage`} and
-		 * {@link module:utils/locale~Locale#contentLanguage `Locale#contentLanguage`} properties instead.
-		 *
-		 * @error locale-deprecated-language-property
-		 */ console.warn('locale-deprecated-language-property: ' + 'The Locale#language property has been deprecated and will be removed in the near future. ' + 'Please use #uiLanguage and #contentLanguage properties instead.');
-        return this.uiLanguage;
-    }
     /**
 	 * An unbound version of the {@link #t} method.
 	 */ _t(message, values = []) {
@@ -5475,6 +5461,28 @@ function getNumberOfLanguages(translations) {
     return iteratorItem.value;
 }
 
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+ */ /**
+ * @module utils/nth
+ */ /**
+ * Returns `nth` (starts from `0` of course) item of the given `iterable`.
+ *
+ * If the iterable is a generator, then it consumes **all its items**.
+ * If it's a normal iterator, then it consumes **all items up to the given index**.
+ * Refer to the [Iterators and Generators](https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Iterators_and_Generators)
+ * guide to learn differences between these interfaces.
+ */ function nth(index, iterable) {
+    for (const item of iterable){
+        if (index === 0) {
+            return item;
+        }
+        index -= 1;
+    }
+    return null;
+}
+
 /**
  * Allows observing a group of DOM `Element`s or {@link module:ui/view~View view instances} whether at least one of them (or their child)
  * is focused.
@@ -5837,7 +5845,7 @@ function isFocusedView(subTreeRoot, view) {
 	 * @param keystroke Keystroke defined in a format accepted by
 	 * the {@link module:utils/keyboard~parseKeystroke} function.
 	 * @param callback A function called with the
-	 * {@link module:engine/view/observer/keyobserver~KeyEventData key event data} object and
+	 * {@link module:engine/view/observer/keyobserver~ViewDocumentKeyEventData key event data} object and
 	 * a helper function to call both `preventDefault()` and `stopPropagation()` on the underlying event.
 	 * @param options Additional options.
 	 */ set(keystroke, callback, options = {}) {
@@ -5928,6 +5936,31 @@ function isFocusedView(subTreeRoot, view) {
     }
 }
 
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+ */ /**
+ * @module utils/mapsequal
+ */ /**
+ * Checks whether given `Map`s are equal, that is has same size and same key-value pairs.
+ *
+ * @param mapA The first map to compare.
+ * @param mapB The second map to compare.
+ * @returns `true` if given maps are equal, `false` otherwise.
+ */ function mapsEqual(mapA, mapB) {
+    if (mapA.size != mapB.size) {
+        return false;
+    }
+    for (const attr of mapA.entries()){
+        const valA = JSON.stringify(attr[1]);
+        const valB = JSON.stringify(mapB.get(attr[0]));
+        if (valA !== valB) {
+            return false;
+        }
+    }
+    return true;
+}
+
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
@@ -6520,5 +6553,5 @@ function buildEmojiRegexp() {
     return new RegExp(sequence, 'ug');
 }
 
-export { CKEditorError, Collection, Config, DomEmitterMixin, ElementReplacer, EmitterMixin, EventInfo, FocusTracker, KeystrokeHandler, Locale, ObservableMixin, Rect, ResizeObserver, abortableDebounce, add, collectStylesheets, compareArrays, count, crc32, createElement, delay, diff, diffToChanges, env, exponentialDelay, fastDiff, findClosestScrollableAncestor, first, formatHtml, getAncestors, getBorderWidths, getCode, getDataFromElement, getEnvKeystrokeText, getLanguageDirection, getLocalizedArrowKeyCodeDirection, getOptimalPosition, getRangeFromMouseEvent, getVisualViewportOffset, global, indexOf, insertAt, insertToPriorityArray, isArrowKeyCode, isCombiningMark, isComment, isForwardArrowKeyCode, isHighSurrogateHalf, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isLowSurrogateHalf, isNode, isRange, isText, isValidAttributeName, isViewWithFocusTracker, isVisible, keyCodes, logError, logWarning, mix, parseBase64EncodedObject, parseKeystroke, priorities, releaseDate, remove, retry, scrollAncestorsToShowTarget, scrollViewportToShowTarget, setDataInElement, spliceArray, toArray, toMap, toUnit, uid, version, wait };
+export { CKEditorError, Collection, Config, DOCUMENTATION_URL, DomEmitterMixin, ElementReplacer, EmitterMixin, EventInfo, FocusTracker, KeystrokeHandler, Locale, ObservableMixin, Rect, ResizeObserver, _clear as _clearTranslations, _getEmitterId, _getEmitterListenedTo, getUserAgent as _getUserAgent, isAndroid as _isAndroid, isBlink as _isBlink, isGecko as _isGecko, isMac as _isMac, isMediaForcedColors as _isMediaForcedColors, isMotionReduced as _isMotionReduced, isRegExpUnicodePropertySupported as _isRegExpUnicodePropertySupported, isSafari as _isSafari, isWindows as _isWindows, isiOS as _isiOS, _setEmitterId, _translate, _unifyTranslations, abortableDebounce, add, areConnectedThroughProperties, collectStylesheets, compareArrays, count, crc32, createElement, delay, diff, diffToChanges, env, exponentialDelay, fastDiff, findClosestScrollableAncestor, first, formatHtml, getAncestors, getBorderWidths, getCode, getCommonAncestor, getDataFromElement, getEnvKeystrokeText, getLanguageDirection, getLocalizedArrowKeyCodeDirection, getOptimalPosition, getPositionedAncestor, getRangeFromMouseEvent, getVisualViewportOffset, global, indexOf, insertAt, insertToPriorityArray, isArrowKeyCode, isCombiningMark, isComment, isForwardArrowKeyCode, isHighSurrogateHalf, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isLowSurrogateHalf, isNode, isRange, isText, isValidAttributeName, isViewWithFocusTracker, isVisible, isWindow, keyCodes, logError, logWarning, mapsEqual, nth, objectToMap, parseBase64EncodedObject, parseKeystroke, priorities, releaseDate, remove, retry, scrollAncestorsToShowTarget, scrollViewportToShowTarget, setDataInElement, spliceArray, spy, toArray, toMap, toUnit, uid, version, wait };
 //# sourceMappingURL=index.js.map