@ckeditor/ckeditor5-utils 44.0.0 → 44.1.0-alpha.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { isObject, isString, isPlainObject, cloneDeepWith, isElement as isElemen
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /* globals window, document */ /**
  * @module utils/dom/global
  */ // This interface exists to make our API pages more readable.
@@ -171,7 +171,7 @@ const userAgent = /* #__PURE__ */ getUserAgent();
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/fastdiff
  */ /**
@@ -524,7 +524,7 @@ diff.fastDiff = fastDiff;
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/difftochanges
  */ /**
@@ -599,7 +599,7 @@ diff.fastDiff = fastDiff;
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/mix
  */ /**
@@ -647,7 +647,7 @@ diff.fastDiff = fastDiff;
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/spy
  */ /**
@@ -714,7 +714,7 @@ diff.fastDiff = fastDiff;
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/uid
  */ /**
@@ -739,7 +739,7 @@ diff.fastDiff = fastDiff;
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/priorities
  */ /**
@@ -785,7 +785,7 @@ diff.fastDiff = fastDiff;
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/ckeditorerror
  */ /* globals console */ /**
@@ -959,9 +959,9 @@ diff.fastDiff = fastDiff;
     ];
 }
 
-const version = '44.0.0';
+const version = '44.1.0-alpha.1';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2024, 11, 2);
+const releaseDate = new Date(2024, 11, 12);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
 	 * This error is thrown when, due to a mistake in the way CKEditor 5 was installed,
@@ -1242,24 +1242,20 @@ function EmitterMixin(base) {
                 eventInfo.path.push(this);
                 // Handle event listener callbacks first.
                 if (callbacks) {
-                    // Arguments passed to each callback.
-                    const callbackArgs = [
-                        eventInfo,
-                        ...args
-                    ];
                     // Copying callbacks array is the easiest and most secure way of preventing infinite loops, when event callbacks
                     // are added while processing other callbacks. Previous solution involved adding counters (unique ids) but
                     // failed if callbacks were added to the queue before currently processed callback.
                     // If this proves to be too inefficient, another method is to change `.on()` so callbacks are stored if same
                     // event is currently processed. Then, `.fire()` at the end, would have to add all stored events.
-                    callbacks = Array.from(callbacks);
+                    callbacks = callbacks.slice();
                     for(let i = 0; i < callbacks.length; i++){
-                        callbacks[i].callback.apply(this, callbackArgs);
+                        const fn = callbacks[i].callback;
+                        fn.call(this, eventInfo, ...args);
                         // Remove the callback from future requests if off() has been called.
                         if (eventInfo.off.called) {
                             // Remove the called mark for the next calls.
                             delete eventInfo.off.called;
-                            this._removeEventListener(event, callbacks[i].callback);
+                            this._removeEventListener(event, fn);
                         }
                         // Do not execute next callbacks if stop() was called.
                         if (eventInfo.stop.called) {
@@ -1499,19 +1495,19 @@ function EmitterMixin(base) {
  * If there are no callbacks registered for given event, it checks if this is a specific event and looks
  * for callbacks for it's more generic version.
  */ function getCallbacksForEvent(source, eventName) {
-    let event;
-    if (!source._events || !(event = source._events[eventName]) || !event.callbacks.length) {
-        // There are no callbacks registered for specified eventName.
-        // But this could be a specific-type event that is in a namespace.
-        if (eventName.indexOf(':') > -1) {
-            // If the eventName is specific, try to find callback lists for more generic event.
-            return getCallbacksForEvent(source, eventName.substr(0, eventName.lastIndexOf(':')));
-        } else {
-            // If this is a top-level generic event, return null;
-            return null;
-        }
+    if (!source._events) {
+        return null;
     }
-    return event.callbacks;
+    let currentEventName = eventName;
+    do {
+        const event = source._events[currentEventName];
+        if (event && event.callbacks && event.callbacks.length) {
+            return event.callbacks;
+        }
+        const colonIndex = currentEventName.lastIndexOf(':');
+        currentEventName = colonIndex > -1 ? currentEventName.substring(0, colonIndex) : '';
+    }while (currentEventName)
+    return null;
 }
 /**
  * Fires delegated events for given map of destinations.
@@ -2132,7 +2128,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/elementreplacer
  */ /**
@@ -2177,7 +2173,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/abortabledebounce
  */ /**
@@ -2197,7 +2193,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/count
  */ /**
@@ -2220,7 +2216,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/comparearrays
  */ /**
@@ -2263,7 +2259,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/isiterable
  */ /**
@@ -2460,7 +2456,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/isnode
  */ /**
@@ -2478,7 +2474,7 @@ function initObservable(observable) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/iswindow
  */ /**
@@ -2762,7 +2758,7 @@ function DomEmitterMixin(base) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /* globals Node */ /**
  * @module utils/dom/getancestors
  */ /**
@@ -2786,7 +2782,7 @@ function DomEmitterMixin(base) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /* globals HTMLTextAreaElement */ /**
  * @module utils/dom/getdatafromelement
  */ /**
@@ -2803,7 +2799,7 @@ function DomEmitterMixin(base) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/getborderwidths
  */ /**
@@ -2825,7 +2821,7 @@ function DomEmitterMixin(base) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/getrangefrommouseevent
  */ /**
@@ -2854,7 +2850,7 @@ function DomEmitterMixin(base) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/istext
  */ /**
@@ -2865,7 +2861,7 @@ function DomEmitterMixin(base) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/isrange
  */ /**
@@ -3473,7 +3469,7 @@ const rectProperties = [
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/setdatainelement
  */ /* globals HTMLTextAreaElement */ /**
@@ -3490,7 +3486,7 @@ const rectProperties = [
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/tounit
  */ /**
@@ -3504,7 +3500,7 @@ const rectProperties = [
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/indexof
  */ /**
@@ -3523,7 +3519,7 @@ const rectProperties = [
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/insertat
  */ /**
@@ -3538,7 +3534,7 @@ const rectProperties = [
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /* globals Node */ /**
  * @module utils/dom/iscomment
  */ /**
@@ -3886,7 +3882,7 @@ const rectProperties = [
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/dom/remove
  */ /**
@@ -4500,7 +4496,7 @@ function splitKeystrokeText(keystroke) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/language
  */ /**
@@ -4530,7 +4526,7 @@ function splitKeystrokeText(keystroke) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/toarray
  */ /**
@@ -5350,7 +5346,7 @@ function getNumberOfLanguages(translations) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/first
  */ /**
@@ -5774,7 +5770,7 @@ function isFocusedView(subTreeRoot, view) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/objecttomap
  */ /**
@@ -5818,7 +5814,7 @@ function isFocusedView(subTreeRoot, view) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/wait
  */ /**
@@ -5886,22 +5882,19 @@ function isFocusedView(subTreeRoot, view) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/splicearray
- */ const BIG_CHUNK_SIZE = 10000;
-/**
- * Splices one array into another. To be used instead of `Array.prototype.splice` as the latter may
- * throw "Maximum call stack size exceeded" when passed huge number of items to insert.
- *
- * Note: in contrary to Array.splice, this function does not modify the original `target`.
+ */ /**
+ * Splices one array into another. To be used instead of `Array.prototype.splice` for better
+ * performance and because the latter may throw "Maximum call stack size exceeded" error when
+ * passing huge number of items to insert.
  *
  * ```ts
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 0, 0 );	// [ 3, 4, 1, 2 ]
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 1, 1 );	// [ 1, 3, 4 ]
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 1, 0 );	// [ 1, 3, 4, 2 ]
- * spliceArray( [ 1, 2 ], [ 3, 4 ], 2, 0 );	// [ 1, 2, 3, 4 ]
- * spliceArray( [ 1, 2 ], [],       0, 1 );	// [ 2 ]
+ * spliceArray( [ 1, 2 ], [ 3, 4 ], 0 );	// [ 3, 4, 1, 2 ]
+ * spliceArray( [ 1, 2 ], [ 3, 4 ], 1 );	// [ 1, 3, 4, 2 ]
+ * spliceArray( [ 1, 2 ], [ 3, 4 ], 2 );	// [ 1, 2, 3, 4 ]
+ * spliceArray( [ 1, 2 ], [],       0 );	// [ 1, 2 ]
  * ```
  *
  * @param target Array to be spliced.
@@ -5910,20 +5903,22 @@ function isFocusedView(subTreeRoot, view) {
  * @param count Number of items.
  *
  * @returns New spliced array.
- */ function spliceArray(target, source, start, count) {
-    // In case of performance problems, see: https://github.com/ckeditor/ckeditor5/pull/12429/files#r965850568
-    if (Math.max(source.length, target.length) > BIG_CHUNK_SIZE) {
-        return target.slice(0, start).concat(source).concat(target.slice(start + count, target.length));
-    } else {
-        const newTarget = Array.from(target);
-        newTarget.splice(start, count, ...source);
-        return newTarget;
+ */ function spliceArray(targetArray, insertArray, index) {
+    const originalLength = targetArray.length;
+    const insertLength = insertArray.length;
+    // Shift elements in the target array to make space for insertArray
+    for(let i = originalLength - 1; i >= index; i--){
+        targetArray[i + insertLength] = targetArray[i];
+    }
+    // Copy elements from insertArray into the target array
+    for(let i = 0; i < insertLength; i++){
+        targetArray[index + i] = insertArray[i];
     }
 }
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/delay
  */ /* globals setTimeout, clearTimeout */ /**
@@ -5946,7 +5941,7 @@ function isFocusedView(subTreeRoot, view) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/parsebase64encodedobject
  */ /**
@@ -5965,7 +5960,7 @@ function isFocusedView(subTreeRoot, view) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * @module utils/crc32
  */ /**
@@ -6024,7 +6019,7 @@ function isFocusedView(subTreeRoot, view) {
 
 /**
  * @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
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */ /**
  * Set of utils to handle unicode characters.
  *