@ckeditor/ckeditor5-utils 35.3.2 → 36.0.0

package/src/env.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /* globals navigator:false */
@@ -9,8 +9,6 @@
 /**
  * Safely returns `userAgent` from browser's navigator API in a lower case.
  * If navigator API is not available it will return an empty string.
- *
- * @returns {String}
  */
 export function getUserAgent() {
     // In some environments navigator API might not be available.
@@ -24,73 +22,16 @@ export function getUserAgent() {
 const userAgent = getUserAgent();
 /**
  * A namespace containing environment and browser information.
- *
- * @namespace
  */
 const env = {
-    /**
-     * Indicates that the application is running on Macintosh.
-     *
-     * @static
-     * @type {Boolean}
-     */
     isMac: isMac(userAgent),
-    /**
-     * Indicates that the application is running on Windows.
-     *
-     * @static
-     * @type {Boolean}
-     */
     isWindows: isWindows(userAgent),
-    /**
-     * Indicates that the application is running in Firefox (Gecko).
-     *
-     * @static
-     * @type {Boolean}
-     */
     isGecko: isGecko(userAgent),
-    /**
-     * Indicates that the application is running in Safari.
-     *
-     * @static
-     * @type {Boolean}
-     */
     isSafari: isSafari(userAgent),
-    /**
-     * Indicates the the application is running in iOS.
-     *
-     * @static
-     * @type {Boolean}
-     */
     isiOS: isiOS(userAgent),
-    /**
-     * Indicates that the application is running on Android mobile device.
-     *
-     * @static
-     * @type {Boolean}
-     */
     isAndroid: isAndroid(userAgent),
-    /**
-     * Indicates that the application is running in a browser using the Blink engine.
-     *
-     * @static
-     * @type {Boolean}
-     */
     isBlink: isBlink(userAgent),
-    /**
-     * Environment features information.
-     *
-     * @memberOf module:utils/env~env
-     * @namespace
-     */
     features: {
-        /**
-         * Indicates that the environment supports ES2018 Unicode property escapes — 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).
-         *
-         * @type {Boolean}
-         */
         isRegExpUnicodePropertySupported: isRegExpUnicodePropertySupported()
     }
 };
@@ -98,8 +39,8 @@ export default env;
 /**
  * Checks if User Agent represented by the string is running on Macintosh.
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is running on Macintosh or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is running on Macintosh or not.
  */
 export function isMac(userAgent) {
     return userAgent.indexOf('macintosh') > -1;
@@ -107,8 +48,8 @@ export function isMac(userAgent) {
 /**
  * Checks if User Agent represented by the string is running on Windows.
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is running on Windows or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is running on Windows or not.
  */
 export function isWindows(userAgent) {
     return userAgent.indexOf('windows') > -1;
@@ -116,8 +57,8 @@ export function isWindows(userAgent) {
 /**
  * Checks if User Agent represented by the string is Firefox (Gecko).
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is Firefox or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is Firefox or not.
  */
 export function isGecko(userAgent) {
     return !!userAgent.match(/gecko\/\d+/);
@@ -125,8 +66,8 @@ export function isGecko(userAgent) {
 /**
  * Checks if User Agent represented by the string is Safari.
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is Safari or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is Safari or not.
  */
 export function isSafari(userAgent) {
     return userAgent.indexOf(' applewebkit/') > -1 && userAgent.indexOf('chrome') === -1;
@@ -134,8 +75,8 @@ export function isSafari(userAgent) {
 /**
  * Checks if User Agent represented by the string is running in iOS.
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is running in iOS or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is running in iOS or not.
  */
 export function isiOS(userAgent) {
     // "Request mobile site" || "Request desktop site".
@@ -144,8 +85,8 @@ export function isiOS(userAgent) {
 /**
  * Checks if User Agent represented by the string is Android mobile device.
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is Safari or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is Safari or not.
  */
 export function isAndroid(userAgent) {
     return userAgent.indexOf('android') > -1;
@@ -153,8 +94,8 @@ export function isAndroid(userAgent) {
 /**
  * Checks if User Agent represented by the string is Blink engine.
  *
- * @param {String} userAgent **Lowercase** `navigator.userAgent` string.
- * @returns {Boolean} Whether User Agent is Blink engine or not.
+ * @param userAgent **Lowercase** `navigator.userAgent` string.
+ * @returns Whether User Agent is Blink engine or not.
  */
 export function isBlink(userAgent) {
     // The Edge browser before switching to the Blink engine used to report itself as Chrome (and "Edge/")
@@ -165,8 +106,6 @@ export function isBlink(userAgent) {
  * 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).
- *
- * @returns {Boolean}
  */
 export function isRegExpUnicodePropertySupported() {
     let isSupported = false;

package/src/eventinfo.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
@@ -12,8 +12,8 @@ import spy from './spy';
  */
 export default class EventInfo {
     /**
-     * @param {Object} source The emitter.
-     * @param {String} name The event name.
+     * @param source The emitter.
+     * @param name The event name.
      */
     constructor(source, name) {
         this.source = source;

package/src/fastdiff.js

@@ -1,95 +1,113 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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/fastdiff
+ */
 /**
  * Finds positions of the first and last change in the given string/array and generates a set of changes:
  *
- *		fastDiff( '12a', '12xyza' );
- *		// [ { index: 2, type: 'insert', values: [ 'x', 'y', 'z' ] } ]
+ * ```ts
+ * fastDiff( '12a', '12xyza' );
+ * // [ { index: 2, type: 'insert', values: [ 'x', 'y', 'z' ] } ]
  *
- *		fastDiff( '12a', '12aa' );
- *		// [ { index: 3, type: 'insert', values: [ 'a' ] } ]
+ * fastDiff( '12a', '12aa' );
+ * // [ { index: 3, type: 'insert', values: [ 'a' ] } ]
  *
- *		fastDiff( '12xyza', '12a' );
- *		// [ { index: 2, type: 'delete', howMany: 3 } ]
+ * fastDiff( '12xyza', '12a' );
+ * // [ { index: 2, type: 'delete', howMany: 3 } ]
  *
- *		fastDiff( [ '1', '2', 'a', 'a' ], [ '1', '2', 'a' ] );
- *		// [ { index: 3, type: 'delete', howMany: 1 } ]
+ * fastDiff( [ '1', '2', 'a', 'a' ], [ '1', '2', 'a' ] );
+ * // [ { index: 3, type: 'delete', howMany: 1 } ]
  *
- *		fastDiff( [ '1', '2', 'a', 'b', 'c', '3' ], [ '2', 'a', 'b' ] );
- *		// [ { index: 0, type: 'insert', values: [ '2', 'a', 'b' ] }, { index: 3, type: 'delete', howMany: 6 } ]
+ * fastDiff( [ '1', '2', 'a', 'b', 'c', '3' ], [ '2', 'a', 'b' ] );
+ * // [ { index: 0, type: 'insert', values: [ '2', 'a', 'b' ] }, { index: 3, type: 'delete', howMany: 6 } ]
+ * ```
  *
  * Passed arrays can contain any type of data, however to compare them correctly custom comparator function
  * should be passed as a third parameter:
  *
- *		fastDiff( [ { value: 1 }, { value: 2 } ], [ { value: 1 }, { value: 3 } ], ( a, b ) => {
- *			return a.value === b.value;
- *		} );
- *		// [ { index: 1, type: 'insert', values: [ { value: 3 } ] }, { index: 2, type: 'delete', howMany: 1 } ]
+ * ```ts
+ * fastDiff( [ { value: 1 }, { value: 2 } ], [ { value: 1 }, { value: 3 } ], ( a, b ) => {
+ * 	return a.value === b.value;
+ * } );
+ * // [ { index: 1, type: 'insert', values: [ { value: 3 } ] }, { index: 2, type: 'delete', howMany: 1 } ]
+ * ```
  *
  * The resulted set of changes can be applied to the input in order to transform it into the output, for example:
  *
- *		let input = '12abc3';
- *		const output = '2ab';
- *		const changes = fastDiff( input, output );
+ * ```ts
+ * let input = '12abc3';
+ * const output = '2ab';
+ * const changes = fastDiff( input, output );
  *
- *		changes.forEach( change => {
- *			if ( change.type == 'insert' ) {
- *				input = input.substring( 0, change.index ) + change.values.join( '' ) + input.substring( change.index );
- *			} else if ( change.type == 'delete' ) {
- *				input = input.substring( 0, change.index ) + input.substring( change.index + change.howMany );
- *			}
- *		} );
+ * changes.forEach( change => {
+ * 	if ( change.type == 'insert' ) {
+ * 		input = input.substring( 0, change.index ) + change.values.join( '' ) + input.substring( change.index );
+ * 	} else if ( change.type == 'delete' ) {
+ * 		input = input.substring( 0, change.index ) + input.substring( change.index + change.howMany );
+ * 	}
+ * } );
  *
- *		// input equals output now
+ * // input equals output now
+ * ```
  *
  * or in case of arrays:
  *
- *		let input = [ '1', '2', 'a', 'b', 'c', '3' ];
- *		const output = [ '2', 'a', 'b' ];
- *		const changes = fastDiff( input, output );
+ * ```ts
+ * let input = [ '1', '2', 'a', 'b', 'c', '3' ];
+ * const output = [ '2', 'a', 'b' ];
+ * const changes = fastDiff( input, output );
  *
- *		changes.forEach( change => {
- *			if ( change.type == 'insert' ) {
- *				input = input.slice( 0, change.index ).concat( change.values, input.slice( change.index ) );
- *			} else if ( change.type == 'delete' ) {
- *				input = input.slice( 0, change.index ).concat( input.slice( change.index + change.howMany ) );
- *			}
- *		} );
+ * changes.forEach( change => {
+ * 	if ( change.type == 'insert' ) {
+ * 		input = input.slice( 0, change.index ).concat( change.values, input.slice( change.index ) );
+ * 	} else if ( change.type == 'delete' ) {
+ * 		input = input.slice( 0, change.index ).concat( input.slice( change.index + change.howMany ) );
+ * 	}
+ * } );
  *
- *		// input equals output now
+ * // input equals output now
+ * ```
  *
  * By passing `true` as the fourth parameter (`atomicChanges`) the output of this function will become compatible with
  * the {@link module:utils/diff~diff `diff()`} function:
  *
- *		fastDiff( '12a', '12xyza' );
- *		// [ 'equal', 'equal', 'insert', 'insert', 'insert', 'equal' ]
+ * ```ts
+ * fastDiff( '12a', '12xyza', undefined, true );
+ * // [ 'equal', 'equal', 'insert', 'insert', 'insert', 'equal' ]
+ * ```
  *
  * The default output format of this function is compatible with the output format of
  * {@link module:utils/difftochanges~diffToChanges `diffToChanges()`}. The `diffToChanges()` input format is, in turn,
  * compatible with the output of {@link module:utils/diff~diff `diff()`}:
  *
- *		const a = '1234';
- *		const b = '12xyz34';
- *
- *		// Both calls will return the same results (grouped changes format).
- *		fastDiff( a, b );
- *		diffToChanges( diff( a, b ) );
- *
- *		// Again, both calls will return the same results (atomic changes format).
- *		fastDiff( a, b, null, true );
- *		diff( a, b );
- *
- *
- * @param {Array|String} a Input array or string.
- * @param {Array|String} b Input array or string.
- * @param {Function} [cmp] Optional function used to compare array values, by default `===` (strict equal operator) is used.
- * @param {Boolean} [atomicChanges=false] Whether an array of `inset|delete|equal` operations should
+ * ```ts
+ * const a = '1234';
+ * const b = '12xyz34';
+ *
+ * // Both calls will return the same results (grouped changes format).
+ * fastDiff( a, b );
+ * diffToChanges( diff( a, b ) );
+ *
+ * // Again, both calls will return the same results (atomic changes format).
+ * fastDiff( a, b, undefined, true );
+ * diff( a, b );
+ * ```
+ *
+ * @typeParam T The type of array elements.
+ * @typeParam AtomicChanges The type of `atomicChanges` parameter (selects the result type).
+ * @param a Input array or string.
+ * @param b Input array or string.
+ * @param cmp Optional function used to compare array values, by default `===` (strict equal operator) is used.
+ * @param atomicChanges Whether an array of `inset|delete|equal` operations should
  * be returned instead of changes set. This makes this function compatible with {@link module:utils/diff~diff `diff()`}.
- * @returns {Array} Array of changes.
+ * Defaults to `false`.
+ * @returns Array of changes. The elements are either {@link module:utils/diff~DiffResult} or {@link module:utils/difftochanges~Change},
+ * depending on `atomicChanges` parameter.
  */
-export default function fastDiff(a, b, cmp, atomicChanges = false) {
+export default function fastDiff(a, b, cmp, atomicChanges) {
     // Set the comparator function.
     cmp = cmp || function (a, b) {
         return a === b;
@@ -105,24 +123,23 @@ export default function fastDiff(a, b, cmp, atomicChanges = false) {
     // Find first and last change.
     const changeIndexes = findChangeBoundaryIndexes(arrayA, arrayB, cmp);
     // Transform into changes array.
-    return atomicChanges ? changeIndexesToAtomicChanges(changeIndexes, arrayB.length) : changeIndexesToChanges(arrayB, changeIndexes);
+    const result = atomicChanges ?
+        changeIndexesToAtomicChanges(changeIndexes, arrayB.length) :
+        changeIndexesToChanges(arrayB, changeIndexes);
+    return result;
 }
-// Finds position of the first and last change in the given arrays. For example:
-//
-//		const indexes = findChangeBoundaryIndexes( [ '1', '2', '3', '4' ], [ '1', '3', '4', '2', '4' ] );
-//		console.log( indexes ); // { firstIndex: 1, lastIndexOld: 3, lastIndexNew: 4 }
-//
-// The above indexes means that in the first array the modified part is `1[23]4` and in the second array it is `1[342]4`.
-// Based on such indexes, array with `insert`/`delete` operations which allows transforming first value into the second one
-// can be generated.
-//
-// @param {Array} arr1
-// @param {Array} arr2
-// @param {Function} cmp Comparator function.
-// @returns {Object}
-// @returns {Number} return.firstIndex Index of the first change in both values (always the same for both).
-// @returns {Number} result.lastIndexOld Index of the last common value in `arr1`.
-// @returns {Number} result.lastIndexNew Index of the last common value in `arr2`.
+/**
+ * Finds position of the first and last change in the given arrays. For example:
+ *
+ * ```ts
+ * const indexes = findChangeBoundaryIndexes( [ '1', '2', '3', '4' ], [ '1', '3', '4', '2', '4' ] );
+ * console.log( indexes ); // { firstIndex: 1, lastIndexOld: 3, lastIndexNew: 4 }
+ * ```
+ *
+ * The above indexes means that in the first array the modified part is `1[23]4` and in the second array it is `1[342]4`.
+ * Based on such indexes, array with `insert`/`delete` operations which allows transforming first value into the second one
+ * can be generated.
+ */
 function findChangeBoundaryIndexes(arr1, arr2, cmp) {
     // Find the first difference between passed values.
     const firstIndex = findFirstDifferenceIndex(arr1, arr2, cmp);
@@ -150,12 +167,9 @@ function findChangeBoundaryIndexes(arr1, arr2, cmp) {
     const lastIndexNew = arr2.length - lastIndex;
     return { firstIndex, lastIndexOld, lastIndexNew };
 }
-// Returns a first index on which given arrays differ. If both arrays are the same, -1 is returned.
-//
-// @param {Array} arr1
-// @param {Array} arr2
-// @param {Function} cmp Comparator function.
-// @returns {Number}
+/**
+ * Returns a first index on which given arrays differ. If both arrays are the same, -1 is returned.
+ */
 function findFirstDifferenceIndex(arr1, arr2, cmp) {
     for (let i = 0; i < Math.max(arr1.length, arr2.length); i++) {
         if (arr1[i] === undefined || arr2[i] === undefined || !cmp(arr1[i], arr2[i])) {
@@ -164,21 +178,24 @@ function findFirstDifferenceIndex(arr1, arr2, cmp) {
     }
     return -1; // Return -1 if arrays are equal.
 }
-// Returns a copy of the given array with `howMany` elements removed starting from the beginning and in reversed order.
-//
-// @param {Array} arr Array to be processed.
-// @param {Number} howMany How many elements from array beginning to remove.
-// @returns {Array} Shortened and reversed array.
+/**
+ * Returns a copy of the given array with `howMany` elements removed starting from the beginning and in reversed order.
+ *
+ * @param arr Array to be processed.
+ * @param howMany How many elements from array beginning to remove.
+ * @returns Shortened and reversed array.
+ */
 function cutAndReverse(arr, howMany) {
     return arr.slice(howMany).reverse();
 }
-// Generates changes array based on change indexes from `findChangeBoundaryIndexes` function. This function will
-// generate array with 0 (no changes), 1 (deletion or insertion) or 2 records (insertion and deletion).
-//
-// @param {Array} newArray New array for which change indexes were calculated.
-// @param {Object} changeIndexes Change indexes object from `findChangeBoundaryIndexes` function.
-// @returns {Array.<module:utils/difftochanges~Change>} Array of changes compatible with
-// {@link module:utils/difftochanges~diffToChanges} format.
+/**
+ * Generates changes array based on change indexes from `findChangeBoundaryIndexes` function. This function will
+ * generate array with 0 (no changes), 1 (deletion or insertion) or 2 records (insertion and deletion).
+ *
+ * @param newArray New array for which change indexes were calculated.
+ * @param changeIndexes Change indexes object from `findChangeBoundaryIndexes` function.
+ * @returns Array of changes compatible with {@link module:utils/difftochanges~diffToChanges} format.
+ */
 function changeIndexesToChanges(newArray, changeIndexes) {
     const result = [];
     const { firstIndex, lastIndexOld, lastIndexNew } = changeIndexes;
@@ -201,11 +218,13 @@ function changeIndexesToChanges(newArray, changeIndexes) {
     }
     return result;
 }
-// Generates array with set `equal|insert|delete` operations based on change indexes from `findChangeBoundaryIndexes` function.
-//
-// @param {Object} changeIndexes Change indexes object from `findChangeBoundaryIndexes` function.
-// @param {Number} newLength Length of the new array on which `findChangeBoundaryIndexes` calculated change indexes.
-// @returns {Array.<module:utils/diff~DiffResult>} Array of changes compatible with {@link module:utils/diff~diff} format.
+/**
+ * Generates array with set `equal|insert|delete` operations based on change indexes from `findChangeBoundaryIndexes` function.
+ *
+ * @param changeIndexes Change indexes object from `findChangeBoundaryIndexes` function.
+ * @param newLength Length of the new array on which `findChangeBoundaryIndexes` calculated change indexes.
+ * @returns Array of changes compatible with {@link module:utils/diff~diff} format.
+ */
 function changeIndexesToAtomicChanges(changeIndexes, newLength) {
     const { firstIndex, lastIndexOld, lastIndexNew } = changeIndexes;
     // No changes.

package/src/first.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
@@ -7,9 +7,6 @@
  */
 /**
  * Returns first item of the given `iterator`.
- *
- * @param {Iterator.<*>} iterator
- * @returns {*}
  */
 export default function first(iterator) {
     const iteratorItem = iterator.next();

package/src/focustracker.js

@@ -1,14 +1,13 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /* global setTimeout, clearTimeout */
-/* eslint-disable new-cap */
 /**
  * @module utils/focustracker
  */
 import DomEmitterMixin from './dom/emittermixin';
-import { Observable } from './observablemixin';
+import ObservableMixin from './observablemixin';
 import CKEditorError from './ckeditorerror';
 /**
  * Allows observing a group of `Element`s whether at least one of them is focused.
@@ -21,22 +20,23 @@ import CKEditorError from './ckeditorerror';
  * (have e.g. `tabindex="-1"`).
  *
  * Check out the {@glink framework/guides/deep-dive/ui/focus-tracking "Deep dive into focus tracking" guide} to learn more.
- *
- * @mixes module:utils/dom/emittermixin~EmitterMixin
- * @mixes module:utils/observablemixin~ObservableMixin
  */
-export default class FocusTracker extends DomEmitterMixin(Observable) {
+export default class FocusTracker extends DomEmitterMixin(ObservableMixin()) {
     constructor() {
         super();
-        this.set('isFocused', false);
-        this.set('focusedElement', null);
+        /**
+         * List of registered elements.
+         */
         this._elements = new Set();
+        /**
+         * Event loop timeout.
+         */
         this._nextEventLoopTimeout = null;
+        this.set('isFocused', false);
+        this.set('focusedElement', null);
     }
     /**
      * Starts tracking the specified element.
-     *
-     * @param {Element} element
      */
     add(element) {
         if (this._elements.has(element)) {
@@ -53,8 +53,6 @@ export default class FocusTracker extends DomEmitterMixin(Observable) {
     }
     /**
      * Stops tracking the specified element and stops listening on this element.
-     *
-     * @param {Element} element
      */
     remove(element) {
         if (element === this.focusedElement) {
@@ -74,10 +72,7 @@ export default class FocusTracker extends DomEmitterMixin(Observable) {
         this.stopListening();
     }
     /**
-     * Stores currently focused element and set {#isFocused} as `true`.
-     *
-     * @private
-     * @param {Element} element Element which has been focused.
+     * Stores currently focused element and set {@link #isFocused} as `true`.
      */
     _focus(element) {
         clearTimeout(this._nextEventLoopTimeout);
@@ -87,9 +82,6 @@ export default class FocusTracker extends DomEmitterMixin(Observable) {
     /**
      * Clears currently focused element and set {@link #isFocused} as `false`.
      * This method uses `setTimeout` to change order of fires `blur` and `focus` events.
-     *
-     * @private
-     * @fires blur
      */
     _blur() {
         clearTimeout(this._nextEventLoopTimeout);

package/src/index.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
@@ -7,20 +7,36 @@
  */
 export { default as env } from './env';
 export { default as diff } from './diff';
+export { default as fastDiff } from './fastdiff';
 export { default as mix } from './mix';
 export { default as EmitterMixin } from './emittermixin';
+export { default as EventInfo } from './eventinfo';
 export { default as ObservableMixin } from './observablemixin';
 export { default as CKEditorError, logError, logWarning } from './ckeditorerror';
 export { default as ElementReplacer } from './elementreplacer';
+export { default as count } from './count';
+export { default as compareArrays } from './comparearrays';
 export { default as createElement } from './dom/createelement';
+export { default as Config } from './config';
+export { default as isIterable } from './isiterable';
 export { default as DomEmitterMixin } from './dom/emittermixin';
+export { default as findClosestScrollableAncestor } from './dom/findclosestscrollableancestor';
 export { default as global } from './dom/global';
+export { default as getAncestors } from './dom/getancestors';
 export { default as getDataFromElement } from './dom/getdatafromelement';
+export { default as isText } from './dom/istext';
 export { default as Rect } from './dom/rect';
 export { default as ResizeObserver } from './dom/resizeobserver';
 export { default as setDataInElement } from './dom/setdatainelement';
 export { default as toUnit } from './dom/tounit';
+export { default as indexOf } from './dom/indexof';
+export { default as insertAt } from './dom/insertat';
+export { default as isComment } from './dom/iscomment';
+export { default as isNode } from './dom/isnode';
+export { default as isRange } from './dom/isrange';
 export { default as isVisible } from './dom/isvisible';
+export { getOptimalPosition } from './dom/position';
+export { default as remove } from './dom/remove';
 export * from './dom/scroll';
 export * from './keyboard';
 export * from './language';
@@ -33,5 +49,7 @@ export { default as toArray } from './toarray';
 export { default as toMap } from './tomap';
 export { default as priorities } from './priorities';
 export { default as insertToPriorityArray } from './inserttopriorityarray';
+export { default as spliceArray } from './splicearray';
 export { default as uid } from './uid';
+export * from './unicode';
 export { default as version } from './version';

package/src/inserttopriorityarray.js

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 import priorities from './priorities';
 /**
  * Inserts any object with priority at correct index by priority so registered objects are always sorted from highest to lowest priority.
  *
- * @param {Array.<module:utils/inserttopriorityarray~ObjectWithPriority>} objects Array of objects with priority to insert object to.
- * @param {module:utils/inserttopriorityarray~ObjectWithPriority} objectToInsert Object with `priority` property.
+ * @param objects Array of objects with priority to insert object to.
+ * @param objectToInsert Object with `priority` property.
  */
 export default function insertToPriorityArray(objects, objectToInsert) {
     const priority = priorities.get(objectToInsert.priority);