@ckeditor/ckeditor5-utils 35.3.2 → 36.0.0

package/src/diff.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,17 +12,19 @@ import fastDiff from './fastdiff';
  * Calculates the difference between two arrays or strings producing an array containing a list of changes
  * necessary to transform input into output.
  *
- *		diff( 'aba', 'acca' ); // [ 'equal', 'insert', 'insert', 'delete', 'equal' ]
+ * ```ts
+ * diff( 'aba', 'acca' ); // [ 'equal', 'insert', 'insert', 'delete', 'equal' ]
+ * ```
  *
  * This function is based on the "O(NP) Sequence Comparison Algorithm" by Sun Wu, Udi Manber, Gene Myers, Webb Miller.
  * Unfortunately, while it gives the most precise results, its to complex for longer strings/arrow (above 200 items).
  * Therefore, `diff()` automatically switches to {@link module:utils/fastdiff~fastDiff `fastDiff()`} when detecting
  * such a scenario. The return formats of both functions are identical.
  *
- * @param {Array|String} a Input array or string.
- * @param {Array|String} b Output array or string.
- * @param {Function} [cmp] Optional function used to compare array values, by default === is used.
- * @returns {Array.<module:utils/diff~DiffResult>} Array of changes.
+ * @param a Input array or string.
+ * @param b Output array or string.
+ * @param cmp Optional function used to compare array values, by default === is used.
+ * @returns Array of changes.
  */
 export default function diff(a, b, cmp) {
     // Set the comparator function.

package/src/difftochanges.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
  */
 /**
@@ -9,23 +9,26 @@
  * Creates a set of changes which need to be applied to the input in order to transform
  * it into the output. This function can be used with strings or arrays.
  *
- *		const input = Array.from( 'abc' );
- *		const output = Array.from( 'xaby' );
- *		const changes = diffToChanges( diff( input, output ), output );
+ * ```ts
+ * const input = Array.from( 'abc' );
+ * const output = Array.from( 'xaby' );
+ * const changes = diffToChanges( diff( input, output ), output );
  *
- *		changes.forEach( change => {
- *			if ( change.type == 'insert' ) {
- *				input.splice( change.index, 0, ...change.values );
- *			} else if ( change.type == 'delete' ) {
- *				input.splice( change.index, change.howMany );
- *			}
- *		} );
+ * changes.forEach( change => {
+ * 	if ( change.type == 'insert' ) {
+ * 		input.splice( change.index, 0, ...change.values );
+ * 	} else if ( change.type == 'delete' ) {
+ * 		input.splice( change.index, change.howMany );
+ * 	}
+ * } );
  *
- *		input.join( '' ) == output.join( '' ); // -> true
+ * input.join( '' ) == output.join( '' ); // -> true
+ * ```
  *
- * @param {Array.<module:utils/diff~DiffResult>} diff Result of {@link module:utils/diff~diff}.
- * @param {String|Array} output The string or array which was passed as diff's output.
- * @returns {Array.<module:utils/difftochanges~Change>} Set of changes (insert or delete) which need to be applied to the input
+ * @typeParam T The type of output array element.
+ * @param diff Result of {@link module:utils/diff~diff}.
+ * @param output The string or array which was passed as diff's output.
+ * @returns Set of changes (insert or delete) which need to be applied to the input
  * in order to transform it into the output.
  */
 export default function diffToChanges(diff, output) {

package/src/dom/createelement.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
  */
 /**
@@ -10,17 +10,19 @@ import { isString } from 'lodash-es';
 /**
  * Creates element with attributes and children.
  *
- *		createElement( document, 'p' ); // <p>
- *		createElement( document, 'p', { class: 'foo' } ); // <p class="foo">
- *		createElement( document, 'p', null, 'foo' ); // <p>foo</p>
- *		createElement( document, 'p', null, [ 'foo', createElement( document, 'img' ) ] ); // <p>foo<img></p>
+ * ```ts
+ * createElement( document, 'p' ); // <p>
+ * createElement( document, 'p', { class: 'foo' } ); // <p class="foo">
+ * createElement( document, 'p', null, 'foo' ); // <p>foo</p>
+ * createElement( document, 'p', null, [ 'foo', createElement( document, 'img' ) ] ); // <p>foo<img></p>
+ * ```
  *
- * @param {Document} doc Document used to create element.
- * @param {String} name Name of the element.
- * @param {Object} [attributes] Object keys will become attributes keys and object values will became attributes values.
- * @param {Node|String|Iterable.<Node|String>} [children] Child or any iterable of children. Strings will be automatically turned
+ * @param doc Document used to create element.
+ * @param name Name of the element.
+ * @param attributes Object keys will become attributes keys and object values will became attributes values.
+ * @param children Child or any iterable of children. Strings will be automatically turned
  * into Text nodes.
- * @returns {Element} Created element.
+ * @returns Created element.
  */
 export default function createElement(doc, name, attributes = {}, children = []) {
     const namespace = attributes && attributes.xmlns;

package/src/dom/emittermixin.js

@@ -1,38 +1,19 @@
 /**
- * @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
  */
-/* eslint-disable new-cap */
 /**
  * @module utils/dom/emittermixin
  */
-import { _getEmitterListenedTo, _setEmitterId, Emitter as BaseEmitter } from '../emittermixin';
+import EmitterMixin, { _getEmitterListenedTo, _setEmitterId } from '../emittermixin';
 import uid from '../uid';
 import isNode from './isnode';
 import isWindow from './iswindow';
-/**
- * Mixin that injects the DOM events API into its host. It provides the API
- * compatible with {@link module:utils/emittermixin~EmitterMixin}.
- *
- * DOM emitter mixin is by default available in the {@link module:ui/view~View} class,
- * but it can also be mixed into any other class:
- *
- *		import mix from '../utils/mix.js';
- *		import DomEmitterMixin from '../utils/dom/emittermixin.js';
- *		import { Emitter } from '../utils/emittermixin.js';
- *
- *		class SomeView extends DomEmitterMixin( Emitter ) {}
- *
- *		const view = new SomeView();
- *		view.listenTo( domElement, ( evt, domEvt ) => {
- *			console.log( evt, domEvt );
- *		} );
- *
- * @mixin EmitterMixin
- * @mixes module:utils/emittermixin~EmitterMixin
- * @implements module:utils/dom/emittermixin~Emitter
- */
+const defaultEmitterClass = DomEmitterMixin(EmitterMixin());
 export default function DomEmitterMixin(base) {
+    if (!base) {
+        return defaultEmitterClass;
+    }
     class Mixin extends base {
         listenTo(emitter, event, callback, options = {}) {
             // Check if emitter is an instance of DOM Node. If so, use corresponding ProxyEmitter (or create one if not existing).
@@ -46,7 +27,7 @@ export default function DomEmitterMixin(base) {
             }
             else {
                 // Execute parent class method with Emitter (or ProxyEmitter) instance.
-                BaseEmitter.prototype.listenTo.call(this, emitter, event, callback, options);
+                super.listenTo(emitter, event, callback, options);
             }
         }
         stopListening(emitter, event, callback) {
@@ -59,20 +40,19 @@ export default function DomEmitterMixin(base) {
             }
             else {
                 // Execute parent class method with Emitter (or ProxyEmitter) instance.
-                BaseEmitter.prototype.stopListening.call(this, emitter, event, callback);
+                super.stopListening(emitter, event, callback);
             }
         }
         /**
          * Retrieves ProxyEmitter instance for given DOM Node residing in this Host and given options.
          *
-         * @private
-         * @param {Node|Window} node DOM Node of the ProxyEmitter.
-         * @param {Object} [options] Additional options.
-         * @param {Boolean} [options.useCapture=false] Indicates that events of this type will be dispatched to the registered
+         * @param node DOM Node of the ProxyEmitter.
+         * @param options Additional options.
+         * @param options.useCapture Indicates that events of this type will be dispatched to the registered
          * listener before being dispatched to any EventTarget beneath it in the DOM tree.
-         * @param {Boolean} [options.usePassive=false] Indicates that the function specified by listener will never call preventDefault()
+         * @param options.usePassive Indicates that the function specified by listener will never call preventDefault()
          * and prevents blocking browser's main thread by this event handler.
-         * @returns {module:utils/dom/emittermixin~ProxyEmitter|null} ProxyEmitter instance bound to the DOM Node.
+         * @returns ProxyEmitter instance bound to the DOM Node.
          */
         _getProxyEmitter(node, options) {
             return _getEmitterListenedTo(this, getProxyEmitterId(node, options));
@@ -80,9 +60,7 @@ export default function DomEmitterMixin(base) {
         /**
          * Retrieves all the ProxyEmitter instances for given DOM Node residing in this Host.
          *
-         * @private
-         * @param {Node|Window} node DOM Node of the ProxyEmitter.
-         * @returns {Array.<module:utils/dom/emittermixin~ProxyEmitter>}
+         * @param node DOM Node of the ProxyEmitter.
          */
         _getAllProxyEmitters(node) {
             return [
@@ -95,7 +73,6 @@ export default function DomEmitterMixin(base) {
     }
     return Mixin;
 }
-export const Emitter = DomEmitterMixin(BaseEmitter);
 // Backward compatibility with `mix`
 ([
     '_getProxyEmitter', '_getAllProxyEmitters',
@@ -103,11 +80,11 @@ export const Emitter = DomEmitterMixin(BaseEmitter);
     'stopListening', 'fire', 'delegate', 'stopDelegating',
     '_addEventListener', '_removeEventListener'
 ]).forEach(key => {
-    DomEmitterMixin[key] = Emitter.prototype[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~EmitterMixin#on}.
+ * and any Host listening to them. It is backwards compatible with {@link module:utils/emittermixin~Emitter#on}.
  * There is a separate instance for each combination of modes (useCapture & usePassive). The mode is concatenated with
  * UID stored in HTMLElement to give each instance unique identifier.
  *
@@ -132,18 +109,14 @@ export const Emitter = DomEmitterMixin(BaseEmitter);
  *                    |                                         |                  click (DOM Event)
  *                    +-----------------------------------------+
  *                                fire( click, DOM Event )
- *
- * @mixes module:utils/emittermixin~EmitterMixin
- * @implements module:utils/dom/emittermixin~Emitter
- * @private
  */
-class ProxyEmitter extends BaseEmitter {
+class ProxyEmitter extends EmitterMixin() {
     /**
-     * @param {Node|Window} node DOM Node that fires events.
-     * @param {Object} [options] Additional options.
-     * @param {Boolean} [options.useCapture=false] Indicates that events of this type will be dispatched to the registered
+     * @param node DOM Node that fires events.
+     * @param options Additional options.
+     * @param options.useCapture Indicates that events of this type will be dispatched to the registered
      * listener before being dispatched to any EventTarget beneath it in the DOM tree.
-     * @param {Boolean} [options.usePassive=false] Indicates that the function specified by listener will never call preventDefault()
+     * @param options.usePassive Indicates that the function specified by listener will never call preventDefault()
      * and prevents blocking browser's main thread by this event handler.
      */
     constructor(node, options) {
@@ -162,10 +135,9 @@ class ProxyEmitter extends BaseEmitter {
      * a corresponding Emitter event will also fire with DOM Event object as an argument.
      *
      * **Note**: This is automatically called by the
-     * {@link module:utils/emittermixin~EmitterMixin#listenTo `EmitterMixin#listenTo()`}.
+     * {@link module:utils/emittermixin~Emitter#listenTo `Emitter#listenTo()`}.
      *
-     * @method module:utils/dom/emittermixin~ProxyEmitter#attach
-     * @param {String} event The name of the event.
+     * @param event The name of the event.
      */
     attach(event) {
         // If the DOM Listener for given event already exist it is pointless
@@ -187,10 +159,9 @@ class ProxyEmitter extends BaseEmitter {
      * Stops executing the callback on the given event.
      *
      * **Note**: This is automatically called by the
-     * {@link module:utils/emittermixin~EmitterMixin#stopListening `EmitterMixin#stopListening()`}.
+     * {@link module:utils/emittermixin~Emitter#stopListening `Emitter#stopListening()`}.
      *
-     * @method module:utils/dom/emittermixin~ProxyEmitter#detach
-     * @param {String} event The name of the event.
+     * @param event The name of the event.
      */
     detach(event) {
         let events;
@@ -204,29 +175,24 @@ class ProxyEmitter extends BaseEmitter {
     /**
      * Adds callback to emitter for given event.
      *
-     * @protected
-     * @method module:utils/dom/emittermixin~ProxyEmitter#_addEventListener
-     * @param {String} event The name of the event.
-     * @param {Function} callback The function to be called on event.
-     * @param {Object} [options={}] Additional options.
-     * @param {module:utils/priorities~PriorityString} [options.priority='normal'] The priority of this event callback. The higher
-     * the priority value the sooner the callback will be fired. Events having the same priority are called in the
-     * order they were added.
+     * @internal
+     * @param event The name of the event.
+     * @param callback The function to be called on event.
+     * @param options Additional options.
      */
     _addEventListener(event, callback, options) {
         this.attach(event);
-        BaseEmitter.prototype._addEventListener.call(this, event, callback, options);
+        EmitterMixin().prototype._addEventListener.call(this, event, callback, options);
     }
     /**
      * Removes callback from emitter for given event.
      *
-     * @protected
-     * @method module:utils/dom/emittermixin~ProxyEmitter#_removeEventListener
-     * @param {String} event The name of the event.
-     * @param {Function} callback The function to stop being called.
+     * @internal
+     * @param event The name of the event.
+     * @param callback The function to stop being called.
      */
     _removeEventListener(event, callback) {
-        BaseEmitter.prototype._removeEventListener.call(this, event, callback);
+        EmitterMixin().prototype._removeEventListener.call(this, event, callback);
         this.detach(event);
     }
     /**
@@ -234,10 +200,8 @@ class ProxyEmitter extends BaseEmitter {
      * is fired it will fire corresponding event on this ProxyEmitter.
      * Note: A native DOM Event is passed as an argument.
      *
-     * @private
-     * @method module:utils/dom/emittermixin~ProxyEmitter#_createDomListener
-     * @param {String} event The name of the event.
-     * @returns {Function} The DOM listener callback.
+     * @param event The name of the event.
+     * @returns The DOM listener callback.
      */
     _createDomListener(event) {
         const domListener = (domEvt) => {
@@ -253,22 +217,17 @@ class ProxyEmitter extends BaseEmitter {
         return domListener;
     }
 }
-// Gets an unique DOM Node identifier. The identifier will be set if not defined.
-//
-// @private
-// @param {Node} node
-// @returns {String} UID for given DOM Node.
+/**
+ * Gets an unique DOM Node identifier. The identifier will be set if not defined.
+ *
+ * @returns UID for given DOM Node.
+ */
 function getNodeUID(node) {
     return node['data-ck-expando'] || (node['data-ck-expando'] = uid());
 }
-// Gets id of the ProxyEmitter for the given node.
-//
-// Combines DOM Node identifier and additional options.
-//
-// @private
-// @param {Node} node
-// @param {Object} options Additional options.
-// @returns {String} ProxyEmitter id.
+/**
+ * Gets id of the ProxyEmitter for the given node.
+ */
 function getProxyEmitterId(node, options) {
     let id = getNodeUID(node);
     for (const option of Object.keys(options).sort()) {

package/src/dom/findclosestscrollableancestor.js

@@ -0,0 +1,30 @@
+/**
+ * @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/dom/findClosestScrollableAncestor
+ */
+/**
+ * Returns the closest scrollable ancestor of a DOM element.
+ *
+ * @param domElement DOM element.
+ * @returns First ancestor of `domElement` that is scrollable or null if such ancestor doesn't exist.
+ */
+export default function findClosestScrollableAncestor(domElement) {
+    let element = domElement.parentElement;
+    if (!element) {
+        return null;
+    }
+    while (element.tagName != 'BODY') {
+        const overflow = element.style.overflowY || global.window.getComputedStyle(element).overflowY;
+        if (overflow === 'auto' || overflow === 'scroll') {
+            break;
+        }
+        element = element.parentElement;
+        if (!element) {
+            return null;
+        }
+    }
+    return element;
+}

package/src/dom/getancestors.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 Node */
@@ -12,8 +12,8 @@
  * appended to a `Document`, that `Document` will not be returned (algorithms operating on DOM tree care for `Document#documentElement`
  * at most, which will be returned).
  *
- * @param {Node} node DOM node.
- * @returns {Array.<Node|DocumentFragment>} Array of given `node` parents.
+ * @param node DOM node.
+ * @returns Array of given `node` parents.
  */
 export default function getAncestors(node) {
     const nodes = [];

package/src/dom/getborderwidths.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
  */
 /**
@@ -8,8 +8,8 @@
 /**
  * Returns an object containing CSS border widths of a specified HTML element.
  *
- * @param {HTMLElement} element An element which has CSS borders.
- * @returns {module:utils/dom/getborderwidths~BorderWidths} An object containing `top`, `left`, `right` and `bottom` properties
+ * @param element An element which has CSS borders.
+ * @returns An object containing `top`, `left`, `right` and `bottom` properties
  * with numerical values of the `border-[top,left,right,bottom]-width` CSS styles.
  */
 export default function getBorderWidths(element) {

package/src/dom/getcommonancestor.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
  */
 /**
@@ -9,9 +9,9 @@ import getAncestors from './getancestors';
 /**
  * Searches and returns the lowest common ancestor of two given nodes.
  *
- * @param {Node} nodeA First node.
- * @param {Node} nodeB Second node.
- * @returns {Node|DocumentFragment|Document|null} Lowest common ancestor of both nodes or `null` if nodes do not have a common ancestor.
+ * @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.
  */
 export default function getCommonAncestor(nodeA, nodeB) {
     const ancestorsA = getAncestors(nodeA);

package/src/dom/getdatafromelement.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 HTMLTextAreaElement */
@@ -9,8 +9,8 @@
 /**
  * Gets data from a given source element.
  *
- * @param {HTMLElement} el The element from which the data will be retrieved.
- * @returns {String} The data string.
+ * @param el The element from which the data will be retrieved.
+ * @returns The data string.
  */
 export default function getDataFromElement(el) {
     if (el instanceof HTMLTextAreaElement) {

package/src/dom/getpositionedancestor.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
  */
 /**
@@ -9,8 +9,7 @@ import global from './global';
 /**
  * For a given element, returns the nearest ancestor element which CSS position is not "static".
  *
- * @param {HTMLElement} [element] The native DOM element to be checked.
- * @returns {HTMLElement|null}
+ * @param element The native DOM element to be checked.
  */
 export default function getPositionedAncestor(element) {
     if (!element || !element.parentNode) {

package/src/dom/global.js

@@ -1,29 +1,27 @@
 /**
- * @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 window, document */
-/**
- * @module utils/dom/global
- */
 /**
  * A helper (module) giving an access to the global DOM objects such as `window` and
  * `document`. Accessing these objects using this helper allows easy and bulletproof
  * testing, i.e. stubbing native properties:
  *
- *		import global from 'ckeditor5/utils/dom/global.js';
+ * ```ts
+ * import { global } from 'ckeditor5/utils';
  *
- *		// This stub will work for any code using global module.
- *		testUtils.sinon.stub( global, 'window', {
- *			innerWidth: 10000
- *		} );
+ * // This stub will work for any code using global module.
+ * testUtils.sinon.stub( global, 'window', {
+ * 	innerWidth: 10000
+ * } );
  *
- *		console.log( global.window.innerWidth );
+ * console.log( global.window.innerWidth );
+ * ```
  */
-let global;
+let globalVar; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
 // In some environments window and document API might not be available.
 try {
-    global = { window, document };
+    globalVar = { window, document };
 }
 catch (e) {
     // It's not possible to mock a window object to simulate lack of a window object without writing extremely convoluted code.
@@ -32,6 +30,6 @@ catch (e) {
     // 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.
-    global = { window: {}, document: {} };
+    globalVar = { window: {}, document: {} };
 }
-export default global;
+export default globalVar;

package/src/dom/indexof.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
  */
 /**
@@ -8,8 +8,8 @@
 /**
  * Returns index of the node in the parent element.
  *
- * @param {Node} node Node which index is tested.
- * @returns {Number} Index of the node in the parent element. Returns 0 if node has no parent.
+ * @param node Node which index is tested.
+ * @returns Index of the node in the parent element. Returns 0 if node has no parent.
  */
 export default function indexOf(node) {
     let index = 0;

package/src/dom/insertat.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
  */
 /**
@@ -8,9 +8,9 @@
 /**
  * Inserts node to the parent at given index.
  *
- * @param {Element} parentElement Parent element.
- * @param {Number} index Insertions index.
- * @param {Node} nodeToInsert Node to insert.
+ * @param parentElement Parent element.
+ * @param index Insertions index.
+ * @param nodeToInsert Node to insert.
  */
 export default function insertAt(parentElement, index, nodeToInsert) {
     parentElement.insertBefore(nodeToInsert, parentElement.childNodes[index] || null);

package/src/dom/iscomment.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 Node */
@@ -8,9 +8,6 @@
  */
 /**
  * Checks whether the object is a native DOM Comment node.
- *
- * @param {*} obj
- * @returns {Boolean}
  */
 export default function isComment(obj) {
     return obj && obj.nodeType === Node.COMMENT_NODE;

package/src/dom/isnode.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 @@
  */
 /**
  * Checks if the object is a native DOM Node.
- *
- * @param {*} obj
- * @returns {Boolean}
  */
 export default function isNode(obj) {
     if (obj) {

package/src/dom/isrange.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 @@
  */
 /**
  * Checks if the object is a native DOM Range.
- *
- * @param {*} obj
- * @returns {Boolean}
  */
 export default function isRange(obj) {
     return Object.prototype.toString.apply(obj) == '[object Range]';

package/src/dom/istext.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 @@
  */
 /**
  * Checks if the object is a native DOM Text node.
- *
- * @param {*} obj
- * @returns {Boolean}
  */
 export default function isText(obj) {
     return Object.prototype.toString.call(obj) == '[object Text]';